@webda/mock 4.0.0-beta.3

package/lib/engine/generate.js

@@ -0,0 +1,171 @@
+import { readMockMeta } from "@webda/models";
+import { makeFaker } from "./faker.js";
+import { SessionPool } from "./pool.js";
+import { inferKind } from "./infer.js";
+/**
+ * Generate `count` instances of `ModelClass`, resolving each field through the
+ * fallback chain (explicit `@Mock.*` → name-heuristic → type fallback → throw/skip).
+ *
+ * @param ModelClass - the target model constructor.
+ * @param options - generation options (count, seed, mode, overrides, ai, pool, strict).
+ * @returns the generated instances.
+ */
+export async function generate(ModelClass, options = {}) {
+    const count = options.count ?? 1;
+    const mode = options.mode ?? (process.env.VITEST ? "test" : "dev");
+    const seedDefault = mode === "test" ? 0 : Date.now();
+    const seed = options.seed ?? seedDefault;
+    const faker = makeFaker(seed);
+    const rng = () => faker.number.float({ min: 0, max: 1 });
+    const pool = options.pool ?? new SessionPool(rng);
+    const metaMap = readMockMeta(ModelClass);
+    const aiFn = async (prompt, opts) => {
+        if (!options.ai)
+            throw new Error("generate: no AIProvider configured for an @Mock.ai field");
+        return options.ai.complete(prompt, opts);
+    };
+    // Determine the full field set by:
+    // 1. Own enumerable keys on a fresh instance (regular class fields).
+    // 2. Getter/setter pairs on the prototype chain (auto-accessor fields created with `accessor` keyword).
+    // 3. Any field names stashed in the @Mock decorator metadata map.
+    const probe = new ModelClass();
+    const protoFieldNames = new Set();
+    let proto = Object.getPrototypeOf(probe);
+    while (proto && proto !== Object.prototype) {
+        for (const key of Object.getOwnPropertyNames(proto)) {
+            if (key === "constructor")
+                continue;
+            const desc = Object.getOwnPropertyDescriptor(proto, key);
+            if (desc && typeof desc.get === "function" && typeof desc.set === "function") {
+                protoFieldNames.add(key);
+            }
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    const fieldNames = new Set([...Object.keys(probe), ...protoFieldNames, ...Object.keys(metaMap)]);
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        const instance = new ModelClass();
+        for (const fieldName of fieldNames) {
+            if (options.overrides && fieldName in options.overrides) {
+                instance[fieldName] = options.overrides[fieldName];
+                continue;
+            }
+            const meta = metaMap[fieldName];
+            const ctx = {
+                faker,
+                rng,
+                ai: aiFn,
+                pool,
+                index: i,
+                total: count,
+                model: ModelClass,
+                fieldName
+            };
+            let kind = meta?.kind ?? null;
+            const opts = meta?.options ?? {};
+            if (!kind && !options.strict) {
+                kind = inferKind({
+                    fieldName,
+                    declaredType: typeof instance[fieldName]
+                });
+            }
+            if (!kind) {
+                if (options.strict) {
+                    throw new Error(`generate: no @Mock decorator or inference rule for field "${fieldName}"`);
+                }
+                continue;
+            }
+            if (kind === "ai" && mode === "test") {
+                throw new Error(`generate: mode="test" forbids @Mock.ai (field "${fieldName}")`);
+            }
+            instance[fieldName] = await resolveKind(kind, opts, ctx);
+        }
+        out.push(instance);
+        pool.add(instance);
+    }
+    return out;
+}
+/**
+ * Route a resolved kind to its Faker / AI / custom generator.
+ *
+ * @param kind - the `MockKind` to produce.
+ * @param opts - decorator-time options for that kind.
+ * @param ctx - the mock context (faker, rng, pool, etc.).
+ * @returns the generated value.
+ */
+async function resolveKind(kind, opts, ctx) {
+    const f = ctx.faker;
+    switch (kind) {
+        case "uuid":
+            return f.string.uuid();
+        case "email":
+            return f.internet.email();
+        case "firstName":
+            return f.person.firstName();
+        case "lastName":
+            return f.person.lastName();
+        case "fullName":
+            return f.person.fullName();
+        case "phone":
+            return f.phone.number();
+        case "url":
+            return f.internet.url();
+        case "avatar":
+            return f.image.avatar();
+        case "word":
+            return f.word.sample();
+        case "percentage":
+            return f.number.int({ min: 0, max: 100 });
+        case "recentDate":
+            return f.date.recent();
+        case "lorem": {
+            const o = opts;
+            if (o.paragraphs !== undefined)
+                return f.lorem.paragraphs(o.paragraphs);
+            if (o.sentences !== undefined)
+                return f.lorem.sentences(o.sentences);
+            return f.lorem.words(o.words ?? 3);
+        }
+        case "integer": {
+            const o = opts;
+            return f.number.int({ min: o.min ?? 0, max: o.max ?? 100 });
+        }
+        case "float": {
+            const o = opts;
+            return f.number.float({ min: o.min ?? 0, max: o.max ?? 100 });
+        }
+        case "pastDate": {
+            const within = opts.within ?? "year";
+            const years = within === "year" ? 1 : within === "month" ? 1 / 12 : within === "week" ? 1 / 52 : 1 / 365;
+            return f.date.past({ years });
+        }
+        case "futureDate": {
+            const within = opts.within ?? "year";
+            const years = within === "year" ? 1 : within === "month" ? 1 / 12 : within === "week" ? 1 / 52 : 1 / 365;
+            return f.date.future({ years });
+        }
+        case "pick": {
+            const values = opts.values;
+            return values[Math.floor(ctx.rng() * values.length)];
+        }
+        case "boolean":
+            return ctx.rng() < 0.5;
+        case "custom": {
+            const fn = opts.fn;
+            return fn(ctx);
+        }
+        case "ai": {
+            const o = opts;
+            return ctx.ai(o.prompt, { maxTokens: o.maxTokens });
+        }
+        case "count":
+        case "linkExisting":
+        case "linkNew":
+            // Relation kinds are handled by generateGraph, not here.
+            return undefined;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=generate.js.map

package/lib/engine/generate.js.map

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

package/lib/engine/graph.d.ts

@@ -0,0 +1,22 @@
+import { type GenerateOptions } from "./generate.js";
+type ModelClass<T> = new (...args: any[]) => T;
+/**
+ * Generate instances of multiple models in the order given, reusing the same
+ * seeded RNG and session pool so that later models can reference earlier
+ * instances (when/if the callers' models support @ModelLink / @ModelRelated
+ * style fields resolving against the pool).
+ *
+ * For v1 the order is the caller-declared `options.models` order. A future
+ * version may add a topological-sort step based on declared relations.
+ *
+ * @param spec - { ModelName: count }
+ * @param options - shared generation options plus the model classes in the
+ *   order they should be generated.
+ * @returns a map of model name → generated instances (empty array for models
+ *   not listed in `spec`).
+ */
+export declare function generateGraph(spec: Record<string, number>, options?: GenerateOptions & {
+    models: ModelClass<unknown>[];
+}): Promise<Record<string, unknown[]>>;
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/lib/engine/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/engine/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAG/D,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,GAAE,eAAe,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAA;CAAmB,GAC5E,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAkBpC"}

package/lib/engine/graph.js

@@ -0,0 +1,37 @@
+import { SessionPool } from "./pool.js";
+import { generate } from "./generate.js";
+import { makeFaker } from "./faker.js";
+/**
+ * Generate instances of multiple models in the order given, reusing the same
+ * seeded RNG and session pool so that later models can reference earlier
+ * instances (when/if the callers' models support @ModelLink / @ModelRelated
+ * style fields resolving against the pool).
+ *
+ * For v1 the order is the caller-declared `options.models` order. A future
+ * version may add a topological-sort step based on declared relations.
+ *
+ * @param spec - { ModelName: count }
+ * @param options - shared generation options plus the model classes in the
+ *   order they should be generated.
+ * @returns a map of model name → generated instances (empty array for models
+ *   not listed in `spec`).
+ */
+export async function generateGraph(spec, options = { models: [] }) {
+    const mode = options.mode ?? (process.env.VITEST ? "test" : "dev");
+    const seed = options.seed ?? (mode === "test" ? 0 : Date.now());
+    const faker = makeFaker(seed);
+    const rng = () => faker.number.float({ min: 0, max: 1 });
+    const pool = options.pool ?? new SessionPool(rng);
+    const out = {};
+    for (const ModelClass of options.models) {
+        const name = ModelClass.name;
+        const count = spec[name] ?? 0;
+        if (count === 0) {
+            out[name] = [];
+            continue;
+        }
+        out[name] = await generate(ModelClass, { ...options, count, pool });
+    }
+    return out;
+}
+//# sourceMappingURL=graph.js.map

package/lib/engine/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/engine/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAA4B,EAC5B,OAAO,GAAwD,EAAE,MAAM,EAAE,EAAE,EAAE;IAE7E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAElD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,CAAC,UAAiC,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/engine/infer.d.ts

@@ -0,0 +1,15 @@
+import type { MockKind } from "@webda/models";
+export type InferContext = {
+    fieldName: string;
+    declaredType?: string;
+};
+/**
+ * Resolve a mock kind from a field's name (strong signal) or declared type
+ * (weak fallback). Returns `null` when no rule matches — callers decide
+ * whether to warn, throw, or skip.
+ *
+ * @param ctx - the inference context (field name + optional declared type).
+ * @returns the inferred `MockKind`, or `null` when no rule matches.
+ */
+export declare function inferKind(ctx: InferContext): MockKind | null;
+//# sourceMappingURL=infer.d.ts.map

package/lib/engine/infer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.d.ts","sourceRoot":"","sources":["../../src/engine/infer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAmCF;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAc5D"}

package/lib/engine/infer.js

@@ -0,0 +1,54 @@
+/** Case-insensitive exact-match field-name heuristic. Includes type-guarded `*At` rule. */
+const NAME_TO_KIND = {
+    email: "email",
+    phone: "phone",
+    phonenumber: "phone",
+    url: "url",
+    website: "url",
+    firstname: "firstName",
+    lastname: "lastName",
+    fullname: "fullName",
+    uuid: "uuid",
+    id: "uuid",
+    avatar: "avatar",
+    image: "avatar",
+    photo: "avatar",
+    createdat: "recentDate",
+    updatedat: "recentDate",
+    age: "integer",
+    count: "integer",
+    quantity: "integer",
+    amount: "float",
+    price: "float",
+    score: "float",
+    rating: "float"
+};
+const TYPE_TO_KIND = {
+    string: "lorem",
+    number: "integer",
+    boolean: "boolean",
+    date: "recentDate"
+};
+/**
+ * Resolve a mock kind from a field's name (strong signal) or declared type
+ * (weak fallback). Returns `null` when no rule matches — callers decide
+ * whether to warn, throw, or skip.
+ *
+ * @param ctx - the inference context (field name + optional declared type).
+ * @returns the inferred `MockKind`, or `null` when no rule matches.
+ */
+export function inferKind(ctx) {
+    const lower = ctx.fieldName.toLowerCase();
+    const direct = NAME_TO_KIND[lower];
+    if (direct)
+        return direct;
+    if (lower.endsWith("at") && ctx.declaredType === "Date")
+        return "pastDate";
+    if (ctx.declaredType) {
+        const tk = TYPE_TO_KIND[ctx.declaredType.toLowerCase()];
+        if (tk)
+            return tk;
+    }
+    return null;
+}
+//# sourceMappingURL=infer.js.map

package/lib/engine/infer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.js","sourceRoot":"","sources":["../../src/engine/infer.ts"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,MAAM,YAAY,GAA6B;IAC7C,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,OAAO;IACpB,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,MAAM;IACV,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,OAAO;IACf,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,OAAO;CAChB,CAAC;AAEF,MAAM,YAAY,GAA6B;IAC7C,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAqB;IAC9B,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,GAAiB;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IAE1C,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,YAAY,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IAE3E,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QACxD,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/engine/pool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Session-scoped instance pool. Holds every instance generated during one
+ * `generate()` / `generateGraph()` call so that later relation-aware fields
+ * (`@ModelLink`, `@ModelRelated`) can reference real earlier instances rather
+ * than made-up ids.
+ *
+ * All randomness is driven by the constructor-injected `rng: () => number`
+ * so outcomes are reproducible when the caller supplies a seeded RNG.
+ */
+export declare class SessionPool {
+    private rng;
+    private byClass;
+    /**
+     * @param rng - deterministic RNG returning a float in `[0, 1)`. Defaults to
+     *   `Math.random` when no seed is needed.
+     */
+    constructor(rng?: () => number);
+    /**
+     * Add an instance to the pool, keyed by its constructor.
+     *
+     * @param instance - the object to add. Non-objects are ignored.
+     */
+    add(instance: unknown): void;
+    /**
+     * Pick one random instance of the given class from the pool.
+     *
+     * @param ctor - the class to pick an instance of.
+     * @returns a pooled instance, or `null` when the pool has none.
+     */
+    pickOne<T>(ctor: new (...args: any[]) => T): T | null;
+    /**
+     * Pick a unique subset of instances of the given class.
+     *
+     * @param ctor - the class to pick from.
+     * @param count - requested subset size; clamped to `pool.size(ctor)`.
+     * @returns the selected instances (may be shorter than `count`).
+     */
+    pickMany<T>(ctor: new (...args: any[]) => T, count: number): T[];
+    /**
+     * Number of pooled instances of the given class.
+     *
+     * @param ctor - the class to count.
+     * @returns the current pool size for that class (0 when absent).
+     */
+    size(ctor: new (...args: any[]) => unknown): number;
+}
+//# sourceMappingURL=pool.d.ts.map

package/lib/engine/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../src/engine/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,GAAG;IANvB,OAAO,CAAC,OAAO,CAAkC;IAEjD;;;OAGG;IACH,YAAoB,GAAG,GAAE,MAAM,MAAoB,EAAI;IAEvD;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAS3B;IAED;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAKpD;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,CAc/D;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,MAAM,CAElD;CACF"}

package/lib/engine/pool.js

@@ -0,0 +1,82 @@
+/**
+ * Session-scoped instance pool. Holds every instance generated during one
+ * `generate()` / `generateGraph()` call so that later relation-aware fields
+ * (`@ModelLink`, `@ModelRelated`) can reference real earlier instances rather
+ * than made-up ids.
+ *
+ * All randomness is driven by the constructor-injected `rng: () => number`
+ * so outcomes are reproducible when the caller supplies a seeded RNG.
+ */
+export class SessionPool {
+    rng;
+    byClass = new Map();
+    /**
+     * @param rng - deterministic RNG returning a float in `[0, 1)`. Defaults to
+     *   `Math.random` when no seed is needed.
+     */
+    constructor(rng = Math.random) {
+        this.rng = rng;
+    }
+    /**
+     * Add an instance to the pool, keyed by its constructor.
+     *
+     * @param instance - the object to add. Non-objects are ignored.
+     */
+    add(instance) {
+        if (instance == null || typeof instance !== "object")
+            return;
+        const ctor = instance.constructor;
+        let list = this.byClass.get(ctor);
+        if (!list) {
+            list = [];
+            this.byClass.set(ctor, list);
+        }
+        list.push(instance);
+    }
+    /**
+     * Pick one random instance of the given class from the pool.
+     *
+     * @param ctor - the class to pick an instance of.
+     * @returns a pooled instance, or `null` when the pool has none.
+     */
+    pickOne(ctor) {
+        const list = this.byClass.get(ctor);
+        if (!list || list.length === 0)
+            return null;
+        const idx = Math.floor(this.rng() * list.length);
+        return list[Math.min(idx, list.length - 1)];
+    }
+    /**
+     * Pick a unique subset of instances of the given class.
+     *
+     * @param ctor - the class to pick from.
+     * @param count - requested subset size; clamped to `pool.size(ctor)`.
+     * @returns the selected instances (may be shorter than `count`).
+     */
+    pickMany(ctor, count) {
+        const list = this.byClass.get(ctor);
+        if (!list || list.length === 0)
+            return [];
+        const take = Math.min(count, list.length);
+        // Fisher-Yates-style selection using our rng, taking the first `take`.
+        const copy = [...list];
+        for (let i = 0; i < take; i++) {
+            const j = i + Math.floor(this.rng() * (copy.length - i));
+            const swap = Math.min(j, copy.length - 1);
+            const tmp = copy[i];
+            copy[i] = copy[swap];
+            copy[swap] = tmp;
+        }
+        return copy.slice(0, take);
+    }
+    /**
+     * Number of pooled instances of the given class.
+     *
+     * @param ctor - the class to count.
+     * @returns the current pool size for that class (0 when absent).
+     */
+    size(ctor) {
+        return this.byClass.get(ctor)?.length ?? 0;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/lib/engine/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../src/engine/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IAOF,GAAG;IANf,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEjD;;;OAGG;IACH,YAAoB,GAAG,GAAiB,IAAI,CAAC,MAAM;mBAA/B,GAAG;IAA+B,CAAC;IAEvD;;;;OAIG;IACH,GAAG,CAAC,QAAiB;QACnB,IAAI,QAAQ,IAAI,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,OAAO;QAC7D,MAAM,IAAI,GAAI,QAAsC,CAAC,WAAW,CAAC;QACjE,IAAI,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAI,IAA+B;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAM,CAAC;IACnD,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAI,IAA+B,EAAE,KAAa;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,uEAAuE;QACvE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAQ,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAqC;QACxC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/lib/index.d.ts

@@ -0,0 +1,10 @@
+export declare const VERSION = "4.0.0-beta.1";
+export { generate, type GenerateOptions, type MockContext, type Mode } from "./engine/generate.js";
+export { generateGraph } from "./engine/graph.js";
+export { SessionPool } from "./engine/pool.js";
+export { makeFaker } from "./engine/faker.js";
+export { inferKind, type InferContext } from "./engine/infer.js";
+export type { AIProvider } from "./ai/provider.js";
+export { MockAIProvider } from "./ai/provider.js";
+export { AnthropicProvider } from "./ai/anthropic.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,iBAAiB,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/index.js

@@ -0,0 +1,9 @@
+export const VERSION = "4.0.0-beta.1";
+export { generate } from "./engine/generate.js";
+export { generateGraph } from "./engine/graph.js";
+export { SessionPool } from "./engine/pool.js";
+export { makeFaker } from "./engine/faker.js";
+export { inferKind } from "./engine/infer.js";
+export { MockAIProvider } from "./ai/provider.js";
+export { AnthropicProvider } from "./ai/anthropic.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAqD,MAAM,sBAAsB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAqB,MAAM,mBAAmB,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/service/mock-service.d.ts

@@ -0,0 +1,59 @@
+import { type GenerateOptions } from "../engine/generate.js";
+type ModelClass<T> = new (...args: any[]) => T;
+export type MockServiceParameters = {
+    mode?: "test" | "dev" | "demo" | "load" | "custom";
+    seed?: number;
+    aiProvider?: "anthropic" | "openai" | "none";
+    aiApiKey?: string;
+};
+/**
+ * Thin service facade exposing mock-data generation. Holds default
+ * configuration (mode/seed/AI) so callers don't repeat options per call.
+ *
+ * For v1 this is a standalone class; integrators wrap it into a `@Bean`
+ * subclass in their own project as needed. A first-class `@webda/core`
+ * Service subclass is a planned follow-up once the core package export
+ * graph on `main` is repaired.
+ */
+export declare class MockService {
+    private parameters;
+    /**
+     * @param _webda - reserved for a future `@webda/core` Service subclass wiring.
+     * @param _name - reserved service name (unused in the v1 standalone class).
+     * @param parameters - default mode/seed/AI configuration.
+     */
+    constructor(_webda?: unknown, _name?: string, parameters?: MockServiceParameters);
+    /**
+     * Generate instances using the service's defaults merged with per-call options.
+     *
+     * @param ModelClass - the target model constructor.
+     * @param options - per-call overrides for the service defaults.
+     * @returns the generated instances.
+     */
+    generate<T>(ModelClass: ModelClass<T>, options?: GenerateOptions<T>): Promise<T[]>;
+    /**
+     * Generate across multiple models in one call, sharing one seeded pool.
+     *
+     * @param spec - `{ ModelName: count }` map.
+     * @param options - per-call overrides plus the model classes to generate.
+     * @returns `{ ModelName: instances[] }`.
+     */
+    seed(spec: Record<string, number>, options?: Partial<GenerateOptions> & {
+        models: ModelClass<unknown>[];
+    }): Promise<Record<string, unknown[]>>;
+    /**
+     * Clear generated data. In v1 this is a no-op — persistent clearing
+     * requires webda Store registry access and is planned as a follow-up.
+     *
+     * @param _modelNames - models to clear. Ignored in v1.
+     */
+    clear(_modelNames?: string[]): Promise<void>;
+    /**
+     * Build the default `GenerateOptions` from the service's parameters.
+     *
+     * @returns the default options bag (mode + seed from constructor params).
+     */
+    private defaults;
+}
+export {};
+//# sourceMappingURL=mock-service.d.ts.map

package/lib/service/mock-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-service.d.ts","sourceRoot":"","sources":["../../src/service/mock-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGvE,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW;IAMwB,OAAO,CAAC,UAAU;IALhE;;;;OAIG;IACH,YAAY,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAU,UAAU,GAAE,qBAA0B,EAAI;IAEhG;;;;;;OAMG;IACG,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAGvF;IAED;;;;;;OAMG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG;QAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAA;KAAE,GACrE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAGpC;IAED;;;;;OAKG;IACG,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjD;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAQ;CAMjB"}

package/lib/service/mock-service.js

@@ -0,0 +1,66 @@
+import { generate } from "../engine/generate.js";
+import { generateGraph } from "../engine/graph.js";
+/**
+ * Thin service facade exposing mock-data generation. Holds default
+ * configuration (mode/seed/AI) so callers don't repeat options per call.
+ *
+ * For v1 this is a standalone class; integrators wrap it into a `@Bean`
+ * subclass in their own project as needed. A first-class `@webda/core`
+ * Service subclass is a planned follow-up once the core package export
+ * graph on `main` is repaired.
+ */
+export class MockService {
+    parameters;
+    /**
+     * @param _webda - reserved for a future `@webda/core` Service subclass wiring.
+     * @param _name - reserved service name (unused in the v1 standalone class).
+     * @param parameters - default mode/seed/AI configuration.
+     */
+    constructor(_webda, _name, parameters = {}) {
+        this.parameters = parameters;
+    }
+    /**
+     * Generate instances using the service's defaults merged with per-call options.
+     *
+     * @param ModelClass - the target model constructor.
+     * @param options - per-call overrides for the service defaults.
+     * @returns the generated instances.
+     */
+    async generate(ModelClass, options) {
+        const merged = { ...this.defaults(), ...options };
+        return generate(ModelClass, merged);
+    }
+    /**
+     * Generate across multiple models in one call, sharing one seeded pool.
+     *
+     * @param spec - `{ ModelName: count }` map.
+     * @param options - per-call overrides plus the model classes to generate.
+     * @returns `{ ModelName: instances[] }`.
+     */
+    async seed(spec, options) {
+        const models = options?.models ?? [];
+        return generateGraph(spec, { ...this.defaults(), ...options, models });
+    }
+    /**
+     * Clear generated data. In v1 this is a no-op — persistent clearing
+     * requires webda Store registry access and is planned as a follow-up.
+     *
+     * @param _modelNames - models to clear. Ignored in v1.
+     */
+    async clear(_modelNames) {
+        // v1 no-op — persistent clearing requires webda Store registry access
+        // and is blocked on the @webda/core export graph. Planned for follow-up.
+    }
+    /**
+     * Build the default `GenerateOptions` from the service's parameters.
+     *
+     * @returns the default options bag (mode + seed from constructor params).
+     */
+    defaults() {
+        return {
+            mode: this.parameters.mode,
+            seed: this.parameters.seed
+        };
+    }
+}
+//# sourceMappingURL=mock-service.js.map

package/lib/service/mock-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-service.js","sourceRoot":"","sources":["../../src/service/mock-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwB,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWnD;;;;;;;;GAQG;AACH,MAAM,OAAO,WAAW;IAMgC,UAAU;IALhE;;;;OAIG;IACH,YAAY,MAAgB,EAAE,KAAc,EAAU,UAAU,GAA0B,EAAE;0BAAtC,UAAU;IAA+B,CAAC;IAEhG;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,CAAI,UAAyB,EAAE,OAA4B;QACvE,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAwB,CAAC;QACxE,OAAO,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CACR,IAA4B,EAC5B,OAAsE;QAEtE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAC;QACrC,OAAO,aAAa,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,WAAsB;QAChC,sEAAsE;QACtE,yEAAyE;IAC3E,CAAC;IAED;;;;OAIG;IACK,QAAQ;QACd,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;SAC3B,CAAC;IACJ,CAAC;CACF"}