@pikku/core 0.11.1 → 0.11.2

package/src/wirings/scheduler/scheduler-runner.test.ts

@@ -37,7 +37,7 @@ describe('wireScheduler', () => {
     }
 
     // Set up metadata first
-    pikkuState('scheduler', 'meta')['test-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['test-task'] = {
       pikkuFuncName: 'scheduler_test-task',
       name: 'test-task',
       schedule: '0 0 * * *',
@@ -45,7 +45,7 @@ describe('wireScheduler', () => {
 
     wireScheduler(mockTask)
 
-    const tasks = pikkuState('scheduler', 'tasks')
+    const tasks = pikkuState(null, 'scheduler', 'tasks')
     assert.equal(tasks.has('test-task'), true)
     assert.equal(tasks.get('test-task'), mockTask)
   })
@@ -80,7 +80,7 @@ describe('wireScheduler', () => {
     }
 
     // Set up metadata
-    pikkuState('scheduler', 'meta')['duplicate-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['duplicate-task'] = {
       pikkuFuncName: 'scheduler_duplicate-task',
       name: 'duplicate-task',
       schedule: '0 0 * * *',
@@ -120,7 +120,7 @@ describe('wireScheduler', () => {
       tags: ['scheduled'],
     }
 
-    pikkuState('scheduler', 'meta')['task-with-middleware'] = {
+    pikkuState(null, 'scheduler', 'meta')['task-with-middleware'] = {
       pikkuFuncName: 'scheduler_task-with-middleware',
       name: 'task-with-middleware',
       schedule: '0 0 * * *',
@@ -128,7 +128,7 @@ describe('wireScheduler', () => {
 
     wireScheduler(mockTask)
 
-    const tasks = pikkuState('scheduler', 'tasks')
+    const tasks = pikkuState(null, 'scheduler', 'tasks')
     const task = tasks.get('task-with-middleware')
     assert.equal(task?.middleware?.length, 1)
     assert.deepEqual(task?.tags, ['scheduled'])
@@ -151,12 +151,12 @@ describe('runScheduledTask', () => {
     }
 
     // Set up metadata and task
-    pikkuState('scheduler', 'meta')['simple-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['simple-task'] = {
       pikkuFuncName: 'scheduler_simple-task',
       name: 'simple-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_simple-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_simple-task'] = {
       pikkuFuncName: 'scheduler_simple-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -191,12 +191,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['task-with-session'] = {
+    pikkuState(null, 'scheduler', 'meta')['task-with-session'] = {
       pikkuFuncName: 'scheduler_task-with-session',
       name: 'task-with-session',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_task-with-session'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_task-with-session'] = {
       pikkuFuncName: 'scheduler_task-with-session',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -243,7 +243,7 @@ describe('runScheduledTask', () => {
     }
 
     // Add task but not metadata
-    pikkuState('scheduler', 'tasks').set('task-without-meta', mockTask)
+    pikkuState(null, 'scheduler', 'tasks').set('task-without-meta', mockTask)
 
     const mockLogger = createMockLogger()
 
@@ -273,12 +273,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['skipped-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['skipped-task'] = {
       pikkuFuncName: 'scheduler_skipped-task',
       name: 'skipped-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_skipped-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_skipped-task'] = {
       pikkuFuncName: 'scheduler_skipped-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -316,12 +316,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['skipped-task-no-reason'] = {
+    pikkuState(null, 'scheduler', 'meta')['skipped-task-no-reason'] = {
       pikkuFuncName: 'scheduler_skipped-task-no-reason',
       name: 'skipped-task-no-reason',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_skipped-task-no-reason'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_skipped-task-no-reason'] = {
       pikkuFuncName: 'scheduler_skipped-task-no-reason',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -362,12 +362,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['wire-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['wire-task'] = {
       pikkuFuncName: 'scheduler_wire-task',
       name: 'wire-task',
       schedule: '*/5 * * * *',
     }
-    pikkuState('function', 'meta')['scheduler_wire-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_wire-task'] = {
       pikkuFuncName: 'scheduler_wire-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -400,12 +400,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['session-services-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['session-services-task'] = {
       pikkuFuncName: 'scheduler_session-services-task',
       name: 'session-services-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_session-services-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_session-services-task'] = {
       pikkuFuncName: 'scheduler_session-services-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -445,12 +445,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['cleanup-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['cleanup-task'] = {
       pikkuFuncName: 'scheduler_cleanup-task',
       name: 'cleanup-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_cleanup-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_cleanup-task'] = {
       pikkuFuncName: 'scheduler_cleanup-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -489,12 +489,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['error-cleanup-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['error-cleanup-task'] = {
       pikkuFuncName: 'scheduler_error-cleanup-task',
       name: 'error-cleanup-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_error-cleanup-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_error-cleanup-task'] = {
       pikkuFuncName: 'scheduler_error-cleanup-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -526,12 +526,12 @@ describe('runScheduledTask', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['error-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['error-task'] = {
       pikkuFuncName: 'scheduler_error-task',
       name: 'error-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_error-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_error-task'] = {
       pikkuFuncName: 'scheduler_error-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -573,12 +573,12 @@ describe('runScheduledTask', () => {
       middleware: [middleware],
     }
 
-    pikkuState('scheduler', 'meta')['middleware-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['middleware-task'] = {
       pikkuFuncName: 'scheduler_middleware-task',
       name: 'middleware-task',
       schedule: '0 0 * * *',
     }
-    pikkuState('function', 'meta')['scheduler_middleware-task'] = {
+    pikkuState(null, 'function', 'meta')['scheduler_middleware-task'] = {
       pikkuFuncName: 'scheduler_middleware-task',
       inputSchemaName: null,
       outputSchemaName: null,
@@ -607,7 +607,7 @@ describe('getScheduledTasks', () => {
       },
     }
 
-    pikkuState('scheduler', 'meta')['test-task'] = {
+    pikkuState(null, 'scheduler', 'meta')['test-task'] = {
       pikkuFuncName: 'scheduler_test-task',
       name: 'test-task',
       schedule: '0 0 * * *',

package/src/wirings/scheduler/scheduler-runner.ts

@@ -34,7 +34,7 @@ export const wireScheduler = <
 >(
   scheduledTask: CoreScheduledTask<PikkuFunctionConfig>
 ) => {
-  const meta = pikkuState('scheduler', 'meta')
+  const meta = pikkuState(null, 'scheduler', 'meta')
   const taskMeta = meta[scheduledTask.name]
   if (!taskMeta) {
     throw new Error('Task metadata not found')
@@ -47,7 +47,7 @@ export const wireScheduler = <
     tags: scheduledTask.func.tags,
   })
 
-  const tasks = pikkuState('scheduler', 'tasks')
+  const tasks = pikkuState(null, 'scheduler', 'tasks')
   if (tasks.has(scheduledTask.name)) {
     throw new Error(`Scheduled task already exists: ${scheduledTask.name}`)
   }
@@ -76,8 +76,8 @@ export async function runScheduledTask({
   createWireServices,
 }: RunScheduledTasksParams): Promise<void> {
   let wireServices: any
-  const task = pikkuState('scheduler', 'tasks').get(name)
-  const meta = pikkuState('scheduler', 'meta')[name]
+  const task = pikkuState(null, 'scheduler', 'tasks').get(name)
+  const meta = pikkuState(null, 'scheduler', 'meta')[name]
 
   const userSession = new PikkuSessionService()
   if (session) {
@@ -135,5 +135,5 @@ export async function runScheduledTask({
 }
 
 export const getScheduledTasks = () => {
-  return pikkuState('scheduler', 'tasks')
+  return pikkuState(null, 'scheduler', 'tasks')
 }

package/src/wirings/trigger/index.ts

@@ -0,0 +1,2 @@
+export * from './trigger.types.js'
+export * from './trigger-runner.js'

package/src/wirings/trigger/trigger-runner.ts

@@ -0,0 +1,96 @@
+import type { CoreSingletonServices } from '../../types/core.types.js'
+import type { CoreTrigger, TriggerInstance } from './trigger.types.js'
+import { pikkuState } from '../../pikku-state.js'
+import type { CorePikkuTriggerFunctionConfig } from '../../function/functions.types.js'
+
+/**
+ * Registers a trigger with the Pikku framework.
+ * The trigger will be available for setup via setupTrigger.
+ */
+export const wireTrigger = <
+  TConfig = unknown,
+  TOutput = unknown,
+  TriggerFunctionConfig extends CorePikkuTriggerFunctionConfig<
+    TConfig,
+    TOutput
+  > = CorePikkuTriggerFunctionConfig<TConfig, TOutput>,
+>(
+  trigger: CoreTrigger<TConfig, TOutput, TriggerFunctionConfig>
+) => {
+  const meta = pikkuState(null, 'trigger', 'meta')
+  const triggerMeta = meta[trigger.name]
+  if (!triggerMeta) {
+    throw new Error(`Trigger metadata not found: ${trigger.name}`)
+  }
+
+  const triggers = pikkuState(null, 'trigger', 'triggers')
+  if (triggers.has(trigger.name)) {
+    throw new Error(`Trigger already exists: ${trigger.name}`)
+  }
+  triggers.set(trigger.name, trigger as any)
+}
+
+/**
+ * Parameters for setting up a trigger
+ */
+export type SetupTriggerParams<TOutput = unknown> = {
+  name: string
+  singletonServices: CoreSingletonServices
+  onTrigger: (data: TOutput) => void | Promise<void>
+}
+
+/**
+ * Sets up a registered trigger and starts listening for events.
+ * Returns a TriggerInstance with a teardown function.
+ */
+export async function setupTrigger<TOutput = unknown>({
+  name,
+  singletonServices,
+  onTrigger,
+}: SetupTriggerParams<TOutput>): Promise<TriggerInstance> {
+  const trigger = pikkuState(null, 'trigger', 'triggers').get(name)
+  const meta = pikkuState(null, 'trigger', 'meta')[name]
+
+  if (!trigger) {
+    throw new Error(`Trigger not found: ${name}`)
+  }
+  if (!meta) {
+    throw new Error(`Trigger metadata not found: ${name}`)
+  }
+
+  const wire = {
+    trigger: {
+      trigger: (data: TOutput) => {
+        singletonServices.logger.info(`Trigger fired: ${name}`)
+        onTrigger(data)
+      },
+    },
+  }
+
+  singletonServices.logger.info(`Setting up trigger: ${name}`)
+
+  const teardown = await trigger.func.func(
+    singletonServices,
+    trigger.config,
+    wire as any
+  )
+
+  return {
+    name,
+    teardown,
+  }
+}
+
+/**
+ * Gets all registered triggers
+ */
+export const getRegisteredTriggers = () => {
+  return pikkuState(null, 'trigger', 'triggers')
+}
+
+/**
+ * Gets trigger metadata
+ */
+export const getTriggerMeta = () => {
+  return pikkuState(null, 'trigger', 'meta')
+}

package/src/wirings/trigger/trigger.types.ts

@@ -0,0 +1,56 @@
+import type { CorePikkuTriggerFunctionConfig } from '../../function/functions.types.js'
+
+/**
+ * The trigger interaction object passed to trigger functions via the wire.
+ * Call trigger() to fire the trigger and start a new workflow/execution.
+ */
+export interface PikkuTrigger<TOutput = unknown> {
+  trigger: (data: TOutput) => void
+}
+
+/**
+ * Metadata for registered triggers stored in state.
+ */
+export type TriggerMeta = Record<
+  string,
+  {
+    pikkuFuncName: string
+    name: string
+    description?: string
+    tags?: string[]
+  }
+>
+
+/**
+ * Core trigger definition for registration.
+ *
+ * @template TConfig - Configuration type
+ * @template TOutput - Output type
+ */
+export interface CoreTrigger<
+  TConfig = unknown,
+  TOutput = unknown,
+  TriggerFunctionConfig extends CorePikkuTriggerFunctionConfig<
+    TConfig,
+    TOutput
+  > = CorePikkuTriggerFunctionConfig<TConfig, TOutput>,
+> {
+  /** Unique name for this trigger */
+  name: string
+  /** The trigger function configuration */
+  func: TriggerFunctionConfig
+  /** Configuration to pass to the trigger function */
+  config: TConfig
+  /** Optional description */
+  description?: string
+  /** Optional tags for categorization */
+  tags?: string[]
+}
+
+/**
+ * Represents a trigger instance with teardown capability
+ */
+export interface TriggerInstance {
+  name: string
+  teardown: () => void | Promise<void>
+}

package/src/wirings/workflow/dsl/index.ts

@@ -0,0 +1,30 @@
+/**
+ * DSL (Domain Specific Language) workflow exports
+ */
+export { addWorkflow } from './workflow-runner.js'
+
+export type {
+  WorkflowStepOptions,
+  WorkflowWireDoRPC,
+  WorkflowWireDoInline,
+  WorkflowWireSleep,
+  InputSource,
+  OutputBinding,
+  RpcStepMeta,
+  SimpleCondition,
+  Condition,
+  BranchStepMeta,
+  ParallelGroupStepMeta,
+  FanoutStepMeta,
+  ReturnStepMeta,
+  InlineStepMeta,
+  SleepStepMeta,
+  CancelStepMeta,
+  SwitchCaseMeta,
+  SwitchStepMeta,
+  FilterStepMeta,
+  ArrayPredicateStepMeta,
+  WorkflowStepMeta,
+  WorkflowStepWire,
+  PikkuWorkflowWire,
+} from './workflow-dsl.types.js'