@jaypie/constructs 1.1.40 → 1.1.41

package/dist/cjs/helpers/__tests__/jaypieLambdaEnv.spec.d.ts

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

package/dist/cjs/helpers/addDatadogLayer.d.ts

@@ -0,0 +1,5 @@
+import * as lambda from "aws-cdk-lib/aws-lambda";
+export interface AddDatadogLayerOptions {
+    datadogApiKeyArn?: string;
+}
+export declare function addDatadogLayer(lambdaFunction: lambda.Function, options?: AddDatadogLayerOptions): boolean;

package/dist/cjs/helpers/addParamsAndSecrets.d.ts

@@ -0,0 +1,11 @@
+import * as lambda from "aws-cdk-lib/aws-lambda";
+export interface AddParamsAndSecretsOptions {
+    paramsAndSecrets?: lambda.ParamsAndSecretsLayerVersion | boolean;
+    paramsAndSecretsOptions?: {
+        cacheSize?: number;
+        logLevel?: lambda.ParamsAndSecretsLogLevel;
+        parameterStoreTtl?: number;
+        secretsManagerTtl?: number;
+    };
+}
+export declare function addParamsAndSecrets(lambdaFunction: lambda.Function, options?: AddParamsAndSecretsOptions): boolean;

package/dist/cjs/helpers/index.d.ts

@@ -1,5 +1,9 @@
+export { addDatadogLayer } from "./addDatadogLayer";
+export { addParamsAndSecrets } from "./addParamsAndSecrets";
 export { constructEnvName } from "./constructEnvName";
 export { constructStackName } from "./constructStackName";
 export { constructTagger } from "./constructTagger";
 export { envHostname } from "./envHostname";
 export { isEnv, isProductionEnv, isSandboxEnv } from "./isEnv";
+export { jaypieLambdaEnv } from "./jaypieLambdaEnv";
+export { resolveHostedZone } from "./resolveHostedZone";

package/dist/cjs/helpers/jaypieLambdaEnv.d.ts

@@ -0,0 +1,8 @@
+export interface JaypieLambdaEnvOptions {
+    initialEnvironment?: {
+        [key: string]: string;
+    };
+}
+export declare function jaypieLambdaEnv(options?: JaypieLambdaEnvOptions): {
+    [key: string]: string;
+};

package/dist/cjs/helpers/resolveHostedZone.d.ts

@@ -0,0 +1,6 @@
+import { Construct } from "constructs";
+import * as route53 from "aws-cdk-lib/aws-route53";
+export declare function resolveHostedZone(scope: Construct, { name, zone, }: {
+    name?: string;
+    zone?: string | route53.IHostedZone;
+}): route53.IHostedZone;

package/dist/cjs/index.cjs

@@ -7,12 +7,12 @@ var apiGateway = require('aws-cdk-lib/aws-apigateway');
 var route53 = require('aws-cdk-lib/aws-route53');
 var route53Targets = require('aws-cdk-lib/aws-route53-targets');
 var cdk$1 = require('@jaypie/cdk');
+var lambda = require('aws-cdk-lib/aws-lambda');
+var secretsmanager = require('aws-cdk-lib/aws-secretsmanager');
 var s3 = require('aws-cdk-lib/aws-s3');
 var s3n = require('aws-cdk-lib/aws-s3-notifications');
-var lambda = require('aws-cdk-lib/aws-lambda');
 var sqs = require('aws-cdk-lib/aws-sqs');
 var lambdaEventSources = require('aws-cdk-lib/aws-lambda-event-sources');
-var secretsmanager = require('aws-cdk-lib/aws-secretsmanager');
 var awsIam = require('aws-cdk-lib/aws-iam');
 var awsLogs = require('aws-cdk-lib/aws-logs');
 var sso = require('aws-cdk-lib/aws-sso');
@@ -41,16 +41,109 @@ var acm__namespace = /*#__PURE__*/_interopNamespaceDefault(acm);
 var apiGateway__namespace = /*#__PURE__*/_interopNamespaceDefault(apiGateway);
 var route53__namespace = /*#__PURE__*/_interopNamespaceDefault(route53);
 var route53Targets__namespace = /*#__PURE__*/_interopNamespaceDefault(route53Targets);
+var lambda__namespace = /*#__PURE__*/_interopNamespaceDefault(lambda);
+var secretsmanager__namespace = /*#__PURE__*/_interopNamespaceDefault(secretsmanager);
 var s3__namespace = /*#__PURE__*/_interopNamespaceDefault(s3);
 var s3n__namespace = /*#__PURE__*/_interopNamespaceDefault(s3n);
-var lambda__namespace = /*#__PURE__*/_interopNamespaceDefault(lambda);
 var sqs__namespace = /*#__PURE__*/_interopNamespaceDefault(sqs);
 var lambdaEventSources__namespace = /*#__PURE__*/_interopNamespaceDefault(lambdaEventSources);
-var secretsmanager__namespace = /*#__PURE__*/_interopNamespaceDefault(secretsmanager);
 var sso__namespace = /*#__PURE__*/_interopNamespaceDefault(sso);
 var cloudfront__namespace = /*#__PURE__*/_interopNamespaceDefault(cloudfront);
 var origins__namespace = /*#__PURE__*/_interopNamespaceDefault(origins);
 
+function addDatadogLayer(lambdaFunction, options = {}) {
+    const { datadogApiKeyArn } = options;
+    // Resolve the Datadog API key ARN from multiple sources
+    const resolvedDatadogApiKeyArn = datadogApiKeyArn ||
+        process.env.DATADOG_API_KEY_ARN ||
+        process.env.CDK_ENV_DATADOG_API_KEY_ARN;
+    // Return false if no API key is found
+    if (!resolvedDatadogApiKeyArn) {
+        return false;
+    }
+    const stack = cdk.Stack.of(lambdaFunction);
+    // Create Datadog Node.js layer
+    const datadogNodeLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(stack, `DatadogNodeLayer-${lambdaFunction.node.id}`, `arn:aws:lambda:${stack.region}:464622532012:layer:Datadog-Node20-x:${cdk$1.CDK.DATADOG.LAYER.NODE}`);
+    // Create Datadog Extension layer
+    const datadogExtensionLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(stack, `DatadogExtensionLayer-${lambdaFunction.node.id}`, `arn:aws:lambda:${stack.region}:464622532012:layer:Datadog-Extension:${cdk$1.CDK.DATADOG.LAYER.EXTENSION}`);
+    // Add layers to the lambda function
+    lambdaFunction.addLayers(datadogNodeLayer, datadogExtensionLayer);
+    // Define Datadog environment variables
+    const datadogEnvVars = {
+        DD_API_KEY_SECRET_ARN: resolvedDatadogApiKeyArn,
+        DD_ENHANCED_METRICS: "true",
+        DD_ENV: process.env.PROJECT_ENV || "",
+        DD_PROFILING_ENABLED: "false",
+        DD_SERVERLESS_APPSEC_ENABLED: "false",
+        DD_SERVICE: process.env.PROJECT_SERVICE || "",
+        DD_SITE: cdk$1.CDK.DATADOG.SITE,
+        DD_TAGS: `${cdk$1.CDK.TAG.SPONSOR}:${process.env.PROJECT_SPONSOR || ""}`,
+        DD_TRACE_OTEL_ENABLED: "false",
+    };
+    // Add environment variables only if they don't already exist
+    Object.entries(datadogEnvVars).forEach(([key, value]) => {
+        if (lambdaFunction.environment[key] === undefined) {
+            lambdaFunction.addEnvironment(key, value);
+        }
+    });
+    // Grant Datadog API key read permission
+    const datadogApiKey = secretsmanager__namespace.Secret.fromSecretCompleteArn(stack, `DatadogApiKeyGrant-${lambdaFunction.node.id}`, resolvedDatadogApiKeyArn);
+    datadogApiKey.grantRead(lambdaFunction);
+    return true;
+}
+
+function addParamsAndSecrets(lambdaFunction, options = {}) {
+    const { paramsAndSecrets, paramsAndSecretsOptions } = options;
+    // Return false if explicitly disabled
+    if (paramsAndSecrets === false) {
+        return false;
+    }
+    const stack = cdk.Stack.of(lambdaFunction);
+    let resolvedLayer = undefined;
+    if (paramsAndSecrets instanceof lambda__namespace.ParamsAndSecretsLayerVersion) {
+        // For custom ParamsAndSecretsLayerVersion, we need to extract the ARN
+        // This is a workaround since ParamsAndSecretsLayerVersion doesn't implement ILayerVersion
+        const layerArn = `arn:aws:lambda:${stack.region}:017000801446:layer:AWSLambdaParametersAndSecrets:${lambda__namespace.ParamsAndSecretsVersions.V1_0_103}`;
+        resolvedLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(stack, `ParamsAndSecretsLayer-${lambdaFunction.node.id}`, layerArn);
+        // Set environment variables for configuration
+        if (paramsAndSecretsOptions?.cacheSize) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_CACHE_SIZE", paramsAndSecretsOptions.cacheSize.toString());
+        }
+        if (paramsAndSecretsOptions?.logLevel) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_LOG_LEVEL", paramsAndSecretsOptions.logLevel);
+        }
+        if (paramsAndSecretsOptions?.parameterStoreTtl) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_PARAMETER_STORE_TTL", paramsAndSecretsOptions.parameterStoreTtl.toString());
+        }
+        if (paramsAndSecretsOptions?.secretsManagerTtl) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_SECRETS_MANAGER_TTL", paramsAndSecretsOptions.secretsManagerTtl.toString());
+        }
+    }
+    else {
+        // Create default ParamsAndSecrets layer using LayerVersion.fromLayerVersionArn
+        const layerArn = `arn:aws:lambda:${stack.region}:017000801446:layer:AWSLambdaParametersAndSecrets:${lambda__namespace.ParamsAndSecretsVersions.V1_0_103}`;
+        resolvedLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(stack, `ParamsAndSecretsLayer-${lambdaFunction.node.id}`, layerArn);
+        // Set default environment variables
+        if (paramsAndSecretsOptions?.cacheSize) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_CACHE_SIZE", paramsAndSecretsOptions.cacheSize.toString());
+        }
+        const logLevel = paramsAndSecretsOptions?.logLevel || lambda__namespace.ParamsAndSecretsLogLevel.WARN;
+        lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_LOG_LEVEL", logLevel);
+        if (paramsAndSecretsOptions?.parameterStoreTtl) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_PARAMETER_STORE_TTL", paramsAndSecretsOptions.parameterStoreTtl.toString());
+        }
+        if (paramsAndSecretsOptions?.secretsManagerTtl) {
+            lambdaFunction.addEnvironment("PARAMETERS_SECRETS_EXTENSION_SECRETS_MANAGER_TTL", paramsAndSecretsOptions.secretsManagerTtl.toString());
+        }
+    }
+    // Add the layer to the lambda function
+    if (resolvedLayer) {
+        lambdaFunction.addLayers(resolvedLayer);
+        return true;
+    }
+    return false;
+}
+
 function constructEnvName(name, opts) {
     const env = opts?.env ?? process.env.PROJECT_ENV ?? "build";
     const key = opts?.key ?? process.env.PROJECT_KEY ?? "project";
@@ -155,6 +248,72 @@ function isSandboxEnv() {
     return isEnv(cdk$1.CDK.ENV.SANDBOX);
 }
 
+function jaypieLambdaEnv(options = {}) {
+    const { initialEnvironment = {} } = options;
+    // Start with empty environment - we'll only add valid values
+    let environment = {};
+    // First, add all valid string values from initialEnvironment
+    Object.entries(initialEnvironment).forEach(([key, value]) => {
+        if (typeof value === "string") {
+            environment[key] = value;
+        }
+    });
+    // Default environment values
+    const defaultEnvValues = {
+        AWS_LAMBDA_NODEJS_DISABLE_CALLBACK_WARNING: "true",
+    };
+    // Apply default environment values with user overrides
+    Object.entries(defaultEnvValues).forEach(([key, defaultValue]) => {
+        if (key in initialEnvironment) {
+            const userValue = initialEnvironment[key];
+            // If user passes a string, it's already added above
+            // If user passes non-string falsy value, omit the key
+            if (!userValue) {
+                delete environment[key];
+            }
+            // Ignore non-string truthy values (key not added)
+        }
+        else {
+            // No user override, use default value
+            environment[key] = defaultValue;
+        }
+    });
+    // Default environment variables from process.env if present
+    const defaultEnvVars = [
+        "DATADOG_API_KEY_ARN",
+        "LOG_LEVEL",
+        "MODULE_LOGGER",
+        "MODULE_LOG_LEVEL",
+        "PROJECT_CHAOS",
+        "PROJECT_COMMIT",
+        "PROJECT_ENV",
+        "PROJECT_KEY",
+        "PROJECT_SECRET",
+        "PROJECT_SERVICE",
+        "PROJECT_SPONSOR",
+        "PROJECT_VERSION",
+    ];
+    // Add default environment variables if they exist in process.env
+    defaultEnvVars.forEach((envVar) => {
+        if (process.env[envVar] && !environment[envVar]) {
+            environment[envVar] = process.env[envVar];
+        }
+    });
+    return environment;
+}
+
+function resolveHostedZone(scope, { name = "HostedZone", zone = process.env.CDK_ENV_HOSTED_ZONE, }) {
+    if (!zone) {
+        throw new cdk$1.ConfigurationError("No `zone` provided. Set CDK_ENV_HOSTED_ZONE to use environment zone");
+    }
+    if (typeof zone === "string") {
+        return route53__namespace.HostedZone.fromLookup(scope, name, {
+            domainName: zone,
+        });
+    }
+    return zone;
+}
+
 class JaypieApiGateway extends constructs.Construct {
     constructor(scope, id, props) {
         super(scope, id);
@@ -181,14 +340,7 @@ class JaypieApiGateway extends constructs.Construct {
         let hostedZone;
         let certificateToUse;
         if (host && zone) {
-            if (typeof zone === "string") {
-                hostedZone = route53__namespace.HostedZone.fromLookup(this, "HostedZone", {
-                    domainName: zone,
-                });
-            }
-            else {
-                hostedZone = zone;
-            }
+            hostedZone = resolveHostedZone(this, { zone });
             if (certificate === true) {
                 certificateToUse = new acm__namespace.Certificate(this, certificateName, {
                     domainName: host,
@@ -339,102 +491,11 @@ class JaypieLambda extends constructs.Construct {
     constructor(scope, id, props) {
         super(scope, id);
         const { allowAllOutbound, allowPublicSubnet, architecture = lambda__namespace.Architecture.X86_64, code, codeSigningConfig, datadogApiKeyArn, deadLetterQueue, deadLetterQueueEnabled, deadLetterTopic, description, environment: initialEnvironment = {}, environmentEncryption, envSecrets = {}, ephemeralStorageSize, filesystem, handler = "index.handler", initialPolicy, layers = [], logRetention = cdk$1.CDK.LAMBDA.LOG_RETENTION, logRetentionRole, logRetentionRetryOptions, maxEventAge, memorySize = cdk$1.CDK.LAMBDA.MEMORY_SIZE, paramsAndSecrets, paramsAndSecretsOptions, profiling, profilingGroup, provisionedConcurrentExecutions, reservedConcurrentExecutions, retryAttempts, roleTag = cdk$1.CDK.ROLE.PROCESSING, runtime = lambda__namespace.Runtime.NODEJS_22_X, runtimeManagementMode, secrets = [], securityGroups, timeout = cdk.Duration.seconds(cdk$1.CDK.DURATION.LAMBDA_WORKER), tracing, vendorTag, vpc, vpcSubnets, } = props;
-        // Create a mutable copy of the environment variables
-        let environment = { ...initialEnvironment };
-        // Default environment values
-        const defaultEnvValues = {
-            AWS_LAMBDA_NODEJS_DISABLE_CALLBACK_WARNING: "true",
-        };
-        // Apply default environment values with user overrides
-        Object.entries(defaultEnvValues).forEach(([key, defaultValue]) => {
-            if (key in initialEnvironment) {
-                const userValue = initialEnvironment[key];
-                // If user passes a string, use that value
-                if (typeof userValue === "string") {
-                    environment[key] = userValue;
-                }
-                // If user passes non-string falsy value, omit the key
-                else if (!userValue) {
-                    delete environment[key];
-                }
-                // Ignore non-string truthy values (key already not present)
-            }
-            else {
-                // No user override, use default value
-                environment[key] = defaultValue;
-            }
-        });
-        // Default environment variables from process.env if present
-        const defaultEnvVars = [
-            "DATADOG_API_KEY_ARN",
-            "LOG_LEVEL",
-            "MODULE_LOGGER",
-            "MODULE_LOG_LEVEL",
-            "PROJECT_COMMIT",
-            "PROJECT_ENV",
-            "PROJECT_KEY",
-            "PROJECT_SECRET",
-            "PROJECT_SERVICE",
-            "PROJECT_SPONSOR",
-            "PROJECT_VERSION",
-        ];
-        // Add default environment variables if they exist in process.env
-        defaultEnvVars.forEach((envVar) => {
-            if (process.env[envVar] && !environment[envVar]) {
-                environment[envVar] = process.env[envVar];
-            }
-        });
+        // Get base environment with defaults
+        const environment = jaypieLambdaEnv({ initialEnvironment });
         const codeAsset = typeof code === "string" ? lambda__namespace.Code.fromAsset(code) : code;
         // Create a working copy of layers
         const resolvedLayers = [...layers];
-        // Determine if we should add Datadog integration
-        // Check for datadog API key ARN in different sources
-        const resolvedDatadogApiKeyArn = datadogApiKeyArn ||
-            process.env.DATADOG_API_KEY_ARN ||
-            process.env.CDK_ENV_DATADOG_API_KEY_ARN;
-        // Add Datadog integration if API key is available
-        if (resolvedDatadogApiKeyArn) {
-            // Add Datadog Node.js layer
-            const datadogNodeLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(this, "DatadogNodeLayer", `arn:aws:lambda:${cdk.Stack.of(this).region}:464622532012:layer:Datadog-Node20-x:${cdk$1.CDK.DATADOG.LAYER.NODE}`);
-            resolvedLayers.push(datadogNodeLayer);
-            // Add Datadog Extension layer
-            const datadogExtensionLayer = lambda__namespace.LayerVersion.fromLayerVersionArn(this, "DatadogExtensionLayer", `arn:aws:lambda:${cdk.Stack.of(this).region}:464622532012:layer:Datadog-Extension:${cdk$1.CDK.DATADOG.LAYER.EXTENSION}`);
-            resolvedLayers.push(datadogExtensionLayer);
-            // Set Datadog environment variables
-            Object.assign(environment, {
-                DD_API_KEY_SECRET_ARN: resolvedDatadogApiKeyArn,
-                DD_ENHANCED_METRICS: "true",
-                DD_ENV: process.env.PROJECT_ENV || "",
-                DD_PROFILING_ENABLED: "false",
-                DD_SERVERLESS_APPSEC_ENABLED: "false",
-                DD_SERVICE: process.env.PROJECT_SERVICE || "",
-                DD_SITE: cdk$1.CDK.DATADOG.SITE,
-                DD_TAGS: `${cdk$1.CDK.TAG.SPONSOR}:${process.env.PROJECT_SPONSOR || ""}`,
-                DD_TRACE_OTEL_ENABLED: "false",
-            });
-        }
-        // Configure ParamsAndSecrets layer
-        let resolvedParamsAndSecrets = undefined;
-        if (paramsAndSecrets !== false) {
-            if (paramsAndSecrets instanceof lambda__namespace.ParamsAndSecretsLayerVersion) {
-                resolvedParamsAndSecrets = paramsAndSecrets;
-            }
-            else {
-                // Create default ParamsAndSecrets layer
-                resolvedParamsAndSecrets =
-                    lambda__namespace.ParamsAndSecretsLayerVersion.fromVersion(lambda__namespace.ParamsAndSecretsVersions.V1_0_103, {
-                        cacheSize: paramsAndSecretsOptions?.cacheSize,
-                        logLevel: paramsAndSecretsOptions?.logLevel ||
-                            lambda__namespace.ParamsAndSecretsLogLevel.WARN,
-                        parameterStoreTtl: paramsAndSecretsOptions?.parameterStoreTtl
-                            ? cdk.Duration.seconds(paramsAndSecretsOptions.parameterStoreTtl)
-                            : undefined,
-                        secretsManagerTtl: paramsAndSecretsOptions?.secretsManagerTtl
-                            ? cdk.Duration.seconds(paramsAndSecretsOptions.secretsManagerTtl)
-                            : undefined,
-                    });
-            }
-        }
         // Process secrets environment variables
         const secretsEnvironment = Object.entries(envSecrets).reduce((acc, [key, secret]) => ({
             ...acc,
@@ -477,7 +538,6 @@ class JaypieLambda extends constructs.Construct {
             logRetentionRetryOptions,
             maxEventAge,
             memorySize,
-            paramsAndSecrets: resolvedParamsAndSecrets,
             profiling,
             profilingGroup,
             reservedConcurrentExecutions,
@@ -498,6 +558,13 @@ class JaypieLambda extends constructs.Construct {
                 }
                 : undefined,
         });
+        // Add ParamsAndSecrets layer if configured
+        addParamsAndSecrets(this._lambda, {
+            paramsAndSecrets,
+            paramsAndSecretsOptions,
+        });
+        // Add Datadog layers and environment variables if configured
+        addDatadogLayer(this._lambda, { datadogApiKeyArn });
         // Grant secret read permissions
         Object.values(envSecrets).forEach((secret) => {
             secret.grantRead(this._lambda);
@@ -506,11 +573,6 @@ class JaypieLambda extends constructs.Construct {
         secrets.forEach((secret) => {
             secret.grantRead(this._lambda);
         });
-        // Grant Datadog API key read permission if applicable
-        if (resolvedDatadogApiKeyArn) {
-            const datadogApiKey = secretsmanager__namespace.Secret.fromSecretCompleteArn(this, "DatadogApiKeyGrant", resolvedDatadogApiKeyArn);
-            datadogApiKey.grantRead(this._lambda);
-        }
         // Configure provisioned concurrency if specified
         if (provisionedConcurrentExecutions !== undefined) {
             // Use currentVersion which is auto-published with proper configuration
@@ -1820,6 +1882,8 @@ exports.JaypieSsoGroups = JaypieSsoGroups;
 exports.JaypieStack = JaypieStack;
 exports.JaypieTraceSigningKeySecret = JaypieTraceSigningKeySecret;
 exports.JaypieWebDeploymentBucket = JaypieWebDeploymentBucket;
+exports.addDatadogLayer = addDatadogLayer;
+exports.addParamsAndSecrets = addParamsAndSecrets;
 exports.constructEnvName = constructEnvName;
 exports.constructStackName = constructStackName;
 exports.constructTagger = constructTagger;
@@ -1827,4 +1891,6 @@ exports.envHostname = envHostname;
 exports.isEnv = isEnv;
 exports.isProductionEnv = isProductionEnv;
 exports.isSandboxEnv = isSandboxEnv;
+exports.jaypieLambdaEnv = jaypieLambdaEnv;
+exports.resolveHostedZone = resolveHostedZone;
 //# sourceMappingURL=index.cjs.map