fetchium 0.0.0 → 0.1.0

package/dist/esm/development/subscriptions/polling.js

@@ -0,0 +1,25 @@
+function o(t) {
+  return !Number.isFinite(t) || t < 100 ? ((Number.isNaN(t) || t < 0) && console.warn(`poll: invalid interval ${t}, clamping to 100ms`), 100) : t;
+}
+function N(t) {
+  const n = o(t.interval);
+  return function(u) {
+    let i = !0, e;
+    const c = this.refetch, r = async () => {
+      if (i) {
+        try {
+          await c();
+        } catch {
+        }
+        i && (e = setTimeout(r, n));
+      }
+    };
+    return e = setTimeout(r, n), () => {
+      i = !1, e !== void 0 && (clearTimeout(e), e = void 0);
+    };
+  };
+}
+export {
+  N as poll
+};
+//# sourceMappingURL=polling.js.map

package/dist/esm/development/subscriptions/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sources":["../../../../src/subscriptions/polling.ts"],"sourcesContent":["import type { MutationEvent } from '../types.js';\n\nconst MIN_INTERVAL = 100;\n\nexport interface PollConfig {\n  interval: number;\n}\n\nfunction clampInterval(interval: number): number {\n  if (!Number.isFinite(interval) || interval < MIN_INTERVAL) {\n    if (IS_DEV && (Number.isNaN(interval) || interval < 0)) {\n      console.warn(`poll: invalid interval ${interval}, clamping to ${MIN_INTERVAL}ms`);\n    }\n    return MIN_INTERVAL;\n  }\n  return interval;\n}\n\nexport function poll(config: PollConfig): (this: any, onEvent: (event: MutationEvent) => void) => () => void {\n  const interval = clampInterval(config.interval);\n\n  return function subscribe(this: any, _onEvent: (event: MutationEvent) => void): () => void {\n    let active = true;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const refetch = this.refetch as () => Promise<unknown>;\n\n    const tick = async () => {\n      if (!active) return;\n      try {\n        await refetch();\n      } catch {\n        // Keep polling after errors\n      }\n      if (active) {\n        timer = setTimeout(tick, interval);\n      }\n    };\n\n    timer = setTimeout(tick, interval);\n\n    return () => {\n      active = false;\n      if (timer !== undefined) {\n        clearTimeout(timer);\n        timer = undefined;\n      }\n    };\n  };\n}\n"],"names":["clampInterval","interval","poll","config","_onEvent","active","timer","refetch","tick"],"mappings":"AAQA,SAASA,EAAcC,GAA0B;AAC/C,SAAI,CAAC,OAAO,SAASA,CAAQ,KAAKA,IAAW,QAC5B,OAAO,MAAMA,CAAQ,KAAKA,IAAW,MAClD,QAAQ,KAAK,0BAA0BA,CAAQ,qBAAiC,GAE3E,OAEFA;AACT;AAEO,SAASC,EAAKC,GAAwF;AAC3G,QAAMF,IAAWD,EAAcG,EAAO,QAAQ;AAE9C,SAAO,SAA8BC,GAAsD;AACzF,QAAIC,IAAS,IACTC;AAEJ,UAAMC,IAAU,KAAK,SAEfC,IAAO,YAAY;AACvB,UAAKH,GACL;AAAA,YAAI;AACF,gBAAME,EAAA;AAAA,QACR,QAAQ;AAAA,QAER;AACA,QAAIF,MACFC,IAAQ,WAAWE,GAAMP,CAAQ;AAAA;AAAA,IAErC;AAEA,WAAAK,IAAQ,WAAWE,GAAMP,CAAQ,GAE1B,MAAM;AACX,MAAAI,IAAS,IACLC,MAAU,WACZ,aAAaA,CAAK,GAClBA,IAAQ;AAAA,IAEZ;AAAA,EACF;AACF;"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,4 @@
+import { InternalObjectFieldTypeDef } from './types.js';
+export declare function typeToString(type: InternalObjectFieldTypeDef): string;
+export declare function typeError(path: string, expectedType: InternalObjectFieldTypeDef, value: unknown): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,0BAA0B,EAM3B,MAAM,YAAY,CAAC;AAGpB,wBAAgB,YAAY,CAAC,IAAI,EAAE,0BAA0B,GAAG,MAAM,CAkIrE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,0BAA0B,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CASvG"}

package/dist/esm/fieldRef.d.ts

@@ -0,0 +1,15 @@
+import type { QueryContext } from './QueryClient.js';
+export declare const DEFINITION_TARGET: unique symbol;
+export declare const CANCEL_PROXY: unique symbol;
+export declare function isFieldRef(value: unknown): boolean;
+export declare function getFieldRefPath(ref: unknown): string[];
+export declare function createDefinitionProxy<T extends object>(target: T): T;
+export interface CapturedDefinition<T = Record<string, unknown>> {
+    fields: T;
+    methods: T;
+}
+export declare function extractDefinition<T>(instance: T): CapturedDefinition<T>;
+export declare function resolveFieldRefPath(path: string[], root: Record<string, unknown>): unknown;
+export declare function reifyValue(value: unknown, root: Record<string, unknown>): unknown;
+export declare function createExecutionContext<T>(captured: CapturedDefinition<T>, actualParams: Record<string, unknown>, queryContext: QueryContext): T;
+//# sourceMappingURL=fieldRef.d.ts.map

package/dist/esm/fieldRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldRef.d.ts","sourceRoot":"","sources":["../../src/fieldRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AASrD,eAAO,MAAM,iBAAiB,eAA8B,CAAC;AAC7D,eAAO,MAAM,YAAY,eAAyB,CAAC;AA0CnD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAEtD;AAMD,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAyBpE;AAMD,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAyBvE;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAO1F;AAUD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsBjF;AAMD,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,YAAY,EAAE,YAAY,GACzB,CAAC,CAmBH"}

package/dist/esm/index.d.ts

@@ -0,0 +1,14 @@
+export * from './types.js';
+export { QueryClient, QueryClientContext } from './QueryClient.js';
+export type { QueryContext } from './QueryClient.js';
+export { t, registerFormat } from './typeDefs.js';
+export { Query, RESTQuery, fetchQuery, queryKeyForClass } from './query.js';
+export type { ResolvedLoadNext } from './query.js';
+export { Mutation, RESTMutation, getMutation, mutationKeyForClass } from './mutation.js';
+export type { MutationDefinition } from './mutation.js';
+export { draft } from './utils.js';
+export type { Draft } from './utils.js';
+export { NetworkManager, NoOpNetworkManager, defaultNetworkManager, NetworkManagerContext } from './NetworkManager.js';
+export { GcManager, NoOpGcManager } from './GcManager.js';
+export { Entity } from './proxy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzF,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/mutation.d.ts

@@ -0,0 +1,47 @@
+import { ReactiveTask } from 'signalium';
+import { ExtractType, InternalTypeDef, MutationEffects, RetryConfig, TypeDefShape, QueryRequestOptions } from './types.js';
+import { QueryContext } from './QueryClient.js';
+import { type CapturedDefinition } from './fieldRef.js';
+export interface MutationConfigOptions {
+    retry?: RetryConfig | number | false;
+}
+export interface MutationDefinition<Request, Response> {
+    id: string;
+    requestShape: InternalTypeDef;
+    responseShape: InternalTypeDef | undefined;
+    captured: CapturedDefinition<Mutation>;
+    optimisticUpdates: boolean;
+    config?: MutationConfigOptions;
+    effects?: MutationEffects;
+    hasGetEffects: boolean;
+}
+export declare abstract class Mutation {
+    readonly params?: TypeDefShape;
+    readonly result?: TypeDefShape;
+    readonly optimisticUpdates?: boolean;
+    readonly config?: MutationConfigOptions;
+    readonly effects?: Readonly<MutationEffects>;
+    context: QueryContext;
+    response: Response | undefined;
+    signal: AbortSignal;
+    abstract send(): Promise<unknown>;
+    abstract getStorageKey(): unknown;
+    getEffects?(): MutationEffects;
+    constructor();
+}
+export declare abstract class RESTMutation extends Mutation {
+    path?: string;
+    method: 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    body?: Record<string, unknown>;
+    headers?: HeadersInit;
+    requestOptions?: QueryRequestOptions;
+    getStorageKey(): string;
+    getPath?(): string | undefined;
+    getMethod?(): string;
+    getBody?(): Record<string, unknown> | undefined;
+    getRequestOptions?(): QueryRequestOptions | undefined;
+    send(): Promise<unknown>;
+}
+export declare const mutationKeyForClass: (cls: new () => Mutation) => string;
+export declare function getMutation<T extends Mutation>(MutationClass: new () => T): ReactiveTask<Readonly<ExtractType<T['result']>>, [ExtractType<T['params']>]>;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/esm/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../src/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EACL,WAAW,EACX,eAAe,EACf,eAAe,EAEf,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAsB,YAAY,EAAkB,MAAM,kBAAkB,CAAC;AAEpF,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAMlG,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB,CAAC,OAAO,EAAE,QAAQ;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,eAAe,CAAC;IAC9B,aAAa,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACvC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;CACxB;AAMD,8BAAsB,QAAQ;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAErC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,WAAW,CAAC;IAE5B,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,IAAI,OAAO;IAEjC,UAAU,CAAC,IAAI,eAAe;;CAK/B;AAMD,8BAAsB,YAAa,SAAQ,QAAQ;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAU;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IAErC,aAAa,IAAI,MAAM;IAIvB,OAAO,CAAC,IAAI,MAAM,GAAG,SAAS;IAC9B,SAAS,CAAC,IAAI,MAAM;IACpB,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAC/C,iBAAiB,CAAC,IAAI,mBAAmB,GAAG,SAAS;IAE/C,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CAiC/B;AAQD,eAAO,MAAM,mBAAmB,QAAS,UAAU,QAAQ,KAAG,MAQ7D,CAAC;AA0DF,wBAAgB,WAAW,CAAC,CAAC,SAAS,QAAQ,EAC5C,aAAa,EAAE,UAAU,CAAC,GACzB,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAU9E"}

package/dist/esm/parseEntities.d.ts

@@ -0,0 +1,44 @@
+import type { QueryClient, PreloadedEntityMap } from './QueryClient.js';
+import { ValidatorDef } from './typeDefs.js';
+import { ComplexTypeDef, EntityDef, TypeDef } from './types.js';
+import type { WarnFn } from './proxy.js';
+export interface ParsedEntity {
+    key: number;
+    shape: EntityDef;
+    data: Record<string, unknown>;
+    /** Set for partial event updates — restricts mergeFields to only these keys. */
+    rawKeys: Set<string> | undefined;
+}
+export declare class ParseContext {
+    queryClient: QueryClient | undefined;
+    preloadedEntities: PreloadedEntityMap | undefined;
+    warn: WarnFn;
+    /** When true, missing optional fields on existing entities are set to
+     *  undefined. False for mutation events (truly partial payloads). */
+    isPartialEvent: boolean;
+    seen: Map<Record<string, unknown>, ParsedEntity> | undefined;
+    seenByKey: Map<number, ParsedEntity> | undefined;
+    reset(queryClient: QueryClient | undefined, preloadedEntities: PreloadedEntityMap | undefined, warn: WarnFn, isPartialEvent?: boolean): void;
+}
+export interface ParseResult {
+    data: unknown;
+    ctx: ParseContext;
+}
+/**
+ * Parse data: validates types, applies formats, produces parsed entity data
+ * objects (stored in ctx.seen). Does NOT touch the entity store.
+ *
+ * After parsing, call applyEntityRefs() to apply entities and reify the tree.
+ */
+export declare function parseEntities(value: unknown, typeDef: TypeDef | ComplexTypeDef, ctx: ParseContext): unknown;
+/**
+ * Standalone value parser for non-entity values. Used by tests and LiveCollection.
+ * Validates types and applies eager formats. Does not perform entity resolution.
+ */
+export declare function parseValue(value: unknown, typeDef: TypeDef | ComplexTypeDef, path: string, warn?: WarnFn): unknown;
+/**
+ * Parse a single entity. Returns its parsed data object.
+ */
+export declare function parseEntity(obj: Record<string, unknown>, entityShape: EntityDef, ctx: ParseContext): Record<string, unknown>;
+export declare function entitySatisfiesShape(data: Record<string, unknown>, def: ValidatorDef<any>): boolean;
+//# sourceMappingURL=parseEntities.d.ts.map

package/dist/esm/parseEntities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseEntities.d.ts","sourceRoot":"","sources":["../../src/parseEntities.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAyD,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpG,OAAO,EAGL,cAAc,EACd,SAAS,EAQT,OAAO,EAER,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AASzC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gFAAgF;IAChF,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAClC;AAMD,qBAAa,YAAY;IACvB,WAAW,EAAE,WAAW,GAAG,SAAS,CAAa;IACjD,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,CAAa;IAC9D,IAAI,EAAE,MAAM,CAAY;IACxB;yEACqE;IACrE,cAAc,EAAE,OAAO,CAAS;IAChC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,SAAS,CAAa;IACzE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,CAAa;IAE7D,KAAK,CACH,WAAW,EAAE,WAAW,GAAG,SAAS,EACpC,iBAAiB,EAAE,kBAAkB,GAAG,SAAS,EACjD,IAAI,EAAE,MAAM,EACZ,cAAc,GAAE,OAAe,GAC9B,IAAI;CAeR;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,YAAY,CAAC;CACnB;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAE3G;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GAAG,cAAc,EACjC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAiB,GACtB,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,WAAW,EAAE,SAAS,EACtB,GAAG,EAAE,YAAY,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB;AAkVD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAEnG"}