@procedures/collections 0.8.0 → 0.9.0

package/dist/overlay/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/overlay/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,KAAK,EACL,aAAa,EACb,WAAW,EACX,OAAO,EACP,WAAW,EACX,WAAW,GAIZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,OAAO,EAA0D,MAAM,aAAa,CAAC"}

package/dist/overlay/overlay.d.ts

@@ -0,0 +1,55 @@
+/**
+ * The overlay: one logical document read through a stack of layers (for example the scopes of a
+ * space, a board, a group and a user). Each layer can hold its own copy of the document. A read
+ * merges the copies, top layer first:
+ *
+ * - The mode `field` (the default): each top-level field comes from the highest copy that has it. A
+ *   copy that sets a field to `UNSET` hides the lower values of that field.
+ * - The mode `doc`: the highest copy wins whole.
+ * - A copy with `_deleted: true` hides the whole logical document, and in the mode `field` also the
+ *   copies under it.
+ *
+ * A copy of the mode `field` is the same as the patch operations of `applyPatch` over the copies
+ * under it: its fields are `$set`, and its `UNSET` fields are `$unset` (refer to `copyAsPatch`).
+ * It is not a JSON Merge Patch: in a copy, `null` is a value, and an object field replaces the
+ * lower object whole.
+ */
+import type { StoragePatchOperations } from "@procedures/client/query";
+/**
+ * The value that hides a field of the lower layers (`{ field: UNSET }` in an upper copy). Its key has
+ * no `$`, because MongoDB refuses or warns about field names that start with `$`.
+ */
+export declare const UNSET: Readonly<{
+    __unset: true;
+}>;
+/** The field of a copy that hides the whole logical document. */
+export declare const DELETED_FIELD = "_deleted";
+/** The field of a copy that names its layer. A merge removes it. */
+export declare const LAYER_FIELD = "_scope";
+/** How the copies of a document merge: field by field, or the top copy whole. */
+export type MergeMode = "field" | "doc";
+/** The options of `mergeCopies` and `copyAsPatch`: the names of the fields of the overlay. */
+export interface OverlayFields {
+    /** The field that hides the whole document (default `_deleted`). */
+    readonly deleted?: string | undefined;
+    /** The field that names the layer of a copy (default `_scope`). A merge removes it. */
+    readonly layer?: string | undefined;
+}
+/** A copy of a logical document in one layer. */
+export type LayerCopy = Readonly<Record<string, unknown>>;
+/** True when a value is the `UNSET` marker (an object with only `__unset: true`). */
+export declare function isUnset(value: unknown): boolean;
+/**
+ * This function merges the copies of one logical document. `copies` is in the order of the stack,
+ * top layer first, with `undefined` for a layer without a copy. It gives the merged document
+ * without the fields of the overlay, or `undefined` when no copy exists or the top copy is deleted.
+ */
+export declare function mergeCopies(copies: ReadonlyArray<LayerCopy | undefined>, mode?: MergeMode, fields?: OverlayFields): Record<string, unknown> | undefined;
+/**
+ * This function gives a copy of the mode `field` as the patch operations of `applyPatch`: its
+ * fields as `$set` and its `UNSET` fields as `$unset`. `applyPatch(lower, copyAsPatch(copy))` then
+ * gives the merge of the copy over `lower`. A field name with a dot is a path for `applyPatch`, so
+ * the two agree only for field names without a dot.
+ */
+export declare function copyAsPatch(copy: LayerCopy, fields?: OverlayFields): StoragePatchOperations;
+//# sourceMappingURL=overlay.d.ts.map

package/dist/overlay/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/overlay/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAA6C,CAAC;AAE5F,iEAAiE;AACjE,eAAO,MAAM,aAAa,aAAa,CAAC;AAExC,oEAAoE;AACpE,eAAO,MAAM,WAAW,WAAW,CAAC;AAEpC,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC;AAExC,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE1D,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ/C;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,CAAC,SAAS,GAAG,SAAS,CAAC,EAC5C,IAAI,GAAE,SAAmB,EACzB,MAAM,GAAE,aAAkB,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAwBrC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,GAAE,aAAkB,GAAG,sBAAsB,CAQ/F"}

package/dist/overlay/overlay.js

@@ -0,0 +1,82 @@
+/**
+ * The value that hides a field of the lower layers (`{ field: UNSET }` in an upper copy). Its key has
+ * no `$`, because MongoDB refuses or warns about field names that start with `$`.
+ */
+export const UNSET = Object.freeze({ __unset: true });
+/** The field of a copy that hides the whole logical document. */
+export const DELETED_FIELD = "_deleted";
+/** The field of a copy that names its layer. A merge removes it. */
+export const LAYER_FIELD = "_scope";
+/** True when a value is the `UNSET` marker (an object with only `__unset: true`). */
+export function isUnset(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        value.__unset === true &&
+        Object.keys(value).length === 1);
+}
+/**
+ * This function sets an own field. An assignment with the key `__proto__` changes the prototype,
+ * and a copy from `JSON.parse` or a database can have that key (the same rule as `applyPatch`).
+ */
+function put(target, key, value) {
+    Object.defineProperty(target, key, { value, enumerable: true, writable: true, configurable: true });
+}
+/** The fields of a copy without the fields of the overlay. */
+function withoutOverlayFields(copy, fields) {
+    const { [fields.deleted ?? DELETED_FIELD]: _deleted, [fields.layer ?? LAYER_FIELD]: _layer, ...rest } = copy;
+    return rest;
+}
+/**
+ * This function merges the copies of one logical document. `copies` is in the order of the stack,
+ * top layer first, with `undefined` for a layer without a copy. It gives the merged document
+ * without the fields of the overlay, or `undefined` when no copy exists or the top copy is deleted.
+ */
+export function mergeCopies(copies, mode = "field", fields = {}) {
+    const deleted = fields.deleted ?? DELETED_FIELD;
+    const present = copies.filter((copy) => copy !== undefined && copy !== null);
+    const top = present[0];
+    if (top === undefined || top[deleted] === true)
+        return undefined;
+    if (mode === "doc") {
+        const whole = withoutOverlayFields(top, fields);
+        for (const key of Object.keys(whole))
+            if (isUnset(whole[key]))
+                delete whole[key];
+        return whole;
+    }
+    // From the bottom copy up: a deleted copy lower down hides only the copies under it
+    let merged = {};
+    for (let index = present.length - 1; index >= 0; index--) {
+        const copy = present[index];
+        if (copy[deleted] === true) {
+            merged = {};
+            continue;
+        }
+        for (const [key, value] of Object.entries(withoutOverlayFields(copy, fields))) {
+            if (isUnset(value))
+                delete merged[key];
+            else
+                put(merged, key, value);
+        }
+    }
+    return merged;
+}
+/**
+ * This function gives a copy of the mode `field` as the patch operations of `applyPatch`: its
+ * fields as `$set` and its `UNSET` fields as `$unset`. `applyPatch(lower, copyAsPatch(copy))` then
+ * gives the merge of the copy over `lower`. A field name with a dot is a path for `applyPatch`, so
+ * the two agree only for field names without a dot.
+ */
+export function copyAsPatch(copy, fields = {}) {
+    const set = {};
+    const unset = [];
+    for (const [key, value] of Object.entries(withoutOverlayFields(copy, fields))) {
+        if (isUnset(value))
+            unset.push(key);
+        else
+            put(set, key, value);
+    }
+    return { $set: set, $unset: unset };
+}
+//# sourceMappingURL=overlay.js.map

package/dist/overlay/overlay.js.map

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

package/dist/overlay/stacks.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The stacks of the overlay from rules. Each rule gives, for collections (and, when it names them,
+ * for some documents), a read stack (top layer first), the write targets (the first one is the
+ * default) and a merge mode. A rule names layers with variables, and the app resolves them, for
+ * example `$me` to the layer of the signed-in user. The first rule for a document wins, so a rule
+ * for some documents goes before the rule of their collection.
+ */
+import type { MergeMode } from "./overlay.js";
+/** A rule of the overlay, with the layers as variables or names. */
+export interface StackRule {
+    /** A collection, a list of collections, or a pattern that the app gives a meaning (for example `*`). */
+    readonly collection: string | readonly string[];
+    /** Only these documents (logical ids) of the collection. */
+    readonly doc?: string | readonly string[] | undefined;
+    /** The read stack, top layer first. */
+    readonly read: readonly string[];
+    /** The write targets. The default is the top layer of the read stack. */
+    readonly write?: string | readonly string[] | undefined;
+    /** The merge mode (default `field`). */
+    readonly mode?: MergeMode | undefined;
+}
+/** A resolved stack: for some documents (`docs`) or for all the documents of a collection. */
+export interface ResolvedStack {
+    readonly docs?: readonly string[];
+    /** The read stack, top layer first. */
+    readonly layers: readonly string[];
+    /** The write targets. The first one is the default. */
+    readonly write: readonly string[];
+    readonly mode: MergeMode;
+}
+/** The function that gives the layer of a variable or a name, or `undefined` for none. */
+export type LayerResolver = (variable: string) => string | undefined;
+/**
+ * This function resolves the rules to the stacks of each collection. A rule whose read stack
+ * resolves to no layer does not apply. After a rule for all the documents of a collection, a later
+ * rule of that collection does not apply.
+ */
+export declare function resolveStacks(rules: readonly StackRule[] | undefined, resolve: LayerResolver): Map<string, ResolvedStack[]>;
+/**
+ * This function gives the stack of a document: the first stack of its collection that names the
+ * document or names no documents, or `undefined` when the collection has no stack.
+ */
+export declare function stackOf(stacks: ReadonlyMap<string, readonly ResolvedStack[]>, collection: string, id?: string): ResolvedStack | undefined;
+//# sourceMappingURL=stacks.d.ts.map

package/dist/overlay/stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../src/overlay/stacks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oEAAoE;AACpE,MAAM,WAAW,SAAS;IACxB,wGAAwG;IACxG,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAChD,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtD,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACxD,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B;AAED,0FAA0F;AAC1F,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAIrE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAwB3H;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEzI"}

package/dist/overlay/stacks.js

@@ -0,0 +1,43 @@
+const listOf = (value) => (value === undefined ? [] : typeof value === "string" ? [value] : [...value]);
+/**
+ * This function resolves the rules to the stacks of each collection. A rule whose read stack
+ * resolves to no layer does not apply. After a rule for all the documents of a collection, a later
+ * rule of that collection does not apply.
+ */
+export function resolveStacks(rules, resolve) {
+    const stacks = new Map();
+    for (const rule of rules ?? []) {
+        if (typeof rule !== "object" || rule === null)
+            continue;
+        const resolved = (values) => values.map((value) => resolve(value)).filter((layer) => typeof layer === "string" && layer !== "");
+        const layers = [...new Set(resolved(listOf(rule.read)))];
+        if (layers.length === 0)
+            continue;
+        const write = resolved(listOf(rule.write));
+        const docs = rule.doc === undefined ? undefined : listOf(rule.doc);
+        const stack = {
+            ...(docs ? { docs } : {}),
+            layers,
+            write: write.length > 0 ? write : [layers[0]],
+            mode: rule.mode === "doc" ? "doc" : "field",
+        };
+        for (const collection of listOf(rule.collection)) {
+            if (typeof collection !== "string" || collection === "")
+                continue;
+            const list = stacks.get(collection) ?? [];
+            if (list.some((entry) => !entry.docs))
+                continue;
+            list.push(stack);
+            stacks.set(collection, list);
+        }
+    }
+    return stacks;
+}
+/**
+ * This function gives the stack of a document: the first stack of its collection that names the
+ * document or names no documents, or `undefined` when the collection has no stack.
+ */
+export function stackOf(stacks, collection, id) {
+    return stacks.get(collection)?.find((stack) => !stack.docs || (id !== undefined && stack.docs.includes(id)));
+}
+//# sourceMappingURL=stacks.js.map

package/dist/overlay/stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.js","sourceRoot":"","sources":["../../src/overlay/stacks.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,GAAG,CAAC,KAA6C,EAAY,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAE1J;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAuC,EAAE,OAAsB;IAC3F,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QACxD,MAAM,QAAQ,GAAG,CAAC,MAAgB,EAAY,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACrK,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,MAAM,KAAK,GAAkB;YAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YAC9C,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;SAC5C,CAAC;QACF,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE;gBAAE,SAAS;YAClE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAChD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAqD,EAAE,UAAkB,EAAE,EAAW;IAC5G,OAAO,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/G,CAAC"}

package/dist/storage/index.d.ts

@@ -1,16 +1,21 @@
 /**
- * Collection Storage Backends
+ * The storages of the collections.
  *
- * Abstract storage layer enabling collections to be backed by:
- * - In-memory (fast, volatile)
+ * This package has the contract `CollectionStorage` and one storage, `InMemoryStorage` (fast,
+ * in memory only).
  *
- * The backends that need an RPC Client (ApiStorage: remote API, HybridStorage: local
- * cache + remote sync) live in @procedures/client and are exported from
- * "@procedures/client/collections". Keeping them there means this package
- * does not depend on the client package.
+ * The storages that need a `Client` are in `@procedures/store`: `ApiStorage` (a remote
+ * collection) and `HybridStorage` (a local copy that syncs with a remote). `MongoStorage` is in
+ * `@procedures/mongo`, and `SqliteStorage` is in `@procedures/sqlite`. This package uses only the
+ * query language of the core, from the entry `@procedures/client/query`, which imports nothing
+ * else (roadmap CLI-34).
  */
-export type { CollectionStorage, StorageChanges, StorageMetadata } from "./interface.js";
+export type { CollectionStorage, StorageChanges, StorageMetadata, StorageWriteOptions, StorageSetChange, StorageDeleteChange, StorageClearChange, StorageChangeEvent, StorageChangeBatch, StorageObserver, } from "./interface.js";
 export { normalizeStorageResult } from "./interface.js";
+export { DEFAULT_FIND_LIMIT, DEFAULT_QUERY_OPERATORS, DEFAULT_QUERY_POLICY, QUERY_OPERATORS, applyPatch, compareStorageValues, compileSelector, isPatchOperations, matchesSelector, mergePatch, patchProblems, queryEntries, queryOptionsProblems, selectorProblems, } from "@procedures/client/query";
+export type { StorageFieldOperators, StoragePatch, StoragePatchOperations, StorageQueryOperator, StorageQueryOptions, StorageQueryPolicy, StorageSelector, StorageSort, StorageSortDirection, } from "@procedures/client/query";
+export { StorageListeners, reportListenerError } from "./listeners.js";
+export type { ListenerErrorHandler } from "./listeners.js";
 export { InMemoryStorage } from "./memory.js";
 export type { InMemoryStorageOptions } from "./memory.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage/index.js

@@ -1,14 +1,20 @@
 /**
- * Collection Storage Backends
+ * The storages of the collections.
  *
- * Abstract storage layer enabling collections to be backed by:
- * - In-memory (fast, volatile)
+ * This package has the contract `CollectionStorage` and one storage, `InMemoryStorage` (fast,
+ * in memory only).
  *
- * The backends that need an RPC Client (ApiStorage: remote API, HybridStorage: local
- * cache + remote sync) live in @procedures/client and are exported from
- * "@procedures/client/collections". Keeping them there means this package
- * does not depend on the client package.
+ * The storages that need a `Client` are in `@procedures/store`: `ApiStorage` (a remote
+ * collection) and `HybridStorage` (a local copy that syncs with a remote). `MongoStorage` is in
+ * `@procedures/mongo`, and `SqliteStorage` is in `@procedures/sqlite`. This package uses only the
+ * query language of the core, from the entry `@procedures/client/query`, which imports nothing
+ * else (roadmap CLI-34).
  */
 export { normalizeStorageResult } from "./interface.js";
+// The query language: the selectors, the options, the query policy and the patches (roadmap
+// CLI-14, CLI-20). The one copy is in the core (CLI-34): these names come from there.
+export { DEFAULT_FIND_LIMIT, DEFAULT_QUERY_OPERATORS, DEFAULT_QUERY_POLICY, QUERY_OPERATORS, applyPatch, compareStorageValues, compileSelector, isPatchOperations, matchesSelector, mergePatch, patchProblems, queryEntries, queryOptionsProblems, selectorProblems, } from "@procedures/client/query";
+// The listeners of the events of a storage
+export { StorageListeners, reportListenerError } from "./listeners.js";
 export { InMemoryStorage } from "./memory.js";
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAExD,4FAA4F;AAC5F,sFAAsF;AACtF,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAalC,2CAA2C;AAC3C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/storage/interface.d.ts

@@ -1,15 +1,18 @@
 /**
- * Collection Storage Interface
+ * The interface of the collection storages. These storages implement it:
+ * - `InMemoryStorage` (this package): a fast storage in a `Map`, in memory only.
+ * - `ApiStorage` (`@procedures/store`): a remote collection through a `Client`.
+ * - `HybridStorage` (`@procedures/store`): a local copy that syncs with a remote, with a
+ *   conflict policy and a queue of the local writes.
+ * - `MongoStorage` (`@procedures/mongo`).
  *
- * Abstract storage layer for collections, enabling different backends:
- * - InMemoryStorage: Fast, volatile storage using Map
- * - ApiStorage: Remote persistence via universal client
- * - HybridStorage: Local cache + remote sync with conflict resolution
- * - SyncedStorage: Periodic background sync with offline support
+ * `@procedures/client` declares a copy of this interface with the same shape, so that the core
+ * does not depend on this package. `SqliteStorage` (`@procedures/sqlite`) implements that copy.
  *
- * IMPORTANT: All methods return Promise to ensure client code is
- * transport-agnostic (cannot distinguish local from remote storage).
+ * Each method gives a `Promise`. Thus the code of a caller cannot tell a local storage from a
+ * remote storage.
  */
+import type { StoragePatch, StorageQueryOptions, StorageQueryPolicy, StorageSelector } from "@procedures/client/query";
 /**
  * Storage backend interface for collections.
  *
@@ -25,6 +28,11 @@
  * - A delta of `getChangesSince` follows the order of the last change of each id.
  * - After `close()`, each operation rejects with an error whose message says "closed". A second
  *   `close()` does nothing.
+ * - `query()` gives the result of `queryEntries()` for the entries of the storage.
+ * - `observe()` gives one batch for each write that changes the storage, before the write resolves.
+ * - `patch()` changes the item in one step: two patches at the same time keep each field.
+ *
+ * The optional methods are features: a caller tests for each one before it uses it.
  */
 export interface CollectionStorage<T> {
     /**
@@ -71,6 +79,35 @@ export interface CollectionStorage<T> {
      * @returns Promise resolving to array of matching items
      */
     find(predicate: (item: T) => boolean): Promise<T[]>;
+    /**
+     * The entries whose items match a selector, with an order, a skip and a limit. The selector is
+     * JSON, so a remote storage sends it to its server, and a database can run it itself. The result
+     * is the result of `queryEntries()` for the entries of the storage. A storage without this method
+     * does not run selectors: a caller uses `queryEntries()` on the entries.
+     *
+     * @param selector - The selector. `{}` matches each item.
+     * @param options - The order, the skip and the limit
+     * @param policy - The query policy of the caller: the procedure `find` gives the policy of the
+     *   host. Without it, the storage uses its own policy. The default policy does not permit `$regex`.
+     * @returns Promise resolving to the [id, item] pairs, with copies of the items. A selector or
+     *   options with a problem, or that the policy does not permit, reject with a `TypeError`.
+     */
+    query?(selector: StorageSelector, options?: StorageQueryOptions, policy?: StorageQueryPolicy): Promise<Array<[string, T]>>;
+    /**
+     * This method starts to send the changes of the storage to an observer. Each write that changes
+     * the storage gives one batch, before the write resolves. A write that changes nothing gives no
+     * batch. A storage without this method does not tell its changes.
+     *
+     * - A set gives a `set` change with a copy of the value. A patch gives a `set` change with the new item.
+     * - A delete gives a `delete` change for each id that existed.
+     * - A clear of a storage with items gives one `clear` change.
+     * - Each change has the `origin` of the write options, or no origin.
+     *
+     * @param observer - The function that gets each batch. Its error does not change the write.
+     * @returns The function that stops the batches. A second use of it does nothing.
+     * @throws Error after `close()`
+     */
+    observe?(observer: StorageObserver<T>): () => void;
     /**
      * Check if item exists.
      *
@@ -89,36 +126,55 @@ export interface CollectionStorage<T> {
      *
      * @param id - Item identifier
      * @param value - Item to store
+     * @param options - The origin of the write, for the observers
      * @returns Promise resolving when operation completes
      */
-    set(id: string, value: T): Promise<void>;
+    set(id: string, value: T, options?: StorageWriteOptions): Promise<void>;
     /**
      * Delete item by ID.
      *
      * @param id - Item identifier
+     * @param options - The origin of the write, for the observers
      * @returns Promise resolving to true if item was deleted, false if not found
      */
-    delete(id: string): Promise<boolean>;
+    delete(id: string, options?: StorageWriteOptions): Promise<boolean>;
     /**
      * Clear all items from collection.
      *
+     * @param options - The origin of the write, for the observers
      * @returns Promise resolving when operation completes
      */
-    clear(): Promise<void>;
+    clear(options?: StorageWriteOptions): Promise<void>;
+    /**
+     * This method changes one item in one step. The fields are a JSON Merge Patch (RFC 7386): each
+     * field replaces the field of the item, an object field merges into an object field, and `null`
+     * removes the field. Or they are the operations `{ $set, $unset }`: `$set` can set `null` and
+     * nested field paths. Two patches of one item at the same time keep the fields of each. A storage
+     * without this method cannot change an item in one step.
+     *
+     * @param id - Item identifier
+     * @param fields - The fields: an object of one form. Another value rejects with a `TypeError`.
+     * @param options - The origin of the write, for the observers
+     * @returns Promise resolving to a copy of the new item, or undefined when the id has no item. A
+     *   missing id stays missing.
+     */
+    patch?(id: string, fields: StoragePatch, options?: StorageWriteOptions): Promise<T | undefined>;
     /**
      * Set multiple items at once (more efficient than individual sets).
      *
      * @param items - Array of [id, value] tuples
+     * @param options - The origin of the write, for the observers
      * @returns Promise resolving when operation completes
      */
-    setBatch(items: Array<[string, T]>): Promise<void>;
+    setBatch(items: Array<[string, T]>, options?: StorageWriteOptions): Promise<void>;
     /**
      * Delete multiple items at once.
      *
      * @param ids - Array of item identifiers
+     * @param options - The origin of the write, for the observers
      * @returns Promise resolving to number of items actually deleted
      */
-    deleteBatch(ids: string[]): Promise<number>;
+    deleteBatch(ids: string[], options?: StorageWriteOptions): Promise<number>;
     /**
      * Get multiple items by ID at once.
      *
@@ -149,6 +205,42 @@ export interface CollectionStorage<T> {
      */
     getMetadata?(): Promise<StorageMetadata>;
 }
+/** The options of a write. */
+export interface StorageWriteOptions {
+    /**
+     * The tag of the writer. Each change that the write gives has it, so an observer knows its own
+     * writes: a sync does not send back the changes that it wrote itself.
+     */
+    readonly origin?: string | undefined;
+}
+/** A change of `observe()`: an id got a value. */
+export interface StorageSetChange<T> {
+    readonly type: "set";
+    readonly id: string;
+    /** A copy of the new item. */
+    readonly value: T;
+    /** The origin of the write, or undefined when the write had none. */
+    readonly origin?: string | undefined;
+}
+/** A change of `observe()`: an id lost its item. */
+export interface StorageDeleteChange {
+    readonly type: "delete";
+    readonly id: string;
+    /** The origin of the write, or undefined when the write had none. */
+    readonly origin?: string | undefined;
+}
+/** A change of `observe()`: the storage lost each item. */
+export interface StorageClearChange {
+    readonly type: "clear";
+    /** The origin of the write, or undefined when the write had none. */
+    readonly origin?: string | undefined;
+}
+/** One change of `observe()`. */
+export type StorageChangeEvent<T> = StorageSetChange<T> | StorageDeleteChange | StorageClearChange;
+/** The changes of one write, in the order of the write. The observers share it: do not change it. */
+export type StorageChangeBatch<T> = readonly StorageChangeEvent<T>[];
+/** The function that gets each batch of `observe()`. */
+export type StorageObserver<T> = (changes: StorageChangeBatch<T>) => void;
 /**
  * The changes of a storage after a version (roadmap R28).
  *

package/dist/storage/interface.d.ts.map

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

package/dist/storage/interface.js

@@ -1,14 +1,16 @@
 /**
- * Collection Storage Interface
+ * The interface of the collection storages. These storages implement it:
+ * - `InMemoryStorage` (this package): a fast storage in a `Map`, in memory only.
+ * - `ApiStorage` (`@procedures/store`): a remote collection through a `Client`.
+ * - `HybridStorage` (`@procedures/store`): a local copy that syncs with a remote, with a
+ *   conflict policy and a queue of the local writes.
+ * - `MongoStorage` (`@procedures/mongo`).
  *
- * Abstract storage layer for collections, enabling different backends:
- * - InMemoryStorage: Fast, volatile storage using Map
- * - ApiStorage: Remote persistence via universal client
- * - HybridStorage: Local cache + remote sync with conflict resolution
- * - SyncedStorage: Periodic background sync with offline support
+ * `@procedures/client` declares a copy of this interface with the same shape, so that the core
+ * does not depend on this package. `SqliteStorage` (`@procedures/sqlite`) implements that copy.
  *
- * IMPORTANT: All methods return Promise to ensure client code is
- * transport-agnostic (cannot distinguish local from remote storage).
+ * Each method gives a `Promise`. Thus the code of a caller cannot tell a local storage from a
+ * remote storage.
  */
 /**
  * @deprecated All storage methods now return Promise.

package/dist/storage/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkOH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAI,KAAiB;IACzD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/storage/interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwUH;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAI,KAAiB;IACzD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/storage/listeners.d.ts

@@ -0,0 +1,39 @@
+/**
+ * A set of listeners for the events of a storage: the change batches of `observe()`, or the status
+ * of a sync. A storage package uses it, so each storage treats its listeners in the same way.
+ */
+/** The function that gets the error of a listener. */
+export type ListenerErrorHandler = (error: unknown) => void;
+/**
+ * The default handler of the error of a listener. It throws the error again in a microtask, as an
+ * `EventTarget` reports the error of a listener. Thus the error is not lost, and the write that
+ * sent the event does not fail.
+ */
+export declare const reportListenerError: ListenerErrorHandler;
+/**
+ * The listeners of one kind of event.
+ *
+ * - `emit()` gives the event to each listener, in the order of `add()`.
+ * - A listener that `add()` gets during an `emit()` gets the next event, not this one.
+ * - The error of a listener goes to the error handler. The other listeners get the event.
+ * - The same function can be added two times. Each `add()` gives its own function that removes it.
+ */
+export declare class StorageListeners<E> {
+    private readonly listeners;
+    private readonly onError;
+    /** @param onError - The function that gets the error of a listener. The default is `reportListenerError`. */
+    constructor(onError?: ListenerErrorHandler);
+    /** The number of listeners. */
+    get size(): number;
+    /**
+     * This method adds a listener.
+     *
+     * @returns The function that removes the listener. A second use of it does nothing.
+     */
+    add(listener: (event: E) => void): () => void;
+    /** This method gives the event to each listener. */
+    emit(event: E): void;
+    /** This method removes each listener. */
+    clear(): void;
+}
+//# sourceMappingURL=listeners.d.ts.map

package/dist/storage/listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../../src/storage/listeners.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBAIjC,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwD;IAClF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,6GAA6G;IAC7G,YAAY,OAAO,GAAE,oBAA0C,EAE9D;IAED,+BAA+B;IAC/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAM5C;IAED,oDAAoD;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAUnB;IAED,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAEZ;CACF"}