@futdevpro/fsm-dynamo 1.20.12 → 1.20.16

package/README.md

@@ -66,6 +66,7 @@ All these packages build upon Dynamo FSM's core interfaces, types, and utilities
 - **Crypto Utilities**: Deterministic encryption/decryption using AES-256-CBC
 - **Testing Tools**: Comprehensive HTTP endpoint testing utilities
 - **Analytics**: User behavior tracking and usage analytics
+- **Sandbox Runtime Contract**: Closed cross-runtime outcomes, result codes, and strict content-free receipt validation (`@futdevpro/fsm-dynamo/sandbox-runtime`)
 
 ## Installation
 

package/build/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.d.ts

@@ -0,0 +1,20 @@
+import { DyFM_ZeroEgressOutcome_Type } from '../_enums/zero-egress-outcome.type-enum';
+import { DyFM_ZeroEgressResultCode_Type } from './zero-egress-result-code.const';
+import { DyFM_ZeroEgressReceiptValidation_Interface } from '../_models/zero-egress-receipt.interface';
+/** Closed, immutable result-code registry indexed by its only valid terminal outcome. */
+export declare const DyFM_zeroEgressResultCodesByOutcome: Readonly<Record<DyFM_ZeroEgressOutcome_Type, readonly DyFM_ZeroEgressResultCode_Type[]>>;
+/** Strict cross-runtime validation and content-free projection for zero-egress terminal evidence. */
+export declare class DyFM_ZeroEgressReceipt_Util {
+    /** Narrows an untrusted value to one closed terminal outcome. */
+    static isOutcome(value: unknown): value is DyFM_ZeroEgressOutcome_Type;
+    /** Narrows an untrusted value to one closed runtime result code. */
+    static isResultCode(value: unknown): value is DyFM_ZeroEgressResultCode_Type;
+    /** Validates that a result code belongs to exactly the supplied terminal outcome. */
+    static isOutcomeCodePair(outcome: unknown, code: unknown): boolean;
+    /** Validates and copies an exact receipt without reflecting any rejected input. */
+    static validate(value: unknown): DyFM_ZeroEgressReceiptValidation_Interface;
+    private static isDuration;
+    private static isByteCount;
+    private static invalid;
+}
+//# sourceMappingURL=zero-egress-receipt.util.d.ts.map

package/build/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-receipt.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EACL,8BAA8B,EAE/B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,0CAA0C,EAC3C,MAAM,0CAA0C,CAAC;AA6BlD,yFAAyF;AACzF,eAAO,MAAM,mCAAmC,EAAE,QAAQ,CAC1D,MAAM,CAAC,2BAA2B,EAAE,SAAS,8BAA8B,EAAE,CAAC,CA+C5E,CAAC;AAMH,qGAAqG;AACrG,qBAAa,2BAA2B;IACtC,iEAAiE;WACnD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B;IAgB7E,oEAAoE;WACtD,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,8BAA8B;IAInF,qFAAqF;WACvE,iBAAiB,CAC7B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO;IAMV,mFAAmF;WACrE,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,0CAA0C;IA4ClF,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B,OAAO,CAAC,MAAM,CAAC,OAAO;CAOvB"}

package/build/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_ZeroEgressReceipt_Util = exports.DyFM_zeroEgressResultCodesByOutcome = void 0;
+const zero_egress_outcome_type_enum_1 = require("../_enums/zero-egress-outcome.type-enum");
+const zero_egress_result_code_const_1 = require("./zero-egress-result-code.const");
+const dyfm_exactReceiptKeys = 'code,contractVersion,elapsedMs,outcome,outputBytes';
+/** Determines whether an unknown value is a non-array object with string-addressable fields. */
+function dyfm_isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Compares all own string keys, including non-enumerable keys, with the exact receipt shape. */
+function dyfm_hasExactReceiptKeys(value) {
+    const names = [];
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== 'string') {
+            return false;
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (!descriptor || !descriptor.enumerable || !Object.hasOwn(descriptor, 'value')) {
+            return false;
+        }
+        names.push(key);
+    }
+    return names.sort().join(',') === dyfm_exactReceiptKeys
+        && Object.keys(value).sort().join(',') === dyfm_exactReceiptKeys;
+}
+/** Closed, immutable result-code registry indexed by its only valid terminal outcome. */
+exports.DyFM_zeroEgressResultCodesByOutcome = Object.freeze({
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.completed]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.completed,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.cancelled]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.cancelled,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.cancelFallback,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.timedOut]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.timeout,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.hostTimeout,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.outputLimitExceeded]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.outputLimit,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.integrityRejected]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.artifactIntegrity,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.workerRejected]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.workerError,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.protocolInvalid,
+    ]),
+    [zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.hostFailed]: Object.freeze([
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.artifactBudgetInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.artifactInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.artifactLimit,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.bootstrapFailed,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.bootstrapLoadFailed,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.bootstrapUrlRequired,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.bootstrapUrlUntrusted,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.browserRequired,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.contractUnsupported,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.epochInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.inputBudgetInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.inputInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.inputLimit,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.integrityUnavailable,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.messageInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.outputBudgetInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.randomSeedInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.readyReplayed,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.responseInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.runAlreadyActive,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.runIdInvalid,
+        zero_egress_result_code_const_1.DyFM_zeroEgressResultCode.timeoutInvalid,
+    ]),
+});
+const dyfm_allResultCodes = new Set(Object.values(exports.DyFM_zeroEgressResultCodesByOutcome).flat());
+/** Strict cross-runtime validation and content-free projection for zero-egress terminal evidence. */
+class DyFM_ZeroEgressReceipt_Util {
+    /** Narrows an untrusted value to one closed terminal outcome. */
+    static isOutcome(value) {
+        switch (value) {
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.completed:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.cancelled:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.timedOut:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.outputLimitExceeded:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.integrityRejected:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.workerRejected:
+            case zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.hostFailed:
+                return true;
+            default:
+                return false;
+        }
+    }
+    /** Narrows an untrusted value to one closed runtime result code. */
+    static isResultCode(value) {
+        return typeof value === 'string' && dyfm_allResultCodes.has(value);
+    }
+    /** Validates that a result code belongs to exactly the supplied terminal outcome. */
+    static isOutcomeCodePair(outcome, code) {
+        return this.isOutcome(outcome)
+            && this.isResultCode(code)
+            && exports.DyFM_zeroEgressResultCodesByOutcome[outcome].includes(code);
+    }
+    /** Validates and copies an exact receipt without reflecting any rejected input. */
+    static validate(value) {
+        try {
+            if (!dyfm_isRecord(value)
+                || !dyfm_hasExactReceiptKeys(value)) {
+                return this.invalid();
+            }
+            const candidate = value;
+            if (candidate.contractVersion !== 'dyfm-zero-egress-receipt/1'
+                || !this.isOutcome(candidate.outcome)
+                || !this.isResultCode(candidate.code)
+                || !this.isOutcomeCodePair(candidate.outcome, candidate.code)
+                || !this.isDuration(candidate.elapsedMs)
+                || !this.isByteCount(candidate.outputBytes)
+                || (candidate.outcome !== zero_egress_outcome_type_enum_1.DyFM_ZeroEgressOutcome_Type.completed
+                    && candidate.outputBytes !== 0)) {
+                return this.invalid();
+            }
+            const receipt = Object.freeze({
+                contractVersion: 'dyfm-zero-egress-receipt/1',
+                outcome: candidate.outcome,
+                code: candidate.code,
+                elapsedMs: candidate.elapsedMs,
+                outputBytes: candidate.outputBytes,
+            });
+            return Object.freeze({
+                contractVersion: 'dyfm-zero-egress-receipt-validation/1',
+                valid: true,
+                code: 'DYFM|ZERO_EGRESS_RECEIPT|VALID',
+                receipt: receipt,
+            });
+        }
+        catch {
+            return this.invalid();
+        }
+    }
+    static isDuration(value) {
+        return typeof value === 'number'
+            && Number.isFinite(value)
+            && value >= 0
+            && value <= Number.MAX_SAFE_INTEGER;
+    }
+    static isByteCount(value) {
+        return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+    }
+    static invalid() {
+        return Object.freeze({
+            contractVersion: 'dyfm-zero-egress-receipt-validation/1',
+            valid: false,
+            code: 'DYFM|ZERO_EGRESS_RECEIPT|INVALID',
+        });
+    }
+}
+exports.DyFM_ZeroEgressReceipt_Util = DyFM_ZeroEgressReceipt_Util;
+//# sourceMappingURL=zero-egress-receipt.util.js.map

package/build/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-receipt.util.js","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_collections/zero-egress-receipt.util.ts"],"names":[],"mappings":";;;AAAA,2FAAsF;AACtF,mFAGyC;AAMzC,MAAM,qBAAqB,GAAW,oDAAoD,CAAC;AAE3F,gGAAgG;AAChG,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,iGAAiG;AACjG,SAAS,wBAAwB,CAAC,KAA8B;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,UAAU,GAAmC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE/F,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,qBAAqB;WAClD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,qBAAqB,CAAC;AACrE,CAAC;AAED,yFAAyF;AAC5E,QAAA,mCAAmC,GAE5C,MAAM,CAAC,MAAM,CAAC;IAChB,CAAC,2DAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QACvF,yDAAyB,CAAC,SAAS;KACpC,CAAC;IACF,CAAC,2DAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QACvF,yDAAyB,CAAC,SAAS;QACnC,yDAAyB,CAAC,cAAc;KACzC,CAAC;IACF,CAAC,2DAA2B,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QACtF,yDAAyB,CAAC,OAAO;QACjC,yDAAyB,CAAC,WAAW;KACtC,CAAC;IACF,CAAC,2DAA2B,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QACjG,yDAAyB,CAAC,WAAW;KACtC,CAAC;IACF,CAAC,2DAA2B,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QAC/F,yDAAyB,CAAC,iBAAiB;KAC5C,CAAC;IACF,CAAC,2DAA2B,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QAC5F,yDAAyB,CAAC,WAAW;QACrC,yDAAyB,CAAC,eAAe;KAC1C,CAAC;IACF,CAAC,2DAA2B,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,CAAmC;QACxF,yDAAyB,CAAC,qBAAqB;QAC/C,yDAAyB,CAAC,eAAe;QACzC,yDAAyB,CAAC,aAAa;QACvC,yDAAyB,CAAC,eAAe;QACzC,yDAAyB,CAAC,mBAAmB;QAC7C,yDAAyB,CAAC,oBAAoB;QAC9C,yDAAyB,CAAC,qBAAqB;QAC/C,yDAAyB,CAAC,eAAe;QACzC,yDAAyB,CAAC,mBAAmB;QAC7C,yDAAyB,CAAC,YAAY;QACtC,yDAAyB,CAAC,kBAAkB;QAC5C,yDAAyB,CAAC,YAAY;QACtC,yDAAyB,CAAC,UAAU;QACpC,yDAAyB,CAAC,oBAAoB;QAC9C,yDAAyB,CAAC,cAAc;QACxC,yDAAyB,CAAC,mBAAmB;QAC7C,yDAAyB,CAAC,iBAAiB;QAC3C,yDAAyB,CAAC,aAAa;QACvC,yDAAyB,CAAC,eAAe;QACzC,yDAAyB,CAAC,gBAAgB;QAC1C,yDAAyB,CAAC,YAAY;QACtC,yDAAyB,CAAC,cAAc;KACzC,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CACtD,MAAM,CAAC,MAAM,CAAC,2CAAmC,CAAC,CAAC,IAAI,EAAE,CAC1D,CAAC;AAEF,qGAAqG;AACrG,MAAa,2BAA2B;IACtC,iEAAiE;IAC1D,MAAM,CAAC,SAAS,CAAC,KAAc;QACpC,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,2DAA2B,CAAC,SAAS,CAAC;YAC3C,KAAK,2DAA2B,CAAC,SAAS,CAAC;YAC3C,KAAK,2DAA2B,CAAC,QAAQ,CAAC;YAC1C,KAAK,2DAA2B,CAAC,mBAAmB,CAAC;YACrD,KAAK,2DAA2B,CAAC,iBAAiB,CAAC;YACnD,KAAK,2DAA2B,CAAC,cAAc,CAAC;YAChD,KAAK,2DAA2B,CAAC,UAAU;gBACzC,OAAO,IAAI,CAAC;YAEd;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,oEAAoE;IAC7D,MAAM,CAAC,YAAY,CAAC,KAAc;QACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,qFAAqF;IAC9E,MAAM,CAAC,iBAAiB,CAC7B,OAAgB,EAChB,IAAa;QAEb,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;eACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;eACvB,2CAAmC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,mFAAmF;IAC5E,MAAM,CAAC,QAAQ,CAAC,KAAc;QACnC,IAAI,CAAC;YACH,IACE,CAAC,aAAa,CAAC,KAAK,CAAC;mBAClB,CAAC,wBAAwB,CAAC,KAAK,CAAC,EACnC,CAAC;gBACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;YACD,MAAM,SAAS,GAA4B,KAAK,CAAC;YAEjD,IACE,SAAS,CAAC,eAAe,KAAK,4BAA4B;mBACvD,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC;mBAClC,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC;mBAClC,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;mBAC1D,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC;mBACrC,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC;mBACxC,CACD,SAAS,CAAC,OAAO,KAAK,2DAA2B,CAAC,SAAS;uBACxD,SAAS,CAAC,WAAW,KAAK,CAAC,CAC/B,EACD,CAAC;gBACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;YAED,MAAM,OAAO,GAAqC,MAAM,CAAC,MAAM,CAAC;gBAC9D,eAAe,EAAE,4BAA4B;gBAC7C,OAAO,EAAE,SAAS,CAAC,OAAO;gBAC1B,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,WAAW,EAAE,SAAS,CAAC,WAAW;aACnC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,eAAe,EAAE,uCAAuC;gBACxD,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,gCAAgC;gBACtC,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,KAAc;QACtC,OAAO,OAAO,KAAK,KAAK,QAAQ;eAC3B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;eACtB,KAAK,IAAI,CAAC;eACV,KAAK,IAAI,MAAM,CAAC,gBAAgB,CAAC;IACxC,CAAC;IAEO,MAAM,CAAC,WAAW,CAAC,KAAc;QACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAChF,CAAC;IAEO,MAAM,CAAC,OAAO;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,eAAe,EAAE,uCAAuC;YACxD,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,kCAAkC;SACzC,CAAC,CAAC;IACL,CAAC;CACF;AAhGD,kEAgGC"}

package/build/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.d.ts

@@ -0,0 +1,39 @@
+/** Exact literal map for the compatibility-bound zero-egress wire codes. */
+export interface DyFM_ZeroEgressResultCodeMap_Interface {
+    readonly artifactBudgetInvalid: 'DYNX|SANDBOX|ARTIFACT_BUDGET_INVALID';
+    readonly artifactIntegrity: 'DYNX|SANDBOX|ARTIFACT_INTEGRITY';
+    readonly artifactInvalid: 'DYNX|SANDBOX|ARTIFACT_INVALID';
+    readonly artifactLimit: 'DYNX|SANDBOX|ARTIFACT_LIMIT';
+    readonly bootstrapFailed: 'DYNX|SANDBOX|BOOTSTRAP_FAILED';
+    readonly bootstrapLoadFailed: 'DYNX|SANDBOX|BOOTSTRAP_LOAD_FAILED';
+    readonly bootstrapUrlRequired: 'DYNX|SANDBOX|BOOTSTRAP_URL_REQUIRED';
+    readonly bootstrapUrlUntrusted: 'DYNX|SANDBOX|BOOTSTRAP_URL_UNTRUSTED';
+    readonly browserRequired: 'DYNX|SANDBOX|BROWSER_REQUIRED';
+    readonly cancelFallback: 'DYNX|SANDBOX|CANCEL_FALLBACK';
+    readonly cancelled: 'DYNX|SANDBOX|CANCELLED';
+    readonly completed: 'DYNX|SANDBOX|COMPLETED';
+    readonly contractUnsupported: 'DYNX|SANDBOX|CONTRACT_UNSUPPORTED';
+    readonly epochInvalid: 'DYNX|SANDBOX|EPOCH_INVALID';
+    readonly hostTimeout: 'DYNX|SANDBOX|HOST_TIMEOUT';
+    readonly inputBudgetInvalid: 'DYNX|SANDBOX|INPUT_BUDGET_INVALID';
+    readonly inputInvalid: 'DYNX|SANDBOX|INPUT_INVALID';
+    readonly inputLimit: 'DYNX|SANDBOX|INPUT_LIMIT';
+    readonly integrityUnavailable: 'DYNX|SANDBOX|INTEGRITY_UNAVAILABLE';
+    readonly messageInvalid: 'DYNX|SANDBOX|MESSAGE_INVALID';
+    readonly outputBudgetInvalid: 'DYNX|SANDBOX|OUTPUT_BUDGET_INVALID';
+    readonly outputLimit: 'DYNX|SANDBOX|OUTPUT_LIMIT';
+    readonly protocolInvalid: 'DYNX|SANDBOX|PROTOCOL_INVALID';
+    readonly randomSeedInvalid: 'DYNX|SANDBOX|RANDOM_SEED_INVALID';
+    readonly readyReplayed: 'DYNX|SANDBOX|READY_REPLAYED';
+    readonly responseInvalid: 'DYNX|SANDBOX|RESPONSE_INVALID';
+    readonly runAlreadyActive: 'DYNX|SANDBOX|RUN_ALREADY_ACTIVE';
+    readonly runIdInvalid: 'DYNX|SANDBOX|RUN_ID_INVALID';
+    readonly timeout: 'DYNX|SANDBOX|TIMEOUT';
+    readonly timeoutInvalid: 'DYNX|SANDBOX|TIMEOUT_INVALID';
+    readonly workerError: 'DYNX|SANDBOX|WORKER_ERROR';
+}
+/** Closed runtime values shared by browser hosts, servers, and persisted receipt consumers. */
+export declare const DyFM_zeroEgressResultCode: Readonly<DyFM_ZeroEgressResultCodeMap_Interface>;
+/** Union of every compatibility-bound zero-egress wire code. */
+export type DyFM_ZeroEgressResultCode_Type = DyFM_ZeroEgressResultCodeMap_Interface[keyof DyFM_ZeroEgressResultCodeMap_Interface];
+//# sourceMappingURL=zero-egress-result-code.const.d.ts.map

package/build/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-result-code.const.d.ts","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;IACvE,QAAQ,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,mBAAmB,EAAE,oCAAoC,CAAC;IACnE,QAAQ,CAAC,oBAAoB,EAAE,qCAAqC,CAAC;IACrE,QAAQ,CAAC,qBAAqB,EAAE,sCAAsC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,mCAAmC,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,mCAAmC,CAAC;IACjE,QAAQ,CAAC,YAAY,EAAE,4BAA4B,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,0BAA0B,CAAC;IAChD,QAAQ,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;IACpE,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,mBAAmB,EAAE,oCAAoC,CAAC;IACnE,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;IAClD,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,6BAA6B,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,+BAA+B,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAC;CACnD;AAED,+FAA+F;AAC/F,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,sCAAsC,CAgCrF,CAAC;AAEH,gEAAgE;AAChE,MAAM,MAAM,8BAA8B,GACxC,sCAAsC,CAAC,MAAM,sCAAsC,CAAC,CAAC"}

package/build/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_zeroEgressResultCode = void 0;
+/** Closed runtime values shared by browser hosts, servers, and persisted receipt consumers. */
+exports.DyFM_zeroEgressResultCode = Object.freeze({
+    artifactBudgetInvalid: 'DYNX|SANDBOX|ARTIFACT_BUDGET_INVALID',
+    artifactIntegrity: 'DYNX|SANDBOX|ARTIFACT_INTEGRITY',
+    artifactInvalid: 'DYNX|SANDBOX|ARTIFACT_INVALID',
+    artifactLimit: 'DYNX|SANDBOX|ARTIFACT_LIMIT',
+    bootstrapFailed: 'DYNX|SANDBOX|BOOTSTRAP_FAILED',
+    bootstrapLoadFailed: 'DYNX|SANDBOX|BOOTSTRAP_LOAD_FAILED',
+    bootstrapUrlRequired: 'DYNX|SANDBOX|BOOTSTRAP_URL_REQUIRED',
+    bootstrapUrlUntrusted: 'DYNX|SANDBOX|BOOTSTRAP_URL_UNTRUSTED',
+    browserRequired: 'DYNX|SANDBOX|BROWSER_REQUIRED',
+    cancelFallback: 'DYNX|SANDBOX|CANCEL_FALLBACK',
+    cancelled: 'DYNX|SANDBOX|CANCELLED',
+    completed: 'DYNX|SANDBOX|COMPLETED',
+    contractUnsupported: 'DYNX|SANDBOX|CONTRACT_UNSUPPORTED',
+    epochInvalid: 'DYNX|SANDBOX|EPOCH_INVALID',
+    hostTimeout: 'DYNX|SANDBOX|HOST_TIMEOUT',
+    inputBudgetInvalid: 'DYNX|SANDBOX|INPUT_BUDGET_INVALID',
+    inputInvalid: 'DYNX|SANDBOX|INPUT_INVALID',
+    inputLimit: 'DYNX|SANDBOX|INPUT_LIMIT',
+    integrityUnavailable: 'DYNX|SANDBOX|INTEGRITY_UNAVAILABLE',
+    messageInvalid: 'DYNX|SANDBOX|MESSAGE_INVALID',
+    outputBudgetInvalid: 'DYNX|SANDBOX|OUTPUT_BUDGET_INVALID',
+    outputLimit: 'DYNX|SANDBOX|OUTPUT_LIMIT',
+    protocolInvalid: 'DYNX|SANDBOX|PROTOCOL_INVALID',
+    randomSeedInvalid: 'DYNX|SANDBOX|RANDOM_SEED_INVALID',
+    readyReplayed: 'DYNX|SANDBOX|READY_REPLAYED',
+    responseInvalid: 'DYNX|SANDBOX|RESPONSE_INVALID',
+    runAlreadyActive: 'DYNX|SANDBOX|RUN_ALREADY_ACTIVE',
+    runIdInvalid: 'DYNX|SANDBOX|RUN_ID_INVALID',
+    timeout: 'DYNX|SANDBOX|TIMEOUT',
+    timeoutInvalid: 'DYNX|SANDBOX|TIMEOUT_INVALID',
+    workerError: 'DYNX|SANDBOX|WORKER_ERROR',
+});
+//# sourceMappingURL=zero-egress-result-code.const.js.map

package/build/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-result-code.const.js","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_collections/zero-egress-result-code.const.ts"],"names":[],"mappings":";;;AAmCA,+FAA+F;AAClF,QAAA,yBAAyB,GAAqD,MAAM,CAAC,MAAM,CAAC;IACvG,qBAAqB,EAAE,sCAAsC;IAC7D,iBAAiB,EAAE,iCAAiC;IACpD,eAAe,EAAE,+BAA+B;IAChD,aAAa,EAAE,6BAA6B;IAC5C,eAAe,EAAE,+BAA+B;IAChD,mBAAmB,EAAE,oCAAoC;IACzD,oBAAoB,EAAE,qCAAqC;IAC3D,qBAAqB,EAAE,sCAAsC;IAC7D,eAAe,EAAE,+BAA+B;IAChD,cAAc,EAAE,8BAA8B;IAC9C,SAAS,EAAE,wBAAwB;IACnC,SAAS,EAAE,wBAAwB;IACnC,mBAAmB,EAAE,mCAAmC;IACxD,YAAY,EAAE,4BAA4B;IAC1C,WAAW,EAAE,2BAA2B;IACxC,kBAAkB,EAAE,mCAAmC;IACvD,YAAY,EAAE,4BAA4B;IAC1C,UAAU,EAAE,0BAA0B;IACtC,oBAAoB,EAAE,oCAAoC;IAC1D,cAAc,EAAE,8BAA8B;IAC9C,mBAAmB,EAAE,oCAAoC;IACzD,WAAW,EAAE,2BAA2B;IACxC,eAAe,EAAE,+BAA+B;IAChD,iBAAiB,EAAE,kCAAkC;IACrD,aAAa,EAAE,6BAA6B;IAC5C,eAAe,EAAE,+BAA+B;IAChD,gBAAgB,EAAE,iCAAiC;IACnD,YAAY,EAAE,6BAA6B;IAC3C,OAAO,EAAE,sBAAsB;IAC/B,cAAc,EAAE,8BAA8B;IAC9C,WAAW,EAAE,2BAA2B;CACzC,CAAC,CAAC"}

package/build/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.d.ts

@@ -0,0 +1,11 @@
+/** Stable terminal outcomes shared by zero-egress sandbox hosts and their consumers. */
+export declare enum DyFM_ZeroEgressOutcome_Type {
+    completed = "completed",
+    cancelled = "cancelled",
+    timedOut = "timed-out",
+    outputLimitExceeded = "output-limit-exceeded",
+    integrityRejected = "integrity-rejected",
+    workerRejected = "worker-rejected",
+    hostFailed = "host-failed"
+}
+//# sourceMappingURL=zero-egress-outcome.type-enum.d.ts.map

package/build/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-outcome.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,oBAAY,2BAA2B;IACrC,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,QAAQ,cAAc;IACtB,mBAAmB,0BAA0B;IAC7C,iBAAiB,uBAAuB;IACxC,cAAc,oBAAoB;IAClC,UAAU,gBAAgB;CAC3B"}

package/build/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_ZeroEgressOutcome_Type = void 0;
+/** Stable terminal outcomes shared by zero-egress sandbox hosts and their consumers. */
+var DyFM_ZeroEgressOutcome_Type;
+(function (DyFM_ZeroEgressOutcome_Type) {
+    DyFM_ZeroEgressOutcome_Type["completed"] = "completed";
+    DyFM_ZeroEgressOutcome_Type["cancelled"] = "cancelled";
+    DyFM_ZeroEgressOutcome_Type["timedOut"] = "timed-out";
+    DyFM_ZeroEgressOutcome_Type["outputLimitExceeded"] = "output-limit-exceeded";
+    DyFM_ZeroEgressOutcome_Type["integrityRejected"] = "integrity-rejected";
+    DyFM_ZeroEgressOutcome_Type["workerRejected"] = "worker-rejected";
+    DyFM_ZeroEgressOutcome_Type["hostFailed"] = "host-failed";
+})(DyFM_ZeroEgressOutcome_Type || (exports.DyFM_ZeroEgressOutcome_Type = DyFM_ZeroEgressOutcome_Type = {}));
+//# sourceMappingURL=zero-egress-outcome.type-enum.js.map

package/build/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-outcome.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_enums/zero-egress-outcome.type-enum.ts"],"names":[],"mappings":";;;AAAA,wFAAwF;AACxF,IAAY,2BAQX;AARD,WAAY,2BAA2B;IACrC,sDAAuB,CAAA;IACvB,sDAAuB,CAAA;IACvB,qDAAsB,CAAA;IACtB,4EAA6C,CAAA;IAC7C,uEAAwC,CAAA;IACxC,iEAAkC,CAAA;IAClC,yDAA0B,CAAA;AAC5B,CAAC,EARW,2BAA2B,2CAA3B,2BAA2B,QAQtC"}

package/build/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.d.ts

@@ -0,0 +1,18 @@
+import { DyFM_ZeroEgressOutcome_Type } from '../_enums/zero-egress-outcome.type-enum';
+import { DyFM_ZeroEgressResultCode_Type } from '../_collections/zero-egress-result-code.const';
+/** Content-free terminal evidence safe to persist outside the browser execution boundary. */
+export interface DyFM_ZeroEgressReceipt_Interface {
+    readonly contractVersion: 'dyfm-zero-egress-receipt/1';
+    readonly outcome: DyFM_ZeroEgressOutcome_Type;
+    readonly code: DyFM_ZeroEgressResultCode_Type;
+    readonly elapsedMs: number;
+    readonly outputBytes: number;
+}
+/** Non-reflective validation result for an untrusted receipt candidate. */
+export interface DyFM_ZeroEgressReceiptValidation_Interface {
+    readonly contractVersion: 'dyfm-zero-egress-receipt-validation/1';
+    readonly valid: boolean;
+    readonly code: 'DYFM|ZERO_EGRESS_RECEIPT|VALID' | 'DYFM|ZERO_EGRESS_RECEIPT|INVALID';
+    readonly receipt?: DyFM_ZeroEgressReceipt_Interface;
+}
+//# sourceMappingURL=zero-egress-receipt.interface.d.ts.map

package/build/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-receipt.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAC;AAE/F,6FAA6F;AAC7F,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,eAAe,EAAE,4BAA4B,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,eAAe,EAAE,uCAAuC,CAAC;IAClE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EACT,gCAAgC,GAChC,kCAAkC,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,gCAAgC,CAAC;CACrD"}

package/build/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=zero-egress-receipt.interface.js.map

package/build/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-egress-receipt.interface.js","sourceRoot":"","sources":["../../../../src/_modules/sandbox-runtime/_models/zero-egress-receipt.interface.ts"],"names":[],"mappings":""}

package/build/_modules/sandbox-runtime/index.d.ts

@@ -0,0 +1,5 @@
+export * from './_collections/zero-egress-receipt.util';
+export * from './_collections/zero-egress-result-code.const';
+export * from './_enums/zero-egress-outcome.type-enum';
+export * from './_models/zero-egress-receipt.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/sandbox-runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/sandbox-runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC;AACxD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC"}

package/build/_modules/sandbox-runtime/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./_collections/zero-egress-receipt.util"), exports);
+tslib_1.__exportStar(require("./_collections/zero-egress-result-code.const"), exports);
+tslib_1.__exportStar(require("./_enums/zero-egress-outcome.type-enum"), exports);
+tslib_1.__exportStar(require("./_models/zero-egress-receipt.interface"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/sandbox-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/sandbox-runtime/index.ts"],"names":[],"mappings":";;;AAAA,kFAAwD;AACxD,uFAA6D;AAC7D,iFAAuD;AACvD,kFAAwD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "1.20.12",
+  "version": "1.20.16",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",
@@ -137,6 +137,12 @@
       "types": "./build/_modules/deployment/index.d.ts",
       "typings": "./build/_modules/deployment/index.d.ts"
     },
+    "./sandbox-runtime": {
+      "default": "./build/_modules/sandbox-runtime/index.js",
+      "module": "./build/_modules/sandbox-runtime/index.js",
+      "types": "./build/_modules/sandbox-runtime/index.d.ts",
+      "typings": "./build/_modules/sandbox-runtime/index.d.ts"
+    },
     "./custom-data": {
       "default": "./build/_modules/custom-data/index.js",
       "module": "./build/_modules/custom-data/index.js",
@@ -248,6 +254,9 @@
       "deployment": [
         "build/_modules/deployment/index.d.ts"
       ],
+      "sandbox-runtime": [
+        "build/_modules/sandbox-runtime/index.d.ts"
+      ],
       "custom-data": [
         "build/_modules/custom-data/index.d.ts"
       ],