@stratasync/transport-graphql 0.2.0

package/dist/mutations.d.ts

@@ -0,0 +1,33 @@
+import type { MutateResult, TransactionBatch } from "@stratasync/core";
+import type { AuthProvider, GraphQLMutationBuilder, RetryConfig } from "./types.js";
+export interface SendRestMutationsOptions {
+    endpoint: string;
+    batch: TransactionBatch;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+}
+/**
+ * Sends mutations via REST endpoint (no GraphQL)
+ * Used when no mutationBuilder is configured
+ */
+export declare const sendRestMutations: (opts: SendRestMutationsOptions) => Promise<MutateResult>;
+export interface SendMutationsOptions {
+    endpoint: string;
+    batch: TransactionBatch;
+    auth: AuthProvider;
+    headers?: Record<string, string>;
+    retryConfig?: RetryConfig;
+    timeoutMs?: number;
+    mutationBuilder: GraphQLMutationBuilder;
+}
+/**
+ * Sends a batch of mutations to the server via GraphQL
+ */
+export declare const sendMutations: (opts: SendMutationsOptions) => Promise<MutateResult>;
+/**
+ * Checks if an error indicates auth failure
+ */
+export declare const isAuthError: (error: unknown) => boolean;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../src/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEZ,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EACV,YAAY,EAEZ,sBAAsB,EAEtB,WAAW,EACZ,MAAM,YAAY,CAAC;AAwMpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;IACxB,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;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,wBAAwB,KAC7B,OAAO,CAAC,YAAY,CAoEtB,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;IACxB,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;IACnB,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,MAAM,oBAAoB,KACzB,OAAO,CAAC,YAAY,CAyCtB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,OAU5C,CAAC"}

package/dist/mutations.js

@@ -0,0 +1,225 @@
+import { maxSyncId, ZERO_SYNC_ID } from "@stratasync/core";
+import { buildRequestHeaders, fetchChecked, isRetryableError, parseSyncId, resolveAuthToken, retryWithBackoff, } from "./utils.js";
+/**
+ * Maps internal action codes to GraphQL action names
+ */
+const mapActionToGraphQL = (action) => {
+    const mapping = {
+        A: "ARCHIVE",
+        D: "DELETE",
+        I: "INSERT",
+        U: "UPDATE",
+        V: "UNARCHIVE",
+    };
+    return mapping[action] ?? action;
+};
+const mergeInto = (target, source, label) => {
+    if (!source) {
+        return;
+    }
+    for (const [key, value] of Object.entries(source)) {
+        if (key in target) {
+            throw new Error(`Duplicate GraphQL ${label}: ${key}`);
+        }
+        target[key] = value;
+    }
+};
+const buildMutationPayload = (batch, mutationBuilder) => {
+    const mutationSpecs = batch.transactions.map((tx, index) => mutationBuilder(tx, index));
+    const aliasMap = new Map();
+    const fields = [];
+    const variables = {};
+    const variableTypes = {};
+    for (const [index, spec] of mutationSpecs.entries()) {
+        const alias = `t${index}`;
+        const tx = batch.transactions[index];
+        if (!tx) {
+            continue;
+        }
+        aliasMap.set(alias, tx.clientTxId);
+        fields.push(`${alias}: ${spec.mutation}`);
+        mergeInto(variables, spec.variables, "variable");
+        mergeInto(variableTypes, spec.variableTypes, "variable type");
+    }
+    const variableDefs = Object.entries(variableTypes)
+        .map(([key, type]) => `$${key}: ${type}`)
+        .join(", ");
+    const query = `mutation SyncBatch${variableDefs ? `(${variableDefs})` : ""} { ${fields.join(" ")} }`;
+    return { aliasMap, query, variables };
+};
+const collectGraphQLErrors = (errors) => {
+    const errorsByAlias = new Map();
+    const unscopedErrors = [];
+    if (!errors?.length) {
+        return { errorsByAlias, unscopedErrors };
+    }
+    for (const error of errors) {
+        const pathAlias = error.path?.[0];
+        if (typeof pathAlias === "string") {
+            const existing = errorsByAlias.get(pathAlias) ?? [];
+            existing.push(error.message);
+            errorsByAlias.set(pathAlias, existing);
+        }
+        else {
+            unscopedErrors.push(error.message);
+        }
+    }
+    return { errorsByAlias, unscopedErrors };
+};
+const parseMutationResults = (response, aliasMap) => {
+    if (!response.data) {
+        throw new Error("No data in mutation response");
+    }
+    const { errorsByAlias, unscopedErrors } = collectGraphQLErrors(response.errors);
+    if (unscopedErrors.length > 0) {
+        throw new Error(`GraphQL errors: ${unscopedErrors.join(", ")}`);
+    }
+    const results = [];
+    let lastSyncId = ZERO_SYNC_ID;
+    let success = true;
+    for (const [alias, clientTxId] of aliasMap.entries()) {
+        const aliasErrors = errorsByAlias.get(alias);
+        if (aliasErrors) {
+            results.push({
+                clientTxId,
+                error: aliasErrors.join(", "),
+                success: false,
+            });
+            success = false;
+            continue;
+        }
+        const payload = response.data[alias];
+        if (!payload || typeof payload !== "object") {
+            results.push({
+                clientTxId,
+                error: "Missing mutation response",
+                success: false,
+            });
+            success = false;
+            continue;
+        }
+        const payloadRecord = payload;
+        if (payloadRecord.success === false) {
+            results.push({
+                clientTxId,
+                error: typeof payloadRecord.error === "string"
+                    ? payloadRecord.error
+                    : "Mutation failed",
+                success: false,
+            });
+            success = false;
+            continue;
+        }
+        const syncIdRaw = payloadRecord.syncId;
+        const syncId = syncIdRaw === undefined
+            ? undefined
+            : parseSyncId(syncIdRaw, `Mutation response ${alias} syncId`);
+        if (syncId !== undefined) {
+            lastSyncId = maxSyncId(lastSyncId, syncId);
+        }
+        results.push({
+            clientTxId,
+            success: true,
+            ...(syncId !== undefined && { syncId }),
+        });
+    }
+    return {
+        lastSyncId,
+        results,
+        success,
+    };
+};
+/**
+ * Sends mutations via REST endpoint (no GraphQL)
+ * Used when no mutationBuilder is configured
+ */
+export const sendRestMutations = async (opts) => {
+    if (opts.batch.transactions.length === 0) {
+        return {
+            lastSyncId: ZERO_SYNC_ID,
+            results: [],
+            success: true,
+        };
+    }
+    const response = await retryWithBackoff(async () => {
+        const token = await resolveAuthToken(opts.auth);
+        const requestHeaders = buildRequestHeaders({
+            contentType: "application/json",
+            headers: opts.headers,
+            token,
+        });
+        const body = JSON.stringify({
+            batchId: opts.batch.batchId,
+            transactions: opts.batch.transactions.map((tx) => ({
+                action: mapActionToGraphQL(tx.action),
+                clientId: tx.clientId,
+                clientTxId: tx.clientTxId,
+                modelId: tx.modelId,
+                modelName: tx.modelName,
+                payload: tx.action === "D" && tx.original
+                    ? { ...tx.original, ...tx.payload }
+                    : tx.payload,
+            })),
+        });
+        const res = await fetchChecked(opts.endpoint, { body, headers: requestHeaders, method: "POST" }, opts.timeoutMs, "Mutation failed");
+        return res.json();
+    }, opts.retryConfig, isRetryableError);
+    return {
+        lastSyncId: parseSyncId(response.lastSyncId, "Mutation response lastSyncId"),
+        results: response.results.map((r) => {
+            const result = {
+                clientTxId: r.clientTxId,
+                success: r.success,
+            };
+            if (r.syncId !== undefined) {
+                result.syncId = parseSyncId(r.syncId, `Mutation response result ${r.clientTxId} syncId`);
+            }
+            if (r.error !== undefined) {
+                result.error = r.error;
+            }
+            return result;
+        }),
+        success: response.success,
+    };
+};
+/**
+ * Sends a batch of mutations to the server via GraphQL
+ */
+export const sendMutations = async (opts) => {
+    if (opts.batch.transactions.length === 0) {
+        return {
+            lastSyncId: ZERO_SYNC_ID,
+            results: [],
+            success: true,
+        };
+    }
+    const { aliasMap, query, variables } = buildMutationPayload(opts.batch, opts.mutationBuilder);
+    const response = await retryWithBackoff(async () => {
+        const token = await resolveAuthToken(opts.auth);
+        const requestHeaders = buildRequestHeaders({
+            contentType: "application/json",
+            headers: opts.headers,
+            token,
+        });
+        const body = JSON.stringify({
+            query,
+            variables,
+        });
+        const res = await fetchChecked(opts.endpoint, { body, headers: requestHeaders, method: "POST" }, opts.timeoutMs, "Mutation failed");
+        return res.json();
+    }, opts.retryConfig, isRetryableError);
+    return parseMutationResults(response, aliasMap);
+};
+/**
+ * Checks if an error indicates auth failure
+ */
+export const isAuthError = (error) => {
+    if (error instanceof Error) {
+        return (error.message.includes("401") ||
+            error.message.includes("403") ||
+            error.message.includes("Unauthorized") ||
+            error.message.includes("Forbidden"));
+    }
+    return false;
+};
+//# sourceMappingURL=mutations.js.map

package/dist/mutations.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,14 @@
+import type { DeltaPacket } from "@stratasync/core";
+/**
+ * Normalizes a sync endpoint to its base path (e.g., /sync)
+ */
+export declare const normalizeSyncEndpoint: (endpoint: string) => string;
+/**
+ * Joins a base URL with a path segment
+ */
+export declare const joinSyncUrl: (base: string, path: string) => string;
+/**
+ * Parses a raw delta packet payload into a DeltaPacket
+ */
+export declare const parseDeltaPacket: (raw: unknown) => DeltaPacket | null;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,kBAAkB,CAAC;AAQ1B;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAQxD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,MAIxD,CAAC;AAsFF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,KAAG,WAAW,GAAG,IAgE7D,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,144 @@
+import { maxSyncId, ZERO_SYNC_ID } from "@stratasync/core";
+import { parseSyncId } from "./utils.js";
+const SYNC_ENDPOINT_SUFFIXES = ["/bootstrap", "/batch", "/deltas"];
+const TRAILING_SLASH_RE = /\/+$/;
+/**
+ * Normalizes a sync endpoint to its base path (e.g., /sync)
+ */
+export const normalizeSyncEndpoint = (endpoint) => {
+    const trimmed = endpoint.replace(TRAILING_SLASH_RE, "");
+    for (const suffix of SYNC_ENDPOINT_SUFFIXES) {
+        if (trimmed.endsWith(suffix)) {
+            return trimmed.slice(0, -suffix.length);
+        }
+    }
+    return trimmed;
+};
+/**
+ * Joins a base URL with a path segment
+ */
+export const joinSyncUrl = (base, path) => {
+    const normalizedBase = base.replace(TRAILING_SLASH_RE, "");
+    const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+    return `${normalizedBase}${normalizedPath}`;
+};
+/**
+ * Maps action strings to internal action codes
+ */
+const normalizeAction = (action) => {
+    if (action === "I" ||
+        action === "U" ||
+        action === "D" ||
+        action === "A" ||
+        action === "V" ||
+        action === "C" ||
+        action === "G" ||
+        action === "S") {
+        return action;
+    }
+    throw new Error(`Unknown action: ${action}`);
+};
+/**
+ * Parses a raw sync action payload into a SyncAction
+ */
+const parseSyncAction = (raw) => {
+    const syncIdRaw = raw.syncId ?? raw.id;
+    if (syncIdRaw === undefined) {
+        throw new TypeError("Sync action is missing syncId/id");
+    }
+    const parsedSyncId = parseSyncId(syncIdRaw, "Sync action syncId/id");
+    const { modelName } = raw;
+    if (typeof modelName !== "string") {
+        throw new TypeError("Sync action is missing modelName");
+    }
+    const { modelId } = raw;
+    if (typeof modelId !== "string") {
+        throw new TypeError("Sync action is missing modelId");
+    }
+    const actionRaw = raw.action;
+    if (typeof actionRaw !== "string") {
+        throw new TypeError("Sync action is missing action");
+    }
+    const createdAtRaw = raw.createdAt;
+    let createdAt;
+    if (typeof createdAtRaw === "string" || typeof createdAtRaw === "number") {
+        createdAt = new Date(createdAtRaw);
+    }
+    const groupsRaw = raw.groups;
+    const groups = Array.isArray(groupsRaw)
+        ? groupsRaw.filter((group) => typeof group === "string")
+        : undefined;
+    const groupId = typeof raw.groupId === "string" ? raw.groupId : undefined;
+    const result = {
+        action: normalizeAction(actionRaw),
+        data: raw.data ?? {},
+        id: parsedSyncId,
+        modelId,
+        modelName,
+    };
+    if (groupId !== undefined) {
+        result.groupId = groupId;
+    }
+    if (groups !== undefined) {
+        result.groups = groups;
+    }
+    if (typeof raw.clientTxId === "string") {
+        result.clientTxId = raw.clientTxId;
+    }
+    if (typeof raw.clientId === "string") {
+        result.clientId = raw.clientId;
+    }
+    if (createdAt !== undefined) {
+        result.createdAt = createdAt;
+    }
+    return result;
+};
+/**
+ * Parses a raw delta packet payload into a DeltaPacket
+ */
+export const parseDeltaPacket = (raw) => {
+    if (Array.isArray(raw)) {
+        const actions = raw
+            .filter((item) => typeof item === "object" && item !== null)
+            .map((item) => parseSyncAction(item));
+        // oxlint-disable-next-line no-array-reduce
+        const lastSyncId = actions.reduce((max, action) => maxSyncId(max, action.id), ZERO_SYNC_ID);
+        return { actions, lastSyncId };
+    }
+    if (typeof raw !== "object" || raw === null) {
+        return null;
+    }
+    const payload = raw;
+    if (payload.type === "delta" &&
+        payload.packet &&
+        typeof payload.packet === "object") {
+        return parseDeltaPacket(payload.packet);
+    }
+    if (Array.isArray(payload.actions)) {
+        const actions = payload.actions.map((action) => parseSyncAction(action));
+        const lastSyncIdRaw = payload.lastSyncId;
+        const lastSyncId = 
+        // oxlint-disable-next-line no-array-reduce
+        lastSyncIdRaw === undefined
+            ? // oxlint-disable-next-line no-array-reduce
+                actions.reduce((max, action) => maxSyncId(max, action.id), ZERO_SYNC_ID)
+            : parseSyncId(lastSyncIdRaw, "Delta packet lastSyncId");
+        const packet = {
+            actions,
+            lastSyncId,
+        };
+        if (typeof payload.hasMore === "boolean") {
+            packet.hasMore = payload.hasMore;
+        }
+        return packet;
+    }
+    if (payload.action && payload.modelName && payload.modelId) {
+        const action = parseSyncAction(payload);
+        return {
+            actions: [action],
+            lastSyncId: action.id,
+        };
+    }
+    return null;
+};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+import type { Transaction } from "@stratasync/core";
+/**
+ * Authentication provider interface
+ */
+export interface AuthProvider {
+    /** Gets the current access token */
+    getAccessToken(): Promise<string | null>;
+    /** Refreshes the access token */
+    refreshToken?(): Promise<string | null>;
+    /** Called when auth fails */
+    onAuthError?(error: Error): void;
+}
+/**
+ * Transport adapter options
+ */
+export interface TransportOptions {
+    /** GraphQL endpoint URL */
+    endpoint: string;
+    /** Base REST sync endpoint (e.g., https://api.example.com/sync) */
+    syncEndpoint: string;
+    /** WebSocket endpoint for subscriptions */
+    wsEndpoint: string;
+    /** Authentication provider */
+    auth: AuthProvider;
+    /** GraphQL mutation builder */
+    mutationBuilder?: GraphQLMutationBuilder;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+    /** Retry configuration */
+    retry?: RetryConfig;
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Custom WebSocket implementation (for non-browser environments) */
+    webSocketFactory?: typeof WebSocket;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of retries */
+    maxRetries: number;
+    /** Base delay in milliseconds */
+    baseDelay: number;
+    /** Maximum delay in milliseconds */
+    maxDelay: number;
+    /** Jitter factor (0-1) */
+    jitter?: number;
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * GraphQL error structure
+ */
+export interface GraphQLError {
+    message: string;
+    locations?: {
+        line: number;
+        column: number;
+    }[];
+    path?: (string | number)[];
+    extensions?: {
+        code?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * GraphQL response structure
+ */
+export interface GraphQLResponse<T> {
+    data?: T;
+    errors?: GraphQLError[];
+}
+/**
+ * GraphQL mutation specification for a single transaction
+ */
+export interface GraphQLMutationSpec {
+    /** GraphQL field invocation (e.g. taskUpdate(...){ syncId }) */
+    mutation: string;
+    /** Variables used by the mutation */
+    variables?: Record<string, unknown>;
+    /** GraphQL variable types */
+    variableTypes?: Record<string, string>;
+}
+/**
+ * Builds a GraphQL mutation for a transaction
+ */
+export type GraphQLMutationBuilder = (transaction: Transaction, index: number) => GraphQLMutationSpec;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,iCAAiC;IACjC,YAAY,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,6BAA6B;IAC7B,WAAW,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,YAAY,CAAC;IACnB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,KACV,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    baseDelay: 1000,
+    jitter: 0.2,
+    maxDelay: 30_000,
+    maxRetries: 3,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoDA;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,SAAS,EAAE,IAAI;IACf,MAAM,EAAE,GAAG;IACX,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,CAAC;CACd,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,52 @@
+import type { AuthProvider, RetryConfig } from "./types.js";
+/**
+ * Calculates the delay for exponential backoff with jitter
+ */
+export declare const calculateBackoff: (attempt: number, config: RetryConfig) => number;
+/**
+ * Retries an async function with exponential backoff
+ */
+export declare const retryWithBackoff: <T>(fn: () => Promise<T>, config?: RetryConfig, shouldRetry?: (error: unknown) => boolean) => Promise<T>;
+interface RequestHeaderOptions {
+    token: string | null;
+    headers?: Record<string, string>;
+    accept?: string;
+    contentType?: string;
+}
+/**
+ * Builds request headers with auth token, accept, content-type, and custom headers
+ */
+export declare const buildRequestHeaders: (opts: RequestHeaderOptions) => Record<string, string>;
+/**
+ * HTTP error with status code for robust error classification
+ */
+export declare class HttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+/**
+ * Fetches a URL with optional timeout and checks for a successful response
+ */
+export declare const fetchChecked: (url: string, init: RequestInit, timeoutMs: number | undefined, errorPrefix: string) => Promise<Response>;
+/**
+ * Checks if an error is a network error
+ */
+export declare const isNetworkError: (error: unknown) => boolean;
+/**
+ * Checks if an error is a timeout error
+ */
+export declare const isTimeoutError: (error: unknown) => boolean;
+/**
+ * Checks if an error is retryable
+ */
+export declare const isRetryableError: (error: unknown) => boolean;
+/**
+ * Validates a string-encoded sync ID.
+ */
+export declare const parseSyncId: (value: unknown, fieldName?: string) => string;
+/**
+ * Resolves an auth token, falling back to refreshToken if available
+ */
+export declare const resolveAuthToken: (auth: AuthProvider) => Promise<string | null>;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY5D;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,QAAQ,WAAW,KAClB,MAYF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAU,CAAC,EACtC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,SAAQ,WAAkC,EAC1C,cAAa,CAAC,KAAK,EAAE,OAAO,KAAK,OAAoB,KACpD,OAAO,CAAC,CAAC,CAoBX,CAAC;AA4CF,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,MAAM,oBAAoB,KACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBvB,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,EACX,MAAM,WAAW,EACjB,WAAW,MAAM,GAAG,SAAS,EAC7B,aAAa,MAAM,KAClB,OAAO,CAAC,QAAQ,CAWlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAY/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAS/C,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,OAejD,CAAC;AAIF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,kBAAoB,KAAG,MAUlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,YAAY,KACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAMvB,CAAC"}