@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/platform/action-responses.js

@@ -0,0 +1,85 @@
+import { spendContext } from "../core/context.js";
+import { dataDepthMax, dataNodesMax } from "../core/limits.js";
+import { Item, itemNode } from "../items/item.js";
+import { ApplicationError, PlatformError } from "./errors.js";
+const fetchedActions = new Set(["add", "edit", "update", "lock", "unlock"]);
+/** Return retrieval is an action phase, distinct from persistence and its mutation hooks. */
+export class ActionResponses {
+    apply;
+    hasAfterEvents;
+    constructor(apply, hasAfterEvents) {
+        this.apply = apply;
+        this.hasAfterEvents = hasAfterEvents;
+    }
+    prepare(request, context) {
+        if (request.attributes.doGetItem === undefined || request.attributes.doGetItem === "") {
+            request.attributes.doGetItem = "1";
+        }
+        const pending = [{ node: request, depth: 0 }];
+        let visited = 0;
+        while (pending.length > 0) {
+            spendContext(context);
+            const frame = pending.pop();
+            if (!frame || ++visited > dataNodesMax || frame.depth > dataDepthMax) {
+                throw new PlatformError("ProtocolLimit", "Action responses exceed their input limit.");
+            }
+            const node = frame.node;
+            if (frame.depth > 0 && !node.attributes.doGetItem) {
+                node.attributes.doGetItem = this.hasAfterEvents(node.type) ? "1" : "0";
+            }
+            for (const child of [...Object.values(node.propertyItems), ...node.relationships]) {
+                pending.push({ node: child, depth: frame.depth + 1 });
+            }
+        }
+    }
+    async complete(request, response, context) {
+        const action = request.attributes.action ?? "get";
+        if (response.isError() || response.payload.result !== undefined) {
+            return response;
+        }
+        if (action === "delete") {
+            return new Item({ items: [], result: "Ok" });
+        }
+        if (!fetchedActions.has(action)) {
+            return response;
+        }
+        if (request.attributes.doGetItem === "0") {
+            if (action === "lock" || action === "unlock") {
+                return new Item({ items: [], result: "Ok." });
+            }
+            return new Item({ items: response.payload.items.map(identityNode) });
+        }
+        return await this.fetch(request, response, context);
+    }
+    async fetch(request, response, context) {
+        const query = Item.create(request.type, "get");
+        const ids = response.payload.items.map((node) => node.attributes.id ?? "");
+        if (ids.length === 0 || ids.some((id) => !id)) {
+            throw new PlatformError("InvalidActionResult", "A default action must retain its target IDs.");
+        }
+        query.setAttribute("idlist", ids.join(","));
+        if (request.attributes.select) {
+            query.setAttribute("select", request.attributes.select);
+        }
+        const action = request.attributes.action;
+        if (request.attributes.serverEvents === "0" && action !== "lock" && action !== "unlock") {
+            query.setAttribute("serverEvents", "0");
+        }
+        const result = await this.apply(query, context);
+        if (result.isError()) {
+            throw new ApplicationError(result);
+        }
+        const positions = new Map(ids.map((id, index) => [id.toLowerCase(), index]));
+        result.payload.items.sort((left, right) => (positions.get((left.attributes.id ?? "").toLowerCase()) ?? ids.length) -
+            (positions.get((right.attributes.id ?? "").toLowerCase()) ?? ids.length));
+        return result;
+    }
+}
+function identityNode(node) {
+    const id = node.attributes.id;
+    if (!id) {
+        throw new PlatformError("InvalidActionResult", "A minimal response requires its Item ID.");
+    }
+    return { ...itemNode(node.type), attributes: { id } };
+}
+//# sourceMappingURL=action-responses.js.map

package/dist/platform/action-responses.js.map

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

package/dist/platform/actions.d.ts

@@ -0,0 +1,12 @@
+export declare enum ItemAction {
+    Get = "get",
+    Add = "add",
+    Edit = "edit",
+    Update = "update",
+    Delete = "delete",
+    Version = "version",
+    Lock = "lock",
+    Unlock = "unlock",
+    PromoteItem = "promoteItem"
+}
+//# sourceMappingURL=actions.d.ts.map

package/dist/platform/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/platform/actions.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IAClB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,WAAW,gBAAgB;CAC9B"}

package/dist/platform/actions.js

@@ -0,0 +1,13 @@
+export var ItemAction;
+(function (ItemAction) {
+    ItemAction["Get"] = "get";
+    ItemAction["Add"] = "add";
+    ItemAction["Edit"] = "edit";
+    ItemAction["Update"] = "update";
+    ItemAction["Delete"] = "delete";
+    ItemAction["Version"] = "version";
+    ItemAction["Lock"] = "lock";
+    ItemAction["Unlock"] = "unlock";
+    ItemAction["PromoteItem"] = "promoteItem";
+})(ItemAction || (ItemAction = {}));
+//# sourceMappingURL=actions.js.map

package/dist/platform/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/platform/actions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAUX;AAVD,WAAY,UAAU;IAClB,yBAAW,CAAA;IACX,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,iCAAmB,CAAA;IACnB,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,yCAA2B,CAAA;AAC/B,CAAC,EAVW,UAAU,KAAV,UAAU,QAUrB"}

package/dist/platform/catalog.d.ts

@@ -0,0 +1,20 @@
+import type { MethodDefinition } from "../methods/types.js";
+import type { CatalogEntry, HarnessStorage, ItemTypeDefinition } from "../storage/types.js";
+import { Classifications } from "./classifications.js";
+import { ServerEventVersion } from "./events/types.js";
+export declare class PlatformCatalog {
+    private readonly storage;
+    readonly classifications: Classifications;
+    private readonly bindings;
+    private epoch;
+    private methods;
+    private readonly definitions;
+    constructor(storage: HarnessStorage);
+    assertMutable(definition: ItemTypeDefinition): void;
+    itemType(name: string): ItemTypeDefinition;
+    methodEntry(nameOrId: string): CatalogEntry | undefined;
+    private refreshMethods;
+    method(nameOrId: string): MethodDefinition;
+    events(definition: ItemTypeDefinition, name: string, enabled?: boolean, version?: ServerEventVersion): readonly import("./events/types.js").EventBinding[];
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/platform/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/platform/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAM5D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAwDvD,qBAAa,eAAe;IAOZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,YAA6B,OAAO,EAAE,cAAc,EAGnD;IAED,aAAa,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAclD;IAED,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA4BzC;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,4BAe3B;IAED,OAAO,CAAC,cAAc;IA+BtB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmCzC;IAED,MAAM,CACF,UAAU,EAAE,kBAAkB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,UAAO,EACd,OAAO,qBAA0B,uDAGpC;CACJ"}

package/dist/platform/catalog.js

@@ -0,0 +1,155 @@
+import { CapabilityId } from "../compatibility/capabilities.js";
+import { presentationTypes } from "../packages/bootstrap.js";
+import { walkElements } from "../packages/elements.js";
+import { parseAml } from "../packages/parser.js";
+import { findDocument } from "../storage/documents.js";
+import { metadataEpoch } from "../storage/metadata-epoch.js";
+import { Classifications } from "./classifications.js";
+import { PlatformError } from "./errors.js";
+import { EventBindings } from "./events/bindings.js";
+import { ServerEventVersion } from "./events/types.js";
+const definitionTypes = new Set([
+    "itemtype",
+    "property",
+    "relationshiptype",
+    "morphae",
+    "revision",
+    "method",
+    "sql",
+    "server event",
+    "life cycle map",
+    "life cycle state",
+    "life cycle transition",
+    "itemtype life cycle",
+]);
+const sourceLocationsMax = 512;
+const sourceLocations = new Map();
+/** Source coordinates depend on original XML bytes, independently of a world's database. */
+function methodCodeSource(storage, original) {
+    const document = findDocument(storage, original.file);
+    if (!document) {
+        return original;
+    }
+    const path = `${original.path}/method_code[1]`;
+    const key = JSON.stringify([
+        document.path,
+        new Bun.CryptoHasher("sha256").update(document.xml).digest("hex"),
+        path,
+    ]);
+    const cached = sourceLocations.get(key);
+    if (cached) {
+        return cached;
+    }
+    for (const element of walkElements(parseAml(document.xml, document.path).items)) {
+        if (element.source.path === path) {
+            if (sourceLocations.size >= sourceLocationsMax) {
+                sourceLocations.clear();
+            }
+            const source = Object.freeze({ ...element.source });
+            sourceLocations.set(key, source);
+            return source;
+        }
+    }
+    return original;
+}
+export class PlatformCatalog {
+    storage;
+    classifications;
+    bindings;
+    epoch;
+    methods;
+    definitions = new Map();
+    constructor(storage) {
+        this.storage = storage;
+        this.classifications = new Classifications(storage);
+        this.bindings = new EventBindings(storage);
+    }
+    assertMutable(definition) {
+        if (presentationTypes.has(definition.name)) {
+            throw new PlatformError("UnsupportedPresentation", `Presentation metadata '${definition.name}' is retained from its package; changing it requires a presentation adapter.`);
+        }
+        if (definitionTypes.has(definition.name.toLowerCase())) {
+            throw new PlatformError("UnsupportedDefinitionMutation", `Changes to '${definition.name}' definitions must be loaded through packages. Runtime definition mutation is not implemented.`);
+        }
+    }
+    itemType(name) {
+        const definition = this.storage.getItemType(name);
+        if (!definition) {
+            const metadata = this.storage
+                .listCatalogEntries("ItemType")
+                .find((entry) => String(entry.properties.name).toLowerCase() === name.toLowerCase());
+            if (metadata && metadata.properties.implementation_type !== "table") {
+                throw new PlatformError("UnsupportedImplementation", `ItemType '${name}' uses '${metadata.properties.implementation_type}' storage and requires an adapter. Its metadata is available through ItemType queries.`, {
+                    capability: String(metadata.properties.implementation_type).toLowerCase() ===
+                        "polymorphic"
+                        ? CapabilityId.Polymorphism
+                        : CapabilityId.Federation,
+                });
+            }
+            throw new PlatformError("MissingItemType", `ItemType '${name}' has not been imported.`);
+        }
+        return definition;
+    }
+    methodEntry(nameOrId) {
+        this.refreshMethods();
+        const candidates = this.methods?.get(nameOrId.toLowerCase()) ?? [];
+        const current = candidates.filter((entry) => entry.properties.is_current !== 0 && entry.properties.is_current !== "0");
+        if (current.length > 1) {
+            throw new PlatformError("MethodResolution", `Method '${nameOrId}' resolved to ${current.length} current definitions.`);
+        }
+        return current[0];
+    }
+    refreshMethods() {
+        const epoch = metadataEpoch(this.storage);
+        if (epoch !== undefined && this.methods && this.epoch === epoch) {
+            return;
+        }
+        this.epoch = epoch;
+        this.methods = new Map();
+        this.definitions.clear();
+        for (const entry of this.storage.listCatalogEntries("Method")) {
+            const keys = new Set([entry.id, entry.properties.name, entry.properties.config_id]);
+            for (const key of keys) {
+                if (typeof key !== "string") {
+                    continue;
+                }
+                const normalized = key.toLowerCase();
+                const entries = this.methods.get(normalized) ?? [];
+                if (!entries.includes(entry)) {
+                    entries.push(entry);
+                }
+                this.methods.set(normalized, entries);
+            }
+        }
+    }
+    method(nameOrId) {
+        const method = this.methodEntry(nameOrId);
+        if (!method) {
+            throw new PlatformError("MethodResolution", `Missing Method '${nameOrId}'.`);
+        }
+        const cached = this.definitions.get(method.id);
+        if (cached) {
+            return cached;
+        }
+        const name = method.properties.name;
+        const language = method.properties.method_type;
+        const code = method.properties.method_code;
+        if (typeof name !== "string" || typeof language !== "string" || typeof code !== "string") {
+            throw new PlatformError("InvalidMethod", `Method '${nameOrId}' is missing its name, language or source.`);
+        }
+        const definition = Object.freeze({
+            id: method.id,
+            name,
+            language,
+            code,
+            source: Object.freeze({ ...methodCodeSource(this.storage, method.source) }),
+            hash: new Bun.CryptoHasher("sha256").update(code).digest("hex"),
+        });
+        this.definitions.set(method.id, definition);
+        return definition;
+    }
+    events(definition, name, enabled = true, version = ServerEventVersion.Item) {
+        return this.bindings.select(definition, name, enabled, version);
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/platform/catalog.js.map

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

package/dist/platform/classifications.d.ts

@@ -0,0 +1,14 @@
+import type { ExecutionContext } from "../core/types.js";
+import type { HarnessStorage, ItemTypeDefinition, StorageValue } from "../storage/types.js";
+/** Grants may name branches; stored classification values must name leaves or the root. */
+export declare class Classifications {
+    private readonly storage;
+    private readonly cache;
+    private readonly rootPaths;
+    private readonly rootStructure;
+    constructor(storage: HarnessStorage);
+    paths(definition: ItemTypeDefinition, context: ExecutionContext): ReadonlySet<string>;
+    assertValue(definition: ItemTypeDefinition, value: StorageValue | undefined, context: ExecutionContext): void;
+    private structure;
+}
+//# sourceMappingURL=classifications.d.ts.map

package/dist/platform/classifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifications.d.ts","sourceRoot":"","sources":["../../src/platform/classifications.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAIzD,OAAO,KAAK,EAER,cAAc,EACd,kBAAkB,EAClB,YAAY,EACf,MAAM,qBAAqB,CAAC;AAS7B,2FAA2F;AAC3F,qBAAa,eAAe;IASZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAI5B;IAEF,YAA6B,OAAO,EAAE,cAAc,EAAI;IAExD,KAAK,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAAC,MAAM,CAAC,CAEpF;IAED,WAAW,CACP,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,OAAO,EAAE,gBAAgB,GAC1B,IAAI,CAWN;IAED,OAAO,CAAC,SAAS;CAoCpB"}

package/dist/platform/classifications.js

@@ -0,0 +1,100 @@
+import { spendContext } from "../core/context.js";
+import { dataBytesMax } from "../core/limits.js";
+import { Item } from "../items/item.js";
+import { parseXml } from "../packages/parser.js";
+import { ApplicationError, PlatformError } from "./errors.js";
+/** Grants may name branches; stored classification values must name leaves or the root. */
+export class Classifications {
+    storage;
+    cache = new Map();
+    rootPaths = new Set([""]);
+    rootStructure = {
+        xml: "",
+        paths: this.rootPaths,
+        selectable: this.rootPaths,
+    };
+    constructor(storage) {
+        this.storage = storage;
+    }
+    paths(definition, context) {
+        return this.structure(definition, context).paths;
+    }
+    assertValue(definition, value, context) {
+        const path = String(value ?? "");
+        if (!this.structure(definition, context).selectable.has(path)) {
+            throw new ApplicationError(Item.error(`Invalid classification '${path}' for '${definition.name}': choose a leaf class or the unclassified root.`, "InvalidClassification"));
+        }
+    }
+    structure(definition, context) {
+        spendContext(context);
+        const metadata = this.storage.getCatalogEntry("ItemType", definition.id);
+        const xml = metadata?.properties.class_structure;
+        if (xml === undefined || xml === null || xml === "") {
+            return this.rootStructure;
+        }
+        if (typeof xml !== "string") {
+            throw invalidStructure(definition, metadata, "class_structure must contain XML text.");
+        }
+        const cached = this.cache.get(definition.id);
+        if (cached?.xml === xml) {
+            return cached;
+        }
+        let root;
+        try {
+            root = parseXml(xml, metadata?.source.file ?? "class_structure");
+        }
+        catch (cause) {
+            throw new PlatformError("InvalidClassStructure", `Invalid class_structure XML for '${definition.name}'.`, { cause, ...(metadata ? { source: metadata.source } : {}) });
+        }
+        const structure = { xml, ...readPaths(root, definition, metadata, context) };
+        this.cache.set(definition.id, structure);
+        return structure;
+    }
+}
+function readPaths(root, definition, metadata, context) {
+    const paths = new Set();
+    const selectable = new Set();
+    const pending = [{ element: root, path: "" }];
+    let pathBytes = 0;
+    while (pending.length > 0) {
+        spendContext(context);
+        const entry = pending.pop();
+        if (!entry) {
+            throw new Error("A pending class entry must exist.");
+        }
+        if (entry.element.name.split(":").at(-1) !== "class" || paths.has(entry.path)) {
+            throw invalidStructure(definition, metadata, "Expected unique class paths.");
+        }
+        paths.add(entry.path);
+        selectable.add(entry.path);
+        for (const child of entry.element.children) {
+            spendContext(context);
+            if (child.kind !== "element") {
+                if (child.value.trim()) {
+                    throw invalidStructure(definition, metadata, "Classes cannot contain text.");
+                }
+                continue;
+            }
+            const name = child.attributes.name;
+            selectable.delete(entry.path);
+            if (!name || name.includes("/")) {
+                throw invalidStructure(definition, metadata, "Class names must be path segments.");
+            }
+            const length = entry.path.length + name.length + (entry.path ? 1 : 0);
+            const bytes = length * 3;
+            if (bytes > dataBytesMax - pathBytes) {
+                throw invalidStructure(definition, metadata, "Class paths exceed the text limit.");
+            }
+            pathBytes += bytes;
+            spendContext(context, length);
+            const path = entry.path ? `${entry.path}/${name}` : name;
+            pending.push({ element: child, path });
+        }
+    }
+    selectable.add("");
+    return { paths, selectable };
+}
+function invalidStructure(definition, metadata, detail) {
+    return new PlatformError("InvalidClassStructure", `Invalid class_structure for '${definition.name}': ${detail}`, metadata ? { source: metadata.source } : undefined);
+}
+//# sourceMappingURL=classifications.js.map

package/dist/platform/classifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifications.js","sourceRoot":"","sources":["../../src/platform/classifications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAQjD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQ9D,2FAA2F;AAC3F,MAAM,OAAO,eAAe;IASK,OAAO;IARnB,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC3C,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,aAAa,GAAoB;QAC9C,GAAG,EAAE,EAAE;QACP,KAAK,EAAE,IAAI,CAAC,SAAS;QACrB,UAAU,EAAE,IAAI,CAAC,SAAS;KAC7B,CAAC;IAEF,YAA6B,OAAuB;uBAAvB,OAAO;IAAmB,CAAC;IAExD,KAAK,CAAC,UAA8B,EAAE,OAAyB;QAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IACrD,CAAC;IAED,WAAW,CACP,UAA8B,EAC9B,KAA+B,EAC/B,OAAyB;QAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAEjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,gBAAgB,CACtB,IAAI,CAAC,KAAK,CACN,2BAA2B,IAAI,UAAU,UAAU,CAAC,IAAI,kDAAkD,EAC1G,uBAAuB,CAC1B,CACJ,CAAC;QACN,CAAC;IACL,CAAC;IAEO,SAAS,CAAC,UAA8B,EAAE,OAAyB;QACvE,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC;QAEjD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YAClD,OAAO,IAAI,CAAC,aAAa,CAAC;QAC9B,CAAC;QAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,wCAAwC,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAE7C,IAAI,MAAM,EAAE,GAAG,KAAK,GAAG,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,IAAgB,CAAC;QAErB,IAAI,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,iBAAiB,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,aAAa,CACnB,uBAAuB,EACvB,oCAAoC,UAAU,CAAC,IAAI,IAAI,EACvD,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAC9D,CAAC;QACN,CAAC;QAED,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAEzC,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ;AAED,SAAS,SAAS,CACd,IAAgB,EAChB,UAA8B,EAC9B,QAAkC,EAClC,OAAyB;IAEzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5E,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,8BAA8B,CAAC,CAAC;QACjF,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzC,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;oBACrB,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,8BAA8B,CAAC,CAAC;gBACjF,CAAC;gBAED,SAAS;YACb,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;YACnC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE9B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,oCAAoC,CAAC,CAAC;YACvF,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;YAEzB,IAAI,KAAK,GAAG,YAAY,GAAG,SAAS,EAAE,CAAC;gBACnC,MAAM,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,oCAAoC,CAAC,CAAC;YACvF,CAAC;YAED,SAAS,IAAI,KAAK,CAAC;YACnB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IAED,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEnB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,gBAAgB,CACrB,UAA8B,EAC9B,QAAkC,EAClC,MAAc;IAEd,OAAO,IAAI,aAAa,CACpB,uBAAuB,EACvB,gCAAgC,UAAU,CAAC,IAAI,MAAM,MAAM,EAAE,EAC7D,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACrD,CAAC;AACN,CAAC"}

package/dist/platform/creation.d.ts

@@ -0,0 +1,4 @@
+import type { ItemTypeDefinition, StorageValue } from "../storage/types.js";
+/** Required native creation fields are supplied by actions, never by fixture import. */
+export declare function creationDefaults(definition: ItemTypeDefinition, values: Readonly<Record<string, StorageValue>>, userId: (() => string) | undefined, now?: () => Date): Readonly<Record<string, StorageValue>>;
+//# sourceMappingURL=creation.d.ts.map

package/dist/platform/creation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation.d.ts","sourceRoot":"","sources":["../../src/platform/creation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG5E,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC5B,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,EAC9C,MAAM,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,EAClC,GAAG,GAAE,MAAM,IAAuB,GACnC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CA2BxC"}

package/dist/platform/creation.js

@@ -0,0 +1,23 @@
+import { PlatformError } from "./errors.js";
+/** Required native creation fields are supplied by actions, never by fixture import. */
+export function creationDefaults(definition, values, userId, now = () => new Date()) {
+    const defaults = {};
+    for (const property of definition.properties) {
+        if (!property.isRequired ||
+            values[property.name] !== undefined ||
+            property.defaultValue !== undefined) {
+            continue;
+        }
+        if (property.name === "created_on" && property.dataType === "date") {
+            defaults.created_on = now().toISOString();
+        }
+        else if (property.name === "created_by_id" && property.dataType === "item") {
+            if (!userId) {
+                throw new PlatformError("SessionRequired", `Adding '${definition.name}' requires a User session for created_by_id.`);
+            }
+            defaults.created_by_id = userId();
+        }
+    }
+    return defaults;
+}
+//# sourceMappingURL=creation.js.map

package/dist/platform/creation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation.js","sourceRoot":"","sources":["../../src/platform/creation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAC5B,UAA8B,EAC9B,MAA8C,EAC9C,MAAkC,EAClC,GAAG,GAAe,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IAElC,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAElD,KAAK,MAAM,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC3C,IACI,CAAC,QAAQ,CAAC,UAAU;YACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,SAAS;YACnC,QAAQ,CAAC,YAAY,KAAK,SAAS,EACrC,CAAC;YACC,SAAS;QACb,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACjE,QAAQ,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;aAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC3E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACV,MAAM,IAAI,aAAa,CACnB,iBAAiB,EACjB,WAAW,UAAU,CAAC,IAAI,8CAA8C,CAC3E,CAAC;YACN,CAAC;YAED,QAAQ,CAAC,aAAa,GAAG,MAAM,EAAE,CAAC;QACtC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/platform/engine.d.ts

@@ -0,0 +1,127 @@
+import type { HarnessModule } from "../core/types.js";
+import { Item } from "../items/item.js";
+import type { MethodEventData } from "../methods/event-data.js";
+import type { MethodExecutor } from "../methods/types.js";
+import type { MockRegistry } from "../mocks/registry.js";
+import type { SelectQuery } from "../queries/types.js";
+import type { HarnessStorage, StorageValue, StoredItem } from "../storage/types.js";
+import type { AuthorizationPolicy } from "./security/types.js";
+import { PlatformTrace } from "./trace.js";
+import type { ItemReference, SeedValue } from "./values.js";
+interface MethodCall {
+    readonly name: string;
+    readonly context: Item;
+    readonly eventData?: MethodEventData;
+}
+interface SeedCall {
+    readonly type: string;
+    readonly properties: Readonly<Record<string, SeedValue>>;
+}
+interface SeedRecord extends SeedCall {
+    readonly id: string;
+}
+export declare const applyItemOperation: import("../core/operation.js").Operation<Item, Item>;
+export declare const callMethodOperation: import("../core/operation.js").Operation<MethodCall, Item>;
+export declare const seedOperation: import("../core/operation.js").Operation<SeedCall, ItemReference>;
+export declare const seedRecordsOperation: import("../core/operation.js").Operation<readonly SeedRecord[], void>;
+export declare const applyAMLOperation: import("../core/operation.js").Operation<string, Item>;
+export type { AuthorizationRequest } from "./security/types.js";
+export interface PlatformOptions {
+    readonly userId?: () => string;
+    readonly executors?: readonly MethodExecutor[];
+    readonly authorization?: AuthorizationPolicy;
+    readonly nextId?: () => string;
+    readonly mocks?: MockRegistry;
+}
+export declare class Platform {
+    private readonly storage;
+    private readonly options;
+    readonly trace: PlatformTrace;
+    private readonly now;
+    private readonly catalog;
+    private readonly executors;
+    private readonly ownedExecutors;
+    private readonly identity;
+    private generation;
+    private readonly nextId;
+    private readonly locks;
+    private readonly versioning;
+    private readonly lifeCycles;
+    private readonly revisions;
+    private readonly queries;
+    private readonly graph;
+    private readonly references;
+    private readonly deletion;
+    private readonly security;
+    private readonly responses;
+    private readonly replacements;
+    private readonly boundMethods;
+    private readonly baseOverrides;
+    private readonly baseUpdates;
+    private readonly afterEvents;
+    constructor(storage: HarnessStorage, options?: PlatformOptions, trace?: PlatformTrace, now?: () => Date, select?: SelectQuery);
+    private createDependentDeletion;
+    private createAfterEvents;
+    private eventRunners;
+    private registerExecutors;
+    module(): HarnessModule;
+    inspect(reference: ItemReference): StoredItem;
+    item(reference: ItemReference, action?: string): Item;
+    find(type: string, properties: Readonly<Record<string, StorageValue>>): ItemReference;
+    private assertReference;
+    private seed;
+    private resolveSeedProperties;
+    private authorize;
+    private callBoundMethod;
+    private authorizeMethod;
+    private callMethod;
+    private checkedMethodResult;
+    private executeMethod;
+    private executorFor;
+    private mockResult;
+    private eventBindings;
+    private hasAfterEvents;
+    private events;
+    private invokeEvent;
+    private hydrateEventItem;
+    private apply;
+    private applyStandardAction;
+    private prepareAddId;
+    private assertActionContext;
+    private authorizeAction;
+    private traceAction;
+    private applyStateAction;
+    private applyStateTarget;
+    private authorizeTransition;
+    private applySqlProcess;
+    private unsupportedSqlProcess;
+    private sqlSource;
+    private query;
+    private add;
+    private setupPlatform;
+    private deleteOwned;
+    private applyAML;
+    private registerSeedOperations;
+    private assertActionSupported;
+    private replaceAction;
+    private delegateBase;
+    private applyBaseItem;
+    private updateEvent;
+    private applyVersionedUpdate;
+    private get;
+    private mutateExisting;
+    private mutationTargets;
+    private pinnedMutationTargets;
+    private deletionTargets;
+    private mutateTarget;
+    private applyCapturedMutation;
+    private mutateTargetBase;
+    private recordResponse;
+    private mutateRecord;
+    private updateRecord;
+    private assertAddProperties;
+    private creationProperties;
+    private methodPorts;
+    private mockedMethodResult;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/platform/engine.d.ts.map

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