@auriclabs/events-infra 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,25 @@
+
+> @auriclabs/events-infra@0.1.0 build /home/runner/work/packages/packages/packages/events-infra
+> tsdown src/index.ts --format cjs,esm --dts --tsconfig tsconfig.build.json --no-hash
+
+[tsdown] Node.js v20.20.1 is deprecated. Support will be removed in the next minor release. Please upgrade to Node.js 22.18.0 or later.
+ℹ tsdown v0.21.4 powered by rolldown v1.0.0-rc.9
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.build.json
+ℹ Build start
+ℹ [CJS] dist/index.cjs  1.14 kB │ gzip: 0.57 kB
+ℹ [CJS] 1 files, total: 1.14 kB
+ℹ [ESM] dist/index.mjs        1.03 kB │ gzip: 0.54 kB
+ℹ [ESM] dist/index.mjs.map    2.18 kB │ gzip: 0.95 kB
+ℹ [ESM] dist/index.d.mts.map  0.52 kB │ gzip: 0.27 kB
+ℹ [ESM] dist/index.d.mts      0.77 kB │ gzip: 0.33 kB
+ℹ [ESM] 4 files, total: 4.50 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
+
+ℹ [CJS] dist/index.d.cts.map  0.52 kB │ gzip: 0.27 kB
+ℹ [CJS] dist/index.d.cts      0.77 kB │ gzip: 0.33 kB
+ℹ [CJS] 2 files, total: 1.29 kB
+✔ Build complete in 11027ms
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 11028ms

package/README.md

@@ -0,0 +1,111 @@
+# @auriclabs/events-infra
+
+SST infrastructure helpers for provisioning DynamoDB event stores, EventBridge buses, and DynamoDB stream subscriptions.
+
+## Setup
+
+```bash
+pnpm add @auriclabs/events-infra
+```
+
+### Peer dependencies
+
+```bash
+pnpm add sst @auriclabs/sst-types
+```
+
+## API Reference
+
+### `createEventStore(name, options?)`
+
+Creates a DynamoDB table configured for event sourcing with `pk`/`sk` keys, DynamoDB Streams enabled, and `STANDARD_INFREQUENT_ACCESS` storage class.
+
+```typescript
+import { createEventStore } from '@auriclabs/events-infra';
+
+export const table = createEventStore('EventStoreTable');
+```
+
+Options:
+
+```typescript
+interface CreateEventStoreOptions {
+  transform?: {
+    table?: Record<string, unknown>;  // Override default table transform
+  };
+}
+```
+
+Returns: `sst.aws.Dynamo`
+
+### `createEventBus(name)`
+
+Creates an EventBridge bus.
+
+```typescript
+import { createEventBus } from '@auriclabs/events-infra';
+
+export const bus = createEventBus('EventBus');
+```
+
+Returns: `sst.aws.Bus`
+
+### `subscribeEventStream(config)`
+
+Subscribes a Lambda handler to the DynamoDB event store stream. Filters for `itemType: 'event'` records only (skips HEAD updates). Links the EventBridge bus and all listener queues, and sets the `QUEUE_URL_LIST` environment variable.
+
+```typescript
+import { subscribeEventStream } from '@auriclabs/events-infra';
+
+subscribeEventStream({
+  table: eventTable,
+  bus: eventBus,
+  listenerQueues: [crawlerQueue, indexerQueue],
+  handlerPath: 'services/event/handlers/event-store-table-stream.handler',
+});
+```
+
+Config:
+
+```typescript
+interface SubscribeEventStreamConfig {
+  table: sst.aws.Dynamo;
+  bus: sst.aws.Bus;
+  listenerQueues: sst.aws.Queue[];
+  handlerPath: string;  // Lambda handler path
+}
+```
+
+## Full Example
+
+```typescript
+// infra/event.ts
+import { createEventStore, createEventBus, subscribeEventStream } from '@auriclabs/events-infra';
+import * as services from './services';
+
+export const table = createEventStore('EventStoreTable');
+export const bus = createEventBus('EventBus');
+
+subscribeEventStream({
+  table,
+  bus,
+  listenerQueues: [
+    services.crawler.eventListenerQueue,
+    services.indexer.eventListenerQueue,
+  ],
+  handlerPath: 'services/event/handlers/event-store-table-stream.handler',
+});
+```
+
+The stream handler should use `createStreamHandler()` from `@auriclabs/events`:
+
+```typescript
+// services/event/handlers/event-store-table-stream.ts
+import { createStreamHandler } from '@auriclabs/events';
+import { Resource } from 'sst';
+
+export const handler = createStreamHandler({
+  busName: Resource.EventBus.name,
+  queueUrls: JSON.parse(process.env.QUEUE_URL_LIST ?? '[]'),
+});
+```

package/dist/index.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/event-store.ts
+function createEventStore(name, options) {
+	return new sst.aws.Dynamo(name, {
+		fields: {
+			pk: "string",
+			sk: "string"
+		},
+		primaryIndex: {
+			hashKey: "pk",
+			rangeKey: "sk"
+		},
+		globalIndexes: {},
+		stream: "new-and-old-images",
+		transform: { table: {
+			tableClass: "STANDARD_INFREQUENT_ACCESS",
+			...options?.transform?.table
+		} }
+	});
+}
+//#endregion
+//#region src/event-bus.ts
+function createEventBus(name) {
+	return new sst.aws.Bus(name);
+}
+//#endregion
+//#region src/event-listeners.ts
+function subscribeEventStream(config) {
+	const { table, bus, listenerQueues, handlerPath } = config;
+	table.subscribe("EventStoreTableStream", {
+		handler: handlerPath,
+		link: [bus, ...listenerQueues],
+		environment: { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) }
+	}, { filters: [{ dynamodb: { NewImage: { itemType: { S: ["event"] } } } }] });
+}
+//#endregion
+exports.createEventBus = createEventBus;
+exports.createEventStore = createEventStore;
+exports.subscribeEventStream = subscribeEventStream;

package/dist/index.d.cts

@@ -0,0 +1,22 @@
+//#region src/event-store.d.ts
+interface CreateEventStoreOptions {
+  transform?: {
+    table?: Record<string, unknown>;
+  };
+}
+declare function createEventStore(name: string, options?: CreateEventStoreOptions): sst.aws.Dynamo;
+//#endregion
+//#region src/event-bus.d.ts
+declare function createEventBus(name: string): sst.aws.Bus;
+//#endregion
+//#region src/event-listeners.d.ts
+interface SubscribeEventStreamConfig {
+  table: sst.aws.Dynamo;
+  bus: sst.aws.Bus;
+  listenerQueues: sst.aws.Queue[];
+  handlerPath: string;
+}
+declare function subscribeEventStream(config: SubscribeEventStreamConfig): void;
+//#endregion
+export { CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventStore, subscribeEventStream };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts"],"mappings":";UAAiB,uBAAA;EACf,SAAA;IACE,KAAA,GAAQ,MAAA;EAAA;AAAA;AAAA,iBAII,gBAAA,CAAiB,IAAA,UAAc,OAAA,GAAU,uBAAA,GAAuB,GAAA,CAAA,GAAA,CAAA,MAAA;;;iBCNhE,cAAA,CAAe,IAAA,WAAY,GAAA,CAAA,GAAA,CAAA,GAAA;;;UCA1B,0BAAA;EACf,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,MAAA;EACf,GAAA,EAAK,GAAA,CAAI,GAAA,CAAI,GAAA;EACb,cAAA,EAAgB,GAAA,CAAI,GAAA,CAAI,KAAA;EACxB,WAAA;AAAA;AAAA,iBAGc,oBAAA,CAAqB,MAAA,EAAQ,0BAAA"}

package/dist/index.d.mts

@@ -0,0 +1,22 @@
+//#region src/event-store.d.ts
+interface CreateEventStoreOptions {
+  transform?: {
+    table?: Record<string, unknown>;
+  };
+}
+declare function createEventStore(name: string, options?: CreateEventStoreOptions): sst.aws.Dynamo;
+//#endregion
+//#region src/event-bus.d.ts
+declare function createEventBus(name: string): sst.aws.Bus;
+//#endregion
+//#region src/event-listeners.d.ts
+interface SubscribeEventStreamConfig {
+  table: sst.aws.Dynamo;
+  bus: sst.aws.Bus;
+  listenerQueues: sst.aws.Queue[];
+  handlerPath: string;
+}
+declare function subscribeEventStream(config: SubscribeEventStreamConfig): void;
+//#endregion
+export { CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventStore, subscribeEventStream };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts"],"mappings":";UAAiB,uBAAA;EACf,SAAA;IACE,KAAA,GAAQ,MAAA;EAAA;AAAA;AAAA,iBAII,gBAAA,CAAiB,IAAA,UAAc,OAAA,GAAU,uBAAA,GAAuB,GAAA,CAAA,GAAA,CAAA,MAAA;;;iBCNhE,cAAA,CAAe,IAAA,WAAY,GAAA,CAAA,GAAA,CAAA,GAAA;;;UCA1B,0BAAA;EACf,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,MAAA;EACf,GAAA,EAAK,GAAA,CAAI,GAAA,CAAI,GAAA;EACb,cAAA,EAAgB,GAAA,CAAI,GAAA,CAAI,KAAA;EACxB,WAAA;AAAA;AAAA,iBAGc,oBAAA,CAAqB,MAAA,EAAQ,0BAAA"}

package/dist/index.mjs

@@ -0,0 +1,38 @@
+//#region src/event-store.ts
+function createEventStore(name, options) {
+	return new sst.aws.Dynamo(name, {
+		fields: {
+			pk: "string",
+			sk: "string"
+		},
+		primaryIndex: {
+			hashKey: "pk",
+			rangeKey: "sk"
+		},
+		globalIndexes: {},
+		stream: "new-and-old-images",
+		transform: { table: {
+			tableClass: "STANDARD_INFREQUENT_ACCESS",
+			...options?.transform?.table
+		} }
+	});
+}
+//#endregion
+//#region src/event-bus.ts
+function createEventBus(name) {
+	return new sst.aws.Bus(name);
+}
+//#endregion
+//#region src/event-listeners.ts
+function subscribeEventStream(config) {
+	const { table, bus, listenerQueues, handlerPath } = config;
+	table.subscribe("EventStoreTableStream", {
+		handler: handlerPath,
+		link: [bus, ...listenerQueues],
+		environment: { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) }
+	}, { filters: [{ dynamodb: { NewImage: { itemType: { S: ["event"] } } } }] });
+}
+//#endregion
+export { createEventBus, createEventStore, subscribeEventStream };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts"],"sourcesContent":["export interface CreateEventStoreOptions {\n  transform?: {\n    table?: Record<string, unknown>;\n  };\n}\n\nexport function createEventStore(name: string, options?: CreateEventStoreOptions) {\n  return new sst.aws.Dynamo(name, {\n    fields: {\n      pk: 'string',\n      sk: 'string',\n    },\n    primaryIndex: {\n      hashKey: 'pk',\n      rangeKey: 'sk',\n    },\n    globalIndexes: {},\n    stream: 'new-and-old-images',\n    transform: {\n      table: {\n        tableClass: 'STANDARD_INFREQUENT_ACCESS',\n        ...options?.transform?.table,\n      },\n    },\n  });\n}\n","export function createEventBus(name: string) {\n  return new sst.aws.Bus(name);\n}\n","export interface SubscribeEventStreamConfig {\n  table: sst.aws.Dynamo;\n  bus: sst.aws.Bus;\n  listenerQueues: sst.aws.Queue[];\n  handlerPath: string;\n}\n\nexport function subscribeEventStream(config: SubscribeEventStreamConfig) {\n  const { table, bus, listenerQueues, handlerPath } = config;\n\n  table.subscribe(\n    'EventStoreTableStream',\n    {\n      handler: handlerPath,\n      link: [bus, ...listenerQueues],\n      environment: {\n        QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)),\n      },\n    },\n    {\n      filters: [\n        {\n          dynamodb: {\n            NewImage: {\n              itemType: { S: ['event'] },\n            },\n          },\n        },\n      ],\n    },\n  );\n}\n"],"mappings":";AAMA,SAAgB,iBAAiB,MAAc,SAAmC;AAChF,QAAO,IAAI,IAAI,IAAI,OAAO,MAAM;EAC9B,QAAQ;GACN,IAAI;GACJ,IAAI;GACL;EACD,cAAc;GACZ,SAAS;GACT,UAAU;GACX;EACD,eAAe,EAAE;EACjB,QAAQ;EACR,WAAW,EACT,OAAO;GACL,YAAY;GACZ,GAAG,SAAS,WAAW;GACxB,EACF;EACF,CAAC;;;;ACxBJ,SAAgB,eAAe,MAAc;AAC3C,QAAO,IAAI,IAAI,IAAI,IAAI,KAAK;;;;ACM9B,SAAgB,qBAAqB,QAAoC;CACvE,MAAM,EAAE,OAAO,KAAK,gBAAgB,gBAAgB;AAEpD,OAAM,UACJ,yBACA;EACE,SAAS;EACT,MAAM,CAAC,KAAK,GAAG,eAAe;EAC9B,aAAa,EACX,gBAAgB,eAAe,eAAe,KAAK,UAAU,MAAM,IAAI,CAAC,EACzE;EACF,EACD,EACE,SAAS,CACP,EACE,UAAU,EACR,UAAU,EACR,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAC3B,EACF,EACF,CACF,EACF,CACF"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@auriclabs/events-infra",
+  "version": "0.1.0",
+  "description": "SST infrastructure helpers for DynamoDB event stores",
+  "prettier": "@auriclabs/prettier-config",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "keywords": [],
+  "author": "",
+  "type": "module",
+  "license": "ISC",
+  "dependencies": {},
+  "devDependencies": {
+    "sst": "^4.3.7",
+    "@auriclabs/sst-types": "0.1.0"
+  },
+  "peerDependencies": {
+    "@auriclabs/sst-types": "^0.1.0",
+    "sst": "^4.3.7"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/auriclabs/packages.git",
+    "directory": "packages/events-infra"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts --format cjs,esm --dts --tsconfig tsconfig.build.json --no-hash",
+    "dev": "concurrently \"pnpm build --watch\" \"pnpm:y:watch\"",
+    "y:watch": "chokidar dist --initial --silent -c \"yalc publish --push\"",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "ts-config-typecheck",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}

package/src/event-bus.ts

@@ -0,0 +1,3 @@
+export function createEventBus(name: string) {
+  return new sst.aws.Bus(name);
+}

package/src/event-listeners.ts

@@ -0,0 +1,32 @@
+export interface SubscribeEventStreamConfig {
+  table: sst.aws.Dynamo;
+  bus: sst.aws.Bus;
+  listenerQueues: sst.aws.Queue[];
+  handlerPath: string;
+}
+
+export function subscribeEventStream(config: SubscribeEventStreamConfig) {
+  const { table, bus, listenerQueues, handlerPath } = config;
+
+  table.subscribe(
+    'EventStoreTableStream',
+    {
+      handler: handlerPath,
+      link: [bus, ...listenerQueues],
+      environment: {
+        QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)),
+      },
+    },
+    {
+      filters: [
+        {
+          dynamodb: {
+            NewImage: {
+              itemType: { S: ['event'] },
+            },
+          },
+        },
+      ],
+    },
+  );
+}

package/src/event-store.ts

@@ -0,0 +1,26 @@
+export interface CreateEventStoreOptions {
+  transform?: {
+    table?: Record<string, unknown>;
+  };
+}
+
+export function createEventStore(name: string, options?: CreateEventStoreOptions) {
+  return new sst.aws.Dynamo(name, {
+    fields: {
+      pk: 'string',
+      sk: 'string',
+    },
+    primaryIndex: {
+      hashKey: 'pk',
+      rangeKey: 'sk',
+    },
+    globalIndexes: {},
+    stream: 'new-and-old-images',
+    transform: {
+      table: {
+        tableClass: 'STANDARD_INFREQUENT_ACCESS',
+        ...options?.transform?.table,
+      },
+    },
+  });
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './event-store';
+export * from './event-bus';
+export * from './event-listeners';

package/tsconfig.build.json

@@ -0,0 +1,19 @@
+{
+  "extends": "@auriclabs/ts-config/node-package",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "dist",
+    "composite": true,
+    "types": ["@auriclabs/sst-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": [
+    "dist",
+    "node_modules",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/__tests__/**",
+    "**/__mocks__/**",
+    "vitest.config.ts"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "files": [],
+  "references": [{ "path": "./tsconfig.build.json" }]
+}