@bgord/bun 0.19.1 → 0.19.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.19.1",
+  "version": "0.19.4",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -26,10 +26,10 @@
     "@types/bun": "1.2.20",
     "@types/lodash": "4.17.20",
     "@types/mime-types": "3.0.1",
-    "@types/nodemailer": "7.0.0",
+    "@types/nodemailer": "7.0.1",
     "@types/yazl": "3.3.0",
     "cspell": "9.2.0",
-    "knip": "5.62.0",
+    "knip": "5.63.0",
     "lefthook": "1.12.3",
     "only-allow": "1.2.1",
     "shellcheck": "4.1.0",
@@ -43,7 +43,7 @@
     "check-disk-space": "3.4.0",
     "croner": "9.1.0",
     "hcaptcha": "0.2.0",
-    "hono": "4.9.2",
+    "hono": "4.9.4",
     "lodash": "4.17.21",
     "mime-types": "3.0.1",
     "node-cache": "5.1.2",

package/readme.md

@@ -24,9 +24,7 @@ Run the tests
 
 ```
 src/
-├── api-key-shield.middleware.ts
 ├── api-version.middleware.ts
-├── auth-shield.middleware.ts
 ├── basic-auth.service.ts
 ├── better-auth-logger.service.ts
 ├── bots.vo.ts
@@ -34,11 +32,6 @@ src/
 ├── cache-resolver.service.ts
 ├── cache-response.middleware.ts
 ├── cache-static-files.middleware.ts
-├── captcha-shield-hcaptcha-local.adapter.ts
-├── captcha-shield-hcaptcha.adapter.ts
-├── captcha-shield-noop.adapter.ts
-├── captcha-shield-recaptcha.adapter.ts
-├── captcha-shield.port.ts
 ├── command-logger.service.ts
 ├── command.types.ts
 ├── context.middleware.ts
@@ -49,12 +42,14 @@ src/
 ├── encryption.service.ts
 ├── env-validator.service.ts
 ├── etag-extractor.middleware.ts
+├── event-envelope.ts
 ├── event-handler.service.ts
 ├── event-logger.service.ts
 ├── event-publisher.types.ts
 ├── event-store.ts
 ├── event-stream.vo.ts
 ├── event.types.ts
+├── file-draft-zip.service.ts
 ├── file-draft.service.ts
 ├── file-location.service.ts
 ├── file-uploader.middleware.ts
@@ -92,7 +87,6 @@ src/
 │           ├── history-payload.ts
 │           ├── history-subject.ts
 │           ├── history.ts
-├── node-cache-rate-limit-store.adapter.ts
 ├── node-env.vo.ts
 ├── open-graph.service.ts
 ├── path.vo.ts
@@ -117,10 +111,18 @@ src/
 │   ├── timezone-utc.ts
 │   └── translations.ts
 ├── prerequisites.service.ts
-├── rate-limit-shield.middleware.ts
+├── rate-limit-store-node-cache.adapter.ts
 ├── rate-limit-store.port.ts
 ├── safe-parse-body.service.ts
 ├── setup.service.ts
+├── shield-api-key.middleware.ts
+├── shield-auth.middleware.ts
+├── shield-captcha-hcaptcha-local.adapter.ts
+├── shield-captcha-hcaptcha.adapter.ts
+├── shield-captcha-noop.adapter.ts
+├── shield-captcha-recaptcha.adapter.ts
+├── shield-captcha.port.ts
+├── shield-rate-limit.middleware.ts
 ├── simulated-error.middleware.ts
 ├── sitemap.service.ts
 ├── slower.middleware.ts
@@ -133,7 +135,6 @@ src/
 ├── visitor-id-hash-hono.adapter.ts
 ├── visitor-id-hash.adapter.ts
 ├── visitor-id.port.ts
-├── weak-etag-extractor.middleware.ts
-└── zip-draft.service.ts
+└── weak-etag-extractor.middleware.ts
 ```
 

package/src/event-envelope.ts

@@ -0,0 +1,23 @@
+import * as tools from "@bgord/tools";
+import { z } from "zod/v4";
+import { CorrelationStorage } from "./correlation-storage.service";
+import type { EventStreamType } from "./event-stream.vo";
+import { UUID } from "./uuid.vo";
+
+export const EventEnvelopeSchema = {
+  id: UUID,
+  correlationId: UUID,
+  createdAt: tools.Timestamp,
+  stream: z.string().min(1),
+  version: z.literal(1),
+  revision: tools.RevisionValue.optional(),
+};
+
+export const createEventEnvelope = (stream: EventStreamType) =>
+  ({
+    id: crypto.randomUUID(),
+    correlationId: CorrelationStorage.get(),
+    createdAt: tools.Time.Now().value,
+    stream,
+    version: 1,
+  }) as const;

package/src/{zip-draft.service.ts → file-draft-zip.service.ts}

@@ -3,7 +3,7 @@ import * as tools from "@bgord/tools";
 import { ZipFile } from "yazl";
 import { FileDraft } from "./file-draft.service";
 
-export class ZipDraft extends FileDraft {
+export class FileDraftZip extends FileDraft {
   private readonly parts: FileDraft[];
 
   constructor(config: { filename: string; parts: FileDraft[] }) {

package/src/index.ts

@@ -1,18 +1,11 @@
 export { default as sharp } from "sharp";
-export * from "./api-key-shield.middleware";
 export * from "./api-version.middleware";
-export * from "./auth-shield.middleware";
 export * from "./basic-auth.service";
 export * from "./better-auth-logger.service";
 export * from "./build-info-repository.service";
 export * from "./cache-resolver.service";
 export * from "./cache-response.middleware";
 export * from "./cache-static-files.middleware";
-export * from "./captcha-shield.port";
-export * from "./captcha-shield-hcaptcha.adapter";
-export * from "./captcha-shield-hcaptcha-local.adapter";
-export * from "./captcha-shield-noop.adapter";
-export * from "./captcha-shield-recaptcha.adapter";
 export * from "./command.types";
 export * from "./command-logger.service";
 export * from "./context.middleware";
@@ -24,11 +17,13 @@ export * from "./encryption.service";
 export * from "./env-validator.service";
 export * from "./etag-extractor.middleware";
 export * from "./event.types";
+export * from "./event-envelope";
 export * from "./event-handler.service";
 export * from "./event-logger.service";
 export * from "./event-store";
 export * from "./event-stream.vo";
 export * from "./file-draft.service";
+export * from "./file-draft-zip.service";
 export * from "./file-location.service";
 export * from "./file-uploader.middleware";
 export * from "./graceful-shutdown.service";
@@ -48,16 +43,24 @@ export * from "./mailer-smtp.adapter";
 export * from "./mailer-smtp-with-logger.adapter";
 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 "./open-graph.service";
 export * from "./path.vo";
 export * from "./port.vo";
 export * from "./prerequisites/index";
 export * from "./prerequisites.service";
-export * from "./rate-limit-shield.middleware";
+export * from "./rate-limit-store.port";
+export * from "./rate-limit-store-node-cache.adapter";
 export * from "./safe-parse-body.service";
 export * from "./setup.service";
+export * from "./shield-api-key.middleware";
+export * from "./shield-auth.middleware";
+export * from "./shield-captcha.port";
+export * from "./shield-captcha-hcaptcha.adapter";
+export * from "./shield-captcha-hcaptcha-local.adapter";
+export * from "./shield-captcha-noop.adapter";
+export * from "./shield-captcha-recaptcha.adapter";
+export * from "./shield-rate-limit.middleware";
 export * from "./simulated-error.middleware";
 export * from "./sitemap.service";
 export * from "./slower.middleware";
@@ -71,4 +74,3 @@ export * from "./visitor-id.port";
 export * from "./visitor-id-hash.adapter";
 export * from "./visitor-id-hash-hono.adapter";
 export * from "./weak-etag-extractor.middleware";
-export * from "./zip-draft.service";

package/src/{node-cache-rate-limit-store.adapter.ts → rate-limit-store-node-cache.adapter.ts}

@@ -2,7 +2,7 @@ import type * as tools from "@bgord/tools";
 import NodeCache from "node-cache";
 import type { RateLimitStore, RateLimitStoreSubjectType } from "./rate-limit-store.port";
 
-export class NodeCacheRateLimitStore implements RateLimitStore {
+export class RateLimitStoreNodeCache implements RateLimitStore {
   private readonly store: NodeCache;
 
   constructor(readonly time: tools.TimeResult) {

package/src/{api-key-shield.middleware.ts → shield-api-key.middleware.ts}

@@ -8,13 +8,13 @@ export const AccessDeniedApiKeyError = new HTTPException(403, {
   message: "access_denied_api_key",
 });
 
-export class ApiKeyShield {
+export class ShieldApiKey {
   static readonly HEADER_NAME = "bgord-api-key";
 
   constructor(private readonly config: ApiKeyShieldConfigType) {}
 
   verify = createMiddleware(async (c, next) => {
-    if (c.req.header(ApiKeyShield.HEADER_NAME) === this.config.API_KEY) {
+    if (c.req.header(ShieldApiKey.HEADER_NAME) === this.config.API_KEY) {
       return next();
     }
 

package/src/{auth-shield.middleware.ts → shield-auth.middleware.ts}

@@ -9,7 +9,7 @@ export const AccessDeniedAuthShieldError = new HTTPException(403, {
   message: "access_denied_auth_shield",
 });
 
-export class AuthShield {
+export class ShieldAuth {
   cors = {
     origin: ["http://localhost:5173", "http://localhost:3000"],
     credentials: true,

package/src/{captcha-shield-hcaptcha-local.adapter.ts → shield-captcha-hcaptcha-local.adapter.ts}

@@ -1,14 +1,14 @@
 import hcaptcha from "hcaptcha";
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
-import type { CaptchaShieldPort } from "./captcha-shield.port";
-import type { HCaptchaSecretKeyType } from "./captcha-shield-hcaptcha.adapter";
+import type { ShieldCaptchaPort } from "./shield-captcha.port";
+import type { HCaptchaSecretKeyType } from "./shield-captcha-hcaptcha.adapter";
 
 export const AccessDeniedHcaptchaLocalError = new HTTPException(403, {
   message: "access_denied_hcaptcha_local",
 });
 
-export class CaptchaShieldHcaptchaLocal implements CaptchaShieldPort {
+export class ShieldCaptchaHcaptchaLocal implements ShieldCaptchaPort {
   constructor(private readonly secretKey: HCaptchaSecretKeyType) {}
 
   verify = createMiddleware(async (_c, next) => {

package/src/{captcha-shield-hcaptcha.adapter.ts → shield-captcha-hcaptcha.adapter.ts}

@@ -2,7 +2,7 @@ import hcaptcha from "hcaptcha";
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 import { z } from "zod/v4";
-import type { CaptchaShieldPort } from "./captcha-shield.port";
+import type { ShieldCaptchaPort } from "./shield-captcha.port";
 
 export const HCaptchaSecretKey = z.string().trim().length(42).brand("HCaptchaSecretKey");
 
@@ -18,7 +18,7 @@ export const AccessDeniedHcaptchaError = new HTTPException(403, {
   message: "access_denied_hcaptcha",
 });
 
-export class CaptchaShieldHcaptcha implements CaptchaShieldPort {
+export class ShieldCaptchaHcaptcha implements ShieldCaptchaPort {
   constructor(private readonly secretKey: HCaptchaSecretKeyType) {}
 
   verify = createMiddleware(async (c, next) => {

package/src/shield-captcha-noop.adapter.ts

@@ -0,0 +1,6 @@
+import { createMiddleware } from "hono/factory";
+import type { ShieldCaptchaPort } from "./shield-captcha.port";
+
+export class ShieldCaptchaNoop implements ShieldCaptchaPort {
+  verify = createMiddleware(async (_c, next) => next());
+}

package/src/{captcha-shield-recaptcha.adapter.ts → shield-captcha-recaptcha.adapter.ts}

@@ -1,7 +1,7 @@
 import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 import { z } from "zod/v4";
-import type { CaptchaShieldPort } from "./captcha-shield.port";
+import type { ShieldCaptchaPort } from "./shield-captcha.port";
 
 export const RecaptchaSiteKey = z.string().trim().length(40);
 
@@ -24,7 +24,7 @@ export const AccessDeniedRecaptchaError = new HTTPException(403, {
   message: "access_denied_recaptcha",
 });
 
-export class CaptchaShieldRecaptcha implements CaptchaShieldPort {
+export class ShieldCaptchaRecaptcha implements ShieldCaptchaPort {
   private readonly secretKey: RecaptchaVerifierConfigType["secretKey"];
 
   constructor(config: RecaptchaVerifierConfigType) {

package/src/{captcha-shield.port.ts → shield-captcha.port.ts}

@@ -1,5 +1,5 @@
 import type { MiddlewareHandler } from "hono";
 
-export interface CaptchaShieldPort {
+export interface ShieldCaptchaPort {
   verify: MiddlewareHandler;
 }

package/src/{rate-limit-shield.middleware.ts → shield-rate-limit.middleware.ts}

@@ -18,7 +18,7 @@ type RateLimitShieldOptionsType = {
 
 export const TooManyRequestsError = new HTTPException(429, { message: "app.too_many_requests" });
 
-export const RateLimitShield = (options: RateLimitShieldOptionsType) => {
+export const ShieldRateLimit = (options: RateLimitShieldOptionsType) => {
   return createMiddleware(async (c, next) => {
     if (!options.enabled) return next();
 

package/dist/captcha-shield-noop.adapter.d.ts

@@ -1,5 +0,0 @@
-import type { CaptchaShieldPort } from "./captcha-shield.port";
-export declare class CaptchaShieldNoop implements CaptchaShieldPort {
-    verify: import("hono").MiddlewareHandler<any, string, {}>;
-}
-//# sourceMappingURL=captcha-shield-noop.adapter.d.ts.map

package/dist/captcha-shield-noop.adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"captcha-shield-noop.adapter.d.ts","sourceRoot":"","sources":["../src/captcha-shield-noop.adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,MAAM,oDAAgD;CACvD"}

package/dist/captcha-shield-noop.adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"captcha-shield-noop.adapter.js","sourceRoot":"","sources":["../src/captcha-shield-noop.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,OAAO,iBAAiB;IAC5B,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;CACvD"}

package/dist/captcha-shield.port.d.ts

@@ -1,5 +0,0 @@
-import type { MiddlewareHandler } from "hono";
-export interface CaptchaShieldPort {
-    verify: MiddlewareHandler;
-}
-//# sourceMappingURL=captcha-shield.port.d.ts.map

package/dist/captcha-shield.port.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"captcha-shield.port.d.ts","sourceRoot":"","sources":["../src/captcha-shield.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;CAC3B"}

package/dist/captcha-shield.port.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=captcha-shield.port.js.map

package/dist/captcha-shield.port.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"captcha-shield.port.js","sourceRoot":"","sources":["../src/captcha-shield.port.ts"],"names":[],"mappings":""}

package/dist/zip-draft.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zip-draft.service.d.ts","sourceRoot":"","sources":["../src/zip-draft.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,qBAAa,QAAS,SAAQ,SAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,EAAE,CAAA;KAAE;IAMtD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAgBhC"}

package/dist/zip-draft.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"zip-draft.service.js","sourceRoot":"","sources":["../src/zip-draft.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,OAAO,QAAS,SAAQ,SAAS;IACpB,KAAK,CAAc;IAEpC,YAAY,MAAgD;QAC1D,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAa,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7E,CAAC;QACD,GAAG,CAAC,GAAG,EAAE,CAAC;QAEV,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAErE,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/src/captcha-shield-noop.adapter.ts

@@ -1,6 +0,0 @@
-import { createMiddleware } from "hono/factory";
-import type { CaptchaShieldPort } from "./captcha-shield.port";
-
-export class CaptchaShieldNoop implements CaptchaShieldPort {
-  verify = createMiddleware(async (_c, next) => next());
-}