@procedures/store 0.0.0-stage → 0.1.0

package/dist/module.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Module (no side effects): the procedures of client-store as data, for `createRegistry()`.
+ *
+ * The procedures of the store: `procedure.register` and the program store procedures
+ * `procedure.store`, `load`, `sync` and `remote`. The core registered the older versions of them
+ * before they moved here (roadmap 3.2).
+ */
+import { type ProcedureModule } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export declare const storeModule: ProcedureModule;
+export default storeModule;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGxE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAA+E,CAAC;eAE3F,WAAW"}

package/dist/module.js

@@ -0,0 +1,16 @@
+/**
+ * Module (no side effects): the procedures of client-store as data, for `createRegistry()`.
+ *
+ * The procedures of the store: `procedure.register` and the program store procedures
+ * `procedure.store`, `load`, `sync` and `remote`. The core registered the older versions of them
+ * before they moved here (roadmap 3.2).
+ */
+import { defineModule } from "@procedures/client";
+import { procedureStorageProcedures } from "./procedures.js";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const storeModule = defineModule("@procedures/store", procedureStorageProcedures);
+export default storeModule;
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoB,YAAY,CAAC,mBAAmB,EAAE,0BAA0B,CAAC,CAAC;AAE1G,eAAe,WAAW,CAAC"}

package/dist/procedures.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Every procedure of the package: procedure.register (the synced registry) and the procedures of
+ * the program store (procedure.store, load, sync and remote).
+ */
+import type { AnyProcedure } from "@procedures/client";
+/** All the procedures of client-store. */
+export declare const procedureStorageProcedures: AnyProcedure[];
+/** All the procedures of client-store as a module. */
+export declare const procedureStorageModule: {
+    name: string;
+    procedures: AnyProcedure[];
+};
+//# sourceMappingURL=procedures.d.ts.map

package/dist/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,0CAA0C;AAC1C,eAAO,MAAM,0BAA0B,EAAE,YAAY,EAA4D,CAAC;AAElH,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,YAAY,EAAE,CAAA;CAG9E,CAAC"}

package/dist/procedures.js

@@ -0,0 +1,14 @@
+/**
+ * Every procedure of the package: procedure.register (the synced registry) and the procedures of
+ * the program store (procedure.store, load, sync and remote).
+ */
+import { procedureRegisterProcedure } from "./storage/procedures.js";
+import { programStoreProcedures } from "./program-store/procedures.js";
+/** All the procedures of client-store. */
+export const procedureStorageProcedures = [procedureRegisterProcedure, ...programStoreProcedures];
+/** All the procedures of client-store as a module. */
+export const procedureStorageModule = {
+    name: "procedure-storage",
+    procedures: procedureStorageProcedures,
+};
+//# sourceMappingURL=procedures.js.map

package/dist/procedures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.js","sourceRoot":"","sources":["../src/procedures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,0CAA0C;AAC1C,MAAM,CAAC,MAAM,0BAA0B,GAAmB,CAAC,0BAA0B,EAAE,GAAG,sBAAsB,CAAC,CAAC;AAElH,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAiD;IAClF,IAAI,EAAE,mBAAmB;IACzB,UAAU,EAAE,0BAA0B;CACvC,CAAC"}

package/dist/program-store/attach.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The program store of a registry.
+ *
+ * A host gives a registry its store with `attachProgramStore(registry, store)`. The procedures
+ * `procedure.store`, `load` and `sync` use the store of the caller's registry (`ctx.registry`,
+ * or the global registry). Without a store, they fail with the code NOT_CONFIGURED.
+ */
+import { type ProcedureContext, type ProcedureRegistryLike } from "@procedures/client";
+import type { ProgramStore } from "./types.js";
+/** Give a registry its program store. A second call replaces the store. */
+export declare function attachProgramStore(registry: object, store: ProgramStore): void;
+/** Take the program store from a registry. */
+export declare function detachProgramStore(registry: object): void;
+/** The program store of a registry, or undefined. */
+export declare function getProgramStore(registry: object): ProgramStore | undefined;
+/** The registry of a caller: the context's registry, or the global registry. */
+export declare function callerRegistry(ctx: ProcedureContext | undefined): ProcedureRegistryLike;
+/** The program store of the caller's registry, or a NOT_CONFIGURED error. */
+export declare function requireProgramStore(ctx: ProcedureContext | undefined, what: string): ProgramStore;
+//# sourceMappingURL=attach.d.ts.map

package/dist/program-store/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../src/program-store/attach.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAE9E;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE1E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,qBAAqB,CAEvF;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAUjG"}

package/dist/program-store/attach.js

@@ -0,0 +1,36 @@
+/**
+ * The program store of a registry.
+ *
+ * A host gives a registry its store with `attachProgramStore(registry, store)`. The procedures
+ * `procedure.store`, `load` and `sync` use the store of the caller's registry (`ctx.registry`,
+ * or the global registry). Without a store, they fail with the code NOT_CONFIGURED.
+ */
+import { PROCEDURE_REGISTRY } from "@procedures/client";
+import { ProcedureStoreError } from "../storage/procedures.js";
+const STORES = new WeakMap();
+/** Give a registry its program store. A second call replaces the store. */
+export function attachProgramStore(registry, store) {
+    STORES.set(registry, store);
+}
+/** Take the program store from a registry. */
+export function detachProgramStore(registry) {
+    STORES.delete(registry);
+}
+/** The program store of a registry, or undefined. */
+export function getProgramStore(registry) {
+    return STORES.get(registry);
+}
+/** The registry of a caller: the context's registry, or the global registry. */
+export function callerRegistry(ctx) {
+    return ctx?.registry ?? PROCEDURE_REGISTRY;
+}
+/** The program store of the caller's registry, or a NOT_CONFIGURED error. */
+export function requireProgramStore(ctx, what) {
+    const store = getProgramStore(callerRegistry(ctx));
+    if (!store) {
+        throw new ProcedureStoreError("NOT_CONFIGURED", `${what} needs a program store, and this registry has none. ` +
+            "Give it one with attachProgramStore(registry, new FileProgramStore(path)) (or MemoryProgramStore, CollectionProgramStore).");
+    }
+    return store;
+}
+//# sourceMappingURL=attach.js.map

package/dist/program-store/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/program-store/attach.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAqD,MAAM,oBAAoB,CAAC;AAE3G,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,MAAM,GAAG,IAAI,OAAO,EAAwB,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAmB;IACtE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAAC,GAAiC;IAC9D,OAAO,GAAG,EAAE,QAAQ,IAAI,kBAAkB,CAAC;AAC7C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,GAAiC,EAAE,IAAY;IACjF,MAAM,KAAK,GAAG,eAAe,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,mBAAmB,CAC3B,gBAAgB,EAChB,GAAG,IAAI,sDAAsD;YAC3D,4HAA4H,CAC/H,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/program-store/collection.d.ts

@@ -0,0 +1,19 @@
+/**
+ * A program store on a collection storage: `InMemoryStorage` of client-collections, or a remote
+ * one, `ApiStorage` (the collection procedures of a server) or `HybridStorage` (a local cache with
+ * a remote copy). The key of each record is the key of the program.
+ */
+import type { CollectionStorage } from "@procedures/client";
+import { type ProgramStore, type StoredProgram } from "./types.js";
+export declare class CollectionProgramStore implements ProgramStore {
+    private readonly storage;
+    readonly kind = "collection";
+    /** @param storage - The storage of the records. The store closes it in `close()`. */
+    constructor(storage: CollectionStorage<StoredProgram>);
+    get(key: string): Promise<StoredProgram | undefined>;
+    list(prefix?: string): Promise<StoredProgram[]>;
+    put(program: StoredProgram): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=collection.d.ts.map

package/dist/program-store/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/program-store/collection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAyC,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1G,qBAAa,sBAAuB,YAAW,YAAY;IAI7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,gBAAgB;IAE7B,qFAAqF;IACrF,YAA6B,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAI;IAEpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAIzD;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAGpD;IAEK,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;CACF"}

package/dist/program-store/collection.js

@@ -0,0 +1,34 @@
+/**
+ * A program store on a collection storage: `InMemoryStorage` of client-collections, or a remote
+ * one, `ApiStorage` (the collection procedures of a server) or `HybridStorage` (a local cache with
+ * a remote copy). The key of each record is the key of the program.
+ */
+import { byKey, checkStoredProgram, keyMatches } from "./types.js";
+export class CollectionProgramStore {
+    storage;
+    kind = "collection";
+    /** @param storage - The storage of the records. The store closes it in `close()`. */
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async get(key) {
+        const record = await this.storage.get(key);
+        // A copy: a local storage (InMemoryStorage) gives its own object
+        return record === undefined ? undefined : checkStoredProgram(structuredClone(record));
+    }
+    async list(prefix) {
+        const records = await this.storage.getAll();
+        return byKey(records.map((record) => checkStoredProgram(structuredClone(record))).filter((p) => keyMatches(p.key, prefix)));
+    }
+    async put(program) {
+        const checked = checkStoredProgram(structuredClone(program));
+        await this.storage.set(checked.key, checked);
+    }
+    async delete(key) {
+        return this.storage.delete(key);
+    }
+    async close() {
+        await this.storage.close();
+    }
+}
+//# sourceMappingURL=collection.js.map

package/dist/program-store/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../../src/program-store/collection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAyC,MAAM,YAAY,CAAC;AAE1G,MAAM,OAAO,sBAAsB;IAIJ,OAAO;IAH3B,IAAI,GAAG,YAAY,CAAC;IAE7B,qFAAqF;IACrF,YAA6B,OAAyC;uBAAzC,OAAO;IAAqC,CAAC;IAE1E,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,iEAAiE;QACjE,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9H,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAsB;QAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/program-store/file.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A program store in one JSON file.
+ *
+ * The file is `{ "schemaVersion": 1, "programs": { "<key>": <StoredProgram> } }`. Each operation
+ * reads the file again, so two processes see the programs of each other. A write takes a lock
+ * file (`<file>.lock`), reads, changes and writes the file through a temporary file and a rename,
+ * so a reader never sees a part of a write and two writers do not lose each other's programs.
+ * A file that is not valid JSON is an error: the store does not write over it.
+ */
+import { type ProgramStore, type StoredProgram } from "./types.js";
+export declare class FileProgramStore implements ProgramStore {
+    readonly path: string;
+    readonly kind = "file";
+    /** The writes of this process, one at a time (the lock file orders the processes). */
+    private queue;
+    /** @param path - The JSON file. The store makes it, and its folder, at the first write. */
+    constructor(path: string);
+    get(key: string): Promise<StoredProgram | undefined>;
+    list(prefix?: string): Promise<StoredProgram[]>;
+    put(program: StoredProgram): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /** The content of the file. A missing file is an empty store. */
+    private read;
+    /** Read, change and write the file under the lock. `change` gives false when nothing changed. */
+    private change;
+    private write;
+    private withLock;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/program-store/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/program-store/file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAyC,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAqC1G,qBAAa,gBAAiB,YAAW,YAAY;IAMvC,QAAQ,CAAC,IAAI,EAAE,MAAM;IALjC,QAAQ,CAAC,IAAI,UAAU;IACvB,sFAAsF;IACtF,OAAO,CAAC,KAAK,CAAuC;IAEpD,2FAA2F;IAC3F,YAAqB,IAAI,EAAE,MAAM,EAAI;IAE/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAEzD;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAEpD;IAEK,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/C;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1C;IAED,iEAAiE;YACnD,IAAI;IAwBlB,iGAAiG;IACjG,OAAO,CAAC,MAAM;YASA,KAAK;YAYL,QAAQ;CA0BvB"}

package/dist/program-store/file.js

@@ -0,0 +1,156 @@
+/**
+ * A program store in one JSON file.
+ *
+ * The file is `{ "schemaVersion": 1, "programs": { "<key>": <StoredProgram> } }`. Each operation
+ * reads the file again, so two processes see the programs of each other. A write takes a lock
+ * file (`<file>.lock`), reads, changes and writes the file through a temporary file and a rename,
+ * so a reader never sees a part of a write and two writers do not lose each other's programs.
+ * A file that is not valid JSON is an error: the store does not write over it.
+ */
+import { mkdir, open, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { byKey, checkStoredProgram, keyMatches } from "./types.js";
+/** A lock older than this belongs to a process that stopped: it is removed. */
+const STALE_LOCK_MS = 10_000;
+/** The longest wait for the lock. */
+const LOCK_TIMEOUT_MS = 30_000;
+/**
+ * True when another process holds a file for a moment. On Windows, a file that its owner is
+ * deleting or renaming cannot be opened until that completes: EPERM, EACCES or EBUSY.
+ */
+function isContention(error) {
+    const code = error.code;
+    if (code === "EEXIST")
+        return true;
+    return process.platform === "win32" && (code === "EPERM" || code === "EACCES" || code === "EBUSY");
+}
+const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/** Run a file operation again while Windows holds the file for a moment. */
+async function retryOnContention(operation) {
+    for (let attempt = 1;; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const code = error.code;
+            if (attempt >= 20 || code === "EEXIST" || !isContention(error))
+                throw error;
+            await pause(10 * attempt);
+        }
+    }
+}
+export class FileProgramStore {
+    path;
+    kind = "file";
+    /** The writes of this process, one at a time (the lock file orders the processes). */
+    queue = Promise.resolve();
+    /** @param path - The JSON file. The store makes it, and its folder, at the first write. */
+    constructor(path) {
+        this.path = path;
+    }
+    async get(key) {
+        return (await this.read()).programs[key];
+    }
+    async list(prefix) {
+        return byKey(Object.values((await this.read()).programs).filter((p) => keyMatches(p.key, prefix)));
+    }
+    async put(program) {
+        const checked = checkStoredProgram(structuredClone(program));
+        await this.change((file) => {
+            file.programs[checked.key] = checked;
+            return true;
+        });
+    }
+    async delete(key) {
+        let deleted = false;
+        await this.change((file) => {
+            deleted = Object.hasOwn(file.programs, key);
+            if (deleted)
+                delete file.programs[key];
+            return deleted;
+        });
+        return deleted;
+    }
+    /** The content of the file. A missing file is an empty store. */
+    async read() {
+        let text;
+        try {
+            text = await retryOnContention(() => readFile(this.path, "utf8"));
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return { schemaVersion: 1, programs: {} };
+            throw error;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            throw new Error(`The program store file is not valid JSON: ${this.path}. The store does not write over it.`);
+        }
+        const file = parsed;
+        if (file?.schemaVersion !== 1 || typeof file.programs !== "object" || file.programs === null) {
+            throw new Error(`The program store file has an unknown format (schemaVersion 1 expected): ${this.path}`);
+        }
+        // A null-prototype object: a key such as "__proto__" stays a plain key
+        const programs = Object.create(null);
+        for (const [key, value] of Object.entries(file.programs))
+            programs[key] = checkStoredProgram(value);
+        return { schemaVersion: 1, programs };
+    }
+    /** Read, change and write the file under the lock. `change` gives false when nothing changed. */
+    change(change) {
+        const run = this.queue.then(() => this.withLock(async () => {
+            const file = await this.read();
+            if (change(file))
+                await this.write(file);
+        }));
+        this.queue = run.catch(() => undefined);
+        return run;
+    }
+    async write(file) {
+        await mkdir(dirname(this.path), { recursive: true });
+        const temporary = `${this.path}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+        try {
+            await writeFile(temporary, `${JSON.stringify(file, null, 2)}\n`, "utf8");
+            await retryOnContention(() => rename(temporary, this.path));
+        }
+        catch (error) {
+            await rm(temporary, { force: true });
+            throw error;
+        }
+    }
+    async withLock(work) {
+        const lockPath = `${this.path}.lock`;
+        await mkdir(dirname(this.path), { recursive: true });
+        const deadline = Date.now() + LOCK_TIMEOUT_MS;
+        for (;;) {
+            try {
+                const handle = await open(lockPath, "wx");
+                await handle.close();
+                break;
+            }
+            catch (error) {
+                if (!isContention(error) || Date.now() > deadline)
+                    throw error;
+                try {
+                    const { mtimeMs } = await stat(lockPath);
+                    if (Date.now() - mtimeMs > STALE_LOCK_MS)
+                        await rm(lockPath, { force: true });
+                }
+                catch {
+                    // The lock went away: try again
+                }
+                await pause(10 + Math.random() * 20);
+            }
+        }
+        try {
+            await work();
+        }
+        finally {
+            await rm(lockPath, { force: true });
+        }
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/program-store/file.js.map

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

package/dist/program-store/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The program store (roadmap 3.2): programs of procedure.define that outlive the process.
+ */
+export type { ProgramStore, StoredProgram } from "./types.js";
+export { checkStoredProgram } from "./types.js";
+export { MemoryProgramStore } from "./memory.js";
+export { FileProgramStore } from "./file.js";
+export { CollectionProgramStore } from "./collection.js";
+export { attachProgramStore, detachProgramStore, getProgramStore } from "./attach.js";
+export { procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, programStoreProcedures, } from "./procedures.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/program-store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/program-store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/program-store/index.js

@@ -0,0 +1,10 @@
+/**
+ * The program store (roadmap 3.2): programs of procedure.define that outlive the process.
+ */
+export { checkStoredProgram } from "./types.js";
+export { MemoryProgramStore } from "./memory.js";
+export { FileProgramStore } from "./file.js";
+export { CollectionProgramStore } from "./collection.js";
+export { attachProgramStore, detachProgramStore, getProgramStore } from "./attach.js";
+export { procedureStoreProcedure, procedureLoadProcedure, procedureSyncProcedure, procedureRemoteProcedure, programStoreProcedures, } from "./procedures.js";
+//# sourceMappingURL=index.js.map

package/dist/program-store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/program-store/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/program-store/memory.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A program store in memory: for tests, and for a process that keeps its programs only while it
+ * runs. Each read and write copies the record, so a caller that changes a result does not change
+ * the store.
+ */
+import { type ProgramStore, type StoredProgram } from "./types.js";
+export declare class MemoryProgramStore implements ProgramStore {
+    readonly kind = "memory";
+    private readonly programs;
+    get(key: string): Promise<StoredProgram | undefined>;
+    list(prefix?: string): Promise<StoredProgram[]>;
+    put(program: StoredProgram): Promise<void>;
+    delete(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/program-store/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/program-store/memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAyC,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1G,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAEvD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGzD;IAEK,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAEpD;IAEK,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C;IAEK,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1C;CACF"}

package/dist/program-store/memory.js

@@ -0,0 +1,25 @@
+/**
+ * A program store in memory: for tests, and for a process that keeps its programs only while it
+ * runs. Each read and write copies the record, so a caller that changes a result does not change
+ * the store.
+ */
+import { byKey, checkStoredProgram, keyMatches } from "./types.js";
+export class MemoryProgramStore {
+    kind = "memory";
+    programs = new Map();
+    async get(key) {
+        const program = this.programs.get(key);
+        return program ? structuredClone(program) : undefined;
+    }
+    async list(prefix) {
+        return byKey([...this.programs.values()].filter((p) => keyMatches(p.key, prefix)).map((p) => structuredClone(p)));
+    }
+    async put(program) {
+        const checked = checkStoredProgram(structuredClone(program));
+        this.programs.set(checked.key, checked);
+    }
+    async delete(key) {
+        return this.programs.delete(key);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/program-store/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/program-store/memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAyC,MAAM,YAAY,CAAC;AAE1G,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,QAAQ,CAAC;IACR,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,OAAO,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAsB;QAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/program-store/procedures.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The procedures of the program store (roadmap 3.2):
+ *
+ * - `procedure.store`: write the program of a runtime-defined procedure to the store.
+ * - `procedure.load`: define the stored programs again, through `procedure.define`.
+ * - `procedure.sync`: push the programs of the registry, pull the stored ones, or both.
+ * - `procedure.remote`: the status of the store. A store's backend is fixed when a host makes
+ *   it, so `connect` and `disconnect` are NOT_IMPLEMENTED: a procedure that could point the
+ *   store at a new endpoint would give a caller network reach.
+ *
+ * They use the program store of the caller's registry (`attachProgramStore`). A loaded program
+ * is a runtime-defined procedure again: data-driven, so a server with an expose rule lets it
+ * call only the exposed procedures. Load programs only from a store that you trust: a host with
+ * no expose rule runs whatever a program calls.
+ */
+import { type AnyProcedure } from "@procedures/client";
+export declare const procedureStoreProcedure: AnyProcedure;
+export declare const procedureLoadProcedure: AnyProcedure;
+export declare const procedureSyncProcedure: AnyProcedure;
+export declare const procedureRemoteProcedure: AnyProcedure;
+/** The procedures of the program store. */
+export declare const programStoreProcedures: AnyProcedure[];
+//# sourceMappingURL=procedures.d.ts.map

package/dist/program-store/procedures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../src/program-store/procedures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAQL,KAAK,YAAY,EAGlB,MAAM,oBAAoB,CAAC;AAiF5B,eAAO,MAAM,uBAAuB,EAAE,YAuB5B,CAAC;AA0BX,eAAO,MAAM,sBAAsB,EAAE,YAsD3B,CAAC;AA2BX,eAAO,MAAM,sBAAsB,EAAE,YA+C3B,CAAC;AAkBX,eAAO,MAAM,wBAAwB,EAAE,YA+B7B,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAKhD,CAAC"}