@apso/domain-events 0.1.0

package/dist/domain-events.module.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var DomainEventsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainEventsModule = void 0;
+const common_1 = require("@nestjs/common");
+const typeorm_1 = require("@nestjs/typeorm");
+const domain_event_entity_1 = require("./domain-event.entity");
+const domain_event_subscriber_1 = require("./domain-event.subscriber");
+const domain_event_relay_1 = require("./domain-event.relay");
+const domain_event_mapper_1 = require("./domain-event.mapper");
+const destinations_1 = require("./destinations");
+/**
+ * DomainEventsModule wires the durable domain-event spine (transactional-outbox
+ * pattern, surfaced as generic domain events).
+ *
+ * - {@link DomainEventSubscriber} writes events in-transaction with state changes.
+ * - {@link DomainEventRelay} drains and delivers pending events, with its own
+ *   self-contained poller (no external scheduler dependency).
+ * - {@link DOMAIN_EVENT_MAPPER} controls event-type/payload semantics; pass a
+ *   `mapper` to override.
+ * - {@link DOMAIN_EVENT_DESTINATIONS} is the set of ACTIVE delivery adapters,
+ *   built from the `EVENTS_DESTINATION` env var at runtime.
+ *
+ * MULTI-DATASOURCE: `@EventSubscriber()` auto-registers on the default
+ * DataSource; for additional named DataSources, register this module (or the
+ * subscriber) per DataSource.
+ */
+let DomainEventsModule = DomainEventsModule_1 = class DomainEventsModule {
+    static forRoot(options) {
+        const mapperProvider = options.mapper
+            ? { provide: domain_event_mapper_1.DOMAIN_EVENT_MAPPER, useClass: options.mapper }
+            : { provide: domain_event_mapper_1.DOMAIN_EVENT_MAPPER, useClass: domain_event_mapper_1.DefaultDomainEventMapper };
+        const providers = [
+            domain_event_subscriber_1.DomainEventSubscriber,
+            domain_event_relay_1.DomainEventRelay,
+            mapperProvider,
+            {
+                provide: domain_event_subscriber_1.DOMAIN_EVENT_ENTITIES,
+                useValue: options.entities ?? [],
+            },
+            {
+                provide: domain_event_relay_1.DOMAIN_EVENT_POLL_INTERVAL,
+                useValue: options.pollIntervalMs ?? domain_event_relay_1.DEFAULT_POLL_INTERVAL_MS,
+            },
+            {
+                provide: destinations_1.DOMAIN_EVENT_DESTINATIONS,
+                useFactory: () => (0, destinations_1.buildDestinations)(),
+            },
+        ];
+        return {
+            module: DomainEventsModule_1,
+            imports: [typeorm_1.TypeOrmModule.forFeature([domain_event_entity_1.DomainEvent])],
+            providers,
+            exports: [
+                domain_event_relay_1.DomainEventRelay,
+                domain_event_mapper_1.DOMAIN_EVENT_MAPPER,
+                destinations_1.DOMAIN_EVENT_DESTINATIONS,
+                domain_event_subscriber_1.DOMAIN_EVENT_ENTITIES,
+            ],
+        };
+    }
+};
+exports.DomainEventsModule = DomainEventsModule;
+exports.DomainEventsModule = DomainEventsModule = DomainEventsModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], DomainEventsModule);
+//# sourceMappingURL=domain-events.module.js.map

package/dist/domain-events.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-events.module.js","sourceRoot":"","sources":["../src/domain-events.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAA+E;AAC/E,6CAAgD;AAChD,+DAAoD;AACpD,uEAGmC;AACnC,6DAI8B;AAC9B,+DAI+B;AAC/B,iDAA8E;AA2B9E;;;;;;;;;;;;;;;GAeG;AAGI,IAAM,kBAAkB,0BAAxB,MAAM,kBAAkB;IAC7B,MAAM,CAAC,OAAO,CAAC,OAAkC;QAC/C,MAAM,cAAc,GAAa,OAAO,CAAC,MAAM;YAC7C,CAAC,CAAC,EAAE,OAAO,EAAE,yCAAmB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE;YAC5D,CAAC,CAAC,EAAE,OAAO,EAAE,yCAAmB,EAAE,QAAQ,EAAE,8CAAwB,EAAE,CAAC;QAEzE,MAAM,SAAS,GAAe;YAC5B,+CAAqB;YACrB,qCAAgB;YAChB,cAAc;YACd;gBACE,OAAO,EAAE,+CAAqB;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;aACjC;YACD;gBACE,OAAO,EAAE,+CAA0B;gBACnC,QAAQ,EAAE,OAAO,CAAC,cAAc,IAAI,6CAAwB;aAC7D;YACD;gBACE,OAAO,EAAE,wCAAyB;gBAClC,UAAU,EAAE,GAAG,EAAE,CAAC,IAAA,gCAAiB,GAAE;aACtC;SACF,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,oBAAkB;YAC1B,OAAO,EAAE,CAAC,uBAAa,CAAC,UAAU,CAAC,CAAC,iCAAW,CAAC,CAAC,CAAC;YAClD,SAAS;YACT,OAAO,EAAE;gBACP,qCAAgB;gBAChB,yCAAmB;gBACnB,wCAAyB;gBACzB,+CAAqB;aACtB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AApCY,gDAAkB;6BAAlB,kBAAkB;IAF9B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,kBAAkB,CAoC9B"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './domain-event.entity';
+export * from './domain-event.subscriber';
+export * from './domain-event.mapper';
+export * from './domain-event.relay';
+export * from './domain-events.module';
+export * from './destinations';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./domain-event.entity"), exports);
+__exportStar(require("./domain-event.subscriber"), exports);
+__exportStar(require("./domain-event.mapper"), exports);
+__exportStar(require("./domain-event.relay"), exports);
+__exportStar(require("./domain-events.module"), exports);
+__exportStar(require("./destinations"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C;AAC1C,wDAAsC;AACtC,uDAAqC;AACrC,yDAAuC;AACvC,iDAA+B"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@apso/domain-events",
+  "version": "0.1.0",
+  "description": "Durable domain-event spine (transactional outbox + runtime-selected delivery) for NestJS + TypeORM.",
+  "license": "MIT",
+  "author": "Apso",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "test": "jest",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=9 <12",
+    "@nestjs/core": ">=9 <12",
+    "@nestjs/typeorm": ">=9 <12",
+    "rxjs": ">=7",
+    "typeorm": ">=0.3"
+  },
+  "optionalDependencies": {
+    "@aws-sdk/client-eventbridge": "^3.0.0",
+    "@aws-sdk/client-sqs": "^3.0.0",
+    "@nestjs/microservices": "^10.0.0",
+    "kafkajs": "^2.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/typeorm": "^10.0.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typeorm": "^0.3.20"
+  },
+  "keywords": [
+    "apso",
+    "domain-events",
+    "outbox",
+    "nestjs",
+    "typeorm"
+  ]
+}