@photon-grove/evt 0.0.0 → 0.1.1

package/dist/codec.d.ts

@@ -0,0 +1,56 @@
+import { type JsonValue } from './json.js';
+/** Encodes values of `T` to stored bytes and decodes them back. */
+export interface Codec<T> {
+    encode(value: T): Uint8Array;
+    decode(bytes: Uint8Array): T;
+}
+/**
+ * The part of a [Standard Schema](https://standardschema.dev) validator evt calls, so Zod,
+ * Valibot, ArkType and the rest work without evt depending on any of them.
+ */
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => StandardResult<Output> | Promise<StandardResult<Output>>;
+        readonly types?: {
+            readonly input: Input;
+            readonly output: Output;
+        } | undefined;
+    };
+}
+/** A Standard Schema validation result: the value, or the issues that refused it. */
+export type StandardResult<Output> = {
+    readonly value: Output;
+    readonly issues?: undefined;
+} | {
+    readonly issues: readonly {
+        readonly message: string;
+    }[];
+};
+/** Options for {@link json}. */
+export interface JsonOptions<T> {
+    /** Validates each value before it's encoded and after it's decoded, synchronously. */
+    schema?: StandardSchemaV1<unknown, T> | undefined;
+}
+/**
+ * A JSON codec written with evt's encoder (the one Go's `encoding/json` output is reproduced
+ * with). Plain objects encode in property order.
+ *
+ * Decoding gives plain objects, arrays and numbers, so `T` must be plain JSON: a `Map`, a `bigint`
+ * or a `Date` doesn't decode back to itself. A domain that must match a Go or Rust one byte for
+ * byte, with a map whose keys are written sorted, needs a codec of its own that decodes the map as
+ * a `Map`. An integer past `Number.MAX_SAFE_INTEGER` is refused rather than rounded.
+ *
+ * Encoding refuses a value decoding would refuse, and with a `schema`, each value is validated
+ * before it's encoded and after it's decoded, so an event or a snapshot that couldn't be read back
+ * fails its commit instead of every later load. The schema must not transform values: the value
+ * is encoded as given.
+ */
+export declare function json<T>(options?: JsonOptions<T>): Codec<T>;
+/**
+ * A JSON value as plain JavaScript: objects as plain objects, numbers as `number`. An integer past
+ * the safe range is refused, because `number` would round it.
+ */
+export declare function plainJson(value: JsonValue): unknown;
+//# sourceMappingURL=codec.d.ts.map

package/dist/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../src/codec.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,SAAS,EAA2B,MAAM,WAAW,CAAA;AAG9E,mEAAmE;AACnE,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,UAAU,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,KAAK;IAC/D,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;QACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;QAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE;YAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;SAAC,GAAG,SAAS,CAAA;KAC9E,CAAA;CACF;AAED,qFAAqF;AACrF,MAAM,MAAM,cAAc,CAAC,MAAM,IAC7B;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAC,GACrD;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAC,EAAE,CAAA;CAAC,CAAA;AAE5D,gCAAgC;AAChC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,sFAAsF;IACtF,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,SAAS,CAAA;CAClD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,OAAO,GAAE,WAAW,CAAC,CAAC,CAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAoB9D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAgCnD"}

package/dist/codec.js

@@ -0,0 +1,90 @@
+// Payload codecs: how an application turns event data and aggregate state into stored bytes and
+// back. evt stores the bytes verbatim, so a codec owns their format.
+import { EvtError, messageOf } from './errors.js';
+import { JsonNumber, parseJson, stringifyJson } from './json.js';
+import { utf8Decode, utf8Encode } from './utf8.js';
+/**
+ * A JSON codec written with evt's encoder (the one Go's `encoding/json` output is reproduced
+ * with). Plain objects encode in property order.
+ *
+ * Decoding gives plain objects, arrays and numbers, so `T` must be plain JSON: a `Map`, a `bigint`
+ * or a `Date` doesn't decode back to itself. A domain that must match a Go or Rust one byte for
+ * byte, with a map whose keys are written sorted, needs a codec of its own that decodes the map as
+ * a `Map`. An integer past `Number.MAX_SAFE_INTEGER` is refused rather than rounded.
+ *
+ * Encoding refuses a value decoding would refuse, and with a `schema`, each value is validated
+ * before it's encoded and after it's decoded, so an event or a snapshot that couldn't be read back
+ * fails its commit instead of every later load. The schema must not transform values: the value
+ * is encoded as given.
+ */
+export function json(options = {}) {
+    const schema = options.schema;
+    return {
+        encode(value) {
+            if (schema) {
+                validate(schema, value, 'invalidArgument');
+            }
+            const text = stringifyJson(value);
+            readable(text);
+            return utf8Encode(text);
+        },
+        decode(bytes) {
+            const value = plainJson(parseJson(utf8Decode(bytes, 'payload')));
+            return schema ? validate(schema, value, 'invalidRecord') : value;
+        },
+    };
+}
+/**
+ * A JSON value as plain JavaScript: objects as plain objects, numbers as `number`. An integer past
+ * the safe range is refused, because `number` would round it.
+ */
+export function plainJson(value) {
+    if (value instanceof JsonNumber) {
+        const number = Number(value.text);
+        if (value.isInteger && !Number.isSafeInteger(number)) {
+            throw new EvtError('invalidRecord', `the integer ${value.text} is past the integers a number holds; decode it with a codec ` +
+                'of its own');
+        }
+        return number;
+    }
+    if (Array.isArray(value)) {
+        return value.map(plainJson);
+    }
+    if (value instanceof Map) {
+        const object = {};
+        for (const [key, entry] of value) {
+            // defineProperty, so a "__proto__" key is a plain property and never a prototype.
+            Object.defineProperty(object, key, {
+                value: plainJson(entry),
+                enumerable: true,
+                writable: true,
+                configurable: true,
+            });
+        }
+        return object;
+    }
+    return value;
+}
+// Refuses JSON that decode would refuse, such as an integer past the safe range, so the value
+// fails its commit instead of every later load.
+function readable(text) {
+    try {
+        plainJson(parseJson(text));
+    }
+    catch (error) {
+        throw new EvtError('invalidArgument', messageOf(error), { cause: error });
+    }
+}
+function validate(schema, value, code) {
+    const result = schema['~standard'].validate(value);
+    if ('then' in result && typeof result.then === 'function') {
+        throw new EvtError('invalidArgument', 'a codec schema must validate synchronously');
+    }
+    const settled = result;
+    if (settled.issues) {
+        const issues = settled.issues.map((issue) => issue.message).join('; ');
+        throw new EvtError(code, `the payload does not match its schema: ${issues}`);
+    }
+    return settled.value;
+}
+//# sourceMappingURL=codec.js.map

package/dist/codec.js.map

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

package/dist/commit-id.d.ts

@@ -0,0 +1,3 @@
+/** Makes a ULID-format commit ID generator that reads `clock` (Unix milliseconds). */
+export declare function commitIds(clock: () => number): () => string;
+//# sourceMappingURL=commit-id.d.ts.map

package/dist/commit-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-id.d.ts","sourceRoot":"","sources":["../src/commit-id.ts"],"names":[],"mappings":"AAQA,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,MAAM,GAAG,MAAM,MAAM,CAwB3D"}

package/dist/commit-id.js

@@ -0,0 +1,43 @@
+// Commit IDs for commits whose command carries none: ULID-format identifiers, 26 Crockford base32
+// characters for a 48-bit millisecond timestamp and 80 random bits. IDs one generator makes in one
+// millisecond increase, so they sort by creation time.
+const ALPHABET = '0123456789ABCDEFGHJKMNPQRSTVWXYZ';
+const ENTROPY_MAX = (1n << 80n) - 1n;
+const TIMESTAMP_MASK = (1n << 48n) - 1n;
+/** Makes a ULID-format commit ID generator that reads `clock` (Unix milliseconds). */
+export function commitIds(clock) {
+    let lastMs = -1n;
+    let entropy = 0n;
+    return () => {
+        // A clock that steps backwards keeps the last timestamp, so IDs never decrease.
+        let ms = BigInt(Math.max(0, Math.floor(clock()))) & TIMESTAMP_MASK;
+        if (ms < lastMs) {
+            ms = lastMs;
+        }
+        if (ms === lastMs && entropy < ENTROPY_MAX) {
+            entropy++;
+        }
+        else {
+            // A new millisecond, or 2^80 IDs in this one.
+            if (ms === lastMs) {
+                ms = (ms + 1n) & TIMESTAMP_MASK;
+            }
+            lastMs = ms;
+            entropy = randomEntropy();
+        }
+        return encode((ms << 80n) | entropy);
+    };
+}
+function randomEntropy() {
+    const bytes = crypto.getRandomValues(new Uint8Array(10));
+    return bytes.reduce((value, byte) => (value << 8n) | BigInt(byte), 0n);
+}
+function encode(value) {
+    let text = '';
+    for (let i = 0; i < 26; i++) {
+        text = ALPHABET[Number(value & 31n)] + text;
+        value >>= 5n;
+    }
+    return text;
+}
+//# sourceMappingURL=commit-id.js.map

package/dist/commit-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-id.js","sourceRoot":"","sources":["../src/commit-id.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,mGAAmG;AACnG,uDAAuD;AAEvD,MAAM,QAAQ,GAAG,kCAAkC,CAAA;AACnD,MAAM,WAAW,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAA;AACpC,MAAM,cAAc,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,CAAA;AAEvC,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC3C,IAAI,MAAM,GAAG,CAAC,EAAE,CAAA;IAChB,IAAI,OAAO,GAAG,EAAE,CAAA;IAEhB,OAAO,GAAG,EAAE;QACV,gFAAgF;QAChF,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,cAAc,CAAA;QAClE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAChB,EAAE,GAAG,MAAM,CAAA;QACb,CAAC;QAED,IAAI,EAAE,KAAK,MAAM,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC3C,OAAO,EAAE,CAAA;QACX,CAAC;aAAM,CAAC;YACN,8CAA8C;YAC9C,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;gBAClB,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,cAAc,CAAA;YACjC,CAAC;YACD,MAAM,GAAG,EAAE,CAAA;YACX,OAAO,GAAG,aAAa,EAAE,CAAA;QAC3B,CAAC;QAED,OAAO,MAAM,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,CAAA;IACtC,CAAC,CAAA;AACH,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAA;IAExD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;AACxE,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,IAAI,IAAI,GAAG,EAAE,CAAA;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAE,GAAG,IAAI,CAAA;QAC5C,KAAK,KAAK,EAAE,CAAA;IACd,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/dynamodb/client.d.ts

@@ -0,0 +1,83 @@
+import type { Item } from './item.js';
+/** The options the repository passes with every call. */
+export interface RequestOptions {
+    abortSignal?: AbortSignal;
+}
+/** One action of a `TransactWriteItems` call. */
+export interface TransactItem {
+    ConditionCheck?: ConditionCheckAction;
+    Put?: PutAction;
+    Update?: UpdateAction;
+    Delete?: DeleteAction;
+}
+/** The expression parts an action or a query may carry. */
+export interface Expressions {
+    ConditionExpression?: string;
+    ExpressionAttributeNames?: Record<string, string>;
+    ExpressionAttributeValues?: Item;
+}
+export interface ConditionCheckAction extends Expressions {
+    TableName: string;
+    Key: Item;
+    ConditionExpression: string;
+}
+export interface PutAction extends Expressions {
+    TableName: string;
+    Item: Item;
+}
+export interface UpdateAction extends Expressions {
+    TableName: string;
+    Key: Item;
+    UpdateExpression: string;
+}
+export interface DeleteAction extends Expressions {
+    TableName: string;
+    Key: Item;
+}
+export interface GetItemInput {
+    TableName: string;
+    Key: Item;
+    ConsistentRead?: boolean;
+    ProjectionExpression?: string;
+    ExpressionAttributeNames?: Record<string, string>;
+}
+export interface PutItemInput extends Expressions {
+    TableName: string;
+    Item: Item;
+}
+export interface QueryInput {
+    TableName: string;
+    KeyConditionExpression: string;
+    ExpressionAttributeNames?: Record<string, string>;
+    ExpressionAttributeValues: Item;
+    ConsistentRead?: boolean;
+    ProjectionExpression?: string;
+    ScanIndexForward?: boolean;
+    Limit?: number;
+    ExclusiveStartKey?: Item;
+}
+export interface ScanInput {
+    TableName: string;
+    ConsistentRead?: boolean;
+    ProjectionExpression?: string;
+    Limit?: number;
+    ExclusiveStartKey?: Item;
+}
+/** A page of a query or a scan. Items come back as the SDK decodes them. */
+export interface Page {
+    Items?: Record<string, unknown>[] | undefined;
+    LastEvaluatedKey?: Record<string, unknown> | undefined;
+}
+/** The calls {@link DynamoRepository} makes: the SDK's `DynamoDB` client has them all. */
+export interface DynamoClient {
+    getItem(input: GetItemInput, options?: RequestOptions): Promise<{
+        Item?: Record<string, unknown> | undefined;
+    }>;
+    putItem(input: PutItemInput, options?: RequestOptions): Promise<unknown>;
+    query(input: QueryInput, options?: RequestOptions): Promise<Page>;
+    scan(input: ScanInput, options?: RequestOptions): Promise<Page>;
+    transactWriteItems(input: {
+        TransactItems: TransactItem[];
+    }, options?: RequestOptions): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/dynamodb/client.d.ts.map

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

package/dist/dynamodb/client.js

@@ -0,0 +1,6 @@
+// The DynamoDB calls the repository makes, as a structural interface. The AWS SDK's aggregated
+// `DynamoDB` client (`@aws-sdk/client-dynamodb`) satisfies it, so this package imports nothing
+// from the SDK. Requests and responses use the low-level `AttributeValue` maps, never the document
+// client's marshalling, because the storage format pins every attribute's type.
+export {};
+//# sourceMappingURL=client.js.map

package/dist/dynamodb/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/dynamodb/client.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,mGAAmG;AACnG,gFAAgF"}

package/dist/dynamodb/head.d.ts

@@ -0,0 +1,34 @@
+/** The update expression of a head update on a stream without retention. */
+export declare const HEAD_UPDATE = "SET head = :last";
+/** The update expression of a head update on a stream with retention, which raises `ttl` too. */
+export declare const HEAD_UPDATE_RETAINED = "SET head = :last, #ttl = :t";
+/** The condition of the head update of a stream the commit creates (first sequence 1). */
+export declare const HEAD_CREATE_CONDITION = "attribute_not_exists(head)";
+/** The condition of the head update of an append: the head is the sequence before the first. */
+export declare const HEAD_APPEND_CONDITION = "head = :prev";
+/** {@link HEAD_APPEND_CONDITION} with retention: `ttl` is raised, never lowered. */
+export declare const HEAD_APPEND_RETAINED_CONDITION = "head = :prev AND (attribute_not_exists(#ttl) OR #ttl <= :t)";
+/** An `Update` or `ConditionCheck` on a stream's head item. */
+export interface HeadAction {
+    entityId: string;
+    /** The update expression, or null for a `ConditionCheck`. */
+    updateExpression: string | null;
+    conditionExpression: string;
+    /** `ExpressionAttributeNames`: placeholder and attribute name. */
+    names: [string, string][];
+    /** `ExpressionAttributeValues`: placeholder and number. */
+    values: [string, bigint][];
+}
+/**
+ * The head update of a stream whose commit writes events `first` to `last`. A first sequence of 1
+ * creates the head. `ttl` is the `:t` of the never-lower rule, given only for a stream with
+ * retention.
+ */
+export declare function headUpdate(entityId: string, first: bigint, last: bigint, ttl?: number): HeadAction;
+/**
+ * An action's size in the commit budget, by the rule for any update, delete or condition check:
+ * its key attributes plus its expression strings, name placeholders (the placeholder and the
+ * name), and attribute values (the placeholder and the number's text).
+ */
+export declare function headActionSize(action: HeadAction): number;
+//# sourceMappingURL=head.d.ts.map

package/dist/dynamodb/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/dynamodb/head.ts"],"names":[],"mappings":"AAQA,4EAA4E;AAC5E,eAAO,MAAM,WAAW,qBAAqB,CAAA;AAE7C,iGAAiG;AACjG,eAAO,MAAM,oBAAoB,gCAAgC,CAAA;AAEjE,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,+BAA+B,CAAA;AAEjE,gGAAgG;AAChG,eAAO,MAAM,qBAAqB,iBAAiB,CAAA;AAEnD,oFAAoF;AACpF,eAAO,MAAM,8BAA8B,gEACoB,CAAA;AAE/D,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,6DAA6D;IAC7D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,kEAAkE;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IACzB,2DAA2D;IAC3D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,UAAU,CA0BZ;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAazD"}

package/dist/dynamodb/head.js

@@ -0,0 +1,62 @@
+// The DynamoDB actions on a stream's head item (ADR 0007), independent of any SDK: the one source
+// of the head's expression strings, which the writer builds its actions from and the commit
+// budget sizes. The fence and snapshot-guard forms join them with the DynamoDB backend.
+import { safeIntegerArgument } from '../fields.js';
+import { utf8Length } from '../utf8.js';
+import { HEAD_SORT_KEY, itemSize } from './item.js';
+/** The update expression of a head update on a stream without retention. */
+export const HEAD_UPDATE = 'SET head = :last';
+/** The update expression of a head update on a stream with retention, which raises `ttl` too. */
+export const HEAD_UPDATE_RETAINED = 'SET head = :last, #ttl = :t';
+/** The condition of the head update of a stream the commit creates (first sequence 1). */
+export const HEAD_CREATE_CONDITION = 'attribute_not_exists(head)';
+/** The condition of the head update of an append: the head is the sequence before the first. */
+export const HEAD_APPEND_CONDITION = 'head = :prev';
+/** {@link HEAD_APPEND_CONDITION} with retention: `ttl` is raised, never lowered. */
+export const HEAD_APPEND_RETAINED_CONDITION = 'head = :prev AND (attribute_not_exists(#ttl) OR #ttl <= :t)';
+/**
+ * The head update of a stream whose commit writes events `first` to `last`. A first sequence of 1
+ * creates the head. `ttl` is the `:t` of the never-lower rule, given only for a stream with
+ * retention.
+ */
+export function headUpdate(entityId, first, last, ttl) {
+    const create = first <= 1n;
+    const values = [[':last', last]];
+    const names = [];
+    if (!create) {
+        values.push([':prev', first - 1n]);
+    }
+    if (ttl !== undefined) {
+        names.push(['#ttl', 'ttl']);
+        values.push([':t', BigInt(safeIntegerArgument(ttl, 'ttl'))]);
+    }
+    let conditionExpression = HEAD_CREATE_CONDITION;
+    if (!create) {
+        conditionExpression =
+            ttl === undefined ? HEAD_APPEND_CONDITION : HEAD_APPEND_RETAINED_CONDITION;
+    }
+    return {
+        entityId,
+        updateExpression: ttl === undefined ? HEAD_UPDATE : HEAD_UPDATE_RETAINED,
+        conditionExpression,
+        names,
+        values,
+    };
+}
+/**
+ * An action's size in the commit budget, by the rule for any update, delete or condition check:
+ * its key attributes plus its expression strings, name placeholders (the placeholder and the
+ * name), and attribute values (the placeholder and the number's text).
+ */
+export function headActionSize(action) {
+    const key = itemSize({ pk: { S: action.entityId }, sk: { N: HEAD_SORT_KEY.toString() } });
+    let size = key + utf8Length(action.updateExpression ?? '') + utf8Length(action.conditionExpression);
+    for (const [placeholder, name] of action.names) {
+        size += utf8Length(placeholder) + utf8Length(name);
+    }
+    for (const [placeholder, number] of action.values) {
+        size += utf8Length(placeholder) + number.toString().length;
+    }
+    return size;
+}
+//# sourceMappingURL=head.js.map

package/dist/dynamodb/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/dynamodb/head.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,4FAA4F;AAC5F,wFAAwF;AAExF,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAA;AAChD,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AACrC,OAAO,EAAC,aAAa,EAAE,QAAQ,EAAC,MAAM,WAAW,CAAA;AAEjD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAA;AAE7C,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG,6BAA6B,CAAA;AAEjE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,4BAA4B,CAAA;AAEjE,gGAAgG;AAChG,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAEnD,oFAAoF;AACpF,MAAM,CAAC,MAAM,8BAA8B,GACzC,6DAA6D,CAAA;AAc/D;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,KAAa,EACb,IAAY,EACZ,GAAY;IAEZ,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,CAAA;IAC1B,MAAM,MAAM,GAAuB,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IACpD,MAAM,KAAK,GAAuB,EAAE,CAAA;IAEpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;QAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,mBAAmB,GAAG,qBAAqB,CAAA;IAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,mBAAmB;YACjB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,8BAA8B,CAAA;IAC9E,CAAC;IAED,OAAO;QACL,QAAQ;QACR,gBAAgB,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB;QACxE,mBAAmB;QACnB,KAAK;QACL,MAAM;KACP,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAC,EAAE,EAAE,EAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,EAAC,EAAE,EAAE,EAAE,EAAC,CAAC,EAAE,aAAa,CAAC,QAAQ,EAAE,EAAC,EAAC,CAAC,CAAA;IACnF,IAAI,IAAI,GACN,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAA;IAE1F,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/C,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClD,IAAI,IAAI,UAAU,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAA;IAC5D,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/dynamodb/index.d.ts

@@ -0,0 +1,6 @@
+export { type AttributeValue, type Item, DEFAULT_VIEW_SORT_KEY, HEAD_SORT_KEY, SNAPSHOT_SORT_KEY, eventFromItem, eventItem, expiry, headFromItem, headItem, isSnapshotItem, itemSize, snapshotFromItem, snapshotItem, sortKey, ttlFromItem, viewItem, } from './item.js';
+export { type ConditionCheckAction, type DeleteAction, type DynamoClient, type Expressions, type GetItemInput, type Page, type PutAction, type PutItemInput, type QueryInput, type RequestOptions, type ScanInput, type TransactItem, type UpdateAction, } from './client.js';
+export { FEATURES_PK, REBUILD_LOCK_PK, manifestFromItem, markerItem } from './marker.js';
+export { DynamoRepository, type DynamoRepositoryOptions } from './repository.js';
+export { type CommitTtl, type SnapshotTtl, commitTransaction, snapshotTransaction, } from './requests.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dynamodb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dynamodb/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,IAAI,EACT,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAC,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAC,MAAM,aAAa,CAAA;AACtF,OAAO,EAAC,gBAAgB,EAAE,KAAK,uBAAuB,EAAC,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,eAAe,CAAA"}

package/dist/dynamodb/index.js

@@ -0,0 +1,8 @@
+// @photon-grove/evt/dynamodb: the DynamoDB backend. It imports nothing from the AWS SDK: the
+// repository takes the SDK's `DynamoDB` client, or anything shaped like it, as a DynamoClient.
+export { DEFAULT_VIEW_SORT_KEY, HEAD_SORT_KEY, SNAPSHOT_SORT_KEY, eventFromItem, eventItem, expiry, headFromItem, headItem, isSnapshotItem, itemSize, snapshotFromItem, snapshotItem, sortKey, ttlFromItem, viewItem, } from './item.js';
+export {} from './client.js';
+export { FEATURES_PK, REBUILD_LOCK_PK, manifestFromItem, markerItem } from './marker.js';
+export { DynamoRepository } from './repository.js';
+export { commitTransaction, snapshotTransaction, } from './requests.js';
+//# sourceMappingURL=index.js.map

package/dist/dynamodb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dynamodb/index.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,+FAA+F;AAE/F,OAAO,EAGL,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,SAAS,EACT,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,WAAW,EACX,QAAQ,GACT,MAAM,WAAW,CAAA;AAClB,OAAO,EAcN,MAAM,aAAa,CAAA;AACpB,OAAO,EAAC,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAC,MAAM,aAAa,CAAA;AACtF,OAAO,EAAC,gBAAgB,EAA+B,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAGL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,eAAe,CAAA"}

package/dist/dynamodb/item.d.ts

@@ -0,0 +1,70 @@
+import { type SerializedEvent, type SerializedSnapshot } from '../event.js';
+/** A DynamoDB attribute value, shaped like the SDK's `AttributeValue`. */
+export type AttributeValue = {
+    S: string;
+} | {
+    N: string;
+} | {
+    B: Uint8Array;
+} | {
+    BOOL: boolean;
+} | {
+    NULL: boolean;
+} | {
+    M: Item;
+} | {
+    L: AttributeValue[];
+} | {
+    SS: string[];
+} | {
+    NS: string[];
+} | {
+    BS: Uint8Array[];
+};
+/** A DynamoDB item. */
+export type Item = Record<string, AttributeValue>;
+/** The sort key of a stream's inline snapshot. */
+export declare const SNAPSHOT_SORT_KEY = 0n;
+/** The sort key of a stream's head item. */
+export declare const HEAD_SORT_KEY = -1n;
+/** The sort key of a single-item view row. */
+export declare const DEFAULT_VIEW_SORT_KEY = "VIEW";
+/** Encodes an event as an event-log item. `ttl` (Unix seconds) is written only when positive. */
+export declare function eventItem(event: SerializedEvent, ttl?: number): Item;
+/** Encodes a stream's inline snapshot item. `ttl` is written only when positive. */
+export declare function snapshotItem(snapshot: SerializedSnapshot, ttl?: number): Item;
+/** Encodes a stream's head item. `ttl` is written only when positive. */
+export declare function headItem(entityId: string, head: bigint, ttl?: number): Item;
+/** Encodes a single-item view row: `pk = {entityType}#{entityId}`, `sk = "VIEW"`. */
+export declare function viewItem(entityType: string, entityId: string, payload: Uint8Array): Item;
+/**
+ * Decodes an event-log item. Missing attributes other than the key are empty, and `metadata` must
+ * be present and not blank. A JSON `null` metadata is the zero value, as in Go.
+ */
+export declare function eventFromItem(item: Item): SerializedEvent;
+/** Decodes a stream's inline snapshot item. */
+export declare function snapshotFromItem(item: Item): SerializedSnapshot;
+/** Decodes a head item into its head and its `ttl`, if it has one. */
+export declare function headFromItem(item: Item): {
+    head: bigint;
+    ttl: number | undefined;
+};
+/** An item's `ttl` in Unix seconds, or undefined when it has none. */
+export declare function ttlFromItem(item: Item): number | undefined;
+/** Whether an item is a stream's inline snapshot (`sk = 0`). */
+export declare function isSnapshotItem(item: Item): boolean;
+/** An item's numeric sort key, if it has one. */
+export declare function sortKey(item: Item): bigint | undefined;
+/**
+ * The `ttl` of an item written at `nowMs` (Unix milliseconds) under a retention of `retentionMs`:
+ * their sum in whole Unix seconds, rounded down after adding, as Go's `Time.Add(...).Unix()` is.
+ * Undefined, so no `ttl` is written, for a zero retention. A retention with a fraction of a
+ * millisecond is refused, because Go would count it.
+ */
+export declare function expiry(nowMs: number, retentionMs: number): number | undefined;
+/**
+ * The size DynamoDB counts for an item: each attribute's name plus its value, in UTF-8 bytes. The
+ * commit budget measures every action with it.
+ */
+export declare function itemSize(item: Item): number;
+//# sourceMappingURL=item.d.ts.map

package/dist/dynamodb/item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../src/dynamodb/item.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAC,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAU,MAAM,aAAa,CAAA;AAalF,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GACtB;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,GACX;IAAC,CAAC,EAAE,MAAM,CAAA;CAAC,GACX;IAAC,CAAC,EAAE,UAAU,CAAA;CAAC,GACf;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,GACf;IAAC,IAAI,EAAE,OAAO,CAAA;CAAC,GACf;IAAC,CAAC,EAAE,IAAI,CAAA;CAAC,GACT;IAAC,CAAC,EAAE,cAAc,EAAE,CAAA;CAAC,GACrB;IAAC,EAAE,EAAE,MAAM,EAAE,CAAA;CAAC,GACd;IAAC,EAAE,EAAE,MAAM,EAAE,CAAA;CAAC,GACd;IAAC,EAAE,EAAE,UAAU,EAAE,CAAA;CAAC,CAAA;AAEtB,uBAAuB;AACvB,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAEjD,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,KAAK,CAAA;AAEnC,4CAA4C;AAC5C,eAAO,MAAM,aAAa,MAAM,CAAA;AAEhC,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,SAAS,CAAA;AAE3C,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAapE;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAY7E;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ3E;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAQxF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,CA0BzD;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAQ/D;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAC,CAEhF;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAI1D;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAElD;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAOtD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa7E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO3C"}