@sylwellsoftware/glue 0.2.0 → 0.4.0

package/README.md

@@ -5,7 +5,7 @@ uses it as its state/data-flow layer, but Glue does not depend on Fray, a DOM,
 or any UI framework. Its implementation and tests are strict TypeScript; the
 ESM build includes declarations and declaration maps.
 
-Install the published alpha with pnpm:
+Install with pnpm:
 
 ```bash
 pnpm add @sylwellsoftware/glue
@@ -46,8 +46,13 @@ by asynchronous retrieval. Richer responsibilities remain separate:
 | `DerivedEmitter` | A cached value computed from one or more readable emitters |
 | `QueryArg` | A named query-input view over another emitter when a semantic name is useful |
 | `LiveQuery` | Reactive request timing, latest-request ownership, status/error state, and cached results |
+| `LiveResult` | Common read/dispose contract for remote and locally derived endpoint results |
 | `QueryHandler` | Non-reactive retrieval strategy over a plain named argument object |
 | `RestQueryHandler` | HTTP URL construction, wire serialization, Fetch execution, and JSON result retrieval |
+| `QueryEndpoint` | Immutable declaration that opens caller-owned queries through any handler |
+| `RestEndpoint` | Immutable REST query declaration with optional response parsing |
+| `DerivedEndpoint` | Immutable local projection declaration that opens caller-owned live results |
+| `AsyncCommand` | Abortable mutation lifecycle with explicit concurrency policy |
 | `EventBubble` / `EventBus` | Optional cause-and-effect diagnostics without owning application history |
 
 The intended flow is explicit and one-directional:
@@ -177,20 +182,104 @@ const users = new LiveQuery({handler, args: {search}})
 Arguments are a named record of emitters. Construction fetches immediately
 unless `autoFetch: false`; `refresh()` and `retry()` return the active request
 promise. A newer request aborts and supersedes the older request, and stale
-results cannot overwrite current state. `dispose()` aborts the active request
-and releases argument subscriptions.
+results cannot overwrite current state. `abort()` cancels without disposing;
+`dispose()` aborts the active request and releases argument subscriptions.
 
 By default the last successful value remains visible while refreshing and after
 a refresh error. Set `keepPreviousValue: false` to clear it while loading or in
 error state.
 
+Polling is opt-in and waits one full interval before the first poll:
+
+```ts
+const pollingEnabled = new Emitter(true)
+const intervalMs = new Emitter(5_000)
+const users = new LiveQuery({
+    handler,
+    args: {search},
+    polling: {enabled: pollingEnabled, intervalMs},
+})
+```
+
+`enabled` and `intervalMs` may be constants or readable emitters. A changed
+control restarts the timer from that change. A tick is skipped while a request
+is active; the next normal tick remains scheduled. Errors do not cause an
+immediate retry or backoff, but polling continues while enabled. Disposal
+releases the timer and control subscriptions. Applications can feed page
+visibility or any other policy into `enabled`; Glue never reads the DOM. Tests
+and nonstandard runtimes may inject `PollingScheduler`.
+
 The REST adapter accepts injected `fetch`, `baseUrl`, and `serialize` behavior.
 Its generic serializer omits `undefined` and empty arrays, encodes `null` as an
 empty value, repeats keys for arrays, JSON-encodes objects, and stringifies
 scalars. Application-specific table filter/sort formats belong in an injected
-serializer, not Glue. A `RestQueryHandler` result generic declares the expected
-JSON shape but does not validate it at runtime; validate untrusted responses at
-the application boundary.
+serializer, not Glue. A result generic alone does not validate JSON. Supply
+`parseResult(json: unknown)` to decode or validate immediately after JSON
+parsing. A thrown parser error becomes the `LiveQuery` error, and Glue does not
+include the raw response body in its diagnostics.
+
+## Service endpoint declarations
+
+Applications may group immutable endpoint declarations in ordinary service
+classes. Glue does not register, locate, construct, or cache services; the
+application chooses and constructs its service scope. Fray applications may
+expose those services through Fray's typed runtime `ServiceScope`; non-Fray
+applications use their own explicit composition. Every `open()` call creates a
+caller-owned result with independent arguments, request state, polling, and
+disposal.
+
+```ts
+import {DerivedEndpoint, RestEndpoint} from '@sylwellsoftware/glue'
+
+class MovieService {
+    readonly movies = new RestEndpoint<{genre: string}, readonly Movie[]>({
+        url: '/api/movies',
+        parseResult: parseMovies,
+    })
+
+    readonly matchingMovies = new DerivedEndpoint<
+        readonly Movie[],
+        {genre: string},
+        readonly Movie[]
+    >({
+        apply: (movies, {genre}) => movies.filter((movie) => movie.genre === genre),
+    })
+}
+
+const service = new MovieService()
+const remote = service.movies.open({genre})
+const local = service.matchingMovies.open({source: cachedMovies, args: {genre}})
+```
+
+Both results implement `LiveResult`, so a UI that only reads value, fetch
+state, error, and subscriptions can accept either. `LiveQuery` additionally
+implements `RefreshableLiveResult` with `refresh()`, `retry()`, and `abort()`.
+
+For a query-like body protocol such as GraphQL, put a custom handler in a
+`QueryEndpoint`. The handler owns method, headers, authentication, body
+serialization, response checks, validation, and safe diagnostics:
+
+```ts
+import {QueryEndpoint} from '@sylwellsoftware/glue'
+
+const projectStatus = new QueryEndpoint<{id: string}, ProjectStatus>({
+    handler: {
+        async fetch({id}, {signal} = {}) {
+            const response = await fetch('/graphql', {
+                method: 'POST',
+                headers: {'content-type': 'application/json'},
+                body: JSON.stringify({query: STATUS_QUERY, variables: {id}}),
+                signal,
+            })
+            if (!response.ok) throw new Error(`HTTP ${response.status}`)
+            return parseProjectStatus(await response.json())
+        },
+    },
+})
+```
+
+Ordinary POST/PUT/PATCH/DELETE mutations belong in `AsyncCommand` executors,
+not auto-running query declarations.
 
 ## Optional tracing
 
@@ -206,14 +295,22 @@ start, and query completion can retain explicit parent/child causality without
 turning diagnostics into a second execution system. Applications decide
 whether to retain, render, or export observed events.
 
-## Experimental commands
+## Async commands
 
-`@sylwellsoftware/glue/experimental` exports `AsyncCommand`, an abortable
+`AsyncCommand` is exported from Glue's package root. It is an abortable
 mutation lifecycle with explicit `ignore`, `replace`, and `reject` concurrency
 policies. It exposes the last result/error through the standard emitter
 snapshot and a read-only `isRunning` view. It deliberately does not own batch
-progress, retries, notifications, or UI behavior. See
-[EXPERIMENTAL.md](EXPERIMENTAL.md) for the provisional contract.
+progress, retries, notifications, or UI behavior. Executor completion alone
+determines command success. The application may then refresh affected queries;
+their failures remain in their own query snapshots:
+
+```ts
+const saved = await saveCommand.run(update)
+if (saved !== undefined) {
+    await Promise.all([users.refresh('save reconciled'), audit.refresh('save reconciled')])
+}
+```
 
 ## Integration with Fray and other consumers
 
@@ -256,7 +353,7 @@ Glue intentionally does not own a DOM renderer, component lifecycle,
 application-specific query encoding, persistent event history, CommonJS build,
 or framework adapter. Fray consumes Glue as a peer; browser UI belongs there.
 
-See the [workspace overview](../../README.md), [alpha API
+See the [workspace overview](../../README.md), [API
 surface](../../docs/API_SURFACE.md), [changelog](../../CHANGELOG.md),
 [contribution guide](../../CONTRIBUTING.md), and [security
 policy](../../SECURITY.md).

package/dist/commands/asyncCommand.d.ts

@@ -19,7 +19,7 @@ export interface AsyncCommandOptions<TArguments, TResult, TError = unknown> {
 export declare class AsyncCommandConcurrencyError extends Error {
     constructor();
 }
-/** Experimental abortable mutation state with an explicit concurrency policy. */
+/** Abortable mutation state with an explicit concurrency policy. */
 export declare class AsyncCommand<TArguments, TResult, TError = unknown> extends BaseEmitter<TResult | undefined, TError> {
     readonly execute: AsyncCommandExecutor<TArguments, TResult>;
     readonly concurrency: AsyncCommandConcurrency;

package/dist/commands/asyncCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asyncCommand.d.ts","sourceRoot":"","sources":["../../src/commands/asyncCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAA;AAG/D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kCAAkC,CAAA;AAErE,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAErE,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC9C;AAED,MAAM,MAAM,oBAAoB,CAAC,UAAU,EAAE,OAAO,IAAI,CACpD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,mBAAmB,KAC3B,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAEnC,MAAM,WAAW,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IACtE,OAAO,EAAE,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAClD,WAAW,CAAC,EAAE,uBAAuB,CAAA;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAWD,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD;AAED,iFAAiF;AACjF,qBAAa,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAC3D,SAAQ,WAAW,CAAC,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAC3D,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,kBAAkB,CAAQ;IAClC,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI,CAAO;gBAE9C,OAAO,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAgCrE,GAAG,CACC,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAuB,GAC7D,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAiE/B,KAAK,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAA2B,GAAG,OAAO;IAmBhF,KAAK,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAyB,GAAG,IAAI;IAelE,OAAO,IAAI,IAAI;IAWxB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;CAO1B"}
+{"version":3,"file":"asyncCommand.d.ts","sourceRoot":"","sources":["../../src/commands/asyncCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAA;AACtD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAA;AAG/D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kCAAkC,CAAA;AAErE,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAErE,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC9C;AAED,MAAM,MAAM,oBAAoB,CAAC,UAAU,EAAE,OAAO,IAAI,CACpD,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,mBAAmB,KAC3B,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;AAEnC,MAAM,WAAW,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IACtE,OAAO,EAAE,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAClD,WAAW,CAAC,EAAE,uBAAuB,CAAA;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAWD,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD;AAED,oEAAoE;AACpE,qBAAa,YAAY,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAC3D,SAAQ,WAAW,CAAC,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAC3D,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,kBAAkB,CAAQ;IAClC,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI,CAAO;gBAE9C,OAAO,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAgCrE,GAAG,CACC,UAAU,EAAE,UAAU,EACtB,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAuB,GAC7D,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAiE/B,KAAK,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAA2B,GAAG,OAAO;IAmBhF,KAAK,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAyB,GAAG,IAAI;IAelE,OAAO,IAAI,IAAI;IAWxB,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,eAAe;CAO1B"}

package/dist/emitters/liveQuery.d.ts

@@ -2,26 +2,42 @@ import { EventBubble } from '../debugging/eventBubble.js';
 import type { QueryHandlerLike } from '../queryhandling/queryHandler.js';
 import { BaseEmitter } from './baseEmitter.js';
 import type { EmitterValue, ReadableEmitter } from './baseEmitter.js';
+import type { RefreshableLiveResult } from './liveResult.js';
 export type QueryArgumentEmitters = Record<string, ReadableEmitter<unknown, unknown>>;
 export type QueryArgumentValues<TArguments extends QueryArgumentEmitters> = {
     [TName in keyof TArguments]: EmitterValue<TArguments[TName]>;
 };
+export interface PollingScheduler {
+    schedule(callback: () => void, delayMs: number): unknown;
+    cancel(handle: unknown): void;
+}
+export interface LiveQueryPollingOptions {
+    intervalMs: number | ReadableEmitter<number, unknown>;
+    enabled?: boolean | ReadableEmitter<boolean, unknown>;
+    scheduler?: PollingScheduler;
+}
 export interface LiveQueryOptions<TResult, TArguments extends QueryArgumentEmitters> {
     handler: QueryHandlerLike<QueryArgumentValues<TArguments>, TResult>;
     args?: TArguments;
     autoFetch?: boolean;
     keepPreviousValue?: boolean;
+    polling?: LiveQueryPollingOptions;
     owner?: unknown;
     purpose?: string;
     trace?: boolean;
 }
 /** Reactive, abortable query driven by a named record of emitter arguments. */
-export declare class LiveQuery<TResult, TArguments extends QueryArgumentEmitters = Record<string, never>> extends BaseEmitter<TResult | undefined, unknown> {
+export declare class LiveQuery<TResult, TArguments extends QueryArgumentEmitters = Record<string, never>> extends BaseEmitter<TResult | undefined, unknown> implements RefreshableLiveResult<TResult | undefined, unknown> {
     readonly handler: QueryHandlerLike<QueryArgumentValues<TArguments>, TResult>;
     readonly args: TArguments;
     readonly keepPreviousValue: boolean;
     private lastSuccessfulValue;
+    private hasSuccessfulValue;
     private argumentUnsubscribers;
+    private pollingUnsubscribers;
+    private readonly polling;
+    private readonly pollingScheduler;
+    private pollingHandle;
     private requestId;
     private abortController;
     /** Exposed for deterministic tests; consumers should use refresh()/retry(). */
@@ -30,7 +46,11 @@ export declare class LiveQuery<TResult, TArguments extends QueryArgumentEmitters
     get argumentValues(): QueryArgumentValues<TArguments>;
     refresh(eventOrCause?: EventBubble<unknown> | unknown): Promise<TResult | undefined>;
     retry(eventOrCause?: EventBubble<unknown> | unknown): Promise<TResult | undefined>;
+    abort(eventOrCause?: EventBubble<unknown> | unknown): void;
     dispose(): void;
+    private initializePolling;
+    private scheduleNextPoll;
+    private cancelScheduledPoll;
     private isCurrentRequest;
 }
 //# sourceMappingURL=liveQuery.d.ts.map

package/dist/emitters/liveQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"liveQuery.d.ts","sourceRoot":"","sources":["../../src/emitters/liveQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAA;AAEvD,OAAO,KAAK,EAAC,gBAAgB,EAAmC,MAAM,kCAAkC,CAAA;AACxG,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAC,YAAY,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAEnE,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAErF,MAAM,MAAM,mBAAmB,CAAC,UAAU,SAAS,qBAAqB,IAAI;KACvE,KAAK,IAAI,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;CAC/D,CAAA;AAED,MAAM,WAAW,gBAAgB,CAC7B,OAAO,EACP,UAAU,SAAS,qBAAqB;IAExC,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAA;IACnE,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;CAClB;AAWD,+EAA+E;AAC/E,qBAAa,SAAS,CAClB,OAAO,EACP,UAAU,SAAS,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAClE,SAAQ,WAAW,CAAC,OAAO,GAAG,SAAS,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAA;IAC5E,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,qBAAqB,CAAmB;IAChD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAAmC;IAC1D,+EAA+E;IAC/E,cAAc,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,IAAI,CAAO;gBAE9C,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC;IAsC1D,IAAI,cAAc,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAIpD;IAED,OAAO,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAmB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IA8D/F,KAAK,CAAC,YAAY,GAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAiB,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAIlF,OAAO,IAAI,IAAI;IAWxB,OAAO,CAAC,gBAAgB;CAM3B"}
+{"version":3,"file":"liveQuery.d.ts","sourceRoot":"","sources":["../../src/emitters/liveQuery.ts"],"names":[],"mappings":"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"}

package/dist/emitters/liveResult.d.ts

@@ -0,0 +1,14 @@
+import type { EventBubble } from '../debugging/eventBubble.js';
+import type { ReadableEmitter } from './baseEmitter.js';
+/** Common caller-facing contract for remote and locally derived live results. */
+export interface LiveResult<TValue, TError = unknown> extends ReadableEmitter<TValue, TError> {
+    readonly disposed: boolean;
+    dispose(): void;
+}
+/** Capabilities available only when a result can re-execute its source. */
+export interface RefreshableLiveResult<TValue, TError = unknown> extends LiveResult<TValue, TError> {
+    refresh(eventOrCause?: EventBubble<unknown> | unknown): Promise<TValue>;
+    retry(eventOrCause?: EventBubble<unknown> | unknown): Promise<TValue>;
+    abort(eventOrCause?: EventBubble<unknown> | unknown): void;
+}
+//# sourceMappingURL=liveResult.d.ts.map

package/dist/emitters/liveResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveResult.d.ts","sourceRoot":"","sources":["../../src/emitters/liveResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,6BAA6B,CAAA;AAC5D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAA;AAErD,iFAAiF;AACjF,MAAM,WAAW,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAChD,SAAQ,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,OAAO,IAAI,IAAI,CAAA;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAC3D,SAAQ,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,KAAK,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACrE,KAAK,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;CAC7D"}

package/dist/index.d.ts

@@ -5,13 +5,18 @@ export type { BubbleGraph, EventListener } from './debugging/eventBus.js';
 export { BaseEmitter, DerivedEmitter } from './emitters/baseEmitter.js';
 export type { DerivedEmitterOptions, DerivedErrorEntry, DerivedErrors, EmitterNotification, EmitterOptions, EmitterValue, EmitterValues, MapOptions, ReadableEmitter, SnapshotUpdate, SubscribeOptions, } from './emitters/baseEmitter.js';
 export { Emitter } from './emitters/emitter.js';
+export { AsyncCommand, AsyncCommandConcurrencyError } from './commands/asyncCommand.js';
+export type { AsyncCommandConcurrency, AsyncCommandContext, AsyncCommandExecutor, AsyncCommandOptions, } from './commands/asyncCommand.js';
 export { LiveQuery } from './emitters/liveQuery.js';
-export type { LiveQueryOptions, QueryArgumentEmitters, QueryArgumentValues, } from './emitters/liveQuery.js';
+export type { LiveQueryPollingOptions, LiveQueryOptions, PollingScheduler, QueryArgumentEmitters, QueryArgumentValues, } from './emitters/liveQuery.js';
+export type { LiveResult, RefreshableLiveResult } from './emitters/liveResult.js';
 export { combineFetchStates, FetchState, FetchStateValues } from './enums/fetchState.js';
 export type { FetchStateValue } from './enums/fetchState.js';
 export { QueryArg } from './queryhandling/queryArg.js';
 export { QueryHandler } from './queryhandling/queryHandler.js';
 export type { AbortSignalLike, QueryHandlerLike, QueryRequestOptions, QueryValues, } from './queryhandling/queryHandler.js';
 export { RestQueryHandler } from './queryhandling/restQueryHandler.js';
-export type { FetchLike, JsonResponseLike, QuerySerializer, RestQueryHandlerOptions, SearchParamsLike, UrlLike, } from './queryhandling/restQueryHandler.js';
+export type { FetchLike, JsonResponseLike, QuerySerializer, ResultParser, RestQueryHandlerOptions, SearchParamsLike, UrlLike, } from './queryhandling/restQueryHandler.js';
+export { DerivedEndpoint, DerivedLiveResult, derivedEndpoint, QueryEndpoint, queryEndpoint, RestEndpoint, restEndpoint, } from './queryhandling/endpoints.js';
+export type { DerivedEndpointOptions, EndpointArgumentEmitters, EndpointQueryOptions, OpenDerivedEndpointOptions, QueryEndpointOptions, RestEndpointOptions, } from './queryhandling/endpoints.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAA;AACtD,YAAY,EAAC,YAAY,EAAC,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAA;AAChD,YAAY,EAAC,WAAW,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAA;AAEvE,OAAO,EAAC,WAAW,EAAE,cAAc,EAAC,MAAM,2BAA2B,CAAA;AACrE,YAAY,EACR,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,GACnB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAA;AACjD,YAAY,EACR,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAC,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAC,MAAM,uBAAuB,CAAA;AACtF,YAAY,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAC,QAAQ,EAAC,MAAM,6BAA6B,CAAA;AACpD,OAAO,EAAC,YAAY,EAAC,MAAM,iCAAiC,CAAA;AAC5D,YAAY,EACR,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,GACd,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAA;AACpE,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,gBAAgB,EAChB,OAAO,GACV,MAAM,qCAAqC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAA;AACtD,YAAY,EAAC,YAAY,EAAC,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAC,QAAQ,EAAC,MAAM,yBAAyB,CAAA;AAChD,YAAY,EAAC,WAAW,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAA;AAEvE,OAAO,EAAC,WAAW,EAAE,cAAc,EAAC,MAAM,2BAA2B,CAAA;AACrE,YAAY,EACR,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,GACnB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAC,OAAO,EAAC,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAC,YAAY,EAAE,4BAA4B,EAAC,MAAM,4BAA4B,CAAA;AACrF,YAAY,EACR,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAA;AACjD,YAAY,EACR,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAC,UAAU,EAAE,qBAAqB,EAAC,MAAM,0BAA0B,CAAA;AAE/E,OAAO,EAAC,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAC,MAAM,uBAAuB,CAAA;AACtF,YAAY,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAA;AAE1D,OAAO,EAAC,QAAQ,EAAC,MAAM,6BAA6B,CAAA;AACpD,OAAO,EAAC,YAAY,EAAC,MAAM,iCAAiC,CAAA;AAC5D,YAAY,EACR,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,WAAW,GACd,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAC,gBAAgB,EAAC,MAAM,qCAAqC,CAAA;AACpE,YAAY,EACR,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,gBAAgB,EAChB,OAAO,GACV,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACH,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,GACf,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,GACtB,MAAM,8BAA8B,CAAA"}