@bgord/bun 0.30.1 → 1.0.0

package/src/env-validator.service.ts

@@ -5,7 +5,7 @@ type NodeEnvironmentEnumType = z.infer<typeof NodeEnvironment>;
 type AnyZodSchema = z.ZodSchema<any, any>;
 type EnvironmentValidatorConfig = { type: unknown; schema: AnyZodSchema };
 
-export const InvalidNodeEnvironmentError = "invalid.node.environment" as const;
+export const EnvironmentValidatorError = { Invalid: "environment.validator.invalid" } as const;
 
 export class EnvironmentValidator<SchemaType> {
   type: NodeEnvironmentEnumType;
@@ -21,7 +21,7 @@ export class EnvironmentValidator<SchemaType> {
       return;
     }
 
-    throw new Error(InvalidNodeEnvironmentError);
+    throw new Error(EnvironmentValidatorError.Invalid);
   }
 
   load(): SchemaType & { type: NodeEnvironmentEnumType } {

package/src/etag-extractor.middleware.ts

@@ -6,11 +6,11 @@ export type EtagVariables = { ETag: tools.ETag | null; WeakETag: tools.WeakETag
 export class ETagExtractor {
   static attach = createMiddleware<{ Variables: EtagVariables }>(async (c, next) => {
     try {
-      const header = String(c.req.header(tools.ETag.IF_MATCH_HEADER_NAME));
+      const header = c.req.header(tools.ETag.IF_MATCH_HEADER_NAME);
 
       if (!header || header === "undefined") c.set("ETag", null);
       else c.set("ETag", tools.ETag.fromHeader(header));
-    } catch (_error) {
+    } catch {
       c.set("ETag", null);
     }
 

package/src/event-store-like.types.ts

@@ -1,4 +1,5 @@
 export type EventStoreLike<E extends { name: string }> = {
   save(events: E[]): Promise<unknown>;
+
   saveAfter(events: E[], delay: { ms: number }): Promise<unknown>;
 };

package/src/event-stream.vo.ts

@@ -1,9 +1,14 @@
 import { z } from "zod/v4";
 
-export const EventStreamInvalidError = { error: "event.stream.invalid.error" } as const;
+export const EventStreamError = {
+  Type: "event.store.type",
+  Empty: "event.stream.empty",
+  TooLong: "event.stream.too.long",
+} as const;
 
 export const EventStream = z
-  .string(EventStreamInvalidError)
-  .min(1, EventStreamInvalidError)
-  .max(256, EventStreamInvalidError);
+  .string(EventStreamError.Type)
+  .min(1, EventStreamError.Empty)
+  .max(256, EventStreamError.TooLong);
+
 export type EventStreamType = z.infer<typeof EventStream>;

package/src/file-cleaner-bun-forgiving.adapter.ts

@@ -0,0 +1,10 @@
+import type * as tools from "@bgord/tools";
+import type { FileCleanerPort } from "./file-cleaner.port";
+
+export class FileCleanerBunForgivingAdapter implements FileCleanerPort {
+  async delete(path: tools.FilePathRelative | tools.FilePathAbsolute | string): Promise<void> {
+    try {
+      await Bun.file(typeof path === "string" ? path : path.get()).delete();
+    } catch {}
+  }
+}

package/src/file-cleaner-bun.adapter.ts

@@ -0,0 +1,8 @@
+import type * as tools from "@bgord/tools";
+import type { FileCleanerPort } from "./file-cleaner.port";
+
+export class FileCleanerBunAdapter implements FileCleanerPort {
+  async delete(path: tools.FilePathRelative | tools.FilePathAbsolute | string): Promise<void> {
+    await Bun.file(typeof path === "string" ? path : path.get()).delete();
+  }
+}

package/src/file-cleaner-noop.adapter.ts

@@ -0,0 +1,6 @@
+import type * as tools from "@bgord/tools";
+import type { FileCleanerPort } from "./file-cleaner.port";
+
+export class FileCleanerNoopAdapter implements FileCleanerPort {
+  async delete(_path: tools.FilePathRelative | tools.FilePathAbsolute | string): Promise<void> {}
+}

package/src/file-cleaner.port.ts

@@ -0,0 +1,5 @@
+import type * as tools from "@bgord/tools";
+
+export interface FileCleanerPort {
+  delete(path: tools.FilePathRelative | tools.FilePathAbsolute | string): Promise<void>;
+}

package/src/file-draft.service.ts

@@ -8,7 +8,7 @@ export abstract class FileDraft {
 
   getHeaders(): Headers {
     return new Headers({
-      "Content-Type": this.config.mime.raw,
+      "Content-Type": this.config.mime.toString(),
       "Content-Disposition": `attachment; filename="${this.config.filename}"`,
     });
   }
@@ -24,6 +24,6 @@ export abstract class FileDraft {
   async toAttachment() {
     const body = await this.create();
 
-    return { filename: this.config.filename, content: body, contentType: this.config.mime.raw };
+    return { filename: this.config.filename, content: body, contentType: this.config.mime.toString() };
   }
 }

package/src/file-renamer-fs-forgiving.adapter.ts

@@ -0,0 +1,17 @@
+import fs from "node:fs/promises";
+import type * as tools from "@bgord/tools";
+import type { FileRenamerPort } from "./file-renamer.port";
+
+export class FileRenamerFsForgivingAdapter implements FileRenamerPort {
+  async rename(
+    input: tools.FilePathRelative | tools.FilePathAbsolute | string,
+    output: tools.FilePathRelative | tools.FilePathAbsolute | string,
+  ): Promise<void> {
+    const from = typeof input === "string" ? input : input.get();
+    const to = typeof output === "string" ? output : output.get();
+
+    try {
+      await fs.rename(from, to);
+    } catch {}
+  }
+}

package/src/file-renamer-fs.adapter.ts

@@ -0,0 +1,15 @@
+import fs from "node:fs/promises";
+import type * as tools from "@bgord/tools";
+import type { FileRenamerPort } from "./file-renamer.port";
+
+export class FileRenamerFsAdapter implements FileRenamerPort {
+  async rename(
+    input: tools.FilePathRelative | tools.FilePathAbsolute | string,
+    output: tools.FilePathRelative | tools.FilePathAbsolute | string,
+  ): Promise<void> {
+    const from = typeof input === "string" ? input : input.get();
+    const to = typeof output === "string" ? output : output.get();
+
+    await fs.rename(from, to);
+  }
+}

package/src/file-renamer-noop.adapter.ts

@@ -0,0 +1,9 @@
+import type * as tools from "@bgord/tools";
+import type { FileRenamerPort } from "./file-renamer.port";
+
+export class FileRenamerNoopAdapter implements FileRenamerPort {
+  async rename(
+    _input: tools.FilePathRelative | tools.FilePathAbsolute | string,
+    _output: tools.FilePathRelative | tools.FilePathAbsolute | string,
+  ): Promise<void> {}
+}

package/src/file-renamer.port.ts

@@ -0,0 +1,8 @@
+import type * as tools from "@bgord/tools";
+
+export interface FileRenamerPort {
+  rename(
+    input: tools.FilePathRelative | tools.FilePathAbsolute | string,
+    output: tools.FilePathRelative | tools.FilePathAbsolute | string,
+  ): Promise<void>;
+}

package/src/graceful-shutdown.service.ts

@@ -29,9 +29,7 @@ export class GracefulShutdown {
       .catch((error) =>
         this.logger.error({ message: "Cleanup hook failed", error: formatError(error), ...this.base }),
       )
-      .finally(() => {
-        this.exitFn(exitCode);
-      });
+      .finally(() => this.exitFn(exitCode));
   }
 
   applyTo(server: ServerType, cleanup: () => any = tools.noop) {

package/src/hcaptcha-secret-key.vo.ts

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+
+export const HCaptchaSecretKeyError = {
+  Type: "hcaptcha.secret.key.type",
+  Length: "hcaptcha.secret.key.length",
+} as const;
+
+export const HCaptchaSecretKey = z
+  .string(HCaptchaSecretKeyError.Type)
+  .length(42, HCaptchaSecretKeyError.Length)
+  .brand("HCaptchaSecretKey");
+
+export type HCaptchaSecretKeyType = z.infer<typeof HCaptchaSecretKey>;

package/src/hcaptcha-site-key.vo.ts

@@ -0,0 +1,13 @@
+import { z } from "zod/v4";
+
+export const HCaptchaSiteKeyError = {
+  Type: "hcaptcha.site.key.type",
+  Length: "hcaptcha.site.key.length",
+} as const;
+
+export const HCaptchaSiteKey = z
+  .string(HCaptchaSiteKeyError.Type)
+  .length(36, HCaptchaSiteKeyError.Length)
+  .brand("HCaptchaSiteKey");
+
+export type HCaptchaSiteKeyType = z.infer<typeof HCaptchaSiteKey>;

package/src/healthcheck.service.ts

@@ -2,6 +2,8 @@ import * as tools from "@bgord/tools";
 import { createFactory } 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 { LoggerPort } from "./logger.port";
 import { MemoryConsumption } from "./memory-consumption.service";
 import * as prereqs from "./prerequisites.service";
 import { Uptime, type UptimeResultType } from "./uptime.service";
@@ -17,14 +19,14 @@ type HealthcheckResultType = {
   durationMs: tools.Duration["ms"];
 };
 
-type Dependencies = { Clock: ClockPort };
+type Dependencies = { Clock: ClockPort; JsonFileReader: JsonFileReaderPort; Logger: LoggerPort };
 
 export class Healthcheck {
   static build = (prerequisites: prereqs.Prerequisite[], deps: Dependencies) =>
     handler.createHandlers(async (c) => {
       const stopwatch = new tools.Stopwatch(deps.Clock.nowMs());
 
-      const build = await BuildInfoRepository.extract(deps);
+      const buildInfo = await BuildInfoRepository.extract(deps);
 
       const details: HealthcheckResultType["details"][number][] = [];
 
@@ -41,11 +43,11 @@ export class Healthcheck {
       const result: HealthcheckResultType = {
         ok,
         details,
-        version: build.BUILD_VERSION ?? "unknown",
+        version: buildInfo.BUILD_VERSION ?? "unknown",
         uptime: Uptime.get(deps.Clock),
         memory: {
           bytes: MemoryConsumption.get().toBytes(),
-          formatted: MemoryConsumption.get().format(tools.SizeUnit.MB),
+          formatted: MemoryConsumption.get().format(tools.Size.unit.MB),
         },
         durationMs: stopwatch.stop().ms,
       };

package/src/http-logger.middleware.ts

@@ -3,9 +3,8 @@ import { createMiddleware } from "hono/factory";
 import _ from "lodash";
 import { CacheHitEnum } from "./cache-resolver.service";
 import { CacheResponse } from "./cache-response.middleware";
-import { ClientFromHono } from "./client-from-hono.adapter";
+import { ClientFromHonoAdapter } from "./client-from-hono.adapter";
 import type { ClockPort } from "./clock.port";
-import type { CorrelationIdType } from "./correlation-id.vo";
 import type { LoggerPort } from "./logger.port";
 
 const UNINFORMATIVE_HEADERS = [
@@ -36,8 +35,8 @@ export type HttpLoggerOptions = { skip?: readonly string[] };
 
 export class HttpLogger {
   static build = (deps: Dependencies, options?: HttpLoggerOptions) =>
-    createMiddleware(async (c, next) => {
-      const request = c.req.raw.clone();
+    createMiddleware(async (context, next) => {
+      const request = context.req.raw.clone();
 
       const pathname = new URL(request.url).pathname;
 
@@ -46,15 +45,15 @@ export class HttpLogger {
         return;
       }
 
-      const correlationId = c.get("requestId") as CorrelationIdType;
-      const client = ClientFromHono.extract(c).toJSON();
+      const correlationId = context.get("requestId");
+      const client = ClientFromHonoAdapter.extract(context).toJSON();
 
       const httpRequestBeforeMetadata = {
-        params: c.req.param(),
+        params: context.req.param(),
         // @ts-expect-error
         headers: _.omit(Object.fromEntries(request.headers), UNINFORMATIVE_HEADERS),
         body: await HttpLogger.parseJSON(request),
-        query: c.req.queries(),
+        query: context.req.queries(),
       };
 
       deps.Logger.http({
@@ -72,7 +71,7 @@ export class HttpLogger {
       await next();
       const duration = stopwatch.stop();
 
-      const response = c.res.clone();
+      const response = context.res.clone();
 
       deps.Logger.http({
         component: "http",
@@ -93,7 +92,7 @@ export class HttpLogger {
     let result: any;
     try {
       result = await resource.json();
-    } catch (_error) {}
+    } catch {}
 
     return result;
   }

package/src/i18n.service.ts

@@ -1,4 +1,5 @@
 import * as tools from "@bgord/tools";
+import type { JsonFileReaderPort } from "../src/json-file-reader.port";
 import type { LoggerPort } from "../src/logger.port";
 
 export type TranslationsKeyType = string;
@@ -14,29 +15,30 @@ export type I18nConfigType = {
   defaultLanguage?: string;
 };
 
+type Dependencies = { JsonFileReader: JsonFileReaderPort; Logger: LoggerPort };
+
 export class I18n {
   private readonly base = { component: "infra", operation: "translations" };
 
   static DEFAULT_TRANSLATIONS_PATH = tools.DirectoryPathRelativeSchema.parse("infra/translations");
 
-  constructor(private translationsPath: tools.DirectoryPathRelativeType = I18n.DEFAULT_TRANSLATIONS_PATH) {}
+  constructor(
+    private readonly deps: Dependencies,
+    private translationsPath: tools.DirectoryPathRelativeType = I18n.DEFAULT_TRANSLATIONS_PATH,
+  ) {}
 
   async getTranslations(language: tools.LanguageType): Promise<TranslationsType> {
-    try {
-      return Bun.file(this.getTranslationPathForLanguage(language).get()).json();
-    } catch (_error) {
-      return {};
-    }
+    return this.deps.JsonFileReader.read(this.getTranslationPathForLanguage(language));
   }
 
-  useTranslations(logger: LoggerPort, translations: TranslationsType) {
+  useTranslations(translations: TranslationsType) {
     const that = this;
 
     return function translate(key: TranslationsKeyType, variables?: TranslationVariableType) {
       const translation = translations[key];
 
       if (!translation) {
-        logger.warn({ message: `Missing translation for key ${key}`, ...that.base });
+        that.deps.Logger.warn({ message: `Missing translation for key ${key}`, ...that.base });
         return key;
       }
 
@@ -50,8 +52,9 @@ export class I18n {
   }
 
   getTranslationPathForLanguage(language: tools.LanguageType): tools.FilePathRelative {
-    const filename = tools.Filename.fromParts(language, "json");
-
-    return tools.FilePathRelative.fromParts(this.translationsPath, filename);
+    return tools.FilePathRelative.fromParts(
+      this.translationsPath,
+      tools.Filename.fromParts(language, "json"),
+    );
   }
 }

package/src/id-provider-deterministic.adapter.ts

@@ -1,6 +1,10 @@
 import type { IdProviderPort } from "./id-provider.port";
 import type { UUIDType } from "./uuid.vo";
 
+export const IdProviderDeterministicAdapterError = {
+  SequenceExhausted: "id.provider.deterministic.adapter.sequence.exhausted",
+} as const;
+
 export class IdProviderDeterministicAdapter implements IdProviderPort {
   private readonly queue: UUIDType[];
 
@@ -11,7 +15,7 @@ export class IdProviderDeterministicAdapter implements IdProviderPort {
   generate(): string {
     const next = this.queue.shift();
 
-    if (!next) throw new Error("IdProviderDeterministicAdapter: sequence exhausted");
+    if (!next) throw new Error(IdProviderDeterministicAdapterError.SequenceExhausted);
     return next;
   }
 }

package/src/image-alpha-sharp.adapter.ts

@@ -1,15 +1,19 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageAlphaPort, ImageAlphaStrategy } from "./image-alpha.port";
 
+type Dependencies = { FileRenamer: FileRenamerPort };
+
 export class ImageAlphaSharpAdapter implements ImageAlphaPort {
+  constructor(private readonly deps: Dependencies) {}
+
   async flatten(recipe: ImageAlphaStrategy) {
     const final = recipe.strategy === "output_path" ? recipe.output : recipe.input;
 
     const filename = final.getFilename();
     const temporary = final.withFilename(filename.withSuffix("-flattened"));
 
-    const extension = String(final.getFilename().getExtension());
+    const extension = final.getFilename().getExtension();
     const format = (extension === "jpg" ? "jpeg" : extension) as keyof sharp.FormatEnum;
 
     const pipeline = sharp(recipe.input.get());
@@ -20,8 +24,7 @@ export class ImageAlphaSharpAdapter implements ImageAlphaPort {
       .flatten({ background: recipe.background })
       .toFormat(format)
       .toFile(temporary.get());
-
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     return final;
   }

package/src/image-blur-sharp.adapter.ts

@@ -1,23 +1,26 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageBlurPort, ImageBlurStrategy } from "./image-blur.port";
 
+type Dependencies = { FileRenamer: FileRenamerPort };
+
 export class ImageBlurSharpAdapter implements ImageBlurPort {
+  constructor(private readonly deps: Dependencies) {}
+
   async blur(recipe: ImageBlurStrategy) {
     const final = recipe.strategy === "output_path" ? recipe.output : recipe.input;
 
     const filename = final.getFilename();
     const temporary = final.withFilename(filename.withSuffix("-blurred"));
 
-    const extension = String(final.getFilename().getExtension());
+    const extension = final.getFilename().getExtension();
     const format = (extension === "jpg" ? "jpeg" : extension) as keyof sharp.FormatEnum;
 
     const pipeline = sharp(recipe.input.get());
     using _sharp_ = { [Symbol.dispose]: () => pipeline.destroy() };
 
     await pipeline.rotate().blur(recipe.sigma).toFormat(format).toFile(temporary.get());
-
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     return final;
   }

package/src/image-compressor-sharp.adapter.ts

@@ -1,8 +1,12 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageCompressorPort, ImageCompressorStrategy } from "./image-compressor.port";
 
+type Dependencies = { FileRenamer: FileRenamerPort };
+
 export class ImageCompressorSharpAdapter implements ImageCompressorPort {
+  constructor(private readonly deps: Dependencies) {}
+
   private static readonly DEFAULT_QUALITY = 85;
 
   async compress(recipe: ImageCompressorStrategy) {
@@ -19,7 +23,7 @@ export class ImageCompressorSharpAdapter implements ImageCompressorPort {
     using _sharp_ = { [Symbol.dispose]: () => pipeline.destroy() };
 
     await pipeline.rotate().toFormat(format, { quality }).toFile(temporary.get());
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     return final;
   }

package/src/image-exif-clear-sharp.adapter.ts

@@ -1,8 +1,12 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageExifClearPort, ImageExifClearStrategy } from "./image-exif-clear.port";
 
+type Dependencies = { FileRenamer: FileRenamerPort };
+
 export class ImageExifClearSharpAdapter implements ImageExifClearPort {
+  constructor(private readonly deps: Dependencies) {}
+
   async clear(recipe: ImageExifClearStrategy) {
     const final = recipe.strategy === "output_path" ? recipe.output : recipe.input;
 
@@ -13,7 +17,7 @@ export class ImageExifClearSharpAdapter implements ImageExifClearPort {
     using _sharp_ = { [Symbol.dispose]: () => pipeline.destroy() };
 
     await pipeline.rotate().toFile(temporary.get());
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     return final;
   }

package/src/image-formatter-sharp.adapter.ts

@@ -1,8 +1,13 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileCleanerPort } from "./file-cleaner.port";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageFormatterPort, ImageFormatterStrategy } from "./image-formatter.port";
 
+type Dependencies = { FileCleaner: FileCleanerPort; FileRenamer: FileRenamerPort };
+
 export class ImageFormatterSharpAdapter implements ImageFormatterPort {
+  constructor(private readonly deps: Dependencies) {}
+
   async format(recipe: ImageFormatterStrategy) {
     const final =
       recipe.strategy === "output_path"
@@ -11,17 +16,17 @@ export class ImageFormatterSharpAdapter implements ImageFormatterPort {
 
     const temporary = final.withFilename(final.getFilename().withSuffix("-formatted"));
 
-    const finalExtension = String(final.getFilename().getExtension());
-    const encoder = (finalExtension === "jpg" ? "jpeg" : finalExtension) as keyof sharp.FormatEnum;
+    const extension = final.getFilename().getExtension();
+    const encoder = (extension === "jpg" ? "jpeg" : extension) as keyof sharp.FormatEnum;
 
     const pipeline = sharp((recipe.strategy === "output_path" ? recipe.input : recipe.input).get());
     using _sharp_ = { [Symbol.dispose]: () => pipeline.destroy() };
 
     await pipeline.toFormat(encoder).toFile(temporary.get());
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     if (recipe.strategy === "in_place" && final.get() !== recipe.input.get()) {
-      await fs.unlink(recipe.input.get());
+      await this.deps.FileCleaner.delete(recipe.input.get());
     }
 
     return final;

package/src/image-info-sharp.adapter.ts

@@ -6,22 +6,16 @@ export class ImageInfoSharpAdapter implements ImageInfoPort {
   async inspect(filePath: tools.FilePathRelative | tools.FilePathAbsolute) {
     const path = filePath.get();
 
-    const image = sharp(path);
+    const pipeline = sharp(path);
+    using _sharp_ = { [Symbol.dispose]: () => pipeline.destroy() };
 
-    using _sharp_ = {
-      [Symbol.dispose]: () => image.destroy(),
-    };
-
-    const metadata = await image.metadata();
-    const extension = tools.Extension.parse(metadata.format);
-
-    const sizeBytes = Bun.file(path).size;
+    const metadata = await pipeline.metadata();
 
     return {
       width: tools.ImageWidth.parse(metadata.width),
       height: tools.ImageHeight.parse(metadata.height),
-      mime: tools.Mime.fromExtension(extension),
-      size: tools.Size.fromBytes(sizeBytes),
+      mime: tools.Mime.fromExtension(tools.Extension.parse(metadata.format)),
+      size: tools.Size.fromBytes(Bun.file(path).size),
     };
   }
 }

package/src/image-processor-sharp.adapter.ts

@@ -1,11 +1,16 @@
-import fs from "node:fs/promises";
 import type * as tools from "@bgord/tools";
 import sharp from "sharp";
+import type { FileCleanerPort } from "./file-cleaner.port";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageProcessorPort, ImageProcessorStrategy } from "./image-processor.port";
 
+type Dependencies = { FileCleaner: FileCleanerPort; FileRenamer: FileRenamerPort };
+
 export class ImageProcessorSharpAdapter implements ImageProcessorPort {
   private static readonly DEFAULT_QUALITY = 85;
 
+  constructor(private readonly deps: Dependencies) {}
+
   async process(recipe: ImageProcessorStrategy): Promise<tools.FilePathRelative | tools.FilePathAbsolute> {
     const final =
       recipe.strategy === "output_path"
@@ -14,8 +19,8 @@ export class ImageProcessorSharpAdapter implements ImageProcessorPort {
 
     const temporary = final.withFilename(final.getFilename().withSuffix("-processed"));
 
-    const finalExtension = final.getFilename().getExtension();
-    const encoder = (finalExtension === "jpg" ? "jpeg" : finalExtension) as keyof sharp.FormatEnum;
+    const extension = final.getFilename().getExtension();
+    const encoder = (extension === "jpg" ? "jpeg" : extension) as keyof sharp.FormatEnum;
 
     const quality = recipe.quality ?? ImageProcessorSharpAdapter.DEFAULT_QUALITY;
 
@@ -38,10 +43,10 @@ export class ImageProcessorSharpAdapter implements ImageProcessorPort {
     processor = processor.toFormat(encoder, { quality });
 
     await processor.toFile(temporary.get());
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     if (recipe.strategy === "in_place" && final.get() !== recipe.input.get()) {
-      await fs.unlink(recipe.input.get());
+      await this.deps.FileCleaner.delete(recipe.input.get());
     }
 
     return final;

package/src/image-resizer-sharp.adapter.ts

@@ -1,8 +1,12 @@
-import fs from "node:fs/promises";
 import sharp from "sharp";
+import type { FileRenamerPort } from "./file-renamer.port";
 import type { ImageResizerPort, ImageResizerStrategy } from "./image-resizer.port";
 
+type Dependencies = { FileRenamer: FileRenamerPort };
+
 export class ImageResizerSharpAdapter implements ImageResizerPort {
+  constructor(private readonly deps: Dependencies) {}
+
   async resize(recipe: ImageResizerStrategy) {
     const final = recipe.strategy === "output_path" ? recipe.output : recipe.input;
     const filename = final.getFilename();
@@ -24,8 +28,7 @@ export class ImageResizerSharpAdapter implements ImageResizerPort {
       })
       .toFormat(format)
       .toFile(temporary.get());
-
-    await fs.rename(temporary.get(), final.get());
+    await this.deps.FileRenamer.rename(temporary, final);
 
     return final;
   }