@earendil-works/chord 1.5.0 → 1.5.1

package/dist/next/index.js

@@ -1,18 +0,0 @@
-// Chord v2 (`@earendil-works/chord/next`, experimental): every layer's API for apps, and the store's surface for
-// adapters (Durable's `StoreStorage`), marked internal.
-export * from "./contracts/index.js";
-export * from "./data/index.js";
-export * from "./documents/index.js";
-export * from "./host/index.js";
-export * from "./jobs/index.js";
-export * from "./link/index.js";
-export * from "./registries/index.js";
-export * from "./state/index.js";
-/** @internal The store's surface for adapters (slice 6b §2.1). */
-export { OwnerTable, StoreOwnerTables } from "./store/adapter.js";
-/** @internal The sync layer's batch apply (slice 6b §1.6). */
-export { applyBatch } from "./store/apply-batch.js";
-/** @internal */
-export { findDocument, findDocumentEntry, insertDocument, listDocumentEntries, listDocuments, loadContent, loadDocument, readDocument, readDocumentEntry, retireRecord, writeContent, } from "./store/engine.js";
-export * from "./store/index.js";
-//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,wDAAwD;AAExD,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,kEAAkE;AAClE,OAAO,EAAmB,UAAU,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACnF,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,gBAAgB;AAChB,OAAO,EAQN,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,YAAY,EAEZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EAEZ,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAG3B,cAAc,kBAAkB,CAAC","sourcesContent":["// Chord v2 (`@earendil-works/chord/next`, experimental): every layer's API for apps, and the store's surface for\n// adapters (Durable's `StoreStorage`), marked internal.\n\nexport * from \"./contracts/index.ts\";\nexport * from \"./data/index.ts\";\nexport * from \"./documents/index.ts\";\nexport * from \"./host/index.ts\";\nexport * from \"./jobs/index.ts\";\nexport * from \"./link/index.ts\";\nexport * from \"./registries/index.ts\";\nexport * from \"./state/index.ts\";\n/** @internal The store's surface for adapters (slice 6b §2.1). */\nexport { type DecodedRow, OwnerTable, StoreOwnerTables } from \"./store/adapter.ts\";\n/** @internal The sync layer's batch apply (slice 6b §1.6). */\nexport { applyBatch } from \"./store/apply-batch.ts\";\n/** @internal */\nexport type { Claimant } from \"./store/claims.ts\";\n/** @internal */\nexport {\n\ttype DocumentAddress,\n\ttype DocumentContent,\n\ttype DocumentEntry,\n\ttype DocumentHistory,\n\ttype DocumentPoint,\n\ttype DocumentRecord,\n\ttype DocumentScope,\n\tfindDocument,\n\tfindDocumentEntry,\n\tinsertDocument,\n\tlistDocumentEntries,\n\tlistDocuments,\n\tloadContent,\n\tloadDocument,\n\ttype OwnedDocumentEntry,\n\treadDocument,\n\treadDocumentEntry,\n\tretireRecord,\n\ttype StoredDocument,\n\twriteContent,\n} from \"./store/engine.ts\";\n/** @internal */\nexport type { WhereNode } from \"./store/expression.ts\";\nexport * from \"./store/index.ts\";\n/** @internal */\nexport type { EncodedRow } from \"./store/rows.ts\";\n/** @internal */\nexport type { Order } from \"./store/sql.ts\";\n/** @internal */\nexport type { StagedWrite, Step } from \"./store/step.ts\";\n/** @internal */\nexport type { ChordStore, SeriesCommit, SeriesResult } from \"./store/store.ts\";\n"]}

package/dist/next/jobs/definition.d.ts.map

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

package/dist/next/jobs/definition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../src/next/jobs/definition.ts"],"names":[],"mappings":"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","sourcesContent":["// Job definitions (§15): `defineJob(name, …)`, the checks of a declaration, and the types of what a run ends with.\n\nimport { checkKeys, entriesOf } from \"../contracts/declare.ts\";\nimport type { Schema, Static } from \"../contracts/index.ts\";\nimport { checkName, hash64 } from \"../contracts/internal.ts\";\nimport { type Snapshot, snapshotArguments, snapshotSchema } from \"../contracts/snapshot.ts\";\nimport type { ChordError, PluginError } from \"../data/index.ts\";\nimport type { JsonObject, StateDefinition } from \"../documents/index.ts\";\n\n/** What `defineJob` takes besides the name. */\nexport type JobOptions<\n\tA extends Schema,\n\tR extends Schema,\n\tD extends StateDefinition<JsonObject, false, boolean> | undefined,\n> = {\n\t/** The job's version; every change of its args, result or state bumps it. */\n\treadonly version: number;\n\t/** The run's arguments: closed objects, JSON only (`running` carries them), checked at every start. */\n\treadonly args: A;\n\t/** What `run` returns; not validated. */\n\treadonly result: R;\n\t/**\n\t * A singleton document definition: one document per run, `ctx.state` in `run`, `outcome.state` in `finish`; a\n\t * persisted job's is persisted (`persist: true`, its `checkpointWhen`).\n\t */\n\treadonly state?: D;\n\t/** At most this many runs running or finishing per object; a start beyond it rejects `unavailable/busy`. */\n\treadonly concurrency?: number;\n\t/** Per older version, how its args and result map forwards (used from slice 7 on; checked now). */\n\treadonly accepts?: JobAccepts<A, R>;\n\t/**\n\t * Persists the runs in the object's store (slice 6b; only in `local` types with empty params, P3): how a run cut\n\t * off by a crash or a stop resumes, `rerun` (its `run` again: idempotent work) or `abandon` (`finish` gets `failed {\n\t * aborted, reason: \"restart\" }`). Its result is JSON only (no `bytes()`).\n\t */\n\treadonly persist?: JobPersistence;\n};\n\n/** How a persisted job's runs resume after a crash or a stop. */\nexport type JobPersistence = { readonly resume: \"rerun\" | \"abandon\" };\n\n/** Per older version, its mappings forwards: its args to the current args, its result to the current result. */\nexport type JobAccepts<A extends Schema = Schema, R extends Schema = Schema> = {\n\treadonly [version: number]: { readonly args: (old: never) => Static<A>; readonly result: (old: never) => Static<R> };\n};\n\n/** The value of a job's state document: the definition's document, `undefined` without one. */\ntype StateOf<D> = D extends StateDefinition<infer T, false, boolean> ? T : undefined;\n\n/** What a run ended with, as `finish` and `outcome` get it: its args and state, and its result or its error. */\nexport type Outcome<A, R, S> = { readonly id: string; readonly args: A; readonly state: S } & (\n\t| { readonly kind: \"done\"; readonly result: R }\n\t| { readonly kind: \"failed\"; readonly error: JobError }\n);\n\n/**\n * Why a run failed: `run` threw (reported as `job_failed`; anything but a ChordError or PluginError becomes a\n * PluginError `internal` with its message), it was aborted (`abort`: `abort(id)`; `restart`: cut off by its attempt's\n * seal while the object continues, or a persisted run abandoned after a crash; `reload` comes with slice 7), or a\n * persisted run was cut off five times in a row (`restart_limit`, D6).\n */\nexport type JobError =\n\t| { readonly kind: \"threw\"; readonly error: ChordError | PluginError }\n\t| { readonly kind: \"aborted\"; readonly reason: \"abort\" | \"reload\" | \"restart\" }\n\t| { readonly kind: \"restart_limit\"; readonly restarts: number };\n\n/** Declares a job: owned work a call starts that outlives it (§15). */\nexport function defineJob<\n\tconst A extends Schema,\n\tconst R extends Schema,\n\tD extends StateDefinition<JsonObject, false, boolean> | undefined = undefined,\n>(name: string, options: JobOptions<A, R, D>): JobDefinition<Static<A>, Static<R>, StateOf<D>> {\n\t// Declaration policy: JavaScript callers reach every check below.\n\tcheckName(name, \"A job name\");\n\tcheckKeys(options, [\"version\", \"args\", \"result\", \"state\", \"concurrency\", \"accepts\", \"persist\"], name);\n\tconst { version, state, concurrency, accepts, persist } = options;\n\tif (!Number.isSafeInteger(version) || version < 1) throw new Error(`${name}.version: expected a positive integer`);\n\tconst args = snapshotArguments(options.args, `${name}.args`);\n\tif (args.bytes) throw new Error(`${name}.args: job arguments are JSON (running carries them); no bytes()`);\n\tconst result = snapshotSchema(options.result, `${name}.result`);\n\tif (state?.keyed) throw new Error(`${name}.state: expected a singleton document definition`);\n\tif (persist !== undefined) checkPersistence(persist, state, result, name);\n\tif (concurrency !== undefined && !(Number.isSafeInteger(concurrency) && concurrency > 0)) {\n\t\tthrow new Error(`${name}.concurrency: expected a positive integer`);\n\t}\n\tif (accepts !== undefined) checkJobAccepts(accepts, version, `${name}.accepts`);\n\tconst fingerprint = hash64(\n\t\tJSON.stringify({ args: args.normal, result: result.normal, state: state?.fingerprint ?? null }),\n\t);\n\treturn new JobDefinition(name, version, args, result, state, concurrency, accepts ?? {}, persist, fingerprint);\n}\n\n/** A persisted job's declaration: a resume rule, a persisted state document (if any), a JSON-only result. */\nfunction checkPersistence(\n\tpersist: unknown,\n\tstate: StateDefinition<JsonObject, false, boolean> | undefined,\n\tresult: Snapshot,\n\tname: string,\n): void {\n\tcheckKeys(persist, [\"resume\"], `${name}.persist`);\n\tconst { resume } = persist as { readonly resume?: unknown };\n\tif (resume !== \"rerun\" && resume !== \"abandon\")\n\t\tthrow new Error(`${name}.persist.resume: expected \"rerun\" or \"abandon\"`);\n\tif (state !== undefined && !state.persist) {\n\t\tthrow new Error(`${name}.state: a persisted job's state is a persisted document (persist: true)`);\n\t}\n\tif (result.bytes) throw new Error(`${name}.result: a persisted job's result is JSON (it is stored); no bytes()`);\n}\n\n/** Checks an accepts table's shape: older versions only, each with an `args` and a `result` function. */\nfunction checkJobAccepts(accepts: unknown, version: number, path: string): void {\n\tfor (const [key, adapter] of entriesOf(accepts, path)) {\n\t\tconst older = Number(key);\n\t\tif (!Number.isSafeInteger(older) || older < 1 || older >= version) {\n\t\t\tthrow new Error(`${path}[${key}]: not an older version`);\n\t\t}\n\t\tcheckKeys(adapter, [\"args\", \"result\"], `${path}[${key}]`);\n\t\tconst { args, result } = adapter as { readonly args?: unknown; readonly result?: unknown };\n\t\tif (typeof args !== \"function\") throw new Error(`${path}[${key}].args: expected a function`);\n\t\tif (typeof result !== \"function\") throw new Error(`${path}[${key}].result: expected a function`);\n\t}\n}\n\n/** A declared job; `A`, `R` and `S` are its args, result and state document (`undefined` without one). */\nexport class JobDefinition<A, R, S> {\n\treadonly name: string;\n\treadonly version: number;\n\t/** The args schema, Chord's copy; its compiled check is cached by this snapshot. */\n\treadonly args: Snapshot;\n\treadonly result: Snapshot;\n\treadonly state: StateDefinition<JsonObject, false, boolean> | undefined;\n\treadonly concurrency: number | undefined;\n\t/** The older versions' mappings, checked at declaration; slice 7 maps older runs with them. */\n\treadonly accepts: JobAccepts;\n\t/** How its runs persist; `undefined` for a job in memory. */\n\treadonly persist: JobPersistence | undefined;\n\t/** `hash64` of its args', result's and state's normal forms: a stored run of another fingerprint is blocked. */\n\treadonly fingerprint: string;\n\t/** Type only: the args, result and state types. */\n\tdeclare readonly \"~types\"?: { readonly args: A; readonly result: R; readonly state: S };\n\n\tconstructor(\n\t\tname: string,\n\t\tversion: number,\n\t\targs: Snapshot,\n\t\tresult: Snapshot,\n\t\tstate: StateDefinition<JsonObject, false, boolean> | undefined,\n\t\tconcurrency: number | undefined,\n\t\taccepts: JobAccepts,\n\t\tpersist: JobPersistence | undefined,\n\t\tfingerprint: string,\n\t) {\n\t\tthis.name = name;\n\t\tthis.version = version;\n\t\tthis.args = args;\n\t\tthis.result = result;\n\t\tthis.state = state;\n\t\tthis.concurrency = concurrency;\n\t\tthis.accepts = accepts;\n\t\tthis.persist = persist;\n\t\tthis.fingerprint = fingerprint;\n\t}\n}\n"]}

package/dist/next/jobs/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/jobs/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,SAAS,EACT,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,OAAO,GACZ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/next/jobs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next/jobs/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACN,SAAS,GAMT,MAAM,iBAAiB,CAAC","sourcesContent":["// Jobs for apps: declaring a job, its handle, its runs, their outcomes and `running`.\n\nexport {\n\tdefineJob,\n\ttype JobAccepts,\n\ttype JobDefinition,\n\ttype JobError,\n\ttype JobOptions,\n\ttype Outcome,\n} from \"./definition.ts\";\nexport type { JobCtx, JobHandle, JobImplementation, RunState, StartOptions } from \"./job.ts\";\nexport type { BlockedReason, Run } from \"./run.ts\";\nexport type { RunningEntry } from \"./running.ts\";\n"]}

package/dist/next/jobs/internal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/next/jobs/internal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,SAAS,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/next/jobs/internal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../src/next/jobs/internal.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAE9G,OAAO,EAA6C,GAAG,EAAiB,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC","sourcesContent":["// Jobs for Chord's layers: a job's records on its object and the handle an attempt keeps, and what they need.\n\nexport { type AnyJobImplementation, type CutReason, Job, type JobOwner } from \"./job.ts\";\nexport { JobRecords, type RecordsOwner } from \"./records.ts\";\n"]}

package/dist/next/jobs/job.d.ts

@@ -1,152 +0,0 @@
-import { type Context } from "../../context/index.ts";
-import type { Draft } from "../../delta/index.ts";
-import type { JsonValue } from "../../json.ts";
-import type { Watchable } from "../../watch.ts";
-import { ChordError, type Principal } from "../data/index.ts";
-import type { CommitPersistence, JsonObject, Tx } from "../documents/index.ts";
-import type { Documents, SealToken, Transaction } from "../documents/internal.ts";
-import { type Ctx } from "../host/index.ts";
-import { type AnyHost, CallContext, type Caller } from "../host/internal.ts";
-import type { Outcome } from "./definition.ts";
-import type { JobRecords } from "./records.ts";
-import type { AnyOutcome, JobRun, Run } from "./run.ts";
-import type { RunningEntry } from "./running.ts";
-/** A job's handle, `self.job(Job, { run, finish? })`; `A`, `R` and `S` are its args, result and state. */
-export interface JobHandle<A, R, S> {
-    /**
-     * Starts a run in one transaction on the object's line and resolves with its `Run` after the commit: the args
-     * checked (`invalid/args`); a `key` of an unsettled run returns that run; at the `concurrency` limit (running plus
-     * finishing runs) it rejects `unavailable/busy`. `run` starts after the commit.
-     */
-    start(args: A, context: Context, options?: StartOptions): Promise<Run<Outcome<A, R, S>>>;
-    /** Waits for the outcome of the unsettled run `id`; a settled or unknown id rejects `gone`. */
-    outcome(id: string, context: Context): Promise<Outcome<A, R, S>>;
-    /**
-     * Aborts run `id` (D7, as Durable's `abortTask`): marks it (stored for a persisted job) and fires its `run`'s
-     * signal, resolving `"marked"` once its `run` settled (a run not invoked yet ends `aborted` without one); a
-     * finishing run is only marked, a blocked one dropped (no `finish`; its waiters reject `aborted`). `"terminal"` when
-     * no unsettled run has that id. `context` ends only this wait.
-     */
-    abort(id: string, context: Context): Promise<"marked" | "terminal">;
-    /** The unsettled runs, one entry each in start order, tagged by phase (a JSON watchable, a state member). */
-    readonly running: Watchable<readonly RunningEntry<A, S>[]>;
-}
-/** What `start` and `tx.start` take besides the args. */
-export type StartOptions = {
-    /** Names one run: a start with the key of an unsettled run returns that run (args not compared). */
-    readonly key?: string;
-};
-/** What `self.job` takes: the run and the optional finish. */
-export type JobImplementation<A, R, S, P extends Principal = Principal> = {
-    /** The work, outside transactions; its ctx's abort signal fires on `abort(id)` and on its object's end. */
-    readonly run: (args: A, ctx: JobCtx<P, S>) => Promise<R>;
-    /** Records the outcome in one transaction (only `await tx.*`); the run's record and state document go with it. */
-    readonly finish?: (outcome: Outcome<A, R, S>, tx: Tx) => void | Promise<void>;
-};
-/** A run's ctx: a handler's ctx (the object's principal or the host's), its run's id and, with a state, the state. */
-export type JobCtx<P extends Principal, S> = Ctx<P> & {
-    readonly jobId: string;
-} & ([S] extends [undefined] ? unknown : {
-    readonly state: RunState<S>;
-});
-/** A run's state document. */
-export interface RunState<S> {
-    /** The document's value. */
-    readonly value: S;
-    /**
-     * One transaction on the object's line drafting only this document, under `context` without its abort signal:
-     * admitted while `run` runs (also after an abort, with the run's own ctx), refused `released` once it settled. A
-     * persisted job's change may be `deferred` (D8): adopted and published at once, stored within `withinMs` (1,000 ms by
-     * default) or earlier; a crash loses it. In memory the option changes nothing.
-     */
-    change<T>(fn: (draft: Draft<S>) => T, context: Context, options?: {
-        readonly persistence?: CommitPersistence;
-    }): Promise<T>;
-}
-/** Where a job's handle runs its work: its attempt, as the job sees it. */
-export type JobOwner = {
-    readonly host: AnyHost;
-    /** Whom runs act for: the object's principal (remote) or the host's (local), from this host. */
-    readonly caller: Caller;
-    /** The object's context, without an abort signal: runs, state changes and finishes run under it. */
-    readonly context: Context;
-    /** Aborted when the attempt is sealed: a finish's backoff waits under it. */
-    readonly signal: AbortSignal;
-    /** The attempt's seal token: its starts and finishes are transactions under it. */
-    readonly token: SealToken;
-    readonly documents: Documents;
-    /**
-     * Adds running work (a finish, a reservation) to the attempt's calls drain; `cleanup` (its bookkeeping) runs once,
-     * when it settles or when the attempt ends with it still running.
-     */
-    admit(running: Promise<unknown>, cleanup?: () => void): void;
-    /** Adds a run's invocation to the attempt's drain at its end (a swap does not wait for it), as `admit`. */
-    admitRun(running: Promise<unknown>, cleanup: () => void): void;
-};
-/**
- * Why a seal cuts a running in-memory run off: `restart` (its attempt ended while the object continues) or `reload`
- * (a native restart, slice 7b §8); its outcome is `failed { aborted }` with that reason.
- */
-export type CutReason = "restart" | "reload";
-/** A job's implementation as Chord calls it, whatever the job's types. */
-export type AnyJobImplementation = {
-    readonly run: (args: JsonValue, ctx: JobContext) => Promise<unknown>;
-    readonly finish?: (outcome: AnyOutcome, tx: Tx) => void | Promise<void>;
-};
-/**
- * A job as one attempt declares it: its implementation and the invocations and finishes running on the attempt. Starts
- * are taken while the attempt is live; the object's records keep the runs.
- */
-export declare class Job implements JobHandle<JsonValue, unknown, JsonValue | undefined> {
-    #private;
-    constructor(records: JobRecords, implementation: AnyJobImplementation, owner: JobOwner);
-    get running(): Watchable<readonly RunningEntry<JsonValue, JsonValue | undefined>[]>;
-    start(args: JsonValue, context: Context, options?: StartOptions): Promise<Run<AnyOutcome>>;
-    outcome(id: string, context: Context): Promise<AnyOutcome>;
-    abort(id: string, context: Context): Promise<"marked" | "terminal">;
-    /** A persisted job's runs, loaded once per object at its first activation (before it goes live). */
-    load(context: Context): Promise<void>;
-    /** The close writer of this job's runs, after the attempt's drain (slice 6b §4.2). */
-    writeAtClose(context: Context): Promise<void>;
-    /** The attempt went live: starts are taken, and the records' waiting runs are invoked or finished here. */
-    live(): void;
-    /**
-     * Stages a run in `tx` (`start`, `tx.start`), in order: the args checked, dedupe by key (runs started earlier in
-     * `tx` included), the concurrency check, then the record and the state document, created in the commit. The run
-     * whose finish `tx` is counts for neither: `finish` may start the same job again, with the same key too. Returns
-     * the run's handle at once; a start that only dedupes stages nothing.
-     */
-    stage(tx: Transaction, args: unknown, context: Context, options: StartOptions): Run<AnyOutcome>;
-    /**
-     * The attempt is sealed with `error`: starts are refused, running invocations are cut off (their signals fire, in
-     * memory they end `aborted` with `reason` and finish on the next live attempt, persisted ones are stopped and
-     * resumed, R3), and the runs finishing here wait for it.
-     */
-    seal(error: ChordError, reason: CutReason): void;
-    /**
-     * A reload swapped its attempt out (slice 7b §8): starts are refused, the records go to the new attempt's job once it
-     * is live, the runs it invokes finish on this code (their outcome is finished by the new code), a finish running here
-     * completes here.
-     */
-    handOver(): void;
-    /**
-     * Runs `run` for a committed run (with its signal aborted already after an early abort); a persisted run's
-     * reservation commits first (`running`: a crash from then on counts, D6). The reservation, the invocation and the
-     * run's finish are one piece of work in the drain, admitted before plugin code runs: `run` may end its own object
-     * before its first await.
-     */
-    invoke(run: JobRun): void;
-    /**
-     * Runs the finish of `run`, whose outcome is recorded: `finish` with the cleanup in one transaction under the
-     * attempt's token, retried with backoff after a throw (reported), blocked after five in a row. The attempt's seal
-     * stops it without a report or a count; the next live attempt finishes the run.
-     */
-    finish(run: JobRun): void;
-}
-/** A run's ctx: the handler's ctx of its object, its id and, with a state, its state document. */
-export declare class JobContext extends CallContext {
-    readonly jobId: string;
-    readonly state: RunState<JsonObject> | undefined;
-    constructor(context: Context, caller: Caller, host: AnyHost, jobId: string, state: RunState<JsonObject> | undefined);
-}
-//# sourceMappingURL=job.d.ts.map

package/dist/next/jobs/job.d.ts.map

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

package/dist/next/jobs/job.js

@@ -1,320 +0,0 @@
-// Jobs (§15), in memory: the handle `self.job` returns, one per attempt, over the job's records on its object. It
-// holds the implementation and the invocations: `run` runs outside transactions, `finish` in one with the cleanup,
-// both on the attempt that is live; the attempt's seal cuts its invocations off (slice 6a §1.3).
-import { withAbortSignal, withoutAbortSignal } from "../../context/index.js";
-import { ChordError, isChordError, PluginError } from "../data/index.js";
-import { sleep } from "../host/index.js";
-import { CallContext, nextDelay } from "../host/internal.js";
-/** Failed finishes in a row after which a run is blocked. */
-const FINISH_ATTEMPTS = 5;
-/**
- * A job as one attempt declares it: its implementation and the invocations and finishes running on the attempt. Starts
- * are taken while the attempt is live; the object's records keep the runs.
- */
-export class Job {
-    #records;
-    /** The definition its attempt declared: its invocations get args in its version, whatever the records' is now. */
-    #definition;
-    #implementation;
-    #owner;
-    /**
-     * `declared` until the attempt is live (starts are refused), `handed` once a reload's swap gave its records to the
-     * new attempt's job (starts refused, its invocations finish here), `sealed` once it is sealed.
-     */
-    #state = "declared";
-    /** Runs whose `run` runs on this attempt. */
-    #invocations = new Set();
-    /** The seal's error and cut reason, once sealed: a reservation committing after it cuts its run off with them. */
-    #sealed;
-    /** Runs whose finish runs on this attempt. */
-    #finishing = new Set();
-    constructor(records, implementation, owner) {
-        this.#records = records;
-        // Its attempt's declaration redefined the records just before (`ChordObject.jobRecords`).
-        this.#definition = records.definition;
-        this.#implementation = implementation;
-        this.#owner = owner;
-    }
-    get running() {
-        // Its value is the list of entries `JobRun.entryFor` builds.
-        return this.#records.running;
-    }
-    async start(args, context, options = {}) {
-        const { documents, token } = this.#owner;
-        return documents.tx((tx) => this.stage(tx, args, context, options), token, context);
-    }
-    outcome(id, context) {
-        return this.#records.outcome(id, context);
-    }
-    abort(id, context) {
-        return this.#records.abort(id, context);
-    }
-    /** A persisted job's runs, loaded once per object at its first activation (before it goes live). */
-    load(context) {
-        return this.#records.load(context);
-    }
-    /** The close writer of this job's runs, after the attempt's drain (slice 6b §4.2). */
-    writeAtClose(context) {
-        return this.#records.writeAtClose(context);
-    }
-    /** The attempt went live: starts are taken, and the records' waiting runs are invoked or finished here. */
-    live() {
-        if (this.#state !== "declared")
-            return;
-        this.#state = "live";
-        this.#records.attach(this);
-    }
-    /**
-     * Stages a run in `tx` (`start`, `tx.start`), in order: the args checked, dedupe by key (runs started earlier in
-     * `tx` included), the concurrency check, then the record and the state document, created in the commit. The run
-     * whose finish `tx` is counts for neither: `finish` may start the same job again, with the same key too. Returns
-     * the run's handle at once; a start that only dedupes stages nothing.
-     */
-    stage(tx, args, context, options) {
-        // Declaration policy: a handle belongs to its object (types cannot say whose transaction this is).
-        if (tx.documents !== this.#owner.documents) {
-            throw new Error(`${this.#owner.documents.label}: a transaction starts only its own object's jobs`);
-        }
-        if (this.#state === "sealed" || this.#state === "handed") {
-            throw new ChordError({
-                code: "released",
-                reason: "ended",
-                message: `${this.#records.name}: its attempt ended`,
-            });
-        }
-        if (this.#state === "declared") {
-            throw new ChordError({ code: "not_ready", message: `${this.#records.name}: its object is not live yet` });
-        }
-        return this.#records.stage(tx, args, context, options);
-    }
-    /**
-     * The attempt is sealed with `error`: starts are refused, running invocations are cut off (their signals fire, in
-     * memory they end `aborted` with `reason` and finish on the next live attempt, persisted ones are stopped and
-     * resumed, R3), and the runs finishing here wait for it.
-     */
-    seal(error, reason) {
-        if (this.#state === "sealed")
-            return;
-        const handed = this.#state === "handed";
-        this.#state = "sealed";
-        this.#sealed = { error, reason };
-        this.#records.detach(this, this.#finishing);
-        this.#finishing.clear();
-        // A handed-over job's invocations finish on its code; their outcomes go to the new attempt's job.
-        if (!handed)
-            for (const run of this.#invocations)
-                this.#records.cut(run, error, reason);
-        this.#invocations.clear();
-    }
-    /**
-     * A reload swapped its attempt out (slice 7b §8): starts are refused, the records go to the new attempt's job once it
-     * is live, the runs it invokes finish on this code (their outcome is finished by the new code), a finish running here
-     * completes here.
-     */
-    handOver() {
-        if (this.#state !== "live" && this.#state !== "declared")
-            return;
-        this.#state = "handed";
-        // Runs needing a live attempt meanwhile wait for the new one.
-        this.#records.detach(this, []);
-    }
-    /**
-     * Runs `run` for a committed run (with its signal aborted already after an early abort); a persisted run's
-     * reservation commits first (`running`: a crash from then on counts, D6). The reservation, the invocation and the
-     * run's finish are one piece of work in the drain, admitted before plugin code runs: `run` may end its own object
-     * before its first await.
-     */
-    invoke(run) {
-        const invocation = run.begin();
-        if (!this.#records.persisted || run.phase === "running") {
-            this.#start(run, invocation);
-            return;
-        }
-        const { documents, token, context } = this.#owner;
-        const reserving = documents
-            .tx((tx) => this.#records.reserve(tx, run), token, context)
-            .then(() => {
-            if (this.#state !== "sealed") {
-                this.#start(run, invocation);
-                return;
-            }
-            this.#records.cut(run, this.#sealed.error, this.#sealed.reason);
-            // No `run` started: nothing else ends it, and an abort joined to it returns.
-            invocation.ended();
-        }, () => {
-            invocation.settle();
-            invocation.ended();
-            // Refused because this attempt was sealed (at admission, or queued past the seal): the run is pending still,
-            // for the next live attempt (this one is detached already). Any other failure (the store closed or failed,
-            // the object ended) is not retried here: retrying on this attempt would only fail again.
-            if (this.#state === "sealed")
-                this.#records.requeue(run);
-        });
-        this.#owner.admit(reserving);
-    }
-    /** Starts `invocation` of `run` on this attempt: its ctx and its settling act for this invocation only. */
-    #start(run, invocation) {
-        const { context, caller, host } = this.#owner;
-        const signal = invocation.abort.signal;
-        const ctx = new JobContext(withAbortSignal(signal, context), caller, host, run.id, this.#stateOf(run, invocation));
-        const work = Promise.withResolvers();
-        this.#owner.admitRun(work.promise, () => ctx.settle());
-        this.#invocations.add(run);
-        const running = (async () => {
-            try {
-                // Its own version's args: a handed-over attempt's late start runs its own code (Sol, reservation).
-                return await this.#implementation.run(this.#records.argsOf(run, this.#definition), ctx);
-            }
-            finally {
-                // The fence closes as `run` settles: a change made later is refused.
-                invocation.settle();
-            }
-        })();
-        running
-            .then((result) => this.#settled(run, invocation, ctx, { kind: "done", result }), (error) => this.#settled(run, invocation, ctx, this.#failed(run, invocation, error)))
-            .finally(() => invocation.ended())
-            .then(work.resolve);
-    }
-    /**
-     * Runs the finish of `run`, whose outcome is recorded: `finish` with the cleanup in one transaction under the
-     * attempt's token, retried with backoff after a throw (reported), blocked after five in a row. The attempt's seal
-     * stops it without a report or a count; the next live attempt finishes the run.
-     */
-    finish(run) {
-        const work = this.#finish(run);
-        this.#owner.admit(work);
-    }
-    /** How a throwing `run` ended: `aborted` after its invocation's signal fired, otherwise `threw` (reported). */
-    #failed(run, invocation, error) {
-        if (invocation.abort.signal.aborted)
-            return { kind: "failed", error: { kind: "aborted", reason: "abort" } };
-        this.#records.report({ kind: "job_failed", id: run.id, error });
-        const thrown = isChordError(error) || error instanceof PluginError ? error : internal(error);
-        return { kind: "failed", error: { kind: "threw", error: thrown } };
-    }
-    /**
-     * `invocation` of `run` settled: its `ctx.get` references go; its outcome is recorded unless the attempt's seal cut
-     * it off (which recorded its own, or stopped the run for a later invocation), then the run finishes here while this
-     * attempt is live.
-     */
-    async #settled(run, invocation, ctx, ended) {
-        ctx.settle();
-        if (invocation.token.sealed || run.invocation !== invocation)
-            return;
-        this.#invocations.delete(run);
-        this.#records.settled(run, ended);
-    }
-    async #finish(run) {
-        const { documents, token, context, signal } = this.#owner;
-        this.#finishing.add(run);
-        let delay;
-        try {
-            for (;;) {
-                try {
-                    return await documents.tx(async (tx) => {
-                        const staging = this.#records.staging(tx);
-                        staging.finishing = run;
-                        await this.#implementation.finish?.(this.#records.outcomeOf(run, context), tx);
-                        this.#records.change(tx, { kind: "delete", run });
-                    }, token, context);
-                }
-                catch (error) {
-                    if (this.#state === "sealed")
-                        return;
-                    this.#records.report({ kind: "job_finish_failed", id: run.id, error });
-                    // The count is the run's (stored for a persisted job): failures count across a crash.
-                    const finishFailures = run.finishFailures + 1;
-                    if (finishFailures >= FINISH_ATTEMPTS) {
-                        return await this.#records.record(run, { kind: "block", run, reason: "finish_failed" });
-                    }
-                    await this.#records.record(run, { kind: "update", run, fields: { finishFailures } });
-                    delay = nextDelay(delay);
-                    try {
-                        await sleep(delay, withAbortSignal(signal, context));
-                    }
-                    catch {
-                        return;
-                    }
-                }
-            }
-        }
-        finally {
-            this.#finishing.delete(run);
-        }
-    }
-    /** `ctx.state` of `invocation` of `run`, when the job has a state: changes under its token while it runs. */
-    #stateOf(run, invocation) {
-        const records = this.#records;
-        const states = records.states;
-        if (states === undefined)
-            return undefined;
-        const { documents } = this.#owner;
-        const refused = () => new ChordError({
-            code: "released",
-            reason: "settled",
-            message: `${records.name}: run ${run.id} settled; its state is closed`,
-        });
-        return {
-            get value() {
-                const value = records.stateOf(run.id);
-                if (value === undefined)
-                    throw refused();
-                return value;
-            },
-            change: (fn, context, options = {}) => {
-                if (invocation.state !== "running")
-                    return Promise.reject(refused());
-                let persistence;
-                try {
-                    persistence = checkedPersistence(options.persistence, records.name);
-                }
-                catch (error) {
-                    return Promise.reject(error);
-                }
-                // Never the abort signal: a run records its progress also after an abort.
-                const unaborted = withoutAbortSignal(context);
-                // A change resetting the restart count is stored at once: the reset must be durable (D8).
-                const now = run.restarts === 0 ? persistence : IMMEDIATE;
-                return documents.tx(async (tx) => {
-                    const value = fn(await tx.draftSlot(states, run.id));
-                    records.progressed(tx, run);
-                    return value;
-                }, invocation.token, unaborted, now);
-            },
-        };
-    }
-}
-const IMMEDIATE = { kind: "immediate" };
-/**
- * A state change's `persistence` (a trust boundary: plugin code): `immediate` when omitted; a deferred one's `withinMs`
- * a number from 0 (`Infinity` waits for the others), `invalid/args` otherwise.
- */
-function checkedPersistence(persistence, what) {
-    if (persistence === undefined || persistence.kind === "immediate")
-        return IMMEDIATE;
-    const { withinMs } = persistence;
-    if (persistence.kind !== "deferred" ||
-        (withinMs !== undefined && !(typeof withinMs === "number" && withinMs >= 0))) {
-        throw new ChordError({
-            code: "invalid",
-            reason: "args",
-            message: `${what}: persistence is immediate or deferred with withinMs >= 0`,
-        });
-    }
-    return persistence;
-}
-/** A plugin's throw that is neither a ChordError nor a PluginError, as a run's outcome keeps it. */
-function internal(error) {
-    return new PluginError("internal", error instanceof Error ? error.message : String(error));
-}
-/** A run's ctx: the handler's ctx of its object, its id and, with a state, its state document. */
-export class JobContext extends CallContext {
-    jobId;
-    constructor(context, caller, host, jobId, state) {
-        super(context, caller, host);
-        this.jobId = jobId;
-        if (state !== undefined)
-            this.state = state;
-    }
-}
-//# sourceMappingURL=job.js.map