@photon-grove/evt 0.1.0 → 0.1.1

package/dist/repository.js

@@ -2,6 +2,7 @@
 // same way: validation, the reserved namespaces, and the transaction budget.
 import { headActionSize, headUpdate } from './dynamodb/head.js';
 import { eventItem, itemSize, snapshotItem } from './dynamodb/item.js';
+import { FEATURES_PK, REBUILD_LOCK_PK } from './dynamodb/marker.js';
 import { CommitTooLargeError, EvtError, ReservedEntityIdError } from './errors.js';
 import { eventId } from './event.js';
 import { MAX_COMMIT_ITEM_BYTES } from './snapshots.js';
@@ -14,9 +15,6 @@ export const RESERVED_PREFIXES = Object.freeze([
     'SYSTEM#',
     'command-outcome#',
 ]);
-// The control rows every commit checks: the feature marker and the rebuild lock.
-const FEATURES_ID = 'SYSTEM#FEATURES';
-const REBUILD_LOCK_ID = 'SYSTEM#REBUILD';
 /** Whether an entity ID is in a reserved namespace. */
 export function isReserved(entityId) {
     return RESERVED_PREFIXES.some((prefix) => entityId.startsWith(prefix));
@@ -79,7 +77,8 @@ export function validateCommit(commit) {
  * backend budgets a commit by these sizes, so an oversized commit fails the same way on each.
  */
 export function commitSizes(commit, ttl) {
-    const sizes = [controlCheckSize(FEATURES_ID), controlCheckSize(REBUILD_LOCK_ID)];
+    // The control rows every commit checks: the feature marker and the rebuild lock.
+    const sizes = [controlCheckSize(FEATURES_PK), controlCheckSize(REBUILD_LOCK_PK)];
     const first = commit.events[0];
     const last = commit.events.at(-1);
     if (first === undefined || last === undefined) {

package/dist/repository.js.map

@@ -1 +1 @@
-{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6EAA6E;AAE7E,OAAO,EAAC,cAAc,EAAE,UAAU,EAAC,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAC,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAC,mBAAmB,EAAE,QAAQ,EAAE,qBAAqB,EAAC,MAAM,aAAa,CAAA;AAChF,OAAO,EAAgD,OAAO,EAAC,MAAM,YAAY,CAAA;AACjF,OAAO,EAAC,qBAAqB,EAAC,MAAM,gBAAgB,CAAA;AAmFpD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAA;AAErC,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA;AAEzC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC;IAChE,SAAS;IACT,kBAAkB;CACnB,CAAC,CAAA;AAEF,iFAAiF;AACjF,MAAM,WAAW,GAAG,iBAAiB,CAAA;AACrC,MAAM,eAAe,GAAG,gBAAgB,CAAA;AAExC,uDAAuD;AACvD,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;AACxE,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAM;IACR,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;YAC1C,MAAM,aAAa,CACjB,SAAS,KAAK,CAAC,EAAE,oBAAoB,KAAK,CAAC,UAAU,iCAAiC;gBACpF,OAAO,KAAK,CAAC,UAAU,EAAE,CAC5B,CAAA;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IAChC,IAAI,QAAQ,IAAI,QAAQ,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;QACzD,MAAM,aAAa,CACjB,gCAAgC,QAAQ,CAAC,UAAU,wBAAwB;YACzE,KAAK,CAAC,UAAU,CACnB,CAAA;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;QACvC,MAAM,aAAa,CACjB,qBAAqB,QAAQ,CAAC,QAAQ,4CAA4C,CACnF,CAAA;IACH,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,aAAa,CACjB,SAAS,KAAK,CAAC,EAAE,sBAAsB,KAAK,CAAC,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE,CAChF,CAAA;QACH,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QAClD,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACpB,MAAM,aAAa,CAAC,SAAS,KAAK,CAAC,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAA;QACnE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,GAAG,EAAE,EAAE,CAAC;QACxB,MAAM,aAAa,CAAC,kBAAkB,KAAK,CAAC,QAAQ,mCAAmC,CAAC,CAAA;IAC1F,CAAC;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,QAAQ,CAAA;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAA;QACvC,IAAI,IAAI,KAAK,QAAQ,GAAG,EAAE,EAAE,CAAC;YAC3B,MAAM,aAAa,CACjB,kBAAkB,IAAI,YAAY,QAAQ,gCAAgC,CAC3E,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,GAA+C;IAE/C,MAAM,KAAK,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAA;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;IAC9F,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAA;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAA;IAChC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAuB;YACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,aAAa,EAAE,IAAI,CAAC,QAAQ;YAC5B,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAA;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAwB;IAClD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,WAAW,GAAG,CAAC,CAAA;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,IAAI,IAAI,CAAA;QACb,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,QAAQ,GACZ,KAAK,CAAC,MAAM,GAAG,kBAAkB;QACjC,KAAK,GAAG,gBAAgB;QACxB,WAAW,GAAG,qBAAqB,CAAA;IACrC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,0DAA0D;AAC1D,SAAS,gBAAgB,CAAC,EAAU;IAClC,OAAO,QAAQ,CAAC,EAAC,EAAE,EAAE,EAAC,CAAC,EAAE,EAAE,EAAC,EAAE,EAAE,EAAE,EAAC,CAAC,EAAE,GAAG,EAAC,EAAC,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,aAAa,CAAC,OAAe;IACpC,OAAO,IAAI,QAAQ,CAAC,eAAe,EAAE,mBAAmB,OAAO,EAAE,CAAC,CAAA;AACpE,CAAC"}
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -94,9 +94,9 @@ export declare class Store {
      */
     execute<S, C, D extends EventDefinitions>(aggregate: Aggregate<S, C, D>, entityId: string, command: C, options?: ExecuteOptions): Promise<ExecuteResult<S>>;
     /**
-     * Like {@link execute}, but loads and runs the command again after a retryable error (a
-     * conflict), waiting {@link retryDelay} between attempts. When the attempts run out, the last
-     * error is thrown. A rejection or a duplicate is a result, never retried.
+     * Like {@link execute}, but loads and runs the command again after a retryable error (see
+     * {@link isRetryable}), waiting {@link retryDelay} between attempts. When the attempts run out,
+     * the last error is thrown. A rejection or a duplicate is a result, never retried.
      */
     executeWithRetry<S, C, D extends EventDefinitions>(aggregate: Aggregate<S, C, D>, entityId: string, command: C, options?: RetryOptions): Promise<ExecuteResult<S>>;
 }

package/dist/store.js

@@ -85,9 +85,9 @@ export class Store {
         return { kind: 'committed', state, events };
     }
     /**
-     * Like {@link execute}, but loads and runs the command again after a retryable error (a
-     * conflict), waiting {@link retryDelay} between attempts. When the attempts run out, the last
-     * error is thrown. A rejection or a duplicate is a result, never retried.
+     * Like {@link execute}, but loads and runs the command again after a retryable error (see
+     * {@link isRetryable}), waiting {@link retryDelay} between attempts. When the attempts run out,
+     * the last error is thrown. A rejection or a duplicate is a result, never retried.
      */
     async executeWithRetry(aggregate, entityId, command, options = {}) {
         const policy = options.policy ?? DEFAULT_RETRY_POLICY;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photon-grove/evt",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Event sourcing for TypeScript, wire-compatible with the Go and Rust evt implementations.",
   "keywords": [
     "event-sourcing",
@@ -44,14 +44,23 @@
     },
     "./package.json": "./package.json"
   },
+  "peerDependencies": {
+    "@aws-sdk/client-dynamodb": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-dynamodb": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "tsc",
     "check": "tsc --noEmit && tsc -p tsconfig.test.json && oxlint --deny-warnings && node scripts/check-imports.ts",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@types/node": "^25.9.9",
-    "oxlint": "1.88.0",
+    "@aws-sdk/client-dynamodb": "3.1161.0",
+    "@types/node": "^26.6.6",
+    "oxlint": "1.90.0",
     "typescript": "^7.0.2",
     "vitest": "5.0.5"
   }

package/src/dynamodb/client.ts

@@ -0,0 +1,102 @@
+// 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.
+
+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>
+}

package/src/dynamodb/index.ts

@@ -1,5 +1,5 @@
-// @photon-grove/evt/dynamodb: the DynamoDB backend. So far it holds the item codec, which imports
-// nothing from the AWS SDK.
+// @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 {
   type AttributeValue,
@@ -17,5 +17,29 @@ export {
   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'

package/src/dynamodb/item.ts

@@ -151,12 +151,14 @@ export function snapshotFromItem(item: Item): SerializedSnapshot {
 
 /** Decodes a head item into its head and its `ttl`, if it has one. */
 export function headFromItem(item: Item): {head: bigint; ttl: number | undefined} {
+  return {head: requiredNumber(item, 'head'), ttl: ttlFromItem(item)}
+}
+
+/** An item's `ttl` in Unix seconds, or undefined when it has none. */
+export function ttlFromItem(item: Item): number | undefined {
   const ttl = optionalNumber(item, 'ttl')
 
-  return {
-    head: requiredNumber(item, 'head'),
-    ttl: ttl === undefined ? undefined : safeInteger(ttl, 'ttl'),
-  }
+  return ttl === undefined ? undefined : safeInteger(ttl, 'ttl')
 }
 
 /** Whether an item is a stream's inline snapshot (`sk = 0`). */

package/src/dynamodb/marker.ts

@@ -0,0 +1,64 @@
+// The DynamoDB item of the feature-marker row. The control rows live in the reserved SYSTEM#
+// namespace at sort key 0.
+//
+// | Attribute          | Type | Feature-marker item (`pk = SYSTEM#FEATURES`, `sk = 0`)       |
+// | ------------------ | ---- | ------------------------------------------------------------ |
+// | `version`          | N    | bumped on every change to the manifest                       |
+// | `features`         | S    | JSON object, feature name → stored-format version, sorted    |
+// | `historyDependent` | S    | JSON array of entity types, sorted. Absent when empty        |
+// | `retention`        | S    | JSON array of entity types, sorted. Absent when empty        |
+
+import {checkInt64, invalid} from '../fields.js'
+import {type FeatureManifest, decodeManifest, encodeManifest} from '../features.js'
+import {type Item, SNAPSHOT_SORT_KEY} from './item.js'
+
+/** The partition key of the feature-marker row. */
+export const FEATURES_PK = 'SYSTEM#FEATURES'
+
+/** The partition key of the rebuild-lock row, which every commit checks is absent. */
+export const REBUILD_LOCK_PK = 'SYSTEM#REBUILD'
+
+/** Encodes a feature manifest as its marker item. Empty entity-type sets are left out. */
+export function markerItem(manifest: FeatureManifest): Item {
+  const texts = encodeManifest(manifest)
+  const item: Item = {
+    pk: {S: FEATURES_PK},
+    sk: {N: SNAPSHOT_SORT_KEY.toString()},
+    version: {N: manifest.version.toString()},
+    features: {S: texts.features},
+  }
+  if (manifest.historyDependent.length > 0) {
+    item['historyDependent'] = {S: texts.historyDependent}
+  }
+  if (manifest.retention.length > 0) {
+    item['retention'] = {S: texts.retention}
+  }
+
+  return item
+}
+
+/** Decodes a marker item. An absent text attribute is an empty map or set. */
+export function manifestFromItem(item: Item): FeatureManifest {
+  const version = item['version']
+  if (version === undefined || !('N' in version) || !/^\d+$/.test(version.N)) {
+    throw invalid('the feature marker has no version')
+  }
+
+  return decodeManifest(checkInt64(BigInt(version.N), 'the feature marker version'), {
+    features: text(item, 'features'),
+    historyDependent: text(item, 'historyDependent'),
+    retention: text(item, 'retention'),
+  })
+}
+
+function text(item: Item, name: string): string {
+  const value = item[name]
+  if (value === undefined) {
+    return ''
+  }
+  if (!('S' in value)) {
+    throw invalid(`the feature marker's ${name} attribute is not a string`)
+  }
+
+  return value.S
+}