Merge branch 'main' into improv/commons/typeutils

Author: dreamorosi

docs/core/tracer.md

@@ -55,7 +55,7 @@ The library has three optional settings. You can set them as environment variabl
 | **Capture Errors**         | Defines whether functions errors are serialized as metadata           | `POWERTOOLS_TRACER_CAPTURE_ERROR`          | `true`              | `true` or `false` | `false`             | N/A                    |
 
 !!! note
-    Before your use this utility, your AWS Lambda function must have [Active Tracing enabled](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) as well as [have permissions](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html#services-xray-permissions) to send traces to AWS X-Ray
+    Before you use this utility, your AWS Lambda function must have [Active Tracing enabled](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html) as well as [have permissions](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html#services-xray-permissions) to send traces to AWS X-Ray
 
 #### Example using AWS Serverless Application Model (SAM)
 

docs/upgrade.md

@@ -10,12 +10,13 @@ V2 is focused on official support for ESM (ECMAScript modules). We've made other
 ### Quick summary
 
 | Area                  | Change                                                                                                                         | Code change required |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------- |
+| --------------------- |--------------------------------------------------------------------------------------------------------------------------------| -------------------- |
 | **ESM support**       | Added ESM support via dual CommonJS and ESM bundling, enabling top-level `await` and tree-shaking.                             | -                    |
 | **Middy.js**          | Updated import path for Middy.js middlewares to leverage subpath exports - i.e. `@aws-lambda-powertools/tracer/middleware`.    | Yes                  |
 | **Types imports**     | Updated import path for TypeScript types to leverage subpath exports - i.e. `@aws-lambda-powertools/logger/types`.             | Yes                  |
 | **Logger**            | Changed [log sampling](./core/logger.md#sampling-logs) to dynamically switch log level to `DEBUG` on a percentage of requests. | -                    |
 | **Logger**            | Updated [custom log formatter](#custom-log-formatter) to include standard as well as persistent keys.                          | Yes                  |
+| **Logger**            | Removed `ContextExamples` from `@aws-lambda-powertools/commons` package.                                                       | Yes                  |
 | **Logger and Tracer** | Removed deprecated `createLogger` and `createTracer` helper functions in favor of direct instantiation.                        | Yes                  |
 
 
@@ -280,6 +281,56 @@ In v2, you have more control over **standard** (`attributes`) and [**custom keys
     2. `LogItem` is the new return object instead of a plain object.
     3. If you prefer adding at the initialization, use: <br/><br/> **`LogItem({persistentAttributes: additionalLogAttributes, attributes: baseAttributes})`**
 
+### ContextExamples for testing
+
+In v1, we have provided a `ContextExamples` object to help you with testing.
+
+In v2, we have removed the `ContextExamples` from the `@aws-lambda-powertools/commons` package, so you need to create it in your tests: 
+
+=== "Before"
+
+    ```typescript
+    import { ContextExamples as dummyContext } from '@aws-lambda-powertools/commons';
+    
+    describe('MyUnitTest', () => {
+      test('Lambda invoked successfully', async () => {
+        const testEvent = { test: 'test' };
+        await handler(testEvent, dummyContext);
+      });
+    });
+    ```
+
+=== "After"
+
+    ```typescript
+    declare const handler: (event: unknown, context: unknown) => Promise<void>;
+    
+    const context = {
+      callbackWaitsForEmptyEventLoop: true,
+      functionVersion: '$LATEST',
+      functionName: 'foo-bar-function',
+      memoryLimitInMB: '128',
+      logGroupName: '/aws/lambda/foo-bar-function-123456abcdef',
+      logStreamName: '2021/03/09/[$LATEST]abcdef123456abcdef123456abcdef123456',
+      invokedFunctionArn:
+      'arn:aws:lambda:eu-west-1:123456789012:function:foo-bar-function',
+      awsRequestId: 'c6af9ac6-7b61-11e6-9a41-93e812345678',
+      getRemainingTimeInMillis: () => 1234,
+      done: () => console.log('Done!'),
+      fail: () => console.log('Failed!'),
+      succeed: () => console.log('Succeeded!'),
+    };
+    
+    describe('MyUnitTest', () => {
+      test('Lambda invoked successfully', async () => {
+        const testEvent = { test: 'test' };
+        await handler(testEvent, context);
+      });
+    });
+    ```
+
+
+
 ## Helper functions
 
 We removed the deprecated `createLogger` and `createTracer` heper functions.

packages/jmespath/src/Functions.ts

@@ -0,0 +1,4 @@
+// This is a placeholder for the real class. The actual implementation will be added in a subsequent PR.
+export class Functions {
+  public iAmAPlaceholder = true;
+}

packages/jmespath/src/constants.ts

@@ -0,0 +1,97 @@
+/**
+ * The binding powers for the various tokens in the JMESPath grammar.
+ *
+ * The binding powers are used to determine the order of operations for
+ * the parser. The higher the binding power, the more tightly the token
+ * binds to its arguments.
+ */
+const BINDING_POWER = {
+  eof: 0,
+  unquoted_identifier: 0,
+  quoted_identifier: 0,
+  literal: 0,
+  rbracket: 0,
+  rparen: 0,
+  comma: 0,
+  rbrace: 0,
+  number: 0,
+  current: 0,
+  expref: 0,
+  colon: 0,
+  pipe: 1,
+  or: 2,
+  and: 3,
+  eq: 5,
+  gt: 5,
+  lt: 5,
+  gte: 5,
+  lte: 5,
+  ne: 5,
+  flatten: 9,
+  // Everything above stops a projection.
+  star: 20,
+  filter: 21,
+  dot: 40,
+  not: 45,
+  lbrace: 50,
+  lbracket: 55,
+  lparen: 60,
+} as const;
+
+/**
+ * The set of ASCII lowercase letters allowed in JMESPath identifiers.
+ */
+const ASCII_LOWERCASE = 'abcdefghijklmnopqrstuvwxyz';
+/**
+ * The set of ASCII uppercase letters allowed in JMESPath identifiers.
+ */
+const ASCII_UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+/**
+ * The set of ASCII letters allowed in JMESPath identifiers.
+ */
+const ASCII_LETTERS = ASCII_LOWERCASE + ASCII_UPPERCASE;
+/**
+ * The set of ASCII digits allowed in JMESPath identifiers.
+ */
+const DIGITS = '0123456789';
+/**
+ * The set of ASCII letters and digits allowed in JMESPath identifiers.
+ */
+const START_IDENTIFIER = new Set(ASCII_LETTERS + '_');
+/**
+ * The set of ASCII letters and digits allowed in JMESPath identifiers.
+ */
+const VALID_IDENTIFIER = new Set(ASCII_LETTERS + DIGITS + '_');
+/**
+ * The set of ASCII digits allowed in JMESPath identifiers.
+ */
+const VALID_NUMBER = new Set(DIGITS);
+/**
+ * The set of ASCII whitespace characters allowed in JMESPath identifiers.
+ */
+const WHITESPACE = new Set(' \t\n\r');
+/**
+ * The set of simple tokens in the JMESPath grammar.
+ */
+const SIMPLE_TOKENS: Map<string, keyof typeof BINDING_POWER> = new Map([
+  ['.', 'dot'],
+  ['*', 'star'],
+  [':', 'colon'],
+  [']', 'rbracket'],
+  [',', 'comma'],
+  [':', 'colon'],
+  ['@', 'current'],
+  ['(', 'lparen'],
+  [')', 'rparen'],
+  ['{', 'lbrace'],
+  ['}', 'rbrace'],
+]);
+
+export {
+  BINDING_POWER,
+  SIMPLE_TOKENS,
+  START_IDENTIFIER,
+  VALID_IDENTIFIER,
+  VALID_NUMBER,
+  WHITESPACE,
+};