@olivervea/pipelines 2.0.0-beta.18 → 2.0.0-beta.19

package/src/build/project.ts

@@ -1,11 +1,11 @@
 // Layout of a pipeline directory and the identity of the SDK building it.
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import { dirname, join, relative, resolve } from "node:path";
-import { isImplementation } from "../core/handlers.ts";
-import { sha256Hex } from "../util/hash.ts";
-import type { HarnessInfo } from "../util/handler-hash.ts";
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { isImplementation } from '../core/handlers.ts';
+import { sha256Hex } from '../util/hash.ts';
+import type { HarnessInfo } from '../util/handler-hash.ts';
 
-export const SDK_ROOT = resolve(import.meta.dir, "../..");
+export const SDK_ROOT = resolve(import.meta.dir, '../..');
 
 export interface Project {
   dir: string;
@@ -17,33 +17,56 @@ export interface Project {
 }
 
 export class ProjectError extends Error {
-  override name = "ProjectError";
+  override name = 'ProjectError';
 }
 
 export async function loadProject(dirArg: string): Promise<Project> {
   const dir = resolve(dirArg);
-  if (!existsSync(dir) || !statSync(dir).isDirectory()) throw new ProjectError(`${dirArg} is not a directory`);
-  const pipelineFile = join(dir, "pipeline.ts");
-  if (!existsSync(pipelineFile)) throw new ProjectError(`${join(dirArg, "pipeline.ts")} not found (it must default-export pipeline({...}))`);
-  const contractFiles = ["pipeline.ts", "models.ts"].map((f) => join(dir, f)).filter((f) => existsSync(f));
-  const hdir = join(dir, "handlers");
+  if (!existsSync(dir) || !statSync(dir).isDirectory())
+    throw new ProjectError(`${dirArg} is not a directory`);
+  const pipelineFile = join(dir, 'pipeline.ts');
+  if (!existsSync(pipelineFile))
+    throw new ProjectError(
+      `${join(dirArg, 'pipeline.ts')} not found (it must default-export pipeline({...}))`,
+    );
+  const contractFiles = ['pipeline.ts', 'models.ts']
+    .map((f) => join(dir, f))
+    .filter((f) => existsSync(f));
+  const hdir = join(dir, 'handlers');
   const files = existsSync(hdir)
     ? readdirSync(hdir)
-        .filter((f) => f.endsWith(".ts") && !f.endsWith(".test.ts") && !f.endsWith(".d.ts") && statSync(join(hdir, f)).isFile())
+        .filter(
+          (f) =>
+            f.endsWith('.ts') &&
+            !f.endsWith('.test.ts') &&
+            !f.endsWith('.d.ts') &&
+            statSync(join(hdir, f)).isFile(),
+        )
         .sort()
     : [];
-  return { dir, pipelineFile, contractFiles, handlers: await resolveHandlers(hdir, files) };
+  return {
+    dir,
+    pipelineFile,
+    contractFiles,
+    handlers: await resolveHandlers(hdir, files),
+  };
 }
 
 /** The default export of pipeline.ts. */
 export async function loadPipeline(project: Project): Promise<unknown> {
   const mod = (await import(project.pipelineFile)) as { default?: unknown };
-  if (!mod.default) throw new ProjectError(`${project.pipelineFile} has no default export (export default pipeline({...})...)`);
+  if (!mod.default)
+    throw new ProjectError(
+      `${project.pipelineFile} has no default export (export default pipeline({...})...)`,
+    );
   return mod.default;
 }
 
 /** Pairs each handler file with the step its default export implements (file names don't matter). */
-async function resolveHandlers(hdir: string, files: string[]): Promise<[string, string][]> {
+async function resolveHandlers(
+  hdir: string,
+  files: string[],
+): Promise<[string, string][]> {
   const byStep = new Map<string, string>();
   for (const f of files) {
     const file = join(hdir, f);
@@ -51,13 +74,20 @@ async function resolveHandlers(hdir: string, files: string[]): Promise<[string,
     try {
       impl = ((await import(file)) as { default?: unknown }).default;
     } catch (e) {
-      throw new ProjectError(`handlers/${f} failed to load: ${(e as Error)?.message ?? String(e)}`);
+      throw new ProjectError(
+        `handlers/${f} failed to load: ${(e as Error)?.message ?? String(e)}`,
+      );
     }
     if (!isImplementation(impl))
-      throw new ProjectError(`handlers/${f} must default-export implement(<step>, …); put shared code in a subfolder such as handlers/lib/`);
+      throw new ProjectError(
+        `handlers/${f} must default-export implement(<step>, …); put shared code in a subfolder such as handlers/lib/`,
+      );
     const step = (impl.step as { name: string }).name;
     const other = byStep.get(step);
-    if (other) throw new ProjectError(`handlers/${other.slice(hdir.length + 1)} and handlers/${f} both implement step '${step}'`);
+    if (other)
+      throw new ProjectError(
+        `handlers/${other.slice(hdir.length + 1)} and handlers/${f} both implement step '${step}'`,
+      );
     byStep.set(step, file);
   }
   return [...byStep].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
@@ -80,28 +110,37 @@ let cached: HarnessInfo | undefined;
  */
 export function harnessInfo(): HarnessInfo {
   if (cached) return cached;
-  const pkg = JSON.parse(readFileSync(join(SDK_ROOT, "package.json"), "utf8")) as { version: string };
-  const src = join(SDK_ROOT, "src");
+  const pkg = JSON.parse(readFileSync(join(SDK_ROOT, 'package.json'), 'utf8')) as {
+    version: string;
+  };
+  const src = join(SDK_ROOT, 'src');
   const files = listFiles(src)
-    .map((f) => relative(src, f).split("\\").join("/"))
-    .filter((f) => !f.startsWith("build/") && !f.startsWith("dev/") && !f.startsWith("testing/") && f.endsWith(".ts"))
+    .map((f) => relative(src, f).split('\\').join('/'))
+    .filter(
+      (f) =>
+        !f.startsWith('build/') &&
+        !f.startsWith('dev/') &&
+        !f.startsWith('testing/') &&
+        f.endsWith('.ts'),
+    )
     .sort();
-  const h = new Bun.CryptoHasher("sha256");
+  const h = new Bun.CryptoHasher('sha256');
   for (const f of files) h.update(`${f}\0${sha256Hex(readFileSync(join(src, f)))}\n`);
-  let zodVersion = "unknown";
+  let zodVersion = 'unknown';
   try {
-    const zodPkg = Bun.resolveSync("zod/package.json", SDK_ROOT);
-    zodVersion = (JSON.parse(readFileSync(zodPkg, "utf8")) as { version: string }).version;
+    const zodPkg = Bun.resolveSync('zod/package.json', SDK_ROOT);
+    zodVersion = (JSON.parse(readFileSync(zodPkg, 'utf8')) as { version: string })
+      .version;
   } catch {
     /* keep unknown */
   }
   h.update(`zod@${zodVersion}\n`);
-  cached = { bun: Bun.version, sdk: pkg.version, sdkHash: "sha256:" + h.digest("hex") };
+  cached = { bun: Bun.version, sdk: pkg.version, sdkHash: 'sha256:' + h.digest('hex') };
   return cached;
 }
 
 export const relPosix = (from: string, to: string) => {
-  const r = relative(from, to).split("\\").join("/");
-  return r.startsWith(".") ? r : `./${r}`;
+  const r = relative(from, to).split('\\').join('/');
+  return r.startsWith('.') ? r : `./${r}`;
 };
 export { dirname };