@bgord/bun 1.6.6 → 1.7.0

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

@@ -1 +1 @@
-{"version":3,"file":"uptime.service.d.ts","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;IACzB,SAAS,EAAE,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAClE,CAAC;AAEF,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IAE9D,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB;CAM/C"}
+{"version":3,"file":"uptime.service.d.ts","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC;IACzB,SAAS,EAAE,UAAU,CAAC,CAAC,OAAO,KAAK,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;CAClE,CAAC;AAEF,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAEzE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,gBAAgB;CAM/C"}

package/dist/uptime.service.js

@@ -1,6 +1,6 @@
 import * as tools from "@bgord/tools";
 export class Uptime {
-    static rounding = new tools.RoundToNearest();
+    static rounding = new tools.RoundingToNearestStrategy();
     static get(clock) {
         const duration = tools.Duration.Seconds(Uptime.rounding.round(process.uptime()));
         const formatted = tools.DateFormatters.relative(clock.now().subtract(duration).ms);

package/dist/uptime.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"uptime.service.js","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAQtC,MAAM,OAAO,MAAM;IACT,MAAM,CAAU,QAAQ,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;IAE9D,MAAM,CAAC,GAAG,CAAC,KAAgB;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;QAEnF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC"}
+{"version":3,"file":"uptime.service.js","sourceRoot":"","sources":["../src/uptime.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAQtC,MAAM,OAAO,MAAM;IACT,MAAM,CAAU,QAAQ,GAAG,IAAI,KAAK,CAAC,yBAAyB,EAAE,CAAC;IAEzE,MAAM,CAAC,GAAG,CAAC,KAAgB;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;QAEnF,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC"}

package/dist/visitor-id-client.strategy.d.ts

@@ -0,0 +1,14 @@
+import type { Client } from "./client.vo";
+import type { HashContentStrategy } from "./hash-content.strategy";
+import type { VisitorIdStrategy } from "./visitor-id.strategy";
+type Dependencies = {
+    HashContent: HashContentStrategy;
+};
+export declare class VisitorIdClientStrategy implements VisitorIdStrategy {
+    private readonly client;
+    private readonly deps;
+    constructor(client: Client, deps: Dependencies);
+    get(): Promise<import("./hash.vo").Hash>;
+}
+export {};
+//# sourceMappingURL=visitor-id-client.strategy.d.ts.map

package/dist/visitor-id-client.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-id-client.strategy.d.ts","sourceRoot":"","sources":["../src/visitor-id-client.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,KAAK,YAAY,GAAG;IAAE,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEzD,qBAAa,uBAAwB,YAAW,iBAAiB;IAE7D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY;IAG/B,GAAG;CAOV"}

package/dist/visitor-id-client.strategy.js

@@ -0,0 +1,14 @@
+export class VisitorIdClientStrategy {
+    client;
+    deps;
+    constructor(client, deps) {
+        this.client = client;
+        this.deps = deps;
+    }
+    async get() {
+        const { ip, ua } = this.client.toJSON();
+        const value = `${ip}|${ua}`;
+        return this.deps.HashContent.hash(value);
+    }
+}
+//# sourceMappingURL=visitor-id-client.strategy.js.map

package/dist/visitor-id-client.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-id-client.strategy.js","sourceRoot":"","sources":["../src/visitor-id-client.strategy.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,MAAc,EACd,IAAkB;QADlB,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAc;IAClC,CAAC;IAEJ,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAExC,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/visitor-id.strategy.d.ts

@@ -0,0 +1,5 @@
+import type { Hash } from "./hash.vo";
+export interface VisitorIdStrategy {
+    get(): Promise<Hash>;
+}
+//# sourceMappingURL=visitor-id.strategy.d.ts.map

package/dist/visitor-id.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitor-id.strategy.d.ts","sourceRoot":"","sources":["../src/visitor-id.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB"}

package/dist/visitor-id.strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=visitor-id.strategy.js.map

package/dist/visitor-id.strategy.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "1.6.6",
+  "version": "1.7.0",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",
@@ -28,9 +28,10 @@
     "@types/nodemailer": "7.0.4",
     "@types/yazl": "3.3.0",
     "cspell": "9.4.0",
-    "knip": "5.75.2",
-    "lefthook": "2.0.12",
+    "knip": "5.78.0",
+    "lefthook": "2.0.13",
     "lockfile-lint": "4.14.1",
+    "lru-cache": "11.2.4",
     "only-allow": "1.2.2",
     "sharp": "0.34.5",
     "shellcheck": "4.1.0",
@@ -38,30 +39,30 @@
     "zod": "4.2.1"
   },
   "dependencies": {
-    "@axiomhq/winston": "1.3.1",
-    "@bgord/tools": "1.2.3",
-    "@hono/ua-blocker": "0.1.22",
-    "better-auth": "1.4.7",
+    "@bgord/tools": "1.2.9",
+    "better-auth": "1.4.9",
     "croner": "9.1.0",
     "csv": "6.4.1",
     "dotenv": "17.2.3",
     "hcaptcha": "0.2.0",
-    "hono": "4.11.1",
-    "isomorphic-dompurify": "2.34.0",
+    "hono": "4.11.3",
     "lodash": "4.17.21",
-    "marked": "17.0.1",
     "node-cache": "5.1.2",
-    "nodemailer": "7.0.11",
+    "nodemailer": "7.0.12",
     "winston": "3.19.0",
     "yazl": "3.3.1"
   },
   "peerDependencies": {
+    "lru-cache": "11.2.4",
     "zod": "4.2.1",
     "sharp": "0.34.5"
   },
   "peerDependenciesMeta": {
     "sharp": {
       "optional": true
+    },
+    "lru-cache": {
+      "optional": true
     }
   }
 }

package/readme.md

@@ -36,26 +36,32 @@ src/
 ├── bots.vo.ts
 ├── build-info-repository.service.ts
 ├── cache-file.service.ts
+├── cache-repository-lru-cache.adapter.ts
 ├── cache-repository-node-cache.adapter.ts
 ├── cache-repository-noop.adapter.ts
 ├── cache-repository.port.ts
-├── cache-resolver-simple.adapter.ts
-├── cache-resolver.port.ts
+├── cache-resolver-simple.strategy.ts
+├── cache-resolver.strategy.ts
 ├── cache-response.middleware.ts
 ├── cache-subject-resolver.vo.ts
-├── cache-subject-segment-cookie.ts
-├── cache-subject-segment-fixed.ts
-├── cache-subject-segment-header.ts
-├── cache-subject-segment-path.ts
-├── cache-subject-segment-query.ts
-├── cache-subject-segment-user.ts
-├── cache-subject-segment.port.ts
+├── cache-subject-segment-cookie.strategy.ts
+├── cache-subject-segment-fixed.strategy.ts
+├── cache-subject-segment-header.strategy.ts
+├── cache-subject-segment-ip.strategy.ts
+├── cache-subject-segment-path.strategy.ts
+├── cache-subject-segment-query.strategy.ts
+├── cache-subject-segment-user.strategy.ts
+├── cache-subject-segment.strategy.ts
 ├── certificate-inspector-noop.adapter.ts
 ├── certificate-inspector-tls.adapter.ts
 ├── certificate-inspector.port.ts
 ├── checksum.service.ts
+├── client-from-hono.adapter.ts
+├── client-ip.vo.ts
+├── client-user-agent.vo.ts
 ├── client.vo.ts
 ├── clock-fixed.adapter.ts
+├── clock-offset.adapter.ts
 ├── clock-system.adapter.ts
 ├── clock.port.ts
 ├── command-envelope.ts
@@ -64,9 +70,11 @@ src/
 ├── context.middleware.ts
 ├── correlation-id.vo.ts
 ├── correlation-storage.service.ts
+├── crypto-aes-gcm.service.ts
 ├── crypto-key-provider-file.adapter.ts
 ├── crypto-key-provider-memory.adapter.ts
 ├── crypto-key-provider-noop.adapter.ts
+├── crypto-key-provider-with-cache.adapter.ts
 ├── crypto-key-provider.port.ts
 ├── csv-stringifier.adapter.ts
 ├── csv-stringifier.port.ts
@@ -75,23 +83,24 @@ src/
 ├── disk-space-checker-noop.adapter.ts
 ├── disk-space-checker.port.ts
 ├── dispatching-event-store.ts
-├── encryption-bun.adapter.ts
+├── encryption-aes-gcm.adapter.ts
 ├── encryption-iv.vo.ts
 ├── encryption-key-value.vo.ts
 ├── encryption-key.vo.ts
 ├── encryption-noop.adapter.ts
 ├── encryption.port.ts
 ├── environment-loader-encrypted.adapter.ts
+├── environment-loader-noop.adapter.ts
 ├── environment-loader-process-safe.adapter.ts
 ├── environment-loader-process.adapter.ts
 ├── environment-loader.port.ts
 ├── etag-extractor.middleware.ts
 ├── event-bus-like.types.ts
 ├── event-envelope.ts
-├── event-handler-bare.adapter.ts
-├── event-handler-noop.adapter.ts
-├── event-handler-with-logger.adapter.ts
-├── event-handler.port.ts
+├── event-handler-bare.strategy.ts
+├── event-handler-noop.strategy.ts
+├── event-handler-with-logger.strategy.ts
+├── event-handler.strategy.ts
 ├── event-logger.service.ts
 ├── event-publisher.types.ts
 ├── event-store-like.types.ts
@@ -104,6 +113,11 @@ src/
 ├── file-cleaner.port.ts
 ├── file-draft-zip.service.ts
 ├── file-draft.service.ts
+├── file-reader-json-bun-forgiving.adapter.ts
+├── file-reader-json-bun.adapter.ts
+├── file-reader-json-noop.adapter.ts
+├── file-reader-json-with-cache.adapter.ts
+├── file-reader-json.port.ts
 ├── file-renamer-fs-forgiving.adapter.ts
 ├── file-renamer-fs.adapter.ts
 ├── file-renamer-noop.adapter.ts
@@ -114,9 +128,9 @@ src/
 ├── gzip-noop.adapter.ts
 ├── gzip-stream.adapter.ts
 ├── gzip.port.ts
-├── hash-content-noop.adapter.ts
-├── hash-content-sha256-bun.adapter.ts
-├── hash-content.port.ts
+├── hash-content-noop.strategy.ts
+├── hash-content-sha256-bun.strategy.ts
+├── hash-content.strategy.ts
 ├── hash-file-noop.adapter.ts
 ├── hash-file-sha256-bun.adapter.ts
 ├── hash-file.port.ts
@@ -156,15 +170,11 @@ src/
 ├── image-resizer.port.ts
 ├── invariant-error-handler.service.ts
 ├── invariant.service.ts
-├── job-handler-bare.adapter.ts
-├── job-handler-noop.adapter.ts
-├── job-handler-with-logger.adapter.ts
-├── job-handler.port.ts
+├── job-handler-bare.strategy.ts
+├── job-handler-noop.strategy.ts
+├── job-handler-with-logger.strategy.ts
+├── job-handler.strategy.ts
 ├── jobs.service.ts
-├── json-file-reader-bun-forgiving.adapter.ts
-├── json-file-reader-bun.adapter.ts
-├── json-file-reader-noop.adapter.ts
-├── json-file-reader.port.ts
 ├── logger-format-error.service.ts
 ├── logger-noop.adapter.ts
 ├── logger-winston-local.adapter.ts
@@ -176,6 +186,7 @@ src/
 ├── mailer-smtp.adapter.ts
 ├── mailer.port.ts
 ├── mailer.vo.ts
+├── maintenance-mode.middleware.ts
 ├── memory-consumption.service.ts
 ├── modules
 │   ├── history
@@ -216,6 +227,7 @@ src/
 │       ├── events
 │       │   ├── HOUR_HAS_PASSED_EVENT.ts
 │       │   ├── MINUTE_HAS_PASSED_EVENT.ts
+│       │   ├── SECURITY_VIOLATION_DETECTED_EVENT.ts
 │       └── services
 │           ├── passage-of-time-hourly.service.ts
 │           └── passage-of-time-minute.service.ts
@@ -223,60 +235,98 @@ src/
 ├── pdf-generator-noop.adapter.ts
 ├── pdf-generator.port.ts
 ├── port.vo.ts
-├── prerequisites
-│   ├── binary.ts
-│   ├── bun.ts
-│   ├── clock-drift.ts
-│   ├── dependency-vulnerabilities.ts
-│   ├── directory.ts
-│   ├── dns.ts
-│   ├── external-api.ts
-│   ├── file.ts
-│   ├── jobs.ts
-│   ├── log-file.ts
-│   ├── mailer.ts
-│   ├── memory.ts
-│   ├── node.ts
-│   ├── os.ts
-│   ├── outside-connectivity.ts
-│   ├── port.ts
-│   ├── ram.ts
-│   ├── running-user.ts
-│   ├── self.ts
-│   ├── space.ts
-│   ├── sqlite.ts
-│   ├── ssl-certificate-expiry.ts
-│   ├── timezone-utc.ts
-│   └── translations.ts
-├── prerequisites.service.ts
+├── prerequisite-runner-startup.service.ts
+├── prerequisite-verifier-binary.adapter.ts
+├── prerequisite-verifier-bun.adapter.ts
+├── prerequisite-verifier-clock-drift.adapter.ts
+├── prerequisite-verifier-dependency-vulnerabilities.adapter.ts
+├── prerequisite-verifier-directory.adapter.ts
+├── prerequisite-verifier-dns.adapter.ts
+├── prerequisite-verifier-external-api.adapter.ts
+├── prerequisite-verifier-file.adapter.ts
+├── prerequisite-verifier-jobs.adapter.ts
+├── prerequisite-verifier-log-file.adapter.ts
+├── prerequisite-verifier-mailer.adapter.ts
+├── prerequisite-verifier-memory.adapter.ts
+├── prerequisite-verifier-node.adapter.ts
+├── prerequisite-verifier-os.adapter.ts
+├── prerequisite-verifier-outside-connectivity.adapter.ts
+├── prerequisite-verifier-port.adapter.ts
+├── prerequisite-verifier-ram.adapter.ts
+├── prerequisite-verifier-running-user.adapter.ts
+├── prerequisite-verifier-self.adapter.ts
+├── prerequisite-verifier-space.adapter.ts
+├── prerequisite-verifier-sqlite.adapter.ts
+├── prerequisite-verifier-ssl-certificate-expiry.adapter.ts
+├── prerequisite-verifier-timezone-utc.adapter.ts
+├── prerequisite-verifier-translations.adapter.ts
+├── prerequisite-verifier-with-cache.adapter.ts
+├── prerequisite-verifier-with-fail-safe.adapter.ts
+├── prerequisite-verifier-with-logger.adapter.ts
+├── prerequisite-verifier-with-retry.adapter.ts
+├── prerequisite-verifier-with-timeout.adapter.ts
+├── prerequisite-verifier.decorator.ts
+├── prerequisite-verifier.port.ts
+├── prerequisite.vo.ts
 ├── recaptcha-secret-key.vo.ts
 ├── recaptcha-site-key.vo.ts
-├── redactor-compact-array.adapter.ts
-├── redactor-compact-object.adapter.ts
-├── redactor-composite.adapter.ts
-├── redactor-encrypt.adapter.ts
-├── redactor-mask.adapter.ts
-├── redactor-noop.adapter.ts
-├── redactor.port.ts
+├── redactor-compact-array.strategy.ts
+├── redactor-compact-object.strategy.ts
+├── redactor-composite.strategy.ts
+├── redactor-mask.strategy.ts
+├── redactor-noop.strategy.ts
+├── redactor.strategy.ts
 ├── remote-file-storage-disk.adapter.ts
 ├── remote-file-storage-noop.adapter.ts
 ├── remote-file-storage.port.ts
+├── retry-backoff-exponential.strategy.ts
+├── retry-backoff-fibonacci.strategy.ts
+├── retry-backoff-linear.strategy.ts
+├── retry-backoff-noop.strategy.ts
+├── retry-backoff.strategy.ts
+├── retry.service.ts
 ├── safe-parse-body.service.ts
-├── secret.vo.ts
+├── sealer-aes-gcm.adapter.ts
+├── sealer-noop.adapter.ts
+├── sealer.port.ts
+├── security-context.vo.ts
+├── security-countermeasure-ban.strategy.ts
+├── security-countermeasure-mirage.strategy.ts
+├── security-countermeasure-name.vo.ts
+├── security-countermeasure-noop.strategy.ts
+├── security-countermeasure-report.strategy.ts
+├── security-countermeasure-tarpit.strategy.ts
+├── security-countermeasure.strategy.ts
+├── security-policy.vo.ts
+├── security-rule-and.strategy.ts
+├── security-rule-bait-routes.strategy.ts
+├── security-rule-fail.strategy.ts
+├── security-rule-honey-pot-field.strategy.ts
+├── security-rule-name.vo.ts
+├── security-rule-or.strategy.ts
+├── security-rule-pass.strategy.ts
+├── security-rule-user-agent.strategy.ts
+├── security-rule-violation-threshold.strategy.ts
+├── security-rule.strategy.ts
 ├── setup.service.ts
-├── shield-api-key.adapter.ts
-├── shield-auth.middleware.ts
-├── shield-basic-auth.adapter.ts
-├── shield-captcha-hcaptcha-local.adapter.ts
-├── shield-captcha-hcaptcha.adapter.ts
-├── shield-captcha-recaptcha.adapter.ts
-├── shield-noop.adapter.ts
-├── shield-rate-limit.adapter.ts
-├── shield-timeout.adapter.ts
-├── shield.port.ts
+├── shield-api-key.strategy.ts
+├── shield-auth.strategy.ts
+├── shield-basic-auth.strategy.ts
+├── shield-captcha-hcaptcha-local.strategy.ts
+├── shield-captcha-hcaptcha.strategy.ts
+├── shield-captcha-recaptcha.strategy.ts
+├── shield-noop.strategy.ts
+├── shield-rate-limit.strategy.ts
+├── shield-security.strategy.ts
+├── shield-timeout.strategy.ts
+├── shield.strategy.ts
 ├── simulated-error.middleware.ts
+├── sleeper-noop.adapter.ts
+├── sleeper-system.adapter.ts
+├── sleeper.port.ts
 ├── slower.middleware.ts
 ├── static-files.service.ts
+├── stopwatch.service.ts
 ├── temporary-file-absolute.adapter.ts
 ├── temporary-file-noop.adapter.ts
 ├── temporary-file.port.ts
@@ -284,13 +334,20 @@ src/
 ├── timekeeper-google.adapter.ts
 ├── timekeeper-noop.adapter.ts
 ├── timekeeper.port.ts
-├── timeout.service.ts
+├── timeout-cancellable-runner-bare.adapter.ts
+├── timeout-cancellable-runner-noop.adapter.ts
+├── timeout-cancellable-runner.port.ts
+├── timeout-runner-bare.adapter.ts
+├── timeout-runner-error.adapter.ts
+├── timeout-runner-monitor.adapter.ts
+├── timeout-runner-noop.adapter.ts
+├── timeout-runner.port.ts
 ├── to-event-map.types.ts
 ├── translations.service.ts
 ├── uptime.service.ts
 ├── uuid.vo.ts
-├── visitor-id-client.adapter.ts
-├── visitor-id.port.ts
+├── visitor-id-client.strategy.ts
+├── visitor-id.strategy.ts
 └── weak-etag-extractor.middleware.ts
 ```
 

package/src/api-version.middleware.ts

@@ -1,9 +1,9 @@
 import { createMiddleware } from "hono/factory";
 import { BuildInfoRepository } from "./build-info-repository.service";
 import type { ClockPort } from "./clock.port";
-import type { JsonFileReaderPort } from "./json-file-reader.port";
+import type { FileReaderJsonPort } from "./file-reader-json.port";
 
-type Dependencies = { Clock: ClockPort; JsonFileReader: JsonFileReaderPort };
+type Dependencies = { Clock: ClockPort; JsonFileReader: FileReaderJsonPort };
 
 export class ApiVersion {
   static readonly HEADER_NAME = "api-version";

package/src/binary.vo.ts

@@ -8,13 +8,13 @@ export const BinaryError = {
 };
 
 // One to sixty four letters, digits, hyphens, or underscores
-const BINARY_WHITELIST = /^[a-zA-Z0-9-_]{1,64}$/;
+const CHARS_WHITELIST = /^[a-zA-Z0-9-_]{1,64}$/;
 
 export const Binary = z
   .string(BinaryError.Type)
   .min(1, BinaryError.Empty)
   .max(64, BinaryError.TooLong)
-  .regex(BINARY_WHITELIST, BinaryError.BadChars)
+  .regex(CHARS_WHITELIST, BinaryError.BadChars)
   .brand("Binary");
 
 export type BinaryType = z.infer<typeof Binary>;

package/src/bots.vo.ts

@@ -1,3 +1,132 @@
-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)/;
+// Source: https://github.com/honojs/middleware/blob/main/packages/ua-blocker/src/generated.ts
+export const ALL_BOTS = [
+  "AddSearchBot",
+  "AI2Bot",
+  "AI2Bot-DeepResearchEval",
+  "Ai2Bot-Dolma",
+  "aiHitBot",
+  "amazon-kendra",
+  "Amazonbot",
+  "AmazonBuyForMe",
+  "Andibot",
+  "Anomura",
+  "anthropic-ai",
+  "Applebot",
+  "Applebot-Extended",
+  "atlassian-bot",
+  "Awario",
+  "bedrockbot",
+  "bigsur.ai",
+  "Bravebot",
+  "Brightbot 1.0",
+  "BuddyBot",
+  "Bytespider",
+  "CCBot",
+  "Channel3Bot",
+  "ChatGLM-Spider",
+  "ChatGPT Agent",
+  "ChatGPT-User",
+  "Claude-SearchBot",
+  "Claude-User",
+  "Claude-Web",
+  "ClaudeBot",
+  "Cloudflare-AutoRAG",
+  "CloudVertexBot",
+  "cohere-ai",
+  "cohere-training-data-crawler",
+  "Cotoyogi",
+  "Crawl4AI",
+  "Crawlspace",
+  "Datenbank Crawler",
+  "DeepSeekBot",
+  "Devin",
+  "Diffbot",
+  "DuckAssistBot",
+  "Echobot Bot",
+  "EchoboxBot",
+  "FacebookBot",
+  "facebookexternalhit",
+  "Factset_spyderbot",
+  "FirecrawlAgent",
+  "FriendlyCrawler",
+  "Gemini-Deep-Research",
+  "Google-CloudVertexBot",
+  "Google-Extended",
+  "Google-Firebase",
+  "Google-NotebookLM",
+  "GoogleAgent-Mariner",
+  "GoogleOther",
+  "GoogleOther-Image",
+  "GoogleOther-Video",
+  "GPTBot",
+  "iAskBot",
+  "iaskspider",
+  "iaskspider/2.0",
+  "IbouBot",
+  "ICC-Crawler",
+  "ImagesiftBot",
+  "imageSpider",
+  "img2dataset",
+  "ISSCyberRiskCrawler",
+  "Kangaroo Bot",
+  "KlaviyoAIBot",
+  "KunatoCrawler",
+  "laion-huggingface-processor",
+  "LAIONDownloader",
+  "LCC",
+  "LinerBot",
+  "Linguee Bot",
+  "LinkupBot",
+  "Manus-User",
+  "meta-externalagent",
+  "Meta-ExternalAgent",
+  "meta-externalfetcher",
+  "Meta-ExternalFetcher",
+  "meta-webindexer",
+  "MistralAI-User",
+  "MistralAI-User/1.0",
+  "MyCentralAIScraperBot",
+  "netEstate Imprint Crawler",
+  "NotebookLM",
+  "NovaAct",
+  "OAI-SearchBot",
+  "omgili",
+  "omgilibot",
+  "OpenAI",
+  "Operator",
+  "PanguBot",
+  "Panscient",
+  "panscient.com",
+  "Perplexity-User",
+  "PerplexityBot",
+  "PetalBot",
+  "PhindBot",
+  "Poggio-Citations",
+  "Poseidon Research Crawler",
+  "QualifiedBot",
+  "QuillBot",
+  "quillbot.com",
+  "SBIntuitionsBot",
+  "Scrapy",
+  "SemrushBot-OCOB",
+  "SemrushBot-SWA",
+  "ShapBot",
+  "Sidetrade indexer bot",
+  "Spider",
+  "TerraCotta",
+  "Thinkbot",
+  "TikTokSpider",
+  "Timpibot",
+  "TwinAgent",
+  "VelenPublicWebCrawler",
+  "WARDBot",
+  "Webzio-Extended",
+  "webzio-extended",
+  "wpbot",
+  "WRTNBot",
+  "YaK",
+  "YandexAdditional",
+  "YandexAdditionalBot",
+  "YouBot",
+  "ZanistaBot",
+];

package/src/build-info-repository.service.ts

@@ -1,14 +1,14 @@
 import * as tools from "@bgord/tools";
 import type { ClockPort } from "./clock.port";
-import type { JsonFileReaderPort } from "./json-file-reader.port";
+import type { FileReaderJsonPort } from "./file-reader-json.port";
 
 export type BuildInfoType = { BUILD_DATE: tools.TimestampValueType; BUILD_VERSION?: string };
 
-type Dependencies = { Clock: ClockPort; JsonFileReader: JsonFileReaderPort };
+type Dependencies = { Clock: ClockPort; JsonFileReader: FileReaderJsonPort };
 
 export class BuildInfoRepository {
   static async extract(deps: Dependencies): Promise<BuildInfoType> {
-    const BUILD_DATE = deps.Clock.nowMs();
+    const BUILD_DATE = deps.Clock.now().ms;
 
     try {
       const packageJson = await deps.JsonFileReader.read("package.json");

package/src/cache-repository-lru-cache.adapter.ts

@@ -0,0 +1,32 @@
+import { LRUCache } from "lru-cache";
+import type { CacheRepositoryPort, CacheRepositoryTtlType } from "./cache-repository.port";
+import type { Hash } from "./hash.vo";
+import type { HashValueType } from "./hash-value.vo";
+
+export class CacheRepositoryLruCacheAdapter implements CacheRepositoryPort {
+  private readonly store;
+
+  constructor(config: CacheRepositoryTtlType) {
+    this.store = new LRUCache<HashValueType, any>({
+      max: 100_000,
+      ttl: config.type === "finite" ? config.ttl.ms : undefined,
+      ttlAutopurge: true,
+    });
+  }
+
+  async get<T>(subject: Hash): Promise<T | null> {
+    return (this.store.get(subject.get()) as T) ?? null;
+  }
+
+  async set<T>(subject: Hash, value: T) {
+    this.store.set(subject.get(), value);
+  }
+
+  async delete(subject: Hash) {
+    this.store.delete(subject.get());
+  }
+
+  async flush() {
+    this.store.clear();
+  }
+}