@arki/journal 0.0.0-stage → 0.1.1

package/dist/api.d.ts

@@ -0,0 +1,336 @@
+/**
+ * The public declarations: the `Journal` object, commands and their context, the
+ * definition helpers `initJournal` returns, and the input, option and result types.
+ * Types only, no runtime code. May import `entity`, `types` and `pg`; nothing else.
+ */
+import type { z } from 'zod';
+import type { EntityBuilder } from './entity.js';
+import type { HookPoint } from './hooks.js';
+import type { JournalTables } from './pg.js';
+import type { AnyEntity, AnyEventDef, CommandHookContext, DbHandle, Effect, EffectHandlers, EffectHookContext, EntityDef, EntityId, EntityInfo, EntityTable, EventDef, EventOptions, IdTable, JournalWorker, KeyName, Needs, PendingOf, Projection, ProjectionHandlers, ProjectionOptions, RecordedOf, ReducerRow, RootDb, Row, Services, ServicesFor, SingleKey, StrandedJobs, Tap, TapHandlers, TransactionSource, WakeListener } from './types.js';
+/**
+ * Looks at the locked row, checks the rules, and returns the events to append.
+ * Runs after the row is locked, inside the write's savepoint. `tx` is that
+ * savepoint: reads through it see the locked row's transaction.
+ */
+export type NextEvents<Tbl extends EntityTable, E extends AnyEventDef, Tx = DbHandle> = (row: Row<Tbl> | null, ctx: {
+    readonly tx: Tx;
+}) => readonly PendingOf<E>[] | Promise<readonly PendingOf<E>[]>;
+/** Options of a write, from `journal.write` or a command's `write`. */
+export type WriteOptions = {
+    /**
+     * The row version the caller saw. If the stored version differs (0 for no row), the
+     * write is refused with `CONFLICT` before `events` runs, so a client that edited a
+     * stale copy learns it instead of overwriting a newer one.
+     */
+    readonly expectedVersion?: number;
+};
+export type WriteInput<Tbl extends EntityTable, E extends AnyEventDef, Meta extends z.ZodObject, Tx = DbHandle> = WriteOptions & {
+    readonly meta: z.input<Meta>;
+    readonly events: NextEvents<Tbl, E, Tx>;
+};
+/**
+ * A command: a name, an input schema and a handler. `j.command` makes one;
+ * `journal.run` runs it. `name` and `input` are for the app (an oRPC procedure
+ * can reuse or `.pick` the schema). The handler is for `journal.run` only.
+ */
+export type Command<S extends z.ZodType, R, in MetaOut, in Tx extends TransactionSource<Tx> = DbHandle> = {
+    readonly name: string;
+    readonly input: S;
+    readonly handler: (input: z.output<S>, context: CommandContext<MetaOut, Tx>) => R;
+};
+/**
+ * What a command handler receives. `write` and `run` are bound to the command's
+ * transaction and metadata. The variance annotations here and on `Command` are
+ * needed: the two types refer to each other, and TypeScript cannot measure the
+ * variance of such a pair on its own.
+ */
+/** Options of one call: `journal.run`, a bound runner, a command's `run`, an effect's `ctx.run`. */
+export type CallOptions = {
+    /**
+     * Makes the call idempotent. The first run with this key records its result in
+     * `journal_receipts`, in its own transaction. A later run with the same key and the same
+     * input returns that result without running the handler; the same key with another input
+     * or another command is `CONFLICT`. The result must survive JSON storage, or the first run
+     * fails with `UNSTABLE_SCHEMA`. Scope a key from outside to its caller: `${tenant}:${id}`.
+     */
+    readonly idempotencyKey?: string;
+};
+/** Options of `journal.run` and `journal.bind`. */
+export type RunOptions = CallOptions & {
+    /**
+     * Seeds the chain's correlation id, for example with the request id. Without it, a run
+     * from an effect continues the cause event's chain, and any other run starts a new one.
+     */
+    readonly correlationId?: string;
+};
+export type CommandContext<out MetaOut, out Tx extends TransactionSource<Tx> = DbHandle> = {
+    /** The command's transaction. Use it for reads and for writes outside any entity. */
+    readonly tx: Tx;
+    /** The parsed metadata every `write` in this command records. */
+    readonly meta: MetaOut;
+    /** This run's `cmd_` id. Every event it writes carries it. */
+    readonly commandId: string;
+    /** The chain this run belongs to. Every event it writes carries it; a child run inherits it. */
+    readonly correlationId: string;
+    /** `journal.write` on this command's transaction with this command's metadata. Safe to destructure. */
+    readonly write: <K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(entity: EntityDef<K, Tbl, E, MetaOut, Key>, id: EntityId<Tbl, Key>, events: NextEvents<Tbl, E, Tx>, opts?: WriteOptions) => Promise<WriteResult<Tbl, E, MetaOut, Key>>;
+    /** Run another command in a savepoint of this transaction, with the same metadata. Safe to destructure. */
+    readonly run: <S extends z.ZodType, R>(command: Command<S, R, MetaOut, Tx>, input: NoInfer<z.input<S>>, opts?: CallOptions) => Promise<Awaited<R>>;
+};
+/**
+ * The type of `context.run`. Use it in app code that passes `run` on, so the
+ * generic signature is not repeated there.
+ */
+export type CommandRunner<MetaOut, Tx extends TransactionSource<Tx> = DbHandle> = CommandContext<MetaOut, Tx>['run'];
+/**
+ * The type of an effect's `ctx.run`: `journal.run` without `source`. It runs on the
+ * root database the worker or `drain` was given, in its own transaction. `meta`
+ * is required, as in `journal.run`: the library never picks an actor.
+ */
+export type RootCommandRunner<Meta extends z.ZodObject, Tx extends TransactionSource<Tx> = DbHandle> = <S extends z.ZodType, R>(command: Command<S, R, z.output<Meta>, Tx>, input: NoInfer<z.input<S>>, meta: z.input<Meta>, opts?: CallOptions) => Promise<Awaited<R>>;
+export type WriteResult<Tbl extends EntityTable, E extends AnyEventDef, MetaOut, Key extends string = 'id'> = {
+    readonly row: Row<Tbl> | null;
+    readonly events: RecordedOf<E, MetaOut, EntityId<Tbl, Key>>[];
+};
+export type ForgetResult<Tbl extends EntityTable> = {
+    /** How many events were rewritten in this call. Already-erased events count again: the rewrite is the same. */
+    readonly erased: number;
+    /** The row after repair from the erased log, or `null` if the log says the entity is gone. */
+    readonly row: Row<Tbl> | null;
+};
+export type ReplayResult<Tbl extends EntityTable, E extends AnyEventDef, MetaOut, Key extends string = 'id'> = {
+    readonly row: ReducerRow<Tbl, Key> | null;
+    readonly events: RecordedOf<E, MetaOut, EntityId<Tbl, Key>>[];
+};
+export type VerifyResult<Tbl extends EntityTable, Key extends string = 'id'> = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly expected: ReducerRow<Tbl, Key> | null;
+    readonly actual: Row<Tbl> | null;
+};
+export type Journal<Meta extends z.ZodObject, Tx extends TransactionSource<Tx> = DbHandle, AppDb extends RootDb = RootDb> = {
+    /** Append events, run reducers, save the row, run projections, queue jobs. All inside `tx`. */
+    write<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(tx: Tx, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>, input: WriteInput<Tbl, E, Meta, Tx>): Promise<WriteResult<Tbl, E, z.output<Meta>, Key>>;
+    /**
+     * Parse `input` and `meta`, then call the command's handler inside one
+     * transaction of `source`. A root database opens a transaction; a transaction
+     * opens a savepoint. Returns what the handler returns. Errors pass through.
+     * On a root database, a run that queued a job calls `wake()` after the commit.
+     */
+    run<S extends z.ZodType, R>(source: TransactionSource<Tx>, command: Command<S, R, z.output<Meta>, Tx>, input: NoInfer<z.input<S>>, meta: z.input<Meta>, opts?: RunOptions): Promise<Awaited<R>>;
+    /**
+     * The command door: `run` with `source` and `meta` fixed. It returns
+     * `(command, input) => journal.run(source, command, input, meta)`. A request
+     * context binds it once with the signed-in actor; a job binds it with a
+     * system actor. The caller still gives `meta`: the library never picks an actor.
+     * `source` follows the rules of `run`: a root database commits and wakes, a
+     * transaction joins and leaves the commit to the caller.
+     * `meta` is parsed on every call, not once here, so a bound runner is exactly
+     * `run`: a default in the meta schema gives each command its own value, and
+     * a bad `meta` rejects the call, inside the transaction guard, as `run` does.
+     */
+    bind(source: TransactionSource<Tx>, meta: z.input<Meta>, opts?: RunOptions): CommandRunner<z.output<Meta>, Tx>;
+    /**
+     * Bring a row that existed before the journal into it. The row must be at version 0
+     * with no history, or `CONFLICT`. `events` builds exactly one create event from the
+     * stored row. Its `.create` reducer must rebuild that row exactly, column by column,
+     * or `VALUE_MISMATCH` and nothing changes: replay folds from nothing and must land on
+     * the row as it is. The event is recorded as version 1 and the row moves to version 1,
+     * so `replay`, `verify` and `repair` work from then on. Projections run and effects
+     * are queued as for any write, because the event is the app's own.
+     */
+    adopt<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(tx: Tx, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>, input: WriteInput<Tbl, E, Meta, Tx>): Promise<WriteResult<Tbl, E, z.output<Meta>, Key>>;
+    /** Rebuild the row from the log in memory. `throughVersion` is the last version applied. */
+    replay<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(db: DbHandle, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>, opts?: {
+        readonly throughVersion?: number;
+    }): Promise<ReplayResult<Tbl, E, z.output<Meta>, Key>>;
+    /** Replay and compare with the stored row on the columns the reducers produce. */
+    verify<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(db: DbHandle, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>): Promise<VerifyResult<Tbl, Key>>;
+    /**
+     * Remove personal data from one entity's history. Every stored event whose definition
+     * has an `erased` form gets its `data` rewritten to that form and `erased_at` set; events
+     * without one are left alone. Then the row is repaired from the rewritten log, so the row
+     * and its history agree. All in one transaction: an erased form the schema rejects is
+     * `BAD_DEFINITION` and nothing changes; a history replay cannot rebuild (a legacy row that
+     * was never adopted) is `NO_HISTORY` and nothing changes. Projections are not rerun, and no
+     * job is queued: the app owns its read models. Running it twice is safe.
+     */
+    forget<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(db: DbHandle, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>): Promise<ForgetResult<Tbl>>;
+    /**
+     * Delete receipts recorded before `before`. Receipts hold inputs and results, which may
+     * carry personal data; `forget` does not touch them, so an app that keys personal flows
+     * prunes on a schedule. Returns how many were deleted.
+     */
+    pruneReceipts(db: DbHandle, opts: {
+        readonly before: Date;
+    }): Promise<number>;
+    /** Lock the row, replay, save the result. Writes no event, runs no projection, creates no job. */
+    repair<K extends string, Tbl extends EntityTable, E extends AnyEventDef, Key extends string>(db: DbHandle, entity: EntityDef<K, Tbl, E, z.output<Meta>, Key>, id: EntityId<Tbl, Key>): Promise<Row<Tbl> | null>;
+    /**
+     * The async lane of projections: one batch per async projection. Each batch locks the
+     * projection's cursor, scans the next `batchSize` events in commit order, applies the
+     * matching ones on that transaction, and moves the cursor to the last event scanned.
+     * The worker calls it after every drain; call it yourself in tests or one-off scripts.
+     * A projection whose batch throws is skipped this pass and tried again next pass.
+     */
+    catchUp(db: RootDb & TransactionSource<Tx>, opts?: {
+        readonly batchSize?: number;
+    }): Promise<{
+        readonly scanned: number;
+    }>;
+    /**
+     * Rewind an async projection to the start. `clear` runs on the same transaction, after the
+     * cursor is locked and before it is rewound, so the read model is emptied and refilled with
+     * no batch landing in between. To rebuild without downtime, deploy the projection under a
+     * new name into a new table instead, wait for `cursors` to show lag 0, then switch reads.
+     */
+    reset(db: RootDb & TransactionSource<Tx>, projection: Projection<z.output<Meta>, Tx>, clear?: (tx: Tx) => Promise<void>): Promise<void>;
+    /** Per async projection: its cursor and how far behind the newest event it is, in seqs. */
+    cursors(db: DbHandle): Promise<readonly {
+        readonly name: string;
+        readonly seq: number;
+        readonly lag: number;
+    }[]>;
+    /** Walk the log after sequence number `afterSeq` and call one inline projection's handlers, a batch per transaction. Async projections use `reset` and `catchUp`. */
+    rerun(db: TransactionSource<Tx>, projection: Projection<z.output<Meta>, Tx>, opts?: {
+        readonly afterSeq?: number;
+        readonly batchSize?: number;
+    }): Promise<{
+        readonly events: number;
+    }>;
+    /**
+     * Run up to `batchSize` due jobs. Returns how many jobs were claimed. Root database only.
+     * It must open the journal's transaction type: an effect runs commands on it.
+     * Each job is claimed right before it runs, so its lease (`leaseSeconds`, default 60)
+     * covers only its own work, and the lease is renewed every half lease while the effect
+     * runs. A lost lease aborts the effect's `ctx.signal`.
+     * Once `signal` is aborted no further job is claimed; the running one sees it as `ctx.signal`.
+     */
+    drain(db: AppDb & RootDb & TransactionSource<Tx>, opts?: {
+        readonly batchSize?: number;
+        readonly signal?: AbortSignal;
+        readonly leaseSeconds?: number;
+    }): Promise<number>;
+    /**
+     * A loop around `drain`. The same database as `drain`. `stop()` aborts the running
+     * effect's `ctx.signal`, claims nothing more, and resolves when that effect returns.
+     */
+    worker(db: AppDb & RootDb & TransactionSource<Tx>, opts?: {
+        readonly pollMs?: number;
+        readonly batchSize?: number;
+        readonly leaseSeconds?: number;
+        /**
+         * Hear the wake channel (`journal.wakeChannel`): a commit that recorded events wakes this
+         * worker at once, from any process, and the journal's taps fire here for those events.
+         * Required when the journal has taps, unless `taps: false` says this worker runs jobs only.
+         */
+        readonly listen?: WakeListener;
+        /** `false`: a jobs-only worker in a journal that has taps. Another process must listen. */
+        readonly taps?: boolean;
+    }): JournalWorker;
+    /**
+     * The Postgres channel every commit that recorded events notifies, with the seq range as
+     * JSON `{ "from": n, "to": m }`. `journal_wake`, or `<schema>_journal_wake` for tables in a
+     * schema. Payloads are small and bounded; a listener loads what it needs by seq.
+     */
+    readonly wakeChannel: string;
+    /**
+     * Wake every running worker this journal started in this process. Call it
+     * after committing a transaction of your own that ran commands. No worker: nothing happens.
+     */
+    wake(): void;
+    /**
+     * Pending jobs whose effect this journal does not have, counted per effect name.
+     * `drain` leaves them alone, because during a rolling deploy an older worker may
+     * still have that effect. After the deploy, a non-empty list means an effect was
+     * renamed or removed while it had jobs: bring it back under its old name until
+     * the count is zero, or delete those job rows on purpose.
+     */
+    strandedJobs(db: DbHandle): Promise<readonly StrandedJobs[]>;
+    /**
+     * List job rows. `pending` (the default) is everything not dead: due, delayed and leased
+     * alike. `dead` is what the worker gave up on. Oldest due first, `limit` 100.
+     */
+    jobs(db: DbHandle, opts?: {
+        readonly status?: 'pending' | 'dead' | 'all';
+        readonly effect?: string;
+        readonly limit?: number;
+    }): Promise<JournalTables['jobs']['$inferSelect'][]>;
+    /** A dead job back to pending: attempts and lease cleared, due now, workers woken. A job that is not dead throws. */
+    retry(db: DbHandle, jobId: string): Promise<void>;
+    /** Delete a dead job. A job that is not dead throws: deleting a live one would not stop its work. */
+    discard(db: DbHandle, jobId: string): Promise<void>;
+    /**
+     * The one way to extend a run from outside: a wrapper that receives the context and
+     * `next`. Command hooks run inside the transaction, around the handler; effect hooks run
+     * inside the lease, around the handler. Rules: call `next` exactly once, or throw before
+     * it to stop; a rejection of `next` is the hook's rejection too; the context is frozen
+     * and the result cannot be changed; hooks run in registration order, the first outermost.
+     * Register at boot: once the journal has run a command, a drain or a worker, `around`
+     * throws `BAD_DEFINITION`.
+     */
+    readonly hooks: {
+        readonly command: HookPoint<CommandHookContext<z.output<Meta>>>;
+        readonly effect: HookPoint<EffectHookContext<z.output<Meta>>>;
+    };
+    readonly catalog: {
+        /**
+         * Only the entities that a projection or an effect of this journal names. An
+         * entity that no handler names is not listed, even when the app writes to it.
+         */
+        readonly entities: readonly EntityInfo[];
+        readonly projections: readonly string[];
+        readonly effects: readonly string[];
+        readonly taps: readonly string[];
+    };
+};
+export type JournalDefinitions<Meta extends z.ZodObject, Tx extends TransactionSource<Tx> = DbHandle, AppDb extends RootDb = RootDb> = {
+    event<T extends string, S extends z.ZodType, const U extends readonly z.ZodType[] = readonly []>(type: T, schema: S, opts?: EventOptions<S, U>): EventDef<T, S>;
+    /** The key column is `id`. */
+    entity<K extends string, Tbl extends IdTable>(kind: K, table: Tbl): EntityBuilder<K, Tbl, never, z.output<Meta>, 'id'>;
+    /**
+     * The key column is the one `table` holds under the property name `options.key`:
+     * a non-null string column that is the primary key or unique.
+     */
+    entity<K extends string, Tbl extends EntityTable, Key extends KeyName<Tbl>>(kind: K, table: Tbl, options: {
+        readonly key: Key & SingleKey<Key>;
+    }): EntityBuilder<K, Tbl, never, z.output<Meta>, Key>;
+    /**
+     * A command: `input` is parsed before the handler runs; the handler's
+     * `write` and `run` are bound to one transaction and one parsed `meta`.
+     * Needs only `j`, entities and events, never the finished journal.
+     */
+    command<S extends z.ZodType, R>(name: string, input: S, handler: (input: z.output<S>, context: CommandContext<z.output<Meta>, Tx>) => R): Command<S, R, z.output<Meta>, Tx>;
+    /** `on` is `NoInfer` so `E` comes from `entity`; handlers are then contextually typed. */
+    projection<E extends AnyEntity<z.output<Meta>>>(name: string, entity: E | readonly E[], on: NoInfer<ProjectionHandlers<E, z.output<Meta>, Tx>>, opts?: ProjectionOptions): Projection<z.output<Meta>, Tx>;
+    effect<E extends AnyEntity<z.output<Meta>>>(name: string, entity: E | readonly E[], on: NoInfer<EffectHandlers<E, z.output<Meta>, AppDb, RootCommandRunner<Meta, Tx>>>): Effect<z.output<Meta>, AppDb, RootCommandRunner<Meta, Tx>>;
+    /**
+     * An effect that needs a service: `needs` is `{ mailer: need<Mailer>() }`, and each
+     * handler then gets `mailer` in its context, next to `jobId`, `signal`, `db` and `run`.
+     */
+    effect<E extends AnyEntity<z.output<Meta>>, N extends Needs>(name: string, entity: E | readonly E[], needs: N, on: NoInfer<EffectHandlers<E, z.output<Meta>, AppDb, RootCommandRunner<Meta, Tx>, N>>): Effect<z.output<Meta>, AppDb, RootCommandRunner<Meta, Tx>, N>;
+    /**
+     * Build the runtime journal from the tables and the handlers. `services` holds one
+     * value for every need of every listed effect, by name. A need without a value throws here.
+     * `const`: the list is read as a tuple, so an effect with needs keeps them next to one without.
+     */
+    /** A tap: in-process, after commit, lossy. See `Tap`. Same shapes as `effect`. */
+    tap<E extends AnyEntity<z.output<Meta>>>(name: string, entity: E | readonly E[], on: NoInfer<TapHandlers<E, z.output<Meta>, AppDb>>): Tap<z.output<Meta>, AppDb>;
+    tap<E extends AnyEntity<z.output<Meta>>, N extends Needs>(name: string, entity: E | readonly E[], needs: N, on: NoInfer<TapHandlers<E, z.output<Meta>, AppDb, N>>): Tap<z.output<Meta>, AppDb, N>;
+    compose<const E extends readonly Effect<z.output<Meta>, AppDb, RootCommandRunner<Meta, Tx>, Needs>[] = readonly [], const T extends readonly Tap<z.output<Meta>, AppDb, Needs>[] = readonly []>(config: {
+        readonly tables: JournalTables;
+        readonly projections?: readonly Projection<z.output<Meta>, Tx>[];
+        readonly effects?: E;
+        readonly taps?: T;
+    } & ServicesOption<ServicesFor<E> & ServicesFor<T>>): Journal<Meta, Tx, AppDb>;
+};
+/** `services` is required as soon as one listed effect has a need. */
+type ServicesOption<S> = unknown extends S ? {
+    readonly services?: Services;
+} : {
+    readonly services: S & Services;
+};
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

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

package/dist/api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":""}

package/dist/command.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Command execution: parse the input, open the transaction, give the handler a
+ * context bound to it, and refuse to close while an operation is still running.
+ * May import `api`, `write` (types), `storage`, `transaction-guard` and leaf files.
+ * Must not import `journal`, `history` or `worker`.
+ */
+import type { z } from 'zod';
+import type { Command, RunOptions } from './api.js';
+import type { HookPointInternal } from './hooks.js';
+import type { JournalTables } from './pg.js';
+import type { CommandHookContext, TransactionSource } from './types.js';
+import type { Writer } from './write.js';
+/** What command execution needs from the journal. */
+export type CommandDeps<Meta extends z.ZodObject, Tx extends TransactionSource<Tx>> = {
+    readonly metaSchema: Meta;
+    readonly writeWithValidatedMeta: Writer<Meta, Tx>['writeWithValidatedMeta'];
+    /** Wakes this journal's workers. Called after a root-database run that queued a job. */
+    readonly wake: () => void;
+    /** The command hooks. Frozen by the first run. */
+    readonly hooks: HookPointInternal<CommandHookContext<z.output<Meta>>>;
+    readonly tables: Pick<JournalTables, 'receipts'>;
+};
+export declare function createCommandRunner<Meta extends z.ZodObject, Tx extends TransactionSource<Tx>>(deps: CommandDeps<Meta, Tx>): <S extends z.ZodType, R>(source: TransactionSource<Tx>, command: Command<S, R, z.output<Meta>, Tx>, input: NoInfer<z.input<S>>, meta: z.input<Meta>, opts?: RunOptions, cause?: {
+    readonly seq: number;
+    readonly correlationId: string | null;
+}) => Promise<Awaited<R>>;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B,OAAO,KAAK,EAAE,OAAO,EAAkB,UAAU,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAmB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAYzC,qDAAqD;AACrD,MAAM,MAAM,WAAW,CAAC,IAAI,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,SAAS,iBAAiB,CAAC,EAAE,CAAC,IAAI;IACpF,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,CAAC;IAC5E,wFAAwF;IACxF,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;CAClD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,SAAS,iBAAiB,CAAC,EAAE,CAAC,EAC5F,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAuKd,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,UACzB,iBAAiB,CAAC,EAAE,CAAC,WACpB,OAAO,CAAC,CAAC,EAAE,CAAC,kBAAW,EAAE,CAAC,SAC5B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QACpB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SACZ,UAAU,UACT;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KACtE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CA6BvB"}

package/dist/command.js

@@ -0,0 +1,157 @@
+import { eq, is } from 'drizzle-orm';
+import { PgAsyncTransaction } from 'drizzle-orm/pg-core';
+import { debugCommand } from './debug.js';
+import { JournalError } from './errors.js';
+import { commandId, correlationId } from './id.js';
+import { assertRoundTrips, sameValue } from './storage.js';
+import { oneAtATime } from './transaction-guard.js';
+/** What JSON storage keeps of `value`. `undefined` has no JSON form, so it comes back as `undefined` here too. */
+const throughJson = (value) => 
+// eslint-disable-next-line unicorn/prefer-structured-clone -- JSON semantics on purpose: this is what the column stores
+value === undefined ? undefined : JSON.parse(JSON.stringify(value));
+export function createCommandRunner(deps) {
+    const { metaSchema, writeWithValidatedMeta, hooks } = deps;
+    const receipts = deps.tables.receipts;
+    /**
+     * Take the key for this run, or find the run that holds it. Returns `{ replay }` with the
+     * stored result when a finished run holds the key with the same command and input. The
+     * insert waits on an uncommitted holder, so a concurrent repeat sees its outcome.
+     */
+    const claimReceipt = async (tx, key, name, input, own) => {
+        const inserted = await tx
+            .insert(receipts)
+            .values({ key, command: name, input: throughJson(input) ?? null, commandId: own })
+            .onConflictDoNothing()
+            .returning({ key: receipts.key });
+        if (inserted.length > 0)
+            return undefined;
+        const [held] = await tx.select().from(receipts).where(eq(receipts.key, key));
+        if (held === undefined)
+            throw new Error(`journal: idempotency key ${JSON.stringify(key)} vanished while it was being claimed`);
+        // Only a run inside this transaction can see an unfinished receipt: a concurrent one waited on the insert.
+        if (held.result === null)
+            throw new Error(`journal: idempotency key ${JSON.stringify(key)} is held by a run of "${held.command}" that has not finished; a key cannot be reused inside its own transaction`);
+        if (held.command !== name)
+            throw new JournalError('CONFLICT', 'receipt', key, `the idempotency key is held by command "${held.command}", not "${name}"`);
+        if (!sameValue(held.input, throughJson(input) ?? null))
+            throw new JournalError('CONFLICT', 'receipt', key, `the idempotency key was used by command "${name}" with a different input`);
+        return { replay: 'value' in held.result ? held.result.value : undefined };
+    };
+    /** Store the result under the key. It must survive JSON, because the replay returns the stored form. */
+    const storeReceipt = async (tx, key, name, value) => {
+        const stored = throughJson(value);
+        if (!sameValue(stored, value))
+            throw new JournalError('UNSTABLE_SCHEMA', 'command', name, `the result of command "${name}" does not survive JSON storage; a command run with an idempotency key must return plain data, because a repeat returns the stored result`);
+        await tx
+            .update(receipts)
+            .set({ result: stored === undefined ? {} : { value: stored } })
+            .where(eq(receipts.key, key));
+    };
+    /**
+     * `journal.run` and `context.run` share this. `getValidatedMeta` gives the parsed meta:
+     * the root call parses it, a child inherits it. It runs inside the one-at-a-time
+     * guard, so a bad meta on a busy transaction waits like any other rejection.
+     * `onJobs` hears how many jobs each write queued, in this command and its children.
+     * `parent` is the trace this run continues: the chain's correlation id and cause are
+     * inherited, the command id is this run's own.
+     */
+    const runCommand = (source, command, input, getValidatedMeta, onJobs, parent, key) => oneAtATime(source, `command "${command.name}"`, async () => {
+        hooks.freeze();
+        const meta = await getValidatedMeta();
+        const parsed = await command.input.parseAsync(input);
+        const own = commandId();
+        const trace = { ...parent, commandId: own };
+        debugCommand.debug('{commandName}: input ok ({own}, {correlationId})', {
+            commandName: command.name,
+            own,
+            correlationId: trace.correlationId,
+        });
+        return source.transaction(async (tx) => {
+            // Every operation the handler starts through this context. The transaction
+            // must not close while one is still running: its work would land outside.
+            const started = [];
+            let unfinished = 0;
+            const track = (operation) => {
+                started.push(operation);
+                unfinished += 1;
+                const done = () => {
+                    unfinished -= 1;
+                };
+                void operation.then(done, done);
+                return operation;
+            };
+            const context = {
+                tx,
+                meta,
+                commandId: own,
+                correlationId: trace.correlationId,
+                write: (entity, id, events, opts) => track(writeWithValidatedMeta(tx, entity, id, () => meta, events, trace, onJobs, opts)),
+                run: (child, childInput, childOpts) => track(runCommand(tx, child, childInput, () => Promise.resolve(meta), onJobs, trace, childOpts?.idempotencyKey)),
+            };
+            let result;
+            try {
+                // Inside the transaction: a hook that throws rolls the command back cleanly.
+                result = await hooks.run({
+                    name: command.name,
+                    input: parsed,
+                    meta,
+                    commandId: own,
+                    correlationId: trace.correlationId,
+                    idempotencyKey: key ?? null,
+                }, async () => {
+                    if (key === undefined)
+                        return await command.handler(parsed, context);
+                    const held = await claimReceipt(tx, key, command.name, parsed, own);
+                    if (held !== undefined) {
+                        debugCommand.debug('{commandName}: replayed from receipt {key}', { commandName: command.name, key });
+                        // The receipt holds what this same command returned earlier, in the JSON form
+                        // `storeReceipt` checked against the live value. This is the one cast in the library.
+                        return held.replay;
+                    }
+                    const value = await command.handler(parsed, context);
+                    await storeReceipt(tx, key, command.name, value);
+                    return value;
+                });
+            }
+            catch (error) {
+                // The handler's own error is the one to report; the rollback undoes the rest.
+                await Promise.allSettled(started);
+                throw error;
+            }
+            if (unfinished > 0) {
+                const count = unfinished;
+                await Promise.allSettled(started);
+                throw new Error(`journal: command "${command.name}" returned with ${count} journal operation${count === 1 ? '' : 's'} still running; await every write and run before the handler returns`);
+            }
+            debugCommand.debug('{commandName}: done', { commandName: command.name });
+            return result;
+        });
+    });
+    /**
+     * `journal.run`: parses `meta` once for the whole command. `cause` is set only by an
+     * effect's `ctx.run`: the event the job was for. Its correlation id carries over unless
+     * `opts.correlationId` says otherwise; with neither, the run starts a new chain.
+     */
+    const run = (source, command, input, meta, opts, cause) => {
+        let queued = 0;
+        return runCommand(source, command, input, async () => {
+            const parsed = await metaSchema.parseAsync(meta);
+            // No entity yet: the error names the command instead.
+            assertRoundTrips(metaSchema, parsed, 'command', command.name, 'meta');
+            return parsed;
+        }, count => {
+            queued += count;
+        }, {
+            causeSeq: cause?.seq ?? null,
+            correlationId: opts?.correlationId ?? cause?.correlationId ?? correlationId(),
+        }, opts?.idempotencyKey).then(result => {
+            // The root database has committed by now. Inside a caller's transaction
+            // only the caller knows when the commit happens, so the caller wakes.
+            if (queued > 0 && !is(source, PgAsyncTransaction))
+                deps.wake();
+            return result;
+        });
+    };
+    return run;
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

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

package/dist/debug.d.ts

@@ -0,0 +1,7 @@
+/** Enable with `DEBUG=arki:journal:*`. */
+export declare const debugWrite: import("@arki/log").Logger;
+export declare const debugCommand: import("@arki/log").Logger;
+export declare const debugReplay: import("@arki/log").Logger;
+export declare const debugDrain: import("@arki/log").Logger;
+export declare const debugWorker: import("@arki/log").Logger;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,eAAO,MAAM,UAAU,4BAAkC,CAAC;AAC1D,eAAO,MAAM,YAAY,4BAAoC,CAAC;AAC9D,eAAO,MAAM,WAAW,4BAAmC,CAAC;AAC5D,eAAO,MAAM,UAAU,4BAAkC,CAAC;AAC1D,eAAO,MAAM,WAAW,4BAAmC,CAAC"}

package/dist/debug.js

@@ -0,0 +1,8 @@
+import { getLogger } from '@arki/log';
+/** Enable with `DEBUG=arki:journal:*`. */
+export const debugWrite = getLogger('arki:journal:write');
+export const debugCommand = getLogger('arki:journal:command');
+export const debugReplay = getLogger('arki:journal:replay');
+export const debugDrain = getLogger('arki:journal:drain');
+export const debugWorker = getLogger('arki:journal:worker');
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC"}