velocious 1.0.552 → 1.0.555

package/build/src/testing/factory/factory-registry.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Owns all factories, traits, sequences, callbacks and construction defaults for
+ * one isolated scope, and exposes the strategy entry points. Registry mutation is
+ * setup-time only and is rejected while evaluations are active.
+ */
+export default class FactoryRegistry {
+    /** @type {Map<string, import("./factory-definition.js").default>} - Factories and aliases. */
+    _factories: Map<string, import("./factory-definition.js").default>;
+    /** @type {Map<string, import("./trait-definition.js").default>} - Global traits. */
+    _globalTraits: Map<string, import("./trait-definition.js").default>;
+    /** @type {Map<string, import("./sequence.js").default>} - Global sequences and aliases. */
+    _sequences: Map<string, import("./sequence.js").default>;
+    /** @type {Map<string, Map<string, import("./sequence.js").default>>} - Factory-scoped sequences. */
+    _factorySequences: Map<string, Map<string, import("./sequence.js").default>>;
+    /** @type {import("./declarations.js").Declaration[]} - Registry-level default declarations. */
+    _globalDeclarations: import("./declarations.js").Declaration[];
+    /** @type {number} - In-flight evaluation count (mutation guard). */
+    _activeEvaluations: number;
+    /** @type {FactoryRunner} - Plan compiler. */
+    _runner: FactoryRunner;
+    /** @type {FactoryEventEmitter} - Debug/performance event emitter. */
+    _events: FactoryEventEmitter;
+    /** @type {{attributesFor: AttributesForStrategy, build: BuildStrategy, create: CreateStrategy}} - Installed strategies. */
+    _strategies: {
+        attributesFor: AttributesForStrategy;
+        build: BuildStrategy;
+        create: CreateStrategy;
+    };
+    /**
+     * Registers factories/traits/sequences/callbacks via a builder callback.
+     * @param {(builder: object) => void} callback - The definition callback.
+     * @returns {this} - This registry (for chaining).
+     */
+    define(callback: (builder: object) => void): this;
+    /**
+     * Reopens existing factories to append/override declarations, recompiling each
+     * into a fresh immutable definition. Rejected while evaluations are active.
+     * @param {(builder: object) => void} callback - The modify callback.
+     * @returns {this} - This registry (for chaining).
+     */
+    modify(callback: (builder: object) => void): this;
+    /**
+     * Lints factories/traits, aggregating every failure. Create-strategy cases roll
+     * back their database writes.
+     * @param {object} [options] - Lint options (factories, traits, strategy).
+     * @returns {Promise<void>} - Resolves when all cases pass; rejects with an aggregate otherwise.
+     */
+    lint(options?: object): Promise<void>;
+    /**
+     * Subscribes to factory debug events (`start`, `success`, `failure`).
+     * @param {string} event - Event name.
+     * @param {(payload: {invocationId: string, factory: string, strategy: string, traits: string[], durationMs?: number, error?: ?}) => void} handler - Event handler.
+     * @returns {this} - This registry (for chaining).
+     */
+    on(event: string, handler: (payload: {
+        invocationId: string;
+        factory: string;
+        strategy: string;
+        traits: string[];
+        durationMs?: number;
+        error?: unknown;
+    }) => void): this;
+    /**
+     * Unsubscribes a previously-registered event handler.
+     * @param {string} event - Event name.
+     * @param {(payload: ?) => void} handler - Event handler to remove.
+     * @returns {this} - This registry (for chaining).
+     */
+    off(event: string, handler: (payload: unknown) => void): this;
+    /**
+     * Resolves attributes without constructing a model or building associations.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Record<string, ?>>} - The resolved attributes.
+     */
+    attributesFor(factoryName: string, ...args: Array<unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Builds an unsaved record graph.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<?>} - The built record.
+     */
+    build(factoryName: string, ...args: Array<unknown>): Promise<unknown>;
+    /**
+     * Builds and persists a record graph.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<?>} - The persisted record.
+     */
+    create(factoryName: string, ...args: Array<unknown>): Promise<unknown>;
+    /**
+     * Resolves attributes for a list of records sequentially.
+     * @param {string} factoryName - Factory name.
+     * @param {number} count - Number of entries.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<Record<string, ?>>>} - The resolved attribute objects.
+     */
+    attributesForList(factoryName: string, count: number, ...args: Array<unknown>): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Builds a list of unsaved records sequentially.
+     * @param {string} factoryName - Factory name.
+     * @param {number} count - Number of records.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<?>>} - The built records.
+     */
+    buildList(factoryName: string, count: number, ...args: Array<unknown>): Promise<Array<unknown>>;
+    /**
+     * Creates a list of persisted records sequentially.
+     * @param {string} factoryName - Factory name.
+     * @param {number} count - Number of records.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<?>>} - The persisted records.
+     */
+    createList(factoryName: string, count: number, ...args: Array<unknown>): Promise<Array<unknown>>;
+    /**
+     * Resolves attributes for exactly two records.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<Record<string, ?>>>} - The two resolved attribute objects.
+     */
+    attributesForPair(factoryName: string, ...args: Array<unknown>): Promise<Array<Record<string, unknown>>>;
+    /**
+     * Builds exactly two unsaved records.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<?>>} - The two built records.
+     */
+    buildPair(factoryName: string, ...args: Array<unknown>): Promise<Array<unknown>>;
+    /**
+     * Creates exactly two persisted records.
+     * @param {string} factoryName - Factory name.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<?>>} - The two persisted records.
+     */
+    createPair(factoryName: string, ...args: Array<unknown>): Promise<Array<unknown>>;
+    /**
+     * Advances a sequence and returns its formatted value.
+     * @param {string} sequenceName - Sequence name.
+     * @returns {Promise<?>} - The formatted value.
+     */
+    generate(sequenceName: string): Promise<unknown>;
+    /**
+     * Advances a sequence `count` times and returns the formatted values.
+     * @param {string} sequenceName - Sequence name.
+     * @param {number} count - Number of values.
+     * @returns {Promise<Array<?>>} - The formatted values.
+     */
+    generateList(sequenceName: string, count: number): Promise<Array<unknown>>;
+    /**
+     * Returns the next raw value a global sequence would allocate without consuming it.
+     * @param {string} sequenceName - Sequence name.
+     * @returns {number} - The upcoming raw value.
+     */
+    peekSequence(sequenceName: string): number;
+    /**
+     * Sets the next value a global sequence will allocate.
+     * @param {string} sequenceName - Sequence name.
+     * @param {number} value - Next raw value.
+     * @returns {void}
+     */
+    setSequence(sequenceName: string, value: number): void;
+    /**
+     * Rewinds a single global sequence to its initial value.
+     * @param {string} sequenceName - Sequence name.
+     * @returns {void}
+     */
+    rewindSequence(sequenceName: string): void;
+    /**
+     * Rewinds every global and factory-scoped sequence to its initial value while
+     * leaving all definitions intact.
+     * @returns {void}
+     */
+    rewindSequences(): void;
+    /**
+     * Clears all definitions, traits, sequences and registry defaults, restoring an
+     * empty registry with the built-in strategies.
+     * @returns {void}
+     */
+    reset(): void;
+    /**
+     * Runs `count` sequential strategy invocations.
+     * @param {"attributesFor" | "build" | "create"} strategy - Strategy name.
+     * @param {string} factoryName - Factory name.
+     * @param {number} count - Number of entries.
+     * @param {Array<?>} args - Trait names then an optional overrides object.
+     * @returns {Promise<Array<?>>} - The results.
+     */
+    _runList(strategy: "attributesFor" | "build" | "create", factoryName: string, count: number, args: Array<unknown>): Promise<Array<unknown>>;
+    /**
+     * Compiles and runs a factory invocation under a strategy, tracking active
+     * evaluations for the mutation guard.
+     * @param {object} args - Options.
+     * @param {string} args.factoryName - Factory name.
+     * @param {string[]} args.traits - Ordered traits.
+     * @param {Record<string, ?>} args.overrides - Overrides.
+     * @param {"attributesFor" | "build" | "create"} args.strategy - Strategy name.
+     * @returns {Promise<?>} - The strategy result.
+     */
+    _runFactory({ factoryName, traits, overrides, strategy }: {
+        factoryName: string;
+        traits: string[];
+        overrides: Record<string, unknown>;
+        strategy: "attributesFor" | "build" | "create";
+    }): Promise<unknown>;
+    /**
+     * Registers an immutable factory definition and its aliases.
+     * @param {import("./factory-definition.js").default} definition - Compiled factory.
+     * @returns {void}
+     */
+    _registerFactoryDefinition(definition: import("./factory-definition.js").default): void;
+    /**
+     * Replaces an existing factory definition (and its aliases) with a recompiled
+     * one. Used by `modify`; no duplicate check because it intentionally overwrites.
+     * @param {import("./factory-definition.js").default} definition - Recompiled factory.
+     * @returns {void}
+     */
+    _replaceFactoryDefinition(definition: import("./factory-definition.js").default): void;
+    /**
+     * Registers a global trait.
+     * @param {import("./trait-definition.js").default} trait - Compiled trait.
+     * @returns {void}
+     */
+    _registerGlobalTrait(trait: import("./trait-definition.js").default): void;
+    /**
+     * Registers a sequence (and its aliases) either globally or under a factory scope.
+     * @param {import("./sequence.js").default} sequence - Sequence instance.
+     * @param {string | null} factoryScope - Factory name to scope under, or null for global.
+     * @returns {void}
+     */
+    _registerSequence(sequence: import("./sequence.js").default, factoryScope: string | null): void;
+    /**
+     * Appends a registry-level default declaration (callbacks/construction defaults).
+     * @param {import("./declarations.js").Declaration} declaration - Declaration to add.
+     * @returns {void}
+     */
+    _addGlobalDeclaration(declaration: import("./declarations.js").Declaration): void;
+    /**
+     * Resolves a sequence name against a factory scope chain (child first) then the
+     * global scope and advances it.
+     * @param {string} sequenceName - Sequence name.
+     * @param {string[]} chainNames - Inheritance chain names (child last).
+     * @returns {Promise<?>} - The formatted value.
+     */
+    _generateScoped(sequenceName: string, chainNames: string[]): Promise<unknown>;
+    /**
+     * Resolves a global sequence by name.
+     * @param {string} sequenceName - Sequence name.
+     * @returns {import("./sequence.js").default} - The sequence.
+     */
+    _resolveGlobalSequence(sequenceName: string): import("./sequence.js").default;
+    /**
+     * Rejects setup-time mutation while evaluations are active.
+     * @param {string} operation - Operation name, for the error message.
+     * @returns {void}
+     */
+    _assertNotEvaluating(operation: string): void;
+}
+import FactoryRunner from "./factory-runner.js";
+import FactoryEventEmitter from "./events.js";
+import AttributesForStrategy from "./strategies/attributes-for.js";
+import BuildStrategy from "./strategies/build.js";
+import CreateStrategy from "./strategies/create.js";
+//# sourceMappingURL=factory-registry.d.ts.map

package/build/src/testing/factory/factory-registry.d.ts.map

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