@innovatorstack/harness 0.0.0-stage → 0.1.0

package/dist/packages/draft.js

@@ -0,0 +1,186 @@
+export function entryKey(type, id) {
+    return JSON.stringify([type.toLowerCase(), id.toLowerCase()]);
+}
+function copy(entry) {
+    return { ...entry, properties: { ...entry.properties } };
+}
+/** In-memory import state. Failed action attempts restore only the records they touched. */
+export class ImportDraft {
+    records = new Map();
+    recordsByType = new Map();
+    changedKeys = new Set();
+    deletions = new Map();
+    creators = new Map();
+    journal;
+    action;
+    constructor(entries) {
+        for (const [key, entry] of entries) {
+            this.setRecord(key, entry);
+        }
+    }
+    get entries() {
+        return this.records;
+    }
+    ofType(type) {
+        return this.recordsByType.get(type.toLowerCase())?.values() ?? [];
+    }
+    get changed() {
+        return this.changedKeys;
+    }
+    get deleted() {
+        return this.deletions;
+    }
+    put(entry) {
+        const key = entryKey(entry.type, entry.id);
+        this.capture(key).replacesItem = true;
+        this.setRecord(key, entry);
+        this.changedKeys.add(key);
+        if (this.action !== undefined) {
+            this.creators.set(key, this.action);
+        }
+    }
+    touch(entry, properties) {
+        const key = entryKey(entry.type, entry.id);
+        const saved = this.capture(key);
+        for (const name of properties) {
+            saved.properties.add(name);
+        }
+        this.changedKeys.add(key);
+    }
+    remove(key, deletion) {
+        this.capture(key).replacesItem = true;
+        this.removeRecord(key);
+        this.changedKeys.delete(key);
+        this.creators.delete(key);
+        if (deletion) {
+            this.deletions.set(key, deletion);
+        }
+    }
+    begin(action) {
+        if (this.journal) {
+            throw new Error("An import action attempt is already active.");
+        }
+        this.action = action;
+        this.journal = new Map();
+    }
+    changes() {
+        const changes = [];
+        for (const [key, saved] of this.journal ?? []) {
+            const after = this.records.get(key);
+            if (!saved.entry && !after) {
+                continue;
+            }
+            changes.push({
+                key,
+                before: saved.entry,
+                after: after ? copy(after) : undefined,
+                properties: new Set(saved.properties),
+                replacesItem: saved.replacesItem,
+                previousCreator: saved.creator,
+            });
+        }
+        return changes;
+    }
+    commit() {
+        this.journal = undefined;
+        this.action = undefined;
+    }
+    rollback() {
+        for (const [key, saved] of this.journal ?? []) {
+            if (saved.entry) {
+                this.setRecord(key, saved.entry);
+            }
+            else {
+                this.removeRecord(key);
+            }
+            this.restoreEntry(key, saved.deleted, this.deletions);
+            if (saved.changed) {
+                this.changedKeys.add(key);
+            }
+            else {
+                this.changedKeys.delete(key);
+            }
+            if (saved.creator === undefined) {
+                this.creators.delete(key);
+            }
+            else {
+                this.creators.set(key, saved.creator);
+            }
+        }
+        this.commit();
+    }
+    checkpoint() {
+        return {
+            entries: new Map([...this.records].map(([key, entry]) => [key, copy(entry)])),
+            changed: new Set(this.changedKeys),
+            deleted: new Map(this.deletions),
+            creators: new Map(this.creators),
+        };
+    }
+    restore(checkpoint) {
+        this.records.clear();
+        this.recordsByType.clear();
+        this.changedKeys.clear();
+        this.deletions.clear();
+        this.creators.clear();
+        for (const [key, entry] of checkpoint.entries) {
+            this.setRecord(key, copy(entry));
+        }
+        for (const key of checkpoint.changed) {
+            this.changedKeys.add(key);
+        }
+        for (const [key, entry] of checkpoint.deleted) {
+            this.deletions.set(key, entry);
+        }
+        for (const [key, action] of checkpoint.creators) {
+            this.creators.set(key, action);
+        }
+        this.commit();
+    }
+    setRecord(key, entry) {
+        this.records.set(key, entry);
+        const type = entry.type.toLowerCase();
+        const records = this.recordsByType.get(type) ?? new Map();
+        records.set(key, entry);
+        this.recordsByType.set(type, records);
+    }
+    removeRecord(key) {
+        const entry = this.records.get(key);
+        if (!entry) {
+            return;
+        }
+        this.records.delete(key);
+        const type = entry.type.toLowerCase();
+        const records = this.recordsByType.get(type);
+        records?.delete(key);
+        if (records?.size === 0) {
+            this.recordsByType.delete(type);
+        }
+    }
+    capture(key) {
+        const existing = this.journal?.get(key);
+        if (existing) {
+            return existing;
+        }
+        const entry = this.records.get(key);
+        const saved = {
+            entry: entry ? copy(entry) : undefined,
+            changed: this.changedKeys.has(key),
+            deleted: this.deletions.get(key),
+            creator: this.creators.get(key),
+            properties: new Set(),
+            replacesItem: false,
+        };
+        this.journal?.set(key, saved);
+        return saved;
+    }
+    restoreEntry(key, entry, target) {
+        if (entry) {
+            target.set(key, entry);
+        }
+        else {
+            target.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=draft.js.map

package/dist/packages/draft.js.map

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

package/dist/packages/elements.d.ts

@@ -0,0 +1,11 @@
+import type { AmlElement } from "./types.js";
+export declare function childElements(element: AmlElement): readonly AmlElement[];
+export declare function textContent(element: AmlElement): string;
+export declare function itemType(element: AmlElement): string;
+export declare function itemProperties(element: AmlElement): readonly AmlElement[];
+/**
+ * Preorder traversal preserves declaration order without consuming the JavaScript call stack.
+ * @yields {AmlElement} Each element in its original declaration order.
+ */
+export declare function walkElements(roots: readonly AmlElement[]): Generator<AmlElement, void, void>;
+//# sourceMappingURL=elements.d.ts.map

package/dist/packages/elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../src/packages/elements.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAExE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAKvD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAYpD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,UAAU,EAAE,CAiBzE;AAED;;;GAGG;AACH,wBAAiB,YAAY,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAmC7F"}

package/dist/packages/elements.js

@@ -0,0 +1,58 @@
+import { dataDepthMax, dataNodesMax } from "../core/limits.js";
+import { PackageImportError } from "./diagnostics.js";
+export function childElements(element) {
+    return element.children.filter((child) => child.kind === "element");
+}
+export function textContent(element) {
+    return element.children
+        .filter((child) => child.kind !== "element")
+        .map((child) => child.value)
+        .join("");
+}
+export function itemType(element) {
+    const type = element.attributes.type?.trim();
+    if (element.name !== "Item" || !type) {
+        throw new PackageImportError("INVALID_ITEM", "Expected an Item with a type.", element.source);
+    }
+    return type;
+}
+export function itemProperties(element) {
+    const properties = childElements(element).filter((child) => child.name !== "Relationships");
+    const names = new Set();
+    for (const property of properties) {
+        if (names.has(property.name)) {
+            throw new PackageImportError("REPEATED_PROPERTY", `Repeated property '${property.name}' requires a multi-value or multilingual adapter.`, property.source);
+        }
+        names.add(property.name);
+    }
+    return properties;
+}
+/**
+ * Preorder traversal preserves declaration order without consuming the JavaScript call stack.
+ * @yields {AmlElement} Each element in its original declaration order.
+ */
+export function* walkElements(roots) {
+    const pending = roots.map((element) => ({ element, depth: 0 })).reverse();
+    const visited = new Set();
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (!frame) {
+            throw new Error("An AML frame must exist while traversal is pending.");
+        }
+        if (visited.size >= dataNodesMax ||
+            frame.depth > dataDepthMax ||
+            visited.has(frame.element)) {
+            throw new PackageImportError("INVALID_ITEM", "AML exceeds its traversal bounds or contains a cycle.", frame.element.source);
+        }
+        visited.add(frame.element);
+        yield frame.element;
+        const children = childElements(frame.element);
+        for (let index = children.length - 1; index >= 0; index -= 1) {
+            const element = children[index];
+            if (element) {
+                pending.push({ element, depth: frame.depth + 1 });
+            }
+        }
+    }
+}
+//# sourceMappingURL=elements.js.map

package/dist/packages/elements.js.map

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

package/dist/packages/evaluation.d.ts

@@ -0,0 +1,16 @@
+export interface ImportWork {
+    advance(): ImportWork | null;
+    abort(error: unknown): void;
+}
+/** A suspended metadata operation. Only the evaluator advances nested operations. */
+export declare class ImportTask<Value> implements ImportWork {
+    private readonly program;
+    private result;
+    constructor(program: Generator<ImportWork, Value, void>);
+    advance(): ImportWork | null;
+    value(): Value;
+    abort(error: unknown): void;
+}
+/** Explicit interpreter stack preserves AML action order and unwinds selector guards on failure. */
+export declare function evaluateImport<Value>(root: ImportTask<Value>): Value;
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/packages/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../src/packages/evaluation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACvB,OAAO,IAAI,UAAU,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,qFAAqF;AACrF,qBAAa,UAAU,CAAC,KAAK,CAAE,YAAW,UAAU;IAGpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,MAAM,CAAwC;IAEtD,YAA6B,OAAO,EAAE,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,EAAI;IAE5E,OAAO,IAAI,UAAU,GAAG,IAAI,CAU3B;IAED,KAAK,IAAI,KAAK,CAMb;IAED,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1B;CACJ;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,KAAK,CAiDpE"}

package/dist/packages/evaluation.js

@@ -0,0 +1,71 @@
+import { importFramesMax, dataNodesMax } from "../core/limits.js";
+/** A suspended metadata operation. Only the evaluator advances nested operations. */
+export class ImportTask {
+    program;
+    result;
+    constructor(program) {
+        this.program = program;
+    }
+    advance() {
+        const step = this.program.next();
+        if (step.done) {
+            this.result = { value: step.value };
+            return null;
+        }
+        return step.value;
+    }
+    value() {
+        if (!this.result) {
+            throw new Error("An import task cannot be read before it completes.");
+        }
+        return this.result.value;
+    }
+    abort(error) {
+        this.program.throw(error);
+    }
+}
+/** Explicit interpreter stack preserves AML action order and unwinds selector guards on failure. */
+export function evaluateImport(root) {
+    const pending = [root];
+    let steps = 0;
+    try {
+        while (pending.length > 0) {
+            steps += 1;
+            if (steps > dataNodesMax || pending.length > importFramesMax) {
+                throw new TypeError("Package evaluation exceeded its work or nesting limit.");
+            }
+            const current = pending.at(-1);
+            if (!current) {
+                throw new Error("An import task must exist while evaluation is pending.");
+            }
+            const child = current.advance();
+            if (child === null) {
+                pending.pop();
+            }
+            else {
+                pending.push(child);
+            }
+        }
+    }
+    catch (error) {
+        const failures = [error];
+        for (const task of pending.reverse()) {
+            try {
+                task.abort(error);
+            }
+            catch (cleanupError) {
+                if (cleanupError !== error) {
+                    failures.push(cleanupError);
+                }
+            }
+        }
+        if (failures.length > 1) {
+            throw new AggregateError(failures, "Package evaluation and unwinding failed.", {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+    return root.value();
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/packages/evaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.js","sourceRoot":"","sources":["../../src/packages/evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOlE,qFAAqF;AACrF,MAAM,OAAO,UAAU;IAGU,OAAO;IAF5B,MAAM,CAAwC;IAEtD,YAA6B,OAA2C;uBAA3C,OAAO;IAAuC,CAAC;IAE5E,OAAO;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEjC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAEpC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,KAAK;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAc;QAChB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACJ;AAED,oGAAoG;AACpG,MAAM,UAAU,cAAc,CAAQ,IAAuB;IACzD,MAAM,OAAO,GAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,IAAI,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,CAAC;YAEX,IAAI,KAAK,GAAG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;gBAC3D,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAEhC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,EAAE,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACL,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACpB,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;oBACzB,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,0CAA0C,EAAE;gBAC3E,KAAK,EAAE,KAAK;aACf,CAAC,CAAC;QACP,CAAC;QAED,MAAM,KAAK,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/packages/files.d.ts

@@ -0,0 +1,21 @@
+import { PackageImportError } from "./diagnostics.js";
+import { AmlParseError } from "./parser.js";
+import type { AmlDocument, PackageSource } from "./types.js";
+export declare class PackageFileError extends Error {
+    readonly code: string;
+    readonly path: string;
+    readonly name = "PackageFileError";
+    constructor(code: string, path: string, message: string, options?: ErrorOptions);
+}
+export declare function loadAmlDocuments(sources: readonly PackageSource[]): Promise<readonly AmlDocument[]>;
+export declare function readAmlDocument(path: string): Promise<AmlDocument>;
+export type PackageInputError = PackageFileError | PackageImportError | AmlParseError;
+interface PackageFileOptions {
+    readonly allowEmptyDirectories?: boolean;
+    readonly onError?: (error: PackageInputError) => void;
+}
+/** Resolve inputs without parsing AML, so automatic and additional paths can share discovery. */
+export declare function resolvePackageFiles(sources: readonly PackageSource[], options?: PackageFileOptions): Promise<readonly string[]>;
+export declare function readText(path: string): Promise<string>;
+export {};
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/packages/files.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAY,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,gBAAiB,SAAQ,KAAK;IAInC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJzB,SAAkB,IAAI,sBAAsB;IAE5C,YACa,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY,EAGzB;CACJ;AAED,wBAAsB,gBAAgB,CAClC,OAAO,EAAE,SAAS,aAAa,EAAE,GAClC,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAqBjC;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAExE;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEtF,UAAU,kBAAkB;IACxB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACzD;AAED,iGAAiG;AACjG,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAE5B;AA8ND,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe5D"}

package/dist/packages/files.js

@@ -0,0 +1,214 @@
+import { lstat, readdir, realpath } from "node:fs/promises";
+import { extname, join, resolve } from "node:path";
+import { readTextFile, TextEncodingError } from "../core/files.js";
+import { setupBytesMax, setupFilesMax } from "../core/limits.js";
+import { PackageImportError } from "./diagnostics.js";
+import { manifestPaths } from "./manifest.js";
+import { AmlParseError, parseAml } from "./parser.js";
+export class PackageFileError extends Error {
+    code;
+    path;
+    name = "PackageFileError";
+    constructor(code, path, message, options) {
+        super(`${path}: ${message}`, options);
+        this.code = code;
+        this.path = path;
+    }
+}
+export async function loadAmlDocuments(sources) {
+    const files = await resolvePackageFiles(sources);
+    const documents = [];
+    let bytes = 0;
+    for (const path of files) {
+        const document = await readAmlDocument(path);
+        bytes += document.xml.length * 3;
+        if (bytes > setupBytesMax) {
+            throw new PackageFileError("PackageReadFailed", path, "Package inputs exceed the setup byte limit.");
+        }
+        documents.push(document);
+    }
+    return Object.freeze(documents);
+}
+export async function readAmlDocument(path) {
+    return parseAml(await readText(path), path);
+}
+/** Resolve inputs without parsing AML, so automatic and additional paths can share discovery. */
+export async function resolvePackageFiles(sources, options = {}) {
+    return await new PackageFiles(options).resolve(sources);
+}
+class PackageFiles {
+    options;
+    files = [];
+    seen = new Set();
+    manifests = new Set();
+    visited = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    async resolve(sources) {
+        const pending = sources.map((source) => source.path).reverse();
+        while (pending.length > 0) {
+            this.checkDiscovery(pending.length);
+            const path = pending.pop();
+            if (path === undefined) {
+                throw new Error("A source must exist while package discovery is pending.");
+            }
+            try {
+                const children = await this.collectSource(path);
+                for (let index = children.length - 1; index >= 0; index -= 1) {
+                    const child = children[index];
+                    if (child) {
+                        if (pending.length >= setupFilesMax) {
+                            throw new PackageFileError("PackageReadFailed", path, "Package discovery exceeded its pending-file limit.");
+                        }
+                        pending.push(child);
+                    }
+                }
+            }
+            catch (error) {
+                this.reportError(error);
+            }
+        }
+        return Object.freeze(this.files);
+    }
+    checkDiscovery(pending) {
+        this.visited += 1;
+        if (this.visited > setupFilesMax ||
+            pending > setupFilesMax ||
+            this.files.length > setupFilesMax) {
+            throw new PackageFileError("PackageReadFailed", "<package inputs>", "Package discovery exceeded its work limit.");
+        }
+    }
+    reportError(error) {
+        if (!this.options.onError ||
+            !(error instanceof PackageFileError ||
+                error instanceof PackageImportError ||
+                error instanceof AmlParseError)) {
+            throw error;
+        }
+        this.options.onError(error);
+    }
+    async addFile(path) {
+        const canonical = await fileOperation(path, () => realpath(path));
+        if (this.seen.has(canonical)) {
+            throw new PackageFileError("DuplicatePackageFile", path, "This XML file was supplied more than once.");
+        }
+        this.seen.add(canonical);
+        this.files.push(canonical);
+    }
+    async collectDirectory(path) {
+        const discovered = [];
+        const pending = [path];
+        while (pending.length > 0) {
+            const directory = pending.pop();
+            if (directory === undefined) {
+                throw new Error("A directory must exist while discovery is pending.");
+            }
+            try {
+                const entries = await fileOperation(directory, () => readdir(directory, { withFileTypes: true }));
+                entries.sort((left, right) => comparePaths(left.name, right.name));
+                for (const entry of entries) {
+                    const child = join(directory, entry.name);
+                    try {
+                        if (entry.isSymbolicLink()) {
+                            throw new PackageFileError("UnsupportedSymlink", child, "Supply real files and directories instead of symbolic links.");
+                        }
+                        if (entry.isDirectory()) {
+                            pending.push(child);
+                        }
+                        else if (entry.isFile() && isXmlFile(child)) {
+                            discovered.push(child);
+                        }
+                        else if (!entry.isFile()) {
+                            throw new PackageFileError("UnsupportedPackageEntry", child, "Only regular files and directories are supported.");
+                        }
+                    }
+                    catch (error) {
+                        this.reportError(error);
+                    }
+                }
+            }
+            catch (error) {
+                this.reportError(error);
+            }
+        }
+        if (discovered.length === 0 && !this.options.allowEmptyDirectories) {
+            throw new PackageFileError("EmptyPackageDirectory", path, "No XML files were found in the supplied directory.");
+        }
+        for (const file of discovered.sort(comparePaths)) {
+            try {
+                await this.addFile(file);
+            }
+            catch (error) {
+                this.reportError(error);
+            }
+        }
+    }
+    async collectSource(sourcePath) {
+        if (!sourcePath.trim()) {
+            throw new PackageFileError("MissingPackagePath", sourcePath, "A package source path is required.");
+        }
+        const path = resolve(sourcePath);
+        const status = await fileOperation(path, () => lstat(path));
+        if (status.isSymbolicLink()) {
+            throw new PackageFileError("UnsupportedSymlink", path, "Supply a real file or directory instead of a symbolic link.");
+        }
+        if (status.isDirectory()) {
+            await this.collectDirectory(path);
+        }
+        else if (status.isFile() && extname(path).toLowerCase() === ".mf") {
+            return await this.collectManifest(path);
+        }
+        else if (status.isFile() && isXmlFile(path)) {
+            await this.addFile(path);
+        }
+        else {
+            throw new PackageFileError("UnsupportedPackageFile", path, "Supply an XML file, imports.mf manifest, package root, or Import directory.");
+        }
+        return [];
+    }
+    async collectManifest(path) {
+        const canonical = await fileOperation(path, () => realpath(path));
+        if (this.manifests.has(canonical)) {
+            throw new PackageFileError("DuplicatePackageManifest", path, "This manifest was supplied more than once or contains a recursive path.");
+        }
+        this.manifests.add(canonical);
+        const paths = manifestPaths(await readText(path), path);
+        if (paths.length === 0) {
+            throw new PackageFileError("EmptyPackageManifest", path, "The manifest contains no packages.");
+        }
+        return paths;
+    }
+}
+export async function readText(path) {
+    try {
+        return await fileOperation(path, () => readTextFile(path));
+    }
+    catch (error) {
+        if (error instanceof PackageFileError && error.cause instanceof TextEncodingError) {
+            throw new PackageFileError("InvalidPackageEncoding", path, "Package XML must contain valid UTF-8.", { cause: error.cause });
+        }
+        throw error;
+    }
+}
+function isXmlFile(path) {
+    return extname(path).toLowerCase() === ".xml";
+}
+function comparePaths(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    if (left < right) {
+        return -1;
+    }
+    return 1;
+}
+async function fileOperation(path, operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        throw new PackageFileError("PackageReadFailed", path, "Could not read the supplied package input.", { cause: error });
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/packages/files.js.map

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

package/dist/packages/importer.d.ts

@@ -0,0 +1,23 @@
+import type { SourceLocation } from "../diagnostics/source-location.js";
+import type { HarnessStorage } from "../storage/types.js";
+import type { AmlDocument } from "./types.js";
+export interface PackageLoadReport {
+    readonly documents: readonly {
+        readonly path: string;
+        readonly sha256: string;
+    }[];
+    readonly added: number;
+    readonly updated: number;
+    readonly deleted: number;
+    readonly itemTypes: readonly string[];
+    readonly generatedIds: readonly {
+        readonly id: string;
+        readonly source: SourceLocation;
+    }[];
+}
+export declare class PackageImporter {
+    private readonly storage;
+    constructor(storage: HarnessStorage);
+    import(documents: readonly AmlDocument[], fixtureFiles?: ReadonlySet<string>): PackageLoadReport;
+}
+//# sourceMappingURL=importer.d.ts.map