@kubb/plugin-faker 5.1.1 → 5.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/OVERVIEW.md +18 -0
- package/dist/index.cjs +37 -29
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +38 -30
- package/dist/index.js.map +1 -1
- package/kubb-extension.json +189 -0
- package/package.json +8 -5
package/OVERVIEW.md
ADDED
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Faker
|
|
2
|
+
|
|
3
|
+
Generates a Faker.js mock-data factory for every schema in your OpenAPI spec. Use the factories in tests, Storybook, and local development without a running backend. Each factory accepts partial data that overrides the generated values.
|
|
4
|
+
|
|
5
|
+
`@kubb/plugin-msw` can use these factories to fill mock responses.
|
|
6
|
+
|
|
7
|
+
## Setup
|
|
8
|
+
|
|
9
|
+
- Add `@kubb/plugin-ts` for the factory return types.
|
|
10
|
+
- Install `@faker-js/faker` v9 or higher in the app that uses the generated code.
|
|
11
|
+
|
|
12
|
+
## Options worth knowing
|
|
13
|
+
|
|
14
|
+
- `seed` passes a fixed seed to `faker.seed(...)`, so every run returns the same data.
|
|
15
|
+
- `locale` sets the Faker locale. The default is `en`.
|
|
16
|
+
- `dateParser` formats date and time strings with `faker` (default), `dayjs`, or `moment`. Install the library you pick.
|
|
17
|
+
- `regexGenerator` turns a `pattern` into a string with `faker` (default) or `randexp`.
|
|
18
|
+
- `typeMode` sets the factory types: `inferred` (default) derives them from the generated values, `schema` uses the declared model type.
|
package/dist/index.cjs
CHANGED
|
@@ -1497,6 +1497,15 @@ const fakerGenerator = (0, kubb_kit.defineGenerator)({
|
|
|
1497
1497
|
}
|
|
1498
1498
|
});
|
|
1499
1499
|
//#endregion
|
|
1500
|
+
//#region kubb-extension.json
|
|
1501
|
+
var compatibility = {
|
|
1502
|
+
"kubb": ">=5.8.0",
|
|
1503
|
+
"node": ">=22"
|
|
1504
|
+
};
|
|
1505
|
+
//#endregion
|
|
1506
|
+
//#region package.json
|
|
1507
|
+
var version = "5.1.3";
|
|
1508
|
+
//#endregion
|
|
1500
1509
|
//#region src/resolvers/resolverFaker.ts
|
|
1501
1510
|
/**
|
|
1502
1511
|
* Default resolver used by `@kubb/plugin-faker`. Decides the names and file
|
|
@@ -1550,36 +1559,35 @@ const pluginFakerName = "plugin-faker";
|
|
|
1550
1559
|
* })
|
|
1551
1560
|
* ```
|
|
1552
1561
|
*/
|
|
1553
|
-
const pluginFaker = (0, kubb_kit.definePlugin)(
|
|
1554
|
-
|
|
1555
|
-
path: "mocks",
|
|
1556
|
-
barrel: { type: "named" }
|
|
1557
|
-
}, seed, locale = "en", group, exclude = [], include, override = [], typeMode = "inferred", dateParser = "faker", regexGenerator = "faker", printer, resolver: userResolver, macros: userMacros } = options;
|
|
1558
|
-
const groupConfig = createGroupConfig(group);
|
|
1559
|
-
return {
|
|
1562
|
+
const pluginFaker = (0, kubb_kit.definePlugin)({
|
|
1563
|
+
meta: {
|
|
1560
1564
|
name: pluginFakerName,
|
|
1561
|
-
|
|
1562
|
-
|
|
1563
|
-
|
|
1564
|
-
|
|
1565
|
-
|
|
1566
|
-
|
|
1567
|
-
|
|
1568
|
-
|
|
1569
|
-
|
|
1570
|
-
|
|
1571
|
-
|
|
1572
|
-
|
|
1573
|
-
|
|
1574
|
-
|
|
1575
|
-
|
|
1576
|
-
|
|
1577
|
-
|
|
1578
|
-
|
|
1579
|
-
|
|
1580
|
-
|
|
1581
|
-
|
|
1582
|
-
|
|
1565
|
+
version,
|
|
1566
|
+
compatibility
|
|
1567
|
+
},
|
|
1568
|
+
dependencies: { [_kubb_plugin_ts.pluginTsName]: {} },
|
|
1569
|
+
setup(options) {
|
|
1570
|
+
const { output = {
|
|
1571
|
+
path: "mocks",
|
|
1572
|
+
barrel: { type: "named" }
|
|
1573
|
+
}, seed, locale = "en", group, exclude = [], include, override = [], typeMode = "inferred", dateParser = "faker", regexGenerator = "faker", printer, resolver: userResolver, macros: userMacros } = options;
|
|
1574
|
+
(0, kubb_kit.setResolver)(userResolver ? kubb_kit.Resolver.merge(resolverFaker, userResolver) : resolverFaker);
|
|
1575
|
+
if (userMacros?.length) (0, kubb_kit.setMacros)(userMacros);
|
|
1576
|
+
(0, kubb_kit.addGenerator)(fakerGenerator);
|
|
1577
|
+
return {
|
|
1578
|
+
output,
|
|
1579
|
+
seed,
|
|
1580
|
+
locale,
|
|
1581
|
+
exclude,
|
|
1582
|
+
include,
|
|
1583
|
+
override,
|
|
1584
|
+
typeMode,
|
|
1585
|
+
group: createGroupConfig(group),
|
|
1586
|
+
dateParser,
|
|
1587
|
+
regexGenerator,
|
|
1588
|
+
printer
|
|
1589
|
+
};
|
|
1590
|
+
}
|
|
1583
1591
|
});
|
|
1584
1592
|
//#endregion
|
|
1585
1593
|
exports.Faker = Faker;
|