@laboverwire/stitch 0.4.1

package/dist/persistence-layer.js

@@ -0,0 +1,409 @@
+import { wrapWasmError, isCorruptionError } from "./internal-wasm-error.js";
+const PENDING_SYNC_DEFINITION = {
+    fields: [
+        { name: 'id', type: 'string', required: true },
+        { name: 'op', type: 'string', required: true },
+        { name: 'entity', type: 'string', required: true },
+        { name: 'entityId', type: 'string', required: true },
+        { name: 'scopeId', type: 'string', required: true },
+        { name: 'userId', type: 'string', required: true },
+        { name: 'data', type: 'object' },
+        { name: 'createdAt', type: 'number' },
+    ],
+    indexes: ['scopeId', 'entity'],
+};
+class PersistenceLayerImpl {
+    db = null;
+    dbName = null;
+    dbRecovering = false;
+    _dbNeedsRecovery = false;
+    shuttingDown = false;
+    _opQueue = Promise.resolve();
+    config;
+    allSyncedEntities;
+    allLocalEntities;
+    entitySubscriptions = new Map();
+    wasmSubscriptionIds = new Map();
+    suppressEntityNotifications = false;
+    constructor(config) {
+        this.config = config;
+        this.allSyncedEntities = [
+            config.scope.rootEntity,
+            ...config.scope.childEntities,
+            ...(config.topLevelEntities?.map((t) => t.entity) ?? []),
+        ];
+        this.allLocalEntities = Object.keys(config.localOnlyEntities ?? {});
+    }
+    get isOpen() {
+        return this.db !== null;
+    }
+    async open(dbName) {
+        if (this.db)
+            return;
+        const wasmMod = await import('mqdb-wasm');
+        try {
+            await wasmMod.default();
+        }
+        catch (err) {
+            throw wrapWasmError('init', err);
+        }
+        try {
+            this.db = await wasmMod.Database.openPersistent(dbName);
+            this.dbName = dbName;
+        }
+        catch (err) {
+            throw wrapWasmError(`openPersistent:${dbName}`, err);
+        }
+        await this.setupSchemas();
+        this.setupWasmSubscriptions();
+    }
+    close() {
+        this.shuttingDown = true;
+        this._opQueue = Promise.resolve();
+        this.unsubscribeAllWasm();
+        this.entitySubscriptions.clear();
+        if (this.db) {
+            try {
+                this.db.free();
+            }
+            catch { }
+        }
+        this.db = null;
+        this.shuttingDown = false;
+    }
+    notifyCorruption() {
+        this._dbNeedsRecovery = true;
+        this.serialized('proactiveRecovery', async () => { }).catch(() => { });
+    }
+    setSuppressNotifications(suppress) {
+        this.suppressEntityNotifications = suppress;
+    }
+    serialized(label, fn, timeoutMs = 10000) {
+        if (this.shuttingDown)
+            return Promise.reject(new Error('Service shutting down'));
+        const result = this._opQueue.then(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 0));
+            if (this._dbNeedsRecovery) {
+                this._dbNeedsRecovery = false;
+                await this.recoverDb();
+            }
+            let timer;
+            const timeout = new Promise((_, reject) => {
+                timer = setTimeout(() => {
+                    this._dbNeedsRecovery = true;
+                    reject(new Error(`serialized('${label}') timed out after ${timeoutMs}ms`));
+                }, timeoutMs);
+            });
+            return Promise.race([fn(), timeout]).finally(() => {
+                clearTimeout(timer);
+            });
+        });
+        this._opQueue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    async create(entity, data) {
+        await this.serialized('create:' + entity, async () => {
+            if (!this.db)
+                throw new Error('Database not open');
+            try {
+                await this.db.create(entity, data);
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        await this.db.create(entity, data);
+                    }
+                    catch (retryErr) {
+                        throw wrapWasmError(`create:${entity}`, retryErr);
+                    }
+                }
+                else {
+                    throw wrapWasmError(`create:${entity}`, err);
+                }
+            }
+        });
+    }
+    async read(entity, id) {
+        return this.serialized('read:' + entity, async () => {
+            if (!this.db)
+                throw new Error('Database not open');
+            try {
+                return (await this.db.read(entity, id));
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        return (await this.db.read(entity, id));
+                    }
+                    catch (retryErr) {
+                        throw wrapWasmError(`read:${entity}`, retryErr);
+                    }
+                }
+                throw wrapWasmError(`read:${entity}`, err);
+            }
+        });
+    }
+    async update(entity, id, data) {
+        await this.serialized('update:' + entity, async () => {
+            if (!this.db)
+                throw new Error('Database not open');
+            try {
+                await this.db.update(entity, id, data);
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        await this.db.update(entity, id, data);
+                    }
+                    catch (retryErr) {
+                        throw wrapWasmError(`update:${entity}`, retryErr);
+                    }
+                }
+                else {
+                    throw wrapWasmError(`update:${entity}`, err);
+                }
+            }
+        });
+    }
+    async delete(entity, id) {
+        await this.serialized('delete:' + entity, async () => {
+            if (!this.db)
+                throw new Error('Database not open');
+            try {
+                await this.db.delete(entity, id);
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        await this.db.delete(entity, id);
+                    }
+                    catch (retryErr) {
+                        throw wrapWasmError(`delete:${entity}`, retryErr);
+                    }
+                }
+                else {
+                    throw wrapWasmError(`delete:${entity}`, err);
+                }
+            }
+        });
+    }
+    async list(entity, options) {
+        return this.serialized('list:' + entity, async () => {
+            if (!this.db)
+                return [];
+            try {
+                return (await this.db.list(entity, options ?? {}));
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        return (await this.db.list(entity, options ?? {}));
+                    }
+                    catch {
+                        return [];
+                    }
+                }
+                throw wrapWasmError(`list:${entity}`, err);
+            }
+        });
+    }
+    async count(entity, options) {
+        return this.serialized('count:' + entity, async () => {
+            if (!this.db)
+                return 0;
+            try {
+                return await this.db.count(entity, options ?? {});
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        return await this.db.count(entity, options ?? {});
+                    }
+                    catch {
+                        return 0;
+                    }
+                }
+                return 0;
+            }
+        });
+    }
+    subscribe(entity, callback) {
+        let set = this.entitySubscriptions.get(entity);
+        if (!set) {
+            set = new Set();
+            this.entitySubscriptions.set(entity, set);
+        }
+        set.add(callback);
+        return () => {
+            const current = this.entitySubscriptions.get(entity);
+            if (!current)
+                return;
+            current.delete(callback);
+            if (current.size === 0)
+                this.entitySubscriptions.delete(entity);
+        };
+    }
+    notifyAllEntitySubscribers() {
+        for (const entity of this.entitySubscriptions.keys()) {
+            this.notifyEntitySubscribers(entity, null, 'update');
+        }
+    }
+    async readLocalState(entity, id) {
+        return this.serialized('readLocalState', async () => {
+            if (!this.db)
+                return null;
+            try {
+                return (await this.db.read(entity, id));
+            }
+            catch (err) {
+                if (this.isDbCorrupted(err) && (await this.recoverDb())) {
+                    try {
+                        return (await this.db.read(entity, id));
+                    }
+                    catch {
+                        return null;
+                    }
+                }
+                return null;
+            }
+        });
+    }
+    async updateLocalState(entity, id, fields) {
+        await this.serialized('updateLocalState', async () => {
+            if (!this.db)
+                return;
+            try {
+                await this.db.update(entity, id, fields);
+            }
+            catch {
+                try {
+                    await this.db.create(entity, { id, ...fields });
+                }
+                catch { }
+            }
+        }, 5000);
+    }
+    notifyEntitySubscribers(entity, data, op) {
+        const subscribers = this.entitySubscriptions.get(entity);
+        if (subscribers) {
+            for (const callback of subscribers) {
+                callback(data, op);
+            }
+        }
+    }
+    parseOperationFromEvent(operation) {
+        if (!operation)
+            return null;
+        if (operation === 'create')
+            return 'insert';
+        if (operation === 'update')
+            return 'update';
+        if (operation === 'delete')
+            return 'delete';
+        return null;
+    }
+    async setupSchemas() {
+        if (!this.db)
+            return;
+        const db = this.db;
+        const { entities, localOnlyEntities } = this.config;
+        const pendingSyncDef = localOnlyEntities?.['pending_sync'];
+        const schemaDefs = [
+            ...Object.entries(entities),
+            ...Object.entries(localOnlyEntities ?? {}),
+        ];
+        if (!pendingSyncDef) {
+            schemaDefs.push(['pending_sync', PENDING_SYNC_DEFINITION]);
+        }
+        await Promise.all(schemaDefs.map(async ([entity, def]) => {
+            try {
+                await db.addSchemaAsync(entity, def);
+            }
+            catch (err) {
+                throw wrapWasmError(`addSchema:${entity}`, err);
+            }
+        }));
+        await Promise.all(schemaDefs.flatMap(([entity, def]) => [
+            ...(def.foreignKeys ?? []).map(async (fk) => {
+                try {
+                    await db.addForeignKeyAsync(entity, fk.field, fk.references, 'id', fk.onDelete);
+                }
+                catch (err) {
+                    throw wrapWasmError(`addForeignKey:${entity}.${fk.field}`, err);
+                }
+            }),
+            ...(def.indexes ?? []).map(async (field) => {
+                try {
+                    await db.addIndexAsync(entity, [field]);
+                }
+                catch (err) {
+                    throw wrapWasmError(`addIndex:${entity}.${field}`, err);
+                }
+            }),
+        ]));
+    }
+    unsubscribeAllWasm() {
+        if (this.db) {
+            for (const subId of this.wasmSubscriptionIds.values()) {
+                try {
+                    this.db.unsubscribe(subId);
+                }
+                catch { }
+            }
+        }
+        this.wasmSubscriptionIds.clear();
+    }
+    setupWasmSubscriptions() {
+        if (!this.db)
+            return;
+        this.unsubscribeAllWasm();
+        const allEntities = [...this.allSyncedEntities, ...this.allLocalEntities];
+        for (const entity of allEntities) {
+            let subId;
+            try {
+                subId = this.db.subscribe('#', entity, (event) => {
+                    if (this.suppressEntityNotifications)
+                        return;
+                    const evt = event;
+                    const op = this.parseOperationFromEvent(evt.operation);
+                    if (op) {
+                        this.notifyEntitySubscribers(entity, evt.data, op);
+                    }
+                });
+            }
+            catch (err) {
+                throw wrapWasmError(`subscribe:${entity}`, err);
+            }
+            this.wasmSubscriptionIds.set(entity, subId);
+        }
+    }
+    isDbCorrupted(err) {
+        return isCorruptionError(err, ['index out of bounds', 'database is busy']);
+    }
+    async recoverDb() {
+        if (this.dbRecovering)
+            return false;
+        this.dbRecovering = true;
+        const oldDb = this.db;
+        try {
+            if (!this.dbName)
+                return false;
+            const wasmMod = await import('mqdb-wasm');
+            this.db = await wasmMod.Database.openPersistent(this.dbName);
+            await this.setupSchemas();
+            this.setupWasmSubscriptions();
+            return true;
+        }
+        catch {
+            this.db = oldDb;
+            return false;
+        }
+        finally {
+            this.dbRecovering = false;
+        }
+    }
+}
+export function createPersistenceLayer(config) {
+    return new PersistenceLayerImpl(config);
+}
+//# sourceMappingURL=persistence-layer.js.map

package/dist/persistence-layer.js.map

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

package/dist/react/context.d.ts

@@ -0,0 +1,10 @@
+import type { ConnectionStatus, Store } from '../types.ts';
+export interface StoreContextValue {
+    store: Store;
+    initialized: boolean;
+    connectionStatus: ConnectionStatus;
+    error: Error | null;
+}
+export declare const StoreContext: import("react").Context<StoreContextValue | null>;
+export declare function useStore(): StoreContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/react/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/react/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,mDAAgD,CAAC;AAE1E,wBAAgB,QAAQ,IAAI,iBAAiB,CAI5C"}

package/dist/react/context.js

@@ -0,0 +1,9 @@
+import { createContext, useContext } from 'react';
+export const StoreContext = createContext(null);
+export function useStore() {
+    const ctx = useContext(StoreContext);
+    if (!ctx)
+        throw new Error('useStore must be used within a StoreProvider');
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/react/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/react/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAUlD,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAA2B,IAAI,CAAC,CAAC;AAE1E,MAAM,UAAU,QAAQ;IACtB,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC1E,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/react/hooks/useChildCounts.d.ts

@@ -0,0 +1,3 @@
+import type { Store } from '../../types.ts';
+export declare function useChildCounts(store: Store, entity: string): Map<string, number>;
+//# sourceMappingURL=useChildCounts.d.ts.map

package/dist/react/hooks/useChildCounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChildCounts.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useChildCounts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAuFhF"}

package/dist/react/hooks/useChildCounts.js

@@ -0,0 +1,85 @@
+import { useEffect, useState } from 'react';
+export function useChildCounts(store, entity) {
+    const scopeField = store.config.scope.scopeField;
+    const [counts, setCounts] = useState(new Map());
+    useEffect(() => {
+        let fetched = false;
+        let cancelled = false;
+        const buffer = [];
+        const fetchAll = () => {
+            store
+                .list(entity, { projection: ['id', scopeField] })
+                .then((records) => {
+                if (cancelled)
+                    return;
+                const countMap = new Map();
+                for (const record of records) {
+                    const sid = record[scopeField];
+                    if (sid) {
+                        countMap.set(sid, (countMap.get(sid) ?? 0) + 1);
+                    }
+                }
+                for (const { entity: e, op } of buffer) {
+                    if (op === 'update')
+                        continue;
+                    const n = e;
+                    const sid = n[scopeField];
+                    if (!sid)
+                        continue;
+                    const current = countMap.get(sid) ?? 0;
+                    if (op === 'insert') {
+                        countMap.set(sid, current + 1);
+                    }
+                    else if (op === 'delete') {
+                        countMap.set(sid, Math.max(0, current - 1));
+                    }
+                }
+                buffer.length = 0;
+                fetched = true;
+                setCounts(countMap);
+            })
+                .catch(() => {
+                if (cancelled)
+                    return;
+                fetched = true;
+                buffer.length = 0;
+            });
+        };
+        const unsubscribe = store.subscribeToEntity(entity, (entityData, op) => {
+            if (entityData === null) {
+                fetchAll();
+                return;
+            }
+            if (op === 'update')
+                return;
+            if (typeof entityData !== 'object')
+                return;
+            if (!fetched) {
+                buffer.push({ entity: entityData, op });
+                return;
+            }
+            const record = entityData;
+            const sid = record[scopeField];
+            if (!sid)
+                return;
+            setCounts((prev) => {
+                const next = new Map(prev);
+                const current = next.get(sid) ?? 0;
+                if (op === 'insert') {
+                    next.set(sid, current + 1);
+                }
+                else if (op === 'delete') {
+                    next.set(sid, Math.max(0, current - 1));
+                }
+                return next;
+            });
+        });
+        fetchAll();
+        return () => {
+            cancelled = true;
+            unsubscribe();
+        };
+    }, [store, entity, scopeField]);
+    return counts;
+}
+//# sourceMappingURL=useChildCounts.js.map

package/dist/react/hooks/useChildCounts.js.map

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

package/dist/react/hooks/useConnectionStatus.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectionStatus, Store } from '../../types.ts';
+export declare function useConnectionStatus(store: Store): ConnectionStatus;
+//# sourceMappingURL=useConnectionStatus.d.ts.map

package/dist/react/hooks/useConnectionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectionStatus.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useConnectionStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,gBAAgB,CAQlE"}

package/dist/react/hooks/useConnectionStatus.js

@@ -0,0 +1,9 @@
+import { useEffect, useState } from 'react';
+export function useConnectionStatus(store) {
+    const [status, setStatus] = useState(store.connectionStatus);
+    useEffect(() => {
+        return store.subscribeToConnectionStatus(setStatus);
+    }, [store]);
+    return status;
+}
+//# sourceMappingURL=useConnectionStatus.js.map

package/dist/react/hooks/useConnectionStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useConnectionStatus.js","sourceRoot":"","sources":["../../../src/react/hooks/useConnectionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAG5C,MAAM,UAAU,mBAAmB,CAAC,KAAY;IAC9C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAmB,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAE/E,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,KAAK,CAAC,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/react/hooks/useEntitySnapshot.d.ts

@@ -0,0 +1,4 @@
+import type { MemoryStore, Store } from '../../types.ts';
+export declare function useEntitySnapshot(store: MemoryStore | Store, scopeId: string, entity: string): Record<string, unknown>[];
+export declare function useEntitySnapshotAsMap(store: MemoryStore | Store, scopeId: string, entity: string): Record<string, Record<string, unknown>>;
+//# sourceMappingURL=useEntitySnapshot.d.ts.map

package/dist/react/hooks/useEntitySnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntitySnapshot.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useEntitySnapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAUzD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,GAAG,KAAK,EAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAY3B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,GAAG,KAAK,EAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAYzC"}

package/dist/react/hooks/useEntitySnapshot.js

@@ -0,0 +1,33 @@
+import { useSyncExternalStore } from 'react';
+const EMPTY_ARRAY = [];
+const EMPTY_MAP = {};
+function resolveMemory(storeOrMemory) {
+    if ('memory' in storeOrMemory)
+        return storeOrMemory.memory;
+    return storeOrMemory;
+}
+export function useEntitySnapshot(store, scopeId, entity) {
+    const memory = resolveMemory(store);
+    return useSyncExternalStore((onStoreChange) => {
+        if (!scopeId)
+            return () => { };
+        return memory.subscribeToScope(scopeId, entity, onStoreChange);
+    }, () => {
+        if (!scopeId)
+            return EMPTY_ARRAY;
+        return memory.getSnapshot(entity, scopeId);
+    });
+}
+export function useEntitySnapshotAsMap(store, scopeId, entity) {
+    const memory = resolveMemory(store);
+    return useSyncExternalStore((onStoreChange) => {
+        if (!scopeId)
+            return () => { };
+        return memory.subscribeToScope(scopeId, entity, onStoreChange);
+    }, () => {
+        if (!scopeId)
+            return EMPTY_MAP;
+        return memory.getSnapshotAsMap(entity, scopeId);
+    });
+}
+//# sourceMappingURL=useEntitySnapshot.js.map

package/dist/react/hooks/useEntitySnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEntitySnapshot.js","sourceRoot":"","sources":["../../../src/react/hooks/useEntitySnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG7C,MAAM,WAAW,GAA8B,EAAE,CAAC;AAClD,MAAM,SAAS,GAA4C,EAAE,CAAC;AAE9D,SAAS,aAAa,CAAC,aAAkC;IACvD,IAAI,QAAQ,IAAI,aAAa;QAAE,OAAQ,aAAuB,CAAC,MAAM,CAAC;IACtE,OAAO,aAA4B,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAA0B,EAC1B,OAAe,EACf,MAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,oBAAoB,CACzB,CAAC,aAAa,EAAE,EAAE;QAChB,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjE,CAAC,EACD,GAAG,EAAE;QACH,IAAI,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC;QACjC,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAA0B,EAC1B,OAAe,EACf,MAAc;IAEd,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,oBAAoB,CACzB,CAAC,aAAa,EAAE,EAAE;QAChB,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACjE,CAAC,EACD,GAAG,EAAE;QACH,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/react/hooks/useRootEntityList.d.ts

@@ -0,0 +1,9 @@
+import type { Store } from '../../types.ts';
+import { type ListItem } from '../../internal-list-apply.ts';
+export declare function useRootEntityList(store: Store): {
+    items: ListItem[];
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useRootEntityList.d.ts.map

package/dist/react/hooks/useRootEntityList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRootEntityList.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useRootEntityList.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG;IAC/C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAwEA"}