@syncular/client 0.25.2 → 0.26.1

package/src/worker-protocol.ts

@@ -34,7 +34,7 @@ import type {
   WindowState,
 } from './client';
 import type { SqlRow, SqlValue } from './database';
-import type { ClientDiagnosticsSnapshot } from './diagnostics';
+import type { ClientDiagnosticsSnapshot, RealtimePolicy } from './diagnostics';
 import type { EncryptionKeyringConfig } from './encryption';
 import type { ClientChangeBatch, LocalRevision } from './invalidation';
 import type { LocalDataPurgeInput, LocalDataPurgeResult } from './local-purge';
@@ -102,12 +102,23 @@ export interface WorkerInitConfig {
   readonly schema: ClientSchema;
   readonly database: WorkerDatabaseInit;
   readonly endpoints: WorkerEndpoints;
+  /**
+   * Host auth headers for sync, segment, and blob requests. `setHeaders`
+   * replaces the whole set at runtime. WebSockets cannot carry headers, so
+   * realtime authenticates through `realtimeUrl` (cookie or ticket).
+   */
+  readonly headers?: Readonly<Record<string, string>>;
   /** Portable raw keyring installed inside the worker-owned client core. */
   readonly encryption?: EncryptionKeyringConfig;
   /** Open the worker-owned replica behind the fail-closed security gate. */
   readonly securityPreflight?: boolean;
   readonly clientId?: string;
   readonly limits?: SyncClientLimits;
+  /**
+   * SPEC §8.8 realtime policy for the worker-owned core; forwarded verbatim.
+   * Absent ⇒ `optional` (a connected socket, otherwise `POST /sync`).
+   */
+  readonly realtimePolicy?: RealtimePolicy;
   /**
    * RFC 0005 previous-version context, forwarded verbatim into the worker's
    * `SyncClientConfig`. Absent ⇒ the feature stays off (default-off).
@@ -190,6 +201,8 @@ export interface WorkerApi extends Omit<
     options?: { readonly mediaType?: string; readonly name?: string },
   ): Promise<BlobRef>;
   fetchBlob(blobIdOrRef: string): Promise<CachedBlob>;
+  /** Replace the host auth header set; the next HTTP request uses it. */
+  setHeaders(headers: Readonly<Record<string, string>>): void;
   /** Sever/restore the transport + realtime (offline simulation, demos). */
   setOffline(offline: boolean): void;
   close(): Promise<void>;