cross-state 0.54.7 → 0.55.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scope-CoDFmhxK.cjs","names":["factory: (...args: Args) => T","cacheTime?: number","simpleHash","name?: string","allResources: ResourceGroup","Store","args: Args","options: CacheOptions<T, Args>","derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n }","createStore","calculatedValue","PromiseWithState","calcDuration","makeSelector","options","baseInstance: CacheBundle<T, Args, TCache> & TCache","defaultCacheOptions: CacheOptions<any, any>","deepEqual","createCache: typeof create & { defaultOptions: CacheOptions<any, any> }","defaultValue: T"],"sources":["../src/lib/instanceCache.ts","../src/core/resourceGroup.ts","../src/core/cache.ts","../src/core/scope.ts"],"sourcesContent":["import { simpleHash } from './hash';\n\nexport class InstanceCache<Args extends any[], T extends object> {\n private cache = new Map<string, { t: number; ref?: T; weakRef: WeakRef<T> }>();\n\n private interval = this.cacheTime\n ? setInterval(() => this.cleanup(), Math.max(this.cacheTime / 10, 1))\n : undefined;\n\n constructor(\n public readonly factory: (...args: Args) => T,\n public readonly cacheTime?: number,\n ) {}\n\n cleanup(): void {\n const cutoff = this.now() - (this.cacheTime ?? 0);\n\n for (const [key, entry] of this.cache.entries()) {\n if (entry.ref && entry.t <= cutoff) {\n delete entry.ref;\n }\n\n if (!entry.ref && !entry.weakRef?.deref()) {\n this.cache.delete(key);\n }\n }\n }\n\n get(...args: Args): T {\n return this.getWithKey(args, args);\n }\n\n getWithKey(args: Args, cacheKey: unknown): T {\n const key = simpleHash(cacheKey);\n let entry = this.cache.get(key);\n let value = entry?.ref ?? entry?.weakRef?.deref();\n\n if (!entry || !value) {\n value = this.factory(...args);\n entry = {\n t: this.now(),\n ref: value,\n weakRef: new WeakRef(value),\n };\n\n this.cache.set(key, entry);\n } else {\n entry.t = this.now();\n entry.ref ??= value;\n }\n\n return value;\n }\n\n values(): T[] {\n return [...this.cache.values()]\n .map((entry) => entry.ref ?? entry.weakRef?.deref())\n .filter((value): value is T => !!value);\n }\n\n stop(): void {\n if (this.interval) {\n clearInterval(this.interval);\n }\n }\n\n stats(): { count: number; withRef: number; withWeakRef: number } {\n return {\n count: this.cache.size,\n withRef: [...this.cache.values()].filter((x) => !!x.ref).length,\n withWeakRef: [...this.cache.values()].filter((x) => !!x.weakRef?.deref()).length,\n };\n }\n\n private now() {\n return performance.now();\n }\n}\n","import { autobind } from '@lib/autobind';\n\nexport interface Resource {\n invalidateAll(): void;\n clearAll(): void;\n}\n\nexport class ResourceGroup {\n private refMap = new WeakMap<Resource, WeakRef<Resource>>();\n\n private refSet = new Set<WeakRef<Resource>>();\n\n constructor(public readonly name?: string) {\n autobind(ResourceGroup);\n }\n\n add(resource: Resource): void {\n const ref = new WeakRef(resource);\n this.refMap.set(resource, ref);\n this.refSet.add(ref);\n }\n\n delete(resource: Resource): void {\n const ref = this.refMap.get(resource);\n if (ref) {\n this.refMap.delete(resource);\n this.refSet.delete(ref);\n }\n }\n\n invalidateAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.invalidateAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n\n clearAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.clearAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n}\n\nexport const allResources: ResourceGroup = /* @__PURE__ */ new ResourceGroup();\n\nexport function createResourceGroup(name?: string): ResourceGroup {\n return new ResourceGroup(name);\n}\n","import { autobind } from '@lib/autobind';\nimport type { CacheState, ErrorState, ValueState } from '@lib/cacheState';\nimport { calcDuration } from '@lib/calcDuration';\nimport { calculatedValue } from '@lib/calculatedValue';\nimport type { Constrain } from '@lib/constrain';\nimport { deepEqual } from '@lib/equals';\nimport { InstanceCache } from '@lib/instanceCache';\nimport { makeSelector } from '@lib/makeSelector';\nimport { type MaybePromise } from '@lib/maybePromise';\nimport type { AnyPath, Path, Value } from '@lib/path';\nimport { PromiseWithState } from '@lib/promiseWithState';\nimport type { Duration, Selector } from './commonTypes';\nimport { allResources, type ResourceGroup } from './resourceGroup';\nimport { Store, createStore, type Calculate, type StoreOptions } from './store';\n\nexport interface CacheGetOptions {\n /**\n * How to handle the cache when getting the value.\n * - `whenMissing`: Only fetch a new value if there is no cached value.\n * - `whenStale`: Fetch a new value if there is no cached value or if the cached value is stale.\n * - `force`: Always fetch a new value, regardless of the cache state.\n */\n update?: 'whenMissing' | 'whenStale' | 'force';\n\n /**\n * If set to `true`, the cache will be updated in the background.\n * This means that a stale value will be returned immediately, if available, while the new value is being fetched.\n */\n backgroundUpdate?: boolean;\n}\n\nexport interface CacheFunction<T, Args extends any[] = []> {\n (...args: Args): Promise<T> | Calculate<Promise<T>>;\n}\n\nexport interface CacheOptions<T, Args extends any[]> extends StoreOptions<Promise<T>> {\n /**\n * How long to keep the cache entry before it is considered stale.\n * If set to `undefined` or `null`, the cache entry will never be invalidated automatically.\n *\n * @example\n * ```typescript\n * createCache(fetchData, {\n * invalidateAfter: { seconds: 10 },\n * });\n * ```\n */\n invalidateAfter?: Duration | ((state: ValueState<T> | ErrorState) => Duration | null) | null;\n\n /**\n * If set, the cache will be invalidated when the window gets focused.\n * This is useful for caches that are used in a browser environment and might become stale when the user switches tabs.\n */\n invalidateOnWindowFocus?: boolean;\n\n /**\n * If set, the cached value will be cleared when the cache is invalidated.\n * Without this option, the cache will keep the last value as stale until a new value becomes available.\n */\n clearOnInvalidate?: boolean;\n\n /**\n * If set, cache entries will be cleared after approximately the specified duration.\n * This is useful for long lived pages or applications and helps to prevent memory leaks.\n * The exact time when the entry is cleared is not guaranteed, since it will be cleared during garbage collection.\n */\n clearUnusedAfter?: Duration | null;\n\n /**\n * Add the cache to the specified resource group(s).\n * This allows you to invalidate or clear multiple caches that belong to the same group.\n * All caches are always added to the `allResources` group.\n */\n resourceGroup?: ResourceGroup | ResourceGroup[];\n\n /**\n * Function to generate a custom cache key based on the provided arguments.\n * This allows you to control how cache entries are identified and reused.\n * By default, the arguments array is used as the cache key.\n *\n * @example\n * ```typescript\n * // Will use the same instance when provided with `undefined`, `{ num: 0 }`, `{ bool: false }`, etc.\n * createCache((filter?: { num?: number, bool?: boolean }) => fetchData(filter), {\n * getCacheKey: (filter?) => ({\n * num: filter?.num ?? 0,\n * bool: filter?.bool ?? false,\n * }),\n * });\n * ```\n */\n getCacheKey?: (...args: NoInfer<Args>) => unknown;\n}\n\nexport class Cache<T, Args extends any[] = []> extends Store<Promise<T>> {\n readonly state: Store<CacheState<T>> = createStore<CacheState<T>>({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n\n protected stalePromise?: Promise<T>;\n\n protected invalidationTimer?: ReturnType<typeof setTimeout>;\n\n constructor(\n getter: Calculate<Promise<T>>,\n public readonly args: Args,\n public readonly options: CacheOptions<T, Args> = {},\n public readonly derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n },\n ) {\n super(getter, options, undefined);\n autobind(Cache);\n\n this.watchPromise();\n this.watchFocus();\n }\n\n get({ update = 'whenStale', backgroundUpdate = false }: CacheGetOptions = {}): Promise<T> {\n this.calculatedValue?.check();\n const promise = this.calculatedValue?.value;\n const stalePromise = this.stalePromise;\n\n if (\n (update === 'whenMissing' && !promise && !stalePromise) ||\n (update === 'whenStale' && !promise) ||\n update === 'force'\n ) {\n this.calculatedValue = calculatedValue(this, this.notify);\n this.notify();\n\n if ((!promise && !stalePromise) || !backgroundUpdate) {\n return this.calculatedValue.value;\n }\n }\n\n if (!promise || (stalePromise && backgroundUpdate)) {\n return stalePromise!;\n }\n\n return promise;\n }\n\n updateValue(value: MaybePromise<T> | ((value: T | undefined) => T)): void {\n if (value instanceof Function) {\n value = value(this.state.get().value);\n }\n this.set(PromiseWithState.resolve(value));\n }\n\n updateError(error: unknown): void {\n this.set(PromiseWithState.reject(error));\n }\n\n invalidate(recursive?: boolean): void {\n const { clearOnInvalidate } = this.options;\n\n if (clearOnInvalidate) {\n return this.clear(recursive);\n }\n\n const { status, isStale, isUpdating } = this.state.get();\n if (status !== 'pending' && !isStale && !isUpdating) {\n this.stalePromise = this.calculatedValue?.value;\n }\n\n this.state.set((state) => ({\n ...state,\n isStale: true,\n isUpdating: false,\n }));\n\n super.invalidate(recursive);\n }\n\n clear(recursive?: boolean): void {\n this.state.set({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n delete this.stalePromise;\n\n super.invalidate(recursive);\n }\n\n mapValue<S>(selector: Selector<T, S>): Cache<S, Args>;\n\n mapValue<const P extends AnyPath>(\n selector: P extends Path<T> ? P : Path<T>,\n ): Cache<Value<T, P>, Args>;\n\n mapValue(selector: Selector<any, any> | AnyPath) {\n return mapValue(this, selector);\n }\n\n protected watchPromise(): void {\n this.subscribe(\n async (promise) => {\n if (promise instanceof PromiseWithState && promise.state.status !== 'pending') {\n promise.catch(() => undefined);\n\n this.state.set((state) => ({\n ...promise.state,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n\n delete this.stalePromise;\n this.setTimers();\n return;\n }\n\n this.state.set((state) => ({\n ...state,\n isUpdating: true,\n }));\n\n this.setTimers();\n\n try {\n const value = await promise;\n\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'value',\n value,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n } catch (error) {\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'error',\n error,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n }\n },\n { passive: true },\n );\n }\n\n protected setTimers(): void {\n if (this.invalidationTimer) {\n clearTimeout(this.invalidationTimer);\n }\n this.invalidationTimer = undefined;\n\n const state = this.state.get();\n let { invalidateAfter } = this.options;\n const ref = new WeakRef(this);\n\n if (state.status === 'pending') {\n return;\n }\n\n if (invalidateAfter instanceof Function) {\n invalidateAfter = invalidateAfter(state);\n }\n\n if (invalidateAfter !== null && invalidateAfter !== undefined) {\n this.invalidationTimer = setTimeout(\n () => ref?.deref()?.invalidate(),\n calcDuration(invalidateAfter),\n );\n }\n }\n\n protected watchFocus(): void {\n const { invalidateOnWindowFocus } = this.options;\n\n if (\n !invalidateOnWindowFocus ||\n typeof document === 'undefined' ||\n typeof document.addEventListener === 'undefined'\n ) {\n return;\n }\n\n const ref = new WeakRef(this);\n\n const onFocus = () => {\n const that = ref?.deref();\n if (!that) {\n document.removeEventListener('visibilitychange', onFocus);\n return;\n }\n\n if (!document.hidden && !that.state.get().isConnected) {\n that.invalidate();\n }\n };\n\n document.addEventListener('visibilitychange', onFocus);\n }\n}\n\nfunction mapValue<T, S, Args extends any[]>(\n cache: Cache<T, Args>,\n _selector: Selector<T, S> | AnyPath,\n): Cache<S, Args> {\n const selector = makeSelector(_selector);\n const derivedFromCache = {\n cache: cache.derivedFromCache ? cache.derivedFromCache.cache : cache,\n selectors: cache.derivedFromCache\n ? [...cache.derivedFromCache.selectors, _selector]\n : [_selector],\n };\n\n return new Cache<S, Args>(\n async ({ use }) => {\n const value = await use(cache);\n return selector(value);\n },\n cache.args,\n {\n equals: cache.options.equals,\n },\n derivedFromCache,\n );\n}\n\nexport type CreateCacheResult<\n T,\n Args extends any[],\n TCache extends Cache<T, Args>,\n> = [] extends Args ? CacheBundle<T, Args, TCache> & TCache : CacheBundle<T, Args, TCache>;\n\nexport interface InvalidationOptions<T, Args extends any[], TCache extends Cache<T, Args>> {\n filter?: (cache: TCache) => boolean;\n}\n\nexport type CacheBundle<T, Args extends any[], TCache extends Cache<T, Args>> = {\n (...args: Args): TCache;\n mapCache<S>(selector: Selector<T, S>): CreateCacheResult<S, Args, Cache<S, Args>>;\n mapValue<const P>(\n selector: Constrain<P, Path<T>>,\n ): CreateCacheResult<Value<T, P>, Args, Cache<Value<T, P>, Args>>;\n invalidateAll: (options?: InvalidationOptions<T, Args, TCache>) => void;\n clearAll: (options?: InvalidationOptions<T, Args, TCache>) => void;\n getInstances: () => TCache[];\n};\n\nfunction create<T, Args extends any[] = []>(\n cacheFunction: CacheFunction<T, Args>,\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args, Cache<T, Args>> {\n return internalCreate<T, Args, Cache<T, Args>>(\n (args, options) =>\n new Cache(\n (helpers) => {\n const result = cacheFunction.apply(helpers, args);\n\n if (result instanceof Function) {\n return result(helpers);\n }\n\n return result;\n },\n args,\n options,\n undefined,\n ),\n options,\n );\n}\n\nexport function internalCreate<T, Args extends any[], TCache extends Cache<T, Args>>(\n factory: (args: Args, options: CacheOptions<T, Args>) => TCache,\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args, TCache> {\n options = { ...createCache.defaultOptions, ...options };\n const { clearUnusedAfter, resourceGroup } = options ?? {};\n\n let baseInstance: CacheBundle<T, Args, TCache> & TCache;\n\n const instanceCache = new InstanceCache<Args, TCache>(\n (...args) => factory(args, options),\n clearUnusedAfter ? calcDuration(clearUnusedAfter) : undefined,\n );\n\n function get(...args: Args) {\n const sliceAfter = args.lastIndexOf(undefined);\n if (sliceAfter !== -1) {\n args = args.slice(0, sliceAfter) as Args;\n }\n\n const cacheKey = options?.getCacheKey ? options.getCacheKey(...args) : args;\n return instanceCache.getWithKey(args, cacheKey);\n }\n\n const mapCache = (selector: any) => {\n return internalCreate<any, Args, Cache<any, Args>>((args: Args) =>\n mapValue(baseInstance(...args), selector),\n );\n };\n\n const invalidateAll = ({ filter = () => true }: InvalidationOptions<T, Args, TCache> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.invalidate();\n }\n }\n };\n\n const clearAll = ({ filter = () => true }: InvalidationOptions<T, Args, TCache> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.clear();\n }\n }\n };\n\n const getInstances = () => {\n return instanceCache.values();\n };\n\n baseInstance = new Proxy(\n Object.assign(() => undefined, {\n mapCache,\n invalidateAll,\n clearAll,\n getInstances,\n }),\n {\n apply(_target, _thisArg, argArray) {\n return get(...(argArray as unknown as Args));\n },\n get(target, p, receiver) {\n if (Reflect.has(target, p)) {\n return Reflect.get(target, p, receiver);\n }\n\n const baseCache = get(...([] as unknown as Args));\n return Reflect.get(baseCache, p, baseCache);\n },\n },\n ) as unknown as CacheBundle<T, Args, TCache> & TCache;\n\n const groups = Array.isArray(resourceGroup)\n ? resourceGroup\n : resourceGroup\n ? [resourceGroup]\n : [];\n\n for (const group of groups.concat(allResources)) {\n group.add(baseInstance);\n }\n\n return baseInstance;\n}\n\nexport const defaultCacheOptions: CacheOptions<any, any> = {\n invalidateOnWindowFocus: true,\n clearUnusedAfter: { days: 1 },\n retain: { milliseconds: 1 },\n equals: deepEqual,\n};\n\nexport const createCache: typeof create & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(create, {\n defaultOptions: defaultCacheOptions,\n });\n","import { autobind } from '@lib/autobind';\n\nexport class Scope<T> {\n constructor(public readonly defaultValue: T) {\n autobind(Scope);\n }\n}\n\nexport function createScope<T>(defaultValue: T): Scope<T> {\n return new Scope(defaultValue);\n}\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { Cache, CacheState, Scope } from "./scope-DZVNkeCy.cjs";
1
+ import { Cache, CacheState, Scope } from "./scope-6B7-8lwa.cjs";
2
2
  import { Constrain, Path, Selector, Store, SubscribeOptions, Update, Value } from "./store-BEsiS8y7.cjs";
3
3
  import { Context, ReactNode } from "react";
4
4
 
@@ -104,4 +104,4 @@ declare const storeMethods: {
104
104
  };
105
105
  //#endregion
106
106
  export { ScopeProps, ScopeProvider, UseCacheArray, UseCacheValue, UseStoreOptions, cacheMethods, scopeMethods, storeMethods, useCache, useScope, useStore };
107
- //# sourceMappingURL=storeMethods-HhjDEc7D.d.cts.map
107
+ //# sourceMappingURL=storeMethods-Bg8nMBrf.d.cts.map
@@ -1,4 +1,4 @@
1
- import { Cache, CacheState, Scope } from "./scope-DkCUDAD1.js";
1
+ import { Cache, CacheState, Scope } from "./scope-BbUXgNW_.js";
2
2
  import { Constrain, Path, Selector, Store, SubscribeOptions, Update, Value } from "./store-DKaeE840.js";
3
3
  import { Context, ReactNode } from "react";
4
4
 
@@ -104,4 +104,4 @@ declare const storeMethods: {
104
104
  };
105
105
  //#endregion
106
106
  export { ScopeProps, ScopeProvider, UseCacheArray, UseCacheValue, UseStoreOptions, cacheMethods, scopeMethods, storeMethods, useCache, useScope, useStore };
107
- //# sourceMappingURL=storeMethods-CABq4ehi.d.ts.map
107
+ //# sourceMappingURL=storeMethods-DWKSveN0.d.ts.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cross-state",
3
- "version": "0.54.7",
3
+ "version": "0.55.0",
4
4
  "description": "(React) state library",
5
5
  "license": "ISC",
6
6
  "repository": "schummar/cross-state",
@@ -1 +0,0 @@
1
- {"version":3,"file":"scope-6P87zGw6.js","names":["factory: (...args: Args) => T","cacheTime?: number","name?: string","allResources: ResourceGroup","args: Args","options: CacheOptions<T, Args>","derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n }","baseInstance: CacheBundle<T, Args> & Cache<T, Args>","createCache: typeof create & { defaultOptions: CacheOptions<any, any> }","defaultValue: T"],"sources":["../src/lib/instanceCache.ts","../src/core/resourceGroup.ts","../src/core/cache.ts","../src/core/scope.ts"],"sourcesContent":["import { simpleHash } from './hash';\n\nexport class InstanceCache<Args extends any[], T extends object> {\n private cache = new Map<string, { t: number; ref?: T; weakRef: WeakRef<T> }>();\n\n private interval = this.cacheTime\n ? setInterval(() => this.cleanup(), Math.max(this.cacheTime / 10, 1))\n : undefined;\n\n constructor(\n public readonly factory: (...args: Args) => T,\n public readonly cacheTime?: number,\n ) {}\n\n cleanup(): void {\n const cutoff = this.now() - (this.cacheTime ?? 0);\n\n for (const [key, entry] of this.cache.entries()) {\n if (entry.ref && entry.t <= cutoff) {\n delete entry.ref;\n }\n\n if (!entry.ref && !entry.weakRef?.deref()) {\n this.cache.delete(key);\n }\n }\n }\n\n get(...args: Args): T {\n return this.getWithKey(args, args);\n }\n\n getWithKey(args: Args, cacheKey: unknown): T {\n const key = simpleHash(cacheKey);\n let entry = this.cache.get(key);\n let value = entry?.ref ?? entry?.weakRef?.deref();\n\n if (!entry || !value) {\n value = this.factory(...args);\n entry = {\n t: this.now(),\n ref: value,\n weakRef: new WeakRef(value),\n };\n\n this.cache.set(key, entry);\n } else {\n entry.t = this.now();\n entry.ref ??= value;\n }\n\n return value;\n }\n\n values(): T[] {\n return [...this.cache.values()]\n .map((entry) => entry.ref ?? entry.weakRef?.deref())\n .filter((value): value is T => !!value);\n }\n\n stop(): void {\n if (this.interval) {\n clearInterval(this.interval);\n }\n }\n\n stats(): { count: number; withRef: number; withWeakRef: number } {\n return {\n count: this.cache.size,\n withRef: [...this.cache.values()].filter((x) => !!x.ref).length,\n withWeakRef: [...this.cache.values()].filter((x) => !!x.weakRef?.deref()).length,\n };\n }\n\n private now() {\n return performance.now();\n }\n}\n","import { autobind } from '@lib/autobind';\n\nexport interface Resource {\n invalidateAll(): void;\n clearAll(): void;\n}\n\nexport class ResourceGroup {\n private refMap = new WeakMap<Resource, WeakRef<Resource>>();\n\n private refSet = new Set<WeakRef<Resource>>();\n\n constructor(public readonly name?: string) {\n autobind(ResourceGroup);\n }\n\n add(resource: Resource): void {\n const ref = new WeakRef(resource);\n this.refMap.set(resource, ref);\n this.refSet.add(ref);\n }\n\n delete(resource: Resource): void {\n const ref = this.refMap.get(resource);\n if (ref) {\n this.refMap.delete(resource);\n this.refSet.delete(ref);\n }\n }\n\n invalidateAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.invalidateAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n\n clearAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.clearAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n}\n\nexport const allResources: ResourceGroup = /* @__PURE__ */ new ResourceGroup();\n\nexport function createResourceGroup(name?: string): ResourceGroup {\n return new ResourceGroup(name);\n}\n","import { autobind } from '@lib/autobind';\nimport type { CacheState, ErrorState, ValueState } from '@lib/cacheState';\nimport { calcDuration } from '@lib/calcDuration';\nimport { calculatedValue } from '@lib/calculatedValue';\nimport type { Constrain } from '@lib/constrain';\nimport { deepEqual } from '@lib/equals';\nimport { InstanceCache } from '@lib/instanceCache';\nimport { makeSelector } from '@lib/makeSelector';\nimport { type MaybePromise } from '@lib/maybePromise';\nimport type { AnyPath, Path, Value } from '@lib/path';\nimport { PromiseWithState } from '@lib/promiseWithState';\nimport type { Duration, Selector } from './commonTypes';\nimport { allResources, type ResourceGroup } from './resourceGroup';\nimport { Store, createStore, type Calculate, type StoreOptions } from './store';\n\nexport interface CacheGetOptions {\n /**\n * How to handle the cache when getting the value.\n * - `whenMissing`: Only fetch a new value if there is no cached value.\n * - `whenStale`: Fetch a new value if there is no cached value or if the cached value is stale.\n * - `force`: Always fetch a new value, regardless of the cache state.\n */\n update?: 'whenMissing' | 'whenStale' | 'force';\n\n /**\n * If set to `true`, the cache will be updated in the background.\n * This means that a stale value will be returned immediately, if available, while the new value is being fetched.\n */\n backgroundUpdate?: boolean;\n}\n\nexport interface CacheFunction<T, Args extends any[] = []> {\n (...args: Args): Promise<T> | Calculate<Promise<T>>;\n}\n\nexport interface CacheOptions<T, Args extends any[]> extends StoreOptions<Promise<T>> {\n /**\n * How long to keep the cache entry before it is considered stale.\n * If set to `undefined` or `null`, the cache entry will never be invalidated automatically.\n *\n * @example\n * ```typescript\n * createCache(fetchData, {\n * invalidateAfter: { seconds: 10 },\n * });\n * ```\n */\n invalidateAfter?: Duration | ((state: ValueState<T> | ErrorState) => Duration | null) | null;\n\n /**\n * If set, the cache will be invalidated when the window gets focused.\n * This is useful for caches that are used in a browser environment and might become stale when the user switches tabs.\n */\n invalidateOnWindowFocus?: boolean;\n\n /**\n * If set, the cached value will be cleared when the cache is invalidated.\n * Without this option, the cache will keep the last value as stale until a new value becomes available.\n */\n clearOnInvalidate?: boolean;\n\n /**\n * If set, cache entries will be cleared after approximately the specified duration.\n * This is useful for long lived pages or applications and helps to prevent memory leaks.\n * The exact time when the entry is cleared is not guaranteed, since it will be cleared during garbage collection.\n */\n clearUnusedAfter?: Duration | null;\n\n /**\n * Add the cache to the specified resource group(s).\n * This allows you to invalidate or clear multiple caches that belong to the same group.\n * All caches are always added to the `allResources` group.\n */\n resourceGroup?: ResourceGroup | ResourceGroup[];\n\n /**\n * Function to generate a custom cache key based on the provided arguments.\n * This allows you to control how cache entries are identified and reused.\n * By default, the arguments array is used as the cache key.\n *\n * @example\n * ```typescript\n * // Will use the same instance when provided with `undefined`, `{ num: 0 }`, `{ bool: false }`, etc.\n * createCache((filter?: { num?: number, bool?: boolean }) => fetchData(filter), {\n * getCacheKey: (filter?) => ({\n * num: filter?.num ?? 0,\n * bool: filter?.bool ?? false,\n * }),\n * });\n * ```\n */\n getCacheKey?: (...args: NoInfer<Args>) => unknown;\n}\n\nexport class Cache<T, Args extends any[] = []> extends Store<Promise<T>> {\n readonly state: Store<CacheState<T>> = createStore<CacheState<T>>({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n\n protected stalePromise?: Promise<T>;\n\n protected invalidationTimer?: ReturnType<typeof setTimeout>;\n\n constructor(\n getter: Calculate<Promise<T>>,\n public readonly args: Args,\n public readonly options: CacheOptions<T, Args> = {},\n public readonly derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n },\n ) {\n super(getter, options, undefined);\n autobind(Cache);\n\n this.watchPromise();\n this.watchFocus();\n }\n\n get({ update = 'whenStale', backgroundUpdate = false }: CacheGetOptions = {}): Promise<T> {\n this.calculatedValue?.check();\n const promise = this.calculatedValue?.value;\n const stalePromise = this.stalePromise;\n\n if (\n (update === 'whenMissing' && !promise && !stalePromise) ||\n (update === 'whenStale' && !promise) ||\n update === 'force'\n ) {\n this.calculatedValue = calculatedValue(this, this.notify);\n this.notify();\n\n if ((!promise && !stalePromise) || !backgroundUpdate) {\n return this.calculatedValue.value;\n }\n }\n\n if (!promise || (stalePromise && backgroundUpdate)) {\n return stalePromise!;\n }\n\n return promise;\n }\n\n updateValue(value: MaybePromise<T> | ((value: T | undefined) => T)): void {\n if (value instanceof Function) {\n value = value(this.state.get().value);\n }\n this.set(PromiseWithState.resolve(value));\n }\n\n updateError(error: unknown): void {\n this.set(PromiseWithState.reject(error));\n }\n\n invalidate(recursive?: boolean): void {\n const { clearOnInvalidate } = this.options;\n\n if (clearOnInvalidate) {\n return this.clear(recursive);\n }\n\n const { status, isStale, isUpdating } = this.state.get();\n if (status !== 'pending' && !isStale && !isUpdating) {\n this.stalePromise = this.calculatedValue?.value;\n }\n\n this.state.set((state) => ({\n ...state,\n isStale: true,\n isUpdating: false,\n }));\n\n super.invalidate(recursive);\n }\n\n clear(recursive?: boolean): void {\n this.state.set({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n delete this.stalePromise;\n\n super.invalidate(recursive);\n }\n\n mapValue<S>(selector: Selector<T, S>): Cache<S, Args>;\n\n mapValue<const P extends AnyPath>(\n selector: P extends Path<T> ? P : Path<T>,\n ): Cache<Value<T, P>, Args>;\n\n mapValue(selector: Selector<any, any> | AnyPath) {\n return mapValue(this, selector);\n }\n\n protected watchPromise(): void {\n this.subscribe(\n async (promise) => {\n if (promise instanceof PromiseWithState && promise.state.status !== 'pending') {\n promise.catch(() => undefined);\n\n this.state.set((state) => ({\n ...promise.state,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n\n delete this.stalePromise;\n this.setTimers();\n return;\n }\n\n this.state.set((state) => ({\n ...state,\n isUpdating: true,\n }));\n\n this.setTimers();\n\n try {\n const value = await promise;\n\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'value',\n value,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n } catch (error) {\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'error',\n error,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n }\n },\n { passive: true },\n );\n }\n\n protected setTimers(): void {\n if (this.invalidationTimer) {\n clearTimeout(this.invalidationTimer);\n }\n this.invalidationTimer = undefined;\n\n const state = this.state.get();\n let { invalidateAfter } = this.options;\n const ref = new WeakRef(this);\n\n if (state.status === 'pending') {\n return;\n }\n\n if (invalidateAfter instanceof Function) {\n invalidateAfter = invalidateAfter(state);\n }\n\n if (invalidateAfter !== null && invalidateAfter !== undefined) {\n this.invalidationTimer = setTimeout(\n () => ref?.deref()?.invalidate(),\n calcDuration(invalidateAfter),\n );\n }\n }\n\n protected watchFocus(): void {\n const { invalidateOnWindowFocus } = this.options;\n\n if (\n !invalidateOnWindowFocus ||\n typeof document === 'undefined' ||\n typeof document.addEventListener === 'undefined'\n ) {\n return;\n }\n\n const ref = new WeakRef(this);\n\n const onFocus = () => {\n const that = ref?.deref();\n if (!that) {\n document.removeEventListener('visibilitychange', onFocus);\n return;\n }\n\n if (!document.hidden && !that.state.get().isConnected) {\n that.invalidate();\n }\n };\n\n document.addEventListener('visibilitychange', onFocus);\n }\n}\n\nfunction mapValue<T, S, Args extends any[]>(\n cache: Cache<T, Args>,\n _selector: Selector<T, S> | AnyPath,\n): Cache<S, Args> {\n const selector = makeSelector(_selector);\n const derivedFromCache = {\n cache: cache.derivedFromCache ? cache.derivedFromCache.cache : cache,\n selectors: cache.derivedFromCache\n ? [...cache.derivedFromCache.selectors, _selector]\n : [_selector],\n };\n\n return new Cache<S, Args>(\n async ({ use }) => {\n const value = await use(cache);\n return selector(value);\n },\n cache.args,\n {\n equals: cache.options.equals,\n },\n derivedFromCache,\n );\n}\n\nexport type CreateCacheResult<T, Args extends any[]> = [] extends Args\n ? CacheBundle<T, Args> & Cache<T, Args>\n : CacheBundle<T, Args>;\n\nexport interface InvalidationOptions<T, Args extends any[]> {\n filter?: (cache: Cache<T, Args>) => boolean;\n}\n\nexport type CacheBundle<T, Args extends any[]> = {\n (...args: Args): Cache<T, Args>;\n mapCache<S>(selector: Selector<T, S>): CreateCacheResult<S, Args>;\n mapValue<const P>(selector: Constrain<P, Path<T>>): CreateCacheResult<Value<T, P>, Args>;\n invalidateAll: (options?: InvalidationOptions<T, Args>) => void;\n clearAll: (options?: InvalidationOptions<T, Args>) => void;\n getInstances: () => Cache<T, Args>[];\n};\n\nfunction create<T, Args extends any[] = []>(\n cacheFunction: CacheFunction<T, Args>,\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args> {\n return internalCreate<T, Args>(cacheFunction, options);\n}\n\nfunction internalCreate<T, Args extends any[] = []>(\n source:\n | CacheFunction<T, Args>\n | [cache: CacheBundle<any, Args>, selector: Selector<any, T> | AnyPath],\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args> {\n options = { ...createCache.defaultOptions, ...options };\n const { clearUnusedAfter, resourceGroup } = options ?? {};\n\n let baseInstance: CacheBundle<T, Args> & Cache<T, Args>;\n\n const instanceCache = new InstanceCache<Args, Cache<T, Args>>(\n (...args: Args): Cache<T, Args> => {\n if (Array.isArray(source)) {\n const [cache, selector] = source;\n return mapValue(cache(...args), selector);\n }\n\n return new Cache(\n (helpers) => {\n const result = source.apply(helpers, args);\n\n if (result instanceof Function) {\n return result(helpers);\n }\n\n return result;\n },\n args,\n options,\n undefined,\n );\n },\n clearUnusedAfter ? calcDuration(clearUnusedAfter) : undefined,\n );\n\n function get(...args: Args) {\n const sliceAfter = args.lastIndexOf(undefined);\n if (sliceAfter !== -1) {\n args = args.slice(0, sliceAfter) as Args;\n }\n\n const cacheKey = options?.getCacheKey ? options.getCacheKey(...args) : args;\n return instanceCache.getWithKey(args, cacheKey);\n }\n\n const mapCache = (selector: any) => {\n return internalCreate([baseInstance, selector]);\n };\n\n const invalidateAll = ({ filter = () => true }: InvalidationOptions<T, Args> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.invalidate();\n }\n }\n };\n\n const clearAll = ({ filter = () => true }: InvalidationOptions<T, Args> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.clear();\n }\n }\n };\n\n const getInstances = () => {\n return instanceCache.values();\n };\n\n baseInstance = new Proxy(\n Object.assign(() => undefined, {\n mapCache,\n invalidateAll,\n clearAll,\n getInstances,\n }),\n {\n apply(_target, _thisArg, argArray) {\n return get(...(argArray as unknown as Args));\n },\n get(target, p, receiver) {\n if (Reflect.has(target, p)) {\n return Reflect.get(target, p, receiver);\n }\n\n const baseCache = get(...([] as unknown as Args));\n return Reflect.get(baseCache, p, baseCache);\n },\n },\n ) as unknown as CacheBundle<T, Args> & Cache<T, Args>;\n\n const groups = Array.isArray(resourceGroup)\n ? resourceGroup\n : resourceGroup\n ? [resourceGroup]\n : [];\n\n for (const group of groups.concat(allResources)) {\n group.add(baseInstance);\n }\n\n return baseInstance;\n}\n\nexport const createCache: typeof create & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(create, {\n defaultOptions: {\n invalidateOnWindowFocus: true,\n clearUnusedAfter: { days: 1 },\n retain: { milliseconds: 1 },\n equals: deepEqual,\n } as CacheOptions<any, any>,\n });\n","import { autobind } from '@lib/autobind';\n\nexport class Scope<T> {\n constructor(public readonly defaultValue: T) {\n autobind(Scope);\n }\n}\n\nexport function createScope<T>(defaultValue: T): Scope<T> {\n return new Scope(defaultValue);\n}\n"],"mappings":";;;;;AAEA,IAAa,gBAAb,MAAiE;CAO/D,YACE,AAAgBA,SAChB,AAAgBC,WAChB;EAFgB;EACA;+BARF,IAAI;kBAED,KAAK,YACpB,kBAAkB,KAAK,WAAW,KAAK,IAAI,KAAK,YAAY,IAAI,MAChE;;CAOJ,UAAgB;EACd,MAAM,SAAS,KAAK,SAAS,KAAK,aAAa;AAE/C,OAAK,MAAM,CAAC,KAAK,UAAU,KAAK,MAAM,WAAW;AAC/C,OAAI,MAAM,OAAO,MAAM,KAAK,OAC1B,QAAO,MAAM;AAGf,OAAI,CAAC,MAAM,OAAO,CAAC,MAAM,SAAS,QAChC,MAAK,MAAM,OAAO;;;CAKxB,IAAI,GAAG,MAAe;AACpB,SAAO,KAAK,WAAW,MAAM;;CAG/B,WAAW,MAAY,UAAsB;EAC3C,MAAM,MAAM,WAAW;EACvB,IAAI,QAAQ,KAAK,MAAM,IAAI;EAC3B,IAAI,QAAQ,OAAO,OAAO,OAAO,SAAS;AAE1C,MAAI,CAAC,SAAS,CAAC,OAAO;AACpB,WAAQ,KAAK,QAAQ,GAAG;AACxB,WAAQ;IACN,GAAG,KAAK;IACR,KAAK;IACL,SAAS,IAAI,QAAQ;;AAGvB,QAAK,MAAM,IAAI,KAAK;SACf;AACL,SAAM,IAAI,KAAK;AACf,SAAM,QAAQ;;AAGhB,SAAO;;CAGT,SAAc;AACZ,SAAO,CAAC,GAAG,KAAK,MAAM,UACnB,KAAK,UAAU,MAAM,OAAO,MAAM,SAAS,SAC3C,QAAQ,UAAsB,CAAC,CAAC;;CAGrC,OAAa;AACX,MAAI,KAAK,SACP,eAAc,KAAK;;CAIvB,QAAiE;AAC/D,SAAO;GACL,OAAO,KAAK,MAAM;GAClB,SAAS,CAAC,GAAG,KAAK,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC,EAAE,KAAK;GACzD,aAAa,CAAC,GAAG,KAAK,MAAM,UAAU,QAAQ,MAAM,CAAC,CAAC,EAAE,SAAS,SAAS;;;CAI9E,AAAQ,MAAM;AACZ,SAAO,YAAY;;;;;;ACpEvB,IAAa,gBAAb,MAAa,cAAc;CAKzB,YAAY,AAAgBC,MAAe;EAAf;gCAJX,IAAI;gCAEJ,IAAI;AAGnB,WAAS;;CAGX,IAAI,UAA0B;EAC5B,MAAM,MAAM,IAAI,QAAQ;AACxB,OAAK,OAAO,IAAI,UAAU;AAC1B,OAAK,OAAO,IAAI;;CAGlB,OAAO,UAA0B;EAC/B,MAAM,MAAM,KAAK,OAAO,IAAI;AAC5B,MAAI,KAAK;AACP,QAAK,OAAO,OAAO;AACnB,QAAK,OAAO,OAAO;;;CAIvB,gBAAsB;AACpB,OAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,WAAW,IAAI;AACrB,OAAI,SACF,UAAS;OAET,MAAK,OAAO,OAAO;;;CAKzB,WAAiB;AACf,OAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,WAAW,IAAI;AACrB,OAAI,SACF,UAAS;OAET,MAAK,OAAO,OAAO;;;;AAM3B,MAAaC,+BAA8C,IAAI;AAE/D,SAAgB,oBAAoB,MAA8B;AAChE,QAAO,IAAI,cAAc;;;;;ACsC3B,IAAa,QAAb,MAAa,cAA0C,MAAkB;CAYvE,YACE,QACA,AAAgBC,MAChB,AAAgBC,UAAiC,IACjD,AAAgBC,kBAIhB;AACA,QAAM,QAAQ,SAAS;EAPP;EACA;EACA;eAfqB,YAA2B;GAChE,QAAQ;GACR,SAAS;GACT,YAAY;GACZ,aAAa;;AAiBb,WAAS;AAET,OAAK;AACL,OAAK;;CAGP,IAAI,EAAE,SAAS,aAAa,mBAAmB,UAA2B,IAAgB;AACxF,OAAK,iBAAiB;EACtB,MAAM,UAAU,KAAK,iBAAiB;EACtC,MAAM,eAAe,KAAK;AAE1B,MACG,WAAW,iBAAiB,CAAC,WAAW,CAAC,gBACzC,WAAW,eAAe,CAAC,WAC5B,WAAW,SACX;AACA,QAAK,kBAAkB,gBAAgB,MAAM,KAAK;AAClD,QAAK;AAEL,OAAK,CAAC,WAAW,CAAC,gBAAiB,CAAC,iBAClC,QAAO,KAAK,gBAAgB;;AAIhC,MAAI,CAAC,WAAY,gBAAgB,iBAC/B,QAAO;AAGT,SAAO;;CAGT,YAAY,OAA8D;AACxE,MAAI,iBAAiB,SACnB,SAAQ,MAAM,KAAK,MAAM,MAAM;AAEjC,OAAK,IAAI,iBAAiB,QAAQ;;CAGpC,YAAY,OAAsB;AAChC,OAAK,IAAI,iBAAiB,OAAO;;CAGnC,WAAW,WAA2B;EACpC,MAAM,EAAE,sBAAsB,KAAK;AAEnC,MAAI,kBACF,QAAO,KAAK,MAAM;EAGpB,MAAM,EAAE,QAAQ,SAAS,eAAe,KAAK,MAAM;AACnD,MAAI,WAAW,aAAa,CAAC,WAAW,CAAC,WACvC,MAAK,eAAe,KAAK,iBAAiB;AAG5C,OAAK,MAAM,KAAK,WAAW;GACzB,GAAG;GACH,SAAS;GACT,YAAY;;AAGd,QAAM,WAAW;;CAGnB,MAAM,WAA2B;AAC/B,OAAK,MAAM,IAAI;GACb,QAAQ;GACR,SAAS;GACT,YAAY;GACZ,aAAa;;AAEf,SAAO,KAAK;AAEZ,QAAM,WAAW;;CASnB,SAAS,UAAwC;AAC/C,SAAO,SAAS,MAAM;;CAGxB,AAAU,eAAqB;AAC7B,OAAK,UACH,OAAO,YAAY;AACjB,OAAI,mBAAmB,oBAAoB,QAAQ,MAAM,WAAW,WAAW;AAC7E,YAAQ,YAAY;AAEpB,SAAK,MAAM,KAAK,WAAW;KACzB,GAAG,QAAQ;KACX,SAAS;KACT,YAAY;KACZ,aAAa,MAAM;;AAGrB,WAAO,KAAK;AACZ,SAAK;AACL;;AAGF,QAAK,MAAM,KAAK,WAAW;IACzB,GAAG;IACH,YAAY;;AAGd,QAAK;AAEL,OAAI;IACF,MAAM,QAAQ,MAAM;AAEpB,QAAI,YAAY,KAAK,iBAAiB,MACpC;AAGF,SAAK,MAAM,KAAK,WAAW;KACzB,QAAQ;KACR;KACA,SAAS;KACT,YAAY;KACZ,aAAa,MAAM;;AAErB,WAAO,KAAK;AACZ,SAAK;YACE,OAAO;AACd,QAAI,YAAY,KAAK,iBAAiB,MACpC;AAGF,SAAK,MAAM,KAAK,WAAW;KACzB,QAAQ;KACR;KACA,SAAS;KACT,YAAY;KACZ,aAAa,MAAM;;AAErB,WAAO,KAAK;AACZ,SAAK;;KAGT,EAAE,SAAS;;CAIf,AAAU,YAAkB;AAC1B,MAAI,KAAK,kBACP,cAAa,KAAK;AAEpB,OAAK,oBAAoB;EAEzB,MAAM,QAAQ,KAAK,MAAM;EACzB,IAAI,EAAE,oBAAoB,KAAK;EAC/B,MAAM,MAAM,IAAI,QAAQ;AAExB,MAAI,MAAM,WAAW,UACnB;AAGF,MAAI,2BAA2B,SAC7B,mBAAkB,gBAAgB;AAGpC,MAAI,oBAAoB,QAAQ,oBAAoB,OAClD,MAAK,oBAAoB,iBACjB,KAAK,SAAS,cACpB,aAAa;;CAKnB,AAAU,aAAmB;EAC3B,MAAM,EAAE,4BAA4B,KAAK;AAEzC,MACE,CAAC,2BACD,OAAO,aAAa,eACpB,OAAO,SAAS,qBAAqB,YAErC;EAGF,MAAM,MAAM,IAAI,QAAQ;EAExB,MAAM,gBAAgB;GACpB,MAAM,OAAO,KAAK;AAClB,OAAI,CAAC,MAAM;AACT,aAAS,oBAAoB,oBAAoB;AACjD;;AAGF,OAAI,CAAC,SAAS,UAAU,CAAC,KAAK,MAAM,MAAM,YACxC,MAAK;;AAIT,WAAS,iBAAiB,oBAAoB;;;AAIlD,SAAS,SACP,OACA,WACgB;CAChB,MAAM,WAAW,aAAa;CAC9B,MAAM,mBAAmB;EACvB,OAAO,MAAM,mBAAmB,MAAM,iBAAiB,QAAQ;EAC/D,WAAW,MAAM,mBACb,CAAC,GAAG,MAAM,iBAAiB,WAAW,aACtC,CAAC;;AAGP,QAAO,IAAI,MACT,OAAO,EAAE,UAAU;EACjB,MAAM,QAAQ,MAAM,IAAI;AACxB,SAAO,SAAS;IAElB,MAAM,MACN,EACE,QAAQ,MAAM,QAAQ,UAExB;;AAqBJ,SAAS,OACP,eACA,SAC4B;AAC5B,QAAO,eAAwB,eAAe;;AAGhD,SAAS,eACP,QAGA,SAC4B;AAC5B,WAAU;EAAE,GAAG,YAAY;EAAgB,GAAG;;CAC9C,MAAM,EAAE,kBAAkB,kBAAkB,WAAW;CAEvD,IAAIC;CAEJ,MAAM,gBAAgB,IAAI,eACvB,GAAG,SAA+B;AACjC,MAAI,MAAM,QAAQ,SAAS;GACzB,MAAM,CAAC,OAAO,YAAY;AAC1B,UAAO,SAAS,MAAM,GAAG,OAAO;;AAGlC,SAAO,IAAI,OACR,YAAY;GACX,MAAM,SAAS,OAAO,MAAM,SAAS;AAErC,OAAI,kBAAkB,SACpB,QAAO,OAAO;AAGhB,UAAO;KAET,MACA,SACA;IAGJ,mBAAmB,aAAa,oBAAoB;CAGtD,SAAS,IAAI,GAAG,MAAY;EAC1B,MAAM,aAAa,KAAK,YAAY;AACpC,MAAI,eAAe,GACjB,QAAO,KAAK,MAAM,GAAG;EAGvB,MAAM,WAAW,SAAS,cAAc,QAAQ,YAAY,GAAG,QAAQ;AACvE,SAAO,cAAc,WAAW,MAAM;;CAGxC,MAAM,YAAY,aAAkB;AAClC,SAAO,eAAe,CAAC,cAAc;;CAGvC,MAAM,iBAAiB,EAAE,eAAe,SAAuC,OAAO;AACpF,OAAK,MAAM,YAAY,cAAc,SACnC,KAAI,OAAO,UACT,UAAS;;CAKf,MAAM,YAAY,EAAE,eAAe,SAAuC,OAAO;AAC/E,OAAK,MAAM,YAAY,cAAc,SACnC,KAAI,OAAO,UACT,UAAS;;CAKf,MAAM,qBAAqB;AACzB,SAAO,cAAc;;AAGvB,gBAAe,IAAI,MACjB,OAAO,aAAa,QAAW;EAC7B;EACA;EACA;EACA;KAEF;EACE,MAAM,SAAS,UAAU,UAAU;AACjC,UAAO,IAAI,GAAI;;EAEjB,IAAI,QAAQ,GAAG,UAAU;AACvB,OAAI,QAAQ,IAAI,QAAQ,GACtB,QAAO,QAAQ,IAAI,QAAQ,GAAG;GAGhC,MAAM,YAAY,IAAI,GAAI;AAC1B,UAAO,QAAQ,IAAI,WAAW,GAAG;;;CAKvC,MAAM,SAAS,MAAM,QAAQ,iBACzB,gBACA,gBACE,CAAC,iBACD;AAEN,MAAK,MAAM,SAAS,OAAO,OAAO,cAChC,OAAM,IAAI;AAGZ,QAAO;;AAGT,MAAaC,cACK,uBAAO,OAAO,QAAQ,EACpC,gBAAgB;CACd,yBAAyB;CACzB,kBAAkB,EAAE,MAAM;CAC1B,QAAQ,EAAE,cAAc;CACxB,QAAQ;;;;;AC3dd,IAAa,QAAb,MAAa,MAAS;CACpB,YAAY,AAAgBC,cAAiB;EAAjB;AAC1B,WAAS;;;AAIb,SAAgB,YAAe,cAA2B;AACxD,QAAO,IAAI,MAAM"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"scope-BfYAP7hS.cjs","names":["factory: (...args: Args) => T","cacheTime?: number","simpleHash","name?: string","allResources: ResourceGroup","Store","args: Args","options: CacheOptions<T, Args>","derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n }","createStore","calculatedValue","PromiseWithState","calcDuration","makeSelector","baseInstance: CacheBundle<T, Args> & Cache<T, Args>","createCache: typeof create & { defaultOptions: CacheOptions<any, any> }","deepEqual","defaultValue: T"],"sources":["../src/lib/instanceCache.ts","../src/core/resourceGroup.ts","../src/core/cache.ts","../src/core/scope.ts"],"sourcesContent":["import { simpleHash } from './hash';\n\nexport class InstanceCache<Args extends any[], T extends object> {\n private cache = new Map<string, { t: number; ref?: T; weakRef: WeakRef<T> }>();\n\n private interval = this.cacheTime\n ? setInterval(() => this.cleanup(), Math.max(this.cacheTime / 10, 1))\n : undefined;\n\n constructor(\n public readonly factory: (...args: Args) => T,\n public readonly cacheTime?: number,\n ) {}\n\n cleanup(): void {\n const cutoff = this.now() - (this.cacheTime ?? 0);\n\n for (const [key, entry] of this.cache.entries()) {\n if (entry.ref && entry.t <= cutoff) {\n delete entry.ref;\n }\n\n if (!entry.ref && !entry.weakRef?.deref()) {\n this.cache.delete(key);\n }\n }\n }\n\n get(...args: Args): T {\n return this.getWithKey(args, args);\n }\n\n getWithKey(args: Args, cacheKey: unknown): T {\n const key = simpleHash(cacheKey);\n let entry = this.cache.get(key);\n let value = entry?.ref ?? entry?.weakRef?.deref();\n\n if (!entry || !value) {\n value = this.factory(...args);\n entry = {\n t: this.now(),\n ref: value,\n weakRef: new WeakRef(value),\n };\n\n this.cache.set(key, entry);\n } else {\n entry.t = this.now();\n entry.ref ??= value;\n }\n\n return value;\n }\n\n values(): T[] {\n return [...this.cache.values()]\n .map((entry) => entry.ref ?? entry.weakRef?.deref())\n .filter((value): value is T => !!value);\n }\n\n stop(): void {\n if (this.interval) {\n clearInterval(this.interval);\n }\n }\n\n stats(): { count: number; withRef: number; withWeakRef: number } {\n return {\n count: this.cache.size,\n withRef: [...this.cache.values()].filter((x) => !!x.ref).length,\n withWeakRef: [...this.cache.values()].filter((x) => !!x.weakRef?.deref()).length,\n };\n }\n\n private now() {\n return performance.now();\n }\n}\n","import { autobind } from '@lib/autobind';\n\nexport interface Resource {\n invalidateAll(): void;\n clearAll(): void;\n}\n\nexport class ResourceGroup {\n private refMap = new WeakMap<Resource, WeakRef<Resource>>();\n\n private refSet = new Set<WeakRef<Resource>>();\n\n constructor(public readonly name?: string) {\n autobind(ResourceGroup);\n }\n\n add(resource: Resource): void {\n const ref = new WeakRef(resource);\n this.refMap.set(resource, ref);\n this.refSet.add(ref);\n }\n\n delete(resource: Resource): void {\n const ref = this.refMap.get(resource);\n if (ref) {\n this.refMap.delete(resource);\n this.refSet.delete(ref);\n }\n }\n\n invalidateAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.invalidateAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n\n clearAll(): void {\n for (const ref of this.refSet) {\n const resource = ref.deref();\n if (resource) {\n resource.clearAll();\n } else {\n this.refSet.delete(ref);\n }\n }\n }\n}\n\nexport const allResources: ResourceGroup = /* @__PURE__ */ new ResourceGroup();\n\nexport function createResourceGroup(name?: string): ResourceGroup {\n return new ResourceGroup(name);\n}\n","import { autobind } from '@lib/autobind';\nimport type { CacheState, ErrorState, ValueState } from '@lib/cacheState';\nimport { calcDuration } from '@lib/calcDuration';\nimport { calculatedValue } from '@lib/calculatedValue';\nimport type { Constrain } from '@lib/constrain';\nimport { deepEqual } from '@lib/equals';\nimport { InstanceCache } from '@lib/instanceCache';\nimport { makeSelector } from '@lib/makeSelector';\nimport { type MaybePromise } from '@lib/maybePromise';\nimport type { AnyPath, Path, Value } from '@lib/path';\nimport { PromiseWithState } from '@lib/promiseWithState';\nimport type { Duration, Selector } from './commonTypes';\nimport { allResources, type ResourceGroup } from './resourceGroup';\nimport { Store, createStore, type Calculate, type StoreOptions } from './store';\n\nexport interface CacheGetOptions {\n /**\n * How to handle the cache when getting the value.\n * - `whenMissing`: Only fetch a new value if there is no cached value.\n * - `whenStale`: Fetch a new value if there is no cached value or if the cached value is stale.\n * - `force`: Always fetch a new value, regardless of the cache state.\n */\n update?: 'whenMissing' | 'whenStale' | 'force';\n\n /**\n * If set to `true`, the cache will be updated in the background.\n * This means that a stale value will be returned immediately, if available, while the new value is being fetched.\n */\n backgroundUpdate?: boolean;\n}\n\nexport interface CacheFunction<T, Args extends any[] = []> {\n (...args: Args): Promise<T> | Calculate<Promise<T>>;\n}\n\nexport interface CacheOptions<T, Args extends any[]> extends StoreOptions<Promise<T>> {\n /**\n * How long to keep the cache entry before it is considered stale.\n * If set to `undefined` or `null`, the cache entry will never be invalidated automatically.\n *\n * @example\n * ```typescript\n * createCache(fetchData, {\n * invalidateAfter: { seconds: 10 },\n * });\n * ```\n */\n invalidateAfter?: Duration | ((state: ValueState<T> | ErrorState) => Duration | null) | null;\n\n /**\n * If set, the cache will be invalidated when the window gets focused.\n * This is useful for caches that are used in a browser environment and might become stale when the user switches tabs.\n */\n invalidateOnWindowFocus?: boolean;\n\n /**\n * If set, the cached value will be cleared when the cache is invalidated.\n * Without this option, the cache will keep the last value as stale until a new value becomes available.\n */\n clearOnInvalidate?: boolean;\n\n /**\n * If set, cache entries will be cleared after approximately the specified duration.\n * This is useful for long lived pages or applications and helps to prevent memory leaks.\n * The exact time when the entry is cleared is not guaranteed, since it will be cleared during garbage collection.\n */\n clearUnusedAfter?: Duration | null;\n\n /**\n * Add the cache to the specified resource group(s).\n * This allows you to invalidate or clear multiple caches that belong to the same group.\n * All caches are always added to the `allResources` group.\n */\n resourceGroup?: ResourceGroup | ResourceGroup[];\n\n /**\n * Function to generate a custom cache key based on the provided arguments.\n * This allows you to control how cache entries are identified and reused.\n * By default, the arguments array is used as the cache key.\n *\n * @example\n * ```typescript\n * // Will use the same instance when provided with `undefined`, `{ num: 0 }`, `{ bool: false }`, etc.\n * createCache((filter?: { num?: number, bool?: boolean }) => fetchData(filter), {\n * getCacheKey: (filter?) => ({\n * num: filter?.num ?? 0,\n * bool: filter?.bool ?? false,\n * }),\n * });\n * ```\n */\n getCacheKey?: (...args: NoInfer<Args>) => unknown;\n}\n\nexport class Cache<T, Args extends any[] = []> extends Store<Promise<T>> {\n readonly state: Store<CacheState<T>> = createStore<CacheState<T>>({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n\n protected stalePromise?: Promise<T>;\n\n protected invalidationTimer?: ReturnType<typeof setTimeout>;\n\n constructor(\n getter: Calculate<Promise<T>>,\n public readonly args: Args,\n public readonly options: CacheOptions<T, Args> = {},\n public readonly derivedFromCache?: {\n cache: Cache<any, any>;\n selectors: (Selector<any, any> | AnyPath)[];\n },\n ) {\n super(getter, options, undefined);\n autobind(Cache);\n\n this.watchPromise();\n this.watchFocus();\n }\n\n get({ update = 'whenStale', backgroundUpdate = false }: CacheGetOptions = {}): Promise<T> {\n this.calculatedValue?.check();\n const promise = this.calculatedValue?.value;\n const stalePromise = this.stalePromise;\n\n if (\n (update === 'whenMissing' && !promise && !stalePromise) ||\n (update === 'whenStale' && !promise) ||\n update === 'force'\n ) {\n this.calculatedValue = calculatedValue(this, this.notify);\n this.notify();\n\n if ((!promise && !stalePromise) || !backgroundUpdate) {\n return this.calculatedValue.value;\n }\n }\n\n if (!promise || (stalePromise && backgroundUpdate)) {\n return stalePromise!;\n }\n\n return promise;\n }\n\n updateValue(value: MaybePromise<T> | ((value: T | undefined) => T)): void {\n if (value instanceof Function) {\n value = value(this.state.get().value);\n }\n this.set(PromiseWithState.resolve(value));\n }\n\n updateError(error: unknown): void {\n this.set(PromiseWithState.reject(error));\n }\n\n invalidate(recursive?: boolean): void {\n const { clearOnInvalidate } = this.options;\n\n if (clearOnInvalidate) {\n return this.clear(recursive);\n }\n\n const { status, isStale, isUpdating } = this.state.get();\n if (status !== 'pending' && !isStale && !isUpdating) {\n this.stalePromise = this.calculatedValue?.value;\n }\n\n this.state.set((state) => ({\n ...state,\n isStale: true,\n isUpdating: false,\n }));\n\n super.invalidate(recursive);\n }\n\n clear(recursive?: boolean): void {\n this.state.set({\n status: 'pending',\n isStale: true,\n isUpdating: false,\n isConnected: false,\n });\n delete this.stalePromise;\n\n super.invalidate(recursive);\n }\n\n mapValue<S>(selector: Selector<T, S>): Cache<S, Args>;\n\n mapValue<const P extends AnyPath>(\n selector: P extends Path<T> ? P : Path<T>,\n ): Cache<Value<T, P>, Args>;\n\n mapValue(selector: Selector<any, any> | AnyPath) {\n return mapValue(this, selector);\n }\n\n protected watchPromise(): void {\n this.subscribe(\n async (promise) => {\n if (promise instanceof PromiseWithState && promise.state.status !== 'pending') {\n promise.catch(() => undefined);\n\n this.state.set((state) => ({\n ...promise.state,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n\n delete this.stalePromise;\n this.setTimers();\n return;\n }\n\n this.state.set((state) => ({\n ...state,\n isUpdating: true,\n }));\n\n this.setTimers();\n\n try {\n const value = await promise;\n\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'value',\n value,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n } catch (error) {\n if (promise !== this.calculatedValue?.value) {\n return;\n }\n\n this.state.set((state) => ({\n status: 'error',\n error,\n isStale: false,\n isUpdating: false,\n isConnected: state.isConnected,\n }));\n delete this.stalePromise;\n this.setTimers();\n }\n },\n { passive: true },\n );\n }\n\n protected setTimers(): void {\n if (this.invalidationTimer) {\n clearTimeout(this.invalidationTimer);\n }\n this.invalidationTimer = undefined;\n\n const state = this.state.get();\n let { invalidateAfter } = this.options;\n const ref = new WeakRef(this);\n\n if (state.status === 'pending') {\n return;\n }\n\n if (invalidateAfter instanceof Function) {\n invalidateAfter = invalidateAfter(state);\n }\n\n if (invalidateAfter !== null && invalidateAfter !== undefined) {\n this.invalidationTimer = setTimeout(\n () => ref?.deref()?.invalidate(),\n calcDuration(invalidateAfter),\n );\n }\n }\n\n protected watchFocus(): void {\n const { invalidateOnWindowFocus } = this.options;\n\n if (\n !invalidateOnWindowFocus ||\n typeof document === 'undefined' ||\n typeof document.addEventListener === 'undefined'\n ) {\n return;\n }\n\n const ref = new WeakRef(this);\n\n const onFocus = () => {\n const that = ref?.deref();\n if (!that) {\n document.removeEventListener('visibilitychange', onFocus);\n return;\n }\n\n if (!document.hidden && !that.state.get().isConnected) {\n that.invalidate();\n }\n };\n\n document.addEventListener('visibilitychange', onFocus);\n }\n}\n\nfunction mapValue<T, S, Args extends any[]>(\n cache: Cache<T, Args>,\n _selector: Selector<T, S> | AnyPath,\n): Cache<S, Args> {\n const selector = makeSelector(_selector);\n const derivedFromCache = {\n cache: cache.derivedFromCache ? cache.derivedFromCache.cache : cache,\n selectors: cache.derivedFromCache\n ? [...cache.derivedFromCache.selectors, _selector]\n : [_selector],\n };\n\n return new Cache<S, Args>(\n async ({ use }) => {\n const value = await use(cache);\n return selector(value);\n },\n cache.args,\n {\n equals: cache.options.equals,\n },\n derivedFromCache,\n );\n}\n\nexport type CreateCacheResult<T, Args extends any[]> = [] extends Args\n ? CacheBundle<T, Args> & Cache<T, Args>\n : CacheBundle<T, Args>;\n\nexport interface InvalidationOptions<T, Args extends any[]> {\n filter?: (cache: Cache<T, Args>) => boolean;\n}\n\nexport type CacheBundle<T, Args extends any[]> = {\n (...args: Args): Cache<T, Args>;\n mapCache<S>(selector: Selector<T, S>): CreateCacheResult<S, Args>;\n mapValue<const P>(selector: Constrain<P, Path<T>>): CreateCacheResult<Value<T, P>, Args>;\n invalidateAll: (options?: InvalidationOptions<T, Args>) => void;\n clearAll: (options?: InvalidationOptions<T, Args>) => void;\n getInstances: () => Cache<T, Args>[];\n};\n\nfunction create<T, Args extends any[] = []>(\n cacheFunction: CacheFunction<T, Args>,\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args> {\n return internalCreate<T, Args>(cacheFunction, options);\n}\n\nfunction internalCreate<T, Args extends any[] = []>(\n source:\n | CacheFunction<T, Args>\n | [cache: CacheBundle<any, Args>, selector: Selector<any, T> | AnyPath],\n options?: CacheOptions<T, Args>,\n): CreateCacheResult<T, Args> {\n options = { ...createCache.defaultOptions, ...options };\n const { clearUnusedAfter, resourceGroup } = options ?? {};\n\n let baseInstance: CacheBundle<T, Args> & Cache<T, Args>;\n\n const instanceCache = new InstanceCache<Args, Cache<T, Args>>(\n (...args: Args): Cache<T, Args> => {\n if (Array.isArray(source)) {\n const [cache, selector] = source;\n return mapValue(cache(...args), selector);\n }\n\n return new Cache(\n (helpers) => {\n const result = source.apply(helpers, args);\n\n if (result instanceof Function) {\n return result(helpers);\n }\n\n return result;\n },\n args,\n options,\n undefined,\n );\n },\n clearUnusedAfter ? calcDuration(clearUnusedAfter) : undefined,\n );\n\n function get(...args: Args) {\n const sliceAfter = args.lastIndexOf(undefined);\n if (sliceAfter !== -1) {\n args = args.slice(0, sliceAfter) as Args;\n }\n\n const cacheKey = options?.getCacheKey ? options.getCacheKey(...args) : args;\n return instanceCache.getWithKey(args, cacheKey);\n }\n\n const mapCache = (selector: any) => {\n return internalCreate([baseInstance, selector]);\n };\n\n const invalidateAll = ({ filter = () => true }: InvalidationOptions<T, Args> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.invalidate();\n }\n }\n };\n\n const clearAll = ({ filter = () => true }: InvalidationOptions<T, Args> = {}) => {\n for (const instance of instanceCache.values()) {\n if (filter(instance)) {\n instance.clear();\n }\n }\n };\n\n const getInstances = () => {\n return instanceCache.values();\n };\n\n baseInstance = new Proxy(\n Object.assign(() => undefined, {\n mapCache,\n invalidateAll,\n clearAll,\n getInstances,\n }),\n {\n apply(_target, _thisArg, argArray) {\n return get(...(argArray as unknown as Args));\n },\n get(target, p, receiver) {\n if (Reflect.has(target, p)) {\n return Reflect.get(target, p, receiver);\n }\n\n const baseCache = get(...([] as unknown as Args));\n return Reflect.get(baseCache, p, baseCache);\n },\n },\n ) as unknown as CacheBundle<T, Args> & Cache<T, Args>;\n\n const groups = Array.isArray(resourceGroup)\n ? resourceGroup\n : resourceGroup\n ? [resourceGroup]\n : [];\n\n for (const group of groups.concat(allResources)) {\n group.add(baseInstance);\n }\n\n return baseInstance;\n}\n\nexport const createCache: typeof create & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(create, {\n defaultOptions: {\n invalidateOnWindowFocus: true,\n clearUnusedAfter: { days: 1 },\n retain: { milliseconds: 1 },\n equals: deepEqual,\n } as CacheOptions<any, any>,\n });\n","import { autobind } from '@lib/autobind';\n\nexport class Scope<T> {\n constructor(public readonly defaultValue: T) {\n autobind(Scope);\n }\n}\n\nexport function createScope<T>(defaultValue: T): Scope<T> {\n return new Scope(defaultValue);\n}\n"],"mappings":"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"}