@fkws/klonk 0.0.14 → 0.0.16

package/dist/index.cjs

@@ -41,16 +41,16 @@ module.exports = __toCommonJS(exports_src);
 
 // src/prototypes/Playlist.ts
 class Playlist {
-  machines;
+  bundles;
   finalizer;
-  constructor(machines = [], finalizer) {
-    this.machines = machines;
+  constructor(bundles = [], finalizer) {
+    this.bundles = bundles;
     this.finalizer = finalizer;
   }
   addTask(task, builder) {
-    const machine = { task, builder };
-    const newMachines = [...this.machines, machine];
-    return new Playlist(newMachines, this.finalizer);
+    const bundle = { task, builder };
+    const newBundles = [...this.bundles, bundle];
+    return new Playlist(newBundles, this.finalizer);
   }
   finally(finalizer) {
     this.finalizer = finalizer;
@@ -58,14 +58,14 @@ class Playlist {
   }
   async run(source) {
     const outputs = {};
-    for (const machine of this.machines) {
-      const input = machine.builder(source, outputs);
-      const isValid = await machine.task.validateInput(input);
+    for (const bundle of this.bundles) {
+      const input = bundle.builder(source, outputs);
+      const isValid = await bundle.task.validateInput(input);
       if (!isValid) {
-        throw new Error(`Input validation failed for task '${machine.task.ident}'`);
+        throw new Error(`Input validation failed for task '${bundle.task.ident}'`);
       }
-      const result = await machine.task.run(input);
-      outputs[machine.task.ident] = result;
+      const result = await bundle.task.run(input);
+      outputs[bundle.task.ident] = result;
     }
     if (this.finalizer) {
       await this.finalizer(source, outputs);

package/dist/index.d.ts

@@ -68,7 +68,7 @@ type InputBuilder<
 /**
 * @internal Internal assembly type that couples a task with its input builder.
 */
-interface Machine<
+interface TaskBundle<
 	SourceType,
 	AllOutputTypes,
 	TaskInputType,
@@ -79,11 +79,15 @@ interface Machine<
 	builder: InputBuilder<SourceType, AllOutputTypes, TaskInputType>;
 }
 /**
-* Prevent TypeScript from inferring `T` from a builder argument so that the
-* task definition remains the source of truth. Useful for preserving safety
-* when chaining `.addTask` calls.
+* Important typing note:
+*
+* We intentionally do NOT wrap the builder return in `NoInfer<...>`.
+* Doing so breaks contextual typing for object literals, causing string literal unions
+* (e.g. `"low" | "critical"`) to widen to `string` inside input builder callbacks.
+*
+* By letting `TaskInputType` be inferred from the `task` argument (and then checking the
+* builder against it), literal unions are preserved and DX stays sane.
 */
-type NoInfer<T> = [T][T extends any ? 0 : never];
 /**
 * An ordered sequence of Tasks executed with strong type inference.
 *
@@ -108,12 +112,12 @@ declare class Playlist<
 	/**
 	* Internal list of task + builder pairs in the order they will run.
 	*/
-	machines: Machine<any, any, any, any, string>[];
+	bundles: TaskBundle<any, any, any, any, string>[];
 	/**
 	* Optional finalizer invoked after all tasks complete (successfully or not).
 	*/
 	finalizer?: (source: SourceType, outputs: Record<string, any>) => void | Promise<void>;
-	constructor(machines?: Machine<any, any, any, any, string>[], finalizer?: (source: SourceType, outputs: Record<string, any>) => void | Promise<void>);
+	constructor(bundles?: TaskBundle<any, any, any, any, string>[], finalizer?: (source: SourceType, outputs: Record<string, any>) => void | Promise<void>);
 	/**
 	* Append a task to the end of the playlist.
 	*
@@ -134,7 +138,7 @@ declare class Playlist<
 		const IdentType extends string
 	>(task: Task<TaskInputType, TaskOutputType, IdentType> & {
 		ident: IdentType
-	}, builder: (source: SourceType, outputs: AllOutputTypes) => NoInfer<TaskInputType>): Playlist<AllOutputTypes & { [K in IdentType] : Railroad<TaskOutputType> }, SourceType>;
+	}, builder: (source: SourceType, outputs: AllOutputTypes) => TaskInputType): Playlist<AllOutputTypes & { [K in IdentType] : Railroad<TaskOutputType> }, SourceType>;
 	/**
 	* Register a callback to run after the playlist finishes. Use this hook to
 	* react to the last task or to adjust machine state before a transition.
@@ -418,7 +422,7 @@ declare class StateNode<TStateData> {
 *
 * @template TStateData - The shape of the external mutable state carried through the machine.
 */
-declare class Machine2<TStateData> {
+declare class Machine<TStateData> {
 	initialState: StateNode<TStateData> | null;
 	statesToCreate: StateNode<TStateData>[];
 	private currentState;
@@ -447,7 +451,7 @@ declare class Machine2<TStateData> {
 	* @template TStateData
 	* @returns A new unfinalized machine instance.
 	*/
-	static create<TStateData>(): Machine2<TStateData>;
+	static create<TStateData>(): Machine<TStateData>;
 	/**
 	* Finalize the machine by resolving state transitions and locking configuration.
 	* Must be called before `start` or `run`.
@@ -460,7 +464,7 @@ declare class Machine2<TStateData> {
 	*/
 	finalize({ ident }?: {
 		ident?: string
-	}): Machine2<TStateData>;
+	}): Machine<TStateData>;
 	/**
 	* Add a state to the machine.
 	*
@@ -471,12 +475,12 @@ declare class Machine2<TStateData> {
 	*/
 	addState(state: StateNode<TStateData>, options?: {
 		initial?: boolean
-	}): Machine2<TStateData>;
+	}): Machine<TStateData>;
 	/**
 	* Attach a logger to this machine. If the machine has an initial state set,
 	* the logger will be propagated to all currently reachable states.
 	*/
-	addLogger(logger: Logger): Machine2<TStateData>;
+	addLogger(logger: Logger): Machine<TStateData>;
 	/**
 	* Run the machine synchronously until it reaches a terminal condition:
 	* - A leaf state (no transitions)
@@ -503,4 +507,4 @@ type RunOptions = {
 	mode: "infinitely"
 	interval?: number
 });
-export { Workflow, TriggerEvent, Trigger, Task, StateNode, RunOptions, Railroad, Playlist, Machine2 as Machine };
+export { Workflow, TriggerEvent, Trigger, Task, StateNode, RunOptions, Railroad, Playlist, Machine };

package/dist/index.js

@@ -1,15 +1,15 @@
 // src/prototypes/Playlist.ts
 class Playlist {
-  machines;
+  bundles;
   finalizer;
-  constructor(machines = [], finalizer) {
-    this.machines = machines;
+  constructor(bundles = [], finalizer) {
+    this.bundles = bundles;
     this.finalizer = finalizer;
   }
   addTask(task, builder) {
-    const machine = { task, builder };
-    const newMachines = [...this.machines, machine];
-    return new Playlist(newMachines, this.finalizer);
+    const bundle = { task, builder };
+    const newBundles = [...this.bundles, bundle];
+    return new Playlist(newBundles, this.finalizer);
   }
   finally(finalizer) {
     this.finalizer = finalizer;
@@ -17,14 +17,14 @@ class Playlist {
   }
   async run(source) {
     const outputs = {};
-    for (const machine of this.machines) {
-      const input = machine.builder(source, outputs);
-      const isValid = await machine.task.validateInput(input);
+    for (const bundle of this.bundles) {
+      const input = bundle.builder(source, outputs);
+      const isValid = await bundle.task.validateInput(input);
       if (!isValid) {
-        throw new Error(`Input validation failed for task '${machine.task.ident}'`);
+        throw new Error(`Input validation failed for task '${bundle.task.ident}'`);
       }
-      const result = await machine.task.run(input);
-      outputs[machine.task.ident] = result;
+      const result = await bundle.task.run(input);
+      outputs[bundle.task.ident] = result;
     }
     if (this.finalizer) {
       await this.finalizer(source, outputs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fkws/klonk",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "A lightweight, extensible workflow automation engine for Node.js and Bun",
   "repository": "https://github.com/klar-web-services/klonk",
   "homepage": "https://klonk.dev",