@signalium/query 0.0.0 → 0.0.1

package/dist/esm/QueryClient.js

@@ -0,0 +1,175 @@
+/**
+ * Query Client with Entity Caching and Deduplication
+ *
+ * Features:
+ * - Global entity map for deduplication
+ * - Entity definitions with cached sub-entity paths
+ * - Eager entity discovery and caching
+ * - Permanent proxy cache for entities
+ * - Response caching for offline access
+ * - Signalium-based reactivity for entity updates
+ * - Self-contained validator (no external dependencies except Signalium)
+ */
+import { relay, context, notifier, } from 'signalium';
+import { hashValue, setReactivePromise } from 'signalium/utils';
+import { parseValue } from './proxy.js';
+import { parseEntities } from './parseEntities.js';
+import { EntityStore } from './EntityMap.js';
+import { ValidatorDef } from './typeDefs.js';
+const queryKeyFor = (queryDef, params) => {
+    return hashValue([queryDef.id, params]);
+};
+/**
+ * QueryResult wraps a DiscriminatedReactivePromise and adds additional functionality
+ * like refetch, while forwarding all the base relay properties.
+ */
+export class QueryResultImpl {
+    relay;
+    instance;
+    constructor(relay, instance) {
+        this.relay = relay;
+        this.instance = instance;
+        setReactivePromise(this);
+    }
+    // Forward all ReactivePromise properties through getters
+    get value() {
+        return this.relay.value;
+    }
+    get error() {
+        return this.relay.error;
+    }
+    get isPending() {
+        return this.relay.isPending;
+    }
+    get isRejected() {
+        return this.relay.isRejected;
+    }
+    get isResolved() {
+        return this.relay.isResolved;
+    }
+    get isSettled() {
+        return this.relay.isSettled;
+    }
+    get isReady() {
+        return this.relay.isReady;
+    }
+    // TODO: Intimate APIs needed for `useReactive`, this is a code smell and
+    // we should find a better way to entangle these more generically
+    get _version() {
+        return this.relay._version;
+    }
+    get _signal() {
+        return this.relay._signal;
+    }
+    get _flags() {
+        return this.relay._flags;
+    }
+    // Forward Promise methods
+    then(onfulfilled, onrejected) {
+        return this.relay.then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.relay.catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.relay.finally(onfinally);
+    }
+    // Additional methods
+    refetch() {
+        this.instance.notifier.notify();
+        // pull the value to make sure the relay is activated
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+        this.instance.relay.value;
+        return this.relay;
+    }
+    // Make it work with Symbol.toStringTag for Promise detection
+    get [Symbol.toStringTag]() {
+        return 'QueryResult';
+    }
+}
+export class QueryClient {
+    store;
+    context;
+    entityMap = new EntityStore();
+    queryInstances = new Map();
+    constructor(store, context = { fetch }) {
+        this.store = store;
+        this.context = context;
+    }
+    /**
+     * Loads a query from the document store and returns a QueryResult
+     * that triggers fetches and prepopulates with cached data
+     */
+    getQuery(queryDef, params) {
+        const queryKey = queryKeyFor(queryDef, params);
+        let queryInstance = this.queryInstances.get(queryKey);
+        // Create a new relay if it doesn't exist
+        if (queryInstance === undefined) {
+            queryInstance = {
+                relay: undefined,
+                initialized: false,
+                notifier: notifier(),
+            };
+            const queryRelay = relay(state => {
+                // Load from cache first, then fetch fresh data
+                queryInstance.notifier.consume();
+                this.store.activateQuery(queryDef, queryKey);
+                if (queryInstance.initialized) {
+                    state.setPromise(this.runQuery(queryDef, queryKey, params));
+                }
+                else {
+                    this.initializeQuery(queryDef, params, state, queryInstance);
+                }
+            });
+            queryInstance.relay = new QueryResultImpl(queryRelay, queryInstance);
+            // Store the relay for future use
+            this.queryInstances.set(queryKey, queryInstance);
+        }
+        return queryInstance.relay;
+    }
+    async initializeQuery(queryDef, params, state, instance) {
+        try {
+            instance.initialized = true;
+            const queryKey = queryKeyFor(queryDef, params);
+            // Load from cache first
+            const query = this.store.loadQuery(queryDef, queryKey, this.entityMap);
+            if (query !== undefined) {
+                const shape = queryDef.shape;
+                state.value =
+                    shape instanceof ValidatorDef
+                        ? parseEntities(query, shape, this, new Set())
+                        : parseValue(query, shape, queryDef.id);
+            }
+            state.setPromise(this.runQuery(queryDef, queryKey, params));
+        }
+        catch (error) {
+            // Relay will handle the error state automatically
+            state.setError(error);
+        }
+    }
+    /**
+     * Fetches fresh data and updates the cache
+     */
+    async runQuery(queryDef, queryKey, params) {
+        const freshData = await queryDef.fetchFn(this.context, params);
+        // Parse and cache the fresh data
+        const entityRefs = new Set();
+        const shape = queryDef.shape;
+        const parsedData = shape instanceof ValidatorDef
+            ? parseEntities(freshData, shape, this, entityRefs)
+            : parseValue(freshData, shape, queryDef.id);
+        // Cache the data (synchronous, fire-and-forget)
+        this.store.saveQuery(queryDef, queryKey, freshData, entityRefs);
+        return parsedData;
+    }
+    hydrateEntity(key, shape) {
+        return this.entityMap.hydratePreloadedEntity(key, shape);
+    }
+    saveEntity(key, obj, shape, entityRefs) {
+        const record = this.entityMap.setEntity(key, obj, shape);
+        this.store.saveEntity(key, obj, entityRefs);
+        return record;
+    }
+}
+export const QueryClientContext = context(undefined);
+//# sourceMappingURL=QueryClient.js.map

package/dist/esm/QueryClient.js.map

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

package/dist/esm/QueryStore.d.ts

@@ -0,0 +1,73 @@
+/**
+ * QueryStore - Minimal interface for query persistence
+ *
+ * Provides a clean abstraction over document storage, reference counting,
+ * and LRU cache management. Supports both synchronous (in-memory) and
+ * asynchronous (writer-backed) implementations.
+ */
+import { EntityStore } from './EntityMap.js';
+import { QueryDefinition } from './QueryClient.js';
+export interface QueryStore {
+    /**
+     * Asynchronously retrieves a document by key.
+     * May return undefined if the document is not in the store.
+     */
+    loadQuery(queryDef: QueryDefinition<any, any>, queryKey: number, entityMap: EntityStore): MaybePromise<unknown | undefined>;
+    /**
+     * Synchronously stores a document with optional reference IDs.
+     * This is fire-and-forget for async implementations.
+     */
+    saveQuery(queryDef: QueryDefinition<any, any>, queryKey: number, value: unknown, refIds?: Set<number>): void;
+    /**
+     * Synchronously stores an entity with optional reference IDs.
+     * This is fire-and-forget for async implementations.
+     */
+    saveEntity(entityKey: number, value: unknown, refIds?: Set<number>): void;
+    /**
+     * Marks a query as accessed, updating the LRU queue.
+     * Handles eviction internally when the cache is full.
+     */
+    activateQuery(queryDef: QueryDefinition<any, any>, queryKey: number): void;
+}
+export type MaybePromise<T> = T | Promise<T>;
+export interface SyncPersistentStore {
+    has(key: string): boolean;
+    getString(key: string): string | undefined;
+    setString(key: string, value: string): void;
+    getNumber(key: string): number | undefined;
+    setNumber(key: string, value: number): void;
+    getBuffer(key: string): Uint32Array | undefined;
+    setBuffer(key: string, value: Uint32Array): void;
+    delete(key: string): void;
+}
+export declare class MemoryPersistentStore implements SyncPersistentStore {
+    private readonly kv;
+    has(key: string): boolean;
+    getString(key: string): string | undefined;
+    setString(key: string, value: string): void;
+    getNumber(key: string): number | undefined;
+    setNumber(key: string, value: number): void;
+    getBuffer(key: string): Uint32Array | undefined;
+    setBuffer(key: string, value: Uint32Array): void;
+    delete(key: string): void;
+}
+export declare const valueKeyFor: (id: number) => string;
+export declare const refCountKeyFor: (id: number) => string;
+export declare const refIdsKeyFor: (id: number) => string;
+export declare const updatedAtKeyFor: (id: number) => string;
+export declare const queueKeyFor: (queryDefId: string) => string;
+export declare class SyncQueryStore implements QueryStore {
+    private readonly kv;
+    queues: Map<string, Uint32Array>;
+    constructor(kv: SyncPersistentStore);
+    loadQuery(queryDef: QueryDefinition<any, any>, queryKey: number, entityMap: EntityStore): unknown | undefined;
+    private preloadEntities;
+    saveQuery(queryDef: QueryDefinition<any, any>, queryKey: number, value: unknown, refIds?: Set<number>): void;
+    saveEntity(entityKey: number, value: unknown, refIds?: Set<number>): void;
+    activateQuery(queryDef: QueryDefinition<any, any>, queryKey: number): void;
+    private setValue;
+    private deleteValue;
+    private incrementRefCount;
+    private decrementRefCount;
+}
+//# sourceMappingURL=QueryStore.d.ts.map

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

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

package/dist/esm/QueryStore.js

@@ -0,0 +1,209 @@
+/**
+ * QueryStore - Minimal interface for query persistence
+ *
+ * Provides a clean abstraction over document storage, reference counting,
+ * and LRU cache management. Supports both synchronous (in-memory) and
+ * asynchronous (writer-backed) implementations.
+ */
+const DEFAULT_MAX_COUNT = 50;
+const DEFAULT_MAX_AGE = 1000 * 60 * 60 * 24; // 24 hours
+export class MemoryPersistentStore {
+    kv = Object.create(null);
+    has(key) {
+        return key in this.kv;
+    }
+    getString(key) {
+        return this.kv[key];
+    }
+    setString(key, value) {
+        this.kv[key] = value;
+    }
+    getNumber(key) {
+        return this.kv[key];
+    }
+    setNumber(key, value) {
+        this.kv[key] = value;
+    }
+    getBuffer(key) {
+        return this.kv[key];
+    }
+    setBuffer(key, value) {
+        this.kv[key] = value;
+    }
+    delete(key) {
+        delete this.kv[key];
+    }
+}
+// Query Instance keys
+export const valueKeyFor = (id) => `sq:doc:value:${id}`;
+export const refCountKeyFor = (id) => `sq:doc:refCount:${id}`;
+export const refIdsKeyFor = (id) => `sq:doc:refIds:${id}`;
+export const updatedAtKeyFor = (id) => `sq:doc:updatedAt:${id}`;
+// Query Type keys
+export const queueKeyFor = (queryDefId) => `sq:doc:queue:${queryDefId}`;
+export class SyncQueryStore {
+    kv;
+    queues = new Map();
+    constructor(kv) {
+        this.kv = kv;
+    }
+    loadQuery(queryDef, queryKey, entityMap) {
+        const updatedAt = this.kv.getNumber(updatedAtKeyFor(queryKey));
+        if (updatedAt === undefined || updatedAt < Date.now() - (queryDef.cache?.maxAge ?? DEFAULT_MAX_AGE)) {
+            return;
+        }
+        const value = this.kv.getString(valueKeyFor(queryKey));
+        if (value === undefined) {
+            return;
+        }
+        const entityIds = this.kv.getBuffer(refIdsKeyFor(queryKey));
+        if (entityIds !== undefined) {
+            this.preloadEntities(entityIds, entityMap);
+        }
+        this.activateQuery(queryDef, queryKey);
+        return JSON.parse(value);
+    }
+    preloadEntities(entityIds, entityMap) {
+        for (const entityId of entityIds) {
+            const entityValue = this.kv.getString(valueKeyFor(entityId));
+            if (entityValue === undefined) {
+                continue;
+            }
+            const entity = JSON.parse(entityValue);
+            entityMap.setPreloadedEntity(entityId, entity);
+            const childIds = this.kv.getBuffer(refIdsKeyFor(entityId));
+            if (childIds === undefined) {
+                continue;
+            }
+            this.preloadEntities(childIds, entityMap);
+        }
+    }
+    saveQuery(queryDef, queryKey, value, refIds) {
+        this.setValue(queryKey, value, refIds);
+        this.kv.setNumber(updatedAtKeyFor(queryKey), Date.now());
+        this.activateQuery(queryDef, queryKey);
+    }
+    saveEntity(entityKey, value, refIds) {
+        this.setValue(entityKey, value, refIds);
+    }
+    activateQuery(queryDef, queryKey) {
+        if (!this.kv.has(valueKeyFor(queryKey))) {
+            // Query not in store, nothing to do. This can happen if the query has
+            // been evicted from the cache, but is still active in memory.
+            return;
+        }
+        let queue = this.queues.get(queryDef.id);
+        if (queue === undefined) {
+            const maxCount = queryDef.cache?.maxCount ?? DEFAULT_MAX_COUNT;
+            queue = this.kv.getBuffer(queueKeyFor(queryDef.id));
+            if (queue === undefined) {
+                queue = new Uint32Array(maxCount);
+                this.kv.setBuffer(queueKeyFor(queryDef.id), queue);
+            }
+            else if (queue.length !== maxCount) {
+                const newQueue = new Uint32Array(maxCount);
+                newQueue.set(queue);
+                queue = newQueue;
+                this.kv.setBuffer(queueKeyFor(queryDef.id), queue);
+            }
+            this.queues.set(queryDef.id, queue);
+        }
+        const indexOfKey = queue.indexOf(queryKey);
+        // Item already in queue, move to front
+        if (indexOfKey >= 0) {
+            if (indexOfKey === 0) {
+                // Already at front, nothing to do
+                return;
+            }
+            // Shift items right to make space at front
+            queue.copyWithin(1, 0, indexOfKey);
+            queue[0] = queryKey;
+            return;
+        }
+        // Item not in queue, add to front and evict tail
+        const evicted = queue[queue.length - 1];
+        queue.copyWithin(1, 0, queue.length - 1);
+        queue[0] = queryKey;
+        if (evicted !== 0) {
+            this.deleteValue(evicted);
+            this.kv.delete(updatedAtKeyFor(evicted));
+        }
+    }
+    setValue(id, value, refIds) {
+        const kv = this.kv;
+        kv.setString(valueKeyFor(id), JSON.stringify(value));
+        const refIdsKey = refIdsKeyFor(id);
+        const prevRefIds = kv.getBuffer(refIdsKey);
+        if (refIds === undefined || refIds.size === 0) {
+            kv.delete(refIdsKey);
+            // Decrement all previous refs
+            if (prevRefIds !== undefined) {
+                for (let i = 0; i < prevRefIds.length; i++) {
+                    const refId = prevRefIds[i];
+                    this.decrementRefCount(refId);
+                }
+            }
+        }
+        else {
+            // Convert the set to a Uint32Array and capture all the refIds before we
+            // delete previous ones from the set
+            const newRefIds = new Uint32Array(refIds);
+            if (prevRefIds !== undefined) {
+                // Process new refs: increment if not in old
+                for (let i = 0; i < prevRefIds.length; i++) {
+                    const refId = prevRefIds[i];
+                    if (refIds.has(refId)) {
+                        refIds.delete(refId);
+                    }
+                    else {
+                        this.decrementRefCount(refId);
+                    }
+                }
+            }
+            // No previous refs, increment all unique new refs
+            for (const refId of refIds) {
+                this.incrementRefCount(refId);
+            }
+            kv.setBuffer(refIdsKey, newRefIds);
+        }
+    }
+    deleteValue(id) {
+        const kv = this.kv;
+        kv.delete(valueKeyFor(id));
+        kv.delete(refCountKeyFor(id));
+        const refIds = kv.getBuffer(refIdsKeyFor(id));
+        kv.delete(refIdsKeyFor(id)); // Clean up the refIds key
+        if (refIds === undefined) {
+            return;
+        }
+        // Decrement ref counts for all referenced entities
+        for (const refId of refIds) {
+            if (refId !== 0) {
+                this.decrementRefCount(refId);
+            }
+        }
+    }
+    incrementRefCount(refId) {
+        const refCountKey = refCountKeyFor(refId);
+        const currentCount = this.kv.getNumber(refCountKey) ?? 0;
+        const newCount = currentCount + 1;
+        this.kv.setNumber(refCountKey, newCount);
+    }
+    decrementRefCount(refId) {
+        const refCountKey = refCountKeyFor(refId);
+        const currentCount = this.kv.getNumber(refCountKey);
+        if (currentCount === undefined) {
+            // Already deleted or never existed
+            return;
+        }
+        const newCount = currentCount - 1;
+        if (newCount === 0) {
+            // Entity exists, cascade delete it
+            this.deleteValue(refId);
+        }
+        else {
+            this.kv.setNumber(refCountKey, newCount);
+        }
+    }
+}
+//# sourceMappingURL=QueryStore.js.map

package/dist/esm/QueryStore.js.map

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

package/dist/esm/errors.d.ts

@@ -0,0 +1,4 @@
+import { ObjectFieldTypeDef } from './types.js';
+export declare function typeToString(type: ObjectFieldTypeDef): string;
+export declare function typeError(path: string, expectedType: ObjectFieldTypeDef, 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,EAQL,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,YAAY,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAuG7D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAM/F"}

package/dist/esm/errors.js

@@ -0,0 +1,101 @@
+import { ARRAY_KEY, RECORD_KEY, } from './types.js';
+export function typeToString(type) {
+    // Handle Set-based constants/enums
+    if (type instanceof Set) {
+        const values = Array.from(type).map(v => (typeof v === 'string' ? `"${v}"` : String(v)));
+        return values.join(' | ');
+    }
+    // Handle constants
+    if (typeof type === 'string') {
+        return `"${type}"`;
+    }
+    if (typeof type === 'boolean') {
+        return String(type);
+    }
+    // Handle primitive masks
+    if (typeof type === 'number') {
+        const types = [];
+        if (type & 1 /* Mask.UNDEFINED */)
+            types.push('undefined');
+        if (type & 2 /* Mask.NULL */)
+            types.push('null');
+        if (type & 4 /* Mask.NUMBER */)
+            types.push('number');
+        if (type & 8 /* Mask.STRING */)
+            types.push('string');
+        if (type & 16 /* Mask.BOOLEAN */)
+            types.push('boolean');
+        if (type & 32 /* Mask.OBJECT */)
+            types.push('object');
+        if (type & 64 /* Mask.ARRAY */)
+            types.push('array');
+        if (types.length === 0) {
+            return 'unknown';
+        }
+        return types.length === 1 ? types[0] : types.join(' | ');
+    }
+    // Handle complex types - CHECK UNION FIRST since it contains other types
+    const mask = type.mask;
+    if (mask & 512 /* Mask.UNION */) {
+        const unionType = type;
+        const parts = [];
+        // Add primitive types from the mask
+        if (mask & 1 /* Mask.UNDEFINED */)
+            parts.push('undefined');
+        if (mask & 2 /* Mask.NULL */)
+            parts.push('null');
+        if (mask & 4 /* Mask.NUMBER */)
+            parts.push('number');
+        if (mask & 8 /* Mask.STRING */)
+            parts.push('string');
+        if (mask & 16 /* Mask.BOOLEAN */)
+            parts.push('boolean');
+        // Add const/enum values from the values Set
+        if (unionType.values !== undefined && unionType.values.size > 0) {
+            for (const val of unionType.values) {
+                const valStr = typeof val === 'string' ? `"${val}"` : String(val);
+                parts.push(valStr);
+            }
+        }
+        // Add complex types from the shape object
+        if (unionType.shape !== undefined) {
+            if (unionType.shape[ARRAY_KEY] !== undefined) {
+                parts.push(`Array<${typeToString(unionType.shape[ARRAY_KEY])}>`);
+            }
+            if (unionType.shape[RECORD_KEY] !== undefined) {
+                parts.push(`Record<string, ${typeToString(unionType.shape[RECORD_KEY])}>`);
+            }
+            // Add entity/object types by typename
+            for (const [key, value] of Object.entries(unionType.shape)) {
+                if (key !== ARRAY_KEY && key !== RECORD_KEY) {
+                    // key is the typename value (e.g., "User", "Post")
+                    parts.push(key);
+                }
+            }
+        }
+        if (parts.length === 0) {
+            return 'union';
+        }
+        return parts.join(' | ');
+    }
+    if (mask & 1024 /* Mask.ENTITY */) {
+        return `Entity<${type.typenameValue}>`;
+    }
+    if (mask & 64 /* Mask.ARRAY */) {
+        const shape = type.shape;
+        return `Array<${typeToString(shape)}>`;
+    }
+    if (mask & 256 /* Mask.RECORD */) {
+        const shape = type.shape;
+        return `Record<string, ${typeToString(shape)}>`;
+    }
+    if (mask & 32 /* Mask.OBJECT */) {
+        const typename = type.typenameValue;
+        return typename ? `Object<${typename}>` : 'object';
+    }
+    return 'unknown';
+}
+export function typeError(path, expectedType, value) {
+    return new TypeError(`Validation error at ${path}: expected ${typeToString(expectedType)}, got ${typeof value === 'object' ? (value === null ? 'null' : Array.isArray(value) ? 'array' : 'object') : typeof value}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export { QueryClient, QueryResultImpl as QueryResult } from './QueryClient.js';
+export type { QueryContext } from './QueryClient.js';
+export type { QueryStore } from './QueryStore.js';
+export { query } from './query.js';
+export type { ExtractType } from './query.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,eAAe,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { QueryClient, QueryResultImpl as QueryResult } from './QueryClient.js';
+export { query } from './query.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,eAAe,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/parseEntities.d.ts

@@ -0,0 +1,8 @@
+import { QueryClient } from './QueryClient.js';
+import { ComplexTypeDef, EntityDef, ObjectDef, UnionDef } from './types.js';
+export declare function parseUnionEntities(valueType: number, value: object | unknown[], unionDef: UnionDef, queryClient: QueryClient, entityRefs?: Set<number>): unknown;
+export declare function parseArrayEntities(array: unknown[], arrayShape: ComplexTypeDef, queryClient: QueryClient, entityRefs?: Set<number>): unknown[];
+export declare function parseRecordEntities(record: Record<string, unknown>, recordShape: ComplexTypeDef, queryClient: QueryClient, entityRefs?: Set<number>): Record<string, unknown>;
+export declare function parseObjectEntities(obj: Record<string, unknown>, objectShape: ObjectDef | EntityDef, queryClient: QueryClient, entityRefs?: Set<number>): Record<string, unknown>;
+export declare function parseEntities(value: unknown, def: ComplexTypeDef, queryClient: QueryClient, entityRefs?: Set<number>): unknown;
+//# 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":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAGL,cAAc,EACd,SAAS,EAET,SAAS,EAGT,QAAQ,EACT,MAAM,YAAY,CAAC;AAKpB,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EACzB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,CA+CT;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EAAE,EAChB,UAAU,EAAE,cAAc,EAC1B,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,EAAE,CAMX;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,cAAc,EAC3B,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,WAAW,EAAE,SAAS,GAAG,SAAS,EAClC,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkDzB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,WAAW,EACxB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,CA4CT"}