@livestore/react 0.4.0-dev.20 → 0.4.0-dev.22

package/dist/experimental/multi-store/StoreRegistry.js

@@ -1,275 +0,0 @@
-import { createStorePromise } from '@livestore/livestore';
-/**
- * Default time to keep unused stores in cache.
- *
- * - Browser: 60 seconds (60,000ms)
- * - SSR: Infinity (disables disposal to avoid disposing stores before server render completes)
- *
- * @internal Exported primarily for testing purposes.
- */
-export const DEFAULT_UNUSED_CACHE_TIME = typeof window === 'undefined' ? Number.POSITIVE_INFINITY : 60_000;
-/**
- * @typeParam TSchema - The schema for this entry's store.
- * @internal
- */
-class StoreEntry {
-    #storeId;
-    #cache;
-    #state = { status: 'idle' };
-    #unusedCacheTime;
-    #disposalTimeout;
-    /**
-     * Set of subscriber callbacks to notify on state changes.
-     */
-    #subscribers = new Set();
-    constructor(storeId, cache) {
-        this.#storeId = storeId;
-        this.#cache = cache;
-    }
-    #scheduleDisposal = () => {
-        this.#cancelDisposal();
-        const effectiveTime = this.#unusedCacheTime === undefined ? DEFAULT_UNUSED_CACHE_TIME : this.#unusedCacheTime;
-        if (effectiveTime === Number.POSITIVE_INFINITY)
-            return; // Infinity disables disposal
-        this.#disposalTimeout = setTimeout(() => {
-            this.#disposalTimeout = null;
-            // Re-check to avoid racing with a new subscription
-            if (this.#subscribers.size > 0)
-                return;
-            // Abort any in-progress loading to release resources early
-            this.#abortLoading();
-            // Transition to shutting_down state BEFORE starting async shutdown.
-            // This prevents new subscribers from receiving a store that's about to be disposed.
-            const shutdownPromise = this.#shutdown().finally(() => {
-                // Reset to idle so fresh loads can proceed, then remove from cache if still inactive
-                this.#setIdle();
-                if (this.#subscribers.size === 0)
-                    this.#cache.delete(this.#storeId);
-            });
-            this.#setShuttingDown(shutdownPromise);
-        }, effectiveTime);
-    };
-    #cancelDisposal = () => {
-        if (!this.#disposalTimeout)
-            return;
-        clearTimeout(this.#disposalTimeout);
-        this.#disposalTimeout = null;
-    };
-    /**
-     * Transitions to the loading state.
-     */
-    #setLoading(promise, abortController) {
-        if (this.#state.status === 'success' || this.#state.status === 'loading')
-            return;
-        this.#state = { status: 'loading', promise, abortController };
-        this.#notify();
-    }
-    /**
-     * Transitions to the success state.
-     */
-    #setStore = (store) => {
-        this.#state = { status: 'success', store };
-        this.#notify();
-    };
-    /**
-     * Transitions to the error state.
-     */
-    #setError = (error) => {
-        this.#state = { status: 'error', error };
-        this.#notify();
-    };
-    /**
-     * Transitions to the shutting_down state.
-     */
-    #setShuttingDown = (shutdownPromise) => {
-        this.#state = { status: 'shutting_down', shutdownPromise };
-        this.#notify();
-    };
-    /**
-     * Transitions to the idle state.
-     */
-    #setIdle = () => {
-        this.#state = { status: 'idle' };
-        // No notify needed - getOrLoad will handle the fresh load
-    };
-    /**
-     * Notifies all subscribers of state changes.
-     *
-     * @remarks
-     * This should be called after any meaningful state change.
-     */
-    #notify = () => {
-        for (const sub of this.#subscribers) {
-            try {
-                sub();
-            }
-            catch {
-                // Swallow to protect other listeners
-            }
-        }
-    };
-    /**
-     * Subscribes to this entry's updates.
-     *
-     * @param listener - Callback invoked when the entry changes
-     * @returns Unsubscribe function
-     */
-    subscribe = (listener) => {
-        this.#cancelDisposal();
-        this.#subscribers.add(listener);
-        return () => {
-            this.#subscribers.delete(listener);
-            // If no more subscribers remain, schedule disposal
-            if (this.#subscribers.size === 0)
-                this.#scheduleDisposal();
-        };
-    };
-    /**
-     * Gets the loaded store or initiates loading if not already in progress.
-     *
-     * @param options - Store creation options
-     * @returns The loaded store if available, or a Promise that resolves to the loaded store
-     *
-     * @remarks
-     * This method handles the complete lifecycle of loading a store:
-     * - Returns the store directly if already loaded (synchronous)
-     * - Returns a Promise if loading is in progress or needs to be initiated
-     * - Transitions through loading → success/error states
-     * - Schedules disposal when loading completes without active subscribers
-     */
-    getOrLoad = (options) => {
-        if (options.unusedCacheTime !== undefined)
-            this.#unusedCacheTime = Math.max(this.#unusedCacheTime ?? 0, options.unusedCacheTime);
-        if (this.#state.status === 'success')
-            return this.#state.store;
-        if (this.#state.status === 'loading')
-            return this.#state.promise;
-        if (this.#state.status === 'error')
-            throw this.#state.error;
-        // Wait for shutdown to complete, then recursively call to load a fresh store
-        if (this.#state.status === 'shutting_down') {
-            return this.#state.shutdownPromise.then(() => this.getOrLoad(options));
-        }
-        const abortController = new AbortController();
-        const promise = createStorePromise({ ...options, signal: abortController.signal })
-            .then((store) => {
-            this.#setStore(store);
-            return store;
-        })
-            .catch((error) => {
-            this.#setError(error);
-            throw error;
-        })
-            .finally(() => {
-            // The store entry may have become unused (no subscribers) while loading the store
-            if (this.#subscribers.size === 0)
-                this.#scheduleDisposal();
-        });
-        this.#setLoading(promise, abortController);
-        return promise;
-    };
-    /**
-     * Aborts an in-progress store load.
-     *
-     * This signals the createStorePromise to cancel, releasing resources like
-     * worker threads, SQLite connections, and network requests.
-     */
-    #abortLoading = () => {
-        if (this.#state.status !== 'loading')
-            return;
-        this.#state.abortController.abort();
-    };
-    #shutdown = async () => {
-        if (this.#state.status !== 'success')
-            return;
-        await this.#state.store.shutdownPromise().catch((reason) => {
-            console.warn(`Store ${this.#storeId} failed to shutdown cleanly during disposal:`, reason);
-        });
-    };
-}
-/**
- * In-memory map of {@link StoreEntry} instances keyed by {@link StoreId}.
- *
- * @privateRemarks
- * The cache is intentionally small; eviction and disposal timers are coordinated by the client.
- *
- * @internal
- */
-class StoreCache {
-    #entries = new Map();
-    get = (storeId) => {
-        return this.#entries.get(storeId);
-    };
-    ensure = (storeId) => {
-        let entry = this.#entries.get(storeId);
-        if (!entry) {
-            entry = new StoreEntry(storeId, this);
-            this.#entries.set(storeId, entry);
-        }
-        return entry;
-    };
-    /**
-     * Removes an entry from the cache.
-     *
-     * @param storeId - The ID of the store to remove
-     */
-    delete = (storeId) => {
-        this.#entries.delete(storeId);
-    };
-}
-/**
- * Store Registry coordinating store loading, caching, and subscription
- *
- * @public
- */
-export class StoreRegistry {
-    #cache = new StoreCache();
-    #defaultOptions;
-    constructor({ defaultOptions = {} } = {}) {
-        this.#defaultOptions = defaultOptions;
-    }
-    #applyDefaultOptions = (options) => ({
-        ...this.#defaultOptions,
-        ...options,
-    });
-    /**
-     * Get or load a store, returning it directly if loaded or a promise if loading.
-     *
-     * @typeParam TSchema - The schema of the store to load
-     * @returns The loaded store if available, or a Promise that resolves to the loaded store
-     * @throws unknown loading error
-     *
-     * @remarks
-     * - Returns the store instance directly (synchronous) when already loaded
-     * - Returns a stable Promise reference when loading is in progress or needs to be initiated
-     * - Applies default options from registry config, with call-site options taking precedence
-     */
-    getOrLoad = (options) => {
-        const optionsWithDefaults = this.#applyDefaultOptions(options);
-        const storeEntry = this.#cache.ensure(optionsWithDefaults.storeId);
-        return storeEntry.getOrLoad(optionsWithDefaults);
-    };
-    /**
-     * Warms the cache for a store without mounting a subscriber.
-     *
-     * @typeParam TSchema - The schema of the store to preload
-     * @returns A promise that resolves when the loading is complete (success or failure)
-     *
-     * @remarks
-     * - We don't return the store or throw as this is a fire-and-forget operation.
-     * - If the entry remains unused after preload resolves/rejects, it is scheduled for disposal.
-     */
-    preload = async (options) => {
-        try {
-            await this.getOrLoad(options);
-        }
-        catch {
-            // Do nothing; preload is best-effort
-        }
-    };
-    subscribe = (storeId, listener) => {
-        const entry = this.#cache.ensure(storeId);
-        return entry.subscribe(listener);
-    };
-}
-//# sourceMappingURL=StoreRegistry.js.map

package/dist/experimental/multi-store/StoreRegistry.js.map

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

package/dist/experimental/multi-store/StoreRegistry.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=StoreRegistry.test.d.ts.map

package/dist/experimental/multi-store/StoreRegistry.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StoreRegistry.test.d.ts","sourceRoot":"","sources":["../../../src/experimental/multi-store/StoreRegistry.test.ts"],"names":[],"mappings":""}