@itzworking/events-manager 0.0.94

package/README.md

@@ -0,0 +1,15 @@
+# ItzWorking (AWS Serverless, Next.js, TypeScript)
+
+> **ItzWorking because you built it!**
+
+Framework for building AWS Serverless applications with Next.js and TypeScript.
+
+- [Intro](#intro)
+- [Key features](#key-features)
+- [Usage](#usage)
+
+## Intro
+
+## Key features
+
+## Usage

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@itzworking/events-manager",
+  "version": "0.0.94",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-eventbridge": "3.x",
+    "@itzworking/decorated-class": "0.0.94",
+    "@itzworking/powertools": "0.0.94",
+    "uuid": "10.x"
+  },
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts"
+}

package/src/application-event-metadata.d.ts

@@ -0,0 +1,6 @@
+import { DecoratedClass } from "@itzworking/decorated-class";
+export declare class ApplicationEventMetadata extends DecoratedClass {
+    idempotencyKey: string;
+    createdAt: number;
+    constructor(props?: any);
+}

package/src/application-event-metadata.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationEventMetadata = void 0;
+const decorated_class_1 = require("@itzworking/decorated-class");
+const uuid_1 = require("uuid");
+class ApplicationEventMetadata extends decorated_class_1.DecoratedClass {
+    constructor(props) {
+        super(props);
+        if (!(props === null || props === void 0 ? void 0 : props.idempotencyKey)) {
+            this.idempotencyKey = (0, uuid_1.v4)();
+        }
+        if (!(props === null || props === void 0 ? void 0 : props.createdAt)) {
+            this.createdAt = Date.now();
+        }
+    }
+}
+exports.ApplicationEventMetadata = ApplicationEventMetadata;
+//# sourceMappingURL=application-event-metadata.js.map

package/src/application-event-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-event-metadata.js","sourceRoot":"","sources":["../../../../libs/events-manager/src/application-event-metadata.ts"],"names":[],"mappings":";;;AAAA,iEAA6D;AAC7D,+BAAkC;AAElC,MAAa,wBAAyB,SAAQ,gCAAc;IAI1D,YAAY,KAAW;QACrB,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,cAAc,CAAA,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,IAAA,SAAI,GAAE,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS,CAAA,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;CACF;AAbD,4DAaC"}

package/src/application-event.d.ts

@@ -0,0 +1,7 @@
+import { DecoratedClass } from "@itzworking/decorated-class";
+import { ApplicationEventMetadata } from "./application-event-metadata";
+export declare class ApplicationEvent<T extends DecoratedClass> extends DecoratedClass {
+    metadata: ApplicationEventMetadata;
+    body?: T;
+    constructor(props?: any);
+}

package/src/application-event.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationEvent = void 0;
+const tslib_1 = require("tslib");
+const decorated_class_1 = require("@itzworking/decorated-class");
+const application_event_metadata_1 = require("./application-event-metadata");
+class ApplicationEvent extends decorated_class_1.DecoratedClass {
+    constructor(props) {
+        super(props);
+        this.metadata = new application_event_metadata_1.ApplicationEventMetadata(props === null || props === void 0 ? void 0 : props.metadata);
+    }
+}
+exports.ApplicationEvent = ApplicationEvent;
+tslib_1.__decorate([
+    decorated_class_1.NotNull,
+    (0, decorated_class_1.Attribute)(decorated_class_1.AttributeType.Object, { nestedType: application_event_metadata_1.ApplicationEventMetadata }),
+    tslib_1.__metadata("design:type", application_event_metadata_1.ApplicationEventMetadata)
+], ApplicationEvent.prototype, "metadata", void 0);
+tslib_1.__decorate([
+    (0, decorated_class_1.Attribute)(decorated_class_1.AttributeType.Object),
+    tslib_1.__metadata("design:type", Object)
+], ApplicationEvent.prototype, "body", void 0);
+//# sourceMappingURL=application-event.js.map

package/src/application-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-event.js","sourceRoot":"","sources":["../../../../libs/events-manager/src/application-event.ts"],"names":[],"mappings":";;;;AAAA,iEAKqC;AACrC,6EAAwE;AAExE,MAAa,gBAA2C,SAAQ,gCAAc;IAQ5E,YAAY,KAAW;QACrB,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,IAAI,qDAAwB,CAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,QAAQ,CAAC,CAAC;IAChE,CAAC;CACF;AAZD,4CAYC;AATC;IAFC,yBAAO;IACP,IAAA,2BAAS,EAAC,+BAAa,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,qDAAwB,EAAE,CAAC;sCAChE,qDAAwB;kDAAC;AAGnC;IADC,IAAA,2BAAS,EAAC,+BAAa,CAAC,MAAM,CAAC;;8CACvB"}

package/src/errors/index.d.ts

@@ -0,0 +1 @@
+export * from "./missing-environment-variables-error";

package/src/errors/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./missing-environment-variables-error"), exports);
+//# sourceMappingURL=index.js.map

package/src/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/events-manager/src/errors/index.ts"],"names":[],"mappings":";;;AAAA,gFAAsD"}

package/src/errors/missing-environment-variables-error.d.ts

@@ -0,0 +1,3 @@
+export declare class MissingEnvironmentVariablesError extends Error {
+    constructor(missingEnvironmentVariables: string[]);
+}

package/src/errors/missing-environment-variables-error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingEnvironmentVariablesError = void 0;
+class MissingEnvironmentVariablesError extends Error {
+    constructor(missingEnvironmentVariables) {
+        super(JSON.stringify({
+            name: "MissingEnvironmentVariablesError",
+            message: `Missing environment variables: ${missingEnvironmentVariables.join(", ")}`,
+        }));
+        this.name = "MissingEnvironmentVariablesError";
+    }
+}
+exports.MissingEnvironmentVariablesError = MissingEnvironmentVariablesError;
+//# sourceMappingURL=missing-environment-variables-error.js.map

package/src/errors/missing-environment-variables-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-environment-variables-error.js","sourceRoot":"","sources":["../../../../../libs/events-manager/src/errors/missing-environment-variables-error.ts"],"names":[],"mappings":";;;AAAA,MAAa,gCAAiC,SAAQ,KAAK;IACzD,YAAY,2BAAqC;QAC/C,KAAK,CACH,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,kCAAkC;YACxC,OAAO,EAAE,kCAAkC,2BAA2B,CAAC,IAAI,CACzE,IAAI,CACL,EAAE;SACJ,CAAC,CACH,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAZD,4EAYC"}

package/src/eventbridge/eventbridge.d.ts

@@ -0,0 +1,2 @@
+import { EventBridgeClient } from "@aws-sdk/client-eventbridge";
+export declare const eventbridge: EventBridgeClient;

package/src/eventbridge/eventbridge.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventbridge = void 0;
+const client_eventbridge_1 = require("@aws-sdk/client-eventbridge");
+exports.eventbridge = new client_eventbridge_1.EventBridgeClient({});
+//# sourceMappingURL=eventbridge.js.map

package/src/eventbridge/eventbridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbridge.js","sourceRoot":"","sources":["../../../../../libs/events-manager/src/eventbridge/eventbridge.ts"],"names":[],"mappings":";;;AAAA,oEAAgE;AAEnD,QAAA,WAAW,GAAG,IAAI,sCAAiB,CAAC,EAAE,CAAC,CAAC"}

package/src/eventbridge/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./eventbridge";
+export * from "./put-eb-events";

package/src/eventbridge/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./eventbridge"), exports);
+tslib_1.__exportStar(require("./put-eb-events"), exports);
+//# sourceMappingURL=index.js.map

package/src/eventbridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/events-manager/src/eventbridge/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAE9B,0DAAgC"}

package/src/eventbridge/put-eb-events.d.ts

@@ -0,0 +1,2 @@
+import { PutEventsCommandInput } from "@aws-sdk/client-eventbridge";
+export declare const putEbEvents: (input: PutEventsCommandInput) => Promise<import("@aws-sdk/client-eventbridge").PutEventsCommandOutput>;

package/src/eventbridge/put-eb-events.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.putEbEvents = void 0;
+const tslib_1 = require("tslib");
+const powertools_1 = require("@itzworking/powertools");
+const client_eventbridge_1 = require("@aws-sdk/client-eventbridge");
+const eventbridge_1 = require("./eventbridge");
+const putEbEvents = (input) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    powertools_1.logger.debug({
+        message: "send eventbridge PutEventsCommand",
+        awsService: "eventbridge",
+        action: "PutEventsCommand",
+        input,
+    });
+    try {
+        return eventbridge_1.eventbridge.send(new client_eventbridge_1.PutEventsCommand(input));
+    }
+    catch (error) {
+        powertools_1.logger.error({
+            message: "send eventbridge PutEventsCommand",
+            awsService: "eventbridge",
+            action: "PutEventsCommand",
+            input,
+            error,
+        });
+        throw error;
+    }
+});
+exports.putEbEvents = putEbEvents;
+//# sourceMappingURL=put-eb-events.js.map

package/src/eventbridge/put-eb-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"put-eb-events.js","sourceRoot":"","sources":["../../../../../libs/events-manager/src/eventbridge/put-eb-events.ts"],"names":[],"mappings":";;;;AAAA,uDAAgD;AAChD,oEAGqC;AACrC,+CAA4C;AAErC,MAAM,WAAW,GAAG,CAAO,KAA4B,EAAE,EAAE;IAChE,mBAAM,CAAC,KAAK,CAAC;QACX,OAAO,EAAE,mCAAmC;QAC5C,UAAU,EAAE,aAAa;QACzB,MAAM,EAAE,kBAAkB;QAC1B,KAAK;KACN,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,yBAAW,CAAC,IAAI,CAAC,IAAI,qCAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mBAAM,CAAC,KAAK,CAAC;YACX,OAAO,EAAE,mCAAmC;YAC5C,UAAU,EAAE,aAAa;YACzB,MAAM,EAAE,kBAAkB;YAC1B,KAAK;YACL,KAAK;SACN,CAAC,CAAC;QACH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAA,CAAC;AAnBW,QAAA,WAAW,eAmBtB"}

package/src/events-manager.d.ts

@@ -0,0 +1,10 @@
+import { DecoratedClass } from "@itzworking/decorated-class";
+declare class EventsManagerClass {
+    readonly serviceName: string;
+    readonly eventBusName: string;
+    readonly eventSource: string;
+    constructor();
+    publishEvent<T extends DecoratedClass>(entityClass: new (props?: any) => T, eventName: string, body: T): Promise<import("@aws-sdk/client-eventbridge").PutEventsCommandOutput>;
+}
+export declare const EventsManager: EventsManagerClass;
+export {};

package/src/events-manager.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventsManager = void 0;
+const tslib_1 = require("tslib");
+const decorated_class_1 = require("@itzworking/decorated-class");
+const powertools_1 = require("@itzworking/powertools");
+const application_event_1 = require("./application-event");
+const eventbridge_1 = require("./eventbridge");
+const errors_1 = require("./errors");
+class EventsManagerClass {
+    constructor() {
+        this.serviceName = process.env.SERVICE_NAME || "";
+        this.eventBusName = process.env.EVENT_BUS_NAME || "";
+        this.eventSource = process.env.NAMESPACE || "";
+        const missingEnvironmentVariables = [];
+        if (!this.serviceName) {
+            missingEnvironmentVariables.push("SERVICE_NAME");
+        }
+        if (!this.eventBusName) {
+            missingEnvironmentVariables.push("EVENT_BUS_NAME");
+        }
+        if (!this.eventSource) {
+            missingEnvironmentVariables.push("NAMESPACE");
+        }
+        if (missingEnvironmentVariables.length > 0) {
+            powertools_1.logger.error("Missing environment variables", {
+                missing: missingEnvironmentVariables,
+            });
+            throw new errors_1.MissingEnvironmentVariablesError(missingEnvironmentVariables);
+        }
+        powertools_1.logger.debug("EventsManager initialized", {
+            serviceName: this.serviceName,
+            eventBusName: this.eventBusName,
+            eventSource: this.eventSource,
+        });
+    }
+    publishEvent(entityClass, eventName, body) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            powertools_1.logger.debug("Publishing event", {
+                eventName,
+                entityClass: entityClass.name,
+            });
+            const applicationEvent = new application_event_1.ApplicationEvent({
+                body: body instanceof entityClass ? body : new entityClass(body),
+            });
+            try {
+                decorated_class_1.validator.validate(applicationEvent);
+                const events = {
+                    Entries: [
+                        {
+                            Detail: JSON.stringify(applicationEvent),
+                            DetailType: `${this.serviceName}.${eventName}`,
+                            Source: this.eventSource,
+                            EventBusName: this.eventBusName,
+                        },
+                    ],
+                };
+                powertools_1.logger.debug("Sending event to EventBridge", {
+                    detailType: events.Entries[0].DetailType,
+                    eventBusName: this.eventBusName,
+                });
+                const result = yield (0, eventbridge_1.putEbEvents)(events);
+                powertools_1.logger.info("Event published successfully", {
+                    eventName,
+                    detailType: events.Entries[0].DetailType,
+                });
+                return result;
+            }
+            catch (error) {
+                powertools_1.logger.error("Failed to publish event", {
+                    eventName,
+                    error: error.message,
+                    entityClass: entityClass.name,
+                });
+                throw error;
+            }
+        });
+    }
+}
+exports.EventsManager = new EventsManagerClass();
+//# sourceMappingURL=events-manager.js.map

package/src/events-manager.js.map

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

package/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./errors";
+export * from "./eventbridge";
+export * from "./application-event-metadata";
+export * from "./application-event";
+export * from "./events-manager";

package/src/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./errors"), exports);
+tslib_1.__exportStar(require("./eventbridge"), exports);
+tslib_1.__exportStar(require("./application-event-metadata"), exports);
+tslib_1.__exportStar(require("./application-event"), exports);
+tslib_1.__exportStar(require("./events-manager"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/events-manager/src/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,wDAA8B;AAE9B,uEAA6C;AAC7C,8DAAoC;AACpC,2DAAiC"}