@signalium/query 0.0.0 → 0.0.2

package/dist/esm/QueryStore.js

@@ -0,0 +1,212 @@
+/**
+ * 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_GC_TIME = 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?.gcTime ?? DEFAULT_GC_TIME)) {
+            return;
+        }
+        const valueStr = this.kv.getString(valueKeyFor(queryKey));
+        if (valueStr === undefined) {
+            return;
+        }
+        const entityIds = this.kv.getBuffer(refIdsKeyFor(queryKey));
+        if (entityIds !== undefined) {
+            this.preloadEntities(entityIds, entityMap);
+        }
+        this.activateQuery(queryDef, queryKey);
+        return {
+            value: JSON.parse(valueStr),
+            updatedAt,
+        };
+    }
+    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":"AAAA;;;;;;GAMG;AA6DH,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,eAAe,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW;AAExD,MAAM,OAAO,qBAAqB;IACf,EAAE,GAA4B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEnE,GAAG,CAAC,GAAW;QACb,OAAO,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAuB,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAuB,CAAC;IAC5C,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAA4B,CAAC;IACjD,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,KAAkB;QACvC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;CACF;AAED,sBAAsB;AACtB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,gBAAgB,EAAE,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,mBAAmB,EAAE,EAAE,CAAC;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,iBAAiB,EAAE,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,oBAAoB,EAAE,EAAE,CAAC;AAExE,kBAAkB;AAClB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,gBAAgB,UAAU,EAAE,CAAC;AAEhF,MAAM,OAAO,cAAc;IAGI;IAF7B,MAAM,GAA6B,IAAI,GAAG,EAAE,CAAC;IAE7C,YAA6B,EAAuB;QAAvB,OAAE,GAAF,EAAE,CAAqB;IAAG,CAAC;IAExD,SAAS,CAAC,QAAmC,EAAE,QAAgB,EAAE,SAAsB;QACrF,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE/D,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC;YACpG,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE1D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE5D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEvC,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B;YACtD,SAAS;SACV,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,SAAsB,EAAE,SAAsB;QACpE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE7D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAA4B,CAAC;YAClE,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;YAE3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,SAAS,CAAC,QAAmC,EAAE,QAAgB,EAAE,KAAc,EAAE,MAAoB;QACnG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,UAAU,CAAC,SAAiB,EAAE,KAAc,EAAE,MAAoB;QAChE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,aAAa,CAAC,QAAmC,EAAE,QAAgB;QACjE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACxC,sEAAsE;YACtE,8DAA8D;YAC9D,OAAO;QACT,CAAC;QAED,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,IAAI,iBAAiB,CAAC;YAC/D,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;YAEpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,KAAK,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAClC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAC3C,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBACpB,KAAK,GAAG,QAAQ,CAAC;gBACjB,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE3C,uCAAuC;QACvC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,kCAAkC;gBAClC,OAAO;YACT,CAAC;YACD,2CAA2C;YAC3C,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;YACnC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;YACpB,OAAO;QACT,CAAC;QAED,iDAAiD;QACjD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;QAEpB,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,EAAU,EAAE,KAAc,EAAE,MAAoB;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAEnB,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAErD,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;QAEnC,MAAM,UAAU,GAAG,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9C,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAErB,8BAA8B;YAC9B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAC5B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,oCAAoC;YACpC,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,4CAA4C;gBAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;oBAE5B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;wBACtB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACvB,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,kDAAkD;YAClD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;YAED,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,EAAU;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAEnB,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,0BAA0B;QAEvD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,mDAAmD;QACnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACrC,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACrC,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAEpD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,mCAAmC;YACnC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,GAAG,CAAC,CAAC;QAElC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,mCAAmC;YACnC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF"}

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"}

package/dist/esm/parseEntities.js

@@ -0,0 +1,120 @@
+// -----------------------------------------------------------------------------
+// Entity System
+// -----------------------------------------------------------------------------
+import { hashValue } from 'signalium/utils';
+import { ARRAY_KEY, RECORD_KEY, } from './types.js';
+import { extractShape, typeMaskOf } from './utils.js';
+const entries = Object.entries;
+export function parseUnionEntities(valueType, value, unionDef, queryClient, entityRefs) {
+    if (valueType === 64 /* Mask.ARRAY */) {
+        const shape = unionDef.shape[ARRAY_KEY];
+        if (shape === undefined || typeof shape === 'number') {
+            return value;
+        }
+        return parseArrayEntities(value, { mask: 64 /* Mask.ARRAY */, shape, values: undefined }, queryClient, entityRefs);
+    }
+    else {
+        // Use the cached typename field from the union definition
+        const typenameField = unionDef.typenameField;
+        const typename = typenameField ? value[typenameField] : undefined;
+        if (typename === undefined || typeof typename !== 'string') {
+            const recordShape = unionDef.shape[RECORD_KEY];
+            if (recordShape === undefined || typeof recordShape === 'number') {
+                return value;
+            }
+            return parseRecordEntities(value, recordShape, queryClient, entityRefs);
+        }
+        const matchingDef = unionDef.shape[typename];
+        if (matchingDef === undefined || typeof matchingDef === 'number') {
+            return value;
+        }
+        return parseObjectEntities(value, matchingDef, queryClient, entityRefs);
+    }
+}
+export function parseArrayEntities(array, arrayShape, queryClient, entityRefs) {
+    for (let i = 0; i < array.length; i++) {
+        array[i] = parseEntities(array[i], arrayShape, queryClient, entityRefs);
+    }
+    return array;
+}
+export function parseRecordEntities(record, recordShape, queryClient, entityRefs) {
+    if (typeof recordShape === 'number') {
+        return record;
+    }
+    for (const [key, value] of entries(record)) {
+        record[key] = parseEntities(value, recordShape, queryClient, entityRefs);
+    }
+    return record;
+}
+export function parseObjectEntities(obj, objectShape, queryClient, entityRefs) {
+    const entityRefId = obj.__entityRef;
+    // Check if this is an entity reference (from cache)
+    if (typeof entityRefId === 'number') {
+        return queryClient.hydrateEntity(entityRefId, objectShape).proxy;
+    }
+    // Process sub-entity paths (only these paths can contain entities)
+    const { mask } = objectShape;
+    const childRefs = mask & 1024 /* Mask.ENTITY */ ? new Set() : entityRefs;
+    // Extract shape first to resolve lazy definitions and set subEntityPaths
+    const shape = extractShape(objectShape);
+    const subEntityPaths = objectShape.subEntityPaths;
+    if (subEntityPaths !== undefined) {
+        if (typeof subEntityPaths === 'string') {
+            // Single path - avoid array allocation
+            const propDef = shape[subEntityPaths];
+            obj[subEntityPaths] = parseEntities(obj[subEntityPaths], propDef, queryClient, childRefs);
+        }
+        else {
+            // Multiple paths - iterate directly
+            for (const path of subEntityPaths) {
+                const propDef = shape[path];
+                obj[path] = parseEntities(obj[path], propDef, queryClient, childRefs);
+            }
+        }
+    }
+    // Handle entity replacement (entities get cached and replaced with proxies)
+    if (mask & 1024 /* Mask.ENTITY */) {
+        const entityDef = objectShape;
+        const typename = entityDef.typenameValue;
+        const id = obj[entityDef.idField];
+        const desc = `${typename}:${id}`;
+        const key = hashValue(desc);
+        // Add this entity's key to the parent's entityRefs (if provided)
+        if (entityRefs !== undefined) {
+            entityRefs.add(key);
+        }
+        return queryClient.saveEntity(key, obj, entityDef, childRefs).proxy;
+    }
+    // Return the processed object (even if not an entity)
+    return obj;
+}
+export function parseEntities(value, def, queryClient, entityRefs) {
+    const valueType = typeMaskOf(value);
+    const defType = def.mask;
+    // Skip primitives and incompatible types - they can't contain entities
+    // Note: We silently return incompatible values rather than erroring
+    if (valueType < 32 /* Mask.OBJECT */ || (defType & valueType) === 0) {
+        return value;
+    }
+    // Handle unions first - they can contain multiple types, and all of the union
+    // logic is handled above, so we return early here if it's a union
+    if ((defType & 512 /* Mask.UNION */) !== 0) {
+        return parseUnionEntities(valueType, value, def, queryClient, entityRefs);
+    }
+    // If it's not a union, AND the value IS an array, then the definition must
+    // be an ArrayDef, so we can cast safely here
+    if (valueType === 64 /* Mask.ARRAY */) {
+        return parseArrayEntities(value, def.shape, queryClient, entityRefs);
+    }
+    // Now we know the value is an object, so def must be a RecordDef, ObjectDef
+    // or EntityDef. We first check to see if it's a RecordDef, and if so, we can
+    // cast it here and return early.
+    if ((defType & 256 /* Mask.RECORD */) !== 0) {
+        return parseRecordEntities(value, def.shape, queryClient, entityRefs);
+    }
+    // Now we know the def is an ObjectDef or EntityDef. These are both handled
+    // the same way _mostly_, with Entities just returning a proxy instead of the
+    // object itself
+    return parseObjectEntities(value, def, queryClient, entityRefs);
+}
+//# sourceMappingURL=parseEntities.js.map

package/dist/esm/parseEntities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseEntities.js","sourceRoot":"","sources":["../../src/parseEntities.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,SAAS,EAMT,UAAU,GAGX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;AAE/B,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,KAAyB,EACzB,QAAkB,EAClB,WAAwB,EACxB,UAAwB;IAExB,IAAI,SAAS,wBAAe,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAM,CAAC,SAAS,CAAC,CAAC;QAEzC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,kBAAkB,CACvB,KAAkB,EAClB,EAAE,IAAI,qBAAY,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAc,EAC1D,WAAW,EACX,UAAU,CACX,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,0DAA0D;QAC1D,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC;QAC7C,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAE,KAAiC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/F,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAM,CAAC,UAAU,CAAC,CAAC;YAEhD,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;gBACjE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,mBAAmB,CACxB,KAAgC,EAChC,WAA6B,EAC7B,WAAW,EACX,UAAU,CACX,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAM,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,mBAAmB,CACxB,KAAgC,EAChC,WAAoC,EACpC,WAAW,EACX,UAAU,CACX,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAgB,EAChB,UAA0B,EAC1B,WAAwB,EACxB,UAAwB;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,WAA2B,EAC3B,WAAwB,EACxB,UAAwB;IAExB,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,GAA4B,EAC5B,WAAkC,EAClC,WAAwB,EACxB,UAAwB;IAExB,MAAM,WAAW,GAAG,GAAG,CAAC,WAAqB,CAAC;IAE9C,oDAAoD;IACpD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC,aAAa,CAAC,WAAW,EAAE,WAAwB,CAAC,CAAC,KAAK,CAAC;IAChF,CAAC;IAED,mEAAmE;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;IAE7B,MAAM,SAAS,GAAG,IAAI,yBAAc,CAAC,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAEtE,yEAAyE;IACzE,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,WAAW,CAAC,cAAc,CAAC;IAElD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;YACvC,uCAAuC;YACvC,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;YACtC,GAAG,CAAC,cAAc,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,OAAyB,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QAC9G,CAAC;aAAM,CAAC;YACN,oCAAoC;YACpC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC5B,GAAG,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAyB,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,IAAI,IAAI,yBAAc,EAAE,CAAC;QACvB,MAAM,SAAS,GAAG,WAAwB,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,aAAa,CAAC;QACzC,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAElC,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE5B,iEAAiE;QACjE,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,WAAW,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC;IACtE,CAAC;IAED,sDAAsD;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,GAAmB,EACnB,WAAwB,EACxB,UAAwB;IAExB,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;IAEzB,uEAAuE;IACvE,oEAAoE;IACpE,IAAI,SAAS,uBAAc,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,kEAAkE;IAClE,IAAI,CAAC,OAAO,uBAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,kBAAkB,CACvB,SAAS,EACT,KAA4C,EAC5C,GAAe,EACf,WAAW,EACX,UAAU,CACX,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,6CAA6C;IAC7C,IAAI,SAAS,wBAAe,EAAE,CAAC;QAC7B,OAAO,kBAAkB,CAAC,KAAkB,EAAG,GAAgB,CAAC,KAAuB,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACpH,CAAC;IAED,4EAA4E;IAC5E,6EAA6E;IAC7E,iCAAiC;IACjC,IAAI,CAAC,OAAO,wBAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,mBAAmB,CACxB,KAAgC,EAC/B,GAAiB,CAAC,KAAuB,EAC1C,WAAW,EACX,UAAU,CACX,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,6EAA6E;IAC7E,gBAAgB;IAChB,OAAO,mBAAmB,CAAC,KAAgC,EAAE,GAA4B,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AACtH,CAAC"}

package/dist/esm/pathInterpolator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Path interpolation utilities for URL templates with parameter substitution.
+ *
+ * Converts path templates like "/users/{userId}/posts/{postId}" into functions
+ * that efficiently interpolate parameter values.
+ *
+ * The implementation pre-parses the path template once into segments and parameter
+ * keys, then uses simple string concatenation at runtime for optimal performance.
+ */
+export type PathInterpolator = (params: Record<string, any>) => string;
+/**
+ * Creates an optimized path interpolation function from a URL template.
+ *
+ * The template uses curly braces for parameters (e.g., "/items/{id}").
+ * Parameter values are URL-encoded when interpolated. Any parameters not
+ * found in the path template are appended as query string parameters.
+ *
+ * @param pathTemplate - URL template with {paramName} placeholders
+ * @returns Function that interpolates parameters into the path with search params
+ *
+ * @example
+ * ```ts
+ * const interpolate = createPathInterpolator('/users/{userId}/posts/{postId}');
+ * const url = interpolate({ userId: '123', postId: '456', page: 2, limit: 10 });
+ * // Returns: "/users/123/posts/456?page=2&limit=10"
+ * ```
+ */
+export declare function createPathInterpolator(pathTemplate: string): PathInterpolator;
+//# sourceMappingURL=pathInterpolator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathInterpolator.d.ts","sourceRoot":"","sources":["../../src/pathInterpolator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CA4C7E"}

package/dist/esm/pathInterpolator.js

@@ -0,0 +1,66 @@
+/**
+ * Path interpolation utilities for URL templates with parameter substitution.
+ *
+ * Converts path templates like "/users/{userId}/posts/{postId}" into functions
+ * that efficiently interpolate parameter values.
+ *
+ * The implementation pre-parses the path template once into segments and parameter
+ * keys, then uses simple string concatenation at runtime for optimal performance.
+ */
+/**
+ * Creates an optimized path interpolation function from a URL template.
+ *
+ * The template uses curly braces for parameters (e.g., "/items/{id}").
+ * Parameter values are URL-encoded when interpolated. Any parameters not
+ * found in the path template are appended as query string parameters.
+ *
+ * @param pathTemplate - URL template with {paramName} placeholders
+ * @returns Function that interpolates parameters into the path with search params
+ *
+ * @example
+ * ```ts
+ * const interpolate = createPathInterpolator('/users/{userId}/posts/{postId}');
+ * const url = interpolate({ userId: '123', postId: '456', page: 2, limit: 10 });
+ * // Returns: "/users/123/posts/456?page=2&limit=10"
+ * ```
+ */
+export function createPathInterpolator(pathTemplate) {
+    // Pre-parse path into segments and param keys (parse once, concatenate many times)
+    const segments = [];
+    const paramKeys = [];
+    const paramKeysSet = new Set();
+    let lastIndex = 0;
+    const paramRegex = /\[([^\]]+)\]/g;
+    let match;
+    while ((match = paramRegex.exec(pathTemplate)) !== null) {
+        segments.push(pathTemplate.slice(lastIndex, match.index));
+        paramKeys.push(match[1]);
+        paramKeysSet.add(match[1]);
+        lastIndex = paramRegex.lastIndex;
+    }
+    segments.push(pathTemplate.slice(lastIndex));
+    // Return optimized interpolation function with pre-parsed segments
+    return (params) => {
+        // Build the path with interpolated path parameters
+        let result = segments[0];
+        for (let i = 0; i < paramKeys.length; i++) {
+            result += encodeURIComponent(String(params[paramKeys[i]])) + segments[i + 1];
+        }
+        // Collect remaining parameters as search params
+        let searchParams = null;
+        for (const key in params) {
+            if (!paramKeysSet.has(key) && params[key] !== undefined) {
+                if (searchParams === null) {
+                    searchParams = new URLSearchParams();
+                }
+                searchParams.append(key, String(params[key]));
+            }
+        }
+        // Append search params if any exist
+        if (searchParams !== null) {
+            result += '?' + searchParams.toString();
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=pathInterpolator.js.map

package/dist/esm/pathInterpolator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathInterpolator.js","sourceRoot":"","sources":["../../src/pathInterpolator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAoB;IACzD,mFAAmF;IACnF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,UAAU,GAAG,eAAe,CAAC;IACnC,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7C,mEAAmE;IACnE,OAAO,CAAC,MAA2B,EAAU,EAAE;QAC7C,mDAAmD;QACnD,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,CAAC;QAED,gDAAgD;QAChD,IAAI,YAAY,GAA2B,IAAI,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACxD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC1B,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;gBACvC,CAAC;gBAED,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC1C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/esm/proxy.d.ts

@@ -0,0 +1,8 @@
+import { ComplexTypeDef, EntityDef, ObjectDef, ObjectFieldTypeDef, TypeDef } from './types.js';
+import { PreloadedEntityRecord } from './EntityMap.js';
+export declare function parseArrayValue(array: unknown[], arrayShape: TypeDef, path: string): unknown[];
+export declare function parseRecordValue(record: Record<string, unknown>, recordShape: ComplexTypeDef, path: string): Record<string, unknown>;
+export declare function parseObjectValue(object: Record<string, unknown>, objectShape: ObjectDef | EntityDef, path: string): Record<string, unknown>;
+export declare function parseValue(value: unknown, propDef: ObjectFieldTypeDef, path: string): unknown;
+export declare function createEntityProxy(id: number, entityRecord: PreloadedEntityRecord, def: ObjectDef | EntityDef, desc?: string): Record<string, unknown>;
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,cAAc,EACd,SAAS,EAET,SAAS,EAET,kBAAkB,EAElB,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AA6CvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAMlF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,2BAM1G;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,SAAS,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,2BAcjH;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAyE7F;AAID,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,qBAAqB,EACnC,GAAG,EAAE,SAAS,GAAG,SAAS,EAC1B,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkFzB"}