@bounded-sh/core 0.0.53-next.0 → 0.0.53

package/dist/client/subscription-v2.d.ts

@@ -53,6 +53,27 @@ export declare function forceReconnectV2(): Promise<void>;
  * Returns true if there is an active v2 WebSocket connection open.
  */
 export declare function hasActiveConnection(): boolean;
+/**
+ * v2 socket-when-warm transport for named/computed query polls (subscribeQuery /
+ * runQuery). Runs `queries` over the ambient per-app authenticated socket instead
+ * of HTTP `POST /queries`, but ONLY when that is observably safe and identity-correct:
+ *   - a warm, OPEN, non-authenticating app socket already exists (never opens one);
+ *   - the server advertised `capabilities.runQuery` on the authenticated ack;
+ *   - the socket's authenticated principal matches the caller's CURRENT identity
+ *     (else read rules would evaluate for the wrong user) - reuses the same gate as
+ *     reliable live intents;
+ *   - the serialized frame fits the WS message limit.
+ * Returns the per-row array on a clean socket success; returns null - meaning
+ * "fall back to HTTP" - for every miss/refusal (no socket, no capability, identity
+ * skew, oversized batch, the server's own `{ useHttp: true }` deferral, or any
+ * timeout / disconnect / error frame). The rows are byte-identical to POST /queries,
+ * so the caller is transport-agnostic and never observes which transport won.
+ */
+export declare function runNamedQueriesOverSocket(appId: string, queries: Array<{
+    path: string;
+    queryName: string;
+    queryArgs: any;
+}>, isServer: boolean): Promise<any[] | null>;
 /**
  * Send a live-room intent over the EXISTING per-room socket (fire-and-forget).
  * Returns true if it was sent over an open connection, false if there is no