@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/instrumentation/types.d.ts

@@ -0,0 +1,107 @@
+import type { CapabilityId } from "../compatibility/capabilities.js";
+import type { ExecutionInjection } from "../controls/failure-types.js";
+import type { SourceLocation } from "../diagnostics/source-location.js";
+import type { MockValue } from "../mocks/types.js";
+import type { SourceDefinition } from "../platform/trace.js";
+import type { StoredItem } from "../storage/types.js";
+export declare enum ExecutionOutcome {
+    Committed = "COMMITTED",
+    RolledBack = "ROLLED_BACK",
+    Unknown = "UNKNOWN"
+}
+export declare enum ExecutionStatus {
+    Succeeded = "SUCCEEDED",
+    Failed = "FAILED"
+}
+export declare enum ExecutionMode {
+    Real = "REAL",
+    Mocked = "MOCKED"
+}
+export declare enum ExecutionKind {
+    Operation = "OPERATION",
+    Aml = "AML",
+    Action = "ACTION",
+    Method = "METHOD",
+    Sql = "SQL"
+}
+export type ExecutionValue = null | boolean | number | string | readonly ExecutionValue[] | {
+    readonly [name: string]: ExecutionValue;
+};
+export interface ExecutionLocation {
+    readonly executionId: string;
+    readonly name: string;
+    readonly source?: SourceLocation;
+}
+export interface ExecutionFailure {
+    readonly name: string;
+    readonly message: string;
+    readonly code?: string;
+    readonly capability?: CapabilityId;
+    readonly source?: SourceLocation;
+    readonly callChain: readonly ExecutionLocation[];
+    readonly causes: readonly ExecutionFailure[];
+}
+export interface ExecutionEvent {
+    readonly name: string;
+    readonly kind: "event" | "authorization";
+    readonly source?: SourceLocation;
+}
+export type ExecutionDefinition = SourceDefinition;
+export interface ExecutionCall extends ExecutionLocation {
+    readonly parentExecutionId?: string;
+    readonly operation: string;
+    readonly kind: ExecutionKind;
+    readonly status: ExecutionStatus;
+    readonly mode: ExecutionMode;
+    readonly durationMs: number;
+    readonly definition?: ExecutionDefinition;
+    readonly sourceHash?: string;
+    /** Evidence that the executor began source evaluation, separate from dispatch or
+     * compilation. */
+    readonly executed: boolean;
+    readonly input?: ExecutionValue;
+    readonly result?: ExecutionValue;
+    readonly via?: ExecutionEvent;
+    readonly events: readonly ExecutionEvent[];
+    readonly error?: ExecutionFailure;
+    readonly children: readonly ExecutionCall[];
+}
+export interface ExecutionChange {
+    readonly executionId: string;
+    readonly name: string;
+    readonly before?: StoredItem;
+    readonly after?: StoredItem;
+    readonly outcome: ExecutionOutcome;
+}
+export interface ExecutionMock {
+    readonly executionId: string;
+    readonly name: string;
+    readonly definition: string;
+    readonly parameters?: Readonly<Record<string, MockValue>>;
+    readonly responseFile?: string;
+    readonly responseHash: string;
+}
+export interface ExecutionTruncation {
+    readonly calls: number;
+    readonly changes: number;
+    readonly mocks: number;
+    readonly failures: number;
+    readonly events: number;
+    readonly snapshots: number;
+}
+/** A completed request. A successful nested call can still belong to a rolled-back request. */
+export interface ExecutionReport {
+    readonly id: string;
+    readonly requestId: string;
+    readonly startedAt: string;
+    readonly durationMs: number;
+    readonly outcome: ExecutionOutcome;
+    readonly calls: readonly ExecutionCall[];
+    readonly changes: readonly ExecutionChange[];
+    readonly mocks: readonly ExecutionMock[];
+    readonly failures: readonly ExecutionInjection[];
+    readonly error?: ExecutionFailure;
+    readonly truncated: boolean;
+    readonly omitted: ExecutionTruncation;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/instrumentation/types.d.ts.map

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

package/dist/instrumentation/types.js

@@ -0,0 +1,25 @@
+export var ExecutionOutcome;
+(function (ExecutionOutcome) {
+    ExecutionOutcome["Committed"] = "COMMITTED";
+    ExecutionOutcome["RolledBack"] = "ROLLED_BACK";
+    ExecutionOutcome["Unknown"] = "UNKNOWN";
+})(ExecutionOutcome || (ExecutionOutcome = {}));
+export var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["Succeeded"] = "SUCCEEDED";
+    ExecutionStatus["Failed"] = "FAILED";
+})(ExecutionStatus || (ExecutionStatus = {}));
+export var ExecutionMode;
+(function (ExecutionMode) {
+    ExecutionMode["Real"] = "REAL";
+    ExecutionMode["Mocked"] = "MOCKED";
+})(ExecutionMode || (ExecutionMode = {}));
+export var ExecutionKind;
+(function (ExecutionKind) {
+    ExecutionKind["Operation"] = "OPERATION";
+    ExecutionKind["Aml"] = "AML";
+    ExecutionKind["Action"] = "ACTION";
+    ExecutionKind["Method"] = "METHOD";
+    ExecutionKind["Sql"] = "SQL";
+})(ExecutionKind || (ExecutionKind = {}));
+//# sourceMappingURL=types.js.map

package/dist/instrumentation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/instrumentation/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,2CAAuB,CAAA;IACvB,8CAA0B,CAAA;IAC1B,uCAAmB,CAAA;AACvB,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B;AAED,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACvB,0CAAuB,CAAA;IACvB,oCAAiB,CAAA;AACrB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAED,MAAM,CAAN,IAAY,aAGX;AAHD,WAAY,aAAa;IACrB,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACrB,CAAC,EAHW,aAAa,KAAb,aAAa,QAGxB;AAED,MAAM,CAAN,IAAY,aAMX;AAND,WAAY,aAAa;IACrB,wCAAuB,CAAA;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,kCAAiB,CAAA;IACjB,4BAAW,CAAA;AACf,CAAC,EANW,aAAa,KAAb,aAAa,QAMxB"}

package/dist/items/codec.d.ts

@@ -0,0 +1,4 @@
+import type { ItemPayload } from "./item.js";
+export declare function object(value: unknown): value is Record<string, unknown>;
+export declare function decodePayload(value: unknown): ItemPayload;
+//# sourceMappingURL=codec.d.ts.map

package/dist/items/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/items/codec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,WAAW,CAAC;AAGvD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAiDzD"}

package/dist/items/codec.js

@@ -0,0 +1,137 @@
+import { assertDataTree, setOwn } from "../core/data.js";
+import { decodeLogical } from "./logical.js";
+export function object(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function decodePayload(value) {
+    assertDataTree(value);
+    if (!object(value) || !Array.isArray(value.items)) {
+        throw new TypeError("Invalid Item payload.");
+    }
+    const items = value.items.map(decodeNode);
+    const payload = { items };
+    if (value.messages !== undefined && value.messages !== null) {
+        if (!Array.isArray(value.messages)) {
+            throw new TypeError("Item messages must contain native name/value records.");
+        }
+        payload.messages = value.messages.map((message) => {
+            if (!object(message) ||
+                typeof message.name !== "string" ||
+                typeof message.value !== "string") {
+                throw new TypeError("Invalid Item message.");
+            }
+            return { name: message.name, value: message.value };
+        });
+    }
+    if (value.result !== undefined && value.result !== null) {
+        if (typeof value.result !== "string") {
+            throw new TypeError("Invalid Item result.");
+        }
+        payload.result = value.result;
+    }
+    if (value.error !== undefined && value.error !== null) {
+        if (!object(value.error) ||
+            typeof value.error.code !== "string" ||
+            typeof value.error.message !== "string") {
+            throw new TypeError("Invalid Item error.");
+        }
+        payload.error = { code: value.error.code, message: value.error.message };
+    }
+    return payload;
+}
+function decodeNode(value) {
+    assertNode(value);
+    const root = decodeShell(value);
+    const pending = [{ value, node: root }];
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame) {
+            throw new Error("An Item frame must exist while decoding is pending.");
+        }
+        for (const [name, value] of Object.entries(frame.value.propertyItems)) {
+            assertNode(value);
+            const node = decodeShell(value);
+            setOwn(frame.node.propertyItems, name, node);
+            pending.push({ value, node });
+        }
+        for (const value of frame.value.relationships) {
+            assertNode(value);
+            const node = decodeShell(value);
+            frame.node.relationships.push(node);
+            pending.push({ value, node });
+        }
+        if (frame.value.logical !== undefined && frame.value.logical !== null) {
+            frame.node.logical = decodeLogical(frame.value.logical, (value) => {
+                assertNode(value);
+                const node = decodeShell(value);
+                pending.push({ value, node });
+                return node;
+            });
+        }
+    }
+    return root;
+}
+function assertNode(value) {
+    if (!object(value) ||
+        typeof value.type !== "string" ||
+        !object(value.attributes) ||
+        !object(value.properties) ||
+        !object(value.propertyItems) ||
+        !Array.isArray(value.relationships)) {
+        throw new TypeError("Invalid Item node.");
+    }
+}
+function decodeShell(value) {
+    const attributes = {};
+    for (const [key, entry] of Object.entries(value.attributes)) {
+        if (typeof entry !== "string") {
+            throw new TypeError("Invalid Item attribute.");
+        }
+        Object.defineProperty(attributes, key, {
+            value: entry,
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    const properties = {};
+    for (const [key, entry] of Object.entries(value.properties)) {
+        if (entry !== null &&
+            typeof entry !== "string" &&
+            (typeof entry !== "number" || !Number.isFinite(entry))) {
+            throw new TypeError("Invalid Item property.");
+        }
+        Object.defineProperty(properties, key, {
+            value: entry,
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    const propertyAttributes = decodePropertyAttributes(value.propertyAttributes);
+    return {
+        type: value.type,
+        attributes,
+        properties,
+        propertyItems: {},
+        propertyAttributes,
+        relationships: [],
+    };
+}
+function decodePropertyAttributes(value) {
+    const propertyAttributes = {};
+    if (value !== undefined) {
+        if (!object(value)) {
+            throw new TypeError("Invalid property attributes.");
+        }
+        for (const [name, attributes] of Object.entries(value)) {
+            if (!object(attributes) ||
+                Object.values(attributes).some((value) => typeof value !== "string")) {
+                throw new TypeError("Invalid property attributes.");
+            }
+            setOwn(propertyAttributes, name, Object.fromEntries(Object.entries(attributes).map(([key, value]) => [key, String(value)])));
+        }
+    }
+    return propertyAttributes;
+}
+//# sourceMappingURL=codec.js.map

package/dist/items/codec.js.map

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

package/dist/items/item.d.ts

@@ -0,0 +1,58 @@
+import type { StorageValue } from "../storage/types.js";
+import type { AmlLogicalGroup } from "./logical.js";
+export { AmlLogicalOperator } from "./logical.js";
+export type { AmlLogicalGroup, AmlLogicalTerm, AmlPropertyCondition } from "./logical.js";
+export interface ItemNode {
+    type: string;
+    attributes: Record<string, string>;
+    properties: Record<string, StorageValue>;
+    propertyItems: Record<string, ItemNode>;
+    propertyAttributes: Record<string, Record<string, string>>;
+    relationships: ItemNode[];
+    logical?: readonly AmlLogicalGroup[];
+}
+export interface ItemError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface ItemPayload {
+    items: ItemNode[];
+    error?: ItemError;
+    result?: string;
+    messages?: readonly ItemMessage[];
+}
+export interface ItemMessage {
+    readonly name: string;
+    readonly value: string;
+}
+export declare function itemNode(type: string, action?: string): ItemNode;
+export declare class Item {
+    readonly payload: ItemPayload;
+    constructor(payload: ItemPayload);
+    static create(type: string, action?: string): Item;
+    static error(message: string, code?: string): Item;
+    isError(): boolean;
+    getErrorString(): string;
+    getErrorCode(): string;
+    getResult(): string;
+    getPropertyAttribute(property: string, attribute: string, fallback?: string): string;
+    setPropertyAttribute(property: string, attribute: string, value: string): void;
+    getItemCount(): number;
+    getItemByIndex(index: number): Item;
+    getID(): string;
+    getType(): string;
+    setType(type: string): void;
+    getAction(): string;
+    setAction(action: string): void;
+    getAttribute(name: string, fallback?: string): string;
+    setAttribute(name: string, value: string): void;
+    getProperty(name: string, fallback?: string): string;
+    setProperty(name: string, value: StorageValue): void;
+    setPropertyItem(name: string, item: Item): void;
+    getPropertyItem(name: string): Item | undefined;
+    addRelationship(item: Item): void;
+    getRelationships(type?: string): Item;
+    clone(): Item;
+    get node(): ItemNode;
+}
+//# sourceMappingURL=item.d.ts.map

package/dist/items/item.d.ts.map

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

package/dist/items/item.js

@@ -0,0 +1,145 @@
+import { getOwn, setOwn } from "../core/data.js";
+import { cloneItemPayload } from "./origins.js";
+export { AmlLogicalOperator } from "./logical.js";
+export function itemNode(type, action) {
+    return {
+        type,
+        attributes: action ? { action } : {},
+        properties: {},
+        propertyItems: {},
+        propertyAttributes: {},
+        relationships: [],
+    };
+}
+export class Item {
+    payload;
+    constructor(payload) {
+        this.payload = payload;
+    }
+    static create(type, action) {
+        return new Item({ items: [itemNode(type, action)] });
+    }
+    static error(message, code = "ApplicationError") {
+        return new Item({ items: [], error: { code, message } });
+    }
+    isError() {
+        return this.payload.error !== undefined;
+    }
+    getErrorString() {
+        return this.payload.error?.message ?? "";
+    }
+    getErrorCode() {
+        return this.payload.error?.code ?? "";
+    }
+    getResult() {
+        return this.payload.result ?? "";
+    }
+    getPropertyAttribute(property, attribute, fallback = "") {
+        const attributes = getOwn(this.node.propertyAttributes, property);
+        return attributes ? (getOwn(attributes, attribute) ?? fallback) : fallback;
+    }
+    setPropertyAttribute(property, attribute, value) {
+        let attributes = getOwn(this.node.propertyAttributes, property);
+        if (!attributes) {
+            attributes = {};
+            setOwn(this.node.propertyAttributes, property, attributes);
+        }
+        setOwn(attributes, attribute, value);
+    }
+    getItemCount() {
+        if (this.isError()) {
+            return -1;
+        }
+        return this.payload.items.length;
+    }
+    getItemByIndex(index) {
+        const node = this.payload.items[index];
+        if (!node) {
+            throw new RangeError(`Item index ${index} is outside this collection.`);
+        }
+        return new Item({ items: [node] });
+    }
+    getID() {
+        return this.node.attributes.id ?? "";
+    }
+    getType() {
+        return this.node.type;
+    }
+    setType(type) {
+        this.node.type = type;
+    }
+    getAction() {
+        return this.getAttribute("action", "get");
+    }
+    setAction(action) {
+        this.setAttribute("action", action);
+    }
+    getAttribute(name, fallback = "") {
+        if (name === "type") {
+            return this.node.type;
+        }
+        return getOwn(this.node.attributes, name) ?? fallback;
+    }
+    setAttribute(name, value) {
+        if (name === "type") {
+            this.node.type = value;
+            return;
+        }
+        setOwn(this.node.attributes, name, value);
+    }
+    getProperty(name, fallback = "") {
+        if (name === "id") {
+            return this.getID() || fallback;
+        }
+        const value = getOwn(this.node.properties, name);
+        if (value === null || value === undefined) {
+            return fallback;
+        }
+        return String(value);
+    }
+    setProperty(name, value) {
+        if (name === "id") {
+            if (typeof value !== "string") {
+                throw new TypeError("Item ID must be a string.");
+            }
+            this.node.attributes.id = value;
+        }
+        else {
+            delete this.node.propertyItems[name];
+            setOwn(this.node.properties, name, value);
+        }
+    }
+    setPropertyItem(name, item) {
+        delete this.node.properties[name];
+        setOwn(this.node.propertyItems, name, item.node);
+    }
+    getPropertyItem(name) {
+        const node = getOwn(this.node.propertyItems, name);
+        if (node) {
+            return new Item({ items: [node] });
+        }
+        return undefined;
+    }
+    addRelationship(item) {
+        this.node.relationships.push(item.node);
+    }
+    getRelationships(type) {
+        return new Item({
+            items: this.node.relationships.filter((node) => type === undefined || node.type.toLowerCase() === type.toLowerCase()),
+        });
+    }
+    clone() {
+        return new Item(cloneItemPayload(this.payload));
+    }
+    get node() {
+        if (this.isError() || this.payload.items.length !== 1) {
+            throw new TypeError("This operation requires one non-error Item.");
+        }
+        const node = this.payload.items[0];
+        if (!node) {
+            throw new TypeError("Item is missing its context.");
+        }
+        return node;
+    }
+}
+//# sourceMappingURL=item.js.map

package/dist/items/item.js.map

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

package/dist/items/logical.d.ts

@@ -0,0 +1,23 @@
+import type { ItemNode } from "./item.js";
+export declare enum AmlLogicalOperator {
+    And = "and",
+    Or = "or",
+    Not = "not"
+}
+export interface AmlPropertyCondition {
+    readonly name: string;
+    readonly attributes: Readonly<Record<string, string>>;
+    readonly value?: string | number | null;
+    readonly item?: ItemNode;
+}
+export interface AmlLogicalGroup {
+    readonly operator: AmlLogicalOperator;
+    readonly terms: readonly AmlLogicalTerm[];
+    /** Repeated direct properties share the root's implicit AND without adding an XML tag. */
+    readonly implicit?: boolean;
+}
+export type AmlLogicalTerm = AmlLogicalGroup | AmlPropertyCondition;
+export declare function logicalOperator(name: string): AmlLogicalOperator | undefined;
+/** Item nodes are attached to the caller's work stack; logical decoding never recurses. */
+export declare function decodeLogical(value: unknown, item: (value: unknown) => ItemNode): readonly AmlLogicalGroup[];
+//# sourceMappingURL=logical.d.ts.map

package/dist/items/logical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logical.d.ts","sourceRoot":"","sources":["../../src/items/logical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,oBAAY,kBAAkB;IAC1B,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,GAAG,QAAQ;CACd;AAED,MAAM,WAAW,oBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAe5E;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GACnC,SAAS,eAAe,EAAE,CA8D5B"}

package/dist/items/logical.js

@@ -0,0 +1,92 @@
+export var AmlLogicalOperator;
+(function (AmlLogicalOperator) {
+    AmlLogicalOperator["And"] = "and";
+    AmlLogicalOperator["Or"] = "or";
+    AmlLogicalOperator["Not"] = "not";
+})(AmlLogicalOperator || (AmlLogicalOperator = {}));
+export function logicalOperator(name) {
+    switch (name) {
+        case "and": {
+            return AmlLogicalOperator.And;
+        }
+        case "or": {
+            return AmlLogicalOperator.Or;
+        }
+        case "not": {
+            return AmlLogicalOperator.Not;
+        }
+        default: {
+            return undefined;
+        }
+    }
+}
+/** Item nodes are attached to the caller's work stack; logical decoding never recurses. */
+export function decodeLogical(value, item) {
+    if (!Array.isArray(value)) {
+        throw new TypeError("Logical AML requires an array of groups.");
+    }
+    const roots = [];
+    const pending = [];
+    for (let index = value.length - 1; index >= 0; index -= 1) {
+        const input = value[index];
+        pending.push({ input, output: roots, depth: 0 });
+    }
+    let visited = 0;
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame || !record(frame.input) || ++visited > 100_000 || frame.depth > 128) {
+            throw new TypeError("Logical AML exceeds its node or nesting limit.");
+        }
+        const operator = typeof frame.input.operator === "string"
+            ? logicalOperator(frame.input.operator)
+            : undefined;
+        if (frame.input.operator !== undefined && operator === undefined) {
+            throw new TypeError("Invalid logical AML operator.");
+        }
+        if (operator !== undefined) {
+            const terms = [];
+            const implicit = frame.input.implicit === true;
+            if (!Array.isArray(frame.input.terms) ||
+                (implicit && (operator !== AmlLogicalOperator.And || frame.depth !== 0))) {
+                throw new TypeError("Invalid logical AML group.");
+            }
+            frame.output.push({ operator, terms, ...(implicit ? { implicit } : {}) });
+            for (let index = frame.input.terms.length - 1; index >= 0; index -= 1) {
+                const input = frame.input.terms[index];
+                pending.push({ input, output: terms, depth: frame.depth + 1 });
+            }
+        }
+        else {
+            if (frame.depth === 0) {
+                throw new TypeError("Top-level logical AML must contain groups.");
+            }
+            frame.output.push(decodeCondition(frame.input, item));
+        }
+    }
+    return roots;
+}
+function decodeCondition(value, item) {
+    if (typeof value.name !== "string" || !record(value.attributes)) {
+        throw new TypeError("Logical criteria need a property name and attributes.");
+    }
+    const attributes = {};
+    for (const [name, text] of Object.entries(value.attributes)) {
+        if (typeof text !== "string") {
+            throw new TypeError("Logical property attributes must contain text.");
+        }
+        Object.defineProperty(attributes, name, { value: text, enumerable: true });
+    }
+    if (value.item !== undefined && value.item !== null) {
+        return { name: value.name, attributes, item: item(value.item) };
+    }
+    if (value.value !== null &&
+        typeof value.value !== "string" &&
+        (typeof value.value !== "number" || !Number.isFinite(value.value))) {
+        throw new TypeError("Logical properties require a scalar value or nested Item.");
+    }
+    return { name: value.name, attributes, value: value.value };
+}
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=logical.js.map

package/dist/items/logical.js.map

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