@voyant-travel/workflows-orchestrator 0.109.2 → 0.109.4

package/dist/node/entry-loader.d.ts

@@ -1,8 +1,14 @@
 export interface EntryFile {
     exports: Record<string, unknown>;
 }
+export interface WorkflowBundleBootstrapContext {
+    env: NodeJS.ProcessEnv;
+}
+export type WorkflowBundleBootstrap = (ctx: WorkflowBundleBootstrapContext) => void | Promise<void>;
 export interface LoadEntryOptions {
     cacheBust?: boolean;
+    runBootstrap?: boolean;
 }
 export declare function loadEntryFile(path: string, options?: LoadEntryOptions): Promise<EntryFile>;
+export declare function runWorkflowBundleBootstrap(mod: Record<string, unknown>, ctx?: WorkflowBundleBootstrapContext): Promise<void>;
 //# sourceMappingURL=entry-loader.d.ts.map

package/dist/node/entry-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-loader.d.ts","sourceRoot":"","sources":["../../src/node/entry-loader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAgBpB"}
+{"version":3,"file":"entry-loader.d.ts","sourceRoot":"","sources":["../../src/node/entry-loader.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,8BAA8B;IAC7C,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CACvB;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,GAAG,EAAE,8BAA8B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnG,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAmBpB;AAED,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,GAAE,8BAAqD,GACzD,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/node/entry-loader.js

@@ -8,6 +8,9 @@ export async function loadEntryFile(path, options = {}) {
     const url = options.cacheBust ? `${baseUrl}?t=${Date.now()}` : baseUrl;
     try {
         const mod = (await import(url));
+        if (options.runBootstrap !== false) {
+            await runWorkflowBundleBootstrap(mod);
+        }
         return { exports: mod };
     }
     catch (err) {
@@ -17,3 +20,12 @@ export async function loadEntryFile(path, options = {}) {
             "`voyant dev` on a .ts source to bundle with esbuild first.");
     }
 }
+export async function runWorkflowBundleBootstrap(mod, ctx = { env: process.env }) {
+    const bootstrap = mod.bootstrapWorkflowBundle;
+    if (bootstrap === undefined)
+        return;
+    if (typeof bootstrap !== "function") {
+        throw new Error("voyant: workflow entry export `bootstrapWorkflowBundle` must be a function");
+    }
+    await bootstrap(ctx);
+}

package/dist/node/index.d.ts

@@ -1,5 +1,5 @@
 export { type ChunkBus, type ChunkEvent, createChunkBus, createSelfHostDeps, createStaticReader, findDashboardDir, type HandlerResponse, handleRequest, handleRunSseStream, handleSseStream, type MetricsSnapshot, type RequestHandlerDeps, renderMetrics, type SelfHostServerOptions, type ServeDeps, type ServeHandle, startSelfHostServer, startServer, } from "./dashboard-server.js";
-export { type EntryFile, type LoadEntryOptions, loadEntryFile, } from "./entry-loader.js";
+export { type EntryFile, type LoadEntryOptions, loadEntryFile, runWorkflowBundleBootstrap, type WorkflowBundleBootstrap, type WorkflowBundleBootstrapContext, } from "./entry-loader.js";
 export { createFsRunRecordStore, type FsRunRecordStoreOptions, filterRunRecords, } from "./fs-run-record-store.js";
 export { durationToMs, generateLocalRunId, } from "./local-runtime.js";
 export { defaultMigrationsDir, loadPostgresMigrations, type PostgresMigration, type RunPostgresMigrationsOptions, runPostgresMigrations, } from "./migrate.js";

package/dist/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,eAAe,EACpB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,aAAa,GACd,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,KAAK,+BAA+B,EACpC,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,EACpC,cAAc,EACd,cAAc,GACf,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,iBAAiB,EACjB,WAAW,GACZ,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,QAAQ,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,IAAI,GACL,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,eAAe,EACpB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,mBAAmB,EACnB,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,aAAa,EACb,0BAA0B,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,GACpC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,YAAY,EACZ,kBAAkB,GACnB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,KAAK,+BAA+B,EACpC,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,4BAA4B,GAClC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,4BAA4B,EAC5B,KAAK,6BAA6B,GACnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,GACvB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,8BAA8B,EAC9B,KAAK,+BAA+B,EACpC,cAAc,EACd,cAAc,GACf,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACL,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,iBAAiB,EACjB,WAAW,GACZ,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,EAClC,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,KAAK,QAAQ,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,IAAI,GACL,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAA"}

package/dist/node/index.js

@@ -1,5 +1,5 @@
 export { createChunkBus, createSelfHostDeps, createStaticReader, findDashboardDir, handleRequest, handleRunSseStream, handleSseStream, renderMetrics, startSelfHostServer, startServer, } from "./dashboard-server.js";
-export { loadEntryFile, } from "./entry-loader.js";
+export { loadEntryFile, runWorkflowBundleBootstrap, } from "./entry-loader.js";
 export { createFsRunRecordStore, filterRunRecords, } from "./fs-run-record-store.js";
 export { durationToMs, generateLocalRunId, } from "./local-runtime.js";
 export { defaultMigrationsDir, loadPostgresMigrations, runPostgresMigrations, } from "./migrate.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/workflows-orchestrator",
-  "version": "0.109.2",
+  "version": "0.109.4",
   "description": "Postgres self-host orchestrator runtime for Voyant Workflows — drives runs through the tenant step handler over the v1 wire protocol.",
   "license": "Apache-2.0",
   "repository": {
@@ -43,7 +43,7 @@
   "dependencies": {
     "drizzle-orm": "^0.45.2",
     "pg": "^8.20.0",
-    "@voyant-travel/workflows": "^0.109.2"
+    "@voyant-travel/workflows": "^0.109.4"
   },
   "devDependencies": {
     "@types/node": "^20.12.0",

package/src/node/entry-loader.ts

@@ -6,8 +6,15 @@ export interface EntryFile {
   exports: Record<string, unknown>
 }
 
+export interface WorkflowBundleBootstrapContext {
+  env: NodeJS.ProcessEnv
+}
+
+export type WorkflowBundleBootstrap = (ctx: WorkflowBundleBootstrapContext) => void | Promise<void>
+
 export interface LoadEntryOptions {
   cacheBust?: boolean
+  runBootstrap?: boolean
 }
 
 export async function loadEntryFile(
@@ -20,6 +27,9 @@ export async function loadEntryFile(
   const url = options.cacheBust ? `${baseUrl}?t=${Date.now()}` : baseUrl
   try {
     const mod = (await import(url)) as Record<string, unknown>
+    if (options.runBootstrap !== false) {
+      await runWorkflowBundleBootstrap(mod)
+    }
     return { exports: mod }
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err)
@@ -30,3 +40,15 @@ export async function loadEntryFile(
     )
   }
 }
+
+export async function runWorkflowBundleBootstrap(
+  mod: Record<string, unknown>,
+  ctx: WorkflowBundleBootstrapContext = { env: process.env },
+): Promise<void> {
+  const bootstrap = mod.bootstrapWorkflowBundle
+  if (bootstrap === undefined) return
+  if (typeof bootstrap !== "function") {
+    throw new Error("voyant: workflow entry export `bootstrapWorkflowBundle` must be a function")
+  }
+  await (bootstrap as WorkflowBundleBootstrap)(ctx)
+}

package/src/node/index.ts

@@ -22,6 +22,9 @@ export {
   type EntryFile,
   type LoadEntryOptions,
   loadEntryFile,
+  runWorkflowBundleBootstrap,
+  type WorkflowBundleBootstrap,
+  type WorkflowBundleBootstrapContext,
 } from "./entry-loader.js"
 export {
   createFsRunRecordStore,