@bgord/bun 0.18.22 → 0.18.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.18.22",
+  "version": "0.18.25",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -38,8 +38,8 @@
   "dependencies": {
     "@axiomhq/winston": "1.3.1",
     "@bgord/tools": "0.12.11",
-    "@hono/ua-blocker": "0.1.7",
-    "better-auth": "1.3.6",
+    "@hono/ua-blocker": "0.1.8",
+    "better-auth": "1.3.7",
     "check-disk-space": "3.4.0",
     "croner": "9.1.0",
     "hcaptcha": "0.2.0",

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
+│       ├── ports
+│       │   ├── history-projection.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

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";

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 Ports from "../ports";
+
+export const onHistoryClearedEvent =
+  (projection: Ports.HistoryProjectionPort) => async (event: Events.HistoryClearedEventType) => {
+    await projection.clear(event.payload.subject);
+  };

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

@@ -0,0 +1,9 @@
+import * as Events from "../events";
+import * as Ports from "../ports";
+import * as VO from "../value-objects";
+
+export const onHistoryPopulatedEvent =
+  (projection: Ports.HistoryProjectionPort) => async (event: Events.HistoryPopulatedEventType) => {
+    const data = VO.HistoryParsed.parse(event.payload);
+    await projection.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 Ports from "./ports";
+export * as Services from "./services";
+export * as VO from "./value-objects";

package/src/modules/history/ports/history-projection.ts

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

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

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

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";