@tanstack/db-sqlite-persistence-core 0.2.21 → 0.4.0

package/dist/esm/remote-subset-owner.d.ts

@@ -0,0 +1,7 @@
+import { TransportedLoadSubsetOptions } from './remote-subset-wire.js';
+export type RemoteSubsetOwner = ((options: TransportedLoadSubsetOptions) => Promise<void> | void) & {
+    unloadSubset: (options: TransportedLoadSubsetOptions) => void;
+    onError: (error: unknown) => void;
+};
+export declare function reportRemoteSubsetOwnerError(owner: RemoteSubsetOwner, error: unknown): void;
+export declare function unloadRemoteSubsetOwner(owner: RemoteSubsetOwner, options: TransportedLoadSubsetOptions): Promise<void>;

package/dist/esm/remote-subset-owner.js

@@ -0,0 +1,20 @@
+function reportRemoteSubsetOwnerError(owner, error) {
+  try {
+    owner.onError(error);
+  } catch {
+  }
+}
+async function unloadRemoteSubsetOwner(owner, options) {
+  try {
+    const result = owner.unloadSubset(options);
+    await Promise.resolve(result);
+  } catch (error) {
+    reportRemoteSubsetOwnerError(owner, error);
+    throw error;
+  }
+}
+export {
+  reportRemoteSubsetOwnerError,
+  unloadRemoteSubsetOwner
+};
+//# sourceMappingURL=remote-subset-owner.js.map

package/dist/esm/remote-subset-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-subset-owner.js","sources":["../../src/remote-subset-owner.ts"],"sourcesContent":["import type { TransportedLoadSubsetOptions } from './remote-subset-wire'\n\nexport type RemoteSubsetOwner = ((\n  options: TransportedLoadSubsetOptions,\n) => Promise<void> | void) & {\n  unloadSubset: (options: TransportedLoadSubsetOptions) => void\n  onError: (error: unknown) => void\n}\n\nexport function reportRemoteSubsetOwnerError(\n  owner: RemoteSubsetOwner,\n  error: unknown,\n): void {\n  try {\n    owner.onError(error)\n  } catch {\n    // Reporting must not replace the original owner failure.\n  }\n}\n\nexport async function unloadRemoteSubsetOwner(\n  owner: RemoteSubsetOwner,\n  options: TransportedLoadSubsetOptions,\n): Promise<void> {\n  try {\n    const result = (\n      owner.unloadSubset as unknown as (\n        options: TransportedLoadSubsetOptions,\n      ) => unknown\n    )(options)\n    await Promise.resolve(result)\n  } catch (error) {\n    reportRemoteSubsetOwnerError(owner, error)\n    throw error\n  }\n}\n"],"names":[],"mappings":"AASO,SAAS,6BACd,OACA,OACM;AACN,MAAI;AACF,UAAM,QAAQ,KAAK;AAAA,EACrB,QAAQ;AAAA,EAER;AACF;AAEA,eAAsB,wBACpB,OACA,SACe;AACf,MAAI;AACF,UAAM,SACJ,MAAM,aAGN,OAAO;AACT,UAAM,QAAQ,QAAQ,MAAM;AAAA,EAC9B,SAAS,OAAO;AACd,iCAA6B,OAAO,KAAK;AACzC,UAAM;AAAA,EACR;AACF;"}

package/dist/esm/remote-subset-wire.d.ts

@@ -0,0 +1,59 @@
+import { LoadSubsetOptions } from '@tanstack/db';
+export type RemoteSubsetWirePrimitive = undefined | null | boolean | string | number | bigint;
+export type RemoteSubsetWireTypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array | BigInt64Array | BigUint64Array;
+export type RemoteSubsetWireRecord = {
+    [key: string]: RemoteSubsetWireValue;
+};
+/** Values whose complete semantics survive a coordinator transport boundary. */
+export type RemoteSubsetWireValue = RemoteSubsetWirePrimitive | Date | RegExp | ArrayBuffer | DataView | RemoteSubsetWireTypedArray | Array<RemoteSubsetWireValue> | Map<RemoteSubsetWireValue, RemoteSubsetWireValue> | Set<RemoteSubsetWireValue> | RemoteSubsetWireRecord;
+export type RemoteSubsetWireExpression = {
+    type: `ref`;
+    path: Array<string>;
+    sourceAlias?: string;
+} | {
+    type: `val`;
+    value: RemoteSubsetWireValue;
+} | {
+    type: `func`;
+    name: string;
+    args: Array<RemoteSubsetWireExpression>;
+};
+export type RemoteSubsetWireCompareOptions = {
+    direction: `asc` | `desc`;
+    nulls: `first` | `last`;
+} & ({
+    stringSort?: `lexical`;
+} | {
+    stringSort?: `locale`;
+    locale?: string;
+    localeOptions?: RemoteSubsetWireRecord;
+});
+export type RemoteSubsetWireOrderByClause = {
+    expression: RemoteSubsetWireExpression;
+    compareOptions: RemoteSubsetWireCompareOptions;
+};
+export type RemoteSubsetWireCursor = {
+    whereFrom: RemoteSubsetWireExpression;
+    whereCurrent: RemoteSubsetWireExpression;
+    lastKey?: string | number;
+};
+/** The complete data portion transported by a remote-subset request. */
+export type TransportedLoadSubsetOptions = {
+    where?: RemoteSubsetWireExpression;
+    orderBy?: Array<RemoteSubsetWireOrderByClause>;
+    limit?: number;
+    cursor?: RemoteSubsetWireCursor;
+    offset?: number;
+};
+export declare class RemoteSubsetWireValueError extends TypeError {
+    readonly path: string;
+    readonly name = "RemoteSubsetWireValueError";
+    constructor(path: string, reason: string);
+}
+/**
+ * Projects one live subset request into the exact coordinator wire domain.
+ * Validation happens before callers choose a local-leader or transported path.
+ */
+export declare function toTransportedLoadSubsetOptions(options: LoadSubsetOptions): TransportedLoadSubsetOptions;
+/** Adds live lifecycle references only to an already validated local request. */
+export declare function toProcessLocalLoadSubsetOptions(options: LoadSubsetOptions, transported?: TransportedLoadSubsetOptions): TransportedLoadSubsetOptions & Pick<LoadSubsetOptions, `signal` | `subscription`>;