@bgord/bun 0.7.0 → 0.8.1

package/dist/uptime.service.d.ts

@@ -0,0 +1,9 @@
+import * as tools from "@bgord/tools";
+export type UptimeResultType = {
+    seconds: tools.TimestampType;
+    formatted: ReturnType<(typeof tools.DateFormatters)["relative"]>;
+};
+export declare class Uptime {
+    static get(): UptimeResultType;
+}
+//# sourceMappingURL=uptime.service.d.ts.map

package/dist/uptime.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.service.d.ts","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC;IAC7B,SAAS,EAAE,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAClE,CAAC;AAEF,qBAAa,MAAM;IACjB,MAAM,CAAC,GAAG,IAAI,gBAAgB;CAO/B"}

package/dist/uptime.service.js

@@ -0,0 +1,10 @@
+import * as tools from "@bgord/tools";
+export class Uptime {
+    static get() {
+        const rounding = new tools.RoundToNearest();
+        const uptime = tools.Time.Seconds(rounding.round(process.uptime()));
+        const uptimeFormatted = tools.DateFormatters.relative(Date.now() - uptime.ms);
+        return { seconds: uptime.seconds, formatted: uptimeFormatted };
+    }
+}
+//# sourceMappingURL=uptime.service.js.map

package/dist/uptime.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uptime.service.js","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAOtC,MAAM,OAAO,MAAM;IACjB,MAAM,CAAC,GAAG;QACR,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,eAAe,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;IACjE,CAAC;CACF"}

package/dist/url-wo-trailing-slash.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+export declare const UrlWithoutTrailingSlash: z.ZodURL;
+export type UrlWithoutTrailingSlashType = z.infer<typeof UrlWithoutTrailingSlash>;
+//# sourceMappingURL=url-wo-trailing-slash.d.ts.map

package/dist/url-wo-trailing-slash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-wo-trailing-slash.d.ts","sourceRoot":"","sources":["../src/url-wo-trailing-slash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,uBAAuB,UAMhC,CAAC;AAEL,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/url-wo-trailing-slash.js

@@ -0,0 +1,9 @@
+import { z } from "zod/v4";
+export const UrlWithoutTrailingSlash = z
+    .url()
+    .trim()
+    .min(1)
+    .refine((value) => !value.endsWith("/"), {
+    message: "url_cannot_end_with_trailing_slash",
+});
+//# sourceMappingURL=url-wo-trailing-slash.js.map

package/dist/url-wo-trailing-slash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-wo-trailing-slash.js","sourceRoot":"","sources":["../src/url-wo-trailing-slash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,GAAG,EAAE;KACL,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;IACvC,OAAO,EAAE,oCAAoC;CAC9C,CAAC,CAAC"}

package/dist/url-wo-trailing-slash.vo.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+export declare const UrlWithoutTrailingSlash: z.ZodURL;
+export type UrlWithoutTrailingSlashType = z.infer<typeof UrlWithoutTrailingSlash>;
+//# sourceMappingURL=url-wo-trailing-slash.vo.d.ts.map

package/dist/url-wo-trailing-slash.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-wo-trailing-slash.vo.d.ts","sourceRoot":"","sources":["../src/url-wo-trailing-slash.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,eAAO,MAAM,uBAAuB,UAMhC,CAAC;AAEL,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/url-wo-trailing-slash.vo.js

@@ -0,0 +1,9 @@
+import { z } from "zod/v4";
+export const UrlWithoutTrailingSlash = z
+    .url()
+    .trim()
+    .min(1)
+    .refine((value) => !value.endsWith("/"), {
+    message: "url_cannot_end_with_trailing_slash",
+});
+//# sourceMappingURL=url-wo-trailing-slash.vo.js.map

package/dist/url-wo-trailing-slash.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-wo-trailing-slash.vo.js","sourceRoot":"","sources":["../src/url-wo-trailing-slash.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC;KACrC,GAAG,EAAE;KACL,IAAI,EAAE;KACN,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;IACvC,OAAO,EAAE,oCAAoC;CAC9C,CAAC,CAAC"}

package/dist/username.vo.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod/v4";
+export type IdType = string;
+type UsernameType = string;
+export declare class Username {
+    private readonly schema;
+    private readonly value;
+    constructor(value: UsernameType, schema?: z.ZodSchema);
+    read(): UsernameType;
+}
+export {};
+//# sourceMappingURL=username.vo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"username.vo.d.ts","sourceRoot":"","sources":["../src/username.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,KAAK,YAAY,GAAG,MAAM,CAAC;AAE3B,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS;IAKrD,IAAI,IAAI,YAAY;CAGrB"}

package/dist/username.vo.js

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+export class Username {
+    schema = z.string().max(256);
+    value;
+    constructor(value, schema) {
+        this.schema = schema ?? this.schema;
+        this.value = this.schema.parse(value);
+    }
+    read() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=username.vo.js.map

package/dist/username.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"username.vo.js","sourceRoot":"","sources":["../src/username.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAM3B,MAAM,OAAO,QAAQ;IACF,MAAM,GAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE1C,KAAK,CAAe;IAErC,YAAY,KAAmB,EAAE,MAAoB;QACnD,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAiB,CAAC;IACxD,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,IAAI,yBAA6C,CAAC;AAC/D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC"}
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,IAAI,yBAA6C,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC"}

package/dist/uuid.vo.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+export declare const UUID: z.ZodDefault<z.ZodUUID>;
+export type UUIDType = z.infer<typeof UUID>;
+//# sourceMappingURL=uuid.vo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.vo.d.ts","sourceRoot":"","sources":["../src/uuid.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,IAAI,yBAA6C,CAAC;AAE/D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC"}

package/dist/uuid.vo.js

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+import { NewUUID } from "./new-uuid.service";
+export const UUID = z.uuid().default(() => NewUUID.generate());
+//# sourceMappingURL=uuid.vo.js.map

package/dist/uuid.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.vo.js","sourceRoot":"","sources":["../src/uuid.vo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC"}

package/dist/weak-etag-extractor.middleware.d.ts

@@ -0,0 +1,7 @@
+import { EtagVariables } from "./etag-extractor.middleware";
+export declare class WeakETagExtractor {
+    static attach: import("hono").MiddlewareHandler<{
+        Variables: EtagVariables;
+    }, string, {}>;
+}
+//# sourceMappingURL=weak-etag-extractor.middleware.d.ts.map

package/dist/weak-etag-extractor.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weak-etag-extractor.middleware.d.ts","sourceRoot":"","sources":["../src/weak-etag-extractor.middleware.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,MAAM;mBAAiC,aAAa;mBAWxD;CACJ"}

package/dist/weak-etag-extractor.middleware.js

@@ -0,0 +1,18 @@
+import * as tools from "@bgord/tools";
+import { createMiddleware } from "hono/factory";
+export class WeakETagExtractor {
+    static attach = createMiddleware(async (c, next) => {
+        try {
+            const header = String(c.req.header(tools.WeakETag.IF_MATCH_HEADER_NAME));
+            if (!header || header === "undefined")
+                c.set("WeakETag", null);
+            else
+                c.set("WeakETag", tools.WeakETag.fromHeader(header));
+        }
+        catch (error) {
+            c.set("WeakETag", null);
+        }
+        await next();
+    });
+}
+//# sourceMappingURL=weak-etag-extractor.middleware.js.map

package/dist/weak-etag-extractor.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weak-etag-extractor.middleware.js","sourceRoot":"","sources":["../src/weak-etag-extractor.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAC,MAAM,GAAG,gBAAgB,CAA+B,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QAC/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,WAAW;gBAAE,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;;gBAC1D,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -22,6 +22,7 @@
     "@commitlint/config-conventional": "19.8.1",
     "@types/bun": "1.2.15",
     "@types/lodash": "4.17.17",
+    "@types/mime-types": "3.0.1",
     "@types/nodemailer": "6.4.17",
     "cspell": "9.0.2",
     "knip": "5.60.2",
@@ -31,12 +32,14 @@
     "typescript": "5.8.3"
   },
   "dependencies": {
-    "@bgord/tools": "0.6.0",
+    "@bgord/tools": "0.8.0",
     "check-disk-space": "3.4.0",
     "croner": "9.0.0",
+    "hcaptcha": "0.2.0",
     "hono": "4.7.11",
     "lodash": "4.17.21",
     "lucia": "3.2.2",
+    "mime-types": "3.0.1",
     "node-cache": "5.1.2",
     "nodemailer": "7.0.3",
     "sharp": "0.34.2",

package/src/{api-version.ts → api-version.middleware.ts}

@@ -1,6 +1,6 @@
 import { createMiddleware } from "hono/factory";
 
-import { BuildInfoRepository } from "./build-info-repository";
+import { BuildInfoRepository } from "./build-info-repository.service";
 
 export class ApiVersion {
   static HEADER_NAME = "api-version";

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

@@ -3,9 +3,9 @@ import { createMiddleware } from "hono/factory";
 import { HTTPException } from "hono/http-exception";
 import { Lucia } from "lucia";
 
-import { HashedPassword, Password, PasswordType } from "./passwords";
-import { SessionId } from "./session-id";
-import { IdType, Username } from "./username";
+import { HashedPassword, Password, PasswordType } from "./passwords.vo";
+import { SessionId } from "./session-id.vo";
+import { IdType, Username } from "./username.vo";
 
 type AuthShieldConfigType<T> = {
   Username: typeof Username;

package/src/basic-auth.service.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+
+export const BasicAuthUsername = z.string().min(1).max(128);
+
+export type BasicAuthUsernameType = z.infer<typeof BasicAuthUsername>;
+
+export const BasicAuthPassword = z.string().min(1).max(128);
+
+export type BasicAuthPasswordType = z.infer<typeof BasicAuthPassword>;
+
+type BasicAuthHeaderValueType = { authorization: string };
+
+export class BasicAuth {
+  static toHeaderValue(
+    username: BasicAuthUsernameType,
+    password: BasicAuthPasswordType,
+  ): BasicAuthHeaderValueType {
+    const credentials = btoa(`${username}:${password}`);
+
+    return { authorization: `Basic ${credentials}` };
+  }
+
+  static toHeader(username: BasicAuthUsernameType, password: BasicAuthPasswordType): Headers {
+    return new Headers(BasicAuth.toHeaderValue(username, password));
+  }
+}

package/src/{cache-response.ts → cache-response.middleware.ts}

@@ -2,7 +2,7 @@ import { createMiddleware } from "hono/factory";
 import _ from "lodash";
 import NodeCache from "node-cache";
 
-import { CacheHitEnum } from "./cache-resolver";
+import { CacheHitEnum } from "./cache-resolver.service";
 
 export class CacheResponse {
   static readonly CACHE_HIT_HEADER = "Cache-Hit";

package/src/{context.ts → context.middleware.ts}

@@ -1,7 +1,7 @@
 import { createMiddleware } from "hono/factory";
 
-import { CorrelationIdType } from "./correlation-id";
-import { TimeZoneOffsetVariables } from "./time-zone-offset";
+import type { CorrelationIdType } from "./correlation-id.vo";
+import { TimeZoneOffsetVariables } from "./time-zone-offset.middleware";
 
 export type ContextType = {
   requestId: CorrelationIdType;

package/src/{correlation-id.ts → correlation-id.vo.ts}

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

package/src/decorators.service.ts

@@ -0,0 +1,78 @@
+import * as tools from "@bgord/tools";
+
+import { Logger } from "./logger.service";
+
+export class DecoratorTimeoutError extends Error {}
+
+export class Decorators {
+  private readonly rounding = new tools.RoundToDecimal(2);
+
+  constructor(private readonly logger: Logger) {}
+
+  duration() {
+    const that = this;
+
+    return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+      const className =
+        // @ts-expect-error
+        this?.constructor?.name || target?.name || target?.constructor?.name || "UnknownClass";
+
+      const original: (...args: unknown[]) => unknown = descriptor.value;
+
+      const label = `${className}.${propertyKey}`;
+
+      descriptor.value = function (...args: unknown[]) {
+        const before = performance.now();
+        const value = original.apply(this, args);
+        const after = performance.now();
+
+        that.logger.info({
+          message: `${label} duration`,
+          operation: "decorators_duration_ms",
+          metadata: { durationMs: that.rounding.round(after - before) },
+        });
+
+        return value;
+      };
+    };
+  }
+
+  inspector() {
+    const that = this;
+
+    return function (target: any, propertyKey: string, descriptor: PropertyDescriptor) {
+      const className =
+        // @ts-expect-error
+        this?.constructor?.name || target?.name || target?.constructor?.name || "UnknownClass";
+
+      const original: (...args: unknown[]) => unknown = descriptor.value;
+
+      const label = `${className}.${propertyKey}`;
+
+      descriptor.value = async function (...args: unknown[]) {
+        const value = await original.apply(this, args);
+
+        that.logger.info({
+          message: `${label} inspector`,
+          operation: "decorators_inspector",
+          metadata: { arguments: args, output: value },
+        });
+
+        return value;
+      };
+    };
+  }
+
+  timeout(ms: number) {
+    return (_target: any, _key: string, descriptor: PropertyDescriptor) => {
+      const original: (...args: unknown[]) => unknown = descriptor.value;
+
+      descriptor.value = async function (...args: any[]) {
+        return await Promise.race([
+          original.apply(this, args),
+          new Promise((_, reject) => setTimeout(() => reject(new DecoratorTimeoutError()), ms)),
+        ]);
+      };
+    };
+  }
+}

package/src/encryption.service.ts

@@ -0,0 +1,60 @@
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import { pipeline } from "node:stream/promises";
+import * as util from "node:util";
+import { z } from "zod/v4";
+
+export const EncryptionIV = z
+  .string()
+  .min(1)
+  .transform((value) => Buffer.from(value.split(",").map(Number)));
+
+export type EncryptionIVType = z.infer<typeof EncryptionIV>;
+
+export const EncryptionSecret = z.string().length(64);
+
+export type EncryptionSecretType = z.infer<typeof EncryptionSecret>;
+
+export type EncryptionConfig = {
+  secret: EncryptionSecretType;
+  iv: EncryptionIVType;
+};
+
+export type EncryptionOperationConfig = {
+  input: fs.PathLike;
+  output: fs.PathLike;
+};
+
+const scrypt = util.promisify(crypto.scrypt);
+
+export class Encryption {
+  private readonly algorithm = "aes-192-cbc";
+
+  constructor(private readonly config: EncryptionConfig) {}
+
+  async createEncrypt() {
+    const key = (await scrypt(this.config.secret, "salt", 24)) as Buffer;
+
+    // @ts-ignore
+    return crypto.createCipheriv(this.algorithm, key, this.config.iv);
+  }
+
+  async createDecrypt() {
+    const key = (await scrypt(this.config.secret, "salt", 24)) as Buffer;
+
+    // @ts-ignore
+    return crypto.createDecipheriv(this.algorithm, key, this.config.iv);
+  }
+
+  async encrypt(config: EncryptionOperationConfig) {
+    const encrypt = await this.createEncrypt();
+
+    return pipeline(fs.createReadStream(config.input), encrypt, fs.createWriteStream(config.output));
+  }
+
+  async decrypt(config: EncryptionOperationConfig) {
+    const decrypt = await this.createDecrypt();
+
+    return pipeline(fs.createReadStream(config.input), decrypt, fs.createWriteStream(config.output));
+  }
+}

package/src/event-handler.service.ts

@@ -0,0 +1,20 @@
+import type { EventType } from "./event.vo";
+import { Logger } from "./logger.service";
+
+export class EventHandler {
+  constructor(private readonly logger: Logger) {}
+
+  handle<T extends Pick<EventType, "name">>(fn: (event: T) => Promise<void>) {
+    return async (event: T) => {
+      try {
+        await fn(event);
+      } catch (error) {
+        this.logger.error({
+          message: `Unknown ${event.name} event handler error`,
+          operation: "unknown_event_handler_error",
+          metadata: this.logger.formatError(error),
+        });
+      }
+    };
+  }
+}

package/src/event-logger.service.ts

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

package/src/event.vo.ts

@@ -0,0 +1,29 @@
+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>;

package/src/file-location.service.ts

@@ -0,0 +1,70 @@
+import * as path from "node:path";
+
+import { Path, PathType } from "./path.vo";
+
+type FileLocationBasenameType = string;
+
+type FileLocationExtensionType = string;
+
+type FileLocationParentType = string;
+
+export type FileLocationConfigType = {
+  parent: FileLocationParentType;
+  basename: FileLocationBasenameType;
+  extension: FileLocationExtensionType;
+};
+
+export class FileLocation {
+  readonly parent: PathType; // /parent/dir
+
+  private basename: FileLocationBasenameType; // index
+
+  private extension: FileLocationExtensionType; // .html
+
+  constructor(config: FileLocationConfigType) {
+    this.parent = Path.parse(config.parent);
+    this.basename = config.basename;
+    this.extension = config.extension;
+  }
+
+  getBasename(): FileLocationBasenameType {
+    return this.basename; // index
+  }
+
+  getExtension(): FileLocationExtensionType {
+    return this.extension; // .html
+  }
+
+  getFilename(extension?: FileLocationExtensionType): PathType {
+    return Path.parse(`${this.basename}${extension ?? this.extension}`); // index.html
+  }
+
+  getPath(extension?: FileLocationExtensionType): PathType {
+    const filename = this.getFilename(extension);
+    return Path.parse(path.join(this.parent, filename)); // parent/index.html
+  }
+
+  getGzippedPath(): PathType {
+    return Path.parse(`${this.getPath()}.gz`); // parent/index.html.gz
+  }
+
+  summary() {
+    return {
+      parent: this.parent,
+      basename: this.getBasename(),
+      extension: this.getExtension(),
+      filename: this.getFilename(),
+      path: this.getPath(),
+      gzipped: this.getGzippedPath(),
+    };
+  }
+
+  setBasename(basename: FileLocationBasenameType): FileLocation {
+    this.basename = basename;
+    return this;
+  }
+
+  async delete(): Promise<void> {
+    return Bun.file(this.getPath()).unlink();
+  }
+}

package/src/gzip.service.ts

@@ -0,0 +1,23 @@
+import { PathLike, createReadStream, createWriteStream } from "node:fs";
+import { pipeline } from "node:stream/promises";
+import { createGunzip, createGzip } from "node:zlib";
+
+type GzipCompressConfigType = { input: PathLike; output: PathLike };
+
+export class Gzip {
+  static createCompress() {
+    return createGzip();
+  }
+
+  static createDecompress() {
+    return createGunzip();
+  }
+
+  static async compress(config: GzipCompressConfigType) {
+    return pipeline(createReadStream(config.input), createGzip(), createWriteStream(config.output));
+  }
+
+  static async uncompress(config: GzipCompressConfigType) {
+    return pipeline(createReadStream(config.input), createGunzip(), createWriteStream(config.output));
+  }
+}

package/src/hcaptcha-shield.middleware.ts

@@ -0,0 +1,57 @@
+import hcaptcha from "hcaptcha";
+import { createMiddleware } from "hono/factory";
+import { HTTPException } from "hono/http-exception";
+import { z } from "zod/v4";
+
+export const HCaptchaSecretKey = z.string().trim().length(42);
+
+export type HCaptchaSecretKeyType = z.infer<typeof HCaptchaSecretKey>;
+
+export const HCaptchaSiteKey = z.string().trim().length(36);
+export type HCaptchaSiteKeyType = z.infer<typeof HCaptchaSiteKey>;
+
+export const HCaptchaResponseToken = z.string().trim();
+export type HCaptchaResponseTokenType = z.infer<typeof HCaptchaResponseToken>;
+
+type HCaptchaVerifierModeType = "local" | "production";
+
+export const AccessDeniedHcaptchaError = new HTTPException(403, {
+  message: "access_denied_recaptcha",
+});
+
+export type HCaptchaVerifierConfigType = {
+  secretKey: HCaptchaSecretKeyType;
+  mode: HCaptchaVerifierModeType;
+};
+
+export class HcaptchaShield {
+  private readonly secretKey: HCaptchaSecretKeyType;
+  private readonly mode: HCaptchaVerifierModeType;
+
+  private readonly LOCAL_HCAPTCHA_RESPONSE_PLACEHOLDER = "10000000-aaaa-bbbb-cccc-000000000001";
+
+  constructor(config: HCaptchaVerifierConfigType) {
+    this.mode = config.mode;
+    this.secretKey = config.secretKey;
+  }
+
+  build = createMiddleware(async (c, next) => {
+    try {
+      const form = await c.req.formData();
+
+      const hcaptchaTokenFormData = form.get("h-captcha-response")?.toString() as HCaptchaResponseTokenType;
+
+      const result = await hcaptcha.verify(
+        this.secretKey,
+        this.mode === "production" ? hcaptchaTokenFormData : this.LOCAL_HCAPTCHA_RESPONSE_PLACEHOLDER,
+      );
+
+      if (!result?.success) {
+        throw AccessDeniedHcaptchaError;
+      }
+      return next();
+    } catch (error) {
+      throw AccessDeniedHcaptchaError;
+    }
+  });
+}