@nexigen/entity-normalizer 0.1.1 → 0.1.3

package/dist/entities/store.js

@@ -0,0 +1,154 @@
+import { makeAutoObservable, observable } from 'mobx';
+import { META } from '../constants/values';
+export class EntitiesStore {
+    constructor() {
+        this.buckets = new Map();
+        this.onMergeCallbacks = new Set();
+        Object.defineProperty(this, 'buckets', {
+            enumerable: false,
+            writable: true,
+            configurable: false,
+        });
+        makeAutoObservable(this, {
+            buckets: false,
+            onMergeCallbacks: false,
+            getSnapshot: false,
+            getSnapshotKeys: false,
+            getSnapshotByKey: false,
+            reset: true,
+        }, { autoBind: true });
+    }
+    // ===== callbacks =====
+    addOnMergeCallback(fn) {
+        this.onMergeCallbacks.add(fn);
+    }
+    removeOnMergeCallback(fn) {
+        this.onMergeCallbacks.delete(fn);
+    }
+    triggerMergeCallbacks() {
+        for (const fn of this.onMergeCallbacks) {
+            fn();
+        }
+    }
+    // ===== buckets =====
+    getBucket(key) {
+        return this.buckets.get(key);
+    }
+    ensureBucket(key) {
+        let bucket = this.getBucket(key);
+        if (!bucket) {
+            bucket = observable.object({}, {}, { deep: false });
+            this.buckets.set(key, bucket);
+        }
+        return bucket;
+    }
+    // ===== merge =====
+    merge(newEntities) {
+        for (const key in newEntities) {
+            const bucket = this.ensureBucket(key);
+            const incomingBucket = newEntities[key];
+            if (!incomingBucket) {
+                continue;
+            }
+            for (const id in incomingBucket) {
+                const incoming = incomingBucket[id];
+                const existing = bucket[id];
+                if (existing) {
+                    Object.assign(existing, incoming);
+                }
+                else {
+                    bucket[id] = incoming;
+                }
+            }
+        }
+        this.triggerMergeCallbacks();
+    }
+    // ===== read =====
+    hasEntity(entityKey, id) {
+        return !!this.getBucket(entityKey)?.[id];
+    }
+    getEntity(entityKey, id) {
+        const entity = this.getBucket(entityKey)?.[id];
+        if (entity?.[META]) {
+            entity[META].accessedAt = Date.now();
+        }
+        return entity;
+    }
+    getAll(entityKey) {
+        const bucket = this.getBucket(entityKey);
+        return bucket ? Object.values(bucket) : [];
+    }
+    getCount(entityKey) {
+        return Object.keys(this.getBucket(entityKey) ?? {}).length;
+    }
+    // ===== remove =====
+    remove(entityKey, id) {
+        const bucket = this.getBucket(entityKey);
+        if (!bucket) {
+            return;
+        }
+        delete bucket[id];
+        this.triggerMergeCallbacks();
+    }
+    removeMany(toRemove) {
+        for (const key in toRemove) {
+            const bucket = this.getBucket(key);
+            if (!bucket) {
+                continue;
+            }
+            const ids = toRemove[key];
+            if (!ids || ids.size === 0) {
+                continue;
+            }
+            ids.forEach(id => {
+                delete bucket[id];
+            });
+        }
+        this.triggerMergeCallbacks();
+    }
+    // ===== reset =====
+    reset(entityKey) {
+        if (entityKey) {
+            this.buckets.set(entityKey, observable.object({}, {}, { deep: false }));
+            return;
+        }
+        for (const key of this.buckets.keys()) {
+            this.buckets.set(key, observable.object({}, {}, { deep: false }));
+        }
+        this.triggerMergeCallbacks();
+    }
+    // ===== snapshot =====
+    get getSnapshot() {
+        const out = {};
+        for (const [key, bucket] of this.buckets.entries()) {
+            out[key] = { ...bucket };
+        }
+        return out;
+    }
+    get getSnapshotKeys() {
+        return Array.from(this.buckets.keys());
+    }
+    getSnapshotByKey(entityKey) {
+        const bucket = this.getBucket(entityKey);
+        if (!bucket) {
+            return {};
+        }
+        const out = {};
+        for (const [id, entity] of Object.entries(bucket)) {
+            const { [META]: meta, ...rest } = entity;
+            out[id] = {
+                ...rest,
+                [META]: meta
+                    ? {
+                        createdAt: meta.createdAt,
+                        updatedAt: meta.updatedAt,
+                        accessedAt: meta.accessedAt,
+                        refSources: Array.from(meta.refSources ?? []),
+                    }
+                    : undefined,
+            };
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/entities/store.js.map

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

package/dist/entities/types.d.ts

@@ -0,0 +1,82 @@
+import type { EntitySchema } from './schema';
+import type { EntitiesStore } from './store';
+import type { META } from '../constants/values';
+/**
+ * Runtime schema type for infra layers
+ */
+export type AnySchema = EntitySchema<any, any>;
+/**
+ * Generic entity buckets shape
+ * key   -> entityKey (string)
+ * value -> map of id -> stored entity
+ */
+export type EntityBuckets = Record<string, Record<string, StoredEntity<any>>>;
+/**
+ * Resolver injected into models
+ */
+export type GetEntity = <T = any>(entityKey: string, id: string | number) => PublicEntity<StoredEntity<T>> | undefined;
+/**
+ * Entity model constructor contract
+ */
+export interface EntityModelCtor<TDto, TModel> {
+    new (dto: TDto, getEntity: GetEntity): TModel;
+}
+/**
+ * Schema options (runtime-oriented)
+ */
+export interface EntitySchemaOptions<TDto, TModel> {
+    idAttribute?: ((input: any) => string | number) | string;
+    processStrategy?: (input: any) => any;
+    mergeStrategy?: (a: any, b: any) => any;
+    model?: EntityModelCtor<TDto, TModel>;
+}
+/**
+ * Core store type (no domain knowledge)
+ */
+export type TEntitiesStore = EntitiesStore;
+/**
+ * Entity metadata (infra concern)
+ */
+export type EntityMeta = {
+    createdAt: number;
+    updatedAt: number;
+    accessedAt: number;
+    refSources?: Set<string>;
+};
+/**
+ * Stored entity = model + meta
+ */
+export type StoredEntity<T> = T & {
+    _meta_nexigen: EntityMeta;
+};
+/**
+ * Garbage collector item
+ */
+export type EntityGarbageCollectorItem = {
+    id: string;
+    meta: EntityMeta;
+};
+/**
+ * Normalization output
+ */
+export interface NormalizedOutput {
+    map: Partial<EntityBuckets>;
+    ids: (string | number)[];
+}
+/**
+ * Entity processing options
+ */
+export interface EntityProcessOptions<T> {
+    data: T | T[];
+    entityKey: string;
+    sourceRefId: string;
+    isCollection?: boolean;
+}
+/**
+ * Persist snapshot shape
+ */
+export type EntitiesSnapshot = Record<string, Record<string, any>>;
+/**
+ * Public projection (hide meta from DX)
+ */
+export type PublicEntity<T> = Omit<T, typeof META>;

package/dist/entities/types.js

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

package/dist/entities/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { createDuck } from './async';
+import { createStoreHooks } from './create-store-hooks';
+import { registerRootStore } from './di';
+import { createEntitySchema } from './entities/create-entity-schema';
+import { createRootStore } from './root';
+export * from './root/coreApi/public';
+export * from './root/public';
+export * from './entities/record/public';
+export * from './entities/collection/public';
+export * from './entities/public';
+export * from './async/public';
+export { registerRootStore, createRootStore, createStoreHooks, createDuck, createEntitySchema, };

package/dist/index.js

@@ -0,0 +1,13 @@
+import { createDuck } from './async';
+import { createStoreHooks } from './create-store-hooks';
+import { registerRootStore } from './di';
+import { createEntitySchema } from './entities/create-entity-schema';
+import { createRootStore } from './root';
+export * from './root/coreApi/public';
+export * from './root/public';
+export * from './entities/record/public';
+export * from './entities/collection/public';
+export * from './entities/public';
+export * from './async/public';
+export { registerRootStore, createRootStore, createStoreHooks, createDuck, createEntitySchema, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,kBAAkB,GACnB,CAAC"}

package/dist/root/RootStore.d.ts

@@ -0,0 +1,24 @@
+import { SET_PERSISTENCE } from './marker';
+import type { CoreAPI } from './coreApi/types';
+import type { RootStoreDeps, StoreClassMap, ServiceClassMap, PersistenceNotifier } from './types';
+import type { AnySchema } from '../entities/types';
+export declare class RootStore<TApi, TSchemaMap extends Record<string, AnySchema>, TStores extends StoreClassMap<any, any>, TServices extends ServiceClassMap<any, any>> {
+    private deps;
+    core: CoreAPI<{
+        [K in keyof TStores]: InstanceType<TStores[K]>;
+    }>;
+    private entities;
+    private entitiesCleaner;
+    private persistence?;
+    [SET_PERSISTENCE](notifier: PersistenceNotifier): void;
+    stores: {
+        [K in keyof TStores]: InstanceType<TStores[K]>;
+    };
+    services: {
+        [K in keyof TServices]: InstanceType<TServices[K]>;
+    };
+    private _isInitialized;
+    constructor(deps: RootStoreDeps<TApi, TSchemaMap, TStores, TServices>);
+    private get isInitialized();
+    private setInitialized;
+}

package/dist/root/RootStore.js

@@ -0,0 +1,134 @@
+import { makeAutoObservable } from 'mobx';
+import { createStore } from '../create';
+import { EntityCleanerStore } from '../entities/cleaner';
+import { COLLECTION_TAG, MULTI_COLLECTION_TAG, } from '../entities/collection/marker';
+import { RECORD_TAG } from '../entities/record/marker';
+import { EntitiesStore } from '../entities/store';
+import { createCoreAPI } from './coreApi/create-core-api';
+import { noopPersistence } from './fallback';
+import { SET_PERSISTENCE } from './marker';
+export class RootStore {
+    [SET_PERSISTENCE](notifier) {
+        this.persistence = notifier;
+    }
+    constructor(deps) {
+        this.deps = deps;
+        this._isInitialized = false;
+        const self = this;
+        // ---------------------------------------------
+        // Core systems
+        // ---------------------------------------------
+        this.entities = new EntitiesStore();
+        this.entitiesCleaner = new EntityCleanerStore(this.entities, this.deps.schemaMap);
+        const storesRef = {};
+        this.core = createCoreAPI({
+            lifecycle: {
+                getIsInitialized: () => self.isInitialized,
+                setInitialized: (v) => self.setInitialized(v),
+            },
+            entities: {
+                entities: this.entities,
+                entitiesCleaner: this.entitiesCleaner,
+                schemaMap: this.deps.schemaMap,
+                getPersistence: () => this.persistence ?? noopPersistence,
+            },
+            stores: storesRef,
+            __internal: {
+                setPersistence: notifier => {
+                    this[SET_PERSISTENCE](notifier);
+                },
+            },
+        });
+        // ---------------------------------------------
+        // Deps
+        // ---------------------------------------------
+        const domainDeps = {
+            api: deps.api,
+            get stores() {
+                return self.stores;
+            },
+            get services() {
+                return self.services;
+            },
+            core: this.core,
+        };
+        const systemDeps = {
+            getPersistence: () => this.persistence ?? noopPersistence,
+            entities: this.entities,
+        };
+        const combinedDeps = {
+            domain: domainDeps,
+            system: systemDeps,
+        };
+        // ---------------------------------------------
+        // Plugins
+        // ---------------------------------------------
+        const decorators = {
+            isRecord: (v) => v?.[RECORD_TAG] === true,
+            isCollection: (v) => v?.[COLLECTION_TAG] === true,
+            isMultiCollection: (v) => v?.[MULTI_COLLECTION_TAG] === true,
+        };
+        for (const plugin of this.deps.plugins ?? []) {
+            plugin.setup({
+                entities: this.entities,
+                core: this.core,
+                config: plugin.config,
+                domain: domainDeps,
+                decorators,
+            });
+        }
+        // ---------------------------------------------
+        // Build stores
+        // ---------------------------------------------
+        this.stores = Object.fromEntries(Object.entries(this.deps.stores).map(([key, StoreClass]) => {
+            const instance = createStore(StoreClass, combinedDeps);
+            return [key, instance];
+        }));
+        Object.assign(storesRef, this.stores);
+        // ---------------------------------------------
+        // Build services
+        // ---------------------------------------------
+        this.services = Object.fromEntries(Object.entries(this.deps.services).map(([key, ServiceClass]) => {
+            const instance = new ServiceClass(domainDeps);
+            Object.defineProperty(instance, 'deps', {
+                enumerable: false,
+                configurable: true,
+                writable: true,
+            });
+            return [key, instance];
+        }));
+        // Hide cyclical getters inside domainDeps
+        Object.defineProperty(this, 'deps', {
+            enumerable: false,
+            configurable: true,
+            writable: true,
+        });
+        Object.defineProperty(domainDeps, 'stores', {
+            enumerable: false,
+            configurable: true,
+        });
+        Object.defineProperty(domainDeps, 'services', {
+            enumerable: false,
+            configurable: true,
+        });
+        Object.defineProperty(domainDeps, 'core', {
+            enumerable: false,
+            configurable: true,
+        });
+        Object.defineProperty(this.core, '__internal', {
+            enumerable: false,
+        });
+        makeAutoObservable(this, {
+            core: false,
+            services: false,
+            stores: false,
+        });
+    }
+    get isInitialized() {
+        return this._isInitialized;
+    }
+    setInitialized(v) {
+        this._isInitialized = v;
+    }
+}
+//# sourceMappingURL=RootStore.js.map

package/dist/root/RootStore.js.map

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

package/dist/root/coreApi/create-core-api.d.ts

@@ -0,0 +1,7 @@
+import type { CoreAPI, CoreEntitiesDeps, CoreLifecycleDeps, CoreStoresDeps, CoreInternalAPI } from './types';
+export declare function createCoreAPI<TStores extends Record<string, any>>(deps: {
+    lifecycle: CoreLifecycleDeps;
+    entities: CoreEntitiesDeps;
+    stores: CoreStoresDeps<TStores>;
+    __internal: CoreInternalAPI;
+}): CoreAPI<TStores>;

package/dist/root/coreApi/create-core-api.js

@@ -0,0 +1,12 @@
+import { createEntitiesAPI } from './entities';
+import { createLifecycleAPI } from './lifecycle';
+import { createStoresAPI } from './stores';
+export function createCoreAPI(deps) {
+    return {
+        lifecycle: createLifecycleAPI(deps.lifecycle),
+        entities: createEntitiesAPI(deps.entities),
+        stores: createStoresAPI(deps.stores),
+        __internal: deps.__internal,
+    };
+}
+//# sourceMappingURL=create-core-api.js.map

package/dist/root/coreApi/create-core-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-core-api.js","sourceRoot":"","sources":["../../../src/root/coreApi/create-core-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAU3C,MAAM,UAAU,aAAa,CAAsC,IAKlE;IACC,OAAO;QACL,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC7C,QAAQ,EAAE,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC1C,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;QACpC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC"}

package/dist/root/coreApi/entities.d.ts

@@ -0,0 +1,10 @@
+import type { EntityCleanerStore } from '../../entities/cleaner';
+import type { TEntitiesStore } from '../../entities/types';
+import type { TSchemaMap, PersistenceNotifier } from '../types';
+import type { CoreEntitiesAPI } from './types';
+export declare function createEntitiesAPI(deps: {
+    entities: TEntitiesStore;
+    schemaMap: TSchemaMap;
+    entitiesCleaner: EntityCleanerStore;
+    getPersistence: () => PersistenceNotifier | undefined;
+}): CoreEntitiesAPI;

package/dist/root/coreApi/entities.js

@@ -0,0 +1,57 @@
+import { createEntityCollection, createMultiEntityCollection, } from '../../entities/collection/create-entity-collection';
+import { createEntityProcessor, createEntityRestorer, } from '../../entities/processor';
+import { createEntityRecord } from '../../entities/record/create-entity-record';
+export function createEntitiesAPI(deps) {
+    const { entities, entitiesCleaner, schemaMap, getPersistence } = deps;
+    const notify = () => {
+        getPersistence?.()?.onPointersChanged?.();
+    };
+    return {
+        createRecord(options) {
+            return createEntityRecord(options, {
+                entities,
+                notify,
+                entitiesCleaner,
+                entitiesApi: this,
+            });
+        },
+        createCollection(options) {
+            return createEntityCollection(options, {
+                entities,
+                entitiesCleaner,
+                notify,
+                entitiesApi: this,
+            });
+        },
+        createMultiCollection(options) {
+            return createMultiEntityCollection(options, {
+                entities,
+                entitiesCleaner,
+                notify,
+                entitiesApi: this,
+            });
+        },
+        process(options) {
+            return createEntityProcessor(entities, schemaMap, options);
+        },
+        hydrate(snapshot) {
+            return createEntityRestorer(entities, schemaMap)(snapshot);
+        },
+        get(key, id) {
+            return entities.getEntity(key, id);
+        },
+        getAll(key) {
+            return entities.getAll(key);
+        },
+        getCount(key) {
+            return entities.getCount(key);
+        },
+        getSnapshot() {
+            return entities.getSnapshot;
+        },
+        getSchema(key) {
+            return schemaMap[key];
+        },
+    };
+}
+//# sourceMappingURL=entities.js.map

package/dist/root/coreApi/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../../src/root/coreApi/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAchF,MAAM,UAAU,iBAAiB,CAAC,IAKjC;IACC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAEtE,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,CAAC;IAC5C,CAAC,CAAC;IAEF,OAAO;QACL,YAAY,CAAuC,OAGlD;YACC,OAAO,kBAAkB,CAAO,OAAO,EAAE;gBACvC,QAAQ;gBACR,MAAM;gBACN,eAAe;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,gBAAgB,CACd,OAAmC;YAEnC,OAAO,sBAAsB,CAAO,OAAO,EAAE;gBAC3C,QAAQ;gBACR,eAAe;gBACf,MAAM;gBACN,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB,CACnB,OAAmC;YAEnC,OAAO,2BAA2B,CAAO,OAAO,EAAE;gBAChD,QAAQ;gBACR,eAAe;gBACf,MAAM;gBACN,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CACL,OAAyD;YAEzD,OAAO,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,CAAC,QAA6C;YACnD,OAAO,oBAAoB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC7D,CAAC;QAED,GAAG,CAAmB,GAAM,EAAE,EAAmB;YAC/C,OAAO,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,CAAQ,CAAC;QAC5C,CAAC;QAED,MAAM,CAAmB,GAAM;YAC7B,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAQ,CAAC;QACrC,CAAC;QAED,QAAQ,CAAmB,GAAM;YAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAED,WAAW;YACT,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QAED,SAAS,CAAsB,GAAS;YACtC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/root/coreApi/lifecycle.d.ts

@@ -0,0 +1,5 @@
+import type { CoreLifecycleAPI } from './types';
+export declare function createLifecycleAPI(deps: {
+    getIsInitialized: () => boolean;
+    setInitialized: (v: boolean) => void;
+}): CoreLifecycleAPI;

package/dist/root/coreApi/lifecycle.js

@@ -0,0 +1,9 @@
+export function createLifecycleAPI(deps) {
+    return {
+        get isInitialized() {
+            return deps.getIsInitialized();
+        },
+        setInitialized: deps.setInitialized,
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/root/coreApi/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/root/coreApi/lifecycle.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,IAGlC;IACC,OAAO;QACL,IAAI,aAAa;YACf,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACjC,CAAC;QACD,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC"}

package/dist/root/coreApi/public.d.ts

@@ -0,0 +1,71 @@
+import type { EntityCollection } from '../../entities/collection/public';
+import type { MultiEntityCollection } from '../../entities/collection/public';
+import type { EntityId } from '../../entities/public';
+import type { EntityRecord } from '../../entities/record/public';
+/**
+ * Snapshot of a single store
+ * Shape is store-defined
+ */
+export type StoreSnapshot = Record<string, any>;
+/**
+ * Snapshot of all stores
+ */
+export type StoresSnapshot<TStores> = {
+    [K in keyof TStores]?: StoreSnapshot;
+};
+export interface EntityProcessOptions<T> {
+    data: T | T[];
+    entityKey: string;
+    sourceRefId: string;
+    isCollection?: boolean;
+}
+export type CoreEntitiesAPI = {
+    createRecord<T extends {
+        id: EntityId;
+    }, M>(options: {
+        entityKey: string;
+        recordId: string;
+    }): EntityRecord<T, M>;
+    createCollection<T extends {
+        id: EntityId;
+    }, M>(options: {
+        entityKey: string;
+        collectionId?: string;
+        limit?: number;
+        reversed?: boolean;
+        hasNoMore?: boolean;
+    }): EntityCollection<T, M>;
+    createMultiCollection<T extends {
+        id: EntityId;
+    }, M>(options: {
+        entityKey: string;
+        collectionId?: string;
+        limit?: number;
+        reversed?: boolean;
+        hasNoMore?: boolean;
+    }): MultiEntityCollection<T, M>;
+    process<TDto>(options: EntityProcessOptions<TDto>): EntityId[];
+    hydrate(snapshot: Record<string, Record<string, any>> | null | undefined): void;
+    get<T = any>(entityKey: string, id: EntityId): T | undefined;
+    getAll<T = any>(entityKey: string): T[];
+    getCount(entityKey: string): number;
+    getSnapshot(): Record<string, any>;
+    getSchema(entityKey: string): unknown;
+};
+export type CoreStoresAPI<TStores> = {
+    getSnapshot(): StoresSnapshot<TStores>;
+    getSnapshotByKey<K extends keyof TStores>(key: K): StoresSnapshot<TStores>[K];
+    applySnapshot(snapshot: StoresSnapshot<TStores>): void;
+    applySnapshotByKey<K extends keyof TStores>(key: K, snapshot: StoresSnapshot<TStores>[K]): void;
+    resetAll(): void;
+    resetByKey<K extends keyof TStores>(key: K): void;
+};
+export type CoreLifecycleAPI = {
+    readonly isInitialized: boolean;
+    setInitialized(v: boolean): void;
+};
+export type CoreAPI<TStores = {}> = {
+    lifecycle: CoreLifecycleAPI;
+    entities: CoreEntitiesAPI;
+    stores: CoreStoresAPI<TStores>;
+};

package/dist/root/coreApi/public.js

@@ -0,0 +1,6 @@
+/* ======================================================
+ * CORE — PUBLIC API
+ * Everything domain stores & services ARE allowed to use
+ * ====================================================== */
+export {};
+//# sourceMappingURL=public.js.map

package/dist/root/coreApi/public.js.map

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

package/dist/root/coreApi/stores.d.ts

@@ -0,0 +1,2 @@
+import type { CoreStoresAPI } from './types';
+export declare function createStoresAPI<TStores extends Record<string, any>>(stores?: TStores | any): CoreStoresAPI<TStores>;