@bgord/bun 0.11.2 → 0.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.11.2",
+  "version": "0.12.1",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -36,6 +36,7 @@
   },
   "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",

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/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 type { EventType } from "./event.vo";
+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 Pick<EventType, "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-store.ts

@@ -0,0 +1,44 @@
+import { z } from "zod/v4";
+import type { GenericEventSchema, GenericParsedEventSchema } from "./event.types";
+import type { EventStreamType } from "./event-stream.vo";
+
+export type EventNameType = z.infer<GenericEventSchema["shape"]["name"]>;
+
+type FindEventsHandler = (
+  stream: EventStreamType,
+  acceptedEventsNames: EventNameType[],
+) => Promise<z.infer<GenericEventSchema>[]>;
+
+type InserterEventsHandler = (events: z.infer<GenericParsedEventSchema>[]) => Promise<void>;
+
+type EventStoreConfigType = {
+  finder: FindEventsHandler;
+  inserter: InserterEventsHandler;
+};
+
+export class EventStore<AllEvents extends GenericEventSchema> {
+  constructor(private readonly config: EventStoreConfigType) {}
+
+  async find<AcceptedEvents extends readonly AllEvents[]>(
+    acceptedEvents: AcceptedEvents,
+    stream: EventStreamType,
+  ): Promise<z.infer<AcceptedEvents[number]>[]> {
+    const acceptedEventsNames = acceptedEvents.map((event) => event.shape.name.value);
+
+    const rows = await this.config.finder(stream, acceptedEventsNames);
+
+    return rows
+      .map((row) => ({ ...row, payload: JSON.parse(row.payload) }))
+      .map((row) => acceptedEvents.find((event) => event.shape.name.value === row.name)?.parse(row))
+      .filter((event): event is z.infer<AcceptedEvents[number]> => event !== undefined);
+  }
+
+  async save(events: z.infer<AllEvents>[]) {
+    await this.config.inserter(
+      events.map((event) => ({
+        ...event,
+        payload: JSON.stringify(event.payload),
+      })),
+    );
+  }
+}

package/src/event-stream.vo.ts

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

package/src/event.types.ts

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

package/src/index.ts

@@ -10,13 +10,16 @@ export * from "./cache-static-files.middleware";
 export * from "./context.middleware";
 export * from "./correlation-id.vo";
 export * from "./decorators.service";
+export * from "./dispatching-event-store";
 export * from "./download-file.service";
 export * from "./encryption.service";
 export * from "./env-validator.service";
 export * from "./etag-extractor.middleware";
-export * from "./event.vo";
+export * from "./event.types";
 export * from "./event-handler.service";
 export * from "./event-logger.service";
+export * from "./event-store";
+export * from "./event-stream.vo";
 export * from "./file-location.service";
 export * from "./file-uploader.middleware";
 export * from "./graceful-shutdown.service";
@@ -49,6 +52,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,6 +8,7 @@ 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 { ETagExtractor } from "./etag-extractor.middleware";
 import { HttpLogger } from "./http-logger.middleware";
@@ -25,6 +27,7 @@ export class Setup {
     return [
       secureHeaders(),
       bodyLimit({ maxSize: BODY_LIMIT_MAX_SIZE }),
+      uaBlocker({ blocklist: BOTS_REGEX }),
       ApiVersion.attach,
       cors({ origin: "*" }),
       languageDetector({

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;
+};

package/dist/event.vo.d.ts

@@ -1,20 +0,0 @@
-import { z } from "zod/v4";
-export declare const Event: z.ZodObject<{
-    id: z.ZodDefault<z.ZodUUID>;
-    createdAt: z.ZodDate;
-    stream: z.ZodString;
-    name: z.ZodString;
-    version: z.ZodNumber;
-    payload: z.ZodPipe<z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodTransform<string, Record<string, any>>>;
-}, z.core.$strip>;
-export declare const ParsedEvent: z.ZodObject<{
-    id: z.ZodDefault<z.ZodUUID>;
-    createdAt: z.ZodDate;
-    stream: z.ZodString;
-    name: z.ZodString;
-    version: z.ZodNumber;
-    payload: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip>;
-export type EventType = z.infer<typeof Event>;
-export type ParsedEventType = z.infer<typeof ParsedEvent>;
-//# sourceMappingURL=event.vo.d.ts.map

package/dist/event.vo.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.vo.d.ts","sourceRoot":"","sources":["../src/event.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,KAAK;;;;;;;iBAmBhB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;iBAAoE,CAAC;AAE7F,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/event.vo.js

@@ -1,23 +0,0 @@
-import { z } from "zod/v4";
-import { UUID } from "./uuid.vo";
-export const Event = z.object({
-    id: UUID,
-    createdAt: z.date(),
-    stream: z.string().min(1),
-    name: z.string().min(1),
-    version: z.number().int().positive(),
-    payload: z
-        .record(z.string(), z.any())
-        .refine((value) => {
-        try {
-            JSON.parse(JSON.stringify(value));
-            return true;
-        }
-        catch (_error) {
-            return false;
-        }
-    })
-        .transform((value) => JSON.stringify(value)),
-});
-export const ParsedEvent = Event.merge(z.object({ payload: z.record(z.string(), z.any()) }));
-//# sourceMappingURL=event.vo.js.map

package/dist/event.vo.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.vo.js","sourceRoot":"","sources":["../src/event.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAE,IAAI;IACR,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IAEnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACpC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;SAC3B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;SACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/src/event.vo.ts

@@ -1,29 +0,0 @@
-import { z } from "zod/v4";
-
-import { UUID } from "./uuid.vo";
-
-export const Event = z.object({
-  id: UUID,
-  createdAt: z.date(),
-
-  stream: z.string().min(1),
-
-  name: z.string().min(1),
-  version: z.number().int().positive(),
-  payload: z
-    .record(z.string(), z.any())
-    .refine((value) => {
-      try {
-        JSON.parse(JSON.stringify(value));
-        return true;
-      } catch (_error) {
-        return false;
-      }
-    })
-    .transform((value) => JSON.stringify(value)),
-});
-
-export const ParsedEvent = Event.merge(z.object({ payload: z.record(z.string(), z.any()) }));
-
-export type EventType = z.infer<typeof Event>;
-export type ParsedEventType = z.infer<typeof ParsedEvent>;