@jaypie/constructs 1.2.5 → 1.2.7

package/dist/cjs/index.d.ts

@@ -1,18 +1,18 @@
-export { CDK } from "./constants";
+export { CDK, LAMBDA_WEB_ADAPTER } from "./constants";
 export { JaypieAccountLoggingBucket, JaypieAccountLoggingBucketProps, } from "./JaypieAccountLoggingBucket";
 export { JaypieApiGateway } from "./JaypieApiGateway";
 export { JaypieAppStack } from "./JaypieAppStack";
 export { JaypieBucketQueuedLambda } from "./JaypieBucketQueuedLambda";
 export { JaypieDatadogBucket, JaypieDatadogBucketProps, } from "./JaypieDatadogBucket";
 export { JaypieDatadogForwarder, JaypieDatadogForwarderProps, } from "./JaypieDatadogForwarder";
-export { JaypieDistribution, JaypieDistributionProps, } from "./JaypieDistribution";
 export { JaypieDatadogSecret } from "./JaypieDatadogSecret";
+export { JaypieDistribution, JaypieDistributionProps, } from "./JaypieDistribution";
 export { JaypieDnsRecord, JaypieDnsRecordProps } from "./JaypieDnsRecord";
 export { JaypieDynamoDb, JaypieDynamoDbProps } from "./JaypieDynamoDb";
 export { JaypieEnvSecret } from "./JaypieEnvSecret";
 export { JaypieEventsRule, JaypieEventsRuleProps } from "./JaypieEventsRule";
-export { JaypieGitHubDeployRole, JaypieGitHubDeployRoleProps, } from "./JaypieGitHubDeployRole";
 export { JaypieExpressLambda } from "./JaypieExpressLambda";
+export { JaypieGitHubDeployRole, JaypieGitHubDeployRoleProps, } from "./JaypieGitHubDeployRole";
 export { JaypieHostedZone, JaypieHostedZoneRecordProps, } from "./JaypieHostedZone";
 export { JaypieInfrastructureStack } from "./JaypieInfrastructureStack";
 export { JaypieLambda, JaypieLambdaProps } from "./JaypieLambda";
@@ -20,11 +20,12 @@ export { JaypieMongoDbSecret } from "./JaypieMongoDbSecret";
 export { DomainNameConfig, JaypieNextJs, JaypieNextjsProps, } from "./JaypieNextJs";
 export { JaypieOpenAiSecret } from "./JaypieOpenAiSecret";
 export { JaypieOrganizationTrail, JaypieOrganizationTrailProps, } from "./JaypieOrganizationTrail";
+export { JaypieQueuedLambda } from "./JaypieQueuedLambda";
 export { AccountAssignments, JaypieSsoPermissions, JaypieSsoPermissionsProps, } from "./JaypieSsoPermissions";
 export { JaypieSsoSyncApplication, JaypieSsoSyncApplicationProps, } from "./JaypieSsoSyncApplication";
-export { JaypieQueuedLambda } from "./JaypieQueuedLambda";
 export { JaypieStack, JaypieStackProps } from "./JaypieStack";
 export { JaypieStaticWebBucket, JaypieStaticWebBucketProps, } from "./JaypieStaticWebBucket";
+export { JaypieStreamingLambda, JaypieStreamingLambdaProps, } from "./JaypieStreamingLambda";
 export { JaypieTraceSigningKeySecret } from "./JaypieTraceSigningKeySecret";
 export { JaypieWebDeploymentBucket } from "./JaypieWebDeploymentBucket";
 export * from "./helpers";

package/dist/esm/JaypieDistribution.d.ts

@@ -35,8 +35,10 @@ export interface JaypieDistributionProps extends Omit<cloudfront.DistributionPro
      */
     host?: string;
     /**
-     * Invoke mode for Lambda Function URLs
-     * @default InvokeMode.BUFFERED
+     * Invoke mode for Lambda Function URLs.
+     * If not provided, auto-detects from handler if it has an invokeMode property
+     * (e.g., JaypieStreamingLambda).
+     * @default InvokeMode.BUFFERED (or auto-detected from handler)
      */
     invokeMode?: lambda.InvokeMode;
     /**
@@ -64,6 +66,7 @@ export declare class JaypieDistribution extends Construct implements cloudfront.
     private isIOrigin;
     private isIFunctionUrl;
     private isIFunction;
+    private hasInvokeMode;
     get env(): {
         account: string;
         region: string;

package/dist/esm/JaypieLambda.d.ts

@@ -21,7 +21,7 @@ export interface JaypieLambdaProps {
     /**
      * DynamoDB tables to grant read/write access to the Lambda function.
      * Each table is granted read/write access and if exactly one table is provided,
-     * the CDK_ENV_DYNAMO_TABLE environment variable is set to the table name.
+     * the DYNAMODB_TABLE_NAME environment variable is set to the table name.
      */
     tables?: dynamodb.ITable[];
     /**

package/dist/esm/JaypieNextJs.d.ts

@@ -23,7 +23,7 @@ export interface JaypieNextjsProps {
     /**
      * DynamoDB tables to grant read/write access to the Next.js server function.
      * Each table is granted read/write access and if exactly one table is provided,
-     * the CDK_ENV_DYNAMO_TABLE environment variable is set to the table name.
+     * the DYNAMODB_TABLE_NAME environment variable is set to the table name.
      */
     tables?: dynamodb.ITable[];
     /**

package/dist/esm/JaypieStreamingLambda.d.ts

@@ -0,0 +1,44 @@
+import { Construct } from "constructs";
+import * as lambda from "aws-cdk-lib/aws-lambda";
+import { JaypieLambda, JaypieLambdaProps } from "./JaypieLambda.js";
+export interface JaypieStreamingLambdaProps extends JaypieLambdaProps {
+    /**
+     * The port your application listens on.
+     * @default 8000
+     */
+    port?: number;
+    /**
+     * Enable response streaming mode.
+     * When true, uses RESPONSE_STREAM invoke mode.
+     * When false, uses BUFFERED invoke mode.
+     * @default false
+     */
+    streaming?: boolean;
+}
+/**
+ * A Lambda construct that uses AWS Lambda Web Adapter for streaming support.
+ * This allows running web applications (Express, Fastify, etc.) with streaming responses.
+ *
+ * @example
+ * ```typescript
+ * const streamingLambda = new JaypieStreamingLambda(this, "StreamingApi", {
+ *   code: "dist/api",
+ *   handler: "run.sh",
+ *   streaming: true,
+ * });
+ *
+ * // Use with JaypieDistribution
+ * new JaypieDistribution(this, "Distribution", {
+ *   handler: streamingLambda,
+ *   invokeMode: streamingLambda.invokeMode,
+ * });
+ * ```
+ */
+export declare class JaypieStreamingLambda extends JaypieLambda {
+    /**
+     * The invoke mode for this Lambda function.
+     * Use this when configuring JaypieDistribution.
+     */
+    readonly invokeMode: lambda.InvokeMode;
+    constructor(scope: Construct, id: string, props: JaypieStreamingLambdaProps);
+}

package/dist/esm/__tests__/JaypieStreamingLambda.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esm/constants.d.ts

@@ -1,3 +1,17 @@
+export declare const LAMBDA_WEB_ADAPTER: {
+    ACCOUNT: string;
+    DEFAULT_PORT: number;
+    EXEC_WRAPPER: string;
+    INVOKE_MODE: {
+        BUFFERED: string;
+        RESPONSE_STREAM: string;
+    };
+    LAYER: {
+        ARM64: string;
+        X86: string;
+    };
+    VERSION: number;
+};
 export declare const CDK: {
     ACCOUNT: {
         DEVELOPMENT: string;

package/dist/esm/index.d.ts

@@ -1,18 +1,18 @@
-export { CDK } from "./constants";
+export { CDK, LAMBDA_WEB_ADAPTER } from "./constants";
 export { JaypieAccountLoggingBucket, JaypieAccountLoggingBucketProps, } from "./JaypieAccountLoggingBucket";
 export { JaypieApiGateway } from "./JaypieApiGateway";
 export { JaypieAppStack } from "./JaypieAppStack";
 export { JaypieBucketQueuedLambda } from "./JaypieBucketQueuedLambda";
 export { JaypieDatadogBucket, JaypieDatadogBucketProps, } from "./JaypieDatadogBucket";
 export { JaypieDatadogForwarder, JaypieDatadogForwarderProps, } from "./JaypieDatadogForwarder";
-export { JaypieDistribution, JaypieDistributionProps, } from "./JaypieDistribution";
 export { JaypieDatadogSecret } from "./JaypieDatadogSecret";
+export { JaypieDistribution, JaypieDistributionProps, } from "./JaypieDistribution";
 export { JaypieDnsRecord, JaypieDnsRecordProps } from "./JaypieDnsRecord";
 export { JaypieDynamoDb, JaypieDynamoDbProps } from "./JaypieDynamoDb";
 export { JaypieEnvSecret } from "./JaypieEnvSecret";
 export { JaypieEventsRule, JaypieEventsRuleProps } from "./JaypieEventsRule";
-export { JaypieGitHubDeployRole, JaypieGitHubDeployRoleProps, } from "./JaypieGitHubDeployRole";
 export { JaypieExpressLambda } from "./JaypieExpressLambda";
+export { JaypieGitHubDeployRole, JaypieGitHubDeployRoleProps, } from "./JaypieGitHubDeployRole";
 export { JaypieHostedZone, JaypieHostedZoneRecordProps, } from "./JaypieHostedZone";
 export { JaypieInfrastructureStack } from "./JaypieInfrastructureStack";
 export { JaypieLambda, JaypieLambdaProps } from "./JaypieLambda";
@@ -20,11 +20,12 @@ export { JaypieMongoDbSecret } from "./JaypieMongoDbSecret";
 export { DomainNameConfig, JaypieNextJs, JaypieNextjsProps, } from "./JaypieNextJs";
 export { JaypieOpenAiSecret } from "./JaypieOpenAiSecret";
 export { JaypieOrganizationTrail, JaypieOrganizationTrailProps, } from "./JaypieOrganizationTrail";
+export { JaypieQueuedLambda } from "./JaypieQueuedLambda";
 export { AccountAssignments, JaypieSsoPermissions, JaypieSsoPermissionsProps, } from "./JaypieSsoPermissions";
 export { JaypieSsoSyncApplication, JaypieSsoSyncApplicationProps, } from "./JaypieSsoSyncApplication";
-export { JaypieQueuedLambda } from "./JaypieQueuedLambda";
 export { JaypieStack, JaypieStackProps } from "./JaypieStack";
 export { JaypieStaticWebBucket, JaypieStaticWebBucketProps, } from "./JaypieStaticWebBucket";
+export { JaypieStreamingLambda, JaypieStreamingLambdaProps, } from "./JaypieStreamingLambda";
 export { JaypieTraceSigningKeySecret } from "./JaypieTraceSigningKeySecret";
 export { JaypieWebDeploymentBucket } from "./JaypieWebDeploymentBucket";
 export * from "./helpers";

package/dist/esm/index.js

@@ -31,6 +31,20 @@ import { Trail, ReadWriteType } from 'aws-cdk-lib/aws-cloudtrail';
 import { CfnPermissionSet, CfnAssignment } from 'aws-cdk-lib/aws-sso';
 import { CfnApplication } from 'aws-cdk-lib/aws-sam';
 
+const LAMBDA_WEB_ADAPTER = {
+    ACCOUNT: "753240598075",
+    DEFAULT_PORT: 8000,
+    EXEC_WRAPPER: "/opt/bootstrap",
+    INVOKE_MODE: {
+        BUFFERED: "BUFFERED",
+        RESPONSE_STREAM: "RESPONSE_STREAM",
+    },
+    LAYER: {
+        ARM64: "LambdaAdapterLayerArm64",
+        X86: "LambdaAdapterLayerX86",
+    },
+    VERSION: 25,
+};
 const CDK$2 = {
     ACCOUNT: {
         DEVELOPMENT: "development",
@@ -1275,7 +1289,7 @@ class JaypieLambda extends Construct {
         });
         // Add table name to environment if there's exactly one table
         if (tables.length === 1) {
-            this._lambda.addEnvironment("CDK_ENV_DYNAMO_TABLE", tables[0].tableName);
+            this._lambda.addEnvironment("DYNAMODB_TABLE_NAME", tables[0].tableName);
         }
         // Configure provisioned concurrency if specified
         if (provisionedConcurrentExecutions !== undefined) {
@@ -1962,6 +1976,18 @@ class JaypieDatadogForwarder extends Construct {
     }
 }
 
+class JaypieDatadogSecret extends JaypieEnvSecret {
+    constructor(scope, id = "MongoConnectionString", props) {
+        const defaultProps = {
+            envKey: "DATADOG_API_KEY",
+            roleTag: CDK$2.ROLE.MONITORING,
+            vendorTag: CDK$2.VENDOR.DATADOG,
+            ...props,
+        };
+        super(scope, id, defaultProps);
+    }
+}
+
 class JaypieDistribution extends Construct {
     constructor(scope, id, props) {
         super(scope, id);
@@ -2007,12 +2033,19 @@ class JaypieDistribution extends Construct {
         // IFunction before IFunctionUrl (IFunction doesn't have functionUrlId)
         let origin;
         if (handler) {
+            // Auto-detect invoke mode from handler (e.g., JaypieStreamingLambda)
+            // Explicit invokeMode prop takes precedence over auto-detection
+            const resolvedInvokeMode = invokeMode !== lambda.InvokeMode.BUFFERED
+                ? invokeMode // Explicit non-default value, use it
+                : this.hasInvokeMode(handler)
+                    ? handler.invokeMode // Auto-detect from handler
+                    : invokeMode; // Use default BUFFERED
             if (this.isIFunction(handler)) {
                 // Create FunctionUrl for the Lambda function
                 const functionUrl = new lambda.FunctionUrl(this, "FunctionUrl", {
                     function: handler,
                     authType: lambda.FunctionUrlAuthType.NONE,
-                    invokeMode,
+                    invokeMode: resolvedInvokeMode,
                 });
                 this.functionUrl = functionUrl;
                 origin = new origins.FunctionUrlOrigin(functionUrl);
@@ -2149,6 +2182,13 @@ class JaypieDistribution extends Construct {
             "functionName" in handler &&
             !("url" in handler));
     }
+    hasInvokeMode(handler) {
+        // Check if handler has an invokeMode property (e.g., JaypieStreamingLambda)
+        return (typeof handler === "object" &&
+            handler !== null &&
+            "invokeMode" in handler &&
+            typeof handler.invokeMode === "string");
+    }
     // Implement IDistribution interface
     get env() {
         return {
@@ -2175,18 +2215,6 @@ class JaypieDistribution extends Construct {
     }
 }
 
-class JaypieDatadogSecret extends JaypieEnvSecret {
-    constructor(scope, id = "MongoConnectionString", props) {
-        const defaultProps = {
-            envKey: "DATADOG_API_KEY",
-            roleTag: CDK$2.ROLE.MONITORING,
-            vendorTag: CDK$2.VENDOR.DATADOG,
-            ...props,
-        };
-        super(scope, id, defaultProps);
-    }
-}
-
 class JaypieDnsRecord extends Construct {
     constructor(scope, id, props) {
         super(scope, id);
@@ -2586,6 +2614,16 @@ class JaypieEventsRule extends Construct {
     }
 }
 
+class JaypieExpressLambda extends JaypieLambda {
+    constructor(scope, id, props) {
+        super(scope, id, {
+            timeout: Duration.seconds(CDK$2.DURATION.EXPRESS_API),
+            roleTag: CDK$2.ROLE.API,
+            ...props,
+        });
+    }
+}
+
 class JaypieGitHubDeployRole extends Construct {
     constructor(scope, id = "GitHubDeployRole", props = {}) {
         super(scope, id);
@@ -2668,16 +2706,6 @@ class JaypieGitHubDeployRole extends Construct {
     }
 }
 
-class JaypieExpressLambda extends JaypieLambda {
-    constructor(scope, id, props) {
-        super(scope, id, {
-            timeout: Duration.seconds(CDK$2.DURATION.EXPRESS_API),
-            roleTag: CDK$2.ROLE.API,
-            ...props,
-        });
-    }
-}
-
 const SERVICE = {
     ROUTE53: "route53.amazonaws.com",
 };
@@ -2917,7 +2945,7 @@ class JaypieNextJs extends Construct {
         });
         // Add table name to environment if there's exactly one table
         if (tables.length === 1) {
-            nextjs.serverFunction.lambdaFunction.addEnvironment("CDK_ENV_DYNAMO_TABLE", tables[0].tableName);
+            nextjs.serverFunction.lambdaFunction.addEnvironment("DYNAMODB_TABLE_NAME", tables[0].tableName);
         }
         // Store reference to nextjs for property exposure
         this._nextjs = nextjs;
@@ -3722,6 +3750,75 @@ class JaypieStaticWebBucket extends JaypieWebDeploymentBucket {
     }
 }
 
+/**
+ * A Lambda construct that uses AWS Lambda Web Adapter for streaming support.
+ * This allows running web applications (Express, Fastify, etc.) with streaming responses.
+ *
+ * @example
+ * ```typescript
+ * const streamingLambda = new JaypieStreamingLambda(this, "StreamingApi", {
+ *   code: "dist/api",
+ *   handler: "run.sh",
+ *   streaming: true,
+ * });
+ *
+ * // Use with JaypieDistribution
+ * new JaypieDistribution(this, "Distribution", {
+ *   handler: streamingLambda,
+ *   invokeMode: streamingLambda.invokeMode,
+ * });
+ * ```
+ */
+class JaypieStreamingLambda extends JaypieLambda {
+    constructor(scope, id, props) {
+        const { architecture = lambda.Architecture.X86_64, environment: propsEnvironment, layers: propsLayers = [], port = LAMBDA_WEB_ADAPTER.DEFAULT_PORT, streaming = false, ...restProps } = props;
+        // Determine the Lambda Web Adapter layer ARN based on architecture
+        const region = Stack.of(scope).region;
+        const layerArn = architecture === lambda.Architecture.ARM_64
+            ? `arn:aws:lambda:${region}:${LAMBDA_WEB_ADAPTER.ACCOUNT}:layer:${LAMBDA_WEB_ADAPTER.LAYER.ARM64}:${LAMBDA_WEB_ADAPTER.VERSION}`
+            : `arn:aws:lambda:${region}:${LAMBDA_WEB_ADAPTER.ACCOUNT}:layer:${LAMBDA_WEB_ADAPTER.LAYER.X86}:${LAMBDA_WEB_ADAPTER.VERSION}`;
+        // Create the Lambda Web Adapter layer
+        const webAdapterLayer = lambda.LayerVersion.fromLayerVersionArn(scope, `${id}WebAdapterLayer`, layerArn);
+        // Build environment variables with Lambda Web Adapter configuration
+        const lwaInvokeMode = streaming
+            ? LAMBDA_WEB_ADAPTER.INVOKE_MODE.RESPONSE_STREAM
+            : LAMBDA_WEB_ADAPTER.INVOKE_MODE.BUFFERED;
+        const webAdapterEnvironment = {
+            AWS_LAMBDA_EXEC_WRAPPER: LAMBDA_WEB_ADAPTER.EXEC_WRAPPER,
+            AWS_LWA_INVOKE_MODE: lwaInvokeMode,
+            PORT: String(port),
+        };
+        // Merge environment variables - props environment takes precedence
+        let mergedEnvironment;
+        if (Array.isArray(propsEnvironment)) {
+            // Array syntax: prepend our object to the array
+            mergedEnvironment = [webAdapterEnvironment, ...propsEnvironment];
+        }
+        else if (propsEnvironment && typeof propsEnvironment === "object") {
+            // Object syntax: merge objects
+            mergedEnvironment = {
+                ...webAdapterEnvironment,
+                ...propsEnvironment,
+            };
+        }
+        else {
+            mergedEnvironment = webAdapterEnvironment;
+        }
+        super(scope, id, {
+            architecture,
+            environment: mergedEnvironment,
+            layers: [webAdapterLayer, ...propsLayers],
+            roleTag: CDK$2.ROLE.API,
+            timeout: Duration.seconds(CDK$2.DURATION.EXPRESS_API),
+            ...restProps,
+        });
+        // Set invoke mode for use with JaypieDistribution
+        this.invokeMode = streaming
+            ? lambda.InvokeMode.RESPONSE_STREAM
+            : lambda.InvokeMode.BUFFERED;
+    }
+}
+
 class JaypieTraceSigningKeySecret extends JaypieEnvSecret {
     constructor(scope, id = "TraceSigningKey", props) {
         const defaultProps = {
@@ -3734,5 +3831,5 @@ class JaypieTraceSigningKeySecret extends JaypieEnvSecret {
     }
 }
 
-export { CDK$2 as CDK, JaypieAccountLoggingBucket, JaypieApiGateway, JaypieAppStack, JaypieBucketQueuedLambda, JaypieDatadogBucket, JaypieDatadogForwarder, JaypieDatadogSecret, JaypieDistribution, JaypieDnsRecord, JaypieDynamoDb, JaypieEnvSecret, JaypieEventsRule, JaypieExpressLambda, JaypieGitHubDeployRole, JaypieHostedZone, JaypieInfrastructureStack, JaypieLambda, JaypieMongoDbSecret, JaypieNextJs, JaypieOpenAiSecret, JaypieOrganizationTrail, JaypieQueuedLambda, JaypieSsoPermissions, JaypieSsoSyncApplication, JaypieStack, JaypieStaticWebBucket, JaypieTraceSigningKeySecret, JaypieWebDeploymentBucket, addDatadogLayers, clearAllSecretsCaches, clearSecretsCache, constructEnvName, constructStackName, constructTagger, envHostname, extendDatadogRole, isEnv, isProductionEnv, isSandboxEnv, isValidHostname$1 as isValidHostname, isValidSubdomain, jaypieLambdaEnv, mergeDomain, resolveDatadogForwarderFunction, resolveDatadogLayers, resolveDatadogLoggingDestination, resolveEnvironment, resolveHostedZone, resolveParamsAndSecrets, resolveSecrets };
+export { CDK$2 as CDK, JaypieAccountLoggingBucket, JaypieApiGateway, JaypieAppStack, JaypieBucketQueuedLambda, JaypieDatadogBucket, JaypieDatadogForwarder, JaypieDatadogSecret, JaypieDistribution, JaypieDnsRecord, JaypieDynamoDb, JaypieEnvSecret, JaypieEventsRule, JaypieExpressLambda, JaypieGitHubDeployRole, JaypieHostedZone, JaypieInfrastructureStack, JaypieLambda, JaypieMongoDbSecret, JaypieNextJs, JaypieOpenAiSecret, JaypieOrganizationTrail, JaypieQueuedLambda, JaypieSsoPermissions, JaypieSsoSyncApplication, JaypieStack, JaypieStaticWebBucket, JaypieStreamingLambda, JaypieTraceSigningKeySecret, JaypieWebDeploymentBucket, LAMBDA_WEB_ADAPTER, addDatadogLayers, clearAllSecretsCaches, clearSecretsCache, constructEnvName, constructStackName, constructTagger, envHostname, extendDatadogRole, isEnv, isProductionEnv, isSandboxEnv, isValidHostname$1 as isValidHostname, isValidSubdomain, jaypieLambdaEnv, mergeDomain, resolveDatadogForwarderFunction, resolveDatadogLayers, resolveDatadogLoggingDestination, resolveEnvironment, resolveHostedZone, resolveParamsAndSecrets, resolveSecrets };
 //# sourceMappingURL=index.js.map