velocious 1.0.552 → 1.0.555

package/build/src/frontend-models/transport-deadline.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Runs an async transport operation under a bounded deadline built on awaitery's
+ * `timeout`, which owns the timer, the stable `TimeoutError`, and the timer
+ * cleanup. awaitery's deadline `AbortSignal` is handed to `operation` (composed
+ * with an optional caller/session signal) so the live request — and its
+ * response-body read — is actually aborted when the deadline expires, not merely
+ * left racing a wrapper promise.
+ *
+ * A deadline expiry rejects with awaitery's `TimeoutError`
+ * (`import {TimeoutError} from "awaitery/build/timeout.js"`), so callers can
+ * classify a timeout without parsing browser/network error text. A caller abort
+ * rejects with the caller's own reason, keeping the two distinguishable. Both the
+ * awaitery timer and the composed abort listeners are always cleaned up. With no
+ * positive `timeoutMs` the operation runs directly under the caller signal (or no
+ * signal) and no timer is armed.
+ * @template T
+ * @param {{timeoutMs?: number | null, signal?: AbortSignal | null, errorMessage?: string}} options - Deadline options.
+ * @param {(signal: AbortSignal) => Promise<T>} operation - Transport operation receiving the composed signal.
+ * @returns {Promise<T>} - The operation result.
+ */
+export default function runWithTransportDeadline<T>({ timeoutMs, signal, errorMessage }: {
+    timeoutMs?: number | null;
+    signal?: AbortSignal | null;
+    errorMessage?: string;
+}, operation: (signal: AbortSignal) => Promise<T>): Promise<T>;
+//# sourceMappingURL=transport-deadline.d.ts.map

package/build/src/frontend-models/transport-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-deadline.d.ts","sourceRoot":"","sources":["../../../src/frontend-models/transport-deadline.js"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iDALa,CAAC,uCACH;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAC,aAC/E,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CA2CtB"}

package/build/src/frontend-models/transport-deadline.js

@@ -0,0 +1,61 @@
+// @ts-check
+import timeout from "awaitery/build/timeout.js";
+/**
+ * Runs an async transport operation under a bounded deadline built on awaitery's
+ * `timeout`, which owns the timer, the stable `TimeoutError`, and the timer
+ * cleanup. awaitery's deadline `AbortSignal` is handed to `operation` (composed
+ * with an optional caller/session signal) so the live request — and its
+ * response-body read — is actually aborted when the deadline expires, not merely
+ * left racing a wrapper promise.
+ *
+ * A deadline expiry rejects with awaitery's `TimeoutError`
+ * (`import {TimeoutError} from "awaitery/build/timeout.js"`), so callers can
+ * classify a timeout without parsing browser/network error text. A caller abort
+ * rejects with the caller's own reason, keeping the two distinguishable. Both the
+ * awaitery timer and the composed abort listeners are always cleaned up. With no
+ * positive `timeoutMs` the operation runs directly under the caller signal (or no
+ * signal) and no timer is armed.
+ * @template T
+ * @param {{timeoutMs?: number | null, signal?: AbortSignal | null, errorMessage?: string}} options - Deadline options.
+ * @param {(signal: AbortSignal) => Promise<T>} operation - Transport operation receiving the composed signal.
+ * @returns {Promise<T>} - The operation result.
+ */
+export default async function runWithTransportDeadline({ timeoutMs, signal, errorMessage }, operation) {
+    if (!(typeof timeoutMs === "number" && timeoutMs > 0)) {
+        // No deadline: run under the caller signal if provided, else a never-aborting signal.
+        return await operation(signal || new AbortController().signal);
+    }
+    return await timeout({ errorMessage: errorMessage || "Transport request timed out", timeout: timeoutMs }, async ({ control }) => {
+        if (!signal) {
+            return await operation(control.signal);
+        }
+        // A caller that has already cancelled must not start a live request.
+        if (signal.aborted) {
+            throw signal.reason instanceof Error ? signal.reason : new Error("Transport request aborted");
+        }
+        // Compose the caller/session signal with awaitery's deadline signal: either
+        // one aborts the live operation, and the composed listeners are always removed.
+        const callerSignal = signal;
+        const composed = new AbortController();
+        /**
+         * Aborts the composed operation when the deadline signal fires.
+         * @returns {void} - No return value.
+         */
+        const onDeadlineAbort = () => composed.abort(control.signal.reason);
+        /**
+         * Aborts the composed operation when the caller signal fires.
+         * @returns {void} - No return value.
+         */
+        const onCallerAbort = () => composed.abort(callerSignal.reason);
+        control.signal.addEventListener("abort", onDeadlineAbort);
+        callerSignal.addEventListener("abort", onCallerAbort);
+        try {
+            return await operation(composed.signal);
+        }
+        finally {
+            control.signal.removeEventListener("abort", onDeadlineAbort);
+            callerSignal.removeEventListener("abort", onCallerAbort);
+        }
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHJhbnNwb3J0LWRlYWRsaW5lLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2Zyb250ZW5kLW1vZGVscy90cmFuc3BvcnQtZGVhZGxpbmUuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaLE9BQU8sT0FBTyxNQUFNLDJCQUEyQixDQUFBO0FBRS9DOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBbUJHO0FBQ0gsTUFBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLFVBQVUsd0JBQXdCLENBQUMsRUFBQyxTQUFTLEVBQUUsTUFBTSxFQUFFLFlBQVksRUFBQyxFQUFFLFNBQVM7SUFDakcsSUFBSSxDQUFDLENBQUMsT0FBTyxTQUFTLEtBQUssUUFBUSxJQUFJLFNBQVMsR0FBRyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ3RELHNGQUFzRjtRQUN0RixPQUFPLE1BQU0sU0FBUyxDQUFDLE1BQU0sSUFBSSxJQUFJLGVBQWUsRUFBRSxDQUFDLE1BQU0sQ0FBQyxDQUFBO0lBQ2hFLENBQUM7SUFFRCxPQUFPLE1BQU0sT0FBTyxDQUFDLEVBQUMsWUFBWSxFQUFFLFlBQVksSUFBSSw2QkFBNkIsRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFDLEVBQUUsS0FBSyxFQUFFLEVBQUMsT0FBTyxFQUFDLEVBQUUsRUFBRTtRQUMxSCxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDWixPQUFPLE1BQU0sU0FBUyxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsQ0FBQTtRQUN4QyxDQUFDO1FBRUQscUVBQXFFO1FBQ3JFLElBQUksTUFBTSxDQUFDLE9BQU8sRUFBRSxDQUFDO1lBQ25CLE1BQU0sTUFBTSxDQUFDLE1BQU0sWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLDJCQUEyQixDQUFDLENBQUE7UUFDL0YsQ0FBQztRQUVELDRFQUE0RTtRQUM1RSxnRkFBZ0Y7UUFDaEYsTUFBTSxZQUFZLEdBQUcsTUFBTSxDQUFBO1FBQzNCLE1BQU0sUUFBUSxHQUFHLElBQUksZUFBZSxFQUFFLENBQUE7UUFDdEM7OztXQUdHO1FBQ0gsTUFBTSxlQUFlLEdBQUcsR0FBRyxFQUFFLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxDQUFBO1FBQ25FOzs7V0FHRztRQUNILE1BQU0sYUFBYSxHQUFHLEdBQUcsRUFBRSxDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsWUFBWSxDQUFDLE1BQU0sQ0FBQyxDQUFBO1FBRS9ELE9BQU8sQ0FBQyxNQUFNLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxFQUFFLGVBQWUsQ0FBQyxDQUFBO1FBQ3pELFlBQVksQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLEVBQUUsYUFBYSxDQUFDLENBQUE7UUFFckQsSUFBSSxDQUFDO1lBQ0gsT0FBTyxNQUFNLFNBQVMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUE7UUFDekMsQ0FBQztnQkFBUyxDQUFDO1lBQ1QsT0FBTyxDQUFDLE1BQU0sQ0FBQyxtQkFBbUIsQ0FBQyxPQUFPLEVBQUUsZUFBZSxDQUFDLENBQUE7WUFDNUQsWUFBWSxDQUFDLG1CQUFtQixDQUFDLE9BQU8sRUFBRSxhQUFhLENBQUMsQ0FBQTtRQUMxRCxDQUFDO0lBQ0gsQ0FBQyxDQUFDLENBQUE7QUFDSixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbmltcG9ydCB0aW1lb3V0IGZyb20gXCJhd2FpdGVyeS9idWlsZC90aW1lb3V0LmpzXCJcblxuLyoqXG4gKiBSdW5zIGFuIGFzeW5jIHRyYW5zcG9ydCBvcGVyYXRpb24gdW5kZXIgYSBib3VuZGVkIGRlYWRsaW5lIGJ1aWx0IG9uIGF3YWl0ZXJ5J3NcbiAqIGB0aW1lb3V0YCwgd2hpY2ggb3ducyB0aGUgdGltZXIsIHRoZSBzdGFibGUgYFRpbWVvdXRFcnJvcmAsIGFuZCB0aGUgdGltZXJcbiAqIGNsZWFudXAuIGF3YWl0ZXJ5J3MgZGVhZGxpbmUgYEFib3J0U2lnbmFsYCBpcyBoYW5kZWQgdG8gYG9wZXJhdGlvbmAgKGNvbXBvc2VkXG4gKiB3aXRoIGFuIG9wdGlvbmFsIGNhbGxlci9zZXNzaW9uIHNpZ25hbCkgc28gdGhlIGxpdmUgcmVxdWVzdCDigJQgYW5kIGl0c1xuICogcmVzcG9uc2UtYm9keSByZWFkIOKAlCBpcyBhY3R1YWxseSBhYm9ydGVkIHdoZW4gdGhlIGRlYWRsaW5lIGV4cGlyZXMsIG5vdCBtZXJlbHlcbiAqIGxlZnQgcmFjaW5nIGEgd3JhcHBlciBwcm9taXNlLlxuICpcbiAqIEEgZGVhZGxpbmUgZXhwaXJ5IHJlamVjdHMgd2l0aCBhd2FpdGVyeSdzIGBUaW1lb3V0RXJyb3JgXG4gKiAoYGltcG9ydCB7VGltZW91dEVycm9yfSBmcm9tIFwiYXdhaXRlcnkvYnVpbGQvdGltZW91dC5qc1wiYCksIHNvIGNhbGxlcnMgY2FuXG4gKiBjbGFzc2lmeSBhIHRpbWVvdXQgd2l0aG91dCBwYXJzaW5nIGJyb3dzZXIvbmV0d29yayBlcnJvciB0ZXh0LiBBIGNhbGxlciBhYm9ydFxuICogcmVqZWN0cyB3aXRoIHRoZSBjYWxsZXIncyBvd24gcmVhc29uLCBrZWVwaW5nIHRoZSB0d28gZGlzdGluZ3Vpc2hhYmxlLiBCb3RoIHRoZVxuICogYXdhaXRlcnkgdGltZXIgYW5kIHRoZSBjb21wb3NlZCBhYm9ydCBsaXN0ZW5lcnMgYXJlIGFsd2F5cyBjbGVhbmVkIHVwLiBXaXRoIG5vXG4gKiBwb3NpdGl2ZSBgdGltZW91dE1zYCB0aGUgb3BlcmF0aW9uIHJ1bnMgZGlyZWN0bHkgdW5kZXIgdGhlIGNhbGxlciBzaWduYWwgKG9yIG5vXG4gKiBzaWduYWwpIGFuZCBubyB0aW1lciBpcyBhcm1lZC5cbiAqIEB0ZW1wbGF0ZSBUXG4gKiBAcGFyYW0ge3t0aW1lb3V0TXM/OiBudW1iZXIgfCBudWxsLCBzaWduYWw/OiBBYm9ydFNpZ25hbCB8IG51bGwsIGVycm9yTWVzc2FnZT86IHN0cmluZ319IG9wdGlvbnMgLSBEZWFkbGluZSBvcHRpb25zLlxuICogQHBhcmFtIHsoc2lnbmFsOiBBYm9ydFNpZ25hbCkgPT4gUHJvbWlzZTxUPn0gb3BlcmF0aW9uIC0gVHJhbnNwb3J0IG9wZXJhdGlvbiByZWNlaXZpbmcgdGhlIGNvbXBvc2VkIHNpZ25hbC5cbiAqIEByZXR1cm5zIHtQcm9taXNlPFQ+fSAtIFRoZSBvcGVyYXRpb24gcmVzdWx0LlxuICovXG5leHBvcnQgZGVmYXVsdCBhc3luYyBmdW5jdGlvbiBydW5XaXRoVHJhbnNwb3J0RGVhZGxpbmUoe3RpbWVvdXRNcywgc2lnbmFsLCBlcnJvck1lc3NhZ2V9LCBvcGVyYXRpb24pIHtcbiAgaWYgKCEodHlwZW9mIHRpbWVvdXRNcyA9PT0gXCJudW1iZXJcIiAmJiB0aW1lb3V0TXMgPiAwKSkge1xuICAgIC8vIE5vIGRlYWRsaW5lOiBydW4gdW5kZXIgdGhlIGNhbGxlciBzaWduYWwgaWYgcHJvdmlkZWQsIGVsc2UgYSBuZXZlci1hYm9ydGluZyBzaWduYWwuXG4gICAgcmV0dXJuIGF3YWl0IG9wZXJhdGlvbihzaWduYWwgfHwgbmV3IEFib3J0Q29udHJvbGxlcigpLnNpZ25hbClcbiAgfVxuXG4gIHJldHVybiBhd2FpdCB0aW1lb3V0KHtlcnJvck1lc3NhZ2U6IGVycm9yTWVzc2FnZSB8fCBcIlRyYW5zcG9ydCByZXF1ZXN0IHRpbWVkIG91dFwiLCB0aW1lb3V0OiB0aW1lb3V0TXN9LCBhc3luYyAoe2NvbnRyb2x9KSA9PiB7XG4gICAgaWYgKCFzaWduYWwpIHtcbiAgICAgIHJldHVybiBhd2FpdCBvcGVyYXRpb24oY29udHJvbC5zaWduYWwpXG4gICAgfVxuXG4gICAgLy8gQSBjYWxsZXIgdGhhdCBoYXMgYWxyZWFkeSBjYW5jZWxsZWQgbXVzdCBub3Qgc3RhcnQgYSBsaXZlIHJlcXVlc3QuXG4gICAgaWYgKHNpZ25hbC5hYm9ydGVkKSB7XG4gICAgICB0aHJvdyBzaWduYWwucmVhc29uIGluc3RhbmNlb2YgRXJyb3IgPyBzaWduYWwucmVhc29uIDogbmV3IEVycm9yKFwiVHJhbnNwb3J0IHJlcXVlc3QgYWJvcnRlZFwiKVxuICAgIH1cblxuICAgIC8vIENvbXBvc2UgdGhlIGNhbGxlci9zZXNzaW9uIHNpZ25hbCB3aXRoIGF3YWl0ZXJ5J3MgZGVhZGxpbmUgc2lnbmFsOiBlaXRoZXJcbiAgICAvLyBvbmUgYWJvcnRzIHRoZSBsaXZlIG9wZXJhdGlvbiwgYW5kIHRoZSBjb21wb3NlZCBsaXN0ZW5lcnMgYXJlIGFsd2F5cyByZW1vdmVkLlxuICAgIGNvbnN0IGNhbGxlclNpZ25hbCA9IHNpZ25hbFxuICAgIGNvbnN0IGNvbXBvc2VkID0gbmV3IEFib3J0Q29udHJvbGxlcigpXG4gICAgLyoqXG4gICAgICogQWJvcnRzIHRoZSBjb21wb3NlZCBvcGVyYXRpb24gd2hlbiB0aGUgZGVhZGxpbmUgc2lnbmFsIGZpcmVzLlxuICAgICAqIEByZXR1cm5zIHt2b2lkfSAtIE5vIHJldHVybiB2YWx1ZS5cbiAgICAgKi9cbiAgICBjb25zdCBvbkRlYWRsaW5lQWJvcnQgPSAoKSA9PiBjb21wb3NlZC5hYm9ydChjb250cm9sLnNpZ25hbC5yZWFzb24pXG4gICAgLyoqXG4gICAgICogQWJvcnRzIHRoZSBjb21wb3NlZCBvcGVyYXRpb24gd2hlbiB0aGUgY2FsbGVyIHNpZ25hbCBmaXJlcy5cbiAgICAgKiBAcmV0dXJucyB7dm9pZH0gLSBObyByZXR1cm4gdmFsdWUuXG4gICAgICovXG4gICAgY29uc3Qgb25DYWxsZXJBYm9ydCA9ICgpID0+IGNvbXBvc2VkLmFib3J0KGNhbGxlclNpZ25hbC5yZWFzb24pXG5cbiAgICBjb250cm9sLnNpZ25hbC5hZGRFdmVudExpc3RlbmVyKFwiYWJvcnRcIiwgb25EZWFkbGluZUFib3J0KVxuICAgIGNhbGxlclNpZ25hbC5hZGRFdmVudExpc3RlbmVyKFwiYWJvcnRcIiwgb25DYWxsZXJBYm9ydClcblxuICAgIHRyeSB7XG4gICAgICByZXR1cm4gYXdhaXQgb3BlcmF0aW9uKGNvbXBvc2VkLnNpZ25hbClcbiAgICB9IGZpbmFsbHkge1xuICAgICAgY29udHJvbC5zaWduYWwucmVtb3ZlRXZlbnRMaXN0ZW5lcihcImFib3J0XCIsIG9uRGVhZGxpbmVBYm9ydClcbiAgICAgIGNhbGxlclNpZ25hbC5yZW1vdmVFdmVudExpc3RlbmVyKFwiYWJvcnRcIiwgb25DYWxsZXJBYm9ydClcbiAgICB9XG4gIH0pXG59XG4iXX0=

package/build/src/testing/factory/association-declaration.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A declared association. It records the relationship name, the factory to run
+ * (defaulting to the relationship name), any traits/overrides passed to that
+ * factory, and an optional explicit strategy. When no strategy is given the
+ * association follows the parent strategy at evaluation time.
+ */
+export default class AssociationDeclaration {
+    /**
+     * Builds an association declaration.
+     * @param {object} args - Options.
+     * @param {string} args.name - Relationship name on the owning model.
+     * @param {string} [args.factory] - Factory name to run. Defaults to the relationship name.
+     * @param {string[]} [args.traits] - Traits passed to the association factory.
+     * @param {Record<string, ?>} [args.overrides] - Overrides passed to the association factory.
+     * @param {"build" | "create" | undefined} [args.strategy] - Explicit strategy override.
+     */
+    constructor({ name, factory, traits, overrides, strategy }: {
+        name: string;
+        factory?: string | undefined;
+        traits?: string[] | undefined;
+        overrides?: Record<string, any> | undefined;
+        strategy?: "build" | "create" | undefined;
+    });
+    /** @type {"association"} - Discriminant. */
+    kind: "association";
+    /** @type {string} - Relationship name on the owning model. */
+    name: string;
+    /** @type {string} - Factory name to run for the association. */
+    factory: string;
+    /** @type {string[]} - Traits passed to the association factory. */
+    traits: string[];
+    /** @type {Record<string, ?>} - Overrides passed to the association factory. */
+    overrides: Record<string, unknown>;
+    /** @type {"build" | "create" | undefined} - Explicit strategy override. */
+    strategy: "build" | "create" | undefined;
+}
+//# sourceMappingURL=association-declaration.d.ts.map

package/build/src/testing/factory/association-declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"association-declaration.d.ts","sourceRoot":"","sources":["../../../../src/testing/factory/association-declaration.js"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH;IACE;;;;;;;;OAQG;IACH,4DANG;QAAqB,IAAI,EAAjB,MAAM;QACQ,OAAO;QACL,MAAM;QACG,SAAS;QACI,QAAQ,GAA9C,OAAO,GAAG,QAAQ,GAAG,SAAS;KACxC,EA6BA;IAnBC,4CAA4C;IAC5C,MADW,aAAa,CACC;IAEzB,8DAA8D;IAC9D,MADW,MAAM,CACD;IAEhB,gEAAgE;IAChE,SADW,MAAM,CACa;IAE9B,mEAAmE;IACnE,QADW,MAAM,EAAE,CACC;IAEpB,+EAA+E;IAC/E,WADW,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CACF;IAE1B,2EAA2E;IAC3E,UADW,OAAO,GAAG,QAAQ,GAAG,SAAS,CACjB;CAI3B"}

package/build/src/testing/factory/association-declaration.js

@@ -0,0 +1,41 @@
+// @ts-check
+import { InvalidDefinitionError } from "./errors.js";
+/**
+ * A declared association. It records the relationship name, the factory to run
+ * (defaulting to the relationship name), any traits/overrides passed to that
+ * factory, and an optional explicit strategy. When no strategy is given the
+ * association follows the parent strategy at evaluation time.
+ */
+export default class AssociationDeclaration {
+    /**
+     * Builds an association declaration.
+     * @param {object} args - Options.
+     * @param {string} args.name - Relationship name on the owning model.
+     * @param {string} [args.factory] - Factory name to run. Defaults to the relationship name.
+     * @param {string[]} [args.traits] - Traits passed to the association factory.
+     * @param {Record<string, ?>} [args.overrides] - Overrides passed to the association factory.
+     * @param {"build" | "create" | undefined} [args.strategy] - Explicit strategy override.
+     */
+    constructor({ name, factory, traits = [], overrides = {}, strategy }) {
+        if (!name || typeof name !== "string") {
+            throw new InvalidDefinitionError(`Association name must be a non-empty string, got: ${String(name)}`);
+        }
+        if (strategy !== undefined && strategy !== "build" && strategy !== "create") {
+            throw new InvalidDefinitionError(`Association strategy must be "build" or "create", got: ${String(strategy)}`);
+        }
+        /** @type {"association"} - Discriminant. */
+        this.kind = "association";
+        /** @type {string} - Relationship name on the owning model. */
+        this.name = name;
+        /** @type {string} - Factory name to run for the association. */
+        this.factory = factory || name;
+        /** @type {string[]} - Traits passed to the association factory. */
+        this.traits = traits;
+        /** @type {Record<string, ?>} - Overrides passed to the association factory. */
+        this.overrides = overrides;
+        /** @type {"build" | "create" | undefined} - Explicit strategy override. */
+        this.strategy = strategy;
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXNzb2NpYXRpb24tZGVjbGFyYXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvdGVzdGluZy9mYWN0b3J5L2Fzc29jaWF0aW9uLWRlY2xhcmF0aW9uLmpzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLFlBQVk7QUFFWixPQUFPLEVBQUMsc0JBQXNCLEVBQUMsTUFBTSxhQUFhLENBQUE7QUFFbEQ7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsT0FBTyxPQUFPLHNCQUFzQjtJQUN6Qzs7Ozs7Ozs7T0FRRztJQUNILFlBQVksRUFBQyxJQUFJLEVBQUUsT0FBTyxFQUFFLE1BQU0sR0FBRyxFQUFFLEVBQUUsU0FBUyxHQUFHLEVBQUUsRUFBRSxRQUFRLEVBQUM7UUFDaEUsSUFBSSxDQUFDLElBQUksSUFBSSxPQUFPLElBQUksS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUN0QyxNQUFNLElBQUksc0JBQXNCLENBQUMscURBQXFELE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUE7UUFDdkcsQ0FBQztRQUVELElBQUksUUFBUSxLQUFLLFNBQVMsSUFBSSxRQUFRLEtBQUssT0FBTyxJQUFJLFFBQVEsS0FBSyxRQUFRLEVBQUUsQ0FBQztZQUM1RSxNQUFNLElBQUksc0JBQXNCLENBQUMsMERBQTBELE1BQU0sQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLENBQUE7UUFDaEgsQ0FBQztRQUVELDRDQUE0QztRQUM1QyxJQUFJLENBQUMsSUFBSSxHQUFHLGFBQWEsQ0FBQTtRQUV6Qiw4REFBOEQ7UUFDOUQsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUE7UUFFaEIsZ0VBQWdFO1FBQ2hFLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxJQUFJLElBQUksQ0FBQTtRQUU5QixtRUFBbUU7UUFDbkUsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUE7UUFFcEIsK0VBQStFO1FBQy9FLElBQUksQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFBO1FBRTFCLDJFQUEyRTtRQUMzRSxJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQTtRQUV4QixNQUFNLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFBO0lBQ3JCLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8vIEB0cy1jaGVja1xuXG5pbXBvcnQge0ludmFsaWREZWZpbml0aW9uRXJyb3J9IGZyb20gXCIuL2Vycm9ycy5qc1wiXG5cbi8qKlxuICogQSBkZWNsYXJlZCBhc3NvY2lhdGlvbi4gSXQgcmVjb3JkcyB0aGUgcmVsYXRpb25zaGlwIG5hbWUsIHRoZSBmYWN0b3J5IHRvIHJ1blxuICogKGRlZmF1bHRpbmcgdG8gdGhlIHJlbGF0aW9uc2hpcCBuYW1lKSwgYW55IHRyYWl0cy9vdmVycmlkZXMgcGFzc2VkIHRvIHRoYXRcbiAqIGZhY3RvcnksIGFuZCBhbiBvcHRpb25hbCBleHBsaWNpdCBzdHJhdGVneS4gV2hlbiBubyBzdHJhdGVneSBpcyBnaXZlbiB0aGVcbiAqIGFzc29jaWF0aW9uIGZvbGxvd3MgdGhlIHBhcmVudCBzdHJhdGVneSBhdCBldmFsdWF0aW9uIHRpbWUuXG4gKi9cbmV4cG9ydCBkZWZhdWx0IGNsYXNzIEFzc29jaWF0aW9uRGVjbGFyYXRpb24ge1xuICAvKipcbiAgICogQnVpbGRzIGFuIGFzc29jaWF0aW9uIGRlY2xhcmF0aW9uLlxuICAgKiBAcGFyYW0ge29iamVjdH0gYXJncyAtIE9wdGlvbnMuXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBhcmdzLm5hbWUgLSBSZWxhdGlvbnNoaXAgbmFtZSBvbiB0aGUgb3duaW5nIG1vZGVsLlxuICAgKiBAcGFyYW0ge3N0cmluZ30gW2FyZ3MuZmFjdG9yeV0gLSBGYWN0b3J5IG5hbWUgdG8gcnVuLiBEZWZhdWx0cyB0byB0aGUgcmVsYXRpb25zaGlwIG5hbWUuXG4gICAqIEBwYXJhbSB7c3RyaW5nW119IFthcmdzLnRyYWl0c10gLSBUcmFpdHMgcGFzc2VkIHRvIHRoZSBhc3NvY2lhdGlvbiBmYWN0b3J5LlxuICAgKiBAcGFyYW0ge1JlY29yZDxzdHJpbmcsID8+fSBbYXJncy5vdmVycmlkZXNdIC0gT3ZlcnJpZGVzIHBhc3NlZCB0byB0aGUgYXNzb2NpYXRpb24gZmFjdG9yeS5cbiAgICogQHBhcmFtIHtcImJ1aWxkXCIgfCBcImNyZWF0ZVwiIHwgdW5kZWZpbmVkfSBbYXJncy5zdHJhdGVneV0gLSBFeHBsaWNpdCBzdHJhdGVneSBvdmVycmlkZS5cbiAgICovXG4gIGNvbnN0cnVjdG9yKHtuYW1lLCBmYWN0b3J5LCB0cmFpdHMgPSBbXSwgb3ZlcnJpZGVzID0ge30sIHN0cmF0ZWd5fSkge1xuICAgIGlmICghbmFtZSB8fCB0eXBlb2YgbmFtZSAhPT0gXCJzdHJpbmdcIikge1xuICAgICAgdGhyb3cgbmV3IEludmFsaWREZWZpbml0aW9uRXJyb3IoYEFzc29jaWF0aW9uIG5hbWUgbXVzdCBiZSBhIG5vbi1lbXB0eSBzdHJpbmcsIGdvdDogJHtTdHJpbmcobmFtZSl9YClcbiAgICB9XG5cbiAgICBpZiAoc3RyYXRlZ3kgIT09IHVuZGVmaW5lZCAmJiBzdHJhdGVneSAhPT0gXCJidWlsZFwiICYmIHN0cmF0ZWd5ICE9PSBcImNyZWF0ZVwiKSB7XG4gICAgICB0aHJvdyBuZXcgSW52YWxpZERlZmluaXRpb25FcnJvcihgQXNzb2NpYXRpb24gc3RyYXRlZ3kgbXVzdCBiZSBcImJ1aWxkXCIgb3IgXCJjcmVhdGVcIiwgZ290OiAke1N0cmluZyhzdHJhdGVneSl9YClcbiAgICB9XG5cbiAgICAvKiogQHR5cGUge1wiYXNzb2NpYXRpb25cIn0gLSBEaXNjcmltaW5hbnQuICovXG4gICAgdGhpcy5raW5kID0gXCJhc3NvY2lhdGlvblwiXG5cbiAgICAvKiogQHR5cGUge3N0cmluZ30gLSBSZWxhdGlvbnNoaXAgbmFtZSBvbiB0aGUgb3duaW5nIG1vZGVsLiAqL1xuICAgIHRoaXMubmFtZSA9IG5hbWVcblxuICAgIC8qKiBAdHlwZSB7c3RyaW5nfSAtIEZhY3RvcnkgbmFtZSB0byBydW4gZm9yIHRoZSBhc3NvY2lhdGlvbi4gKi9cbiAgICB0aGlzLmZhY3RvcnkgPSBmYWN0b3J5IHx8IG5hbWVcblxuICAgIC8qKiBAdHlwZSB7c3RyaW5nW119IC0gVHJhaXRzIHBhc3NlZCB0byB0aGUgYXNzb2NpYXRpb24gZmFjdG9yeS4gKi9cbiAgICB0aGlzLnRyYWl0cyA9IHRyYWl0c1xuXG4gICAgLyoqIEB0eXBlIHtSZWNvcmQ8c3RyaW5nLCA/Pn0gLSBPdmVycmlkZXMgcGFzc2VkIHRvIHRoZSBhc3NvY2lhdGlvbiBmYWN0b3J5LiAqL1xuICAgIHRoaXMub3ZlcnJpZGVzID0gb3ZlcnJpZGVzXG5cbiAgICAvKiogQHR5cGUge1wiYnVpbGRcIiB8IFwiY3JlYXRlXCIgfCB1bmRlZmluZWR9IC0gRXhwbGljaXQgc3RyYXRlZ3kgb3ZlcnJpZGUuICovXG4gICAgdGhpcy5zdHJhdGVneSA9IHN0cmF0ZWd5XG5cbiAgICBPYmplY3QuZnJlZXplKHRoaXMpXG4gIH1cbn1cbiJdfQ==

package/build/src/testing/factory/declarations.d.ts

@@ -0,0 +1,190 @@
+/**
+ * A literal or lazy attribute (or transient) declaration. A function value is the
+ * lazy form and receives the evaluator context; any other value is a literal.
+ * @typedef {object} AttributeDeclaration
+ * @property {"attribute"} kind - Discriminant.
+ * @property {string} name - Attribute name.
+ * @property {boolean} isTransient - Whether the value is transient (never assigned/returned).
+ * @property {?} value - Literal value or lazy `(context) => value` function.
+ */
+/**
+ * A lifecycle callback declaration. The same declaration object reached through
+ * multiple trait paths runs once per record (dedup is by object identity).
+ * @typedef {object} CallbackDeclaration
+ * @property {"callback"} kind - Discriminant.
+ * @property {string} event - One of the supported callback events.
+ * @property {(args: {record: ?, context: ?, strategy: string}) => (void | Promise<void>)} fn - Callback body.
+ */
+/**
+ * A base-trait inclusion declaration (a trait applied by default within a factory
+ * or composed inside another trait).
+ * @typedef {object} TraitIncludeDeclaration
+ * @property {"traitInclude"} kind - Discriminant.
+ * @property {string} name - Referenced trait name.
+ */
+/**
+ * A custom-constructor declaration.
+ * @typedef {object} InitializeWithDeclaration
+ * @property {"initializeWith"} kind - Discriminant.
+ * @property {(args: {attributes: Record<string, ?>, context: ?, get: (name: string) => ?}) => (? | Promise<?>)} fn - Constructor body.
+ */
+/**
+ * A custom-persistence declaration.
+ * @typedef {object} ToCreateDeclaration
+ * @property {"toCreate"} kind - Discriminant.
+ * @property {(args: {record: ?, context: ?}) => (void | Promise<void>)} fn - Persistence body.
+ */
+/**
+ * A declaration that disables persistence entirely for the create strategy.
+ * @typedef {object} SkipCreateDeclaration
+ * @property {"skipCreate"} kind - Discriminant.
+ */
+/**
+ * Union of every declaration kind stored on a factory/trait definition. Includes
+ * association declarations imported from their own module.
+ * @typedef {AttributeDeclaration | CallbackDeclaration | TraitIncludeDeclaration | InitializeWithDeclaration | ToCreateDeclaration | SkipCreateDeclaration | import("./association-declaration.js").default} Declaration
+ */
+/**
+ * Creates a literal/lazy attribute declaration.
+ * @param {string} name - Attribute name.
+ * @param {?} value - Literal value or lazy function.
+ * @param {boolean} isTransient - Whether the declaration is transient.
+ * @returns {AttributeDeclaration} - The frozen declaration.
+ */
+export function attributeDeclaration(name: string, value: unknown, isTransient: boolean): AttributeDeclaration;
+/**
+ * Creates a lifecycle callback declaration.
+ * @param {string} event - Callback event name.
+ * @param {CallbackDeclaration["fn"]} fn - Callback body.
+ * @returns {CallbackDeclaration} - The frozen declaration.
+ */
+export function callbackDeclaration(event: string, fn: CallbackDeclaration["fn"]): CallbackDeclaration;
+/**
+ * Creates a base-trait inclusion declaration.
+ * @param {string} name - Referenced trait name.
+ * @returns {TraitIncludeDeclaration} - The frozen declaration.
+ */
+export function traitIncludeDeclaration(name: string): TraitIncludeDeclaration;
+/**
+ * Creates a custom-constructor declaration.
+ * @param {InitializeWithDeclaration["fn"]} fn - Constructor body.
+ * @returns {InitializeWithDeclaration} - The frozen declaration.
+ */
+export function initializeWithDeclaration(fn: InitializeWithDeclaration["fn"]): InitializeWithDeclaration;
+/**
+ * Creates a custom-persistence declaration.
+ * @param {ToCreateDeclaration["fn"]} fn - Persistence body.
+ * @returns {ToCreateDeclaration} - The frozen declaration.
+ */
+export function toCreateDeclaration(fn: ToCreateDeclaration["fn"]): ToCreateDeclaration;
+/**
+ * Creates a skip-create declaration.
+ * @returns {SkipCreateDeclaration} - The frozen declaration.
+ */
+export function skipCreateDeclaration(): SkipCreateDeclaration;
+/**
+ * A literal or lazy attribute (or transient) declaration. A function value is the
+ * lazy form and receives the evaluator context; any other value is a literal.
+ */
+export type AttributeDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "attribute";
+    /**
+     * - Attribute name.
+     */
+    name: string;
+    /**
+     * - Whether the value is transient (never assigned/returned).
+     */
+    isTransient: boolean;
+    /**
+     * - Literal value or lazy `(context) => value` function.
+     */
+    value: unknown;
+};
+/**
+ * A lifecycle callback declaration. The same declaration object reached through
+ * multiple trait paths runs once per record (dedup is by object identity).
+ */
+export type CallbackDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "callback";
+    /**
+     * - One of the supported callback events.
+     */
+    event: string;
+    /**
+     * - Callback body.
+     */
+    fn: (args: {
+        record: unknown;
+        context: unknown;
+        strategy: string;
+    }) => (void | Promise<void>);
+};
+/**
+ * A base-trait inclusion declaration (a trait applied by default within a factory
+ * or composed inside another trait).
+ */
+export type TraitIncludeDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "traitInclude";
+    /**
+     * - Referenced trait name.
+     */
+    name: string;
+};
+/**
+ * A custom-constructor declaration.
+ */
+export type InitializeWithDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "initializeWith";
+    /**
+     * - Constructor body.
+     */
+    fn: (args: {
+        attributes: Record<string, unknown>;
+        context: unknown;
+        get: (name: string) => unknown;
+    }) => (unknown | Promise<unknown>);
+};
+/**
+ * A custom-persistence declaration.
+ */
+export type ToCreateDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "toCreate";
+    /**
+     * - Persistence body.
+     */
+    fn: (args: {
+        record: unknown;
+        context: unknown;
+    }) => (void | Promise<void>);
+};
+/**
+ * A declaration that disables persistence entirely for the create strategy.
+ */
+export type SkipCreateDeclaration = {
+    /**
+     * - Discriminant.
+     */
+    kind: "skipCreate";
+};
+/**
+ * Union of every declaration kind stored on a factory/trait definition. Includes
+ * association declarations imported from their own module.
+ */
+export type Declaration = AttributeDeclaration | CallbackDeclaration | TraitIncludeDeclaration | InitializeWithDeclaration | ToCreateDeclaration | SkipCreateDeclaration | import("./association-declaration.js").default;
+//# sourceMappingURL=declarations.d.ts.map

package/build/src/testing/factory/declarations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.d.ts","sourceRoot":"","sources":["../../../../src/testing/factory/declarations.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;;GAMG;AAEH;;;;;GAKG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;;GAIG;AAEH;;;;;;GAMG;AACH,2CALW,MAAM,SACN,OAAC,eACD,OAAO,GACL,oBAAoB,CAIhC;AAED;;;;;GAKG;AACH,2CAJW,MAAM,MACN,mBAAmB,CAAC,IAAI,CAAC,GACvB,mBAAmB,CAI/B;AAED;;;;GAIG;AACH,8CAHW,MAAM,GACJ,uBAAuB,CAInC;AAED;;;;GAIG;AACH,8CAHW,yBAAyB,CAAC,IAAI,CAAC,GAC7B,yBAAyB,CAIrC;AAED;;;;GAIG;AACH,wCAHW,mBAAmB,CAAC,IAAI,CAAC,GACvB,mBAAmB,CAI/B;AAED;;;GAGG;AACH,yCAFa,qBAAqB,CAIjC;;;;;;;;;UAvGa,WAAW;;;;UACX,MAAM;;;;iBACN,OAAO;;;;WACP,OAAC;;;;;;;;;;UAOD,UAAU;;;;WACV,MAAM;;;;QACN,CAAC,IAAI,EAAE;QAAC,MAAM,EAAE,OAAC,CAAC;QAAC,OAAO,EAAE,OAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;;;;;;UAO3E,cAAc;;;;UACd,MAAM;;;;;;;;;UAMN,gBAAgB;;;;QAChB,CAAC,IAAI,EAAE;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAC,CAAC,CAAC;QAAC,OAAO,EAAE,OAAC,CAAC;QAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAC,CAAA;KAAC,KAAK,CAAC,OAAC,GAAG,OAAO,CAAC,OAAC,CAAC,CAAC;;;;;;;;;UAMjG,UAAU;;;;QACV,CAAC,IAAI,EAAE;QAAC,MAAM,EAAE,OAAC,CAAC;QAAC,OAAO,EAAE,OAAC,CAAA;KAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;;;;;UAMzD,YAAY;;;;;;0BAMb,oBAAoB,GAAG,mBAAmB,GAAG,uBAAuB,GAAG,yBAAyB,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,OAAO,8BAA8B,EAAE,OAAO"}

package/build/src/testing/factory/declarations.js

@@ -0,0 +1,98 @@
+// @ts-check
+/**
+ * A literal or lazy attribute (or transient) declaration. A function value is the
+ * lazy form and receives the evaluator context; any other value is a literal.
+ * @typedef {object} AttributeDeclaration
+ * @property {"attribute"} kind - Discriminant.
+ * @property {string} name - Attribute name.
+ * @property {boolean} isTransient - Whether the value is transient (never assigned/returned).
+ * @property {?} value - Literal value or lazy `(context) => value` function.
+ */
+/**
+ * A lifecycle callback declaration. The same declaration object reached through
+ * multiple trait paths runs once per record (dedup is by object identity).
+ * @typedef {object} CallbackDeclaration
+ * @property {"callback"} kind - Discriminant.
+ * @property {string} event - One of the supported callback events.
+ * @property {(args: {record: ?, context: ?, strategy: string}) => (void | Promise<void>)} fn - Callback body.
+ */
+/**
+ * A base-trait inclusion declaration (a trait applied by default within a factory
+ * or composed inside another trait).
+ * @typedef {object} TraitIncludeDeclaration
+ * @property {"traitInclude"} kind - Discriminant.
+ * @property {string} name - Referenced trait name.
+ */
+/**
+ * A custom-constructor declaration.
+ * @typedef {object} InitializeWithDeclaration
+ * @property {"initializeWith"} kind - Discriminant.
+ * @property {(args: {attributes: Record<string, ?>, context: ?, get: (name: string) => ?}) => (? | Promise<?>)} fn - Constructor body.
+ */
+/**
+ * A custom-persistence declaration.
+ * @typedef {object} ToCreateDeclaration
+ * @property {"toCreate"} kind - Discriminant.
+ * @property {(args: {record: ?, context: ?}) => (void | Promise<void>)} fn - Persistence body.
+ */
+/**
+ * A declaration that disables persistence entirely for the create strategy.
+ * @typedef {object} SkipCreateDeclaration
+ * @property {"skipCreate"} kind - Discriminant.
+ */
+/**
+ * Union of every declaration kind stored on a factory/trait definition. Includes
+ * association declarations imported from their own module.
+ * @typedef {AttributeDeclaration | CallbackDeclaration | TraitIncludeDeclaration | InitializeWithDeclaration | ToCreateDeclaration | SkipCreateDeclaration | import("./association-declaration.js").default} Declaration
+ */
+/**
+ * Creates a literal/lazy attribute declaration.
+ * @param {string} name - Attribute name.
+ * @param {?} value - Literal value or lazy function.
+ * @param {boolean} isTransient - Whether the declaration is transient.
+ * @returns {AttributeDeclaration} - The frozen declaration.
+ */
+export function attributeDeclaration(name, value, isTransient) {
+    return Object.freeze({ kind: "attribute", name, isTransient, value });
+}
+/**
+ * Creates a lifecycle callback declaration.
+ * @param {string} event - Callback event name.
+ * @param {CallbackDeclaration["fn"]} fn - Callback body.
+ * @returns {CallbackDeclaration} - The frozen declaration.
+ */
+export function callbackDeclaration(event, fn) {
+    return Object.freeze({ kind: "callback", event, fn });
+}
+/**
+ * Creates a base-trait inclusion declaration.
+ * @param {string} name - Referenced trait name.
+ * @returns {TraitIncludeDeclaration} - The frozen declaration.
+ */
+export function traitIncludeDeclaration(name) {
+    return Object.freeze({ kind: "traitInclude", name });
+}
+/**
+ * Creates a custom-constructor declaration.
+ * @param {InitializeWithDeclaration["fn"]} fn - Constructor body.
+ * @returns {InitializeWithDeclaration} - The frozen declaration.
+ */
+export function initializeWithDeclaration(fn) {
+    return Object.freeze({ kind: "initializeWith", fn });
+}
+/**
+ * Creates a custom-persistence declaration.
+ * @param {ToCreateDeclaration["fn"]} fn - Persistence body.
+ * @returns {ToCreateDeclaration} - The frozen declaration.
+ */
+export function toCreateDeclaration(fn) {
+    return Object.freeze({ kind: "toCreate", fn });
+}
+/**
+ * Creates a skip-create declaration.
+ * @returns {SkipCreateDeclaration} - The frozen declaration.
+ */
+export function skipCreateDeclaration() {
+    return Object.freeze({ kind: "skipCreate" });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVjbGFyYXRpb25zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3Rlc3RpbmcvZmFjdG9yeS9kZWNsYXJhdGlvbnMuanMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsWUFBWTtBQUVaOzs7Ozs7OztHQVFHO0FBRUg7Ozs7Ozs7R0FPRztBQUVIOzs7Ozs7R0FNRztBQUVIOzs7OztHQUtHO0FBRUg7Ozs7O0dBS0c7QUFFSDs7OztHQUlHO0FBRUg7Ozs7R0FJRztBQUVIOzs7Ozs7R0FNRztBQUNILE1BQU0sVUFBVSxvQkFBb0IsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLFdBQVc7SUFDM0QsT0FBTyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUMsSUFBSSxFQUFFLFdBQVcsRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLEtBQUssRUFBQyxDQUFDLENBQUE7QUFDckUsQ0FBQztBQUVEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLG1CQUFtQixDQUFDLEtBQUssRUFBRSxFQUFFO0lBQzNDLE9BQU8sTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFDLElBQUksRUFBRSxVQUFVLEVBQUUsS0FBSyxFQUFFLEVBQUUsRUFBQyxDQUFDLENBQUE7QUFDckQsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUsdUJBQXVCLENBQUMsSUFBSTtJQUMxQyxPQUFPLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBQyxJQUFJLEVBQUUsY0FBYyxFQUFFLElBQUksRUFBQyxDQUFDLENBQUE7QUFDcEQsQ0FBQztBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFVBQVUseUJBQXlCLENBQUMsRUFBRTtJQUMxQyxPQUFPLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBQyxJQUFJLEVBQUUsZ0JBQWdCLEVBQUUsRUFBRSxFQUFDLENBQUMsQ0FBQTtBQUNwRCxDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxtQkFBbUIsQ0FBQyxFQUFFO0lBQ3BDLE9BQU8sTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFDLElBQUksRUFBRSxVQUFVLEVBQUUsRUFBRSxFQUFDLENBQUMsQ0FBQTtBQUM5QyxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsTUFBTSxVQUFVLHFCQUFxQjtJQUNuQyxPQUFPLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBQyxJQUFJLEVBQUUsWUFBWSxFQUFDLENBQUMsQ0FBQTtBQUM1QyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gQHRzLWNoZWNrXG5cbi8qKlxuICogQSBsaXRlcmFsIG9yIGxhenkgYXR0cmlidXRlIChvciB0cmFuc2llbnQpIGRlY2xhcmF0aW9uLiBBIGZ1bmN0aW9uIHZhbHVlIGlzIHRoZVxuICogbGF6eSBmb3JtIGFuZCByZWNlaXZlcyB0aGUgZXZhbHVhdG9yIGNvbnRleHQ7IGFueSBvdGhlciB2YWx1ZSBpcyBhIGxpdGVyYWwuXG4gKiBAdHlwZWRlZiB7b2JqZWN0fSBBdHRyaWJ1dGVEZWNsYXJhdGlvblxuICogQHByb3BlcnR5IHtcImF0dHJpYnV0ZVwifSBraW5kIC0gRGlzY3JpbWluYW50LlxuICogQHByb3BlcnR5IHtzdHJpbmd9IG5hbWUgLSBBdHRyaWJ1dGUgbmFtZS5cbiAqIEBwcm9wZXJ0eSB7Ym9vbGVhbn0gaXNUcmFuc2llbnQgLSBXaGV0aGVyIHRoZSB2YWx1ZSBpcyB0cmFuc2llbnQgKG5ldmVyIGFzc2lnbmVkL3JldHVybmVkKS5cbiAqIEBwcm9wZXJ0eSB7P30gdmFsdWUgLSBMaXRlcmFsIHZhbHVlIG9yIGxhenkgYChjb250ZXh0KSA9PiB2YWx1ZWAgZnVuY3Rpb24uXG4gKi9cblxuLyoqXG4gKiBBIGxpZmVjeWNsZSBjYWxsYmFjayBkZWNsYXJhdGlvbi4gVGhlIHNhbWUgZGVjbGFyYXRpb24gb2JqZWN0IHJlYWNoZWQgdGhyb3VnaFxuICogbXVsdGlwbGUgdHJhaXQgcGF0aHMgcnVucyBvbmNlIHBlciByZWNvcmQgKGRlZHVwIGlzIGJ5IG9iamVjdCBpZGVudGl0eSkuXG4gKiBAdHlwZWRlZiB7b2JqZWN0fSBDYWxsYmFja0RlY2xhcmF0aW9uXG4gKiBAcHJvcGVydHkge1wiY2FsbGJhY2tcIn0ga2luZCAtIERpc2NyaW1pbmFudC5cbiAqIEBwcm9wZXJ0eSB7c3RyaW5nfSBldmVudCAtIE9uZSBvZiB0aGUgc3VwcG9ydGVkIGNhbGxiYWNrIGV2ZW50cy5cbiAqIEBwcm9wZXJ0eSB7KGFyZ3M6IHtyZWNvcmQ6ID8sIGNvbnRleHQ6ID8sIHN0cmF0ZWd5OiBzdHJpbmd9KSA9PiAodm9pZCB8IFByb21pc2U8dm9pZD4pfSBmbiAtIENhbGxiYWNrIGJvZHkuXG4gKi9cblxuLyoqXG4gKiBBIGJhc2UtdHJhaXQgaW5jbHVzaW9uIGRlY2xhcmF0aW9uIChhIHRyYWl0IGFwcGxpZWQgYnkgZGVmYXVsdCB3aXRoaW4gYSBmYWN0b3J5XG4gKiBvciBjb21wb3NlZCBpbnNpZGUgYW5vdGhlciB0cmFpdCkuXG4gKiBAdHlwZWRlZiB7b2JqZWN0fSBUcmFpdEluY2x1ZGVEZWNsYXJhdGlvblxuICogQHByb3BlcnR5IHtcInRyYWl0SW5jbHVkZVwifSBraW5kIC0gRGlzY3JpbWluYW50LlxuICogQHByb3BlcnR5IHtzdHJpbmd9IG5hbWUgLSBSZWZlcmVuY2VkIHRyYWl0IG5hbWUuXG4gKi9cblxuLyoqXG4gKiBBIGN1c3RvbS1jb25zdHJ1Y3RvciBkZWNsYXJhdGlvbi5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IEluaXRpYWxpemVXaXRoRGVjbGFyYXRpb25cbiAqIEBwcm9wZXJ0eSB7XCJpbml0aWFsaXplV2l0aFwifSBraW5kIC0gRGlzY3JpbWluYW50LlxuICogQHByb3BlcnR5IHsoYXJnczoge2F0dHJpYnV0ZXM6IFJlY29yZDxzdHJpbmcsID8+LCBjb250ZXh0OiA/LCBnZXQ6IChuYW1lOiBzdHJpbmcpID0+ID99KSA9PiAoPyB8IFByb21pc2U8Pz4pfSBmbiAtIENvbnN0cnVjdG9yIGJvZHkuXG4gKi9cblxuLyoqXG4gKiBBIGN1c3RvbS1wZXJzaXN0ZW5jZSBkZWNsYXJhdGlvbi5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IFRvQ3JlYXRlRGVjbGFyYXRpb25cbiAqIEBwcm9wZXJ0eSB7XCJ0b0NyZWF0ZVwifSBraW5kIC0gRGlzY3JpbWluYW50LlxuICogQHByb3BlcnR5IHsoYXJnczoge3JlY29yZDogPywgY29udGV4dDogP30pID0+ICh2b2lkIHwgUHJvbWlzZTx2b2lkPil9IGZuIC0gUGVyc2lzdGVuY2UgYm9keS5cbiAqL1xuXG4vKipcbiAqIEEgZGVjbGFyYXRpb24gdGhhdCBkaXNhYmxlcyBwZXJzaXN0ZW5jZSBlbnRpcmVseSBmb3IgdGhlIGNyZWF0ZSBzdHJhdGVneS5cbiAqIEB0eXBlZGVmIHtvYmplY3R9IFNraXBDcmVhdGVEZWNsYXJhdGlvblxuICogQHByb3BlcnR5IHtcInNraXBDcmVhdGVcIn0ga2luZCAtIERpc2NyaW1pbmFudC5cbiAqL1xuXG4vKipcbiAqIFVuaW9uIG9mIGV2ZXJ5IGRlY2xhcmF0aW9uIGtpbmQgc3RvcmVkIG9uIGEgZmFjdG9yeS90cmFpdCBkZWZpbml0aW9uLiBJbmNsdWRlc1xuICogYXNzb2NpYXRpb24gZGVjbGFyYXRpb25zIGltcG9ydGVkIGZyb20gdGhlaXIgb3duIG1vZHVsZS5cbiAqIEB0eXBlZGVmIHtBdHRyaWJ1dGVEZWNsYXJhdGlvbiB8IENhbGxiYWNrRGVjbGFyYXRpb24gfCBUcmFpdEluY2x1ZGVEZWNsYXJhdGlvbiB8IEluaXRpYWxpemVXaXRoRGVjbGFyYXRpb24gfCBUb0NyZWF0ZURlY2xhcmF0aW9uIHwgU2tpcENyZWF0ZURlY2xhcmF0aW9uIHwgaW1wb3J0KFwiLi9hc3NvY2lhdGlvbi1kZWNsYXJhdGlvbi5qc1wiKS5kZWZhdWx0fSBEZWNsYXJhdGlvblxuICovXG5cbi8qKlxuICogQ3JlYXRlcyBhIGxpdGVyYWwvbGF6eSBhdHRyaWJ1dGUgZGVjbGFyYXRpb24uXG4gKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIEF0dHJpYnV0ZSBuYW1lLlxuICogQHBhcmFtIHs/fSB2YWx1ZSAtIExpdGVyYWwgdmFsdWUgb3IgbGF6eSBmdW5jdGlvbi5cbiAqIEBwYXJhbSB7Ym9vbGVhbn0gaXNUcmFuc2llbnQgLSBXaGV0aGVyIHRoZSBkZWNsYXJhdGlvbiBpcyB0cmFuc2llbnQuXG4gKiBAcmV0dXJucyB7QXR0cmlidXRlRGVjbGFyYXRpb259IC0gVGhlIGZyb3plbiBkZWNsYXJhdGlvbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGF0dHJpYnV0ZURlY2xhcmF0aW9uKG5hbWUsIHZhbHVlLCBpc1RyYW5zaWVudCkge1xuICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7a2luZDogXCJhdHRyaWJ1dGVcIiwgbmFtZSwgaXNUcmFuc2llbnQsIHZhbHVlfSlcbn1cblxuLyoqXG4gKiBDcmVhdGVzIGEgbGlmZWN5Y2xlIGNhbGxiYWNrIGRlY2xhcmF0aW9uLlxuICogQHBhcmFtIHtzdHJpbmd9IGV2ZW50IC0gQ2FsbGJhY2sgZXZlbnQgbmFtZS5cbiAqIEBwYXJhbSB7Q2FsbGJhY2tEZWNsYXJhdGlvbltcImZuXCJdfSBmbiAtIENhbGxiYWNrIGJvZHkuXG4gKiBAcmV0dXJucyB7Q2FsbGJhY2tEZWNsYXJhdGlvbn0gLSBUaGUgZnJvemVuIGRlY2xhcmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gY2FsbGJhY2tEZWNsYXJhdGlvbihldmVudCwgZm4pIHtcbiAgcmV0dXJuIE9iamVjdC5mcmVlemUoe2tpbmQ6IFwiY2FsbGJhY2tcIiwgZXZlbnQsIGZufSlcbn1cblxuLyoqXG4gKiBDcmVhdGVzIGEgYmFzZS10cmFpdCBpbmNsdXNpb24gZGVjbGFyYXRpb24uXG4gKiBAcGFyYW0ge3N0cmluZ30gbmFtZSAtIFJlZmVyZW5jZWQgdHJhaXQgbmFtZS5cbiAqIEByZXR1cm5zIHtUcmFpdEluY2x1ZGVEZWNsYXJhdGlvbn0gLSBUaGUgZnJvemVuIGRlY2xhcmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdHJhaXRJbmNsdWRlRGVjbGFyYXRpb24obmFtZSkge1xuICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7a2luZDogXCJ0cmFpdEluY2x1ZGVcIiwgbmFtZX0pXG59XG5cbi8qKlxuICogQ3JlYXRlcyBhIGN1c3RvbS1jb25zdHJ1Y3RvciBkZWNsYXJhdGlvbi5cbiAqIEBwYXJhbSB7SW5pdGlhbGl6ZVdpdGhEZWNsYXJhdGlvbltcImZuXCJdfSBmbiAtIENvbnN0cnVjdG9yIGJvZHkuXG4gKiBAcmV0dXJucyB7SW5pdGlhbGl6ZVdpdGhEZWNsYXJhdGlvbn0gLSBUaGUgZnJvemVuIGRlY2xhcmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gaW5pdGlhbGl6ZVdpdGhEZWNsYXJhdGlvbihmbikge1xuICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7a2luZDogXCJpbml0aWFsaXplV2l0aFwiLCBmbn0pXG59XG5cbi8qKlxuICogQ3JlYXRlcyBhIGN1c3RvbS1wZXJzaXN0ZW5jZSBkZWNsYXJhdGlvbi5cbiAqIEBwYXJhbSB7VG9DcmVhdGVEZWNsYXJhdGlvbltcImZuXCJdfSBmbiAtIFBlcnNpc3RlbmNlIGJvZHkuXG4gKiBAcmV0dXJucyB7VG9DcmVhdGVEZWNsYXJhdGlvbn0gLSBUaGUgZnJvemVuIGRlY2xhcmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdG9DcmVhdGVEZWNsYXJhdGlvbihmbikge1xuICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7a2luZDogXCJ0b0NyZWF0ZVwiLCBmbn0pXG59XG5cbi8qKlxuICogQ3JlYXRlcyBhIHNraXAtY3JlYXRlIGRlY2xhcmF0aW9uLlxuICogQHJldHVybnMge1NraXBDcmVhdGVEZWNsYXJhdGlvbn0gLSBUaGUgZnJvemVuIGRlY2xhcmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gc2tpcENyZWF0ZURlY2xhcmF0aW9uKCkge1xuICByZXR1cm4gT2JqZWN0LmZyZWV6ZSh7a2luZDogXCJza2lwQ3JlYXRlXCJ9KVxufVxuIl19

package/build/src/testing/factory/definition-builder.d.ts

@@ -0,0 +1,132 @@
+/**
+ * A single `define`/`modify` session. It walks the builder callbacks, compiles
+ * immutable definitions and registers them into the target registry, throwing on
+ * duplicate or structurally invalid declarations at definition time.
+ */
+export default class DefinitionSession {
+    /**
+     * Builds a session.
+     * @param {import("./factory-registry.js").default} registry - Target registry.
+     */
+    constructor(registry: import("./factory-registry.js").default);
+    /** @type {import("./factory-registry.js").default} - Target registry. */
+    registry: import("./factory-registry.js").default;
+    /**
+     * Runs a root `define` callback.
+     * @param {(builder: object) => void} callback - Root builder callback.
+     * @returns {void}
+     */
+    run(callback: (builder: object) => void): void;
+    /**
+     * Runs a `modify` callback that reopens existing factories to append/override
+     * declarations, recompiling each into a fresh immutable definition rather than
+     * mutating the original.
+     * @param {(builder: object) => void} callback - Modify builder callback.
+     * @returns {void}
+     */
+    runModify(callback: (builder: object) => void): void;
+    /**
+     * Builds the builder object exposed to `modify`.
+     * @returns {object} - Modify builder.
+     */
+    _modifyBuilder(): object;
+    /**
+     * Recompiles an existing factory with appended declarations.
+     * @param {string} name - Existing factory name.
+     * @param {(builder: object) => void} cb - Factory builder callback.
+     * @returns {void}
+     */
+    _modifyFactory(name: string, cb: (builder: object) => void): void;
+    /**
+     * Builds the root builder object exposed to `define`.
+     * @returns {object} - Root builder.
+     */
+    _rootBuilder(): object;
+    /**
+     * Compiles and registers a factory (and its nested children/local traits/scoped
+     * sequences).
+     * @param {string} name - Factory name.
+     * @param {?} modelOrOptions - Model class or options object.
+     * @param {?} cb - Factory builder callback.
+     * @param {string | null} inheritedParent - Parent name for nested factories.
+     * @returns {void}
+     */
+    _defineFactory(name: string, modelOrOptions: unknown, cb: unknown, inheritedParent: string | null): void;
+    /**
+     * Builds the factory builder object.
+     * @param {DeclarationCollector} collector - Declaration collector.
+     * @param {Array<{name: string, modelOrOptions: ?, cb: ?}>} nestedFactories - Nested factory sink.
+     * @param {Map<string, TraitDefinition>} localTraits - Local trait sink.
+     * @param {Sequence[]} scopedSequences - Scoped sequence sink.
+     * @returns {object} - Factory builder.
+     */
+    _factoryBuilder(collector: DeclarationCollector, nestedFactories: Array<{
+        name: string;
+        modelOrOptions: unknown;
+        cb: unknown;
+    }>, localTraits: Map<string, TraitDefinition>, scopedSequences: Sequence[]): object;
+}
+/**
+ * Collects declarations for one factory/trait block. Shared by factory blocks,
+ * trait blocks and the root registry-defaults block.
+ */
+declare class DeclarationCollector {
+    /** @type {import("./declarations.js").Declaration[]} - Ordered declarations. */
+    declarations: import("./declarations.js").Declaration[];
+    /**
+     * Records a literal/lazy attribute.
+     * @param {string} name - Attribute name.
+     * @param {?} value - Literal value or lazy function.
+     * @returns {void}
+     */
+    attribute(name: string, value: unknown): void;
+    /**
+     * Records a transient attribute.
+     * @param {string} name - Transient name.
+     * @param {?} value - Literal value or lazy function.
+     * @returns {void}
+     */
+    transient(name: string, value: unknown): void;
+    /**
+     * Records an association.
+     * @param {string} name - Relationship name.
+     * @param {Array<?>} args - Traits and/or an options object.
+     * @returns {void}
+     */
+    association(name: string, ...args: Array<unknown>): void;
+    /**
+     * Records a before-callback.
+     * @param {string} phase - Phase (all/build/create).
+     * @param {import("./declarations.js").CallbackDeclaration["fn"]} fn - Callback body.
+     * @returns {void}
+     */
+    before(phase: string, fn: import("./declarations.js").CallbackDeclaration["fn"]): void;
+    /**
+     * Records an after-callback.
+     * @param {string} phase - Phase (all/build/create).
+     * @param {import("./declarations.js").CallbackDeclaration["fn"]} fn - Callback body.
+     * @returns {void}
+     */
+    after(phase: string, fn: import("./declarations.js").CallbackDeclaration["fn"]): void;
+    /**
+     * Records a custom constructor.
+     * @param {import("./declarations.js").InitializeWithDeclaration["fn"]} fn - Constructor body.
+     * @returns {void}
+     */
+    initializeWith(fn: import("./declarations.js").InitializeWithDeclaration["fn"]): void;
+    /**
+     * Records a custom persistence hook.
+     * @param {import("./declarations.js").ToCreateDeclaration["fn"]} fn - Persistence body.
+     * @returns {void}
+     */
+    toCreate(fn: import("./declarations.js").ToCreateDeclaration["fn"]): void;
+    /**
+     * Records that persistence should be skipped for the create strategy.
+     * @returns {void}
+     */
+    skipCreate(): void;
+}
+import TraitDefinition from "./trait-definition.js";
+import Sequence from "./sequence.js";
+export {};
+//# sourceMappingURL=definition-builder.d.ts.map

package/build/src/testing/factory/definition-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-builder.d.ts","sourceRoot":"","sources":["../../../../src/testing/factory/definition-builder.js"],"names":[],"mappings":"AA0OA;;;;GAIG;AACH;IACE;;;OAGG;IACH,sBAFW,OAAO,uBAAuB,EAAE,OAAO,EAKjD;IAFC,yEAAyE;IACzE,UADW,OAAO,uBAAuB,EAAE,OAAO,CAC1B;IAG1B;;;;OAIG;IACH,cAHW,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACvB,IAAI,CAQhB;IAED;;;;;;OAMG;IACH,oBAHW,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACvB,IAAI,CAQhB;IAED;;;OAGG;IACH,kBAFa,MAAM,CAiBlB;IAED;;;;;OAKG;IACH,qBAJW,MAAM,MACN,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACvB,IAAI,CAwChB;IAED;;;OAGG;IACH,gBAFa,MAAM,CAkBlB;IAED;;;;;;;;OAQG;IACH,qBANW,MAAM,kBACN,OAAC,MACD,OAAC,mBACD,MAAM,GAAG,IAAI,GACX,IAAI,CA+DhB;IAED;;;;;;;OAOG;IACH,2BANW,oBAAoB,mBACpB,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAC,CAAC;QAAC,EAAE,EAAE,OAAC,CAAA;KAAC,CAAC,eAC/C,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,mBAC5B,QAAQ,EAAE,GACR,MAAM,CA8BlB;CACF;AA9WD;;;GAGG;AACH;IAGI,gFAAgF;IAChF,cADW,OAAO,mBAAmB,EAAE,WAAW,EAAE,CAC9B;IAGxB;;;;;OAKG;IACH,gBAJW,MAAM,SACN,OAAC,GACC,IAAI,CAKhB;IAED;;;;;OAKG;IACH,gBAJW,MAAM,SACN,OAAC,GACC,IAAI,CAKhB;IAED;;;;;OAKG;IACH,kBAJW,MAAM,WACN,KAAK,CAAC,OAAC,CAAC,GACN,IAAI,CAKhB;IAED;;;;;OAKG;IACH,cAJW,MAAM,MACN,OAAO,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,CAAC,GACnD,IAAI,CAIhB;IAED;;;;;OAKG;IACH,aAJW,MAAM,MACN,OAAO,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,CAAC,GACnD,IAAI,CAIhB;IAED;;;;OAIG;IACH,mBAHW,OAAO,mBAAmB,EAAE,yBAAyB,CAAC,IAAI,CAAC,GACzD,IAAI,CAIhB;IAED;;;;OAIG;IACH,aAHW,OAAO,mBAAmB,EAAE,mBAAmB,CAAC,IAAI,CAAC,GACnD,IAAI,CAIhB;IAED;;;OAGG;IACH,cAFa,IAAI,CAIhB;CACF;4BAvL2B,uBAAuB;qBAD9B,eAAe"}