@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/core/data.js

@@ -0,0 +1,197 @@
+import { dataBytesMax, dataDepthMax, dataNodesMax } from "./limits.js";
+const frozenData = new WeakSet();
+export function isFrozenData(value) {
+    return value !== null && typeof value === "object" && frozenData.has(value);
+}
+/** Validate before native cloning/serialization, which can otherwise overflow on deep input. */
+export function assertDataTree(value, options = { allowArrays: true, allowUndefined: true }) {
+    if (options.allowArrays && options.allowUndefined && isFrozenData(value)) {
+        return;
+    }
+    new DataValidator(options).validate(value);
+}
+/** JSON.parse owns every property, so this boundary does not need accessor/prototype inspection. */
+export function parseFrozenJson(text) {
+    const value = JSON.parse(text);
+    const targets = [];
+    new DataValidator({ allowArrays: true, allowUndefined: false }, true).validate(value, targets);
+    for (const target of targets) {
+        Object.freeze(target);
+        frozenData.add(target);
+    }
+    return value;
+}
+class DataValidator {
+    options;
+    parsedJson;
+    pending = [];
+    ancestors = new Set();
+    nodes = 0;
+    bytes = 0;
+    constructor(options, parsedJson = false) {
+        this.options = options;
+        this.parsedJson = parsedJson;
+    }
+    validate(value, freezeTargets) {
+        this.pending.push({ value, depth: 0 });
+        while (this.pending.length > 0) {
+            const frame = this.pending.pop();
+            if (!frame) {
+                throw new Error("A data frame must exist while traversal is pending.");
+            }
+            if (frame.leaving && frame.value !== null && typeof frame.value === "object") {
+                this.ancestors.delete(frame.value);
+                freezeTargets?.push(frame.value);
+                continue;
+            }
+            this.nodes += 1;
+            if (this.nodes > dataNodesMax || frame.depth > dataDepthMax) {
+                throw new TypeError("Data exceeds the supported node or nesting limit.");
+            }
+            if (frame.value === undefined && !this.options.allowUndefined) {
+                throw new TypeError("Data cannot contain undefined values.");
+            }
+            this.addBytes(scalarBytes(frame.value));
+            if (frame.value !== null && typeof frame.value === "object") {
+                if (this.parsedJson) {
+                    this.enterParsedObject(frame.value, frame.depth);
+                }
+                else {
+                    this.enterObject(frame.value, frame.depth, freezeTargets !== undefined);
+                }
+            }
+        }
+    }
+    enterParsedObject(value, depth) {
+        this.pending.push({ value, depth, leaving: true });
+        for (const [name, child] of Object.entries(value)) {
+            this.addBytes(name.length * 3);
+            if (this.pending.length >= dataNodesMax) {
+                throw new TypeError("Data exceeds the supported node limit.");
+            }
+            this.pending.push({ value: child, depth: depth + 1 });
+        }
+    }
+    enterObject(value, depth, freezing) {
+        if (Array.isArray(value) && !this.options.allowArrays) {
+            throw new TypeError("Data cannot contain arrays.");
+        }
+        if (Object.getOwnPropertySymbols(value).length > 0) {
+            throw new TypeError("Data cannot contain symbol properties.");
+        }
+        if (this.ancestors.has(value)) {
+            throw new TypeError("Data cannot contain circular references.");
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError("Data must contain plain objects and arrays.");
+        }
+        this.ancestors.add(value);
+        this.pending.push({ value, depth, leaving: true });
+        const entries = Object.entries(Object.getOwnPropertyDescriptors(value));
+        let arrayIndexCount = 0;
+        for (const [name, descriptor] of entries) {
+            if (freezing && (descriptor.get || descriptor.set)) {
+                throw new TypeError("Data cannot contain accessors.");
+            }
+            if (!descriptor.enumerable) {
+                continue;
+            }
+            if (descriptor.get || descriptor.set) {
+                throw new TypeError("Data cannot contain accessors.");
+            }
+            if (Array.isArray(value)) {
+                if (!/^(0|[1-9][0-9]*)$/.test(name) || Number(name) >= value.length) {
+                    throw new TypeError("Data arrays must contain only indexed values.");
+                }
+                arrayIndexCount += 1;
+            }
+            this.addBytes(name.length * 3);
+            if (this.pending.length >= dataNodesMax) {
+                throw new TypeError("Data exceeds the supported node limit.");
+            }
+            const child = descriptor.value;
+            this.pending.push({ value: child, depth: depth + 1 });
+        }
+        if (Array.isArray(value) && arrayIndexCount !== value.length) {
+            throw new TypeError("Data arrays must be dense.");
+        }
+    }
+    addBytes(bytes) {
+        this.bytes += bytes;
+        if (this.bytes > dataBytesMax) {
+            throw new TypeError("Data exceeds the supported byte limit.");
+        }
+    }
+}
+function scalarBytes(value) {
+    if (value === null || value === undefined || typeof value === "boolean") {
+        return 5;
+    }
+    if (typeof value === "string") {
+        return value.length * 3 + 2;
+    }
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return 24;
+    }
+    if (typeof value === "object") {
+        return 2;
+    }
+    throw new TypeError("Data contains a non-serializable value.");
+}
+export function cloneData(value) {
+    if (!isFrozenData(value)) {
+        assertDataTree(value);
+    }
+    return structuredClone(value);
+}
+/** Validate at the boundary, then freeze the detached native copy without revalidating it. */
+export function cloneFrozenData(value) {
+    const copied = cloneData(value);
+    const pending = [copied];
+    const visited = new Set();
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (current === null || typeof current !== "object" || visited.has(current)) {
+            continue;
+        }
+        visited.add(current);
+        if (visited.size > dataNodesMax) {
+            throw new Error("A validated clone cannot exceed its source node budget.");
+        }
+        for (const child of Object.values(current)) {
+            pending.push(child);
+        }
+        Object.freeze(current);
+        frozenData.add(current);
+    }
+    return copied;
+}
+/** Freeze only data properties; never evaluate a user getter while recording diagnostics. */
+export function freezeData(value) {
+    if (isFrozenData(value)) {
+        return value;
+    }
+    const targets = [];
+    new DataValidator({ allowArrays: true, allowUndefined: true }).validate(value, targets);
+    for (const target of targets) {
+        Object.freeze(target);
+        frozenData.add(target);
+    }
+    return value;
+}
+export function setOwn(record, name, value) {
+    Object.defineProperty(record, name, {
+        value,
+        enumerable: true,
+        writable: true,
+        configurable: true,
+    });
+}
+export function getOwn(record, name) {
+    if (!Object.hasOwn(record, name)) {
+        return undefined;
+    }
+    return record[name];
+}
+//# sourceMappingURL=data.js.map

package/dist/core/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/core/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAavE,MAAM,UAAU,GAAG,IAAI,OAAO,EAAE,CAAC;AAEjC,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,cAAc,CAC1B,KAAc,EACd,OAAO,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IAErD,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO;IACX,CAAC;IAED,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,IAAY;IACxC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAE/F,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,aAAa;IAOM,OAAO;IACP,UAAU;IAPd,OAAO,GAAgB,EAAE,CAAC;IAC1B,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,KAAK,GAAG,CAAC,CAAC;IACV,KAAK,GAAG,CAAC,CAAC;IAElB,YACqB,OAAoB,EACpB,UAAU,GAAG,KAAK;uBADlB,OAAO;0BACP,UAAU;IAC5B,CAAC;IAEJ,QAAQ,CAAC,KAAc,EAAE,aAAwB;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QAEvC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YAEjC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC3E,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEnC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEjC,SAAS;YACb,CAAC;YAED,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAEhB,IAAI,IAAI,CAAC,KAAK,GAAG,YAAY,IAAI,KAAK,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;YAC7E,CAAC;YAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC5D,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YAExC,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC1D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;oBAClB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrD,CAAC;qBAAM,CAAC;oBACJ,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC;gBAC5E,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,KAAa,EAAE,KAAa;QAClD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAE/B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;gBACtC,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,KAAa,EAAE,KAAa,EAAE,QAAiB;QAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,SAAS,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAExD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAChF,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,OAAO,EAAE,CAAC;YACvC,IAAI,QAAQ,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;gBACzB,SAAS;YACb,CAAC;YAED,IAAI,UAAU,CAAC,GAAG,IAAI,UAAU,CAAC,GAAG,EAAE,CAAC;gBACnC,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBAClE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;gBACzE,CAAC;gBAED,eAAe,IAAI,CAAC,CAAC;YACzB,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAE/B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,YAAY,EAAE,CAAC;gBACtC,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;YAClE,CAAC;YAED,MAAM,KAAK,GAAY,UAAU,CAAC,KAAK,CAAC;YACxC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3D,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAEO,QAAQ,CAAC,KAAa;QAC1B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QAEpB,IAAI,IAAI,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;YAC5B,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;QAClE,CAAC;IACL,CAAC;CACJ;AAED,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACtE,OAAO,CAAC,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,CAAC;IACd,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACb,CAAC;IAED,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,SAAS,CAAQ,KAAY;IACzC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,cAAc,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAQ,KAAY;IAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,GAAc,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAElC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE9B,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1E,SAAS;QACb,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErB,IAAI,OAAO,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC/E,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvB,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAQ,KAAY;IAC1C,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAExF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,MAAM,CAAQ,MAA6B,EAAE,IAAY,EAAE,KAAY;IACnF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE;QAChC,KAAK;QACL,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;KACrB,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,MAAM,CAClB,MAAuC,EACvC,IAAY;IAEZ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/core/deadline.d.ts

@@ -0,0 +1,12 @@
+/** A deadline settles framework work; late extension callbacks still need their context checked. */
+export declare class Deadline implements Disposable {
+    private readonly controller;
+    private readonly timer;
+    private readonly expired;
+    constructor(timeoutMs: number, error: () => Error);
+    get signal(): AbortSignal;
+    wait<Value>(work: PromiseLike<Value>): Promise<Value>;
+    cancel(reason: unknown): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=deadline.d.ts.map

package/dist/core/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/core/deadline.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,qBAAa,QAAS,YAAW,UAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,YAAY,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,EAsBhD;IAED,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAEpD;IAED,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAE5B;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAGvB;CACJ"}

package/dist/core/deadline.js

@@ -0,0 +1,38 @@
+/** A deadline settles framework work; late extension callbacks still need their context checked. */
+export class Deadline {
+    controller = new AbortController();
+    timer;
+    expired;
+    constructor(timeoutMs, error) {
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2_147_483_647) {
+            throw new TypeError("A deadline requires a positive integer timeout in milliseconds.");
+        }
+        this.expired = new Promise((_resolve, reject) => {
+            this.controller.signal.addEventListener("abort", () => {
+                const reason = this.controller.signal.reason;
+                reject(reason);
+            }, {
+                once: true,
+            });
+        });
+        this.timer = setTimeout(() => this.cancel(error()), timeoutMs);
+        // A synchronous owner can dispose without ever waiting on the deadline.
+        void this.expired.catch(() => {
+            // Disposal can precede the first waiter; wait() still observes this rejection.
+        });
+    }
+    get signal() {
+        return this.controller.signal;
+    }
+    wait(work) {
+        return Promise.race([work, this.expired]);
+    }
+    cancel(reason) {
+        this.controller.abort(reason);
+    }
+    [Symbol.dispose]() {
+        clearTimeout(this.timer);
+        this.cancel(new Error("The deadline owner has finished."));
+    }
+}
+//# sourceMappingURL=deadline.js.map

package/dist/core/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../src/core/deadline.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,OAAO,QAAQ;IACA,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACnC,KAAK,CAAgC;IACrC,OAAO,CAAiB;IAEzC,YAAY,SAAiB,EAAE,KAAkB;QAC7C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;YACjF,MAAM,IAAI,SAAS,CAAC,iEAAiE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACnD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CACnC,OAAO,EACP,GAAG,EAAE;gBACD,MAAM,MAAM,GAAY,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;gBACtD,MAAM,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC,EACD;gBACI,IAAI,EAAE,IAAI;aACb,CACJ,CAAC;QACN,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QAC/D,wEAAwE;QACxE,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;YACzB,+EAA+E;QACnF,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED,IAAI,CAAQ,IAAwB;QAChC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,MAAe;QAClB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACZ,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAC/D,CAAC;CACJ"}

package/dist/core/errors.d.ts

@@ -0,0 +1,7 @@
+export type RuntimeErrorCode = "InvalidModule" | "DuplicateModule" | "MissingModule" | "ModuleCycle" | "DuplicateOperation" | "InvalidOperation" | "InvalidTransactionBoundary" | "UnknownOperation" | "AsyncOperationInSyncExecution" | "UnfinishedExecution" | "ExpiredExecutionContext" | "WorldBusy" | "RuntimeClosed";
+export declare class RuntimeError extends Error {
+    readonly code: RuntimeErrorCode;
+    constructor(code: RuntimeErrorCode, message: string);
+}
+export declare function errorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACtB,eAAe,GACf,iBAAiB,GACjB,eAAe,GACf,aAAa,GACb,oBAAoB,GACpB,kBAAkB,GAClB,4BAA4B,GAC5B,kBAAkB,GAClB,+BAA+B,GAC/B,qBAAqB,GACrB,yBAAyB,GACzB,WAAW,GACX,eAAe,CAAC;AAEtB,qBAAa,YAAa,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,YAAY,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAIlD;CACJ;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMnD"}

package/dist/core/errors.js

@@ -0,0 +1,15 @@
+export class RuntimeError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "RuntimeError";
+        this.code = code;
+    }
+}
+export function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC1B,IAAI,CAAmB;IAEhC,YAAY,IAAsB,EAAE,OAAe;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;CACJ;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/core/files.d.ts

@@ -0,0 +1,8 @@
+export declare class TextEncodingError extends TypeError {
+    readonly name = "TextEncodingError";
+}
+/** Read a bounded slice even if the file grows between discovery and the actual read. */
+export declare function readTextFile(path: string, bytesMax?: number): Promise<string>;
+export declare function readBinaryFile(path: string, bytesMax?: number): Promise<Uint8Array>;
+export declare function readJsonFile(path: string): Promise<unknown>;
+//# sourceMappingURL=files.d.ts.map

package/dist/core/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAGA,qBAAa,iBAAkB,SAAQ,SAAS;IAC5C,SAAkB,IAAI,uBAAuB;CAChD;AAED,yFAAyF;AACzF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAoB/F;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAIjE"}

package/dist/core/files.js

@@ -0,0 +1,98 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { Deadline } from "./deadline.js";
+import { dataBytesMax } from "./limits.js";
+export class TextEncodingError extends TypeError {
+    name = "TextEncodingError";
+}
+/** Read a bounded slice even if the file grows between discovery and the actual read. */
+export async function readTextFile(path, bytesMax = dataBytesMax) {
+    const bytes = await readBinaryFile(path, bytesMax);
+    try {
+        return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
+    }
+    catch (error) {
+        throw new TextEncodingError(`File '${path}' is not valid UTF-8.`, { cause: error });
+    }
+}
+export async function readBinaryFile(path, bytesMax = dataBytesMax) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        if (!Number.isSafeInteger(bytesMax) || bytesMax < 1) {
+            throw new TypeError("A file byte limit must be a positive safe integer.");
+        }
+        const deadline = __addDisposableResource(env_1, new Deadline(30_000, () => new Error(`Reading '${path}' timed out.`)), false);
+        const file = Bun.file(path);
+        const status = await deadline.wait(file.stat());
+        if (!status.isFile()) {
+            throw new TypeError(`Input '${path}' must be a regular file.`);
+        }
+        const bytes = await deadline.wait(file.slice(0, bytesMax + 1).bytes());
+        if (bytes.length > bytesMax) {
+            throw new TypeError(`File '${path}' exceeds the ${bytesMax}-byte input limit.`);
+        }
+        return bytes;
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+export async function readJsonFile(path) {
+    const text = await readTextFile(path);
+    return JSON.parse(text.replace(/^\uFEFF/u, ""));
+}
+//# sourceMappingURL=files.js.map

package/dist/core/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC1B,IAAI,GAAG,mBAAmB,CAAC;CAChD;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAAQ,GAAG,YAAY;IACpE,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnD,IAAI,CAAC;QACD,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,iBAAiB,CAAC,SAAS,IAAI,uBAAuB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,QAAQ,GAAG,YAAY;;;QACtE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,QAAQ,kCAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,CAAC,QAAA,CAAC;QACvF,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,IAAI,SAAS,CAAC,UAAU,IAAI,2BAA2B,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAEvE,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,SAAS,IAAI,iBAAiB,QAAQ,oBAAoB,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,KAAK,CAAC;;;;;;;;;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAEtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,7 @@
+export { RuntimeError } from "./errors.js";
+export type { RuntimeErrorCode } from "./errors.js";
+export { defineOperation } from "./operation.js";
+export type { Operation } from "./operation.js";
+export { createRuntime, Runtime } from "./runtime.js";
+export type { AsyncHandler, ExecutionContext, HarnessModule, ModuleRegistrar, RuntimeOptions, RuntimeObserver, RuntimeExecution, SyncHandler, TraceEvent, TransactionBoundary, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EACR,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,mBAAmB,GACtB,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+export { RuntimeError } from "./errors.js";
+export { defineOperation } from "./operation.js";
+export { createRuntime, Runtime } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/limits.d.ts

@@ -0,0 +1,15 @@
+/** Internal work budgets keep malformed input and accidental cycles from exhausting the host. */
+export declare const dataDepthMax = 256;
+export declare const dataNodesMax = 1000000;
+export declare const dataBytesMax: number;
+export declare const setupFilesMax = 20000;
+export declare const setupBytesMax: number;
+export declare const importFramesMax = 4096;
+export declare const workUnitsMax = 50000000;
+export declare const requestDepthMax = 128;
+export declare const requestOperationsMax = 20000;
+export declare const queuedRequestsMax = 1000;
+export declare const requestTimeoutMs = 300000;
+export declare const traceEventsMax = 100000;
+export declare const traceBytesMax: number;
+//# sourceMappingURL=limits.d.ts.map

package/dist/core/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/core/limits.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY,UAAY,CAAC;AACtC,eAAO,MAAM,YAAY,QAAmB,CAAC;AAC7C,eAAO,MAAM,aAAa,QAAS,CAAC;AACpC,eAAO,MAAM,aAAa,QAAoB,CAAC;AAC/C,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,YAAY,WAAa,CAAC;AACvC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,gBAAgB,SAAU,CAAC;AACxC,eAAO,MAAM,cAAc,SAAU,CAAC;AACtC,eAAO,MAAM,aAAa,QAAmB,CAAC"}

package/dist/core/limits.js

@@ -0,0 +1,15 @@
+/** Internal work budgets keep malformed input and accidental cycles from exhausting the host. */
+export const dataDepthMax = 256;
+export const dataNodesMax = 1_000_000;
+export const dataBytesMax = 64 * 1024 * 1024;
+export const setupFilesMax = 20_000;
+export const setupBytesMax = 512 * 1024 * 1024;
+export const importFramesMax = 4096;
+export const workUnitsMax = 50_000_000;
+export const requestDepthMax = 128;
+export const requestOperationsMax = 20_000;
+export const queuedRequestsMax = 1000;
+export const requestTimeoutMs = 300_000;
+export const traceEventsMax = 100_000;
+export const traceBytesMax = 64 * 1024 * 1024;
+//# sourceMappingURL=limits.js.map

package/dist/core/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/core/limits.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AACtC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/dist/core/modules.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessModule } from "./types.js";
+export declare function orderModules(modules: readonly HarnessModule[]): readonly HarnessModule[];
+//# sourceMappingURL=modules.d.ts.map

package/dist/core/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/core/modules.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,CAkCxF"}

package/dist/core/modules.js

@@ -0,0 +1,68 @@
+import { RuntimeError } from "./errors.js";
+import { setupFilesMax } from "./limits.js";
+export function orderModules(modules) {
+    if (modules.length > setupFilesMax) {
+        throw new RuntimeError("InvalidModule", "Too many modules were supplied.");
+    }
+    const byId = new Map();
+    for (const module of modules) {
+        if (module.id.trim().length === 0) {
+            throw new RuntimeError("InvalidModule", "A module needs a non-empty ID.");
+        }
+        if (byId.has(module.id)) {
+            throw new RuntimeError("DuplicateModule", `Module "${module.id}" was supplied more than once.`);
+        }
+        byId.set(module.id, Object.freeze({
+            id: module.id,
+            ...(module.requires === undefined
+                ? {}
+                : { requires: Object.freeze([...module.requires]) }),
+            setup: module.setup.bind(module),
+            ...(module.reset === undefined ? {} : { reset: module.reset.bind(module) }),
+            ...(module.dispose === undefined ? {} : { dispose: module.dispose.bind(module) }),
+        }));
+    }
+    return visitModules(byId);
+}
+function visitModules(byId) {
+    const ordered = [];
+    const completed = new Set();
+    const active = new Set();
+    for (const module of byId.values()) {
+        if (completed.has(module.id)) {
+            continue;
+        }
+        const pending = [{ module, next: 0 }];
+        active.add(module.id);
+        while (pending.length > 0) {
+            const frame = pending.at(-1);
+            if (!frame) {
+                throw new Error("A module frame must exist while ordering is pending.");
+            }
+            const id = frame.module.requires?.[frame.next];
+            if (id === undefined) {
+                pending.pop();
+                active.delete(frame.module.id);
+                completed.add(frame.module.id);
+                ordered.push(frame.module);
+                continue;
+            }
+            frame.next += 1;
+            const dependency = byId.get(id);
+            if (!dependency) {
+                throw new RuntimeError("MissingModule", `Module "${frame.module.id}" requires missing module "${id}".`);
+            }
+            if (completed.has(id)) {
+                continue;
+            }
+            if (active.has(id)) {
+                const chain = [...pending.map((frame) => frame.module.id), id].join(" -> ");
+                throw new RuntimeError("ModuleCycle", `Module dependency cycle: ${chain}.`);
+            }
+            active.add(id);
+            pending.push({ module: dependency, next: 0 });
+        }
+    }
+    return ordered;
+}
+//# sourceMappingURL=modules.js.map

package/dist/core/modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["../../src/core/modules.ts"],"names":[],"mappings":"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"}

package/dist/core/operation.d.ts

@@ -0,0 +1,18 @@
+import type { AsyncHandler, SyncHandler } from "./types.js";
+declare const bindings: unique symbol;
+export type OperationBinding<Input, Output> = {
+    readonly mode: "sync";
+    readonly handler: SyncHandler<Input, Output>;
+} | {
+    readonly mode: "async";
+    readonly handler: AsyncHandler<Input, Output>;
+};
+export interface Operation<Input, Output> {
+    readonly name: string;
+    readonly [bindings]: WeakMap<object, OperationBinding<Input, Output>>;
+}
+export declare function defineOperation<Input, Output>(name: string): Operation<Input, Output>;
+export declare function bindOperation<Input, Output>(operation: Operation<Input, Output>, owner: object, binding: OperationBinding<Input, Output>): () => void;
+export declare function getOperationBinding<Input, Output>(operation: Operation<Input, Output>, owner: object): OperationBinding<Input, Output> | undefined;
+export {};
+//# sourceMappingURL=operation.d.ts.map

package/dist/core/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/core/operation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,QAAA,MAAM,QAAQ,eAA+B,CAAC;AAE9C,MAAM,MAAM,gBAAgB,CAAC,KAAK,EAAE,MAAM,IACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,SAAS,CAAC,KAAK,EAAE,MAAM;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;CACzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CASrF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EACvC,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GACzC,MAAM,IAAI,CAMZ;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAC7C,SAAS,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EACnC,KAAK,EAAE,MAAM,GACd,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,SAAS,CAE7C"}

package/dist/core/operation.js

@@ -0,0 +1,21 @@
+import { RuntimeError } from "./errors.js";
+const bindings = Symbol("operation bindings");
+export function defineOperation(name) {
+    if (typeof name !== "string" || name.trim().length === 0 || name.length > 1024) {
+        throw new RuntimeError("InvalidOperation", "An operation needs a non-empty name.");
+    }
+    return Object.freeze({
+        name,
+        [bindings]: new WeakMap(),
+    });
+}
+export function bindOperation(operation, owner, binding) {
+    operation[bindings].set(owner, binding);
+    return () => {
+        operation[bindings].delete(owner);
+    };
+}
+export function getOperationBinding(operation, owner) {
+    return operation[bindings].get(owner);
+}
+//# sourceMappingURL=operation.js.map

package/dist/core/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/core/operation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,QAAQ,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAW9C,MAAM,UAAU,eAAe,CAAgB,IAAY;IACvD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QAC7E,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,sCAAsC,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI;QACJ,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,EAA2C;KACrE,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,aAAa,CACzB,SAAmC,EACnC,KAAa,EACb,OAAwC;IAExC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAExC,OAAO,GAAG,EAAE;QACR,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,mBAAmB,CAC/B,SAAmC,EACnC,KAAa;IAEb,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/core/process.d.ts

@@ -0,0 +1,3 @@
+/** Drain pipes while retaining bounded diagnostics; a full buffer must not deadlock the child. */
+export declare function readProcessOutput(stream: ReadableStream<Uint8Array>, signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=process.d.ts.map

package/dist/core/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/core/process.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,wBAAsB,iBAAiB,CACnC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAgDjB"}