@signalium/query 0.0.0 → 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,12 @@
+
+> @signalium/query@0.0.1 build
+> npm run build:esm && npm run build:cjs
+
+
+> @signalium/query@0.0.1 build:esm
+> tsc --build tsconfig.esm.json
+
+
+> @signalium/query@0.0.1 build:cjs
+> tsc --build tsconfig.cjs.json
+

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @signalium/query
+
+## 0.0.1
+
+### Patch Changes
+
+- e6c39ee: Initial Signalium Query release
+- Updated dependencies [e6c39ee]
+  - signalium@2.0.7

package/dist/cjs/EntityMap.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityStore = void 0;
+const signalium_1 = require("signalium");
+const proxy_js_1 = require("./proxy.js");
+class EntityStore {
+    map = new Map();
+    hasEntity(key) {
+        return this.map.has(key);
+    }
+    getEntity(key) {
+        return this.map.get(key);
+    }
+    hydratePreloadedEntity(key, shape) {
+        const record = this.getEntity(key);
+        if (record === undefined) {
+            throw new Error(`Entity ${key} not found`);
+        }
+        record.proxy = (0, proxy_js_1.createEntityProxy)(key, record, shape);
+        return record;
+    }
+    setPreloadedEntity(key, obj) {
+        const record = {
+            key,
+            signal: (0, signalium_1.signal)(obj),
+            cache: new Map(),
+            proxy: undefined,
+        };
+        this.map.set(key, record);
+        return record;
+    }
+    setEntity(key, obj, shape) {
+        let record = this.map.get(key);
+        if (record === undefined) {
+            record = this.setPreloadedEntity(key, obj);
+            record.proxy = (0, proxy_js_1.createEntityProxy)(key, record, shape);
+        }
+        else {
+            record.signal.value = obj;
+            record.cache.clear();
+        }
+        return record;
+    }
+}
+exports.EntityStore = EntityStore;
+//# sourceMappingURL=EntityMap.js.map

package/dist/cjs/EntityMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMap.js","sourceRoot":"","sources":["../../src/EntityMap.ts"],"names":[],"mappings":";;;AAAA,yCAA2C;AAE3C,yCAA+C;AAW/C,MAAa,WAAW;IACd,GAAG,GAAG,IAAI,GAAG,EAAgD,CAAC;IAEtE,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,sBAAsB,CAAC,GAAW,EAAE,KAAgB;QAClD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,YAAY,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,IAAA,4BAAiB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAErD,OAAO,MAAsB,CAAC;IAChC,CAAC;IAED,kBAAkB,CAAC,GAAW,EAAE,GAA4B;QAC1D,MAAM,MAAM,GAA0B;YACpC,GAAG;YACH,MAAM,EAAE,IAAA,kBAAM,EAAC,GAAG,CAAC;YACnB,KAAK,EAAE,IAAI,GAAG,EAAE;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC;QAEF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,CAAC,GAAW,EAAE,GAA4B,EAAE,KAAgB;QACnE,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAE3C,MAAM,CAAC,KAAK,GAAG,IAAA,4BAAiB,EAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QAED,OAAO,MAAsB,CAAC;IAChC,CAAC;CACF;AAjDD,kCAiDC"}

package/dist/cjs/QueryClient.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryClientContext = exports.QueryClient = exports.QueryResultImpl = void 0;
+const signalium_1 = require("signalium");
+const utils_1 = require("signalium/utils");
+const proxy_js_1 = require("./proxy.js");
+const parseEntities_js_1 = require("./parseEntities.js");
+const EntityMap_js_1 = require("./EntityMap.js");
+const typeDefs_js_1 = require("./typeDefs.js");
+const queryKeyFor = (queryDef, params) => {
+    return (0, utils_1.hashValue)([queryDef.id, params]);
+};
+/**
+ * QueryResult wraps a DiscriminatedReactivePromise and adds additional functionality
+ * like refetch, while forwarding all the base relay properties.
+ */
+class QueryResultImpl {
+    relay;
+    instance;
+    constructor(relay, instance) {
+        this.relay = relay;
+        this.instance = instance;
+        (0, utils_1.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';
+    }
+}
+exports.QueryResultImpl = QueryResultImpl;
+class QueryClient {
+    store;
+    context;
+    entityMap = new EntityMap_js_1.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: (0, signalium_1.notifier)(),
+            };
+            const queryRelay = (0, signalium_1.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 typeDefs_js_1.ValidatorDef
+                        ? (0, parseEntities_js_1.parseEntities)(query, shape, this, new Set())
+                        : (0, proxy_js_1.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 typeDefs_js_1.ValidatorDef
+            ? (0, parseEntities_js_1.parseEntities)(freshData, shape, this, entityRefs)
+            : (0, proxy_js_1.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;
+    }
+}
+exports.QueryClient = QueryClient;
+exports.QueryClientContext = (0, signalium_1.context)(undefined);
+//# sourceMappingURL=QueryClient.js.map

package/dist/cjs/QueryClient.js.map

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

package/dist/cjs/QueryStore.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncQueryStore = exports.queueKeyFor = exports.updatedAtKeyFor = exports.refIdsKeyFor = exports.refCountKeyFor = exports.valueKeyFor = exports.MemoryPersistentStore = void 0;
+const DEFAULT_MAX_COUNT = 50;
+const DEFAULT_MAX_AGE = 1000 * 60 * 60 * 24; // 24 hours
+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];
+    }
+}
+exports.MemoryPersistentStore = MemoryPersistentStore;
+// Query Instance keys
+const valueKeyFor = (id) => `sq:doc:value:${id}`;
+exports.valueKeyFor = valueKeyFor;
+const refCountKeyFor = (id) => `sq:doc:refCount:${id}`;
+exports.refCountKeyFor = refCountKeyFor;
+const refIdsKeyFor = (id) => `sq:doc:refIds:${id}`;
+exports.refIdsKeyFor = refIdsKeyFor;
+const updatedAtKeyFor = (id) => `sq:doc:updatedAt:${id}`;
+exports.updatedAtKeyFor = updatedAtKeyFor;
+// Query Type keys
+const queueKeyFor = (queryDefId) => `sq:doc:queue:${queryDefId}`;
+exports.queueKeyFor = queueKeyFor;
+class SyncQueryStore {
+    kv;
+    queues = new Map();
+    constructor(kv) {
+        this.kv = kv;
+    }
+    loadQuery(queryDef, queryKey, entityMap) {
+        const updatedAt = this.kv.getNumber((0, exports.updatedAtKeyFor)(queryKey));
+        if (updatedAt === undefined || updatedAt < Date.now() - (queryDef.cache?.maxAge ?? DEFAULT_MAX_AGE)) {
+            return;
+        }
+        const value = this.kv.getString((0, exports.valueKeyFor)(queryKey));
+        if (value === undefined) {
+            return;
+        }
+        const entityIds = this.kv.getBuffer((0, exports.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((0, exports.valueKeyFor)(entityId));
+            if (entityValue === undefined) {
+                continue;
+            }
+            const entity = JSON.parse(entityValue);
+            entityMap.setPreloadedEntity(entityId, entity);
+            const childIds = this.kv.getBuffer((0, exports.refIdsKeyFor)(entityId));
+            if (childIds === undefined) {
+                continue;
+            }
+            this.preloadEntities(childIds, entityMap);
+        }
+    }
+    saveQuery(queryDef, queryKey, value, refIds) {
+        this.setValue(queryKey, value, refIds);
+        this.kv.setNumber((0, exports.updatedAtKeyFor)(queryKey), Date.now());
+        this.activateQuery(queryDef, queryKey);
+    }
+    saveEntity(entityKey, value, refIds) {
+        this.setValue(entityKey, value, refIds);
+    }
+    activateQuery(queryDef, queryKey) {
+        if (!this.kv.has((0, exports.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((0, exports.queueKeyFor)(queryDef.id));
+            if (queue === undefined) {
+                queue = new Uint32Array(maxCount);
+                this.kv.setBuffer((0, exports.queueKeyFor)(queryDef.id), queue);
+            }
+            else if (queue.length !== maxCount) {
+                const newQueue = new Uint32Array(maxCount);
+                newQueue.set(queue);
+                queue = newQueue;
+                this.kv.setBuffer((0, exports.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((0, exports.updatedAtKeyFor)(evicted));
+        }
+    }
+    setValue(id, value, refIds) {
+        const kv = this.kv;
+        kv.setString((0, exports.valueKeyFor)(id), JSON.stringify(value));
+        const refIdsKey = (0, exports.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((0, exports.valueKeyFor)(id));
+        kv.delete((0, exports.refCountKeyFor)(id));
+        const refIds = kv.getBuffer((0, exports.refIdsKeyFor)(id));
+        kv.delete((0, exports.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 = (0, exports.refCountKeyFor)(refId);
+        const currentCount = this.kv.getNumber(refCountKey) ?? 0;
+        const newCount = currentCount + 1;
+        this.kv.setNumber(refCountKey, newCount);
+    }
+    decrementRefCount(refId) {
+        const refCountKey = (0, exports.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);
+        }
+    }
+}
+exports.SyncQueryStore = SyncQueryStore;
+//# sourceMappingURL=QueryStore.js.map

package/dist/cjs/QueryStore.js.map

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

package/dist/cjs/errors.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeToString = typeToString;
+exports.typeError = typeError;
+const types_js_1 = require("./types.js");
+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[types_js_1.ARRAY_KEY] !== undefined) {
+                parts.push(`Array<${typeToString(unionType.shape[types_js_1.ARRAY_KEY])}>`);
+            }
+            if (unionType.shape[types_js_1.RECORD_KEY] !== undefined) {
+                parts.push(`Record<string, ${typeToString(unionType.shape[types_js_1.RECORD_KEY])}>`);
+            }
+            // Add entity/object types by typename
+            for (const [key, value] of Object.entries(unionType.shape)) {
+                if (key !== types_js_1.ARRAY_KEY && key !== types_js_1.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';
+}
+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/cjs/errors.js.map

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

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = exports.QueryResult = exports.QueryClient = void 0;
+__exportStar(require("./types.js"), exports);
+var QueryClient_js_1 = require("./QueryClient.js");
+Object.defineProperty(exports, "QueryClient", { enumerable: true, get: function () { return QueryClient_js_1.QueryClient; } });
+Object.defineProperty(exports, "QueryResult", { enumerable: true, get: function () { return QueryClient_js_1.QueryResultImpl; } });
+var query_js_1 = require("./query.js");
+Object.defineProperty(exports, "query", { enumerable: true, get: function () { return query_js_1.query; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAE3B,mDAA+E;AAAtE,6GAAA,WAAW,OAAA;AAAE,6GAAA,eAAe,OAAe;AAGpD,uCAAmC;AAA1B,iGAAA,KAAK,OAAA"}