@earendil-works/chord 1.3.0 → 1.5.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-slot.js","sourceRoot":"","sources":["../../../src/next/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 { type Prepared, type Tracker, track } from \"../../delta/index.ts\";\nimport type { Watch } from \"../../watch.ts\";\nimport { ChordError } from \"../data/index.ts\";\nimport { asChordError } from \"../data/internal.ts\";\nimport type { StagedWrite } from \"../store/step.ts\";\nimport { compareText, storedText } from \"../store/text.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/next/documents/line.d.ts

@@ -0,0 +1,7 @@
+/** An object's line: `acquire()` resolves with the release once every earlier holder released; releasing twice is harmless. */
+export declare class Line {
+    #private;
+    /** Resolves with this holder's release once every earlier holder released. */
+    acquire(): Promise<() => void>;
+}
+//# sourceMappingURL=line.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../../src/next/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/next/documents/line.js

@@ -0,0 +1,14 @@
+// An object's line (§9): its transactions, cold loads, key pages and eviction sweeps run on it one at a time, in the
+// order they asked.
+/** An object's line: `acquire()` resolves with the release once every earlier holder released; releasing twice is harmless. */
+export class Line {
+    #tail = Promise.resolve();
+    /** Resolves with this holder's release once every earlier holder released. */
+    acquire() {
+        const { promise, resolve } = Promise.withResolvers();
+        const previous = this.#tail;
+        this.#tail = promise;
+        return previous.then(() => resolve);
+    }
+}
+//# sourceMappingURL=line.js.map

package/dist/next/documents/line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line.js","sourceRoot":"","sources":["../../../src/next/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/next/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/next/documents/persistence.d.ts.map

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

package/dist/next/documents/persistence.js

@@ -0,0 +1,128 @@
+// Persisted documents' store side (slice 6a §8, §10): a slot's address in the documents engine, what is stored of each
+// loaded document (Durable's `LoadedDocument` fields), its loads with the version and fingerprint checks and the
+// checked `migrate`, and the writes one commit stages for a changed or retired document.
+import { changeDocument, createDocument, findDocument, listDocumentKeys, loadDocument, retireDocument, } from "../store/engine.js";
+/**
+ * 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 class Persistence {
+    store;
+    #address;
+    /** `owner` is the object's type (R2); `kind` the definition's or the job's name. */
+    constructor(store, owner, namespace, kind) {
+        this.store = store;
+        this.#address = { owner, namespace, kind };
+    }
+    /**
+     * 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`).
+     */
+    async read(key, context) {
+        const address = this.at(key);
+        const document = await this.store.read(async (executor) => {
+            const record = await findDocument(executor, address);
+            return record === undefined ? undefined : loadDocument(executor, record);
+        }, context);
+        if (document !== undefined)
+            context.telemetry.metrics?.counter("chord.store.loads").add(1);
+        return document;
+    }
+    /**
+     * `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, definition, context) {
+        const { record, deltasSinceBase } = document;
+        checkReadable(record, definition);
+        // The engine stores what commits gave it: JSON objects of the record's version.
+        const stored = document.value;
+        const value = record.version === definition.version ? stored : definition.migrate(stored, record.version, context);
+        return {
+            value,
+            stored: { id: record.id, revision: record.revision, version: record.version, deltasSinceBase },
+        };
+    }
+    /**
+     * 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.
+     */
+    async find(key, context) {
+        const record = await this.store.read((executor) => findDocument(executor, this.at(key)), context);
+        if (record === undefined)
+            return undefined;
+        // The change counter is all a retirement needs; `deltasSinceBase` is not read for one.
+        const stored = { id: record.id, revision: record.revision, version: record.version, deltasSinceBase: 0 };
+        return { stored, fingerprint: record.fingerprint };
+    }
+    /** Up to `limit` keys of live documents after `after`, in code point order. */
+    keys(after, limit, context) {
+        return this.store.read((executor) => listDocumentKeys(executor, this.#address, after, limit), context);
+    }
+    /**
+     * 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, definition, stored, change, writes, held) {
+        const { prepared, retires } = change;
+        if (retires && stored !== undefined)
+            writes.push(retireDocument(stored.id, stored.revision));
+        if (prepared === undefined)
+            return { kind: "retire" };
+        const { version, fingerprint } = definition;
+        if (retires || stored === undefined) {
+            const base = { version, fingerprint, value: prepared.value };
+            const created = { id: 0 };
+            const write = createDocument(this.at(key), base, JSON.stringify(prepared.value), (id) => {
+                created.id = id;
+            });
+            writes.push(write);
+            return { kind: "create", version, created };
+        }
+        const info = { deltasSinceBase: stored.deltasSinceBase };
+        const base = held?.base === true ||
+            stored.version !== version ||
+            definition.checkpointWhen(prepared.value, prepared.ops, info);
+        const ops = held === undefined ? prepared.ops : [...held.ops, ...prepared.ops];
+        const content = base
+            ? { kind: "base", version, fingerprint, value: prepared.value }
+            : { kind: "delta", version, ops };
+        const text = JSON.stringify(base ? prepared.value : ops);
+        writes.push(changeDocument(stored.id, stored.revision, content, text));
+        const deltasSinceBase = base ? 0 : stored.deltasSinceBase + 1;
+        return { kind: "change", stored: { id: stored.id, revision: stored.revision + 1, version, deltasSinceBase } };
+    }
+    /** The address of `key`: a singleton's (`""`) has no key. */
+    at(key) {
+        return key === "" ? this.#address : { ...this.#address, key };
+    }
+}
+/**
+ * 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 function checkReadable(stored, definition) {
+    const { name, version, fingerprint } = definition;
+    if (stored.version > version) {
+        throw new Error(`${name}: stored at version ${stored.version}, newer than the code's ${version}`);
+    }
+    if (stored.version === version && stored.fingerprint !== fingerprint) {
+        throw new Error(`${name}: stored with another schema at version ${version} (a schema changed without a bump)`);
+    }
+}
+/** What is stored after a commit's `change` was adopted. */
+export function storedAfter(change) {
+    switch (change.kind) {
+        case "retire":
+            return undefined;
+        case "create":
+            return { id: change.created.id, revision: 1, version: change.version, deltasSinceBase: 0 };
+        case "change":
+        case "held":
+            return change.stored;
+    }
+}
+//# sourceMappingURL=persistence.js.map

package/dist/next/documents/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../src/next/documents/persistence.ts"],"names":[],"mappings":"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","sourcesContent":["// Persisted documents' store side (slice 6a §8, §10): a slot's address in the documents engine, what is stored of each\n// loaded document (Durable's `LoadedDocument` fields), its loads with the version and fingerprint checks and the\n// checked `migrate`, and the writes one commit stages for a changed or retired document.\n\nimport type { Context } from \"../../context/index.ts\";\nimport type { Op, Prepared } from \"../../delta/index.ts\";\nimport {\n\tchangeDocument,\n\tcreateDocument,\n\ttype DocumentAddress,\n\ttype DocumentContent,\n\tfindDocument,\n\tlistDocumentKeys,\n\tloadDocument,\n\tretireDocument,\n\ttype StoredDocument,\n} from \"../store/engine.ts\";\nimport type { StagedWrite } from \"../store/step.ts\";\nimport type { ChordStore } from \"../store/store.ts\";\nimport type { JsonObject } from \"./definition.ts\";\nimport type { AnyDefinition } from \"./slot.ts\";\n\n/** What is stored of a loaded document: its record's id and revision, its base's version, the deltas after it. */\nexport type Stored = {\n\treadonly id: number;\n\treadonly revision: number;\n\t/** The version of the stored base: below the definition's, the next change stores a base (rule 1). */\n\treadonly version: number;\n\treadonly deltasSinceBase: number;\n};\n\n/** A live document found without loading it: what is stored of it and the fingerprint it was stored with. */\nexport type FoundDocument = { readonly stored: Stored; readonly fingerprint: string };\n\n/** A loaded document: its value at the definition's version, and what is stored of it. */\nexport type Loaded = { readonly value: JsonObject; readonly stored: Stored };\n\n/** One transaction's change of one document: its prepared draft (if changed), and whether it retires it. */\nexport type DocumentChange = { readonly prepared: Prepared<JsonObject> | undefined; readonly retires: boolean };\n\n/** A run state's held ops (D8), stored before the next change's own; `base` when a held change asked for a base. */\nexport type Held = { readonly ops: readonly Op[]; readonly base: boolean };\n\n/**\n * What one commit stores of a document, in the store writes' words: a retirement (nothing stored after it), a\n * creation whose id the step assigns (`create`: `created.id` once it applied), a change of the record `stored` was\n * prepared on, or nothing yet (`held`: a deferred change of a run's state, D8, kept in memory over `stored`).\n */\nexport type StoredChange =\n\t| { readonly kind: \"retire\" }\n\t| { readonly kind: \"create\"; readonly version: number; readonly created: { id: number } }\n\t| { readonly kind: \"change\"; readonly stored: Stored }\n\t| { readonly kind: \"held\"; readonly stored: Stored; readonly withinMs: number };\n\n/**\n * The documents of one persisted name on one object: `(<object type>, namespace, name, key)`, the namespace `chord` for\n * `self.state`, `chord.jobs` and `chord.job-states` for persisted job runs (slice 6b D5).\n */\nexport class Persistence {\n\treadonly store: ChordStore;\n\treadonly #address: Omit<DocumentAddress, \"key\">;\n\n\t/** `owner` is the object's type (R2); `kind` the definition's or the job's name. */\n\tconstructor(store: ChordStore, owner: string, namespace: string, kind: string) {\n\t\tthis.store = store;\n\t\tthis.#address = { owner, namespace, kind };\n\t}\n\n\t/**\n\t * The stored document at `key`, `undefined` when absent: found and loaded with plain reads (a store error rejects\n\t * as the store's). Counted (`chord.store.loads`).\n\t */\n\tasync read(key: string, context: Context): Promise<StoredDocument | undefined> {\n\t\tconst address = this.at(key);\n\t\tconst document = await this.store.read(async (executor) => {\n\t\t\tconst record = await findDocument(executor, address);\n\t\t\treturn record === undefined ? undefined : loadDocument(executor, record);\n\t\t}, context);\n\t\tif (document !== undefined) context.telemetry.metrics?.counter(\"chord.store.loads\").add(1);\n\t\treturn document;\n\t}\n\n\t/**\n\t * `document` as `definition` reads it: a stored version newer than the code's, or the same version with another\n\t * fingerprint (D9), throws; an older one is migrated and the result checked once (R8). What throws here is the\n\t * code's (a failing `migrate` too, whatever it throws), never the store's.\n\t */\n\tdecode(document: StoredDocument, definition: AnyDefinition, context: Context): Loaded {\n\t\tconst { record, deltasSinceBase } = document;\n\t\tcheckReadable(record, definition);\n\t\t// The engine stores what commits gave it: JSON objects of the record's version.\n\t\tconst stored = document.value as JsonObject;\n\t\tconst value =\n\t\t\trecord.version === definition.version ? stored : definition.migrate(stored, record.version, context);\n\t\treturn {\n\t\t\tvalue,\n\t\t\tstored: { id: record.id, revision: record.revision, version: record.version, deltasSinceBase },\n\t\t};\n\t}\n\n\t/**\n\t * What is stored of the live document at `key` without loading it (a retirement's find) and the schema fingerprint\n\t * it was stored with (`checkReadable` takes both), `undefined` when absent.\n\t */\n\tasync find(key: string, context: Context): Promise<FoundDocument | undefined> {\n\t\tconst record = await this.store.read((executor) => findDocument(executor, this.at(key)), context);\n\t\tif (record === undefined) return undefined;\n\t\t// The change counter is all a retirement needs; `deltasSinceBase` is not read for one.\n\t\tconst stored = { id: record.id, revision: record.revision, version: record.version, deltasSinceBase: 0 };\n\t\treturn { stored, fingerprint: record.fingerprint };\n\t}\n\n\t/** Up to `limit` keys of live documents after `after`, in code point order. */\n\tkeys(after: string | undefined, limit: number, context: Context): Promise<string[]> {\n\t\treturn this.store.read((executor) => listDocumentKeys(executor, this.#address, after, limit), context);\n\t}\n\n\t/**\n\t * Stages one commit's writes of the document at `key` into `writes` (rule 8: serialized here, before the queue):\n\t * its retirement when `retired` is stored, then its creation, or the change of `stored` (a base when created, when\n\t * the stored version is older, or when `checkpointWhen` asks; a delta otherwise), `held` ops stored before the\n\t * change's own (D8: a held base makes it a base). Returns what the commit stores.\n\t */\n\tstage(\n\t\tkey: string,\n\t\tdefinition: AnyDefinition,\n\t\tstored: Stored | undefined,\n\t\tchange: DocumentChange,\n\t\twrites: StagedWrite[],\n\t\theld?: Held,\n\t): StoredChange {\n\t\tconst { prepared, retires } = change;\n\t\tif (retires && stored !== undefined) writes.push(retireDocument(stored.id, stored.revision));\n\t\tif (prepared === undefined) return { kind: \"retire\" };\n\t\tconst { version, fingerprint } = definition;\n\t\tif (retires || stored === undefined) {\n\t\t\tconst base = { version, fingerprint, value: prepared.value };\n\t\t\tconst created = { id: 0 };\n\t\t\tconst write = createDocument(this.at(key), base, JSON.stringify(prepared.value), (id) => {\n\t\t\t\tcreated.id = id;\n\t\t\t});\n\t\t\twrites.push(write);\n\t\t\treturn { kind: \"create\", version, created };\n\t\t}\n\t\tconst info = { deltasSinceBase: stored.deltasSinceBase };\n\t\tconst base =\n\t\t\theld?.base === true ||\n\t\t\tstored.version !== version ||\n\t\t\tdefinition.checkpointWhen(prepared.value, prepared.ops, info);\n\t\tconst ops = held === undefined ? prepared.ops : [...held.ops, ...prepared.ops];\n\t\tconst content: DocumentContent = base\n\t\t\t? { kind: \"base\", version, fingerprint, value: prepared.value }\n\t\t\t: { kind: \"delta\", version, ops };\n\t\tconst text = JSON.stringify(base ? prepared.value : ops);\n\t\twrites.push(changeDocument(stored.id, stored.revision, content, text));\n\t\tconst deltasSinceBase = base ? 0 : stored.deltasSinceBase + 1;\n\t\treturn { kind: \"change\", stored: { id: stored.id, revision: stored.revision + 1, version, deltasSinceBase } };\n\t}\n\n\t/** The address of `key`: a singleton's (`\"\"`) has no key. */\n\tat(key: string): DocumentAddress {\n\t\treturn key === \"\" ? this.#address : { ...this.#address, key };\n\t}\n}\n\n/**\n * Throws when `definition` cannot read a document stored at `stored`'s version and fingerprint: a newer version than\n * the code's, or the same version with another fingerprint (D9). A load and a retirement check alike (R15).\n */\nexport function checkReadable(\n\tstored: { readonly version: number; readonly fingerprint: string },\n\tdefinition: AnyDefinition,\n): void {\n\tconst { name, version, fingerprint } = definition;\n\tif (stored.version > version) {\n\t\tthrow new Error(`${name}: stored at version ${stored.version}, newer than the code's ${version}`);\n\t}\n\tif (stored.version === version && stored.fingerprint !== fingerprint) {\n\t\tthrow new Error(`${name}: stored with another schema at version ${version} (a schema changed without a bump)`);\n\t}\n}\n\n/** What is stored after a commit's `change` was adopted. */\nexport function storedAfter(change: StoredChange): Stored | undefined {\n\tswitch (change.kind) {\n\t\tcase \"retire\":\n\t\t\treturn undefined;\n\t\tcase \"create\":\n\t\t\treturn { id: change.created.id, revision: 1, version: change.version, deltasSinceBase: 0 };\n\t\tcase \"change\":\n\t\tcase \"held\":\n\t\t\treturn change.stored;\n\t}\n}\n"]}

package/dist/next/documents/residency.d.ts

@@ -0,0 +1,31 @@
+import type { Tracker } from "../../delta/index.ts";
+import type { JsonObject } from "./definition.ts";
+import type { Stored } from "./persistence.ts";
+/** One keyed document in memory: its slot, its tracker and, persisted, what is stored of it. */
+export declare class Resident {
+    readonly slot: {
+        evict(resident: Resident): void;
+    };
+    readonly key: string;
+    tracker: Tracker<JsonObject>;
+    stored: Stored | undefined;
+    /** The definition version the tracker's value is at: below the slot's, it migrates on its next access. */
+    version: number;
+    constructor(slot: {
+        evict(resident: Resident): void;
+    }, key: string, tracker: Tracker<JsonObject>, stored: Stored | undefined, version: number);
+}
+/** How long an unpinned persisted keyed document stays in memory after its last read or write (slice 6a §10). */
+export declare const RETENTION_MS: number;
+/** The idle persisted keyed documents of one object, oldest first, and the one timer evicting them. */
+export declare class Residency {
+    #private;
+    constructor(onLine: (sweep: () => void) => void);
+    /** A use of an unpinned `resident`: it becomes the newest idle one (once per granule), and a sweep is scheduled. */
+    touch(resident: Resident): void;
+    /** `resident` is pinned or left memory: it is no longer idle. */
+    forget(resident: Resident): void;
+    /** The object ended: nothing is evicted any more, the timer is cleared. */
+    end(): void;
+}
+//# sourceMappingURL=residency.d.ts.map

package/dist/next/documents/residency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"residency.d.ts","sourceRoot":"","sources":["../../../src/next/documents/residency.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C,gGAAgG;AAChG,qBAAa,QAAQ;IACpB,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,0GAA0G;IAC1G,OAAO,EAAE,MAAM,CAAC;IAEhB,YACC,IAAI,EAAE;QAAE,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,EACzC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EAOf;CACD;AAED,iHAAiH;AACjH,eAAO,MAAM,YAAY,QAAc,CAAC;AAKxC,uGAAuG;AACvG,qBAAa,SAAS;;IAQrB,YAAY,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,EAE9C;IAED,oHAAoH;IACpH,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQ9B;IAED,iEAAiE;IACjE,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAE/B;IAED,2EAA2E;IAC3E,GAAG,IAAI,IAAI,CAKV;CAmCD"}

package/dist/next/documents/residency.js

@@ -0,0 +1,93 @@
+// Residency of keyed documents (slice 6a §10, rule 23): which keyed documents are in memory, and the eviction of
+// persisted ones nobody pinned and nobody read or wrote for the retention. One idle structure and one timer per
+// object, Durable's (`Session.#touchDocument`): an insertion-ordered map whose oldest entry the timer waits for, a
+// touch moving an entry to the back at most once per granule (O(1) per touch, no timer per key).
+/** One keyed document in memory: its slot, its tracker and, persisted, what is stored of it. */
+export class Resident {
+    slot;
+    key;
+    tracker;
+    stored;
+    /** The definition version the tracker's value is at: below the slot's, it migrates on its next access. */
+    version;
+    constructor(slot, key, tracker, stored, version) {
+        this.slot = slot;
+        this.key = key;
+        this.tracker = tracker;
+        this.stored = stored;
+        this.version = version;
+    }
+}
+/** How long an unpinned persisted keyed document stays in memory after its last read or write (slice 6a §10). */
+export const RETENTION_MS = 10 * 60_000;
+/** A touch moves an entry at most once per granule: a tenth of the retention, up to 1 s (Durable's rule). */
+const GRANULE_MS = Math.min(1_000, RETENTION_MS / 10);
+/** The idle persisted keyed documents of one object, oldest first, and the one timer evicting them. */
+export class Residency {
+    /** Runs a sweep on the object's line. */
+    #onLine;
+    #idle = new Map();
+    /** The pending sweep: when it is due and its timer; stays set until its job runs on the line. */
+    #sweep;
+    #ended = false;
+    constructor(onLine) {
+        this.#onLine = onLine;
+    }
+    /** A use of an unpinned `resident`: it becomes the newest idle one (once per granule), and a sweep is scheduled. */
+    touch(resident) {
+        const now = Date.now();
+        const since = this.#idle.get(resident);
+        // A hot document moves at most once per granule: it may then leave up to a granule early (a reload).
+        if (since !== undefined && now - since < GRANULE_MS)
+            return;
+        this.#idle.delete(resident);
+        this.#idle.set(resident, now);
+        if (this.#sweep === undefined)
+            this.#schedule();
+    }
+    /** `resident` is pinned or left memory: it is no longer idle. */
+    forget(resident) {
+        this.#idle.delete(resident);
+    }
+    /** The object ended: nothing is evicted any more, the timer is cleared. */
+    end() {
+        this.#ended = true;
+        this.#idle.clear();
+        clearTimeout(this.#sweep?.timer);
+        this.#sweep = undefined;
+    }
+    /** Schedules the eviction of the oldest idle document when its retention expires. */
+    #schedule() {
+        const oldest = this.#idle.values().next();
+        if (this.#ended || oldest.done === true)
+            return;
+        const at = oldest.value + RETENTION_MS;
+        const sweep = { at, timer: undefined };
+        this.#sweep = sweep;
+        // A timer firing early sweeps nothing and schedules the next one.
+        sweep.timer = setTimeout(() => this.#onLine(() => {
+            if (this.#sweep === sweep)
+                this.#sweep = undefined;
+            this.#evictExpired();
+        }), Math.max(0, at - Date.now()));
+    }
+    /**
+     * On the line: evicts the idle documents whose retention passed, oldest first, then schedules the next sweep. No
+     * load in flight needs a pin against it: cold loads run on the line too, so a sweep never runs during one, and a
+     * load installing an unpinned key touches it (it is then the newest idle one).
+     */
+    #evictExpired() {
+        if (this.#ended)
+            return;
+        const expired = Date.now() - RETENTION_MS;
+        for (const [resident, since] of this.#idle) {
+            if (since > expired)
+                break;
+            this.#idle.delete(resident);
+            resident.slot.evict(resident);
+        }
+        if (this.#sweep === undefined)
+            this.#schedule();
+    }
+}
+//# sourceMappingURL=residency.js.map

package/dist/next/documents/residency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"residency.js","sourceRoot":"","sources":["../../../src/next/documents/residency.ts"],"names":[],"mappings":"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","sourcesContent":["// Residency of keyed documents (slice 6a §10, rule 23): which keyed documents are in memory, and the eviction of\n// persisted ones nobody pinned and nobody read or wrote for the retention. One idle structure and one timer per\n// object, Durable's (`Session.#touchDocument`): an insertion-ordered map whose oldest entry the timer waits for, a\n// touch moving an entry to the back at most once per granule (O(1) per touch, no timer per key).\n\nimport type { Tracker } from \"../../delta/index.ts\";\nimport type { JsonObject } from \"./definition.ts\";\nimport type { Stored } from \"./persistence.ts\";\n\n/** One keyed document in memory: its slot, its tracker and, persisted, what is stored of it. */\nexport class Resident {\n\treadonly slot: { evict(resident: Resident): void };\n\treadonly key: string;\n\ttracker: Tracker<JsonObject>;\n\tstored: Stored | undefined;\n\t/** The definition version the tracker's value is at: below the slot's, it migrates on its next access. */\n\tversion: number;\n\n\tconstructor(\n\t\tslot: { evict(resident: Resident): void },\n\t\tkey: string,\n\t\ttracker: Tracker<JsonObject>,\n\t\tstored: Stored | undefined,\n\t\tversion: number,\n\t) {\n\t\tthis.slot = slot;\n\t\tthis.key = key;\n\t\tthis.tracker = tracker;\n\t\tthis.stored = stored;\n\t\tthis.version = version;\n\t}\n}\n\n/** How long an unpinned persisted keyed document stays in memory after its last read or write (slice 6a §10). */\nexport const RETENTION_MS = 10 * 60_000;\n\n/** A touch moves an entry at most once per granule: a tenth of the retention, up to 1 s (Durable's rule). */\nconst GRANULE_MS = Math.min(1_000, RETENTION_MS / 10);\n\n/** The idle persisted keyed documents of one object, oldest first, and the one timer evicting them. */\nexport class Residency {\n\t/** Runs a sweep on the object's line. */\n\treadonly #onLine: (sweep: () => void) => void;\n\treadonly #idle = new Map<Resident, number>();\n\t/** The pending sweep: when it is due and its timer; stays set until its job runs on the line. */\n\t#sweep: { readonly at: number; timer: ReturnType<typeof setTimeout> | undefined } | undefined;\n\t#ended = false;\n\n\tconstructor(onLine: (sweep: () => void) => void) {\n\t\tthis.#onLine = onLine;\n\t}\n\n\t/** A use of an unpinned `resident`: it becomes the newest idle one (once per granule), and a sweep is scheduled. */\n\ttouch(resident: Resident): void {\n\t\tconst now = Date.now();\n\t\tconst since = this.#idle.get(resident);\n\t\t// A hot document moves at most once per granule: it may then leave up to a granule early (a reload).\n\t\tif (since !== undefined && now - since < GRANULE_MS) return;\n\t\tthis.#idle.delete(resident);\n\t\tthis.#idle.set(resident, now);\n\t\tif (this.#sweep === undefined) this.#schedule();\n\t}\n\n\t/** `resident` is pinned or left memory: it is no longer idle. */\n\tforget(resident: Resident): void {\n\t\tthis.#idle.delete(resident);\n\t}\n\n\t/** The object ended: nothing is evicted any more, the timer is cleared. */\n\tend(): void {\n\t\tthis.#ended = true;\n\t\tthis.#idle.clear();\n\t\tclearTimeout(this.#sweep?.timer);\n\t\tthis.#sweep = undefined;\n\t}\n\n\t/** Schedules the eviction of the oldest idle document when its retention expires. */\n\t#schedule(): void {\n\t\tconst oldest = this.#idle.values().next();\n\t\tif (this.#ended || oldest.done === true) return;\n\t\tconst at = oldest.value + RETENTION_MS;\n\t\tconst sweep: { readonly at: number; timer: ReturnType<typeof setTimeout> | undefined } = { at, timer: undefined };\n\t\tthis.#sweep = sweep;\n\t\t// A timer firing early sweeps nothing and schedules the next one.\n\t\tsweep.timer = setTimeout(\n\t\t\t() =>\n\t\t\t\tthis.#onLine(() => {\n\t\t\t\t\tif (this.#sweep === sweep) this.#sweep = undefined;\n\t\t\t\t\tthis.#evictExpired();\n\t\t\t\t}),\n\t\t\tMath.max(0, at - Date.now()),\n\t\t);\n\t}\n\n\t/**\n\t * On the line: evicts the idle documents whose retention passed, oldest first, then schedules the next sweep. No\n\t * load in flight needs a pin against it: cold loads run on the line too, so a sweep never runs during one, and a\n\t * load installing an unpinned key touches it (it is then the newest idle one).\n\t */\n\t#evictExpired(): void {\n\t\tif (this.#ended) return;\n\t\tconst expired = Date.now() - RETENTION_MS;\n\t\tfor (const [resident, since] of this.#idle) {\n\t\t\tif (since > expired) break;\n\t\t\tthis.#idle.delete(resident);\n\t\t\tresident.slot.evict(resident);\n\t\t}\n\t\tif (this.#sweep === undefined) this.#schedule();\n\t}\n}\n"]}