@lambda-kata/cdk 0.1.3-rc.94 → 0.1.3-rc.95

package/out/tsc/src/index.d.ts

@@ -18,11 +18,11 @@
  * ```
  */
 export { KataProps, LicensingResponse, TransformationConfig } from './types';
-export { LicensingService, HttpLicensingService, createLicensingService, isValidAccountId, } from './licensing';
+export { LicensingService, LicenseCheckParams, HttpLicensingService, createLicensingService, isValidAccountId, } from './licensing';
 export { MockLicensingService, createMockLicensingService, } from './mock-licensing';
 export { resolveAccountId, resolveAccountIdWithSource, isValidAccountIdFormat, AccountResolutionError, AccountResolutionResult, AccountResolverOptions, } from './account-resolver';
 export { resolveAccountIdSync, resolveAccountIdSyncWithSource, resolveRegionSync, SyncAccountResolutionError, SyncAccountResolutionResult, SyncAccountResolverOptions, } from './sync-account-resolver';
-export { kata, kataWithAccountId, applyTransformation, handleUnlicensed, isKataTransformed, getKataPromise, extractBundlePathFromHandler, KataWrapperOptions, KataResult, } from './kata-wrapper';
+export { kata, kataWithAccountId, applyTransformation, handleUnlicensed, isKataTransformed, getKataPromise, extractBundlePathFromHandler, extractNodeVersion, KataWrapperOptions, KataResult, } from './kata-wrapper';
 export { SnapStartActivator, SnapStartActivatorProps, } from './snapstart-construct';
 export { activateSnapStart, SnapStartActivationResult, SnapStartActivatorConfig, } from './snapstart-activator';
 export { createKataConfigLayer, generateConfigContent, KataConfigLayerProps, CONFIG_DIR_NAME, CONFIG_FILE_NAME, HANDLER_CONFIG_KEY, } from './config-layer';

package/out/tsc/src/kata-wrapper.d.ts

@@ -169,6 +169,20 @@ export declare function extractBundlePathFromHandler(handler: string): string;
  * @internal
  */
 export declare function getOriginalRuntime(lambda: NodejsFunction | LambdaFunction): string;
+/**
+ * Extracts the Node.js major version number from a runtime string.
+ *
+ * @param runtime - The runtime string (e.g., "nodejs20.x")
+ * @returns The major version number as NodeVersion type, or "20" as default
+ *
+ * @example
+ * extractNodeVersion("nodejs20.x") // => "20"
+ * extractNodeVersion("nodejs22.x") // => "22"
+ * extractNodeVersion("python3.12") // => "20" (default for non-Node.js)
+ *
+ * @internal
+ */
+export declare function extractNodeVersion(runtime: string): '18' | '20' | '22' | '24';
 /**
  * Detects if a Lambda function uses a Node.js runtime.
  *

package/out/tsc/src/licensing.d.ts

@@ -7,6 +7,37 @@
  * @module licensing
  */
 import { LicensingResponse } from './types';
+/**
+ * Supported Node.js versions for licensing requests.
+ * Valid values: "18", "20", "22", "24"
+ */
+export type NodeVersion = '18' | '20' | '22' | '24';
+/**
+ * Supported architectures for licensing requests.
+ * Valid values: "x86_64", "arm64"
+ */
+export type LicenseArchitecture = 'x86_64' | 'arm64';
+/**
+ * Parameters for license entitlement check.
+ */
+export interface LicenseCheckParams {
+    /**
+     * AWS account ID (12-digit string)
+     */
+    accountId: string;
+    /**
+     * Node.js version number.
+     * Valid values: "18", "20", "22", "24"
+     * @default "20"
+     */
+    nodeVersion?: NodeVersion;
+    /**
+     * Lambda architecture.
+     * Valid values: "x86_64", "arm64"
+     * @default "x86_64"
+     */
+    architecture?: LicenseArchitecture;
+}
 /**
  * Interface for the Lambda Kata licensing service.
  *
@@ -16,9 +47,13 @@ import { LicensingResponse } from './types';
  * @example
  * ```typescript
  * const licensingService = new HttpLicensingService();
- * const response = await licensingService.checkEntitlement('123456789012');
+ * const response = await licensingService.checkEntitlement({
+ *   accountId: '123456789012',
+ *   nodeVersion: '20',
+ *   architecture: 'x86_64'
+ * });
  * if (response.entitled) {
- *   console.log(`Layer ARN: ${response.layerArn}`);
+ *   console.log(`Layer ARN: ${response.layerVersionArn}`);
  * }
  * ```
  */
@@ -26,7 +61,8 @@ export interface LicensingService {
     /**
      * Check if an AWS account is entitled to use Lambda Kata.
      *
-     * @param accountId - The AWS account ID to check (12-digit string)
+     * @param params - License check parameters (accountId, nodeVersion, architecture)
+     *                 For backward compatibility, can also be just accountId string
      * @returns Promise resolving to entitlement status and Layer ARN if entitled
      *
      * @remarks
@@ -34,7 +70,7 @@ export interface LicensingService {
      * - If the account is not entitled, the response will have `entitled: false`
      * - Network errors are handled gracefully and treated as unlicensed (Requirement 6.5)
      */
-    checkEntitlement(accountId: string): Promise<LicensingResponse>;
+    checkEntitlement(params: LicenseCheckParams | string): Promise<LicensingResponse>;
 }
 /**
  * HTTP-based implementation of the LicensingService interface.
@@ -69,7 +105,7 @@ export declare class HttpLicensingService implements LicensingService {
      * AWS Marketplace entitlement. If the service is unreachable or returns
      * an error, the account is treated as unlicensed (Requirement 6.5).
      *
-     * @param accountId - The AWS account ID to check (12-digit string)
+     * @param params - License check parameters or accountId string for backward compatibility
      * @returns Promise resolving to entitlement status and Layer ARN if entitled
      *
      * @remarks
@@ -78,11 +114,13 @@ export declare class HttpLicensingService implements LicensingService {
      * - 3.3: Returns the customer-specific Layer_ARN if entitled
      * - 6.5: Treats unreachable service as unlicensed with appropriate warning
      */
-    checkEntitlement(accountId: string): Promise<LicensingResponse>;
+    checkEntitlement(params: LicenseCheckParams | string): Promise<LicensingResponse>;
     /**
      * Makes the HTTP request to the licensing service.
      *
      * @param accountId - The AWS account ID to check
+     * @param nodeVersion - Optional Node.js version (defaults to "20")
+     * @param architecture - Optional architecture (defaults to "x86_64")
      * @returns Promise resolving to the licensing response
      * @throws Error if the request fails or times out
      */

package/out/tsc/src/mock-licensing.d.ts

@@ -6,7 +6,7 @@
  *
  * @module mock-licensing
  */
-import { LicensingService } from './licensing';
+import { LicensingService, LicenseCheckParams } from './licensing';
 import { LicensingResponse } from './types';
 /**
  * Mock implementation of the LicensingService interface for testing.
@@ -171,7 +171,7 @@ export declare class MockLicensingService implements LicensingService {
      * This mock implementation returns entitlement status based on
      * accounts configured via setEntitled().
      *
-     * @param accountId - The AWS account ID to check (12-digit string)
+     * @param params - License check parameters or accountId string for backward compatibility
      * @returns Promise resolving to entitlement status and Layer ARN if entitled
      *
      * @remarks
@@ -179,7 +179,7 @@ export declare class MockLicensingService implements LicensingService {
      * - 3.2: Validates the account's entitlement based on configured entitlements
      * - 3.3: Returns the customer-specific Layer_ARN if entitled
      */
-    checkEntitlement(accountId: string): Promise<LicensingResponse>;
+    checkEntitlement(params: LicenseCheckParams | string): Promise<LicensingResponse>;
     /**
      * Returns the number of entitled accounts.
      *

package/out/tsc/src/types.d.ts

@@ -51,7 +51,8 @@ export interface LicensingResponse {
      * This is the ARN that should be used when attaching layers to Lambda functions.
      * Only present if the account is entitled.
      *
-     * @example "arn:aws:lambda:eu-central-1:113258654684:layer:lambda-kata-euc:1"
+     * Format: lambda-kata-node{version}-{arch}-{regionCode}
+     * @example "arn:aws:lambda:eu-central-1:113258654684:layer:lambda-kata-node20-x86_64-euc:1"
      */
     layerVersionArn?: string;
     /**
@@ -63,6 +64,18 @@ export interface LicensingResponse {
      * Only present if the account is entitled.
      */
     expiresAt?: string;
+    /**
+     * Node.js version used for the layer.
+     * Echoed back from the request or defaults to "20".
+     * @example "20", "22", "24"
+     */
+    nodeVersion?: string;
+    /**
+     * Architecture used for the layer.
+     * Echoed back from the request or defaults to "x86_64".
+     * @example "x86_64", "arm64"
+     */
+    architecture?: string;
 }
 /**
  * Configuration for transforming a Lambda function to use Lambda Kata.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambda-kata/cdk",
-  "version": "0.1.3-rc.94",
+  "version": "0.1.3-rc.95",
   "description": "AWS CDK integration for Lambda Kata - Node.js Lambdas running via Lambda Kata runtime",
   "main": "out/dist/index.js",
   "types": "out/tsc/src/index.d.ts",