@geekmidas/testkit 10.0.0-alpha.20 → 10.0.0-alpha.21

package/dist/transactions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.cts","names":[],"sources":["../src/transactions.ts"],"mappings":";;;iBAqBiB;EAChB;EACA;;;;;;;;;wBAUe,iBAAiB,cAAc;;iBAa9B;;WAEP,IAAI;;EAEb,YAAY;;;wBAIS,qBACrB,cACE,QAAQ;;;;;;;;qBAmEE,oBAAoB;mBACf;EAEjB,IAAI,KAAK,MAAM,cAAc,QAAQ;EAS/B,eAAe"}

package/dist/transactions.d.mts

@@ -0,0 +1,38 @@
+import { Kysely } from "kysely";
+//#region src/transactions.d.ts
+/** How to reach one database: a URL, and its search path as a startup option. */
+export interface ConnectionConfig {
+  connectionString: string;
+  options?: string;
+}
+/**
+ * The connection settings for a database URL.
+ *
+ * `?search_path=` is not a libpq parameter: a URL carrying it connects and then
+ * resolves every name against `public`. Postgres takes it as a startup option,
+ * which is what a schema tenant's URL needs to reach its own tables.
+ */
+export declare function connectionConfig(url: string): ConnectionConfig;
+/** One database's connection, inside a transaction the test will roll back. */
+export interface BoundTransaction {
+  /** Everything queried through this runs inside the test's transaction. */
+  readonly db: Kysely<any>;
+  /** Undo everything, and let the connection go. */
+  rollback(): Promise<void>;
+}
+/** Open a connection to `url` and begin the transaction a test will roll back. */
+export declare function openBoundTransaction(url: string): Promise<BoundTransaction>;
+/**
+ * The transactions one test has opened, by database.
+ *
+ * `get` opens a database's transaction the first time it is asked for and
+ * hands back the same one after that — including to a caller that asks while
+ * it is still opening. `rollbackAll` ends every one of them.
+ */
+export declare class TransactionRegistry<TKey = string> {
+  private readonly open;
+  get(key: TKey, url: string): Promise<Kysely<any>>;
+  rollbackAll(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=transactions.d.mts.map

package/dist/transactions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.d.mts","names":[],"sources":["../src/transactions.ts"],"mappings":";;;iBAqBiB;EAChB;EACA;;;;;;;;;wBAUe,iBAAiB,cAAc;;iBAa9B;;WAEP,IAAI;;EAEb,YAAY;;;wBAIS,qBACrB,cACE,QAAQ;;;;;;;;qBAmEE,oBAAoB;mBACf;EAEjB,IAAI,KAAK,MAAM,cAAc,QAAQ;EAS/B,eAAe"}

package/dist/transactions.mjs

@@ -0,0 +1,109 @@
+import pg from "pg";
+import { Kysely, PostgresDialect } from "kysely";
+//#region src/transactions.ts
+/**
+* A transaction per database, per test — as each runs deployed.
+*
+* An app's database and a schema tenant such as the auth server's are separate
+* databases to the code using them: separate connections, credentials, roles
+* and search paths. A test keeps them that way. Each gets its own connection,
+* opened into a transaction the first time the test touches it, and every one
+* is rolled back when the test ends.
+*
+* Code under test must be free to use transactions itself, and better-auth
+* does — it also calls `db.connection()`, which Kysely refuses on a
+* `Transaction`. So what a test hands over is not a `Transaction` but a Kysely
+* over the one connection already inside the test's transaction, on which a
+* `BEGIN` becomes a savepoint and a `COMMIT` releases it. Nothing the code does
+* can end the transaction the test will roll back.
+*/
+/**
+* The connection settings for a database URL.
+*
+* `?search_path=` is not a libpq parameter: a URL carrying it connects and then
+* resolves every name against `public`. Postgres takes it as a startup option,
+* which is what a schema tenant's URL needs to reach its own tables.
+*/
+function connectionConfig(url) {
+	const parsed = new URL(url);
+	const searchPath = parsed.searchParams.get("search_path");
+	if (!searchPath) return { connectionString: url };
+	parsed.searchParams.delete("search_path");
+	return {
+		connectionString: parsed.toString(),
+		options: `-c search_path=${searchPath}`
+	};
+}
+/** Open a connection to `url` and begin the transaction a test will roll back. */
+async function openBoundTransaction(url) {
+	const client = new pg.Client(connectionConfig(url));
+	await client.connect();
+	await client.query("BEGIN");
+	return {
+		db: new Kysely({ dialect: new PostgresDialect({ pool: {
+			connect: async () => savepointing(client),
+			end: async () => {}
+		} }) }),
+		async rollback() {
+			try {
+				await client.query("ROLLBACK");
+			} finally {
+				await client.end();
+			}
+		}
+	};
+}
+/**
+* The client, with transaction control turned into savepoints.
+*
+* Kysely issues `begin`/`commit`/`rollback` as plain statements; this is the
+* one place they can be caught. A depth counter names the savepoints, so
+* nested transactions nest.
+*/
+function savepointing(client) {
+	let depth = 0;
+	const query = client.query.bind(client);
+	const wrapped = Object.create(client);
+	Object.assign(wrapped, {
+		query: (text, ...rest) => {
+			const statement = typeof text === "string" ? text.trim().toLowerCase() : void 0;
+			if (statement === "begin" || statement?.startsWith("start transaction")) {
+				depth++;
+				return query(`SAVEPOINT test_sp_${depth}`);
+			}
+			if (statement === "commit") return query(`RELEASE SAVEPOINT test_sp_${depth--}`);
+			if (statement === "rollback") return query(`ROLLBACK TO SAVEPOINT test_sp_${depth--}`);
+			return query(text, ...rest);
+		},
+		release: () => {}
+	});
+	return wrapped;
+}
+/**
+* The transactions one test has opened, by database.
+*
+* `get` opens a database's transaction the first time it is asked for and
+* hands back the same one after that — including to a caller that asks while
+* it is still opening. `rollbackAll` ends every one of them.
+*/
+var TransactionRegistry = class {
+	open = /* @__PURE__ */ new Map();
+	get(key, url) {
+		let transaction = this.open.get(key);
+		if (!transaction) {
+			transaction = openBoundTransaction(url);
+			this.open.set(key, transaction);
+		}
+		return transaction.then(({ db }) => db);
+	}
+	async rollbackAll() {
+		const transactions = [...this.open.values()];
+		this.open.clear();
+		const failed = (await Promise.allSettled(transactions.map(async (transaction) => (await transaction).rollback()))).find((result) => result.status === "rejected");
+		if (failed) throw failed.reason;
+	}
+};
+//#endregion
+export { TransactionRegistry, connectionConfig, openBoundTransaction };
+
+//# sourceMappingURL=transactions.mjs.map

package/dist/transactions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.mjs","names":[],"sources":["../src/transactions.ts"],"sourcesContent":["/**\n * A transaction per database, per test — as each runs deployed.\n *\n * An app's database and a schema tenant such as the auth server's are separate\n * databases to the code using them: separate connections, credentials, roles\n * and search paths. A test keeps them that way. Each gets its own connection,\n * opened into a transaction the first time the test touches it, and every one\n * is rolled back when the test ends.\n *\n * Code under test must be free to use transactions itself, and better-auth\n * does — it also calls `db.connection()`, which Kysely refuses on a\n * `Transaction`. So what a test hands over is not a `Transaction` but a Kysely\n * over the one connection already inside the test's transaction, on which a\n * `BEGIN` becomes a savepoint and a `COMMIT` releases it. Nothing the code does\n * can end the transaction the test will roll back.\n */\n\nimport { Kysely, PostgresDialect } from 'kysely';\nimport pg from 'pg';\n\n/** How to reach one database: a URL, and its search path as a startup option. */\nexport interface ConnectionConfig {\n\tconnectionString: string;\n\toptions?: string;\n}\n\n/**\n * The connection settings for a database URL.\n *\n * `?search_path=` is not a libpq parameter: a URL carrying it connects and then\n * resolves every name against `public`. Postgres takes it as a startup option,\n * which is what a schema tenant's URL needs to reach its own tables.\n */\nexport function connectionConfig(url: string): ConnectionConfig {\n\tconst parsed = new URL(url);\n\tconst searchPath = parsed.searchParams.get('search_path');\n\tif (!searchPath) return { connectionString: url };\n\n\tparsed.searchParams.delete('search_path');\n\treturn {\n\t\tconnectionString: parsed.toString(),\n\t\toptions: `-c search_path=${searchPath}`,\n\t};\n}\n\n/** One database's connection, inside a transaction the test will roll back. */\nexport interface BoundTransaction {\n\t/** Everything queried through this runs inside the test's transaction. */\n\treadonly db: Kysely<any>;\n\t/** Undo everything, and let the connection go. */\n\trollback(): Promise<void>;\n}\n\n/** Open a connection to `url` and begin the transaction a test will roll back. */\nexport async function openBoundTransaction(\n\turl: string,\n): Promise<BoundTransaction> {\n\tconst client = new pg.Client(connectionConfig(url));\n\tawait client.connect();\n\tawait client.query('BEGIN');\n\n\treturn {\n\t\tdb: new Kysely({\n\t\t\tdialect: new PostgresDialect({\n\t\t\t\t// A \"pool\" of the one connection. Released never, ended never: the\n\t\t\t\t// test owns it, and it closes in `rollback`.\n\t\t\t\tpool: {\n\t\t\t\t\tconnect: async () => savepointing(client),\n\t\t\t\t\tend: async () => {},\n\t\t\t\t} as unknown as pg.Pool,\n\t\t\t}),\n\t\t}),\n\t\tasync rollback() {\n\t\t\ttry {\n\t\t\t\tawait client.query('ROLLBACK');\n\t\t\t} finally {\n\t\t\t\tawait client.end();\n\t\t\t}\n\t\t},\n\t};\n}\n\n/**\n * The client, with transaction control turned into savepoints.\n *\n * Kysely issues `begin`/`commit`/`rollback` as plain statements; this is the\n * one place they can be caught. A depth counter names the savepoints, so\n * nested transactions nest.\n */\nfunction savepointing(client: pg.Client): pg.PoolClient {\n\tlet depth = 0;\n\tconst query = client.query.bind(client) as (...args: unknown[]) => unknown;\n\n\tconst wrapped = Object.create(client) as pg.PoolClient;\n\tObject.assign(wrapped, {\n\t\tquery: (text: unknown, ...rest: unknown[]) => {\n\t\t\tconst statement =\n\t\t\t\ttypeof text === 'string' ? text.trim().toLowerCase() : undefined;\n\n\t\t\tif (statement === 'begin' || statement?.startsWith('start transaction')) {\n\t\t\t\tdepth++;\n\t\t\t\treturn query(`SAVEPOINT test_sp_${depth}`);\n\t\t\t}\n\t\t\tif (statement === 'commit') {\n\t\t\t\treturn query(`RELEASE SAVEPOINT test_sp_${depth--}`);\n\t\t\t}\n\t\t\tif (statement === 'rollback') {\n\t\t\t\treturn query(`ROLLBACK TO SAVEPOINT test_sp_${depth--}`);\n\t\t\t}\n\t\t\treturn query(text, ...rest);\n\t\t},\n\t\trelease: () => {},\n\t});\n\treturn wrapped;\n}\n\n/**\n * The transactions one test has opened, by database.\n *\n * `get` opens a database's transaction the first time it is asked for and\n * hands back the same one after that — including to a caller that asks while\n * it is still opening. `rollbackAll` ends every one of them.\n */\nexport class TransactionRegistry<TKey = string> {\n\tprivate readonly open = new Map<TKey, Promise<BoundTransaction>>();\n\n\tget(key: TKey, url: string): Promise<Kysely<any>> {\n\t\tlet transaction = this.open.get(key);\n\t\tif (!transaction) {\n\t\t\ttransaction = openBoundTransaction(url);\n\t\t\tthis.open.set(key, transaction);\n\t\t}\n\t\treturn transaction.then(({ db }) => db);\n\t}\n\n\tasync rollbackAll(): Promise<void> {\n\t\tconst transactions = [...this.open.values()];\n\t\tthis.open.clear();\n\n\t\tconst results = await Promise.allSettled(\n\t\t\ttransactions.map(async (transaction) => (await transaction).rollback()),\n\t\t);\n\t\tconst failed = results.find(\n\t\t\t(result): result is PromiseRejectedResult => result.status === 'rejected',\n\t\t);\n\t\tif (failed) throw failed.reason;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,iBAAiB,KAA+B;CAC/D,MAAM,SAAS,IAAI,IAAI,GAAG;CAC1B,MAAM,aAAa,OAAO,aAAa,IAAI,aAAa;CACxD,IAAI,CAAC,YAAY,OAAO,EAAE,kBAAkB,IAAI;CAEhD,OAAO,aAAa,OAAO,aAAa;CACxC,OAAO;EACN,kBAAkB,OAAO,SAAS;EAClC,SAAS,kBAAkB;CAC5B;AACD;;AAWA,eAAsB,qBACrB,KAC4B;CAC5B,MAAM,SAAS,IAAI,GAAG,OAAO,iBAAiB,GAAG,CAAC;CAClD,MAAM,OAAO,QAAQ;CACrB,MAAM,OAAO,MAAM,OAAO;CAE1B,OAAO;EACN,IAAI,IAAI,OAAO,EACd,SAAS,IAAI,gBAAgB,EAG5B,MAAM;GACL,SAAS,YAAY,aAAa,MAAM;GACxC,KAAK,YAAY,CAAC;EACnB,EACD,CAAC,EACF,CAAC;EACD,MAAM,WAAW;GAChB,IAAI;IACH,MAAM,OAAO,MAAM,UAAU;GAC9B,UAAU;IACT,MAAM,OAAO,IAAI;GAClB;EACD;CACD;AACD;;;;;;;;AASA,SAAS,aAAa,QAAkC;CACvD,IAAI,QAAQ;CACZ,MAAM,QAAQ,OAAO,MAAM,KAAK,MAAM;CAEtC,MAAM,UAAU,OAAO,OAAO,MAAM;CACpC,OAAO,OAAO,SAAS;EACtB,QAAQ,MAAe,GAAG,SAAoB;GAC7C,MAAM,YACL,OAAO,SAAS,WAAW,KAAK,KAAK,CAAC,CAAC,YAAY,IAAI,KAAA;GAExD,IAAI,cAAc,WAAW,WAAW,WAAW,mBAAmB,GAAG;IACxE;IACA,OAAO,MAAM,qBAAqB,OAAO;GAC1C;GACA,IAAI,cAAc,UACjB,OAAO,MAAM,6BAA6B,SAAS;GAEpD,IAAI,cAAc,YACjB,OAAO,MAAM,iCAAiC,SAAS;GAExD,OAAO,MAAM,MAAM,GAAG,IAAI;EAC3B;EACA,eAAe,CAAC;CACjB,CAAC;CACD,OAAO;AACR;;;;;;;;AASA,IAAa,sBAAb,MAAgD;CAC/C,uBAAwB,IAAI,IAAqC;CAEjE,IAAI,KAAW,KAAmC;EACjD,IAAI,cAAc,KAAK,KAAK,IAAI,GAAG;EACnC,IAAI,CAAC,aAAa;GACjB,cAAc,qBAAqB,GAAG;GACtC,KAAK,KAAK,IAAI,KAAK,WAAW;EAC/B;EACA,OAAO,YAAY,MAAM,EAAE,SAAS,EAAE;CACvC;CAEA,MAAM,cAA6B;EAClC,MAAM,eAAe,CAAC,GAAG,KAAK,KAAK,OAAO,CAAC;EAC3C,KAAK,KAAK,MAAM;EAKhB,MAAM,UAAS,MAHO,QAAQ,WAC7B,aAAa,IAAI,OAAO,iBAAiB,MAAM,YAAA,CAAa,SAAS,CAAC,CACvE,EAAA,CACuB,MACrB,WAA4C,OAAO,WAAW,UAChE;EACA,IAAI,QAAQ,MAAM,OAAO;CAC1B;AACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/testkit",
-  "version": "10.0.0-alpha.20",
+  "version": "10.0.0-alpha.21",
   "private": false,
   "type": "module",
   "exports": {
@@ -113,6 +113,46 @@
         "types": "./dist/requestContext.d.cts",
         "default": "./dist/requestContext.cjs"
       }
+    },
+    "./browser": {
+      "import": {
+        "types": "./dist/browser.d.mts",
+        "default": "./dist/browser.mjs"
+      },
+      "require": {
+        "types": "./dist/browser.d.cts",
+        "default": "./dist/browser.cjs"
+      }
+    },
+    "./context": {
+      "import": {
+        "types": "./dist/context.d.mts",
+        "default": "./dist/context.mjs"
+      },
+      "require": {
+        "types": "./dist/context.d.cts",
+        "default": "./dist/context.cjs"
+      }
+    },
+    "./mailbox": {
+      "import": {
+        "types": "./dist/mailbox.d.mts",
+        "default": "./dist/mailbox.mjs"
+      },
+      "require": {
+        "types": "./dist/mailbox.d.cts",
+        "default": "./dist/mailbox.cjs"
+      }
+    },
+    "./transactions": {
+      "import": {
+        "types": "./dist/transactions.d.mts",
+        "default": "./dist/transactions.mjs"
+      },
+      "require": {
+        "types": "./dist/transactions.d.cts",
+        "default": "./dist/transactions.cjs"
+      }
     }
   },
   "files": [
@@ -120,17 +160,18 @@
   ],
   "dependencies": {
     "@faker-js/faker": "~10.6.0",
-    "@geekmidas/envkit": "^10.0.0-alpha.20",
-    "@geekmidas/logger": "^10.0.0-alpha.20",
-    "@geekmidas/services": "^10.0.0-alpha.20"
+    "tough-cookie": "~6.0.2",
+    "@geekmidas/logger": "^10.0.0-alpha.21",
+    "@geekmidas/envkit": "^10.0.0-alpha.21",
+    "@geekmidas/services": "^10.0.0-alpha.21"
   },
   "devDependencies": {
     "@better-auth/test-utils": "~1.7.6",
     "@types/pg": "~8.23.1",
     "better-auth": "~1.7.6",
-    "@geekmidas/envkit": "^10.0.0-alpha.20",
-    "@geekmidas/logger": "^10.0.0-alpha.20",
-    "@geekmidas/services": "^10.0.0-alpha.20"
+    "@geekmidas/logger": "^10.0.0-alpha.21",
+    "@geekmidas/envkit": "^10.0.0-alpha.21",
+    "@geekmidas/services": "^10.0.0-alpha.21"
   },
   "repository": {
     "type": "git",