@pikku/core 0.11.1 → 0.11.2

package/src/wirings/workflow/graph/workflow-graph.types.ts

@@ -0,0 +1,126 @@
+/**
+ * Ref value - internal representation after input callback is evaluated
+ */
+export interface RefValue {
+  __isRef: true
+  nodeId: string
+  path?: string
+}
+
+/**
+ * Helper to create a ref value
+ */
+export const createRef = (nodeId: string, path?: string): RefValue => ({
+  __isRef: true,
+  nodeId,
+  path,
+})
+
+/**
+ * Check if a value is a ref
+ */
+export const isRef = (value: unknown): value is RefValue =>
+  typeof value === 'object' &&
+  value !== null &&
+  '__isRef' in value &&
+  (value as RefValue).__isRef === true
+
+/**
+ * Input reference for fetching step results
+ */
+export interface InputRef {
+  nodeId: string
+  path?: string
+}
+
+/**
+ * Ref function type - provides type-safe references to other nodes' outputs
+ * The actual typing is done at the pikkuWorkflowGraph level
+ */
+export type RefFn<NodeIds extends string = string> = (
+  nodeId: NodeIds,
+  path?: string
+) => RefValue
+
+/**
+ * Next node configuration - fully serializable
+ * - string: single next node
+ * - string[]: parallel execution (all run concurrently)
+ * - Record<string, string | string[]>: branching (function calls graph.branch('key'))
+ */
+export type NextConfig<NodeIds extends string = string> =
+  | NodeIds
+  | NodeIds[]
+  | Record<string, NodeIds | NodeIds[]>
+
+/**
+ * Graph node configuration - references functions by RPC name
+ */
+export interface GraphNodeConfig<NodeIds extends string = string> {
+  /** RPC function name */
+  func: string
+  /** Input mapping callback - receives ref function, returns input object */
+  input?: (ref: RefFn<NodeIds>) => Record<string, unknown>
+  /** Next nodes - string, array, or record for branching */
+  next?: NextConfig<NodeIds>
+  /** Error routing - node(s) to execute on error */
+  onError?: NodeIds | NodeIds[]
+}
+
+// Import unified wire types from workflow module
+import type { WorkflowWires } from '../workflow.types.js'
+
+export type { WorkflowWires }
+
+/**
+ * Workflow graph definition (internal use)
+ */
+export interface WorkflowGraphDefinition<
+  Nodes extends Record<string, GraphNodeConfig<string>> = Record<
+    string,
+    GraphNodeConfig
+  >,
+> {
+  /** Unique workflow name */
+  name: string
+  /** Wire configuration */
+  wires: WorkflowWires
+  /** Graph nodes */
+  graph: Nodes
+}
+
+/**
+ * Graph wire context - available to functions running in a workflow graph
+ */
+export interface PikkuGraphWire {
+  /** Workflow run ID */
+  runId: string
+  /** Graph name */
+  graphName: string
+  /** Current node ID */
+  nodeId: string
+  /**
+   * Select which branch to take for Record-based next config.
+   * Must be called if the node has a Record `next` configuration.
+   * @param key - The branch key to take (must match a key in the next Record)
+   */
+  branch: (key: string) => void
+  /**
+   * Set a state variable value.
+   * @param name - Variable name
+   * @param value - Value to store
+   */
+  setState: (name: string, value: unknown) => Promise<void>
+  /**
+   * Get the entire state object.
+   * @returns The state object with all variables
+   */
+  getState: () => Promise<Record<string, unknown>>
+}
+
+/**
+ * Internal mutable state for graph wire (used by runner to capture branch)
+ */
+export interface GraphWireState {
+  branchKey?: string
+}

package/src/wirings/workflow/index.ts

@@ -1,13 +1,57 @@
 /**
  * Workflow module exports
  */
+export {
+  PikkuWorkflowService,
+  WorkflowCancelledException,
+} from './pikku-workflow-service.js'
 
-// Types
+// Internal registration functions (used by generated code)
+export { addWorkflow } from './dsl/workflow-runner.js'
+export { addWorkflowGraph } from './graph/graph-runner.js'
+
+// Unified wireWorkflow function
+export { wireWorkflow } from './wire-workflow.js'
+export type {
+  WorkflowDefinition,
+  WorkflowDefinitionFunc,
+  WorkflowDefinitionGraph,
+} from './wire-workflow.js'
+
+// Re-export all types from workflow.types
 export type {
+  WorkflowService,
+  WorkflowServiceConfig,
+  WorkflowHTTPWire,
+  WorkflowWires,
+  WorkflowStatus,
+  StepStatus,
+  WorkflowRun,
+  StepState,
   CoreWorkflow,
+  PikkuWorkflow,
+  ContextVariable,
+  WorkflowContext,
+  WorkflowsMeta,
+  WorkflowRuntimeMeta,
+  WorkflowsRuntimeMeta,
+  WorkflowStepInput,
+  WorkflowOrchestratorInput,
+  WorkflowSleeperInput,
+} from './workflow.types.js'
+
+// Re-export DSL types
+export type {
   WorkflowStepOptions,
-  WorkflowStepMeta,
+  WorkflowWireDoRPC,
+  WorkflowWireDoInline,
+  WorkflowWireSleep,
+  InputSource,
+  OutputBinding,
   RpcStepMeta,
+  SimpleCondition,
+  Condition,
+  BranchCase,
   BranchStepMeta,
   ParallelGroupStepMeta,
   FanoutStepMeta,
@@ -15,29 +59,12 @@ export type {
   InlineStepMeta,
   SleepStepMeta,
   CancelStepMeta,
-  InputSource,
-  OutputBinding,
+  SetStepMeta,
+  SwitchCaseMeta,
+  SwitchStepMeta,
+  FilterStepMeta,
+  ArrayPredicateStepMeta,
+  WorkflowStepMeta,
+  WorkflowStepWire,
   PikkuWorkflowWire,
-  PikkuWorkflow,
-  WorkflowsMeta,
-  WorkflowRun,
-  StepState,
-  WorkflowStatus,
-  StepStatus,
 } from './workflow.types.js'
-
-export { PikkuWorkflowService } from './pikku-workflow-service.js'
-
-// Internal registration function (used by generated code)
-export { addWorkflow } from './workflow-runner.js'
-
-/**
- * @deprecated This function is no longer used and will be removed in a future release.
- * It exists only for backwards compatibility with generated code.
- * TODO: Remove this export in a future release after updating code generation
- */
-export const wireWorkflow = <T extends { name: string; func: any }>(
-  workflow: T
-): void => {
-  // Empty function - no longer used, kept for backwards compatibility
-}