vibeorm 1.1.7 → 1.1.9

package/README.md

@@ -371,7 +371,11 @@ import { bunAdapter } from "@vibeorm/adapter-bun";
 
 const db = VibeClient({
   // Required
-  adapter: bunAdapter({ url: "postgres://..." }),
+  adapter: bunAdapter({
+    url: "postgres://...",
+    statementTimeout: 30000,    // 30s default query timeout (recommended)
+    connectionTimeout: 5000,    // 5s connection establishment timeout
+  }),
   // Or let it read DATABASE_URL from env:
   // adapter: bunAdapter(),
 
@@ -395,7 +399,11 @@ With `node-postgres`:
 import { pgAdapter } from "@vibeorm/adapter-pg";
 
 const db = VibeClient({
-  adapter: pgAdapter({ connectionString: "postgres://..." }),
+  adapter: pgAdapter({
+    connectionString: "postgres://...",
+    statementTimeout: 30000,
+    connectionTimeout: 5000,
+  }),
 });
 ```
 
@@ -1041,6 +1049,64 @@ try {
 }
 ```
 
+### Timeouts
+
+Both adapters support `statementTimeout` and `connectionTimeout` at the adapter level:
+
+```ts
+const db = VibeClient({
+  adapter: bunAdapter({
+    url: "postgres://...",
+    statementTimeout: 30000,    // Cancel any query exceeding 30s
+    connectionTimeout: 5000,    // Fail if connection takes > 5s
+  }),
+});
+```
+
+- **`statementTimeout`** — PostgreSQL cancels queries exceeding this duration (SQLSTATE `57014`), surfaced as `VibeTransientError` with code `STATEMENT_TIMEOUT`.
+- **`connectionTimeout`** — Limits initial connection establishment (bun adapter) or pool checkout (pg adapter).
+- **Transaction-level override** — `db.$transaction(fn, { timeout: 5000 })` overrides the default for that transaction using `SET LOCAL statement_timeout`.
+
+### Retry
+
+Use `withRetry` from `@vibeorm/runtime` to automatically retry operations that fail with transient errors:
+
+```ts
+import { withRetry } from "@vibeorm/runtime";
+
+// Basic — 3 retries with exponential backoff + jitter
+const users = await withRetry(() =>
+  db.user.findMany({ where: { active: true } })
+);
+
+// Custom options
+const user = await withRetry(
+  () => db.user.create({ data: { email: "new@example.com" } }),
+  { maxRetries: 5, baseDelay: 100, maxDelay: 10000 },
+);
+
+// Retry only specific transient errors
+const result = await withRetry(
+  () => db.$transaction(async (tx) => {
+    const user = await tx.user.findUniqueOrThrow({ where: { id: 1 } });
+    await tx.user.update({ where: { id: 1 }, data: { balance: user.balance - 100 } });
+  }, { isolationLevel: "Serializable" }),
+  { retryOn: ["SERIALIZATION_FAILURE", "DEADLOCK"] },
+);
+```
+
+`withRetry` only retries `VibeTransientError` instances. Deterministic errors (`VibeRequestError` — unique constraint violations, validation errors, not found, etc.) are thrown immediately.
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `maxRetries` | `3` | Max retry attempts |
+| `baseDelay` | `50ms` | Base delay for exponential backoff |
+| `maxDelay` | `5000ms` | Delay cap |
+| `maxJitter` | `50ms` | Random jitter per retry |
+| `signal` | — | `AbortSignal` to cancel retries |
+| `retryOn` | — | Filter by `VibeTransientErrorCode` |
+| `onRetry` | — | Callback for logging/metrics |
+
 ---
 
 ## Validation
@@ -1190,7 +1256,10 @@ import { bunAdapter } from "@vibeorm/adapter-bun";
 
 const db = VibeClient({
   adapter: bunAdapter({
-    url: "postgres://...",  // Or reads DATABASE_URL
+    url: "postgres://...",      // Or reads DATABASE_URL
+    max: 20,                    // Pool size (default: 10)
+    statementTimeout: 30000,    // 30s query timeout
+    connectionTimeout: 5000,    // 5s connection timeout
   }),
 });
 ```
@@ -1209,10 +1278,15 @@ import { pgAdapter } from "@vibeorm/adapter-pg";
 const db = VibeClient({
   adapter: pgAdapter({
     connectionString: "postgres://...",
+    max: 20,                    // Pool size (default: 10)
+    statementTimeout: 30000,    // 30s query timeout
+    connectionTimeout: 5000,    // 5s connection timeout
   }),
 });
 ```
 
+Both adapters support `statementTimeout` and `connectionTimeout`. See the adapter package READMEs for full option details.
+
 ---
 
 ## ID Generation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeorm",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "CLI for VibeORM — generate clients, run migrations, introspect databases",
   "license": "MIT",
   "keywords": [
@@ -41,10 +41,10 @@
     "bun": ">=1.1.0"
   },
   "dependencies": {
-    "@vibeorm/parser": "1.1.4",
-    "@vibeorm/generator": "1.1.5",
-    "@vibeorm/migrate": "1.1.5",
-    "@vibeorm/runtime": "1.1.4",
-    "@vibeorm/adapter-bun": "1.1.4"
+    "@vibeorm/parser": "1.1.6",
+    "@vibeorm/generator": "1.1.7",
+    "@vibeorm/migrate": "1.1.7",
+    "@vibeorm/runtime": "1.1.6",
+    "@vibeorm/adapter-bun": "1.1.6"
   }
 }