@bgord/bun 0.12.0 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -20,15 +20,15 @@
     "preinstall": "bunx only-allow bun"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.0.0",
+    "@biomejs/biome": "2.0.6",
     "@commitlint/cli": "19.8.1",
     "@commitlint/config-conventional": "19.8.1",
-    "@types/bun": "1.2.16",
-    "@types/lodash": "4.17.18",
+    "@types/bun": "1.2.17",
+    "@types/lodash": "4.17.19",
     "@types/mime-types": "3.0.1",
     "@types/nodemailer": "6.4.17",
-    "cspell": "9.1.1",
-    "knip": "5.61.2",
+    "cspell": "9.1.2",
+    "knip": "5.61.3",
     "lefthook": "1.11.14",
     "only-allow": "1.2.1",
     "shellcheck": "3.1.0",
@@ -36,10 +36,11 @@
   },
   "dependencies": {
     "@bgord/tools": "0.9.3",
+    "@hono/ua-blocker": "0.1.2",
     "check-disk-space": "3.4.0",
     "croner": "9.1.0",
     "hcaptcha": "0.2.0",
-    "hono": "4.8.0",
+    "hono": "4.8.3",
     "lodash": "4.17.21",
     "lucia": "3.2.2",
     "mime-types": "3.0.1",

package/src/bots.vo.ts

@@ -0,0 +1,3 @@
+export const BOTS_REGEX =
+  // cspell:disable-next-line
+  /(AI2BOT|AI2BOT-DOLMA|AIHITBOT|AMAZONBOT|ANDIBOT|ANTHROPIC-AI|APPLEBOT|APPLEBOT-EXTENDED|BEDROCKBOT|BRIGHTBOT 1.0|BYTESPIDER|CCBOT|CHATGPT-USER|CLAUDE-SEARCHBOT|CLAUDE-USER|CLAUDE-WEB|CLAUDEBOT|COHERE-AI|COHERE-TRAINING-DATA-CRAWLER|COTOYOGI|CRAWLSPACE|DIFFBOT|DUCKASSISTBOT|ECHOBOXBOT|FACEBOOKBOT|FACEBOOKEXTERNALHIT|FACTSET_SPYDERBOT|FIRECRAWLAGENT|FRIENDLYCRAWLER|GOOGLE-CLOUDVERTEXBOT|GOOGLE-EXTENDED|GOOGLEOTHER|GOOGLEOTHER-IMAGE|GOOGLEOTHER-VIDEO|GPTBOT|IASKSPIDER\/2.0|ICC-CRAWLER|IMAGESIFTBOT|IMG2DATASET|ISSCYBERRISKCRAWLER|KANGAROO BOT|META-EXTERNALAGENT|META-EXTERNALAGENT|META-EXTERNALFETCHER|META-EXTERNALFETCHER|MISTRALAI-USER\/1.0|MYCENTRALAISCRAPERBOT|NOVAACT|OAI-SEARCHBOT|OMGILI|OMGILIBOT|OPERATOR|PANGUBOT|PANSCIENT|PANSCIENT.COM|PERPLEXITY-USER|PERPLEXITYBOT|PETALBOT|PHINDBOT|POSEIDON RESEARCH CRAWLER|QUALIFIEDBOT|QUILLBOT|QUILLBOT.COM|SBINTUITIONSBOT|SCRAPY|SEMRUSHBOT|SEMRUSHBOT-BA|SEMRUSHBOT-CT|SEMRUSHBOT-OCOB|SEMRUSHBOT-SI|SEMRUSHBOT-SWA|SIDETRADE INDEXER BOT|TIKTOKSPIDER|TIMPIBOT|VELENPUBLICWEBCRAWLER|WEBZIO-EXTENDED|WPBOT|YANDEXADDITIONAL|YANDEXADDITIONALBOT|YOUBOT)/;

package/src/command-logger.ts

@@ -0,0 +1,24 @@
+import { Logger } from "./logger.service";
+
+export class CommandLogger {
+  constructor(private readonly logger: Logger) {}
+
+  private _handle(
+    type: string,
+    _debugName: string,
+    commandName: string | undefined,
+    commandData: Record<string, any> | undefined,
+  ) {
+    if (type === "subscribe") return;
+
+    if (typeof commandName === "symbol") return;
+
+    this.logger.info({
+      message: `${commandName} emitted`,
+      operation: "command_emitted",
+      metadata: commandData,
+    });
+  }
+
+  handle = this._handle.bind(this);
+}

package/src/command.types.ts

@@ -0,0 +1,15 @@
+import { z } from "zod/v4";
+
+export type GenericCommandSchema = z.ZodObject<{
+  id: z.ZodType<string>;
+  correlationId: z.ZodType<string>;
+  createdAt: z.ZodType<number>;
+  name: z.ZodLiteral<string>;
+  payload: z.ZodType<any>;
+}>;
+
+export type GenericParsedCommandSchema = z.ZodObject<
+  Omit<GenericCommandSchema["shape"], "payload"> & {
+    payload: z.ZodString;
+  }
+>;

package/src/correlation-id.vo.ts

@@ -2,6 +2,6 @@ import { z } from "zod/v4";
 
 import { UUID } from "./uuid.vo";
 
-export const CorrelationId = UUID.brand("CorrelationId");
+export const CorrelationId = UUID;
 
 export type CorrelationIdType = z.infer<typeof CorrelationId>;

package/src/correlation-storage.service.ts

@@ -0,0 +1,35 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createMiddleware } from "hono/factory";
+
+import type { CorrelationIdType } from "./correlation-id.vo";
+
+interface CorrelationContext {
+  correlationId: CorrelationIdType;
+}
+
+export class CorrelationStorage {
+  private static readonly GLOBAL_KEY = Symbol.for("bgord.CorrelationStorage");
+
+  // biome-ignore lint: lint/suspicious/noAssignInExpressions
+  private static readonly als: AsyncLocalStorage<CorrelationContext> = ((globalThis as any)[
+    this.GLOBAL_KEY
+  ] ??=
+    new AsyncLocalStorage<CorrelationContext>());
+
+  static run<T>(correlationId: CorrelationIdType, fn: () => T | Promise<T>): T | Promise<T> {
+    return CorrelationStorage.als.run({ correlationId }, fn);
+  }
+
+  static get(): CorrelationIdType {
+    const store = CorrelationStorage.als.getStore();
+    if (!store) throw new Error("CorrelationId missing from context");
+    return store.correlationId;
+  }
+
+  static handle = () =>
+    createMiddleware(async (c, next) => {
+      const correlationId = c.get("requestId");
+
+      return CorrelationStorage.run(correlationId, next);
+    });
+}

package/src/dispatching-event-store.ts

@@ -0,0 +1,28 @@
+import { z } from "zod/v4";
+import type { GenericEventSchema, GenericParsedEventSchema } from "./event.types";
+import type { EventPublisher } from "./event-publisher.types";
+import { EventStore as BaseStore } from "./event-store";
+import type { EventStreamType } from "./event-stream.vo";
+import { ToEventMap } from "./to-event-map.types";
+
+export class DispatchingEventStore<AllEvents extends GenericEventSchema> extends BaseStore<AllEvents> {
+  constructor(
+    config: {
+      finder: (stream: EventStreamType, names: string[]) => Promise<z.infer<GenericEventSchema>[]>;
+      inserter: (events: z.infer<GenericParsedEventSchema>[]) => Promise<void>;
+    },
+    private readonly publisher: EventPublisher<ToEventMap<z.infer<AllEvents>>>,
+  ) {
+    super(config);
+  }
+
+  async save(events: z.infer<AllEvents>[]) {
+    await super.save(events);
+
+    await Promise.all(
+      events.map((event) =>
+        this.publisher.emit(event.name as keyof ToEventMap<z.infer<AllEvents>>, event as any),
+      ),
+    );
+  }
+}

package/src/event-handler.service.ts

@@ -1,10 +1,11 @@
+import { z } from "zod/v4";
 import type { GenericEventSchema } from "./event.types";
 import { Logger } from "./logger.service";
 
 export class EventHandler {
   constructor(private readonly logger: Logger) {}
 
-  handle<T extends { name: GenericEventSchema["shape"]["name"] }>(fn: (event: T) => Promise<void>) {
+  handle<T extends { name: z.infer<GenericEventSchema["shape"]["name"]> }>(fn: (event: T) => Promise<void>) {
     return async (event: T) => {
       try {
         await fn(event);

package/src/event-publisher.types.ts

@@ -0,0 +1,3 @@
+export interface EventPublisher<EventMap extends Record<string, any>> {
+  emit<Name extends keyof EventMap>(name: Name, payload: EventMap[Name]): Promise<void>;
+}

package/src/event.types.ts

@@ -2,6 +2,7 @@ import { z } from "zod/v4";
 
 export type GenericEventSchema = z.ZodObject<{
   id: z.ZodType<string>;
+  correlationId: z.ZodType<string>;
   createdAt: z.ZodType<number>;
   stream: z.ZodString;
   name: z.ZodLiteral<string>;

package/src/index.ts

@@ -1,4 +1,5 @@
 export { default as sharp } from "sharp";
+
 export * from "./api-key-shield.middleware";
 export * from "./api-version.middleware";
 export * from "./auth-shield.middleware";
@@ -7,9 +8,13 @@ export * from "./build-info-repository.service";
 export * from "./cache-resolver.service";
 export * from "./cache-response.middleware";
 export * from "./cache-static-files.middleware";
+export * from "./command.types";
+export * from "./command-logger";
 export * from "./context.middleware";
 export * from "./correlation-id.vo";
+export * from "./correlation-storage.service";
 export * from "./decorators.service";
+export * from "./dispatching-event-store";
 export * from "./download-file.service";
 export * from "./encryption.service";
 export * from "./env-validator.service";
@@ -51,6 +56,7 @@ export * from "./simulated-error.middleware";
 export * from "./sitemap.service";
 export * from "./slower.middleware";
 export * from "./time-zone-offset.middleware";
+export * from "./to-event-map.types";
 export * from "./uptime.service";
 export * from "./url-wo-trailing-slash.vo";
 export * from "./username.vo";

package/src/setup.service.ts

@@ -1,4 +1,5 @@
 import * as tools from "@bgord/tools";
+import { uaBlocker } from "@hono/ua-blocker";
 import { bodyLimit } from "hono/body-limit";
 import { cors } from "hono/cors";
 import { languageDetector } from "hono/language";
@@ -7,7 +8,9 @@ import { secureHeaders } from "hono/secure-headers";
 import { timing } from "hono/timing";
 
 import { ApiVersion } from "./api-version.middleware";
+import { BOTS_REGEX } from "./bots.vo";
 import { Context } from "./context.middleware";
+import { CorrelationStorage } from "./correlation-storage.service";
 import { ETagExtractor } from "./etag-extractor.middleware";
 import { HttpLogger } from "./http-logger.middleware";
 import { I18nConfigType } from "./i18n.service";
@@ -25,19 +28,21 @@ export class Setup {
     return [
       secureHeaders(),
       bodyLimit({ maxSize: BODY_LIMIT_MAX_SIZE }),
+      uaBlocker({ blocklist: BOTS_REGEX }),
       ApiVersion.attach,
       cors({ origin: "*" }),
       languageDetector({
         supportedLanguages: Object.keys(i18n.supportedLanguages),
         fallbackLanguage: i18n.defaultLanguage,
       }),
-      requestId({ limitLength: 36 }),
+      requestId({ limitLength: 36, headerName: "x-correlation-id" }),
       TimeZoneOffset.attach,
       Context.attach,
       WeakETagExtractor.attach,
       ETagExtractor.attach,
       HttpLogger.build(logger),
       timing(),
+      CorrelationStorage.handle(),
     ];
   }
 }

package/src/to-event-map.types.ts

@@ -0,0 +1,3 @@
+export type ToEventMap<E extends { name: string }> = {
+  [Ev in E as Ev["name"]]: Ev;
+};