@kensio/yulin 1.10.5 → 1.11.1

package/dist/service/cloudfront/cff/function-code-input/cff-function-code-input.d.ts

@@ -1,5 +1,6 @@
 import type { CloudFrontFunction } from "../../typings/cloudfront-functions.namespace.js";
 import type { SimCreateFunctionCommand } from "../../command/create-function/create-function.command.js";
+import type { CffCloudFrontModule } from "../kvs/cff-cloudfront-module.js";
 type FunctionCodeInput = SimCreateFunctionCommand["input"]["FunctionCode"];
 /**
  * Convert a handler function reference into a Uint8Array for input in the
@@ -27,7 +28,8 @@ export declare class CffUint8ArrayStowaway extends Uint8Array {
  */
 export declare class CffUint8ArrayFunctionCodeExtractor<H extends CloudFrontFunction.Handler = CloudFrontFunction.ViewerRequestHandler> {
     private readonly functionCodeInput;
-    constructor(functionCodeInput: FunctionCodeInput);
+    private readonly cloudFront?;
+    constructor(functionCodeInput: FunctionCodeInput, cloudFront?: CffCloudFrontModule | undefined);
     /**
      * Extract the handler function.
      */

package/dist/service/cloudfront/cff/function-code-input/cff-function-code-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cff-function-code-input.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-function-code-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AAGzG,KAAK,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,kBAAkB,CAAC,OAAO,GAC1C,iBAAiB,CAInB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;;IAGnD;;OAEG;IACH,uBAAuB,CAAC,eAAe,EAAE,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAGzE;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,kBAAkB,CAAC,OAAO,CAEhD;CACF;AAED;;;GAGG;AACH,qBAAa,kCAAkC,CAC7C,CAAC,SAAS,kBAAkB,CAAC,OAAO,GAClC,kBAAkB,CAAC,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAA9C,YAA6B,iBAAiB,EAAE,iBAAiB,EAAI;IAErE;;OAEG;IACH,sBAAsB,IAAI,CAAC,CAM1B;IAED,OAAO,CAAC,2BAA2B;CAsBpC"}
+{"version":3,"file":"cff-function-code-input.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-function-code-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAE1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACzG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,KAAK,iBAAiB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,kBAAkB,CAAC,OAAO,GAC1C,iBAAiB,CAInB;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;;IAGnD;;OAEG;IACH,uBAAuB,CAAC,eAAe,EAAE,kBAAkB,CAAC,OAAO,GAAG,IAAI,CAGzE;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,kBAAkB,CAAC,OAAO,CAEhD;CACF;AAED;;;GAGG;AACH,qBAAa,kCAAkC,CAC7C,CAAC,SAAS,kBAAkB,CAAC,OAAO,GAClC,kBAAkB,CAAC,oBAAoB;IAGvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAF9B,YACmB,iBAAiB,EAAE,iBAAiB,EACpC,UAAU,CAAC,EAAE,mBAAmB,YAAA,EAC/C;IAEJ;;OAEG;IACH,sBAAsB,IAAI,CAAC,CAM1B;IAED,OAAO,CAAC,2BAA2B;CAKpC"}

package/dist/service/cloudfront/cff/function-code-input/cff-function-code-input.js

@@ -1,5 +1,5 @@
 import { defaultCffHandler } from "../sim-cloudfront-function.js";
-import vm from "node:vm";
+import { cffHandlerFromSource } from "./cff-vm-source-handler.js";
 /**
  * Convert a handler function reference into a Uint8Array for input in the
  * CloudFront CreateFunction Command input FunctionCode.
@@ -35,8 +35,10 @@ export class CffUint8ArrayStowaway extends Uint8Array {
  */
 export class CffUint8ArrayFunctionCodeExtractor {
     functionCodeInput;
-    constructor(functionCodeInput) {
+    cloudFront;
+    constructor(functionCodeInput, cloudFront) {
         this.functionCodeInput = functionCodeInput;
+        this.cloudFront = cloudFront;
     }
     /**
      * Extract the handler function.
@@ -49,21 +51,7 @@ export class CffUint8ArrayFunctionCodeExtractor {
     }
     extractUint8ArraySourceCode() {
         const source = Buffer.from(this.functionCodeInput ?? "").toString();
-        const context = vm.createContext({
-            console,
-        });
-        const script = new vm.Script(`
-    ${source}
-    handler;
-    `);
-        const handler = script.runInContext(context, {
-            timeout: 50, // Real CloudFront Functions have a short timeout.
-            breakOnSigint: true,
-        });
-        if (typeof handler !== "function") {
-            throw new TypeError("CloudFront Function code did not define a handler function");
-        }
-        return handler;
+        return cffHandlerFromSource(source, this.cloudFront);
     }
 }
 //# sourceMappingURL=cff-function-code-input.js.map

package/dist/service/cloudfront/cff/function-code-input/cff-function-code-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"cff-function-code-input.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-function-code-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,gBAAgB,GAA+B,iBAAiB,CAAC;IAEjE;;OAEG;IACH,uBAAuB,CAAC,eAA2C;QACjE,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kCAAkC;IAIhB,iBAAiB;IAA9C,YAA6B,iBAAoC;iCAApC,iBAAiB;IAAsB,CAAC;IAErE;;OAEG;IACH,sBAAsB;QACpB,IAAI,IAAI,CAAC,iBAAiB,YAAY,qBAAqB,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,iBAAiB,CAAC,eAAoB,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;IAC5C,CAAC;IAEO,2BAA2B;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC;YAC/B,OAAO;SACR,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC;MAC3B,MAAM;;KAEP,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;YAC3C,OAAO,EAAE,EAAE,EAAE,kDAAkD;YAC/D,aAAa,EAAE,IAAI;SACpB,CAA+B,CAAC;QAEjC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,SAAS,CACjB,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QAED,OAAO,OAAY,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"cff-function-code-input.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-function-code-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIlE;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,eAA2C;IAE3C,MAAM,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC7C,QAAQ,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC;IAClD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,gBAAgB,GAA+B,iBAAiB,CAAC;IAEjE;;OAEG;IACH,uBAAuB,CAAC,eAA2C;QACjE,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kCAAkC;IAK1B,iBAAiB;IACjB,UAAU;IAF7B,YACmB,iBAAoC,EACpC,UAAgC;iCADhC,iBAAiB;0BACjB,UAAU;IAC1B,CAAC;IAEJ;;OAEG;IACH,sBAAsB;QACpB,IAAI,IAAI,CAAC,iBAAiB,YAAY,qBAAqB,EAAE,CAAC;YAC5D,OAAO,IAAI,CAAC,iBAAiB,CAAC,eAAoB,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;IAC5C,CAAC;IAEO,2BAA2B;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEpE,OAAO,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAM,CAAC;IAC5D,CAAC;CACF"}

package/dist/service/cloudfront/cff/function-code-input/cff-vm-source-handler.d.ts

@@ -0,0 +1,13 @@
+import type { CloudFrontFunction } from "../../typings/cloudfront-functions.namespace.js";
+import { type CffCloudFrontModule } from "../kvs/cff-cloudfront-module.js";
+/**
+ * Compile CloudFront Function source and hand back its handler.
+ *
+ * The source runs in a vm context of its own, which is the closest thing here
+ * to the isolate real CloudFront gives a Function. The context holds this
+ * Function's own `cf`, so two Functions running in one process each read the
+ * key value store they are associated with and nothing else. A Function with no
+ * association still gets a `cf`, one that refuses when asked to open a store.
+ */
+export declare function cffHandlerFromSource(source: string, cloudFront?: CffCloudFrontModule): CloudFrontFunction.Handler;
+//# sourceMappingURL=cff-vm-source-handler.d.ts.map

package/dist/service/cloudfront/cff/function-code-input/cff-vm-source-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-vm-source-handler.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-vm-source-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAC1F,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,iCAAiC,CAAC;AAGzC;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,mBAAoD,GAC/D,kBAAkB,CAAC,OAAO,CAmB5B"}

package/dist/service/cloudfront/cff/function-code-input/cff-vm-source-handler.js

@@ -0,0 +1,28 @@
+import vm from "node:vm";
+import { cffCloudFrontModule, } from "../kvs/cff-cloudfront-module.js";
+import { cffSourceWithoutCloudFrontImport } from "./cff-cloudfront-import.js";
+/**
+ * Compile CloudFront Function source and hand back its handler.
+ *
+ * The source runs in a vm context of its own, which is the closest thing here
+ * to the isolate real CloudFront gives a Function. The context holds this
+ * Function's own `cf`, so two Functions running in one process each read the
+ * key value store they are associated with and nothing else. A Function with no
+ * association still gets a `cf`, one that refuses when asked to open a store.
+ */
+export function cffHandlerFromSource(source, cloudFront = cffCloudFrontModule(undefined)) {
+    const context = vm.createContext({ console, cf: cloudFront });
+    const script = new vm.Script(`
+    ${cffSourceWithoutCloudFrontImport(source)}
+    handler;
+    `);
+    const handler = script.runInContext(context, {
+        timeout: 50, // Real CloudFront Functions have a short timeout.
+        breakOnSigint: true,
+    });
+    if (typeof handler !== "function") {
+        throw new TypeError("CloudFront Function code did not define a handler function");
+    }
+    return handler;
+}
+//# sourceMappingURL=cff-vm-source-handler.js.map

package/dist/service/cloudfront/cff/function-code-input/cff-vm-source-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-vm-source-handler.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/function-code-input/cff-vm-source-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAGzB,OAAO,EAEL,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,UAAU,GAAwB,mBAAmB,CAAC,SAAS,CAAC;IAEhE,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,EAAE,CAAC,MAAM,CAAC;MACzB,gCAAgC,CAAC,MAAM,CAAC;;KAEzC,CAAC,CAAC;IAEL,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3C,OAAO,EAAE,EAAE,EAAE,kDAAkD;QAC/D,aAAa,EAAE,IAAI;KACpB,CAA+B,CAAC;IAEjC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CACjB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/service/cloudfront/cff/kvs/cff-cloudfront-module.d.ts

@@ -0,0 +1,28 @@
+import type { SimCloudFrontKeyValueStore } from "../../key-value-store/sim-cf-key-value-store.js";
+import { CffKvsHandle } from "./cff-kvs-handle.js";
+/**
+ * What a Function can reach a key value store through.
+ *
+ * The Function's own association is the only store it can open, so this is
+ * given the store the Function was created with, or nothing.
+ */
+export interface CffCloudFrontModule {
+    /**
+     * Open the key value store this Function is associated with.
+     */
+    kvs(kvsId?: string): CffKvsHandle;
+}
+/**
+ * Build the `cloudfront` module a Function sees as `cf`.
+ *
+ * `cf.kvs()` opens the Function's associated store. An ID may be passed, and it
+ * has to be the associated store's: a Function can only reach the one it names
+ * in its own configuration, so an ID for any other store is refused rather than
+ * opened.
+ *
+ * A Function with no association has nothing to open, so `cf.kvs()` fails
+ * rather than handing back an empty store. An empty store would let a Function
+ * that forgot its association run to completion and quietly take every default.
+ */
+export declare function cffCloudFrontModule(store: SimCloudFrontKeyValueStore | undefined): CffCloudFrontModule;
+//# sourceMappingURL=cff-cloudfront-module.d.ts.map

package/dist/service/cloudfront/cff/kvs/cff-cloudfront-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-cloudfront-module.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/cff-cloudfront-module.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,0BAA0B,GAAG,SAAS,GAC5C,mBAAmB,CAoBrB"}

package/dist/service/cloudfront/cff/kvs/cff-cloudfront-module.js

@@ -0,0 +1,30 @@
+import { SimCloudFrontCffKvsUnavailable } from "../../error/sim-cf-key-value-store.error.js";
+import { CffKvsHandle } from "./cff-kvs-handle.js";
+/**
+ * Build the `cloudfront` module a Function sees as `cf`.
+ *
+ * `cf.kvs()` opens the Function's associated store. An ID may be passed, and it
+ * has to be the associated store's: a Function can only reach the one it names
+ * in its own configuration, so an ID for any other store is refused rather than
+ * opened.
+ *
+ * A Function with no association has nothing to open, so `cf.kvs()` fails
+ * rather than handing back an empty store. An empty store would let a Function
+ * that forgot its association run to completion and quietly take every default.
+ */
+export function cffCloudFrontModule(store) {
+    return {
+        kvs: (kvsId) => {
+            if (store === undefined) {
+                throw new SimCloudFrontCffKvsUnavailable("This CloudFront Function is not associated with a key value store, " +
+                    "so cf.kvs() has nothing to open");
+            }
+            if (kvsId !== undefined && kvsId !== store.id && kvsId !== store.arn) {
+                throw new SimCloudFrontCffKvsUnavailable(`This CloudFront Function is associated with key value store ` +
+                    `${store.id}, so cf.kvs() cannot open ${kvsId}`);
+            }
+            return new CffKvsHandle(store);
+        },
+    };
+}
+//# sourceMappingURL=cff-cloudfront-module.js.map

package/dist/service/cloudfront/cff/kvs/cff-cloudfront-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-cloudfront-module.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/cff-cloudfront-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAenD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA6C;IAE7C,OAAO;QACL,GAAG,EAAE,CAAC,KAAc,EAAgB,EAAE;YACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,8BAA8B,CACtC,qEAAqE;oBACnE,iCAAiC,CACpC,CAAC;YACJ,CAAC;YAED,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC,EAAE,IAAI,KAAK,KAAK,KAAK,CAAC,GAAG,EAAE,CAAC;gBACrE,MAAM,IAAI,8BAA8B,CACtC,8DAA8D;oBAC5D,GAAG,KAAK,CAAC,EAAE,6BAA6B,KAAK,EAAE,CAClD,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/service/cloudfront/cff/kvs/cff-kvs-handle.d.ts

@@ -0,0 +1,46 @@
+import type { SimCloudFrontKeyValueStore } from "../../key-value-store/sim-cf-key-value-store.js";
+/**
+ * What a Function may ask a value to be read back as.
+ */
+export type CffKvsValueFormat = "string" | "json" | "bytes";
+/**
+ * What `kvs.meta()` answers with.
+ */
+export interface CffKvsMeta {
+    readonly creationDateTime: string;
+    readonly lastUpdatedDateTime: string;
+    readonly keyCount: number;
+}
+/**
+ * The handle a CloudFront Function gets back from `cf.kvs()`.
+ *
+ * Every method is a promise, as in the runtime, so a Function reading a store
+ * has to be async. It is read-only: a Function can never write to a store, and
+ * there is deliberately no method here that would let it.
+ *
+ * https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/kvs-with-functions-associate.html
+ */
+export declare class CffKvsHandle {
+    private readonly store;
+    constructor(store: SimCloudFrontKeyValueStore);
+    /**
+     * Read a key, in the format the Function asked for.
+     *
+     * The default is `string`. `json` parses the stored string, and `bytes`
+     * hands back its UTF-8 bytes. A key that is not stored rejects, as in the
+     * runtime, rather than resolving to undefined.
+     */
+    get(key: string, options?: {
+        readonly format?: CffKvsValueFormat;
+    }): Promise<unknown>;
+    /**
+     * Whether a key is in the store.
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * The store's metadata, as the runtime reports it.
+     */
+    meta(): Promise<CffKvsMeta>;
+    private formatted;
+}
+//# sourceMappingURL=cff-kvs-handle.d.ts.map

package/dist/service/cloudfront/cff/kvs/cff-kvs-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-kvs-handle.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/cff-kvs-handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAElG;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,0BAA0B,EAAI;IAElE;;;;;;OAMG;IACG,GAAG,CACP,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAChD,OAAO,CAAC,OAAO,CAAC,CASlB;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpC;IAED;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAM1B;IAED,OAAO,CAAC,SAAS;CAalB"}

package/dist/service/cloudfront/cff/kvs/cff-kvs-handle.js

@@ -0,0 +1,60 @@
+/**
+ * The handle a CloudFront Function gets back from `cf.kvs()`.
+ *
+ * Every method is a promise, as in the runtime, so a Function reading a store
+ * has to be async. It is read-only: a Function can never write to a store, and
+ * there is deliberately no method here that would let it.
+ *
+ * https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/kvs-with-functions-associate.html
+ */
+export class CffKvsHandle {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * Read a key, in the format the Function asked for.
+     *
+     * The default is `string`. `json` parses the stored string, and `bytes`
+     * hands back its UTF-8 bytes. A key that is not stored rejects, as in the
+     * runtime, rather than resolving to undefined.
+     */
+    async get(key, options) {
+        // Async so that a missing key rejects the promise rather than throwing
+        // before the caller has one. A Function handling the miss with `.catch()`
+        // depends on that, and so does one that never awaits the read at all.
+        await Promise.resolve();
+        const value = this.store.keys.get(key);
+        return this.formatted(value, options?.format ?? "string");
+    }
+    /**
+     * Whether a key is in the store.
+     */
+    exists(key) {
+        return Promise.resolve(this.store.keys.has(key));
+    }
+    /**
+     * The store's metadata, as the runtime reports it.
+     */
+    meta() {
+        return Promise.resolve({
+            creationDateTime: this.store.createdTime.toISOString(),
+            lastUpdatedDateTime: this.store.lastModifiedTime.toISOString(),
+            keyCount: this.store.keys.itemCount,
+        });
+    }
+    formatted(value, format) {
+        switch (format) {
+            case "string": {
+                return value;
+            }
+            case "json": {
+                return JSON.parse(value);
+            }
+            case "bytes": {
+                return Buffer.from(value, "utf8");
+            }
+        }
+    }
+}
+//# sourceMappingURL=cff-kvs-handle.js.map

package/dist/service/cloudfront/cff/kvs/cff-kvs-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cff-kvs-handle.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/cff-kvs-handle.ts"],"names":[],"mappings":"AAgBA;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACM,KAAK;IAAlC,YAA6B,KAAiC;qBAAjC,KAAK;IAA+B,CAAC;IAElE;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CACP,GAAW,EACX,OAAiD;QAEjD,uEAAuE;QACvE,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAExB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE;YACtD,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE;YAC9D,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS;SACpC,CAAC,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,KAAa,EAAE,MAAyB;QACxD,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,QAAQ,EAAE,CAAC;gBACd,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,MAAM,EAAE,CAAC;gBACZ,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;YACD,KAAK,OAAO,EAAE,CAAC;gBACb,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.d.ts

@@ -0,0 +1,43 @@
+import type { CffCloudFrontModule } from "./cff-cloudfront-module.js";
+declare class SimCffCloudFrontGlobal {
+    private readonly storage;
+    private installed;
+    /**
+     * Run an invocation with the given module as its `cf`.
+     */
+    run<T>(module: CffCloudFrontModule, run: () => Promise<T>): Promise<T>;
+    /**
+     * The module the invocation in progress is using, if there is one.
+     *
+     * An invocation that has finished holds nothing, even though asynchronous
+     * context still reaches its store. Work a Function starts and does not await
+     * outlives the invocation here, and in CloudFront it does not: the Function
+     * is done when it returns. Reading `cf` from that leaked work finds nothing
+     * rather than a store the Function is no longer entitled to.
+     */
+    current(): CffCloudFrontModule | undefined;
+    /**
+     * Define `cf` as a global accessor backed by the invocation store.
+     *
+     * Installed once and never removed. Removing it would be unsafe while
+     * another invocation is in flight, and there is nothing to gain: an
+     * installed accessor with no invocation running reads as undefined, exactly
+     * as though it were not there.
+     *
+     * It stays configurable so that a second copy of this package in one process
+     * can install over the first. Locking it down would stop a Function
+     * reassigning `cf`, which is the Function sabotaging its own test rather than
+     * a boundary worth defending, at the cost of turning a duplicated dependency
+     * into a hard throw.
+     */
+    private install;
+}
+/**
+ * The `cf` global, shared by every simulated CloudFront Function in a process.
+ *
+ * One accessor is installed for the process, and which module it resolves to
+ * is per-invocation, so a single global is all that is needed.
+ */
+export declare const simCffCloudFrontGlobal: SimCffCloudFrontGlobal;
+export {};
+//# sourceMappingURL=sim-cff-cloudfront-global.d.ts.map

package/dist/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cff-cloudfront-global.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AA+BtE,cAAM,sBAAsB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAU3E;IAED;;;;;;;;OAQG;IACH,OAAO,IAAI,mBAAmB,GAAG,SAAS,CAQzC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,OAAO;CAYhB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,wBAA+B,CAAC"}

package/dist/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.js

@@ -0,0 +1,66 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+class SimCffCloudFrontGlobal {
+    storage = new AsyncLocalStorage();
+    installed = false;
+    /**
+     * Run an invocation with the given module as its `cf`.
+     */
+    async run(module, run) {
+        this.install();
+        const invocation = { module, active: true };
+        try {
+            return await this.storage.run(invocation, run);
+        }
+        finally {
+            invocation.active = false;
+        }
+    }
+    /**
+     * The module the invocation in progress is using, if there is one.
+     *
+     * An invocation that has finished holds nothing, even though asynchronous
+     * context still reaches its store. Work a Function starts and does not await
+     * outlives the invocation here, and in CloudFront it does not: the Function
+     * is done when it returns. Reading `cf` from that leaked work finds nothing
+     * rather than a store the Function is no longer entitled to.
+     */
+    current() {
+        const invocation = this.storage.getStore();
+        if (invocation?.active !== true) {
+            return undefined;
+        }
+        return invocation.module;
+    }
+    /**
+     * Define `cf` as a global accessor backed by the invocation store.
+     *
+     * Installed once and never removed. Removing it would be unsafe while
+     * another invocation is in flight, and there is nothing to gain: an
+     * installed accessor with no invocation running reads as undefined, exactly
+     * as though it were not there.
+     *
+     * It stays configurable so that a second copy of this package in one process
+     * can install over the first. Locking it down would stop a Function
+     * reassigning `cf`, which is the Function sabotaging its own test rather than
+     * a boundary worth defending, at the cost of turning a duplicated dependency
+     * into a hard throw.
+     */
+    install() {
+        if (this.installed) {
+            return;
+        }
+        Object.defineProperty(globalThis, "cf", {
+            configurable: true,
+            get: () => this.current(),
+        });
+        this.installed = true;
+    }
+}
+/**
+ * The `cf` global, shared by every simulated CloudFront Function in a process.
+ *
+ * One accessor is installed for the process, and which module it resolves to
+ * is per-invocation, so a single global is all that is needed.
+ */
+export const simCffCloudFrontGlobal = new SimCffCloudFrontGlobal();
+//# sourceMappingURL=sim-cff-cloudfront-global.js.map

package/dist/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cff-cloudfront-global.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/sim-cff-cloudfront-global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAiCrD,MAAM,sBAAsB;IACT,OAAO,GAAG,IAAI,iBAAiB,EAAiB,CAAC;IAC1D,SAAS,GAAG,KAAK,CAAC;IAE1B;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,MAA2B,EAAE,GAAqB;QAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,MAAM,UAAU,GAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAE3D,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO;QACL,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAE3C,IAAI,UAAU,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;OAaG;IACK,OAAO;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE;YACtC,YAAY,EAAE,IAAI;YAClB,GAAG,EAAE,GAAoC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;SAC3D,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.d.ts

@@ -0,0 +1,20 @@
+import type { SimCloudFrontFunctionMap } from "../../command/create-function/create-function.handler.js";
+import type { SimCloudFrontKeyValueStoreId } from "../../key-value-store/sim-cf-key-value-store.js";
+import type { SimCfKeyValueStoreUsers } from "../../key-value-store/sim-cf-key-value-store-users.js";
+/**
+ * The CloudFront Functions holding a key value store open.
+ *
+ * CloudFront will not delete a store a Function is still associated with, and
+ * the Functions are the only thing here that can be, so this is what the delete
+ * command asks. It reads the Function map live rather than keeping its own
+ * index, so a Function deleted a moment ago stops holding its store open.
+ */
+export declare class SimCffKeyValueStoreUsers implements SimCfKeyValueStoreUsers {
+    private readonly cloudFrontFunctions;
+    constructor(cloudFrontFunctions: SimCloudFrontFunctionMap);
+    /**
+     * The names of the Functions associated with a key value store.
+     */
+    functionsUsing(storeId: SimCloudFrontKeyValueStoreId): readonly string[];
+}
+//# sourceMappingURL=sim-cff-key-value-store-users.d.ts.map

package/dist/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cff-key-value-store-users.d.ts","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACzG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iDAAiD,CAAC;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uDAAuD,CAAC;AAErG;;;;;;;GAOG;AACH,qBAAa,wBAAyB,YAAW,uBAAuB;IAC1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAAhD,YAA6B,mBAAmB,EAAE,wBAAwB,EAAI;IAE9E;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,4BAA4B,GAAG,SAAS,MAAM,EAAE,CAMvE;CACF"}

package/dist/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.js

@@ -0,0 +1,25 @@
+/**
+ * The CloudFront Functions holding a key value store open.
+ *
+ * CloudFront will not delete a store a Function is still associated with, and
+ * the Functions are the only thing here that can be, so this is what the delete
+ * command asks. It reads the Function map live rather than keeping its own
+ * index, so a Function deleted a moment ago stops holding its store open.
+ */
+export class SimCffKeyValueStoreUsers {
+    cloudFrontFunctions;
+    constructor(cloudFrontFunctions) {
+        this.cloudFrontFunctions = cloudFrontFunctions;
+    }
+    /**
+     * The names of the Functions associated with a key value store.
+     */
+    functionsUsing(storeId) {
+        return this.cloudFrontFunctions
+            .values()
+            .filter((cff) => cff.keyValueStore?.id === storeId)
+            .map((cff) => cff.name)
+            .toArray();
+    }
+}
+//# sourceMappingURL=sim-cff-key-value-store-users.js.map

package/dist/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-cff-key-value-store-users.js","sourceRoot":"","sources":["../../../../../src/service/cloudfront/cff/kvs/sim-cff-key-value-store-users.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IACN,mBAAmB;IAAhD,YAA6B,mBAA6C;mCAA7C,mBAAmB;IAA6B,CAAC;IAE9E;;OAEG;IACH,cAAc,CAAC,OAAqC;QAClD,OAAO,IAAI,CAAC,mBAAmB;aAC5B,MAAM,EAAE;aACR,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,KAAK,OAAO,CAAC;aAClD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAc,CAAC;aAChC,OAAO,EAAE,CAAC;IACf,CAAC;CACF"}

package/dist/service/cloudfront/cff/sim-cloudfront-function.d.ts

@@ -3,6 +3,7 @@ import { SimCffEventAdapter } from "./adapter/sim-cff-event-adapter.js";
 import type { Brand } from "../../../util/brand.type.js";
 import type { SimArn } from "../../aws/arn.js";
 import { type SimAwsAccountId } from "../../aws/sim-aws-account.js";
+import type { SimCloudFrontKeyValueStore } from "../key-value-store/sim-cf-key-value-store.js";
 export type SimCloudFrontFunctionName = Brand<string, "SimCloudFrontFunctionName">;
 export type CloudFrontFunctionStatus = "UNPUBLISHED" | "UNASSOCIATED" | "ASSOCIATED";
 interface SimCloudFrontFunctionProperties {
@@ -11,6 +12,7 @@ interface SimCloudFrontFunctionProperties {
     readonly accountId?: SimAwsAccountId;
     handlerFunction?: CloudFrontFunction.Handler;
     eventAdapter?: SimCffEventAdapter;
+    keyValueStore?: SimCloudFrontKeyValueStore | undefined;
 }
 export declare const defaultCffHandler: CloudFrontFunction.Handler;
 /**
@@ -22,6 +24,7 @@ export declare class SimCloudFrontFunction {
     readonly accountId: SimAwsAccountId;
     private readonly handlerFunction;
     private readonly eventAdapter;
+    private readonly associatedKeyValueStore;
     constructor(properties: SimCloudFrontFunctionProperties);
     /**
      * Get the current status of this sim CloudFront Function.
@@ -35,14 +38,32 @@ export declare class SimCloudFrontFunction {
      * Move this sim CloudFront Function to the PUBLISHED status.
      */
     publish(): Promise<void>;
+    /**
+     * The key value store this Function may read, if it is associated with one.
+     */
+    get keyValueStore(): SimCloudFrontKeyValueStore | undefined;
     /**
      * Run the viewer-request CFF handler on a native Request.
+     *
+     * Awaited because a Function reading a key value store is async. One that
+     * reads nothing is synchronous and still works: awaiting a plain value is
+     * what makes both shapes the same here.
      */
-    handleViewerRequest(request: Request): Request | Response;
+    handleViewerRequest(request: Request): Promise<Request | Response>;
     /**
      * Run the viewer-response CFF handler on a native Request and Response.
      */
-    handleViewerResponse(request: Request, response: Response): Response;
+    handleViewerResponse(request: Request, response: Response): Promise<Response>;
+    /**
+     * Run the handler with this Function's own `cf` in scope.
+     *
+     * A Function given as source code already has `cf` in its vm sandbox, so this
+     * is what gives one given as a function reference the same thing: the module
+     * is held in asynchronous context for the length of the invocation, and the
+     * global `cf` resolves to it. Setting it for both is harmless and means the
+     * two kinds of Function reach a store the same way.
+     */
+    private running;
 }
 export {};
 //# sourceMappingURL=sim-cloudfront-function.d.ts.map

package/dist/service/cloudfront/cff/sim-cloudfront-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-cloudfront-function.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudfront/cff/sim-cloudfront-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,MAAM,EACN,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,aAAa,GACb,cAAc,GACd,YAAY,CAAC;AAEjB,UAAU,+BAA+B;IACvC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,eAAe,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAC7C,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,CAAC,OAOlD,CAAC;AAEF;;GAEG;AACH,qBAAa,qBAAqB;;IAChC,SAAgB,IAAI,EAAE,yBAAyB,CAAC;IAChD,SAAgB,SAAS,EAAE,eAAe,CAAC;IAG3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,YAAY,UAAU,EAAE,+BAA+B,EAatD;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,wBAAwB,CAErC;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvB;IAED;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAQxD;IAED;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAQnE;CACF"}
+{"version":3,"file":"sim-cloudfront-function.d.ts","sourceRoot":"","sources":["../../../../src/service/cloudfront/cff/sim-cloudfront-function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAI/F,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,MAAM,EACN,2BAA2B,CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,aAAa,GACb,cAAc,GACd,YAAY,CAAC;AAEjB,UAAU,+BAA+B;IACvC,IAAI,EAAE,yBAAyB,GAAG,MAAM,CAAC;IACzC,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,eAAe,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC;IAC7C,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,aAAa,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;CACxD;AAED,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,CAAC,OAOlD,CAAC;AAEF;;GAEG;AACH,qBAAa,qBAAqB;;IAChC,SAAgB,IAAI,EAAE,yBAAyB,CAAC;IAChD,SAAgB,SAAS,EAAE,eAAe,CAAC;IAG3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA6B;IAC7D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAE1B;IAEd,YAAY,UAAU,EAAE,+BAA+B,EActD;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,wBAAwB,CAErC;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGvB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,0BAA0B,GAAG,SAAS,CAE1D;IAED;;;;;;OAMG;IACG,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,CAUvE;IAED;;OAEG;IACG,oBAAoB,CACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,QAAQ,CAAC,CAUnB;IAED;;;;;;;;OAQG;YACW,OAAO;CAMtB"}

package/dist/service/cloudfront/cff/sim-cloudfront-function.js

@@ -1,5 +1,7 @@
 import { SimCffEventAdapter } from "./adapter/sim-cff-event-adapter.js";
 import { makeSimAwsAccountId, } from "../../aws/sim-aws-account.js";
+import { cffCloudFrontModule } from "./kvs/cff-cloudfront-module.js";
+import { simCffCloudFrontGlobal } from "./kvs/sim-cff-cloudfront-global.js";
 export const defaultCffHandler = (event) => {
     if (event.context.eventType === "viewer-response") {
         return event.response;
@@ -15,6 +17,7 @@ export class SimCloudFrontFunction {
     #status;
     handlerFunction;
     eventAdapter;
+    associatedKeyValueStore;
     constructor(properties) {
         const { name, status = "UNPUBLISHED", accountId = makeSimAwsAccountId(), handlerFunction = defaultCffHandler, eventAdapter = new SimCffEventAdapter(), } = properties;
         this.name = name;
@@ -22,6 +25,7 @@ export class SimCloudFrontFunction {
         this.accountId = accountId;
         this.handlerFunction = handlerFunction;
         this.eventAdapter = eventAdapter;
+        this.associatedKeyValueStore = properties.keyValueStore;
     }
     /**
      * Get the current status of this sim CloudFront Function.
@@ -42,25 +46,47 @@ export class SimCloudFrontFunction {
         this.#status = "UNASSOCIATED";
         return Promise.resolve();
     }
+    /**
+     * The key value store this Function may read, if it is associated with one.
+     */
+    get keyValueStore() {
+        return this.associatedKeyValueStore;
+    }
     /**
      * Run the viewer-request CFF handler on a native Request.
+     *
+     * Awaited because a Function reading a key value store is async. One that
+     * reads nothing is synchronous and still works: awaiting a plain value is
+     * what makes both shapes the same here.
      */
-    handleViewerRequest(request) {
+    async handleViewerRequest(request) {
         const cffEvent = this.eventAdapter.toViewerRequestEvent(request);
         const handlerFunction = this
             .handlerFunction;
-        const cffResult = handlerFunction(cffEvent);
+        const cffResult = await this.running(async () => await handlerFunction(cffEvent));
         return this.eventAdapter.fromViewerRequestResult(cffResult, request);
     }
     /**
      * Run the viewer-response CFF handler on a native Request and Response.
      */
-    handleViewerResponse(request, response) {
+    async handleViewerResponse(request, response) {
         const cffEvent = this.eventAdapter.toViewerResponseEvent(request, response);
         const handlerFunction = this
             .handlerFunction;
-        const cffResult = handlerFunction(cffEvent);
+        const cffResult = await this.running(async () => await handlerFunction(cffEvent));
         return this.eventAdapter.fromViewerResponseResult(cffResult, response);
     }
+    /**
+     * Run the handler with this Function's own `cf` in scope.
+     *
+     * A Function given as source code already has `cf` in its vm sandbox, so this
+     * is what gives one given as a function reference the same thing: the module
+     * is held in asynchronous context for the length of the invocation, and the
+     * global `cf` resolves to it. Setting it for both is harmless and means the
+     * two kinds of Function reach a store the same way.
+     */
+    async running(handler) {
+        return await simCffCloudFrontGlobal.run(cffCloudFrontModule(this.associatedKeyValueStore), handler);
+    }
 }
 //# sourceMappingURL=sim-cloudfront-function.js.map