@signalium/query 0.0.0 → 0.0.1

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

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

package/dist/esm/proxy.js

@@ -0,0 +1,180 @@
+import { typeError } from './errors.js';
+import { getFormat } from './typeDefs.js';
+import { ARRAY_KEY, RECORD_KEY, } from './types.js';
+import { extractShape, typeMaskOf } from './utils.js';
+const entries = Object.entries;
+const PROXY_BRAND = new WeakSet();
+function parseUnionValue(valueType, value, unionDef, path) {
+    if (valueType === 64 /* Mask.ARRAY */) {
+        const shape = unionDef.shape[ARRAY_KEY];
+        if (shape === undefined || typeof shape === 'number') {
+            return value;
+        }
+        return parseArrayValue(value, shape, path);
+    }
+    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 parseRecordValue(value, recordShape, path);
+        }
+        const matchingDef = unionDef.shape[typename];
+        if (matchingDef === undefined || typeof matchingDef === 'number') {
+            return value;
+        }
+        return parseObjectValue(value, matchingDef, path);
+    }
+}
+export function parseArrayValue(array, arrayShape, path) {
+    for (let i = 0; i < array.length; i++) {
+        array[i] = parseValue(array[i], arrayShape, `${path}[${i}]`);
+    }
+    return array;
+}
+export function parseRecordValue(record, recordShape, path) {
+    for (const [key, value] of entries(record)) {
+        record[key] = parseValue(value, recordShape, `${path}["${key}"]`);
+    }
+    return record;
+}
+export function parseObjectValue(object, objectShape, path) {
+    if (PROXY_BRAND.has(object)) {
+        // Is an entity proxy, so return it directly
+        return object;
+    }
+    const shape = extractShape(objectShape);
+    for (const [key, propShape] of entries(shape)) {
+        // parse and replace the property in place
+        object[key] = parseValue(object[key], propShape, `${path}.${key}`);
+    }
+    return object;
+}
+export function parseValue(value, propDef, path) {
+    // Handle Set-based constants/enums
+    if (propDef instanceof Set) {
+        if (!propDef.has(value)) {
+            throw typeError(path, propDef, value);
+        }
+        return value;
+    }
+    switch (typeof propDef) {
+        case 'string':
+            if (value !== propDef) {
+                throw typeError(path, propDef, value);
+            }
+            return value;
+        // handle primitives
+        case 'number': {
+            let valueType = typeMaskOf(value);
+            if ((propDef & valueType) === 0) {
+                throw typeError(path, propDef, value);
+            }
+            if ((propDef & 4096 /* Mask.HAS_NUMBER_FORMAT */) !== 0 && valueType === 4 /* Mask.NUMBER */) {
+                return getFormat(propDef)(value);
+            }
+            if ((propDef & 8192 /* Mask.HAS_STRING_FORMAT */) !== 0 && valueType === 8 /* Mask.STRING */) {
+                return getFormat(propDef)(value);
+            }
+            return value;
+        }
+        // handle complex objects
+        default: {
+            // Note: Keep in mind that at this point, we're using `valueType`
+            // primarily, so some of the logic is "reversed" from the above where
+            // we use the `propDef` type primarily
+            let valueType = typeMaskOf(value);
+            const propMask = propDef.mask;
+            // Check if the value type is allowed by the propMask
+            // Also check if it's in a values set (for enums/constants stored in ValidatorDef)
+            if ((propMask & valueType) === 0 && !propDef.values?.has(value)) {
+                throw typeError(path, propMask, value);
+            }
+            if (valueType < 32 /* Mask.OBJECT */) {
+                if ((propMask & 4096 /* Mask.HAS_NUMBER_FORMAT */) !== 0 && valueType === 4 /* Mask.NUMBER */) {
+                    return getFormat(propMask)(value);
+                }
+                if ((propMask & 8192 /* Mask.HAS_STRING_FORMAT */) !== 0 && valueType === 8 /* Mask.STRING */) {
+                    return getFormat(propMask)(value);
+                }
+                // value is a primitive, it has already passed the mask so return it now
+                return value;
+            }
+            if ((valueType & 512 /* Mask.UNION */) !== 0) {
+                return parseUnionValue(valueType, value, propDef, path);
+            }
+            if (valueType === 64 /* Mask.ARRAY */) {
+                return parseArrayValue(value, propDef.shape, path);
+            }
+            return parseObjectValue(value, propDef, path);
+        }
+    }
+}
+const CustomNodeInspect = Symbol.for('nodejs.util.inspect.custom');
+export function createEntityProxy(id, entityRecord, def, desc) {
+    // Cache for nested proxies - each proxy gets its own cache
+    const shape = extractShape(def);
+    const toJSON = () => ({
+        __entityRef: id,
+    });
+    const handler = {
+        get(target, prop) {
+            // Handle toJSON for serialization
+            if (prop === 'toJSON') {
+                return toJSON;
+            }
+            const { signal, cache } = entityRecord;
+            const obj = signal.value;
+            // Check cache first, BEFORE any expensive checks
+            if (cache.has(prop)) {
+                return cache.get(prop);
+            }
+            let value = obj[prop];
+            let propDef = shape[prop];
+            if (!Object.hasOwnProperty.call(shape, prop)) {
+                return value;
+            }
+            const parsed = parseValue(value, propDef, `[[${desc}]].${prop}`);
+            cache.set(prop, parsed);
+            return parsed;
+        },
+        has(target, prop) {
+            return prop in shape;
+        },
+        ownKeys(target) {
+            const keys = Object.keys(shape);
+            // Add typename field if it exists on the definition
+            const typenameField = def.typenameField;
+            if (typenameField && !keys.includes(typenameField)) {
+                keys.push(typenameField);
+            }
+            return keys;
+        },
+        getOwnPropertyDescriptor(target, prop) {
+            const typenameField = def.typenameField;
+            if (prop in shape || prop === typenameField) {
+                return {
+                    enumerable: true,
+                    configurable: true,
+                };
+            }
+            return undefined;
+        },
+    };
+    const proxy = new Proxy({
+        [CustomNodeInspect]: () => {
+            return Object.keys(shape).reduce((acc, key) => {
+                acc[key] = proxy[key];
+                return acc;
+            }, {});
+        },
+    }, handler);
+    // Add the proxy to the proxy brand set so we can easily identify it later
+    PROXY_BRAND.add(proxy);
+    return proxy;
+}
+//# sourceMappingURL=proxy.js.map

package/dist/esm/proxy.js.map

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

package/dist/esm/query.d.ts

@@ -0,0 +1,40 @@
+import { APITypes, ArrayDef, DiscriminatedQueryResult, EntityDef, Mask, ObjectDef, RecordDef, ObjectFieldTypeDef, UnionDef } from './types.js';
+import { QueryCacheOptions } from './QueryClient.js';
+type ExtractPrimitiveTypeFromMask<T extends number> = T extends Mask.UNDEFINED ? undefined : T extends Mask.NULL ? null : T extends Mask.NUMBER ? number : T extends Mask.STRING ? string : T extends Mask.BOOLEAN ? boolean : T extends Mask.ID ? string : never;
+export type ExtractType<T extends ObjectFieldTypeDef | string> = T extends number ? ExtractPrimitiveTypeFromMask<T> : T extends string ? T : T extends Set<infer TSet> ? TSet : T extends ObjectDef<infer S> ? Prettify<ExtractTypesFromShape<S>> : T extends EntityDef<infer S> ? Prettify<ExtractTypesFromShape<S>> : T extends ArrayDef<infer S> ? ExtractType<S>[] : T extends RecordDef<infer S> ? Record<string, ExtractType<S>> : T extends UnionDef<infer VS> ? ExtractType<VS[number]> : never;
+type ExtractTypesFromShape<S extends Record<string, ObjectFieldTypeDef | string>> = {
+    [K in keyof S]: ExtractType<S[K]>;
+};
+type IsParameter<Part> = Part extends `[${infer ParamName}]` ? ParamName : never;
+type FilteredParts<Path> = Path extends `${infer PartA}/${infer PartB}` ? IsParameter<PartA> | FilteredParts<PartB> : IsParameter<Path>;
+type ParamValue<Key> = Key extends `...${infer Anything}` ? (string | number)[] : string | number;
+type RemovePrefixDots<Key> = Key extends `...${infer Name}` ? Name : Key;
+type PathParams<Path> = {
+    [Key in FilteredParts<Path> as RemovePrefixDots<Key>]: ParamValue<Key>;
+};
+interface RESTQueryDefinition {
+    path: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    searchParams?: Record<string, ObjectFieldTypeDef>;
+    response: Record<string, ObjectFieldTypeDef> | ObjectFieldTypeDef;
+    cache?: QueryCacheOptions;
+}
+type ExtractTypesFromObjectOrTypeDef<S extends Record<string, ObjectFieldTypeDef> | ObjectFieldTypeDef | undefined> = S extends Record<string, ObjectFieldTypeDef> ? {
+    [K in keyof S]: ExtractType<S[K]>;
+} : S extends ObjectFieldTypeDef ? ExtractType<S> : {};
+type QueryParams<QDef extends RESTQueryDefinition> = PathParams<QDef['path']> & ExtractTypesFromObjectOrTypeDef<QDef['searchParams']>;
+type QueryParamsOrUndefined<QDef extends RESTQueryDefinition> = {} extends QueryParams<QDef> ? undefined : QueryParams<QDef>;
+type HasRequiredKeys<T> = {} extends T ? false : {
+    [K in keyof T]: undefined;
+} extends T ? false : true;
+type Optionalize<T> = T extends object ? {
+    -readonly [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+} & {
+    -readonly [K in keyof T as undefined extends T[K] ? K : never]?: T[K];
+} : T;
+type Prettify<T> = T extends object ? {
+    -readonly [K in keyof T]: T[K];
+} & {} : T;
+export declare function query<const QDef extends RESTQueryDefinition>(queryDefinitionBuilder: (t: APITypes) => QDef): (...args: HasRequiredKeys<QueryParams<QDef>> extends true ? [params: Prettify<Optionalize<QueryParams<QDef>>>] : [params?: Prettify<Optionalize<QueryParamsOrUndefined<QDef>>>]) => DiscriminatedQueryResult<Readonly<Prettify<ExtractTypesFromObjectOrTypeDef<QDef['response']>>>>;
+export {};
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,wBAAwB,EACxB,SAAS,EACT,IAAI,EACJ,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAqD,MAAM,kBAAkB,CAAC;AAIxG,KAAK,4BAA4B,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,GAC1E,SAAS,GACT,CAAC,SAAS,IAAI,CAAC,IAAI,GACjB,IAAI,GACJ,CAAC,SAAS,IAAI,CAAC,MAAM,GACnB,MAAM,GACN,CAAC,SAAS,IAAI,CAAC,MAAM,GACnB,MAAM,GACN,CAAC,SAAS,IAAI,CAAC,OAAO,GACpB,OAAO,GACP,CAAC,SAAS,IAAI,CAAC,EAAE,GACf,MAAM,GACN,KAAK,CAAC;AAEpB,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,kBAAkB,GAAG,MAAM,IAAI,CAAC,SAAS,MAAM,GAC7E,4BAA4B,CAAC,CAAC,CAAC,GAC/B,CAAC,SAAS,MAAM,GACd,CAAC,GACD,CAAC,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,GACvB,IAAI,GACJ,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAC1B,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAClC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAC1B,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAClC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,CAAC,GACzB,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,SAAS,QAAQ,CAAC,MAAM,EAAE,CAAC,GAC1B,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,GACvB,KAAK,CAAC;AAExB,KAAK,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAAC,IAAI;KACjF,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,CAAC;AAEF,KAAK,WAAW,CAAC,IAAI,IAAI,IAAI,SAAS,IAAI,MAAM,SAAS,GAAG,GAAG,SAAS,GAAG,KAAK,CAAC;AACjF,KAAK,aAAa,CAAC,IAAI,IAAI,IAAI,SAAS,GAAG,MAAM,KAAK,IAAI,MAAM,KAAK,EAAE,GACnE,WAAW,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,GACzC,WAAW,CAAC,IAAI,CAAC,CAAC;AACtB,KAAK,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,MAAM,MAAM,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;AAClG,KAAK,gBAAgB,CAAC,GAAG,IAAI,GAAG,SAAS,MAAM,MAAM,IAAI,EAAE,GAAG,IAAI,GAAG,GAAG,CAAC;AACzE,KAAK,UAAU,CAAC,IAAI,IAAI;KACrB,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC;CACvE,CAAC;AAEF,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;IAElE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,KAAK,+BAA+B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,kBAAkB,GAAG,SAAS,IAChH,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACxC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAClC,GACD,CAAC,SAAS,kBAAkB,GAC1B,WAAW,CAAC,CAAC,CAAC,GAEd,EAAE,CAAC;AAEX,KAAK,WAAW,CAAC,IAAI,SAAS,mBAAmB,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAC3E,+BAA+B,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;AAExD,KAAK,sBAAsB,CAAC,IAAI,SAAS,mBAAmB,IAE1D,EAAE,SAAS,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAG/D,KAAK,eAAe,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,KAAK,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS;CAAE,SAAS,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;AAExG,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAClC;IACE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrE,GAAG;IACF,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CACtE,GACD,CAAC,CAAC;AAEN,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAC/B;IACE,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC/B,GAAG,EAAE,GACN,CAAC,CAAC;AAEN,wBAAgB,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,mBAAmB,EAC1D,sBAAsB,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,GAC5C,CACD,GAAG,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,IAAI,GACpD,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAClD,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAC/D,wBAAwB,CAAC,QAAQ,CAAC,QAAQ,CAAC,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAmDnG"}

package/dist/esm/query.js

@@ -0,0 +1,38 @@
+import { getContext, reactive } from 'signalium';
+import { QueryClientContext } from './QueryClient.js';
+import { t, ValidatorDef } from './typeDefs.js';
+import { createPathInterpolator } from './pathInterpolator.js';
+export function query(queryDefinitionBuilder) {
+    let queryDefinition;
+    return reactive((params) => {
+        const queryClient = getContext(QueryClientContext);
+        if (queryClient === undefined) {
+            throw new Error('QueryClient not found');
+        }
+        if (queryDefinition === undefined) {
+            const { path, method = 'GET', response, cache } = queryDefinitionBuilder(t);
+            const id = `${method}:${path}`;
+            const shape = typeof response === 'object' && !(response instanceof ValidatorDef)
+                ? t.object(response)
+                : response;
+            // Create optimized path interpolator (parses template once)
+            const interpolatePath = createPathInterpolator(path);
+            const fetchFn = async (context, params) => {
+                // Interpolate path params and append search params automatically
+                const url = interpolatePath(params);
+                const response = await context.fetch(url, {
+                    method,
+                });
+                return response.json();
+            };
+            queryDefinition = {
+                id,
+                shape,
+                fetchFn,
+                cache,
+            };
+        }
+        return queryClient.getQuery(queryDefinition, params);
+    });
+}
+//# sourceMappingURL=query.js.map

package/dist/esm/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAYjD,OAAO,EAAqB,kBAAkB,EAAiC,MAAM,kBAAkB,CAAC;AACxG,OAAO,EAAU,CAAC,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AA2F/D,MAAM,UAAU,KAAK,CACnB,sBAA6C;IAM7C,IAAI,eAES,CAAC;IAEd,OAAO,QAAQ,CACb,CAAC,MAA+B,EAA+E,EAAE;QAC/G,MAAM,WAAW,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;QAEnD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAE5E,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;YAE/B,MAAM,KAAK,GACT,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,YAAY,YAAY,CAAC;gBACjE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAA8C,CAAC;gBAC1D,CAAC,CAAE,QAA+B,CAAC;YAEvC,4DAA4D;YAC5D,MAAM,eAAe,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAErD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAqB,EAAE,MAA+B,EAAE,EAAE;gBAC/E,iEAAiE;gBACjE,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;gBAEpC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;oBACxC,MAAM;iBACP,CAAC,CAAC;gBAEH,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;YACzB,CAAC,CAAC;YAEF,eAAe,GAAG;gBAChB,EAAE;gBACF,KAAK;gBACL,OAAO;gBACP,KAAK;aACN,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IACvD,CAAC,CAIK,CAAC;AACX,CAAC"}

package/dist/esm/typeDefs.d.ts

@@ -0,0 +1,25 @@
+import { APITypes, ArrayDef, EntityDef, Mask, ObjectDef, ObjectShape, RecordDef, TypeDef, ObjectFieldTypeDef, UnionTypeDefs } from './types.js';
+export declare class ValidatorDef<T> {
+    mask: Mask;
+    shape: ObjectFieldTypeDef | ObjectShape | ((t: APITypes) => ObjectShape) | UnionTypeDefs | undefined;
+    subEntityPaths: undefined | string | string[];
+    values: Set<string | boolean | number> | undefined;
+    typenameField: string | undefined;
+    typenameValue: string | undefined;
+    idField: string | undefined;
+    private _optional;
+    private _nullable;
+    private _nullish;
+    constructor(mask: Mask, shape: ObjectFieldTypeDef | ObjectShape | ((t: APITypes) => ObjectShape) | UnionTypeDefs | undefined, subEntityPaths?: undefined | string | string[], values?: Set<string | boolean | number> | undefined, typenameField?: string | undefined, typenameValue?: string | undefined, idField?: string | undefined);
+    get optional(): ValidatorDef<T | undefined>;
+    get nullable(): ValidatorDef<T | null>;
+    get nullish(): ValidatorDef<T | null | undefined>;
+}
+export declare function defineArray<T extends TypeDef>(shape: T): ArrayDef<T>;
+export declare function defineRecord<T extends TypeDef>(shape: T): RecordDef<T>;
+export declare function defineObject<T extends ObjectShape>(shape: T): ObjectDef<T>;
+export declare function getFormat(mask: number): (value: unknown) => unknown;
+export declare function registerFormat<Input extends string | boolean, T>(name: string, type: Input extends string ? Mask.STRING : Mask.BOOLEAN, parse: (value: Input) => T, serialize: (value: T) => Input): void;
+export declare function entity<T extends ObjectShape>(shape: (t: APITypes) => T): EntityDef<T>;
+export declare const t: APITypes;
+//# sourceMappingURL=typeDefs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typeDefs.d.ts","sourceRoot":"","sources":["../../src/typeDefs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EAER,QAAQ,EAER,SAAS,EACT,IAAI,EACJ,SAAS,EACT,WAAW,EAEX,SAAS,EACT,OAAO,EACP,kBAAkB,EAElB,aAAa,EACd,MAAM,YAAY,CAAC;AAGpB,qBAAa,YAAY,CAAC,CAAC;IAMhB,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,kBAAkB,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,WAAW,CAAC,GAAG,aAAa,GAAG,SAAS;IACpG,cAAc,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE;IAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,SAAS;IAClD,aAAa,EAAE,MAAM,GAAG,SAAS;IACjC,aAAa,EAAE,MAAM,GAAG,SAAS;IACjC,OAAO,EAAE,MAAM,GAAG,SAAS;IAXpC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,QAAQ,CAAiD;gBAGxD,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,kBAAkB,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,KAAK,WAAW,CAAC,GAAG,aAAa,GAAG,SAAS,EACpG,cAAc,GAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAc,EACzD,MAAM,GAAE,GAAG,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG,SAAqB,EAC9D,aAAa,GAAE,MAAM,GAAG,SAAqB,EAC7C,aAAa,GAAE,MAAM,GAAG,SAAqB,EAC7C,OAAO,GAAE,MAAM,GAAG,SAAqB;IAGhD,IAAI,QAAQ,IAAI,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC,CAa1C;IAED,IAAI,QAAQ,IAAI,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAarC;IAED,IAAI,OAAO,IAAI,YAAY,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAahD;CACF;AAMD,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CASpE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAUtE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAM1E;AA4LD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAInE;AAED,wBAAgB,cAAc,CAAC,KAAK,SAAS,MAAM,GAAG,OAAO,EAAE,CAAC,EAC9D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,SAAS,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EACvD,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,EAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,QAW/B;AAMD,wBAAgB,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAMrF;AAED,eAAO,MAAM,CAAC,EAAE,QAef,CAAC"}