@bgord/bun 0.18.21 → 0.18.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.18.21",
+  "version": "0.18.24",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -26,7 +26,7 @@
     "@types/bun": "1.2.20",
     "@types/lodash": "4.17.20",
     "@types/mime-types": "3.0.1",
-    "@types/nodemailer": "6.4.17",
+    "@types/nodemailer": "7.0.0",
     "@types/yazl": "3.3.0",
     "cspell": "9.2.0",
     "knip": "5.62.0",
@@ -37,13 +37,13 @@
   },
   "dependencies": {
     "@axiomhq/winston": "1.3.1",
-    "@bgord/tools": "0.12.10",
+    "@bgord/tools": "0.12.11",
     "@hono/ua-blocker": "0.1.7",
     "better-auth": "1.3.6",
     "check-disk-space": "3.4.0",
     "croner": "9.1.0",
     "hcaptcha": "0.2.0",
-    "hono": "4.9.1",
+    "hono": "4.9.2",
     "lodash": "4.17.21",
     "mime-types": "3.0.1",
     "node-cache": "5.1.2",

package/readme.md

@@ -67,6 +67,24 @@ src/
 ├── logger.service.ts
 ├── mailer.port.ts
 ├── memory-consumption.service.ts
+├── modules
+│   └── history
+│       ├── event-handlers
+│       │   ├── onHistoryClearedEvent.ts
+│       │   └── onHistoryPopulatedEvent.ts
+│       ├── events
+│       │   ├── HISTORY_CLEARED_EVENT.ts
+│       │   ├── HISTORY_POPULATED_EVENT.ts
+│       ├── repositories
+│       │   ├── history-repository.ts
+│       ├── services
+│       │   ├── history-writer.ts
+│       └── value-objects
+│           ├── history-id.ts
+│           ├── history-operation.ts
+│           ├── history-payload.ts
+│           ├── history-subject.ts
+│           ├── history.ts
 ├── node-cache-rate-limit-store.adapter.ts
 ├── node-env.vo.ts
 ├── noop-mailer.adapter.ts
@@ -101,6 +119,7 @@ src/
 ├── simulated-error.middleware.ts
 ├── sitemap.service.ts
 ├── slower.middleware.ts
+├── smtp-mailer-with-mailer.adapter.ts
 ├── smtp-mailer.adapter.ts
 ├── time-zone-offset.middleware.ts
 ├── to-event-map.types.ts

package/src/index.ts

@@ -40,6 +40,7 @@ export * from "./jobs.service";
 export * from "./logger.service";
 export * from "./mailer.port";
 export * from "./memory-consumption.service";
+export * as History from "./modules/history";
 export * from "./node-cache-rate-limit-store.adapter";
 export * from "./node-env.vo";
 export * from "./noop-mailer.adapter";
@@ -56,6 +57,7 @@ export * from "./simulated-error.middleware";
 export * from "./sitemap.service";
 export * from "./slower.middleware";
 export * from "./smtp-mailer.adapter";
+export * from "./smtp-mailer-with-mailer.adapter";
 export * from "./time-zone-offset.middleware";
 export * from "./to-event-map.types";
 export * from "./translations.service";

package/src/modules/history/event-handlers/index.ts

@@ -0,0 +1,2 @@
+export * from "./onHistoryClearedEvent";
+export * from "./onHistoryPopulatedEvent";

package/src/modules/history/event-handlers/onHistoryClearedEvent.ts

@@ -0,0 +1,7 @@
+import * as Events from "../events";
+import * as Repos from "../repositories";
+
+export const onHistoryClearedEvent =
+  (repository: Repos.HistoryRepositoryPort) => async (event: Events.HistoryClearedEventType) => {
+    await repository.clear(event.payload.subject);
+  };

package/src/modules/history/event-handlers/onHistoryPopulatedEvent.ts

@@ -0,0 +1,9 @@
+import * as Events from "../events";
+import * as Repos from "../repositories";
+import * as VO from "../value-objects";
+
+export const onHistoryPopulatedEvent =
+  (repository: Repos.HistoryRepositoryPort) => async (event: Events.HistoryPopulatedEventType) => {
+    const data = VO.HistoryParsed.parse(event.payload);
+    await repository.append(data, event.createdAt);
+  };

package/src/modules/history/events/HISTORY_CLEARED_EVENT.ts

@@ -0,0 +1,19 @@
+import * as tools from "@bgord/tools";
+import { z } from "zod/v4";
+import { UUID } from "../../../uuid.vo";
+import * as VO from "../value-objects";
+
+export const HISTORY_CLEARED_EVENT = "HISTORY_CLEARED_EVENT";
+
+export const HistoryClearedEvent = z.object({
+  id: UUID,
+  correlationId: UUID,
+  createdAt: tools.Timestamp,
+  stream: z.string().min(1),
+  name: z.literal(HISTORY_CLEARED_EVENT),
+  version: z.literal(1),
+  revision: tools.RevisionValue.optional(),
+  payload: z.object({ subject: VO.HistorySubject }),
+});
+
+export type HistoryClearedEventType = z.infer<typeof HistoryClearedEvent>;

package/src/modules/history/events/HISTORY_POPULATED_EVENT.ts

@@ -0,0 +1,23 @@
+import * as tools from "@bgord/tools";
+import { z } from "zod/v4";
+import { UUID } from "../../../uuid.vo";
+import * as VO from "../value-objects";
+
+export const HISTORY_POPULATED_EVENT = "HISTORY_POPULATED_EVENT";
+
+export const HistoryPopulatedEvent = z.object({
+  id: UUID,
+  correlationId: UUID,
+  createdAt: tools.Timestamp,
+  stream: z.string().min(1),
+  name: z.literal(HISTORY_POPULATED_EVENT),
+  version: z.literal(1),
+  revision: tools.RevisionValue.optional(),
+  payload: z.object({
+    id: VO.HistoryId,
+    operation: VO.HistoryOperation,
+    subject: VO.HistorySubject,
+    payload: VO.HistoryPayload,
+  }),
+});
+export type HistoryPopulatedEventType = z.infer<typeof HistoryPopulatedEvent>;

package/src/modules/history/events/index.ts

@@ -0,0 +1,2 @@
+export * from "./HISTORY_CLEARED_EVENT";
+export * from "./HISTORY_POPULATED_EVENT";

package/src/modules/history/index.ts

@@ -0,0 +1,6 @@
+// TODO: tests
+export * as EventHandlers from "./event-handlers";
+export * as Events from "./events";
+export * as Repos from "./repositories";
+export * as Services from "./services";
+export * as VO from "./value-objects";

package/src/modules/history/repositories/history-repository.ts

@@ -0,0 +1,8 @@
+import * as tools from "@bgord/tools";
+import * as VO from "../value-objects";
+
+export interface HistoryRepositoryPort {
+  append(data: VO.HistoryParsedType, createdAt: tools.TimestampType): Promise<void>;
+
+  clear(subject: VO.HistoryParsedType["subject"]): Promise<void>;
+}

package/src/modules/history/repositories/index.ts

@@ -0,0 +1 @@
+export * from "./history-repository";

package/src/modules/history/services/history-writer.ts

@@ -0,0 +1,6 @@
+import * as VO from "../value-objects";
+
+export interface HistoryWriterPort {
+  populate(history: Omit<VO.HistoryType, "id">): Promise<void>;
+  clear(subject: VO.HistorySubjectType): Promise<void>;
+}

package/src/modules/history/services/index.ts

@@ -0,0 +1 @@
+export * from "./history-writer";

package/src/modules/history/value-objects/history-id.ts

@@ -0,0 +1,3 @@
+import { UUID } from "../../../uuid.vo";
+
+export const HistoryId = UUID;

package/src/modules/history/value-objects/history-operation.ts

@@ -0,0 +1,3 @@
+import { z } from "zod/v4";
+
+export const HistoryOperation = z.string().min(1).max(128).trim();

package/src/modules/history/value-objects/history-payload.ts

@@ -0,0 +1,12 @@
+import { z } from "zod/v4";
+
+export const HistoryPayload = z.record(z.string(), z.any());
+
+export const HistoryPayloadParsed = HistoryPayload.refine((value) => {
+  try {
+    JSON.parse(JSON.stringify(value));
+    return true;
+  } catch (error) {
+    return false;
+  }
+}).transform((value) => JSON.stringify(value));

package/src/modules/history/value-objects/history-subject.ts

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+
+export const HistorySubject = z.string().min(1).max(128).trim();
+export type HistorySubjectType = z.infer<typeof HistorySubject>;

package/src/modules/history/value-objects/history.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+import { HistoryId } from "./history-id";
+import { HistoryOperation } from "./history-operation";
+import { HistoryPayload, HistoryPayloadParsed } from "./history-payload";
+import { HistorySubject } from "./history-subject";
+
+const History = z.object({
+  id: HistoryId,
+  operation: HistoryOperation,
+  payload: HistoryPayload,
+  subject: HistorySubject,
+});
+
+export type HistoryType = z.infer<typeof History>;
+
+export const HistoryParsed = z.object({
+  id: HistoryId,
+  operation: HistoryOperation,
+  payload: HistoryPayloadParsed,
+  subject: HistorySubject,
+});
+
+export type HistoryParsedType = z.infer<typeof HistoryParsed>;

package/src/modules/history/value-objects/index.ts

@@ -0,0 +1,5 @@
+export * from "./history";
+export * from "./history-id";
+export * from "./history-operation";
+export * from "./history-payload";
+export * from "./history-subject";

package/src/smtp-mailer-with-mailer.adapter.ts

@@ -0,0 +1,43 @@
+import { SendMailOptions } from "nodemailer";
+import { Logger } from "./logger.service";
+import { MailerPort } from "./mailer.port";
+import { SmtpMailerAdapter } from "./smtp-mailer.adapter";
+
+type MailerSendOptionsType = SendMailOptions;
+
+type SmtpMailerWithLoggerConfigType = {
+  smtpMailer: SmtpMailerAdapter;
+  logger: Logger;
+};
+
+export class SmtpMailerWithLoggerAdapter implements MailerPort {
+  constructor(private readonly config: SmtpMailerWithLoggerConfigType) {}
+
+  async send(message: MailerSendOptionsType): Promise<unknown> {
+    try {
+      this.config.logger.info({ message: "Mailer attempt", operation: "mailer", metadata: message });
+
+      const result = await this.config.smtpMailer.send(message);
+
+      this.config.logger.info({
+        message: "Mailer success",
+        operation: "mailer",
+        metadata: { message, result },
+      });
+
+      return result;
+    } catch (error) {
+      this.config.logger.error({
+        message: "Mailer error",
+        operation: "mailer",
+        metadata: this.config.logger.formatError(error),
+      });
+
+      throw error;
+    }
+  }
+
+  async verify() {
+    return this.config.smtpMailer.verify();
+  }
+}

package/src/smtp-mailer.adapter.ts

@@ -56,10 +56,7 @@ export class SmtpMailerAdapter implements MailerPort {
     this.transport = nodemailer.createTransport({
       host: config.SMTP_HOST,
       port: config.SMTP_PORT,
-      auth: {
-        user: config.SMTP_USER,
-        pass: config.SMTP_PASS,
-      },
+      auth: { user: config.SMTP_USER, pass: config.SMTP_PASS },
     });
   }