@gonvex/protocol 0.1.26 → 0.1.28

package/dist/index.d.ts

@@ -40,7 +40,12 @@ export type FunctionDependencies = {
         table: string;
         columns?: string[];
     }>;
+    readsEphemeral?: boolean;
+    writesEphemeral?: boolean;
     shareByPermissions?: boolean;
+    shareByVisibility?: string;
+    shareResultFrom?: string;
+    shareResultField?: string;
 };
 export type SubscriptionRevision = {
     epoch: string;
@@ -57,6 +62,8 @@ export type MessageTrace = {
     serverSubscriptionStartedAtMs?: number;
     serverSubscriptionSentAtMs?: number;
     serverDurationMs?: number;
+    /** Non-semantic top-level query performance metadata from result.perf. */
+    queryPerf?: JsonValue;
 };
 export type BrowserTelemetryInfo = {
     userAgent?: string;
@@ -97,8 +104,12 @@ export type ServerCapabilities = {
     syncIntegrity?: 1;
     /** Server accepts `query.subscribeMany` batched subscription frames. */
     queryBatch?: 1;
+    /** Server emits several independent query updates in one WebSocket frame. */
+    queryResultBatch?: 1;
     /** Server accepts `mutation.callMany` batched offline-queue flushes. */
     mutationBatch?: 1;
+    /** Server emits connection-level sync revision watermarks. */
+    syncWatermark?: 1;
 };
 export type QuerySubscribeRequest = {
     id: string;
@@ -128,6 +139,31 @@ export type SyncReady = {
     cursor: SyncCursor;
     mode?: "eager" | "progressive";
     digest?: string;
+    truncated?: boolean;
+};
+export type ClientCapabilities = {
+    /** Client accepts coalesced `sync.readyMany` server frames. */
+    syncReadyMany?: 1;
+    /** Client accepts connection-level `sync.watermark` server frames. */
+    syncWatermark?: 1;
+    /** Client accepts keyed patches for object results with a `page` row array. */
+    queryPagePatch?: 1;
+    /** Client atomically applies keyed patches to named arrays in object results. */
+    queryObjectPatch?: 1;
+    /** Client applies compact front/back order deltas on keyed patches. */
+    queryOrderDelta?: 1;
+    /** Client accepts one query payload fanned out to multiple subscription IDs. */
+    queryFanout?: 1;
+    /** Client accepts several independent query updates in one WebSocket frame. */
+    queryResultBatch?: 1;
+};
+export type KeyedCollectionPatch = {
+    inserted?: JsonValue[];
+    updated?: JsonValue[];
+    deleted?: string[];
+    order?: string[];
+    prepend?: string[];
+    append?: string[];
 };
 export type GonvexManifest = {
     project: string;
@@ -142,6 +178,7 @@ export type ClientMessage = {
     project?: string;
     tenant?: string;
     device?: BrowserTelemetryInfo;
+    capabilities?: ClientCapabilities;
 } | {
     type: "query.subscribe";
     id: string;
@@ -200,6 +237,30 @@ export type ClientMessage = {
     device?: BrowserTelemetryInfo;
 };
 export type ServerMessage = {
+    type: "query.batch";
+    messages: ServerMessage[];
+} | {
+    type: "query.fanout";
+    queryType: "query.result" | "query.progress" | "query.patch" | "query.pagePatch" | "query.objectPatch";
+    ids: string[];
+    path?: string;
+    result?: JsonValue;
+    reason?: "initial" | "invalidate" | "recover";
+    trace?: MessageTrace;
+    cacheScope?: string;
+    cacheRevision?: string;
+    subscriptionRevision?: SubscriptionRevision;
+    baseRevision?: SubscriptionRevision;
+    throughRevision?: SubscriptionRevision;
+    inserted?: JsonValue[];
+    updated?: JsonValue[];
+    deleted?: string[];
+    order?: string[];
+    prepend?: string[];
+    append?: string[];
+    collections?: Record<string, KeyedCollectionPatch>;
+    mutationIds?: string[];
+} | {
     type: "session.ready";
     project?: string;
     tenant?: string;
@@ -244,6 +305,36 @@ export type ServerMessage = {
     updated?: JsonValue[];
     deleted?: string[];
     order?: string[];
+    prepend?: string[];
+    append?: string[];
+    cacheScope?: string;
+    cacheRevision?: string;
+    trace?: MessageTrace;
+} | {
+    type: "query.pagePatch";
+    id: string;
+    path?: string;
+    reason?: "initial" | "invalidate" | "recover";
+    baseRevision: SubscriptionRevision;
+    subscriptionRevision: SubscriptionRevision;
+    result?: JsonValue;
+    inserted?: JsonValue[];
+    updated?: JsonValue[];
+    deleted?: string[];
+    order?: string[];
+    prepend?: string[];
+    append?: string[];
+    cacheScope?: string;
+    cacheRevision?: string;
+    trace?: MessageTrace;
+} | {
+    type: "query.objectPatch";
+    id: string;
+    path?: string;
+    reason?: "initial" | "invalidate" | "recover";
+    baseRevision: SubscriptionRevision;
+    subscriptionRevision: SubscriptionRevision;
+    collections: Record<string, KeyedCollectionPatch>;
     cacheScope?: string;
     cacheRevision?: string;
     trace?: MessageTrace;
@@ -276,6 +367,9 @@ export type ServerMessage = {
 } & SyncReady) | {
     type: "sync.readyMany";
     ready: SyncReady[];
+} | {
+    type: "sync.watermark";
+    revision: number;
 } | {
     type: "sync.needHashes";
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonvex/protocol",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "type": "module",
   "publishConfig": {
     "access": "public"