@przeslijmi/real-fake-data-playwright 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karol Nowakowski
+
+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,120 @@
+# @przeslijmi/real-fake-data-playwright
+
+Playwright fixtures for [Real Fake Data](https://github.com/przeslijmi/rfd) — realistic, synthetic **Polish** test data with one line per record: valid PESELs (correct checksums), NIPs, REGONs, IBANs, addresses drawn from real cities and streets, people, company names, and vehicle plates.
+
+Output _looks_ real but is fake — safe for staging, demos, and seed data.
+
+- **Seeded and reproducible by default.** Each test derives a stable seed from its title, so a failing test replays the exact same data on the next run — no flakiness, trivial repro.
+- **Typed end to end.** One method per generator, fully typed inputs and results.
+- **Zero ceremony.** A `fakeData` fixture; no manual client wiring.
+
+## Install
+
+```sh
+npm install -D @przeslijmi/real-fake-data-playwright
+# or: pnpm add -D @przeslijmi/real-fake-data-playwright
+```
+
+Requires `@playwright/test` (peer dependency) and Node 18+ (for global `fetch`).
+
+## Quick start
+
+Point the fixture at a Real Fake Data API instance, then pull data inside any test:
+
+```ts
+import { test, expect } from '@przeslijmi/real-fake-data-playwright';
+
+test.use({ realFakeData: { baseUrl: 'https://api.real-fake-data.example' } });
+
+test('registers a new customer', async ({ page, fakeData }) => {
+  const person = await fakeData.person({ sex: 'f' });
+
+  await page.goto('/signup');
+  await page.getByLabel('First name').fill(person.name);
+  await page.getByLabel('Surname').fill(person.surname);
+  await page.getByLabel('PESEL').fill(person.pesel);
+  await page.getByRole('button', { name: 'Create account' }).click();
+
+  await expect(page.getByText(person.surname)).toBeVisible();
+});
+```
+
+`test` and `expect` are the standard Playwright exports, extended with the `fakeData` fixture — use them exactly as you would `@playwright/test`.
+
+## Configuration
+
+Set options with `test.use({ realFakeData: { … } })`, at any scope (file, `describe`, or project, via your Playwright config).
+
+| Option    | Type                     | Description                                                                                              |
+| --------- | ------------------------ | ------------------------------------------------------------------------------------------------------- |
+| `baseUrl` | `string` (required)      | Base URL of the Real Fake Data API, e.g. `https://api.example.com`.                                      |
+| `seed`    | `number`                 | Base seed for the test. Omit to derive a stable seed from the test title (reproducible-by-default).      |
+| `headers` | `Record<string, string>` | Extra headers sent with every request (e.g. an API key once your plan requires one).                    |
+
+### Determinism
+
+With a base seed in play, the **Nth call within a test uses `seed + N`** — so calls are reproducible across runs yet distinct from one another. Because the default seed comes from the test title, every test is already deterministic without configuring anything; set `seed` explicitly only when you want to pin a test to a known fixed dataset.
+
+```ts
+test.use({ realFakeData: { baseUrl, seed: 42 } }); // pin this file to a fixed dataset
+```
+
+## Generators
+
+Every method returns a typed result and accepts optional constraints. Pass `seed` on any call to override that call's automatic seed.
+
+| Method                            | Returns                                                       | Common options                                                        |
+| --------------------------------- | ------------------------------------------------------------ | --------------------------------------------------------------------- |
+| `fakeData.pesel(opts?)`           | `{ value, birthDate, sex }`                                   | `sex`, `atAge`, `olderThan`, `youngerThan`, `bornOn/Before/After`, `invalid` |
+| `fakeData.person(opts?)`          | `{ name, surname, initials, birthDate, pesel }`              | same as `pesel`                                                       |
+| `fakeData.address(opts?)`         | `{ buildingNumber, postalCode, cityName, …, terytCodes }`   | `teryt` (1–7 digit prefix)                                            |
+| `fakeData.nip(opts?)`             | `{ value, digits }`                                           | `format`, `invalid`                                                   |
+| `fakeData.iban(opts?)`            | `{ value, electronicFormat, bankCode, bankName }`           | `format`, `bankCode`, `bankName`, `invalid`                          |
+| `fakeData.regon(opts?)`           | `{ value, variant }`                                          | `variant` (`short`/`long`/`any`), `invalid`                          |
+| `fakeData.companyName(opts?)`     | `{ value, legalForm, strategy }`                             | `strategy`, `legalForm`, `activityPrefix`                            |
+| `fakeData.vehicleRegistration(opts?)` | `{ value, prefix, individualPart, type, … }`            | `type`, `voivodeship`, `county`, `format`                           |
+
+### Testing your validators
+
+Every checksum generator accepts `invalid: true` to produce a value with a **deliberately wrong check digit** (the rest stays well-formed) — for asserting that your own validators reject bad input:
+
+```ts
+const bad = await fakeData.nip({ invalid: true });
+await expect(submitNip(bad.value)).rejects.toThrow('invalid checksum');
+```
+
+## Error handling
+
+A non-2xx API response throws a `RealFakeDataError` carrying `status` (HTTP code), `code` (the API's machine error code), and `details` (per-field validation messages):
+
+```ts
+import { RealFakeDataError } from '@przeslijmi/real-fake-data-playwright';
+
+try {
+  await fakeData.address({ teryt: 'not-digits' });
+} catch (error) {
+  if (error instanceof RealFakeDataError) {
+    console.log(error.status, error.code, error.details);
+    // 400 'VALIDATION_ERROR' [{ path: 'teryt', message: 'teryt must be 1–7 digits' }]
+  }
+}
+```
+
+## Advanced: using the client without the fixture
+
+The fixture is a thin wrapper over a provider and a facade you can use directly — handy in global setup, scripts, or non-Playwright code:
+
+```ts
+import { CloudFakeDataProvider, createFakeData } from '@przeslijmi/real-fake-data-playwright';
+
+const provider = new CloudFakeDataProvider({ baseUrl: 'https://api.example.com' });
+const fakeData = createFakeData(provider, { seed: 42 });
+
+const company = await fakeData.companyName({ legalForm: 'S.A.' });
+```
+
+The `FakeDataProvider` interface is the swap point: the cloud provider talks HTTP to the hosted API, and the same facade can run against other backends.
+
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+/** One field-level problem reported by the API for a bad request. */
+export interface RealFakeDataErrorDetail {
+    readonly path: string;
+    readonly message: string;
+}
+/**
+ * Thrown when a Real Fake Data request fails: a non-2xx API response
+ * (`status` carries the HTTP code, `code` the API's machine error code) or a
+ * transport/configuration failure (`status` is `0`).
+ */
+export declare class RealFakeDataError extends Error {
+    readonly status: number;
+    readonly code: string | undefined;
+    readonly details: readonly RealFakeDataErrorDetail[] | undefined;
+    constructor(message: string, status: number, code?: string, details?: readonly RealFakeDataErrorDetail[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,SAAgB,OAAO,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,CAAC;gBAGtE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,SAAS,uBAAuB,EAAE;CAQ/C"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+/**
+ * Thrown when a Real Fake Data request fails: a non-2xx API response
+ * (`status` carries the HTTP code, `code` the API's machine error code) or a
+ * transport/configuration failure (`status` is `0`).
+ */
+export class RealFakeDataError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, status, code, details) {
+        super(message);
+        this.name = 'RealFakeDataError';
+        this.status = status;
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1B,MAAM,CAAS;IACf,IAAI,CAAqB;IACzB,OAAO,CAAiD;IAExE,YACE,OAAe,EACf,MAAc,EACd,IAAa,EACb,OAA4C;QAE5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/fake-data-provider.d.ts

@@ -0,0 +1,26 @@
+/** A query value as it goes on the wire; `undefined` entries are dropped. */
+export type QueryValue = string | number | boolean | undefined;
+/** Reproducibility metadata every generator response carries. */
+export interface GeneratorMeta {
+    readonly seed: number;
+    readonly generatorId: string;
+    readonly [key: string]: unknown;
+}
+/** The `{ data, meta }` envelope every Real Fake Data endpoint returns. */
+export interface GeneratorResponse<Data> {
+    readonly data: Data;
+    readonly meta: GeneratorMeta;
+}
+/**
+ * The swappable transport seam.
+ *
+ * The cloud provider speaks HTTP to the Real Fake Data API; a future
+ * on-premise provider will run the generators in-process. Both produce the
+ * same `{ data, meta }` envelope, so the typed {@link FakeData} facade is
+ * written once on top of this interface and never needs to know which
+ * backend is behind it.
+ */
+export interface FakeDataProvider {
+    generate<Data>(path: string, query: Readonly<Record<string, QueryValue>>): Promise<GeneratorResponse<Data>>;
+}
+//# sourceMappingURL=fake-data-provider.d.ts.map

package/dist/fake-data-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-data-provider.d.ts","sourceRoot":"","sources":["../src/fake-data-provider.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/D,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB,CAAC,IAAI;IACrC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAC1C,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;CACrC"}

package/dist/fake-data-provider.js

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

package/dist/fake-data-provider.js.map

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

package/dist/fake-data.d.ts

@@ -0,0 +1,28 @@
+import type { FakeDataProvider } from './fake-data-provider.js';
+import type { AddressOptions, CompanyNameOptions, IbanOptions, NipOptions, PeselOptions, PersonOptions, PolishAddressData, PolishCompanyNameData, PolishIbanData, PolishNipData, PolishPeselData, PolishPersonData, PolishRegonData, PolishVehicleRegistrationData, RegonOptions, VehicleRegistrationOptions } from './types.js';
+/** The typed surface tests use; one method per Real Fake Data generator. */
+export interface FakeData {
+    pesel(options?: PeselOptions): Promise<PolishPeselData>;
+    person(options?: PersonOptions): Promise<PolishPersonData>;
+    address(options?: AddressOptions): Promise<PolishAddressData>;
+    nip(options?: NipOptions): Promise<PolishNipData>;
+    iban(options?: IbanOptions): Promise<PolishIbanData>;
+    regon(options?: RegonOptions): Promise<PolishRegonData>;
+    companyName(options?: CompanyNameOptions): Promise<PolishCompanyNameData>;
+    vehicleRegistration(options?: VehicleRegistrationOptions): Promise<PolishVehicleRegistrationData>;
+}
+export interface CreateFakeDataOptions {
+    /**
+     * Base seed for this instance. When set, the Nth call uses `seed + N`, so a
+     * re-run with the same base seed produces identical-but-distinct data.
+     * When omitted, the API randomises each call.
+     */
+    readonly seed?: number;
+}
+/**
+ * Builds a {@link FakeData} facade over any {@link FakeDataProvider}. Owns the
+ * per-call seed sequence so that calls are reproducible across runs yet
+ * distinct within a run.
+ */
+export declare const createFakeData: (provider: FakeDataProvider, options?: CreateFakeDataOptions) => FakeData;
+//# sourceMappingURL=fake-data.d.ts.map

package/dist/fake-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-data.d.ts","sourceRoot":"","sources":["../src/fake-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,6BAA6B,EAC7B,YAAY,EAEZ,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,4EAA4E;AAC5E,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3D,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC9D,GAAG,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACrD,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxD,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC1E,mBAAmB,CACjB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,gBAAgB,EAC1B,UAAS,qBAA0B,KAClC,QAwCF,CAAC"}

package/dist/fake-data.js

@@ -0,0 +1,41 @@
+/**
+ * Builds a {@link FakeData} facade over any {@link FakeDataProvider}. Owns the
+ * per-call seed sequence so that calls are reproducible across runs yet
+ * distinct within a run.
+ */
+export const createFakeData = (provider, options = {}) => {
+    const baseSeed = options.seed;
+    let counter = 0;
+    const nextSeed = (override) => {
+        if (override !== undefined) {
+            return override;
+        }
+        if (baseSeed === undefined) {
+            return undefined;
+        }
+        const seed = baseSeed + counter;
+        counter += 1;
+        return seed;
+    };
+    const run = async (path, callOptions) => {
+        const { seed, ...rest } = callOptions;
+        // `rest` carries each method's wire params verbatim; the facade only adds
+        // the resolved seed before handing them to the transport.
+        const response = await provider.generate(path, {
+            ...rest,
+            seed: nextSeed(seed),
+        });
+        return response.data;
+    };
+    return {
+        pesel: async (peselOptions = {}) => await run('pl/pesel', peselOptions),
+        person: async (personOptions = {}) => await run('pl/person', personOptions),
+        address: async (addressOptions = {}) => await run('pl/address', addressOptions),
+        nip: async (nipOptions = {}) => await run('pl/nip', nipOptions),
+        iban: async (ibanOptions = {}) => await run('pl/iban', ibanOptions),
+        regon: async (regonOptions = {}) => await run('pl/regon', regonOptions),
+        companyName: async (companyNameOptions = {}) => await run('pl/company-name', companyNameOptions),
+        vehicleRegistration: async (vehicleOptions = {}) => await run('pl/vehicle-registration', vehicleOptions),
+    };
+};
+//# sourceMappingURL=fake-data.js.map

package/dist/fake-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-data.js","sourceRoot":"","sources":["../src/fake-data.ts"],"names":[],"mappings":"AA4CA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAA0B,EAC1B,UAAiC,EAAE,EACzB,EAAE;IACZ,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,QAAQ,GAAG,CAAC,QAA4B,EAAsB,EAAE;QACpE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,KAAK,EAAQ,IAAY,EAAE,WAA2B,EAAiB,EAAE;QACnF,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,WAAW,CAAC;QACtC,0EAA0E;QAC1E,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAO,IAAI,EAAE;YACnD,GAAG,IAAI;YACP,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;SACrB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,GAAG,CAAkB,UAAU,EAAE,YAAY,CAAC;QACxF,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,GAAG,CAAmB,WAAW,EAAE,aAAa,CAAC;QAC7F,OAAO,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,EAAE,EAAE,CACrC,MAAM,GAAG,CAAoB,YAAY,EAAE,cAAc,CAAC;QAC5D,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,GAAG,CAAgB,QAAQ,EAAE,UAAU,CAAC;QAC9E,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,GAAG,CAAiB,SAAS,EAAE,WAAW,CAAC;QACnF,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,GAAG,CAAkB,UAAU,EAAE,YAAY,CAAC;QACxF,WAAW,EAAE,KAAK,EAAE,kBAAkB,GAAG,EAAE,EAAE,EAAE,CAC7C,MAAM,GAAG,CAAwB,iBAAiB,EAAE,kBAAkB,CAAC;QACzE,mBAAmB,EAAE,KAAK,EAAE,cAAc,GAAG,EAAE,EAAE,EAAE,CACjD,MAAM,GAAG,CAAgC,yBAAyB,EAAE,cAAc,CAAC;KACtF,CAAC;AACJ,CAAC,CAAC"}

package/dist/fixture.d.ts

@@ -0,0 +1,26 @@
+import type { FakeData } from './fake-data.js';
+/** Test-level configuration, set with `test.use({ realFakeData: { … } })`. */
+export interface RealFakeDataConfig {
+    /** Base URL of the Real Fake Data API, e.g. `https://api.example.com`. */
+    baseUrl: string;
+    /**
+     * Base seed for the test. When omitted, a stable seed is derived from the
+     * test title, so each test is reproducible-by-default yet distinct from its
+     * neighbours. Set it explicitly to pin a test to known data.
+     */
+    seed?: number;
+    /** Extra headers (e.g. authentication) sent with every request. */
+    headers?: Record<string, string>;
+}
+export interface RealFakeDataFixtures {
+    realFakeData: RealFakeDataConfig;
+    fakeData: FakeData;
+}
+/**
+ * A Playwright `test` extended with a `fakeData` fixture. Configure the API
+ * location once with `test.use({ realFakeData: { baseUrl: '…' } })`, then pull
+ * synthetic data inside any test via the `fakeData` fixture.
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & RealFakeDataFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export { expect } from '@playwright/test';
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,oQAUf,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/fixture.js

@@ -0,0 +1,22 @@
+import { test as base } from '@playwright/test';
+import { createFakeData } from './fake-data.js';
+import { hashString } from './hash.js';
+import { CloudFakeDataProvider } from './providers/cloud-provider.js';
+/**
+ * A Playwright `test` extended with a `fakeData` fixture. Configure the API
+ * location once with `test.use({ realFakeData: { baseUrl: '…' } })`, then pull
+ * synthetic data inside any test via the `fakeData` fixture.
+ */
+export const test = base.extend({
+    realFakeData: [{ baseUrl: '' }, { option: true }],
+    fakeData: async ({ realFakeData }, use, testInfo) => {
+        const provider = new CloudFakeDataProvider({
+            baseUrl: realFakeData.baseUrl,
+            ...(realFakeData.headers === undefined ? {} : { headers: realFakeData.headers }),
+        });
+        const seed = realFakeData.seed ?? hashString(testInfo.titlePath.join(' › '));
+        await use(createFakeData(provider, { seed }));
+    },
+});
+export { expect } from '@playwright/test';
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAqBtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAuB;IACpD,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjD,QAAQ,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,IAAI,qBAAqB,CAAC;YACzC,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,GAAG,CAAC,YAAY,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;SACjF,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7E,MAAM,GAAG,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;CACF,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A stable 32-bit FNV-1a hash of a string, returned as an unsigned integer.
+ * Used to derive a per-test base seed from the test title so that, absent an
+ * explicit seed, each test still gets reproducible-but-distinct data.
+ */
+export declare const hashString: (value: string) => number;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAO1C,CAAC"}

package/dist/hash.js

@@ -0,0 +1,14 @@
+/**
+ * A stable 32-bit FNV-1a hash of a string, returned as an unsigned integer.
+ * Used to derive a per-test base seed from the test title so that, absent an
+ * explicit seed, each test still gets reproducible-but-distinct data.
+ */
+export const hashString = (value) => {
+    let hash = 2_166_136_261;
+    for (const character of value) {
+        hash ^= character.codePointAt(0) ?? 0;
+        hash = Math.imul(hash, 16_777_619);
+    }
+    return hash >>> 0;
+};
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,IAAI,IAAI,GAAG,aAAa,CAAC;IACzB,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC;AACpB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { test, expect } from './fixture.js';
+export type { RealFakeDataConfig, RealFakeDataFixtures } from './fixture.js';
+export { createFakeData } from './fake-data.js';
+export type { CreateFakeDataOptions, FakeData } from './fake-data.js';
+export { CloudFakeDataProvider } from './providers/cloud-provider.js';
+export type { CloudFakeDataProviderOptions, FetchLike } from './providers/cloud-provider.js';
+export type { FakeDataProvider, GeneratorMeta, GeneratorResponse, QueryValue, } from './fake-data-provider.js';
+export { RealFakeDataError } from './errors.js';
+export type { RealFakeDataErrorDetail } from './errors.js';
+export type * 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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,YAAY,EAAE,4BAA4B,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE7F,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { test, expect } from './fixture.js';
+export { createFakeData } from './fake-data.js';
+export { CloudFakeDataProvider } from './providers/cloud-provider.js';
+export { RealFakeDataError } from './errors.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,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAUtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/cloud-provider.d.ts

@@ -0,0 +1,23 @@
+import type { FakeDataProvider, GeneratorResponse, QueryValue } from '../fake-data-provider.js';
+/** The subset of the global `fetch` signature this provider relies on. */
+export type FetchLike = (input: string | URL, init?: RequestInit) => Promise<Response>;
+export interface CloudFakeDataProviderOptions {
+    /** Base URL of the Real Fake Data API, e.g. `https://api.example.com`. */
+    readonly baseUrl: string;
+    /** Extra headers (e.g. authentication) sent with every request. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Custom fetch implementation; defaults to the global `fetch`. */
+    readonly fetch?: FetchLike;
+}
+/**
+ * A {@link FakeDataProvider} that calls the hosted Real Fake Data API over
+ * HTTP. It maps `(path, query)` to `GET {baseUrl}/v1/{path}?{query}` and
+ * unwraps the `{ data, meta }` envelope, turning non-2xx responses into a
+ * {@link RealFakeDataError}.
+ */
+export declare class CloudFakeDataProvider implements FakeDataProvider {
+    #private;
+    constructor(options: CloudFakeDataProviderOptions);
+    generate<Data>(path: string, query: Readonly<Record<string, QueryValue>>): Promise<GeneratorResponse<Data>>;
+}
+//# sourceMappingURL=cloud-provider.d.ts.map

package/dist/providers/cloud-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-provider.d.ts","sourceRoot":"","sources":["../../src/providers/cloud-provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEhG,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvF,MAAM,WAAW,4BAA4B;IAC3C,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;;gBAKzC,OAAO,EAAE,4BAA4B;IAM3C,QAAQ,CAAC,IAAI,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAC1C,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;CAiCpC"}

package/dist/providers/cloud-provider.js

@@ -0,0 +1,64 @@
+import { RealFakeDataError } from '../errors.js';
+/**
+ * A {@link FakeDataProvider} that calls the hosted Real Fake Data API over
+ * HTTP. It maps `(path, query)` to `GET {baseUrl}/v1/{path}?{query}` and
+ * unwraps the `{ data, meta }` envelope, turning non-2xx responses into a
+ * {@link RealFakeDataError}.
+ */
+export class CloudFakeDataProvider {
+    #baseUrl;
+    #headers;
+    #fetch;
+    constructor(options) {
+        this.#baseUrl = options.baseUrl.replace(/\/+$/u, '');
+        this.#headers = { ...options.headers };
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    async generate(path, query) {
+        if (this.#baseUrl === '') {
+            throw new RealFakeDataError('Real Fake Data baseUrl is not configured. Set it via ' +
+                'test.use({ realFakeData: { baseUrl: "https://…" } }).', 0);
+        }
+        const url = new URL(`${this.#baseUrl}/v1/${path}`);
+        for (const [key, value] of Object.entries(query)) {
+            if (value !== undefined) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        let response;
+        try {
+            response = await this.#fetch(url, { headers: this.#headers });
+        }
+        catch (error) {
+            throw new RealFakeDataError(`Request to ${url.pathname} failed: ${error instanceof Error ? error.message : String(error)}`, 0);
+        }
+        if (!response.ok) {
+            throw await toError(response, url);
+        }
+        const body = await response.json();
+        return body;
+    }
+}
+const isErrorDetail = (value) => typeof value === 'object' &&
+    value !== null &&
+    typeof value.path === 'string' &&
+    typeof value.message === 'string';
+const toError = async (response, url) => {
+    let parsed;
+    try {
+        parsed = await response.json();
+    }
+    catch {
+        parsed = undefined;
+    }
+    const apiError = parsed?.error;
+    const message = typeof apiError?.message === 'string'
+        ? apiError.message
+        : `Request to ${url.pathname} failed with status ${String(response.status)}`;
+    const code = typeof apiError?.code === 'string' ? apiError.code : undefined;
+    const details = Array.isArray(apiError?.details)
+        ? apiError.details.filter((detail) => isErrorDetail(detail))
+        : undefined;
+    return new RealFakeDataError(message, response.status, code, details !== undefined && details.length > 0 ? details : undefined);
+};
+//# sourceMappingURL=cloud-provider.js.map

package/dist/providers/cloud-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-provider.js","sourceRoot":"","sources":["../../src/providers/cloud-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAgBjD;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAAS;IACjB,QAAQ,CAAyB;IACjC,MAAM,CAAY;IAE3B,YAAmB,OAAqC;QACtD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAClD,CAAC;IAEM,KAAK,CAAC,QAAQ,CACnB,IAAY,EACZ,KAA2C;QAE3C,IAAI,IAAI,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;YACzB,MAAM,IAAI,iBAAiB,CACzB,uDAAuD;gBACrD,uDAAuD,EACzD,CAAC,CACF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,OAAO,IAAI,EAAE,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,iBAAiB,CACzB,cAAc,GAAG,CAAC,QAAQ,YAAY,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAC9F,CAAC,CACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,MAAM,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5C,OAAO,IAA+B,CAAC;IACzC,CAAC;CACF;AAUD,MAAM,aAAa,GAAG,CAAC,KAAc,EAAoC,EAAE,CACzE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;IACtD,OAAQ,KAA+B,CAAC,OAAO,KAAK,QAAQ,CAAC;AAE/D,MAAM,OAAO,GAAG,KAAK,EAAE,QAAkB,EAAE,GAAQ,EAA8B,EAAE;IACjF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,QAAQ,GAAI,MAAmC,EAAE,KAAK,CAAC;IAC7D,MAAM,OAAO,GACX,OAAO,QAAQ,EAAE,OAAO,KAAK,QAAQ;QACnC,CAAC,CAAC,QAAQ,CAAC,OAAO;QAClB,CAAC,CAAC,cAAc,GAAG,CAAC,QAAQ,uBAAuB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IACjF,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC9C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,IAAI,iBAAiB,CAC1B,OAAO,EACP,QAAQ,CAAC,MAAM,EACf,IAAI,EACJ,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;AACJ,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Result and option types for every generator. The result shapes mirror the
+ * API's response `data` schemas; the option shapes mirror its query params
+ * (minus `seed`, which the facade manages — see {@link RequestOptions}).
+ */
+/** Sex marker used by the PESEL and person generators. */
+export type Sex = 'm' | 'f';
+/** A Polish legal form the company-name generator can append. */
+export type PolishLegalForm = 'Sp. z o.o.' | 'Sp. z o.o. sp.k.' | 'S.A.' | 'Sp. j.' | 'Sp. k.' | 'S.C.';
+/** Naming family the company-name generator drew from. */
+export type CompanyNameStrategy = 'morpheme' | 'surname' | 'descriptive' | 'modern';
+/** Kind of vehicle registration plate produced. */
+export type VehicleRegistrationType = 'standard' | 'custom' | 'police' | 'military';
+/**
+ * Per-call options shared by every method. A `seed` here overrides the
+ * fixture's automatic per-call seed for this one request.
+ */
+export interface RequestOptions {
+    readonly seed?: number;
+}
+/** Shared inputs of the PESEL and person generators. */
+export interface PersonConstraintOptions extends RequestOptions {
+    readonly sex?: Sex;
+    readonly olderThan?: number;
+    readonly youngerThan?: number;
+    readonly atAge?: number;
+    /** `YYYY`, `YYYY-MM`, or `YYYY-MM-DD`. */
+    readonly bornOn?: string;
+    /** `YYYY`, `YYYY-MM`, or `YYYY-MM-DD`. */
+    readonly bornBefore?: string;
+    /** `YYYY`, `YYYY-MM`, or `YYYY-MM-DD`. */
+    readonly bornAfter?: string;
+    /** Produce a value with a deliberately wrong check digit. */
+    readonly invalid?: boolean;
+}
+export type PeselOptions = PersonConstraintOptions;
+export type PersonOptions = PersonConstraintOptions;
+export interface AddressOptions extends RequestOptions {
+    /** TERYT prefix, 1–7 digits, narrowing the location. */
+    readonly teryt?: string;
+}
+export interface NipOptions extends RequestOptions {
+    readonly format?: 'with-hyphens' | 'digits-only';
+    readonly invalid?: boolean;
+}
+export interface IbanOptions extends RequestOptions {
+    readonly format?: 'grouped' | 'compact';
+    readonly invalid?: boolean;
+    /** Pin the issuing bank by its four-digit code. Mutually exclusive with `bankName`. */
+    readonly bankCode?: string;
+    /** Pin the issuing bank by a case-insensitive name fragment. Mutually exclusive with `bankCode`. */
+    readonly bankName?: string;
+}
+export interface RegonOptions extends RequestOptions {
+    readonly variant?: 'short' | 'long' | 'any';
+    readonly invalid?: boolean;
+}
+export interface CompanyNameOptions extends RequestOptions {
+    readonly strategy?: CompanyNameStrategy | 'any';
+    readonly legalForm?: PolishLegalForm | 'any' | 'none';
+    readonly activityPrefix?: boolean;
+}
+export interface VehicleRegistrationOptions extends RequestOptions {
+    readonly type?: VehicleRegistrationType;
+    readonly voivodeship?: string;
+    readonly county?: string;
+    readonly format?: 'with-space' | 'compact';
+}
+export interface PolishPeselData {
+    readonly value: string;
+    readonly birthDate: string;
+    readonly sex: Sex;
+}
+export interface PolishPersonData {
+    readonly name: string;
+    readonly surname: string;
+    readonly initials: string;
+    readonly birthDate: string;
+    readonly pesel: string;
+}
+export interface PolishAddressTerytCodes {
+    readonly voivodeshipCode: string;
+    readonly countyCode: string;
+    readonly municipalityCode: string;
+    readonly cityCode: string;
+    readonly streetCode?: string;
+}
+export interface PolishAddressData {
+    readonly streetFullName?: string;
+    readonly buildingNumber: string;
+    readonly postalCode: string;
+    readonly cityName: string;
+    readonly municipalityName: string;
+    readonly countyName: string;
+    readonly voivodeshipName: string;
+    readonly terytCodes: PolishAddressTerytCodes;
+}
+export interface PolishNipData {
+    readonly value: string;
+    readonly digits: string;
+}
+export interface PolishIbanData {
+    readonly value: string;
+    readonly electronicFormat: string;
+    readonly bankCode: string;
+    readonly bankName: string;
+}
+export interface PolishRegonData {
+    readonly value: string;
+    readonly variant: 'short' | 'long';
+}
+export interface PolishCompanyNameData {
+    readonly value: string;
+    readonly legalForm: PolishLegalForm | null;
+    readonly strategy: CompanyNameStrategy;
+}
+export interface PolishVehicleRegistrationData {
+    readonly value: string;
+    readonly prefix: string;
+    readonly individualPart: string;
+    readonly type: VehicleRegistrationType;
+    readonly voivodeship?: string;
+    readonly county?: string;
+}
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Result and option types for every generator. The result shapes mirror the
+ * API's response `data` schemas; the option shapes mirror its query params
+ * (minus `seed`, which the facade manages — see {@link RequestOptions}).
+ */
+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":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@przeslijmi/real-fake-data-playwright",
+  "version": "0.1.0",
+  "description": "Playwright fixtures for Real Fake Data — seeded, realistic Polish test data (PESEL, NIP, REGON, IBAN, addresses, companies, people, vehicle plates).",
+  "keywords": [
+    "playwright",
+    "playwright-fixtures",
+    "fake-data",
+    "test-data",
+    "seed-data",
+    "pesel",
+    "nip",
+    "regon",
+    "poland"
+  ],
+  "homepage": "https://github.com/przeslijmi/rfd/tree/main/packages/addon-playwright",
+  "bugs": "https://github.com/przeslijmi/rfd/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/przeslijmi/rfd.git",
+    "directory": "packages/addon-playwright"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.40.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "@przeslijmi/rfd-eslint-config": "0.0.0",
+    "@przeslijmi/rfd-tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "dev": "tsc -b tsconfig.build.json --watch",
+    "clean": "rm -rf dist .turbo *.tsbuildinfo",
+    "lint": "eslint .",
+    "typecheck": "tsc -b tsconfig.build.json --noEmit"
+  }
+}