@jaypie/constructs 1.2.6 → 1.2.8

package/dist/cjs/JaypieDistribution.d.ts

@@ -1,4 +1,4 @@
-import { RemovalPolicy, Stack } from "aws-cdk-lib";
+import { Duration, RemovalPolicy, Stack } from "aws-cdk-lib";
 import * as acm from "aws-cdk-lib/aws-certificatemanager";
 import * as cloudfront from "aws-cdk-lib/aws-cloudfront";
 import * as lambda from "aws-cdk-lib/aws-lambda";
@@ -35,10 +35,19 @@ 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;
+    /**
+     * Origin read timeout - how long CloudFront waits for a response from the origin.
+     * This is the maximum time allowed for the origin to respond.
+     * @default CDK.DURATION.CLOUDFRONT_API (180 seconds)
+     * @max Duration.seconds(180)
+     */
+    originReadTimeout?: Duration;
     /**
      * Role tag for tagging resources
      * @default CDK.ROLE.HOSTING
@@ -64,6 +73,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/cjs/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/cjs/__tests__/JaypieStreamingLambda.spec.d.ts

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

package/dist/cjs/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;
@@ -55,6 +69,7 @@ export declare const CDK: {
     };
     DURATION: {
         EXPRESS_API: number;
+        CLOUDFRONT_API: number;
         LAMBDA_MAXIMUM: number;
         LAMBDA_WORKER: number;
     };

package/dist/cjs/index.cjs

@@ -63,6 +63,20 @@ var origins__namespace = /*#__PURE__*/_interopNamespaceDefault(origins);
 var dynamodb__namespace = /*#__PURE__*/_interopNamespaceDefault(dynamodb);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 
+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",
@@ -121,6 +135,7 @@ const CDK$2 = {
     },
     DURATION: {
         EXPRESS_API: 30,
+        CLOUDFRONT_API: 180,
         LAMBDA_MAXIMUM: 900,
         LAMBDA_WORKER: 900,
     },
@@ -1994,10 +2009,22 @@ class JaypieDatadogForwarder extends constructs.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 constructs.Construct {
     constructor(scope, id, props) {
         super(scope, id);
-        const { certificate: certificateProp = true, defaultBehavior: propsDefaultBehavior, destination: destinationProp = true, handler, host: propsHost, invokeMode = lambda__namespace.InvokeMode.BUFFERED, roleTag = CDK$2.ROLE.API, zone: propsZone, ...distributionProps } = props;
+        const { certificate: certificateProp = true, defaultBehavior: propsDefaultBehavior, destination: destinationProp = true, handler, host: propsHost, invokeMode = lambda__namespace.InvokeMode.BUFFERED, originReadTimeout = cdk.Duration.seconds(CDK$2.DURATION.CLOUDFRONT_API), roleTag = CDK$2.ROLE.API, zone: propsZone, ...distributionProps } = props;
         // Validate environment variables
         if (process.env.CDK_ENV_API_SUBDOMAIN &&
             !isValidSubdomain(process.env.CDK_ENV_API_SUBDOMAIN)) {
@@ -2039,18 +2066,29 @@ class JaypieDistribution extends constructs.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__namespace.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__namespace.FunctionUrl(this, "FunctionUrl", {
                     function: handler,
                     authType: lambda__namespace.FunctionUrlAuthType.NONE,
-                    invokeMode,
+                    invokeMode: resolvedInvokeMode,
                 });
                 this.functionUrl = functionUrl;
-                origin = new origins__namespace.FunctionUrlOrigin(functionUrl);
+                origin = new origins__namespace.FunctionUrlOrigin(functionUrl, {
+                    readTimeout: originReadTimeout,
+                });
             }
             else if (this.isIFunctionUrl(handler)) {
-                origin = new origins__namespace.FunctionUrlOrigin(handler);
+                origin = new origins__namespace.FunctionUrlOrigin(handler, {
+                    readTimeout: originReadTimeout,
+                });
             }
             else if (this.isIOrigin(handler)) {
                 origin = handler;
@@ -2181,6 +2219,13 @@ class JaypieDistribution extends constructs.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 {
@@ -2207,18 +2252,6 @@ class JaypieDistribution extends constructs.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 constructs.Construct {
     constructor(scope, id, props) {
         super(scope, id);
@@ -2618,6 +2651,16 @@ class JaypieEventsRule extends constructs.Construct {
     }
 }
 
+class JaypieExpressLambda extends JaypieLambda {
+    constructor(scope, id, props) {
+        super(scope, id, {
+            timeout: cdk.Duration.seconds(CDK$2.DURATION.EXPRESS_API),
+            roleTag: CDK$2.ROLE.API,
+            ...props,
+        });
+    }
+}
+
 class JaypieGitHubDeployRole extends constructs.Construct {
     constructor(scope, id = "GitHubDeployRole", props = {}) {
         super(scope, id);
@@ -2700,16 +2743,6 @@ class JaypieGitHubDeployRole extends constructs.Construct {
     }
 }
 
-class JaypieExpressLambda extends JaypieLambda {
-    constructor(scope, id, props) {
-        super(scope, id, {
-            timeout: cdk.Duration.seconds(CDK$2.DURATION.EXPRESS_API),
-            roleTag: CDK$2.ROLE.API,
-            ...props,
-        });
-    }
-}
-
 const SERVICE = {
     ROUTE53: "route53.amazonaws.com",
 };
@@ -3754,6 +3787,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__namespace.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 = cdk.Stack.of(scope).region;
+        const layerArn = architecture === lambda__namespace.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__namespace.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: cdk.Duration.seconds(CDK$2.DURATION.EXPRESS_API),
+            ...restProps,
+        });
+        // Set invoke mode for use with JaypieDistribution
+        this.invokeMode = streaming
+            ? lambda__namespace.InvokeMode.RESPONSE_STREAM
+            : lambda__namespace.InvokeMode.BUFFERED;
+    }
+}
+
 class JaypieTraceSigningKeySecret extends JaypieEnvSecret {
     constructor(scope, id = "TraceSigningKey", props) {
         const defaultProps = {
@@ -3793,8 +3895,10 @@ exports.JaypieSsoPermissions = JaypieSsoPermissions;
 exports.JaypieSsoSyncApplication = JaypieSsoSyncApplication;
 exports.JaypieStack = JaypieStack;
 exports.JaypieStaticWebBucket = JaypieStaticWebBucket;
+exports.JaypieStreamingLambda = JaypieStreamingLambda;
 exports.JaypieTraceSigningKeySecret = JaypieTraceSigningKeySecret;
 exports.JaypieWebDeploymentBucket = JaypieWebDeploymentBucket;
+exports.LAMBDA_WEB_ADAPTER = LAMBDA_WEB_ADAPTER;
 exports.addDatadogLayers = addDatadogLayers;
 exports.clearAllSecretsCaches = clearAllSecretsCaches;
 exports.clearSecretsCache = clearSecretsCache;