@bgord/bun 1.9.0 → 1.9.2

package/src/index.ts

@@ -0,0 +1,307 @@
+export * from "./antivirus.port";
+export * from "./antivirus-clamav.adapter";
+export * from "./antivirus-noop.adapter";
+export * from "./api-version.middleware";
+export * from "./basic-auth.service";
+export * from "./basic-auth-password.vo";
+export * from "./basic-auth-username.vo";
+export * from "./better-auth-logger.service";
+export * from "./binary.vo";
+export * from "./bots.vo";
+export * from "./build-info-repository.strategy";
+export * from "./build-info-repository-file.strategy";
+export * from "./build-info-repository-noop.strategy";
+export * from "./build-info-repository-package-json.strategy";
+export * from "./cache-file.service";
+export * from "./cache-repository.port";
+export * from "./cache-repository-lru-cache.adapter";
+export * from "./cache-repository-node-cache.adapter";
+export * from "./cache-repository-noop.adapter";
+export * from "./cache-resolver.strategy";
+export * from "./cache-resolver-simple.strategy";
+export * from "./cache-response.middleware";
+export * from "./cache-subject-application-resolver.vo";
+export * from "./cache-subject-request-resolver.vo";
+export * from "./cache-subject-segment-application.strategy";
+export * from "./cache-subject-segment-build.strategy";
+export * from "./cache-subject-segment-cookie.strategy";
+export * from "./cache-subject-segment-env.strategy";
+export * from "./cache-subject-segment-fixed.strategy";
+export * from "./cache-subject-segment-header.strategy";
+export * from "./cache-subject-segment-ip.strategy";
+export * from "./cache-subject-segment-path.strategy";
+export * from "./cache-subject-segment-query.strategy";
+export * from "./cache-subject-segment-request.strategy";
+export * from "./cache-subject-segment-user.strategy";
+export * from "./certificate-inspector.port";
+export * from "./certificate-inspector-noop.adapter";
+export * from "./certificate-inspector-tls.adapter";
+export * from "./checksum.service";
+export * from "./client.vo";
+export * from "./client-from-hono.adapter";
+export * from "./client-ip.vo";
+export * from "./client-user-agent.vo";
+export * from "./clock.port";
+export * from "./clock-fixed.adapter";
+export * from "./clock-offset.adapter";
+export * from "./clock-system.adapter";
+export * from "./command.types";
+export * from "./command-envelope";
+export * from "./command-logger.service";
+export * from "./commit-sha.vo";
+export * from "./commit-sha-value.vo";
+export * from "./context.middleware";
+export * from "./correlation-id.vo";
+export * from "./correlation-storage.service";
+export * from "./crypto-key-provider.port";
+export * from "./crypto-key-provider-file.adapter";
+export * from "./crypto-key-provider-memory.adapter";
+export * from "./crypto-key-provider-noop.adapter";
+export * from "./crypto-key-provider-with-cache.adapter";
+export * from "./csv-stringifier.adapter";
+export * from "./csv-stringifier.port";
+export * from "./disk-space-checker.port";
+export * from "./disk-space-checker-bun.adapter";
+export * from "./disk-space-checker-noop.adapter";
+export * from "./dispatching-event-store";
+export * from "./encryption.port";
+export * from "./encryption-aes-gcm.adapter";
+export * from "./encryption-key.vo";
+export * from "./encryption-key-value.vo";
+export * from "./encryption-noop.adapter";
+export * from "./environment-file-parser.service";
+export * from "./environment-loader.port";
+export * from "./environment-loader-encrypted.adapter";
+export * from "./environment-loader-noop.adapter";
+export * from "./environment-loader-process.adapter";
+export * from "./environment-loader-process-safe.adapter";
+export * from "./etag-extractor.middleware";
+export * from "./event.types";
+export * from "./event-bus-like.types";
+export * from "./event-envelope";
+export * from "./event-handler.strategy";
+export * from "./event-handler-bare.strategy";
+export * from "./event-handler-noop.strategy";
+export * from "./event-handler-with-logger.strategy";
+export * from "./event-logger.service";
+export * from "./event-loop-lag.service";
+export * from "./event-loop-utilization.service";
+export * from "./event-store";
+export * from "./event-store-like.types";
+export * from "./event-stream.vo";
+export * from "./file-cleaner.port";
+export * from "./file-cleaner-bun.adapter";
+export * from "./file-cleaner-bun-forgiving.adapter";
+export * from "./file-cleaner-noop.adapter";
+export * from "./file-draft.service";
+export * from "./file-draft-zip.service";
+export * from "./file-reader-json.port";
+export * from "./file-reader-json-bun.adapter";
+export * from "./file-reader-json-bun-forgiving.adapter";
+export * from "./file-reader-json-noop.adapter";
+export * from "./file-reader-json-with-cache.adapter";
+export * from "./file-renamer.port";
+export * from "./file-renamer.port";
+export * from "./file-renamer-fs.adapter";
+export * from "./file-renamer-fs.adapter";
+export * from "./file-renamer-fs-forgiving.adapter";
+export * from "./file-renamer-fs-forgiving.adapter";
+export * from "./file-renamer-noop.adapter";
+export * from "./file-renamer-noop.adapter";
+export * from "./file-uploader.middleware";
+export * from "./graceful-shutdown.service";
+export * from "./gzip.port";
+export * from "./gzip-bun.adapter";
+export * from "./gzip-noop.adapter";
+export * from "./gzip-stream.adapter";
+export * from "./hash.vo";
+export * from "./hash-content.strategy";
+export * from "./hash-content-noop.strategy";
+export * from "./hash-content-sha256-bun.strategy";
+export * from "./hash-file.port";
+export * from "./hash-file-noop.adapter";
+export * from "./hash-file-sha256-bun.adapter";
+export * from "./hash-value.vo";
+export * from "./hcaptcha-secret-key.vo";
+export * from "./hcaptcha-site-key.vo";
+export * from "./healthcheck.service";
+export * from "./http-logger.middleware";
+export * from "./i18n.service";
+export * from "./id-provider.port";
+export * from "./id-provider-crypto.adapter";
+export * from "./id-provider-deterministic.adapter";
+export * from "./image-alpha.port";
+export * from "./image-alpha-noop.adapter";
+export * from "./image-alpha-sharp.adapter";
+export * from "./image-blur.port";
+export * from "./image-blur-noop.adapter";
+export * from "./image-blur-sharp.adapter";
+export * from "./image-compressor.port";
+export * from "./image-compressor-noop.adapter";
+export * from "./image-compressor-sharp.adapter";
+export * from "./image-exif-clear.port";
+export * from "./image-exif-clear-noop.adapter";
+export * from "./image-exif-clear-sharp.adapter";
+export * from "./image-formatter.port";
+export * from "./image-formatter-noop.adapter";
+export * from "./image-formatter-sharp.adapter";
+export * from "./image-info.port";
+export * from "./image-info-noop.adapter";
+export * from "./image-info-sharp.adapter";
+export * from "./image-processor.port";
+export * from "./image-processor-noop.adapter";
+export * from "./image-processor-sharp.adapter";
+export * from "./image-resizer.port";
+export * from "./image-resizer-noop.adapter";
+export * from "./image-resizer-sharp.adapter";
+export * from "./in-flight-requests.middleware";
+export * from "./instrumentation.service";
+export * from "./invariant.service";
+export * from "./invariant-error-handler.service";
+export * from "./job-handler.strategy";
+export * from "./job-handler-bare.strategy";
+export * from "./job-handler-noop.strategy";
+export * from "./job-handler-with-logger.strategy";
+export * from "./jobs.service";
+export * from "./logger.port";
+export * from "./logger-format-error.service";
+export * from "./logger-noop.adapter";
+export * from "./logger-winston.adapter";
+export * from "./logger-winston-local.adapter";
+export * from "./logger-winston-production.adapter";
+export * from "./mailer.port";
+export * from "./mailer-content-html.vo";
+export * from "./mailer-noop.adapter";
+export * from "./mailer-smtp.adapter";
+export * from "./mailer-smtp-with-logger.adapter";
+export * from "./mailer-subject.vo";
+export * from "./maintenance-mode.middleware";
+export * from "./memory-consumption.service";
+export * as History from "./modules/history";
+export * as Preferences from "./modules/preferences";
+export * as System from "./modules/system";
+export * from "./node-env.vo";
+export * from "./nonce-provider.port";
+export * from "./nonce-provider-crypto.adapter";
+export * from "./nonce-provider-deterministic.adapter";
+export * from "./nonce-provider-noop.adapter";
+export * from "./nonce-value.vo";
+export * from "./pdf-generator.port";
+export * from "./pdf-generator-noop.adapter";
+export * from "./ping.service";
+export * from "./port.vo";
+export * from "./prerequisite.vo";
+export * from "./prerequisite-runner-startup.service";
+export * from "./prerequisite-verifier.decorator";
+export * from "./prerequisite-verifier.port";
+export * from "./prerequisite-verifier-binary.adapter";
+export * from "./prerequisite-verifier-bun.adapter";
+export * from "./prerequisite-verifier-clock-drift.adapter";
+export * from "./prerequisite-verifier-directory.adapter";
+export * from "./prerequisite-verifier-dns.adapter";
+export * from "./prerequisite-verifier-external-api.adapter";
+export * from "./prerequisite-verifier-file.adapter";
+export * from "./prerequisite-verifier-jobs.adapter";
+export * from "./prerequisite-verifier-log-file.adapter";
+export * from "./prerequisite-verifier-mailer.adapter";
+export * from "./prerequisite-verifier-memory.adapter";
+export * from "./prerequisite-verifier-node.adapter";
+export * from "./prerequisite-verifier-os.adapter";
+export * from "./prerequisite-verifier-outside-connectivity.adapter";
+export * from "./prerequisite-verifier-port.adapter";
+export * from "./prerequisite-verifier-ram.adapter";
+export * from "./prerequisite-verifier-running-user.adapter";
+export * from "./prerequisite-verifier-self.adapter";
+export * from "./prerequisite-verifier-space.adapter";
+export * from "./prerequisite-verifier-sqlite.adapter";
+export * from "./prerequisite-verifier-ssl-certificate-expiry.adapter";
+export * from "./prerequisite-verifier-timezone-utc.adapter";
+export * from "./prerequisite-verifier-translations.adapter";
+export * from "./recaptcha-secret-key.vo";
+export * from "./recaptcha-site-key.vo";
+export * from "./redactor.strategy";
+export * from "./redactor-compact-array.strategy";
+export * from "./redactor-compact-object.strategy";
+export * from "./redactor-composite.strategy";
+// export * from "./redactor-encrypt.strategy";
+export * from "./redactor-mask.strategy";
+export * from "./redactor-noop.strategy";
+export * from "./remote-file-storage.port";
+export * from "./remote-file-storage-disk.adapter";
+export * from "./remote-file-storage-noop.adapter";
+export * from "./retry.service";
+export * from "./retry-backoff.strategy";
+export * from "./retry-backoff-exponential.strategy";
+export * from "./retry-backoff-fibonacci.strategy";
+export * from "./retry-backoff-linear.strategy";
+export * from "./retry-backoff-noop.strategy";
+export * from "./safe-parse-body.service";
+export * from "./sealer.port";
+export * from "./sealer-aes-gcm.adapter";
+export * from "./sealer-noop.adapter";
+export * from "./security-context.vo";
+export * from "./security-countermeasure.strategy";
+export * from "./security-countermeasure-ban.strategy";
+export * from "./security-countermeasure-mirage.strategy";
+export * from "./security-countermeasure-name.vo";
+export * from "./security-countermeasure-noop.strategy";
+export * from "./security-countermeasure-report.strategy";
+export * from "./security-countermeasure-tarpit.strategy";
+export * from "./security-policy.vo";
+export * from "./security-rule.strategy";
+export * from "./security-rule-and.strategy";
+export * from "./security-rule-bait-routes.strategy";
+export * from "./security-rule-fail.strategy";
+export * from "./security-rule-honey-pot-field.strategy";
+export * from "./security-rule-name.vo";
+export * from "./security-rule-or.strategy";
+export * from "./security-rule-pass.strategy";
+export * from "./security-rule-user-agent.strategy";
+export * from "./security-rule-violation-threshold.strategy";
+export * from "./setup.service";
+export * from "./shield.strategy";
+export * from "./shield-api-key.strategy";
+export * from "./shield-auth.strategy";
+export * from "./shield-basic-auth.strategy";
+export * from "./shield-csrf.strategy";
+export * from "./shield-hcaptcha.strategy";
+export * from "./shield-hcaptcha-local.strategy";
+export * from "./shield-noop.strategy";
+export * from "./shield-rate-limit.strategy";
+export * from "./shield-recaptcha.strategy";
+export * from "./shield-security.strategy";
+export * from "./shield-timeout.strategy";
+export * from "./simulated-error.middleware";
+export * from "./sleeper.port";
+export * from "./sleeper-noop.adapter";
+export * from "./sleeper-system.adapter";
+export * from "./slower.middleware";
+export * from "./smtp-host.vo";
+export * from "./smtp-pass.vo";
+export * from "./smtp-port.vo";
+export * from "./smtp-user.vo";
+export * from "./ssr";
+export * from "./static-files.service";
+export * from "./stopwatch.service";
+export * from "./temporary-file.port";
+export * from "./temporary-file-absolute.adapter";
+export * from "./temporary-file-noop.adapter";
+export * from "./time-zone-offset.middleware";
+export * from "./timekeeper.port";
+export * from "./timekeeper-google.adapter";
+export * from "./timekeeper-noop.adapter";
+export * from "./timeout-cancellable-runner.port";
+export * from "./timeout-cancellable-runner-bare.adapter";
+export * from "./timeout-cancellable-runner-noop.adapter";
+export * from "./timeout-runner.port";
+export * from "./timeout-runner-bare.adapter";
+export * from "./timeout-runner-error.adapter";
+export * from "./timeout-runner-monitor.adapter";
+export * from "./timeout-runner-noop.adapter";
+export * from "./to-event-map.types";
+export * from "./translations.service";
+export * from "./uptime.service";
+export * from "./uuid.vo";
+export * from "./visitor-id.strategy";
+export * from "./visitor-id-client.strategy";
+export * from "./weak-etag-extractor.middleware";

package/src/instrumentation.service.ts

@@ -0,0 +1,39 @@
+import type { ClockPort } from "./clock.port";
+import type { LoggerPort } from "./logger.port";
+import { Stopwatch } from "./stopwatch.service";
+
+type Dependencies = { Logger: LoggerPort; Clock: ClockPort };
+
+export class Instrumentation {
+  constructor(private readonly deps: Dependencies) {}
+
+  measure<T>(label: string, action: () => T): T {
+    const stopwatch = new Stopwatch(this.deps);
+
+    const result = action();
+
+    this.deps.Logger.info({
+      message: `${label} measurement`,
+      component: "infra",
+      operation: "instrumentation_measure",
+      metadata: { durationMs: stopwatch.stop().ms },
+    });
+
+    return result;
+  }
+
+  async measureAsync<T>(label: string, action: () => T): Promise<T> {
+    const stopwatch = new Stopwatch(this.deps);
+
+    const result = await action();
+
+    this.deps.Logger.info({
+      message: `${label} measurement`,
+      component: "infra",
+      operation: "instrumentation_measure",
+      metadata: { durationMs: stopwatch.stop().ms },
+    });
+
+    return result;
+  }
+}

package/src/invariant-error-handler.service.ts

@@ -0,0 +1,22 @@
+import type { ContentfulStatusCode } from "hono/utils/http-status";
+import { type Invariant, InvariantFailureKind } from "./invariant.service";
+
+type BaseInvariantType = Invariant<any>;
+type InvariantMessageType = BaseInvariantType["message"];
+type ErrorResponseTupleType = [{ message: InvariantMessageType; _known: true }, ContentfulStatusCode];
+
+export class InvariantErrorHandler {
+  static detect(invariants: BaseInvariantType[], error: unknown): BaseInvariantType | undefined {
+    return invariants.find((invariant) => error instanceof invariant.error);
+  }
+
+  static respond(error: BaseInvariantType): ErrorResponseTupleType {
+    const code: Record<InvariantFailureKind, ContentfulStatusCode> = {
+      [InvariantFailureKind.forbidden]: 403,
+      [InvariantFailureKind.not_found]: 404,
+      [InvariantFailureKind.precondition]: 400,
+    };
+
+    return [{ message: error.message, _known: true }, code[error.kind]];
+  }
+}

package/src/invariant.service.ts

@@ -0,0 +1,27 @@
+import type { Constructor } from "@bgord/tools";
+
+type BaseInvariantConfig = Record<string, unknown>;
+
+export enum InvariantFailureKind {
+  forbidden = "forbidden",
+  precondition = "precondition",
+  not_found = "not_found",
+}
+
+export abstract class Invariant<T extends BaseInvariantConfig> {
+  abstract passes(config: T): boolean;
+
+  abstract error: Constructor<Error>;
+
+  abstract message: string;
+
+  abstract kind: InvariantFailureKind;
+
+  throw() {
+    throw new this.error();
+  }
+
+  enforce(config: T) {
+    if (!this.passes(config)) this.throw();
+  }
+}

package/src/job-handler-bare.strategy.ts

@@ -0,0 +1,15 @@
+import { CorrelationStorage } from "./correlation-storage.service";
+import type { IdProviderPort } from "./id-provider.port";
+import type { JobHandlerStrategy, UnitOfWork } from "./job-handler.strategy";
+
+type Dependencies = { IdProvider: IdProviderPort };
+
+export class JobHandlerBareStrategy implements JobHandlerStrategy {
+  constructor(private readonly deps: Dependencies) {}
+
+  handle(uow: UnitOfWork) {
+    const correlationId = this.deps.IdProvider.generate();
+
+    return async () => CorrelationStorage.run(correlationId, async () => uow.process());
+  }
+}

package/src/job-handler-noop.strategy.ts

@@ -0,0 +1,9 @@
+import type { JobHandlerStrategy, UnitOfWork } from "./job-handler.strategy";
+
+export class JobHandlerNoopStrategy implements JobHandlerStrategy {
+  constructor() {}
+
+  handle(_uow: UnitOfWork) {
+    return async () => {};
+  }
+}

package/src/job-handler-with-logger.strategy.ts

@@ -0,0 +1,44 @@
+import type { ClockPort } from "./clock.port";
+import { CorrelationStorage } from "./correlation-storage.service";
+import type { IdProviderPort } from "./id-provider.port";
+import type { JobHandlerStrategy, UnitOfWork } from "./job-handler.strategy";
+import type { LoggerPort } from "./logger.port";
+import { formatError } from "./logger-format-error.service";
+import { Stopwatch } from "./stopwatch.service";
+
+type Dependencies = { Logger: LoggerPort; IdProvider: IdProviderPort; Clock: ClockPort };
+
+export class JobHandlerWithLoggerStrategy implements JobHandlerStrategy {
+  private readonly base = { component: "infra", operation: "job_handler" };
+
+  constructor(private readonly deps: Dependencies) {}
+
+  handle(uow: UnitOfWork) {
+    const correlationId = this.deps.IdProvider.generate();
+
+    return async () => {
+      const stopwatch = new Stopwatch(this.deps);
+
+      try {
+        this.deps.Logger.info({ message: `${uow.label} start`, correlationId, ...this.base });
+
+        await CorrelationStorage.run(correlationId, async () => uow.process());
+
+        this.deps.Logger.info({
+          message: `${uow.label} success`,
+          correlationId,
+          metadata: stopwatch.stop(),
+          ...this.base,
+        });
+      } catch (error) {
+        this.deps.Logger.error({
+          message: `${uow.label} error`,
+          correlationId,
+          error: formatError(error),
+          metadata: stopwatch.stop(),
+          ...this.base,
+        });
+      }
+    };
+  }
+}

package/src/job-handler.strategy.ts

@@ -0,0 +1,10 @@
+import type { JobNameType } from "./jobs.service";
+
+export interface UnitOfWork {
+  label: JobNameType;
+  process: () => Promise<void>;
+}
+
+export interface JobHandlerStrategy {
+  handle(uow: UnitOfWork): () => Promise<void>;
+}

package/src/jobs.service.ts

@@ -0,0 +1,16 @@
+import type { Cron } from "croner";
+
+export type JobNameType = string;
+export type MultipleJobsType = Record<JobNameType, Cron>;
+
+export class Jobs {
+  static SCHEDULES = { EVERY_MINUTE: "* * * * *", EVERY_HOUR: "0 * * * *" };
+
+  static stopAll(jobs: MultipleJobsType) {
+    Object.values(jobs).forEach((job) => job.stop());
+  }
+
+  static areAllRunning(jobs: MultipleJobsType): boolean {
+    return Object.values(jobs).every((job) => job.isRunning());
+  }
+}

package/src/logger-format-error.service.ts

@@ -0,0 +1,27 @@
+// Stryker disable all
+import type { ErrorInfo } from "./logger.port";
+
+export function formatError(error: unknown): ErrorInfo {
+  if (error instanceof Error) {
+    const code = (error as any)?.code;
+    const cause = error?.cause;
+
+    return {
+      name: error.name ?? "Error",
+      message: error.message ?? "Unknown error",
+      stack: error.stack,
+      code: code ?? undefined,
+      cause:
+        cause instanceof Error
+          ? { name: cause.name, message: cause.message }
+          : typeof cause === "string"
+            ? { message: cause }
+            : undefined,
+    };
+  }
+  return {
+    name: "NonErrorThrown",
+    message: typeof error === "string" ? error : String(error),
+  };
+}
+// Stryker restore all

package/src/logger-noop.adapter.ts

@@ -0,0 +1,17 @@
+import type { LoggerPort } from "./logger.port";
+
+export class LoggerNoopAdapter implements LoggerPort {
+  warn: LoggerPort["warn"] = (_log) => {};
+  error: LoggerPort["error"] = (_log) => {};
+  info: LoggerPort["info"] = (_log) => {};
+  http: LoggerPort["http"] = (_log) => {};
+  verbose: LoggerPort["verbose"] = (_log) => {};
+  debug: LoggerPort["debug"] = (_log) => {};
+  silly: LoggerPort["silly"] = (_log) => {};
+
+  setSilent: LoggerPort["setSilent"] = (_silent) => {};
+
+  getFilePath() {
+    return null;
+  }
+}

package/src/logger-winston-local.adapter.ts

@@ -0,0 +1,24 @@
+import * as winston from "winston";
+import type { LogAppType, LoggerPort, LogLevelEnum } from "./logger.port";
+import { LoggerWinstonAdapter } from "./logger-winston.adapter";
+import { NodeEnvironmentEnum } from "./node-env.vo";
+import type { RedactorStrategy } from "./redactor.strategy";
+
+type LoggerWinstonLocalAdapterConfigType = { app: LogAppType; redactor: RedactorStrategy };
+
+export class LoggerWinstonLocalAdapter {
+  constructor(private readonly config: LoggerWinstonLocalAdapterConfigType) {}
+
+  // Stryker disable all
+  create(level: LogLevelEnum): LoggerPort {
+    return new LoggerWinstonAdapter({
+      app: this.config.app,
+      environment: NodeEnvironmentEnum.local,
+      level,
+      formats: [winston.format.prettyPrint()],
+      redactor: this.config.redactor,
+      filePath: null,
+    });
+    // Stryker restore all
+  }
+}

package/src/logger-winston-production.adapter.ts

@@ -0,0 +1,38 @@
+import * as tools from "@bgord/tools";
+import * as winston from "winston";
+import type { LogAppType, LoggerPort, LogLevelEnum } from "./logger.port";
+import { LoggerWinstonAdapter } from "./logger-winston.adapter";
+import { NodeEnvironmentEnum } from "./node-env.vo";
+import type { RedactorStrategy } from "./redactor.strategy";
+
+type LoggerWinstonProductionAdapterConfigType = { app: LogAppType; redactor: RedactorStrategy };
+
+export class LoggerWinstonProductionAdapter {
+  constructor(private readonly config: LoggerWinstonProductionAdapterConfigType) {}
+
+  create(level: LogLevelEnum): LoggerPort {
+    const filePath = tools.FilePathAbsolute.fromString(
+      `/var/log/${this.config.app}-${NodeEnvironmentEnum.production}.log`,
+    );
+
+    const file = new winston.transports.File({
+      filename: filePath.get(),
+      maxsize: tools.Size.fromMB(100).toBytes(),
+      maxFiles: 3,
+      // Stryker disable all
+      tailable: true,
+      // Stryker restore all
+    });
+
+    return new LoggerWinstonAdapter({
+      app: this.config.app,
+      environment: NodeEnvironmentEnum.production,
+      level,
+      // Stryker disable all
+      transports: [file],
+      // Stryker restore all
+      redactor: this.config.redactor,
+      filePath,
+    });
+  }
+}

package/src/logger-winston.adapter.ts

@@ -0,0 +1,63 @@
+import type * as tools from "@bgord/tools";
+import * as winston from "winston";
+import { type LogAppType, type LoggerPort, LogLevelEnum } from "./logger.port";
+import type { NodeEnvironmentEnum } from "./node-env.vo";
+import type { RedactorStrategy } from "./redactor.strategy";
+
+type WinstonLoggerOptions = {
+  app: LogAppType;
+  environment: NodeEnvironmentEnum;
+  level: LogLevelEnum;
+  formats?: winston.Logform.Format[];
+  transports?: winston.transport[];
+  redactor: RedactorStrategy;
+  filePath: tools.FilePathAbsolute | null;
+};
+
+export class LoggerWinstonAdapter implements LoggerPort {
+  private readonly logger: winston.Logger;
+
+  private readonly filePath: tools.FilePathAbsolute | null;
+
+  constructor(options: WinstonLoggerOptions) {
+    const format = winston.format.combine(
+      winston.format((info) => options.redactor.redact(info))(),
+      // Stryker disable all
+      winston.format.errors({ stack: true }),
+      // Stryker restore all
+      winston.format.timestamp(),
+      winston.format.json(),
+      ...(options.formats ?? []),
+    );
+
+    this.logger = winston.createLogger({
+      levels: winston.config.npm.levels,
+      level: options.level,
+      defaultMeta: { app: options.app, environment: options.environment },
+      // Stryker disable all
+      handleExceptions: true,
+      handleRejections: true,
+      format,
+      transports: [new winston.transports.Console(), ...(options.transports ?? [])],
+      // Stryker restore all
+    });
+
+    this.filePath = options.filePath;
+  }
+
+  warn: LoggerPort["warn"] = (log) => this.logger.log({ level: LogLevelEnum.warn, ...log });
+  error: LoggerPort["error"] = (log) => this.logger.log({ level: LogLevelEnum.error, ...log });
+  info: LoggerPort["info"] = (log) => this.logger.log({ level: LogLevelEnum.info, ...log });
+  http: LoggerPort["http"] = (log) => this.logger.log({ level: LogLevelEnum.http, ...log });
+  verbose: LoggerPort["verbose"] = (log) => this.logger.log({ level: LogLevelEnum.verbose, ...log });
+  debug: LoggerPort["debug"] = (log) => this.logger.log({ level: LogLevelEnum.debug, ...log });
+  silly: LoggerPort["silly"] = (log) => this.logger.log({ level: LogLevelEnum.silly, ...log });
+
+  setSilent: LoggerPort["setSilent"] = (silent) => {
+    this.logger.silent = silent;
+  };
+
+  getFilePath() {
+    return this.filePath;
+  }
+}