@bgord/bun 1.4.16 → 1.4.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/bun",
-  "version": "1.4.16",
+  "version": "1.4.18",
   "license": "MIT",
   "type": "module",
   "author": "Bartosz Gordon",

package/readme.md

@@ -135,6 +135,7 @@ src/
 ├── image-resizer.port.ts
 ├── invariant-error-handler.service.ts
 ├── invariant.service.ts
+├── job-handler.service.ts
 ├── jobs.service.ts
 ├── json-file-reader-bun-forgiving.adapter.ts
 ├── json-file-reader-bun.adapter.ts

package/src/index.ts

@@ -110,6 +110,7 @@ export * from "./image-resizer-noop.adapter";
 export * from "./image-resizer-sharp.adapter";
 export * from "./invariant.service";
 export * from "./invariant-error-handler.service";
+export * from "./job-handler.service";
 export * from "./jobs.service";
 export * from "./json-file-reader.port";
 export * from "./json-file-reader-bun.adapter";

package/src/job-handler.service.ts

@@ -0,0 +1,54 @@
+import * as tools from "@bgord/tools";
+import type { Cron } from "croner";
+import type { ClockPort } from "./clock.port";
+import { CorrelationStorage } from "./correlation-storage.service";
+import type { IdProviderPort } from "./id-provider.port";
+import type { JobNameType } from "./jobs.service";
+import type { LoggerPort } from "./logger.port";
+import { formatError } from "./logger-format-error.service";
+
+type Dependencies = { Logger: LoggerPort; IdProvider: IdProviderPort; Clock: ClockPort };
+
+export interface UnitOfWork {
+  label: JobNameType;
+  process: () => Promise<void>;
+}
+
+export class JobHandler {
+  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 tools.Stopwatch(this.deps.Clock.now());
+
+      try {
+        this.deps.Logger.info({ message: `${uow.label} start`, correlationId, ...this.base });
+
+        await CorrelationStorage.run(correlationId, 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,
+        });
+      }
+    };
+  }
+
+  protect(cron: Cron) {
+    return async () => this.deps.Logger.info({ message: `${cron.name} overrun`, ...this.base });
+  }
+}

package/src/jobs.service.ts

@@ -1,16 +1,7 @@
-import * as tools from "@bgord/tools";
 import type { Cron } from "croner";
-import type { ClockPort } from "./clock.port";
-import { CorrelationStorage } from "./correlation-storage.service";
-import type { IdProviderPort } from "./id-provider.port";
-import type { LoggerPort } from "./logger.port";
-import { formatError } from "./logger-format-error.service";
 
 export type JobNameType = string;
 export type MultipleJobsType = Record<JobNameType, Cron>;
-export type JobProcessorType = { cron: string; label: JobNameType; process: () => Promise<void> };
-
-type Dependencies = { Logger: LoggerPort; IdProvider: IdProviderPort; Clock: ClockPort };
 
 export class Jobs {
   static SCHEDULES = { EVERY_MINUTE: "* * * * *", EVERY_HOUR: "0 * * * *" };
@@ -23,48 +14,3 @@ export class Jobs {
     return Object.values(jobs).every((job) => job.isRunning());
   }
 }
-
-export class JobHandler {
-  private readonly base = { component: "infra", operation: "job_handler" };
-
-  constructor(private readonly deps: Dependencies) {}
-
-  handle(jobProcessor: JobProcessorType) {
-    const correlationId = this.deps.IdProvider.generate();
-
-    // biome-ignore lint: lint/complexity/noUselessThisAlias
-    const that = this;
-
-    return async () => {
-      const stopwatch = new tools.Stopwatch(this.deps.Clock.now());
-
-      try {
-        that.deps.Logger.info({ message: `${jobProcessor.label} start`, correlationId, ...this.base });
-
-        await CorrelationStorage.run(correlationId, jobProcessor.process);
-
-        that.deps.Logger.info({
-          message: `${jobProcessor.label} success`,
-          correlationId,
-          metadata: stopwatch.stop(),
-          ...this.base,
-        });
-      } catch (error) {
-        that.deps.Logger.error({
-          message: `${jobProcessor.label} error`,
-          correlationId,
-          error: formatError(error),
-          metadata: { ...stopwatch.stop() },
-          ...this.base,
-        });
-      }
-    };
-  }
-
-  protect(cron: Cron) {
-    // biome-ignore lint: lint/complexity/noUselessThisAlias
-    const that = this;
-
-    return async () => that.deps.Logger.info({ message: `${cron.name} overrun`, ...this.base });
-  }
-}

package/src/prerequisites/jobs.ts

@@ -8,20 +8,20 @@ export class PrerequisiteJobs implements prereqs.Prerequisite {
   readonly label: prereqs.PrerequisiteLabelType;
   readonly enabled?: boolean = true;
 
-  private readonly jobs: MultipleJobsType;
+  private readonly Jobs: MultipleJobsType;
 
-  constructor(config: prereqs.PrerequisiteConfigType & { jobs: MultipleJobsType }) {
+  constructor(config: prereqs.PrerequisiteConfigType & { Jobs: MultipleJobsType }) {
     this.label = config.label;
     this.enabled = config.enabled === undefined ? true : config.enabled;
 
-    this.jobs = config.jobs;
+    this.Jobs = config.Jobs;
   }
 
   async verify(clock: ClockPort): Promise<prereqs.VerifyOutcome> {
     const stopwatch = new tools.Stopwatch(clock.now());
 
     if (!this.enabled) return prereqs.Verification.undetermined(stopwatch.stop());
-    if (Jobs.areAllRunning(this.jobs)) return prereqs.Verification.success(stopwatch.stop());
+    if (Jobs.areAllRunning(this.Jobs)) return prereqs.Verification.success(stopwatch.stop());
     return prereqs.Verification.failure(stopwatch.stop());
   }
 }

package/src/remote-file-storage-disk.adapter.ts

@@ -70,4 +70,8 @@ export class RemoteFileStorageDiskAdapter implements RemoteFileStoragePort {
   async delete(key: tools.ObjectKeyType): Promise<void> {
     await this.deps.FileCleaner.delete(this.resolveKeyToAbsoluteFilePath(key));
   }
+
+  get root() {
+    return this.config.root;
+  }
 }

package/src/remote-file-storage-noop.adapter.ts

@@ -8,7 +8,7 @@ import type {
   RemotePutFromPathResult,
 } from "./remote-file-storage.port";
 
-type RemoteFileStorageNoopConfig = { publicBaseUrl?: string };
+type RemoteFileStorageNoopConfig = { root: tools.DirectoryPathAbsoluteType; publicBaseUrl?: string };
 type Dependencies = { Logger: LoggerPort; Clock: ClockPort };
 
 export class RemoteFileStorageNoopAdapter implements RemoteFileStoragePort {
@@ -16,7 +16,7 @@ export class RemoteFileStorageNoopAdapter implements RemoteFileStoragePort {
 
   constructor(
     private readonly deps: Dependencies,
-    private readonly config?: RemoteFileStorageNoopConfig,
+    private readonly config: RemoteFileStorageNoopConfig,
   ) {}
 
   publicUrl(key: tools.ObjectKeyType): string {
@@ -66,4 +66,8 @@ export class RemoteFileStorageNoopAdapter implements RemoteFileStoragePort {
       ...this.base,
     });
   }
+
+  get root() {
+    return this.config.root;
+  }
 }

package/src/remote-file-storage.port.ts

@@ -14,4 +14,5 @@ export interface RemoteFileStoragePort {
   getStream(key: tools.ObjectKeyType): Promise<ReadableStream | null>;
   delete(key: tools.ObjectKeyType): Promise<void>;
   publicUrl(key: tools.ObjectKeyType): string;
+  get root(): tools.DirectoryPathAbsoluteType;
 }

package/src/temporary-file-absolute.adapter.ts

@@ -24,4 +24,8 @@ export class TemporaryFileAbsoluteAdapter implements TemporaryFilePort {
   async cleanup(filename: tools.Filename) {
     await this.deps.FileCleaner.delete(tools.FilePathAbsolute.fromPartsSafe(this.directory, filename));
   }
+
+  get root() {
+    return this.directory;
+  }
 }

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

@@ -9,4 +9,8 @@ export class TemporaryFileNoopAdapter implements TemporaryFilePort {
   }
 
   async cleanup() {}
+
+  get root() {
+    return this.directory;
+  }
 }

package/src/temporary-file.port.ts

@@ -4,4 +4,6 @@ export interface TemporaryFilePort {
   write(filename: tools.Filename, content: File): Promise<{ path: tools.FilePathAbsolute }>;
 
   cleanup(filename: tools.Filename): Promise<void>;
+
+  get root(): tools.DirectoryPathAbsoluteType;
 }