@geekmidas/testkit 0.0.10 → 0.0.12

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-BGKYFoCT.mjs";
+import { ObjectionFactory } from "../ObjectionFactory-qIICOph3.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.d.cts

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

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

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

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__/VitestObjectionTransactionIsolator.spec.cjs

@@ -1,6 +1,7 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
-require('../ObjectionFactory-C47B03Ot.cjs');
+require('../faker-B14IEMIN.cjs');
+require('../ObjectionFactory-DxIxJagq.cjs');
 require('../PostgresMigrator-DFcNdCvD.cjs');
 require('../PostgresObjectionMigrator-BG6ymgnt.cjs');
 require('../VitestTransactionIsolator-CruLTRRi.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,5 +1,6 @@
 import "../Factory-z2m01hMj.mjs";
-import "../ObjectionFactory-89p-FFEw.mjs";
+import "../faker-BGKYFoCT.mjs";
+import "../ObjectionFactory-qIICOph3.mjs";
 import "../PostgresMigrator-DxPC_gGu.mjs";
 import "../PostgresObjectionMigrator-G4h5FLvU.mjs";
 import "../VitestTransactionIsolator-BWwK-ca6.mjs";

package/dist/__tests__/faker.spec.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
-const require_faker = require('../faker-SMN4ira4.cjs');
+const require_faker = require('../faker-B14IEMIN.cjs');
 const vitest = require_chunk.__toESM(require("vitest"));
 
 //#region src/__tests__/faker.spec.ts

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__/faker.spec.mjs

@@ -1,4 +1,4 @@
-import { faker } from "../faker-CxKkEeYi.mjs";
+import { faker } from "../faker-BGKYFoCT.mjs";
 import { beforeEach, describe, expect, it } from "vitest";
 
 //#region src/__tests__/faker.spec.ts

package/dist/__tests__/integration.spec.cjs

@@ -1,7 +1,7 @@
 const require_chunk = require('../chunk-CUT6urMc.cjs');
 require('../Factory-WMhTNZ9S.cjs');
-require('../faker-SMN4ira4.cjs');
-const require_KyselyFactory = require('../KyselyFactory-Bdq1s1Go.cjs');
+require('../faker-B14IEMIN.cjs');
+const require_KyselyFactory = require('../KyselyFactory-CXtfmMfK.cjs');
 require('../PostgresMigrator-DFcNdCvD.cjs');
 require('../PostgresKyselyMigrator-CfytARcA.cjs');
 require('../VitestTransactionIsolator-CruLTRRi.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,6 +1,6 @@
 import "../Factory-z2m01hMj.mjs";
-import "../faker-CxKkEeYi.mjs";
-import { KyselyFactory } from "../KyselyFactory-ELiHgHVv.mjs";
+import "../faker-BGKYFoCT.mjs";
+import { KyselyFactory } from "../KyselyFactory-C3Bc3p4L.mjs";
 import "../PostgresMigrator-DxPC_gGu.mjs";
 import "../PostgresKyselyMigrator-Bdhl251C.mjs";
 import "../VitestTransactionIsolator-BWwK-ca6.mjs";

package/dist/example.cjs

@@ -1,6 +1,6 @@
 require('./Factory-WMhTNZ9S.cjs');
-require('./faker-SMN4ira4.cjs');
-const require_KyselyFactory = require('./KyselyFactory-Bdq1s1Go.cjs');
+require('./faker-B14IEMIN.cjs');
+const require_KyselyFactory = require('./KyselyFactory-CXtfmMfK.cjs');
 
 //#region src/example.ts
 const userBuilder = require_KyselyFactory.KyselyFactory.createBuilder({

package/dist/example.d.cts

@@ -0,0 +1,26 @@
+import { FakerFactory } from "./faker-km9UhOS6.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-ChuHaYMR.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/example.mjs

@@ -1,6 +1,6 @@
 import "./Factory-z2m01hMj.mjs";
-import "./faker-CxKkEeYi.mjs";
-import { KyselyFactory } from "./KyselyFactory-ELiHgHVv.mjs";
+import "./faker-BGKYFoCT.mjs";
+import { KyselyFactory } from "./KyselyFactory-C3Bc3p4L.mjs";
 
 //#region src/example.ts
 const userBuilder = KyselyFactory.createBuilder({

package/dist/{faker-SMN4ira4.cjs → faker-B14IEMIN.cjs}

@@ -196,6 +196,36 @@ function resetAllSequences() {
 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.
@@ -221,10 +251,20 @@ const faker = Object.freeze(Object.assign({}, __faker_js_faker.faker, {
 	sequence,
 	resetSequence,
 	resetAllSequences,
-	price
+	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 () {

package/dist/{faker-CxKkEeYi.mjs → faker-BGKYFoCT.mjs}

@@ -195,6 +195,36 @@ function resetAllSequences() {
 function price() {
 	return +faker$1.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.
@@ -220,8 +250,12 @@ const faker$1 = Object.freeze(Object.assign({}, faker, {
 	sequence,
 	resetSequence,
 	resetAllSequences,
-	price
+	price,
+	coordinates: {
+		within: coordinateInRadius,
+		outside: coordinateOutsideRadius
+	}
 }));
 
 //#endregion
-export { faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+export { coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };

package/dist/faker-ChuHaYMR.d.mts

@@ -0,0 +1,165 @@
+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;
+type Coordinate = {
+  lat: number;
+  lng: number;
+};
+declare function coordinateInRadius(center: Coordinate, radius: number): Coordinate;
+declare function coordinateOutsideRadius(center: Coordinate, minRadiusMeters: number, maxRadiusMeters: number): Coordinate;
+/**
+ * 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$1: Readonly<_faker_js_faker4.Faker & {
+  timestamps: typeof timestamps;
+  identifier: typeof identifier;
+  sequence: typeof sequence;
+  resetSequence: typeof resetSequence;
+  resetAllSequences: typeof resetAllSequences;
+  price: typeof price;
+  coordinates: {
+    within: typeof coordinateInRadius;
+    outside: typeof coordinateOutsideRadius;
+  };
+}>;
+/**
+ * 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$1;
+//#endregion
+export { FakerFactory, Timestamps, coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };