@earendil-works/chord 1.5.0 → 1.5.1

package/dist/documents/keyed-slot.js

@@ -0,0 +1,395 @@
+// Keyed slots (slice 6a §1.2, §4, §10, §11): the documents of one keyed name on one object, by key. In memory, every
+// present document stays; persisted, a document is loaded on demand (a cold read is a job on the object's line, one
+// load in flight per key, shared) and leaves memory when unpinned and idle for the retention (`residency.ts`). A key
+// read through `at(key)` or a watch has its own source, which exists while the key is pinned.
+import { awaitWithContext } from "../context/index.js";
+import { ChordError } from "../data/index.js";
+import { asChordError } from "../data/internal.js";
+import { track } from "../delta/index.js";
+import { compareText, storedText } from "../store/text.js";
+import { AddressSource } from "./address-source.js";
+import { storedAfter, } from "./persistence.js";
+import { Resident } from "./residency.js";
+import { SlotDefinition } from "./slot.js";
+/** The keys `keys(ctx)` reads per page from the store. */
+const KEYS_PAGE = 100;
+/** A keyed slot: one resident per document in memory, one source per pinned key. */
+export class KeyedSlot {
+    owner;
+    definition;
+    persisted;
+    #persistence;
+    #residents = new Map();
+    /** The sources of pinned keys: a key is pinned while it has one. */
+    #sources = new Map();
+    /** Cold loads in flight, by key: shared by every reader of the key. */
+    #loads = new Map();
+    /** Names a refused key (the slot's name is the same at every version): made once, not per key check. */
+    #keyWhat;
+    constructor(owner, definition, persistence) {
+        this.owner = owner;
+        this.definition = new SlotDefinition(definition);
+        this.#keyWhat = `${definition.name}: key`;
+        this.#persistence = persistence;
+        this.persisted = persistence === undefined ? undefined : this;
+    }
+    get persistence() {
+        // Only reached through `persisted`, which a persisted slot alone has.
+        return this.#persistence;
+    }
+    /**
+     * The value at `key`, `undefined` when absent. A document in memory is read at once (also through a sealed
+     * handle); a cold persisted one is loaded on the line (refused `released` once the access's token is sealed), and
+     * `context` ends only this caller's wait. An absent key is not cached (rule 20).
+     */
+    get(raw, access, context) {
+        // Not `async`: `#get` is the one async layer; a refused key still reaches the caller as a rejection.
+        try {
+            return this.#get(this.key(raw), access, context);
+        }
+        catch (error) {
+            return Promise.reject(error);
+        }
+    }
+    /** `get` of a key that went through `key` already. */
+    async #get(key, access, context) {
+        this.owner.assertLive();
+        this.definition.assertVersion(access.version);
+        const resident = this.#resident(key);
+        if (resident !== undefined) {
+            this.#touch(resident);
+            return resident.tracker.value;
+        }
+        if (this.#persistence === undefined)
+            return undefined;
+        await this.#loadShared(key, access.token, context);
+        return this.#residents.get(key)?.tracker.value;
+    }
+    /** The present keys in code point order: in memory, the residents; persisted, the store's, a page per line job. */
+    async *keys(access, context) {
+        this.owner.assertLive();
+        this.definition.assertVersion(access.version);
+        const persistence = this.#persistence;
+        if (persistence === undefined) {
+            yield* [...this.#residents.keys()].sort(compareText);
+            return;
+        }
+        let after;
+        for (;;) {
+            const page = await this.owner.onLine(() => persistence.keys(after, KEYS_PAGE, context), access.token);
+            yield* page;
+            if (page.length < KEYS_PAGE)
+                return;
+            after = page.at(-1);
+        }
+    }
+    /**
+     * A watch of the document at `key`, `undefined` when absent (after a cold load); it follows the address (a
+     * retirement is a frame with the `retired` flag) and pins the key until it ends.
+     */
+    async watch(raw, access, context) {
+        const key = this.key(raw);
+        if ((await this.#get(key, access, context)) === undefined)
+            return undefined;
+        const release = this.pin(key, context);
+        // Retired between the load and now: absent.
+        if (!this.#residents.has(key)) {
+            release();
+            return undefined;
+        }
+        let watch;
+        try {
+            // The source's values are this slot's documents.
+            watch = this.#sources.get(key).openWatch(context);
+        }
+        catch (error) {
+            release();
+            throw error;
+        }
+        void watch.closed.then(release);
+        return watch;
+    }
+    /**
+     * Pins `key`: its source (made by the first pin) and its document stay in memory until the returned release
+     * (idempotent) runs; a persisted key not in memory is loaded by the next activation load (`loadDeclared`).
+     */
+    pin(raw, context) {
+        const key = this.key(raw);
+        let source = this.#sources.get(key);
+        if (source === undefined) {
+            const ready = this.#persistence === undefined || this.#residents.has(key);
+            source = new KeySource(this, key, this.definition.current.initial(context), ready);
+            this.#sources.set(key, source);
+        }
+        source.pins++;
+        const resident = this.#residents.get(key);
+        if (resident !== undefined)
+            this.owner.residency.forget(resident);
+        const pinned = source;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            if (--pinned.pins > 0 || this.#sources.get(key) !== pinned)
+                return;
+            this.#sources.delete(key);
+            const idle = this.#residents.get(key);
+            if (idle !== undefined)
+                this.#touch(idle);
+        };
+    }
+    /** Loads pinned `key` on the line unless it was loaded since it was pinned (a consumer's `at(key)`, slice 6a §12). */
+    async ensure(raw, context) {
+        const key = this.key(raw);
+        if (this.#sources.get(key)?.ready !== false)
+            return;
+        await this.owner.onLine(() => this.load(key, context));
+    }
+    /** The source of pinned `key`. */
+    source(key) {
+        return this.#sources.get(this.key(key));
+    }
+    /**
+     * `key` as the slot and the store keep it: the `str()` text rules (slice 6a §8), a lone surrogate replaced by
+     * U+FFFD, NUL refused `invalid/args`. Plugin keys are a trust boundary; every entry point takes them through here,
+     * so memory and the store agree on one key.
+     */
+    key(key) {
+        return storedText(key, this.#keyWhat);
+    }
+    /** Loads every pinned key not loaded since it was pinned (activation, holding the line). */
+    async loadDeclared(context) {
+        for (const [key, source] of this.#sources)
+            if (!source.ready)
+                await this.load(key, context);
+    }
+    /**
+     * Loads the document at `key` (the caller holds the line) and installs it while it is still absent from memory (a
+     * commit's `adopt` always wins). A stored version newer than the code's, another fingerprint or a failing `migrate`
+     * fails the owner (slice 6a §1.4) and rejects with the cause.
+     */
+    async load(key, context, token) {
+        if (this.#residents.has(key))
+            return;
+        // A store error rejects as the store's (`storage_failed`, `aborted`).
+        const document = await this.persistence.read(key, context);
+        // The transaction was cut meanwhile: what it read may be stale already.
+        if (token?.sealed === true)
+            return;
+        let loaded;
+        try {
+            loaded =
+                document === undefined ? undefined : this.persistence.decode(document, this.definition.current, context);
+        }
+        catch (error) {
+            // What the code cannot read (a failing `migrate`, whatever it throws) fails the owner.
+            const failure = asChordError(error, this.owner.label);
+            this.owner.fail(failure);
+            throw failure;
+        }
+        if (loaded !== undefined && !this.#residents.has(key)) {
+            const resident = new Resident(this, key, track(loaded.value), loaded.stored, this.definition.current.version);
+            this.#residents.set(key, resident);
+            this.#touch(resident);
+        }
+        const source = this.#sources.get(key);
+        if (source !== undefined)
+            source.ready = true;
+    }
+    cold(key) {
+        return this.#persistence !== undefined && !this.#residents.has(key);
+    }
+    stored(key) {
+        return this.#residents.get(key)?.stored;
+    }
+    stage(key, change, was, writes) {
+        return this.persistence.stage(key, this.definition.current, was, change, writes);
+    }
+    /**
+     * Takes the attempt's declaration: a newer version migrates each document in memory on its next access (persisted
+     * ones store a base with their next change); the pinned keys are watched, so they migrate now, all or none, and
+     * take `initial()` again.
+     */
+    hydrate(definition, context) {
+        const from = this.definition.hydrated;
+        this.definition.hydrate(definition);
+        if (from === undefined || from.version === definition.version)
+            return;
+        const pinned = [...this.#sources.keys()].flatMap((key) => this.#residents.get(key) ?? []);
+        const migrated = pinned.map((resident) => [resident, this.#migrated(resident, context)]);
+        for (const [resident, tracker] of migrated) {
+            resident.tracker = tracker;
+            resident.version = definition.version;
+        }
+        this.owner.batch.commit(() => {
+            for (const source of this.#sources.values())
+                source.retake(definition.initial(context));
+        }, context);
+    }
+    current(key) {
+        return this.#resident(key)?.tracker;
+    }
+    /** The value a draft of an absent document starts from: a fresh `initial()`. */
+    initial(context) {
+        return this.definition.current.initial(context);
+    }
+    adopt(key, tracker, prepared, change) {
+        const stored = change === undefined ? undefined : storedAfter(change);
+        const source = this.#sources.get(key);
+        const before = source?.peek();
+        tracker.adopt(prepared);
+        let resident = this.#residents.get(key);
+        const { version } = this.definition.current;
+        if (resident === undefined) {
+            resident = new Resident(this, key, tracker, stored, version);
+            this.#residents.set(key, resident);
+        }
+        else {
+            resident.tracker = tracker;
+            resident.stored = stored;
+            resident.version = version;
+        }
+        if (source === undefined)
+            this.#touch(resident);
+        else
+            source.written(before, prepared);
+    }
+    /** Retires the document at `key` (inside the batch): out of memory, its source reads `initial()` with the flag. */
+    retire(key) {
+        const resident = this.#residents.get(key);
+        if (resident !== undefined) {
+            this.#residents.delete(key);
+            this.owner.residency.forget(resident);
+        }
+        this.#sources.get(key)?.retire();
+    }
+    /** The sweep found `resident` idle past the retention: it leaves memory. */
+    evict(resident) {
+        if (this.#residents.get(resident.key) === resident)
+            this.#residents.delete(resident.key);
+    }
+    /** Its object ended or no attempt declares it any more: the documents go and the keys' watches end. */
+    drop() {
+        for (const resident of this.#residents.values())
+            this.owner.residency.forget(resident);
+        this.#residents.clear();
+        for (const source of this.#sources.values())
+            source.end();
+        this.#sources.clear();
+    }
+    /**
+     * A cold persisted key's load, one in flight per key, on the line under the owner's context (rule 11). The load is
+     * every waiter's: when it takes the line, a waiter whose handle was sealed meanwhile (its attempt failed live, the
+     * object still open) is refused `released`, and with no other waiter the load does not run (rule 4).
+     */
+    async #loadShared(key, token, context) {
+        // Also when a load is in flight: a sealed handle's cold read is refused (rule 4).
+        this.owner.assertAdmitted(token);
+        let load = this.#loads.get(key);
+        if (load === undefined)
+            load = this.#startLoad(key);
+        load.tokens.add(token);
+        await awaitWithContext(load.done, context);
+        if (load.refused?.has(token))
+            throw this.owner.released();
+    }
+    /** Starts the shared load of `key`; it leaves `#loads` when it settles. */
+    #startLoad(key) {
+        const tokens = new Set();
+        const load = {
+            tokens,
+            refused: undefined,
+            // The job runs once the line is taken, after `load` is assigned.
+            done: this.owner.onLine(async () => {
+                const refused = new Set([...tokens].filter(({ sealed }) => sealed));
+                load.refused = refused;
+                if (refused.size === tokens.size)
+                    throw this.owner.released();
+                await this.load(key, this.owner.context);
+            }),
+        };
+        this.#loads.set(key, load);
+        const settled = () => {
+            this.#loads.delete(key);
+        };
+        load.done.then(settled, settled);
+        return load;
+    }
+    /** The resident at `key`, migrated to the slot's version first when it is older (migration on access). */
+    #resident(key) {
+        const resident = this.#residents.get(key);
+        if (resident === undefined || resident.version === this.definition.current.version)
+            return resident;
+        const tracker = this.#migrated(resident, this.owner.context);
+        resident.tracker = tracker;
+        resident.version = this.definition.current.version;
+        return resident;
+    }
+    /**
+     * `resident`'s value migrated from its version to the slot's (checked, R8). A throwing `migrate` fails the live
+     * owner `broken` (slice 6a §1.4) and throws the failure (an activation fails with it).
+     */
+    #migrated(resident, context) {
+        try {
+            return track(this.definition.current.migrate(resident.tracker.value, resident.version, context));
+        }
+        catch (error) {
+            const failure = asChordError(error, this.owner.label);
+            this.owner.fail(failure);
+            throw failure;
+        }
+    }
+    /** A use of `resident` while unpinned: persisted, it is idle from now (Durable's granule rule). */
+    #touch(resident) {
+        if (this.#persistence !== undefined && !this.#sources.has(resident.key))
+            this.owner.residency.touch(resident);
+    }
+}
+/**
+ * One pinned key of a keyed slot as a source (`handle.at(key)`, a keyed member's `at(key)`, `watch(key)`): the
+ * document's value, `initial()` while it is absent; retirements arrive with the `retired` flag.
+ */
+export class KeySource extends AddressSource {
+    #slot;
+    key;
+    /** Its pins: at 0 the slot forgets it. */
+    pins = 0;
+    /** Whether the key was loaded since it was pinned (always, in memory): its value is known. */
+    ready;
+    #initial;
+    constructor(slot, key, initial, ready) {
+        super(slot.owner.batch);
+        this.#slot = slot;
+        this.key = key;
+        this.#initial = initial;
+        this.ready = ready;
+    }
+    get value() {
+        this.#slot.owner.assertLive();
+        if (!this.ready) {
+            const message = `${this.#slot.definition.current.name}(${this.key}): read before it was loaded`;
+            throw new ChordError({ code: "not_ready", message });
+        }
+        return this.peek();
+    }
+    /** The value without the checks (inside its slot's commits). */
+    peek() {
+        return this.#slot.current(this.key)?.value ?? this.#initial;
+    }
+    /** The document was retired: `initial()` from now, with the flag. */
+    retire() {
+        this.retired(this.#initial);
+    }
+    /** A new definition took over (inside a batch): `initial()` again, the value as a root replacement. */
+    retake(initial) {
+        this.#initial = initial;
+        if (this.ready)
+            this.replaced();
+    }
+    /** Its slot was dropped: the watches end. */
+    end() {
+        this.endWatches();
+    }
+}
+//# sourceMappingURL=keyed-slot.js.map

package/dist/documents/keyed-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-slot.js","sourceRoot":"","sources":["../../src/documents/keyed-slot.ts"],"names":[],"mappings":"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","sourcesContent":["// Keyed slots (slice 6a §1.2, §4, §10, §11): the documents of one keyed name on one object, by key. In memory, every\n// present document stays; persisted, a document is loaded on demand (a cold read is a job on the object's line, one\n// load in flight per key, shared) and leaves memory when unpinned and idle for the retention (`residency.ts`). A key\n// read through `at(key)` or a watch has its own source, which exists while the key is pinned.\n\nimport { awaitWithContext, type Context } from \"../context/index.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { asChordError } from \"../data/internal.ts\";\nimport { type Prepared, type Tracker, track } from \"../delta/index.ts\";\nimport type { StagedWrite } from \"../store/step.ts\";\nimport { compareText, storedText } from \"../store/text.ts\";\nimport type { Watch } from \"../watch.ts\";\nimport { AddressSource } from \"./address-source.ts\";\nimport type { JsonObject } from \"./definition.ts\";\nimport type { Documents } from \"./documents.ts\";\nimport type { SealToken } from \"./fence.ts\";\nimport {\n\ttype DocumentChange,\n\ttype Loaded,\n\ttype Persistence,\n\ttype Stored,\n\ttype StoredChange,\n\tstoredAfter,\n} from \"./persistence.ts\";\nimport { Resident } from \"./residency.ts\";\nimport { type AnyDefinition, type DocumentSlot, type PersistedSlot, SlotDefinition } from \"./slot.ts\";\n\n/** Whom a read is for: a handle's seal token and the version it was declared with (R15). */\nexport type Access = { readonly token: SealToken; readonly version: number };\n\n/**\n * A cold load in flight, shared by its waiters: their handles' tokens, and those already sealed when the load took\n * the line (`undefined` until then), whose waiters it refuses (rule 4).\n */\ntype SharedLoad = {\n\treadonly done: Promise<void>;\n\treadonly tokens: Set<SealToken>;\n\trefused: ReadonlySet<SealToken> | undefined;\n};\n\n/** The keys `keys(ctx)` reads per page from the store. */\nconst KEYS_PAGE = 100;\n\n/** A keyed slot: one resident per document in memory, one source per pinned key. */\nexport class KeyedSlot implements DocumentSlot, PersistedSlot {\n\treadonly owner: Documents;\n\treadonly definition: SlotDefinition;\n\treadonly persisted: PersistedSlot | undefined;\n\treadonly #persistence: Persistence | undefined;\n\treadonly #residents = new Map<string, Resident>();\n\t/** The sources of pinned keys: a key is pinned while it has one. */\n\treadonly #sources = new Map<string, KeySource>();\n\t/** Cold loads in flight, by key: shared by every reader of the key. */\n\treadonly #loads = new Map<string, SharedLoad>();\n\t/** Names a refused key (the slot's name is the same at every version): made once, not per key check. */\n\treadonly #keyWhat: string;\n\n\tconstructor(owner: Documents, definition: AnyDefinition, persistence: Persistence | undefined) {\n\t\tthis.owner = owner;\n\t\tthis.definition = new SlotDefinition(definition);\n\t\tthis.#keyWhat = `${definition.name}: key`;\n\t\tthis.#persistence = persistence;\n\t\tthis.persisted = persistence === undefined ? undefined : this;\n\t}\n\n\tget persistence(): Persistence {\n\t\t// Only reached through `persisted`, which a persisted slot alone has.\n\t\treturn this.#persistence!;\n\t}\n\n\t/**\n\t * The value at `key`, `undefined` when absent. A document in memory is read at once (also through a sealed\n\t * handle); a cold persisted one is loaded on the line (refused `released` once the access's token is sealed), and\n\t * `context` ends only this caller's wait. An absent key is not cached (rule 20).\n\t */\n\tget(raw: string, access: Access, context: Context): Promise<JsonObject | undefined> {\n\t\t// Not `async`: `#get` is the one async layer; a refused key still reaches the caller as a rejection.\n\t\ttry {\n\t\t\treturn this.#get(this.key(raw), access, context);\n\t\t} catch (error) {\n\t\t\treturn Promise.reject(error);\n\t\t}\n\t}\n\n\t/** `get` of a key that went through `key` already. */\n\tasync #get(key: string, access: Access, context: Context): Promise<JsonObject | undefined> {\n\t\tthis.owner.assertLive();\n\t\tthis.definition.assertVersion(access.version);\n\t\tconst resident = this.#resident(key);\n\t\tif (resident !== undefined) {\n\t\t\tthis.#touch(resident);\n\t\t\treturn resident.tracker.value;\n\t\t}\n\t\tif (this.#persistence === undefined) return undefined;\n\t\tawait this.#loadShared(key, access.token, context);\n\t\treturn this.#residents.get(key)?.tracker.value;\n\t}\n\n\t/** The present keys in code point order: in memory, the residents; persisted, the store's, a page per line job. */\n\tasync *keys(access: Access, context: Context): AsyncIterable<string> {\n\t\tthis.owner.assertLive();\n\t\tthis.definition.assertVersion(access.version);\n\t\tconst persistence = this.#persistence;\n\t\tif (persistence === undefined) {\n\t\t\tyield* [...this.#residents.keys()].sort(compareText);\n\t\t\treturn;\n\t\t}\n\t\tlet after: string | undefined;\n\t\tfor (;;) {\n\t\t\tconst page = await this.owner.onLine(() => persistence.keys(after, KEYS_PAGE, context), access.token);\n\t\t\tyield* page;\n\t\t\tif (page.length < KEYS_PAGE) return;\n\t\t\tafter = page.at(-1);\n\t\t}\n\t}\n\n\t/**\n\t * A watch of the document at `key`, `undefined` when absent (after a cold load); it follows the address (a\n\t * retirement is a frame with the `retired` flag) and pins the key until it ends.\n\t */\n\tasync watch(raw: string, access: Access, context: Context): Promise<Watch<JsonObject> | undefined> {\n\t\tconst key = this.key(raw);\n\t\tif ((await this.#get(key, access, context)) === undefined) return undefined;\n\t\tconst release = this.pin(key, context);\n\t\t// Retired between the load and now: absent.\n\t\tif (!this.#residents.has(key)) {\n\t\t\trelease();\n\t\t\treturn undefined;\n\t\t}\n\t\tlet watch: Watch<JsonObject>;\n\t\ttry {\n\t\t\t// The source's values are this slot's documents.\n\t\t\twatch = this.#sources.get(key)!.openWatch(context) as Watch<JsonObject>;\n\t\t} catch (error) {\n\t\t\trelease();\n\t\t\tthrow error;\n\t\t}\n\t\tvoid watch.closed.then(release);\n\t\treturn watch;\n\t}\n\n\t/**\n\t * Pins `key`: its source (made by the first pin) and its document stay in memory until the returned release\n\t * (idempotent) runs; a persisted key not in memory is loaded by the next activation load (`loadDeclared`).\n\t */\n\tpin(raw: string, context: Context): () => void {\n\t\tconst key = this.key(raw);\n\t\tlet source = this.#sources.get(key);\n\t\tif (source === undefined) {\n\t\t\tconst ready = this.#persistence === undefined || this.#residents.has(key);\n\t\t\tsource = new KeySource(this, key, this.definition.current.initial(context), ready);\n\t\t\tthis.#sources.set(key, source);\n\t\t}\n\t\tsource.pins++;\n\t\tconst resident = this.#residents.get(key);\n\t\tif (resident !== undefined) this.owner.residency.forget(resident);\n\t\tconst pinned = source;\n\t\tlet released = false;\n\t\treturn () => {\n\t\t\tif (released) return;\n\t\t\treleased = true;\n\t\t\tif (--pinned.pins > 0 || this.#sources.get(key) !== pinned) return;\n\t\t\tthis.#sources.delete(key);\n\t\t\tconst idle = this.#residents.get(key);\n\t\t\tif (idle !== undefined) this.#touch(idle);\n\t\t};\n\t}\n\n\t/** Loads pinned `key` on the line unless it was loaded since it was pinned (a consumer's `at(key)`, slice 6a §12). */\n\tasync ensure(raw: string, context: Context): Promise<void> {\n\t\tconst key = this.key(raw);\n\t\tif (this.#sources.get(key)?.ready !== false) return;\n\t\tawait this.owner.onLine(() => this.load(key, context));\n\t}\n\n\t/** The source of pinned `key`. */\n\tsource(key: string): KeySource {\n\t\treturn this.#sources.get(this.key(key))!;\n\t}\n\n\t/**\n\t * `key` as the slot and the store keep it: the `str()` text rules (slice 6a §8), a lone surrogate replaced by\n\t * U+FFFD, NUL refused `invalid/args`. Plugin keys are a trust boundary; every entry point takes them through here,\n\t * so memory and the store agree on one key.\n\t */\n\tkey(key: string): string {\n\t\treturn storedText(key, this.#keyWhat);\n\t}\n\n\t/** Loads every pinned key not loaded since it was pinned (activation, holding the line). */\n\tasync loadDeclared(context: Context): Promise<void> {\n\t\tfor (const [key, source] of this.#sources) if (!source.ready) await this.load(key, context);\n\t}\n\n\t/**\n\t * Loads the document at `key` (the caller holds the line) and installs it while it is still absent from memory (a\n\t * commit's `adopt` always wins). A stored version newer than the code's, another fingerprint or a failing `migrate`\n\t * fails the owner (slice 6a §1.4) and rejects with the cause.\n\t */\n\tasync load(key: string, context: Context, token?: SealToken): Promise<void> {\n\t\tif (this.#residents.has(key)) return;\n\t\t// A store error rejects as the store's (`storage_failed`, `aborted`).\n\t\tconst document = await this.persistence.read(key, context);\n\t\t// The transaction was cut meanwhile: what it read may be stale already.\n\t\tif (token?.sealed === true) return;\n\t\tlet loaded: Loaded | undefined;\n\t\ttry {\n\t\t\tloaded =\n\t\t\t\tdocument === undefined ? undefined : this.persistence.decode(document, this.definition.current, context);\n\t\t} catch (error) {\n\t\t\t// What the code cannot read (a failing `migrate`, whatever it throws) fails the owner.\n\t\t\tconst failure = asChordError(error, this.owner.label);\n\t\t\tthis.owner.fail(failure);\n\t\t\tthrow failure;\n\t\t}\n\t\tif (loaded !== undefined && !this.#residents.has(key)) {\n\t\t\tconst resident = new Resident(this, key, track(loaded.value), loaded.stored, this.definition.current.version);\n\t\t\tthis.#residents.set(key, resident);\n\t\t\tthis.#touch(resident);\n\t\t}\n\t\tconst source = this.#sources.get(key);\n\t\tif (source !== undefined) source.ready = true;\n\t}\n\n\tcold(key: string): boolean {\n\t\treturn this.#persistence !== undefined && !this.#residents.has(key);\n\t}\n\n\tstored(key: string): Stored | undefined {\n\t\treturn this.#residents.get(key)?.stored;\n\t}\n\n\tstage(key: string, change: DocumentChange, was: Stored | undefined, writes: StagedWrite[]): StoredChange {\n\t\treturn this.persistence.stage(key, this.definition.current, was, change, writes);\n\t}\n\n\t/**\n\t * Takes the attempt's declaration: a newer version migrates each document in memory on its next access (persisted\n\t * ones store a base with their next change); the pinned keys are watched, so they migrate now, all or none, and\n\t * take `initial()` again.\n\t */\n\thydrate(definition: AnyDefinition, context: Context): void {\n\t\tconst from = this.definition.hydrated;\n\t\tthis.definition.hydrate(definition);\n\t\tif (from === undefined || from.version === definition.version) return;\n\t\tconst pinned = [...this.#sources.keys()].flatMap((key) => this.#residents.get(key) ?? []);\n\t\tconst migrated = pinned.map((resident) => [resident, this.#migrated(resident, context)] as const);\n\t\tfor (const [resident, tracker] of migrated) {\n\t\t\tresident.tracker = tracker;\n\t\t\tresident.version = definition.version;\n\t\t}\n\t\tthis.owner.batch.commit(() => {\n\t\t\tfor (const source of this.#sources.values()) source.retake(definition.initial(context));\n\t\t}, context);\n\t}\n\n\tcurrent(key: string): Tracker<JsonObject> | undefined {\n\t\treturn this.#resident(key)?.tracker;\n\t}\n\n\t/** The value a draft of an absent document starts from: a fresh `initial()`. */\n\tinitial(context: Context): JsonObject {\n\t\treturn this.definition.current.initial(context);\n\t}\n\n\tadopt(\n\t\tkey: string,\n\t\ttracker: Tracker<JsonObject>,\n\t\tprepared: Prepared<JsonObject>,\n\t\tchange: StoredChange | undefined,\n\t): void {\n\t\tconst stored = change === undefined ? undefined : storedAfter(change);\n\t\tconst source = this.#sources.get(key);\n\t\tconst before = source?.peek();\n\t\ttracker.adopt(prepared);\n\t\tlet resident = this.#residents.get(key);\n\t\tconst { version } = this.definition.current;\n\t\tif (resident === undefined) {\n\t\t\tresident = new Resident(this, key, tracker, stored, version);\n\t\t\tthis.#residents.set(key, resident);\n\t\t} else {\n\t\t\tresident.tracker = tracker;\n\t\t\tresident.stored = stored;\n\t\t\tresident.version = version;\n\t\t}\n\t\tif (source === undefined) this.#touch(resident);\n\t\telse source.written(before!, prepared);\n\t}\n\n\t/** Retires the document at `key` (inside the batch): out of memory, its source reads `initial()` with the flag. */\n\tretire(key: string): void {\n\t\tconst resident = this.#residents.get(key);\n\t\tif (resident !== undefined) {\n\t\t\tthis.#residents.delete(key);\n\t\t\tthis.owner.residency.forget(resident);\n\t\t}\n\t\tthis.#sources.get(key)?.retire();\n\t}\n\n\t/** The sweep found `resident` idle past the retention: it leaves memory. */\n\tevict(resident: Resident): void {\n\t\tif (this.#residents.get(resident.key) === resident) this.#residents.delete(resident.key);\n\t}\n\n\t/** Its object ended or no attempt declares it any more: the documents go and the keys' watches end. */\n\tdrop(): void {\n\t\tfor (const resident of this.#residents.values()) this.owner.residency.forget(resident);\n\t\tthis.#residents.clear();\n\t\tfor (const source of this.#sources.values()) source.end();\n\t\tthis.#sources.clear();\n\t}\n\n\t/**\n\t * A cold persisted key's load, one in flight per key, on the line under the owner's context (rule 11). The load is\n\t * every waiter's: when it takes the line, a waiter whose handle was sealed meanwhile (its attempt failed live, the\n\t * object still open) is refused `released`, and with no other waiter the load does not run (rule 4).\n\t */\n\tasync #loadShared(key: string, token: SealToken, context: Context): Promise<void> {\n\t\t// Also when a load is in flight: a sealed handle's cold read is refused (rule 4).\n\t\tthis.owner.assertAdmitted(token);\n\t\tlet load = this.#loads.get(key);\n\t\tif (load === undefined) load = this.#startLoad(key);\n\t\tload.tokens.add(token);\n\t\tawait awaitWithContext(load.done, context);\n\t\tif (load.refused?.has(token)) throw this.owner.released();\n\t}\n\n\t/** Starts the shared load of `key`; it leaves `#loads` when it settles. */\n\t#startLoad(key: string): SharedLoad {\n\t\tconst tokens = new Set<SealToken>();\n\t\tconst load: SharedLoad = {\n\t\t\ttokens,\n\t\t\trefused: undefined,\n\t\t\t// The job runs once the line is taken, after `load` is assigned.\n\t\t\tdone: this.owner.onLine(async () => {\n\t\t\t\tconst refused = new Set([...tokens].filter(({ sealed }) => sealed));\n\t\t\t\tload.refused = refused;\n\t\t\t\tif (refused.size === tokens.size) throw this.owner.released();\n\t\t\t\tawait this.load(key, this.owner.context);\n\t\t\t}),\n\t\t};\n\t\tthis.#loads.set(key, load);\n\t\tconst settled = (): void => {\n\t\t\tthis.#loads.delete(key);\n\t\t};\n\t\tload.done.then(settled, settled);\n\t\treturn load;\n\t}\n\n\t/** The resident at `key`, migrated to the slot's version first when it is older (migration on access). */\n\t#resident(key: string): Resident | undefined {\n\t\tconst resident = this.#residents.get(key);\n\t\tif (resident === undefined || resident.version === this.definition.current.version) return resident;\n\t\tconst tracker = this.#migrated(resident, this.owner.context);\n\t\tresident.tracker = tracker;\n\t\tresident.version = this.definition.current.version;\n\t\treturn resident;\n\t}\n\n\t/**\n\t * `resident`'s value migrated from its version to the slot's (checked, R8). A throwing `migrate` fails the live\n\t * owner `broken` (slice 6a §1.4) and throws the failure (an activation fails with it).\n\t */\n\t#migrated(resident: Resident, context: Context): Tracker<JsonObject> {\n\t\ttry {\n\t\t\treturn track(this.definition.current.migrate(resident.tracker.value, resident.version, context));\n\t\t} catch (error) {\n\t\t\tconst failure = asChordError(error, this.owner.label);\n\t\t\tthis.owner.fail(failure);\n\t\t\tthrow failure;\n\t\t}\n\t}\n\n\t/** A use of `resident` while unpinned: persisted, it is idle from now (Durable's granule rule). */\n\t#touch(resident: Resident): void {\n\t\tif (this.#persistence !== undefined && !this.#sources.has(resident.key)) this.owner.residency.touch(resident);\n\t}\n}\n\n/**\n * One pinned key of a keyed slot as a source (`handle.at(key)`, a keyed member's `at(key)`, `watch(key)`): the\n * document's value, `initial()` while it is absent; retirements arrive with the `retired` flag.\n */\nexport class KeySource extends AddressSource {\n\treadonly #slot: KeyedSlot;\n\treadonly key: string;\n\t/** Its pins: at 0 the slot forgets it. */\n\tpins = 0;\n\t/** Whether the key was loaded since it was pinned (always, in memory): its value is known. */\n\tready: boolean;\n\t#initial: JsonObject;\n\n\tconstructor(slot: KeyedSlot, key: string, initial: JsonObject, ready: boolean) {\n\t\tsuper(slot.owner.batch);\n\t\tthis.#slot = slot;\n\t\tthis.key = key;\n\t\tthis.#initial = initial;\n\t\tthis.ready = ready;\n\t}\n\n\tget value(): JsonObject {\n\t\tthis.#slot.owner.assertLive();\n\t\tif (!this.ready) {\n\t\t\tconst message = `${this.#slot.definition.current.name}(${this.key}): read before it was loaded`;\n\t\t\tthrow new ChordError({ code: \"not_ready\", message });\n\t\t}\n\t\treturn this.peek();\n\t}\n\n\t/** The value without the checks (inside its slot's commits). */\n\tpeek(): JsonObject {\n\t\treturn this.#slot.current(this.key)?.value ?? this.#initial;\n\t}\n\n\t/** The document was retired: `initial()` from now, with the flag. */\n\tretire(): void {\n\t\tthis.retired(this.#initial);\n\t}\n\n\t/** A new definition took over (inside a batch): `initial()` again, the value as a root replacement. */\n\tretake(initial: JsonObject): void {\n\t\tthis.#initial = initial;\n\t\tif (this.ready) this.replaced();\n\t}\n\n\t/** Its slot was dropped: the watches end. */\n\tend(): void {\n\t\tthis.endWatches();\n\t}\n}\n"]}

package/dist/documents/line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../src/documents/line.ts"],"names":[],"mappings":"AAGA,+HAA+H;AAC/H,qBAAa,IAAI;;IAGhB,8EAA8E;IAC9E,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAK7B;CACD"}

package/dist/documents/line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.js","sourceRoot":"","sources":["../../src/documents/line.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,oBAAoB;AAEpB,+HAA+H;AAC/H,MAAM,OAAO,IAAI;IAChB,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEzC,8EAA8E;IAC9E,OAAO;QACN,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACD","sourcesContent":["// An object's line (§9): its transactions, cold loads, key pages and eviction sweeps run on it one at a time, in the\n// order they asked.\n\n/** An object's line: `acquire()` resolves with the release once every earlier holder released; releasing twice is harmless. */\nexport class Line {\n\t#tail: Promise<void> = Promise.resolve();\n\n\t/** Resolves with this holder's release once every earlier holder released. */\n\tacquire(): Promise<() => void> {\n\t\tconst { promise, resolve } = Promise.withResolvers<void>();\n\t\tconst previous = this.#tail;\n\t\tthis.#tail = promise;\n\t\treturn previous.then(() => resolve);\n\t}\n}\n"]}

package/dist/documents/persistence.d.ts

@@ -0,0 +1,104 @@
+import type { Context } from "../context/index.ts";
+import type { Op, Prepared } from "../delta/index.ts";
+import { type DocumentAddress, type StoredDocument } from "../store/engine.ts";
+import type { StagedWrite } from "../store/step.ts";
+import type { ChordStore } from "../store/store.ts";
+import type { JsonObject } from "./definition.ts";
+import type { AnyDefinition } from "./slot.ts";
+/** What is stored of a loaded document: its record's id and revision, its base's version, the deltas after it. */
+export type Stored = {
+    readonly id: number;
+    readonly revision: number;
+    /** The version of the stored base: below the definition's, the next change stores a base (rule 1). */
+    readonly version: number;
+    readonly deltasSinceBase: number;
+};
+/** A live document found without loading it: what is stored of it and the fingerprint it was stored with. */
+export type FoundDocument = {
+    readonly stored: Stored;
+    readonly fingerprint: string;
+};
+/** A loaded document: its value at the definition's version, and what is stored of it. */
+export type Loaded = {
+    readonly value: JsonObject;
+    readonly stored: Stored;
+};
+/** One transaction's change of one document: its prepared draft (if changed), and whether it retires it. */
+export type DocumentChange = {
+    readonly prepared: Prepared<JsonObject> | undefined;
+    readonly retires: boolean;
+};
+/** A run state's held ops (D8), stored before the next change's own; `base` when a held change asked for a base. */
+export type Held = {
+    readonly ops: readonly Op[];
+    readonly base: boolean;
+};
+/**
+ * What one commit stores of a document, in the store writes' words: a retirement (nothing stored after it), a
+ * creation whose id the step assigns (`create`: `created.id` once it applied), a change of the record `stored` was
+ * prepared on, or nothing yet (`held`: a deferred change of a run's state, D8, kept in memory over `stored`).
+ */
+export type StoredChange = {
+    readonly kind: "retire";
+} | {
+    readonly kind: "create";
+    readonly version: number;
+    readonly created: {
+        id: number;
+    };
+} | {
+    readonly kind: "change";
+    readonly stored: Stored;
+} | {
+    readonly kind: "held";
+    readonly stored: Stored;
+    readonly withinMs: number;
+};
+/**
+ * The documents of one persisted name on one object: `(<object type>, namespace, name, key)`, the namespace `chord` for
+ * `self.state`, `chord.jobs` and `chord.job-states` for persisted job runs (slice 6b D5).
+ */
+export declare class Persistence {
+    #private;
+    readonly store: ChordStore;
+    /** `owner` is the object's type (R2); `kind` the definition's or the job's name. */
+    constructor(store: ChordStore, owner: string, namespace: string, kind: string);
+    /**
+     * The stored document at `key`, `undefined` when absent: found and loaded with plain reads (a store error rejects
+     * as the store's). Counted (`chord.store.loads`).
+     */
+    read(key: string, context: Context): Promise<StoredDocument | undefined>;
+    /**
+     * `document` as `definition` reads it: a stored version newer than the code's, or the same version with another
+     * fingerprint (D9), throws; an older one is migrated and the result checked once (R8). What throws here is the
+     * code's (a failing `migrate` too, whatever it throws), never the store's.
+     */
+    decode(document: StoredDocument, definition: AnyDefinition, context: Context): Loaded;
+    /**
+     * What is stored of the live document at `key` without loading it (a retirement's find) and the schema fingerprint
+     * it was stored with (`checkReadable` takes both), `undefined` when absent.
+     */
+    find(key: string, context: Context): Promise<FoundDocument | undefined>;
+    /** Up to `limit` keys of live documents after `after`, in code point order. */
+    keys(after: string | undefined, limit: number, context: Context): Promise<string[]>;
+    /**
+     * Stages one commit's writes of the document at `key` into `writes` (rule 8: serialized here, before the queue):
+     * its retirement when `retired` is stored, then its creation, or the change of `stored` (a base when created, when
+     * the stored version is older, or when `checkpointWhen` asks; a delta otherwise), `held` ops stored before the
+     * change's own (D8: a held base makes it a base). Returns what the commit stores.
+     */
+    stage(key: string, definition: AnyDefinition, stored: Stored | undefined, change: DocumentChange, writes: StagedWrite[], held?: Held): StoredChange;
+    /** The address of `key`: a singleton's (`""`) has no key. */
+    at(key: string): DocumentAddress;
+}
+/**
+ * Throws when `definition` cannot read a document stored at `stored`'s version and fingerprint: a newer version than
+ * the code's, or the same version with another fingerprint (D9). A load and a retirement check alike (R15).
+ */
+export declare function checkReadable(stored: {
+    readonly version: number;
+    readonly fingerprint: string;
+}, definition: AnyDefinition): void;
+/** What is stored after a commit's `change` was adopted. */
+export declare function storedAfter(change: StoredChange): Stored | undefined;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/documents/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/documents/persistence.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAGN,KAAK,eAAe,EAMpB,KAAK,cAAc,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,kHAAkH;AAClH,MAAM,MAAM,MAAM,GAAG;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,6GAA6G;AAC7G,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,0FAA0F;AAC1F,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7E,4GAA4G;AAC5G,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhH,oHAAoH;AACpH,MAAM,MAAM,IAAI,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF;;;GAGG;AACH,qBAAa,WAAW;;IACvB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAG3B,oFAAoF;IACpF,YAAY,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAG5E;IAED;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAQ7E;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAWpF;IAED;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAM5E;IAED,+EAA+E;IAC/E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElF;IAED;;;;;OAKG;IACH,KAAK,CACJ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,CAAC,EAAE,IAAI,GACT,YAAY,CA2Bd;IAED,6DAA6D;IAC7D,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAE/B;CACD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,MAAM,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAClE,UAAU,EAAE,aAAa,GACvB,IAAI,CAQN;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAUpE"}