@innovatorstack/harness 0.0.0-stage → 0.1.1

package/dist/platform/projection.js

@@ -0,0 +1,165 @@
+import { setOwn, getOwn } from "../core/data.js";
+import { dataBytesMax, dataDepthMax, dataNodesMax } from "../core/limits.js";
+import { itemNode } from "../items/item.js";
+import { PlatformError } from "./errors.js";
+import { projectedProperties } from "./query.js";
+/** Read projection only; business actions and events remain in the dispatcher. */
+export function projectItem(storage, definition, record, expression) {
+    return compileProjection(storage, definition, expression)(record);
+}
+export function compileProjection(storage, definition, expression, visible) {
+    const selection = expression ? new SelectParser(expression).parse() : undefined;
+    const pending = [{ definition, fields: selection ?? [] }];
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame) {
+            throw new Error("A projection frame must exist while metadata validation is pending.");
+        }
+        for (const field of frame.fields) {
+            if (field.name === "*" || field.name === "id") {
+                if (field.children) {
+                    throw new PlatformError("UnsupportedSelect", "Only item properties can expand.");
+                }
+                continue;
+            }
+            const property = frame.definition.properties.find((property) => property.name === field.name);
+            if (!property) {
+                throw new PlatformError("UnknownProperty", `Unknown property '${frame.definition.name}.${field.name}'.`);
+            }
+            if (field.children) {
+                const target = storage
+                    .listItemTypes()
+                    .find((type) => type.id === property.dataSource);
+                if (property.dataType !== "item" || !target) {
+                    throw new PlatformError("UnsupportedSelect", `Property '${field.name}' has no ItemType target to expand.`);
+                }
+                pending.push({ definition: target, fields: field.children });
+            }
+        }
+    }
+    return (record) => project(storage, definition, record, selection, visible);
+}
+function project(storage, definition, record, selection, visible) {
+    const node = projectionNode(storage, definition, record, selection);
+    const pending = [{ node, definition, record, selection, depth: 0 }];
+    let visited = 0;
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame) {
+            throw new Error("A projection frame must exist while expansion is pending.");
+        }
+        visited += 1;
+        if (visited > dataNodesMax || frame.depth > dataDepthMax) {
+            throw new PlatformError("UnsupportedSelect", "Projection exceeds its work or nesting limit.");
+        }
+        for (const field of frame.selection ?? []) {
+            if (!field.children) {
+                continue;
+            }
+            const target = expansionTarget(storage, frame.definition, frame.record, field.name);
+            if (!target || (visible && !visible(target.definition, target.record))) {
+                continue;
+            }
+            const node = projectionNode(storage, target.definition, target.record, field.children);
+            setOwn(frame.node.propertyItems, field.name, node);
+            pending.push({ ...target, node, selection: field.children, depth: frame.depth + 1 });
+        }
+    }
+    return node;
+}
+function projectionNode(storage, definition, record, selection) {
+    const node = itemNode(definition.name);
+    const names = selection?.some((field) => field.name === "*")
+        ? undefined
+        : selection?.map((field) => field.name);
+    node.attributes.id = record.id;
+    node.properties = projectedProperties(storage, definition, record, names);
+    return node;
+}
+function expansionTarget(storage, definition, record, name) {
+    const property = definition.properties.find((property) => property.name === name);
+    const targetType = storage.listItemTypes().find((type) => type.id === property?.dataSource);
+    if (property?.dataType !== "item" || !targetType) {
+        throw new PlatformError("UnsupportedSelect", `'${definition.name}.${name}' has no ItemType target to expand.`);
+    }
+    const id = getOwn(record.properties, name);
+    if (id === undefined || id === null || id === "") {
+        return undefined;
+    }
+    const target = typeof id === "string" ? storage.getItem(targetType.name, id) : undefined;
+    if (!target) {
+        throw new PlatformError("MissingReference", `Cannot expand '${definition.name}.${name}': target '${id}' is missing.`);
+    }
+    return { definition: targetType, record: target };
+}
+class SelectParser {
+    expression;
+    offset = 0;
+    constructor(expression) {
+        this.expression = expression;
+    }
+    parse() {
+        if (this.expression.length > dataBytesMax) {
+            this.fail();
+        }
+        const fields = [];
+        const pending = [{ fields, expectsField: true }];
+        let count = 0;
+        while (this.offset <= this.expression.length) {
+            const frame = pending.at(-1);
+            if (!frame) {
+                throw new Error("A select frame must exist while parsing is pending.");
+            }
+            this.whitespace();
+            if (frame.expectsField) {
+                count += 1;
+                if (count > dataNodesMax || pending.length > dataDepthMax) {
+                    this.fail();
+                }
+                const name = /^(?:[A-Za-z_][\w]*|\*)/.exec(this.expression.slice(this.offset))?.[0];
+                if (!name) {
+                    this.fail();
+                }
+                this.offset += name.length;
+                this.whitespace();
+                frame.expectsField = false;
+                if (this.expression[this.offset] === "(") {
+                    if (name === "*") {
+                        this.fail();
+                    }
+                    const children = [];
+                    frame.fields.push({ name, children });
+                    pending.push({ fields: children, expectsField: true });
+                    this.offset += 1;
+                }
+                else {
+                    frame.fields.push({ name });
+                }
+            }
+            else if (this.expression[this.offset] === ",") {
+                frame.expectsField = true;
+                this.offset += 1;
+            }
+            else if (this.expression[this.offset] === ")" && pending.length > 1) {
+                pending.pop();
+                this.offset += 1;
+            }
+            else if (this.offset === this.expression.length && pending.length === 1) {
+                return fields;
+            }
+            else {
+                this.fail();
+            }
+        }
+        return this.fail();
+    }
+    whitespace() {
+        while (/\s/.test(this.expression[this.offset] ?? "")) {
+            this.offset += 1;
+        }
+    }
+    fail() {
+        throw new PlatformError("UnsupportedSelect", `Invalid select '${this.expression}' at position ${this.offset + 1}.`);
+    }
+}
+//# sourceMappingURL=projection.js.map

package/dist/platform/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../src/platform/projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASjD,kFAAkF;AAClF,MAAM,UAAU,WAAW,CACvB,OAAuB,EACvB,UAA8B,EAC9B,MAAkB,EAClB,UAAmB;IAEnB,OAAO,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,OAAuB,EACvB,UAA8B,EAC9B,UAAmB,EACnB,OAAqB;IAErB,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAChF,MAAM,OAAO,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC,CAAC;IAE1D,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAC3F,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC5C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACjB,MAAM,IAAI,aAAa,CACnB,mBAAmB,EACnB,kCAAkC,CACrC,CAAC;gBACN,CAAC;gBAED,SAAS;YACb,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAC7C,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAC7C,CAAC;YAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,MAAM,IAAI,aAAa,CACnB,iBAAiB,EACjB,qBAAqB,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,CAC/D,CAAC;YACN,CAAC;YAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,OAAO;qBACjB,aAAa,EAAE;qBACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAErD,IAAI,QAAQ,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;oBAC1C,MAAM,IAAI,aAAa,CACnB,mBAAmB,EACnB,aAAa,KAAK,CAAC,IAAI,qCAAqC,CAC/D,CAAC;gBACN,CAAC;gBAED,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YACjE,CAAC;QACL,CAAC;IACL,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,OAAO,CACZ,OAAuB,EACvB,UAA8B,EAC9B,MAAkB,EAClB,SAA2C,EAC3C,OAAgC;IAEhC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACpE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACjF,CAAC;QAED,OAAO,IAAI,CAAC,CAAC;QAEb,IAAI,OAAO,GAAG,YAAY,IAAI,KAAK,CAAC,KAAK,GAAG,YAAY,EAAE,CAAC;YACvD,MAAM,IAAI,aAAa,CACnB,mBAAmB,EACnB,+CAA+C,CAClD,CAAC;QACN,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClB,SAAS;YACb,CAAC;YAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEpF,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBACrE,SAAS;YACb,CAAC;YAED,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACvF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CACnB,OAAuB,EACvB,UAA8B,EAC9B,MAAkB,EAClB,SAA2C;IAE3C,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QACxD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,GAAG,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE1E,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CACpB,OAAuB,EACvB,UAA8B,EAC9B,MAAkB,EAClB,IAAY;IAEZ,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE5F,IAAI,QAAQ,EAAE,QAAQ,KAAK,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,aAAa,CACnB,mBAAmB,EACnB,IAAI,UAAU,CAAC,IAAI,IAAI,IAAI,qCAAqC,CACnE,CAAC;IACN,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAE3C,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzF,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CACnB,kBAAkB,EAClB,kBAAkB,UAAU,CAAC,IAAI,IAAI,IAAI,cAAc,EAAE,eAAe,CAC3E,CAAC;IACN,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,YAAY;IAGe,UAAU;IAF/B,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,UAAkB;0BAAlB,UAAU;IAAW,CAAC;IAEnD,KAAK;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAgB,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAElB,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACrB,KAAK,IAAI,CAAC,CAAC;gBAEX,IAAI,KAAK,GAAG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;oBACxD,IAAI,CAAC,IAAI,EAAE,CAAC;gBAChB,CAAC;gBAED,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAEpF,IAAI,CAAC,IAAI,EAAE,CAAC;oBACR,IAAI,CAAC,IAAI,EAAE,CAAC;gBAChB,CAAC;gBAED,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;gBAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC;gBAE3B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;oBACvC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;wBACf,IAAI,CAAC,IAAI,EAAE,CAAC;oBAChB,CAAC;oBAED,MAAM,QAAQ,GAAgB,EAAE,CAAC;oBACjC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACtC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;oBACvD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;gBACrB,CAAC;qBAAM,CAAC;oBACJ,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChC,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC9C,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;gBAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,OAAO,CAAC,GAAG,EAAE,CAAC;gBACd,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxE,OAAO,MAAM,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,IAAI,EAAE,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAEO,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IAEO,IAAI;QACR,MAAM,IAAI,aAAa,CACnB,mBAAmB,EACnB,mBAAmB,IAAI,CAAC,UAAU,iBAAiB,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CACxE,CAAC;IACN,CAAC;CACJ"}

package/dist/platform/queries/conditions.d.ts

@@ -0,0 +1,4 @@
+import type { AmlPropertyCondition } from "../../items/logical.js";
+import type { Predicate, QueryField } from "../../queries/types.js";
+export declare function propertyPredicate(field: QueryField, property: AmlPropertyCondition): Predicate;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/platform/queries/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,GAAG,SAAS,CA6D9F"}

package/dist/platform/queries/conditions.js

@@ -0,0 +1,48 @@
+import { PredicateParser } from "../../queries/parser.js";
+import { comparison, likePredicate, setPredicate } from "../../queries/predicates.js";
+import { Comparison } from "../../queries/types.js";
+import { PlatformError } from "../errors.js";
+export function propertyPredicate(field, property) {
+    const condition = (property.attributes.condition ?? "eq").trim().toLowerCase();
+    const value = property.attributes.is_null === "1" ? null : property.value;
+    if (value === undefined) {
+        throw new PlatformError("InvalidSelector", `Selector '${property.name}' needs a value.`);
+    }
+    if (condition === "is null" || condition === "is not null" || condition === "is") {
+        const negate = condition === "is"
+            ? String(value).trim().toLowerCase() === "not null"
+            : condition === "is not null";
+        if (condition === "is" &&
+            !["null", "not null"].includes(String(value).trim().toLowerCase())) {
+            throw new PlatformError("UnsupportedCondition", "IS requires NULL or NOT NULL.");
+        }
+        return { kind: "null", field, negate };
+    }
+    if (condition === "in" || condition === "not in") {
+        const values = new PredicateParser(String(value), () => field).scalarList();
+        return setPredicate(field, values, condition === "not in");
+    }
+    if (condition === "between" || condition === "not between") {
+        const [first, last] = new PredicateParser(String(value), () => field).range();
+        const term = {
+            kind: "and",
+            terms: [
+                comparison(field, Comparison.GreaterOrEqual, first),
+                comparison(field, Comparison.LessOrEqual, last),
+            ],
+        };
+        return condition === "not between" ? { kind: "not", term } : term;
+    }
+    if (condition === "like" || condition === "not like") {
+        return likePredicate(field, String(value), condition === "not like");
+    }
+    const operator = Object.values(Comparison).find((operator) => operator === condition);
+    if (operator === undefined) {
+        throw new PlatformError("UnsupportedCondition", `Property condition '${condition}' is not implemented.`);
+    }
+    if (value === null && (operator === Comparison.Equal || operator === Comparison.NotEqual)) {
+        return { kind: "null", field, negate: operator === Comparison.NotEqual };
+    }
+    return comparison(field, operator, value);
+}
+//# sourceMappingURL=conditions.js.map

package/dist/platform/queries/conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.js","sourceRoot":"","sources":["../../../src/platform/queries/conditions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,KAAiB,EAAE,QAA8B;IAC/E,MAAM,SAAS,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;IAE1E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,aAAa,CAAC,iBAAiB,EAAE,aAAa,QAAQ,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,aAAa,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC/E,MAAM,MAAM,GACR,SAAS,KAAK,IAAI;YACd,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU;YACnD,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC;QAEtC,IACI,SAAS,KAAK,IAAI;YAClB,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,EACpE,CAAC;YACC,MAAM,IAAI,aAAa,CAAC,sBAAsB,EAAE,+BAA+B,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QAE5E,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QAC9E,MAAM,IAAI,GAAc;YACpB,IAAI,EAAE,KAAK;YACX,KAAK,EAAE;gBACH,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,EAAE,KAAK,CAAC;gBACnD,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC;aAClD;SACJ,CAAC;QAEF,OAAO,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,CAAC;IAED,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QACnD,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,KAAK,UAAU,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAE9F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,aAAa,CACnB,sBAAsB,EACtB,uBAAuB,SAAS,uBAAuB,CAC1D,CAAC;IACN,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,KAAK,IAAI,QAAQ,KAAK,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC7E,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { ExecutionContext } from "../../core/types.js";
+import type { ItemNode } from "../../items/item.js";
+import type { SelectQuery } from "../../queries/types.js";
+import type { HarnessStorage, ItemTypeDefinition, StoredItem } from "../../storage/types.js";
+import type { PageSelection } from "./paging.js";
+import type { ApplyQueryItem } from "./planner.js";
+/** Schema resolution and execution policy are shared; SQLite only optimizes predicate selection. */
+export declare class ItemQueries {
+    private readonly storage;
+    private readonly apply;
+    private readonly select?;
+    private readonly visible?;
+    constructor(storage: HarnessStorage, apply: ApplyQueryItem, select?: SelectQuery | undefined, visible?: ((definition: ItemTypeDefinition, records: readonly StoredItem[], context: ExecutionContext) => readonly StoredItem[]) | undefined);
+    run(definition: ItemTypeDefinition, request: ItemNode, context: ExecutionContext): Promise<PageSelection>;
+}
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/engine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAI7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,oGAAoG;AACpG,qBAAa,WAAW;IAEhB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAJ7B,YACqB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,cAAc,EACrB,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,CAAC,GAAE,CACvB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,OAAO,EAAE,gBAAgB,KACxB,SAAS,UAAU,EAAE,aAAA,EAC1B;IAEE,GAAG,CACL,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAoCxB;CACJ"}

package/dist/platform/queries/engine.js

@@ -0,0 +1,41 @@
+import { spendContext } from "../../core/context.js";
+import { evaluate } from "../../queries/evaluate.js";
+import { fieldValue } from "./fields.js";
+import { orderBy, orderRows } from "./order.js";
+import { pageRows } from "./paging.js";
+import { requestPredicate } from "./planner.js";
+import { RelationshipQueries } from "./relationships.js";
+/** Schema resolution and execution policy are shared; SQLite only optimizes predicate selection. */
+export class ItemQueries {
+    storage;
+    apply;
+    select;
+    visible;
+    constructor(storage, apply, select, visible) {
+        this.storage = storage;
+        this.apply = apply;
+        this.select = select;
+        this.visible = visible;
+    }
+    async run(definition, request, context) {
+        const predicate = await requestPredicate(this.storage, definition, request, context, this.apply);
+        const orders = orderBy(this.storage, definition, request.attributes.orderBy);
+        const spend = (units) => {
+            spendContext(context, units);
+        };
+        const candidates = this.select
+            ? this.select(definition.name, predicate, spend)
+            : this.storage.listItems(definition.name);
+        const filtered = candidates.filter((record) => evaluate(predicate, (field) => fieldValue(this.storage, record, field), spend));
+        const matching = (request.attributes.action ?? "get") === "get" && this.visible
+            ? this.visible(definition, filtered, context)
+            : filtered;
+        if (request.relationships.length === 0 || (request.attributes.action ?? "get") !== "get") {
+            return pageRows(request, orderRows(this.storage, matching, orders, spend));
+        }
+        const nested = await new RelationshipQueries(this.storage, this.apply).select(definition, request, matching, context);
+        const page = pageRows(request, orderRows(this.storage, nested.records, orders, spend));
+        return { ...page, relationships: nested.relationships };
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/platform/queries/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/platform/queries/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,oGAAoG;AACpG,MAAM,OAAO,WAAW;IAEC,OAAO;IACP,KAAK;IACL,MAAM;IACN,OAAO;IAJ5B,YACqB,OAAuB,EACvB,KAAqB,EACrB,MAAoB,EACpB,OAIS;uBAPT,OAAO;qBACP,KAAK;sBACL,MAAM;uBACN,OAAO;IAKzB,CAAC;IAEJ,KAAK,CAAC,GAAG,CACL,UAA8B,EAC9B,OAAiB,EACjB,OAAyB;QAEzB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CACpC,IAAI,CAAC,OAAO,EACZ,UAAU,EACV,OAAO,EACP,OAAO,EACP,IAAI,CAAC,KAAK,CACb,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;YAC5B,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM;YAC1B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC;YAChD,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAC1C,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CACjF,CAAC;QACF,MAAM,QAAQ,GACV,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO;YAC1D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC7C,CAAC,CAAC,QAAQ,CAAC;QAEnB,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;YACvF,OAAO,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CACzE,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,CACV,CAAC;QACF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAEvF,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;IAC5D,CAAC;CACJ"}

package/dist/platform/queries/fields.d.ts

@@ -0,0 +1,7 @@
+import type { AmlPropertyCondition } from "../../items/logical.js";
+import type { QueryField } from "../../queries/types.js";
+import type { HarnessStorage, ItemTypeDefinition, StoredItem } from "../../storage/types.js";
+export declare function resolveField(storage: HarnessStorage, definition: ItemTypeDefinition, names: readonly string[]): QueryField;
+export declare function fieldValue(storage: HarnessStorage, record: StoredItem, field: QueryField): string | number | null;
+export declare function selectorType(storage: HarnessStorage, definition: ItemTypeDefinition, condition: AmlPropertyCondition): ItemTypeDefinition;
+//# sourceMappingURL=fields.d.ts.map

package/dist/platform/queries/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/fields.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EACR,cAAc,EACd,kBAAkB,EAGlB,UAAU,EACb,MAAM,wBAAwB,CAAC;AAGhC,wBAAgB,YAAY,CACxB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,kBAAkB,EAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,GACzB,UAAU,CA8DZ;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,0BAWxF;AA2CD,wBAAgB,YAAY,CACxB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,kBAAkB,EAC9B,SAAS,EAAE,oBAAoB,GAChC,kBAAkB,CAqBpB"}

package/dist/platform/queries/fields.js

@@ -0,0 +1,88 @@
+import { dataDepthMax } from "../../core/limits.js";
+import { PlatformError } from "../errors.js";
+export function resolveField(storage, definition, names) {
+    const name = names.at(-1);
+    const qualifier = names.slice(0, -1).join(".").toLowerCase();
+    const qualifiers = [definition.name, definition.tableName ?? definition.name].flatMap((name) => [name, `innovator.${name}`, `dbo.${name}`]);
+    if (!name || (qualifier && !qualifiers.some((value) => value.toLowerCase() === qualifier))) {
+        throw new PlatformError("UnsupportedWhere", `Where qualifier does not refer to '${definition.name}'.`);
+    }
+    if (name.toLowerCase() === "id") {
+        return { name: "id", column: "id", kind: "identifier", path: [] };
+    }
+    const property = definition.properties.find((property) => property.name.toLowerCase() === name.toLowerCase());
+    if (!property) {
+        throw new PlatformError("UnknownProperty", `Unknown selector '${definition.name}.${name}'.`);
+    }
+    const path = [];
+    let current = { definition, property };
+    const visited = new Set();
+    while (current.property.dataType === "foreign") {
+        const key = `${current.definition.id}:${current.property.name}`;
+        if (visited.has(key) || path.length >= dataDepthMax) {
+            throw new PlatformError("ForeignPropertyCycle", `Invalid foreign selector '${definition.name}.${name}'.`);
+        }
+        visited.add(key);
+        const next = foreignTarget(storage, current.definition, current.property);
+        path.push({ property: next.source.name, target: next.definition.name });
+        current = next;
+    }
+    if (current.property.isFederated) {
+        throw new PlatformError("UnsupportedFederatedPredicate", `Filtering '${definition.name}.${name}' requires federation query support.`);
+    }
+    return {
+        name: property.name,
+        column: current.property.name,
+        kind: valueKind(current.property),
+        path,
+    };
+}
+export function fieldValue(storage, record, field) {
+    let current = record;
+    for (const reference of field.path) {
+        const id = current?.properties[reference.property];
+        current = typeof id === "string" ? storage.getItem(reference.target, id) : undefined;
+    }
+    return field.column === "id"
+        ? (current?.id ?? null)
+        : (current?.properties[field.column] ?? null);
+}
+function foreignTarget(storage, definition, property) {
+    const source = definition.properties.find((candidate) => candidate.id?.toLowerCase() === property.dataSource?.toLowerCase());
+    const target = storage
+        .listItemTypes()
+        .find((candidate) => candidate.id.toLowerCase() === source?.dataSource?.toLowerCase());
+    const targetProperty = target?.properties.find((candidate) => candidate.id?.toLowerCase() === property.foreignProperty?.toLowerCase());
+    if (!source || !target || !targetProperty) {
+        throw new PlatformError("InvalidForeignProperty", `Cannot resolve foreign selector '${definition.name}.${property.name}'.`);
+    }
+    return { source, definition: target, property: targetProperty };
+}
+function valueKind(property) {
+    if (property.dataType === "item" || property.name === "id") {
+        return "identifier";
+    }
+    if (["integer", "boolean", "float"].includes(property.dataType)) {
+        return "number";
+    }
+    if (property.dataType === "decimal" || property.dataType === "date") {
+        return property.dataType;
+    }
+    return "text";
+}
+export function selectorType(storage, definition, condition) {
+    const property = definition.properties.find((property) => property.name === condition.name);
+    const selector = condition.item;
+    const target = selector ? storage.getItemType(selector.type) : undefined;
+    const operator = (condition.attributes.condition ?? "eq").toLowerCase();
+    if (property?.dataType !== "item" ||
+        !target ||
+        !selector ||
+        (selector.attributes.action ?? "get") !== "get" ||
+        target.id.toLowerCase() !== property.dataSource?.toLowerCase() ||
+        !["eq", "ne", "in", "not in"].includes(operator)) {
+        throw new PlatformError("InvalidSelector", `Invalid nested selector for '${definition.name}.${condition.name}'.`);
+    }
+    return target;
+}
+//# sourceMappingURL=fields.js.map

package/dist/platform/queries/fields.js.map

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

package/dist/platform/queries/order.d.ts

@@ -0,0 +1,5 @@
+import type { QueryOrder } from "../../queries/types.js";
+import type { HarnessStorage, ItemTypeDefinition, StoredItem } from "../../storage/types.js";
+export declare function orderBy(storage: HarnessStorage, definition: ItemTypeDefinition, expression: string | undefined): readonly QueryOrder[];
+export declare function orderRows(storage: HarnessStorage, rows: readonly StoredItem[], orders: readonly QueryOrder[], spend: (units: number) => void): StoredItem[];
+//# sourceMappingURL=order.d.ts.map

package/dist/platform/queries/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/order.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAI7F,wBAAgB,OAAO,CACnB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,MAAM,GAAG,SAAS,GAC/B,SAAS,UAAU,EAAE,CAuDvB;AAED,wBAAgB,SAAS,CACrB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B,UAAU,EAAE,CAuBd"}

package/dist/platform/queries/order.js

@@ -0,0 +1,69 @@
+import { TokenKind, tokenize } from "../../queries/lexer.js";
+import { compareValues } from "../../queries/values.js";
+import { PlatformError } from "../errors.js";
+import { fieldValue, resolveField } from "./fields.js";
+export function orderBy(storage, definition, expression) {
+    if (!expression) {
+        return [];
+    }
+    const tokens = tokenize(expression);
+    const orders = [];
+    let offset = 0;
+    while (offset < tokens.length) {
+        const names = [];
+        while (true) {
+            const token = tokens[offset++];
+            if (!token || ![TokenKind.Word, TokenKind.Identifier].includes(token.kind)) {
+                throw new PlatformError("UnsupportedOrder", "ORDER BY requires property identifiers.");
+            }
+            names.push(token.value);
+            if (tokens[offset]?.value !== ".") {
+                break;
+            }
+            offset += 1;
+        }
+        const direction = tokens[offset]?.kind === TokenKind.Word
+            ? tokens[offset]?.value.toLowerCase()
+            : undefined;
+        if (direction === "asc" || direction === "desc") {
+            offset += 1;
+        }
+        orders.push({
+            field: resolveField(storage, definition, names),
+            descending: direction === "desc",
+        });
+        if (offset < tokens.length && tokens[offset++]?.value !== ",") {
+            throw new PlatformError("UnsupportedOrder", "Unsupported ORDER BY syntax.");
+        }
+        if (tokens.at(-1)?.value === ",") {
+            throw new PlatformError("UnsupportedOrder", "ORDER BY cannot end with a comma.");
+        }
+    }
+    return orders;
+}
+export function orderRows(storage, rows, orders, spend) {
+    return [...rows].sort((left, right) => {
+        for (const order of orders) {
+            const a = fieldValue(storage, left, order.field);
+            const b = fieldValue(storage, right, order.field);
+            spend(String(a ?? "").length + String(b ?? "").length + 1);
+            let difference = compareValues(order.field.kind, a, b);
+            difference ??= nullOrder(a, b);
+            if (difference !== 0) {
+                return order.descending ? -difference : difference;
+            }
+        }
+        spend(1);
+        if (left.id === right.id) {
+            return 0;
+        }
+        return left.id < right.id ? -1 : 1;
+    });
+}
+function nullOrder(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    return left === null ? -1 : 1;
+}
+//# sourceMappingURL=order.js.map

package/dist/platform/queries/order.js.map

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

package/dist/platform/queries/paging.d.ts

@@ -0,0 +1,9 @@
+import type { ItemMessage, ItemNode } from "../../items/item.js";
+import type { StoredItem } from "../../storage/types.js";
+export interface PageSelection {
+    readonly records: readonly StoredItem[];
+    readonly relationships?: ReadonlyMap<string, readonly ItemNode[]>;
+    readonly messages?: readonly ItemMessage[];
+}
+export declare function pageRows(request: ItemNode, records: readonly StoredItem[]): PageSelection;
+//# sourceMappingURL=paging.d.ts.map

package/dist/platform/queries/paging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paging.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/paging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAC9C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,CAyCzF"}

package/dist/platform/queries/paging.js

@@ -0,0 +1,39 @@
+import { PlatformError } from "../errors.js";
+export function pageRows(request, records) {
+    const size = integer(request.attributes.pagesize, "pagesize");
+    const page = integer(request.attributes.page, "page") ?? 1;
+    const maximum = integer(request.attributes.maxRecords, "maxRecords");
+    if ((request.attributes.action ?? "get") !== "get" &&
+        (size !== undefined || maximum !== undefined || request.attributes.page !== undefined)) {
+        throw new PlatformError("UnsupportedAttribute", "Paging attributes are only supported on get requests.");
+    }
+    if (size === undefined && page !== 1) {
+        throw new PlatformError("InvalidPaging", "page requires pagesize.");
+    }
+    const bounded = maximum === undefined ? records : records.slice(0, maximum);
+    if (size === undefined) {
+        return { records: bounded };
+    }
+    const offset = (page - 1) * size;
+    if (!Number.isSafeInteger(offset)) {
+        throw new PlatformError("InvalidPaging", "The page offset exceeds the supported integer range.");
+    }
+    return {
+        records: bounded.slice(offset, offset + size),
+        messages: [
+            { name: "itemmax", value: String(bounded.length) },
+            { name: "pagemax", value: String(Math.ceil(bounded.length / size)) },
+        ],
+    };
+}
+function integer(value, name) {
+    if (value === undefined || value === "") {
+        return undefined;
+    }
+    const number = Number(value);
+    if (!/^\d+$/u.test(value) || !Number.isSafeInteger(number) || number < 1) {
+        throw new PlatformError("InvalidPaging", `${name} must be a positive safe integer.`);
+    }
+    return number;
+}
+//# sourceMappingURL=paging.js.map

package/dist/platform/queries/paging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paging.js","sourceRoot":"","sources":["../../../src/platform/queries/paging.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAQ7C,MAAM,UAAU,QAAQ,CAAC,OAAiB,EAAE,OAA8B;IACtE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAErE,IACI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,KAAK;QAC9C,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,EACxF,CAAC;QACC,MAAM,IAAI,aAAa,CACnB,sBAAsB,EACtB,uDAAuD,CAC1D,CAAC;IACN,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAE5E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;IAEjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,aAAa,CACnB,eAAe,EACf,sDAAsD,CACzD,CAAC;IACN,CAAC;IAED,OAAO;QACH,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7C,QAAQ,EAAE;YACN,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YAClD,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,EAAE;SACvE;KACJ,CAAC;AACN,CAAC;AAED,SAAS,OAAO,CAAC,KAAyB,EAAE,IAAY;IACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACtC,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,aAAa,CAAC,eAAe,EAAE,GAAG,IAAI,mCAAmC,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/platform/queries/planner.d.ts

@@ -0,0 +1,8 @@
+import type { ExecutionContext } from "../../core/types.js";
+import { Item } from "../../items/item.js";
+import type { ItemNode } from "../../items/item.js";
+import type { Predicate } from "../../queries/types.js";
+import type { HarnessStorage, ItemTypeDefinition } from "../../storage/types.js";
+export type ApplyQueryItem = (item: Item, context: ExecutionContext) => Promise<Item>;
+export declare function requestPredicate(storage: HarnessStorage, definition: ItemTypeDefinition, request: ItemNode, context: ExecutionContext, apply: ApplyQueryItem): Promise<Predicate>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/platform/queries/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/platform/queries/planner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAKjF,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtF,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,cAAc,GACtB,OAAO,CAAC,SAAS,CAAC,CAsDpB"}