@ir-kit/openapi-ts-faker 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ahmed Rowaihi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# @ir-kit/openapi-ts-faker
+
+Faker.js mock-data factories from an OpenAPI spec. Plugin for [`@hey-api/openapi-ts`](https://heyapi.dev).
+
+## Install
+
+```bash
+npm install -D @ir-kit/openapi-ts-faker @hey-api/openapi-ts
+npm install @faker-js/faker
+```
+
+## Use
+
+```ts
+import { defineConfig } from "@hey-api/openapi-ts";
+import { defineConfig as defineFakerConfig } from "@ir-kit/openapi-ts-faker";
+
+export default defineConfig({
+  input: "openapi.yaml",
+  output: { path: "./generated" },
+  plugins: [
+    "@hey-api/typescript",
+    defineFakerConfig({
+      fieldNameHints: { email: "internet.email", firstName: "person.firstName" },
+    }),
+  ],
+});
+```
+
+## Resolution order (per property)
+
+1. OpenAPI `format` → `formatMapping`
+2. `fieldNameHints` exact match (keys are case/separator-insensitive: `email`, `Email`, `user_email` all normalize the same)
+3. `enum` → `helpers.arrayElement([...])`
+4. Type fallback (`integer` → `number.int`, etc.)
+
+No default field hints. `formatMapping` ships with sensible defaults you can override.
+
+## Mapping
+
+| OpenAPI | Output |
+| --- | --- |
+| `type: object` | `() => ({ ...props })` |
+| `allOf` | merged object |
+| `oneOf` / `anyOf` | `helpers.arrayElement([() => v1, () => v2])()` |
+| `enum` | `helpers.arrayElement([...])` |
+| `type: array` | `helpers.multiple(() => item, { count: { min, max } })` |
+| `$ref` | call to sibling factory: `createMockX()` |
+| cyclic `$ref` | `null` (broken at codegen to avoid runtime recursion) |
+
+## Type safety
+
+`fieldNameHints` and `formatMapping` values are typed against `FakerMethodPath` — every Faker method callable with zero args. Typos and arg-required methods (e.g. `helpers.arrayElement`) fail at compile time.
+
+## Options
+
+```ts
+defineFakerConfig({
+  output: "factories.gen",          // filename
+  fieldNameHints: {},               // field → faker method
+  formatMapping: {},                // format → faker method (merged with defaults)
+  respectConstraints: true,         // honor minimum/maximum, minLength/maxLength, minItems/maxItems
+  generateBatchCreators: true,      // emit createMockXs(count?)
+  defaultBatchCount: 10,            // default count when caller omits arg
+  include: ["User", "Order"],       // only these schemas
+  exclude: ["Internal"],            // skip these schemas
+  filter: (s) => Boolean(s.title),  // custom predicate
+});
+```
+
+When `respectConstraints` is on:
+- `{ minimum: 18, maximum: 99 }` → `number.int({ min: 18, max: 99 })`
+- `{ maxLength: 8 }` → `string.alpha({ length: 8 })`
+- `{ minItems: 2, maxItems: 5 }` → `helpers.multiple(..., { count: { min: 2, max: 5 } })`
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+import { DEFAULT_FORMAT_MAPPING } from "./core/hints.js";
+import type { FakerPlugin } from "./types.js";
+export { DEFAULT_FORMAT_MAPPING };
+export declare const defaultConfig: FakerPlugin["Config"];
+export declare const defineConfig: (userConfig?: Omit<import("./types.js").UserConfig, "name"> | undefined) => Omit<import("@hey-api/shared").Plugin.Config<import("@hey-api/shared").Plugin.Types<import("./types.js").UserConfig, import("./types.js").Config, never>>, "name"> & {
+    name: any;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AAE9D,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAclC,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,QAAQ,CAuB/C,CAAC;AAEF,eAAO,MAAM,YAAY;;CAAoC,CAAC"}

package/dist/config.js

@@ -0,0 +1,38 @@
+import { definePluginConfig } from "@hey-api/shared";
+import { DEFAULT_FORMAT_MAPPING } from "./core/hints.js";
+import { handler } from "./plugin.js";
+export { DEFAULT_FORMAT_MAPPING };
+const normalizeHintKey = (key) => key.toLowerCase().replace(/[_-]/g, "");
+const normalizeFieldNameHints = (hints) => {
+    if (!hints)
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(hints)) {
+        out[normalizeHintKey(key)] = value;
+    }
+    return out;
+};
+export const defaultConfig = {
+    config: {
+        output: "factories.gen",
+        fieldNameHints: {},
+        formatMapping: DEFAULT_FORMAT_MAPPING,
+        generateBatchCreators: true,
+        defaultBatchCount: 10,
+        respectConstraints: true,
+        includeInEntry: true,
+    },
+    dependencies: ["@hey-api/typescript"],
+    handler,
+    name: "@ir-kit/openapi-ts-faker",
+    resolveConfig: (plugin) => {
+        plugin.config.fieldNameHints = normalizeFieldNameHints(plugin.config.fieldNameHints);
+        plugin.config.formatMapping = {
+            ...DEFAULT_FORMAT_MAPPING,
+            ...plugin.config.formatMapping,
+        };
+    },
+    tags: ["transformer"],
+};
+export const defineConfig = definePluginConfig(defaultConfig);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAU,EAAE,CAC/C,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAEzC,MAAM,uBAAuB,GAAG,CAAC,KAAsB,EAAkB,EAAE;IACzE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAA0B;IAClD,MAAM,EAAE;QACN,MAAM,EAAE,eAAe;QACvB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,sBAAsB;QACrC,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,EAAE;QACrB,kBAAkB,EAAE,IAAI;QACxB,cAAc,EAAE,IAAI;KACrB;IACD,YAAY,EAAE,CAAC,qBAAqB,CAAC;IACrC,OAAO;IACP,IAAI,EAAE,0BAA0B;IAChC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;QACxB,MAAM,CAAC,MAAM,CAAC,cAAc,GAAG,uBAAuB,CACpD,MAAM,CAAC,MAAM,CAAC,cAAc,CAC7B,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG;YAC5B,GAAG,sBAAsB;YACzB,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa;SAC/B,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC"}

package/dist/core/builders.d.ts

@@ -0,0 +1,20 @@
+import type { Symbol as CodegenSymbol } from "@hey-api/codegen-core";
+import { type TsDsl } from "@hey-api/openapi-ts";
+import type ts from "typescript";
+import { type FakerCallSpec, type ResolveOptions } from "./resolve.js";
+import type { PropertyInfo } from "./types.js";
+export type FakerSymbol = CodegenSymbol;
+export type FakerExpr = TsDsl<ts.Expression>;
+export interface BuildFakerOptions extends ResolveOptions {
+    /**
+     * Called when `info.$ref` is set. Return an expression (typically a call to
+     * a sibling factory) or `null` to skip ref handling. When `null` is returned
+     * or no resolver is provided, the builder falls through to inline generation
+     * if `info.children` / `info.items` / `info.type` are present, otherwise
+     * defaults to `lorem.word`.
+     */
+    resolveRef?: (ref: string) => FakerExpr | null;
+}
+export declare function buildFakerCall(faker: FakerSymbol, spec: FakerCallSpec): FakerExpr;
+export declare function buildFakerExpression(faker: FakerSymbol, info: PropertyInfo, opts?: BuildFakerOptions): FakerExpr;
+//# sourceMappingURL=builders.d.ts.map

package/dist/core/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/core/builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAK,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EAEpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,aAAa,CAAC;AACxC,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAE7C,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAC;CAChD;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,aAAa,GAClB,SAAS,CAqBX;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE,iBAAsB,GAC3B,SAAS,CAkDX"}

package/dist/core/builders.js

@@ -0,0 +1,71 @@
+import { $ } from "@hey-api/openapi-ts";
+import { DATE_METHODS } from "./hints.js";
+import { resolveFakerCall, } from "./resolve.js";
+export function buildFakerCall(faker, spec) {
+    if (spec.method === "__null__")
+        return $.literal(null);
+    const [mod, fn] = spec.method.split(".");
+    const args = [];
+    if (spec.args && Object.keys(spec.args).length > 0) {
+        let argObj = $.object();
+        for (const [key, value] of Object.entries(spec.args)) {
+            argObj = argObj.prop(key, $.literal(value));
+        }
+        args.push(argObj);
+    }
+    const call = $(faker)
+        .attr(mod)
+        .attr(fn)
+        .call(...args);
+    if (DATE_METHODS.has(spec.method)) {
+        return call.attr("toISOString").call();
+    }
+    return call;
+}
+export function buildFakerExpression(faker, info, opts = {}) {
+    if (info.$ref && opts.resolveRef) {
+        const refExpr = opts.resolveRef(info.$ref);
+        if (refExpr)
+            return refExpr;
+    }
+    if (info.variants && info.variants.length > 0) {
+        const arrowFns = info.variants.map((v) => $.func().do($.return(buildFakerExpression(faker, v, opts))));
+        return $(faker)
+            .attr("helpers")
+            .attr("arrayElement")
+            .call($.array(...arrowFns))
+            .call();
+    }
+    if (info.enum && info.enum.length > 0) {
+        const literals = $.array(...info.enum.map((v) => $.literal(v)));
+        return $(faker).attr("helpers").attr("arrayElement").call(literals);
+    }
+    if (info.type === "object") {
+        if (info.children && Object.keys(info.children).length > 0) {
+            let obj = $.object().pretty();
+            for (const [key, child] of Object.entries(info.children)) {
+                obj = obj.prop(key, buildFakerExpression(faker, child, opts));
+            }
+            return obj;
+        }
+        return $.object();
+    }
+    if (info.type === "array") {
+        if (!info.items)
+            return $.array();
+        const itemExpr = buildFakerExpression(faker, info.items, opts);
+        const itemFn = $.func().do($.return(itemExpr));
+        const respect = opts.respectConstraints ?? false;
+        const min = respect ? (info.minItems ?? 1) : 1;
+        const max = respect ? (info.maxItems ?? Math.max(min, 3)) : 3;
+        const countArg = $.object()
+            .prop("min", $.literal(min))
+            .prop("max", $.literal(max));
+        return $(faker)
+            .attr("helpers")
+            .attr("multiple")
+            .call(itemFn, $.object().prop("count", countArg));
+    }
+    return buildFakerCall(faker, resolveFakerCall(info, opts));
+}
+//# sourceMappingURL=builders.js.map

package/dist/core/builders.js.map

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

package/dist/core/hints.d.ts

@@ -0,0 +1,4 @@
+import type { FormatMapping } from "./types.js";
+export declare const DEFAULT_FORMAT_MAPPING: FormatMapping;
+export declare const DATE_METHODS: Set<string>;
+//# sourceMappingURL=hints.d.ts.map

package/dist/core/hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../../src/core/hints.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,eAAO,MAAM,sBAAsB,EAAE,aAiBpC,CAAC;AAEF,eAAO,MAAM,YAAY,aAIvB,CAAC"}

package/dist/core/hints.js

@@ -0,0 +1,24 @@
+export const DEFAULT_FORMAT_MAPPING = {
+    email: "internet.email",
+    uri: "internet.url",
+    url: "internet.url",
+    hostname: "internet.domainName",
+    ipv4: "internet.ipv4",
+    ipv6: "internet.ipv6",
+    uuid: "string.uuid",
+    "date-time": "date.recent",
+    date: "date.past",
+    time: "date.recent",
+    binary: "string.alphanumeric",
+    byte: "string.alphanumeric",
+    float: "number.float",
+    double: "number.float",
+    int32: "number.int",
+    int64: "number.int",
+};
+export const DATE_METHODS = new Set([
+    "date.past",
+    "date.recent",
+    "date.birthdate",
+]);
+//# sourceMappingURL=hints.js.map

package/dist/core/hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../../src/core/hints.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,KAAK,EAAE,gBAAgB;IACvB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,cAAc;IACnB,QAAQ,EAAE,qBAAqB;IAC/B,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,aAAa;IAC1B,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,aAAa;IACnB,MAAM,EAAE,qBAAqB;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,WAAW;IACX,aAAa;IACb,gBAAgB;CACjB,CAAC,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export { type BuildFakerOptions, buildFakerCall, buildFakerExpression, type FakerExpr, type FakerSymbol, } from "./builders.js";
+export { DATE_METHODS, DEFAULT_FORMAT_MAPPING } from "./hints.js";
+export { type FakerCallSpec, type ResolvedFakerMethod, type ResolveOptions, resolveFakerCall, } from "./resolve.js";
+export type { FakerMethodPath, FieldNameHints, FormatMapping, PropertyInfo, ResponseSchemaInfo, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,cAAc,EACd,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+export { buildFakerCall, buildFakerExpression, } from "./builders.js";
+export { DATE_METHODS, DEFAULT_FORMAT_MAPPING } from "./hints.js";
+export { resolveFakerCall, } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACd,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAIL,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/core/resolve.d.ts

@@ -0,0 +1,15 @@
+import type { FakerMethodPath, FieldNameHints, FormatMapping, PropertyInfo } from "./types.js";
+declare const NULL_METHOD: "__null__";
+export type ResolvedFakerMethod = FakerMethodPath | typeof NULL_METHOD;
+export interface ResolveOptions {
+    fieldHints?: FieldNameHints;
+    formatHints?: FormatMapping;
+    respectConstraints?: boolean;
+}
+export interface FakerCallSpec {
+    method: ResolvedFakerMethod;
+    args?: Record<string, number>;
+}
+export declare function resolveFakerCall(info: PropertyInfo, opts?: ResolveOptions): FakerCallSpec;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/core/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/core/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,QAAA,MAAM,WAAW,EAAG,UAAmB,CAAC;AACxC,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,OAAO,WAAW,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAQD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE,cAAmB,GACxB,aAAa,CAwCf"}

package/dist/core/resolve.js

@@ -0,0 +1,43 @@
+import { DEFAULT_FORMAT_MAPPING } from "./hints.js";
+const NULL_METHOD = "__null__";
+const hasNumericConstraint = (info) => info.minimum !== undefined || info.maximum !== undefined;
+const hasLengthConstraint = (info) => info.minLength !== undefined || info.maxLength !== undefined;
+export function resolveFakerCall(info, opts = {}) {
+    const fieldHints = opts.fieldHints ?? {};
+    const formatHints = opts.formatHints ?? DEFAULT_FORMAT_MAPPING;
+    const respect = opts.respectConstraints ?? false;
+    if (info.format && formatHints[info.format]) {
+        return { method: formatHints[info.format] };
+    }
+    const normalized = info.name.toLowerCase().replace(/[_-]/g, "");
+    if (fieldHints[normalized]) {
+        return { method: fieldHints[normalized] };
+    }
+    switch (info.type) {
+        case "integer":
+        case "number": {
+            const method = info.type === "integer" ? "number.int" : "number.float";
+            if (respect && hasNumericConstraint(info)) {
+                const args = {};
+                if (info.minimum !== undefined)
+                    args.min = info.minimum;
+                if (info.maximum !== undefined)
+                    args.max = info.maximum;
+                return { method, args };
+            }
+            return { method };
+        }
+        case "boolean":
+            return { method: "datatype.boolean" };
+        case "null":
+            return { method: NULL_METHOD };
+        default: {
+            if (respect && hasLengthConstraint(info)) {
+                const length = info.maxLength ?? info.minLength;
+                return { method: "string.alpha", args: { length } };
+            }
+            return { method: "lorem.word" };
+        }
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/core/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/core/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAQpD,MAAM,WAAW,GAAG,UAAmB,CAAC;AAcxC,MAAM,oBAAoB,GAAG,CAAC,IAAkB,EAAW,EAAE,CAC3D,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;AAE3D,MAAM,mBAAmB,GAAG,CAAC,IAAkB,EAAW,EAAE,CAC1D,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC;AAE/D,MAAM,UAAU,gBAAgB,CAC9B,IAAkB,EAClB,OAAuB,EAAE;IAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IACzC,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,IAAK,sBAAwC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC;IAEjD,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,MAAM,GACV,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;YAC1D,IAAI,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAA2B,EAAE,CAAC;gBACxC,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;oBAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;gBACxD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;oBAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;gBACxD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAC1B,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAU,CAAC;gBACjD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC;YACtD,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,45 @@
+import type { Faker } from "@faker-js/faker";
+export interface PropertyInfo {
+    type: string;
+    format?: string;
+    name: string;
+    /**
+     * Set when this property is a `$ref` to another schema. The builder calls
+     * `opts.resolveRef(ref)` to emit a reference (e.g. a call to a sibling
+     * factory) instead of inlining the target schema. Avoids infinite recursion
+     * for cyclic schemas and matches the zod-plugin / openapi-ts ref-by-symbol
+     * convention.
+     */
+    $ref?: string;
+    enum?: (string | number | boolean)[];
+    /** Set for `oneOf`/`anyOf` schemas. Builder emits a runtime random pick. */
+    variants?: PropertyInfo[];
+    children?: Record<string, PropertyInfo>;
+    items?: PropertyInfo;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    minItems?: number;
+    maxItems?: number;
+}
+export interface ResponseSchemaInfo {
+    properties: Record<string, PropertyInfo>;
+    isArray: boolean;
+}
+/**
+ * All `module.method` paths on the Faker instance whose method is callable
+ * with zero arguments. Methods that require arguments (e.g.
+ * `helpers.arrayElement`, `helpers.fromRegExp`) are excluded so they cannot
+ * be used as field-name or format hints — those would emit empty calls.
+ */
+type ExtractZeroArgFakerPaths<T> = {
+    [K in keyof T]: K extends string ? T[K] extends object ? {
+        [M in keyof T[K]]: M extends string ? T[K][M] extends () => unknown ? `${K}.${M}` : never : never;
+    }[keyof T[K]] : never : never;
+}[keyof T];
+export type FakerMethodPath = ExtractZeroArgFakerPaths<Faker>;
+export type FieldNameHints = Record<string, FakerMethodPath>;
+export type FormatMapping = Record<string, FakerMethodPath>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IACrC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,KAAK,wBAAwB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,GAC5B,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB;SACG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,GAC/B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,OAAO,GAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,GACX,KAAK,GACP,KAAK;KACV,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GACb,KAAK,GACP,KAAK;CACV,CAAC,MAAM,CAAC,CAAC,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAE9D,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/generators/factories.d.ts

@@ -0,0 +1,3 @@
+import type { GenerateFactoriesInput } from "./types.js";
+export declare const generateFactories: ({ plugin, outputFile, }: GenerateFactoriesInput) => void;
+//# sourceMappingURL=factories.d.ts.map

package/dist/generators/factories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factories.d.ts","sourceRoot":"","sources":["../../src/generators/factories.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA2G9E,eAAO,MAAM,iBAAiB,GAAI,yBAG/B,sBAAsB,KAAG,IAwE3B,CAAC"}

package/dist/generators/factories.js

@@ -0,0 +1,182 @@
+import { $ } from "@hey-api/openapi-ts";
+import { buildGraph } from "@hey-api/shared";
+import { buildFakerExpression } from "../core/builders.js";
+import { schemaToBatchFactoryName, schemaToFactoryName, shouldIncludeSchema, } from "../utils/helpers.js";
+const schemaNameFromRef = (ref) => {
+    const m = ref.match(/\/([^/]+)$/);
+    return m ? decodeURIComponent(m[1]) : null;
+};
+/**
+ * IR walker. Produces a `PropertyInfo` tree from an `IR.SchemaObject`.
+ *
+ * Refs (`$ref`) are recorded but not followed — the builder emits a sibling
+ * factory call via `opts.resolveRef`. The exception is `allOf` composition,
+ * which must inline ref'd properties to merge them; for that path we resolve
+ * refs via `plugin.context.resolveIrRef` and guard cycles with `visited`.
+ */
+function irToPropertyInfo(name, schema, plugin, visited = new Set()) {
+    if (schema.$ref) {
+        return { type: "ref", name, $ref: schema.$ref };
+    }
+    // IR encodes enums as { type: "enum", items: [{ const: value }, ...] }
+    if (schema.type === "enum" && schema.items?.length) {
+        const values = schema.items
+            .map((item) => item.const)
+            .filter((v) => v !== undefined);
+        return {
+            type: "string",
+            format: schema.format,
+            name,
+            ...(values.length > 0 && { enum: values }),
+        };
+    }
+    // allOf — merge children. Resolve refs inline since merging requires the
+    // target's properties.
+    if (schema.logicalOperator === "and" && schema.items?.length) {
+        const merged = {};
+        for (const part of schema.items) {
+            const partInfo = mergePart(part, plugin, visited);
+            if (partInfo?.children)
+                Object.assign(merged, partInfo.children);
+        }
+        return { type: "object", name, children: merged };
+    }
+    // oneOf / anyOf — record variants for runtime random pick.
+    if (schema.logicalOperator === "or" && schema.items?.length) {
+        return {
+            type: "union",
+            name,
+            variants: schema.items.map((variant, i) => irToPropertyInfo(`${name}_v${i}`, variant, plugin, visited)),
+        };
+    }
+    const type = Array.isArray(schema.type)
+        ? (schema.type.find((t) => t !== "null") ?? "string")
+        : (schema.type ?? "string");
+    const info = { type, format: schema.format, name };
+    if (schema.minimum !== undefined)
+        info.minimum = schema.minimum;
+    if (schema.maximum !== undefined)
+        info.maximum = schema.maximum;
+    if (schema.minLength !== undefined)
+        info.minLength = schema.minLength;
+    if (schema.maxLength !== undefined)
+        info.maxLength = schema.maxLength;
+    if (schema.minItems !== undefined)
+        info.minItems = schema.minItems;
+    if (schema.maxItems !== undefined)
+        info.maxItems = schema.maxItems;
+    if (type === "object" && schema.properties) {
+        info.children = {};
+        for (const [key, value] of Object.entries(schema.properties)) {
+            if (value)
+                info.children[key] = irToPropertyInfo(key, value, plugin, visited);
+        }
+    }
+    if (type === "array" && schema.items?.length) {
+        info.items = irToPropertyInfo("item", schema.items[0], plugin, visited);
+    }
+    return info;
+}
+/** Resolve a part of an allOf composition into an object PropertyInfo. */
+function mergePart(part, plugin, visited) {
+    if (part.$ref) {
+        if (visited.has(part.$ref))
+            return null;
+        const next = new Set(visited);
+        next.add(part.$ref);
+        const target = plugin.context.resolveIrRef(part.$ref);
+        if (!target)
+            return null;
+        return irToPropertyInfo("merged", target, plugin, next);
+    }
+    return irToPropertyInfo("merged", part, plugin, visited);
+}
+const refToSchemaName = (ref) => schemaNameFromRef(ref);
+export const generateFactories = ({ plugin, outputFile, }) => {
+    const config = plugin.config;
+    const faker = plugin.external("@faker-js/faker.faker");
+    const { graph } = buildGraph(plugin.context.spec, plugin.context.logger);
+    const reaches = (fromName, toName) => {
+        for (const [refKey, deps] of graph.transitiveDependencies) {
+            if (refToSchemaName(refKey) !== fromName)
+                continue;
+            for (const dep of deps) {
+                if (refToSchemaName(dep) === toName)
+                    return true;
+            }
+        }
+        return false;
+    };
+    const generatedFactories = [];
+    // Schemas we emit a factory for: plain objects + allOf composition + oneOf/
+    // anyOf unions. Skip raw scalars, top-level enums, and standalone arrays.
+    const isFactoryable = (s) => s.type === "object" ||
+        s.logicalOperator === "and" ||
+        s.logicalOperator === "or";
+    // Pass 2: emit factories.
+    plugin.forEach("schema", (event) => {
+        const { schema, name } = event;
+        if (!name)
+            return;
+        const schemaName = name;
+        if (!isFactoryable(schema))
+            return;
+        if (!shouldIncludeSchema(schemaName, config.include, config.exclude)) {
+            return;
+        }
+        if (config.filter && !config.filter(schema))
+            return;
+        const factoryName = schemaToFactoryName(schemaName);
+        const factorySymbol = plugin.symbol(factoryName, {
+            getFilePath: () => outputFile,
+        });
+        const rootInfo = irToPropertyInfo(schemaName, schema, plugin);
+        const body = buildFakerExpression(faker, rootInfo, {
+            fieldHints: config.fieldNameHints,
+            formatHints: config.formatMapping,
+            respectConstraints: config.respectConstraints,
+            resolveRef: (ref) => {
+                const target = refToSchemaName(ref);
+                if (!target)
+                    return null;
+                if (target === schemaName || reaches(target, schemaName)) {
+                    return $.literal(null);
+                }
+                return $(schemaToFactoryName(target)).call();
+            },
+        });
+        const factoryFn = $.func().do($.return(body));
+        const statement = $.const(factorySymbol).export().assign(factoryFn);
+        plugin.node(statement);
+        generatedFactories.push(schemaName);
+    });
+    if (config.generateBatchCreators && generatedFactories.length > 0) {
+        generateBatchCreators({
+            plugin,
+            outputFile,
+            schemaNames: generatedFactories,
+            faker,
+            defaultCount: config.defaultBatchCount,
+        });
+    }
+};
+function generateBatchCreators({ plugin, outputFile, schemaNames, faker, defaultCount, }) {
+    for (const schemaName of schemaNames) {
+        const factoryName = schemaToFactoryName(schemaName);
+        const batchFactoryName = schemaToBatchFactoryName(schemaName);
+        const batchSymbol = plugin.symbol(batchFactoryName, {
+            getFilePath: () => outputFile,
+        });
+        const countExpr = $.binary($.id("count"), "??", $.literal(defaultCount));
+        const batchCall = $(faker)
+            .attr("helpers")
+            .attr("multiple")
+            .call($.id(factoryName), $.object().prop("count", countExpr));
+        const batchFn = $.func()
+            .param("count", (p) => p.type($.type.expr("number")).optional())
+            .do($.return(batchCall));
+        const statement = $.const(batchSymbol).export().assign(batchFn);
+        plugin.node(statement);
+    }
+}
+//# sourceMappingURL=factories.js.map

package/dist/generators/factories.js.map

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

package/dist/generators/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./factories.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/generators/index.js

@@ -0,0 +1,3 @@
+export * from "./factories.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/generators/types.d.ts

@@ -0,0 +1,13 @@
+import type { FakerPlugin } from "../types.js";
+/**
+ * Plugin instance type for Faker generators
+ */
+export type FakerPluginInstance = Parameters<FakerPlugin["Handler"]>[0]["plugin"];
+/**
+ * Input for factories generator
+ */
+export interface GenerateFactoriesInput {
+    plugin: FakerPluginInstance;
+    outputFile: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/generators/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAC1C,WAAW,CAAC,SAAS,CAAC,CACvB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/generators/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/generators/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/generators/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import "./types.js";
+export { defaultConfig, defineConfig } from "./config.js";
+export * from "./core/index.js";
+export type { FakerPlugin } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Import for side effects to load module augmentation
+import "./types.js";
+export { defaultConfig, defineConfig } from "./config.js";
+export * from "./core/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,cAAc,iBAAiB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,7 @@
+import type { FakerPlugin } from "./types.js";
+/**
+ * Main faker plugin handler.
+ * Generates faker factory functions from OpenAPI schemas.
+ */
+export declare const handler: FakerPlugin["Handler"];
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,SAAS,CAqB1C,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,24 @@
+import { generateFactories } from "./generators/index.js";
+import { registerExternalSymbols } from "./symbols/external.js";
+/**
+ * Main faker plugin handler.
+ * Generates faker factory functions from OpenAPI schemas.
+ */
+export const handler = ({ plugin }) => {
+    // ============================================================================
+    // External Symbols Registration
+    // ============================================================================
+    registerExternalSymbols(plugin);
+    // ============================================================================
+    // File Paths Configuration
+    // ============================================================================
+    const outputFile = `${plugin.name}/${plugin.config.output}`;
+    // ============================================================================
+    // Factory Generation
+    // ============================================================================
+    generateFactories({
+        plugin,
+        outputFile,
+    });
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAA2B,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IAC5D,+EAA+E;IAC/E,gCAAgC;IAChC,+EAA+E;IAE/E,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,+EAA+E;IAC/E,2BAA2B;IAC3B,+EAA+E;IAE/E,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAE5D,+EAA+E;IAC/E,qBAAqB;IACrB,+EAA+E;IAE/E,iBAAiB,CAAC;QAChB,MAAM;QACN,UAAU;KACX,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/symbols/external.d.ts

@@ -0,0 +1,6 @@
+import type { FakerPluginInstance } from "../generators/types.js";
+/**
+ * Register external symbols from faker library
+ */
+export declare const registerExternalSymbols: (plugin: FakerPluginInstance) => void;
+//# sourceMappingURL=external.d.ts.map

package/dist/symbols/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/symbols/external.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,mBAAmB,KAAG,IAMrE,CAAC"}

package/dist/symbols/external.js

@@ -0,0 +1,11 @@
+/**
+ * Register external symbols from faker library
+ */
+export const registerExternalSymbols = (plugin) => {
+    // Register faker as an external symbol that can be used with $()
+    plugin.symbol("faker", {
+        external: "@faker-js/faker",
+        meta: { category: "external", resource: "@faker-js/faker.faker" },
+    });
+};
+//# sourceMappingURL=external.js.map

package/dist/symbols/external.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.js","sourceRoot":"","sources":["../../src/symbols/external.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAA2B,EAAQ,EAAE;IAC3E,iEAAiE;IACjE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QACrB,QAAQ,EAAE,iBAAiB;QAC3B,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,uBAAuB,EAAE;KAClE,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+import type { DefinePlugin, IR, Plugin } from "@hey-api/shared";
+import type { FieldNameHints, FormatMapping } from "./core/types.js";
+export type { FakerMethodPath, FieldNameHints, FormatMapping, } from "./core/types.js";
+export type SchemaFilter = (schema: IR.SchemaObject) => boolean;
+export type UserConfig = Plugin.Hooks & Plugin.UserExports & {
+    name: "@ir-kit/openapi-ts-faker";
+    /**
+     * Output file name for generated factories
+     * @default 'factories.gen'
+     */
+    output?: string;
+    /**
+     * Field name hints. Keys are field names (any case, with or without
+     * separators — `email`, `Email`, `user_email` all normalize the same way).
+     * Values must be valid faker method paths.
+     * @example { email: "internet.email", phone: "phone.number" }
+     */
+    fieldNameHints?: FieldNameHints;
+    /**
+     * OpenAPI format → faker method mapping. Merged with defaults.
+     */
+    formatMapping?: FormatMapping;
+    /** Include only these schemas (by name). Mutually exclusive with `exclude`. */
+    include?: readonly string[];
+    /** Exclude these schemas (by name). Mutually exclusive with `include`. */
+    exclude?: readonly string[];
+    /** Custom filter function for schemas. */
+    filter?: SchemaFilter;
+    /**
+     * Generate batch creator functions (e.g. `createMockUsers(count)`).
+     * @default true
+     */
+    generateBatchCreators?: boolean;
+    /**
+     * Default count for batch creators when caller omits the argument.
+     * @default 10
+     */
+    defaultBatchCount?: number;
+    /**
+     * Honor `minimum`/`maximum` and `minLength`/`maxLength` from the spec.
+     * Numeric methods receive `{ min, max }`; constrained strings switch to
+     * `string.alpha` with `{ length }`.
+     * @default true
+     */
+    respectConstraints?: boolean;
+};
+export type Config = Plugin.Hooks & Plugin.Exports & {
+    name: "@ir-kit/openapi-ts-faker";
+    output: string;
+    fieldNameHints: FieldNameHints;
+    formatMapping: FormatMapping;
+    include?: readonly string[];
+    exclude?: readonly string[];
+    filter?: SchemaFilter;
+    generateBatchCreators: boolean;
+    defaultBatchCount: number;
+    respectConstraints: boolean;
+};
+export type FakerPlugin = DefinePlugin<UserConfig, Config>;
+declare module "@hey-api/openapi-ts" {
+    interface PluginConfigMap {
+        "@ir-kit/openapi-ts-faker": FakerPlugin["Types"];
+    }
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,KAAK,OAAO,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GACnC,MAAM,CAAC,WAAW,GAAG;IACnB,IAAI,EAAE,0BAA0B,CAAC;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEJ,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,GAC/B,MAAM,CAAC,OAAO,GAAG;IACf,IAAI,EAAE,0BAA0B,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEJ,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAE3D,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAiB,eAAe;QAC9B,0BAA0B,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;KAClD;CACF"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Convert a schema name to a factory function name
+ * @example "User" -> "createMockUser"
+ * @example "BlogPost" -> "createMockBlogPost"
+ */
+export declare const schemaToFactoryName: (schemaName: string) => string;
+/**
+ * Convert a schema name to a batch factory function name
+ * @example "User" -> "createMockUsers"
+ * @example "Post" -> "createMockPosts"
+ */
+export declare const schemaToBatchFactoryName: (schemaName: string) => string;
+/**
+ * Check if a schema should be included based on filters
+ */
+export declare const shouldIncludeSchema: (schemaName: string, include?: readonly string[], exclude?: readonly string[]) => boolean;
+/**
+ * Safely access nested faker methods
+ * @example "internet.email" -> "faker.internet.email()"
+ * @example "number.int" -> "faker.number.int()"
+ */
+export declare const getFakerMethodCall: (method: string, args?: Record<string, any>) => string;
+/**
+ * Escape strings for JSDoc comments
+ */
+export declare const escapeJsDoc: (text: string) => string;
+/**
+ * Generate JSDoc comment for a factory function
+ */
+export declare const generateFactoryJsDoc: (schemaName: string, description?: string) => string;
+/**
+ * Generate JSDoc comment for a batch factory function
+ */
+export declare const generateBatchFactoryJsDoc: (schemaName: string, defaultCount: number) => string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/utils/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,MAExD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,YAAY,MAAM,KAAG,MAS7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,YAAY,MAAM,EAClB,UAAU,SAAS,MAAM,EAAE,EAC3B,UAAU,SAAS,MAAM,EAAE,KAC1B,OAUF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,OAAO,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACzB,MAKF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAE1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,EAClB,cAAc,MAAM,KACnB,MAgBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,EAClB,cAAc,MAAM,KACnB,MAQF,CAAC"}

package/dist/utils/helpers.js

@@ -0,0 +1,78 @@
+/**
+ * Convert a schema name to a factory function name
+ * @example "User" -> "createMockUser"
+ * @example "BlogPost" -> "createMockBlogPost"
+ */
+export const schemaToFactoryName = (schemaName) => {
+    return `createMock${schemaName}`;
+};
+/**
+ * Convert a schema name to a batch factory function name
+ * @example "User" -> "createMockUsers"
+ * @example "Post" -> "createMockPosts"
+ */
+export const schemaToBatchFactoryName = (schemaName) => {
+    // Simple pluralization (handles most common cases)
+    const pluralized = schemaName.endsWith("s")
+        ? schemaName
+        : schemaName.endsWith("y")
+            ? `${schemaName.slice(0, -1)}ies`
+            : `${schemaName}s`;
+    return `createMock${pluralized}`;
+};
+/**
+ * Check if a schema should be included based on filters
+ */
+export const shouldIncludeSchema = (schemaName, include, exclude) => {
+    if (include && include.length > 0) {
+        return include.includes(schemaName);
+    }
+    if (exclude && exclude.length > 0) {
+        return !exclude.includes(schemaName);
+    }
+    return true;
+};
+/**
+ * Safely access nested faker methods
+ * @example "internet.email" -> "faker.internet.email()"
+ * @example "number.int" -> "faker.number.int()"
+ */
+export const getFakerMethodCall = (method, args) => {
+    const hasArgs = args && Object.keys(args).length > 0;
+    const argsString = hasArgs ? JSON.stringify(args) : "";
+    return `faker.${method}(${argsString})`;
+};
+/**
+ * Escape strings for JSDoc comments
+ */
+export const escapeJsDoc = (text) => {
+    return text.replace(/\*\//g, "*\\/").replace(/\/\*/g, "/\\*");
+};
+/**
+ * Generate JSDoc comment for a factory function
+ */
+export const generateFactoryJsDoc = (schemaName, description) => {
+    const lines = ["/**"];
+    if (description) {
+        lines.push(` * ${escapeJsDoc(description)}`);
+        lines.push(" *");
+    }
+    lines.push(` * Factory function to create mock ${schemaName} data`);
+    lines.push(" * @param overrides - Partial object to override generated values");
+    lines.push(` * @returns Mock ${schemaName} object`);
+    lines.push(" */");
+    return lines.join("\n");
+};
+/**
+ * Generate JSDoc comment for a batch factory function
+ */
+export const generateBatchFactoryJsDoc = (schemaName, defaultCount) => {
+    return [
+        "/**",
+        ` * Generate multiple mock ${schemaName} objects`,
+        ` * @param count - Number of objects to generate (default: ${defaultCount})`,
+        ` * @returns Array of mock ${schemaName} objects`,
+        " */",
+    ].join("\n");
+};
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./helpers.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from "./helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@ir-kit/openapi-ts-faker",
+  "version": "0.1.0",
+  "description": "Faker.js plugin for @hey-api/openapi-ts - Generate realistic mock data factories from OpenAPI specs",
+  "keywords": [
+    "openapi",
+    "openapi-ts",
+    "faker",
+    "fakerjs",
+    "mock",
+    "mocking",
+    "testing",
+    "typescript",
+    "codegen",
+    "type-safe",
+    "plugin"
+  ],
+  "homepage": "https://github.com/ir-kit/ir-kit/tree/main/packages/openapi/plugins/faker",
+  "bugs": {
+    "url": "https://github.com/ir-kit/ir-kit/issues"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Rowaihi",
+    "email": "ahmedrowaihi@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ir-kit/ir-kit.git",
+    "directory": "packages/openapi/plugins/faker"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@faker-js/faker": "^10.0.0 || ^9.0.0 || ^8.0.0",
+    "@hey-api/codegen-core": ">=0.7.0",
+    "@hey-api/openapi-ts": ">=0.95.0",
+    "@hey-api/shared": ">=0.2.0",
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@faker-js/faker": "^10.4.0",
+    "@hey-api/codegen-core": "^0.8.1",
+    "@hey-api/openapi-ts": "^0.97.0",
+    "@hey-api/shared": "^0.4.2",
+    "@types/node": "^22",
+    "typescript": "5.9.3",
+    "@ir-kit/tsconfig": "0.0.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}