@bgord/bun 0.19.6 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.19.6",
+  "version": "0.20.0",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@axiomhq/winston": "1.3.1",
-    "@bgord/tools": "0.12.11",
+    "@bgord/tools": "0.12.12",
     "@hono/ua-blocker": "0.1.8",
     "better-auth": "1.3.7",
     "check-disk-space": "3.4.0",

package/readme.md

@@ -48,6 +48,7 @@ src/
 ├── event-handler.service.ts
 ├── event-logger.service.ts
 ├── event-publisher.types.ts
+├── event-store-like.types.ts
 ├── event-store.ts
 ├── event-stream.vo.ts
 ├── event.types.ts
@@ -72,23 +73,38 @@ src/
 ├── mailer.port.ts
 ├── memory-consumption.service.ts
 ├── modules
-│   └── history
-│       ├── event-handlers
-│       │   ├── onHistoryClearedEvent.ts
-│       │   └── onHistoryPopulatedEvent.ts
+│   ├── history
+│   │   ├── event-handlers
+│   │   │   ├── onHistoryClearedEvent.ts
+│   │   │   └── onHistoryPopulatedEvent.ts
+│   │   ├── events
+│   │   │   ├── HISTORY_CLEARED_EVENT.ts
+│   │   │   ├── HISTORY_POPULATED_EVENT.ts
+│   │   ├── ports
+│   │   │   ├── history-projection.ts
+│   │   │   ├── history-writer.ts
+│   │   └── value-objects
+│   │       ├── history-id.ts
+│   │       ├── history-operation.ts
+│   │       ├── history-payload.ts
+│   │       ├── history-subject.ts
+│   │       ├── history.ts
+│   └── preferences
+│       ├── command-handlers
+│       │   ├── handleSetUserLanguageCommand.ts
+│       ├── commands
+│       │   ├── SET_USER_LANGUAGE_COMMAND.ts
 │       ├── events
-│       │   ├── HISTORY_CLEARED_EVENT.ts
-│       │   ├── HISTORY_POPULATED_EVENT.ts
+│       │   ├── USER_LANGUAGE_SET_EVENT.ts
+│       ├── invariants
+│       │   └── user-language-has-changed.ts
+│       ├── open-host-queries
+│       │   └── user-language.ts
 │       ├── ports
-│       │   ├── history-projection.ts
-│       ├── services
-│       │   ├── history-writer.ts
+│       │   ├── user-language-query.ts
+│       │   └── user-language-resolver.ts
 │       └── value-objects
-│           ├── history-id.ts
-│           ├── history-operation.ts
-│           ├── history-payload.ts
-│           ├── history-subject.ts
-│           ├── history.ts
+│           └── supported-languages-set.ts
 ├── node-env.vo.ts
 ├── open-graph.service.ts
 ├── path.vo.ts

package/src/event-store-like.types.ts

@@ -0,0 +1,4 @@
+export type EventStoreLike<E extends { name: string }> = {
+  save(events: E[]): Promise<unknown>;
+  saveAfter(events: E[], delay: { ms: number }): Promise<unknown>;
+};

package/src/index.ts

@@ -23,6 +23,7 @@ export * from "./event-envelope";
 export * from "./event-handler.service";
 export * from "./event-logger.service";
 export * from "./event-store";
+export * from "./event-store-like.types";
 export * from "./event-stream.vo";
 export * from "./file-draft.service";
 export * from "./file-draft-zip.service";
@@ -45,6 +46,7 @@ export * from "./mailer-smtp.adapter";
 export * from "./mailer-smtp-with-logger.adapter";
 export * from "./memory-consumption.service";
 export * as History from "./modules/history";
+export * as Preferences from "./modules/preferences";
 export * from "./node-env.vo";
 export * from "./open-graph.service";
 export * from "./path.vo";

package/src/modules/history/index.ts

@@ -1,6 +1,4 @@
-// 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/index.ts

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

package/src/modules/preferences/command-handlers/handleSetUserLanguageCommand.ts

@@ -0,0 +1,31 @@
+import type * as tools from "@bgord/tools";
+import { createEventEnvelope } from "../../../event-envelope";
+import type { EventStoreLike } from "../../../event-store-like.types";
+import type * as Commands from "../commands";
+import * as Events from "../events";
+import * as Invariants from "../invariants";
+import type * as Ports from "../ports";
+import type * as VO from "../value-objects";
+
+type AcceptedEvent = Events.UserLanguageSetEventType;
+
+export const handleSetUserLanguageCommand =
+  <L extends readonly tools.LanguageType[]>(
+    EventStore: EventStoreLike<AcceptedEvent>,
+    query: Ports.UserLanguageQueryPort,
+    supported: VO.SupportedLanguagesSet<L>,
+  ) =>
+  async (command: Commands.SetUserLanguageCommandType) => {
+    const candidate = supported.ensure(command.payload.language);
+    const current = await query.get(command.payload.userId);
+
+    if (Invariants.UserLanguageHasChanged.fails({ current, candidate: command.payload.language })) return;
+
+    const event = Events.UserLanguageSetEvent.parse({
+      ...createEventEnvelope(`preferences_${command.payload.userId}`),
+      name: Events.USER_LANGUAGE_SET_EVENT,
+      payload: { userId: command.payload.userId, language: candidate },
+    } satisfies Events.UserLanguageSetEventType);
+
+    await EventStore.save([event]);
+  };

package/src/modules/preferences/command-handlers/index.ts

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

package/src/modules/preferences/commands/SET_USER_LANGUAGE_COMMAND.ts

@@ -0,0 +1,14 @@
+import * as tools from "@bgord/tools";
+import { z } from "zod/v4";
+import { CommandEnvelopeSchema } from "../../../command-envelope";
+import { UUID } from "../../../uuid.vo";
+
+export const SET_USER_LANGUAGE_COMMAND = "SET_USER_LANGUAGE_COMMAND";
+
+export const SetUserLanguageCommand = z.object({
+  ...CommandEnvelopeSchema,
+  name: z.literal(SET_USER_LANGUAGE_COMMAND),
+  payload: z.object({ language: tools.Language, userId: UUID }),
+});
+
+export type SetUserLanguageCommandType = z.infer<typeof SetUserLanguageCommand>;

package/src/modules/preferences/commands/index.ts

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

package/src/modules/preferences/events/USER_LANGUAGE_SET_EVENT.ts

@@ -0,0 +1,14 @@
+import * as tools from "@bgord/tools";
+import { z } from "zod/v4";
+import { EventEnvelopeSchema } from "../../../event-envelope";
+import { UUID } from "../../../uuid.vo";
+
+export const USER_LANGUAGE_SET_EVENT = "USER_LANGUAGE_SET_EVENT";
+
+export const UserLanguageSetEvent = z.object({
+  ...EventEnvelopeSchema,
+  name: z.literal(USER_LANGUAGE_SET_EVENT),
+  payload: z.object({ userId: UUID, language: tools.Language }),
+});
+
+export type UserLanguageSetEventType = z.infer<typeof UserLanguageSetEvent>;

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

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

package/src/modules/preferences/index.ts

@@ -0,0 +1,7 @@
+export * as CommandHandlers from "./command-handlers";
+export * as Commands from "./commands";
+export * as Events from "./events";
+export * as Invariants from "./invariants";
+export * as OHQ from "./open-host-queries";
+export * as Ports from "./ports";
+export * as VO from "./value-objects";

package/src/modules/preferences/invariants/index.ts

@@ -0,0 +1 @@
+export * from "./user-language-has-changed";

package/src/modules/preferences/invariants/user-language-has-changed.ts

@@ -0,0 +1,30 @@
+import type * as tools from "@bgord/tools";
+import type { ContentfulStatusCode } from "hono/utils/http-status";
+import { Invariant } from "../../../invariant.service";
+
+class UserLanguageHasChangedError extends Error {
+  constructor() {
+    super();
+    Object.setPrototypeOf(this, UserLanguageHasChangedError.prototype);
+  }
+}
+
+type UserLanguageHasChangedConfigType = {
+  current?: tools.LanguageType | null;
+  candidate: tools.LanguageType;
+};
+
+class UserLanguageHasChangedFactory extends Invariant<UserLanguageHasChangedConfigType> {
+  fails(config: UserLanguageHasChangedConfigType) {
+    if (!config.current) return false;
+    return config.current === config.candidate;
+  }
+
+  message = "UserLanguageHasChanged";
+
+  error = UserLanguageHasChangedError;
+
+  code = 403 as ContentfulStatusCode;
+}
+
+export const UserLanguageHasChanged = new UserLanguageHasChangedFactory();

package/src/modules/preferences/open-host-queries/index.ts

@@ -0,0 +1 @@
+export * from "./user-language";

package/src/modules/preferences/open-host-queries/user-language.ts

@@ -0,0 +1,23 @@
+import type * as tools from "@bgord/tools";
+import type { UUIDType } from "../../../uuid.vo";
+import type * as Ports from "../ports";
+import type * as VO from "../value-objects";
+
+export interface UserLanguagePort<L extends readonly tools.LanguageType[]> {
+  get(userId: UUIDType): Promise<L[number]>;
+}
+
+export class UserLanguageAdapter<L extends readonly tools.LanguageType[]> implements UserLanguagePort<L> {
+  constructor(
+    private readonly query: Ports.UserLanguageQueryPort,
+    private readonly validator: VO.SupportedLanguagesSet<L>,
+    private readonly resolver: Ports.UserLanguageResolverPort,
+  ) {}
+
+  async get(userId: UUIDType): Promise<L[number]> {
+    const stored = await this.query.get(userId);
+    const candidate = await this.resolver.resolve(stored);
+
+    return this.validator.ensure(candidate);
+  }
+}

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

@@ -0,0 +1,2 @@
+export * from "./user-language-query";
+export * from "./user-language-resolver";

package/src/modules/preferences/ports/user-language-query.ts

@@ -0,0 +1,5 @@
+import type * as tools from "@bgord/tools";
+
+export interface UserLanguageQueryPort {
+  get(userId: tools.LanguageType): Promise<tools.LanguageType | null>;
+}

package/src/modules/preferences/ports/user-language-resolver.ts

@@ -0,0 +1,27 @@
+import type * as tools from "@bgord/tools";
+
+export interface UserLanguageResolverPort {
+  resolve(input: tools.LanguageType | null): tools.LanguageType | Promise<tools.LanguageType>;
+}
+
+export class UserLanguagePreferenceMissingError extends Error {
+  constructor() {
+    super();
+    Object.setPrototypeOf(this, UserLanguagePreferenceMissingError.prototype);
+  }
+}
+
+export class UserLanguageResolverThrowIfMissing implements UserLanguageResolverPort {
+  resolve(stored: tools.LanguageType | null) {
+    if (stored == null) throw new UserLanguagePreferenceMissingError();
+    return stored;
+  }
+}
+
+export class UserLanguageResolverSystemDefaultFallback implements UserLanguageResolverPort {
+  constructor(private readonly systemDefaultLanguage: tools.LanguageType) {}
+
+  resolve(stored: tools.LanguageType | null) {
+    return stored ?? this.systemDefaultLanguage;
+  }
+}

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

@@ -0,0 +1 @@
+export * from "./supported-languages-set";

package/src/modules/preferences/value-objects/supported-languages-set.ts

@@ -0,0 +1,23 @@
+import type * as tools from "@bgord/tools";
+
+export class UnsupportedLanguageError extends Error {
+  constructor() {
+    super();
+    Object.setPrototypeOf(this, UnsupportedLanguageError.prototype);
+  }
+}
+
+export class SupportedLanguagesSet<L extends readonly tools.LanguageType[]> {
+  private readonly index: Set<tools.LanguageType>;
+
+  constructor(allowed: L) {
+    this.index = new Set(allowed);
+    Object.freeze(this);
+  }
+
+  ensure(language: tools.LanguageType): L[number] {
+    if (!this.index.has(language)) throw new UnsupportedLanguageError();
+
+    return language as L[number];
+  }
+}

package/dist/modules/history/services/history-writer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"history-writer.d.ts","sourceRoot":"","sources":["../../../../src/modules/history/services/history-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD"}

package/dist/modules/history/services/history-writer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"history-writer.js","sourceRoot":"","sources":["../../../../src/modules/history/services/history-writer.ts"],"names":[],"mappings":""}

package/dist/modules/history/services/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./history-writer";
-//# sourceMappingURL=index.d.ts.map

package/dist/modules/history/services/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/history/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/modules/history/services/index.js

@@ -1,2 +0,0 @@
-export * from "./history-writer";
-//# sourceMappingURL=index.js.map

package/dist/modules/history/services/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/history/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

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

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