@studiolambda/query 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Erik C. Forés
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# Lambda Query
+
+> Lightweight asynchronous data management
+
+Lambda Query is a library created to manage asynchronous data on your code. This is generally used when you have to fetch data asynchronously for a given resource. Lambda Query allows you to manage this data by using an internal cache. It is very similar to how vercel's swr work. Lambda Query is also build to support arbitrary cache and event system, making it possible to create your own implementations.
+
+## Documentation
+
+Find out about the project and discover the features at the [Documentation](https://erik.cat/blog/query-docs/)
+
+## Installation
+
+```
+npm i @studiolambda/query
+```

package/dist/query.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function R(t){return async function(C,{signal:d}){const c=await t(C,{signal:d});if(!c.ok)throw new Error("Unable to fetch the data: "+c.statusText);return await c.json()}}function Z(t){function C(){return 2e3}let d=(t==null?void 0:t.itemsCache)??new Map,c=(t==null?void 0:t.resolversCache)??new Map,v=(t==null?void 0:t.events)??new EventTarget,l=t==null?void 0:t.broadcast,M=(t==null?void 0:t.expiration)??C,A=(t==null?void 0:t.fetcher)??R(fetch),D=(t==null?void 0:t.stale)??!0,F=(t==null?void 0:t.removeOnError)??!1,j=(t==null?void 0:t.fresh)??!1;function q(e){d=(e==null?void 0:e.itemsCache)??d,c=(e==null?void 0:e.resolversCache)??c,v=(e==null?void 0:e.events)??v,l=(e==null?void 0:e.broadcast)??l,M=(e==null?void 0:e.expiration)??M,A=(e==null?void 0:e.fetcher)??A,D=(e==null?void 0:e.stale)??D,F=(e==null?void 0:e.removeOnError)??F,j=(e==null?void 0:e.fresh)??j}function P(e,r,f){v.addEventListener(`${r}:${e}`,f);const u=c.get(e);return r==="refetching"&&u!==void 0&&f(new CustomEvent(`${r}:${e}`,{detail:u.item})),function(){v.removeEventListener(`${r}:${e}`,f)}}async function U(e,r,f){async function u(E){var $;if(typeof E=="function"){const a=E,m=d.get(e);E=await a(m==null?void 0:m.item,m==null?void 0:m.expiresAt)}const w=new Date;return w.setMilliseconds(w.getMilliseconds()+((($=f==null?void 0:f.expiration)==null?void 0:$.call(f,E))??0)),d.set(e,{item:E,expiresAt:w}),E}const h=u(r);v.dispatchEvent(new CustomEvent(`mutating:${e}`,{detail:h}));const g=await h;return v.dispatchEvent(new CustomEvent(`mutated:${e}`,{detail:g})),l==null||l.postMessage({event:`mutated:${e}`,detail:g}),g}function b(e){var r;return(r=d.get(e))==null?void 0:r.item}function x(e="items"){return Array.from(e==="items"?d.keys():c.keys())}function z(e,r){const f=typeof e=="string"?[e]:e??x("resolvers");for(const u of f){const h=c.get(u);h!==void 0&&(h.controller.abort(r),c.delete(u),v.dispatchEvent(new CustomEvent(`aborted:${u}`,{detail:r})),l==null||l.postMessage({event:`aborted:${u}`,detail:r}))}}function G(e){let r;typeof e=="string"?r=[e]:Array.isArray(e)?r=e:e instanceof RegExp?r=x("items").filter(f=>f.match(e)):r=x("items");for(const f of r){const u=d.get(f);u!==void 0&&(d.delete(f),v.dispatchEvent(new CustomEvent(`forgotten:${f}`,{detail:u.item})),l==null||l.postMessage({event:`forgotten:${f}`,detail:u.item}))}}function H(e,r,f){var h;const u=new Date;u.setMilliseconds(u.getMilliseconds()+(((h=f==null?void 0:f.expiration)==null?void 0:h.call(f,r))??0));for(const g of typeof e=="string"?[e]:e)d.set(g,{item:r,expiresAt:u}),v.dispatchEvent(new CustomEvent(`hydrated:${g}`,{detail:r})),l==null||l.postMessage({event:`hydrated:${g}`,detail:r})}function I(e){var r;return(r=d.get(e))==null?void 0:r.expiresAt}async function J(e,r){const f=(r==null?void 0:r.expiration)??M,u=(r==null?void 0:r.fetcher)??A,h=(r==null?void 0:r.stale)??D,g=(r==null?void 0:r.removeOnError)??F,E=(r==null?void 0:r.fresh)??(t==null?void 0:t.fresh);async function w(a){try{const m=c.get(a);if(m!==void 0)return await m.item;const Q=new AbortController;async function Y(){const S=await u(a,{signal:Q.signal});c.delete(a);const T=new Date;return T.setMilliseconds(T.getMilliseconds()+f(S)),d.set(a,{item:S,expiresAt:T}),S}const L=Y();c.set(a,{item:L,controller:Q}),v.dispatchEvent(new CustomEvent(`refetching:${a}`,{detail:L}));const B=await L;return v.dispatchEvent(new CustomEvent(`resolved:${a}`,{detail:B})),l==null||l.postMessage({event:`resolved:${a}`,detail:B}),B}catch(m){throw c.delete(a),g&&d.delete(a),v.dispatchEvent(new CustomEvent(`error:${a}`,{detail:m})),l==null||l.postMessage({event:`error:${a}`,detail:m}),m}}if(E)return await w(e);const $=d.get(e);if($!==void 0){const a=$.expiresAt<=new Date;return a&&h?(w(e).catch(()=>{}),$.item):a?await w(e):$.item}return await w(e)}function N(){return{items:d,resolvers:c}}function V(){return v}function W(){return l}function X(){function e(r){v.dispatchEvent(new CustomEvent(r.data.event,{detail:r.data.detail}))}return l==null||l.addEventListener("message",e),function(){l==null||l.removeEventListener("message",e)}}return{query:J,subscribe:P,subscribeBroadcast:X,mutate:U,configure:q,abort:z,forget:G,keys:x,expiration:I,hydrate:H,snapshot:b,caches:N,events:V,broadcast:W}}exports.createQuery=Z;exports.defaultFetcher=R;
+//# sourceMappingURL=query.cjs.map

package/dist/query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.cjs","sources":["../src/query/index.ts"],"sourcesContent":["/**\n * Determines the shape of the Cache instance.\n */\nexport interface Cache<T = unknown> {\n  /**\n   * Gets an item from the cache.\n   */\n  readonly get: (key: string) => T | undefined\n\n  /**\n   * Sets an item to the cache.\n   */\n  readonly set: (key: string, value: T) => void\n\n  /**\n   * Removes a key-value pair from the cache.\n   */\n  readonly delete: (key: string) => void\n\n  /**\n   * Returns the current cached keys.\n   */\n  readonly keys: () => IterableIterator<string>\n}\n\n/**\n * Determines how we store items in the items cache.\n */\ninterface ItemsCacheItem<T = unknown> {\n  /**\n   * Stores the cache item.\n   */\n  readonly item: T\n\n  /**\n   * Determines the expiration date of the item.\n   */\n  readonly expiresAt: Date\n}\n\n/**\n * Determines how we store items in the resolvers cache.\n */\ninterface ResolversCacheItem<T> {\n  /**\n   * The resolvable item.\n   */\n  readonly item: Promise<T>\n\n  /**\n   * The abort controller for the request.\n   */\n  readonly controller: AbortController\n}\n\n/**\n * Represents the available configuration options\n * for a query instance.\n */\nexport interface Configuration extends Options {\n  /**\n   * Determines the resolved items cache to use.\n   */\n  readonly itemsCache?: Cache<ItemsCacheItem>\n\n  /**\n   * Determines the resolvers cache to use.\n   */\n  readonly resolversCache?: Cache<ResolversCacheItem<unknown>>\n\n  /**\n   * Stores the event system.\n   */\n  readonly events?: EventTarget\n\n  /**\n   * Broadcast channel. This is useful for communicating\n   * between tabs and windows (browser contexts).\n   *\n   * By default it does not use any broadcast channel.\n   * If a broadcast channel is provided, query\n   * won't close automatically, therefore, the responsability\n   * of closing the broadcast channel is up to the user.\n   */\n  readonly broadcast?: BroadcastChannel\n}\n\nexport interface FetcherAdditional {\n  /**\n   * An abort signal to cancel pending queries.\n   */\n  readonly signal: AbortSignal\n}\n\n/**\n * The available options for query.\n */\nexport interface Options<T = unknown> {\n  /**\n   * Determines the item deduplication interval.\n   * This determines how many milliseconds an item\n   * is considered valid.\n   */\n  readonly expiration?: ExpirationFunction<T>\n\n  /**\n   * Determines the fetcher function to use.\n   */\n  readonly fetcher?: FetcherFunction<T>\n\n  /**\n   * Determines if we can return a stale item.\n   * If `true`, it will return the previous stale item\n   * stored in the cache if it has expired. It will attempt\n   * to revalidate it in the background. If `false`, the returned\n   * promise will be the revalidation promise.\n   */\n  readonly stale?: boolean\n\n  /**\n   * Removes the stored item if there is an error in the request.\n   * By default, we don't remove the item upon failure, only the resolver\n   * is removed from the cache.\n   */\n  readonly removeOnError?: boolean\n\n  /**\n   * Determines if the result should be a fresh fetched\n   * instance regardless of any cached value or its expiration time.\n   */\n  readonly fresh?: boolean\n}\n\n/**\n * Determines the cache type.\n */\nexport type CacheType = 'resolvers' | 'items'\n\n/**\n * The mutation function type.\n */\nexport interface MutationFunction<T> {\n  (previous?: T, expiresAt?: Date): T | Promise<T>\n}\n\n/**\n * The available mutation values.\n */\nexport type MutationValue<T> = T | MutationFunction<T>\n\n/**\n * The function type for the event subscription.\n */\nexport interface SubscribeFunction {\n  (key: string, event: QueryEvent, listener: EventListener): Unsubscriber\n}\n\n/**\n * The broadcast payload.\n */\nexport interface BroadcastPayload {\n  /**\n   * The event name.\n   */\n  readonly event: string\n\n  /**\n   * The event detail.\n   */\n  readonly detail: unknown\n}\n\n/**\n * The function type for the broadcast subscription.\n */\nexport interface SubscribeBroadcastFunction {\n  (): Unsubscriber\n}\n\n/**\n * The query function type.\n */\nexport interface QueryFunction {\n  <T = unknown>(key: string, options?: Options<T>): Promise<T>\n}\n\nexport interface ExpirationFunction<T = unknown> {\n  (item: T): number\n}\n\nexport interface FetcherFunction<T = unknown> {\n  (key: string, additional: FetcherAdditional): Promise<T>\n}\n\n/**\n * The mutate function options.\n */\nexport interface HydrateOptions<T = unknown> {\n  expiration?: ExpirationFunction<T>\n}\n\n/**\n * The mutate function options.\n */\nexport interface MutateOptions<T = unknown> {\n  expiration?: ExpirationFunction<T>\n}\n\n/**\n * The mutate function type.\n */\nexport interface MutateFunction {\n  <T = unknown>(key: string, item: MutationValue<T>, options?: MutateOptions<T>): Promise<T>\n}\n\n/**\n * The hydrate function type.\n */\nexport interface HydrateFunction {\n  <T = unknown>(keys: string | string[], item: T, options?: HydrateOptions<T>): void\n}\n\n/**\n * The unsubscriber function.\n */\nexport type Unsubscriber = () => void\n\n/**\n * The caches available on the query.\n */\nexport interface Caches {\n  /**\n   * A cache that contains the resolved items alongside\n   * their expiration time.\n   */\n  readonly items: Cache<ItemsCacheItem>\n\n  /**\n   * A cache that contains the resolvers alongside\n   * their abort controllers.\n   */\n  readonly resolvers: Cache<ResolversCacheItem<unknown>>\n}\n\n/**\n * Represents the methods a query\n * should implement.\n */\nexport interface Query {\n  /**\n   * Configures the current instance of query.\n   */\n  readonly configure: (options?: Partial<Configuration>) => void\n\n  /**\n   * Fetches the key information using a fetcher.\n   * The returned promise contains the result item.\n   */\n  readonly query: QueryFunction\n\n  /**\n   * Subscribes to a given event & key. The event handler\n   * does have a payload parameter that will contain relevant\n   * information depending on the event type.\n   */\n  readonly subscribe: SubscribeFunction\n\n  /**\n   * Subscribes to the broadcast channel\n   * to listen for other browser context\n   * events and reproduce them in the current\n   * context.\n   */\n  readonly subscribeBroadcast: SubscribeBroadcastFunction\n\n  /**\n   * Mutates the key with a given optimistic value.\n   * The mutated value is considered expired and will be\n   * replaced immediatly if a refetch happens.\n   */\n  readonly mutate: MutateFunction\n\n  /**\n   * Aborts the active resolvers on each key\n   * by calling `.abort()` on the `AbortController`.\n   * The fetcher is responsible for using the\n   * `AbortSignal` to cancel the job.\n   */\n  readonly abort: (key?: string | string[], reason?: unknown) => void\n\n  /**\n   * Forgets the given keys from the cache.\n   * Removes items from both, the cache and resolvers.\n   */\n  readonly forget: (keys?: string | string[] | RegExp) => void\n\n  /**\n   * Hydrates the given keys on the cache\n   * with the given value and expiration time.\n   */\n  readonly hydrate: HydrateFunction\n\n  /**\n   * Returns the given keys for the given cache.\n   */\n  readonly keys: (cache?: CacheType) => string[]\n\n  /**\n   * Returns the expiration date of a given key item.\n   * If the item is not in the cache, it will return `undefined`.\n   */\n  readonly expiration: (key: string) => Date | undefined\n\n  /**\n   * Returns the current snapshot of the given key.\n   * If the item is not in the items cache, it will return `undefined`.\n   */\n  readonly snapshot: <T = unknown>(key: string) => T | undefined\n\n  /**\n   * Returns the current cache instances in use.\n   */\n  readonly caches: () => Caches\n\n  /**\n   * Returns the event system in use.\n   */\n  readonly events: () => EventTarget\n\n  /**\n   * Returns the broadcast channel in use.\n   */\n  readonly broadcast: () => BroadcastChannel | undefined\n}\n\n/**\n * Available events on query.\n */\nexport type QueryEvent =\n  | 'refetching'\n  | 'resolved'\n  | 'mutating'\n  | 'mutated'\n  | 'aborted'\n  | 'forgotten'\n  | 'hydrated'\n  | 'error'\n\n/**\n * Stores the default fetcher function.\n */\nexport function defaultFetcher<T>(\n  fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>\n): FetcherFunction<T> {\n  return async function (key: string, { signal }: FetcherAdditional): Promise<T> {\n    const response = await fetch(key, { signal })\n\n    if (!response.ok) {\n      throw new Error('Unable to fetch the data: ' + response.statusText)\n    }\n\n    return (await response.json()) as T\n  }\n}\n\n/**\n * Creates a new query instance.\n */\nexport function createQuery(instanceOptions?: Configuration): Query {\n  /**\n   * Stores the default expiration function.\n   */\n  function defaultExpiration() {\n    return 2000\n  }\n\n  /**\n   * Stores the items cache.\n   */\n  let itemsCache = instanceOptions?.itemsCache ?? new Map<string, ItemsCacheItem>()\n\n  /**\n   * Stores the resolvers cache.\n   */\n  let resolversCache =\n    instanceOptions?.resolversCache ?? new Map<string, ResolversCacheItem<unknown>>()\n\n  /**\n   * Event manager.\n   */\n  let events = instanceOptions?.events ?? new EventTarget()\n\n  /**\n   * Broadcast channel. This is useful for communicating\n   * between tabs and windows (browser contexts).\n   *\n   * By default it does not use any broadcast channel.\n   * If a broadcast channel is provided, query\n   * won't close automatically, therefore, the responsability\n   * of closing the broadcast channel is up to the user.\n   */\n  let broadcast = instanceOptions?.broadcast\n\n  /**\n   * Stores the expiration time of an item.\n   */\n  let instanceExpiration = instanceOptions?.expiration ?? defaultExpiration\n\n  /**\n   * Determines the fetcher function to use.\n   */\n  let instanceFetcher = instanceOptions?.fetcher ?? defaultFetcher(fetch)\n\n  /**\n   * Determines if we can return a stale item.\n   * If `true`, it will return the previous stale item\n   * stored in the cache if it has expired. It will attempt\n   * to revalidate it in the background. If `false`, the returned\n   * promise will be the revalidation promise.\n   */\n  let instanceStale = instanceOptions?.stale ?? true\n\n  /**\n   * Removes the stored item if there is an error in the request.\n   * By default, we don't remove the item upon failure, only the resolver\n   * is removed from the cache.\n   */\n  let instanceRemoveOnError = instanceOptions?.removeOnError ?? false\n\n  /**\n   * Determines if the result should be a fresh fetched\n   * instance regardless of any cached value or its expiration time.\n   */\n  let instanceFresh = instanceOptions?.fresh ?? false\n\n  /**\n   * Configures the current instance of query.\n   */\n  function configure(options?: Configuration): void {\n    itemsCache = options?.itemsCache ?? itemsCache\n    resolversCache = options?.resolversCache ?? resolversCache\n    events = options?.events ?? events\n    broadcast = options?.broadcast ?? broadcast\n    instanceExpiration = options?.expiration ?? instanceExpiration\n    instanceFetcher = options?.fetcher ?? instanceFetcher\n    instanceStale = options?.stale ?? instanceStale\n    instanceRemoveOnError = options?.removeOnError ?? instanceRemoveOnError\n    instanceFresh = options?.fresh ?? instanceFresh\n  }\n\n  /**\n   * Subscribes to a given keyed event. The event handler\n   * does have a payload parameter that will contain relevant\n   * information depending on the event type.\n   * If there's a pending resolver for that key, the `refetching`\n   * event is fired immediatly.\n   */\n  function subscribe(key: string, event: QueryEvent, listener: EventListener): Unsubscriber {\n    events.addEventListener(`${event}:${key}`, listener)\n    const value = resolversCache.get(key)\n\n    // For the refetching event, we want to immediatly return if there's\n    // a pending resolver.\n    if (event === 'refetching' && value !== undefined) {\n      listener(new CustomEvent(`${event}:${key}`, { detail: value.item }))\n    }\n\n    return function () {\n      events.removeEventListener(`${event}:${key}`, listener)\n    }\n  }\n\n  /**\n   * Mutates the key with a given optimistic value.\n   * The mutated value is considered expired and will be\n   * replaced immediatly if a refetch happens when expired\n   * is true. If expired is false, the value expiration time\n   * is added as if it was a valid data refetched. Alternatively\n   * you can provide a Date to decide when the expiration happens.\n   */\n  async function mutate<T = unknown>(\n    key: string,\n    resolver: MutationValue<T>,\n    options?: MutateOptions<T>\n  ): Promise<T> {\n    async function action(resolver: MutationValue<T>) {\n      if (typeof resolver === 'function') {\n        const fn = resolver as MutationFunction<T>\n        const value = itemsCache.get(key)\n\n        resolver = await fn(value?.item as T, value?.expiresAt)\n      }\n\n      const expiresAt = new Date()\n\n      expiresAt.setMilliseconds(\n        expiresAt.getMilliseconds() + (options?.expiration?.(resolver) ?? 0)\n      )\n\n      itemsCache.set(key, { item: resolver, expiresAt: expiresAt })\n\n      return resolver\n    }\n\n    const result = action(resolver)\n\n    events.dispatchEvent(new CustomEvent(`mutating:${key}`, { detail: result }))\n\n    const item = await result\n\n    events.dispatchEvent(new CustomEvent(`mutated:${key}`, { detail: item }))\n    broadcast?.postMessage({ event: `mutated:${key}`, detail: item })\n\n    return item\n  }\n\n  /**\n   * Returns the current snapshot of the given key.\n   * If the item is not in the items cache, it will return `undefined`.\n   */\n  function snapshot<T = unknown>(key: string): T | undefined {\n    return itemsCache.get(key)?.item as T\n  }\n\n  /**\n   * Determines if the given key is currently resolving.\n   */\n  function keys(type: CacheType = 'items'): string[] {\n    return Array.from(type === 'items' ? itemsCache.keys() : resolversCache.keys())\n  }\n\n  /**\n   * Aborts the active resolvers on each key\n   * by calling `.abort()` on the `AbortController`.\n   * The fetcher is responsible for using the\n   * `AbortSignal` to cancel the job.\n   * If no keys are provided, all resolvers are aborted.\n   */\n  function abort(cacheKeys?: string | string[], reason?: unknown): void {\n    const resolverKeys =\n      typeof cacheKeys === 'string' ? [cacheKeys] : (cacheKeys ?? keys('resolvers'))\n\n    for (const key of resolverKeys) {\n      const resolver = resolversCache.get(key)\n\n      if (resolver !== undefined) {\n        resolver.controller.abort(reason)\n        resolversCache.delete(key)\n\n        events.dispatchEvent(new CustomEvent(`aborted:${key}`, { detail: reason }))\n        broadcast?.postMessage({ event: `aborted:${key}`, detail: reason })\n      }\n    }\n  }\n\n  /**\n   * Forgets the given keys from the items cache.\n   * Does not remove any resolvers.\n   * If no keys are provided the items cache is cleared.\n   */\n  function forget(cacheKeys?: string | string[] | RegExp): void {\n    let itemKeys: string[]\n\n    if (typeof cacheKeys === 'string') {\n      itemKeys = [cacheKeys]\n    } else if (Array.isArray(cacheKeys)) {\n      itemKeys = cacheKeys\n    } else if (cacheKeys instanceof RegExp) {\n      itemKeys = keys('items').filter((key) => key.match(cacheKeys))\n    } else {\n      itemKeys = keys('items')\n    }\n\n    for (const key of itemKeys) {\n      const item = itemsCache.get(key)\n\n      if (item !== undefined) {\n        itemsCache.delete(key)\n        events.dispatchEvent(new CustomEvent(`forgotten:${key}`, { detail: item.item }))\n        broadcast?.postMessage({ event: `forgotten:${key}`, detail: item.item })\n      }\n    }\n  }\n\n  /**\n   * Hydrates the given keys on the cache\n   * with the given value. Hydrate should only\n   * be used when you want to populate the cache.\n   * Please use mutate() in most cases unless you\n   * know what you are doing.\n   */\n  function hydrate<T = unknown>(\n    keys: string | string[],\n    item: T,\n    options?: HydrateOptions<T>\n  ): void {\n    const expiresAt = new Date()\n    expiresAt.setMilliseconds(expiresAt.getMilliseconds() + (options?.expiration?.(item) ?? 0))\n\n    for (const key of typeof keys === 'string' ? [keys] : keys) {\n      itemsCache.set(key, { item, expiresAt: expiresAt })\n      events.dispatchEvent(new CustomEvent(`hydrated:${key}`, { detail: item }))\n      broadcast?.postMessage({ event: `hydrated:${key}`, detail: item })\n    }\n  }\n\n  /**\n   * Returns the expiration date of a given key item.\n   * If the item is not in the cache, it will return `undefined`.\n   */\n  function expiration(key: string): Date | undefined {\n    return itemsCache.get(key)?.expiresAt\n  }\n\n  /**\n   * Fetches the key information using a fetcher.\n   * The returned promise contains the result item.\n   */\n  async function query<T = unknown>(key: string, options?: Options<T>): Promise<T> {\n    /**\n     * Stores the expiration time of an item.\n     */\n    const expiration = options?.expiration ?? instanceExpiration\n\n    /**\n     * Determines the fetcher function to use.\n     */\n    const fetcher = (options?.fetcher ?? instanceFetcher) as FetcherFunction<T>\n\n    /**\n     * Determines if we can return a sale item\n     * If true, it will return the previous stale item\n     * stored in the cache if it has expired. It will attempt\n     * to revalidate it in the background. If false, the returned\n     * promise will be the revalidation promise.\n     */\n    const stale = options?.stale ?? instanceStale\n\n    /**\n     * Removes the stored item if there is an error in the request.\n     * By default, we don't remove the item upon failure, only the resolver\n     * is removed from the cache.\n     */\n    const removeOnError = options?.removeOnError ?? instanceRemoveOnError\n\n    /**\n     * Determines if the result should be a fresh fetched\n     * instance regardless of any cached value or its expiration time.\n     */\n    const fresh = options?.fresh ?? instanceOptions?.fresh\n\n    // Force fetching of the data.\n    async function refetch(key: string): Promise<T> {\n      try {\n        // Check if there's a pending resolver for that data.\n        const pending = resolversCache.get(key)\n\n        if (pending !== undefined) {\n          return await (pending.item as Promise<T>)\n        }\n\n        // Create the abort controller that will be\n        // called when a query is aborted.\n        const controller = new AbortController()\n\n        // Initiate the fetching request.\n        async function action() {\n          const result = fetcher(key, { signal: controller.signal })\n\n          // Awaits the fetching to get the result item.\n          const item = await result\n\n          // Removes the resolver from the cache.\n          resolversCache.delete(key)\n\n          // Create the expiration time for the item.\n          const expiresAt = new Date()\n          expiresAt.setMilliseconds(expiresAt.getMilliseconds() + expiration(item))\n\n          // Set the item to the cache.\n          itemsCache.set(key, { item, expiresAt })\n\n          return item\n        }\n\n        const result = action()\n\n        // Adds the resolver to the cache.\n        resolversCache.set(key, { item: result, controller })\n        events.dispatchEvent(new CustomEvent(`refetching:${key}`, { detail: result }))\n\n        const item = await result\n\n        // Notify of the resolved item.\n        events.dispatchEvent(new CustomEvent(`resolved:${key}`, { detail: item }))\n        broadcast?.postMessage({ event: `resolved:${key}`, detail: item })\n\n        // Return back the item.\n        return item\n      } catch (error) {\n        // Remove the resolver.\n        resolversCache.delete(key)\n\n        // Check if the item should be removed as well.\n        if (removeOnError) {\n          itemsCache.delete(key)\n        }\n\n        // Notify of the error.\n        events.dispatchEvent(new CustomEvent(`error:${key}`, { detail: error }))\n        broadcast?.postMessage({ event: `error:${key}`, detail: error })\n\n        // Throw back the error.\n        throw error\n      }\n    }\n\n    // We want to force a fresh item ignoring any current cached\n    // value or its expiration time.\n    if (fresh) {\n      return await refetch(key)\n    }\n\n    // Check if there's an item in the cache for the given key.\n    const cached = itemsCache.get(key)\n\n    if (cached !== undefined) {\n      // We must check if that item has actually expired.\n      // to trigger a revalidation if needed.\n      const hasExpired = cached.expiresAt <= new Date()\n\n      // The item has expired and the fetch is able\n      // to return a stale item while revalidating\n      // in the background.\n      if (hasExpired && stale) {\n        // We have to silence the error to avoid unhandled promises.\n        // Refer to the error event if you need full controll of errors.\n        refetch(key).catch(() => {})\n\n        return cached.item as T\n      }\n\n      // The item has expired but we dont allow stale\n      // responses so we need to wait for the revalidation.\n      if (hasExpired) {\n        return await refetch(key)\n      }\n\n      // The item has not yet expired, so we can return it and\n      // assume it's valid since it's not yet considered stale.\n      return cached.item as T\n    }\n\n    // The item is not found in the items cache.\n    // We need to perform a revalidation of the item.\n    return await refetch(key)\n  }\n\n  /**\n   * Returns the current cache instances.\n   */\n  function caches(): Caches {\n    return { items: itemsCache, resolvers: resolversCache }\n  }\n\n  /**\n   * Returns the event system.\n   */\n  function localEvents() {\n    return events\n  }\n\n  /**\n   * Returns the broadcast channel.\n   */\n  function localBroadcast() {\n    return broadcast\n  }\n\n  /**\n   * Subscribes to the broadcast channel\n   * to listen for other browser context\n   * events and reproduce them in the current\n   * context.\n   */\n  function subscribeBroadcast(): Unsubscriber {\n    function onBroadcastMessage(message: MessageEvent<BroadcastPayload>) {\n      events.dispatchEvent(new CustomEvent(message.data.event, { detail: message.data.detail }))\n    }\n\n    broadcast?.addEventListener('message', onBroadcastMessage)\n\n    return function () {\n      broadcast?.removeEventListener('message', onBroadcastMessage)\n    }\n  }\n\n  return {\n    query,\n    subscribe,\n    subscribeBroadcast,\n    mutate,\n    configure,\n    abort,\n    forget,\n    keys,\n    expiration,\n    hydrate,\n    snapshot,\n    caches,\n    events: localEvents,\n    broadcast: localBroadcast,\n  }\n}\n"],"names":["defaultFetcher","fetch","key","signal","response","createQuery","instanceOptions","defaultExpiration","itemsCache","resolversCache","events","broadcast","instanceExpiration","instanceFetcher","instanceStale","instanceRemoveOnError","instanceFresh","configure","options","subscribe","event","listener","value","mutate","resolver","action","fn","expiresAt","_a","result","item","snapshot","keys","type","abort","cacheKeys","reason","resolverKeys","forget","itemKeys","hydrate","expiration","query","fetcher","stale","removeOnError","fresh","refetch","pending","controller","error","cached","hasExpired","caches","localEvents","localBroadcast","subscribeBroadcast","onBroadcastMessage","message"],"mappings":"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"}

package/dist/query.js

@@ -0,0 +1,144 @@
+function Z(t) {
+  return async function(C, { signal: d }) {
+    const v = await t(C, { signal: d });
+    if (!v.ok)
+      throw new Error("Unable to fetch the data: " + v.statusText);
+    return await v.json();
+  };
+}
+function b(t) {
+  function C() {
+    return 2e3;
+  }
+  let d = (t == null ? void 0 : t.itemsCache) ?? /* @__PURE__ */ new Map(), v = (t == null ? void 0 : t.resolversCache) ?? /* @__PURE__ */ new Map(), m = (t == null ? void 0 : t.events) ?? new EventTarget(), f = t == null ? void 0 : t.broadcast, M = (t == null ? void 0 : t.expiration) ?? C, A = (t == null ? void 0 : t.fetcher) ?? Z(fetch), D = (t == null ? void 0 : t.stale) ?? !0, L = (t == null ? void 0 : t.removeOnError) ?? !1, j = (t == null ? void 0 : t.fresh) ?? !1;
+  function Q(e) {
+    d = (e == null ? void 0 : e.itemsCache) ?? d, v = (e == null ? void 0 : e.resolversCache) ?? v, m = (e == null ? void 0 : e.events) ?? m, f = (e == null ? void 0 : e.broadcast) ?? f, M = (e == null ? void 0 : e.expiration) ?? M, A = (e == null ? void 0 : e.fetcher) ?? A, D = (e == null ? void 0 : e.stale) ?? D, L = (e == null ? void 0 : e.removeOnError) ?? L, j = (e == null ? void 0 : e.fresh) ?? j;
+  }
+  function S(e, r, l) {
+    m.addEventListener(`${r}:${e}`, l);
+    const u = v.get(e);
+    return r === "refetching" && u !== void 0 && l(new CustomEvent(`${r}:${e}`, { detail: u.item })), function() {
+      m.removeEventListener(`${r}:${e}`, l);
+    };
+  }
+  async function U(e, r, l) {
+    async function u(g) {
+      var $;
+      if (typeof g == "function") {
+        const a = g, c = d.get(e);
+        g = await a(c == null ? void 0 : c.item, c == null ? void 0 : c.expiresAt);
+      }
+      const w = /* @__PURE__ */ new Date();
+      return w.setMilliseconds(
+        w.getMilliseconds() + ((($ = l == null ? void 0 : l.expiration) == null ? void 0 : $.call(l, g)) ?? 0)
+      ), d.set(e, { item: g, expiresAt: w }), g;
+    }
+    const h = u(r);
+    m.dispatchEvent(new CustomEvent(`mutating:${e}`, { detail: h }));
+    const E = await h;
+    return m.dispatchEvent(new CustomEvent(`mutated:${e}`, { detail: E })), f == null || f.postMessage({ event: `mutated:${e}`, detail: E }), E;
+  }
+  function z(e) {
+    var r;
+    return (r = d.get(e)) == null ? void 0 : r.item;
+  }
+  function x(e = "items") {
+    return Array.from(e === "items" ? d.keys() : v.keys());
+  }
+  function G(e, r) {
+    const l = typeof e == "string" ? [e] : e ?? x("resolvers");
+    for (const u of l) {
+      const h = v.get(u);
+      h !== void 0 && (h.controller.abort(r), v.delete(u), m.dispatchEvent(new CustomEvent(`aborted:${u}`, { detail: r })), f == null || f.postMessage({ event: `aborted:${u}`, detail: r }));
+    }
+  }
+  function H(e) {
+    let r;
+    typeof e == "string" ? r = [e] : Array.isArray(e) ? r = e : e instanceof RegExp ? r = x("items").filter((l) => l.match(e)) : r = x("items");
+    for (const l of r) {
+      const u = d.get(l);
+      u !== void 0 && (d.delete(l), m.dispatchEvent(new CustomEvent(`forgotten:${l}`, { detail: u.item })), f == null || f.postMessage({ event: `forgotten:${l}`, detail: u.item }));
+    }
+  }
+  function I(e, r, l) {
+    var h;
+    const u = /* @__PURE__ */ new Date();
+    u.setMilliseconds(u.getMilliseconds() + (((h = l == null ? void 0 : l.expiration) == null ? void 0 : h.call(l, r)) ?? 0));
+    for (const E of typeof e == "string" ? [e] : e)
+      d.set(E, { item: r, expiresAt: u }), m.dispatchEvent(new CustomEvent(`hydrated:${E}`, { detail: r })), f == null || f.postMessage({ event: `hydrated:${E}`, detail: r });
+  }
+  function J(e) {
+    var r;
+    return (r = d.get(e)) == null ? void 0 : r.expiresAt;
+  }
+  async function N(e, r) {
+    const l = (r == null ? void 0 : r.expiration) ?? M, u = (r == null ? void 0 : r.fetcher) ?? A, h = (r == null ? void 0 : r.stale) ?? D, E = (r == null ? void 0 : r.removeOnError) ?? L, g = (r == null ? void 0 : r.fresh) ?? (t == null ? void 0 : t.fresh);
+    async function w(a) {
+      try {
+        const c = v.get(a);
+        if (c !== void 0)
+          return await c.item;
+        const q = new AbortController();
+        async function Y() {
+          const R = await u(a, { signal: q.signal });
+          v.delete(a);
+          const T = /* @__PURE__ */ new Date();
+          return T.setMilliseconds(T.getMilliseconds() + l(R)), d.set(a, { item: R, expiresAt: T }), R;
+        }
+        const B = Y();
+        v.set(a, { item: B, controller: q }), m.dispatchEvent(new CustomEvent(`refetching:${a}`, { detail: B }));
+        const F = await B;
+        return m.dispatchEvent(new CustomEvent(`resolved:${a}`, { detail: F })), f == null || f.postMessage({ event: `resolved:${a}`, detail: F }), F;
+      } catch (c) {
+        throw v.delete(a), E && d.delete(a), m.dispatchEvent(new CustomEvent(`error:${a}`, { detail: c })), f == null || f.postMessage({ event: `error:${a}`, detail: c }), c;
+      }
+    }
+    if (g)
+      return await w(e);
+    const $ = d.get(e);
+    if ($ !== void 0) {
+      const a = $.expiresAt <= /* @__PURE__ */ new Date();
+      return a && h ? (w(e).catch(() => {
+      }), $.item) : a ? await w(e) : $.item;
+    }
+    return await w(e);
+  }
+  function P() {
+    return { items: d, resolvers: v };
+  }
+  function V() {
+    return m;
+  }
+  function W() {
+    return f;
+  }
+  function X() {
+    function e(r) {
+      m.dispatchEvent(new CustomEvent(r.data.event, { detail: r.data.detail }));
+    }
+    return f == null || f.addEventListener("message", e), function() {
+      f == null || f.removeEventListener("message", e);
+    };
+  }
+  return {
+    query: N,
+    subscribe: S,
+    subscribeBroadcast: X,
+    mutate: U,
+    configure: Q,
+    abort: G,
+    forget: H,
+    keys: x,
+    expiration: J,
+    hydrate: I,
+    snapshot: z,
+    caches: P,
+    events: V,
+    broadcast: W
+  };
+}
+export {
+  b as createQuery,
+  Z as defaultFetcher
+};
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sources":["../src/query/index.ts"],"sourcesContent":["/**\n * Determines the shape of the Cache instance.\n */\nexport interface Cache<T = unknown> {\n  /**\n   * Gets an item from the cache.\n   */\n  readonly get: (key: string) => T | undefined\n\n  /**\n   * Sets an item to the cache.\n   */\n  readonly set: (key: string, value: T) => void\n\n  /**\n   * Removes a key-value pair from the cache.\n   */\n  readonly delete: (key: string) => void\n\n  /**\n   * Returns the current cached keys.\n   */\n  readonly keys: () => IterableIterator<string>\n}\n\n/**\n * Determines how we store items in the items cache.\n */\ninterface ItemsCacheItem<T = unknown> {\n  /**\n   * Stores the cache item.\n   */\n  readonly item: T\n\n  /**\n   * Determines the expiration date of the item.\n   */\n  readonly expiresAt: Date\n}\n\n/**\n * Determines how we store items in the resolvers cache.\n */\ninterface ResolversCacheItem<T> {\n  /**\n   * The resolvable item.\n   */\n  readonly item: Promise<T>\n\n  /**\n   * The abort controller for the request.\n   */\n  readonly controller: AbortController\n}\n\n/**\n * Represents the available configuration options\n * for a query instance.\n */\nexport interface Configuration extends Options {\n  /**\n   * Determines the resolved items cache to use.\n   */\n  readonly itemsCache?: Cache<ItemsCacheItem>\n\n  /**\n   * Determines the resolvers cache to use.\n   */\n  readonly resolversCache?: Cache<ResolversCacheItem<unknown>>\n\n  /**\n   * Stores the event system.\n   */\n  readonly events?: EventTarget\n\n  /**\n   * Broadcast channel. This is useful for communicating\n   * between tabs and windows (browser contexts).\n   *\n   * By default it does not use any broadcast channel.\n   * If a broadcast channel is provided, query\n   * won't close automatically, therefore, the responsability\n   * of closing the broadcast channel is up to the user.\n   */\n  readonly broadcast?: BroadcastChannel\n}\n\nexport interface FetcherAdditional {\n  /**\n   * An abort signal to cancel pending queries.\n   */\n  readonly signal: AbortSignal\n}\n\n/**\n * The available options for query.\n */\nexport interface Options<T = unknown> {\n  /**\n   * Determines the item deduplication interval.\n   * This determines how many milliseconds an item\n   * is considered valid.\n   */\n  readonly expiration?: ExpirationFunction<T>\n\n  /**\n   * Determines the fetcher function to use.\n   */\n  readonly fetcher?: FetcherFunction<T>\n\n  /**\n   * Determines if we can return a stale item.\n   * If `true`, it will return the previous stale item\n   * stored in the cache if it has expired. It will attempt\n   * to revalidate it in the background. If `false`, the returned\n   * promise will be the revalidation promise.\n   */\n  readonly stale?: boolean\n\n  /**\n   * Removes the stored item if there is an error in the request.\n   * By default, we don't remove the item upon failure, only the resolver\n   * is removed from the cache.\n   */\n  readonly removeOnError?: boolean\n\n  /**\n   * Determines if the result should be a fresh fetched\n   * instance regardless of any cached value or its expiration time.\n   */\n  readonly fresh?: boolean\n}\n\n/**\n * Determines the cache type.\n */\nexport type CacheType = 'resolvers' | 'items'\n\n/**\n * The mutation function type.\n */\nexport interface MutationFunction<T> {\n  (previous?: T, expiresAt?: Date): T | Promise<T>\n}\n\n/**\n * The available mutation values.\n */\nexport type MutationValue<T> = T | MutationFunction<T>\n\n/**\n * The function type for the event subscription.\n */\nexport interface SubscribeFunction {\n  (key: string, event: QueryEvent, listener: EventListener): Unsubscriber\n}\n\n/**\n * The broadcast payload.\n */\nexport interface BroadcastPayload {\n  /**\n   * The event name.\n   */\n  readonly event: string\n\n  /**\n   * The event detail.\n   */\n  readonly detail: unknown\n}\n\n/**\n * The function type for the broadcast subscription.\n */\nexport interface SubscribeBroadcastFunction {\n  (): Unsubscriber\n}\n\n/**\n * The query function type.\n */\nexport interface QueryFunction {\n  <T = unknown>(key: string, options?: Options<T>): Promise<T>\n}\n\nexport interface ExpirationFunction<T = unknown> {\n  (item: T): number\n}\n\nexport interface FetcherFunction<T = unknown> {\n  (key: string, additional: FetcherAdditional): Promise<T>\n}\n\n/**\n * The mutate function options.\n */\nexport interface HydrateOptions<T = unknown> {\n  expiration?: ExpirationFunction<T>\n}\n\n/**\n * The mutate function options.\n */\nexport interface MutateOptions<T = unknown> {\n  expiration?: ExpirationFunction<T>\n}\n\n/**\n * The mutate function type.\n */\nexport interface MutateFunction {\n  <T = unknown>(key: string, item: MutationValue<T>, options?: MutateOptions<T>): Promise<T>\n}\n\n/**\n * The hydrate function type.\n */\nexport interface HydrateFunction {\n  <T = unknown>(keys: string | string[], item: T, options?: HydrateOptions<T>): void\n}\n\n/**\n * The unsubscriber function.\n */\nexport type Unsubscriber = () => void\n\n/**\n * The caches available on the query.\n */\nexport interface Caches {\n  /**\n   * A cache that contains the resolved items alongside\n   * their expiration time.\n   */\n  readonly items: Cache<ItemsCacheItem>\n\n  /**\n   * A cache that contains the resolvers alongside\n   * their abort controllers.\n   */\n  readonly resolvers: Cache<ResolversCacheItem<unknown>>\n}\n\n/**\n * Represents the methods a query\n * should implement.\n */\nexport interface Query {\n  /**\n   * Configures the current instance of query.\n   */\n  readonly configure: (options?: Partial<Configuration>) => void\n\n  /**\n   * Fetches the key information using a fetcher.\n   * The returned promise contains the result item.\n   */\n  readonly query: QueryFunction\n\n  /**\n   * Subscribes to a given event & key. The event handler\n   * does have a payload parameter that will contain relevant\n   * information depending on the event type.\n   */\n  readonly subscribe: SubscribeFunction\n\n  /**\n   * Subscribes to the broadcast channel\n   * to listen for other browser context\n   * events and reproduce them in the current\n   * context.\n   */\n  readonly subscribeBroadcast: SubscribeBroadcastFunction\n\n  /**\n   * Mutates the key with a given optimistic value.\n   * The mutated value is considered expired and will be\n   * replaced immediatly if a refetch happens.\n   */\n  readonly mutate: MutateFunction\n\n  /**\n   * Aborts the active resolvers on each key\n   * by calling `.abort()` on the `AbortController`.\n   * The fetcher is responsible for using the\n   * `AbortSignal` to cancel the job.\n   */\n  readonly abort: (key?: string | string[], reason?: unknown) => void\n\n  /**\n   * Forgets the given keys from the cache.\n   * Removes items from both, the cache and resolvers.\n   */\n  readonly forget: (keys?: string | string[] | RegExp) => void\n\n  /**\n   * Hydrates the given keys on the cache\n   * with the given value and expiration time.\n   */\n  readonly hydrate: HydrateFunction\n\n  /**\n   * Returns the given keys for the given cache.\n   */\n  readonly keys: (cache?: CacheType) => string[]\n\n  /**\n   * Returns the expiration date of a given key item.\n   * If the item is not in the cache, it will return `undefined`.\n   */\n  readonly expiration: (key: string) => Date | undefined\n\n  /**\n   * Returns the current snapshot of the given key.\n   * If the item is not in the items cache, it will return `undefined`.\n   */\n  readonly snapshot: <T = unknown>(key: string) => T | undefined\n\n  /**\n   * Returns the current cache instances in use.\n   */\n  readonly caches: () => Caches\n\n  /**\n   * Returns the event system in use.\n   */\n  readonly events: () => EventTarget\n\n  /**\n   * Returns the broadcast channel in use.\n   */\n  readonly broadcast: () => BroadcastChannel | undefined\n}\n\n/**\n * Available events on query.\n */\nexport type QueryEvent =\n  | 'refetching'\n  | 'resolved'\n  | 'mutating'\n  | 'mutated'\n  | 'aborted'\n  | 'forgotten'\n  | 'hydrated'\n  | 'error'\n\n/**\n * Stores the default fetcher function.\n */\nexport function defaultFetcher<T>(\n  fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>\n): FetcherFunction<T> {\n  return async function (key: string, { signal }: FetcherAdditional): Promise<T> {\n    const response = await fetch(key, { signal })\n\n    if (!response.ok) {\n      throw new Error('Unable to fetch the data: ' + response.statusText)\n    }\n\n    return (await response.json()) as T\n  }\n}\n\n/**\n * Creates a new query instance.\n */\nexport function createQuery(instanceOptions?: Configuration): Query {\n  /**\n   * Stores the default expiration function.\n   */\n  function defaultExpiration() {\n    return 2000\n  }\n\n  /**\n   * Stores the items cache.\n   */\n  let itemsCache = instanceOptions?.itemsCache ?? new Map<string, ItemsCacheItem>()\n\n  /**\n   * Stores the resolvers cache.\n   */\n  let resolversCache =\n    instanceOptions?.resolversCache ?? new Map<string, ResolversCacheItem<unknown>>()\n\n  /**\n   * Event manager.\n   */\n  let events = instanceOptions?.events ?? new EventTarget()\n\n  /**\n   * Broadcast channel. This is useful for communicating\n   * between tabs and windows (browser contexts).\n   *\n   * By default it does not use any broadcast channel.\n   * If a broadcast channel is provided, query\n   * won't close automatically, therefore, the responsability\n   * of closing the broadcast channel is up to the user.\n   */\n  let broadcast = instanceOptions?.broadcast\n\n  /**\n   * Stores the expiration time of an item.\n   */\n  let instanceExpiration = instanceOptions?.expiration ?? defaultExpiration\n\n  /**\n   * Determines the fetcher function to use.\n   */\n  let instanceFetcher = instanceOptions?.fetcher ?? defaultFetcher(fetch)\n\n  /**\n   * Determines if we can return a stale item.\n   * If `true`, it will return the previous stale item\n   * stored in the cache if it has expired. It will attempt\n   * to revalidate it in the background. If `false`, the returned\n   * promise will be the revalidation promise.\n   */\n  let instanceStale = instanceOptions?.stale ?? true\n\n  /**\n   * Removes the stored item if there is an error in the request.\n   * By default, we don't remove the item upon failure, only the resolver\n   * is removed from the cache.\n   */\n  let instanceRemoveOnError = instanceOptions?.removeOnError ?? false\n\n  /**\n   * Determines if the result should be a fresh fetched\n   * instance regardless of any cached value or its expiration time.\n   */\n  let instanceFresh = instanceOptions?.fresh ?? false\n\n  /**\n   * Configures the current instance of query.\n   */\n  function configure(options?: Configuration): void {\n    itemsCache = options?.itemsCache ?? itemsCache\n    resolversCache = options?.resolversCache ?? resolversCache\n    events = options?.events ?? events\n    broadcast = options?.broadcast ?? broadcast\n    instanceExpiration = options?.expiration ?? instanceExpiration\n    instanceFetcher = options?.fetcher ?? instanceFetcher\n    instanceStale = options?.stale ?? instanceStale\n    instanceRemoveOnError = options?.removeOnError ?? instanceRemoveOnError\n    instanceFresh = options?.fresh ?? instanceFresh\n  }\n\n  /**\n   * Subscribes to a given keyed event. The event handler\n   * does have a payload parameter that will contain relevant\n   * information depending on the event type.\n   * If there's a pending resolver for that key, the `refetching`\n   * event is fired immediatly.\n   */\n  function subscribe(key: string, event: QueryEvent, listener: EventListener): Unsubscriber {\n    events.addEventListener(`${event}:${key}`, listener)\n    const value = resolversCache.get(key)\n\n    // For the refetching event, we want to immediatly return if there's\n    // a pending resolver.\n    if (event === 'refetching' && value !== undefined) {\n      listener(new CustomEvent(`${event}:${key}`, { detail: value.item }))\n    }\n\n    return function () {\n      events.removeEventListener(`${event}:${key}`, listener)\n    }\n  }\n\n  /**\n   * Mutates the key with a given optimistic value.\n   * The mutated value is considered expired and will be\n   * replaced immediatly if a refetch happens when expired\n   * is true. If expired is false, the value expiration time\n   * is added as if it was a valid data refetched. Alternatively\n   * you can provide a Date to decide when the expiration happens.\n   */\n  async function mutate<T = unknown>(\n    key: string,\n    resolver: MutationValue<T>,\n    options?: MutateOptions<T>\n  ): Promise<T> {\n    async function action(resolver: MutationValue<T>) {\n      if (typeof resolver === 'function') {\n        const fn = resolver as MutationFunction<T>\n        const value = itemsCache.get(key)\n\n        resolver = await fn(value?.item as T, value?.expiresAt)\n      }\n\n      const expiresAt = new Date()\n\n      expiresAt.setMilliseconds(\n        expiresAt.getMilliseconds() + (options?.expiration?.(resolver) ?? 0)\n      )\n\n      itemsCache.set(key, { item: resolver, expiresAt: expiresAt })\n\n      return resolver\n    }\n\n    const result = action(resolver)\n\n    events.dispatchEvent(new CustomEvent(`mutating:${key}`, { detail: result }))\n\n    const item = await result\n\n    events.dispatchEvent(new CustomEvent(`mutated:${key}`, { detail: item }))\n    broadcast?.postMessage({ event: `mutated:${key}`, detail: item })\n\n    return item\n  }\n\n  /**\n   * Returns the current snapshot of the given key.\n   * If the item is not in the items cache, it will return `undefined`.\n   */\n  function snapshot<T = unknown>(key: string): T | undefined {\n    return itemsCache.get(key)?.item as T\n  }\n\n  /**\n   * Determines if the given key is currently resolving.\n   */\n  function keys(type: CacheType = 'items'): string[] {\n    return Array.from(type === 'items' ? itemsCache.keys() : resolversCache.keys())\n  }\n\n  /**\n   * Aborts the active resolvers on each key\n   * by calling `.abort()` on the `AbortController`.\n   * The fetcher is responsible for using the\n   * `AbortSignal` to cancel the job.\n   * If no keys are provided, all resolvers are aborted.\n   */\n  function abort(cacheKeys?: string | string[], reason?: unknown): void {\n    const resolverKeys =\n      typeof cacheKeys === 'string' ? [cacheKeys] : (cacheKeys ?? keys('resolvers'))\n\n    for (const key of resolverKeys) {\n      const resolver = resolversCache.get(key)\n\n      if (resolver !== undefined) {\n        resolver.controller.abort(reason)\n        resolversCache.delete(key)\n\n        events.dispatchEvent(new CustomEvent(`aborted:${key}`, { detail: reason }))\n        broadcast?.postMessage({ event: `aborted:${key}`, detail: reason })\n      }\n    }\n  }\n\n  /**\n   * Forgets the given keys from the items cache.\n   * Does not remove any resolvers.\n   * If no keys are provided the items cache is cleared.\n   */\n  function forget(cacheKeys?: string | string[] | RegExp): void {\n    let itemKeys: string[]\n\n    if (typeof cacheKeys === 'string') {\n      itemKeys = [cacheKeys]\n    } else if (Array.isArray(cacheKeys)) {\n      itemKeys = cacheKeys\n    } else if (cacheKeys instanceof RegExp) {\n      itemKeys = keys('items').filter((key) => key.match(cacheKeys))\n    } else {\n      itemKeys = keys('items')\n    }\n\n    for (const key of itemKeys) {\n      const item = itemsCache.get(key)\n\n      if (item !== undefined) {\n        itemsCache.delete(key)\n        events.dispatchEvent(new CustomEvent(`forgotten:${key}`, { detail: item.item }))\n        broadcast?.postMessage({ event: `forgotten:${key}`, detail: item.item })\n      }\n    }\n  }\n\n  /**\n   * Hydrates the given keys on the cache\n   * with the given value. Hydrate should only\n   * be used when you want to populate the cache.\n   * Please use mutate() in most cases unless you\n   * know what you are doing.\n   */\n  function hydrate<T = unknown>(\n    keys: string | string[],\n    item: T,\n    options?: HydrateOptions<T>\n  ): void {\n    const expiresAt = new Date()\n    expiresAt.setMilliseconds(expiresAt.getMilliseconds() + (options?.expiration?.(item) ?? 0))\n\n    for (const key of typeof keys === 'string' ? [keys] : keys) {\n      itemsCache.set(key, { item, expiresAt: expiresAt })\n      events.dispatchEvent(new CustomEvent(`hydrated:${key}`, { detail: item }))\n      broadcast?.postMessage({ event: `hydrated:${key}`, detail: item })\n    }\n  }\n\n  /**\n   * Returns the expiration date of a given key item.\n   * If the item is not in the cache, it will return `undefined`.\n   */\n  function expiration(key: string): Date | undefined {\n    return itemsCache.get(key)?.expiresAt\n  }\n\n  /**\n   * Fetches the key information using a fetcher.\n   * The returned promise contains the result item.\n   */\n  async function query<T = unknown>(key: string, options?: Options<T>): Promise<T> {\n    /**\n     * Stores the expiration time of an item.\n     */\n    const expiration = options?.expiration ?? instanceExpiration\n\n    /**\n     * Determines the fetcher function to use.\n     */\n    const fetcher = (options?.fetcher ?? instanceFetcher) as FetcherFunction<T>\n\n    /**\n     * Determines if we can return a sale item\n     * If true, it will return the previous stale item\n     * stored in the cache if it has expired. It will attempt\n     * to revalidate it in the background. If false, the returned\n     * promise will be the revalidation promise.\n     */\n    const stale = options?.stale ?? instanceStale\n\n    /**\n     * Removes the stored item if there is an error in the request.\n     * By default, we don't remove the item upon failure, only the resolver\n     * is removed from the cache.\n     */\n    const removeOnError = options?.removeOnError ?? instanceRemoveOnError\n\n    /**\n     * Determines if the result should be a fresh fetched\n     * instance regardless of any cached value or its expiration time.\n     */\n    const fresh = options?.fresh ?? instanceOptions?.fresh\n\n    // Force fetching of the data.\n    async function refetch(key: string): Promise<T> {\n      try {\n        // Check if there's a pending resolver for that data.\n        const pending = resolversCache.get(key)\n\n        if (pending !== undefined) {\n          return await (pending.item as Promise<T>)\n        }\n\n        // Create the abort controller that will be\n        // called when a query is aborted.\n        const controller = new AbortController()\n\n        // Initiate the fetching request.\n        async function action() {\n          const result = fetcher(key, { signal: controller.signal })\n\n          // Awaits the fetching to get the result item.\n          const item = await result\n\n          // Removes the resolver from the cache.\n          resolversCache.delete(key)\n\n          // Create the expiration time for the item.\n          const expiresAt = new Date()\n          expiresAt.setMilliseconds(expiresAt.getMilliseconds() + expiration(item))\n\n          // Set the item to the cache.\n          itemsCache.set(key, { item, expiresAt })\n\n          return item\n        }\n\n        const result = action()\n\n        // Adds the resolver to the cache.\n        resolversCache.set(key, { item: result, controller })\n        events.dispatchEvent(new CustomEvent(`refetching:${key}`, { detail: result }))\n\n        const item = await result\n\n        // Notify of the resolved item.\n        events.dispatchEvent(new CustomEvent(`resolved:${key}`, { detail: item }))\n        broadcast?.postMessage({ event: `resolved:${key}`, detail: item })\n\n        // Return back the item.\n        return item\n      } catch (error) {\n        // Remove the resolver.\n        resolversCache.delete(key)\n\n        // Check if the item should be removed as well.\n        if (removeOnError) {\n          itemsCache.delete(key)\n        }\n\n        // Notify of the error.\n        events.dispatchEvent(new CustomEvent(`error:${key}`, { detail: error }))\n        broadcast?.postMessage({ event: `error:${key}`, detail: error })\n\n        // Throw back the error.\n        throw error\n      }\n    }\n\n    // We want to force a fresh item ignoring any current cached\n    // value or its expiration time.\n    if (fresh) {\n      return await refetch(key)\n    }\n\n    // Check if there's an item in the cache for the given key.\n    const cached = itemsCache.get(key)\n\n    if (cached !== undefined) {\n      // We must check if that item has actually expired.\n      // to trigger a revalidation if needed.\n      const hasExpired = cached.expiresAt <= new Date()\n\n      // The item has expired and the fetch is able\n      // to return a stale item while revalidating\n      // in the background.\n      if (hasExpired && stale) {\n        // We have to silence the error to avoid unhandled promises.\n        // Refer to the error event if you need full controll of errors.\n        refetch(key).catch(() => {})\n\n        return cached.item as T\n      }\n\n      // The item has expired but we dont allow stale\n      // responses so we need to wait for the revalidation.\n      if (hasExpired) {\n        return await refetch(key)\n      }\n\n      // The item has not yet expired, so we can return it and\n      // assume it's valid since it's not yet considered stale.\n      return cached.item as T\n    }\n\n    // The item is not found in the items cache.\n    // We need to perform a revalidation of the item.\n    return await refetch(key)\n  }\n\n  /**\n   * Returns the current cache instances.\n   */\n  function caches(): Caches {\n    return { items: itemsCache, resolvers: resolversCache }\n  }\n\n  /**\n   * Returns the event system.\n   */\n  function localEvents() {\n    return events\n  }\n\n  /**\n   * Returns the broadcast channel.\n   */\n  function localBroadcast() {\n    return broadcast\n  }\n\n  /**\n   * Subscribes to the broadcast channel\n   * to listen for other browser context\n   * events and reproduce them in the current\n   * context.\n   */\n  function subscribeBroadcast(): Unsubscriber {\n    function onBroadcastMessage(message: MessageEvent<BroadcastPayload>) {\n      events.dispatchEvent(new CustomEvent(message.data.event, { detail: message.data.detail }))\n    }\n\n    broadcast?.addEventListener('message', onBroadcastMessage)\n\n    return function () {\n      broadcast?.removeEventListener('message', onBroadcastMessage)\n    }\n  }\n\n  return {\n    query,\n    subscribe,\n    subscribeBroadcast,\n    mutate,\n    configure,\n    abort,\n    forget,\n    keys,\n    expiration,\n    hydrate,\n    snapshot,\n    caches,\n    events: localEvents,\n    broadcast: localBroadcast,\n  }\n}\n"],"names":["defaultFetcher","fetch","key","signal","response","createQuery","instanceOptions","defaultExpiration","itemsCache","resolversCache","events","broadcast","instanceExpiration","instanceFetcher","instanceStale","instanceRemoveOnError","instanceFresh","configure","options","subscribe","event","listener","value","mutate","resolver","action","_a","fn","expiresAt","result","item","snapshot","keys","type","abort","cacheKeys","reason","resolverKeys","forget","itemKeys","hydrate","expiration","query","fetcher","stale","removeOnError","fresh","refetch","pending","controller","error","cached","hasExpired","caches","localEvents","localBroadcast","subscribeBroadcast","onBroadcastMessage","message"],"mappings":"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"}

package/dist/query_react.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("react"),V=require("react/jsx-runtime"),Z=require("./query.cjs"),P=n.createContext({query:void 0,additional:void 0});function F(){return n.useDebugValue("useQueryContext"),n.use(P)}function h(e){n.useDebugValue("useQueryInstance");const t=F();function u(){const r=(e==null?void 0:e.query)??t.query;if(!r)throw new Error("No query instance was found. Please provide one via the resource options or the query context.");return r}return n.useMemo(u,[e,t])}const I=n.createContext({isPending:void 0,startTransition:void 0});function A(){return n.useDebugValue("useQueryTransitionContext"),n.use(I)}function O(e,t){n.useDebugValue("useQueryActions");const{query:u,mutate:r,forget:o}=h(t);function s(x){return u(e,{stale:!1,...t,...x})}const i=n.useCallback(s,[u,e,t]);function l(x,m){return r(e,x,m)}const d=n.useCallback(l,[r,e]);function c(){o(e)}const g=n.useCallback(c,[o,e]);function b(){return{refetch:i,mutate:d,forget:g}}return n.useMemo(b,[i,d,g])}function j(e){n.useDebugValue("useQueryStatus");const{expiration:t,subscribe:u}=h(),[r,o]=n.useState(t(e)??new Date),[s,i]=n.useState(Date.now()>r.getTime()),[l,d]=n.useState(!1),[c,g]=n.useState(!1);function b(){if(Date.now()>=r.getTime()){i(!0);return}i(!1);function m(){i(!0)}const C=setTimeout(m,r.getTime()-Date.now());return function(){clearTimeout(C)}}n.useEffect(b,[r]);function x(){function m(){g(!0)}function C(){g(!1),o(t(e)??new Date)}function a(){o(t(e)??new Date)}function w(){o(t(e)??new Date),d(!1)}function Q(){o(t(e)??new Date)}function q(){d(!0)}function D(){d(!1),g(!1)}const M=u(e,"mutating",m),T=u(e,"mutated",C),v=u(e,"hydrated",a),R=u(e,"resolved",w),H=u(e,"forgotten",Q),y=u(e,"refetching",q),E=u(e,"error",D);return function(){M(),T(),v(),R(),H(),y(),E()}}return n.useEffect(x,[e,u,t,o]),{expiresAt:r,isExpired:s,isRefetching:l,isMutating:c}}function _(e,t){n.useDebugValue("useQuery");const{additional:u}=F(),{isPending:r,startTransition:o}=A(),[s,i]=n.useTransition(),{query:l,expiration:d,subscribe:c}=h(t);function g(){return(t==null?void 0:t.ignoreTransitionContext)??(u==null?void 0:u.ignoreTransitionContext)??!1}const b=n.useMemo(g,[t,u]);function x(){return b?s:r??s}const m=n.useMemo(x,[r,s,b]);function C(){return b?i:o??i}const a=n.useMemo(C,[o,i,b]);function w(){return(t==null?void 0:t.clearOnForget)??(u==null?void 0:u.clearOnForget)??!1}const Q=n.useMemo(w,[t,u]);async function q(){return await l(e,t)}const D=n.useMemo(q,[l,e,t]),M=n.useRef(void 0);M.current===void 0&&(M.current=n.use(D));const[T,v]=n.useState(M.current);function R(){function B(f){a(function(){v(f.detail)})}function L(f){a(async function(){const S=await f.detail;a(function(){v(S)})})}function N(f){a(function(){v(f.detail)})}function $(f){a(function(){v(f.detail)})}function z(f){a(async function(){const S=await f.detail;a(function(){v(S)})})}function G(){Q&&a(async function(){const f=await l(e,t);a(function(){v(f)})})}const J=c(e,"resolved",B),K=c(e,"mutating",L),U=c(e,"mutated",N),W=c(e,"hydrated",$),X=c(e,"refetching",z),Y=c(e,"forgotten",G);return function(){J(),K(),U(),W(),X(),Y()}}n.useEffect(R,[l,d,c,e,Q,t,a]);const H=O(e,t),y=j(e);function E(){return{data:T,isPending:m,...H,...y}}return n.useMemo(E,[T,m,H,y])}function p({children:e,clearOnForget:t,broadcast:u,...r}){function o(){return Z.createQuery({broadcast:u,...r})}const[s]=n.useState(o);function i(){s.configure(r)}n.useEffect(i,[s,r]);function l(){if(u){s.configure({broadcast:u});const C=s.subscribeBroadcast();return function(){C()}}const x=new BroadcastChannel("query");s.configure({broadcast:x});const m=s.subscribeBroadcast();return function(){m(),x.close()}}n.useEffect(l,[s,u]);function d(){return{clearOnForget:t}}const c=n.useMemo(d,[t]);function g(){return{query:s,additional:c}}const b=n.useMemo(g,[s,c]);return V.jsx(P,{value:b,children:e})}function k({children:e,startTransition:t,isPending:u}){function r(){return{startTransition:t,isPending:u}}const o=n.useMemo(r,[t,u]);return V.jsx(I,{value:o,children:e})}exports.Context=P;exports.QueryProvider=p;exports.QueryTransition=k;exports.TransitionContext=I;exports.useQuery=_;exports.useQueryActions=O;exports.useQueryContext=F;exports.useQueryInstance=h;exports.useQueryStatus=j;exports.useQueryTransitionContext=A;
+//# sourceMappingURL=query_react.cjs.map

package/dist/query_react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_react.cjs","sources":["../src/react/context.ts","../src/react/hooks/useQueryContext.ts","../src/react/hooks/useQueryInstance.ts","../src/react/transition.ts","../src/react/hooks/useQueryTransitionContext.ts","../src/react/hooks/useQueryActions.ts","../src/react/hooks/useQueryStatus.ts","../src/react/hooks/useQuery.ts","../src/react/components/QueryProvider.tsx","../src/react/components/QueryTransition.tsx"],"sourcesContent":["import { createContext } from 'react'\nimport { Query } from 'query:index'\n\nexport interface ContextOptions {\n  readonly clearOnForget?: boolean\n  readonly ignoreTransitionContext?: boolean\n}\n\nexport interface ContextValue {\n  readonly query?: Query\n  readonly additional?: ContextOptions\n}\n\nexport const Context = createContext<ContextValue>({\n  query: undefined,\n  additional: undefined,\n})\n","import { Context, type ContextValue } from 'query/react:context'\nimport { use, useDebugValue } from 'react'\n\nexport function useQueryContext(): ContextValue {\n  useDebugValue('useQueryContext')\n\n  return use(Context)\n}\n","import { type Query } from 'query:index'\nimport { useQueryContext } from 'query/react:hooks/useQueryContext'\nimport { useDebugValue, useMemo } from 'react'\n\nexport interface QueryInstance {\n  readonly query?: Query\n}\n\nexport function useQueryInstance(options?: QueryInstance): Query {\n  useDebugValue('useQueryInstance')\n\n  const contextOptions = useQueryContext()\n\n  function query() {\n    const instance = options?.query ?? contextOptions.query\n\n    if (!instance) {\n      throw new Error(\n        'No query instance was found. Please provide one via the resource options or the query context.'\n      )\n    }\n\n    return instance\n  }\n\n  return useMemo(query, [options, contextOptions])\n}\n","import { createContext, type TransitionStartFunction } from 'react'\n\nexport interface QueryTransitionContextValue {\n  readonly isPending?: boolean\n  readonly startTransition?: TransitionStartFunction\n}\n\nexport const TransitionContext = createContext<QueryTransitionContextValue>({\n  isPending: undefined,\n  startTransition: undefined,\n})\n","import { TransitionContext, type QueryTransitionContextValue } from 'query/react:transition'\nimport { use, useDebugValue } from 'react'\n\nexport function useQueryTransitionContext(): QueryTransitionContextValue {\n  useDebugValue('useQueryTransitionContext')\n\n  return use(TransitionContext)\n}\n","import { MutateOptions, MutationValue, Options } from 'query:index'\nimport { useCallback, useDebugValue, useMemo } from 'react'\nimport { QueryInstance, useQueryInstance } from './useQueryInstance'\n\nexport interface QueryActions<T = unknown> {\n  readonly refetch: (refetchOptions?: Options<T>) => Promise<T>\n  readonly mutate: (value: MutationValue<T>, options?: MutateOptions<T>) => Promise<T>\n  readonly forget: () => void\n}\n\nexport type QueryActionsOptions<T = unknown> = Options<T> & QueryInstance\n\nexport function useQueryActions<T = unknown>(\n  key: string,\n  options?: QueryActionsOptions<T>\n): QueryActions<T> {\n  useDebugValue('useQueryActions')\n\n  const { query, mutate, forget } = useQueryInstance(options)\n\n  function refetchHandler(refetchOptions?: Options<T>) {\n    return query<T>(key, {\n      stale: false,\n      ...options,\n      ...refetchOptions,\n    })\n  }\n\n  const refetch = useCallback(refetchHandler, [query, key, options])\n\n  function mutateHandler<T = unknown>(value: MutationValue<T>, options?: MutateOptions<T>) {\n    return mutate(key, value, options)\n  }\n\n  const localMutate = useCallback(mutateHandler, [mutate, key])\n\n  function forgetHandler() {\n    forget(key)\n  }\n\n  const localForget = useCallback(forgetHandler, [forget, key])\n\n  function actionsHandler() {\n    return { refetch, mutate: localMutate, forget: localForget }\n  }\n\n  return useMemo(actionsHandler, [refetch, localMutate, localForget])\n}\n","import { useDebugValue, useEffect, useState } from 'react'\nimport { useQueryInstance } from './useQueryInstance'\n\nexport interface Status {\n  readonly expiresAt: Date\n  readonly isExpired: boolean\n  readonly isRefetching: boolean\n  readonly isMutating: boolean\n}\n\nexport function useQueryStatus(key: string): Status {\n  useDebugValue('useQueryStatus')\n\n  const { expiration, subscribe } = useQueryInstance()\n  const [expiresAt, setExpiresAt] = useState<Date>(expiration(key) ?? new Date())\n  const [isExpired, setIsExpired] = useState(Date.now() > expiresAt.getTime())\n  const [isRefetching, setIsRefetching] = useState(false)\n  const [isMutating, setIsMutating] = useState(false)\n\n  function expirationHandler() {\n    if (Date.now() >= expiresAt.getTime()) {\n      setIsExpired(true)\n      return\n    }\n\n    setIsExpired(false)\n\n    function handler() {\n      setIsExpired(true)\n    }\n\n    const id = setTimeout(handler, expiresAt.getTime() - Date.now())\n\n    return function () {\n      clearTimeout(id)\n    }\n  }\n\n  useEffect(expirationHandler, [expiresAt])\n\n  function subscribeHandler() {\n    function onMutating() {\n      setIsMutating(true)\n    }\n\n    function onMutated() {\n      setIsMutating(false)\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onHydrated() {\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onResolved() {\n      setExpiresAt(expiration(key) ?? new Date())\n      setIsRefetching(false)\n    }\n\n    function onForgotten() {\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onRefetching() {\n      setIsRefetching(true)\n    }\n\n    function onError() {\n      setIsRefetching(false)\n      setIsMutating(false)\n    }\n\n    const unsubscribeMutating = subscribe(key, 'mutating', onMutating)\n    const unsubscribeMutated = subscribe(key, 'mutated', onMutated)\n    const unsubscribeHydrated = subscribe(key, 'hydrated', onHydrated)\n    const unsubscribeResolved = subscribe(key, 'resolved', onResolved)\n    const unsubscribeForgotten = subscribe(key, 'forgotten', onForgotten)\n    const unsubscribeRefetching = subscribe(key, 'refetching', onRefetching)\n    const unsubscribeError = subscribe(key, 'error', onError)\n\n    return function () {\n      unsubscribeMutating()\n      unsubscribeMutated()\n      unsubscribeHydrated()\n      unsubscribeResolved()\n      unsubscribeForgotten()\n      unsubscribeRefetching()\n      unsubscribeError()\n    }\n  }\n\n  useEffect(subscribeHandler, [key, subscribe, expiration, setExpiresAt])\n\n  return { expiresAt, isExpired, isRefetching, isMutating }\n}\n","import { useEffect, use, useState, useMemo, useDebugValue, useTransition, useRef } from 'react'\nimport { ContextOptions as ContextOptions } from 'query/react:context'\nimport { Options } from 'query:index'\nimport { useQueryContext } from './useQueryContext'\nimport { QueryInstance, useQueryInstance } from './useQueryInstance'\nimport { useQueryTransitionContext } from './useQueryTransitionContext'\nimport { QueryActions, useQueryActions } from './useQueryActions'\nimport { useQueryStatus, type Status } from './useQueryStatus'\n\ntype AdditionalHooks<T> = QueryActions<T> & Status\n\nexport interface Resource<T = unknown> extends AdditionalHooks<T> {\n  data: T\n  isPending: boolean\n}\n\nexport type ResourceOptions<T = unknown> = ContextOptions & Options<T> & QueryInstance\n\nexport function useQuery<T = unknown>(key: string, options?: ResourceOptions<T>): Resource<T> {\n  useDebugValue('useQuery')\n\n  const { additional } = useQueryContext()\n\n  const { isPending: isContextPending, startTransition: startContextTransition } =\n    useQueryTransitionContext()\n\n  const [isLocalPending, startLocalTransition] = useTransition()\n  const { query, expiration, subscribe } = useQueryInstance(options)\n\n  function ignoreTransitionContextHandler() {\n    return options?.ignoreTransitionContext ?? additional?.ignoreTransitionContext ?? false\n  }\n\n  const ignoreTransitionContext = useMemo(ignoreTransitionContextHandler, [options, additional])\n\n  function isPendingHandler() {\n    if (ignoreTransitionContext) {\n      return isLocalPending\n    }\n\n    return isContextPending ?? isLocalPending\n  }\n\n  const isPending = useMemo(isPendingHandler, [\n    isContextPending,\n    isLocalPending,\n    ignoreTransitionContext,\n  ])\n\n  function startTransitionHandler() {\n    if (ignoreTransitionContext) {\n      return startLocalTransition\n    }\n\n    return startContextTransition ?? startLocalTransition\n  }\n\n  const startTransition = useMemo(startTransitionHandler, [\n    startContextTransition,\n    startLocalTransition,\n    ignoreTransitionContext,\n  ])\n\n  function clearOnForgetHandler() {\n    return options?.clearOnForget ?? additional?.clearOnForget ?? false\n  }\n\n  const clearOnForget = useMemo(clearOnForgetHandler, [options, additional])\n\n  async function promiseHandler() {\n    return await query<T>(key, options)\n  }\n\n  const promise = useMemo(promiseHandler, [query, key, options])\n  const initial = useRef<T>(undefined)\n\n  if (initial.current === undefined) {\n    initial.current = use(promise)\n  }\n\n  const [data, setData] = useState(initial.current)\n\n  function subscribeHandler() {\n    function onResolved(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onMutating(event: Event) {\n      startTransition(async function () {\n        const value = await (event as CustomEvent<Promise<T>>).detail\n\n        startTransition(function () {\n          setData(value)\n        })\n      })\n    }\n\n    function onMutated(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onHydrated(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onRefetching(event: Event) {\n      startTransition(async function () {\n        const value = await (event as CustomEvent<Promise<T>>).detail\n\n        startTransition(function () {\n          setData(value)\n        })\n      })\n    }\n\n    function onForgotten() {\n      if (clearOnForget) {\n        startTransition(async function () {\n          const data = await query<T>(key, options)\n\n          startTransition(function () {\n            setData(data)\n          })\n        })\n      }\n    }\n\n    const unsubscribeResolved = subscribe(key, 'resolved', onResolved)\n    const unsubscribeMutating = subscribe(key, 'mutating', onMutating)\n    const unsubscribeMutated = subscribe(key, 'mutated', onMutated)\n    const unsubscribeHydrated = subscribe(key, 'hydrated', onHydrated)\n    const unsubscribeRefetching = subscribe(key, 'refetching', onRefetching)\n    const unsubscribeForgotten = subscribe(key, 'forgotten', onForgotten)\n\n    return function () {\n      unsubscribeResolved()\n      unsubscribeMutating()\n      unsubscribeMutated()\n      unsubscribeHydrated()\n      unsubscribeRefetching()\n      unsubscribeForgotten()\n    }\n  }\n\n  useEffect(subscribeHandler, [\n    query,\n    expiration,\n    subscribe,\n    key,\n    clearOnForget,\n    options,\n    startTransition,\n  ])\n\n  const actions = useQueryActions<T>(key, options)\n  const status = useQueryStatus(key)\n\n  function resourceHandler(): Resource<T> {\n    return { data, isPending, ...actions, ...status }\n  }\n\n  return useMemo(resourceHandler, [data, isPending, actions, status])\n}\n","import { useEffect, useMemo, useState, type ReactNode } from 'react'\nimport { Context, ContextValue, type ContextOptions } from 'query/react:context'\nimport { createQuery, Query, type Configuration } from 'query:index'\n\ntype OtherProps = Configuration & ContextOptions\n\nexport interface QueryProviderProps extends OtherProps {\n  children?: ReactNode\n}\n\nexport function QueryProvider({\n  children,\n  clearOnForget,\n  broadcast,\n  ...options\n}: QueryProviderProps) {\n  function initial() {\n    return createQuery({ broadcast, ...options })\n  }\n\n  const [query] = useState<Query>(initial)\n\n  function reconfigure() {\n    query.configure(options)\n  }\n\n  useEffect(reconfigure, [query, options])\n\n  function broadcastCleanup() {\n    if (broadcast) {\n      query.configure({ broadcast })\n      const unsubscribe = query.subscribeBroadcast()\n\n      return function () {\n        unsubscribe()\n      }\n    }\n\n    const channel = new BroadcastChannel('query')\n\n    query.configure({ broadcast: channel })\n    const unsubscribe = query.subscribeBroadcast()\n\n    return function () {\n      unsubscribe()\n      channel.close()\n    }\n  }\n\n  useEffect(broadcastCleanup, [query, broadcast])\n\n  function additionalHandler() {\n    return { clearOnForget }\n  }\n\n  const additional = useMemo(additionalHandler, [clearOnForget])\n\n  function valueHandler(): ContextValue {\n    return { query, additional }\n  }\n\n  const value = useMemo(valueHandler, [query, additional])\n\n  return <Context value={value}>{children}</Context>\n}\n","import { TransitionContext, QueryTransitionContextValue } from 'query/react:transition'\nimport { useMemo, type ReactNode, type TransitionStartFunction } from 'react'\n\nexport interface QueryTransitionProps {\n  isPending: boolean\n  startTransition: TransitionStartFunction\n  children?: ReactNode\n}\n\nexport function QueryTransition({ children, startTransition, isPending }: QueryTransitionProps) {\n  function valueHandler(): QueryTransitionContextValue {\n    return { startTransition, isPending }\n  }\n\n  const value = useMemo(valueHandler, [startTransition, isPending])\n\n  return <TransitionContext value={value}>{children}</TransitionContext>\n}\n"],"names":["Context","createContext","useQueryContext","useDebugValue","use","useQueryInstance","options","contextOptions","query","instance","useMemo","TransitionContext","useQueryTransitionContext","useQueryActions","key","mutate","forget","refetchHandler","refetchOptions","refetch","useCallback","mutateHandler","value","localMutate","forgetHandler","localForget","actionsHandler","useQueryStatus","expiration","subscribe","expiresAt","setExpiresAt","useState","isExpired","setIsExpired","isRefetching","setIsRefetching","isMutating","setIsMutating","expirationHandler","handler","id","useEffect","subscribeHandler","onMutating","onMutated","onHydrated","onResolved","onForgotten","onRefetching","onError","unsubscribeMutating","unsubscribeMutated","unsubscribeHydrated","unsubscribeResolved","unsubscribeForgotten","unsubscribeRefetching","unsubscribeError","useQuery","additional","isContextPending","startContextTransition","isLocalPending","startLocalTransition","useTransition","ignoreTransitionContextHandler","ignoreTransitionContext","isPendingHandler","isPending","startTransitionHandler","startTransition","clearOnForgetHandler","clearOnForget","promiseHandler","promise","initial","useRef","data","setData","event","actions","status","resourceHandler","QueryProvider","children","broadcast","createQuery","reconfigure","broadcastCleanup","unsubscribe","channel","additionalHandler","valueHandler","jsx","QueryTransition"],"mappings":"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"}

package/dist/query_react.js

@@ -0,0 +1,254 @@
+import { createContext as S, useDebugValue as h, use as O, useMemo as f, useCallback as A, useState as T, useEffect as C, useTransition as k, useRef as nn } from "react";
+import { jsx as L } from "react/jsx-runtime";
+import { createQuery as tn } from "./query.js";
+const j = S({
+  query: void 0,
+  additional: void 0
+});
+function N() {
+  return h("useQueryContext"), O(j);
+}
+function B(n) {
+  h("useQueryInstance");
+  const t = N();
+  function e() {
+    const r = (n == null ? void 0 : n.query) ?? t.query;
+    if (!r)
+      throw new Error(
+        "No query instance was found. Please provide one via the resource options or the query context."
+      );
+    return r;
+  }
+  return f(e, [n, t]);
+}
+const V = S({
+  isPending: void 0,
+  startTransition: void 0
+});
+function en() {
+  return h("useQueryTransitionContext"), O(V);
+}
+function rn(n, t) {
+  h("useQueryActions");
+  const { query: e, mutate: r, forget: o } = B(t);
+  function u(x) {
+    return e(n, {
+      stale: !1,
+      ...t,
+      ...x
+    });
+  }
+  const i = A(u, [e, n, t]);
+  function d(x, m) {
+    return r(n, x, m);
+  }
+  const l = A(d, [r, n]);
+  function c() {
+    o(n);
+  }
+  const g = A(c, [o, n]);
+  function b() {
+    return { refetch: i, mutate: l, forget: g };
+  }
+  return f(b, [i, l, g]);
+}
+function un(n) {
+  h("useQueryStatus");
+  const { expiration: t, subscribe: e } = B(), [r, o] = T(t(n) ?? /* @__PURE__ */ new Date()), [u, i] = T(Date.now() > r.getTime()), [d, l] = T(!1), [c, g] = T(!1);
+  function b() {
+    if (Date.now() >= r.getTime()) {
+      i(!0);
+      return;
+    }
+    i(!1);
+    function m() {
+      i(!0);
+    }
+    const H = setTimeout(m, r.getTime() - Date.now());
+    return function() {
+      clearTimeout(H);
+    };
+  }
+  C(b, [r]);
+  function x() {
+    function m() {
+      g(!0);
+    }
+    function H() {
+      g(!1), o(t(n) ?? /* @__PURE__ */ new Date());
+    }
+    function s() {
+      o(t(n) ?? /* @__PURE__ */ new Date());
+    }
+    function D() {
+      o(t(n) ?? /* @__PURE__ */ new Date()), l(!1);
+    }
+    function Q() {
+      o(t(n) ?? /* @__PURE__ */ new Date());
+    }
+    function F() {
+      l(!0);
+    }
+    function y() {
+      l(!1), g(!1);
+    }
+    const w = e(n, "mutating", m), M = e(n, "mutated", H), v = e(n, "hydrated", s), E = e(n, "resolved", D), R = e(n, "forgotten", Q), q = e(n, "refetching", F), P = e(n, "error", y);
+    return function() {
+      w(), M(), v(), E(), R(), q(), P();
+    };
+  }
+  return C(x, [n, e, t, o]), { expiresAt: r, isExpired: u, isRefetching: d, isMutating: c };
+}
+function an(n, t) {
+  h("useQuery");
+  const { additional: e } = N(), { isPending: r, startTransition: o } = en(), [u, i] = k(), { query: d, expiration: l, subscribe: c } = B(t);
+  function g() {
+    return (t == null ? void 0 : t.ignoreTransitionContext) ?? (e == null ? void 0 : e.ignoreTransitionContext) ?? !1;
+  }
+  const b = f(g, [t, e]);
+  function x() {
+    return b ? u : r ?? u;
+  }
+  const m = f(x, [
+    r,
+    u,
+    b
+  ]);
+  function H() {
+    return b ? i : o ?? i;
+  }
+  const s = f(H, [
+    o,
+    i,
+    b
+  ]);
+  function D() {
+    return (t == null ? void 0 : t.clearOnForget) ?? (e == null ? void 0 : e.clearOnForget) ?? !1;
+  }
+  const Q = f(D, [t, e]);
+  async function F() {
+    return await d(n, t);
+  }
+  const y = f(F, [d, n, t]), w = nn(void 0);
+  w.current === void 0 && (w.current = O(y));
+  const [M, v] = T(w.current);
+  function E() {
+    function z(a) {
+      s(function() {
+        v(a.detail);
+      });
+    }
+    function G(a) {
+      s(async function() {
+        const I = await a.detail;
+        s(function() {
+          v(I);
+        });
+      });
+    }
+    function J(a) {
+      s(function() {
+        v(a.detail);
+      });
+    }
+    function K(a) {
+      s(function() {
+        v(a.detail);
+      });
+    }
+    function U(a) {
+      s(async function() {
+        const I = await a.detail;
+        s(function() {
+          v(I);
+        });
+      });
+    }
+    function W() {
+      Q && s(async function() {
+        const a = await d(n, t);
+        s(function() {
+          v(a);
+        });
+      });
+    }
+    const X = c(n, "resolved", z), Y = c(n, "mutating", G), Z = c(n, "mutated", J), _ = c(n, "hydrated", K), $ = c(n, "refetching", U), p = c(n, "forgotten", W);
+    return function() {
+      X(), Y(), Z(), _(), $(), p();
+    };
+  }
+  C(E, [
+    d,
+    l,
+    c,
+    n,
+    Q,
+    t,
+    s
+  ]);
+  const R = rn(n, t), q = un(n);
+  function P() {
+    return { data: M, isPending: m, ...R, ...q };
+  }
+  return f(P, [M, m, R, q]);
+}
+function fn({
+  children: n,
+  clearOnForget: t,
+  broadcast: e,
+  ...r
+}) {
+  function o() {
+    return tn({ broadcast: e, ...r });
+  }
+  const [u] = T(o);
+  function i() {
+    u.configure(r);
+  }
+  C(i, [u, r]);
+  function d() {
+    if (e) {
+      u.configure({ broadcast: e });
+      const H = u.subscribeBroadcast();
+      return function() {
+        H();
+      };
+    }
+    const x = new BroadcastChannel("query");
+    u.configure({ broadcast: x });
+    const m = u.subscribeBroadcast();
+    return function() {
+      m(), x.close();
+    };
+  }
+  C(d, [u, e]);
+  function l() {
+    return { clearOnForget: t };
+  }
+  const c = f(l, [t]);
+  function g() {
+    return { query: u, additional: c };
+  }
+  const b = f(g, [u, c]);
+  return /* @__PURE__ */ L(j, { value: b, children: n });
+}
+function dn({ children: n, startTransition: t, isPending: e }) {
+  function r() {
+    return { startTransition: t, isPending: e };
+  }
+  const o = f(r, [t, e]);
+  return /* @__PURE__ */ L(V, { value: o, children: n });
+}
+export {
+  j as Context,
+  fn as QueryProvider,
+  dn as QueryTransition,
+  V as TransitionContext,
+  an as useQuery,
+  rn as useQueryActions,
+  N as useQueryContext,
+  B as useQueryInstance,
+  un as useQueryStatus,
+  en as useQueryTransitionContext
+};
+//# sourceMappingURL=query_react.js.map

package/dist/query_react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query_react.js","sources":["../src/react/context.ts","../src/react/hooks/useQueryContext.ts","../src/react/hooks/useQueryInstance.ts","../src/react/transition.ts","../src/react/hooks/useQueryTransitionContext.ts","../src/react/hooks/useQueryActions.ts","../src/react/hooks/useQueryStatus.ts","../src/react/hooks/useQuery.ts","../src/react/components/QueryProvider.tsx","../src/react/components/QueryTransition.tsx"],"sourcesContent":["import { createContext } from 'react'\nimport { Query } from 'query:index'\n\nexport interface ContextOptions {\n  readonly clearOnForget?: boolean\n  readonly ignoreTransitionContext?: boolean\n}\n\nexport interface ContextValue {\n  readonly query?: Query\n  readonly additional?: ContextOptions\n}\n\nexport const Context = createContext<ContextValue>({\n  query: undefined,\n  additional: undefined,\n})\n","import { Context, type ContextValue } from 'query/react:context'\nimport { use, useDebugValue } from 'react'\n\nexport function useQueryContext(): ContextValue {\n  useDebugValue('useQueryContext')\n\n  return use(Context)\n}\n","import { type Query } from 'query:index'\nimport { useQueryContext } from 'query/react:hooks/useQueryContext'\nimport { useDebugValue, useMemo } from 'react'\n\nexport interface QueryInstance {\n  readonly query?: Query\n}\n\nexport function useQueryInstance(options?: QueryInstance): Query {\n  useDebugValue('useQueryInstance')\n\n  const contextOptions = useQueryContext()\n\n  function query() {\n    const instance = options?.query ?? contextOptions.query\n\n    if (!instance) {\n      throw new Error(\n        'No query instance was found. Please provide one via the resource options or the query context.'\n      )\n    }\n\n    return instance\n  }\n\n  return useMemo(query, [options, contextOptions])\n}\n","import { createContext, type TransitionStartFunction } from 'react'\n\nexport interface QueryTransitionContextValue {\n  readonly isPending?: boolean\n  readonly startTransition?: TransitionStartFunction\n}\n\nexport const TransitionContext = createContext<QueryTransitionContextValue>({\n  isPending: undefined,\n  startTransition: undefined,\n})\n","import { TransitionContext, type QueryTransitionContextValue } from 'query/react:transition'\nimport { use, useDebugValue } from 'react'\n\nexport function useQueryTransitionContext(): QueryTransitionContextValue {\n  useDebugValue('useQueryTransitionContext')\n\n  return use(TransitionContext)\n}\n","import { MutateOptions, MutationValue, Options } from 'query:index'\nimport { useCallback, useDebugValue, useMemo } from 'react'\nimport { QueryInstance, useQueryInstance } from './useQueryInstance'\n\nexport interface QueryActions<T = unknown> {\n  readonly refetch: (refetchOptions?: Options<T>) => Promise<T>\n  readonly mutate: (value: MutationValue<T>, options?: MutateOptions<T>) => Promise<T>\n  readonly forget: () => void\n}\n\nexport type QueryActionsOptions<T = unknown> = Options<T> & QueryInstance\n\nexport function useQueryActions<T = unknown>(\n  key: string,\n  options?: QueryActionsOptions<T>\n): QueryActions<T> {\n  useDebugValue('useQueryActions')\n\n  const { query, mutate, forget } = useQueryInstance(options)\n\n  function refetchHandler(refetchOptions?: Options<T>) {\n    return query<T>(key, {\n      stale: false,\n      ...options,\n      ...refetchOptions,\n    })\n  }\n\n  const refetch = useCallback(refetchHandler, [query, key, options])\n\n  function mutateHandler<T = unknown>(value: MutationValue<T>, options?: MutateOptions<T>) {\n    return mutate(key, value, options)\n  }\n\n  const localMutate = useCallback(mutateHandler, [mutate, key])\n\n  function forgetHandler() {\n    forget(key)\n  }\n\n  const localForget = useCallback(forgetHandler, [forget, key])\n\n  function actionsHandler() {\n    return { refetch, mutate: localMutate, forget: localForget }\n  }\n\n  return useMemo(actionsHandler, [refetch, localMutate, localForget])\n}\n","import { useDebugValue, useEffect, useState } from 'react'\nimport { useQueryInstance } from './useQueryInstance'\n\nexport interface Status {\n  readonly expiresAt: Date\n  readonly isExpired: boolean\n  readonly isRefetching: boolean\n  readonly isMutating: boolean\n}\n\nexport function useQueryStatus(key: string): Status {\n  useDebugValue('useQueryStatus')\n\n  const { expiration, subscribe } = useQueryInstance()\n  const [expiresAt, setExpiresAt] = useState<Date>(expiration(key) ?? new Date())\n  const [isExpired, setIsExpired] = useState(Date.now() > expiresAt.getTime())\n  const [isRefetching, setIsRefetching] = useState(false)\n  const [isMutating, setIsMutating] = useState(false)\n\n  function expirationHandler() {\n    if (Date.now() >= expiresAt.getTime()) {\n      setIsExpired(true)\n      return\n    }\n\n    setIsExpired(false)\n\n    function handler() {\n      setIsExpired(true)\n    }\n\n    const id = setTimeout(handler, expiresAt.getTime() - Date.now())\n\n    return function () {\n      clearTimeout(id)\n    }\n  }\n\n  useEffect(expirationHandler, [expiresAt])\n\n  function subscribeHandler() {\n    function onMutating() {\n      setIsMutating(true)\n    }\n\n    function onMutated() {\n      setIsMutating(false)\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onHydrated() {\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onResolved() {\n      setExpiresAt(expiration(key) ?? new Date())\n      setIsRefetching(false)\n    }\n\n    function onForgotten() {\n      setExpiresAt(expiration(key) ?? new Date())\n    }\n\n    function onRefetching() {\n      setIsRefetching(true)\n    }\n\n    function onError() {\n      setIsRefetching(false)\n      setIsMutating(false)\n    }\n\n    const unsubscribeMutating = subscribe(key, 'mutating', onMutating)\n    const unsubscribeMutated = subscribe(key, 'mutated', onMutated)\n    const unsubscribeHydrated = subscribe(key, 'hydrated', onHydrated)\n    const unsubscribeResolved = subscribe(key, 'resolved', onResolved)\n    const unsubscribeForgotten = subscribe(key, 'forgotten', onForgotten)\n    const unsubscribeRefetching = subscribe(key, 'refetching', onRefetching)\n    const unsubscribeError = subscribe(key, 'error', onError)\n\n    return function () {\n      unsubscribeMutating()\n      unsubscribeMutated()\n      unsubscribeHydrated()\n      unsubscribeResolved()\n      unsubscribeForgotten()\n      unsubscribeRefetching()\n      unsubscribeError()\n    }\n  }\n\n  useEffect(subscribeHandler, [key, subscribe, expiration, setExpiresAt])\n\n  return { expiresAt, isExpired, isRefetching, isMutating }\n}\n","import { useEffect, use, useState, useMemo, useDebugValue, useTransition, useRef } from 'react'\nimport { ContextOptions as ContextOptions } from 'query/react:context'\nimport { Options } from 'query:index'\nimport { useQueryContext } from './useQueryContext'\nimport { QueryInstance, useQueryInstance } from './useQueryInstance'\nimport { useQueryTransitionContext } from './useQueryTransitionContext'\nimport { QueryActions, useQueryActions } from './useQueryActions'\nimport { useQueryStatus, type Status } from './useQueryStatus'\n\ntype AdditionalHooks<T> = QueryActions<T> & Status\n\nexport interface Resource<T = unknown> extends AdditionalHooks<T> {\n  data: T\n  isPending: boolean\n}\n\nexport type ResourceOptions<T = unknown> = ContextOptions & Options<T> & QueryInstance\n\nexport function useQuery<T = unknown>(key: string, options?: ResourceOptions<T>): Resource<T> {\n  useDebugValue('useQuery')\n\n  const { additional } = useQueryContext()\n\n  const { isPending: isContextPending, startTransition: startContextTransition } =\n    useQueryTransitionContext()\n\n  const [isLocalPending, startLocalTransition] = useTransition()\n  const { query, expiration, subscribe } = useQueryInstance(options)\n\n  function ignoreTransitionContextHandler() {\n    return options?.ignoreTransitionContext ?? additional?.ignoreTransitionContext ?? false\n  }\n\n  const ignoreTransitionContext = useMemo(ignoreTransitionContextHandler, [options, additional])\n\n  function isPendingHandler() {\n    if (ignoreTransitionContext) {\n      return isLocalPending\n    }\n\n    return isContextPending ?? isLocalPending\n  }\n\n  const isPending = useMemo(isPendingHandler, [\n    isContextPending,\n    isLocalPending,\n    ignoreTransitionContext,\n  ])\n\n  function startTransitionHandler() {\n    if (ignoreTransitionContext) {\n      return startLocalTransition\n    }\n\n    return startContextTransition ?? startLocalTransition\n  }\n\n  const startTransition = useMemo(startTransitionHandler, [\n    startContextTransition,\n    startLocalTransition,\n    ignoreTransitionContext,\n  ])\n\n  function clearOnForgetHandler() {\n    return options?.clearOnForget ?? additional?.clearOnForget ?? false\n  }\n\n  const clearOnForget = useMemo(clearOnForgetHandler, [options, additional])\n\n  async function promiseHandler() {\n    return await query<T>(key, options)\n  }\n\n  const promise = useMemo(promiseHandler, [query, key, options])\n  const initial = useRef<T>(undefined)\n\n  if (initial.current === undefined) {\n    initial.current = use(promise)\n  }\n\n  const [data, setData] = useState(initial.current)\n\n  function subscribeHandler() {\n    function onResolved(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onMutating(event: Event) {\n      startTransition(async function () {\n        const value = await (event as CustomEvent<Promise<T>>).detail\n\n        startTransition(function () {\n          setData(value)\n        })\n      })\n    }\n\n    function onMutated(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onHydrated(event: Event) {\n      startTransition(function () {\n        setData((event as CustomEvent<T>).detail)\n      })\n    }\n\n    function onRefetching(event: Event) {\n      startTransition(async function () {\n        const value = await (event as CustomEvent<Promise<T>>).detail\n\n        startTransition(function () {\n          setData(value)\n        })\n      })\n    }\n\n    function onForgotten() {\n      if (clearOnForget) {\n        startTransition(async function () {\n          const data = await query<T>(key, options)\n\n          startTransition(function () {\n            setData(data)\n          })\n        })\n      }\n    }\n\n    const unsubscribeResolved = subscribe(key, 'resolved', onResolved)\n    const unsubscribeMutating = subscribe(key, 'mutating', onMutating)\n    const unsubscribeMutated = subscribe(key, 'mutated', onMutated)\n    const unsubscribeHydrated = subscribe(key, 'hydrated', onHydrated)\n    const unsubscribeRefetching = subscribe(key, 'refetching', onRefetching)\n    const unsubscribeForgotten = subscribe(key, 'forgotten', onForgotten)\n\n    return function () {\n      unsubscribeResolved()\n      unsubscribeMutating()\n      unsubscribeMutated()\n      unsubscribeHydrated()\n      unsubscribeRefetching()\n      unsubscribeForgotten()\n    }\n  }\n\n  useEffect(subscribeHandler, [\n    query,\n    expiration,\n    subscribe,\n    key,\n    clearOnForget,\n    options,\n    startTransition,\n  ])\n\n  const actions = useQueryActions<T>(key, options)\n  const status = useQueryStatus(key)\n\n  function resourceHandler(): Resource<T> {\n    return { data, isPending, ...actions, ...status }\n  }\n\n  return useMemo(resourceHandler, [data, isPending, actions, status])\n}\n","import { useEffect, useMemo, useState, type ReactNode } from 'react'\nimport { Context, ContextValue, type ContextOptions } from 'query/react:context'\nimport { createQuery, Query, type Configuration } from 'query:index'\n\ntype OtherProps = Configuration & ContextOptions\n\nexport interface QueryProviderProps extends OtherProps {\n  children?: ReactNode\n}\n\nexport function QueryProvider({\n  children,\n  clearOnForget,\n  broadcast,\n  ...options\n}: QueryProviderProps) {\n  function initial() {\n    return createQuery({ broadcast, ...options })\n  }\n\n  const [query] = useState<Query>(initial)\n\n  function reconfigure() {\n    query.configure(options)\n  }\n\n  useEffect(reconfigure, [query, options])\n\n  function broadcastCleanup() {\n    if (broadcast) {\n      query.configure({ broadcast })\n      const unsubscribe = query.subscribeBroadcast()\n\n      return function () {\n        unsubscribe()\n      }\n    }\n\n    const channel = new BroadcastChannel('query')\n\n    query.configure({ broadcast: channel })\n    const unsubscribe = query.subscribeBroadcast()\n\n    return function () {\n      unsubscribe()\n      channel.close()\n    }\n  }\n\n  useEffect(broadcastCleanup, [query, broadcast])\n\n  function additionalHandler() {\n    return { clearOnForget }\n  }\n\n  const additional = useMemo(additionalHandler, [clearOnForget])\n\n  function valueHandler(): ContextValue {\n    return { query, additional }\n  }\n\n  const value = useMemo(valueHandler, [query, additional])\n\n  return <Context value={value}>{children}</Context>\n}\n","import { TransitionContext, QueryTransitionContextValue } from 'query/react:transition'\nimport { useMemo, type ReactNode, type TransitionStartFunction } from 'react'\n\nexport interface QueryTransitionProps {\n  isPending: boolean\n  startTransition: TransitionStartFunction\n  children?: ReactNode\n}\n\nexport function QueryTransition({ children, startTransition, isPending }: QueryTransitionProps) {\n  function valueHandler(): QueryTransitionContextValue {\n    return { startTransition, isPending }\n  }\n\n  const value = useMemo(valueHandler, [startTransition, isPending])\n\n  return <TransitionContext value={value}>{children}</TransitionContext>\n}\n"],"names":["Context","createContext","useQueryContext","useDebugValue","use","useQueryInstance","options","contextOptions","query","instance","useMemo","TransitionContext","useQueryTransitionContext","useQueryActions","key","mutate","forget","refetchHandler","refetchOptions","refetch","useCallback","mutateHandler","value","localMutate","forgetHandler","localForget","actionsHandler","useQueryStatus","expiration","subscribe","expiresAt","setExpiresAt","useState","isExpired","setIsExpired","isRefetching","setIsRefetching","isMutating","setIsMutating","expirationHandler","handler","id","useEffect","subscribeHandler","onMutating","onMutated","onHydrated","onResolved","onForgotten","onRefetching","onError","unsubscribeMutating","unsubscribeMutated","unsubscribeHydrated","unsubscribeResolved","unsubscribeForgotten","unsubscribeRefetching","unsubscribeError","useQuery","additional","isContextPending","startContextTransition","isLocalPending","startLocalTransition","useTransition","ignoreTransitionContextHandler","ignoreTransitionContext","isPendingHandler","isPending","startTransitionHandler","startTransition","clearOnForgetHandler","clearOnForget","promiseHandler","promise","initial","useRef","data","setData","event","actions","status","resourceHandler","QueryProvider","children","broadcast","createQuery","reconfigure","broadcastCleanup","unsubscribe","channel","additionalHandler","valueHandler","jsx","QueryTransition"],"mappings":"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"}

package/dist/src/query/index.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Determines the shape of the Cache instance.
+ */
+export interface Cache<T = unknown> {
+    /**
+     * Gets an item from the cache.
+     */
+    readonly get: (key: string) => T | undefined;
+    /**
+     * Sets an item to the cache.
+     */
+    readonly set: (key: string, value: T) => void;
+    /**
+     * Removes a key-value pair from the cache.
+     */
+    readonly delete: (key: string) => void;
+    /**
+     * Returns the current cached keys.
+     */
+    readonly keys: () => IterableIterator<string>;
+}
+/**
+ * Determines how we store items in the items cache.
+ */
+interface ItemsCacheItem<T = unknown> {
+    /**
+     * Stores the cache item.
+     */
+    readonly item: T;
+    /**
+     * Determines the expiration date of the item.
+     */
+    readonly expiresAt: Date;
+}
+/**
+ * Determines how we store items in the resolvers cache.
+ */
+interface ResolversCacheItem<T> {
+    /**
+     * The resolvable item.
+     */
+    readonly item: Promise<T>;
+    /**
+     * The abort controller for the request.
+     */
+    readonly controller: AbortController;
+}
+/**
+ * Represents the available configuration options
+ * for a query instance.
+ */
+export interface Configuration extends Options {
+    /**
+     * Determines the resolved items cache to use.
+     */
+    readonly itemsCache?: Cache<ItemsCacheItem>;
+    /**
+     * Determines the resolvers cache to use.
+     */
+    readonly resolversCache?: Cache<ResolversCacheItem<unknown>>;
+    /**
+     * Stores the event system.
+     */
+    readonly events?: EventTarget;
+    /**
+     * Broadcast channel. This is useful for communicating
+     * between tabs and windows (browser contexts).
+     *
+     * By default it does not use any broadcast channel.
+     * If a broadcast channel is provided, query
+     * won't close automatically, therefore, the responsability
+     * of closing the broadcast channel is up to the user.
+     */
+    readonly broadcast?: BroadcastChannel;
+}
+export interface FetcherAdditional {
+    /**
+     * An abort signal to cancel pending queries.
+     */
+    readonly signal: AbortSignal;
+}
+/**
+ * The available options for query.
+ */
+export interface Options<T = unknown> {
+    /**
+     * Determines the item deduplication interval.
+     * This determines how many milliseconds an item
+     * is considered valid.
+     */
+    readonly expiration?: ExpirationFunction<T>;
+    /**
+     * Determines the fetcher function to use.
+     */
+    readonly fetcher?: FetcherFunction<T>;
+    /**
+     * Determines if we can return a stale item.
+     * If `true`, it will return the previous stale item
+     * stored in the cache if it has expired. It will attempt
+     * to revalidate it in the background. If `false`, the returned
+     * promise will be the revalidation promise.
+     */
+    readonly stale?: boolean;
+    /**
+     * Removes the stored item if there is an error in the request.
+     * By default, we don't remove the item upon failure, only the resolver
+     * is removed from the cache.
+     */
+    readonly removeOnError?: boolean;
+    /**
+     * Determines if the result should be a fresh fetched
+     * instance regardless of any cached value or its expiration time.
+     */
+    readonly fresh?: boolean;
+}
+/**
+ * Determines the cache type.
+ */
+export type CacheType = 'resolvers' | 'items';
+/**
+ * The mutation function type.
+ */
+export interface MutationFunction<T> {
+    (previous?: T, expiresAt?: Date): T | Promise<T>;
+}
+/**
+ * The available mutation values.
+ */
+export type MutationValue<T> = T | MutationFunction<T>;
+/**
+ * The function type for the event subscription.
+ */
+export interface SubscribeFunction {
+    (key: string, event: QueryEvent, listener: EventListener): Unsubscriber;
+}
+/**
+ * The broadcast payload.
+ */
+export interface BroadcastPayload {
+    /**
+     * The event name.
+     */
+    readonly event: string;
+    /**
+     * The event detail.
+     */
+    readonly detail: unknown;
+}
+/**
+ * The function type for the broadcast subscription.
+ */
+export interface SubscribeBroadcastFunction {
+    (): Unsubscriber;
+}
+/**
+ * The query function type.
+ */
+export interface QueryFunction {
+    <T = unknown>(key: string, options?: Options<T>): Promise<T>;
+}
+export interface ExpirationFunction<T = unknown> {
+    (item: T): number;
+}
+export interface FetcherFunction<T = unknown> {
+    (key: string, additional: FetcherAdditional): Promise<T>;
+}
+/**
+ * The mutate function options.
+ */
+export interface HydrateOptions<T = unknown> {
+    expiration?: ExpirationFunction<T>;
+}
+/**
+ * The mutate function options.
+ */
+export interface MutateOptions<T = unknown> {
+    expiration?: ExpirationFunction<T>;
+}
+/**
+ * The mutate function type.
+ */
+export interface MutateFunction {
+    <T = unknown>(key: string, item: MutationValue<T>, options?: MutateOptions<T>): Promise<T>;
+}
+/**
+ * The hydrate function type.
+ */
+export interface HydrateFunction {
+    <T = unknown>(keys: string | string[], item: T, options?: HydrateOptions<T>): void;
+}
+/**
+ * The unsubscriber function.
+ */
+export type Unsubscriber = () => void;
+/**
+ * The caches available on the query.
+ */
+export interface Caches {
+    /**
+     * A cache that contains the resolved items alongside
+     * their expiration time.
+     */
+    readonly items: Cache<ItemsCacheItem>;
+    /**
+     * A cache that contains the resolvers alongside
+     * their abort controllers.
+     */
+    readonly resolvers: Cache<ResolversCacheItem<unknown>>;
+}
+/**
+ * Represents the methods a query
+ * should implement.
+ */
+export interface Query {
+    /**
+     * Configures the current instance of query.
+     */
+    readonly configure: (options?: Partial<Configuration>) => void;
+    /**
+     * Fetches the key information using a fetcher.
+     * The returned promise contains the result item.
+     */
+    readonly query: QueryFunction;
+    /**
+     * Subscribes to a given event & key. The event handler
+     * does have a payload parameter that will contain relevant
+     * information depending on the event type.
+     */
+    readonly subscribe: SubscribeFunction;
+    /**
+     * Subscribes to the broadcast channel
+     * to listen for other browser context
+     * events and reproduce them in the current
+     * context.
+     */
+    readonly subscribeBroadcast: SubscribeBroadcastFunction;
+    /**
+     * Mutates the key with a given optimistic value.
+     * The mutated value is considered expired and will be
+     * replaced immediatly if a refetch happens.
+     */
+    readonly mutate: MutateFunction;
+    /**
+     * Aborts the active resolvers on each key
+     * by calling `.abort()` on the `AbortController`.
+     * The fetcher is responsible for using the
+     * `AbortSignal` to cancel the job.
+     */
+    readonly abort: (key?: string | string[], reason?: unknown) => void;
+    /**
+     * Forgets the given keys from the cache.
+     * Removes items from both, the cache and resolvers.
+     */
+    readonly forget: (keys?: string | string[] | RegExp) => void;
+    /**
+     * Hydrates the given keys on the cache
+     * with the given value and expiration time.
+     */
+    readonly hydrate: HydrateFunction;
+    /**
+     * Returns the given keys for the given cache.
+     */
+    readonly keys: (cache?: CacheType) => string[];
+    /**
+     * Returns the expiration date of a given key item.
+     * If the item is not in the cache, it will return `undefined`.
+     */
+    readonly expiration: (key: string) => Date | undefined;
+    /**
+     * Returns the current snapshot of the given key.
+     * If the item is not in the items cache, it will return `undefined`.
+     */
+    readonly snapshot: <T = unknown>(key: string) => T | undefined;
+    /**
+     * Returns the current cache instances in use.
+     */
+    readonly caches: () => Caches;
+    /**
+     * Returns the event system in use.
+     */
+    readonly events: () => EventTarget;
+    /**
+     * Returns the broadcast channel in use.
+     */
+    readonly broadcast: () => BroadcastChannel | undefined;
+}
+/**
+ * Available events on query.
+ */
+export type QueryEvent = 'refetching' | 'resolved' | 'mutating' | 'mutated' | 'aborted' | 'forgotten' | 'hydrated' | 'error';
+/**
+ * Stores the default fetcher function.
+ */
+export declare function defaultFetcher<T>(fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>): FetcherFunction<T>;
+/**
+ * Creates a new query instance.
+ */
+export declare function createQuery(instanceOptions?: Configuration): Query;
+export {};

package/dist/src/react/components/QueryProvider.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import { ContextOptions } from '../context';
+import { Configuration } from '../../query/index';
+type OtherProps = Configuration & ContextOptions;
+export interface QueryProviderProps extends OtherProps {
+    children?: ReactNode;
+}
+export declare function QueryProvider({ children, clearOnForget, broadcast, ...options }: QueryProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/react/components/QueryTransition.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode, TransitionStartFunction } from 'react';
+export interface QueryTransitionProps {
+    isPending: boolean;
+    startTransition: TransitionStartFunction;
+    children?: ReactNode;
+}
+export declare function QueryTransition({ children, startTransition, isPending }: QueryTransitionProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import { Query } from '../query/index';
+export interface ContextOptions {
+    readonly clearOnForget?: boolean;
+    readonly ignoreTransitionContext?: boolean;
+}
+export interface ContextValue {
+    readonly query?: Query;
+    readonly additional?: ContextOptions;
+}
+export declare const Context: import('react').Context<ContextValue>;

package/dist/src/react/hooks/useQuery.d.ts

@@ -0,0 +1,13 @@
+import { ContextOptions as ContextOptions } from '../context';
+import { Options } from '../../query/index';
+import { QueryInstance } from './useQueryInstance';
+import { QueryActions } from './useQueryActions';
+import { Status } from './useQueryStatus';
+type AdditionalHooks<T> = QueryActions<T> & Status;
+export interface Resource<T = unknown> extends AdditionalHooks<T> {
+    data: T;
+    isPending: boolean;
+}
+export type ResourceOptions<T = unknown> = ContextOptions & Options<T> & QueryInstance;
+export declare function useQuery<T = unknown>(key: string, options?: ResourceOptions<T>): Resource<T>;
+export {};

package/dist/src/react/hooks/useQueryActions.d.ts

@@ -0,0 +1,9 @@
+import { MutateOptions, MutationValue, Options } from '../../query/index';
+import { QueryInstance } from './useQueryInstance';
+export interface QueryActions<T = unknown> {
+    readonly refetch: (refetchOptions?: Options<T>) => Promise<T>;
+    readonly mutate: (value: MutationValue<T>, options?: MutateOptions<T>) => Promise<T>;
+    readonly forget: () => void;
+}
+export type QueryActionsOptions<T = unknown> = Options<T> & QueryInstance;
+export declare function useQueryActions<T = unknown>(key: string, options?: QueryActionsOptions<T>): QueryActions<T>;

package/dist/src/react/hooks/useQueryContext.d.ts

@@ -0,0 +1,2 @@
+import { ContextValue } from '../context';
+export declare function useQueryContext(): ContextValue;

package/dist/src/react/hooks/useQueryInstance.d.ts

@@ -0,0 +1,5 @@
+import { Query } from '../../query/index';
+export interface QueryInstance {
+    readonly query?: Query;
+}
+export declare function useQueryInstance(options?: QueryInstance): Query;

package/dist/src/react/hooks/useQueryStatus.d.ts

@@ -0,0 +1,7 @@
+export interface Status {
+    readonly expiresAt: Date;
+    readonly isExpired: boolean;
+    readonly isRefetching: boolean;
+    readonly isMutating: boolean;
+}
+export declare function useQueryStatus(key: string): Status;

package/dist/src/react/hooks/useQueryTransitionContext.d.ts

@@ -0,0 +1,2 @@
+import { QueryTransitionContextValue } from '../transition';
+export declare function useQueryTransitionContext(): QueryTransitionContextValue;

package/dist/src/react/index.d.ts

@@ -0,0 +1,10 @@
+export * from './hooks/useQuery';
+export * from './hooks/useQueryStatus';
+export * from './hooks/useQueryInstance';
+export * from './hooks/useQueryContext';
+export * from './hooks/useQueryTransitionContext';
+export * from './hooks/useQueryActions';
+export * from './context';
+export * from './transition';
+export * from './components/QueryProvider';
+export * from './components/QueryTransition';

package/dist/src/react/transition.d.ts

@@ -0,0 +1,6 @@
+import { TransitionStartFunction } from 'react';
+export interface QueryTransitionContextValue {
+    readonly isPending?: boolean;
+    readonly startTransition?: TransitionStartFunction;
+}
+export declare const TransitionContext: import('react').Context<QueryTransitionContextValue>;

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@studiolambda/query",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Lightweight, isomorphic and framework agnostic asynchronous data management for modern UIs",
+  "author": {
+    "name": "Erik C. Forés",
+    "email": "soc@erik.cat",
+    "url": "https://erik.cat"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "types": "./dist/src/query/index.d.ts",
+  "main": "./dist/query.cjs",
+  "module": "./dist/query.js",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/src/query/index.d.ts",
+      "import": "./dist/query.js",
+      "require": "./dist/query.cjs"
+    },
+    "./react": {
+      "types": "./dist/src/react/index.d.ts",
+      "import": "./dist/query_react.js",
+      "require": "./dist/query_react.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vitest",
+    "test": "vitest run",
+    "test:ui": "vitest --ui --coverage",
+    "test:cover": "vitest run --coverage",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "solid-js": "^1.9.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/react": "19.0.1",
+    "@types/react-dom": "19.0.2",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "@vitest/coverage-v8": "^2.1.8",
+    "@vitest/ui": "^2.1.8",
+    "eslint": "^9.16.0",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-react-refresh": "^0.4.16",
+    "eslint-plugin-solid": "^0.14.5",
+    "globals": "^15.13.0",
+    "happy-dom": "^15.11.7",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "solid-js": "^1.9.3",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.0",
+    "vite": "^6.0.3",
+    "vite-plugin-dts": "^4.3.0",
+    "vite-plugin-solid": "^2.11.0",
+    "vitest": "^2.1.8"
+  }
+}