@geekmidas/testkit 0.0.14 → 0.0.16

package/dist/aws.mjs

@@ -0,0 +1,123 @@
+import { vi } from "vitest";
+
+//#region src/aws.ts
+/**
+* Shared test utilities for AWS Lambda adapter testing
+*/
+/**
+* Creates a mock AWS Lambda Context for testing
+*/
+function createMockContext() {
+	return {
+		awsRequestId: "test-request-id",
+		callbackWaitsForEmptyEventLoop: false,
+		functionName: "test-function",
+		functionVersion: "1",
+		invokedFunctionArn: "arn:aws:lambda:us-east-1:123456789012:function:test-function",
+		memoryLimitInMB: "128",
+		logGroupName: "/aws/lambda/test-function",
+		logStreamName: "2024/01/01/[$LATEST]abcdef123456",
+		getRemainingTimeInMillis: () => 5e3,
+		done: vi.fn(),
+		fail: vi.fn(),
+		succeed: vi.fn()
+	};
+}
+/**
+* Creates a mock AWS API Gateway V1 (REST API) event for testing
+*/
+function createMockV1Event(overrides = {}) {
+	return {
+		body: null,
+		headers: {
+			"content-type": "application/json",
+			"user-agent": "test-agent",
+			host: "test.example.com"
+		},
+		multiValueHeaders: {},
+		httpMethod: "GET",
+		isBase64Encoded: false,
+		path: "/test",
+		pathParameters: null,
+		queryStringParameters: null,
+		multiValueQueryStringParameters: null,
+		stageVariables: null,
+		requestContext: {
+			accountId: "123456789012",
+			apiId: "api-id",
+			authorizer: null,
+			protocol: "HTTP/1.1",
+			httpMethod: "GET",
+			path: "/test",
+			stage: "test",
+			requestId: "request-id",
+			requestTimeEpoch: 17040672e5,
+			resourceId: "resource-id",
+			resourcePath: "/test",
+			identity: {
+				accessKey: null,
+				accountId: null,
+				apiKey: null,
+				apiKeyId: null,
+				caller: null,
+				cognitoAuthenticationProvider: null,
+				cognitoAuthenticationType: null,
+				cognitoIdentityId: null,
+				cognitoIdentityPoolId: null,
+				principalOrgId: null,
+				sourceIp: "127.0.0.1",
+				user: null,
+				userAgent: "test-agent",
+				userArn: null,
+				clientCert: null
+			}
+		},
+		resource: "/test",
+		...overrides
+	};
+}
+/**
+* Creates a mock AWS API Gateway V2 (HTTP API) event for testing
+*/
+function createMockV2Event(overrides = {}) {
+	return {
+		version: "2.0",
+		routeKey: "GET /test",
+		rawPath: "/test",
+		rawQueryString: "",
+		headers: {
+			"content-type": "application/json",
+			"user-agent": "test-agent",
+			host: "test.example.com"
+		},
+		requestContext: {
+			accountId: "123456789012",
+			apiId: "api-id",
+			domainName: "test.example.com",
+			domainPrefix: "api",
+			requestId: "request-id",
+			routeKey: "GET /test",
+			stage: "test",
+			time: "01/Jan/2024:00:00:00 +0000",
+			timeEpoch: 17040672e5,
+			http: {
+				method: "GET",
+				path: "/test",
+				protocol: "HTTP/1.1",
+				sourceIp: "127.0.0.1",
+				userAgent: "test-agent"
+			}
+		},
+		body: void 0,
+		pathParameters: void 0,
+		isBase64Encoded: false,
+		stageVariables: void 0,
+		queryStringParameters: void 0,
+		cookies: void 0,
+		...overrides
+	};
+}
+
+//#endregion
+export { createMockContext, createMockV1Event, createMockV2Event };
+//# sourceMappingURL=aws.mjs.map

package/dist/aws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws.mjs","names":["overrides: Partial<APIGatewayProxyEvent>","overrides: Partial<APIGatewayProxyEventV2>"],"sources":["../src/aws.ts"],"sourcesContent":["import type {\n  APIGatewayProxyEvent,\n  APIGatewayProxyEventV2,\n  Context,\n} from 'aws-lambda';\nimport { vi } from 'vitest';\n\n/**\n * Shared test utilities for AWS Lambda adapter testing\n */\n\n/**\n * Creates a mock AWS Lambda Context for testing\n */\nexport function createMockContext(): Context {\n  return {\n    awsRequestId: 'test-request-id',\n    callbackWaitsForEmptyEventLoop: false,\n    functionName: 'test-function',\n    functionVersion: '1',\n    invokedFunctionArn:\n      'arn:aws:lambda:us-east-1:123456789012:function:test-function',\n    memoryLimitInMB: '128',\n    logGroupName: '/aws/lambda/test-function',\n    logStreamName: '2024/01/01/[$LATEST]abcdef123456',\n    getRemainingTimeInMillis: () => 5000,\n    done: vi.fn(),\n    fail: vi.fn(),\n    succeed: vi.fn(),\n  };\n}\n\n/**\n * Creates a mock AWS API Gateway V1 (REST API) event for testing\n */\nexport function createMockV1Event(\n  overrides: Partial<APIGatewayProxyEvent> = {},\n): APIGatewayProxyEvent {\n  return {\n    body: null,\n    headers: {\n      'content-type': 'application/json',\n      'user-agent': 'test-agent',\n      host: 'test.example.com',\n    },\n    multiValueHeaders: {},\n    httpMethod: 'GET',\n    isBase64Encoded: false,\n    path: '/test',\n    pathParameters: null,\n    queryStringParameters: null,\n    multiValueQueryStringParameters: null,\n    stageVariables: null,\n    requestContext: {\n      accountId: '123456789012',\n      apiId: 'api-id',\n      authorizer: null,\n      protocol: 'HTTP/1.1',\n      httpMethod: 'GET',\n      path: '/test',\n      stage: 'test',\n      requestId: 'request-id',\n      requestTimeEpoch: 1704067200000,\n      resourceId: 'resource-id',\n      resourcePath: '/test',\n      identity: {\n        accessKey: null,\n        accountId: null,\n        apiKey: null,\n        apiKeyId: null,\n        caller: null,\n        cognitoAuthenticationProvider: null,\n        cognitoAuthenticationType: null,\n        cognitoIdentityId: null,\n        cognitoIdentityPoolId: null,\n        principalOrgId: null,\n        sourceIp: '127.0.0.1',\n        user: null,\n        userAgent: 'test-agent',\n        userArn: null,\n        clientCert: null,\n      },\n    },\n    resource: '/test',\n    ...overrides,\n  };\n}\n\n/**\n * Creates a mock AWS API Gateway V2 (HTTP API) event for testing\n */\nexport function createMockV2Event(\n  overrides: Partial<APIGatewayProxyEventV2> = {},\n): APIGatewayProxyEventV2 {\n  return {\n    version: '2.0',\n    routeKey: 'GET /test',\n    rawPath: '/test',\n    rawQueryString: '',\n    headers: {\n      'content-type': 'application/json',\n      'user-agent': 'test-agent',\n      host: 'test.example.com',\n    },\n    requestContext: {\n      accountId: '123456789012',\n      apiId: 'api-id',\n      domainName: 'test.example.com',\n      domainPrefix: 'api',\n      requestId: 'request-id',\n      routeKey: 'GET /test',\n      stage: 'test',\n      time: '01/Jan/2024:00:00:00 +0000',\n      timeEpoch: 1704067200000,\n      http: {\n        method: 'GET',\n        path: '/test',\n        protocol: 'HTTP/1.1',\n        sourceIp: '127.0.0.1',\n        userAgent: 'test-agent',\n      },\n    },\n    body: undefined,\n    pathParameters: undefined,\n    isBase64Encoded: false,\n    stageVariables: undefined,\n    queryStringParameters: undefined,\n    cookies: undefined,\n    ...overrides,\n  };\n}\n"],"mappings":";;;;;;;;;AAcA,SAAgB,oBAA6B;AAC3C,QAAO;EACL,cAAc;EACd,gCAAgC;EAChC,cAAc;EACd,iBAAiB;EACjB,oBACE;EACF,iBAAiB;EACjB,cAAc;EACd,eAAe;EACf,0BAA0B,MAAM;EAChC,MAAM,GAAG,IAAI;EACb,MAAM,GAAG,IAAI;EACb,SAAS,GAAG,IAAI;CACjB;AACF;;;;AAKD,SAAgB,kBACdA,YAA2C,CAAE,GACvB;AACtB,QAAO;EACL,MAAM;EACN,SAAS;GACP,gBAAgB;GAChB,cAAc;GACd,MAAM;EACP;EACD,mBAAmB,CAAE;EACrB,YAAY;EACZ,iBAAiB;EACjB,MAAM;EACN,gBAAgB;EAChB,uBAAuB;EACvB,iCAAiC;EACjC,gBAAgB;EAChB,gBAAgB;GACd,WAAW;GACX,OAAO;GACP,YAAY;GACZ,UAAU;GACV,YAAY;GACZ,MAAM;GACN,OAAO;GACP,WAAW;GACX,kBAAkB;GAClB,YAAY;GACZ,cAAc;GACd,UAAU;IACR,WAAW;IACX,WAAW;IACX,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,+BAA+B;IAC/B,2BAA2B;IAC3B,mBAAmB;IACnB,uBAAuB;IACvB,gBAAgB;IAChB,UAAU;IACV,MAAM;IACN,WAAW;IACX,SAAS;IACT,YAAY;GACb;EACF;EACD,UAAU;EACV,GAAG;CACJ;AACF;;;;AAKD,SAAgB,kBACdC,YAA6C,CAAE,GACvB;AACxB,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;EACT,gBAAgB;EAChB,SAAS;GACP,gBAAgB;GAChB,cAAc;GACd,MAAM;EACP;EACD,gBAAgB;GACd,WAAW;GACX,OAAO;GACP,YAAY;GACZ,cAAc;GACd,WAAW;GACX,UAAU;GACV,OAAO;GACP,MAAM;GACN,WAAW;GACX,MAAM;IACJ,QAAQ;IACR,MAAM;IACN,UAAU;IACV,UAAU;IACV,WAAW;GACZ;EACF;EACD;EACA;EACA,iBAAiB;EACjB;EACA;EACA;EACA,GAAG;CACJ;AACF"}

package/dist/directory-B-Ozljzk.mjs

@@ -0,0 +1,22 @@
+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
+	});
+} });
+
+//#endregion
+export { itWithDir };
+//# sourceMappingURL=directory-B-Ozljzk.mjs.map

package/dist/directory-B-Ozljzk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-B-Ozljzk.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  // This fixture automatically provides a transaction to each test\n  dir: async ({}, use) => {\n    const tempDir = os.tmpdir();\n    const directoryName = crypto.randomUUID().replace(/-/g, '').toUpperCase();\n    const dir = path.join(tempDir, directoryName);\n    await fs.mkdir(dir, { recursive: true });\n    await use(dir);\n    await fs.rm(dir, { recursive: true, force: true });\n  },\n});\n\nexport interface DirectoryFixtures {\n  dir: string;\n}\n"],"mappings":";;;;;;;AAMA,MAAa,YAAY,GAAG,OAA0B,EAEpD,KAAK,OAAO,EAAE,EAAE,QAAQ;CACtB,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;AACnD,EACF,EAAC"}

package/dist/directory-B4oYx02C.d.mts

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

package/dist/directory-BUcnztHI.d.cts

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

package/dist/directory-BVC8g7cX.cjs

@@ -0,0 +1,28 @@
+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
+	});
+} });
+
+//#endregion
+Object.defineProperty(exports, 'itWithDir', {
+  enumerable: true,
+  get: function () {
+    return itWithDir;
+  }
+});
+//# sourceMappingURL=directory-BVC8g7cX.cjs.map

package/dist/directory-BVC8g7cX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory-BVC8g7cX.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  // This fixture automatically provides a transaction to each test\n  dir: async ({}, use) => {\n    const tempDir = os.tmpdir();\n    const directoryName = crypto.randomUUID().replace(/-/g, '').toUpperCase();\n    const dir = path.join(tempDir, directoryName);\n    await fs.mkdir(dir, { recursive: true });\n    await use(dir);\n    await fs.rm(dir, { recursive: true, force: true });\n  },\n});\n\nexport interface DirectoryFixtures {\n  dir: string;\n}\n"],"mappings":";;;;;;;;AAMA,MAAa,YAAY,UAAG,OAA0B,EAEpD,KAAK,OAAO,EAAE,EAAE,QAAQ;CACtB,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;AACnD,EACF,EAAC"}

package/dist/faker-B14IEMIN.cjs

@@ -300,4 +300,5 @@ Object.defineProperty(exports, 'timestamps', {
   get: function () {
     return timestamps;
   }
-});
+});
+//# sourceMappingURL=faker-B14IEMIN.cjs.map

package/dist/faker-B14IEMIN.cjs.map

@@ -0,0 +1 @@
+{"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  /**\n   * The current counter value.\n   * @private\n   */\n  private value: number;\n\n  /**\n   * Creates a new atomic counter.\n   * @param initialValue - The starting value (default: 0)\n   */\n  constructor(initialValue = 0) {\n    this.value = initialValue;\n  }\n\n  /**\n   * Increments the counter and returns the new value.\n   * @returns The incremented value\n   */\n  increment(): number {\n    // In Node.js, JavaScript is single-threaded within the event loop,\n    // so this operation is already atomic. However, this class provides\n    // a cleaner abstraction and makes the intent explicit.\n    return ++this.value;\n  }\n\n  /**\n   * Gets the current counter value without incrementing.\n   * @returns The current value\n   */\n  get(): number {\n    return this.value;\n  }\n\n  /**\n   * Resets the counter to a specific value.\n   * @param value - The new value (default: 0)\n   */\n  reset(value = 0): void {\n    this.value = value;\n  }\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  const createdAt = faker.date.past();\n  const updatedAt = faker.date.between({\n    from: createdAt,\n    to: new Date(),\n  });\n\n  createdAt.setMilliseconds(0);\n  updatedAt.setMilliseconds(0);\n\n  return { 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  return [\n    faker.internet.domainSuffix(),\n    faker.internet.domainWord(),\n    suffix ? suffix : faker.internet.domainWord() + sequence('identifier'),\n  ].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  if (!sequences.has(name)) {\n    sequences.set(name, new AtomicCounter());\n  }\n\n  const counter = sequences.get(name) as AtomicCounter;\n  return 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  if (sequences.has(name)) {\n    const counter = sequences.get(name) as AtomicCounter;\n    counter.reset(value);\n  } else {\n    sequences.set(name, new AtomicCounter(value));\n  }\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  sequences.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  return +faker.commerce.price();\n}\n\ntype Coordinate = {\n  lat: number;\n  lng: number;\n};\n\nexport function coordinateInRadius(\n  center: Coordinate,\n  radius: number,\n): Coordinate {\n  // Earth's radius in meters\n  const earth = 6378137;\n  // Convert radius from meters to degrees\n  const d = radius / earth;\n\n  // Random bearing and distance\n  const theta = 2 * Math.PI * Math.random();\n  const r = d * Math.sqrt(Math.random());\n\n  const lat1 = (center.lat * Math.PI) / 180;\n  const lng1 = (center.lng * Math.PI) / 180;\n\n  const lat2 = Math.asin(\n    Math.sin(lat1) * Math.cos(r) +\n      Math.cos(lat1) * Math.sin(r) * Math.cos(theta),\n  );\n  const lng2 =\n    lng1 +\n    Math.atan2(\n      Math.sin(theta) * Math.sin(r) * Math.cos(lat1),\n      Math.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n    );\n\n  return {\n    lat: (lat2 * 180) / Math.PI,\n    lng: (lng2 * 180) / Math.PI,\n  };\n}\n\nfunction coordinateOutsideRadius(\n  center: Coordinate,\n  minRadiusMeters: number,\n  maxRadiusMeters: number,\n): Coordinate {\n  // Earth's radius in meters\n  const earth = 6378137;\n\n  // Convert radii from meters to radians\n  const minD = minRadiusMeters / earth;\n  const maxD = maxRadiusMeters / earth;\n\n  // Random bearing\n  const theta = 2 * Math.PI * Math.random();\n\n  // Random distance in annular ring (uniform distribution by area)\n  // For uniform distribution in annulus: r = sqrt(r_min² + (r_max² - r_min²) * random)\n  const r = Math.sqrt(\n    minD * minD + (maxD * maxD - minD * minD) * Math.random(),\n  );\n\n  const lat1 = (center.lat * Math.PI) / 180;\n  const lng1 = (center.lng * Math.PI) / 180;\n\n  const lat2 = Math.asin(\n    Math.sin(lat1) * Math.cos(r) +\n      Math.cos(lat1) * Math.sin(r) * Math.cos(theta),\n  );\n  const lng2 =\n    lng1 +\n    Math.atan2(\n      Math.sin(theta) * Math.sin(r) * Math.cos(lat1),\n      Math.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n    );\n\n  // Normalize longitude to [-180, 180]\n  const normalizedLng = (((lng2 * 180) / Math.PI + 540) % 360) - 180;\n\n  return {\n    lat: (lat2 * 180) / Math.PI,\n    lng: normalizedLng,\n  };\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  Object.assign({}, baseFaker, {\n    timestamps,\n    identifier,\n    sequence,\n    resetSequence,\n    resetAllSequences,\n    price,\n    coordinates: {\n      within: coordinateInRadius,\n      outside: coordinateOutsideRadius,\n    },\n  }),\n);\n\n/**\n * Type definition for timestamp fields.\n * Used by the timestamps() function to generate date fields.\n */\nexport type Timestamps = {\n  /** The creation date */\n  createdAt: Date;\n  /** The last update date */\n  updatedAt: 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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"}

package/dist/faker-BGKYFoCT.mjs

@@ -258,4 +258,5 @@ const faker$1 = Object.freeze(Object.assign({}, faker, {
 }));
 
 //#endregion
-export { coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+export { coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+//# sourceMappingURL=faker-BGKYFoCT.mjs.map

package/dist/faker-BGKYFoCT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker-BGKYFoCT.mjs","names":["suffix?: string","center: Coordinate","radius: number","minRadiusMeters: number","maxRadiusMeters: number","faker","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  /**\n   * The current counter value.\n   * @private\n   */\n  private value: number;\n\n  /**\n   * Creates a new atomic counter.\n   * @param initialValue - The starting value (default: 0)\n   */\n  constructor(initialValue = 0) {\n    this.value = initialValue;\n  }\n\n  /**\n   * Increments the counter and returns the new value.\n   * @returns The incremented value\n   */\n  increment(): number {\n    // In Node.js, JavaScript is single-threaded within the event loop,\n    // so this operation is already atomic. However, this class provides\n    // a cleaner abstraction and makes the intent explicit.\n    return ++this.value;\n  }\n\n  /**\n   * Gets the current counter value without incrementing.\n   * @returns The current value\n   */\n  get(): number {\n    return this.value;\n  }\n\n  /**\n   * Resets the counter to a specific value.\n   * @param value - The new value (default: 0)\n   */\n  reset(value = 0): void {\n    this.value = value;\n  }\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  const createdAt = faker.date.past();\n  const updatedAt = faker.date.between({\n    from: createdAt,\n    to: new Date(),\n  });\n\n  createdAt.setMilliseconds(0);\n  updatedAt.setMilliseconds(0);\n\n  return { 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  return [\n    faker.internet.domainSuffix(),\n    faker.internet.domainWord(),\n    suffix ? suffix : faker.internet.domainWord() + sequence('identifier'),\n  ].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  if (!sequences.has(name)) {\n    sequences.set(name, new AtomicCounter());\n  }\n\n  const counter = sequences.get(name) as AtomicCounter;\n  return 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  if (sequences.has(name)) {\n    const counter = sequences.get(name) as AtomicCounter;\n    counter.reset(value);\n  } else {\n    sequences.set(name, new AtomicCounter(value));\n  }\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  sequences.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  return +faker.commerce.price();\n}\n\ntype Coordinate = {\n  lat: number;\n  lng: number;\n};\n\nexport function coordinateInRadius(\n  center: Coordinate,\n  radius: number,\n): Coordinate {\n  // Earth's radius in meters\n  const earth = 6378137;\n  // Convert radius from meters to degrees\n  const d = radius / earth;\n\n  // Random bearing and distance\n  const theta = 2 * Math.PI * Math.random();\n  const r = d * Math.sqrt(Math.random());\n\n  const lat1 = (center.lat * Math.PI) / 180;\n  const lng1 = (center.lng * Math.PI) / 180;\n\n  const lat2 = Math.asin(\n    Math.sin(lat1) * Math.cos(r) +\n      Math.cos(lat1) * Math.sin(r) * Math.cos(theta),\n  );\n  const lng2 =\n    lng1 +\n    Math.atan2(\n      Math.sin(theta) * Math.sin(r) * Math.cos(lat1),\n      Math.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n    );\n\n  return {\n    lat: (lat2 * 180) / Math.PI,\n    lng: (lng2 * 180) / Math.PI,\n  };\n}\n\nfunction coordinateOutsideRadius(\n  center: Coordinate,\n  minRadiusMeters: number,\n  maxRadiusMeters: number,\n): Coordinate {\n  // Earth's radius in meters\n  const earth = 6378137;\n\n  // Convert radii from meters to radians\n  const minD = minRadiusMeters / earth;\n  const maxD = maxRadiusMeters / earth;\n\n  // Random bearing\n  const theta = 2 * Math.PI * Math.random();\n\n  // Random distance in annular ring (uniform distribution by area)\n  // For uniform distribution in annulus: r = sqrt(r_min² + (r_max² - r_min²) * random)\n  const r = Math.sqrt(\n    minD * minD + (maxD * maxD - minD * minD) * Math.random(),\n  );\n\n  const lat1 = (center.lat * Math.PI) / 180;\n  const lng1 = (center.lng * Math.PI) / 180;\n\n  const lat2 = Math.asin(\n    Math.sin(lat1) * Math.cos(r) +\n      Math.cos(lat1) * Math.sin(r) * Math.cos(theta),\n  );\n  const lng2 =\n    lng1 +\n    Math.atan2(\n      Math.sin(theta) * Math.sin(r) * Math.cos(lat1),\n      Math.cos(r) - Math.sin(lat1) * Math.sin(lat2),\n    );\n\n  // Normalize longitude to [-180, 180]\n  const normalizedLng = (((lng2 * 180) / Math.PI + 540) % 360) - 180;\n\n  return {\n    lat: (lat2 * 180) / Math.PI,\n    lng: normalizedLng,\n  };\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  Object.assign({}, baseFaker, {\n    timestamps,\n    identifier,\n    sequence,\n    resetSequence,\n    resetAllSequences,\n    price,\n    coordinates: {\n      within: coordinateInRadius,\n      outside: coordinateOutsideRadius,\n    },\n  }),\n);\n\n/**\n * Type definition for timestamp fields.\n * Used by the timestamps() function to generate date fields.\n */\nexport type Timestamps = {\n  /** The creation date */\n  createdAt: Date;\n  /** The last update date */\n  updatedAt: 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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"}

package/dist/{faker-BSH1EMtg.d.cts → faker-Cg76aFNO.d.cts}

@@ -1,4 +1,4 @@
-import * as _faker_js_faker0 from "@faker-js/faker";
+import * as _faker_js_faker1 from "@faker-js/faker";
 
 //#region src/faker.d.ts
 
@@ -134,7 +134,7 @@ declare function coordinateOutsideRadius(center: Coordinate, minRadiusMeters: nu
  * const productPrice = faker.price();
  * ```
  */
-declare const faker: Readonly<_faker_js_faker0.Faker & {
+declare const faker: Readonly<_faker_js_faker1.Faker & {
   timestamps: typeof timestamps;
   identifier: typeof identifier;
   sequence: typeof sequence;
@@ -162,4 +162,5 @@ type Timestamps = {
  */
 type FakerFactory = typeof faker;
 //#endregion
-export { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+export { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+//# sourceMappingURL=faker-Cg76aFNO.d.cts.map

package/dist/{faker-C-Iuk_R1.d.mts → faker-DHh7xs4u.d.mts}

@@ -1,4 +1,4 @@
-import * as _faker_js_faker0 from "@faker-js/faker";
+import * as _faker_js_faker1 from "@faker-js/faker";
 
 //#region src/faker.d.ts
 
@@ -134,7 +134,7 @@ declare function coordinateOutsideRadius(center: Coordinate, minRadiusMeters: nu
  * const productPrice = faker.price();
  * ```
  */
-declare const faker$1: Readonly<_faker_js_faker0.Faker & {
+declare const faker$1: Readonly<_faker_js_faker1.Faker & {
   timestamps: typeof timestamps;
   identifier: typeof identifier;
   sequence: typeof sequence;
@@ -162,4 +162,5 @@ type Timestamps = {
  */
 type FakerFactory = typeof faker$1;
 //#endregion
-export { FakerFactory, Timestamps, coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+export { FakerFactory, Timestamps, coordinateInRadius, faker$1 as faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+//# sourceMappingURL=faker-DHh7xs4u.d.mts.map

package/dist/faker.d.cts

@@ -1,2 +1,2 @@
-import { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps } from "./faker-BSH1EMtg.cjs";
+import { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps } from "./faker-Cg76aFNO.cjs";
 export { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };

package/dist/faker.d.mts

@@ -1,2 +1,2 @@
-import { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps } from "./faker-C-Iuk_R1.mjs";
+import { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps } from "./faker-DHh7xs4u.mjs";
 export { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };

package/dist/helpers.cjs

@@ -1,3 +1,49 @@
-const require_helpers = require('./helpers-nEUtQ7eo.cjs');
+const require_chunk = require('./chunk-CUT6urMc.cjs');
+const kysely = require_chunk.__toESM(require("kysely"));
+const pg = require_chunk.__toESM(require("pg"));
 
-exports.createKyselyDb = require_helpers.createKyselyDb;
+//#region src/helpers.ts
+/**
+* Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.
+* This is a convenience function for quickly setting up a Kysely connection for testing.
+*
+* @template Database - The database schema type
+* @param config - PostgreSQL connection configuration (pg.Pool config)
+* @returns A configured Kysely instance
+*
+* @example
+* ```typescript
+* interface Database {
+*   users: UsersTable;
+*   posts: PostsTable;
+* }
+*
+* // Create from connection string
+* const db = createKyselyDb<Database>({
+*   connectionString: 'postgresql://user:pass@localhost:5432/testdb'
+* });
+*
+* // Create with detailed config
+* const db = createKyselyDb<Database>({
+*   host: 'localhost',
+*   port: 5432,
+*   database: 'testdb',
+*   user: 'testuser',
+*   password: 'testpass',
+*   max: 10 // connection pool size
+* });
+*
+* // Use in tests
+* const users = await db.selectFrom('users').selectAll().execute();
+* ```
+*/
+function createKyselyDb(config) {
+	return new kysely.Kysely({
+		dialect: new kysely.PostgresDialect({ pool: new pg.default.Pool(config) }),
+		plugins: [new kysely.CamelCasePlugin()]
+	});
+}
+
+//#endregion
+exports.createKyselyDb = createKyselyDb;
+//# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":["config: any","Kysely","PostgresDialect","CamelCasePlugin"],"sources":["../src/helpers.ts"],"sourcesContent":["import { CamelCasePlugin, Kysely, PostgresDialect } from 'kysely';\nimport pg from 'pg';\n\n/**\n * Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.\n * This is a convenience function for quickly setting up a Kysely connection for testing.\n *\n * @template Database - The database schema type\n * @param config - PostgreSQL connection configuration (pg.Pool config)\n * @returns A configured Kysely instance\n *\n * @example\n * ```typescript\n * interface Database {\n *   users: UsersTable;\n *   posts: PostsTable;\n * }\n *\n * // Create from connection string\n * const db = createKyselyDb<Database>({\n *   connectionString: 'postgresql://user:pass@localhost:5432/testdb'\n * });\n *\n * // Create with detailed config\n * const db = createKyselyDb<Database>({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'testdb',\n *   user: 'testuser',\n *   password: 'testpass',\n *   max: 10 // connection pool size\n * });\n *\n * // Use in tests\n * const users = await db.selectFrom('users').selectAll().execute();\n * ```\n */\nexport function createKyselyDb<Database>(config: any): Kysely<Database> {\n  return new Kysely({\n    dialect: new PostgresDialect({\n      pool: new pg.Pool(config),\n    }),\n    plugins: [new CamelCasePlugin()],\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyBA,QAA+B;AACtE,QAAO,IAAIC,cAAO;EAChB,SAAS,IAAIC,uBAAgB,EAC3B,MAAM,IAAI,WAAG,KAAK,QACnB;EACD,SAAS,CAAC,IAAIC,wBAAkB;CACjC;AACF"}

package/dist/helpers.d.cts

@@ -38,4 +38,5 @@ import { Kysely } from "kysely";
  */
 declare function createKyselyDb<Database>(config: any): Kysely<Database>;
 //#endregion
-export { createKyselyDb };
+export { createKyselyDb };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.mts

@@ -38,4 +38,5 @@ import { Kysely } from "kysely";
  */
 declare function createKyselyDb<Database>(config: any): Kysely<Database>;
 //#endregion
-export { createKyselyDb };
+export { createKyselyDb };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.mjs

@@ -1,3 +1,48 @@
-import { createKyselyDb } from "./helpers-BuPmgzyQ.mjs";
+import { CamelCasePlugin, Kysely, PostgresDialect } from "kysely";
+import pg from "pg";
 
-export { createKyselyDb };
+//#region src/helpers.ts
+/**
+* Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.
+* This is a convenience function for quickly setting up a Kysely connection for testing.
+*
+* @template Database - The database schema type
+* @param config - PostgreSQL connection configuration (pg.Pool config)
+* @returns A configured Kysely instance
+*
+* @example
+* ```typescript
+* interface Database {
+*   users: UsersTable;
+*   posts: PostsTable;
+* }
+*
+* // Create from connection string
+* const db = createKyselyDb<Database>({
+*   connectionString: 'postgresql://user:pass@localhost:5432/testdb'
+* });
+*
+* // Create with detailed config
+* const db = createKyselyDb<Database>({
+*   host: 'localhost',
+*   port: 5432,
+*   database: 'testdb',
+*   user: 'testuser',
+*   password: 'testpass',
+*   max: 10 // connection pool size
+* });
+*
+* // Use in tests
+* const users = await db.selectFrom('users').selectAll().execute();
+* ```
+*/
+function createKyselyDb(config) {
+	return new Kysely({
+		dialect: new PostgresDialect({ pool: new pg.Pool(config) }),
+		plugins: [new CamelCasePlugin()]
+	});
+}
+
+//#endregion
+export { createKyselyDb };
+//# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":["config: any"],"sources":["../src/helpers.ts"],"sourcesContent":["import { CamelCasePlugin, Kysely, PostgresDialect } from 'kysely';\nimport pg from 'pg';\n\n/**\n * Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.\n * This is a convenience function for quickly setting up a Kysely connection for testing.\n *\n * @template Database - The database schema type\n * @param config - PostgreSQL connection configuration (pg.Pool config)\n * @returns A configured Kysely instance\n *\n * @example\n * ```typescript\n * interface Database {\n *   users: UsersTable;\n *   posts: PostsTable;\n * }\n *\n * // Create from connection string\n * const db = createKyselyDb<Database>({\n *   connectionString: 'postgresql://user:pass@localhost:5432/testdb'\n * });\n *\n * // Create with detailed config\n * const db = createKyselyDb<Database>({\n *   host: 'localhost',\n *   port: 5432,\n *   database: 'testdb',\n *   user: 'testuser',\n *   password: 'testpass',\n *   max: 10 // connection pool size\n * });\n *\n * // Use in tests\n * const users = await db.selectFrom('users').selectAll().execute();\n * ```\n */\nexport function createKyselyDb<Database>(config: any): Kysely<Database> {\n  return new Kysely({\n    dialect: new PostgresDialect({\n      pool: new pg.Pool(config),\n    }),\n    plugins: [new CamelCasePlugin()],\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyBA,QAA+B;AACtE,QAAO,IAAI,OAAO;EAChB,SAAS,IAAI,gBAAgB,EAC3B,MAAM,IAAI,GAAG,KAAK,QACnB;EACD,SAAS,CAAC,IAAI,iBAAkB;CACjC;AACF"}

package/dist/kysely.cjs

@@ -4,11 +4,74 @@ const require_KyselyFactory = require('./KyselyFactory-Cf0o2YxO.cjs');
 require('./PostgresMigrator-DFcNdCvD.cjs');
 const require_PostgresKyselyMigrator = require('./PostgresKyselyMigrator-CfytARcA.cjs');
 const require_VitestTransactionIsolator = require('./VitestTransactionIsolator-BQ5FpLtC.cjs');
-const require_VitestKyselyTransactionIsolator = require('./VitestKyselyTransactionIsolator-Dqy3qNoJ.cjs');
-const require_kysely = require('./kysely-CP1iJMvq.cjs');
+const require_VitestKyselyTransactionIsolator = require('./VitestKyselyTransactionIsolator-Cst3vFjb.cjs');
 
+//#region src/kysely.ts
+/**
+* Creates a wrapped Vitest test API with automatic transaction rollback for Kysely.
+* Each test runs in an isolated database transaction that is rolled back after completion.
+* This ensures tests don't affect each other's data and run faster than truncating tables.
+*
+* @template Database - The database schema type
+* @param api - The Vitest test API (usually `test` from vitest)
+* @param db - The Kysely database instance
+* @param setup - Optional setup function to run before each test in the transaction
+* @param level - Transaction isolation level (defaults to REPEATABLE_READ)
+* @returns A wrapped test API that provides transaction isolation
+*
+* @example
+* ```typescript
+* import { test } from 'vitest';
+* import { wrapVitestKyselyTransaction } from '@geekmidas/testkit/kysely';
+* import { db } from './database';
+*
+* // Create isolated test with automatic rollback
+* const isolatedTest = wrapVitestKyselyTransaction(test, db);
+*
+* // Use in tests - each test gets its own transaction
+* isolatedTest('should create user', async ({ trx }) => {
+*   const user = await trx
+*     .insertInto('users')
+*     .values({ name: 'Test User', email: 'test@example.com' })
+*     .returningAll()
+*     .executeTakeFirst();
+*
+*   expect(user).toBeDefined();
+*   // User is automatically rolled back after test
+* });
+*
+* // With setup function for common test data
+* const testWithSetup = wrapVitestKyselyTransaction(
+*   test,
+*   db,
+*   async (trx) => {
+*     // Create common test data
+*     await trx.insertInto('settings')
+*       .values({ key: 'test_mode', value: 'true' })
+*       .execute();
+*   }
+* );
+*
+* testWithSetup('should have test settings', async ({ trx }) => {
+*   const setting = await trx
+*     .selectFrom('settings')
+*     .where('key', '=', 'test_mode')
+*     .selectAll()
+*     .executeTakeFirst();
+*
+*   expect(setting?.value).toBe('true');
+* });
+* ```
+*/
+function wrapVitestKyselyTransaction(api, connection, setup, level = require_VitestTransactionIsolator.IsolationLevel.REPEATABLE_READ) {
+	const wrapper = new require_VitestKyselyTransactionIsolator.VitestKyselyTransactionIsolator(api);
+	return wrapper.wrapVitestWithTransaction(connection, setup, level);
+}
+
+//#endregion
 exports.IsolationLevel = require_VitestTransactionIsolator.IsolationLevel;
 exports.KyselyFactory = require_KyselyFactory.KyselyFactory;
 exports.PostgresKyselyMigrator = require_PostgresKyselyMigrator.PostgresKyselyMigrator;
 exports.VitestKyselyTransactionIsolator = require_VitestKyselyTransactionIsolator.VitestKyselyTransactionIsolator;
-exports.wrapVitestKyselyTransaction = require_kysely.wrapVitestKyselyTransaction;
+exports.wrapVitestKyselyTransaction = wrapVitestKyselyTransaction;
+//# sourceMappingURL=kysely.cjs.map

package/dist/kysely.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely.cjs","names":["api: TestAPI","connection: DatabaseConnection<Kysely<Database>>","setup?: (trx: Transaction<Database>) => Promise<void>","level: IsolationLevel","IsolationLevel","VitestKyselyTransactionIsolator"],"sources":["../src/kysely.ts"],"sourcesContent":["import type { Kysely, Transaction } from 'kysely';\nimport type { TestAPI } from 'vitest';\nimport { VitestKyselyTransactionIsolator } from './VitestKyselyTransactionIsolator';\nimport {\n  type DatabaseConnection,\n  IsolationLevel,\n} from './VitestTransactionIsolator';\n\n/**\n * Kysely-specific exports for test utilities.\n * Provides factories, migrators, and transaction isolators for Kysely ORM.\n */\n\nexport { KyselyFactory } from './KyselyFactory';\nexport { PostgresKyselyMigrator } from './PostgresKyselyMigrator';\nexport { VitestKyselyTransactionIsolator } from './VitestKyselyTransactionIsolator';\nexport { IsolationLevel } from './VitestTransactionIsolator';\n\n/**\n * Creates a wrapped Vitest test API with automatic transaction rollback for Kysely.\n * Each test runs in an isolated database transaction that is rolled back after completion.\n * This ensures tests don't affect each other's data and run faster than truncating tables.\n *\n * @template Database - The database schema type\n * @param api - The Vitest test API (usually `test` from vitest)\n * @param db - The Kysely database instance\n * @param setup - Optional setup function to run before each test in the transaction\n * @param level - Transaction isolation level (defaults to REPEATABLE_READ)\n * @returns A wrapped test API that provides transaction isolation\n *\n * @example\n * ```typescript\n * import { test } from 'vitest';\n * import { wrapVitestKyselyTransaction } from '@geekmidas/testkit/kysely';\n * import { db } from './database';\n *\n * // Create isolated test with automatic rollback\n * const isolatedTest = wrapVitestKyselyTransaction(test, db);\n *\n * // Use in tests - each test gets its own transaction\n * isolatedTest('should create user', async ({ trx }) => {\n *   const user = await trx\n *     .insertInto('users')\n *     .values({ name: 'Test User', email: 'test@example.com' })\n *     .returningAll()\n *     .executeTakeFirst();\n *\n *   expect(user).toBeDefined();\n *   // User is automatically rolled back after test\n * });\n *\n * // With setup function for common test data\n * const testWithSetup = wrapVitestKyselyTransaction(\n *   test,\n *   db,\n *   async (trx) => {\n *     // Create common test data\n *     await trx.insertInto('settings')\n *       .values({ key: 'test_mode', value: 'true' })\n *       .execute();\n *   }\n * );\n *\n * testWithSetup('should have test settings', async ({ trx }) => {\n *   const setting = await trx\n *     .selectFrom('settings')\n *     .where('key', '=', 'test_mode')\n *     .selectAll()\n *     .executeTakeFirst();\n *\n *   expect(setting?.value).toBe('true');\n * });\n * ```\n */\nexport function wrapVitestKyselyTransaction<Database>(\n  api: TestAPI,\n  connection: DatabaseConnection<Kysely<Database>>,\n  setup?: (trx: Transaction<Database>) => Promise<void>,\n  level: IsolationLevel = IsolationLevel.REPEATABLE_READ,\n) {\n  const wrapper = new VitestKyselyTransactionIsolator<Database>(api);\n\n  return wrapper.wrapVitestWithTransaction(connection, setup, level);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,4BACdA,KACAC,YACAC,OACAC,QAAwBC,iDAAe,iBACvC;CACA,MAAM,UAAU,IAAIC,wEAA0C;AAE9D,QAAO,QAAQ,0BAA0B,YAAY,OAAO,MAAM;AACnE"}

package/dist/kysely.d.cts

@@ -1,6 +1,6 @@
-import "./faker-BSH1EMtg.cjs";
-import "./Factory-pNV7ZQ7-.cjs";
-import { KyselyFactory } from "./KyselyFactory-DLBrYWxU.cjs";
+import "./faker-Cg76aFNO.cjs";
+import "./Factory-BZ8uMoXl.cjs";
+import { KyselyFactory } from "./KyselyFactory-DRQ83r0o.cjs";
 import "./PostgresMigrator-D5UkK1_K.cjs";
 import { PostgresKyselyMigrator } from "./PostgresKyselyMigrator-CQ3aUoy_.cjs";
 import { DatabaseConnection, IsolationLevel } from "./VitestTransactionIsolator-DdLNODZg.cjs";
@@ -70,4 +70,5 @@ declare function wrapVitestKyselyTransaction<Database>(api: TestAPI, connection:
   trx: Transaction<Database>;
 }>;
 //#endregion
-export { IsolationLevel, KyselyFactory, PostgresKyselyMigrator, VitestKyselyTransactionIsolator, wrapVitestKyselyTransaction };
+export { IsolationLevel, KyselyFactory, PostgresKyselyMigrator, VitestKyselyTransactionIsolator, wrapVitestKyselyTransaction };
+//# sourceMappingURL=kysely.d.cts.map

package/dist/kysely.d.mts

@@ -1,10 +1,10 @@
-import "./faker-C-Iuk_R1.mjs";
-import "./Factory-D7P3bKKb.mjs";
-import { KyselyFactory } from "./KyselyFactory-72P98y5I.mjs";
-import "./PostgresMigrator-BlvuQl7d.mjs";
-import { PostgresKyselyMigrator } from "./PostgresKyselyMigrator-_6yHZigp.mjs";
-import { DatabaseConnection, IsolationLevel } from "./VitestTransactionIsolator-zdyiS_SY.mjs";
-import { VitestKyselyTransactionIsolator } from "./VitestKyselyTransactionIsolator-CnxpE9cH.mjs";
+import "./faker-DHh7xs4u.mjs";
+import "./Factory-Cmr3s3-s.mjs";
+import { KyselyFactory } from "./KyselyFactory-Cx3sezwH.mjs";
+import "./PostgresMigrator-DQaRxoaY.mjs";
+import { PostgresKyselyMigrator } from "./PostgresKyselyMigrator-CIx3AFSR.mjs";
+import { DatabaseConnection, IsolationLevel } from "./VitestTransactionIsolator-CsfJBxcb.mjs";
+import { VitestKyselyTransactionIsolator } from "./VitestKyselyTransactionIsolator-COCVfvfr.mjs";
 import { Kysely, Transaction } from "kysely";
 import { TestAPI } from "vitest";
 
@@ -70,4 +70,5 @@ declare function wrapVitestKyselyTransaction<Database>(api: TestAPI, connection:
   trx: Transaction<Database>;
 }>;
 //#endregion
-export { IsolationLevel, KyselyFactory, PostgresKyselyMigrator, VitestKyselyTransactionIsolator, wrapVitestKyselyTransaction };
+export { IsolationLevel, KyselyFactory, PostgresKyselyMigrator, VitestKyselyTransactionIsolator, wrapVitestKyselyTransaction };
+//# sourceMappingURL=kysely.d.mts.map