@photon-grove/evt 0.0.0-stage → 0.1.0

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/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,2 @@
+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, viewItem, } from './item.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,QAAQ,GACT,MAAM,WAAW,CAAA"}

package/dist/dynamodb/index.js

@@ -0,0 +1,4 @@
+// @photon-grove/evt/dynamodb: the DynamoDB backend. So far it holds the item codec, which imports
+// nothing from the AWS SDK.
+export { DEFAULT_VIEW_SORT_KEY, HEAD_SORT_KEY, SNAPSHOT_SORT_KEY, eventFromItem, eventItem, expiry, headFromItem, headItem, isSnapshotItem, itemSize, snapshotFromItem, snapshotItem, sortKey, viewItem, } from './item.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,kGAAkG;AAClG,4BAA4B;AAE5B,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,QAAQ,GACT,MAAM,WAAW,CAAA"}

package/dist/dynamodb/item.d.ts

@@ -0,0 +1,68 @@
+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;
+};
+/** 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,CAOhF;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"}

package/dist/dynamodb/item.js

@@ -0,0 +1,263 @@
+// The DynamoDB item layout of the event log. It's pure: it shapes items the way the AWS SDK's
+// low-level client takes them, and imports nothing from the SDK.
+//
+// | Attribute    | Type | Event item     | Snapshot item (sk 0) | Head item (sk -1) |
+// | ------------ | ---- | -------------- | -------------------- | ----------------- |
+// | `pk`         | S    | entity ID      | entity ID            | entity ID         |
+// | `sk`         | N    | event sequence | `0`                  | `-1`              |
+// | `type`       | S    | event type     |                      |                   |
+// | `version`    | N    | event version  |                      |                   |
+// | `entityType` | S    | entity type    | entity type          |                   |
+// | `payload`    | S    | payload JSON   | state JSON           |                   |
+// | `metadata`   | S    | metadata JSON  |                      |                   |
+// | `seq`        | N    |                | snapshot sequence    |                   |
+// | `eventSeq`   | N    |                | last event folded in |                   |
+// | `head`       | N    |                |                      | highest sequence  |
+// | `ttl`        | N    | optional       | optional             | optional          |
+import { eventId } from '../event.js';
+import { EvtError } from '../errors.js';
+import { DOCUMENT, checkInt64, int64Argument, invalid, safeIntegerArgument, } from '../fields.js';
+import { parseJson } from '../json.js';
+import { encodeMetadata, metadataFromJson } from '../metadata.js';
+import { utf8Decode, utf8Encode, utf8Length } from '../utf8.js';
+/** The sort key of a stream's inline snapshot. */
+export const SNAPSHOT_SORT_KEY = 0n;
+/** The sort key of a stream's head item. */
+export const HEAD_SORT_KEY = -1n;
+/** The sort key of a single-item view row. */
+export const DEFAULT_VIEW_SORT_KEY = 'VIEW';
+/** Encodes an event as an event-log item. `ttl` (Unix seconds) is written only when positive. */
+export function eventItem(event, ttl) {
+    return withTtl({
+        pk: { S: event.entityId },
+        sk: { N: int64Argument(event.sequence, 'event.sequence').toString() },
+        type: { S: event.type },
+        version: { N: safeIntegerArgument(event.version, 'event.version').toString() },
+        entityType: { S: event.entityType },
+        payload: { S: payloadText(event.payload, 'event payload') },
+        metadata: { S: encodeMetadata(event.metadata) },
+    }, ttl);
+}
+/** Encodes a stream's inline snapshot item. `ttl` is written only when positive. */
+export function snapshotItem(snapshot, ttl) {
+    return withTtl({
+        pk: { S: snapshot.entityId },
+        sk: { N: SNAPSHOT_SORT_KEY.toString() },
+        seq: { N: int64Argument(snapshot.sequence, 'snapshot.sequence').toString() },
+        eventSeq: { N: int64Argument(snapshot.eventSequence, 'snapshot.eventSequence').toString() },
+        entityType: { S: snapshot.entityType },
+        payload: { S: payloadText(snapshot.payload, 'snapshot payload') },
+    }, ttl);
+}
+/** Encodes a stream's head item. `ttl` is written only when positive. */
+export function headItem(entityId, head, ttl) {
+    const item = {
+        pk: { S: entityId },
+        sk: { N: HEAD_SORT_KEY.toString() },
+        head: { N: int64Argument(head, 'head').toString() },
+    };
+    return withTtl(item, ttl);
+}
+/** Encodes a single-item view row: `pk = {entityType}#{entityId}`, `sk = "VIEW"`. */
+export function viewItem(entityType, entityId, payload) {
+    return {
+        pk: { S: `${entityType}#${entityId}` },
+        sk: { S: DEFAULT_VIEW_SORT_KEY },
+        entityID: { S: entityId },
+        entityType: { S: entityType },
+        payload: { S: payloadText(payload, 'view payload') },
+    };
+}
+/**
+ * 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 function eventFromItem(item) {
+    const entityId = requiredString(item, 'pk');
+    const sequence = requiredNumber(item, 'sk');
+    const id = eventId(entityId, sequence);
+    const metadata = optionalString(item, 'metadata') ?? '';
+    if (metadata.trim() === '') {
+        throw invalid(`event ${id} has empty metadata`);
+    }
+    let decoded;
+    try {
+        decoded = metadataFromJson(parseJson(metadata, DOCUMENT));
+    }
+    catch (error) {
+        throw new EvtError('invalidRecord', `event ${id} metadata: ${message(error)}`, { cause: error });
+    }
+    return {
+        id,
+        sequence,
+        type: optionalString(item, 'type') ?? '',
+        version: safeInteger(optionalNumber(item, 'version') ?? 0n, 'version'),
+        entityId,
+        entityType: optionalString(item, 'entityType') ?? '',
+        payload: utf8Encode(optionalString(item, 'payload') ?? ''),
+        metadata: decoded,
+    };
+}
+/** Decodes a stream's inline snapshot item. */
+export function snapshotFromItem(item) {
+    return {
+        entityType: optionalString(item, 'entityType') ?? '',
+        entityId: requiredString(item, 'pk'),
+        sequence: optionalNumber(item, 'seq') ?? 0n,
+        eventSequence: optionalNumber(item, 'eventSeq') ?? 0n,
+        payload: utf8Encode(optionalString(item, 'payload') ?? ''),
+    };
+}
+/** Decodes a head item into its head and its `ttl`, if it has one. */
+export function headFromItem(item) {
+    const ttl = optionalNumber(item, 'ttl');
+    return {
+        head: requiredNumber(item, 'head'),
+        ttl: ttl === undefined ? undefined : safeInteger(ttl, 'ttl'),
+    };
+}
+/** Whether an item is a stream's inline snapshot (`sk = 0`). */
+export function isSnapshotItem(item) {
+    return sortKey(item) === SNAPSHOT_SORT_KEY;
+}
+/** An item's numeric sort key, if it has one. */
+export function sortKey(item) {
+    const sk = item['sk'];
+    if (sk === undefined || !('N' in sk)) {
+        return undefined;
+    }
+    return parseNumber(sk.N);
+}
+/**
+ * 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 function expiry(nowMs, retentionMs) {
+    if (!Number.isSafeInteger(nowMs) || !Number.isSafeInteger(retentionMs) || retentionMs < 0) {
+        throw new EvtError('invalidArgument', 'the clock and the retention must be whole, non-negative milliseconds: ' +
+            `${nowMs}, ${retentionMs}`);
+    }
+    if (retentionMs === 0) {
+        return undefined;
+    }
+    return Math.floor((nowMs + retentionMs) / 1000);
+}
+/**
+ * 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 function itemSize(item) {
+    let size = 0;
+    for (const [name, value] of Object.entries(item)) {
+        size += utf8Length(name) + valueSize(value);
+    }
+    return size;
+}
+function valueSize(value) {
+    if ('S' in value) {
+        return utf8Length(value.S);
+    }
+    if ('N' in value) {
+        return utf8Length(value.N);
+    }
+    if ('B' in value) {
+        return value.B.length;
+    }
+    if ('BOOL' in value || 'NULL' in value) {
+        return 1;
+    }
+    if ('M' in value) {
+        return 3 + itemSize(value.M) + Object.keys(value.M).length;
+    }
+    if ('L' in value) {
+        return value.L.reduce((size, entry) => size + 1 + valueSize(entry), 3);
+    }
+    if ('SS' in value) {
+        return value.SS.reduce((size, entry) => size + utf8Length(entry), 0);
+    }
+    if ('NS' in value) {
+        return value.NS.reduce((size, entry) => size + utf8Length(entry), 0);
+    }
+    return value.BS.reduce((size, entry) => size + entry.length, 0);
+}
+function withTtl(item, ttl) {
+    if (ttl !== undefined && safeIntegerArgument(ttl, 'ttl') > 0) {
+        item['ttl'] = { N: ttl.toString() };
+    }
+    return item;
+}
+// A payload is stored as a DynamoDB string, so it must be UTF-8. A null payload is stored empty.
+function payloadText(payload, what) {
+    if (payload === null) {
+        return '';
+    }
+    try {
+        return utf8Decode(payload, what);
+    }
+    catch (error) {
+        const reason = `${what} is not valid UTF-8 and cannot be stored as a string`;
+        throw new EvtError('invalidArgument', reason, { cause: error });
+    }
+}
+function requiredString(item, name) {
+    const value = optionalString(item, name);
+    if (value === undefined) {
+        throw invalid(`item has no ${name} attribute`);
+    }
+    return value;
+}
+function requiredNumber(item, name) {
+    const value = optionalNumber(item, name);
+    if (value === undefined) {
+        throw invalid(`item has no ${name} attribute`);
+    }
+    return value;
+}
+function optionalString(item, name) {
+    const value = item[name];
+    if (value === undefined || 'NULL' in value) {
+        return undefined;
+    }
+    if (!('S' in value)) {
+        throw invalid(`attribute ${name} is not a string`);
+    }
+    return value.S;
+}
+function optionalNumber(item, name) {
+    const value = item[name];
+    if (value === undefined || 'NULL' in value) {
+        return undefined;
+    }
+    if (!('N' in value)) {
+        throw invalid(`attribute ${name} is not a number`);
+    }
+    const number = parseNumber(value.N);
+    if (number === undefined) {
+        throw invalid(`attribute ${name} is not an integer: ${value.N}`);
+    }
+    return number;
+}
+// An int64 in decimal, as strconv.ParseInt reads it: an optional sign, then digits.
+function parseNumber(text) {
+    if (!/^[+-]?\d+$/.test(text)) {
+        return undefined;
+    }
+    try {
+        return checkInt64(BigInt(text), 'number');
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeInteger(value, name) {
+    if (value < BigInt(Number.MIN_SAFE_INTEGER) || value > BigInt(Number.MAX_SAFE_INTEGER)) {
+        throw invalid(`attribute ${name} is ${value}, past the integers it holds`);
+    }
+    return Number(value);
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=item.js.map

package/dist/dynamodb/item.js.map

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