use-abcd 1.4.2 → 1.6.0

package/dist/sync-queue.d.ts

@@ -1,23 +1,21 @@
-import { Change, SyncQueueState, SyncResult, IdMapping } from './types';
-export type SyncQueueConfig<T> = {
+import { Change, SyncQueueState, SyncResponse } from './types';
+export type SyncQueueConfig<T, C = unknown> = {
     debounce: number;
     maxRetries: number;
-    /**
-     * Maximum number of changes to send per sync call.
-     * Useful for rate limiting or API constraints.
-     * Default: Infinity (send all queued changes)
-     */
     batchSize?: number;
-    onSync: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncResult[]>;
-    onIdRemap?: (mappings: IdMapping[]) => void;
+    getContext?: () => C;
+    onSync: (changes: Change<T>[], context: C, signal: AbortSignal) => Promise<SyncResponse<T>>;
+    onServerItems?: (items: T[]) => void;
 };
-export declare class SyncQueue<T> {
+export declare class SyncQueue<T extends {
+    id: string;
+}, C = unknown> {
     private _config;
     private _state;
     private _subscribers;
     private _debounceTimer;
     private _abortController;
-    constructor(config: SyncQueueConfig<T>);
+    constructor(config: SyncQueueConfig<T, C>);
     enqueue(change: Change<T>): void;
     pause(): void;
     resume(): void;
@@ -30,37 +28,7 @@ export declare class SyncQueue<T> {
     private _updateState;
     private _scheduleFlush;
     private _clearTimer;
-    /**
-     * Flush pending changes to the server.
-     *
-     * Flow:
-     * 1. Move queued items to inFlight (atomic swap prevents duplicate sends)
-     * 2. Flatten all changes and optionally batch by batchSize
-     * 3. Send to server via onSync callback
-     * 4. Process results (handle success, retries, ID remapping)
-     * 5. Schedule next flush if more items queued
-     */
     private _flush;
-    /**
-     * Process sync results and update state accordingly.
-     *
-     * For each item in flight:
-     * - If ALL operations succeeded: clear errors, collect ID remappings
-     * - If ANY operation failed: increment retry counter, re-queue if under maxRetries
-     *
-     * ID Remapping: When server assigns new IDs to created items (e.g., temp ID -> DB ID),
-     * we collect these mappings and notify via onIdRemap callback so the collection
-     * can update its local state.
-     */
-    private _processResults;
-    /**
-     * Handle network or unexpected errors during sync.
-     *
-     * Two scenarios:
-     * 1. Aborted (e.g., SyncQueue destroyed): Re-queue all items without incrementing retries
-     * 2. Actual error: Increment retries, re-queue if under limit, record error
-     *
-     * This ensures no data loss - failed operations are preserved for retry.
-     */
+    private _processResponse;
     private _handleError;
 }

package/dist/types.d.ts

@@ -3,9 +3,17 @@ export type PlainObject = {
     [key: string]: JsonValue | PlainObject | JsonValue[] | PlainObject[];
 };
 export type Result = {
+    id: string;
+    type: ChangeType;
     status: "success" | "error";
+    serverSyncedAt: string;
     error?: string;
 };
+export type SyncResponse<T> = {
+    items?: T[];
+    syncResults?: Result[];
+    serverSyncedAt: string;
+};
 export type Fn<A, R = void> = (arg: A) => R;
 export type Mutator<T> = (draft: T) => void;
 export type SyncState = "idle" | "fetching" | "syncing";
@@ -22,34 +30,31 @@ export type ItemStatus = {
     retries: number;
     error?: string;
 } | null;
-export type SyncResult = {
-    id: string;
-    status: "success" | "error";
-    error?: string;
-    newId?: string;
-};
-export type IdMapping = {
-    tempId: string;
-    newId: string;
-};
 export type SyncError<T> = {
     error: string;
     retries: number;
-    operations: Change<T>[];
+    operation: Change<T>;
 };
 export type SyncQueueState<T> = {
-    queue: Map<string, Change<T>[]>;
-    inFlight: Map<string, Change<T>[]>;
+    queue: Map<string, Change<T>>;
+    inFlight: Map<string, Change<T>>;
     errors: Map<string, SyncError<T>>;
     isPaused: boolean;
     isSyncing: boolean;
 };
 export type FetchState = "idle" | "fetching" | "error";
-export type Config<T extends object, C> = {
+export type CrudHandler<T extends {
+    id: string;
+}, C> = (params: {
+    query?: C;
+    changes?: Change<T>[];
+}, signal?: AbortSignal) => Promise<SyncResponse<T>>;
+export type Config<T extends {
+    id: string;
+}, C> = {
     id: string;
     initialContext: C;
-    getId: (item: T) => string;
-    setId?: (item: T, newId: string) => T;
+    serverItems?: T[];
     syncDebounce?: number;
     syncRetries?: number;
     refetchOnMutation?: boolean;
@@ -59,6 +64,5 @@ export type Config<T extends object, C> = {
     rootId?: string;
     getNodeId?: () => string;
     nodeSeparator?: string;
-    onFetch: (context: C, signal: AbortSignal) => Promise<T[]>;
-    onSync?: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncResult[]>;
+    handler?: CrudHandler<T, C>;
 };

package/dist/useCrud.d.ts

@@ -1,7 +1,9 @@
 import { Draft } from 'mutative';
 import { Config, Mutator } from './types';
-export type { Config, Change, SyncResult, ItemStatus, SyncQueueState, SyncState, ChangeType, ItemSyncStatus, FetchState, } from './types';
-export declare function useCrud<T extends object, C>(config: Config<T, C>): {
+export type { Config, CrudHandler, Change, Result, ItemStatus, SyncQueueState, SyncState, ChangeType, ItemSyncStatus, FetchState, } from './types';
+export declare function useCrud<T extends {
+    id: string;
+}, C>(config: Config<T, C>): {
     items: Map<string, T>;
     context: C;
     syncState: import('./types').SyncState;
@@ -10,7 +12,7 @@ export declare function useCrud<T extends object, C>(config: Config<T, C>): {
     syncing: boolean;
     fetchStatus: import('./types').FetchState;
     fetchError: string;
-    create: (item: T) => void;
+    create: (item: Omit<T, "id">) => string;
     update: (id: string, mutate: (draft: Draft<T>) => void) => void;
     remove: (id: string) => void;
     getItem: (id: string) => import('./item').Item<T, C>;

package/dist/useCrudTree.d.ts

@@ -16,7 +16,7 @@ export type TreeConfig<T extends object, C, NodeType = string> = Omit<Config<Tre
  * @returns Object with crud operations, state, and the root node
  */
 export declare function useCrudTree<T extends object, C, NodeType = string>(config: TreeConfig<T, C, NodeType>): {
-    rootNode: Node<T, C, NodeType>;
+    rootNode: any;
     items: Map<string, TreeNode<T, NodeType>>;
     context: C;
     syncState: import('./types').SyncState;
@@ -39,7 +39,7 @@ export declare function useCrudTree<T extends object, C, NodeType = string>(conf
     retrySync: (id?: string) => void;
     selectNode: (id: string) => void;
     deselectNode: () => void;
-    selectedNodeId: string;
-    selectedNode: Node<T, C, NodeType>;
+    selectedNodeId: any;
+    selectedNode: any;
     toJson: () => object;
 };

package/dist/useItem.d.ts

@@ -8,4 +8,6 @@ export type UseItemResult<T> = {
     remove: () => void;
     exists: boolean;
 };
-export declare function useItem<T extends object, C>(item: Item<T, C>): UseItemResult<T>;
+export declare function useItem<T extends {
+    id: string;
+}, C>(item: Item<T, C>): UseItemResult<T>;

package/dist/useNode.d.ts

@@ -16,6 +16,9 @@ export type UseNodeResult<T extends object, C, NodeType = string> = {
     append: (value: T, type?: NodeType) => string;
     prepend: (value: T, type?: NodeType) => string;
     move: (targetPosition: number, targetParent?: Node<T, C, NodeType>) => void;
+    moveUp: () => void;
+    moveDown: () => void;
+    setPosition: (targetIndex: number) => void;
     clone: () => Map<string, TreeNode<T, NodeType>>;
     updateProp: (mutate: (draft: Draft<T>) => void) => void;
     remove: () => void;

package/dist/useSyncState.d.ts

@@ -2,8 +2,8 @@ import { SyncState, Change, SyncError } from './types';
 export type UseSyncStateResult<T = unknown> = {
     syncState: SyncState;
     syncing: boolean;
-    queue: Map<string, Change<T>[]>;
-    inFlight: Map<string, Change<T>[]>;
+    queue: Map<string, Change<T>>;
+    inFlight: Map<string, Change<T>>;
     errors: Map<string, SyncError<T>>;
     isPaused: boolean;
     isSyncing: boolean;

package/dist/utils.d.ts

@@ -1,4 +1,3 @@
-export declare const CANCEL_RECOVERABLE = "CANCEL_RECOVERABLE";
-export declare const CANCELLED_BY_USER = "CANCELLED_BY_USER";
-export declare const useMemoDeepEquals: <T>(value: T) => T;
-export declare function wait(ms: number, signal: AbortSignal, onAbort?: () => void): Promise<unknown>;
+export declare function getTimeFromId(id: string): number;
+export declare function getIdFromTime(time?: number): string;
+export declare function compareTimeIds(a: string, b: string): -1 | 0 | 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-abcd",
-  "version": "1.4.2",
+  "version": "1.6.0",
   "description": "Simple react hook for CRUD type apps",
   "repository": {
     "url": "https://github.com/smtrd3/use-abcd"
@@ -37,9 +37,11 @@
     "test:cov": "vitest run --coverage"
   },
   "dependencies": {
+    "fake-indexeddb": "^6.2.5",
+    "idb": "^8.0.3",
     "lodash-es": "^4.17.21",
     "mutative": "^1.2.0",
-    "nanoid": "^5.1.5"
+    "ulid": "^2.3.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.33.0",

package/dist/cache.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/chunks/client-DReyDQ23.js

@@ -1,144 +0,0 @@
-import { c as f } from "./types-Dy4rYb2N.js";
-function l() {
-  return {
-    create: {
-      guard: (r) => !!r.create,
-      execute: (r, e, s) => e.create(r.data, s),
-      toResult: (r, e) => e.success === !0 ? { id: r.id, status: "success", newId: e.newId } : { id: r.id, status: "error", error: e.error }
-    },
-    update: {
-      guard: (r) => !!r.update,
-      execute: (r, e, s) => e.update(r.id, r.data, s),
-      toResult: (r, e) => e.success === !0 ? { id: r.id, status: "success" } : { id: r.id, status: "error", error: e.error }
-    },
-    delete: {
-      guard: (r) => !!r.delete,
-      execute: (r, e, s) => e.delete(r.id, r.data, s),
-      toResult: (r, e) => e.success === !0 ? { id: r.id, status: "success" } : { id: r.id, status: "error", error: e.error }
-    }
-  };
-}
-async function w(r, e, s) {
-  if (s.aborted)
-    return { id: r.id, status: "error", error: "Operation aborted" };
-  const a = l()[r.type];
-  if (!a)
-    return { id: r.id, status: "error", error: `Unknown change type: ${r.type}` };
-  if (!a.guard(e))
-    return { id: r.id, status: "success" };
-  try {
-    const t = await a.execute(r, e, s);
-    return a.toResult(r, t);
-  } catch (t) {
-    return {
-      id: r.id,
-      status: "error",
-      error: t instanceof Error ? t.message : "Unknown error"
-    };
-  }
-}
-function m(r) {
-  return {
-    onSync: async (s, c) => Promise.all(s.map((a) => w(a, r, c))),
-    handlers: { create: r.create, update: r.update, delete: r.delete }
-  };
-}
-function E(r) {
-  const { onSync: e, handlers: s } = m(r);
-  return { onSync: e, onSyncWithStats: async (a, t) => {
-    const o = await e(a, t);
-    return f(o);
-  }, handlers: s };
-}
-function b(r) {
-  return { success: !0, ...r };
-}
-function h(r) {
-  return { success: !1, error: r };
-}
-function O(r) {
-  const e = typeof r == "string" ? r : r.endpoint, s = typeof r == "string" ? {} : r.headers ?? {}, c = typeof r == "string" ? void 0 : r.scope;
-  return { onFetch: async (o, u) => {
-    if (u.aborted)
-      throw new Error("Operation aborted");
-    try {
-      const n = { scope: c, query: o }, i = await fetch(e, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", ...s },
-        body: JSON.stringify(n),
-        signal: u
-      });
-      if (!i.ok) {
-        let d = "Fetch request failed";
-        try {
-          const y = await i.json();
-          y.error && (d = y.error);
-        } catch {
-        }
-        throw new Error(d);
-      }
-      return (await i.json()).results ?? [];
-    } catch (n) {
-      throw n instanceof Error && n.name === "AbortError" ? new Error("Operation aborted") : n;
-    }
-  }, onSync: async (o, u) => {
-    if (u.aborted)
-      return o.map((n) => ({
-        id: n.id,
-        status: "error",
-        error: "Operation aborted"
-      }));
-    try {
-      const n = { scope: c, changes: o }, i = await fetch(e, {
-        method: "POST",
-        headers: { "Content-Type": "application/json", ...s },
-        body: JSON.stringify(n),
-        signal: u
-      });
-      if (!i.ok) {
-        let d = "Sync request failed";
-        try {
-          const y = await i.json();
-          y.error && (d = y.error);
-        } catch {
-        }
-        return o.map((y) => ({ id: y.id, status: "error", error: d }));
-      }
-      return (await i.json()).syncResults ?? o.map((d) => ({
-        id: d.id,
-        status: "error",
-        error: "No sync results returned"
-      }));
-    } catch (n) {
-      const i = n instanceof Error && n.name === "AbortError" ? "Operation aborted" : n instanceof Error ? n.message : "Unknown error";
-      return o.map((p) => ({ id: p.id, status: "error", error: i }));
-    }
-  } };
-}
-async function R(r) {
-  const { fetch: e, parseResponse: s, parseError: c } = r, a = (t) => typeof c == "function" ? c(t) : typeof c == "string" ? c : t instanceof Error ? t.message : "Request failed";
-  try {
-    const t = await e;
-    if (!t.ok) {
-      let o = new Error("Request failed");
-      try {
-        const u = await t.json();
-        u.message ? o = new Error(u.message) : u.error && (o = new Error(u.error));
-      } catch {
-      }
-      return { success: !1, error: a(o) };
-    }
-    return s ? { success: !0, ...await s(t) } : { success: !0 };
-  } catch (t) {
-    return t instanceof Error && t.name === "AbortError" ? { success: !1, error: "Operation aborted" } : { success: !1, error: a(t) };
-  }
-}
-export {
-  E as a,
-  O as b,
-  m as c,
-  h as d,
-  R as f,
-  b as s
-};
-//# sourceMappingURL=client-DReyDQ23.js.map

package/dist/chunks/client-DReyDQ23.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-DReyDQ23.js","sources":["../../src/runtime/client.ts"],"sourcesContent":["import type { Change, SyncResult } from \"../types\";\nimport {\n  type SyncHandlerResult,\n  type SyncBatchResult,\n  type SyncRequestBody,\n  type SyncResponseBody,\n  categorizeResults,\n} from \"./types\";\n\nexport type { SyncHandlerResult, SyncBatchResult };\nexport { categorizeResults };\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type CreateHandler<T> = (data: T, signal: AbortSignal) => Promise<SyncHandlerResult>;\nexport type UpdateHandler<T> = (\n  id: string,\n  data: T,\n  signal: AbortSignal,\n) => Promise<SyncHandlerResult>;\nexport type DeleteHandler<T> = (\n  id: string,\n  data: T,\n  signal: AbortSignal,\n) => Promise<SyncHandlerResult>;\n\nexport type SyncBuilderConfig<T> = {\n  create?: CreateHandler<T>;\n  update?: UpdateHandler<T>;\n  delete?: DeleteHandler<T>;\n};\n\nexport type SyncBuilder<T> = {\n  onSync: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncResult[]>;\n  handlers: {\n    create?: CreateHandler<T>;\n    update?: UpdateHandler<T>;\n    delete?: DeleteHandler<T>;\n  };\n};\n\nexport type FetchToSyncResultOptions = {\n  fetch: Promise<Response>;\n  parseResponse?: (response: Response) => Promise<{ newId?: string }>;\n  parseError?: string | ((error: unknown) => string);\n};\n\n// ============================================================================\n// Change Processing\n// ============================================================================\n\ntype ChangeProcessor<T> = {\n  guard: (config: SyncBuilderConfig<T>) => boolean;\n  execute: (\n    change: Change<T>,\n    config: SyncBuilderConfig<T>,\n    signal: AbortSignal,\n  ) => Promise<SyncHandlerResult>;\n  toResult: (change: Change<T>, result: SyncHandlerResult) => SyncResult;\n};\n\nfunction createChangeProcessors<T>(): Record<string, ChangeProcessor<T>> {\n  return {\n    create: {\n      guard: (config) => !!config.create,\n      execute: (change, config, signal) => config.create!(change.data, signal),\n      toResult: (change, result) =>\n        result.success === true\n          ? { id: change.id, status: \"success\" as const, newId: result.newId }\n          : { id: change.id, status: \"error\" as const, error: result.error },\n    },\n\n    update: {\n      guard: (config) => !!config.update,\n      execute: (change, config, signal) => config.update!(change.id, change.data, signal),\n      toResult: (change, result) =>\n        result.success === true\n          ? { id: change.id, status: \"success\" as const }\n          : { id: change.id, status: \"error\" as const, error: result.error },\n    },\n\n    delete: {\n      guard: (config) => !!config.delete,\n      execute: (change, config, signal) => config.delete!(change.id, change.data, signal),\n      toResult: (change, result) =>\n        result.success === true\n          ? { id: change.id, status: \"success\" as const }\n          : { id: change.id, status: \"error\" as const, error: result.error },\n    },\n  };\n}\n\nasync function processChange<T>(\n  change: Change<T>,\n  config: SyncBuilderConfig<T>,\n  signal: AbortSignal,\n): Promise<SyncResult> {\n  if (signal.aborted) {\n    return { id: change.id, status: \"error\", error: \"Operation aborted\" };\n  }\n\n  const processors = createChangeProcessors<T>();\n  const processor = processors[change.type];\n\n  if (!processor) {\n    return { id: change.id, status: \"error\", error: `Unknown change type: ${change.type}` };\n  }\n\n  // If handler not configured, treat as success (offline-first support)\n  if (!processor.guard(config)) {\n    return { id: change.id, status: \"success\" };\n  }\n\n  try {\n    const result = await processor.execute(change, config, signal);\n    return processor.toResult(change, result);\n  } catch (error) {\n    return {\n      id: change.id,\n      status: \"error\",\n      error: error instanceof Error ? error.message : \"Unknown error\",\n    };\n  }\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\nexport function createSyncClient<T>(config: SyncBuilderConfig<T>): SyncBuilder<T> {\n  const onSync = async (changes: Change<T>[], signal: AbortSignal): Promise<SyncResult[]> => {\n    return Promise.all(changes.map((change) => processChange(change, config, signal)));\n  };\n\n  return {\n    onSync,\n    handlers: { create: config.create, update: config.update, delete: config.delete },\n  };\n}\n\nexport function createSyncClientWithStats<T>(config: SyncBuilderConfig<T>): {\n  onSync: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncResult[]>;\n  onSyncWithStats: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncBatchResult>;\n  handlers: { create?: CreateHandler<T>; update?: UpdateHandler<T>; delete?: DeleteHandler<T> };\n} {\n  const { onSync, handlers } = createSyncClient(config);\n\n  const onSyncWithStats = async (\n    changes: Change<T>[],\n    signal: AbortSignal,\n  ): Promise<SyncBatchResult> => {\n    const results = await onSync(changes, signal);\n    return categorizeResults(results);\n  };\n\n  return { onSync, onSyncWithStats, handlers };\n}\n\nexport function syncSuccess(options?: { newId?: string }): SyncHandlerResult {\n  return { success: true, ...options };\n}\n\nexport function syncError(error: string): SyncHandlerResult {\n  return { success: false, error };\n}\n\nexport type EndpointSyncClientConfig = {\n  endpoint: string;\n  headers?: Record<string, string>;\n  scope?: string;\n};\n\nexport type EndpointSyncClient<T, Q = unknown> = {\n  onFetch: (query: Q, signal: AbortSignal) => Promise<T[]>;\n  onSync: (changes: Change<T>[], signal: AbortSignal) => Promise<SyncResult[]>;\n};\n\nexport function createSyncClientFromEndpoint<T, Q = unknown>(\n  config: string | EndpointSyncClientConfig,\n): EndpointSyncClient<T, Q> {\n  const endpoint = typeof config === \"string\" ? config : config.endpoint;\n  const headers = typeof config === \"string\" ? {} : (config.headers ?? {});\n  const scope = typeof config === \"string\" ? undefined : config.scope;\n\n  const onFetch = async (query: Q, signal: AbortSignal): Promise<T[]> => {\n    if (signal.aborted) {\n      throw new Error(\"Operation aborted\");\n    }\n\n    try {\n      const body: SyncRequestBody<T, Q> = { scope, query };\n      const response = await fetch(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n        signal,\n      });\n\n      if (!response.ok) {\n        let errorMsg = \"Fetch request failed\";\n        try {\n          const errorBody = await response.json();\n          if (errorBody.error) errorMsg = errorBody.error;\n        } catch {\n          // Ignore JSON parse errors\n        }\n        throw new Error(errorMsg);\n      }\n\n      const responseBody: SyncResponseBody<T> = await response.json();\n      return responseBody.results ?? [];\n    } catch (error) {\n      if (error instanceof Error && error.name === \"AbortError\") {\n        throw new Error(\"Operation aborted\");\n      }\n      throw error;\n    }\n  };\n\n  const onSync = async (changes: Change<T>[], signal: AbortSignal): Promise<SyncResult[]> => {\n    if (signal.aborted) {\n      return changes.map((c) => ({\n        id: c.id,\n        status: \"error\" as const,\n        error: \"Operation aborted\",\n      }));\n    }\n\n    try {\n      const body: SyncRequestBody<T, Q> = { scope, changes };\n      const response = await fetch(endpoint, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\", ...headers },\n        body: JSON.stringify(body),\n        signal,\n      });\n\n      if (!response.ok) {\n        let errorMsg = \"Sync request failed\";\n        try {\n          const errorBody = await response.json();\n          if (errorBody.error) errorMsg = errorBody.error;\n        } catch {\n          // Ignore JSON parse errors\n        }\n        return changes.map((c) => ({ id: c.id, status: \"error\" as const, error: errorMsg }));\n      }\n\n      const responseBody: SyncResponseBody<T> = await response.json();\n      return (\n        responseBody.syncResults ??\n        changes.map((c) => ({\n          id: c.id,\n          status: \"error\" as const,\n          error: \"No sync results returned\",\n        }))\n      );\n    } catch (error) {\n      const errorMsg =\n        error instanceof Error && error.name === \"AbortError\"\n          ? \"Operation aborted\"\n          : error instanceof Error\n            ? error.message\n            : \"Unknown error\";\n      return changes.map((c) => ({ id: c.id, status: \"error\" as const, error: errorMsg }));\n    }\n  };\n\n  return { onFetch, onSync };\n}\n\nexport async function fetchToSyncResult(\n  options: FetchToSyncResultOptions,\n): Promise<SyncHandlerResult> {\n  const { fetch: fetchPromise, parseResponse, parseError } = options;\n\n  const getErrorMessage = (error: unknown): string => {\n    if (typeof parseError === \"function\") return parseError(error);\n    if (typeof parseError === \"string\") return parseError;\n    return error instanceof Error ? error.message : \"Request failed\";\n  };\n\n  try {\n    const response = await fetchPromise;\n\n    if (!response.ok) {\n      let error: unknown = new Error(\"Request failed\");\n      try {\n        const body = await response.json();\n        if (body.message) error = new Error(body.message);\n        else if (body.error) error = new Error(body.error);\n      } catch {\n        // Ignore JSON parse errors\n      }\n      return { success: false, error: getErrorMessage(error) };\n    }\n\n    if (parseResponse) {\n      const result = await parseResponse(response);\n      return { success: true, ...result };\n    }\n\n    return { success: true };\n  } catch (error) {\n    if (error instanceof Error && error.name === \"AbortError\") {\n      return { success: false, error: \"Operation aborted\" };\n    }\n    return { success: false, error: getErrorMessage(error) };\n  }\n}\n"],"names":["createChangeProcessors","config","change","signal","result","processChange","processor","error","createSyncClient","changes","createSyncClientWithStats","onSync","handlers","results","categorizeResults","syncSuccess","options","syncError","createSyncClientFromEndpoint","endpoint","headers","scope","query","body","response","errorMsg","errorBody","c","fetchToSyncResult","fetchPromise","parseResponse","parseError","getErrorMessage"],"mappings":"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"}

package/dist/chunks/types-Dy4rYb2N.js

@@ -1,19 +0,0 @@
-function n(e) {
-  const t = e.filter((l) => l.status === "success"), c = e.filter((l) => l.status === "error");
-  return {
-    results: e,
-    successful: t,
-    failed: c,
-    allSucceeded: c.length === 0,
-    anySucceeded: t.length > 0,
-    summary: {
-      total: e.length,
-      succeeded: t.length,
-      failed: c.length
-    }
-  };
-}
-export {
-  n as c
-};
-//# sourceMappingURL=types-Dy4rYb2N.js.map

package/dist/chunks/types-Dy4rYb2N.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-Dy4rYb2N.js","sources":["../../src/runtime/types.ts"],"sourcesContent":["import type { Change, SyncResult } from \"../types\";\n\n// ============================================================================\n// Shared Types (used by both client and server)\n// ============================================================================\n\n/**\n * Result of a sync operation handler.\n * Used by both client-side and server-side handlers.\n */\nexport type SyncHandlerResult =\n  | { success: true; newId?: string }\n  | { success: false; error: string };\n\n/**\n * Zod-like schema interface (duck typing to avoid hard dependency)\n */\nexport type Schema<T> = {\n  safeParse: (\n    data: unknown,\n  ) => { success: true; data: T } | { success: false; error: { message: string } };\n};\n\n/**\n * Aggregated results from sync operations.\n * Provides categorized results and summary statistics.\n */\nexport type SyncBatchResult = {\n  /** All results from the sync operation */\n  results: SyncResult[];\n  /** Results that succeeded */\n  successful: SyncResult[];\n  /** Results that failed */\n  failed: SyncResult[];\n  /** Whether all operations succeeded */\n  allSucceeded: boolean;\n  /** Whether any operations succeeded */\n  anySucceeded: boolean;\n  /** Summary counts */\n  summary: {\n    total: number;\n    succeeded: number;\n    failed: number;\n  };\n};\n\n/**\n * Categorize sync results into successful and failed\n */\nexport function categorizeResults(results: SyncResult[]): SyncBatchResult {\n  const successful = results.filter((r) => r.status === \"success\");\n  const failed = results.filter((r) => r.status === \"error\");\n\n  return {\n    results,\n    successful,\n    failed,\n    allSucceeded: failed.length === 0,\n    anySucceeded: successful.length > 0,\n    summary: {\n      total: results.length,\n      succeeded: successful.length,\n      failed: failed.length,\n    },\n  };\n}\n\n// ============================================================================\n// Request/Response Types (for client-server communication)\n// ============================================================================\n\n/**\n * Request body for the unified POST endpoint\n */\nexport type SyncRequestBody<T, Q = unknown> = {\n  /** Optional scope identifier for selecting storage on the backend */\n  scope?: string;\n  /** Query parameters for fetching items */\n  query?: Q;\n  /** Changes to sync */\n  changes?: Change<T>[];\n};\n\n/**\n * Response body from the unified POST endpoint\n */\nexport type SyncResponseBody<T> = {\n  /** Fetched items (when query was provided) */\n  results?: T[];\n  /** Sync results (when changes were provided) */\n  syncResults?: SyncResult[];\n};\n"],"names":["categorizeResults","results","successful","r","failed"],"mappings":"AAiDO,SAASA,EAAkBC,GAAwC;AACxE,QAAMC,IAAaD,EAAQ,OAAO,CAACE,MAAMA,EAAE,WAAW,SAAS,GACzDC,IAASH,EAAQ,OAAO,CAACE,MAAMA,EAAE,WAAW,OAAO;AAEzD,SAAO;AAAA,IACL,SAAAF;AAAA,IACA,YAAAC;AAAA,IACA,QAAAE;AAAA,IACA,cAAcA,EAAO,WAAW;AAAA,IAChC,cAAcF,EAAW,SAAS;AAAA,IAClC,SAAS;AAAA,MACP,OAAOD,EAAQ;AAAA,MACf,WAAWC,EAAW;AAAA,MACtB,QAAQE,EAAO;AAAA,IAAA;AAAA,EACjB;AAEJ;"}

package/dist/collection.e2e.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/fetch-handler.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/item-cache.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/node.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/runtime/client.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/runtime/server.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/sync-queue.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/useCrud.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/useCrudTree.test.d.ts

@@ -1 +0,0 @@
-export {};