@geekmidas/testkit 10.0.0-alpha.3 → 10.0.0-alpha.30

package/dist/VitestTransactionIsolator-glcxyS_R.d.cts

@@ -1,223 +0,0 @@
-import { Service } from "@geekmidas/services";
-import { TestAPI } from "vitest";
-
-//#region src/VitestTransactionIsolator.d.ts
-
-/**
- * Type definition for test fixtures that provide transaction access.
- * Used with Vitest's test.extend() API to inject transactions into tests.
- *
- * @template Transaction - The transaction type specific to the database driver
- * @template Extended - Additional context properties provided by the extend function
- */
-interface DatabaseFixtures<Transaction, _Extended = object> {
-  /**
-   * The database transaction available to the test.
-   * All database operations should use this transaction to ensure proper rollback.
-   */
-  trx: Transaction;
-}
-/**
- * Combined fixtures type that merges the base transaction fixture with extended context.
- */
-type ExtendedDatabaseFixtures<Transaction, Extended = object> = DatabaseFixtures<Transaction> & Extended;
-/**
- * Function type for extending test context with additional properties.
- * Receives the transaction and returns additional context to be merged with { trx }.
- *
- * @template Transaction - The transaction type
- * @template Extended - The type of additional context to provide
- *
- * @example
- * ```typescript
- * const extendContext: ExtendContextFn<Transaction<DB>, { factory: KyselyFactory }> =
- *   (trx) => ({ factory: new KyselyFactory(builders, seeds, trx) });
- * ```
- */
-type ExtendContextFn<Transaction, Extended> = (trx: Transaction) => Extended | Promise<Extended>;
-/**
- * PostgreSQL transaction isolation levels.
- * Controls the visibility of concurrent transactions.
- *
- * @see https://www.postgresql.org/docs/current/transaction-iso.html
- */
-declare enum IsolationLevel {
-  /**
-   * Lowest isolation level. Allows dirty reads.
-   * Not recommended for testing.
-   */
-  READ_UNCOMMITTED = "READ UNCOMMITTED",
-  /**
-   * Default PostgreSQL isolation level.
-   * Prevents dirty reads but allows non-repeatable reads.
-   */
-  READ_COMMITTED = "READ COMMITTED",
-  /**
-   * Prevents dirty reads and non-repeatable reads.
-   * Recommended for most test scenarios.
-   */
-  REPEATABLE_READ = "REPEATABLE READ",
-  /**
-   * Highest isolation level. Prevents all phenomena.
-   * May cause performance overhead in tests.
-   */
-  SERIALIZABLE = "SERIALIZABLE",
-}
-/**
- * Abstract base class for implementing database transaction isolation in Vitest tests.
- * Provides automatic transaction rollback after each test to maintain test isolation.
- * Subclasses must implement the transact() method for their specific database driver.
- *
- * @template TConn - The database connection type
- * @template Transaction - The transaction type
- *
- * @example
- * ```typescript
- * // Implement for your database driver
- * class MyDatabaseIsolator extends VitestPostgresTransactionIsolator<MyDB, MyTx> {
- *   async transact(conn: MyDB, level: IsolationLevel, fn: (tx: MyTx) => Promise<void>) {
- *     await conn.transaction(level, fn);
- *   }
- * }
- *
- * // Use in tests
- * const isolator = new MyDatabaseIsolator(test);
- * const isolatedTest = isolator.wrapVitestWithTransaction(db);
- *
- * isolatedTest('should create user', async ({ trx }) => {
- *   await trx.insert('users', { name: 'Test' });
- *   // Data is automatically rolled back after test
- * });
- * ```
- */
-declare abstract class VitestPostgresTransactionIsolator<TConn, Transaction> {
-  private readonly api;
-  /**
-   * Abstract method to create a transaction with the specified isolation level.
-   * Must be implemented by subclasses for specific database drivers.
-   *
-   * @param conn - The database connection
-   * @param isolationLevel - The transaction isolation level
-   * @param fn - The function to execute within the transaction
-   * @returns Promise that resolves when the transaction completes
-   */
-  abstract transact(conn: TConn, isolationLevel: IsolationLevel, fn: (trx: Transaction) => Promise<void>): Promise<void>;
-  abstract destroy(conn: TConn): Promise<void>;
-  /**
-   * Creates a new VitestPostgresTransactionIsolator instance.
-   *
-   * @param api - The Vitest test API (usually the `test` export from vitest)
-   */
-  constructor(api: TestAPI);
-  /**
-   * Creates a wrapped version of Vitest's test API that provides transaction isolation.
-   * Each test will run within a database transaction that is automatically rolled back.
-   *
-   * @param options - Configuration options for transaction wrapping
-   * @returns A wrapped test API with transaction support
-   *
-   * @example
-   * ```typescript
-   * const isolatedTest = isolator.wrapVitestWithTransaction({
-   *   connection: db,
-   *   setup: async (trx) => {
-   *     await trx.insert('settings', { key: 'test', value: 'true' });
-   *   },
-   *   fixtures: {
-   *     factory: (trx) => new Factory(trx),
-   *   },
-   * });
-   *
-   * isolatedTest('test with transaction', async ({ trx, factory }) => {
-   *   const user = await factory.insert('user', { name: 'Test' });
-   *   expect(user).toBeDefined();
-   * });
-   * ```
-   */
-  wrapVitestWithTransaction<Extended extends Record<string, unknown> = {}>(options: TransactionWrapperOptions<TConn, Transaction, Extended>): TestAPI<DatabaseFixtures<Transaction, object> & Extended>;
-}
-type DatabaseConnectionFn<Conn> = () => Conn | Promise<Conn>;
-/**
- * Where a connection comes from: a construct, or a function returning one.
- *
- * A construct is preferred, because it builds the client through the same
- * `connect()` production uses. A hand-rolled client missing `CamelCasePlugin`
- * writes `createdAt` where the app writes `created_at`, and the test passes
- * while production does not. The URL is read from `process.env`.
- */
-type DatabaseConnection<Conn> = DatabaseConnectionFn<Conn> | ConnectableConstruct<Conn>;
-/**
- * Options for wrapping Vitest tests with database transaction isolation.
- */
-/**
- * Anything that owns a service handing back a connection — a database
- * construct, structurally, so testkit depends on no construct package.
- */
-interface ConnectableConstruct<TConn> {
-  readonly service: Service<string, TConn>;
-}
-interface TransactionWrapperOptions<TConn, Transaction, Extended extends Record<string, unknown> = {}> {
-  /** Where the connection comes from — a construct, or a function returning one */
-  connection: DatabaseConnection<TConn>;
-  /** Optional setup function to run within the transaction before each test */
-  setup?: (trx: Transaction) => Promise<void>;
-  /** Transaction isolation level (defaults to REPEATABLE_READ) */
-  isolationLevel?: IsolationLevel;
-  /** Additional fixtures that depend on the transaction */
-  fixtures?: FixtureCreators<Transaction, Extended>;
-}
-/**
- * Type for fixture creator functions that depend on the transaction.
- * Each function receives the transaction and returns the fixture value.
- */
-type FixtureCreators<Transaction, Extended extends Record<string, unknown>> = { [K in keyof Extended]: (trx: Transaction) => Extended[K] | Promise<Extended[K]> };
-/**
- * The test API returned by extendWithFixtures.
- * Provides access to both the transaction (trx) and all extended fixtures.
- *
- * @template Transaction - The transaction type
- * @template Extended - The type of additional fixtures provided
- * @template BaseTest - The base wrapped test type
- */
-type TestWithExtendedFixtures<Transaction, Extended extends Record<string, unknown>, BaseTest extends ReturnType<TestAPI['extend']> = ReturnType<TestAPI['extend']>> = BaseTest & {
-  <C extends object>(name: string, fn: (context: DatabaseFixtures<Transaction> & Extended & C) => Promise<void>): void;
-  <C extends object>(name: string, options: object, fn: (context: DatabaseFixtures<Transaction> & Extended & C) => Promise<void>): void;
-};
-/**
- * Extends a wrapped test API with additional fixtures that depend on the transaction.
- * This allows composing test context with factories, repositories, or other helpers.
- *
- * @template Transaction - The transaction type
- * @template Extended - The type of additional context to provide
- * @param wrappedTest - The base wrapped test from wrapVitestWithTransaction
- * @param fixtures - Object mapping fixture names to creator functions
- * @returns An extended test API with both trx and the additional fixtures
- *
- * @example
- * ```typescript
- * import { wrapVitestKyselyTransaction, extendWithFixtures } from '@geekmidas/testkit/kysely';
- *
- * // Create base wrapped test
- * const baseTest = wrapVitestKyselyTransaction(test, {
- *   connection: db,
- *   setup: createTestTables,
- * });
- *
- * // Extend with fixtures
- * const it = extendWithFixtures(baseTest, {
- *   factory: (trx) => new KyselyFactory(builders, seeds, trx),
- *   userRepo: (trx) => new UserRepository(trx),
- * });
- *
- * // Use in tests - trx and all fixtures are available
- * it('should create user with factory', async ({ trx, factory, userRepo }) => {
- *   const user = await factory.insert('user', { name: 'Test' });
- *   expect(user).toBeDefined();
- * });
- * ```
- */
-declare function extendWithFixtures<Transaction, Extended extends Record<string, unknown>, T extends ReturnType<TestAPI['extend']> = any>(wrappedTest: T, fixtures: FixtureCreators<Transaction, Extended>): TestWithExtendedFixtures<Transaction, Extended, T>;
-//# sourceMappingURL=VitestTransactionIsolator.d.ts.map
-//#endregion
-export { ConnectableConstruct, DatabaseConnection, DatabaseConnectionFn, DatabaseFixtures, ExtendContextFn, ExtendedDatabaseFixtures, FixtureCreators, IsolationLevel, TestWithExtendedFixtures, TransactionWrapperOptions, VitestPostgresTransactionIsolator, extendWithFixtures };
-//# sourceMappingURL=VitestTransactionIsolator-glcxyS_R.d.cts.map

package/dist/VitestTransactionIsolator-glcxyS_R.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VitestTransactionIsolator-glcxyS_R.d.cts","names":[],"sources":["../src/VitestTransactionIsolator.ts"],"sourcesContent":[],"mappings":";;;;;;;AAWA;AAWA;;;;AAGoC,UAdnB,gBAcmB,CAAA,WAAA,EAAA,YAAA,MAAA,CAAA,CAAA;EAAQ;AAe5C;;;EACiB,GACZ,EA1BC,WA0BD;;;AAAkB;AAQvB;AAkDsB,KA9EV,wBA8EU,CAAA,WAAiC,EAAA,WAAA,MAAA,CAAA,GA3EnD,gBA2EmD,CA3ElC,WA2EkC,CAAA,GA3EnB,QA2EmB;;;;;;;;;;;;;;AAkD5C,KA9GC,eA8GD,CAAA,WAAA,EAAA,QAAA,CAAA,GAAA,CAAA,GAAA,EA7GL,WA6GK,EAAA,GA5GN,QA4GM,GA5GK,OA4GL,CA5Ga,QA4Gb,CAAA;;;;;AAAuD;AA8FlE;AAAgC,aAlMpB,cAAA;EAkMoB;;;AAA6B;EAUjD,gBAAA,GAAA,kBAAkB;EAAA;;;;EAEF,cAAzB,GAAA,gBAAA;EAAoB;AAgBvB;;;EACwC,eAArB,GAAA,iBAAA;EAAO;AAG1B;;;EAGwB,YAGQ,GAAA,cAAA;;;;;;;;AAML;AAO3B;;;;;;;;;;AAM2B;AAW3B;;;;;;;;;AAUY,uBA9NU,iCA8NV,CAAA,KAAA,EAAA,WAAA,CAAA,CAAA;EAAgB,iBAAgB,GAAA;EAAQ;;;;;;;AAQtC;AAqCd;EAAkC,SAAA,QAAA,CAAA,IAAA,EAhQ1B,KAgQ0B,EAAA,cAAA,EA/PhB,cA+PgB,EAAA,EAAA,EAAA,CAAA,GAAA,EA9PtB,WA8PsB,EAAA,GA9PN,OA8PM,CAAA,IAAA,CAAA,CAAA,EA7P9B,OA6P8B,CAAA,IAAA,CAAA;EAAA,SAEhB,OAAA,CAAA,IAAA,EA7PM,KA6PN,CAAA,EA7Pc,OA6Pd,CAAA,IAAA,CAAA;EAAM;;;;;EAKwB,WAArC,CAAA,GAAA,EA5PwB,OA4PxB;EAAe;;;;AACC;;;;;;;;;;;;;;;;;;;;;6CAlOiB,uCACjC,0BAA0B,OAAO,aAAa,YAAS,QAAA,iBAAA,uBAAA;;KA8FtD,mCAAmC,OAAO,QAAQ;;;;;;;;;KAUlD,2BACT,qBAAqB,QACrB,qBAAqB;;;;;;;;UAgBP;oBACE,gBAAgB;;UAGlB,+DAGC;;cAGL,mBAAmB;;gBAEjB,gBAAgB;;mBAEb;;aAEN,gBAAgB,aAAa;;;;;;KAO7B,8CAEM,yCAEL,iBACN,gBACD,SAAS,KAAK,QAAQ,SAAS;;;;;;;;;KAWzB,uDAEM,0CACA,WAAW,qBAAqB,WAChD,sBAEE;iDAIQ,iBAAiB,eAAe,WAAW,MAChD;kEAMK,iBAAiB,eAAe,WAAW,MAChD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqCS,iDAEE,mCAEP,WAAW,uCAER,aACH,gBAAgB,aAAa,YACrC,yBAAyB,aAAa,UAAU"}

package/dist/directory-BxjqmtCT.mjs

@@ -1,27 +0,0 @@
-import { it } from "vitest";
-import crypto from "node:crypto";
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-//#region src/os/directory.ts
-const itWithDir = it.extend({ dir: async ({}, use) => {
-	const tempDir = os.tmpdir();
-	const directoryName = crypto.randomUUID().replace(/-/g, "").toUpperCase();
-	const dir = path.join(tempDir, directoryName);
-	await fs.mkdir(dir, { recursive: true });
-	await use(dir);
-	await fs.rm(dir, {
-		recursive: true,
-		force: true
-	});
-	const keystoreDir = path.join(os.homedir(), ".gkm", directoryName);
-	await fs.rm(keystoreDir, {
-		recursive: true,
-		force: true
-	});
-} });
-
-//#endregion
-export { itWithDir };
-//# sourceMappingURL=directory-BxjqmtCT.mjs.map

package/dist/directory-BxjqmtCT.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory-BxjqmtCT.mjs","names":[],"sources":["../src/os/directory.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { it } from 'vitest';\n\nexport const itWithDir = it.extend<DirectoryFixtures>({\n\t// This fixture automatically provides a transaction to each test\n\t// biome-ignore lint/correctness/noEmptyPattern: this has to be like this to satisfy Biome\n\tdir: async ({}, use) => {\n\t\tconst tempDir = os.tmpdir();\n\t\tconst directoryName = crypto.randomUUID().replace(/-/g, '').toUpperCase();\n\t\tconst dir = path.join(tempDir, directoryName);\n\t\tawait fs.mkdir(dir, { recursive: true });\n\t\tawait use(dir);\n\t\tawait fs.rm(dir, { recursive: true, force: true });\n\n\t\t// Clean up keystore directory that may have been created at ~/.gkm/{directoryName}\n\t\tconst keystoreDir = path.join(os.homedir(), '.gkm', directoryName);\n\t\tawait fs.rm(keystoreDir, { recursive: true, force: true });\n\t},\n});\n\nexport interface DirectoryFixtures {\n\tdir: string;\n}\n"],"mappings":";;;;;;;AAMA,MAAa,YAAY,GAAG,OAA0B,EAGrD,KAAK,OAAO,EAAE,EAAE,QAAQ;CACvB,MAAM,UAAU,GAAG,QAAQ;CAC3B,MAAM,gBAAgB,OAAO,YAAY,CAAC,QAAQ,MAAM,GAAG,CAAC,aAAa;CACzE,MAAM,MAAM,KAAK,KAAK,SAAS,cAAc;AAC7C,OAAM,GAAG,MAAM,KAAK,EAAE,WAAW,KAAM,EAAC;AACxC,OAAM,IAAI,IAAI;AACd,OAAM,GAAG,GAAG,KAAK;EAAE,WAAW;EAAM,OAAO;CAAM,EAAC;CAGlD,MAAM,cAAc,KAAK,KAAK,GAAG,SAAS,EAAE,QAAQ,cAAc;AAClE,OAAM,GAAG,GAAG,aAAa;EAAE,WAAW;EAAM,OAAO;CAAM,EAAC;AAC1D,EACD,EAAC"}

package/dist/directory-DD_xQoSh.cjs

@@ -1,33 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const vitest = require_chunk.__toESM(require("vitest"));
-const node_crypto = require_chunk.__toESM(require("node:crypto"));
-const node_fs_promises = require_chunk.__toESM(require("node:fs/promises"));
-const node_os = require_chunk.__toESM(require("node:os"));
-const node_path = require_chunk.__toESM(require("node:path"));
-
-//#region src/os/directory.ts
-const itWithDir = vitest.it.extend({ dir: async ({}, use) => {
-	const tempDir = node_os.default.tmpdir();
-	const directoryName = node_crypto.default.randomUUID().replace(/-/g, "").toUpperCase();
-	const dir = node_path.default.join(tempDir, directoryName);
-	await node_fs_promises.default.mkdir(dir, { recursive: true });
-	await use(dir);
-	await node_fs_promises.default.rm(dir, {
-		recursive: true,
-		force: true
-	});
-	const keystoreDir = node_path.default.join(node_os.default.homedir(), ".gkm", directoryName);
-	await node_fs_promises.default.rm(keystoreDir, {
-		recursive: true,
-		force: true
-	});
-} });
-
-//#endregion
-Object.defineProperty(exports, 'itWithDir', {
-  enumerable: true,
-  get: function () {
-    return itWithDir;
-  }
-});
-//# sourceMappingURL=directory-DD_xQoSh.cjs.map

package/dist/directory-DD_xQoSh.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory-DD_xQoSh.cjs","names":[],"sources":["../src/os/directory.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { it } from 'vitest';\n\nexport const itWithDir = it.extend<DirectoryFixtures>({\n\t// This fixture automatically provides a transaction to each test\n\t// biome-ignore lint/correctness/noEmptyPattern: this has to be like this to satisfy Biome\n\tdir: async ({}, use) => {\n\t\tconst tempDir = os.tmpdir();\n\t\tconst directoryName = crypto.randomUUID().replace(/-/g, '').toUpperCase();\n\t\tconst dir = path.join(tempDir, directoryName);\n\t\tawait fs.mkdir(dir, { recursive: true });\n\t\tawait use(dir);\n\t\tawait fs.rm(dir, { recursive: true, force: true });\n\n\t\t// Clean up keystore directory that may have been created at ~/.gkm/{directoryName}\n\t\tconst keystoreDir = path.join(os.homedir(), '.gkm', directoryName);\n\t\tawait fs.rm(keystoreDir, { recursive: true, force: true });\n\t},\n});\n\nexport interface DirectoryFixtures {\n\tdir: string;\n}\n"],"mappings":";;;;;;;;AAMA,MAAa,YAAY,UAAG,OAA0B,EAGrD,KAAK,OAAO,EAAE,EAAE,QAAQ;CACvB,MAAM,UAAU,gBAAG,QAAQ;CAC3B,MAAM,gBAAgB,oBAAO,YAAY,CAAC,QAAQ,MAAM,GAAG,CAAC,aAAa;CACzE,MAAM,MAAM,kBAAK,KAAK,SAAS,cAAc;AAC7C,OAAM,yBAAG,MAAM,KAAK,EAAE,WAAW,KAAM,EAAC;AACxC,OAAM,IAAI,IAAI;AACd,OAAM,yBAAG,GAAG,KAAK;EAAE,WAAW;EAAM,OAAO;CAAM,EAAC;CAGlD,MAAM,cAAc,kBAAK,KAAK,gBAAG,SAAS,EAAE,QAAQ,cAAc;AAClE,OAAM,yBAAG,GAAG,aAAa;EAAE,WAAW;EAAM,OAAO;CAAM,EAAC;AAC1D,EACD,EAAC"}

package/dist/directory-DGOcVlKD.d.cts

@@ -1,13 +0,0 @@
-import * as vitest6 from "vitest";
-
-//#region src/os/directory.d.ts
-declare const itWithDir: vitest6.TestAPI<{
-  dir: string;
-}>;
-interface DirectoryFixtures {
-  dir: string;
-}
-//# sourceMappingURL=directory.d.ts.map
-//#endregion
-export { DirectoryFixtures, itWithDir };
-//# sourceMappingURL=directory-DGOcVlKD.d.cts.map

package/dist/directory-DGOcVlKD.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory-DGOcVlKD.d.cts","names":[],"sources":["../src/os/directory.ts"],"sourcesContent":[],"mappings":";;;cAMa,WAeX,OAAA,CAfoB;;;AAAT,UAiBI,iBAAA,CAjBK;EAiBL,GAAA,EAAA,MAAA"}

package/dist/directory-DiQ_DkaF.d.mts

@@ -1,13 +0,0 @@
-import * as vitest5 from "vitest";
-
-//#region src/os/directory.d.ts
-declare const itWithDir: vitest5.TestAPI<{
-  dir: string;
-}>;
-interface DirectoryFixtures {
-  dir: string;
-}
-//# sourceMappingURL=directory.d.ts.map
-//#endregion
-export { DirectoryFixtures, itWithDir };
-//# sourceMappingURL=directory-DiQ_DkaF.d.mts.map

package/dist/directory-DiQ_DkaF.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directory-DiQ_DkaF.d.mts","names":[],"sources":["../src/os/directory.ts"],"sourcesContent":[],"mappings":";;;cAMa,WAeX,OAAA,CAfoB;;;AAAT,UAiBI,iBAAA,CAjBK;EAiBL,GAAA,EAAA,MAAA"}

package/dist/faker-B14IEMIN.cjs

@@ -1,304 +0,0 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const __faker_js_faker = require_chunk.__toESM(require("@faker-js/faker"));
-
-//#region src/faker.ts
-/**
-* Atomic counter implementation for thread-safe sequence generation.
-* Provides a clean abstraction for generating sequential numbers in tests.
-* While JavaScript is single-threaded, this class makes the intent explicit.
-*
-* @example
-* ```typescript
-* const counter = new AtomicCounter(100);
-* console.log(counter.increment()); // 101
-* console.log(counter.increment()); // 102
-* console.log(counter.get()); // 102
-* counter.reset(200);
-* console.log(counter.increment()); // 201
-* ```
-*/
-var AtomicCounter = class {
-	/**
-	* The current counter value.
-	* @private
-	*/
-	value;
-	/**
-	* Creates a new atomic counter.
-	* @param initialValue - The starting value (default: 0)
-	*/
-	constructor(initialValue = 0) {
-		this.value = initialValue;
-	}
-	/**
-	* Increments the counter and returns the new value.
-	* @returns The incremented value
-	*/
-	increment() {
-		return ++this.value;
-	}
-	/**
-	* Gets the current counter value without incrementing.
-	* @returns The current value
-	*/
-	get() {
-		return this.value;
-	}
-	/**
-	* Resets the counter to a specific value.
-	* @param value - The new value (default: 0)
-	*/
-	reset(value = 0) {
-		this.value = value;
-	}
-};
-/**
-* Generates random timestamp fields for database records.
-* Creates a createdAt date in the past and an updatedAt date between creation and now.
-* Milliseconds are set to 0 for cleaner database storage.
-*
-* @returns Object with createdAt and updatedAt Date fields
-*
-* @example
-* ```typescript
-* const { createdAt, updatedAt } = timestamps();
-* console.log(createdAt); // 2023-05-15T10:30:00.000Z
-* console.log(updatedAt); // 2023-11-20T14:45:00.000Z
-*
-* // Use in factory
-* const user = {
-*   name: 'John Doe',
-*   ...timestamps()
-* };
-* ```
-*/
-function timestamps() {
-	const createdAt = faker.date.past();
-	const updatedAt = faker.date.between({
-		from: createdAt,
-		to: /* @__PURE__ */ new Date()
-	});
-	createdAt.setMilliseconds(0);
-	updatedAt.setMilliseconds(0);
-	return {
-		createdAt,
-		updatedAt
-	};
-}
-/**
-* Generates a reverse domain name identifier.
-* Useful for creating unique identifiers that follow domain naming conventions.
-*
-* @param suffix - Optional suffix to append to the identifier
-* @returns A reverse domain name string (e.g., "com.example.feature123")
-*
-* @example
-* ```typescript
-* console.log(identifier()); // "com.example.widget1"
-* console.log(identifier('user')); // "org.acme.user"
-* console.log(identifier('api')); // "net.demo.api"
-* ```
-*/
-function identifier(suffix) {
-	return [
-		faker.internet.domainSuffix(),
-		faker.internet.domainWord(),
-		suffix ? suffix : faker.internet.domainWord() + sequence("identifier")
-	].join(".");
-}
-/**
-* Storage for named sequence counters.
-* Each sequence maintains its own independent counter.
-* @private
-*/
-const sequences = /* @__PURE__ */ new Map();
-/**
-* Generates sequential numbers for a named sequence.
-* Useful for creating unique IDs or numbered test data.
-* Each named sequence maintains its own counter.
-*
-* @param name - The sequence name (default: 'default')
-* @returns The next number in the sequence
-*
-* @example
-* ```typescript
-* console.log(sequence()); // 1
-* console.log(sequence()); // 2
-* console.log(sequence('user')); // 1
-* console.log(sequence('user')); // 2
-* console.log(sequence()); // 3
-*
-* // Use in factories
-* const email = `user${sequence('email')}@example.com`;
-* ```
-*/
-function sequence(name = "default") {
-	if (!sequences.has(name)) sequences.set(name, new AtomicCounter());
-	const counter = sequences.get(name);
-	return counter.increment();
-}
-/**
-* Resets a named sequence counter to a specific value.
-* Useful for resetting sequences between test suites.
-*
-* @param name - The sequence name to reset (default: 'default')
-* @param value - The new starting value (default: 0)
-*
-* @example
-* ```typescript
-* sequence('user'); // 1
-* sequence('user'); // 2
-* resetSequence('user');
-* sequence('user'); // 1
-*
-* resetSequence('order', 1000);
-* sequence('order'); // 1001
-* ```
-*/
-function resetSequence(name = "default", value = 0) {
-	if (sequences.has(name)) {
-		const counter = sequences.get(name);
-		counter.reset(value);
-	} else sequences.set(name, new AtomicCounter(value));
-}
-/**
-* Resets all sequence counters.
-* Useful for cleaning up between test suites to ensure predictable sequences.
-*
-* @example
-* ```typescript
-* // In test setup
-* beforeEach(() => {
-*   resetAllSequences();
-* });
-*
-* it('starts sequences from 1', () => {
-*   expect(sequence()).toBe(1);
-*   expect(sequence('user')).toBe(1);
-* });
-* ```
-*/
-function resetAllSequences() {
-	sequences.clear();
-}
-/**
-* Generates a random price as a number.
-* Converts faker's string price to a numeric value.
-*
-* @returns A random price number
-*
-* @example
-* ```typescript
-* const productPrice = price(); // 29.99
-* const total = price() * quantity; // Numeric calculation
-* ```
-*/
-function price() {
-	return +faker.commerce.price();
-}
-function coordinateInRadius(center, radius) {
-	const earth = 6378137;
-	const d = radius / earth;
-	const theta = 2 * Math.PI * Math.random();
-	const r = d * Math.sqrt(Math.random());
-	const lat1 = center.lat * Math.PI / 180;
-	const lng1 = center.lng * Math.PI / 180;
-	const lat2 = Math.asin(Math.sin(lat1) * Math.cos(r) + Math.cos(lat1) * Math.sin(r) * Math.cos(theta));
-	const lng2 = lng1 + Math.atan2(Math.sin(theta) * Math.sin(r) * Math.cos(lat1), Math.cos(r) - Math.sin(lat1) * Math.sin(lat2));
-	return {
-		lat: lat2 * 180 / Math.PI,
-		lng: lng2 * 180 / Math.PI
-	};
-}
-function coordinateOutsideRadius(center, minRadiusMeters, maxRadiusMeters) {
-	const earth = 6378137;
-	const minD = minRadiusMeters / earth;
-	const maxD = maxRadiusMeters / earth;
-	const theta = 2 * Math.PI * Math.random();
-	const r = Math.sqrt(minD * minD + (maxD * maxD - minD * minD) * Math.random());
-	const lat1 = center.lat * Math.PI / 180;
-	const lng1 = center.lng * Math.PI / 180;
-	const lat2 = Math.asin(Math.sin(lat1) * Math.cos(r) + Math.cos(lat1) * Math.sin(r) * Math.cos(theta));
-	const lng2 = lng1 + Math.atan2(Math.sin(theta) * Math.sin(r) * Math.cos(lat1), Math.cos(r) - Math.sin(lat1) * Math.sin(lat2));
-	const normalizedLng = (lng2 * 180 / Math.PI + 540) % 360 - 180;
-	return {
-		lat: lat2 * 180 / Math.PI,
-		lng: normalizedLng
-	};
-}
-/**
-* Enhanced faker instance with additional utility methods for testing.
-* Extends @faker-js/faker with custom methods for common test data generation patterns.
-*
-* @example
-* ```typescript
-* import { faker } from '@geekmidas/testkit';
-*
-* // Use standard faker methods
-* const name = faker.person.fullName();
-* const email = faker.internet.email();
-*
-* // Use custom extensions
-* const { createdAt, updatedAt } = faker.timestamps();
-* const id = faker.identifier('user');
-* const orderNumber = faker.sequence('order');
-* const productPrice = faker.price();
-* ```
-*/
-const faker = Object.freeze(Object.assign({}, __faker_js_faker.faker, {
-	timestamps,
-	identifier,
-	sequence,
-	resetSequence,
-	resetAllSequences,
-	price,
-	coordinates: {
-		within: coordinateInRadius,
-		outside: coordinateOutsideRadius
-	}
-}));
-
-//#endregion
-Object.defineProperty(exports, 'coordinateInRadius', {
-  enumerable: true,
-  get: function () {
-    return coordinateInRadius;
-  }
-});
-Object.defineProperty(exports, 'faker', {
-  enumerable: true,
-  get: function () {
-    return faker;
-  }
-});
-Object.defineProperty(exports, 'identifier', {
-  enumerable: true,
-  get: function () {
-    return identifier;
-  }
-});
-Object.defineProperty(exports, 'resetAllSequences', {
-  enumerable: true,
-  get: function () {
-    return resetAllSequences;
-  }
-});
-Object.defineProperty(exports, 'resetSequence', {
-  enumerable: true,
-  get: function () {
-    return resetSequence;
-  }
-});
-Object.defineProperty(exports, 'sequence', {
-  enumerable: true,
-  get: function () {
-    return sequence;
-  }
-});
-Object.defineProperty(exports, 'timestamps', {
-  enumerable: true,
-  get: function () {
-    return timestamps;
-  }
-});
-//# sourceMappingURL=faker-B14IEMIN.cjs.map

package/dist/faker-B14IEMIN.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"faker-B14IEMIN.cjs","names":["suffix?: string","center: Coordinate","radius: number","minRadiusMeters: number","maxRadiusMeters: number","baseFaker"],"sources":["../src/faker.ts"],"sourcesContent":["import { faker as baseFaker } from '@faker-js/faker';\n\n// NOTE: This is a simple way to extend `faker` with additional methods\n\n/**\n * Atomic counter implementation for thread-safe sequence generation.\n * Provides a clean abstraction for generating sequential numbers in tests.\n * While JavaScript is single-threaded, this class makes the intent explicit.\n *\n * @example\n * ```typescript\n * const counter = new AtomicCounter(100);\n * console.log(counter.increment()); // 101\n * console.log(counter.increment()); // 102\n * console.log(counter.get()); // 102\n * counter.reset(200);\n * console.log(counter.increment()); // 201\n * ```\n */\nclass AtomicCounter {\n\t/**\n\t * The current counter value.\n\t * @private\n\t */\n\tprivate value: number;\n\n\t/**\n\t * Creates a new atomic counter.\n\t * @param initialValue - The starting value (default: 0)\n\t */\n\tconstructor(initialValue = 0) {\n\t\tthis.value = initialValue;\n\t}\n\n\t/**\n\t * Increments the counter and returns the new value.\n\t * @returns The incremented value\n\t */\n\tincrement(): number {\n\t\t// In Node.js, JavaScript is single-threaded within the event loop,\n\t\t// so this operation is already atomic. However, this class provides\n\t\t// a cleaner abstraction and makes the intent explicit.\n\t\treturn ++this.value;\n\t}\n\n\t/**\n\t * Gets the current counter value without incrementing.\n\t * @returns The current value\n\t */\n\tget(): number {\n\t\treturn this.value;\n\t}\n\n\t/**\n\t * Resets the counter to a specific value.\n\t * @param value - The new value (default: 0)\n\t */\n\treset(value = 0): void {\n\t\tthis.value = value;\n\t}\n}\n\n/**\n * Generates random timestamp fields for database records.\n * Creates a createdAt date in the past and an updatedAt date between creation and now.\n * Milliseconds are set to 0 for cleaner database storage.\n *\n * @returns Object with createdAt and updatedAt Date fields\n *\n * @example\n * ```typescript\n * const { createdAt, updatedAt } = timestamps();\n * console.log(createdAt); // 2023-05-15T10:30:00.000Z\n * console.log(updatedAt); // 2023-11-20T14:45:00.000Z\n *\n * // Use in factory\n * const user = {\n *   name: 'John Doe',\n *   ...timestamps()\n * };\n * ```\n */\nexport function timestamps(): Timestamps {\n\tconst createdAt = faker.date.past();\n\tconst updatedAt = faker.date.between({\n\t\tfrom: createdAt,\n\t\tto: new Date(),\n\t});\n\n\tcreatedAt.setMilliseconds(0);\n\tupdatedAt.setMilliseconds(0);\n\n\treturn { createdAt, updatedAt };\n}\n\n/**\n * Generates a reverse domain name identifier.\n * Useful for creating unique identifiers that follow domain naming conventions.\n *\n * @param suffix - Optional suffix to append to the identifier\n * @returns A reverse domain name string (e.g., \"com.example.feature123\")\n *\n * @example\n * ```typescript\n * console.log(identifier()); // \"com.example.widget1\"\n * console.log(identifier('user')); // \"org.acme.user\"\n * console.log(identifier('api')); // \"net.demo.api\"\n * ```\n */\nexport function identifier(suffix?: string): string {\n\treturn [\n\t\tfaker.internet.domainSuffix(),\n\t\tfaker.internet.domainWord(),\n\t\tsuffix ? suffix : faker.internet.domainWord() + sequence('identifier'),\n\t].join('.');\n}\n\n/**\n * Storage for named sequence counters.\n * Each sequence maintains its own independent counter.\n * @private\n */\nconst sequences = new Map<string, AtomicCounter>();\n\n/**\n * Generates sequential numbers for a named sequence.\n * Useful for creating unique IDs or numbered test data.\n * Each named sequence maintains its own counter.\n *\n * @param name - The sequence name (default: 'default')\n * @returns The next number in the sequence\n *\n * @example\n * ```typescript\n * console.log(sequence()); // 1\n * console.log(sequence()); // 2\n * console.log(sequence('user')); // 1\n * console.log(sequence('user')); // 2\n * console.log(sequence()); // 3\n *\n * // Use in factories\n * const email = `user${sequence('email')}@example.com`;\n * ```\n */\nexport function sequence(name = 'default'): number {\n\tif (!sequences.has(name)) {\n\t\tsequences.set(name, new AtomicCounter());\n\t}\n\n\tconst counter = sequences.get(name) as AtomicCounter;\n\treturn counter.increment();\n}\n\n/**\n * Resets a named sequence counter to a specific value.\n * Useful for resetting sequences between test suites.\n *\n * @param name - The sequence name to reset (default: 'default')\n * @param value - The new starting value (default: 0)\n *\n * @example\n * ```typescript\n * sequence('user'); // 1\n * sequence('user'); // 2\n * resetSequence('user');\n * sequence('user'); // 1\n *\n * resetSequence('order', 1000);\n * sequence('order'); // 1001\n * ```\n */\nexport function resetSequence(name = 'default', value = 0): void {\n\tif (sequences.has(name)) {\n\t\tconst counter = sequences.get(name) as AtomicCounter;\n\t\tcounter.reset(value);\n\t} else {\n\t\tsequences.set(name, new AtomicCounter(value));\n\t}\n}\n\n/**\n * Resets all sequence counters.\n * Useful for cleaning up between test suites to ensure predictable sequences.\n *\n * @example\n * ```typescript\n * // In test setup\n * beforeEach(() => {\n *   resetAllSequences();\n * });\n *\n * it('starts sequences from 1', () => {\n *   expect(sequence()).toBe(1);\n *   expect(sequence('user')).toBe(1);\n * });\n * ```\n */\nexport function resetAllSequences(): void {\n\tsequences.clear();\n}\n\n/**\n * Generates a random price as a number.\n * Converts faker's string price to a numeric value.\n *\n * @returns A random price number\n *\n * @example\n * ```typescript\n * const productPrice = price(); // 29.99\n * const total = price() * quantity; // Numeric calculation\n * ```\n */\nfunction price(): number {\n\treturn +faker.commerce.price();\n}\n\ntype Coordinate = {\n\tlat: number;\n\tlng: number;\n};\n\nexport function coordinateInRadius(\n\tcenter: Coordinate,\n\tradius: number,\n): Coordinate {\n\t// Earth's radius in meters\n\tconst earth = 6378137;\n\t// Convert radius from meters to degrees\n\tconst d = radius / earth;\n\n\t// Random bearing and distance\n\tconst theta = 2 * Math.PI * Math.random();\n\tconst r = d * Math.sqrt(Math.random());\n\n\tconst lat1 = (center.lat * Math.PI) / 180;\n\tconst lng1 = (center.lng * Math.PI) / 180;\n\n\tconst lat2 = Math.asin(\n\t\tMath.sin(lat1) * Math.cos(r) +\n\t\t\tMath.cos(lat1) * Math.sin(r) * Math.cos(theta),\n\t);\n\tconst lng2 =\n\t\tlng1 +\n\t\tMath.atan2(\n\t\t\tMath.sin(theta) * Math.sin(r) * Math.cos(lat1),\n\t\t\tMath.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n\t\t);\n\n\treturn {\n\t\tlat: (lat2 * 180) / Math.PI,\n\t\tlng: (lng2 * 180) / Math.PI,\n\t};\n}\n\nfunction coordinateOutsideRadius(\n\tcenter: Coordinate,\n\tminRadiusMeters: number,\n\tmaxRadiusMeters: number,\n): Coordinate {\n\t// Earth's radius in meters\n\tconst earth = 6378137;\n\n\t// Convert radii from meters to radians\n\tconst minD = minRadiusMeters / earth;\n\tconst maxD = maxRadiusMeters / earth;\n\n\t// Random bearing\n\tconst theta = 2 * Math.PI * Math.random();\n\n\t// Random distance in annular ring (uniform distribution by area)\n\t// For uniform distribution in annulus: r = sqrt(r_min² + (r_max² - r_min²) * random)\n\tconst r = Math.sqrt(\n\t\tminD * minD + (maxD * maxD - minD * minD) * Math.random(),\n\t);\n\n\tconst lat1 = (center.lat * Math.PI) / 180;\n\tconst lng1 = (center.lng * Math.PI) / 180;\n\n\tconst lat2 = Math.asin(\n\t\tMath.sin(lat1) * Math.cos(r) +\n\t\t\tMath.cos(lat1) * Math.sin(r) * Math.cos(theta),\n\t);\n\tconst lng2 =\n\t\tlng1 +\n\t\tMath.atan2(\n\t\t\tMath.sin(theta) * Math.sin(r) * Math.cos(lat1),\n\t\t\tMath.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n\t\t);\n\n\t// Normalize longitude to [-180, 180]\n\tconst normalizedLng = (((lng2 * 180) / Math.PI + 540) % 360) - 180;\n\n\treturn {\n\t\tlat: (lat2 * 180) / Math.PI,\n\t\tlng: normalizedLng,\n\t};\n}\n\n/**\n * Enhanced faker instance with additional utility methods for testing.\n * Extends @faker-js/faker with custom methods for common test data generation patterns.\n *\n * @example\n * ```typescript\n * import { faker } from '@geekmidas/testkit';\n *\n * // Use standard faker methods\n * const name = faker.person.fullName();\n * const email = faker.internet.email();\n *\n * // Use custom extensions\n * const { createdAt, updatedAt } = faker.timestamps();\n * const id = faker.identifier('user');\n * const orderNumber = faker.sequence('order');\n * const productPrice = faker.price();\n * ```\n */\nexport const faker = Object.freeze(\n\tObject.assign({}, baseFaker, {\n\t\ttimestamps,\n\t\tidentifier,\n\t\tsequence,\n\t\tresetSequence,\n\t\tresetAllSequences,\n\t\tprice,\n\t\tcoordinates: {\n\t\t\twithin: coordinateInRadius,\n\t\t\toutside: coordinateOutsideRadius,\n\t\t},\n\t}),\n);\n\n/**\n * Type definition for timestamp fields.\n * Used by the timestamps() function to generate date fields.\n */\nexport type Timestamps = {\n\t/** The creation date */\n\tcreatedAt: Date;\n\t/** The last update date */\n\tupdatedAt: Date;\n};\n\n/**\n * Type definition for the enhanced faker factory.\n * Includes all standard faker methods plus custom extensions.\n */\nexport type FakerFactory = typeof faker;\n"],"mappings":"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"}