use-abcd 1.0.1 → 1.4.0

package/dist/chunks/client-DReyDQ23.js

@@ -0,0 +1,144 @@
+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

@@ -0,0 +1 @@
+{"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.map

@@ -1 +1 @@
-{"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  /** 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;"}
+{"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.d.ts

@@ -38,11 +38,13 @@ export declare class Collection<T, C> {
     update(id: string, mutate: (draft: Draft<T>) => void): void;
     remove(id: string): void;
     getItem(id: string): Item<T, C>;
+    _releaseItem(id: string): void;
     setContext(patchContext: Mutator<C>): void;
     refresh(): Promise<void>;
     pauseSync(): void;
     resumeSync(): void;
     retrySync(id?: string): void;
+    destroy(): void;
     private _initialFetch;
     private _onSyncQueueChange;
     private _onFetchChange;

package/dist/fetch-handler.d.ts

@@ -27,6 +27,7 @@ export declare class FetchHandler<T, C> {
     refresh(context?: C): Promise<T[]>;
     invalidateCache(): void;
     invalidateCacheForContext(context: C): void;
+    destroy(): void;
     getState: () => FetchHandlerState<T>;
     getContext: () => C | null;
     isFetching: () => boolean;