@nexigen/entity-normalizer 0.1.1 → 0.1.2

package/dist/entities/processor.d.ts

@@ -0,0 +1,14 @@
+import type { TEntitiesStore, EntityProcessOptions } from './types';
+import type { TSchemaMap } from '../root/types';
+export declare class EntityProcessor {
+    private entities;
+    private schemaMap;
+    private readonly getEntity;
+    constructor(entities: TEntitiesStore, schemaMap: TSchemaMap);
+    private ensureMeta;
+    private upsert;
+    hydrate(snapshot: Record<string, Record<string, any>> | null | undefined): void;
+    process<T>({ data, entityKey, sourceRefId, isCollection, }: EntityProcessOptions<T>): (string | number)[];
+}
+export declare function createEntityProcessor(entities: TEntitiesStore, schemaMap: TSchemaMap, options: EntityProcessOptions<any>): (string | number)[];
+export declare function createEntityRestorer(entities: TEntitiesStore, schemaMap: TSchemaMap): (snapshot: any) => void;

package/dist/entities/processor.js

@@ -0,0 +1,156 @@
+import { PREFIX } from './constants';
+import { createNormalizer } from './normalize';
+import { META } from '../constants/values';
+export class EntityProcessor {
+    constructor(entities, schemaMap) {
+        this.entities = entities;
+        this.schemaMap = schemaMap;
+        this.getEntity = entities.getEntity.bind(entities);
+    }
+    // ===== meta =====
+    ensureMeta(instance) {
+        let meta = instance[META];
+        if (!meta) {
+            meta = {
+                createdAt: Date.now(),
+                updatedAt: Date.now(),
+                accessedAt: Date.now(),
+                refSources: new Set(),
+            };
+            Object.defineProperty(instance, META, {
+                value: meta,
+                enumerable: false,
+                writable: true,
+            });
+        }
+        return meta;
+    }
+    // ===== upsert =====
+    upsert(dto, schema, entityKey, id, opts) {
+        const existing = this.entities.getEntity(entityKey, id);
+        if (opts.hydrate) {
+            const instance = schema.model
+                ? new schema.model(dto, this.getEntity)
+                : { ...dto };
+            const meta = this.ensureMeta(instance);
+            if (opts.snapshot) {
+                meta.createdAt = opts.snapshot.createdAt ?? meta.createdAt;
+                meta.updatedAt = opts.snapshot.updatedAt ?? meta.updatedAt;
+                meta.accessedAt = opts.snapshot.accessedAt ?? meta.accessedAt;
+                const restoredRefs = opts.snapshot.refSources ?? [];
+                for (const ref of restoredRefs) {
+                    meta.refSources.add(ref);
+                }
+            }
+            return instance;
+        }
+        const processed = schema.process({ ...dto });
+        if (existing) {
+            if (existing.__partial) {
+                delete existing.__partial;
+            }
+            schema.merge(existing, processed);
+            const meta = this.ensureMeta(existing);
+            const now = Date.now();
+            meta.updatedAt = now;
+            meta.accessedAt = now;
+            if (opts.sourceRefId) {
+                meta.refSources.add(opts.sourceRefId);
+            }
+            return existing;
+        }
+        const instance = schema.model
+            ? new schema.model(processed, this.getEntity)
+            : { ...processed };
+        const meta = this.ensureMeta(instance);
+        if (opts.sourceRefId) {
+            meta.refSources.add(opts.sourceRefId);
+        }
+        return instance;
+    }
+    // ===== hydrate =====
+    hydrate(snapshot) {
+        if (!snapshot) {
+            return;
+        }
+        const out = {};
+        for (const entityKey of Object.keys(snapshot)) {
+            const schema = this.schemaMap[entityKey];
+            if (!schema) {
+                if (__DEV__) {
+                    console.warn(`[hydrate] Schema not found for entityKey="${entityKey}". Skipping.`);
+                }
+                continue;
+            }
+            const bucket = snapshot[entityKey];
+            if (!bucket) {
+                continue;
+            }
+            const restored = {};
+            for (const id of Object.keys(bucket)) {
+                const full = bucket[id];
+                if (!full) {
+                    continue;
+                }
+                const { [META]: meta, ...dto } = full;
+                restored[id] = this.upsert(dto, schema, entityKey, id, {
+                    hydrate: true,
+                    snapshot: meta,
+                });
+            }
+            out[entityKey] = restored;
+        }
+        this.entities.merge(out);
+    }
+    // ===== process =====
+    process({ data, entityKey, sourceRefId, isCollection, }) {
+        const schema = this.schemaMap[entityKey];
+        if (!schema) {
+            if (__DEV__) {
+                console.warn(`[process] Schema not found for entityKey="${entityKey}". Skipping.`);
+            }
+            return [];
+        }
+        const safeSourceRefId = sourceRefId && typeof sourceRefId === 'string' ? sourceRefId : 'unknown';
+        const refId = isCollection
+            ? `${PREFIX.COLLECTION}${safeSourceRefId}`
+            : `${PREFIX.RECORD}${safeSourceRefId}`;
+        const { ids, map } = createNormalizer().normalize(data, schema);
+        const out = {};
+        for (const key of Object.keys(map)) {
+            const bucket = map[key];
+            if (!bucket) {
+                continue;
+            }
+            const schema = this.schemaMap[key];
+            if (!schema) {
+                continue;
+            }
+            const result = {};
+            for (const id of Object.keys(bucket)) {
+                result[id] = this.upsert(bucket[id], schema, key, id, {
+                    hydrate: false,
+                    sourceRefId: refId,
+                });
+            }
+            out[key] = result;
+        }
+        this.entities.merge(out);
+        return ids;
+    }
+}
+// ===== factories =====
+export function createEntityProcessor(entities, schemaMap, options) {
+    if (!entities) {
+        throw new Error('createEntityProcessor: EntitiesStore is required.');
+    }
+    return new EntityProcessor(entities, schemaMap).process(options);
+}
+export function createEntityRestorer(entities, schemaMap) {
+    if (!entities) {
+        throw new Error('createEntityRestorer: EntitiesStore is required.');
+    }
+    const p = new EntityProcessor(entities, schemaMap);
+    return (snapshot) => p.hydrate(snapshot);
+}
+//# sourceMappingURL=processor.js.map

package/dist/entities/processor.js.map

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

package/dist/entities/public.d.ts

@@ -0,0 +1,102 @@
+/**
+ * ============================
+ * Nexigen – Public Entity API
+ * ============================
+ */
+/**
+ * Primitive entity identifier
+ */
+export type EntityId = string | number;
+/**
+ * ============================
+ * Entity Model Context
+ * ============================
+ */
+export type EntityGetter = <T = any>(entityKey: string, id: string | number) => T | undefined;
+/**
+ * ============================
+ * Entity Model Constructor
+ * ============================
+ *
+ * User-defined domain model constructor.
+ *
+ * Example:
+ *   class PostModel {
+ *     constructor(dto: PostDto, ctx: EntityGetter) {}
+ *   }
+ */
+export type EntityModelCtor<TDto, TModel> = new (dto: TDto, ctx: EntityGetter) => TModel;
+/**
+ * ============================
+ * Public Entity Schema
+ * ============================
+ *
+ * Read-only interface exposed to userland.
+ * No normalization, no GC, no persistence details.
+ */
+export interface PublicEntitySchema<TDto, TModel> {
+    /**
+     * Unique entity key
+     */
+    readonly key: string;
+    /**
+     * Extract entity id from DTO
+     */
+    getId(input: TDto): EntityId;
+    /**
+     * Return id attribute key (string only)
+     */
+    getIdKey(): string;
+    /**
+     * Optional preprocessing before normalization
+     */
+    process(input: TDto): TDto;
+    /**
+     * Merge strategy for model updates
+     */
+    merge(target: TModel, source: Partial<TModel>): TModel;
+}
+/**
+ * ============================
+ * Entity Relations Definition
+ * ============================
+ *
+ * Used to describe nested schemas.
+ *
+ * Example:
+ * {
+ *   author: userSchema,
+ *   comments: [commentSchema],
+ * }
+ */
+export type EntitySchemaDefinition = Record<string, PublicEntitySchema<any, any> | [PublicEntitySchema<any, any>]>;
+/**
+ * ============================
+ * Entity Schema Config
+ * ============================
+ *
+ * User-provided configuration.
+ */
+export interface EntitySchemaConfig<TDto, TModel> {
+    /**
+     * ID attribute or resolver
+     *
+     * Default: "id"
+     */
+    idAttribute?: keyof TDto | ((dto: TDto) => EntityId);
+    /**
+     * Domain model constructor
+     *
+     * Example:
+     *   model: PostModel
+     */
+    model?: EntityModelCtor<TDto, TModel>;
+    /**
+     * Optional DTO preprocessing
+     */
+    processStrategy?: (dto: TDto) => TDto;
+    /**
+     * Optional merge strategy
+     */
+    mergeStrategy?: (target: TModel, source: Partial<TModel>) => TModel;
+}

package/dist/entities/public.js

@@ -0,0 +1,7 @@
+/**
+ * ============================
+ * Nexigen – Public Entity API
+ * ============================
+ */
+export {};
+//# sourceMappingURL=public.js.map

package/dist/entities/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../src/entities/public.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/entities/record/create-entity-record.d.ts

@@ -0,0 +1,15 @@
+import { EntityRecord } from './entity-record';
+import type { CoreEntitiesAPI } from '../../root/coreApi/types';
+import type { EntityCleanerStore } from '../cleaner';
+import type { TEntitiesStore } from '../types';
+export declare function createEntityRecord<T extends {
+    id: string | number;
+}, M>(options: {
+    entityKey: string;
+    recordId: string;
+}, system: {
+    entities: TEntitiesStore;
+    entitiesCleaner: EntityCleanerStore;
+    notify: () => void;
+    entitiesApi: CoreEntitiesAPI;
+}): EntityRecord<T, M>;

package/dist/entities/record/create-entity-record.js

@@ -0,0 +1,13 @@
+import { EntityRecord } from './entity-record';
+export function createEntityRecord(options, system) {
+    if (__DEV__) {
+        if (!options.entityKey) {
+            console.warn('[EntityRecord] Missing "entityKey" in options');
+        }
+        if (!options.recordId) {
+            console.warn('[EntityRecord] Missing "recordId" in options');
+        }
+    }
+    return new EntityRecord(options, system);
+}
+//# sourceMappingURL=create-entity-record.js.map

package/dist/entities/record/create-entity-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-entity-record.js","sourceRoot":"","sources":["../../../src/entities/record/create-entity-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAO/C,MAAM,UAAU,kBAAkB,CAChC,OAAgD,EAChD,MAKC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,YAAY,CAAO,OAAO,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/entities/record/entity-record.d.ts

@@ -0,0 +1,37 @@
+import { RECORD_TAG } from './marker';
+import type { CoreEntitiesAPI } from '../../root/coreApi/types';
+import type { EntityCleanerStore } from '../cleaner';
+import type { TEntitiesStore } from '../types';
+import type { EntityRecordSnapshot } from './types';
+export declare class EntityRecord<T extends {
+    id: string | number;
+}, M> {
+    private entitiesApi;
+    [RECORD_TAG]: boolean;
+    private id;
+    private entityKey;
+    private entities;
+    private entitiesCleaner;
+    private notify;
+    recordId: string;
+    constructor(options: {
+        entityKey: string;
+        recordId: string;
+    }, system: {
+        entities: TEntitiesStore;
+        entitiesCleaner: EntityCleanerStore;
+        notify: () => void;
+        entitiesApi: CoreEntitiesAPI;
+    });
+    private process;
+    private sync;
+    set(item: T): void;
+    update(item: T): void;
+    reset(): void;
+    get data(): M | undefined;
+    get entityId(): string | number | null;
+    get exists(): boolean;
+    get isEmpty(): boolean;
+    getSnapshot(): EntityRecordSnapshot;
+    applySnapshot(snapshot: EntityRecordSnapshot): void;
+}

package/dist/entities/record/entity-record.js

@@ -0,0 +1,83 @@
+var _a;
+import { makeAutoObservable, runInAction } from 'mobx';
+import { PREFIX } from '../constants';
+import { RECORD_TAG } from './marker';
+export class EntityRecord {
+    constructor(options, system) {
+        this[_a] = true;
+        this.id = null;
+        this.entityKey = options.entityKey;
+        this.recordId = options.recordId;
+        this.entities = system.entities;
+        this.entitiesCleaner = system.entitiesCleaner;
+        this.notify = system.notify;
+        this.entitiesApi = system.entitiesApi;
+        makeAutoObservable(this, {}, { autoBind: true });
+    }
+    // ---------------- NORMALIZATION ----------------
+    process(item) {
+        const ids = this.entitiesApi.process({
+            data: [item],
+            entityKey: this.entityKey,
+            sourceRefId: this.recordId,
+        });
+        return ids[0];
+    }
+    sync() {
+        this.notify();
+    }
+    // ---------------- PUBLIC API ----------------
+    set(item) {
+        this.id = this.process(item);
+        this.sync();
+    }
+    update(item) {
+        this.process(item);
+        this.sync();
+    }
+    reset() {
+        if (this.id === null) {
+            return;
+        }
+        this.entitiesCleaner.deleteCascade(this.entityKey, [this.id], `${PREFIX.RECORD}${this.recordId}`);
+        this.id = null;
+        this.sync();
+    }
+    // ---------------- GETTERS ----------------
+    get data() {
+        if (!this.id) {
+            return undefined;
+        }
+        const entity = this.entities.getEntity(this.entityKey, this.id);
+        // lazy cleanup
+        if (!entity) {
+            queueMicrotask(() => {
+                runInAction(() => {
+                    this.id = null;
+                    this.sync();
+                });
+            });
+            return undefined;
+        }
+        return entity;
+    }
+    get entityId() {
+        return this.id;
+    }
+    get exists() {
+        return this.id !== null && this.data !== undefined;
+    }
+    get isEmpty() {
+        return this.id === null;
+    }
+    // ---------------- SNAPSHOT ----------------
+    getSnapshot() {
+        return { id: this.id };
+    }
+    applySnapshot(snapshot) {
+        this.id = snapshot.id;
+        this.sync();
+    }
+}
+_a = RECORD_TAG;
+//# sourceMappingURL=entity-record.js.map

package/dist/entities/record/entity-record.js.map

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

package/dist/entities/record/index.d.ts

@@ -0,0 +1,2 @@
+import type { EntityRecord } from './entity-record';
+export type { EntityRecord };

package/dist/entities/record/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/entities/record/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/entities/record/index.ts"],"names":[],"mappings":""}

package/dist/entities/record/marker.d.ts

@@ -0,0 +1 @@
+export declare const RECORD_TAG: unique symbol;

package/dist/entities/record/marker.js

@@ -0,0 +1,2 @@
+export const RECORD_TAG = Symbol('record');
+//# sourceMappingURL=marker.js.map

package/dist/entities/record/marker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../../../src/entities/record/marker.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC"}

package/dist/entities/record/public.d.ts

@@ -0,0 +1,25 @@
+export interface EntityRecordSnapshot {
+    id: string | number | null;
+}
+export interface EntityRecord<T, M> {
+    /** Current entity id or null */
+    readonly entityId: string | number | null;
+    /** Resolved entity model (may trigger lazy cleanup) */
+    readonly data: M | undefined;
+    /** True if record points to existing entity */
+    readonly exists: boolean;
+    /** True if record is empty (no id) */
+    readonly isEmpty: boolean;
+    /** Stable record identifier */
+    readonly recordId: string;
+    /** Normalize & set entity, replaces id */
+    set(item: T): void;
+    /** Normalize entity without changing id */
+    update(item: T): void;
+    /** Clear record and cascade delete */
+    reset(): void;
+    /** Serialize record state */
+    getSnapshot(): EntityRecordSnapshot;
+    /** Restore record state */
+    applySnapshot(snapshot: EntityRecordSnapshot): void;
+}

package/dist/entities/record/public.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=public.js.map

package/dist/entities/record/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/entities/record/public.ts"],"names":[],"mappings":""}

package/dist/entities/record/types.d.ts

@@ -0,0 +1,3 @@
+export type EntityRecordSnapshot = {
+    id: string | number | null;
+};

package/dist/entities/record/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/entities/record/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/entities/record/types.ts"],"names":[],"mappings":""}

package/dist/entities/schema.d.ts

@@ -0,0 +1,12 @@
+import type { EntitySchemaOptions, EntityModelCtor } from './types';
+export declare class EntitySchema<TDto, TModel> {
+    key: string;
+    definition: Record<string, EntitySchema<any, any> | [EntitySchema<any, any>]>;
+    options: EntitySchemaOptions<TDto, TModel>;
+    constructor(key: string, definition?: Record<string, EntitySchema<any, any> | [EntitySchema<any, any>]>, options?: EntitySchemaOptions<TDto, TModel>);
+    get model(): EntityModelCtor<TDto, TModel> | undefined;
+    getId(input: TDto): any;
+    getIdKey(): string;
+    process(input: TDto): TDto;
+    merge(target: TModel, source: Partial<TModel>): any;
+}

package/dist/entities/schema.js

@@ -0,0 +1,31 @@
+export class EntitySchema {
+    constructor(key, definition = {}, options = {}) {
+        this.key = key;
+        this.definition = definition;
+        this.options = options;
+    }
+    get model() {
+        return this.options.model;
+    }
+    getId(input) {
+        const { idAttribute = 'id' } = this.options;
+        return typeof idAttribute === 'function'
+            ? idAttribute(input)
+            : input[idAttribute];
+    }
+    getIdKey() {
+        const { idAttribute = 'id' } = this.options;
+        return typeof idAttribute === 'string' ? idAttribute : 'id';
+    }
+    process(input) {
+        return this.options.processStrategy
+            ? this.options.processStrategy(input)
+            : { ...input };
+    }
+    merge(target, source) {
+        return this.options.mergeStrategy
+            ? this.options.mergeStrategy(target, source)
+            : Object.assign(target, source);
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/entities/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/entities/schema.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACvB,YACS,GAAW,EACX,aAGH,EAAE,EACC,UAA6C,EAAE;QAL/C,QAAG,GAAH,GAAG,CAAQ;QACX,eAAU,GAAV,UAAU,CAGX;QACC,YAAO,GAAP,OAAO,CAAwC;IACrD,CAAC;IAEJ,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,KAAW;QACf,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5C,OAAO,OAAO,WAAW,KAAK,UAAU;YACtC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;YACpB,CAAC,CAAE,KAAa,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ;QACN,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5C,OAAO,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,CAAC;IAED,OAAO,CAAC,KAAW;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe;YACjC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC;YACrC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAc,EAAE,MAAuB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa;YAC/B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;YAC5C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAa,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/entities/store.d.ts

@@ -0,0 +1,22 @@
+import type { EntityBuckets, StoredEntity } from './types';
+export declare class EntitiesStore {
+    private buckets;
+    private onMergeCallbacks;
+    constructor();
+    addOnMergeCallback(fn: () => void): void;
+    removeOnMergeCallback(fn: () => void): void;
+    private triggerMergeCallbacks;
+    private getBucket;
+    private ensureBucket;
+    merge(newEntities: Partial<EntityBuckets>): void;
+    hasEntity(entityKey: string, id: string | number): boolean;
+    getEntity<T = any>(entityKey: string, id: string | number): StoredEntity<T> | undefined;
+    getAll<T = any>(entityKey: string): StoredEntity<T>[];
+    getCount(entityKey: string): number;
+    remove(entityKey: string, id: string | number): void;
+    removeMany(toRemove: Record<string, Set<string>>): void;
+    reset(entityKey?: string): void;
+    get getSnapshot(): Record<string, any>;
+    get getSnapshotKeys(): string[];
+    getSnapshotByKey(entityKey: string): Record<string, any>;
+}