@signalium/query 0.0.0 → 0.0.2

package/dist/cjs/proxy.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArrayValue = parseArrayValue;
+exports.parseRecordValue = parseRecordValue;
+exports.parseObjectValue = parseObjectValue;
+exports.parseValue = parseValue;
+exports.createEntityProxy = createEntityProxy;
+const errors_js_1 = require("./errors.js");
+const typeDefs_js_1 = require("./typeDefs.js");
+const types_js_1 = require("./types.js");
+const utils_js_1 = require("./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[types_js_1.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[types_js_1.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);
+    }
+}
+function parseArrayValue(array, arrayShape, path) {
+    for (let i = 0; i < array.length; i++) {
+        array[i] = parseValue(array[i], arrayShape, `${path}[${i}]`);
+    }
+    return array;
+}
+function parseRecordValue(record, recordShape, path) {
+    for (const [key, value] of entries(record)) {
+        record[key] = parseValue(value, recordShape, `${path}["${key}"]`);
+    }
+    return record;
+}
+function parseObjectValue(object, objectShape, path) {
+    if (PROXY_BRAND.has(object)) {
+        // Is an entity proxy, so return it directly
+        return object;
+    }
+    const shape = (0, utils_js_1.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;
+}
+function parseValue(value, propDef, path) {
+    // Handle Set-based constants/enums
+    if (propDef instanceof Set) {
+        if (!propDef.has(value)) {
+            throw (0, errors_js_1.typeError)(path, propDef, value);
+        }
+        return value;
+    }
+    switch (typeof propDef) {
+        case 'string':
+            if (value !== propDef) {
+                throw (0, errors_js_1.typeError)(path, propDef, value);
+            }
+            return value;
+        // handle primitives
+        case 'number': {
+            let valueType = (0, utils_js_1.typeMaskOf)(value);
+            if ((propDef & valueType) === 0) {
+                throw (0, errors_js_1.typeError)(path, propDef, value);
+            }
+            if ((propDef & 4096 /* Mask.HAS_NUMBER_FORMAT */) !== 0 && valueType === 4 /* Mask.NUMBER */) {
+                return (0, typeDefs_js_1.getFormat)(propDef)(value);
+            }
+            if ((propDef & 8192 /* Mask.HAS_STRING_FORMAT */) !== 0 && valueType === 8 /* Mask.STRING */) {
+                return (0, typeDefs_js_1.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 = (0, utils_js_1.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 (0, errors_js_1.typeError)(path, propMask, value);
+            }
+            if (valueType < 32 /* Mask.OBJECT */) {
+                if ((propMask & 4096 /* Mask.HAS_NUMBER_FORMAT */) !== 0 && valueType === 4 /* Mask.NUMBER */) {
+                    return (0, typeDefs_js_1.getFormat)(propMask)(value);
+                }
+                if ((propMask & 8192 /* Mask.HAS_STRING_FORMAT */) !== 0 && valueType === 8 /* Mask.STRING */) {
+                    return (0, typeDefs_js_1.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');
+function createEntityProxy(id, entityRecord, def, desc) {
+    // Cache for nested proxies - each proxy gets its own cache
+    const shape = (0, utils_js_1.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/cjs/proxy.js.map

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

package/dist/cjs/query.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = query;
+const signalium_1 = require("signalium");
+const QueryClient_js_1 = require("./QueryClient.js");
+const typeDefs_js_1 = require("./typeDefs.js");
+const pathInterpolator_js_1 = require("./pathInterpolator.js");
+function query(queryDefinitionBuilder) {
+    let queryDefinition;
+    return (0, signalium_1.reactive)((params) => {
+        const queryClient = (0, signalium_1.getContext)(QueryClient_js_1.QueryClientContext);
+        if (queryClient === undefined) {
+            throw new Error('QueryClient not found');
+        }
+        if (queryDefinition === undefined) {
+            const { path, method = 'GET', response, cache, refetchInterval } = queryDefinitionBuilder(typeDefs_js_1.t);
+            const id = `${method}:${path}`;
+            const shape = typeof response === 'object' && !(response instanceof typeDefs_js_1.ValidatorDef)
+                ? typeDefs_js_1.t.object(response)
+                : response;
+            // Create optimized path interpolator (parses template once)
+            const interpolatePath = (0, pathInterpolator_js_1.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/cjs/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/query.ts"],"names":[],"mappings":";;AA0GA,sBAyDC;AAnKD,yCAAiD;AAYjD,qDAAwG;AACxG,+CAAwD;AACxD,+DAA+D;AA4F/D,SAAgB,KAAK,CACnB,sBAA6C;IAM7C,IAAI,eAES,CAAC;IAEd,OAAO,IAAA,oBAAQ,EACb,CAAC,MAA+B,EAA+E,EAAE;QAC/G,MAAM,WAAW,GAAG,IAAA,sBAAU,EAAC,mCAAkB,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,eAAe,EAAE,GAAG,sBAAsB,CAAC,eAAC,CAAC,CAAC;YAE7F,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;YAE/B,MAAM,KAAK,GACT,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,YAAY,0BAAY,CAAC;gBACjE,CAAC,CAAC,eAAC,CAAC,MAAM,CAAC,QAA8C,CAAC;gBAC1D,CAAC,CAAE,QAA+B,CAAC;YAEvC,4DAA4D;YAC5D,MAAM,eAAe,GAAG,IAAA,4CAAsB,EAAC,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/cjs/tsconfig.cjs.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../src/EntityMap.ts","../../src/QueryClient.ts","../../src/QueryStore.ts","../../src/errors.ts","../../src/index.ts","../../src/parseEntities.ts","../../src/pathInterpolator.ts","../../src/proxy.ts","../../src/query.ts","../../src/typeDefs.ts","../../src/types.ts","../../src/utils.ts"],"version":"5.7.3"}

package/dist/cjs/typeDefs.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.t = exports.ValidatorDef = void 0;
+exports.defineArray = defineArray;
+exports.defineRecord = defineRecord;
+exports.defineObject = defineObject;
+exports.getFormat = getFormat;
+exports.registerFormat = registerFormat;
+exports.entity = entity;
+const types_js_1 = require("./types.js");
+const utils_js_1 = require("./utils.js");
+class ValidatorDef {
+    mask;
+    shape;
+    subEntityPaths;
+    values;
+    typenameField;
+    typenameValue;
+    idField;
+    _optional;
+    _nullable;
+    _nullish;
+    constructor(mask, shape, subEntityPaths = undefined, values = undefined, typenameField = undefined, typenameValue = undefined, idField = undefined) {
+        this.mask = mask;
+        this.shape = shape;
+        this.subEntityPaths = subEntityPaths;
+        this.values = values;
+        this.typenameField = typenameField;
+        this.typenameValue = typenameValue;
+        this.idField = idField;
+    }
+    get optional() {
+        if (this._optional === undefined) {
+            this._optional = new ValidatorDef(this.mask | 1 /* Mask.UNDEFINED */, this.shape, this.subEntityPaths, this.values, this.typenameField, this.typenameValue, this.idField);
+        }
+        return this._optional;
+    }
+    get nullable() {
+        if (this._nullable === undefined) {
+            this._nullable = new ValidatorDef(this.mask | 2 /* Mask.NULL */, this.shape, this.subEntityPaths, this.values, this.typenameField, this.typenameValue, this.idField);
+        }
+        return this._nullable;
+    }
+    get nullish() {
+        if (this._nullish === undefined) {
+            this._nullish = new ValidatorDef(this.mask | 1 /* Mask.UNDEFINED */ | 2 /* Mask.NULL */, this.shape, this.subEntityPaths, this.values, this.typenameField, this.typenameValue, this.idField);
+        }
+        return this._nullish;
+    }
+}
+exports.ValidatorDef = ValidatorDef;
+// -----------------------------------------------------------------------------
+// Complex Type Definitions
+// -----------------------------------------------------------------------------
+function defineArray(shape) {
+    let mask = 64 /* Mask.ARRAY */;
+    // Propagate HAS_SUB_ENTITY flag if the shape contains entities
+    if (shape instanceof ValidatorDef && (shape.mask & (1024 /* Mask.ENTITY */ | 2048 /* Mask.HAS_SUB_ENTITY */)) !== 0) {
+        mask |= 2048 /* Mask.HAS_SUB_ENTITY */;
+    }
+    return new ValidatorDef(mask, shape);
+}
+function defineRecord(shape) {
+    // The mask should be OBJECT | RECORD so that values match when compared
+    let mask = 256 /* Mask.RECORD */ | 32 /* Mask.OBJECT */;
+    // Propagate HAS_SUB_ENTITY flag if the shape contains entities
+    if (shape instanceof ValidatorDef && (shape.mask & (1024 /* Mask.ENTITY */ | 2048 /* Mask.HAS_SUB_ENTITY */)) !== 0) {
+        mask |= 2048 /* Mask.HAS_SUB_ENTITY */;
+    }
+    return new ValidatorDef(mask, shape);
+}
+function defineObject(shape) {
+    const def = new ValidatorDef(32 /* Mask.OBJECT */, shape);
+    (0, utils_js_1.extractShapeMetadata)(def, shape);
+    return def;
+}
+const addShapeToUnion = (shape, definition, unionTypenameField) => {
+    const mask = definition.mask;
+    if ((mask & 512 /* Mask.UNION */) !== 0) {
+        // Merge nested union into parent union
+        const nestedUnion = definition;
+        // Check typename field consistency
+        if (nestedUnion.typenameField !== undefined) {
+            if (unionTypenameField !== undefined && unionTypenameField !== nestedUnion.typenameField) {
+                throw new Error(`Union typename field conflict: Cannot merge unions with different typename fields ('${unionTypenameField}' vs '${nestedUnion.typenameField}')`);
+            }
+            unionTypenameField = nestedUnion.typenameField;
+        }
+        // Merge nested union's shape into parent
+        if (nestedUnion.shape !== undefined) {
+            for (const key of [...Object.keys(nestedUnion.shape), types_js_1.ARRAY_KEY, types_js_1.RECORD_KEY]) {
+                // Check for conflicts
+                const value = nestedUnion.shape[key];
+                if (shape[key] !== undefined && shape[key] !== value) {
+                    throw new Error(`Union merge conflict: Duplicate typename value '${String(key)}' found when merging nested unions`);
+                }
+                // coerce type because we know the value is the same type as the key
+                shape[key] = value;
+            }
+        }
+        return unionTypenameField;
+    }
+    else if ((mask & 64 /* Mask.ARRAY */) !== 0) {
+        if (shape[types_js_1.ARRAY_KEY] !== undefined) {
+            throw new Error('Array shape already defined');
+        }
+        shape[types_js_1.ARRAY_KEY] = definition.shape;
+        return unionTypenameField;
+    }
+    else if ((mask & 256 /* Mask.RECORD */) !== 0) {
+        if (shape[types_js_1.RECORD_KEY] !== undefined) {
+            throw new Error('Record shape already defined');
+        }
+        shape[types_js_1.RECORD_KEY] = definition.shape;
+        return unionTypenameField;
+    }
+    else {
+        // Make sure the type is fully extracted, so we can get the typename field and value
+        (0, utils_js_1.extractShape)(definition);
+        // definition is ObjectDef | EntityDef
+        const typenameField = definition.typenameField;
+        const typename = definition.typenameValue;
+        if (typename === undefined) {
+            throw new Error('Object definitions must have a typename to be in a union with other objects, records, or arrays');
+        }
+        if (unionTypenameField !== undefined && typenameField !== unionTypenameField) {
+            throw new Error('Object definitions must have the same typename field to be in the same union');
+        }
+        shape[typename] = definition;
+        return typenameField;
+    }
+};
+function defineUnion(...types) {
+    let mask = 0;
+    let definition;
+    let shape;
+    let values;
+    let unionTypenameField;
+    for (const type of types) {
+        if (typeof type === 'number') {
+            mask |= type;
+            continue;
+        }
+        const isSet = type instanceof Set;
+        const typeValues = isSet ? type : type.values;
+        // Handle Set-based constants/enums
+        if (typeValues !== undefined) {
+            if (values === undefined) {
+                values = new Set(typeValues);
+            }
+            else {
+                for (const val of typeValues) {
+                    values.add(val);
+                }
+            }
+            if (isSet) {
+                continue;
+            }
+        }
+        // We know it's a complex type at this point because if it was a Set,
+        // we would have already handled it above.
+        const typeDef = type;
+        mask |= typeDef.mask;
+        if (definition === undefined) {
+            definition = typeDef;
+            continue;
+        }
+        if (shape === undefined) {
+            shape = Object.create(null);
+            unionTypenameField = addShapeToUnion(shape, definition, unionTypenameField);
+        }
+        unionTypenameField = addShapeToUnion(shape, typeDef, unionTypenameField);
+    }
+    // It was a union of primitives, so return the mask
+    if (definition === undefined && values === undefined) {
+        // This type coercion is incorrect, but we can't return the mask as a Mask
+        // because that loses the type information about the union, which breaks
+        // inference.
+        //
+        // TODO: Figure out how to make this correct type-wise
+        return mask;
+    }
+    return new ValidatorDef(mask | 512 /* Mask.UNION */, shape ?? definition?.shape, undefined, values, unionTypenameField);
+}
+// -----------------------------------------------------------------------------
+// Marker Functions
+// -----------------------------------------------------------------------------
+function defineTypename(value) {
+    return value;
+}
+function defineConst(value) {
+    return new Set([value]);
+}
+function defineEnum(...values) {
+    return new Set(values);
+}
+// -----------------------------------------------------------------------------
+// Formatted Values
+// -----------------------------------------------------------------------------
+const FORMAT_MASK_SHIFT = 16;
+let nextFormatId = 0;
+const FORMAT_PARSERS = [];
+const FORMAT_SERIALIZERS = [];
+const FORMAT_MAP = new Map();
+function defineFormatted(format) {
+    const mask = FORMAT_MAP.get(format);
+    if (mask === undefined) {
+        throw new Error(`Format ${format} not registered`);
+    }
+    return mask;
+}
+function getFormat(mask) {
+    const formatId = mask >> FORMAT_MASK_SHIFT;
+    return FORMAT_PARSERS[formatId];
+}
+function registerFormat(name, type, parse, serialize) {
+    const maskId = nextFormatId++;
+    FORMAT_PARSERS[maskId] = parse;
+    FORMAT_SERIALIZERS[maskId] = serialize;
+    const shiftedId = maskId << FORMAT_MASK_SHIFT;
+    const formatMask = type === 8 /* Mask.STRING */ ? 8192 /* Mask.HAS_STRING_FORMAT */ : 4096 /* Mask.HAS_NUMBER_FORMAT */;
+    const mask = shiftedId | type | formatMask;
+    FORMAT_MAP.set(name, mask);
+}
+// -----------------------------------------------------------------------------
+// Entity Definitions
+// -----------------------------------------------------------------------------
+function entity(shape) {
+    return new ValidatorDef(
+    // The mask should be OBJECT | ENTITY so that values match when compared
+    1024 /* Mask.ENTITY */ | 32 /* Mask.OBJECT */, shape);
+}
+exports.t = {
+    format: defineFormatted,
+    typename: defineTypename,
+    const: defineConst,
+    enum: defineEnum,
+    id: 128 /* Mask.ID */ | 8 /* Mask.STRING */ | 4 /* Mask.NUMBER */,
+    string: 8 /* Mask.STRING */,
+    number: 4 /* Mask.NUMBER */,
+    boolean: 16 /* Mask.BOOLEAN */,
+    null: 2 /* Mask.NULL */,
+    undefined: 1 /* Mask.UNDEFINED */,
+    array: defineArray,
+    object: defineObject,
+    record: defineRecord,
+    union: defineUnion,
+};
+//# sourceMappingURL=typeDefs.js.map

package/dist/cjs/typeDefs.js.map

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

package/dist/cjs/types.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECORD_KEY = exports.ARRAY_KEY = exports.RefetchInterval = void 0;
+var RefetchInterval;
+(function (RefetchInterval) {
+    RefetchInterval[RefetchInterval["Every1Second"] = 1000] = "Every1Second";
+    RefetchInterval[RefetchInterval["Every5Seconds"] = 5000] = "Every5Seconds";
+    RefetchInterval[RefetchInterval["Every10Seconds"] = 10000] = "Every10Seconds";
+    RefetchInterval[RefetchInterval["Every30Seconds"] = 30000] = "Every30Seconds";
+    RefetchInterval[RefetchInterval["Every1Minute"] = 60000] = "Every1Minute";
+    RefetchInterval[RefetchInterval["Every5Minutes"] = 300000] = "Every5Minutes";
+})(RefetchInterval || (exports.RefetchInterval = RefetchInterval = {}));
+exports.ARRAY_KEY = Symbol('array');
+exports.RECORD_KEY = Symbol('record');
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAGA,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,wEAAmB,CAAA;IACnB,0EAAoB,CAAA;IACpB,6EAAsB,CAAA;IACtB,6EAAsB,CAAA;IACtB,yEAAoB,CAAA;IACpB,4EAAsB,CAAA;AACxB,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B;AAyCY,QAAA,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5B,QAAA,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/cjs/utils.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractShapeMetadata = extractShapeMetadata;
+exports.extractShape = extractShape;
+exports.typeMaskOf = typeMaskOf;
+const typeDefs_js_1 = require("./typeDefs.js");
+const entries = Object.entries;
+const isArray = Array.isArray;
+function extractShapeMetadata(def, shape) {
+    for (const [key, value] of Object.entries(shape)) {
+        if (value instanceof typeDefs_js_1.ValidatorDef && (value.mask & (1024 /* Mask.ENTITY */ | 2048 /* Mask.HAS_SUB_ENTITY */)) !== 0) {
+            if (def.subEntityPaths === undefined) {
+                def.subEntityPaths = key;
+            }
+            else if (isArray(def.subEntityPaths)) {
+                def.subEntityPaths.push(key);
+            }
+            else {
+                def.subEntityPaths = [def.subEntityPaths, key];
+            }
+        }
+        // Check if this is a typename field (plain string value)
+        if (typeof value === 'string') {
+            if (def.typenameField !== undefined) {
+                throw new Error(`Duplicate typename field: ${key}`);
+            }
+            def.typenameField = key;
+            def.typenameValue = value;
+        }
+        // Check if this is an id field (Mask.ID)
+        else if (typeof value === 'number' && (value & 128 /* Mask.ID */) !== 0) {
+            if (def.idField !== undefined) {
+                throw new Error(`Duplicate id field: ${key}`);
+            }
+            def.idField = key;
+        }
+    }
+}
+function extractShape(def) {
+    let shape = def.shape;
+    if (typeof shape === 'function') {
+        shape = def.shape = shape(typeDefs_js_1.t);
+        extractShapeMetadata(def, shape);
+    }
+    return shape;
+}
+function typeMaskOf(value) {
+    if (value === null)
+        return 2 /* Mask.NULL */;
+    switch (typeof value) {
+        case 'number':
+            return 4 /* Mask.NUMBER */;
+        case 'string':
+            return 8 /* Mask.STRING */;
+        case 'boolean':
+            return 16 /* Mask.BOOLEAN */;
+        case 'undefined':
+            return 1 /* Mask.UNDEFINED */;
+        case 'object':
+            return isArray(value) ? 64 /* Mask.ARRAY */ : 32 /* Mask.OBJECT */;
+        default:
+            throw new Error(`Invalid type: ${typeof value}`);
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";;AAMA,oDA6BC;AAED,oCASC;AAED,gCAiBC;AAjED,+CAAgD;AAGhD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;AAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;AAE9B,SAAgB,oBAAoB,CAAC,GAAsB,EAAE,KAAkB;IAC7E,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,YAAY,0BAAY,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,uDAAiC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,IAAI,GAAG,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACrC,GAAG,CAAC,cAAc,GAAG,GAAG,CAAC;YAC3B,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,cAAc,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,yDAAyD;QACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;YACtD,CAAC;YAED,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC;YACxB,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,yCAAyC;aACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,oBAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;YAChD,CAAC;YAED,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAA2B,GAAM;IAC3D,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IAEtB,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,KAAK,GAAG,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,eAAC,CAAC,CAAC;QAC7B,oBAAoB,CAAC,GAAwB,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAuD,CAAC;AACjE,CAAC;AAED,SAAgB,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI;QAAE,yBAAiB;IAErC,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,2BAAmB;QACrB,KAAK,QAAQ;YACX,2BAAmB;QACrB,KAAK,SAAS;YACZ,6BAAoB;QACtB,KAAK,WAAW;YACd,8BAAsB;QACxB,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,qBAAY,CAAC,qBAAY,CAAC;QACnD;YACE,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;AACH,CAAC"}

package/dist/esm/EntityMap.d.ts

@@ -0,0 +1,18 @@
+import { Signal } from 'signalium';
+import { EntityDef } from './types.js';
+export interface PreloadedEntityRecord {
+    key: number;
+    signal: Signal<Record<string, unknown>>;
+    cache: Map<PropertyKey, any>;
+    proxy?: Record<string, unknown>;
+}
+export type EntityRecord = Required<PreloadedEntityRecord>;
+export declare class EntityStore {
+    private map;
+    hasEntity(key: number): boolean;
+    getEntity(key: number): PreloadedEntityRecord | EntityRecord | undefined;
+    hydratePreloadedEntity(key: number, shape: EntityDef): EntityRecord;
+    setPreloadedEntity(key: number, obj: Record<string, unknown>): PreloadedEntityRecord;
+    setEntity(key: number, obj: Record<string, unknown>, shape: EntityDef): EntityRecord;
+}
+//# sourceMappingURL=EntityMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMap.d.ts","sourceRoot":"","sources":["../../src/EntityMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,qBAAqB,CAAC,CAAC;AAE3D,qBAAa,WAAW;IACtB,OAAO,CAAC,GAAG,CAA2D;IAEtE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI/B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,YAAY,GAAG,SAAS;IAIxE,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,YAAY;IAWnE,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,qBAAqB;IAapF,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,YAAY;CAcrF"}