@auriclabs/events-infra 0.3.0 → 1.0.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @auriclabs/events-infra@0.3.0 build /home/runner/work/packages/packages/packages/events-infra
+> @auriclabs/events-infra@1.0.1 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.
@@ -7,19 +7,19 @@
 ℹ entry: src/index.ts
 ℹ tsconfig: tsconfig.build.json
 ℹ Build start
-ℹ [CJS] dist/index.cjs  1.22 kB │ gzip: 0.59 kB
-ℹ [CJS] 1 files, total: 1.22 kB
-ℹ [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
+ℹ [CJS] dist/index.cjs  2.07 kB │ gzip: 0.96 kB
+ℹ [CJS] 1 files, total: 2.07 kB
+ℹ [CJS] dist/index.d.cts.map  0.76 kB │ gzip: 0.33 kB
+ℹ [CJS] dist/index.d.cts      1.15 kB │ gzip: 0.43 kB
+ℹ [CJS] 2 files, total: 1.90 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.
 
-✔ Build complete in 10963ms
-ℹ [ESM] dist/index.mjs        1.11 kB │ gzip: 0.56 kB
-ℹ [ESM] dist/index.mjs.map    2.32 kB │ gzip: 0.99 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.72 kB
+✔ Build complete in 4824ms
+ℹ [ESM] dist/index.mjs        1.89 kB │ gzip: 0.90 kB
+ℹ [ESM] dist/index.mjs.map    4.04 kB │ gzip: 1.64 kB
+ℹ [ESM] dist/index.d.mts.map  0.76 kB │ gzip: 0.33 kB
+ℹ [ESM] dist/index.d.mts      1.15 kB │ gzip: 0.43 kB
+ℹ [ESM] 4 files, total: 7.83 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.
 
-✔ Build complete in 10968ms
+✔ Build complete in 4826ms

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @auriclabs/events-infra
 
+## 1.0.1
+
+### Patch Changes
+
+- df1699e: Change default dlqRetries from 3 to 1 in createEventQueue to reduce FIFO message group
+  blocking time on failures.
+- Updated dependencies [adb821b]
+  - @auriclabs/events@0.4.1
+
+## 1.0.0
+
+### Minor Changes
+
+- ddd017a: Add createEventQueue helper, make EventBridge bus optional, and bundle a pre-built stream
+  handler to eliminate consumer boilerplate.
+
+### Patch Changes
+
+- Updated dependencies [ddd017a]
+  - @auriclabs/events@0.4.0
+
 ## 0.3.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let module$1 = require("module");
 //#region src/event-store.ts
 function createEventStore(name, options) {
 	return new sst.aws.Dynamo(name, {
@@ -29,15 +30,42 @@ function createEventBus(name) {
 }
 //#endregion
 //#region src/event-listeners.ts
+const require$1 = (0, module$1.createRequire)(require("url").pathToFileURL(__filename).href);
 function subscribeEventStream(config) {
-	const { table, bus, listenerQueues, handlerPath } = config;
+	const { table, bus, listenerQueues } = config;
+	const handler = require$1.resolve("@auriclabs/events/stream-handler").replace(/\.[^.]+$/, "") + ".handler";
+	const environment = { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) };
+	if (bus) environment.EVENT_BUS_NAME = bus.name;
 	table.subscribe("EventStoreTableStream", {
-		handler: handlerPath,
-		link: [bus, ...listenerQueues],
-		environment: { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) }
+		handler,
+		link: [...bus ? [bus] : [], ...listenerQueues],
+		environment
 	}, { filters: [{ dynamodb: { NewImage: { itemType: { S: ["event"] } } } }] });
 }
 //#endregion
+//#region src/event-queue.ts
+function createEventQueue(name, subscriber, options) {
+	const { batchSize = 10, visibilityTimeout = "30 seconds", dlqRetries = 1 } = options ?? {};
+	const dlq = new sst.aws.Queue(`${name}DLQ`, { fifo: true });
+	const queue = new sst.aws.Queue(name, {
+		fifo: true,
+		visibilityTimeout,
+		dlq: {
+			queue: dlq.arn,
+			retry: dlqRetries
+		}
+	});
+	queue.subscribe(subscriber, { batch: {
+		size: batchSize,
+		partialResponses: true
+	} });
+	return {
+		queue,
+		dlq
+	};
+}
+//#endregion
 exports.createEventBus = createEventBus;
+exports.createEventQueue = createEventQueue;
 exports.createEventStore = createEventStore;
 exports.subscribeEventStream = subscribeEventStream;

package/dist/index.d.cts

@@ -12,11 +12,24 @@ declare function createEventBus(name: string): sst.aws.Bus;
 //#region src/event-listeners.d.ts
 interface SubscribeEventStreamConfig {
   table: sst.aws.Dynamo;
-  bus: sst.aws.Bus;
+  bus?: sst.aws.Bus;
   listenerQueues: sst.aws.Queue[];
-  handlerPath: string;
 }
 declare function subscribeEventStream(config: SubscribeEventStreamConfig): void;
 //#endregion
-export { CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventStore, subscribeEventStream };
+//#region src/event-queue.d.ts
+interface CreateEventQueueOptions {
+  batchSize?: number;
+  visibilityTimeout?: string;
+  dlqRetries?: number;
+}
+declare function createEventQueue(name: string, subscriber: {
+  handler: string;
+  [key: string]: unknown;
+}, options?: CreateEventQueueOptions): {
+  queue: sst.aws.Queue;
+  dlq: sst.aws.Queue;
+};
+//#endregion
+export { CreateEventQueueOptions, CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventQueue, createEventStore, subscribeEventStream };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts","../src/event-queue.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;;;UCI1B,0BAAA;EACf,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,MAAA;EACf,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,GAAA;EACd,cAAA,EAAgB,GAAA,CAAI,GAAA,CAAI,KAAA;AAAA;AAAA,iBAGV,oBAAA,CAAqB,MAAA,EAAQ,0BAAA;;;UCV5B,uBAAA;EACf,SAAA;EACA,iBAAA;EACA,UAAA;AAAA;AAAA,iBAGc,gBAAA,CACd,IAAA,UACA,UAAA;EACE,OAAA;EAAA,CACC,GAAA;AAAA,GAEH,OAAA,GAAU,uBAAA;EACP,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,KAAA;EAAO,GAAA,EAAK,GAAA,CAAI,GAAA,CAAI,KAAA;AAAA"}

package/dist/index.d.mts

@@ -12,11 +12,24 @@ declare function createEventBus(name: string): sst.aws.Bus;
 //#region src/event-listeners.d.ts
 interface SubscribeEventStreamConfig {
   table: sst.aws.Dynamo;
-  bus: sst.aws.Bus;
+  bus?: sst.aws.Bus;
   listenerQueues: sst.aws.Queue[];
-  handlerPath: string;
 }
 declare function subscribeEventStream(config: SubscribeEventStreamConfig): void;
 //#endregion
-export { CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventStore, subscribeEventStream };
+//#region src/event-queue.d.ts
+interface CreateEventQueueOptions {
+  batchSize?: number;
+  visibilityTimeout?: string;
+  dlqRetries?: number;
+}
+declare function createEventQueue(name: string, subscriber: {
+  handler: string;
+  [key: string]: unknown;
+}, options?: CreateEventQueueOptions): {
+  queue: sst.aws.Queue;
+  dlq: sst.aws.Queue;
+};
+//#endregion
+export { CreateEventQueueOptions, CreateEventStoreOptions, SubscribeEventStreamConfig, createEventBus, createEventQueue, createEventStore, subscribeEventStream };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts","../src/event-queue.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;;;UCI1B,0BAAA;EACf,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,MAAA;EACf,GAAA,GAAM,GAAA,CAAI,GAAA,CAAI,GAAA;EACd,cAAA,EAAgB,GAAA,CAAI,GAAA,CAAI,KAAA;AAAA;AAAA,iBAGV,oBAAA,CAAqB,MAAA,EAAQ,0BAAA;;;UCV5B,uBAAA;EACf,SAAA;EACA,iBAAA;EACA,UAAA;AAAA;AAAA,iBAGc,gBAAA,CACd,IAAA,UACA,UAAA;EACE,OAAA;EAAA,CACC,GAAA;AAAA,GAEH,OAAA,GAAU,uBAAA;EACP,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,KAAA;EAAO,GAAA,EAAK,GAAA,CAAI,GAAA,CAAI,KAAA;AAAA"}

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { createRequire } from "module";
 //#region src/event-store.ts
 function createEventStore(name, options) {
 	return new sst.aws.Dynamo(name, {
@@ -28,15 +29,41 @@ function createEventBus(name) {
 }
 //#endregion
 //#region src/event-listeners.ts
+const require = createRequire(import.meta.url);
 function subscribeEventStream(config) {
-	const { table, bus, listenerQueues, handlerPath } = config;
+	const { table, bus, listenerQueues } = config;
+	const handler = require.resolve("@auriclabs/events/stream-handler").replace(/\.[^.]+$/, "") + ".handler";
+	const environment = { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) };
+	if (bus) environment.EVENT_BUS_NAME = bus.name;
 	table.subscribe("EventStoreTableStream", {
-		handler: handlerPath,
-		link: [bus, ...listenerQueues],
-		environment: { QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)) }
+		handler,
+		link: [...bus ? [bus] : [], ...listenerQueues],
+		environment
 	}, { filters: [{ dynamodb: { NewImage: { itemType: { S: ["event"] } } } }] });
 }
 //#endregion
-export { createEventBus, createEventStore, subscribeEventStream };
+//#region src/event-queue.ts
+function createEventQueue(name, subscriber, options) {
+	const { batchSize = 10, visibilityTimeout = "30 seconds", dlqRetries = 1 } = options ?? {};
+	const dlq = new sst.aws.Queue(`${name}DLQ`, { fifo: true });
+	const queue = new sst.aws.Queue(name, {
+		fifo: true,
+		visibilityTimeout,
+		dlq: {
+			queue: dlq.arn,
+			retry: dlqRetries
+		}
+	});
+	queue.subscribe(subscriber, { batch: {
+		size: batchSize,
+		partialResponses: true
+	} });
+	return {
+		queue,
+		dlq
+	};
+}
+//#endregion
+export { createEventBus, createEventQueue, createEventStore, subscribeEventStream };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +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      tenantId: 'string',\n    },\n    primaryIndex: {\n      hashKey: 'pk',\n      rangeKey: 'sk',\n    },\n    globalIndexes: {\n      tenantIndex: { hashKey: 'tenantId', rangeKey: 'pk' },\n    },\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;GACJ,UAAU;GACX;EACD,cAAc;GACZ,SAAS;GACT,UAAU;GACX;EACD,eAAe,EACb,aAAa;GAAE,SAAS;GAAY,UAAU;GAAM,EACrD;EACD,QAAQ;EACR,WAAW,EACT,OAAO;GACL,YAAY;GACZ,GAAG,SAAS,WAAW;GACxB,EACF;EACF,CAAC;;;;AC3BJ,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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/event-store.ts","../src/event-bus.ts","../src/event-listeners.ts","../src/event-queue.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      tenantId: 'string',\n    },\n    primaryIndex: {\n      hashKey: 'pk',\n      rangeKey: 'sk',\n    },\n    globalIndexes: {\n      tenantIndex: { hashKey: 'tenantId', rangeKey: 'pk' },\n    },\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","import { createRequire } from 'module';\n\nconst require = createRequire(import.meta.url);\n\nexport interface SubscribeEventStreamConfig {\n  table: sst.aws.Dynamo;\n  bus?: sst.aws.Bus;\n  listenerQueues: sst.aws.Queue[];\n}\n\nexport function subscribeEventStream(config: SubscribeEventStreamConfig) {\n  const { table, bus, listenerQueues } = config;\n\n  const streamHandlerPath = require.resolve('@auriclabs/events/stream-handler');\n  const handler = streamHandlerPath.replace(/\\.[^.]+$/, '') + '.handler';\n\n  const environment: Record<string, $util.Input<string>> = {\n    QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)),\n  };\n\n  if (bus) {\n    environment.EVENT_BUS_NAME = bus.name;\n  }\n\n  table.subscribe(\n    'EventStoreTableStream',\n    {\n      handler,\n      link: [...(bus ? [bus] : []), ...listenerQueues],\n      environment,\n    },\n    {\n      filters: [\n        {\n          dynamodb: {\n            NewImage: {\n              itemType: { S: ['event'] },\n            },\n          },\n        },\n      ],\n    },\n  );\n}\n","export interface CreateEventQueueOptions {\n  batchSize?: number;\n  visibilityTimeout?: string;\n  dlqRetries?: number;\n}\n\nexport function createEventQueue(\n  name: string,\n  subscriber: {\n    handler: string;\n    [key: string]: unknown;\n  },\n  options?: CreateEventQueueOptions,\n): { queue: sst.aws.Queue; dlq: sst.aws.Queue } {\n  const { batchSize = 10, visibilityTimeout = '30 seconds', dlqRetries = 1 } = options ?? {};\n\n  const dlq = new sst.aws.Queue(`${name}DLQ`, {\n    fifo: true,\n  });\n\n  const queue = new sst.aws.Queue(name, {\n    fifo: true,\n    visibilityTimeout,\n    dlq: {\n      queue: dlq.arn,\n      retry: dlqRetries,\n    },\n  });\n\n  queue.subscribe(subscriber, {\n    batch: {\n      size: batchSize,\n      partialResponses: true,\n    },\n  });\n\n  return { queue, dlq };\n}\n"],"mappings":";;AAMA,SAAgB,iBAAiB,MAAc,SAAmC;AAChF,QAAO,IAAI,IAAI,IAAI,OAAO,MAAM;EAC9B,QAAQ;GACN,IAAI;GACJ,IAAI;GACJ,UAAU;GACX;EACD,cAAc;GACZ,SAAS;GACT,UAAU;GACX;EACD,eAAe,EACb,aAAa;GAAE,SAAS;GAAY,UAAU;GAAM,EACrD;EACD,QAAQ;EACR,WAAW,EACT,OAAO;GACL,YAAY;GACZ,GAAG,SAAS,WAAW;GACxB,EACF;EACF,CAAC;;;;AC3BJ,SAAgB,eAAe,MAAc;AAC3C,QAAO,IAAI,IAAI,IAAI,IAAI,KAAK;;;;ACC9B,MAAM,UAAU,cAAc,OAAO,KAAK,IAAI;AAQ9C,SAAgB,qBAAqB,QAAoC;CACvE,MAAM,EAAE,OAAO,KAAK,mBAAmB;CAGvC,MAAM,UADoB,QAAQ,QAAQ,mCAAmC,CAC3C,QAAQ,YAAY,GAAG,GAAG;CAE5D,MAAM,cAAmD,EACvD,gBAAgB,eAAe,eAAe,KAAK,UAAU,MAAM,IAAI,CAAC,EACzE;AAED,KAAI,IACF,aAAY,iBAAiB,IAAI;AAGnC,OAAM,UACJ,yBACA;EACE;EACA,MAAM,CAAC,GAAI,MAAM,CAAC,IAAI,GAAG,EAAE,EAAG,GAAG,eAAe;EAChD;EACD,EACD,EACE,SAAS,CACP,EACE,UAAU,EACR,UAAU,EACR,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAC3B,EACF,EACF,CACF,EACF,CACF;;;;ACpCH,SAAgB,iBACd,MACA,YAIA,SAC8C;CAC9C,MAAM,EAAE,YAAY,IAAI,oBAAoB,cAAc,aAAa,MAAM,WAAW,EAAE;CAE1F,MAAM,MAAM,IAAI,IAAI,IAAI,MAAM,GAAG,KAAK,MAAM,EAC1C,MAAM,MACP,CAAC;CAEF,MAAM,QAAQ,IAAI,IAAI,IAAI,MAAM,MAAM;EACpC,MAAM;EACN;EACA,KAAK;GACH,OAAO,IAAI;GACX,OAAO;GACR;EACF,CAAC;AAEF,OAAM,UAAU,YAAY,EAC1B,OAAO;EACL,MAAM;EACN,kBAAkB;EACnB,EACF,CAAC;AAEF,QAAO;EAAE;EAAO;EAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auriclabs/events-infra",
-  "version": "0.3.0",
+  "version": "1.0.1",
   "description": "SST infrastructure helpers for DynamoDB event stores",
   "prettier": "@auriclabs/prettier-config",
   "main": "src/index.ts",
@@ -18,9 +18,11 @@
   "dependencies": {},
   "devDependencies": {
     "sst": "^4.3.7",
+    "@auriclabs/events": "0.4.1",
     "@auriclabs/sst-types": "0.1.0"
   },
   "peerDependencies": {
+    "@auriclabs/events": "^0.4.1",
     "@auriclabs/sst-types": "^0.1.0",
     "sst": "^4.3.7"
   },

package/src/event-listeners.ts

@@ -1,21 +1,33 @@
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+
 export interface SubscribeEventStreamConfig {
   table: sst.aws.Dynamo;
-  bus: sst.aws.Bus;
+  bus?: sst.aws.Bus;
   listenerQueues: sst.aws.Queue[];
-  handlerPath: string;
 }
 
 export function subscribeEventStream(config: SubscribeEventStreamConfig) {
-  const { table, bus, listenerQueues, handlerPath } = config;
+  const { table, bus, listenerQueues } = config;
+
+  const streamHandlerPath = require.resolve('@auriclabs/events/stream-handler');
+  const handler = streamHandlerPath.replace(/\.[^.]+$/, '') + '.handler';
+
+  const environment: Record<string, $util.Input<string>> = {
+    QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)),
+  };
+
+  if (bus) {
+    environment.EVENT_BUS_NAME = bus.name;
+  }
 
   table.subscribe(
     'EventStoreTableStream',
     {
-      handler: handlerPath,
-      link: [bus, ...listenerQueues],
-      environment: {
-        QUEUE_URL_LIST: $jsonStringify(listenerQueues.map((queue) => queue.url)),
-      },
+      handler,
+      link: [...(bus ? [bus] : []), ...listenerQueues],
+      environment,
     },
     {
       filters: [

package/src/event-queue.ts

@@ -0,0 +1,38 @@
+export interface CreateEventQueueOptions {
+  batchSize?: number;
+  visibilityTimeout?: string;
+  dlqRetries?: number;
+}
+
+export function createEventQueue(
+  name: string,
+  subscriber: {
+    handler: string;
+    [key: string]: unknown;
+  },
+  options?: CreateEventQueueOptions,
+): { queue: sst.aws.Queue; dlq: sst.aws.Queue } {
+  const { batchSize = 10, visibilityTimeout = '30 seconds', dlqRetries = 1 } = options ?? {};
+
+  const dlq = new sst.aws.Queue(`${name}DLQ`, {
+    fifo: true,
+  });
+
+  const queue = new sst.aws.Queue(name, {
+    fifo: true,
+    visibilityTimeout,
+    dlq: {
+      queue: dlq.arn,
+      retry: dlqRetries,
+    },
+  });
+
+  queue.subscribe(subscriber, {
+    batch: {
+      size: batchSize,
+      partialResponses: true,
+    },
+  });
+
+  return { queue, dlq };
+}

package/src/index.ts

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