@webda/mock 4.0.0-beta.3

package/LICENSE

@@ -0,0 +1,166 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+

package/README.md

@@ -0,0 +1,121 @@
+# @webda/mock module
+
+This module is part of Webda Application Framework that allows you to quickly develop applications with all modern prerequisites: Security, Extensibility, GraphQL, REST, CloudNative [https://webda.io](https://webda.io)
+
+<img src="https://webda.io/images/webda.svg" width="128" />
+
+![CI](https://github.com/loopingz/webda.io/workflows/CI/badge.svg)
+
+[![Join the chat at https://gitter.im/loopingz/webda](https://badges.gitter.im/loopingz/webda.svg)](https://gitter.im/loopingz/webda?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![codecov](https://codecov.io/gh/loopingz/webda.io/branch/main/graph/badge.svg?token=8N9DNM3K3O)](https://codecov.io/gh/loopingz/webda.io)
+[![SonarCloud.io](https://sonarcloud.io/api/project_badges/measure?project=loopingz_webda.io&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=loopingz_webda.io)
+![CodeQL](https://github.com/loopingz/webda.io/workflows/CodeQL/badge.svg)
+
+<!-- README_HEADER -->
+
+# @webda/mock
+
+> Coherent mock-data generation for `@webda/models` classes — decorator-driven field population with deterministic seeding, multi-model graph support, and optional AI-generated text.
+
+## When to use it
+
+- You need realistic, consistent test fixtures for Webda models without writing manual factory functions.
+- You want reproducible test data with `mode: "test"` (seed=0) and varied demo data with `mode: "demo"`.
+- You need to populate an entire relational graph of models (e.g. Users + Orders + Posts) in one call.
+
+## Install
+
+```bash
+pnpm add -D @webda/mock
+```
+
+## Configuration
+
+`@webda/mock` is a pure library — no `webda.config.json` entry is required. Field hints are added via `@Mock.*` decorators from `@webda/models` (zero production cost — tree-shaken out).
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `count` | number | `1` | Number of instances to generate |
+| `seed` | number | `0` (test) / `Date.now()` (dev) | RNG seed for reproducibility |
+| `mode` | `"test"` \| `"dev"` \| `"demo"` \| `"load"` | `"test"` in Vitest | Controls seed default, AI usage, and session pool |
+| `overrides` | `Partial<T>` | — | Force-set specific fields regardless of inference |
+| `strict` | boolean | `false` | Throw instead of skip on unhinted, uninferable fields |
+| `ai` | `AIProvider` | — | AI provider for `@Mock.ai` fields (e.g. `AnthropicProvider`) |
+
+## Usage
+
+```typescript
+import { Mock } from "@webda/models";
+import { generate, generateGraph } from "@webda/mock";
+
+// Annotate your model fields
+class Post {
+  @Mock.word accessor title!: string;
+  @Mock.paragraph accessor body!: string;
+  @Mock.pastDate accessor publishedAt!: Date;
+}
+
+class User {
+  @Mock.firstName accessor firstName!: string;
+  @Mock.email accessor email!: string;
+  @Mock.integer({ min: 18, max: 99 }) accessor age!: number;
+}
+
+// Generate 5 deterministic posts (seed=42)
+const posts = await generate(Post, { count: 5, seed: 42, mode: "test" });
+// posts[0].title is always the same string across runs
+
+// Generate a relational graph: 10 users and 50 posts
+const graph = await generateGraph(
+  { User: 10, Post: 50 },
+  { models: [User, Post], seed: 1, mode: "dev" }
+);
+// graph.User → User[], graph.Post → Post[]
+
+// Optional: AI-generated text fields (Anthropic)
+import { AnthropicProvider } from "@webda/mock";
+
+const ai = new AnthropicProvider({ apiKey: process.env.ANTHROPIC_API_KEY });
+
+class Product {
+  @Mock.word accessor name!: string;
+  @Mock.ai({ prompt: "One-sentence marketing tagline for a fictional product." })
+  accessor tagline!: string;
+}
+
+const products = await generate(Product, { count: 3, mode: "demo", ai });
+```
+
+## Modes
+
+| Mode | Seed default | AI | Use case |
+|------|-------------|-----|---------|
+| `test` | `0` (deterministic) | Throws on `@Mock.ai` | Unit tests, snapshots |
+| `dev` | `Date.now()` | Enabled if provider given | Local development seeding |
+| `demo` | Logged | Enabled + preferred for text | Demo environments |
+| `load` | Caller-supplied | Disabled | Load/performance testing |
+
+## Reference
+
+- API reference: see the auto-generated typedoc at `docs/pages/Modules/mock/`.
+- Source: [`packages/mock`](https://github.com/loopingz/webda.io/tree/main/packages/mock)
+- Related: [`@webda/models`](../models) for the `@Mock.*` decorator definitions; [`@webda/test`](../test) for the `WebdaTest` harness where mock data is typically used; [`@webda/fs`](../fs) for `FileStore` to persist generated data locally.
+
+<!-- README_FOOTER -->
+## Sponsors
+
+<!--
+Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor](mailto:sponsor@webda.io)
+-->
+
+Arize AI is a machine learning observability and model monitoring platform. It helps you visualize, monitor, and explain your machine learning models. [Learn more](https://arize.com)
+
+[<img src="https://arize.com/hubfs/arize/brand/arize-logomark-1.png" width="200">](https://arize.com)
+
+Loopingz is a software development company that provides consulting and development services. [Learn more](https://loopingz.com)
+
+[<img src="https://loopingz.com/images/logo.png" width="200">](https://loopingz.com)
+
+Tellae is an innovative consulting firm specialized in cities transportation issues. We provide our clients, both public and private, with solutions to support your strategic and operational decisions. [Learn more](https://tellae.fr)
+
+[<img src="https://tellae.fr/" width="200">](https://tellae.fr)

package/lib/ai/anthropic.d.ts

@@ -0,0 +1,30 @@
+import type { AIProvider } from "./provider.js";
+/**
+ * `AIProvider` backed by Anthropic's Claude API. Loads `@anthropic-ai/sdk`
+ * lazily on the first `complete()` call so the package does not force the
+ * SDK into consumers' graphs at import time.
+ */
+export declare class AnthropicProvider implements AIProvider {
+    private opts;
+    /**
+     * @param opts - construction options.
+     * @param opts.apiKey - Anthropic API key (falls back to `ANTHROPIC_API_KEY` env).
+     * @param opts.model - model identifier (defaults to the current Haiku).
+     */
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    /**
+     * Send a single completion request to Claude.
+     *
+     * @param prompt - the user-side prompt text.
+     * @param options - optional tuning parameters.
+     * @param options.maxTokens - maximum tokens for the response (default 512).
+     * @returns the first text block of the response; empty string if none.
+     */
+    complete(prompt: string, options?: {
+        maxTokens?: number;
+    }): Promise<string>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/lib/ai/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/ai/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,UAAU;IAMtC,OAAO,CAAC,IAAI;IALxB;;;;OAIG;IACH,YAAoB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,EAAI;IAEtE;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBhF;CACF"}

package/lib/ai/anthropic.js

@@ -0,0 +1,43 @@
+/**
+ * `AIProvider` backed by Anthropic's Claude API. Loads `@anthropic-ai/sdk`
+ * lazily on the first `complete()` call so the package does not force the
+ * SDK into consumers' graphs at import time.
+ */
+export class AnthropicProvider {
+    opts;
+    /**
+     * @param opts - construction options.
+     * @param opts.apiKey - Anthropic API key (falls back to `ANTHROPIC_API_KEY` env).
+     * @param opts.model - model identifier (defaults to the current Haiku).
+     */
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /**
+     * Send a single completion request to Claude.
+     *
+     * @param prompt - the user-side prompt text.
+     * @param options - optional tuning parameters.
+     * @param options.maxTokens - maximum tokens for the response (default 512).
+     * @returns the first text block of the response; empty string if none.
+     */
+    async complete(prompt, options) {
+        const apiKey = this.opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
+        if (!apiKey) {
+            throw new Error("AnthropicProvider: no apiKey configured and ANTHROPIC_API_KEY is not set in env");
+        }
+        // Lazy-load the SDK so the package does not require it at import time.
+        const mod = await import("@anthropic-ai/sdk");
+        const Anthropic = mod.default ?? mod.Anthropic;
+        const client = new Anthropic({ apiKey });
+        const model = this.opts.model ?? "claude-haiku-4-5-20251001";
+        const res = await client.messages.create({
+            model,
+            max_tokens: options?.maxTokens ?? 512,
+            messages: [{ role: "user", content: prompt }]
+        });
+        const first = res.content.find((b) => b.type === "text");
+        return first?.text ?? "";
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/lib/ai/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/ai/anthropic.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAMR,IAAI;IALxB;;;;OAIG;IACH,YAAoB,IAAI,GAAwC,EAAE;oBAA9C,IAAI;IAA6C,CAAC;IAEtE;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAAgC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,uEAAuE;QACvE,MAAM,GAAG,GAAQ,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACnD,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,2BAA2B,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,KAAK;YACL,UAAU,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;YACrC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAkC,CAAC;QAC5G,OAAO,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/lib/ai/provider.d.ts

@@ -0,0 +1,35 @@
+/** Abstracts the LLM used to resolve `@Mock.ai` fields. */
+export interface AIProvider {
+    /**
+     * Complete a prompt.
+     *
+     * @param prompt - the input text.
+     * @param options - optional tuning.
+     * @param options.maxTokens - maximum tokens for the response.
+     * @returns the completion text.
+     */
+    complete(prompt: string, options?: {
+        maxTokens?: number;
+    }): Promise<string>;
+}
+/** Deterministic fake provider for unit tests. */
+export declare class MockAIProvider implements AIProvider {
+    private opts;
+    private i;
+    /**
+     * @param opts - construction options.
+     * @param opts.canned - canned responses returned in order (last repeats if exhausted).
+     *   When omitted, `complete()` echoes the prompt back.
+     */
+    constructor(opts?: {
+        canned?: string[];
+    });
+    /**
+     * Return the next canned answer, or the prompt itself when none were given.
+     *
+     * @param prompt - the input text.
+     * @returns the next canned answer, or the prompt echoed back.
+     */
+    complete(prompt: string): Promise<string>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/lib/ai/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7E;AAED,kDAAkD;AAClD,qBAAa,cAAe,YAAW,UAAU;IAOnC,OAAO,CAAC,IAAI;IANxB,OAAO,CAAC,CAAC,CAAK;IACd;;;;OAIG;IACH,YAAoB,IAAI,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,EAAI;IAExD;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9C;CACF"}

package/lib/ai/provider.js

@@ -0,0 +1,27 @@
+/** Deterministic fake provider for unit tests. */
+export class MockAIProvider {
+    opts;
+    i = 0;
+    /**
+     * @param opts - construction options.
+     * @param opts.canned - canned responses returned in order (last repeats if exhausted).
+     *   When omitted, `complete()` echoes the prompt back.
+     */
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    /**
+     * Return the next canned answer, or the prompt itself when none were given.
+     *
+     * @param prompt - the input text.
+     * @returns the next canned answer, or the prompt echoed back.
+     */
+    async complete(prompt) {
+        if (!this.opts.canned || this.opts.canned.length === 0)
+            return prompt;
+        const idx = Math.min(this.i, this.opts.canned.length - 1);
+        this.i++;
+        return this.opts.canned[idx];
+    }
+}
+//# sourceMappingURL=provider.js.map

package/lib/ai/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAaA,kDAAkD;AAClD,MAAM,OAAO,cAAc;IAOL,IAAI;IANhB,CAAC,GAAG,CAAC,CAAC;IACd;;;;OAIG;IACH,YAAoB,IAAI,GAA0B,EAAE;oBAAhC,IAAI;IAA+B,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/lib/cli/seed.d.ts

@@ -0,0 +1,22 @@
+export type SeedParsed = {
+    spec: Record<string, number>;
+    specPath?: string;
+    options: {
+        seed?: number;
+        mode?: "test" | "dev" | "demo" | "load" | "custom";
+        disableAi?: boolean;
+    };
+};
+/**
+ * Parse `webda mock seed` argv. Recognises:
+ *   --ModelName N         count for a model
+ *   --seed N              deterministic seed
+ *   --mode dev|demo|…
+ *   --ai | --no-ai        enable / disable AI provider
+ *   --spec ./file.json    alternate source for model counts
+ *
+ * @param argv - the command-line arguments to parse (without the `webda mock seed` prefix).
+ * @returns the parsed spec map, optional spec file path, and options bag.
+ */
+export declare function parseSeedArgs(argv: string[]): SeedParsed;
+//# sourceMappingURL=seed.d.ts.map

package/lib/cli/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/cli/seed.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnD,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACH,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAwBxD"}

package/lib/cli/seed.js

@@ -0,0 +1,43 @@
+/**
+ * Parse `webda mock seed` argv. Recognises:
+ *   --ModelName N         count for a model
+ *   --seed N              deterministic seed
+ *   --mode dev|demo|…
+ *   --ai | --no-ai        enable / disable AI provider
+ *   --spec ./file.json    alternate source for model counts
+ *
+ * @param argv - the command-line arguments to parse (without the `webda mock seed` prefix).
+ * @returns the parsed spec map, optional spec file path, and options bag.
+ */
+export function parseSeedArgs(argv) {
+    const out = { spec: {}, options: {} };
+    let i = 0;
+    while (i < argv.length) {
+        const flag = argv[i];
+        if (flag === "--seed") {
+            out.options.seed = Number(argv[++i]);
+        }
+        else if (flag === "--mode") {
+            out.options.mode = argv[++i];
+        }
+        else if (flag === "--no-ai") {
+            out.options.disableAi = true;
+        }
+        else if (flag === "--ai") {
+            out.options.disableAi = false;
+        }
+        else if (flag === "--spec") {
+            out.specPath = argv[++i];
+        }
+        else if (flag.startsWith("--")) {
+            const name = flag.slice(2);
+            const value = argv[++i];
+            const n = Number(value);
+            if (!Number.isNaN(n))
+                out.spec[name] = n;
+        }
+        i++;
+    }
+    return out;
+}
+//# sourceMappingURL=seed.js.map

package/lib/cli/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/cli/seed.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,MAAM,GAAG,GAAe,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAkC,CAAC;QAChE,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;QAC/B,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAChC,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,CAAC;QACD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/lib/engine/faker.d.ts

@@ -0,0 +1,10 @@
+import { Faker } from "@faker-js/faker";
+/**
+ * Build a seeded Faker instance. Uses the English locale plus the base locale
+ * (numbers, dates) as fallbacks — matches Faker v9's recommended defaults.
+ *
+ * @param seed - optional numeric seed. Defaults to Date.now() for non-deterministic runs.
+ * @returns a seeded Faker instance.
+ */
+export declare function makeFaker(seed?: number): Faker;
+//# sourceMappingURL=faker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"faker.d.ts","sourceRoot":"","sources":["../../src/engine/faker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAY,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAI9C"}

package/lib/engine/faker.js

@@ -0,0 +1,14 @@
+import { Faker, en, base } from "@faker-js/faker";
+/**
+ * Build a seeded Faker instance. Uses the English locale plus the base locale
+ * (numbers, dates) as fallbacks — matches Faker v9's recommended defaults.
+ *
+ * @param seed - optional numeric seed. Defaults to Date.now() for non-deterministic runs.
+ * @returns a seeded Faker instance.
+ */
+export function makeFaker(seed) {
+    const faker = new Faker({ locale: [en, base] });
+    faker.seed(seed ?? Date.now());
+    return faker;
+}
+//# sourceMappingURL=faker.js.map

package/lib/engine/faker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker.js","sourceRoot":"","sources":["../../src/engine/faker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/engine/generate.d.ts

@@ -0,0 +1,37 @@
+import type { Faker } from "@faker-js/faker";
+import { SessionPool } from "./pool.js";
+import type { AIProvider } from "../ai/provider.js";
+export type Mode = "test" | "dev" | "demo" | "load" | "custom";
+export type GenerateOptions<T = unknown> = {
+    count?: number;
+    seed?: number;
+    mode?: Mode;
+    ai?: AIProvider;
+    pool?: SessionPool;
+    overrides?: Partial<T>;
+    strict?: boolean;
+};
+type ModelClass<T> = new (...args: any[]) => T;
+export type MockContext = {
+    faker: Faker;
+    rng: () => number;
+    ai: (prompt: string, opts?: {
+        maxTokens?: number;
+    }) => Promise<string>;
+    pool: SessionPool;
+    index: number;
+    total: number;
+    model: Function;
+    fieldName: string;
+};
+/**
+ * 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 declare function generate<T>(ModelClass: ModelClass<T>, options?: GenerateOptions<T>): Promise<T[]>;
+export {};
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/engine/generate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/D,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CA8E3G"}