@bgord/bun 1.21.11 → 1.22.0

package/dist/translations-provider-with-cache.adapter.d.ts

@@ -0,0 +1,21 @@
+import type * as tools from "@bgord/tools";
+import type { CacheResolverStrategy } from "./cache-resolver.strategy";
+import type { HashContentStrategy } from "./hash-content.strategy";
+import type { TranslationsProviderPort, TranslationsType } from "./translations-provider.port";
+type Config = {
+    id: string;
+    inner: TranslationsProviderPort;
+};
+type Dependencies = {
+    CacheResolver: CacheResolverStrategy;
+    HashContent: HashContentStrategy;
+};
+export declare class TranslationsProviderWithCacheAdapter implements TranslationsProviderPort {
+    private readonly config;
+    private readonly deps;
+    private readonly codec;
+    constructor(config: Config, deps: Dependencies);
+    getTranslationsFor(language: tools.LanguageType): Promise<TranslationsType>;
+}
+export {};
+//# sourceMappingURL=translations-provider-with-cache.adapter.d.ts.map

package/dist/translations-provider-with-cache.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-provider-with-cache.adapter.d.ts","sourceRoot":"","sources":["../src/translations-provider-with-cache.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE/F,KAAK,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,wBAAwB,CAAA;CAAE,CAAC;AAC9D,KAAK,YAAY,GAAG;IAAE,aAAa,EAAE,qBAAqB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE/F,qBAAa,oCAAqC,YAAW,wBAAwB;IAIjF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAE5E,YACmB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,YAAY,EACjC;IAEE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBhF;CACF"}

package/dist/translations-provider-with-cache.adapter.js

@@ -0,0 +1,22 @@
+import { CacheCodecIdentityStrategy } from "./cache-codec-identity.strategy";
+import { SubjectApplicationResolver } from "./subject-application-resolver.vo";
+import { SubjectSegmentFixedStrategy } from "./subject-segment-fixed.strategy";
+export class TranslationsProviderWithCacheAdapter {
+    config;
+    deps;
+    codec = new CacheCodecIdentityStrategy();
+    constructor(config, deps) {
+        this.config = config;
+        this.deps = deps;
+    }
+    async getTranslationsFor(language) {
+        const resolver = new SubjectApplicationResolver([
+            new SubjectSegmentFixedStrategy("translations_provider"),
+            new SubjectSegmentFixedStrategy(this.config.id),
+            new SubjectSegmentFixedStrategy(language),
+        ], this.deps);
+        const subject = await resolver.resolve();
+        return this.deps.CacheResolver.resolve(subject.hex, async () => this.config.inner.getTranslationsFor(language), this.codec);
+    }
+}
+//# sourceMappingURL=translations-provider-with-cache.adapter.js.map

package/dist/translations-provider-with-cache.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-provider-with-cache.adapter.js","sourceRoot":"","sources":["../src/translations-provider-with-cache.adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAG7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAM/E,MAAM,OAAO,oCAAoC;IAI5B,MAAM;IACN,IAAI;IAJN,KAAK,GAAG,IAAI,0BAA0B,EAAoB,CAAC;IAE5E,YACmB,MAAc,EACd,IAAkB;sBADlB,MAAM;oBACN,IAAI;IACpB,CAAC;IAEJ,KAAK,CAAC,kBAAkB,CAAC,QAA4B;QACnD,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAC7C;YACE,IAAI,2BAA2B,CAAC,uBAAuB,CAAC;YACxD,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/C,IAAI,2BAA2B,CAAC,QAAQ,CAAC;SAC1C,EACD,IAAI,CAAC,IAAI,CACV,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEzC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CACpC,OAAO,CAAC,GAAG,EACX,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAC1D,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;CACF"}

package/dist/uuid.vo.js

@@ -1,4 +1,5 @@
 import * as v from "valibot";
 export const UUIDError = { Type: "uuid.type" };
+// Stryker disable next-line StringLiteral
 export const UUID = v.pipe(v.string(UUIDError.Type), v.uuid(UUIDError.Type), v.brand("UUID"));
 //# sourceMappingURL=uuid.vo.js.map

package/dist/uuid.vo.js.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.vo.js","sourceRoot":"","sources":["../src/uuid.vo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,WAAW,EAAW,CAAC;AAExD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"uuid.vo.js","sourceRoot":"","sources":["../src/uuid.vo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,IAAI,EAAE,WAAW,EAAW,CAAC;AACxD,0CAA0C;AAC1C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/webhook-id-extractor-header.strategy.d.ts

@@ -0,0 +1,9 @@
+import type { HasRequestHeader } from "./request-context.port";
+import { type WebhookIdType } from "./webhook-id.vo";
+import type { WebhookIdExtractorStrategy } from "./webhook-id-extractor.strategy";
+export declare class WebhookIdExtractorHeaderStrategy implements WebhookIdExtractorStrategy {
+    private readonly header;
+    constructor(header: string);
+    extract(context: HasRequestHeader): Promise<WebhookIdType | null>;
+}
+//# sourceMappingURL=webhook-id-extractor-header.strategy.d.ts.map

package/dist/webhook-id-extractor-header.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id-extractor-header.strategy.d.ts","sourceRoot":"","sources":["../src/webhook-id-extractor-header.strategy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,qBAAa,gCAAiC,YAAW,0BAA0B;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,MAAM,EAAI;IAEzC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAItE;CACF"}

package/dist/webhook-id-extractor-header.strategy.js

@@ -0,0 +1,13 @@
+import * as v from "valibot";
+import { WebhookId } from "./webhook-id.vo";
+export class WebhookIdExtractorHeaderStrategy {
+    header;
+    constructor(header) {
+        this.header = header;
+    }
+    async extract(context) {
+        const id = v.safeParse(WebhookId, context.request.header(this.header));
+        return id.success ? id.output : null;
+    }
+}
+//# sourceMappingURL=webhook-id-extractor-header.strategy.js.map

package/dist/webhook-id-extractor-header.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id-extractor-header.strategy.js","sourceRoot":"","sources":["../src/webhook-id-extractor-header.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAsB,MAAM,iBAAiB,CAAC;AAGhE,MAAM,OAAO,gCAAgC;IACd,MAAM;IAAnC,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,OAAyB;QACrC,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAEvE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;CACF"}

package/dist/webhook-id-extractor-json-field.strategy.d.ts

@@ -0,0 +1,9 @@
+import type { HasRequestJson } from "./request-context.port";
+import { type WebhookIdType } from "./webhook-id.vo";
+import type { WebhookIdExtractorStrategy } from "./webhook-id-extractor.strategy";
+export declare class WebhookIdExtractorJsonFieldStrategy implements WebhookIdExtractorStrategy {
+    private readonly field;
+    constructor(field: string);
+    extract(context: HasRequestJson): Promise<WebhookIdType | null>;
+}
+//# sourceMappingURL=webhook-id-extractor-json-field.strategy.d.ts.map

package/dist/webhook-id-extractor-json-field.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id-extractor-json-field.strategy.d.ts","sourceRoot":"","sources":["../src/webhook-id-extractor-json-field.strategy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAElF,qBAAa,mCAAoC,YAAW,0BAA0B;IACxE,OAAO,CAAC,QAAQ,CAAC,KAAK;IAAlC,YAA6B,KAAK,EAAE,MAAM,EAAI;IAExC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAMpE;CACF"}

package/dist/webhook-id-extractor-json-field.strategy.js

@@ -0,0 +1,14 @@
+import * as v from "valibot";
+import { WebhookId } from "./webhook-id.vo";
+export class WebhookIdExtractorJsonFieldStrategy {
+    field;
+    constructor(field) {
+        this.field = field;
+    }
+    async extract(context) {
+        const body = await context.request.json();
+        const id = v.safeParse(WebhookId, body[this.field]);
+        return id.success ? id.output : null;
+    }
+}
+//# sourceMappingURL=webhook-id-extractor-json-field.strategy.js.map

package/dist/webhook-id-extractor-json-field.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id-extractor-json-field.strategy.js","sourceRoot":"","sources":["../src/webhook-id-extractor-json-field.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAsB,MAAM,iBAAiB,CAAC;AAGhE,MAAM,OAAO,mCAAmC;IACjB,KAAK;IAAlC,YAA6B,KAAa;qBAAb,KAAK;IAAW,CAAC;IAE9C,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAE1C,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAEpD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;CACF"}

package/dist/webhook-id-extractor.strategy.d.ts

@@ -0,0 +1,6 @@
+import type { HasRequestHeader, HasRequestJson } from "./request-context.port";
+import type { WebhookIdType } from "./webhook-id.vo";
+export interface WebhookIdExtractorStrategy {
+    extract(context: HasRequestHeader & HasRequestJson): Promise<WebhookIdType | null>;
+}
+//# sourceMappingURL=webhook-id-extractor.strategy.d.ts.map

package/dist/webhook-id-extractor.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id-extractor.strategy.d.ts","sourceRoot":"","sources":["../src/webhook-id-extractor.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACpF"}

package/dist/webhook-id-extractor.strategy.js

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

package/dist/webhook-id-extractor.strategy.js.map

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

package/dist/webhook-id.vo.d.ts

@@ -0,0 +1,9 @@
+import * as v from "valibot";
+export declare const WebhookIdError: {
+    Type: string;
+    Empty: string;
+    TooLong: string;
+};
+export declare const WebhookId: v.SchemaWithPipe<readonly [v.StringSchema<string>, v.MinLengthAction<string, 1, string>, v.MaxLengthAction<string, 128, string>, v.BrandAction<string, "WebhookId">]>;
+export type WebhookIdType = v.InferOutput<typeof WebhookId>;
+//# sourceMappingURL=webhook-id.vo.d.ts.map

package/dist/webhook-id.vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id.vo.d.ts","sourceRoot":"","sources":["../src/webhook-id.vo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,eAAO,MAAM,cAAc;IACzB,IAAI;IACJ,KAAK;IACL,OAAO;CACR,CAAC;AAEF,eAAO,MAAM,SAAS,uKAMrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/webhook-id.vo.js

@@ -0,0 +1,10 @@
+import * as v from "valibot";
+export const WebhookIdError = {
+    Type: "webhook.id.type",
+    Empty: "webhook.id.empty",
+    TooLong: "webhook.id.too.long",
+};
+export const WebhookId = v.pipe(v.string(WebhookIdError.Type), v.minLength(1, WebhookIdError.Empty), v.maxLength(128, WebhookIdError.TooLong), 
+// Stryker disable next-line StringLiteral
+v.brand("WebhookId"));
+//# sourceMappingURL=webhook-id.vo.js.map

package/dist/webhook-id.vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-id.vo.js","sourceRoot":"","sources":["../src/webhook-id.vo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,qBAAqB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAC7B,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAC7B,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,EACpC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC;AACxC,0CAA0C;AAC1C,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CACrB,CAAC"}

package/dist/{webhook-signature-extractor-header-exact.strategy.d.ts → webhook-signature-extractor-header.strategy.d.ts}

@@ -1,9 +1,9 @@
 import type { HasRequestHeader } from "./request-context.port";
 import { type WebhookSignatureType } from "./webhook-signature.vo";
 import type { WebhookSignatureExtractorStrategy } from "./webhook-signature-extractor.strategy";
-export declare class WebhookSignatureExtractorHeaderExactStrategy implements WebhookSignatureExtractorStrategy {
+export declare class WebhookSignatureExtractorHeaderStrategy implements WebhookSignatureExtractorStrategy {
     private readonly header;
     constructor(header: string);
     extract(context: HasRequestHeader): WebhookSignatureType | null;
 }
-//# sourceMappingURL=webhook-signature-extractor-header-exact.strategy.d.ts.map
+//# sourceMappingURL=webhook-signature-extractor-header.strategy.d.ts.map

package/dist/webhook-signature-extractor-header.strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-signature-extractor-header.strategy.d.ts","sourceRoot":"","sources":["../src/webhook-signature-extractor-header.strategy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAEhG,qBAAa,uCAAwC,YAAW,iCAAiC;IACnF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,MAAM,EAAI;IAE/C,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,IAAI,CAI9D;CACF"}

package/dist/{webhook-signature-extractor-header-exact.strategy.js → webhook-signature-extractor-header.strategy.js}

@@ -1,6 +1,6 @@
 import * as v from "valibot";
 import { WebhookSignature } from "./webhook-signature.vo";
-export class WebhookSignatureExtractorHeaderExactStrategy {
+export class WebhookSignatureExtractorHeaderStrategy {
     header;
     constructor(header) {
         this.header = header;
@@ -10,4 +10,4 @@ export class WebhookSignatureExtractorHeaderExactStrategy {
         return signature.success ? signature.output : null;
     }
 }
-//# sourceMappingURL=webhook-signature-extractor-header-exact.strategy.js.map
+//# sourceMappingURL=webhook-signature-extractor-header.strategy.js.map

package/dist/webhook-signature-extractor-header.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-signature-extractor-header.strategy.js","sourceRoot":"","sources":["../src/webhook-signature-extractor-header.strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAA6B,MAAM,wBAAwB,CAAC;AAGrF,MAAM,OAAO,uCAAuC;IACrB,MAAM;IAAnC,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAE/C,OAAO,CAAC,OAAyB;QAC/B,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAErF,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACrD,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "1.21.11",
+  "version": "1.22.0",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -20,36 +20,33 @@
     "build": "bash scripts/package-build.sh"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.8",
+    "@biomejs/biome": "2.5.10",
     "@standard-schema/spec": "1.1.0",
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/typescript-checker": "10.0.0",
-    "@types/bun": "1.3.14",
+    "@types/bun": "1.4.0",
     "@types/nodemailer": "8.0.1",
-    "@types/yazl": "3.3.1",
-    "better-auth": "1.6.29",
-    "cspell": "10.0.1",
+    "better-auth": "1.7.1",
+    "cspell": "10.1.1",
     "csv": "6.6.3",
-    "fallow": "3.16.0",
+    "fallow": "3.18.0",
     "lefthook": "2.1.10",
     "lockfile-lint": "5.0.1",
     "nodemailer": "9.0.5",
-    "publint": "0.3.23",
+    "publint": "0.3.24",
     "shellcheck": "4.1.0",
-    "typescript": "7.0.2",
-    "yazl": "3.3.1"
+    "typescript": "7.0.2"
   },
   "dependencies": {
-    "@bgord/tools": "1.6.8",
+    "@bgord/tools": "1.6.10",
     "emittery": "2.0.0",
-    "hono": "4.13.2",
+    "hono": "4.13.5",
     "node-cache": "5.1.2"
   },
   "peerDependencies": {
-    "better-auth": "1.6.29",
+    "better-auth": "1.7.1",
     "csv": "6.6.3",
-    "nodemailer": "9.0.5",
-    "yazl": "3.3.1"
+    "nodemailer": "9.0.5"
   },
   "peerDependenciesMeta": {
     "better-auth": {
@@ -60,9 +57,6 @@
     },
     "nodemailer": {
       "optional": true
-    },
-    "yazl": {
-      "optional": true
     }
   }
 }

package/readme.md

@@ -69,15 +69,18 @@ src/
 ├── binary.vo.ts
 ├── bots.vo.ts
 ├── build-info.vo.ts
+├── cache-codec-identity.strategy.ts
+├── cache-codec-sitemap-entries.strategy.ts
+├── cache-codec.strategy.ts
 ├── cache-file.service.ts
 ├── cache-repository-node-cache.adapter.ts
 ├── cache-repository-noop.adapter.ts
 ├── cache-repository-redis.adapter.ts
 ├── cache-repository.port.ts
-├── cache-resolver-simple.strategy.ts
+├── cache-resolver-noop.strategy.ts
+├── cache-resolver-read-through.strategy.ts
 ├── cache-resolver.strategy.ts
-├── cache-response-hono.middleware.ts
-├── cache-response.middleware.ts
+├── cache-value.vo.ts
 ├── certificate-inspector-noop.adapter.ts
 ├── certificate-inspector-tls.adapter.ts
 ├── certificate-inspector.port.ts
@@ -110,7 +113,7 @@ src/
 ├── 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-with-memo.adapter.ts
 ├── crypto-key-provider.port.ts
 ├── csv-stringifier-noop.adapter.ts
 ├── csv-stringifier.adapter.ts
@@ -173,7 +176,7 @@ src/
 ├── file-copier-noop.adapter.ts
 ├── file-copier.adapter.ts
 ├── file-copier.port.ts
-├── file-draft-zip.service.ts
+├── file-draft-tar-gz.service.ts
 ├── file-draft.service.ts
 ├── file-inspection-noop.adapter.ts
 ├── file-inspection.adapter.ts
@@ -233,6 +236,10 @@ src/
 ├── id-provider-crypto.adapter.ts
 ├── id-provider-deterministic.adapter.ts
 ├── id-provider.port.ts
+├── idempotency-store-cache.adapter.ts
+├── idempotency-store-noop.adapter.ts
+├── idempotency-store-with-logger.adapter.ts
+├── idempotency-store.port.ts
 ├── image-blur-noop.adapter.ts
 ├── image-blur-with-semaphore.adapter.ts
 ├── image-blur.adapter.ts
@@ -453,6 +460,7 @@ src/
 ├── randomness-math.strategy.ts
 ├── randomness-noop.strategy.ts
 ├── randomness.strategy.ts
+├── rate-limiter.service.ts
 ├── reactive-config-file-json.adapter.ts
 ├── reactive-config-noop.adapter.ts
 ├── reactive-config-with-cache.adapter.ts
@@ -623,6 +631,7 @@ src/
 ├── translations-hono.handler.ts
 ├── translations-provider-json.adapter.ts
 ├── translations-provider-noop.adapter.ts
+├── translations-provider-with-cache.adapter.ts
 ├── translations-provider.port.ts
 ├── translations.handler.ts
 ├── translator.service.ts
@@ -638,11 +647,15 @@ src/
 ├── weak-etag-extractor.strategy.ts
 ├── webhook-body-builder-text.strategy.ts
 ├── webhook-body-builder.strategy.ts
+├── webhook-id-extractor-header.strategy.ts
+├── webhook-id-extractor-json-field.strategy.ts
+├── webhook-id-extractor.strategy.ts
+├── webhook-id.vo.ts
 ├── webhook-secret.vo.ts
 ├── webhook-signature-creator-noop.strategy.ts
 ├── webhook-signature-creator-sha256.strategy.ts
 ├── webhook-signature-creator.strategy.ts
-├── webhook-signature-extractor-header-exact.strategy.ts
+├── webhook-signature-extractor-header.strategy.ts
 ├── webhook-signature-extractor.strategy.ts
 ├── webhook-signature.vo.ts
 ├── webhook-verifier-noop.strategy.ts

package/src/alert-channel-composite.adapter.ts

@@ -18,6 +18,7 @@ export class AlertChannelCompositeAdapter implements AlertChannelPort {
 
     if (results.some((result) => result.status === "fulfilled")) return;
 
+    // Stryker disable next-line ArrayDeclaration
     const reasons = results.flatMap((result) => (result.status === "rejected" ? [result.reason] : []));
 
     throw new AggregateError(reasons, AlertChannelCompositeError.AllFailed);

package/src/api-version.middleware.ts

@@ -1,5 +1,6 @@
 import type * as tools from "@bgord/tools";
 import type { BuildInfoType } from "./build-info.vo";
+import { CacheCodecIdentityStrategy } from "./cache-codec-identity.strategy";
 import type { CacheResolverStrategy } from "./cache-resolver.strategy";
 import type { HashContentStrategy } from "./hash-content.strategy";
 import type { ReactiveConfigPort } from "./reactive-config.port";
@@ -16,6 +17,7 @@ export class ApiVersionMiddleware {
   static readonly HEADER_NAME = "api-version";
 
   private readonly resolver: SubjectApplicationResolver;
+  private readonly codec = new CacheCodecIdentityStrategy<BuildInfoType>();
 
   constructor(private readonly deps: ApiVersionMiddlewareDependencies) {
     this.resolver = new SubjectApplicationResolver(
@@ -27,8 +29,10 @@ export class ApiVersionMiddleware {
   async evaluate(): Promise<tools.PackageVersionSchemaType> {
     const subject = await this.resolver.resolve();
 
-    const build = await this.deps.CacheResolver.resolve(subject.hex, async () =>
-      this.deps.BuildInfoConfig.get(),
+    const build = await this.deps.CacheResolver.resolve<BuildInfoType>(
+      subject.hex,
+      async () => this.deps.BuildInfoConfig.get(),
+      this.codec,
     );
 
     return build.version;

package/src/cache-codec-identity.strategy.ts

@@ -0,0 +1,12 @@
+import type { CacheCodecStrategy } from "./cache-codec.strategy";
+import type { CacheValueType } from "./cache-value.vo";
+
+export class CacheCodecIdentityStrategy<T extends CacheValueType> implements CacheCodecStrategy<T> {
+  encode(value: T): CacheValueType {
+    return value;
+  }
+
+  decode(raw: CacheValueType): T {
+    return raw as T;
+  }
+}

package/src/cache-codec-sitemap-entries.strategy.ts

@@ -0,0 +1,17 @@
+import type { CacheCodecStrategy } from "./cache-codec.strategy";
+import type { CacheValueType } from "./cache-value.vo";
+import { SitemapEntry } from "./sitemap-entry.vo";
+
+export const CacheCodecSitemapEntriesError = { NotAnArray: "cache.codec.sitemap.entries.not.an.array" };
+
+export class CacheCodecSitemapEntriesStrategy implements CacheCodecStrategy<ReadonlyArray<SitemapEntry>> {
+  encode(value: ReadonlyArray<SitemapEntry>): CacheValueType {
+    return value.map((entry) => entry.toJSON());
+  }
+
+  decode(raw: CacheValueType): ReadonlyArray<SitemapEntry> {
+    if (!Array.isArray(raw)) throw new Error(CacheCodecSitemapEntriesError.NotAnArray);
+
+    return raw.map((entry) => SitemapEntry.fromJSON(entry));
+  }
+}

package/src/cache-codec.strategy.ts

@@ -0,0 +1,6 @@
+import type { CacheValueType } from "./cache-value.vo";
+
+export interface CacheCodecStrategy<T> {
+  encode(value: T): CacheValueType;
+  decode(raw: CacheValueType): T;
+}

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

@@ -1,5 +1,6 @@
 import NodeCache from "node-cache";
 import type { CacheRepositoryPort, CacheRepositoryTtlType } from "./cache-repository.port";
+import type { CacheValueType } from "./cache-value.vo";
 import type { Hash } from "./hash.vo";
 
 export class CacheRepositoryNodeCacheAdapter implements CacheRepositoryPort {
@@ -10,17 +11,20 @@ export class CacheRepositoryNodeCacheAdapter implements CacheRepositoryPort {
       stdTTL: config.type === "finite" ? config.ttl.seconds : 0,
       deleteOnExpire: true,
       maxKeys: 100_000,
-      useClones: false,
     });
   }
 
-  async get<T>(subject: Hash): Promise<T | null> {
-    return this.store.get(subject.get()) ?? null;
+  async get(subject: Hash): Promise<CacheValueType | null> {
+    const value = this.store.get<string>(subject.get());
+
+    if (value === undefined) return null;
+
+    return JSON.parse(value);
   }
 
-  async set<T>(subject: Hash, value: T): Promise<void> {
+  async set(subject: Hash, value: CacheValueType): Promise<void> {
     try {
-      this.store.set(subject.get(), value);
+      this.store.set(subject.get(), JSON.stringify(value));
     } catch {}
   }
 

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

@@ -1,11 +1,12 @@
 import type { CacheRepositoryPort } from "./cache-repository.port";
+import type { CacheValueType } from "./cache-value.vo";
 import type { Hash } from "./hash.vo";
 
 export class CacheRepositoryNoopAdapter implements CacheRepositoryPort {
-  async get<T>(_subject: Hash): Promise<T | null> {
+  async get(_subject: Hash): Promise<CacheValueType | null> {
     return null;
   }
-  async set<T>(_subject: Hash, _value: T): Promise<void> {}
+  async set(_subject: Hash, _value: CacheValueType): Promise<void> {}
   async delete(_subject: Hash): Promise<void> {}
   async flush(): Promise<void> {}
 }

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

@@ -1,6 +1,7 @@
 // [BUN DEPENDENCY]
 // cSpell:ignore setex
 import type { CacheRepositoryPort, CacheRepositoryTtlType } from "./cache-repository.port";
+import type { CacheValueType } from "./cache-value.vo";
 import type { Hash } from "./hash.vo";
 
 export class CacheRepositoryRedisAdapter implements CacheRepositoryPort {
@@ -9,20 +10,22 @@ export class CacheRepositoryRedisAdapter implements CacheRepositoryPort {
     private readonly config: CacheRepositoryTtlType,
   ) {}
 
-  async get<T>(subject: Hash): Promise<T | null> {
+  async get(subject: Hash): Promise<CacheValueType | null> {
     const value = await this.client.get(subject.get());
     if (value === null) return null;
     return JSON.parse(value);
   }
 
-  async set<T>(subject: Hash, value: T): Promise<void> {
+  async set(subject: Hash, value: CacheValueType): Promise<void> {
     const serialized = JSON.stringify(value);
 
-    if (this.config.type === "finite") {
-      await this.client.setex(subject.get(), this.config.ttl.seconds, serialized);
-    } else {
-      await this.client.set(subject.get(), serialized);
-    }
+    try {
+      if (this.config.type === "finite") {
+        await this.client.setex(subject.get(), this.config.ttl.seconds, serialized);
+      } else {
+        await this.client.set(subject.get(), serialized);
+      }
+    } catch {}
   }
 
   async delete(subject: Hash): Promise<void> {

package/src/cache-repository.port.ts

@@ -1,11 +1,12 @@
 import type * as tools from "@bgord/tools";
+import type { CacheValueType } from "./cache-value.vo";
 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>;
+  get(subject: Hash): Promise<CacheValueType | null>;
+  set(subject: Hash, value: CacheValueType): Promise<void>;
   delete(subject: Hash): Promise<void>;
   flush(): Promise<void>;
 }

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

@@ -0,0 +1,11 @@
+import type { CacheCodecStrategy } from "./cache-codec.strategy";
+import type { CacheResolverStrategy } from "./cache-resolver.strategy";
+import type { Hash } from "./hash.vo";
+
+export class CacheResolverNoopStrategy implements CacheResolverStrategy {
+  async resolve<T>(_subject: Hash, producer: () => Promise<T>, _codec: CacheCodecStrategy<T>): Promise<T> {
+    return producer();
+  }
+
+  async flush(): Promise<void> {}
+}

package/src/cache-resolver-read-through.strategy.ts

@@ -0,0 +1,27 @@
+import type { CacheCodecStrategy } from "./cache-codec.strategy";
+import type { CacheRepositoryPort } from "./cache-repository.port";
+import type { CacheResolverStrategy } from "./cache-resolver.strategy";
+import type { Hash } from "./hash.vo";
+
+type Dependencies = { CacheRepository: CacheRepositoryPort };
+
+export class CacheResolverReadThroughStrategy implements CacheResolverStrategy {
+  constructor(private readonly deps: Dependencies) {}
+
+  async resolve<T>(subject: Hash, producer: () => Promise<T>, codec: CacheCodecStrategy<T>): Promise<T> {
+    try {
+      const cached = await this.deps.CacheRepository.get(subject);
+
+      if (cached !== null) return codec.decode(cached);
+    } catch {}
+
+    const value = await producer();
+    await this.deps.CacheRepository.set(subject, codec.encode(value));
+
+    return value;
+  }
+
+  async flush(): Promise<void> {
+    await this.deps.CacheRepository.flush();
+  }
+}

package/src/cache-resolver.strategy.ts

@@ -1,17 +1,8 @@
+import type { CacheCodecStrategy } from "./cache-codec.strategy";
 import type { Hash } from "./hash.vo";
 
-export enum CacheSourceEnum {
-  hit = "hit",
-  miss = "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 }>;
+  resolve<T>(subject: Hash, producer: () => Promise<T>, codec: CacheCodecStrategy<T>): Promise<T>;
 
   flush(): Promise<void>;
 }

package/src/cache-value.vo.ts

@@ -0,0 +1,9 @@
+type CacheJsonType =
+  | string
+  | number
+  | boolean
+  | null
+  | ReadonlyArray<CacheJsonType>
+  | { readonly [key: string]: CacheJsonType | undefined };
+
+export type CacheValueType = Exclude<CacheJsonType, null>;

package/src/correlation-id.vo.ts

@@ -1,6 +1,7 @@
 import * as v from "valibot";
 import { UUID } from "./uuid.vo";
 
+// Stryker disable next-line StringLiteral
 export const CorrelationId = v.pipe(UUID, v.brand("CorrelationId"));
 
 export type CorrelationIdType = v.InferOutput<typeof CorrelationId>;