@stratasync/transport-graphql 0.2.0

package/README.md

@@ -0,0 +1,45 @@
+# @stratasync/transport-graphql
+
+GraphQL transport adapter for sync communication and mutations in the Done.
+
+## Overview
+
+sync-transport-graphql handles communication between the sync client and server:
+
+- **GraphQL client initialization** for sync endpoints
+- **Delta subscriptions** via GraphQL subscriptions over WebSocket
+- **Mutation document generation** from model metadata
+- **Message serialization** for sync payloads including Yjs binary deltas
+
+## Installation
+
+```bash
+npm install @stratasync/transport-graphql
+```
+
+Dependencies: `@stratasync/core`, `@stratasync/yjs`
+
+## Usage
+
+```typescript
+import { createGraphQLTransport } from "@stratasync/transport-graphql";
+
+const transport = createGraphQLTransport({
+  endpoint: "https://api.example.com/graphql",
+  wsEndpoint: "wss://api.example.com/graphql",
+});
+
+// Pass to SyncClient configuration
+const client = new SyncClient({
+  transport,
+});
+```
+
+## How It Works
+
+1. **Bootstrap** — fetches initial state via GraphQL query
+2. **Subscribe** — opens a WebSocket subscription for real-time deltas
+3. **Mutate** — sends client mutations as GraphQL mutations
+4. **Reconnect** — handles connection drops with automatic retry and resubscription
+
+Yjs collaborative editing deltas are encoded as binary (Uint8Array) within GraphQL payloads.

package/dist/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { TransportAdapter } from "@stratasync/client";
+import type { BatchLoadOptions, BootstrapMetadata, BootstrapOptions, ConnectionState, DeltaPacket, DeltaSubscription, ModelRow, MutateResult, SubscribeOptions, SyncId, TransactionBatch } from "@stratasync/core";
+import type { TransportOptions } from "./types.js";
+import { YjsTransportAdapter } from "./yjs-transport.js";
+/**
+ * GraphQL transport adapter implementation
+ */
+export declare class GraphQLTransportAdapter implements TransportAdapter {
+    private readonly options;
+    private readonly wsManager;
+    private connectionState;
+    private readonly stateListeners;
+    private readonly retryConfig;
+    private readonly syncEndpoint;
+    private yjsTransport;
+    constructor(options: TransportOptions);
+    bootstrap(options: BootstrapOptions): AsyncGenerator<ModelRow, BootstrapMetadata, unknown>;
+    batchLoad(options: BatchLoadOptions): AsyncIterable<ModelRow>;
+    mutate(batch: TransactionBatch): Promise<MutateResult>;
+    subscribe(options: SubscribeOptions): DeltaSubscription;
+    getYjsTransport(): YjsTransportAdapter;
+    fetchDeltas(after: SyncId, limit?: number, groups?: string[]): Promise<DeltaPacket>;
+    getConnectionState(): ConnectionState;
+    onConnectionStateChange(callback: (state: ConnectionState) => void): () => void;
+    close(): Promise<void>;
+    private setConnectionState;
+    private getYjsConnectionState;
+    private syncYjsConnectionState;
+    private static resolveYjsConnectionState;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,gBAAgB,EAChB,MAAM,EACN,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAW1B,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,YAAY,CAAoC;gBAE5C,OAAO,EAAE,gBAAgB;IAyBrC,SAAS,CACP,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC;IAWvD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC;IAW7D,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBtD,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB;IAIvD,eAAe,IAAI,mBAAmB;IAwBtC,WAAW,CACT,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,WAAW,CAAC;IAavB,kBAAkB,IAAI,eAAe;IAIrC,uBAAuB,CAErB,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC,MAAM,IAAI;IAOP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,MAAM,CAAC,yBAAyB;CASzC"}

package/dist/adapter.js

@@ -0,0 +1,151 @@
+import { isLiveEditingErrorMessage, isSessionStateMessage, isYjsSyncStep2Message, isYjsUpdateMessage, } from "@stratasync/yjs";
+import { createBatchLoadStream, createBootstrapStream } from "./bootstrap.js";
+import { fetchDeltas } from "./deltas.js";
+import { sendMutations, sendRestMutations } from "./mutations.js";
+import { DEFAULT_RETRY_CONFIG } from "./types.js";
+import { WebSocketManager } from "./websocket.js";
+import { YjsTransportAdapter } from "./yjs-transport.js";
+/**
+ * GraphQL transport adapter implementation
+ */
+export class GraphQLTransportAdapter {
+    options;
+    wsManager;
+    connectionState = "disconnected";
+    stateListeners = new Set();
+    retryConfig;
+    syncEndpoint;
+    yjsTransport = null;
+    constructor(options) {
+        this.options = options;
+        this.retryConfig = options.retry ?? DEFAULT_RETRY_CONFIG;
+        if (!options.syncEndpoint) {
+            throw new Error("syncEndpoint is required");
+        }
+        this.syncEndpoint = options.syncEndpoint;
+        this.wsManager = new WebSocketManager(options.wsEndpoint, options.auth, this.retryConfig, options.webSocketFactory);
+        // Forward WebSocket connection state changes
+        this.wsManager.onConnectionStateChange((state) => {
+            this.setConnectionState(state);
+            this.syncYjsConnectionState(state, this.wsManager.isSubscribedReady());
+        });
+        this.wsManager.onSubscribeStateChange((ready) => {
+            this.syncYjsConnectionState(this.wsManager.getConnectionState(), ready);
+        });
+    }
+    bootstrap(options) {
+        return createBootstrapStream({
+            auth: this.options.auth,
+            bootstrapOptions: options,
+            headers: this.options.headers,
+            retryConfig: this.retryConfig,
+            syncEndpoint: this.syncEndpoint,
+            timeoutMs: this.options.timeout,
+        });
+    }
+    batchLoad(options) {
+        return createBatchLoadStream({
+            auth: this.options.auth,
+            batchLoadOptions: options,
+            headers: this.options.headers,
+            retryConfig: this.retryConfig,
+            syncEndpoint: this.syncEndpoint,
+            timeoutMs: this.options.timeout,
+        });
+    }
+    mutate(batch) {
+        // Use REST endpoint when no GraphQL mutation builder is configured
+        if (!this.options.mutationBuilder) {
+            return sendRestMutations({
+                auth: this.options.auth,
+                batch,
+                endpoint: `${this.syncEndpoint}/mutate`,
+                headers: this.options.headers,
+                retryConfig: this.retryConfig,
+                timeoutMs: this.options.timeout,
+            });
+        }
+        // Otherwise use GraphQL
+        return sendMutations({
+            auth: this.options.auth,
+            batch,
+            endpoint: this.options.endpoint,
+            headers: this.options.headers,
+            mutationBuilder: this.options.mutationBuilder,
+            retryConfig: this.retryConfig,
+            timeoutMs: this.options.timeout,
+        });
+    }
+    subscribe(options) {
+        return this.wsManager.subscribe(options);
+    }
+    getYjsTransport() {
+        if (this.yjsTransport) {
+            return this.yjsTransport;
+        }
+        const adapter = new YjsTransportAdapter((message) => {
+            this.wsManager.sendRaw(JSON.stringify(message));
+        }, this.getYjsConnectionState());
+        this.wsManager.onYjsMessage((message) => {
+            if (isYjsSyncStep2Message(message) ||
+                isYjsUpdateMessage(message) ||
+                isSessionStateMessage(message) ||
+                isLiveEditingErrorMessage(message)) {
+                adapter.handleIncoming(message);
+            }
+        });
+        this.yjsTransport = adapter;
+        return adapter;
+    }
+    fetchDeltas(after, limit, groups) {
+        return fetchDeltas({
+            afterSyncId: after,
+            auth: this.options.auth,
+            groups,
+            headers: this.options.headers,
+            limit,
+            retryConfig: this.retryConfig,
+            syncEndpoint: this.syncEndpoint,
+            timeoutMs: this.options.timeout,
+        });
+    }
+    getConnectionState() {
+        return this.connectionState;
+    }
+    onConnectionStateChange(
+    // oxlint-disable-next-line prefer-await-to-callbacks -- event listener registration
+    callback) {
+        this.stateListeners.add(callback);
+        return () => {
+            this.stateListeners.delete(callback);
+        };
+    }
+    async close() {
+        await this.wsManager.close();
+        this.setConnectionState("disconnected");
+    }
+    setConnectionState(state) {
+        if (this.connectionState !== state) {
+            this.connectionState = state;
+            for (const listener of this.stateListeners) {
+                listener(state);
+            }
+        }
+    }
+    getYjsConnectionState() {
+        return GraphQLTransportAdapter.resolveYjsConnectionState(this.wsManager.getConnectionState(), this.wsManager.isSubscribedReady());
+    }
+    syncYjsConnectionState(wsState, subscribeReady) {
+        if (!this.yjsTransport) {
+            return;
+        }
+        this.yjsTransport.handleConnectionStateChange(GraphQLTransportAdapter.resolveYjsConnectionState(wsState, subscribeReady));
+    }
+    static resolveYjsConnectionState(wsState, subscribeReady) {
+        if (wsState !== "connected") {
+            return wsState;
+        }
+        return subscribeReady ? "connected" : "connecting";
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,27 @@
+import type { BatchLoadOptions, BootstrapMetadata, BootstrapOptions, ModelRow } from "@stratasync/core";
+import type { AuthProvider, RetryConfig } from "./types.js";
+export interface BootstrapStreamOptions {
+    syncEndpoint: string;
+    bootstrapOptions: BootstrapOptions;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+}
+/**
+ * Creates a bootstrap stream that yields model rows
+ */
+export declare function createBootstrapStream(opts: BootstrapStreamOptions): AsyncGenerator<ModelRow, BootstrapMetadata, unknown>;
+export interface BatchLoadStreamOptions {
+    syncEndpoint: string;
+    batchLoadOptions: BatchLoadOptions;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+}
+/**
+ * Batch loads specific model instances via REST
+ */
+export declare function createBatchLoadStream(opts: BatchLoadStreamOptions): AsyncGenerator<ModelRow, void, unknown>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACT,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU5D,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AAKH,wBAAuB,qBAAqB,CAC1C,IAAI,EAAE,sBAAsB,GAC3B,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAuCtD;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AAEH,wBAAuB,qBAAqB,CAC1C,IAAI,EAAE,sBAAsB,GAC3B,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAyCzC"}

package/dist/bootstrap.js

@@ -0,0 +1,223 @@
+import { joinSyncUrl, normalizeSyncEndpoint } from "./protocol.js";
+import { buildRequestHeaders, fetchChecked, isRetryableError, parseSyncId, resolveAuthToken, retryWithBackoff, } from "./utils.js";
+/**
+ * Creates a bootstrap stream that yields model rows
+ */
+// oxlint-disable-next-line func-style -- generators require function declaration
+// oxlint-disable-next-line require-yields
+// oxlint-disable-next-line func-style
+// oxlint-disable-next-line func-style, require-yields -- generators require function declaration
+export async function* createBootstrapStream(opts) {
+    const url = buildBootstrapUrl(opts.syncEndpoint, opts.bootstrapOptions);
+    const response = await retryWithBackoff(async () => {
+        const token = await resolveAuthToken(opts.auth);
+        const requestHeaders = buildRequestHeaders({
+            accept: "application/x-ndjson",
+            headers: opts.headers,
+            token,
+        });
+        return fetchChecked(url, { headers: requestHeaders, method: "GET" }, opts.timeoutMs, "Bootstrap failed");
+    }, opts.retryConfig, isRetryableError);
+    if (!response.body) {
+        throw new Error("Bootstrap response has no body");
+    }
+    let metadata = null;
+    for await (const line of readNdjsonLines(response.body)) {
+        const parsed = parseBootstrapLine(line);
+        if (parsed?.type === "meta") {
+            ({ metadata } = parsed);
+        }
+        else if (parsed?.type === "row") {
+            yield parsed.row;
+        }
+    }
+    return finalizeBootstrapMetadata(metadata, opts.bootstrapOptions);
+}
+/**
+ * Batch loads specific model instances via REST
+ */
+// oxlint-disable-next-line func-style, require-yields -- generators require function declaration
+export async function* createBatchLoadStream(opts) {
+    const body = JSON.stringify({
+        firstSyncId: parseSyncId(opts.batchLoadOptions.firstSyncId, "Batch load firstSyncId"),
+        requests: opts.batchLoadOptions.requests.map(serializeBatchRequest),
+    });
+    const syncBase = normalizeSyncEndpoint(opts.syncEndpoint);
+    const url = joinSyncUrl(syncBase, "/batch");
+    const response = await retryWithBackoff(async () => {
+        const token = await resolveAuthToken(opts.auth);
+        const requestHeaders = buildRequestHeaders({
+            accept: "application/x-ndjson",
+            contentType: "application/json",
+            headers: opts.headers,
+            token,
+        });
+        return fetchChecked(url, { body, headers: requestHeaders, method: "POST" }, opts.timeoutMs, "Batch load failed");
+    }, opts.retryConfig, isRetryableError);
+    if (!response.body) {
+        throw new Error("Batch load response has no body");
+    }
+    for await (const line of readNdjsonLines(response.body)) {
+        const parsed = parseBootstrapLine(line);
+        if (parsed?.type === "row") {
+            yield parsed.row;
+        }
+    }
+}
+const buildBootstrapUrl = (syncEndpoint, options) => {
+    const params = new URLSearchParams();
+    params.set("type", options.type ?? "full");
+    if (options.onlyModels?.length) {
+        params.set("onlyModels", options.onlyModels.join(","));
+    }
+    if (options.schemaHash) {
+        params.set("schemaHash", options.schemaHash);
+    }
+    if (options.firstSyncId !== undefined) {
+        params.set("firstSyncId", parseSyncId(options.firstSyncId, "Bootstrap options firstSyncId"));
+    }
+    if (options.syncGroups?.length) {
+        params.set("syncGroups", options.syncGroups.join(","));
+    }
+    if (options.noSyncPackets) {
+        params.set("noSyncPackets", "true");
+    }
+    if (options.useCFCaching) {
+        params.set("useCFCaching", "true");
+    }
+    if (options.noCache) {
+        params.set("noCache", "true");
+    }
+    if (options.modelsHash) {
+        params.set("modelsHash", options.modelsHash);
+    }
+    const syncBase = normalizeSyncEndpoint(syncEndpoint);
+    return `${joinSyncUrl(syncBase, "/bootstrap")}?${params.toString()}`;
+};
+// oxlint-disable-next-line func-style -- generators require function declaration
+async function* readNdjsonLines(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                break;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (trimmed) {
+                    yield trimmed;
+                }
+            }
+        }
+        if (buffer.trim()) {
+            yield buffer.trim();
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+const finalizeBootstrapMetadata = (metadata, options) => {
+    if (!metadata) {
+        if (options.type === "partial") {
+            return { subscribedSyncGroups: [] };
+        }
+        throw new Error("Bootstrap did not receive metadata");
+    }
+    if (options.type !== "partial" && metadata.lastSyncId === undefined) {
+        throw new Error("Bootstrap metadata is missing lastSyncId");
+    }
+    return metadata;
+};
+const parseBootstrapLine = (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return null;
+    }
+    if (trimmed.startsWith("_metadata_=")) {
+        const raw = JSON.parse(trimmed.slice("_metadata_=".length));
+        return { metadata: normalizeBootstrapMetadata(raw), type: "meta" };
+    }
+    const parsed = JSON.parse(trimmed);
+    if (typeof parsed._metadata_ === "object" && parsed._metadata_ !== null) {
+        return {
+            metadata: normalizeBootstrapMetadata(parsed._metadata_),
+            type: "meta",
+        };
+    }
+    if (isBootstrapMetadata(parsed)) {
+        return { metadata: normalizeBootstrapMetadata(parsed), type: "meta" };
+    }
+    if (parsed.type === "error") {
+        const message = typeof parsed.message === "string"
+            ? parsed.message
+            : "Unknown server error";
+        throw new Error(`Bootstrap server error: ${message}`);
+    }
+    if (parsed.type === "end") {
+        return null;
+    }
+    const modelName = resolveModelName(parsed);
+    if (!modelName) {
+        throw new Error("Bootstrap row is missing __class");
+    }
+    const { __class, ...data } = parsed;
+    return {
+        row: { data, modelName },
+        type: "row",
+    };
+};
+const isBootstrapMetadata = (parsed) => "lastSyncId" in parsed ||
+    "subscribedSyncGroups" in parsed ||
+    "returnedModelsCount" in parsed;
+const normalizeBootstrapMetadata = (parsed) => {
+    const lastSyncIdRaw = parsed.lastSyncId;
+    const subscribedSyncGroupsRaw = parsed.subscribedSyncGroups;
+    const subscribedSyncGroups = Array.isArray(subscribedSyncGroupsRaw)
+        ? subscribedSyncGroupsRaw.filter((group) => typeof group === "string")
+        : [];
+    const result = {
+        subscribedSyncGroups,
+    };
+    if (lastSyncIdRaw !== undefined) {
+        result.lastSyncId = parseSyncId(lastSyncIdRaw, "Bootstrap metadata lastSyncId");
+    }
+    if (parsed.returnedModelsCount &&
+        typeof parsed.returnedModelsCount === "object") {
+        result.returnedModelsCount = parsed.returnedModelsCount;
+    }
+    if (typeof parsed.schemaHash === "string") {
+        result.schemaHash = parsed.schemaHash;
+    }
+    if (typeof parsed.databaseVersion === "number") {
+        result.databaseVersion = parsed.databaseVersion;
+    }
+    result.raw = parsed;
+    return result;
+};
+const resolveModelName = (parsed) => {
+    if (typeof parsed.__class === "string") {
+        return parsed.__class;
+    }
+    return null;
+};
+const serializeBatchRequest = (request) => {
+    if ("indexedKey" in request && typeof request.indexedKey === "string") {
+        return {
+            indexedKey: request.indexedKey,
+            keyValue: request.keyValue,
+            modelName: request.modelName,
+        };
+    }
+    return {
+        groupId: request.groupId,
+        modelName: request.modelName,
+    };
+};
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}

package/dist/deltas.d.ts

@@ -0,0 +1,31 @@
+import type { DeltaPacket, SyncAction, SyncId } from "@stratasync/core";
+import type { AuthProvider, RetryConfig } from "./types.js";
+export interface FetchDeltasOptions {
+    syncEndpoint: string;
+    afterSyncId: SyncId;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    limit?: number;
+    groups?: string[];
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+}
+/**
+ * Fetches deltas from the server via REST
+ */
+export declare const fetchDeltas: (opts: FetchDeltasOptions) => Promise<DeltaPacket>;
+export interface FetchAllDeltasOptions {
+    syncEndpoint: string;
+    afterSyncId: SyncId;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    batchSize?: number;
+    groups?: string[];
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+}
+/**
+ * Fetches all deltas since a sync ID, handling pagination
+ */
+export declare function fetchAllDeltas(opts: FetchAllDeltasOptions): AsyncGenerator<SyncAction, SyncId, unknown>;
+//# sourceMappingURL=deltas.d.ts.map

package/dist/deltas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.d.ts","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQxE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU5D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,kBAAkB,KACvB,OAAO,CAAC,WAAW,CA2CrB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AAOH,wBAAuB,cAAc,CACnC,IAAI,EAAE,qBAAqB,GAC1B,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CA8B7C"}

package/dist/deltas.js

@@ -0,0 +1,69 @@
+import { maxSyncId } from "@stratasync/core";
+import { joinSyncUrl, normalizeSyncEndpoint, parseDeltaPacket, } from "./protocol.js";
+import { buildRequestHeaders, fetchChecked, isRetryableError, parseSyncId, resolveAuthToken, retryWithBackoff, } from "./utils.js";
+/**
+ * Fetches deltas from the server via REST
+ */
+export const fetchDeltas = async (opts) => {
+    const response = await retryWithBackoff(async () => {
+        const token = await resolveAuthToken(opts.auth);
+        const requestHeaders = buildRequestHeaders({
+            accept: "application/json",
+            headers: opts.headers,
+            token,
+        });
+        const params = new URLSearchParams();
+        params.set("after", parseSyncId(opts.afterSyncId, "Fetch deltas afterSyncId"));
+        if (opts.limit !== undefined) {
+            params.set("limit", String(opts.limit));
+        }
+        if (opts.groups && opts.groups.length > 0) {
+            params.set("syncGroups", opts.groups.join(","));
+        }
+        const syncBase = normalizeSyncEndpoint(opts.syncEndpoint);
+        const url = `${joinSyncUrl(syncBase, "/deltas")}?${params.toString()}`;
+        const res = await fetchChecked(url, { headers: requestHeaders, method: "GET" }, opts.timeoutMs, "Fetch deltas failed");
+        return res.json();
+    }, opts.retryConfig, isRetryableError);
+    const packet = parseDeltaPacket(response);
+    if (!packet) {
+        throw new Error("Delta response is not in a supported format");
+    }
+    return packet;
+};
+/**
+ * Fetches all deltas since a sync ID, handling pagination
+ */
+// oxlint-disable-next-line func-style -- generators require function declaration
+// oxlint-disable-next-line require-yields, func-style
+// oxlint-disable-next-line func-style
+// oxlint-disable-next-line require-yields, func-style
+// oxlint-disable-next-line func-style
+// oxlint-disable-next-line require-yields, func-style
+export async function* fetchAllDeltas(opts) {
+    const batchSize = opts.batchSize ?? 1000;
+    let currentSyncId = opts.afterSyncId;
+    let lastSyncId = opts.afterSyncId;
+    while (true) {
+        const packet = await fetchDeltas({
+            afterSyncId: currentSyncId,
+            auth: opts.auth,
+            groups: opts.groups,
+            headers: opts.headers,
+            limit: batchSize,
+            retryConfig: opts.retryConfig,
+            syncEndpoint: opts.syncEndpoint,
+            timeoutMs: opts.timeoutMs,
+        });
+        for (const action of packet.actions) {
+            yield action;
+            lastSyncId = maxSyncId(lastSyncId, action.id);
+        }
+        if (!packet.hasMore || packet.actions.length === 0) {
+            break;
+        }
+        currentSyncId = packet.lastSyncId;
+    }
+    return lastSyncId;
+}
+//# sourceMappingURL=deltas.js.map

package/dist/deltas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deltas.js","sourceRoot":"","sources":["../src/deltas.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { GraphQLTransportAdapter } from "./adapter.js";
+export type { AuthProvider, TransportOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// biome-ignore-all lint/performance/noBarrelFile: package entry point
+export { GraphQLTransportAdapter } from "./adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}