@kensio/yulin 0.34.0 → 0.35.0

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code-factory.js

@@ -22,11 +22,7 @@ export class SimLambdaVmZipCodeFactory {
         return new SimLambdaVmZipCode({
             archive: this.unzip(zipBytes),
             handlerName: context.handlerName,
-            environment: {
-                functionName: context.functionName,
-                regionName: context.regionName,
-                memorySizeMb: context.memorySizeMb,
-            },
+            environment: context.environment,
             sdkModuleProvider: this.vmSdkModuleProvider,
         });
     }

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-lambda-vm-zip-code-factory.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,uCAAuC,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE;;;;;;GAMG;AACH,MAAM,OAAO,yBAAyB;IACnB,mBAAmB,CACO;IAE3C,YAAY,UAA+C;QACzD,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAAoB,EACpB,OAAoC;QAEpC,aAAa,CACX,OAAO,CAAC,WAAW,EACnB,oEAAoE,CACrE,CAAC;QAEF,OAAO,IAAI,kBAAkB,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE;gBACX,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC;YACD,iBAAiB,EAAE,IAAI,CAAC,mBAAmB;SAC5C,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,QAAoB;QAChC,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uCAAuC,CAC/C,yDAAyD;gBACvD,2BAA2B,EAC7B,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"sim-lambda-vm-zip-code-factory.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,uCAAuC,EAAE,MAAM,iCAAiC,CAAC;AAE1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE;;;;;;GAMG;AACH,MAAM,OAAO,yBAAyB;IACnB,mBAAmB,CACO;IAE3C,YAAY,UAA+C;QACzD,IAAI,CAAC,mBAAmB,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,IAAI,CACF,QAAoB,EACpB,OAAoC;QAEpC,aAAa,CACX,OAAO,CAAC,WAAW,EACnB,oEAAoE,CACrE,CAAC;QAEF,OAAO,IAAI,kBAAkB,CAAC;YAC5B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,iBAAiB,EAAE,IAAI,CAAC,mBAAmB;SAC5C,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,QAAoB;QAChC,IAAI,CAAC;YACH,OAAO,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,uCAAuC,CAC/C,yDAAyD;gBACvD,2BAA2B,EAC7B,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code.d.ts

@@ -1,12 +1,12 @@
 import type { SimZipArchive } from "../../../../util/zip/zip-archive.js";
 import type { SimLambdaHandler } from "../sim-lambda-handler.type.js";
 import { type SimLambdaVmSdkModuleProvider } from "./vm/sdk/sim-lambda-vm-sdk-module-provider.js";
+import type { SimLambdaEnvironment } from "../environment/sim-lambda-environment.js";
 import type { SimLambdaExecutableCode } from "./sim-lambda-executable-code.js";
-import { type SimLambdaVmEnvironment } from "./vm/sim-lambda-vm-context.js";
 interface SimLambdaVmZipCodeProperties {
     readonly archive: SimZipArchive;
     readonly handlerName: string;
-    readonly environment: SimLambdaVmEnvironment;
+    readonly environment: SimLambdaEnvironment;
     readonly sdkModuleProvider?: SimLambdaVmSdkModuleProvider | undefined;
 }
 interface ParsedHandlerName {
@@ -38,6 +38,10 @@ export declare class SimLambdaVmZipCode implements SimLambdaExecutableCode {
     /**
      * Look up the handler export, tolerating a module that exported a nullish
      * value so the lookup still reports Runtime.HandlerNotFound.
+     *
+     * Only own exports count. Walking the prototype chain would let a handler
+     * name like `index.constructor` resolve to an `Object.prototype` member and
+     * be invoked as the handler, where real Lambda reports HandlerNotFound.
      */
     private exportedHandler;
     private importHandlerModule;

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-lambda-vm-zip-code.d.ts","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AAGvC,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CACvE;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAY7E;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,uBAAuB;;IAGpD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAvC,YAA6B,UAAU,EAAE,4BAA4B,EAAI;IAEzE;;OAEG;IACH,eAAe,IAAI,gBAAgB,CAGlC;IAED,OAAO,CAAC,SAAS;IA0BjB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,mBAAmB;CAiB5B"}
+{"version":3,"file":"sim-lambda-vm-zip-code.d.ts","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAI/E,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CACvE;AAED,UAAU,iBAAiB;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAY7E;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,uBAAuB;;IAGpD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAvC,YAA6B,UAAU,EAAE,4BAA4B,EAAI;IAEzE;;OAEG;IACH,eAAe,IAAI,gBAAgB,CAGlC;IAED,OAAO,CAAC,SAAS;IA0BjB;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,mBAAmB;CAiB5B"}

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code.js

@@ -1,6 +1,6 @@
 import { SimLambdaRuntimeError } from "../../error/sim-lambda-runtime.error.js";
 import { SimLambdaNoVmSdkModuleProvider, } from "./vm/sdk/sim-lambda-vm-sdk-module-provider.js";
-import { makeSimLambdaVmContext, } from "./vm/sim-lambda-vm-context.js";
+import { makeSimLambdaVmContext } from "./vm/sim-lambda-vm-context.js";
 import { SimLambdaVmModules } from "./vm/sim-lambda-vm-modules.js";
 /**
  * Parse an AWS Lambda handler identifier such as "index.handler" or
@@ -55,12 +55,20 @@ export class SimLambdaVmZipCode {
     /**
      * Look up the handler export, tolerating a module that exported a nullish
      * value so the lookup still reports Runtime.HandlerNotFound.
+     *
+     * Only own exports count. Walking the prototype chain would let a handler
+     * name like `index.constructor` resolve to an `Object.prototype` member and
+     * be invoked as the handler, where real Lambda reports HandlerNotFound.
      */
     exportedHandler(moduleExports, exportName) {
         if (moduleExports === null || moduleExports === undefined) {
             return undefined;
         }
-        return moduleExports[exportName];
+        const exportedValues = moduleExports;
+        if (!Object.hasOwn(exportedValues, exportName)) {
+            return undefined;
+        }
+        return Reflect.get(exportedValues, exportName);
     }
     importHandlerModule(modules, modulePath) {
         try {

package/dist/service/lambda/function/code/sim-lambda-vm-zip-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-lambda-vm-zip-code.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sim-lambda-vm-zip-code.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/code/sim-lambda-vm-zip-code.ts"],"names":[],"mappings":"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"}

package/dist/service/lambda/function/code/vm/sim-lambda-vm-context.d.ts

@@ -1,20 +1,17 @@
 import vm from "node:vm";
-/**
- * The AWS-like execution environment details exposed to sim Lambda function
- * code running in a vm context.
- */
-export interface SimLambdaVmEnvironment {
-    readonly functionName: string;
-    readonly regionName: string;
-    readonly memorySizeMb: number;
-}
+import type { SimLambdaEnvironment } from "../../environment/sim-lambda-environment.js";
 /**
  * Create the sandbox vm context that sim Lambda function code runs in.
  *
  * The context provides the common globals a Node.js Lambda runtime offers,
- * including an AWS-like process.env with the standard runtime variables.
- * Everything else must be part of the deployed function code archive, as on
- * real Lambda.
+ * including an AWS-like process.env holding the standard runtime variables
+ * and any variables declared for the function. Everything else must be part
+ * of the deployed function code archive, as on real Lambda.
+ *
+ * Zip code needs nothing like the process.env handling the in-process handler
+ * path does: this sandbox already owns its process object, so the host
+ * environment is invisible here whether or not the function declares
+ * variables of its own.
  */
-export declare function makeSimLambdaVmContext(environment: SimLambdaVmEnvironment): vm.Context;
+export declare function makeSimLambdaVmContext(environment: SimLambdaEnvironment): vm.Context;
 //# sourceMappingURL=sim-lambda-vm-context.d.ts.map

package/dist/service/lambda/function/code/vm/sim-lambda-vm-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-lambda-vm-context.d.ts","sourceRoot":"","sources":["../../../../../../src/service/lambda/function/code/vm/sim-lambda-vm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAiBD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,sBAAsB,GAClC,EAAE,CAAC,OAAO,CAoBZ"}
+{"version":3,"file":"sim-lambda-vm-context.d.ts","sourceRoot":"","sources":["../../../../../../src/service/lambda/function/code/vm/sim-lambda-vm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAExF;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,oBAAoB,GAChC,EAAE,CAAC,OAAO,CAoBZ"}

package/dist/service/lambda/function/code/vm/sim-lambda-vm-context.js

@@ -1,30 +1,23 @@
 import vm from "node:vm";
-/**
- * Build the AWS-like standard runtime environment variables.
- */
-function runtimeEnvironmentVariables(environment) {
-    return Object.fromEntries([
-        ["AWS_REGION", environment.regionName],
-        ["AWS_DEFAULT_REGION", environment.regionName],
-        ["AWS_LAMBDA_FUNCTION_NAME", environment.functionName],
-        ["AWS_LAMBDA_FUNCTION_MEMORY_SIZE", String(environment.memorySizeMb)],
-        ["AWS_LAMBDA_FUNCTION_VERSION", "$LATEST"],
-    ]);
-}
 /**
  * Create the sandbox vm context that sim Lambda function code runs in.
  *
  * The context provides the common globals a Node.js Lambda runtime offers,
- * including an AWS-like process.env with the standard runtime variables.
- * Everything else must be part of the deployed function code archive, as on
- * real Lambda.
+ * including an AWS-like process.env holding the standard runtime variables
+ * and any variables declared for the function. Everything else must be part
+ * of the deployed function code archive, as on real Lambda.
+ *
+ * Zip code needs nothing like the process.env handling the in-process handler
+ * path does: this sandbox already owns its process object, so the host
+ * environment is invisible here whether or not the function declares
+ * variables of its own.
  */
 export function makeSimLambdaVmContext(environment) {
     return vm.createContext({
         console,
         Buffer,
         process: {
-            env: runtimeEnvironmentVariables(environment),
+            env: environment.variables(),
         },
         setTimeout,
         clearTimeout,

package/dist/service/lambda/function/code/vm/sim-lambda-vm-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-lambda-vm-context.js","sourceRoot":"","sources":["../../../../../../src/service/lambda/function/code/vm/sim-lambda-vm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAYzB;;GAEG;AACH,SAAS,2BAA2B,CAClC,WAAmC;IAEnC,OAAO,MAAM,CAAC,WAAW,CAAC;QACxB,CAAC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC;QACtC,CAAC,oBAAoB,EAAE,WAAW,CAAC,UAAU,CAAC;QAC9C,CAAC,0BAA0B,EAAE,WAAW,CAAC,YAAY,CAAC;QACtD,CAAC,iCAAiC,EAAE,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QACrE,CAAC,6BAA6B,EAAE,SAAS,CAAC;KAC3C,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmC;IAEnC,OAAO,EAAE,CAAC,aAAa,CAAC;QACtB,OAAO;QACP,MAAM;QACN,OAAO,EAAE;YACP,GAAG,EAAE,2BAA2B,CAAC,WAAW,CAAC;SAC9C;QACD,UAAU;QACV,YAAY;QACZ,WAAW;QACX,aAAa;QACb,YAAY;QACZ,cAAc;QACd,WAAW;QACX,WAAW;QACX,GAAG;QACH,eAAe;QACf,eAAe;QACf,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"sim-lambda-vm-context.js","sourceRoot":"","sources":["../../../../../../src/service/lambda/function/code/vm/sim-lambda-vm-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAiC;IAEjC,OAAO,EAAE,CAAC,aAAa,CAAC;QACtB,OAAO;QACP,MAAM;QACN,OAAO,EAAE;YACP,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE;SAC7B;QACD,UAAU;QACV,YAAY;QACZ,WAAW;QACX,aAAa;QACb,YAAY;QACZ,cAAc;QACd,WAAW;QACX,WAAW;QACX,GAAG;QACH,eAAe;QACf,eAAe;QACf,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/service/lambda/function/environment/sim-lambda-environment-conflicts.d.ts

@@ -0,0 +1,48 @@
+import type { SimLambdaEnvironment } from "./sim-lambda-environment.js";
+/**
+ * Warns about declared environment variables whose value a handler module
+ * might not actually see.
+ *
+ * A sim Lambda function backed by a real in-process handler only gets its own
+ * process.env while the handler runs, so a variable read at module scope is
+ * read too early (see SimLambdaProcessEnv). That only changes what the code
+ * sees when the value read at module scope differs from the declared one, so
+ * these are the two conditions worth reporting: the host process sets the
+ * same name with a different value, or another simulated function declares
+ * the same name with a different value.
+ *
+ * Staying quiet when the values agree matters as much as warning when they do
+ * not. Test suites commonly export the same variables they configure their
+ * functions with, and in that case a module-scope read gets the right value
+ * anyway and there is nothing to report.
+ */
+export declare class SimLambdaEnvironmentConflicts {
+    /**
+     * Variable names already reported, so repeated function creation does not
+     * repeat the same warning.
+     */
+    private readonly warned;
+    /**
+     * Check a new function's environment against the host process and against
+     * the functions that already exist.
+     */
+    check(environment: SimLambdaEnvironment, existingEnvironments: Iterable<SimLambdaEnvironment>): void;
+    /**
+     * Warn when the host process sets the same name with a different value.
+     */
+    private checkHostProcess;
+    /**
+     * Warn when another simulated function declares the same name with a
+     * different value.
+     */
+    private checkOtherFunctions;
+    /**
+     * Report a conflict once per variable name.
+     *
+     * Warnings go to the console because that is where a test runner surfaces
+     * them next to the failing expectation they explain; the simulator has no
+     * logger of its own to route them through.
+     */
+    private warn;
+}
+//# sourceMappingURL=sim-lambda-environment-conflicts.d.ts.map

package/dist/service/lambda/function/environment/sim-lambda-environment-conflicts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-lambda-environment-conflicts.d.ts","sourceRoot":"","sources":["../../../../../src/service/lambda/function/environment/sim-lambda-environment-conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAQxE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,6BAA6B;IACxC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C;;;OAGG;IACH,KAAK,CACH,WAAW,EAAE,oBAAoB,EACjC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACnD,IAAI,CAKN;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAsB3B;;;;;;OAMG;IACH,OAAO,CAAC,IAAI;CAQb"}

package/dist/service/lambda/function/environment/sim-lambda-environment-conflicts.js

@@ -0,0 +1,84 @@
+import { simLambdaProcessEnvironment } from "./sim-lambda-process-environment.js";
+const moveTheReadAdvice = "A read of process.env at module scope happens when the module is " +
+    "imported, before any invocation, so it sees the host value instead. " +
+    "Move the read inside the handler function.";
+/**
+ * Warns about declared environment variables whose value a handler module
+ * might not actually see.
+ *
+ * A sim Lambda function backed by a real in-process handler only gets its own
+ * process.env while the handler runs, so a variable read at module scope is
+ * read too early (see SimLambdaProcessEnv). That only changes what the code
+ * sees when the value read at module scope differs from the declared one, so
+ * these are the two conditions worth reporting: the host process sets the
+ * same name with a different value, or another simulated function declares
+ * the same name with a different value.
+ *
+ * Staying quiet when the values agree matters as much as warning when they do
+ * not. Test suites commonly export the same variables they configure their
+ * functions with, and in that case a module-scope read gets the right value
+ * anyway and there is nothing to report.
+ */
+export class SimLambdaEnvironmentConflicts {
+    /**
+     * Variable names already reported, so repeated function creation does not
+     * repeat the same warning.
+     */
+    warned = new Set();
+    /**
+     * Check a new function's environment against the host process and against
+     * the functions that already exist.
+     */
+    check(environment, existingEnvironments) {
+        for (const [name, value] of environment.declaredVariables) {
+            this.checkHostProcess(environment, name, value);
+            this.checkOtherFunctions(environment, name, value, existingEnvironments);
+        }
+    }
+    /**
+     * Warn when the host process sets the same name with a different value.
+     */
+    checkHostProcess(environment, name, value) {
+        // Read-only lookup of a name the function itself declared.
+        // eslint-disable-next-line security/detect-object-injection
+        const hostValue = simLambdaProcessEnvironment.hostVariables()[name];
+        if (hostValue === undefined || hostValue === value) {
+            return;
+        }
+        this.warn(`host:${name}`, `Sim Lambda function "${environment.functionName}" declares ` +
+            `environment variable ${name}, which the host process also sets ` +
+            `with a different value. ${moveTheReadAdvice}`);
+    }
+    /**
+     * Warn when another simulated function declares the same name with a
+     * different value.
+     */
+    checkOtherFunctions(environment, name, value, existingEnvironments) {
+        for (const existing of existingEnvironments) {
+            const existingValue = existing.declaredVariables.get(name);
+            if (existingValue === undefined || existingValue === value) {
+                continue;
+            }
+            this.warn(`function:${name}`, `Sim Lambda functions "${existing.functionName}" and ` +
+                `"${environment.functionName}" declare different values for ` +
+                `environment variable ${name}. ${moveTheReadAdvice}`);
+            return;
+        }
+    }
+    /**
+     * Report a conflict once per variable name.
+     *
+     * Warnings go to the console because that is where a test runner surfaces
+     * them next to the failing expectation they explain; the simulator has no
+     * logger of its own to route them through.
+     */
+    warn(key, message) {
+        if (this.warned.has(key)) {
+            return;
+        }
+        this.warned.add(key);
+        // eslint-disable-next-line no-console
+        console.warn(message);
+    }
+}
+//# sourceMappingURL=sim-lambda-environment-conflicts.js.map

package/dist/service/lambda/function/environment/sim-lambda-environment-conflicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-lambda-environment-conflicts.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/environment/sim-lambda-environment-conflicts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,MAAM,iBAAiB,GACrB,mEAAmE;IACnE,sEAAsE;IACtE,4CAA4C,CAAC;AAE/C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,6BAA6B;IACxC;;;OAGG;IACc,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C;;;OAGG;IACH,KAAK,CACH,WAAiC,EACjC,oBAAoD;QAEpD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC,iBAAiB,EAAE,CAAC;YAC1D,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,oBAAoB,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,WAAiC,EACjC,IAAY,EACZ,KAAa;QAEb,2DAA2D;QAC3D,4DAA4D;QAC5D,MAAM,SAAS,GAAG,2BAA2B,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CACP,QAAQ,IAAI,EAAE,EACd,wBAAwB,WAAW,CAAC,YAAY,aAAa;YAC3D,wBAAwB,IAAI,qCAAqC;YACjE,2BAA2B,iBAAiB,EAAE,CACjD,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB,CACzB,WAAiC,EACjC,IAAY,EACZ,KAAa,EACb,oBAAoD;QAEpD,KAAK,MAAM,QAAQ,IAAI,oBAAoB,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;gBAC3D,SAAS;YACX,CAAC;YAED,IAAI,CAAC,IAAI,CACP,YAAY,IAAI,EAAE,EAClB,yBAAyB,QAAQ,CAAC,YAAY,QAAQ;gBACpD,IAAI,WAAW,CAAC,YAAY,iCAAiC;gBAC7D,wBAAwB,IAAI,KAAK,iBAAiB,EAAE,CACvD,CAAC;YACF,OAAO;QACT,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,IAAI,CAAC,GAAW,EAAE,OAAe;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/service/lambda/function/environment/sim-lambda-environment.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The function details the AWS-provided runtime environment variables are
+ * built from.
+ */
+export interface SimLambdaEnvironmentDetails {
+    readonly functionName: string;
+    readonly regionName: string;
+    readonly memorySizeMb: number;
+}
+interface SimLambdaEnvironmentProperties extends SimLambdaEnvironmentDetails {
+    readonly declaredVariables?: ReadonlyMap<string, string> | undefined;
+}
+/**
+ * The environment a sim Lambda function runs with.
+ *
+ * Combines the AWS-provided runtime variables with the variables declared for
+ * the function through Environment.Variables. Declared variables cannot
+ * shadow the runtime ones: real Lambda rejects the reserved names at
+ * CreateFunction, so the two sets never collide by the time they get here.
+ */
+export declare class SimLambdaEnvironment {
+    #private;
+    private readonly details;
+    private readonly declared;
+    constructor(properties: SimLambdaEnvironmentProperties);
+    /**
+     * Whether any variables were declared for this function.
+     *
+     * A function with no declared variables needs no environment of its own, so
+     * callers can leave the host process environment alone entirely.
+     */
+    get hasDeclaredVariables(): boolean;
+    /**
+     * The variables declared for this function, without the AWS-provided ones.
+     */
+    get declaredVariables(): ReadonlyMap<string, string>;
+    /**
+     * The name of the function this environment belongs to.
+     */
+    get functionName(): string;
+    /**
+     * The declared variables as AWS reports them in function configuration.
+     *
+     * Real Lambda leaves Environment off the configuration entirely for a
+     * function that declares none.
+     */
+    configuration(): {
+        Variables: Record<string, string>;
+    } | undefined;
+    /**
+     * Run function code with this environment applied to process.env.
+     *
+     * A function that declares nothing is left reading the host process
+     * environment, exactly as before: there is nothing of its own to give it,
+     * so there is no reason to touch process.env at all. Zip code running in a
+     * vm context takes its variables from the sandbox instead, and is
+     * unaffected either way.
+     */
+    runWith<T>(run: () => Promise<T>): Promise<T>;
+    /**
+     * The complete process.env-shaped variables the function code sees.
+     */
+    variables(): Record<string, string>;
+    /**
+     * The AWS-like standard runtime environment variables.
+     */
+    private runtimeVariables;
+}
+export {};
+//# sourceMappingURL=sim-lambda-environment.d.ts.map

package/dist/service/lambda/function/environment/sim-lambda-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-lambda-environment.d.ts","sourceRoot":"","sources":["../../../../../src/service/lambda/function/environment/sim-lambda-environment.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,UAAU,8BAA+B,SAAQ,2BAA2B;IAC1E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAYvD,YAAY,UAAU,EAAE,8BAA8B,EAIrD;IAED;;;;;OAKG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAElC;IAED;;OAEG;IACH,IAAI,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAEnD;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;OAKG;IACH,aAAa,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,SAAS,CAMjE;IAED;;;;;;;;OAQG;IACG,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMlD;IAED;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMlC;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/service/lambda/function/environment/sim-lambda-environment.js

@@ -0,0 +1,102 @@
+import { simLambdaProcessEnvironment } from "./sim-lambda-process-environment.js";
+/**
+ * The environment a sim Lambda function runs with.
+ *
+ * Combines the AWS-provided runtime variables with the variables declared for
+ * the function through Environment.Variables. Declared variables cannot
+ * shadow the runtime ones: real Lambda rejects the reserved names at
+ * CreateFunction, so the two sets never collide by the time they get here.
+ */
+export class SimLambdaEnvironment {
+    details;
+    declared;
+    /**
+     * The merged variables, built once and then reused.
+     *
+     * Reusing one object gives the warm execution environment semantics of real
+     * Lambda: a write to process.env inside a handler is still visible to the
+     * next invocation of the same function, and is discarded when the function
+     * goes away.
+     */
+    #variables;
+    constructor(properties) {
+        const { declaredVariables, ...details } = properties;
+        this.details = details;
+        this.declared = declaredVariables ?? new Map();
+    }
+    /**
+     * Whether any variables were declared for this function.
+     *
+     * A function with no declared variables needs no environment of its own, so
+     * callers can leave the host process environment alone entirely.
+     */
+    get hasDeclaredVariables() {
+        return this.declared.size > 0;
+    }
+    /**
+     * The variables declared for this function, without the AWS-provided ones.
+     */
+    get declaredVariables() {
+        return this.declared;
+    }
+    /**
+     * The name of the function this environment belongs to.
+     */
+    get functionName() {
+        return this.details.functionName;
+    }
+    /**
+     * The declared variables as AWS reports them in function configuration.
+     *
+     * Real Lambda leaves Environment off the configuration entirely for a
+     * function that declares none.
+     */
+    configuration() {
+        if (!this.hasDeclaredVariables) {
+            return undefined;
+        }
+        return { Variables: Object.fromEntries(this.declared) };
+    }
+    /**
+     * Run function code with this environment applied to process.env.
+     *
+     * A function that declares nothing is left reading the host process
+     * environment, exactly as before: there is nothing of its own to give it,
+     * so there is no reason to touch process.env at all. Zip code running in a
+     * vm context takes its variables from the sandbox instead, and is
+     * unaffected either way.
+     */
+    async runWith(run) {
+        if (!this.hasDeclaredVariables) {
+            return await run();
+        }
+        return await simLambdaProcessEnvironment.run(this.variables(), run);
+    }
+    /**
+     * The complete process.env-shaped variables the function code sees.
+     */
+    variables() {
+        this.#variables ??= {
+            ...this.runtimeVariables(),
+            ...Object.fromEntries(this.declared),
+        };
+        return this.#variables;
+    }
+    /**
+     * The AWS-like standard runtime environment variables.
+     */
+    runtimeVariables() {
+        const { functionName, regionName, memorySizeMb } = this.details;
+        // Built from entries rather than an object literal because AWS
+        // environment variable names are not code identifier names, and the
+        // project's naming rules treat object literal keys as if they were.
+        return Object.fromEntries([
+            ["AWS_REGION", regionName],
+            ["AWS_DEFAULT_REGION", regionName],
+            ["AWS_LAMBDA_FUNCTION_NAME", functionName],
+            ["AWS_LAMBDA_FUNCTION_MEMORY_SIZE", String(memorySizeMb)],
+            ["AWS_LAMBDA_FUNCTION_VERSION", "$LATEST"],
+        ]);
+    }
+}
+//# sourceMappingURL=sim-lambda-environment.js.map

package/dist/service/lambda/function/environment/sim-lambda-environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-lambda-environment.js","sourceRoot":"","sources":["../../../../../src/service/lambda/function/environment/sim-lambda-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAgBlF;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAoB;IACd,OAAO,CAA8B;IACrC,QAAQ,CAA8B;IAEvD;;;;;;;OAOG;IACH,UAAU,CAAqC;IAE/C,YAAY,UAA0C;QACpD,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;QACrD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,iBAAiB,IAAI,IAAI,GAAG,EAAE,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,IAAI,oBAAoB;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,iBAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1D,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAI,GAAqB;QACpC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,OAAO,MAAM,GAAG,EAAE,CAAC;QACrB,CAAC;QAED,OAAO,MAAM,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,UAAU,KAAK;YAClB,GAAG,IAAI,CAAC,gBAAgB,EAAE;YAC1B,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC;SACrC,CAAC;QACF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAChE,+DAA+D;QAC/D,oEAAoE;QACpE,oEAAoE;QACpE,OAAO,MAAM,CAAC,WAAW,CAAC;YACxB,CAAC,YAAY,EAAE,UAAU,CAAC;YAC1B,CAAC,oBAAoB,EAAE,UAAU,CAAC;YAClC,CAAC,0BAA0B,EAAE,YAAY,CAAC;YAC1C,CAAC,iCAAiC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;YACzD,CAAC,6BAA6B,EAAE,SAAS,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/service/lambda/function/environment/sim-lambda-process-environment.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The process.env a sim Lambda handler function sees while it runs.
+ *
+ * A handler backed by a real in-process function is a closure over its own
+ * module scope, so unlike zip code running in a vm context it has no sandbox
+ * to give it an environment of its own: it reads the host process.env like
+ * any other code in the test run. Node.js asynchronous context tracking
+ * bridges that gap. The function's variables are held in an
+ * AsyncLocalStorage store for the duration of the invocation, and process.env
+ * resolves to that store while it is set.
+ *
+ * The store follows the invocation across await points, and concurrent
+ * invocations of different functions each see their own variables, which a
+ * swap-and-restore around the handler call could not manage.
+ *
+ * The one thing this cannot reach is a read that already happened. A handler
+ * module doing `const TABLE = process.env.TABLE_NAME` at module scope is
+ * evaluated when the test file imports it, long before any invocation, so it
+ * captures the host value. Reads inside the handler body see the function's
+ * own variables. See SimLambdaEnvironmentConflicts, which warns when that
+ * distinction actually changes what the code sees.
+ */
+declare class SimLambdaProcessEnvironment {
+    private readonly storage;
+    private hostEnvironment;
+    private installed;
+    /**
+     * Run an invocation with the given variables as its process.env.
+     */
+    run<T>(variables: Record<string, string>, run: () => Promise<T>): Promise<T>;
+    /**
+     * The host process environment, ignoring any invocation in progress.
+     */
+    hostVariables(): NodeJS.ProcessEnv;
+    /**
+     * Redefine process.env as an accessor backed by the invocation store.
+     *
+     * process.env is a plain configurable data property on process, so it can
+     * be replaced with a getter. Outside a sim Lambda invocation the getter
+     * hands back the untouched host environment object, so the patch is inert:
+     * anything that reads, writes, or stubs process.env normally is unaffected.
+     *
+     * Installed once and never removed. Removing it would be unsafe while
+     * another invocation is in flight, and there is nothing to gain: an
+     * installed patch with no invocation running behaves exactly like no patch
+     * at all.
+     */
+    private install;
+    /**
+     * Apply an assignment to process.env as a whole.
+     *
+     * Inside an invocation this has to stay invocation-local, like a write to a
+     * single variable does, or function code could wipe out the host
+     * environment for the rest of the test run. The store's object identity is
+     * fixed for the run, so the assignment is copied into it rather than
+     * swapping the reference. Outside an invocation it replaces the host
+     * environment, as an assignment to process.env normally would.
+     */
+    private replaceVariables;
+}
+/**
+ * Shared because it patches a process global: one patch, one store.
+ */
+export declare const simLambdaProcessEnvironment: SimLambdaProcessEnvironment;
+export {};
+//# sourceMappingURL=sim-lambda-process-environment.d.ts.map

package/dist/service/lambda/function/environment/sim-lambda-process-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-lambda-process-environment.d.ts","sourceRoot":"","sources":["../../../../../src/service/lambda/function/environment/sim-lambda-process-environment.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAM,2BAA2B;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmD;IAC3E,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAGZ;IAED;;OAEG;IACH,aAAa,IAAI,MAAM,CAAC,UAAU,CAEjC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO;IAkBf;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;CAiBzB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B,6BAAoC,CAAC"}