@geekmidas/testkit 0.0.9 → 0.0.11

package/dist/VitestTransactionIsolator.d.mts

@@ -0,0 +1,2 @@
+import { DatabaseFixtures, IsolationLevel, VitestPostgresTransactionIsolator } from "./VitestTransactionIsolator-Xqyjlmw6.mjs";
+export { DatabaseFixtures, IsolationLevel, VitestPostgresTransactionIsolator };

package/dist/__tests__/Factory.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/Factory.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/KyselyFactory.spec.cjs

@@ -2,8 +2,8 @@ const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
 require('../faker-SMN4ira4.cjs');
 const require_KyselyFactory = require('../KyselyFactory-Bdq1s1Go.cjs');
-require('../PostgresMigrator-BtAWdLss.cjs');
-require('../PostgresKyselyMigrator-Bs31emFd.cjs');
+require('../PostgresMigrator-DFcNdCvD.cjs');
+require('../PostgresKyselyMigrator-CfytARcA.cjs');
 require('../VitestTransactionIsolator-CruLTRRi.cjs');
 require('../VitestKyselyTransactionIsolator-CIlpIO78.cjs');
 const require_helpers = require('../helpers-nEUtQ7eo.cjs');

package/dist/__tests__/KyselyFactory.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/KyselyFactory.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/KyselyFactory.spec.mjs

@@ -1,8 +1,8 @@
 import "../Factory-z2m01hMj.mjs";
 import "../faker-CxKkEeYi.mjs";
 import { KyselyFactory } from "../KyselyFactory-ELiHgHVv.mjs";
-import "../PostgresMigrator-BzqksJcW.mjs";
-import "../PostgresKyselyMigrator-ChIpZFYB.mjs";
+import "../PostgresMigrator-DxPC_gGu.mjs";
+import "../PostgresKyselyMigrator-Bdhl251C.mjs";
 import "../VitestTransactionIsolator-BWwK-ca6.mjs";
 import "../VitestKyselyTransactionIsolator-BKGT9nEG.mjs";
 import { createKyselyDb } from "../helpers-BuPmgzyQ.mjs";

package/dist/__tests__/ObjectionFactory.spec.cjs

@@ -1,6 +1,7 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
-const require_ObjectionFactory = require('../ObjectionFactory-C47B03Ot.cjs');
+const require_faker = require('../faker-SMN4ira4.cjs');
+const require_ObjectionFactory = require('../ObjectionFactory-Wq80ypMM.cjs');
 const require_helpers = require('../helpers-CNMBePuj.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 const objection = require_chunk.__toESM(require("objection"));
@@ -286,6 +287,121 @@ vitest.describe.skip("ObjectionFactory", () => {
 			(0, vitest.expect)(result).toBe(seedFn);
 		});
 	});
+	(0, vitest.describe)("createBuilder static method", () => {
+		(0, vitest.it)("should create a builder function with auto-insert", async () => {
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, faker$1) => ({
+				name: faker$1.person.fullName(),
+				email: faker$1.internet.email(),
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}));
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user", { name: "Test User" });
+			(0, vitest.expect)(result).toBeInstanceOf(User);
+			(0, vitest.expect)(result.name).toBe("Test User");
+			(0, vitest.expect)(result.email).toMatch(/@/);
+			(0, vitest.expect)(result.id).toBeDefined();
+		});
+		(0, vitest.it)("should create a builder function without auto-insert", async () => {
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User, (attrs) => ({
+				name: "No Insert User",
+				email: "noinsert@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}), false);
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user");
+			(0, vitest.expect)(result).toBeInstanceOf(User);
+			(0, vitest.expect)(result.name).toBe("No Insert User");
+			(0, vitest.expect)(result.id).toBeDefined();
+		});
+		(0, vitest.it)("should pass all parameters to the item function", async () => {
+			let capturedFactory;
+			let capturedDb;
+			let capturedFaker;
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, fakerInstance) => {
+				capturedFactory = factory$1;
+				capturedDb = db$1;
+				capturedFaker = fakerInstance;
+				return {
+					name: "Test User",
+					email: "test@example.com",
+					role: "user",
+					createdAt: /* @__PURE__ */ new Date(),
+					updatedAt: /* @__PURE__ */ new Date(),
+					...attrs
+				};
+			});
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			await factory.insert("user");
+			(0, vitest.expect)(capturedFactory).toBe(factory);
+			(0, vitest.expect)(capturedDb).toBe(trx);
+			(0, vitest.expect)(capturedFaker).toBe(require_faker.faker);
+		});
+		(0, vitest.it)("should handle async item functions", async () => {
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User, async (attrs, factory$1, db$1, faker$1) => {
+				await new Promise((resolve) => setTimeout(resolve, 10));
+				return {
+					name: "Async User",
+					email: faker$1.internet.email(),
+					role: "user",
+					createdAt: /* @__PURE__ */ new Date(),
+					updatedAt: /* @__PURE__ */ new Date(),
+					...attrs
+				};
+			});
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user");
+			(0, vitest.expect)(result).toBeInstanceOf(User);
+			(0, vitest.expect)(result.name).toBe("Async User");
+			(0, vitest.expect)(result.id).toBeDefined();
+		});
+		(0, vitest.it)("should work without item function", async () => {
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User);
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			const attrs = {
+				name: "Manual User",
+				email: "manual@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date()
+			};
+			const result = await factory.insert("user", attrs);
+			(0, vitest.expect)(result).toBeInstanceOf(User);
+			(0, vitest.expect)(result.name).toBe("Manual User");
+			(0, vitest.expect)(result.email).toBe("manual@example.com");
+			(0, vitest.expect)(result.id).toBeDefined();
+		});
+		(0, vitest.it)("should allow overriding default values", async () => {
+			const userBuilder = require_ObjectionFactory.ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, faker$1) => ({
+				name: "Default Name",
+				email: "default@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}));
+			const builders = { user: userBuilder };
+			factory = new require_ObjectionFactory.ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user", {
+				name: "Override Name",
+				email: "override@example.com"
+			});
+			(0, vitest.expect)(result).toBeInstanceOf(User);
+			(0, vitest.expect)(result.name).toBe("Override Name");
+			(0, vitest.expect)(result.email).toBe("override@example.com");
+			(0, vitest.expect)(result.role).toBe("user");
+		});
+	});
 	(0, vitest.describe)("error handling", () => {
 		(0, vitest.it)("should handle builder errors gracefully", async () => {
 			const userBuilder = async (attrs, factory$1, db$1) => {

package/dist/__tests__/ObjectionFactory.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/ObjectionFactory.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/ObjectionFactory.spec.mjs

@@ -1,5 +1,6 @@
 import "../Factory-z2m01hMj.mjs";
-import { ObjectionFactory } from "../ObjectionFactory-89p-FFEw.mjs";
+import { faker } from "../faker-CxKkEeYi.mjs";
+import { ObjectionFactory } from "../ObjectionFactory-aqM0dDW7.mjs";
 import { setupKnexTest } from "../helpers-BEmjyUVE.mjs";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
 import { Model } from "objection";
@@ -285,6 +286,121 @@ describe.skip("ObjectionFactory", () => {
 			expect(result).toBe(seedFn);
 		});
 	});
+	describe("createBuilder static method", () => {
+		it("should create a builder function with auto-insert", async () => {
+			const userBuilder = ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, faker$1) => ({
+				name: faker$1.person.fullName(),
+				email: faker$1.internet.email(),
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}));
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user", { name: "Test User" });
+			expect(result).toBeInstanceOf(User);
+			expect(result.name).toBe("Test User");
+			expect(result.email).toMatch(/@/);
+			expect(result.id).toBeDefined();
+		});
+		it("should create a builder function without auto-insert", async () => {
+			const userBuilder = ObjectionFactory.createBuilder(User, (attrs) => ({
+				name: "No Insert User",
+				email: "noinsert@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}), false);
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user");
+			expect(result).toBeInstanceOf(User);
+			expect(result.name).toBe("No Insert User");
+			expect(result.id).toBeDefined();
+		});
+		it("should pass all parameters to the item function", async () => {
+			let capturedFactory;
+			let capturedDb;
+			let capturedFaker;
+			const userBuilder = ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, fakerInstance) => {
+				capturedFactory = factory$1;
+				capturedDb = db$1;
+				capturedFaker = fakerInstance;
+				return {
+					name: "Test User",
+					email: "test@example.com",
+					role: "user",
+					createdAt: /* @__PURE__ */ new Date(),
+					updatedAt: /* @__PURE__ */ new Date(),
+					...attrs
+				};
+			});
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			await factory.insert("user");
+			expect(capturedFactory).toBe(factory);
+			expect(capturedDb).toBe(trx);
+			expect(capturedFaker).toBe(faker);
+		});
+		it("should handle async item functions", async () => {
+			const userBuilder = ObjectionFactory.createBuilder(User, async (attrs, factory$1, db$1, faker$1) => {
+				await new Promise((resolve) => setTimeout(resolve, 10));
+				return {
+					name: "Async User",
+					email: faker$1.internet.email(),
+					role: "user",
+					createdAt: /* @__PURE__ */ new Date(),
+					updatedAt: /* @__PURE__ */ new Date(),
+					...attrs
+				};
+			});
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user");
+			expect(result).toBeInstanceOf(User);
+			expect(result.name).toBe("Async User");
+			expect(result.id).toBeDefined();
+		});
+		it("should work without item function", async () => {
+			const userBuilder = ObjectionFactory.createBuilder(User);
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			const attrs = {
+				name: "Manual User",
+				email: "manual@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date()
+			};
+			const result = await factory.insert("user", attrs);
+			expect(result).toBeInstanceOf(User);
+			expect(result.name).toBe("Manual User");
+			expect(result.email).toBe("manual@example.com");
+			expect(result.id).toBeDefined();
+		});
+		it("should allow overriding default values", async () => {
+			const userBuilder = ObjectionFactory.createBuilder(User, (attrs, factory$1, db$1, faker$1) => ({
+				name: "Default Name",
+				email: "default@example.com",
+				role: "user",
+				createdAt: /* @__PURE__ */ new Date(),
+				updatedAt: /* @__PURE__ */ new Date(),
+				...attrs
+			}));
+			const builders = { user: userBuilder };
+			factory = new ObjectionFactory(builders, {}, trx);
+			const result = await factory.insert("user", {
+				name: "Override Name",
+				email: "override@example.com"
+			});
+			expect(result).toBeInstanceOf(User);
+			expect(result.name).toBe("Override Name");
+			expect(result.email).toBe("override@example.com");
+			expect(result.role).toBe("user");
+		});
+	});
 	describe("error handling", () => {
 		it("should handle builder errors gracefully", async () => {
 			const userBuilder = async (attrs, factory$1, db$1) => {

package/dist/__tests__/PostgresMigrator.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_PostgresMigrator = require('../PostgresMigrator-BtAWdLss.cjs');
+const require_PostgresMigrator = require('../PostgresMigrator-DFcNdCvD.cjs');
 const require_helpers = require('../helpers-CNMBePuj.cjs');
 const pg = require_chunk.__toESM(require("pg"));
 const vitest = require_chunk.__toESM(require("vitest"));

package/dist/__tests__/PostgresMigrator.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/PostgresMigrator.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/PostgresMigrator.spec.mjs

@@ -1,4 +1,4 @@
-import { PostgresMigrator } from "../PostgresMigrator-BzqksJcW.mjs";
+import { PostgresMigrator } from "../PostgresMigrator-DxPC_gGu.mjs";
 import { createTestDatabase } from "../helpers-BEmjyUVE.mjs";
 import { Client } from "pg";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";

package/dist/__tests__/PostgresObjectionMigrator.spec.cjs

@@ -1,6 +1,6 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-require('../PostgresMigrator-BtAWdLss.cjs');
-const require_PostgresObjectionMigrator = require('../PostgresObjectionMigrator-B88aTT0m.cjs');
+require('../PostgresMigrator-DFcNdCvD.cjs');
+const require_PostgresObjectionMigrator = require('../PostgresObjectionMigrator-BG6ymgnt.cjs');
 const require_helpers = require('../helpers-CNMBePuj.cjs');
 const pg = require_chunk.__toESM(require("pg"));
 const vitest = require_chunk.__toESM(require("vitest"));

package/dist/__tests__/PostgresObjectionMigrator.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/PostgresObjectionMigrator.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/PostgresObjectionMigrator.spec.mjs

@@ -1,5 +1,5 @@
-import "../PostgresMigrator-BzqksJcW.mjs";
-import { PostgresObjectionMigrator } from "../PostgresObjectionMigrator-DydSgYFv.mjs";
+import "../PostgresMigrator-DxPC_gGu.mjs";
+import { PostgresObjectionMigrator } from "../PostgresObjectionMigrator-G4h5FLvU.mjs";
 import { createTestDatabase } from "../helpers-BEmjyUVE.mjs";
 import { Client } from "pg";
 import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";

package/dist/__tests__/VitestObjectionTransactionIsolator.spec.cjs

@@ -1,8 +1,9 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
-require('../ObjectionFactory-C47B03Ot.cjs');
-require('../PostgresMigrator-BtAWdLss.cjs');
-require('../PostgresObjectionMigrator-B88aTT0m.cjs');
+require('../faker-SMN4ira4.cjs');
+require('../ObjectionFactory-Wq80ypMM.cjs');
+require('../PostgresMigrator-DFcNdCvD.cjs');
+require('../PostgresObjectionMigrator-BG6ymgnt.cjs');
 require('../VitestTransactionIsolator-CruLTRRi.cjs');
 require('../VitestObjectionTransactionIsolator-DyqLp_in.cjs');
 const require_objection = require('../objection-CCD8fMLj.cjs');

package/dist/__tests__/VitestObjectionTransactionIsolator.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/VitestObjectionTransactionIsolator.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/VitestObjectionTransactionIsolator.spec.mjs

@@ -1,7 +1,8 @@
 import "../Factory-z2m01hMj.mjs";
-import "../ObjectionFactory-89p-FFEw.mjs";
-import "../PostgresMigrator-BzqksJcW.mjs";
-import "../PostgresObjectionMigrator-DydSgYFv.mjs";
+import "../faker-CxKkEeYi.mjs";
+import "../ObjectionFactory-aqM0dDW7.mjs";
+import "../PostgresMigrator-DxPC_gGu.mjs";
+import "../PostgresObjectionMigrator-G4h5FLvU.mjs";
 import "../VitestTransactionIsolator-BWwK-ca6.mjs";
 import "../VitestObjectionTransactionIsolator-BPoLUFop.mjs";
 import { wrapVitestObjectionTransaction } from "../objection-lsMgM5gP.mjs";

package/dist/__tests__/faker.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/faker.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/integration.spec.cjs

@@ -2,8 +2,8 @@ const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
 require('../faker-SMN4ira4.cjs');
 const require_KyselyFactory = require('../KyselyFactory-Bdq1s1Go.cjs');
-require('../PostgresMigrator-BtAWdLss.cjs');
-require('../PostgresKyselyMigrator-Bs31emFd.cjs');
+require('../PostgresMigrator-DFcNdCvD.cjs');
+require('../PostgresKyselyMigrator-CfytARcA.cjs');
 require('../VitestTransactionIsolator-CruLTRRi.cjs');
 require('../VitestKyselyTransactionIsolator-CIlpIO78.cjs');
 const require_helpers = require('../helpers-nEUtQ7eo.cjs');

package/dist/__tests__/integration.spec.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/integration.spec.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/__tests__/integration.spec.mjs

@@ -1,8 +1,8 @@
 import "../Factory-z2m01hMj.mjs";
 import "../faker-CxKkEeYi.mjs";
 import { KyselyFactory } from "../KyselyFactory-ELiHgHVv.mjs";
-import "../PostgresMigrator-BzqksJcW.mjs";
-import "../PostgresKyselyMigrator-ChIpZFYB.mjs";
+import "../PostgresMigrator-DxPC_gGu.mjs";
+import "../PostgresKyselyMigrator-Bdhl251C.mjs";
 import "../VitestTransactionIsolator-BWwK-ca6.mjs";
 import "../VitestKyselyTransactionIsolator-BKGT9nEG.mjs";
 import { createKyselyDb } from "../helpers-BuPmgzyQ.mjs";

package/dist/example.d.cts

@@ -0,0 +1,26 @@
+import { FakerFactory } from "./faker-DAiFK3T3.cjs";
+import * as kysely0 from "kysely";
+
+//#region src/example.d.ts
+interface Database {
+  users: {
+    id: number;
+    name: string;
+    email: string;
+    createdAt: Date;
+  };
+  posts: {
+    id: number;
+    title: string;
+    content: string;
+    userId: number;
+    createdAt: Date;
+  };
+}
+declare const builders: {
+  user: (attrs: Partial<kysely0.Insertable<DB[TableName]>>, factory: any, db: kysely0.Kysely<Database>, faker: FakerFactory) => Promise<kysely0.Selectable<DB[TableName]>>;
+};
+type Builders = typeof builders;
+type Seeds = Record<string, any>;
+//#endregion
+export { Builders, Seeds };

package/dist/example.d.mts

@@ -0,0 +1,26 @@
+import { FakerFactory } from "./faker-nN9Ki6fn.mjs";
+import * as kysely0 from "kysely";
+
+//#region src/example.d.ts
+interface Database {
+  users: {
+    id: number;
+    name: string;
+    email: string;
+    createdAt: Date;
+  };
+  posts: {
+    id: number;
+    title: string;
+    content: string;
+    userId: number;
+    createdAt: Date;
+  };
+}
+declare const builders: {
+  user: (attrs: Partial<kysely0.Insertable<DB[TableName]>>, factory: any, db: kysely0.Kysely<Database>, faker: FakerFactory) => Promise<kysely0.Selectable<DB[TableName]>>;
+};
+type Builders = typeof builders;
+type Seeds = Record<string, any>;
+//#endregion
+export { Builders, Seeds };

package/dist/faker-DAiFK3T3.d.cts

@@ -0,0 +1,155 @@
+import * as _faker_js_faker4 from "@faker-js/faker";
+
+//#region src/faker.d.ts
+
+/**
+ * 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()
+ * };
+ * ```
+ */
+declare function timestamps(): Timestamps;
+/**
+ * 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"
+ * ```
+ */
+declare function identifier(suffix?: string): string;
+/**
+ * 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`;
+ * ```
+ */
+declare function sequence(name?: string): number;
+/**
+ * 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
+ * ```
+ */
+declare function resetSequence(name?: string, value?: number): void;
+/**
+ * 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);
+ * });
+ * ```
+ */
+declare function resetAllSequences(): void;
+/**
+ * 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
+ * ```
+ */
+declare function price(): number;
+/**
+ * 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();
+ * ```
+ */
+declare const faker: Readonly<_faker_js_faker4.Faker & {
+  timestamps: typeof timestamps;
+  identifier: typeof identifier;
+  sequence: typeof sequence;
+  resetSequence: typeof resetSequence;
+  resetAllSequences: typeof resetAllSequences;
+  price: typeof price;
+}>;
+/**
+ * Type definition for timestamp fields.
+ * Used by the timestamps() function to generate date fields.
+ */
+type Timestamps = {
+  /** The creation date */
+  createdAt: Date;
+  /** The last update date */
+  updatedAt: Date;
+};
+/**
+ * Type definition for the enhanced faker factory.
+ * Includes all standard faker methods plus custom extensions.
+ */
+type FakerFactory = typeof faker;
+//#endregion
+export { FakerFactory, Timestamps, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };