neon-testing 2.7.0 → 3.0.0-beta.1

package/dist/lib/expires-in.js

@@ -0,0 +1,21 @@
+/**
+ * Validates the expiresIn option
+ */
+export function validateExpiresIn(expiresIn) {
+    if (expiresIn === null) {
+        return;
+    }
+    if (expiresIn === undefined) {
+        return;
+    }
+    if (!Number.isInteger(expiresIn)) {
+        throw new Error("expiresIn must be an integer");
+    }
+    if (expiresIn <= 0) {
+        throw new Error("expiresIn must be a positive integer");
+    }
+    if (expiresIn > 2592000) {
+        throw new Error("expiresIn must not exceed 30 days (2,592,000 seconds)");
+    }
+}
+//# sourceMappingURL=expires-in.js.map

package/dist/lib/expires-in.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expires-in.js","sourceRoot":"","sources":["../../src/lib/expires-in.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoC;IACpE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,SAAS,GAAG,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/lib/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/lib/singleton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAM1D"}

package/dist/lib/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/lib/singleton.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAI,OAAgB;IAC/C,IAAI,QAAuB,CAAC;IAC5B,OAAO,GAAG,EAAE;QACV,QAAQ,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/ssl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Rewrite the `sslmode` (and related) query params on a Neon connection URI.
+ *
+ * Neon's API returns URIs with `sslmode=require`. In pg v9 /
+ * pg-connection-string v3 this mode will adopt libpq semantics (encrypt
+ * without CA verification) instead of today's effective `verify-full`.
+ */
+export declare function applySslMode(uri: string, mode: "verify-full" | "require" | undefined): string;
+//# sourceMappingURL=ssl.d.ts.map

package/dist/lib/ssl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssl.d.ts","sourceRoot":"","sources":["../../src/lib/ssl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,GAAG,SAAS,GAAG,SAAS,GAC1C,MAAM,CAaR"}

package/dist/lib/ssl.js

@@ -0,0 +1,21 @@
+/**
+ * Rewrite the `sslmode` (and related) query params on a Neon connection URI.
+ *
+ * Neon's API returns URIs with `sslmode=require`. In pg v9 /
+ * pg-connection-string v3 this mode will adopt libpq semantics (encrypt
+ * without CA verification) instead of today's effective `verify-full`.
+ */
+export function applySslMode(uri, mode) {
+    if (mode === undefined)
+        return uri;
+    const url = new URL(uri);
+    url.searchParams.set("sslmode", mode);
+    if (mode === "require") {
+        url.searchParams.set("uselibpqcompat", "true");
+    }
+    else {
+        url.searchParams.delete("uselibpqcompat");
+    }
+    return url.toString();
+}
+//# sourceMappingURL=ssl.js.map

package/dist/lib/ssl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssl.js","sourceRoot":"","sources":["../../src/lib/ssl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,GAAW,EACX,IAA2C;IAE3C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAEnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAEtC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/lib/with-retry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reusable API call wrapper with automatic retry on 423 errors with exponential
+ * backoff
+ *
+ * https://neon.com/docs/reference/typescript-sdk#error-handling
+ * https://neon.com/docs/changelog/2022-07-20
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options: {
+    maxRetries: number;
+    baseDelayMs: number;
+}): Promise<T>;
+//# sourceMappingURL=with-retry.d.ts.map

package/dist/lib/with-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.d.ts","sourceRoot":"","sources":["../../src/lib/with-retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,CAAC,CAAC,CAyCZ"}

package/dist/lib/with-retry.js

@@ -0,0 +1,39 @@
+/**
+ * Reusable API call wrapper with automatic retry on 423 errors with exponential
+ * backoff
+ *
+ * https://neon.com/docs/reference/typescript-sdk#error-handling
+ * https://neon.com/docs/changelog/2022-07-20
+ */
+export async function withRetry(fn, options) {
+    if (!Number.isInteger(options.maxRetries) || options.maxRetries <= 0) {
+        throw new Error("maxRetries must be a positive integer");
+    }
+    if (!Number.isInteger(options.baseDelayMs) || options.baseDelayMs <= 0) {
+        throw new Error("baseDelayMs must be a positive integer");
+    }
+    for (let attempt = 1; attempt <= options.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const status = error?.response?.status;
+            // Retry on 423 (resource locked) with exponential backoff
+            if (status === 423 && attempt < options.maxRetries) {
+                const delay = options.baseDelayMs * Math.pow(2, attempt - 1);
+                console.log(`API call failed with 423, retrying in ${delay}ms (attempt ${attempt}/${options.maxRetries})`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                continue;
+            }
+            // Surface Neon API error details that are otherwise buried in the Axios error
+            if (error?.response?.data?.code) {
+                const { code, message } = error.response.data;
+                throw new Error(`Neon API error - HTTP ${status} - ${code} - ${message}`, { cause: error });
+            }
+            // Non-API errors (network, timeouts, etc.) pass through as-is
+            throw error;
+        }
+    }
+    throw new Error("apiCallWithRetry reached unexpected end");
+}
+//# sourceMappingURL=with-retry.js.map

package/dist/lib/with-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry.js","sourceRoot":"","sources":["../../src/lib/with-retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,OAGC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;YAEvC,0DAA0D;YAC1D,IAAI,MAAM,KAAK,GAAG,IAAI,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBAE7D,OAAO,CAAC,GAAG,CACT,yCAAyC,KAAK,eAAe,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,CAC9F,CAAC;gBACF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBAE3D,SAAS;YACX,CAAC;YAED,8EAA8E;YAC9E,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAChC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC9C,MAAM,IAAI,KAAK,CACb,yBAAyB,MAAM,MAAM,IAAI,MAAM,OAAO,EAAE,EACxD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;YAED,8DAA8D;YAC9D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/lib/ws-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Error handler: Suppress Neon WebSocket "Connection terminated unexpectedly"
+ * error
+ */
+export declare const neonWsErrorHandler: (error: Error) => void;
+//# sourceMappingURL=ws-error.d.ts.map

package/dist/lib/ws-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-error.d.ts","sourceRoot":"","sources":["../../src/lib/ws-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,SAY9C,CAAC"}

package/dist/lib/ws-error.js

@@ -0,0 +1,15 @@
+/**
+ * Error handler: Suppress Neon WebSocket "Connection terminated unexpectedly"
+ * error
+ */
+export const neonWsErrorHandler = (error) => {
+    const isNeonWsClose = error.message.includes("Connection terminated unexpectedly") &&
+        error.stack?.includes("@neondatabase/serverless");
+    if (isNeonWsClose) {
+        // Swallow this specific Neon WS termination error
+        return;
+    }
+    // For any other error, detach and rethrow
+    throw error;
+};
+//# sourceMappingURL=ws-error.js.map

package/dist/lib/ws-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-error.js","sourceRoot":"","sources":["../../src/lib/ws-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAY,EAAE,EAAE;IACjD,MAAM,aAAa,GACjB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC5D,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IAEpD,IAAI,aAAa,EAAE,CAAC;QAClB,kDAAkD;QAClD,OAAO;IACT,CAAC;IAED,0CAA0C;IAC1C,MAAM,KAAK,CAAC;AACd,CAAC,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":""}

package/dist/setup.js

@@ -0,0 +1,9 @@
+import { CLEARED_DATABASE_URL } from "./lib/cleared-database-url.js";
+// Overwrites any existing DATABASE_URL so a test file that forgot to call
+// `neonTesting()` can't reach the pre-configured database. Loaded as a
+// test-runner preload (Vitest `setupFiles` / Bun `bunfig` `preload`).
+if (process.env.DATABASE_URL && process.env.NEON_TESTING_DEBUG === "true") {
+    console.debug("[neon-testing] Overwriting existing DATABASE_URL");
+}
+process.env.DATABASE_URL = CLEARED_DATABASE_URL;
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,0EAA0E;AAC1E,uEAAuE;AACvE,sEAAsE;AACtE,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,MAAM,EAAE,CAAC;IAC1E,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACpE,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,oBAAoB,CAAC"}

package/dist/utils.d.ts

@@ -1,9 +1,3 @@
-import { neonTesting as neonTestingVite } from "./vite-plugin.js";
-export { lazySingleton } from "./singleton.js";
-export { createBarrier } from "./barrier.js";
-/**
- * @deprecated Import the Vite plugin from "neon-testing/vite" instead. This
- * export will be removed in the next major version.
- */
-export declare const neonTesting: typeof neonTestingVite;
+export { lazySingleton } from "./lib/singleton.js";
+export { createBarrier } from "./lib/barrier.js";
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,WAAW,wBAAkB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils.js

@@ -1,9 +1,3 @@
-import { neonTesting as neonTestingVite } from "./vite-plugin.js";
-export { lazySingleton } from "./singleton.js";
-export { createBarrier } from "./barrier.js";
-/**
- * @deprecated Import the Vite plugin from "neon-testing/vite" instead. This
- * export will be removed in the next major version.
- */
-export const neonTesting = neonTestingVite;
+export { lazySingleton } from "./lib/singleton.js";
+export { createBarrier } from "./lib/barrier.js";
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC","sourcesContent":["import { neonTesting as neonTestingVite } from \"./vite-plugin.js\";\nexport { lazySingleton } from \"./singleton.js\";\nexport { createBarrier } from \"./barrier.js\";\n\n/**\n * @deprecated Import the Vite plugin from \"neon-testing/vite\" instead. This\n * export will be removed in the next major version.\n */\nexport const neonTesting = neonTestingVite;\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/vitest.d.ts

@@ -0,0 +1,11 @@
+import type { MakeNeonTestingOptions } from "./core.js";
+export type { MakeNeonTestingOptions, NeonTestingOptions } from "./core.js";
+/**
+ * Create a Neon test-branch factory wired to Vitest's lifecycle hooks.
+ */
+export declare function makeNeonTesting(options: MakeNeonTestingOptions): {
+    (overrides?: import("./core.js").NeonTestingOptions): () => import("@neondatabase/api-client").Branch | undefined;
+    deleteAllTestBranches: () => Promise<void>;
+    api: import("@neondatabase/api-client").Api<unknown>;
+};
+//# sourceMappingURL=vitest.d.ts.map

package/dist/vitest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.d.ts","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE5E;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB;;;;EAE9D"}

package/dist/vitest.js

@@ -0,0 +1,9 @@
+import { beforeAll, afterAll } from "vitest";
+import { makeNeonTestingCore } from "./core.js";
+/**
+ * Create a Neon test-branch factory wired to Vitest's lifecycle hooks.
+ */
+export function makeNeonTesting(options) {
+    return makeNeonTestingCore({ ...options, hooks: { beforeAll, afterAll } });
+}
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.js","sourceRoot":"","sources":["../src/vitest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAKhD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,OAAO,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/package.json

@@ -1,12 +1,14 @@
 {
   "name": "neon-testing",
-  "version": "2.7.0",
-  "description": "A Vitest utility for seamless integration tests with Neon Postgres",
+  "version": "3.0.0-beta.1",
+  "description": "A testing utility for seamless integration tests with Neon Postgres, for Vitest and Bun Test.",
   "keywords": [
     "neon",
     "postgres",
     "postgresql",
-    "vitest"
+    "vitest",
+    "bun",
+    "testing"
   ],
   "author": "Mikael Lirbank",
   "license": "MIT",
@@ -15,60 +17,90 @@
   "bugs": "https://github.com/starmode-base/neon-testing/issues",
   "type": "module",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "import": "./dist/vitest.js"
+    },
+    "./bun": {
+      "types": "./dist/bun.d.ts",
+      "import": "./dist/bun.js"
     },
     "./utils": {
       "types": "./dist/utils.d.ts",
       "import": "./dist/utils.js"
     },
-    "./vite": {
-      "types": "./dist/vite-plugin.d.ts",
-      "import": "./dist/vite-plugin.js"
+    "./setup": {
+      "types": "./dist/setup.d.ts",
+      "import": "./dist/setup.js"
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
   ],
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
     "dev": "tsc -p tsconfig.build.json --watch",
-    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc && prettier --check . && vitest run",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build",
+    "check": "prettier --check . && bun run build && tsc && bun run check:drift && bun run test",
+    "check:drift": "diff -r -x neon-testing.ts tests-bun tests-vitest",
     "format": "prettier --write .",
-    "test": "vitest",
+    "test": "vitest run && bun test",
+    "test:unit": "vitest run src",
+    "test:unit:watch": "vitest src",
+    "test:examples": "vitest run examples",
+    "test:examples:watch": "vitest examples",
+    "test:vitest": "vitest run tests-vitest",
+    "test:vitest:watch": "vitest tests-vitest",
+    "test:bun": "bun test",
+    "test:bun:watch": "bun test --watch",
     "skills:update": "bunx skills add neondatabase/agent-skills",
     "clean:soft": "rm -rf node_modules dist && bun install",
     "clean:hard": "rm -rf node_modules dist bun.lock && bun install",
-    "release:patch": "bun pm version patch",
-    "release:minor": "bun pm version minor",
-    "release:major": "bun pm version major",
-    "release:beta": "bun pm version prerelease --preid=beta",
-    "release:beta:patch": "bun pm version prepatch --preid=beta",
-    "release:beta:minor": "bun pm version preminor --preid=beta",
-    "release:beta:major": "bun pm version premajor --preid=beta",
+    "release:patch": "bun pm version patch --message 'release: v%s'",
+    "release:minor": "bun pm version minor --message 'release: v%s'",
+    "release:major": "bun pm version major --message 'release: v%s'",
+    "release:beta": "bun pm version prerelease --preid=beta --message 'release: v%s'",
+    "release:beta:patch": "bun pm version prepatch --preid=beta --message 'release: v%s'",
+    "release:beta:minor": "bun pm version preminor --preid=beta --message 'release: v%s'",
+    "release:beta:major": "bun pm version premajor --preid=beta --message 'release: v%s'",
+    "preversion": "test \"$(git branch --show-current)\" = main && git pull --ff-only",
     "postversion": "git push --follow-tags"
   },
   "dependencies": {
-    "@neondatabase/api-client": "^2.7.1"
+    "@neondatabase/api-client": "2.7.1"
   },
   "peerDependencies": {
-    "vite": "^7",
+    "@neondatabase/serverless": "^1",
     "vitest": "^3 || ^4"
   },
+  "peerDependenciesMeta": {
+    "@neondatabase/serverless": {
+      "optional": true
+    },
+    "vitest": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@neondatabase/serverless": "^1.0.2",
+    "@neondatabase/serverless": "^1.1.0",
+    "@types/bun": "^1.3.14",
     "@types/pg": "^8.20.0",
     "dotenv": "^17.4.2",
     "drizzle-orm": "^0.45.2",
-    "pg": "^8.20.0",
+    "pg": "^8.21.0",
     "postgres": "^3.4.9",
-    "prettier": "^3.8.2",
+    "prettier": "^3.8.4",
     "tiny-invariant": "^1.3.3",
-    "typescript": "^5.9.3",
-    "vite": "^7.3.2",
-    "vitest": "^4.1.4"
-  },
-  "browser": {
-    "./dist/vite-plugin.js": "./dist/browser-empty.js"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
   }
 }

package/src/bun.ts

@@ -0,0 +1,13 @@
+/// <reference types="bun" />
+import { beforeAll, afterAll } from "bun:test";
+import { makeNeonTestingCore } from "./core.js";
+import type { MakeNeonTestingOptions } from "./core.js";
+
+export type { MakeNeonTestingOptions, NeonTestingOptions } from "./core.js";
+
+/**
+ * Create a Neon test-branch factory wired to Bun's lifecycle hooks.
+ */
+export function makeNeonTesting(options: MakeNeonTestingOptions) {
+  return makeNeonTestingCore({ ...options, hooks: { beforeAll, afterAll } });
+}