@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/platform/references/sessions.js

@@ -0,0 +1,98 @@
+import { spendContext } from "../../core/context.js";
+import { dataNodesMax } from "../../core/limits.js";
+import { Item } from "../../items/item.js";
+import { ApplicationError, PlatformError } from "../errors.js";
+import { recordKey } from "./catalog.js";
+/** A Method or AML batch may construct several linked Items before the transaction is checked. */
+export class ReferenceSessions {
+    storage;
+    catalog;
+    sessions = new Map();
+    constructor(storage, catalog) {
+        this.storage = storage;
+        this.catalog = catalog;
+    }
+    async run(context, work) {
+        if (this.sessions.has(context.requestId)) {
+            return await work();
+        }
+        const session = {
+            created: new Map(),
+            scheduled: new Set(),
+            active: new Set(),
+            deleted: new Map(),
+        };
+        this.sessions.set(context.requestId, session);
+        try {
+            const result = await work();
+            this.validate(session, context);
+            return result;
+        }
+        finally {
+            this.sessions.delete(context.requestId);
+        }
+    }
+    created(record, context) {
+        this.session(context).created.set(recordKey(record), record);
+    }
+    schedule(record, context) {
+        const session = this.session(context);
+        if (session.scheduled.size >= dataNodesMax) {
+            throw new PlatformError("ProtocolLimit", "Deletion exceeds its record budget.");
+        }
+        session.scheduled.add(recordKey(record));
+    }
+    scheduled(record, context) {
+        return this.session(context).scheduled.has(recordKey(record));
+    }
+    active(record, context) {
+        return this.session(context).active.has(recordKey(record));
+    }
+    async deleting(record, context, work) {
+        const session = this.session(context);
+        const key = recordKey(record);
+        if (session.active.has(key)) {
+            throw new PlatformError("RelationshipCycle", `Cyclic deletion of '${record.type}:${record.id}'.`);
+        }
+        session.active.add(key);
+        try {
+            return await work();
+        }
+        finally {
+            session.active.delete(key);
+        }
+    }
+    deleted(record, context) {
+        this.session(context).deleted.set(recordKey(record), record);
+    }
+    session(context) {
+        spendContext(context);
+        const session = this.sessions.get(context.requestId);
+        if (!session) {
+            throw new Error("Platform reference changes require an active request scope.");
+        }
+        return session;
+    }
+    validate(session, context) {
+        for (const record of session.deleted.values()) {
+            if (this.storage.getItem(record.type, record.id)) {
+                continue;
+            }
+            const incoming = this.catalog.incoming(record, context).next();
+            if (!incoming.done) {
+                const source = incoming.value;
+                throw new ApplicationError(Item.error(`Deletion left '${source.definition.name}.${source.property.name}' referencing '${record.type}:${record.id}'.`, "ReferencedItem"));
+            }
+        }
+        for (const record of session.created.values()) {
+            const definition = this.storage.getItemType(record.type);
+            if (definition &&
+                this.catalog.dependent(definition) &&
+                this.storage.getItem(record.type, record.id) &&
+                !this.catalog.hasOwner(record, context)) {
+                throw new ApplicationError(Item.error(`Dependent '${record.type}:${record.id}' requires an owning reference in the same request.`, "DependentItem"));
+            }
+        }
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/platform/references/sessions.js.map

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

package/dist/platform/relationship-copy-policy.d.ts

@@ -0,0 +1,10 @@
+import type { HarnessStorage, ItemTypeDefinition, StoredItem } from "../storage/types.js";
+/** Suppressed business hooks do not replace native revision or vault services. */
+export declare class VersionCopyPolicy {
+    private readonly storage;
+    private readonly hasFileContainer;
+    private readonly checked;
+    constructor(storage: HarnessStorage);
+    assertSupported(definition: ItemTypeDefinition, records: readonly StoredItem[]): void;
+}
+//# sourceMappingURL=relationship-copy-policy.d.ts.map

package/dist/platform/relationship-copy-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-copy-policy.d.ts","sourceRoot":"","sources":["../../src/platform/relationship-copy-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQ1F,kFAAkF;AAClF,qBAAa,iBAAiB;IAId,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YAA6B,OAAO,EAAE,cAAc,EAGnD;IAED,eAAe,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CA8CpF;CACJ"}

package/dist/platform/relationship-copy-policy.js

@@ -0,0 +1,41 @@
+import { PlatformError } from "./errors.js";
+import { eventOwners } from "./events/inheritance.js";
+import { isReleased } from "./revisions/policy.js";
+const fileContainerTypeId = "41EF49EFD2ED4F6EAB04C047681F33AC";
+const fileTypeId = "8052A558B9084D41B9F11805E464F443";
+/** Suppressed business hooks do not replace native revision or vault services. */
+export class VersionCopyPolicy {
+    storage;
+    hasFileContainer;
+    checked = new Set();
+    constructor(storage) {
+        this.storage = storage;
+        this.hasFileContainer =
+            storage.getCatalogEntry("ItemType", fileContainerTypeId) !== undefined;
+    }
+    assertSupported(definition, records) {
+        if (definition.isVersionable && records.some((record) => isReleased(record))) {
+            throw new PlatformError("UnsupportedRevision", "Cloning released relationships requires a revision and lifecycle reset policy.");
+        }
+        const id = definition.id.toLowerCase();
+        if (this.checked.has(id)) {
+            return;
+        }
+        const owners = eventOwners(this.storage, definition.id);
+        if (id === fileTypeId.toLowerCase() ||
+            definition.name.toLowerCase() === "file" ||
+            (this.hasFileContainer && owners.has(fileContainerTypeId.toLowerCase()))) {
+            throw new PlatformError("UnsupportedFileCopy", `Copying '${definition.name}' during versioning requires native file-container and vault services, which are unavailable.`, definition.source ? { source: definition.source } : undefined);
+        }
+        const reset = this.storage.listCatalogEntries("Server Event").find((entry) => {
+            const properties = entry.properties;
+            return (owners.has(String(properties.source_id).toLowerCase()) &&
+                String(properties.server_event).toLowerCase() === "onafterresetlifecycle");
+        });
+        if (reset) {
+            throw new PlatformError("UnsupportedLifecycleResetEvent", `Copying '${definition.name}' requires onAfterResetLifecycle event metadata, which is unavailable.`, { source: reset.source });
+        }
+        this.checked.add(id);
+    }
+}
+//# sourceMappingURL=relationship-copy-policy.js.map

package/dist/platform/relationship-copy-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-copy-policy.js","sourceRoot":"","sources":["../../src/platform/relationship-copy-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAC/D,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAEtD,kFAAkF;AAClF,MAAM,OAAO,iBAAiB;IAIG,OAAO;IAHnB,gBAAgB,CAAU;IAC1B,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAE7C,YAA6B,OAAuB;uBAAvB,OAAO;QAChC,IAAI,CAAC,gBAAgB;YACjB,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,mBAAmB,CAAC,KAAK,SAAS,CAAC;IAC/E,CAAC;IAED,eAAe,CAAC,UAA8B,EAAE,OAA8B;QAC1E,IAAI,UAAU,CAAC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,IAAI,aAAa,CACnB,qBAAqB,EACrB,gFAAgF,CACnF,CAAC;QACN,CAAC;QAED,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QAEvC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,OAAO;QACX,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QAExD,IACI,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE;YAC/B,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM;YACxC,CAAC,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,EAAE,CAAC,CAAC,EAC1E,CAAC;YACC,MAAM,IAAI,aAAa,CACnB,qBAAqB,EACrB,YAAY,UAAU,CAAC,IAAI,+FAA+F,EAC1H,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAChE,CAAC;QACN,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACzE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;YAEpC,OAAO,CACH,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;gBACtD,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAC5E,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,aAAa,CACnB,gCAAgC,EAChC,YAAY,UAAU,CAAC,IAAI,wEAAwE,EACnG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAC3B,CAAC;QACN,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;CACJ"}

package/dist/platform/relationship-copy.d.ts

@@ -0,0 +1,21 @@
+import type { ExecutionContext } from "../core/types.js";
+import type { HarnessStorage, StoredItem } from "../storage/types.js";
+import type { LifeCycles } from "./lifecycle.js";
+import type { ReferenceMaintenance } from "./references/maintenance.js";
+import type { NativeSecurity } from "./security/policy.js";
+import type { PlatformTrace } from "./trace.js";
+/** Parent versions copy stored relationships without invoking business copy or mutation hooks. */
+export declare class RelationshipCopy {
+    private readonly storage;
+    private readonly trace;
+    private readonly nextId;
+    private readonly references;
+    private readonly security;
+    private readonly lifeCycles;
+    constructor(storage: HarnessStorage, trace: PlatformTrace, nextId: () => string, references: ReferenceMaintenance, security: NativeSecurity, lifeCycles: LifeCycles);
+    copy(source: StoredItem, target: StoredItem, copies: Map<string, string>, context: ExecutionContext): void;
+    private enter;
+    private copyGroup;
+    private insert;
+}
+//# sourceMappingURL=relationship-copy.d.ts.map

package/dist/platform/relationship-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-copy.d.ts","sourceRoot":"","sources":["../../src/platform/relationship-copy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAsB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG1F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsBhD,kGAAkG;AAClG,qBAAa,gBAAgB;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAN/B,YACqB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,MAAM,EACpB,UAAU,EAAE,oBAAoB,EAChC,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,UAAU,EACvC;IAEJ,IAAI,CACA,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,OAAO,EAAE,gBAAgB,GAC1B,IAAI,CAsCN;IAED,OAAO,CAAC,KAAK;IAoDb,OAAO,CAAC,SAAS;IAqCjB,OAAO,CAAC,MAAM;CAsCjB"}

package/dist/platform/relationship-copy.js

@@ -0,0 +1,146 @@
+import { assertActiveContext, spendContext } from "../core/context.js";
+import { dataDepthMax, dataNodesMax } from "../core/limits.js";
+import { PlatformError } from "./errors.js";
+import { relationshipKey } from "./graph-actions.js";
+import { recordKey } from "./references/catalog.js";
+import { VersionCopyPolicy } from "./relationship-copy-policy.js";
+import { isReleased } from "./revisions/policy.js";
+import { manualVersioning } from "./version-policy.js";
+/** Parent versions copy stored relationships without invoking business copy or mutation hooks. */
+export class RelationshipCopy {
+    storage;
+    trace;
+    nextId;
+    references;
+    security;
+    lifeCycles;
+    constructor(storage, trace, nextId, references, security, lifeCycles) {
+        this.storage = storage;
+        this.trace = trace;
+        this.nextId = nextId;
+        this.references = references;
+        this.security = security;
+        this.lifeCycles = lifeCycles;
+    }
+    copy(source, target, copies, context) {
+        let policy;
+        const pending = [
+            {
+                kind: "owner",
+                source,
+                targetId: target.id,
+                depth: 0,
+                resetBehavior: isReleased(source),
+            },
+        ];
+        const active = new Set();
+        const created = [];
+        let visited = 0;
+        while (pending.length > 0) {
+            const task = pending.pop();
+            if (!task || ++visited > dataNodesMax || pending.length > dataNodesMax) {
+                throw new PlatformError("ProtocolLimit", "Relationship copies exceed their graph budget.");
+            }
+            spendContext(context);
+            if (task.kind === "leave") {
+                active.delete(task.key);
+            }
+            else if (task.kind === "owner") {
+                this.enter(task, pending, active, context);
+            }
+            else {
+                policy ??= new VersionCopyPolicy(this.storage);
+                this.copyGroup(task.group, copies, pending, policy, created, context);
+            }
+        }
+        this.lifeCycles.resetCopies(created, context);
+    }
+    enter(task, pending, active, context) {
+        const key = recordKey(task.source);
+        if (active.has(key) || task.depth > dataDepthMax) {
+            throw new PlatformError("RelationshipCycle", "Relationship ownership is cyclic or too deep to copy.");
+        }
+        active.add(key);
+        pending.push({ kind: "leave", key });
+        const groups = new Map();
+        for (const record of this.references.catalog.owned(task.source, context)) {
+            const definition = this.storage.getItemType(record.type);
+            if (!definition) {
+                throw new PlatformError("MissingItemType", `Relationship '${record.type}' has no schema.`);
+            }
+            if (definition.isVersionable &&
+                this.references.catalog.current(record).id !== record.id) {
+                continue;
+            }
+            const group = groups.get(definition.id) ?? {
+                definition,
+                records: [],
+                parentId: task.targetId,
+                depth: task.depth,
+                resetBehavior: task.resetBehavior,
+            };
+            group.records.push(record);
+            groups.set(definition.id, group);
+        }
+        for (const group of [...groups.values()].reverse()) {
+            pending.push({ kind: "group", group });
+        }
+    }
+    copyGroup(group, copies, pending, policy, created, context) {
+        policy.assertSupported(group.definition, group.records);
+        const records = [];
+        for (const source of group.records) {
+            spendContext(context);
+            const copied = this.insert(group, source, context);
+            copies.set(relationshipKey(source.type, source.id), copied.id);
+            records.push(copied);
+            created.push(copied);
+        }
+        for (let index = records.length - 1; index >= 0; index -= 1) {
+            const source = group.records[index];
+            const target = records[index];
+            if (!source || !target) {
+                throw new Error("Each copied relationship must retain its source pairing.");
+            }
+            pending.push({
+                kind: "owner",
+                source,
+                targetId: target.id,
+                depth: group.depth + 1,
+                resetBehavior: group.resetBehavior,
+            });
+        }
+    }
+    insert(group, source, context) {
+        const id = this.nextId();
+        const properties = this.references.copied(group.definition, source, group.parentId, group.resetBehavior);
+        const record = {
+            type: group.definition.name,
+            id,
+            properties: {
+                ...properties,
+                ...this.security.copied(group.definition, properties, context),
+                config_id: id,
+                generation: 1,
+                is_current: 1,
+                new_version: group.definition.isVersionable &&
+                    !manualVersioning(this.storage, group.definition)
+                    ? 0
+                    : 1,
+                locked_by_id: null,
+            },
+        };
+        assertActiveContext(context);
+        this.storage.insertItem(record);
+        this.references.sessions.created(record, context);
+        this.trace.record(context, {
+            kind: "mutation",
+            name: "copy",
+            before: source,
+            after: record,
+        });
+        this.references.freeze(source, context);
+        return record;
+    }
+}
+//# sourceMappingURL=relationship-copy.js.map

package/dist/platform/relationship-copy.js.map

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

package/dist/platform/relationship-type.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessStorage, ItemTypeDefinition } from "../storage/types.js";
+export declare function relationshipType(storage: HarnessStorage, parent: ItemTypeDefinition, type: string): ItemTypeDefinition;
+//# sourceMappingURL=relationship-type.d.ts.map

package/dist/platform/relationship-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-type.d.ts","sourceRoot":"","sources":["../../src/platform/relationship-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM,GACb,kBAAkB,CAepB"}

package/dist/platform/relationship-type.js

@@ -0,0 +1,11 @@
+import { PlatformError } from "./errors.js";
+export function relationshipType(storage, parent, type) {
+    const definition = storage.getItemType(type);
+    const source = definition?.properties.find((property) => property.name === "source_id");
+    if (!definition?.isRelationship ||
+        source?.dataSource?.toLowerCase() !== parent.id.toLowerCase()) {
+        throw new PlatformError("RelationshipSource", `'${type}' is not an imported relationship of '${parent.name}'.`);
+    }
+    return definition;
+}
+//# sourceMappingURL=relationship-type.js.map

package/dist/platform/relationship-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-type.js","sourceRoot":"","sources":["../../src/platform/relationship-type.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,UAAU,gBAAgB,CAC5B,OAAuB,EACvB,MAA0B,EAC1B,IAAY;IAEZ,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAExF,IACI,CAAC,UAAU,EAAE,cAAc;QAC3B,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,EAC/D,CAAC;QACC,MAAM,IAAI,aAAa,CACnB,oBAAoB,EACpB,IAAI,IAAI,yCAAyC,MAAM,CAAC,IAAI,IAAI,CACnE,CAAC;IACN,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/dist/platform/request.d.ts

@@ -0,0 +1,7 @@
+import { Item } from "../items/item.js";
+import type { ItemNode } from "../items/item.js";
+/** Action instrumentation must also recognize trusted delegation to a native base action. */
+export declare function appliedItem(operation: string, input: unknown): Item | undefined;
+/** Validate again after before events, which may change the request. */
+export declare function validateRequest(request: ItemNode, action: string): void;
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/platform/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAqBjD,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAY/E;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA8DvE"}

package/dist/platform/request.js

@@ -0,0 +1,86 @@
+import { setOwn } from "../core/data.js";
+import { Item } from "../items/item.js";
+import { PlatformError } from "./errors.js";
+const attributes = new Set([
+    "id",
+    "action",
+    "select",
+    "orderBy",
+    "where",
+    "serverEvents",
+    "version",
+    "idlist",
+    "page",
+    "pagesize",
+    "maxRecords",
+    "isCriteria",
+    "isNew",
+    "isTemp",
+    "doGetItem",
+]);
+/** Action instrumentation must also recognize trusted delegation to a native base action. */
+export function appliedItem(operation, input) {
+    if (operation === "platform.apply" && input instanceof Item) {
+        return input;
+    }
+    if (operation !== "platform.event-base" || input === null || typeof input !== "object") {
+        return undefined;
+    }
+    const item = Object.getOwnPropertyDescriptor(input, "item")?.value;
+    return item instanceof Item ? item : undefined;
+}
+/** Validate again after before events, which may change the request. */
+export function validateRequest(request, action) {
+    for (const [name, attributes] of Object.entries(request.propertyAttributes)) {
+        if (action !== "get" &&
+            attributes.condition !== undefined &&
+            attributes.condition !== "eq") {
+            throw new PlatformError("UnsupportedCondition", `Property condition '${attributes.condition}' on '${name}' is not implemented.`);
+        }
+        if (attributes.is_null === "1") {
+            setOwn(request.properties, name, null);
+        }
+    }
+    validateCriteria(request, action);
+    for (const key of Object.keys(request.attributes)) {
+        if (!attributes.has(key)) {
+            throw new PlatformError("UnsupportedAttribute", `AML attribute '${key}' is not implemented.`);
+        }
+    }
+    if (request.attributes.serverEvents !== undefined &&
+        !["0", "1"].includes(request.attributes.serverEvents)) {
+        throw new PlatformError("InvalidServerEvents", "serverEvents must be '0' or '1'.");
+    }
+    if (request.attributes.version !== undefined &&
+        (!["edit", "update"].includes(action) || !["0", "1"].includes(request.attributes.version))) {
+        throw new PlatformError("InvalidVersion", "version must be '0' or '1' on an edit or update request.");
+    }
+    if (!["get", "add", "edit", "update"].includes(action) &&
+        Object.keys(request.propertyItems).length) {
+        throw new PlatformError("UnsupportedPropertyMutation", "Nested property Item mutations are not implemented. Pass a resolved record reference instead.");
+    }
+    if (!["add", "get", "edit", "update"].includes(action) && request.relationships.length) {
+        throw new PlatformError("UnsupportedRelationships", `Nested relationship requests on '${action}' are not implemented. Apply relationship actions separately.`);
+    }
+}
+function validateCriteria(request, action) {
+    if (action !== "get") {
+        for (const name of ["page", "pagesize", "maxRecords", "isCriteria"]) {
+            if (request.attributes[name] !== undefined) {
+                throw new PlatformError("UnsupportedAttribute", `AML attribute '${name}' is only supported on get requests.`);
+            }
+        }
+        if ((request.logical?.length ?? 0) > 0) {
+            throw new PlatformError("UnsupportedCondition", "Logical groups require a get request; use where or idlist for mutations.");
+        }
+    }
+    if (!["get", "add"].includes(action) &&
+        !["id", "where", "idlist"].some((name) => request.attributes[name]?.trim())) {
+        throw new PlatformError("InvalidSelector", "Mutations require id, idlist or where criteria.");
+    }
+    if (request.attributes.isCriteria !== undefined &&
+        !["0", "1"].includes(request.attributes.isCriteria)) {
+        throw new PlatformError("InvalidSelector", "isCriteria must be '0' or '1'.");
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/platform/request.js.map

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

package/dist/platform/revisions/policy.d.ts

@@ -0,0 +1,13 @@
+import { Item } from "../../items/item.js";
+import type { HarnessStorage, ItemTypeDefinition, StorageValue, StoredItem } from "../../storage/types.js";
+/** Generations share a revision until the released generation starts a new cycle. */
+export declare class Revisions {
+    private readonly sequences;
+    constructor(storage: HarnessStorage);
+    initial(definition: ItemTypeDefinition, values: Readonly<Record<string, StorageValue>>): Readonly<Record<string, StorageValue>>;
+    assertValue(definition: ItemTypeDefinition, value: StorageValue | undefined): void;
+    next(definition: ItemTypeDefinition, previous: StoredItem): string;
+}
+export declare function isReleased(record: StoredItem): boolean;
+export declare function removeRevisionProperties(request: Item, previous: StoredItem, current: StoredItem): void;
+//# sourceMappingURL=policy.d.ts.map

package/dist/platform/revisions/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/platform/revisions/policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EACR,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACb,MAAM,wBAAwB,CAAC;AAIhC,qFAAqF;AACrF,qBAAa,SAAS;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,YAAY,OAAO,EAAE,cAAc,EAElC;IAED,OAAO,CACH,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAC/C,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAQxC;IAED,WAAW,CAAC,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAejF;IAED,IAAI,CAAC,UAAU,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAkCjE;CACJ;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,IAAI,EACb,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,UAAU,GACpB,IAAI,CAgCN"}

package/dist/platform/revisions/policy.js

@@ -0,0 +1,69 @@
+import { Item } from "../../items/item.js";
+import { ApplicationError, PlatformError } from "../errors.js";
+import { RevisionSequences } from "./sequences.js";
+/** Generations share a revision until the released generation starts a new cycle. */
+export class Revisions {
+    sequences;
+    constructor(storage) {
+        this.sequences = new RevisionSequences(storage);
+    }
+    initial(definition, values) {
+        if (!definition.isVersionable || values.major_rev !== undefined) {
+            return {};
+        }
+        const first = this.sequences.resolve(definition)?.values[0];
+        return first === undefined ? {} : { major_rev: first };
+    }
+    assertValue(definition, value) {
+        if (!definition.isVersionable || value === undefined) {
+            return;
+        }
+        const sequence = this.sequences.resolve(definition);
+        if (sequence && !sequence.values.includes(String(value ?? ""))) {
+            throw new ApplicationError(Item.error(`Revision '${value}' is not in the sequence for '${definition.name}'.`, "InvalidRevision"));
+        }
+    }
+    next(definition, previous) {
+        const sequence = this.sequences.resolve(definition);
+        if (!sequence) {
+            throw new PlatformError("MissingRevisionSequence", `Revising released '${definition.name}' requires its exported Revision sequence.`, definition.source ? { source: definition.source } : undefined);
+        }
+        const index = sequence.values.indexOf(String(previous.properties.major_rev ?? ""));
+        if (index === -1) {
+            throw new ApplicationError(Item.error(`Current revision '${previous.properties.major_rev}' is not in the sequence for '${definition.name}'.`, "InvalidRevision"));
+        }
+        const next = sequence.values[index + 1];
+        if (next === undefined) {
+            throw new ApplicationError(Item.error(`Revision sequence exceeded for '${definition.name}'. Extend its exported Revision sequence.`, "RevisionSequenceExceeded"));
+        }
+        return next;
+    }
+}
+export function isReleased(record) {
+    return String(record.properties.is_released ?? "0") === "1";
+}
+export function removeRevisionProperties(request, previous, current) {
+    const managed = [
+        "major_rev",
+        "permission_id",
+        "state",
+        "current_state",
+        "is_released",
+        "not_lockable",
+        "release_date",
+        "effective_date",
+        "superseded_date",
+    ];
+    for (const name of managed) {
+        const value = request.node.properties[name];
+        if (value === undefined) {
+            continue;
+        }
+        if (String(value ?? "") !== String(previous.properties[name] ?? "") &&
+            String(value ?? "") !== String(current.properties[name] ?? "")) {
+            throw new PlatformError("ReadOnlyProperty", `Revision property '${previous.type}.${name}' is managed by the new lifecycle cycle.`);
+        }
+        delete request.node.properties[name];
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/platform/revisions/policy.js.map

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

package/dist/platform/revisions/sequences.d.ts

@@ -0,0 +1,12 @@
+import type { CatalogEntry, HarnessStorage, ItemTypeDefinition } from "../../storage/types.js";
+export interface RevisionSequence {
+    readonly entry: CatalogEntry;
+    readonly values: readonly string[];
+}
+/** Resolve the exported sequence; the baseline supplies the native ItemType default. */
+export declare class RevisionSequences {
+    private readonly storage;
+    constructor(storage: HarnessStorage);
+    resolve(definition: ItemTypeDefinition): RevisionSequence | undefined;
+}
+//# sourceMappingURL=sequences.d.ts.map

package/dist/platform/revisions/sequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../../src/platform/revisions/sequences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAM/F,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wFAAwF;AACxF,qBAAa,iBAAiB;IACd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,cAAc,EAAI;IAExD,OAAO,CAAC,UAAU,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,SAAS,CAkDpE;CACJ"}