@bgord/bun 1.6.7 → 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.7",
+  "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,26 +39,30 @@
     "zod": "4.2.1"
   },
   "dependencies": {
-    "@bgord/tools": "1.2.3",
-    "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",
+    "hono": "4.11.3",
     "lodash": "4.17.21",
     "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,61 +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-user-agent-blocker.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
@@ -285,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/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();
+  }
+}

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

@@ -1,15 +1,13 @@
-import type * as tools from "@bgord/tools";
 import NodeCache from "node-cache";
-import type { CacheRepositoryPort } from "./cache-repository.port";
+import type { CacheRepositoryPort, CacheRepositoryTtlType } from "./cache-repository.port";
 import type { Hash } from "./hash.vo";
 
 export class CacheRepositoryNodeCacheAdapter implements CacheRepositoryPort {
   private readonly store: NodeCache;
 
-  constructor(private readonly config: { ttl: tools.Duration }) {
+  constructor(config: CacheRepositoryTtlType) {
     this.store = new NodeCache({
-      stdTTL: config.ttl.seconds,
-      checkperiod: config.ttl.seconds,
+      stdTTL: config.type === "finite" ? config.ttl.seconds : 0,
       deleteOnExpire: true,
       maxKeys: 100_000,
       useClones: false,
@@ -31,8 +29,4 @@ export class CacheRepositoryNodeCacheAdapter implements CacheRepositoryPort {
   async flush() {
     this.store.flushAll();
   }
-
-  get ttl() {
-    return this.config.ttl;
-  }
 }

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

@@ -1,8 +1,7 @@
-import type * as tools from "@bgord/tools";
-import type { CacheRepositoryPort } from "./cache-repository.port";
+import type { CacheRepositoryPort, CacheRepositoryTtlType } from "./cache-repository.port";
 
 export class CacheRepositoryNoopAdapter implements CacheRepositoryPort {
-  constructor(private readonly config: { ttl: tools.Duration }) {}
+  constructor(_config: CacheRepositoryTtlType) {}
 
   async get<T>(): Promise<T | null> {
     return null;
@@ -13,8 +12,4 @@ export class CacheRepositoryNoopAdapter implements CacheRepositoryPort {
   async delete() {}
 
   async flush() {}
-
-  get ttl() {
-    return this.config.ttl;
-  }
 }

package/src/cache-repository.port.ts

@@ -1,10 +1,11 @@
 import type * as tools from "@bgord/tools";
 import type { Hash } from "./hash.vo";
 
+export type CacheRepositoryTtlType = { type: "finite"; ttl: tools.Duration } | { type: "infinite" };
+
 export interface CacheRepositoryPort {
   get<T>(subject: Hash): Promise<T | null>;
   set<T>(subject: Hash, value: T): Promise<void>;
   delete(subject: Hash): Promise<void>;
   flush(): Promise<void>;
-  get ttl(): tools.Duration;
 }

package/src/cache-resolver-simple.strategy.ts

@@ -0,0 +1,33 @@
+import type { CacheRepositoryPort } from "./cache-repository.port";
+import { type CacheResolverStrategy, CacheSourceEnum } from "./cache-resolver.strategy";
+import type { Hash } from "./hash.vo";
+
+type Dependencies = { CacheRepository: CacheRepositoryPort };
+
+export class CacheResolverSimpleStrategy implements CacheResolverStrategy {
+  constructor(private readonly deps: Dependencies) {}
+
+  async resolve<T>(subject: Hash, producer: () => Promise<T>): Promise<T> {
+    const result = await this.resolveWithContext(subject, producer);
+
+    return result.value;
+  }
+
+  async resolveWithContext<T>(
+    subject: Hash,
+    producer: () => Promise<T>,
+  ): Promise<{ value: T; source: CacheSourceEnum }> {
+    const cached = await this.deps.CacheRepository.get<T>(subject);
+
+    if (cached !== null) return { value: cached, source: CacheSourceEnum.hit };
+
+    const value = await producer();
+    await this.deps.CacheRepository.set(subject, value);
+
+    return { value, source: CacheSourceEnum.miss };
+  }
+
+  async flush() {
+    await this.deps.CacheRepository.flush();
+  }
+}

package/src/cache-resolver.strategy.ts

@@ -0,0 +1,17 @@
+import type { Hash } from "./hash.vo";
+
+export enum CacheSourceEnum {
+  hit = "hit",
+  miss = "",
+}
+
+export interface CacheResolverStrategy {
+  resolve<T>(subject: Hash, producer: () => Promise<T>): Promise<T>;
+
+  resolveWithContext<T>(
+    subject: Hash,
+    producer: () => Promise<T>,
+  ): Promise<{ value: T; source: CacheSourceEnum }>;
+
+  flush(): Promise<void>;
+}

package/src/cache-response.middleware.ts

@@ -1,9 +1,9 @@
 import { createMiddleware } from "hono/factory";
 import type { ContentfulStatusCode } from "hono/utils/http-status";
-import type { CacheResolverPort } from "./cache-resolver.port";
+import type { CacheResolverStrategy } from "./cache-resolver.strategy";
 import type { CacheSubjectResolver } from "./cache-subject-resolver.vo";
 
-type Dependencies = { CacheResolver: CacheResolverPort };
+type Dependencies = { CacheResolver: CacheResolverStrategy };
 
 type CacheResponseOptions = { enabled: boolean; resolver: CacheSubjectResolver };