@synnaxlabs/client 0.56.2 → 0.57.1

package/dist/src/project/client.d.ts

@@ -0,0 +1,89 @@
+import { FileTransport, UnaryClient, UploadBody } from '@synnaxlabs/freighter';
+import { destructor, record } from '@synnaxlabs/x';
+import { z } from 'zod';
+import { imex } from '../imex';
+import { ontology } from '../ontology';
+import { Key, New, Project } from './types.gen';
+import { query } from '../query';
+export declare const SET_CHANNEL_NAME = "sy_project_set";
+export declare const DELETE_CHANNEL_NAME = "sy_project_delete";
+declare const retrieveReqZ: z.ZodObject<{
+    keys: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodInt>;
+    limit: z.ZodOptional<z.ZodInt>;
+    ignoreNotFoundError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const retrieveMultiParamsZ: z.ZodUnion<[z.ZodObject<{
+    keys: z.ZodOptional<z.ZodArray<z.ZodUUID>>;
+    searchTerm: z.ZodOptional<z.ZodString>;
+    offset: z.ZodOptional<z.ZodInt>;
+    limit: z.ZodOptional<z.ZodInt>;
+    ignoreNotFoundError: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodPipe<z.ZodArray<z.ZodUUID>, z.ZodTransform<{
+    keys: string[];
+}, string[]>>]>;
+export interface RetrieveRequest extends z.infer<typeof retrieveReqZ> {
+}
+declare const setLayoutReqZ: z.ZodObject<{
+    key: z.ZodUUID;
+    layout: z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>;
+}, z.core.$strip>;
+/** Options for a project import call. */
+export interface ImportOptions {
+    /**
+     * The name of the uploaded archive or picked directory. Its extension-stripped form
+     * names the project when the bundle carries no name.
+     */
+    fileName: string;
+}
+export interface SetLayoutParams extends z.input<typeof setLayoutReqZ> {
+}
+export interface ClientConfig {
+    unary: UnaryClient;
+    file: FileTransport;
+    cache: query.Cache;
+    ontology: ontology.Client;
+}
+export declare class Client extends query.Retriever<typeof retrieveMultiParamsZ, Key, Project> {
+    private readonly cfg;
+    private readonly store;
+    constructor(cfg: ClientConfig);
+    create(project: New, opts?: query.WriteOptions<Project[]>): Promise<Project>;
+    create(projects: New[], opts?: query.WriteOptions<Project[]>): Promise<Project[]>;
+    rename(key: Key, name: string, opts?: query.WriteOptions): Promise<void>;
+    setLayout(key: Key, layout: record.Unknown, opts?: query.WriteOptions): Promise<void>;
+    delete(key: Key, opts?: query.WriteOptions): Promise<void>;
+    delete(keys: Key[], opts?: query.WriteOptions): Promise<void>;
+    /**
+     * Exports the project and its contents as a bundle: a zip archive holding one JSON
+     * file per document and panel, group children as directories, and a manifest.json
+     * naming the project. Two members of one directory that take the same file name keep
+     * distinct names through a numeric suffix. The caller pipes the stream wherever it
+     * likes without the client buffering the whole archive.
+     * @param options - the export options, including the serialization member files are
+     * written in.
+     * @returns the bundle as a stream of zip bytes.
+     */
+    export(key: Key, options: imex.Options): Promise<ReadableStream<Uint8Array>>;
+    /**
+     * Imports a project bundle: a zip archive holding one JSON envelope per document and
+     * panel, group children as directories, and a manifest.json naming the project. The
+     * Core creates a fresh project and imports every member in a single transaction, so a
+     * failure leaves nothing behind. Legacy project directories (a root LAYOUT.json with
+     * no manifest) import through the same call.
+     *
+     * @param data - the bundle as zip bytes.
+     * @param options - the import options, including the source file's name.
+     * @returns the created project.
+     * @throws {ValidationError} if the manifest is missing, malformed, or of another
+     * bundle kind, if two member names collide, or if a member cannot be imported.
+     */
+    import(data: UploadBody, options: ImportOptions): Promise<Project>;
+    /** Subscribes to every project delete delivered to the cache. */
+    onDelete(handler: (key: Key) => void): destructor.Destructor;
+    private mergeThrough;
+    private execRetrieve;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/project/client.d.ts.map

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

package/dist/src/project/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/project/external.ts"],"names":[],"mappings":"AASA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * as project from './external';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/project/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC"}

package/dist/src/project/types.gen.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { ontology } from '../ontology';
+export declare const keyZ: z.ZodUUID;
+export type Key = z.infer<typeof keyZ>;
+/**
+ * Project is a named, persistable container that stores the layout and organization of
+ * the Console application. Projects allow users to save and restore custom arrangements
+ * of visualizations, tabs, and window configurations.
+ */
+export declare const projectZ: z.ZodObject<{
+    key: z.ZodDefault<z.ZodUUID>;
+    name: z.ZodString;
+    layout: z.ZodDefault<z.ZodRecord<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodUnknown>>;
+}, z.core.$strip>;
+export interface Project extends z.infer<typeof projectZ> {
+}
+export interface New extends z.input<typeof projectZ> {
+}
+export declare const ontologyID: ontology.CreateID<string>;
+export declare const TYPE_ONTOLOGY_ID: {
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
+    key: string;
+} | {
+    type: "arc" | "builtin" | "channel" | "device" | "framer" | "group" | "label" | "lineplot" | "log" | "node" | "panel" | "policy" | "project" | "rack" | "range" | "range-alias" | "role" | "schematic" | "schematic_symbol" | "status" | "table" | "task" | "user" | "view";
+    key: string;
+};
+//# sourceMappingURL=types.gen.d.ts.map

package/dist/src/project/types.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../../../src/project/types.gen.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,eAAO,MAAM,IAAI,WAAW,CAAC;AAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;iBAUnB,CAAC;AACH,MAAM,WAAW,OAAQ,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAC5D,MAAM,WAAW,GAAI,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC;CAAG;AAExD,eAAO,MAAM,UAAU,2BAA2C,CAAC;AACnE,eAAO,MAAM,gBAAgB;;;;;;CAAiB,CAAC"}

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

@@ -0,0 +1,132 @@
+import { breaker, destructor, record, state } from '@synnaxlabs/x';
+import { default as z } from 'zod';
+import { framer } from '../framer';
+import { DeriveParams } from './derived';
+import { Retrieves, SpaceConfig } from './query';
+import { Listener } from './streamer';
+import { Keyed, ListenerSpec, Table, TableParams } from './table';
+import { Data, Params } from './types';
+export interface CacheParams {
+    /**
+     * Opens the raw frame streamer used to receive change signals; reconnect hardening is
+     * applied internally. Null constructs a detached cache: purely local tables and no
+     * change stream. Used for clients constructed with `cache: false`.
+     */
+    openStreamer: framer.StreamOpener | null;
+    /** Retry behavior for change-stream reconnect attempts. */
+    breaker?: breaker.Config;
+    /** Called whenever the change stream goes live, before reconciliation begins. */
+    onStreamLive?: () => void;
+    /** Called when the change stream fails and reconnection begins. */
+    onStreamDrop?: (error: Error) => void;
+    /**
+     * Called when the change stream is refused because the caller lacks access to
+     * the mirrored channels. Only a policy change lifts a denial.
+     */
+    onStreamDenied?: (error: Error) => void;
+    /**
+     * Receives errors that have no caller to throw to: listener fan-out, streamer frame
+     * handling, and background reconciliation. Defaults to console logging.
+     */
+    onError?: (error: Error) => void;
+}
+/** Configuration for a derived table owned by a {@link Cache}. */
+export interface DerivedConfig<Key extends record.Key, Value extends Keyed<Key>, Composed extends Keyed<Key>> extends DeriveParams<Key, Value, Composed> {
+    /** Names the table in diagnostics. */
+    name: string;
+    /** Overrides the deep-equality default used to silence redundant sets. */
+    equal?: (a: Composed, b: Composed, key: Key) => boolean;
+}
+/** Configuration for a table owned by a {@link Cache}. */
+export interface TableConfig<Key extends record.Key = record.Key, Value extends state.State = state.State> extends Omit<TableParams<Key, Value>, "onError"> {
+    /** Names the table in diagnostics (reconciliation errors). */
+    name: string;
+    /** Mirror listeners keeping this table current from stream channels. */
+    listen?: Array<ListenerSpec<Key, Value>>;
+}
+/**
+ * The client's local mirror of cluster state: keyed tables, the change-stream loop,
+ * connection epochs, and reconciliation. Holds zero domain knowledge — domain clients
+ * create their tables here and expose typed query spaces. Always present on a client; a
+ * null {@link CacheParams.openStreamer} stands in for "disabled" or "not yet connected"
+ * rather than a null cache. The change stream opens lazily: nothing touches the network
+ * until the first {@link ensureStreaming} call. All tables and listeners must be
+ * declared before streaming starts.
+ */
+export declare class Cache {
+    private readonly tables;
+    private readonly reactions;
+    private readonly spaces;
+    private readonly detachers;
+    private readonly epochObserver;
+    private readonly params;
+    private streamer;
+    private epochCount;
+    private unmaintained;
+    /**
+     * Stable error sink for machinery built on this cache (dispatch
+     * controllers, answer spaces).
+     */
+    readonly onError: (error: Error) => void;
+    constructor(params: CacheParams);
+    /**
+     * Creates a table owned by this cache and returns it, binding its declared mirror
+     * listeners. Must be called before streaming starts; creating after {@link
+     * ensureStreaming} throws, as the new table's channels would never be streamed.
+     */
+    createTable<Key extends record.Key, Value extends state.State>(config: TableConfig<Key, Value>): Table<Key, Value>;
+    /**
+     * Creates a table materialized from another table owned by this cache. Composed
+     * entries are replaced on source and watch events, so entry identity changes exactly
+     * when composition changes; misses on read fetch through the source. Resets with the
+     * cache. No stream listeners of its own, so it may be created at any time.
+     */
+    derive<Key extends record.Key, Value extends Keyed<Key>, Composed extends Keyed<Key>>(config: DerivedConfig<Key, Value, Composed>): Table<Key, Composed>;
+    /**
+     * Registers a channel reaction: a listener that is not a table mirror
+     * (dispatch wires, cross-table side effects). Same pre-streaming
+     * constraint as {@link createTable}.
+     */
+    listen<Z extends z.ZodType>(listener: Listener<Z>): void;
+    /**
+     * Constructs an answer space wired to this cache: reads open the change
+     * stream, maintained answers refetch on epoch bumps, maintenance errors
+     * report to the cache's error sink, and the space closes with the cache.
+     */
+    queries<Q extends Params, D extends Data, K extends record.Key = record.Key, V extends state.State = state.State>(config: SpaceConfig<Q, D, K, V>): Retrieves<Q, D>;
+    /**
+     * Ensures the change stream is open, opening it on first call. Callers that
+     * populate or read tables await this first so no change is missed between a
+     * fetch and the stream opening.
+     * @throws {AccessDeniedError} if the caller cannot stream the mirrored
+     * channels. Answers stop being maintained until a later call succeeds.
+     */
+    ensureStreaming(): Promise<void>;
+    /**
+     * The connection epoch: 0 before streaming starts, 1 once live, incremented
+     * on every reconnect. Changes may have been missed between epochs.
+     */
+    get epoch(): number;
+    /** Subscribes to epoch changes. Returns a destructor that unsubscribes. */
+    onEpoch(callback: (epoch: number) => void): destructor.Destructor;
+    /**
+     * Re-checks every cached entry against the cluster: refreshes entries that
+     * still exist and tombstones entries that vanished. Runs after every
+     * reconnect for tables that declare a fetch.
+     */
+    private reconcile;
+    /**
+     * Discards every cached entry, tombstone, and answer, closes the change
+     * stream so it reopens fresh, and returns the epoch to 0. Called when the
+     * cluster behind the connection is replaced: no cached record, corpse, or
+     * answer remains meaningful, so nothing is tombstoned or diffed.
+     */
+    reset(): Promise<void>;
+    private bumpEpoch;
+    /**
+     * Closes the change stream and every answer space this cache constructed.
+     * A no-op for the stream when streaming never started.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/query/cache.d.ts.map

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

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

@@ -0,0 +1,20 @@
+import { TimeStamp } from '@synnaxlabs/x';
+declare const BRAND: unique symbol;
+/**
+ * The last value of a deleted record, delivered wherever a cached answer would be, so
+ * deletion can never be mistaken for live data. One instance exists per deletion:
+ * repeated reads of a deleted answer return the same reference.
+ */
+export declare class Deleted<D = unknown> {
+    /** The record's value at the moment it was deleted. */
+    readonly corpse: D;
+    /** When the deletion was applied. */
+    readonly deletedAt: TimeStamp;
+    protected readonly [BRAND] = true;
+    constructor(corpse: D, deletedAt: TimeStamp);
+    /** Narrows a cached answer to the deleted case, carrying its record type
+     *  onto the corpse. */
+    static matches<D>(value: D | Deleted<D> | undefined): value is Deleted<D>;
+}
+export {};
+//# sourceMappingURL=deleted.d.ts.map

package/dist/src/query/deleted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleted.d.ts","sourceRoot":"","sources":["../../../src/query/deleted.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C,QAAA,MAAM,KAAK,eAAgD,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,QAAQ;gBAEtB,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,SAAS;IAK3C;2BACuB;IACvB,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC;CAG1E"}

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

@@ -0,0 +1,33 @@
+import { destructor, record, state } from '@synnaxlabs/x';
+import { Keyed, Table, TableEvent } from './table';
+/**
+ * A foreign-table trigger for a derived table: projects that table's events onto the
+ * source keys whose composition they change. Build with {@link deriveWatch}.
+ */
+export interface DeriveWatch<K extends record.Key> {
+    attach: (recompose: (keys: K[] | "all") => void) => destructor.Destructor;
+}
+/**
+ * Declares that events on the given table change composed entries. `affects`
+ * maps an event to the source keys whose composition it touches, "all" to
+ * recompose every entry, or null when unaffected.
+ */
+export declare const deriveWatch: <K extends record.Key, ForeignKey extends record.Key, ForeignValue extends state.State>(table: Table<ForeignKey, ForeignValue>, affects: (event: TableEvent<ForeignKey, ForeignValue>) => K[] | "all" | null) => DeriveWatch<K>;
+/** Derivation wiring shared by {@link Cache.derive}. */
+export interface DeriveParams<K extends record.Key, V extends Keyed<K>, CV extends Keyed<K>> {
+    /** The table owning the raw records the derivation reads. */
+    source: Table<K, V>;
+    /** Builds the composed entry for one source record. Pure; no network. */
+    compose: (record: V) => CV;
+    /** Foreign tables whose events change composition. */
+    watch?: Array<DeriveWatch<K>>;
+}
+/**
+ * Keeps a derived table materialized from its source: composed entries are
+ * replaced (never mutated) on source and watch events, so an entry's identity
+ * changes exactly when its composition changes, with equal recompositions
+ * silenced by the table's equality check. Existing source entries are composed
+ * immediately. Returns a destructor that detaches every subscription.
+ */
+export declare const bindDerived: <K extends record.Key, V extends Keyed<K>, CV extends Keyed<K>>(into: Table<K, CV>, { source, compose, watch }: DeriveParams<K, V, CV>) => destructor.Destructor;
+//# sourceMappingURL=derived.d.ts.map

package/dist/src/query/derived.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../../src/query/derived.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG;IAC/C,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,KAAK,IAAI,KAAK,UAAU,CAAC,UAAU,CAAC;CAC3E;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,CAAC,SAAS,MAAM,CAAC,GAAG,EACpB,UAAU,SAAS,MAAM,CAAC,GAAG,EAC7B,YAAY,SAAS,KAAK,CAAC,KAAK,EAEhC,OAAO,KAAK,CAAC,UAAU,EAAE,YAAY,CAAC,EACtC,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,IAAI,KAC3E,WAAW,CAAC,CAAC,CAcd,CAAC;AAEH,wDAAwD;AACxD,MAAM,WAAW,YAAY,CAC3B,CAAC,SAAS,MAAM,CAAC,GAAG,EACpB,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,EAClB,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC;IAEnB,6DAA6D;IAC7D,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpB,yEAAyE;IACzE,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IAC3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,CAAC,SAAS,MAAM,CAAC,GAAG,EACpB,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,EAClB,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,EAEnB,MAAM,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAClB,4BAA4B,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KACjD,UAAU,CAAC,UAuBb,CAAC"}

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

@@ -0,0 +1,10 @@
+export { Cache, type CacheParams, type DerivedConfig, type TableConfig, } from './cache';
+export { Deleted } from './deleted';
+export { type DeriveWatch, deriveWatch } from './derived';
+export { type Cached, type ChangeHandler, hash, isLive, requireCorpse, type Retrieves, type SpaceConfig, type Watch, watch, } from './query';
+export { keyListZ, Retriever, type RetrieverParams } from './retriever';
+export { type Listener } from './streamer';
+export { createDeleteListener, createFetchListener, createSetListener, type EntryStatus, type HydrateMode, type Keyed, type ListenerSpec, partialUpdate, Table, type TableEvent, type TableParams, type TableSubscriber, } from './table';
+export { type Data, type FetchOptions, type Params, type WriteOptions, } from './types';
+export { optimistic, type OptimisticParams } from './write';
+//# sourceMappingURL=external.d.ts.map

package/dist/src/query/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/query/external.ts"],"names":[],"mappings":"AASA,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,IAAI,EACJ,MAAM,EACN,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,GACN,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,aAAa,EACb,KAAK,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,MAAM,EACX,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,2 @@
+export * as query from './external';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/query/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC"}

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

@@ -0,0 +1,235 @@
+import { destructor, record, state, TimeSpan } from '@synnaxlabs/x';
+import { Deleted } from './deleted';
+import { Table, TableEvent } from './table';
+import { Data, FetchOptions, Params } from './types';
+/**
+ * Deterministically serializes query params to a stable string. Keys are sorted
+ * recursively so `{a: 1, b: 2}` and `{b: 2, a: 1}` collapse to the same key, and
+ * explicitly-undefined fields hash like absent ones (matching JSON semantics). Class
+ * instances implementing {@link primitive.Hashable} delegate to their `hash()` method;
+ * plain objects and arrays recurse structurally, memoized per object identity ({@link
+ * Params} is readonly, so an object's hash never changes).
+ */
+export declare const hash: (params: Params) => string;
+/**
+ * A cached answer as delivered to consumers: the query's current data, or the
+ * {@link Deleted} corpse of a record that was deleted. A corpse is never
+ * delivered as bare data, so deletion cannot be mistaken for a live result.
+ * Narrow with {@link isLive}, or {@link Deleted.matches} to reach the corpse.
+ */
+export type Cached<D extends Data> = D | Deleted<D>;
+/** True when a cached answer is live: cached at all, and not a deletion. */
+export declare const isLive: <D extends Data>(value: Cached<D> | undefined) => value is D;
+/**
+ * Returns the corpse of a deleted answer, for callers that need the record's
+ * last value (restoring it, say) and have no use for any other outcome.
+ * @throws {NotFoundError} if the answer is live or nothing is cached.
+ */
+export declare const requireCorpse: <D extends Data>(value: Cached<D> | undefined) => D;
+/**
+ * Receives the new cached answer for a query. `undefined` means the answer was
+ * invalidated; the next read refetches.
+ */
+export interface ChangeHandler<D extends Data> {
+    (result: Cached<D> | undefined): void;
+}
+/**
+ * The read surface of one query space: fetch, subscribe, snapshot. The public
+ * face of every answer space, including the named spaces domain clients
+ * expose (children, parents, kv).
+ */
+export interface Retrieves<P extends Params, D extends Data> {
+    retrieve: (params: P, options?: FetchOptions) => Promise<D>;
+    onChange: (params: P, handler: ChangeHandler<D>) => destructor.Destructor;
+    getCached: (params: P) => Cached<D> | undefined;
+}
+/**
+ * A foreign-table subscription for an answer space: projects that table's
+ * events onto the space's primary keys. Build with {@link watch}.
+ */
+export interface Watch<P extends Params, K extends record.Key> {
+    attach: (params: P, onEvent: (result: K[] | "refetch") => void) => destructor.Destructor;
+}
+/**
+ * Declares that events on the given table affect answers in this space.
+ * `affects` maps an event to the primary keys whose membership or content it
+ * touches, "refetch" to invalidate wholesale, or null when unaffected.
+ */
+export declare const watch: <P extends Params, K extends record.Key, ForeignKey extends record.Key, ForeignValue extends state.State>(table: Table<ForeignKey, ForeignValue>, affects: (event: TableEvent<ForeignKey, ForeignValue>, params: P) => K[] | "refetch" | null) => Watch<P, K>;
+/**
+ * Declaration of one query space: which table owns its records, how to fetch
+ * an answer's keys, how to assemble content, and how membership is maintained.
+ *
+ * Maintenance is chosen per query instance:
+ * 1. exact-key — `keyOf` returns a key: track that entry; deletion flips the
+ *    answer to deleted.
+ * 2. client-checkable — `matches` compares a record against the query:
+ *    admit/evict exactly, no network.
+ * 3. server-computed — any field named in `serverFields` is set on the query
+ *    (or neither `keyOf` nor `matches` applies): debounced wholesale refetch.
+ */
+export interface SpaceConfig<P extends Params, D extends Data, K extends record.Key = record.Key, V extends state.State = state.State> {
+    /** Resource name used in error messages, e.g. "range". */
+    name: string;
+    /** The table owning this space's record content. */
+    table: Table<K, V>;
+    /**
+     * Fetches the answer from the cluster: writes fetched records into their
+     * tables and returns the member keys.
+     */
+    fetch: (params: P, options?: FetchOptions) => Promise<K[]>;
+    /** Assembles the answer from resolved member records at read time. */
+    compose: (records: V[], params: P) => D;
+    /** Rule 1: the single key a query addresses, or null when it doesn't. */
+    keyOf?: (params: P) => K | null;
+    /**
+     * The exact key set a keys-only query addresses, or null when it doesn't. Lets
+     * getCached compose the answer straight from the table (params order, deduped,
+     * tombstoned members omitted) and lets maintenance seed a ready answer on
+     * subscribe, so a fully cached key set never fetches.
+     */
+    keysOf?: (params: P) => K[] | null;
+    /** Rule 2: whether a record satisfies the query. Pure; no network. */
+    matches?: (record: V, params: P) => boolean;
+    /**
+     * Query fields only the server can evaluate (searchTerm, limit, offset).
+     * A query instance with any of them set is maintained by rule 3.
+     */
+    serverFields?: readonly string[];
+    /** Foreign tables whose events affect this space's answers. */
+    watch?: Watch<P, K>[];
+    /**
+     * Marks a space whose answer addresses one record and cannot compose an
+     * empty membership: rule-2 eviction of the last member flips the query to
+     * deleted (when the entry tombstoned) or invalidates it, instead of
+     * composing []. Leave unset for spaces where [] is a valid answer.
+     */
+    single?: boolean;
+}
+/** Wiring a {@link Space} receives from the cache that owns it. */
+export interface SpaceHooks {
+    /** Started (not awaited) on reads and subscriptions to open change delivery. */
+    ensureStreaming?: () => Promise<void>;
+    /** Subscribes to connection-epoch changes; maintained answers refetch on bump. */
+    onEpoch?: (callback: (epoch: number) => void) => destructor.Destructor;
+    /**
+     * Whether change delivery keeps subscribed answers current. False when the
+     * cache is detached or the cluster refused the stream. Defaults to true.
+     */
+    maintained?: () => boolean;
+    /** Reports maintenance errors that have no caller to throw to. Defaults to
+     *  console logging. */
+    onError?: (error: Error) => void;
+    /**
+     * How long maintenance survives the last unsubscribe, so a quick remount finds
+     * the answer still maintained and skips the reconfirm refetch. Zero tears down
+     * synchronously. Defaults to 5 seconds.
+     */
+    teardownGrace?: TimeSpan;
+}
+/**
+ * Cached read path for one query space of a domain client: deduped fetches, per-query
+ * lifecycle, subscriptions, and deletion delivery. Answers hold only key lists; record
+ * content lives in tables and is assembled at read time, so answer content cannot
+ * diverge from the record cache. Answers are maintained only while subscribed. An
+ * unsubscribed read refetches; an unsubscribed getCached serves the retained (possibly
+ * stale) answer, recomposed against live tables.
+ */
+export declare class Space<P extends Params, D extends Data, K extends record.Key = record.Key, V extends state.State = state.State> {
+    private readonly queries;
+    /** Composed corpses interned per tombstone and params, so deleted answers
+     *  stay referentially stable. Identity composes reuse the tombstone. */
+    private readonly corpses;
+    /** Answers for reads with no live query, interned per entry and params. */
+    private readonly entryAnswers;
+    private readonly config;
+    private readonly hooks;
+    private readonly detachEpoch?;
+    private readonly grace;
+    private sweepTimer?;
+    constructor(config: SpaceConfig<P, D, K, V>, hooks?: SpaceHooks);
+    /**
+     * Returns the answer to the query: instantly when cached and subscribed,
+     * joining the in-flight fetch when one exists, fetching otherwise. Settled
+     * answers are kept fresh only while maintained (subscribed, or within the teardown
+     * grace window after the last unsubscribe, and only while change delivery is on),
+     * so an unmaintained read always refetches. A previously failed query refetches.
+     * @throws {NotFoundError} if the queried record was deleted.
+     */
+    retrieve(params: P, options?: FetchOptions): Promise<D>;
+    /**
+     * Returns the cached answer without touching the network: the current data,
+     * the corpse of a deleted record, or undefined when nothing is cached.
+     * Exact-key queries also resolve from a table entry cached by any other
+     * query. May be stale for queries nothing subscribes to.
+     */
+    getCached(params: P): Cached<D> | undefined;
+    /**
+     * Resolves a keys-only query's key list against the table: deduped, in params order,
+     * tombstoned keys omitted to match the fetch answer. Returns null when any key is
+     * unknown, since only a fetch can tell an uncached record from a nonexistent one.
+     */
+    private composableMembersOf;
+    /**
+     * Subscribes to changes in the query's cached answer. The handler fires with the new
+     * answer on every change or deletion. Maintenance for the query runs while at least
+     * one subscriber exists and survives the last unsubscribe by the grace window, so a
+     * quick remount skips the reconfirm refetch. Returns a destructor that unsubscribes.
+     */
+    onChange(params: P, handler: ChangeHandler<D>): destructor.Destructor;
+    /**
+     * Resets every answer to unfetched and notifies subscribers that their answer was
+     * invalidated, so the next read refetches. Maintenance subscriptions stay mounted.
+     * Called by the cache when the cluster behind the connection is replaced.
+     */
+    reset(): void;
+    /** Detaches the epoch subscription. Queries and handlers are dropped. */
+    close(): void;
+    private teardownQuery;
+    /** Arms the sweep while any query sits in the grace window. One timer per
+     *  space, no matter how many queries go idle at once. */
+    private armSweep;
+    private sweep;
+    private ensure;
+    private startStreaming;
+    private report;
+    /** Composes a ready answer, interned against the records it was built from. */
+    private composedOf;
+    private cachedOf;
+    /** Composes a rule-1 answer for a read with no live query, interned per entry
+     *  and params. The memo dies with the entry it is keyed on, which a table
+     *  replaces on every content change. */
+    private entryAnswerOf;
+    private deletedOf;
+    /** Notifies subscribers when any of the keys is a member of the ready
+     *  answer; otherwise just drops the memo so the next read recomposes. */
+    private touchMembers;
+    /** Notifies every subscriber with the query's current answer. */
+    private touch;
+    private settle;
+    /**
+     * Replays membership changes a fetch in flight deferred. The fetch answers the query
+     * as of when it ran, so a change that raced it would otherwise be lost under the keys
+     * it publishes. Applies quietly: the settle that calls this notifies once for the
+     * whole answer.
+     */
+    private drainRechecks;
+    private fetch;
+    /** Never rejects: a failed refetch leaves the previous answer in place. */
+    private refetch;
+    private scheduleRefetch;
+    private isServerComputed;
+    private maintain;
+    /**
+     * Applies membership rechecks for the given keys against the table's current entries,
+     * without notifying. Admissions append in iteration order; evicting a single space's
+     * last member flips the query to deleted or unfetched. Returns whether the answer
+     * changed: membership moved, or a member's content was touched.
+     */
+    private applyRechecks;
+    /** Applies rechecks for the keys, then notifies once when anything changed. */
+    private recheckKeys;
+    /** Never rejects: a failed backfill is reported and the recheck is skipped. */
+    private recheckMany;
+}
+//# sourceMappingURL=query.d.ts.map

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

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