@stratasync/transport-graphql 0.2.0

package/dist/utils.js

@@ -0,0 +1,180 @@
+import { DEFAULT_RETRY_CONFIG } from "./types.js";
+/**
+ * Delays execution for a specified duration
+ */
+const delay = (ms) => 
+// oxlint-disable-next-line avoid-new -- wrapping callback API in promise
+new Promise((resolve) => {
+    setTimeout(resolve, ms);
+});
+/**
+ * Calculates the delay for exponential backoff with jitter
+ */
+export const calculateBackoff = (attempt, config) => {
+    const exponentialDelay = config.baseDelay * 2 ** attempt;
+    const clampedDelay = Math.min(exponentialDelay, config.maxDelay);
+    // Add jitter
+    const jitter = config.jitter ?? 0;
+    if (jitter > 0) {
+        const jitterAmount = clampedDelay * jitter;
+        return clampedDelay + (Math.random() * 2 - 1) * jitterAmount;
+    }
+    return clampedDelay;
+};
+/**
+ * Retries an async function with exponential backoff
+ */
+export const retryWithBackoff = async (fn, config = DEFAULT_RETRY_CONFIG, shouldRetry = () => true) => {
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= config.maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            const backoffDelay = calculateBackoff(attempt, config);
+            await delay(backoffDelay);
+        }
+    }
+    // oxlint-disable-next-line no-throw-literal
+    throw lastError;
+};
+/**
+ * Creates an AbortController with a timeout
+ */
+const createTimeoutController = (timeoutMs) => {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(new Error(`Request timed out after ${timeoutMs}ms`)), timeoutMs);
+    return {
+        cleanup: () => clearTimeout(timeoutId),
+        controller,
+    };
+};
+/**
+ * Wraps a fetch call with timeout support
+ */
+const fetchWithTimeout = async (url, options, timeoutMs) => {
+    const { controller, cleanup } = createTimeoutController(timeoutMs);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    finally {
+        cleanup();
+    }
+};
+/**
+ * Builds request headers with auth token, accept, content-type, and custom headers
+ */
+export const buildRequestHeaders = (opts) => {
+    const result = {};
+    if (opts.accept) {
+        result.Accept = opts.accept;
+    }
+    if (opts.contentType) {
+        result["Content-Type"] = opts.contentType;
+    }
+    if (opts.headers) {
+        Object.assign(result, opts.headers);
+    }
+    if (opts.token) {
+        result.Authorization = `Bearer ${opts.token}`;
+    }
+    return result;
+};
+/**
+ * HTTP error with status code for robust error classification
+ */
+export class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.name = "HttpError";
+        this.status = status;
+    }
+}
+/**
+ * Fetches a URL with optional timeout and checks for a successful response
+ */
+export const fetchChecked = async (url, init, timeoutMs, errorPrefix) => {
+    const res = timeoutMs
+        ? await fetchWithTimeout(url, init, timeoutMs)
+        : await fetch(url, init);
+    if (!res.ok) {
+        const text = await res.text();
+        throw new HttpError(res.status, `${errorPrefix}: ${res.status} ${text}`);
+    }
+    return res;
+};
+/**
+ * Checks if an error is a network error
+ */
+export const isNetworkError = (error) => {
+    if (error instanceof Error) {
+        return (error.name === "TypeError" ||
+            error.message.includes("network") ||
+            error.message.includes("fetch") ||
+            error.message.includes("ECONNREFUSED") ||
+            error.message.includes("ETIMEDOUT") ||
+            error.message.includes("ENETUNREACH"));
+    }
+    return false;
+};
+/**
+ * Checks if an error is a timeout error
+ */
+export const isTimeoutError = (error) => {
+    if (error instanceof Error) {
+        return (error.name === "AbortError" ||
+            error.message.includes("timeout") ||
+            error.message.includes("aborted"));
+    }
+    return false;
+};
+const RETRYABLE_STATUS_RE = /\b(500|502|503|504|429)\b/;
+/**
+ * Checks if an error is retryable
+ */
+export const isRetryableError = (error) => {
+    if (isNetworkError(error) || isTimeoutError(error)) {
+        return true;
+    }
+    if (error instanceof HttpError) {
+        return error.status >= 500 || error.status === 429;
+    }
+    // Fallback: string matching for errors not thrown by fetchChecked
+    if (error instanceof Error && RETRYABLE_STATUS_RE.test(error.message)) {
+        return true;
+    }
+    return false;
+};
+const SYNC_ID_RE = /^\d+$/;
+/**
+ * Validates a string-encoded sync ID.
+ */
+export const parseSyncId = (value, fieldName = "syncId") => {
+    if (typeof value !== "string") {
+        throw new TypeError(`${fieldName} must be a string`);
+    }
+    if (!SYNC_ID_RE.test(value)) {
+        throw new TypeError(`${fieldName} must be a string-encoded integer`);
+    }
+    return value;
+};
+/**
+ * Resolves an auth token, falling back to refreshToken if available
+ */
+export const resolveAuthToken = async (auth) => {
+    let token = await auth.getAccessToken();
+    if (!token && auth.refreshToken) {
+        token = await auth.refreshToken();
+    }
+    return token;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/websocket.d.ts

@@ -0,0 +1,75 @@
+import type { ConnectionState, DeltaSubscription, SubscribeOptions } from "@stratasync/core";
+import type { AuthProvider, RetryConfig } from "./types.js";
+/**
+ * WebSocket connection manager for delta streaming
+ */
+export declare class WebSocketManager {
+    private socket;
+    private connectPromise;
+    private readonly wsEndpoint;
+    private readonly auth;
+    private readonly webSocketFactory;
+    private connectionState;
+    private readonly stateListeners;
+    private subscribedReady;
+    private readonly subscribeStateListeners;
+    private readonly subscriptions;
+    private readonly yjsMessageCallbacks;
+    private readonly pendingMessages;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private subscribeRetryAttempts;
+    private subscribeRetryTimer;
+    private readonly retryConfig;
+    private shouldReconnect;
+    constructor(wsEndpoint: string, auth: AuthProvider, retryConfig: RetryConfig, webSocketFactory?: typeof WebSocket);
+    /**
+     * Connects to the WebSocket server
+     */
+    connect(): Promise<void>;
+    /**
+     * Subscribes to delta updates
+     */
+    subscribe(options: SubscribeOptions): DeltaSubscription;
+    /**
+     * Gets the current connection state
+     */
+    getConnectionState(): ConnectionState;
+    /**
+     * Registers a callback for connection state changes
+     */
+    onConnectionStateChange(callback: (state: ConnectionState) => void): () => void;
+    /**
+     * Gets whether the server has acknowledged subscriptions for this socket.
+     */
+    isSubscribedReady(): boolean;
+    /**
+     * Registers a callback for subscription-readiness changes.
+     */
+    onSubscribeStateChange(callback: (ready: boolean) => void): () => void;
+    /**
+     * Registers a callback for Yjs/live-editing messages.
+     */
+    onYjsMessage(callback: (message: unknown) => void): () => void;
+    /**
+     * Sends a raw payload over the WebSocket (queues until subscribed).
+     */
+    sendRaw(payload: string): void;
+    /**
+     * Closes the WebSocket connection
+     */
+    close(): Promise<void>;
+    private setConnectionState;
+    private setSubscribedReady;
+    private scheduleReconnect;
+    private scheduleSubscribeRetry;
+    private flushSubscriptions;
+    private flushPendingMessages;
+    private sendSubscribe;
+    private handleMessage;
+    private emitYjsMessage;
+    private static isLiveEditingMessage;
+    private static isSubscribedAckMessage;
+    private static isSubscribeErrorMessage;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAW5D;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAEpC;IACJ,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyC;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAChD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,sBAAsB,CAAK;IACnC,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,eAAe,CAAQ;gBAG7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,WAAW,EACxB,gBAAgB,CAAC,EAAE,OAAO,SAAS;IAYrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmF9B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB;IAkEvD;;OAEG;IACH,kBAAkB,IAAI,eAAe;IAIrC;;OAEG;IACH,uBAAuB,CAErB,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GACzC,MAAM,IAAI;IAOb;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IAEH,sBAAsB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAStE;;OAEG;IAEH,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAO9D;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAa9B;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBtB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,sBAAsB;YAwChB,kBAAkB;IAUhC,OAAO,CAAC,oBAAoB;YAsCd,aAAa;YAwCb,aAAa;IA4D3B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkBnC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAQrC,OAAO,CAAC,MAAM,CAAC,uBAAuB;CAMvC"}