@pineliner/odb-client 1.2.0 → 1.5.0

package/dist/database/adapters/odblite-socket.d.ts

@@ -10,6 +10,10 @@ export declare class OdbliteSocketAdapter implements DatabaseAdapter {
     disconnect(): Promise<void>;
     isHealthy(): Promise<boolean>;
 }
+/** Socket wire-protocol version this client speaks. The connect-time handshake (isHealthy → get_version)
+ *  requires the server to match; on mismatch the auto-adapter falls back to HTTP. Keep in lockstep with
+ *  router_v2's SOCKET_PROTOCOL. */
+export declare const CLIENT_SOCKET_PROTOCOL = 2;
 /** Default same-host unix socket (free — v1 only uses /tmp/odblite-internal.sock). */
 export declare const DEFAULT_UNIX_SOCKET = "/tmp/odblite.sock";
 /**
@@ -36,12 +40,21 @@ export declare function parseSocketTarget(s?: string): SocketTarget;
  */
 export declare class OdbliteAutoAdapter implements DatabaseAdapter {
     readonly type: BackendType;
-    private readonly chosen;
+    private readonly opts;
+    private chosen;
+    private onHttp;
+    private nextRetryAt;
     constructor(opts: {
         socket?: OdbliteSocketConfig;
         http: any;
     });
     private pick;
+    /** Probe the cascade once; return a live socket adapter or null. */
+    private trySocket;
+    /** When we fell back to HTTP, re-probe the socket on a cooldown so a socket that
+     *  comes up LATER (server started after the app) is picked up without a restart —
+     *  subsequent connections then use it. */
+    private maybeUpgrade;
     /** Ordered socket targets to probe. Explicit override → a single target; else the
      *  zero-config cascade unix (same host) → TCP (host derived from ODB_LITE_URL). */
     private candidates;

package/dist/database/adapters/odblite-socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"odblite-socket.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/odblite-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAkC,MAAM,UAAU,CAAA;AAExG,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAoIjE,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,mBAAmB;IAIjC,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAMzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAWpC;AAED,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,sBAAsB,CAAA;AAEtD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAO1D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAErC,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE;YAI/C,IAAI;IAoBlB;uFACmF;IACnF,OAAO,CAAC,UAAU;IAeZ,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAGzC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGpC"}
+{"version":3,"file":"odblite-socket.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/odblite-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAkC,MAAM,UAAU,CAAA;AAExG,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAA;AA0KjE,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CAAG;AAE5D,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,mBAAmB;IAIjC,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAMzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAmBpC;AAED;;mCAEmC;AACnC,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,sBAAsB,CAAA;AAEtD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAO1D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6C;IAClE,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAI;gBAEX,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,mBAAmB,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE;YAK/C,IAAI;IAWlB,oEAAoE;YACtD,SAAS;IAgBvB;;8CAE0C;YAC5B,YAAY;IAY1B;uFACmF;IACnF,OAAO,CAAC,UAAU;IAgBZ,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAIzC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAG5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAGpC"}

package/dist/database/adapters/socket/client.d.ts

@@ -6,6 +6,11 @@ import { type StreamRequest, type StreamResult } from './protocol';
  *
  * Bun-only (uses `Bun.connect`). app-router runs on Bun; the HTTP `odblite`
  * backend remains the universal fallback for non-Bun environments.
+ *
+ * Liveness invariant: an in-flight request must ALWAYS terminate. If the
+ * connection drops (close/error) or a reply never arrives, the pending promise
+ * is REJECTED — never left hanging. A hung pending request would wedge the
+ * caller's transaction, hold its write lane, and cascade into a 30s timeout.
  */
 export interface SocketTarget {
     unix?: string;
@@ -19,10 +24,22 @@ export declare class SocketClient {
     private writer;
     private readonly pending;
     private nextId;
+    private nextStreamId;
     private ready;
     constructor(target: SocketTarget);
+    /** Reject + clear every in-flight request — called on disconnect/error/close so a
+     *  dropped connection FAILS its requests (the caller retries) instead of hanging. */
+    private failPending;
     private connect;
-    pipeline(tenant: string, requests: StreamRequest[]): Promise<StreamResult[]>;
+    /** Reconnect with bounded backoff — bridges a router restart so a request landing in the down-window
+     *  waits it out instead of failing. After the last attempt the error propagates (caller retries / the
+     *  auto-adapter can fall back to HTTP). Backoff: 50·100·200·400·800·1600ms ≈ 3s total by default. */
+    private connectWithRetry;
+    /** Allocate a fresh stream id for an interactive transaction (unique per connection). The server
+     *  pins one SQLite connection per stream id, so all of a tx's statements run on it (read-your-own-
+     *  writes). The id is carried in every frame of that tx via pipeline()'s `stream` arg. */
+    allocStream(): number;
+    pipeline(tenant: string, requests: StreamRequest[], stream?: number): Promise<StreamResult[]>;
     close(): void;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/database/adapters/socket/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/database/adapters/socket/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE5F;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,qBAAa,YAAY;IAQX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACzE,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,KAAK,CAAe;gBAEC,MAAM,EAAE,YAAY;YAOnC,OAAO;IA6Bf,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAalF,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/database/adapters/socket/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE5F;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAqBD,qBAAa,YAAY;IASX,OAAO,CAAC,QAAQ,CAAC,MAAM;IARnC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,KAAK,CAAe;gBAEC,MAAM,EAAE,YAAY;IAOjD;yFACqF;IACrF,OAAO,CAAC,WAAW;YAQL,OAAO;IAsDrB;;yGAEqG;YACvF,gBAAgB;IAc9B;;8FAE0F;IAC1F,WAAW,IAAI,MAAM;IAIf,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA0BnG,KAAK,IAAI,IAAI;CAKd"}

package/dist/database/adapters/socket/protocol.d.ts

@@ -95,6 +95,8 @@ export type StreamRequest = {
     sql: string;
 } | {
     type: 'get_autocommit';
+} | {
+    type: 'get_version';
 } | {
     type: 'close';
 };
@@ -111,6 +113,7 @@ export interface AtomicStep {
     expect?: 'one' | 'atLeastOne' | number;
 }
 export declare function toBatch(steps: AtomicStep[]): Batch;
+export declare function mightReturnRows(sql: string): boolean;
 interface Writable {
     write(data: Uint8Array): number;
 }

package/dist/database/adapters/socket/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/database/adapters/socket/protocol.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../../src/database/adapters/socket/protocol.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -2204,6 +2204,10 @@ var __webpack_exports__ = {};
                 }))
         };
     }
+    const READ_ONLY_RE = /^\s*(?:SELECT|EXPLAIN|VALUES)\b/i;
+    function mightReturnRows(sql) {
+        return READ_ONLY_RE.test(sql) || /\bRETURNING\b/i.test(sql);
+    }
     class FrameWriter {
         socket;
         pending = Buffer.alloc(0);
@@ -2231,6 +2235,7 @@ var __webpack_exports__ = {};
             }
         }
     }
+    const MAX_FRAME = 1024 * (Number(globalThis.process?.env?.ODB_MAX_FRAME_MB) || 64) * 1024;
     class FrameReader {
         buf = Buffer.alloc(0);
         push(chunk) {
@@ -2241,6 +2246,7 @@ var __webpack_exports__ = {};
             const out = [];
             while(this.buf.length >= 4){
                 const len = this.buf.readUInt32LE(0);
+                if (len > MAX_FRAME) throw new Error(`odblite reply frame too large: ${len} bytes (max ${MAX_FRAME})`);
                 if (this.buf.length < 4 + len) break;
                 out.push(this.buf.subarray(4, 4 + len));
                 this.buf = this.buf.subarray(4 + len);
@@ -2248,6 +2254,10 @@ var __webpack_exports__ = {};
             return out;
         }
     }
+    const REQUEST_TIMEOUT_MS = Number(globalThis.process?.env?.ODB_SOCKET_REQUEST_TIMEOUT_MS) || 30000;
+    const RECONNECT_ATTEMPTS = Number(globalThis.process?.env?.ODB_SOCKET_RECONNECT_ATTEMPTS) || 6;
+    const RECONNECT_BASE_MS = Number(globalThis.process?.env?.ODB_SOCKET_RECONNECT_BASE_MS) || 50;
+    const sleep = (ms)=>new Promise((r)=>setTimeout(r, ms));
     class SocketClient {
         target;
         socket;
@@ -2255,12 +2265,20 @@ var __webpack_exports__ = {};
         writer;
         pending = new Map();
         nextId = 1;
+        nextStreamId = 1;
         ready;
         constructor(target){
             this.target = target;
             this.ready = this.connect();
             this.ready.catch(()=>{});
         }
+        failPending(err) {
+            for (const p of this.pending.values()){
+                clearTimeout(p.timer);
+                p.reject(err);
+            }
+            this.pending.clear();
+        }
         async connect() {
             const Bun = globalThis.Bun;
             if (!Bun?.connect) throw new Error('odblite-socket backend requires Bun (Bun.connect)');
@@ -2273,43 +2291,93 @@ var __webpack_exports__ = {};
             this.socket = await Bun.connect({
                 ...opts,
                 socket: {
-                    data: (_s, chunk)=>{
-                        for (const frame of this.reader.push(chunk)){
+                    data: (s, chunk)=>{
+                        let frames;
+                        try {
+                            frames = this.reader.push(chunk);
+                        } catch (err) {
+                            this.socket = void 0;
+                            this.reader = new FrameReader();
+                            try {
+                                s.end?.();
+                            } catch  {}
+                            this.failPending(err instanceof Error ? err : new Error(`odblite framing error: ${err}`));
+                            return;
+                        }
+                        for (const frame of frames){
                             const msg = JSON.parse(frame.toString('utf8'));
-                            const resolve = this.pending.get(msg.id);
-                            if (resolve) {
+                            const p = this.pending.get(msg.id);
+                            if (p) {
                                 this.pending.delete(msg.id);
-                                resolve(msg.results);
+                                clearTimeout(p.timer);
+                                p.resolve(msg.results);
                             }
                         }
                     },
                     drain: (_s)=>this.writer.flush(),
                     close: ()=>{
                         this.socket = void 0;
+                        this.reader = new FrameReader();
+                        this.failPending(new Error('odblite socket disconnected — request not completed'));
+                    },
+                    error: (_s, err)=>{
+                        this.socket = void 0;
+                        this.reader = new FrameReader();
+                        this.failPending(err instanceof Error ? err : new Error(`odblite socket error: ${err}`));
                     }
                 }
             });
             this.writer = new FrameWriter(this.socket);
         }
-        async pipeline(tenant, requests) {
+        async connectWithRetry() {
+            let lastErr;
+            for(let attempt = 0; attempt < RECONNECT_ATTEMPTS; attempt++)try {
+                await this.connect();
+                return;
+            } catch (err) {
+                lastErr = err;
+                if (attempt < RECONNECT_ATTEMPTS - 1) await sleep(RECONNECT_BASE_MS * 2 ** attempt);
+            }
+            throw lastErr instanceof Error ? lastErr : new Error(`odblite socket reconnect failed: ${lastErr}`);
+        }
+        allocStream() {
+            return this.nextStreamId++;
+        }
+        async pipeline(tenant, requests, stream) {
+            await this.ready.catch(()=>{});
             if (!this.socket) {
-                this.ready = this.connect();
+                this.ready = this.connectWithRetry();
                 this.ready.catch(()=>{});
+                await this.ready;
             }
-            await this.ready;
             const id = this.nextId++;
-            return new Promise((resolve)=>{
-                this.pending.set(id, resolve);
-                this.writer.send(Buffer.from(JSON.stringify({
+            return new Promise((resolve, reject)=>{
+                const timer = setTimeout(()=>{
+                    if (this.pending.delete(id)) reject(new Error(`odblite socket request ${id} timed out after ${REQUEST_TIMEOUT_MS}ms`));
+                }, REQUEST_TIMEOUT_MS);
+                timer.unref?.();
+                this.pending.set(id, {
+                    resolve,
+                    reject,
+                    timer
+                });
+                const payload = null != stream ? {
                     id,
                     tenant,
+                    stream,
                     requests
-                }), 'utf8'));
+                } : {
+                    id,
+                    tenant,
+                    requests
+                };
+                this.writer.send(Buffer.from(JSON.stringify(payload), 'utf8'));
             });
         }
         close() {
             this.socket?.end?.();
             this.socket = void 0;
+            this.failPending(new Error('odblite socket closed'));
         }
     }
     function toQueryResult(res) {
@@ -2333,21 +2401,22 @@ var __webpack_exports__ = {};
     class OdbliteSocketConnection {
         client;
         tenant;
+        streamId;
         databaseName;
         databaseHash;
         sql;
-        buffer;
-        constructor(client, tenant, buffer){
+        beginPending = false;
+        constructor(client, tenant, streamId){
             this.client = client;
             this.tenant = tenant;
+            this.streamId = streamId;
             this.databaseName = tenant;
             this.databaseHash = tenant;
-            this.buffer = buffer;
             const self = this;
             this.sql = function(strings, ...values) {
                 if (strings && 'object' == typeof strings && 'raw' in strings) {
                     const text = strings.reduce((a, s, i)=>a + s + (i < values.length ? '?' : ''), '');
-                    const returns = /^\s*SELECT/i.test(text) || /\bRETURNING\b/i.test(text);
+                    const returns = mightReturnRows(text);
                     return (returns ? self.query(text, values) : self.execute(text, values)).then((r)=>r.rows);
                 }
                 throw new Error('sql() fragment helper not implemented in odblite-socket');
@@ -2358,7 +2427,32 @@ var __webpack_exports__ = {};
             if (!res) throw new Error('odblite-socket: empty pipeline response');
             return res;
         }
+        async streamExec(sql, params = []) {
+            const reqs = [];
+            if (this.beginPending) {
+                reqs.push({
+                    type: 'execute',
+                    stmt: {
+                        sql: 'BEGIN'
+                    }
+                });
+                this.beginPending = false;
+            }
+            reqs.push({
+                type: 'execute',
+                stmt: {
+                    sql,
+                    args: params.map(toHrana)
+                }
+            });
+            const results = await this.client.pipeline(this.tenant, reqs, this.streamId);
+            if (reqs.length > 1 && results[0]?.type === 'error') throw new Error(results[0].error.message);
+            const res = results[results.length - 1];
+            if (!res) throw new Error('odblite-socket: empty stream response');
+            return toQueryResult(res);
+        }
         async query(sql, params = []) {
+            if (null != this.streamId) return await this.streamExec(sql, params);
             return toQueryResult(await this.one([
                 {
                     type: 'execute',
@@ -2372,16 +2466,7 @@ var __webpack_exports__ = {};
         async execute(sql, params = []) {
             const s = 'string' == typeof sql ? sql : sql.sql;
             const p = 'string' == typeof sql ? params : sql.args ?? [];
-            if (this.buffer) {
-                this.buffer.push({
-                    sql: s,
-                    params: p
-                });
-                return {
-                    rows: [],
-                    rowsAffected: 0
-                };
-            }
+            if (null != this.streamId) return this.streamExec(s, p);
             return toQueryResult(await this.one([
                 {
                     type: 'execute',
@@ -2410,24 +2495,33 @@ var __webpack_exports__ = {};
             };
         }
         async transaction(fn) {
-            if (this.buffer) return fn(this);
-            const buffer = [];
-            const out = await fn(new OdbliteSocketConnection(this.client, this.tenant, buffer));
-            if (buffer.length) {
-                const res = await this.atomic(buffer.map((b)=>({
-                        sql: b.sql,
-                        params: b.params
-                    })));
-                const err = res.step_errors?.find((e)=>e);
-                if (err) throw new Error(`transaction batch failed: ${err.message}`);
+            if (null != this.streamId) return fn(this);
+            const tx = new OdbliteSocketConnection(this.client, this.tenant, this.client.allocStream());
+            tx.beginPending = true;
+            try {
+                const out = await fn(tx);
+                if (!tx.beginPending) await tx.streamExec('COMMIT');
+                return out;
+            } catch (e) {
+                if (!tx.beginPending) await tx.streamExec('ROLLBACK').catch(()=>{});
+                throw e;
             }
-            return out;
         }
         begin(fn) {
             return this.transaction(fn);
         }
-        savepoint(fn) {
-            return this.transaction(fn);
+        async savepoint(fn) {
+            if (null == this.streamId) return this.transaction(fn);
+            const name = `sp_${this.client.allocStream()}`;
+            await this.streamExec(`SAVEPOINT ${name}`);
+            try {
+                const out = await fn(this);
+                await this.streamExec(`RELEASE SAVEPOINT ${name}`);
+                return out;
+            } catch (e) {
+                await this.streamExec(`ROLLBACK TO SAVEPOINT ${name}`).catch(()=>{});
+                throw e;
+            }
         }
         async ensureNamespaces(namespaces) {
             return {
@@ -2465,20 +2559,26 @@ var __webpack_exports__ = {};
         }
         async isHealthy() {
             try {
-                await Promise.race([
+                const res = await Promise.race([
                     this.client.pipeline('_health', [
                         {
-                            type: 'get_autocommit'
+                            type: 'get_version'
                         }
                     ]),
                     new Promise((_, rej)=>setTimeout(()=>rej(new Error('probe timeout')), 1500))
                 ]);
+                const proto = res?.[0]?.response?.protocol;
+                if (proto !== CLIENT_SOCKET_PROTOCOL) {
+                    console.warn(`[odb-client] socket protocol mismatch (server=${proto ?? 'none'}, client=${CLIENT_SOCKET_PROTOCOL}) → using HTTP`);
+                    return false;
+                }
                 return true;
             } catch  {
                 return false;
             }
         }
     }
+    const CLIENT_SOCKET_PROTOCOL = 2;
     const DEFAULT_UNIX_SOCKET = '/tmp/odblite.sock';
     function parseSocketTarget(s) {
         const v = (s ?? '').trim();
@@ -2499,13 +2599,26 @@ var __webpack_exports__ = {};
     }
     class OdbliteAutoAdapter {
         type = 'odblite';
+        opts;
         chosen;
+        onHttp = false;
+        nextRetryAt = 0;
         constructor(opts){
-            this.chosen = this.pick(opts);
+            this.opts = opts;
+            this.chosen = this.pick();
         }
-        async pick(opts) {
+        async pick() {
             const hasBun = void 0 !== globalThis.Bun && !!globalThis.Bun.connect;
-            if (hasBun) for (const target of this.candidates(opts))try {
+            if (hasBun) {
+                const socket = await this.trySocket();
+                if (socket) return socket;
+            }
+            this.onHttp = true;
+            console.log('[odb-client] transport → HTTP (no router_v2 socket reachable)');
+            return new ODBLiteAdapter(this.opts.http);
+        }
+        async trySocket() {
+            for (const target of this.candidates())try {
                 const socket = new OdbliteSocketAdapter(target);
                 if (await socket.isHealthy()) {
                     console.log(`[odb-client] transport → SOCKET (router_v2 @ ${target.unix ?? `${target.hostname}:${target.port}`})`);
@@ -2513,12 +2626,23 @@ var __webpack_exports__ = {};
                 }
                 await socket.disconnect();
             } catch  {}
-            console.log('[odb-client] transport → HTTP (no router_v2 socket reachable)');
-            return new ODBLiteAdapter(opts.http);
-        }
-        candidates(opts) {
-            if (opts.socket?.unix || opts.socket?.port) return [
-                opts.socket
+            return null;
+        }
+        async maybeUpgrade() {
+            if (!this.onHttp) return;
+            const now = Date.now();
+            if (now < this.nextRetryAt) return;
+            this.nextRetryAt = now + 15000;
+            const socket = await this.trySocket();
+            if (socket) {
+                this.chosen = Promise.resolve(socket);
+                this.onHttp = false;
+            }
+        }
+        candidates() {
+            const { socket, http } = this.opts;
+            if (socket?.unix || socket?.port) return [
+                socket
             ];
             const env = globalThis.process?.env?.ODB_SOCKET;
             if (env) return [
@@ -2530,7 +2654,7 @@ var __webpack_exports__ = {};
                 }
             ];
             try {
-                const host = new URL(opts.http?.serviceUrl).hostname;
+                const host = new URL(http?.serviceUrl).hostname;
                 const port = Number(globalThis.process?.env?.ODB_SOCKET_PORT ?? 8787);
                 if (host) out.push({
                     hostname: host,
@@ -2540,6 +2664,7 @@ var __webpack_exports__ = {};
             return out;
         }
         async connect(config) {
+            await this.maybeUpgrade();
             return (await this.chosen).connect(config);
         }
         async disconnect(tenantId) {