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

package/dist/faker.d.mts

@@ -1,2 +1,162 @@
-import { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps } from "./faker-D9gz7KjY.mjs";
-export { FakerFactory, Timestamps, coordinateInRadius, faker, identifier, resetAllSequences, resetSequence, sequence, timestamps };
+//#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()
+ * };
+ * ```
+ */
+export 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"
+ * ```
+ */
+export 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`;
+ * ```
+ */
+export 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
+ * ```
+ */
+export 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);
+ * });
+ * ```
+ */
+export 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;
+};
+export 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();
+ * ```
+ */
+export declare const faker: Readonly<import("@faker-js/faker").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.
+ */
+export 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.
+ */
+export type FakerFactory = typeof faker;
+//#endregion
+//# sourceMappingURL=faker.d.mts.map

package/dist/faker.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker.d.mts","names":[],"sources":["../src/faker.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;wBAkFgB,cAAc;;;;;;;;;;;;;;;wBA2Bd,WAAW;;;;;;;;;;;;;;;;;;;;;wBAmCX,SAAS;;;;;;;;;;;;;;;;;;;wBA2BT,cAAc,eAAkB;;;;;;;;;;;;;;;;;;wBA0BhC;;;;;;;;;;;;;iBAgBP;KAIJ;EACJ;EACA;;wBAGe,mBACf,QAAQ,YACR,iBACE;iBA8BM,wBACR,QAAQ,YACR,yBACA,0BACE;;;;;;;;;;;;;;;;;;;;qBA2DU,OAAK,mCAAA;;;;;;;;IASf,eAAM;IACN,gBAAO;;;;;;;YASE;;EAEX,WAAW;;EAEX,WAAW;;;;;;YAOA,sBAAsB"}

package/dist/faker.mjs

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

package/dist/faker.mjs.map

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

package/dist/helpers.cjs

@@ -1,7 +1,8 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const pg = require_chunk.__toESM(require("pg"));
-const kysely = require_chunk.__toESM(require("kysely"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let pg = require("pg");
+pg = require_rolldown_runtime.__toESM(pg, 1);
+let kysely = require("kysely");
 //#region src/helpers.ts
 /**
 * Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.
@@ -43,7 +44,7 @@ function createKyselyDb(config) {
 		plugins: [new kysely.CamelCasePlugin()]
 	});
 }
-
 //#endregion
 exports.createKyselyDb = createKyselyDb;
+
 //# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -1 +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\treturn new Kysely({\n\t\tdialect: new PostgresDialect({\n\t\t\tpool: new pg.Pool(config),\n\t\t}),\n\t\tplugins: [new CamelCasePlugin()],\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyBA,QAA+B;AACvE,QAAO,IAAIC,cAAO;EACjB,SAAS,IAAIC,uBAAgB,EAC5B,MAAM,IAAI,WAAG,KAAK,QAClB;EACD,SAAS,CAAC,IAAIC,wBAAkB;CAChC;AACD"}
+{"version":3,"file":"helpers.cjs","names":["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\treturn new Kysely({\n\t\tdialect: new PostgresDialect({\n\t\t\tpool: new pg.Pool(config),\n\t\t}),\n\t\tplugins: [new CamelCasePlugin()],\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyB,QAA+B;CACvE,OAAO,IAAIA,OAAAA,OAAO;EACjB,SAAS,IAAIC,OAAAA,gBAAgB,EAC5B,MAAM,IAAI,GAAA,QAAG,KAAK,MAAM,EACzB,CAAC;EACD,SAAS,CAAC,IAAIC,OAAAA,gBAAgB,CAAC;CAChC,CAAC;AACF"}

package/dist/helpers.d.cts

@@ -1,7 +1,5 @@
 import { Kysely } from "kysely";
-
 //#region src/helpers.d.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.
@@ -36,8 +34,6 @@ import { Kysely } from "kysely";
  * const users = await db.selectFrom('users').selectAll().execute();
  * ```
  */
-declare function createKyselyDb<Database>(config: any): Kysely<Database>;
-//# sourceMappingURL=helpers.d.ts.map
+export declare function createKyselyDb<Database>(config: any): Kysely<Database>;
 //#endregion
-export { createKyselyDb };
 //# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/helpers.ts"],"sourcesContent":[],"mappings":";;;;;;AAqCA;;;;AAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA7C,uCAAuC,OAAO"}
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqCgB,eAAe,UAAU,cAAc,OAAO"}

package/dist/helpers.d.mts

@@ -1,7 +1,5 @@
 import { Kysely } from "kysely";
-
 //#region src/helpers.d.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.
@@ -36,8 +34,6 @@ import { Kysely } from "kysely";
  * const users = await db.selectFrom('users').selectAll().execute();
  * ```
  */
-declare function createKyselyDb<Database>(config: any): Kysely<Database>;
-//# sourceMappingURL=helpers.d.ts.map
+export declare function createKyselyDb<Database>(config: any): Kysely<Database>;
 //#endregion
-export { createKyselyDb };
 //# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/helpers.ts"],"sourcesContent":[],"mappings":";;;;;;AAqCA;;;;AAA6D;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAA7C,uCAAuC,OAAO"}
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqCgB,eAAe,UAAU,cAAc,OAAO"}

package/dist/helpers.mjs

@@ -1,6 +1,5 @@
 import pg from "pg";
 import { CamelCasePlugin, Kysely, PostgresDialect } from "kysely";
-
 //#region src/helpers.ts
 /**
 * Creates a Kysely database instance with PostgreSQL dialect and camelCase plugin.
@@ -42,7 +41,7 @@ function createKyselyDb(config) {
 		plugins: [new CamelCasePlugin()]
 	});
 }
-
 //#endregion
 export { createKyselyDb };
+
 //# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -1 +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\treturn new Kysely({\n\t\tdialect: new PostgresDialect({\n\t\t\tpool: new pg.Pool(config),\n\t\t}),\n\t\tplugins: [new CamelCasePlugin()],\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyBA,QAA+B;AACvE,QAAO,IAAI,OAAO;EACjB,SAAS,IAAI,gBAAgB,EAC5B,MAAM,IAAI,GAAG,KAAK,QAClB;EACD,SAAS,CAAC,IAAI,iBAAkB;CAChC;AACD"}
+{"version":3,"file":"helpers.mjs","names":[],"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\treturn new Kysely({\n\t\tdialect: new PostgresDialect({\n\t\t\tpool: new pg.Pool(config),\n\t\t}),\n\t\tplugins: [new CamelCasePlugin()],\n\t});\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,eAAyB,QAA+B;CACvE,OAAO,IAAI,OAAO;EACjB,SAAS,IAAI,gBAAgB,EAC5B,MAAM,IAAI,GAAG,KAAK,MAAM,EACzB,CAAC;EACD,SAAS,CAAC,IAAI,gBAAgB,CAAC;CAChC,CAAC;AACF"}

package/dist/initScript.cjs

@@ -1,7 +1,8 @@
-const require_chunk = require('./chunk-CUT6urMc.cjs');
-const pg = require_chunk.__toESM(require("pg"));
-const node_fs = require_chunk.__toESM(require("node:fs"));
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let pg = require("pg");
+pg = require_rolldown_runtime.__toESM(pg, 1);
+let node_fs = require("node:fs");
 //#region src/initScript.ts
 const { Client } = pg.default;
 /**
@@ -18,13 +19,14 @@ function parseInitScript(content, env) {
 	const lines = content.split("\n");
 	let inHeredoc = false;
 	let currentBlock = [];
-	for (const line of lines) if (inHeredoc) if (/^\s*EOSQL\s*$/.test(line)) {
-		const sql = substituteEnvVars(currentBlock.join("\n"), env);
-		blocks.push(sql);
-		currentBlock = [];
-		inHeredoc = false;
-	} else currentBlock.push(line);
-	else if (line.includes("<<-EOSQL") || line.includes("<< EOSQL") || line.includes("<<EOSQL")) {
+	for (const line of lines) if (inHeredoc) {
+		if (/^\s*EOSQL\s*$/.test(line)) {
+			const sql = substituteEnvVars(currentBlock.join("\n"), env);
+			blocks.push(sql);
+			currentBlock = [];
+			inHeredoc = false;
+		} else currentBlock.push(line);
+	} else if (line.includes("<<-EOSQL") || line.includes("<< EOSQL") || line.includes("<<EOSQL")) {
 		inHeredoc = true;
 		currentBlock = [];
 	}
@@ -70,9 +72,7 @@ function substituteEnvVars(sql, env) {
 * ```
 */
 async function runInitScript(scriptPath, databaseUrl, env) {
-	const content = (0, node_fs.readFileSync)(scriptPath, "utf-8");
-	const resolvedEnv = env ?? { ...process.env };
-	const blocks = parseInitScript(content, resolvedEnv);
+	const blocks = parseInitScript((0, node_fs.readFileSync)(scriptPath, "utf-8"), env ?? { ...process.env });
 	if (blocks.length === 0) return;
 	const url = new URL(databaseUrl);
 	const client = new Client({
@@ -89,8 +89,8 @@ async function runInitScript(scriptPath, databaseUrl, env) {
 		await client.end();
 	}
 }
-
 //#endregion
 exports.parseInitScript = parseInitScript;
 exports.runInitScript = runInitScript;
+
 //# sourceMappingURL=initScript.cjs.map

package/dist/initScript.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"initScript.cjs","names":["content: string","env: Record<string, string>","blocks: string[]","currentBlock: string[]","sql: string","scriptPath: string","databaseUrl: string","env?: Record<string, string>"],"sources":["../src/initScript.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport pg from 'pg';\n\nconst { Client } = pg;\n\n/**\n * Parse a shell init script (like docker/postgres/init.sh) and extract\n * SQL blocks from heredoc sections (<<-EOSQL ... EOSQL).\n *\n * @param content - The shell script content\n * @param env - Environment variables to substitute ($VAR_NAME references)\n * @returns Array of SQL strings ready to execute\n * @internal Exported for testing\n */\nexport function parseInitScript(\n\tcontent: string,\n\tenv: Record<string, string>,\n): string[] {\n\tconst blocks: string[] = [];\n\tconst lines = content.split('\\n');\n\tlet inHeredoc = false;\n\tlet currentBlock: string[] = [];\n\n\tfor (const line of lines) {\n\t\tif (inHeredoc) {\n\t\t\t// Check for heredoc terminator (EOSQL at start of line, with optional leading whitespace)\n\t\t\tif (/^\\s*EOSQL\\s*$/.test(line)) {\n\t\t\t\tconst sql = substituteEnvVars(currentBlock.join('\\n'), env);\n\t\t\t\tblocks.push(sql);\n\t\t\t\tcurrentBlock = [];\n\t\t\t\tinHeredoc = false;\n\t\t\t} else {\n\t\t\t\tcurrentBlock.push(line);\n\t\t\t}\n\t\t} else if (\n\t\t\tline.includes('<<-EOSQL') ||\n\t\t\tline.includes('<< EOSQL') ||\n\t\t\tline.includes('<<EOSQL')\n\t\t) {\n\t\t\tinHeredoc = true;\n\t\t\tcurrentBlock = [];\n\t\t}\n\t}\n\n\treturn blocks;\n}\n\n/**\n * Replace shell variable references ($VAR_NAME and ${VAR_NAME})\n * with values from the provided env object.\n */\nfunction substituteEnvVars(sql: string, env: Record<string, string>): string {\n\t// Replace ${VAR_NAME} syntax\n\tlet result = sql.replace(/\\$\\{(\\w+)\\}/g, (_, name) => env[name] ?? '');\n\t// Replace $VAR_NAME syntax (word boundary after)\n\tresult = result.replace(/\\$(\\w+)/g, (_, name) => env[name] ?? '');\n\t// Unescape bash-escaped dollar signs (\\$ → $) AFTER variable substitution\n\t// This handles PL/pgSQL dollar-quoting like DO \\$\\$ ... END \\$\\$;\n\tresult = result.replace(/\\\\\\$/g, '$');\n\treturn result;\n}\n\n/**\n * Read a postgres init script, parse out the SQL blocks,\n * substitute environment variables, and execute against a database.\n *\n * This is intended to run `docker/postgres/init.sh` against a test database\n * so that per-app users and schemas are created (matching what Docker does\n * on first volume initialization).\n *\n * Uses `CREATE ... IF NOT EXISTS` and `DO $$ ... END $$` wrappers where\n * needed so the script is idempotent.\n *\n * @param scriptPath - Path to the init.sh file\n * @param databaseUrl - PostgreSQL connection URL (should point to the test database)\n *\n * @example\n * ```typescript\n * // In your globalSetup.ts\n * import { runInitScript } from '@geekmidas/testkit/postgres';\n * import { Credentials } from '@geekmidas/envkit/credentials';\n *\n * const cleanup = await migrator.start();\n *\n * // Create per-app users in the test database\n * await runInitScript('docker/postgres/init.sh', Credentials.DATABASE_URL, {\n *   ...process.env,\n *   ...Credentials,\n * });\n * ```\n */\nexport async function runInitScript(\n\tscriptPath: string,\n\tdatabaseUrl: string,\n\tenv?: Record<string, string>,\n): Promise<void> {\n\tconst content = readFileSync(scriptPath, 'utf-8');\n\tconst resolvedEnv = env ?? ({ ...process.env } as Record<string, string>);\n\tconst blocks = parseInitScript(content, resolvedEnv);\n\n\tif (blocks.length === 0) {\n\t\treturn;\n\t}\n\n\tconst url = new URL(databaseUrl);\n\tconst client = new Client({\n\t\tuser: url.username,\n\t\tpassword: decodeURIComponent(url.password),\n\t\thost: url.hostname,\n\t\tport: parseInt(url.port, 10),\n\t\tdatabase: url.pathname.slice(1),\n\t});\n\n\ttry {\n\t\tawait client.connect();\n\t\tfor (const sql of blocks) {\n\t\t\tawait client.query(sql);\n\t\t}\n\t} finally {\n\t\tawait client.end();\n\t}\n}\n"],"mappings":";;;;;AAGA,MAAM,EAAE,QAAQ,GAAG;;;;;;;;;;AAWnB,SAAgB,gBACfA,SACAC,KACW;CACX,MAAMC,SAAmB,CAAE;CAC3B,MAAM,QAAQ,QAAQ,MAAM,KAAK;CACjC,IAAI,YAAY;CAChB,IAAIC,eAAyB,CAAE;AAE/B,MAAK,MAAM,QAAQ,MAClB,KAAI,UAEH,KAAI,gBAAgB,KAAK,KAAK,EAAE;EAC/B,MAAM,MAAM,kBAAkB,aAAa,KAAK,KAAK,EAAE,IAAI;AAC3D,SAAO,KAAK,IAAI;AAChB,iBAAe,CAAE;AACjB,cAAY;CACZ,MACA,cAAa,KAAK,KAAK;UAGxB,KAAK,SAAS,WAAW,IACzB,KAAK,SAAS,WAAW,IACzB,KAAK,SAAS,UAAU,EACvB;AACD,cAAY;AACZ,iBAAe,CAAE;CACjB;AAGF,QAAO;AACP;;;;;AAMD,SAAS,kBAAkBC,KAAaH,KAAqC;CAE5E,IAAI,SAAS,IAAI,QAAQ,gBAAgB,CAAC,GAAG,SAAS,IAAI,SAAS,GAAG;AAEtE,UAAS,OAAO,QAAQ,YAAY,CAAC,GAAG,SAAS,IAAI,SAAS,GAAG;AAGjE,UAAS,OAAO,QAAQ,SAAS,IAAI;AACrC,QAAO;AACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BD,eAAsB,cACrBI,YACAC,aACAC,KACgB;CAChB,MAAM,UAAU,0BAAa,YAAY,QAAQ;CACjD,MAAM,cAAc,OAAQ,EAAE,GAAG,QAAQ,IAAK;CAC9C,MAAM,SAAS,gBAAgB,SAAS,YAAY;AAEpD,KAAI,OAAO,WAAW,EACrB;CAGD,MAAM,MAAM,IAAI,IAAI;CACpB,MAAM,SAAS,IAAI,OAAO;EACzB,MAAM,IAAI;EACV,UAAU,mBAAmB,IAAI,SAAS;EAC1C,MAAM,IAAI;EACV,MAAM,SAAS,IAAI,MAAM,GAAG;EAC5B,UAAU,IAAI,SAAS,MAAM,EAAE;CAC/B;AAED,KAAI;AACH,QAAM,OAAO,SAAS;AACtB,OAAK,MAAM,OAAO,OACjB,OAAM,OAAO,MAAM,IAAI;CAExB,UAAS;AACT,QAAM,OAAO,KAAK;CAClB;AACD"}
+{"version":3,"file":"initScript.cjs","names":["readFileSync"],"sources":["../src/initScript.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\nimport pg from 'pg';\n\nconst { Client } = pg;\n\n/**\n * Parse a shell init script (like docker/postgres/init.sh) and extract\n * SQL blocks from heredoc sections (<<-EOSQL ... EOSQL).\n *\n * @param content - The shell script content\n * @param env - Environment variables to substitute ($VAR_NAME references)\n * @returns Array of SQL strings ready to execute\n * @internal Exported for testing\n */\nexport function parseInitScript(\n\tcontent: string,\n\tenv: Record<string, string>,\n): string[] {\n\tconst blocks: string[] = [];\n\tconst lines = content.split('\\n');\n\tlet inHeredoc = false;\n\tlet currentBlock: string[] = [];\n\n\tfor (const line of lines) {\n\t\tif (inHeredoc) {\n\t\t\t// Check for heredoc terminator (EOSQL at start of line, with optional leading whitespace)\n\t\t\tif (/^\\s*EOSQL\\s*$/.test(line)) {\n\t\t\t\tconst sql = substituteEnvVars(currentBlock.join('\\n'), env);\n\t\t\t\tblocks.push(sql);\n\t\t\t\tcurrentBlock = [];\n\t\t\t\tinHeredoc = false;\n\t\t\t} else {\n\t\t\t\tcurrentBlock.push(line);\n\t\t\t}\n\t\t} else if (\n\t\t\tline.includes('<<-EOSQL') ||\n\t\t\tline.includes('<< EOSQL') ||\n\t\t\tline.includes('<<EOSQL')\n\t\t) {\n\t\t\tinHeredoc = true;\n\t\t\tcurrentBlock = [];\n\t\t}\n\t}\n\n\treturn blocks;\n}\n\n/**\n * Replace shell variable references ($VAR_NAME and ${VAR_NAME})\n * with values from the provided env object.\n */\nfunction substituteEnvVars(sql: string, env: Record<string, string>): string {\n\t// Replace ${VAR_NAME} syntax\n\tlet result = sql.replace(/\\$\\{(\\w+)\\}/g, (_, name) => env[name] ?? '');\n\t// Replace $VAR_NAME syntax (word boundary after)\n\tresult = result.replace(/\\$(\\w+)/g, (_, name) => env[name] ?? '');\n\t// Unescape bash-escaped dollar signs (\\$ → $) AFTER variable substitution\n\t// This handles PL/pgSQL dollar-quoting like DO \\$\\$ ... END \\$\\$;\n\tresult = result.replace(/\\\\\\$/g, '$');\n\treturn result;\n}\n\n/**\n * Read a postgres init script, parse out the SQL blocks,\n * substitute environment variables, and execute against a database.\n *\n * This is intended to run `docker/postgres/init.sh` against a test database\n * so that per-app users and schemas are created (matching what Docker does\n * on first volume initialization).\n *\n * Uses `CREATE ... IF NOT EXISTS` and `DO $$ ... END $$` wrappers where\n * needed so the script is idempotent.\n *\n * @param scriptPath - Path to the init.sh file\n * @param databaseUrl - PostgreSQL connection URL (should point to the test database)\n *\n * @example\n * ```typescript\n * // In your globalSetup.ts\n * import { runInitScript } from '@geekmidas/testkit/postgres';\n * import { Credentials } from '@geekmidas/envkit/credentials';\n *\n * const cleanup = await migrator.start();\n *\n * // Create per-app users in the test database\n * await runInitScript('docker/postgres/init.sh', Credentials.DATABASE_URL, {\n *   ...process.env,\n *   ...Credentials,\n * });\n * ```\n */\nexport async function runInitScript(\n\tscriptPath: string,\n\tdatabaseUrl: string,\n\tenv?: Record<string, string>,\n): Promise<void> {\n\tconst content = readFileSync(scriptPath, 'utf-8');\n\tconst resolvedEnv = env ?? ({ ...process.env } as Record<string, string>);\n\tconst blocks = parseInitScript(content, resolvedEnv);\n\n\tif (blocks.length === 0) {\n\t\treturn;\n\t}\n\n\tconst url = new URL(databaseUrl);\n\tconst client = new Client({\n\t\tuser: url.username,\n\t\tpassword: decodeURIComponent(url.password),\n\t\thost: url.hostname,\n\t\tport: parseInt(url.port, 10),\n\t\tdatabase: url.pathname.slice(1),\n\t});\n\n\ttry {\n\t\tawait client.connect();\n\t\tfor (const sql of blocks) {\n\t\t\tawait client.query(sql);\n\t\t}\n\t} finally {\n\t\tawait client.end();\n\t}\n}\n"],"mappings":";;;;;;AAGA,MAAM,EAAE,WAAW,GAAA;;;;;;;;;;AAWnB,SAAgB,gBACf,SACA,KACW;CACX,MAAM,SAAmB,CAAC;CAC1B,MAAM,QAAQ,QAAQ,MAAM,IAAI;CAChC,IAAI,YAAY;CAChB,IAAI,eAAyB,CAAC;CAE9B,KAAK,MAAM,QAAQ,OAClB,IAAI,WAAW;EAEd,IAAI,gBAAgB,KAAK,IAAI,GAAG;GAC/B,MAAM,MAAM,kBAAkB,aAAa,KAAK,IAAI,GAAG,GAAG;GAC1D,OAAO,KAAK,GAAG;GACf,eAAe,CAAC;GAChB,YAAY;EACb,OACC,aAAa,KAAK,IAAI;CAExB,OAAO,IACN,KAAK,SAAS,UAAU,KACxB,KAAK,SAAS,UAAU,KACxB,KAAK,SAAS,SAAS,GACtB;EACD,YAAY;EACZ,eAAe,CAAC;CACjB;CAGD,OAAO;AACR;;;;;AAMA,SAAS,kBAAkB,KAAa,KAAqC;CAE5E,IAAI,SAAS,IAAI,QAAQ,iBAAiB,GAAG,SAAS,IAAI,SAAS,EAAE;CAErE,SAAS,OAAO,QAAQ,aAAa,GAAG,SAAS,IAAI,SAAS,EAAE;CAGhE,SAAS,OAAO,QAAQ,SAAS,GAAG;CACpC,OAAO;AACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,eAAsB,cACrB,YACA,aACA,KACgB;CAGhB,MAAM,SAAS,iBAAA,GAFCA,QAAAA,aAAAA,CAAa,YAAY,OAEJ,GADjB,OAAQ,EAAE,GAAG,QAAQ,IAAI,CACM;CAEnD,IAAI,OAAO,WAAW,GACrB;CAGD,MAAM,MAAM,IAAI,IAAI,WAAW;CAC/B,MAAM,SAAS,IAAI,OAAO;EACzB,MAAM,IAAI;EACV,UAAU,mBAAmB,IAAI,QAAQ;EACzC,MAAM,IAAI;EACV,MAAM,SAAS,IAAI,MAAM,EAAE;EAC3B,UAAU,IAAI,SAAS,MAAM,CAAC;CAC/B,CAAC;CAED,IAAI;EACH,MAAM,OAAO,QAAQ;EACrB,KAAK,MAAM,OAAO,QACjB,MAAM,OAAO,MAAM,GAAG;CAExB,UAAU;EACT,MAAM,OAAO,IAAI;CAClB;AACD"}