@pikku/cli 0.11.1 → 0.11.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.pikku/channel/pikku-channel-types.gen.ts +73 -17
- package/.pikku/channel/pikku-channels-map.gen.d.ts +11 -11
- package/.pikku/channel/pikku-channels-meta.gen.json +1 -0
- package/.pikku/channel/pikku-channels-meta.gen.ts +4 -2
- package/.pikku/channel/pikku-channels.gen.ts +1 -1
- package/.pikku/cli/pikku-cli-channel.ts +2 -2
- package/.pikku/cli/pikku-cli-client.gen.ts +1 -3
- package/.pikku/cli/pikku-cli-types.gen.ts +3 -3
- package/.pikku/cli/pikku-cli-wirings-meta.gen.json +147 -0
- package/.pikku/cli/pikku-cli-wirings-meta.gen.ts +4 -157
- package/.pikku/cli/pikku-cli-wirings.gen.ts +3 -3
- package/.pikku/cli/pikku-cli.gen.ts +3 -3
- package/.pikku/forge/pikku-forge-types.gen.ts +83 -0
- package/.pikku/function/pikku-function-types.gen.ts +223 -91
- package/.pikku/function/pikku-functions-meta-verbose.gen.json +1030 -0
- package/.pikku/function/pikku-functions-meta.gen.json +656 -0
- package/.pikku/function/pikku-functions-meta.gen.ts +4 -970
- package/.pikku/http/pikku-http-types.gen.ts +20 -4
- package/.pikku/http/pikku-http-wirings-map.gen.d.ts +11 -11
- package/.pikku/http/pikku-http-wirings-meta.gen.json +9 -0
- package/.pikku/http/pikku-http-wirings-meta.gen.ts +4 -10
- package/.pikku/http/pikku-http-wirings.gen.ts +1 -1
- package/.pikku/mcp/pikku-mcp-types.gen.ts +72 -20
- package/.pikku/mcp/pikku-mcp-wirings-meta.gen.json +5 -0
- package/.pikku/mcp/pikku-mcp-wirings-meta.gen.ts +6 -4
- package/.pikku/mcp/pikku-mcp-wirings.gen.ts +1 -1
- package/.pikku/pikku-bootstrap.gen.ts +7 -12
- package/.pikku/pikku-services.gen.ts +6 -7
- package/.pikku/pikku-types.gen.ts +4 -1
- package/.pikku/pikku-websocket.gen.ts +1 -1
- package/.pikku/queue/pikku-queue-types.gen.ts +2 -2
- package/.pikku/queue/pikku-queue-workers-wirings-map.gen.d.ts +11 -11
- package/.pikku/queue/pikku-queue-workers-wirings-meta.gen.json +1 -0
- package/.pikku/queue/pikku-queue-workers-wirings-meta.gen.ts +5 -7
- package/.pikku/queue/pikku-queue-workers-wirings.gen.ts +1 -1
- package/.pikku/rpc/pikku-remote-rpc-workers.gen.ts +5 -2
- package/.pikku/rpc/pikku-rpc-wirings-map.gen.d.ts +19 -14
- package/.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts +46 -39
- package/.pikku/scheduler/pikku-scheduler-types.gen.ts +2 -2
- package/.pikku/scheduler/pikku-schedulers-wirings-meta.gen.json +1 -0
- package/.pikku/scheduler/pikku-schedulers-wirings-meta.gen.ts +5 -2
- package/.pikku/scheduler/pikku-schedulers-wirings.gen.ts +1 -1
- package/.pikku/schemas/register.gen.ts +31 -23
- package/.pikku/schemas/schemas/PikkuCLIConfig.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuCLIOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuChannelsOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuForgeNodesOutput.schema.json +1 -0
- package/.pikku/schemas/schemas/PikkuFunctionsOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuHTTPOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuMCPOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuMiddlewareOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuPackageOutput.schema.json +1 -0
- package/.pikku/schemas/schemas/PikkuPermissionsOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuPublicRPCOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuQueueOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuRPCOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuRemoteRPCOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuSchedulerOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuSchemasOutput.schema.json +1 -1
- package/.pikku/schemas/schemas/PikkuWorkflowOutput.schema.json +1 -1
- package/.pikku/services/config.gen.json +104 -0
- package/.pikku/services/getInspectorState.gen.json +10 -0
- package/.pikku/services/jwt.gen.json +13 -0
- package/.pikku/services/logger.gen.json +25 -0
- package/.pikku/services/queueService.gen.json +14 -0
- package/.pikku/services/schedulerService.gen.json +17 -0
- package/.pikku/services/schema.gen.json +14 -0
- package/.pikku/services/secrets.gen.json +13 -0
- package/.pikku/services/variables.gen.json +13 -0
- package/.pikku/services/workflowService.gen.json +31 -0
- package/.pikku/workflow/pikku-workflow-map.gen.d.ts +2 -36
- package/.pikku/workflow/pikku-workflow-types.gen.ts +305 -48
- package/.pikku/workflow/pikku-workflow-wirings-meta.gen.ts +6 -2
- package/.pikku/workflow/pikku-workflow-wirings.gen.ts +1 -2
- package/CHANGELOG.md +44 -1
- package/bin/pikku.ts +6 -32
- package/build.sh +53 -31
- package/cli.schema.json +1 -1
- package/dist/.pikku/channel/pikku-channel-types.gen.d.ts +51 -10
- package/dist/.pikku/channel/pikku-channel-types.gen.js +3 -13
- package/dist/.pikku/channel/pikku-channels-meta.gen.js +3 -2
- package/dist/.pikku/channel/pikku-channels-meta.gen.json +1 -0
- package/dist/.pikku/channel/pikku-channels.gen.d.ts +1 -1
- package/dist/.pikku/channel/pikku-channels.gen.js +1 -1
- package/dist/.pikku/cli/pikku-cli-channel.js +2 -2
- package/dist/.pikku/cli/pikku-cli-client.gen.d.ts +1 -1
- package/dist/.pikku/cli/pikku-cli-client.gen.js +1 -3
- package/dist/.pikku/cli/pikku-cli-types.gen.d.ts +3 -3
- package/dist/.pikku/cli/pikku-cli-types.gen.js +1 -1
- package/dist/.pikku/cli/pikku-cli-wirings-meta.gen.js +3 -157
- package/dist/.pikku/cli/pikku-cli-wirings-meta.gen.json +147 -0
- package/dist/.pikku/cli/pikku-cli-wirings.gen.d.ts +2 -2
- package/dist/.pikku/cli/pikku-cli-wirings.gen.js +2 -2
- package/dist/.pikku/cli/pikku-cli.gen.d.ts +1 -1
- package/dist/.pikku/cli/pikku-cli.gen.js +3 -3
- package/dist/.pikku/forge/pikku-forge-types.gen.d.ts +72 -0
- package/dist/.pikku/forge/pikku-forge-types.gen.js +55 -0
- package/dist/.pikku/function/pikku-function-types.gen.d.ts +141 -99
- package/dist/.pikku/function/pikku-function-types.gen.js +52 -62
- package/dist/.pikku/function/pikku-functions-meta.gen.js +3 -969
- package/dist/.pikku/function/pikku-functions-meta.gen.json +656 -0
- package/dist/.pikku/http/pikku-http-types.gen.d.ts +19 -4
- package/dist/.pikku/http/pikku-http-types.gen.js +1 -1
- package/dist/.pikku/http/pikku-http-wirings-meta.gen.js +3 -10
- package/dist/.pikku/http/pikku-http-wirings-meta.gen.json +9 -0
- package/dist/.pikku/http/pikku-http-wirings.gen.d.ts +1 -1
- package/dist/.pikku/http/pikku-http-wirings.gen.js +1 -1
- package/dist/.pikku/mcp/pikku-mcp-types.gen.d.ts +57 -17
- package/dist/.pikku/mcp/pikku-mcp-types.gen.js +7 -31
- package/dist/.pikku/mcp/pikku-mcp-wirings-meta.gen.js +5 -4
- package/dist/.pikku/mcp/pikku-mcp-wirings-meta.gen.json +5 -0
- package/dist/.pikku/mcp/pikku-mcp-wirings.gen.d.ts +1 -1
- package/dist/.pikku/mcp/pikku-mcp-wirings.gen.js +1 -1
- package/dist/.pikku/pikku-bootstrap.gen.d.ts +7 -12
- package/dist/.pikku/pikku-bootstrap.gen.js +7 -12
- package/dist/.pikku/pikku-services.gen.d.ts +5 -7
- package/dist/.pikku/pikku-services.gen.js +3 -5
- package/dist/.pikku/pikku-types.gen.d.ts +2 -1
- package/dist/.pikku/pikku-types.gen.js +3 -1
- package/dist/.pikku/pikku-websocket.gen.d.ts +1 -1
- package/dist/.pikku/pikku-websocket.gen.js +1 -1
- package/dist/.pikku/queue/pikku-queue-types.gen.d.ts +2 -2
- package/dist/.pikku/queue/pikku-queue-types.gen.js +1 -1
- package/dist/.pikku/queue/pikku-queue-workers-wirings-meta.gen.js +3 -7
- package/dist/.pikku/queue/pikku-queue-workers-wirings-meta.gen.json +1 -0
- package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.d.ts +1 -1
- package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.js +1 -1
- package/dist/.pikku/rpc/pikku-remote-rpc-workers.gen.d.ts +9 -9
- package/dist/.pikku/rpc/pikku-remote-rpc-workers.gen.js +5 -2
- package/dist/.pikku/scheduler/pikku-scheduler-types.gen.d.ts +2 -2
- package/dist/.pikku/scheduler/pikku-scheduler-types.gen.js +1 -1
- package/dist/.pikku/scheduler/pikku-schedulers-wirings-meta.gen.js +3 -2
- package/dist/.pikku/scheduler/pikku-schedulers-wirings-meta.gen.json +1 -0
- package/dist/.pikku/scheduler/pikku-schedulers-wirings.gen.d.ts +1 -1
- package/dist/.pikku/scheduler/pikku-schedulers-wirings.gen.js +1 -1
- package/dist/.pikku/schemas/register.gen.js +19 -15
- package/dist/.pikku/schemas/schemas/PikkuCLIConfig.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuCLIOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuChannelsOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuForgeNodesOutput.schema.json +1 -0
- package/dist/.pikku/schemas/schemas/PikkuFunctionsOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuHTTPOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuMCPOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuMiddlewareOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuPackageOutput.schema.json +1 -0
- package/dist/.pikku/schemas/schemas/PikkuPermissionsOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuPublicRPCOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuQueueOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuRPCOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuRemoteRPCOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuSchedulerOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuSchemasOutput.schema.json +1 -1
- package/dist/.pikku/schemas/schemas/PikkuWorkflowOutput.schema.json +1 -1
- package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts +213 -39
- package/dist/.pikku/workflow/pikku-workflow-types.gen.js +106 -16
- package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js +3 -2
- package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts +1 -1
- package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js +1 -2
- package/dist/bin/pikku.js +5 -26
- package/dist/src/cli.wiring.js +4 -4
- package/dist/src/functions/commands/all.js +172 -94
- package/dist/src/functions/commands/bootstrap.js +21 -16
- package/dist/src/functions/commands/watch.js +6 -3
- package/dist/src/functions/runtimes/nextjs/pikku-command-nextjs.js +12 -8
- package/dist/src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.d.ts +1 -1
- package/dist/src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.js +74 -22
- package/dist/src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.d.ts +1 -1
- package/dist/src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.js +72 -20
- package/dist/src/functions/wirings/channels/pikku-channels.js +9 -2
- package/dist/src/functions/wirings/channels/pikku-command-channels.js +18 -2
- package/dist/src/functions/wirings/channels/serialize-channel-types.js +72 -16
- package/dist/src/functions/wirings/channels/serialize-typed-channel-map.js +1 -2
- package/dist/src/functions/wirings/cli/pikku-command-cli-entry.js +4 -4
- package/dist/src/functions/wirings/cli/pikku-command-cli-types.js +1 -1
- package/dist/src/functions/wirings/cli/pikku-command-cli.js +17 -3
- package/dist/src/functions/wirings/cli/serialize-channel-cli.js +1 -1
- package/dist/src/functions/wirings/cli/serialize-cli-types.js +2 -2
- package/dist/src/functions/wirings/cli/serialize-local-cli-bootstrap.d.ts +1 -1
- package/dist/src/functions/wirings/cli/serialize-local-cli-bootstrap.js +4 -4
- package/dist/src/functions/wirings/forge/pikku-command-forge-nodes.d.ts +1 -0
- package/dist/src/functions/wirings/forge/pikku-command-forge-nodes.js +90 -0
- package/dist/src/functions/wirings/forge/pikku-command-forge-types.d.ts +1 -0
- package/dist/src/functions/wirings/forge/pikku-command-forge-types.js +26 -0
- package/dist/src/functions/wirings/forge/serialize-forge-types.d.ts +4 -0
- package/dist/src/functions/wirings/forge/serialize-forge-types.js +90 -0
- package/dist/src/functions/wirings/functions/pikku-command-function-types-split.js +4 -4
- package/dist/src/functions/wirings/functions/pikku-command-function-types.js +7 -2
- package/dist/src/functions/wirings/functions/pikku-command-functions.js +35 -10
- package/dist/src/functions/wirings/functions/pikku-command-services.d.ts +1 -1
- package/dist/src/functions/wirings/functions/pikku-command-services.js +24 -24
- package/dist/src/functions/wirings/functions/pikku-function-types.js +2 -2
- package/dist/src/functions/wirings/functions/schemas.d.ts +1 -1
- package/dist/src/functions/wirings/functions/schemas.js +5 -4
- package/dist/src/functions/wirings/functions/serialize-function-imports.d.ts +3 -1
- package/dist/src/functions/wirings/functions/serialize-function-imports.js +7 -3
- package/dist/src/functions/wirings/functions/serialize-function-types.d.ts +1 -1
- package/dist/src/functions/wirings/functions/serialize-function-types.js +224 -91
- package/dist/src/functions/wirings/functions/serialize-pikku-types-hub.d.ts +1 -1
- package/dist/src/functions/wirings/functions/serialize-pikku-types-hub.js +19 -21
- package/dist/src/functions/wirings/http/openapi-spec-generator.js +5 -5
- package/dist/src/functions/wirings/http/pikku-command-http-routes.js +18 -2
- package/dist/src/functions/wirings/http/pikku-command-openapi.js +2 -2
- package/dist/src/functions/wirings/http/pikku-http-routes.js +9 -2
- package/dist/src/functions/wirings/http/serialize-http-types.js +19 -3
- package/dist/src/functions/wirings/http/serialize-typed-http-map.js +33 -8
- package/dist/src/functions/wirings/mcp/pikku-command-mcp.js +29 -6
- package/dist/src/functions/wirings/mcp/serialize-mcp-json.js +3 -2
- package/dist/src/functions/wirings/mcp/serialize-mcp-types.js +71 -19
- package/dist/src/functions/wirings/middleware/pikku-command-middleware.js +29 -2
- package/dist/src/functions/wirings/middleware/serialize-middleware-groups-meta.d.ts +5 -2
- package/dist/src/functions/wirings/middleware/serialize-middleware-groups-meta.js +5 -13
- package/dist/src/functions/wirings/package/pikku-command-package.d.ts +1 -0
- package/dist/src/functions/wirings/package/pikku-command-package.js +58 -0
- package/dist/src/functions/wirings/package/serialize-package.d.ts +5 -0
- package/dist/src/functions/wirings/package/serialize-package.js +32 -0
- package/dist/src/functions/wirings/queue/pikku-command-queue.js +17 -3
- package/dist/src/functions/wirings/queue/pikku-queue.js +9 -11
- package/dist/src/functions/wirings/queue/serialize-queue-map.js +20 -3
- package/dist/src/functions/wirings/queue/serialize-queue-meta.d.ts +2 -1
- package/dist/src/functions/wirings/queue/serialize-queue-meta.js +10 -1
- package/dist/src/functions/wirings/queue/serialize-queue-types.js +1 -1
- package/dist/src/functions/wirings/rpc/pikku-command-rpc-map.js +4 -4
- package/dist/src/functions/wirings/rpc/pikku-command-rpc.js +9 -2
- package/dist/src/functions/wirings/rpc/serialize-public-rpc.js +11 -4
- package/dist/src/functions/wirings/rpc/serialize-remote-rpc.js +4 -1
- package/dist/src/functions/wirings/rpc/serialize-rpc-wrapper.js +3 -3
- package/dist/src/functions/wirings/rpc/serialize-typed-rpc-map.d.ts +1 -1
- package/dist/src/functions/wirings/rpc/serialize-typed-rpc-map.js +54 -8
- package/dist/src/functions/wirings/scheduler/pikku-command-scheduler.js +15 -3
- package/dist/src/functions/wirings/scheduler/serialize-scheduler-meta.d.ts +2 -1
- package/dist/src/functions/wirings/scheduler/serialize-scheduler-meta.js +11 -1
- package/dist/src/functions/wirings/scheduler/serialize-scheduler-types.js +1 -1
- package/dist/src/functions/wirings/services/pikku-command-service-metadata.d.ts +1 -0
- package/dist/src/functions/wirings/services/pikku-command-service-metadata.js +22 -0
- package/dist/src/functions/wirings/workflow/pikku-command-workflow.js +58 -16
- package/dist/src/functions/wirings/workflow/serialize-workflow-map.d.ts +3 -0
- package/dist/src/functions/wirings/workflow/serialize-workflow-map.js +30 -32
- package/dist/src/functions/wirings/workflow/serialize-workflow-meta.d.ts +1 -2
- package/dist/src/functions/wirings/workflow/serialize-workflow-meta.js +43 -8
- package/dist/src/functions/wirings/workflow/serialize-workflow-registration.d.ts +7 -0
- package/dist/src/functions/wirings/workflow/serialize-workflow-registration.js +53 -0
- package/dist/src/functions/wirings/workflow/serialize-workflow-types.d.ts +4 -2
- package/dist/src/functions/wirings/workflow/serialize-workflow-types.js +308 -49
- package/dist/src/functions/wirings/workflow/serialize-workflow-workers.d.ts +1 -1
- package/dist/src/functions/wirings/workflow/serialize-workflow-workers.js +16 -29
- package/dist/src/middleware/log-command-info-and-time.d.ts +2 -2
- package/dist/src/middleware/log-command-info-and-time.js +1 -4
- package/dist/src/services/cli-logger-forwarder.service.js +1 -1
- package/dist/src/services.d.ts +2 -7
- package/dist/src/services.js +18 -13
- package/dist/src/utils/check-required-types.d.ts +2 -2
- package/dist/src/utils/check-required-types.js +2 -3
- package/dist/src/utils/command-summary.d.ts +2 -0
- package/dist/src/utils/command-summary.js +2 -0
- package/dist/src/utils/custom-types-generator.js +13 -15
- package/dist/src/utils/generate-bootstrap-file.js +1 -1
- package/dist/src/utils/pikku-cli-config.js +65 -4
- package/dist/src/utils/pikku-files-and-methods.d.ts +2 -2
- package/dist/src/utils/pikku-files-and-methods.js +4 -4
- package/dist/src/utils/schema-generator.d.ts +4 -3
- package/dist/src/utils/schema-generator.js +135 -15
- package/dist/src/utils/strip-verbose-meta.d.ts +43 -0
- package/dist/src/utils/strip-verbose-meta.js +210 -0
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +11 -9
- package/src/cli.wiring.ts +4 -4
- package/src/functions/commands/all.ts +203 -107
- package/src/functions/commands/bootstrap.ts +23 -16
- package/src/functions/commands/watch.ts +6 -3
- package/src/functions/runtimes/nextjs/pikku-command-nextjs.ts +26 -6
- package/src/functions/runtimes/nextjs/serialize-nextjs-backend-wrapper.ts +75 -22
- package/src/functions/runtimes/nextjs/serialize-nextjs-http-wrapper.ts +72 -19
- package/src/functions/wirings/channels/pikku-channels.ts +27 -3
- package/src/functions/wirings/channels/pikku-command-channels.ts +46 -3
- package/src/functions/wirings/channels/serialize-channel-types.ts +72 -16
- package/src/functions/wirings/channels/serialize-typed-channel-map.ts +3 -2
- package/src/functions/wirings/cli/pikku-command-cli-entry.ts +4 -4
- package/src/functions/wirings/cli/pikku-command-cli-types.ts +1 -1
- package/src/functions/wirings/cli/pikku-command-cli.ts +45 -3
- package/src/functions/wirings/cli/serialize-channel-cli.ts +1 -1
- package/src/functions/wirings/cli/serialize-cli-types.ts +2 -2
- package/src/functions/wirings/cli/serialize-local-cli-bootstrap.ts +5 -5
- package/src/functions/wirings/forge/pikku-command-forge-nodes.ts +135 -0
- package/src/functions/wirings/forge/pikku-command-forge-types.ts +38 -0
- package/src/functions/wirings/forge/serialize-forge-types.ts +94 -0
- package/src/functions/wirings/functions/pikku-command-function-types-split.ts +9 -8
- package/src/functions/wirings/functions/pikku-command-function-types.ts +17 -10
- package/src/functions/wirings/functions/pikku-command-functions.ts +59 -14
- package/src/functions/wirings/functions/pikku-command-services.ts +26 -26
- package/src/functions/wirings/functions/pikku-function-types.ts +3 -1
- package/src/functions/wirings/functions/schemas.ts +14 -4
- package/src/functions/wirings/functions/serialize-function-imports.ts +12 -3
- package/src/functions/wirings/functions/serialize-function-types.ts +227 -93
- package/src/functions/wirings/functions/serialize-pikku-types-hub.ts +27 -26
- package/src/functions/wirings/http/openapi-spec-generator.ts +15 -6
- package/src/functions/wirings/http/pikku-command-http-routes.ts +46 -2
- package/src/functions/wirings/http/pikku-command-openapi.ts +3 -2
- package/src/functions/wirings/http/pikku-http-routes.ts +28 -2
- package/src/functions/wirings/http/serialize-http-types.ts +19 -3
- package/src/functions/wirings/http/serialize-typed-http-map.ts +32 -8
- package/src/functions/wirings/mcp/pikku-command-mcp.ts +58 -10
- package/src/functions/wirings/mcp/serialize-mcp-json.ts +8 -6
- package/src/functions/wirings/mcp/serialize-mcp-types.ts +71 -19
- package/src/functions/wirings/middleware/pikku-command-middleware.ts +39 -2
- package/src/functions/wirings/middleware/serialize-middleware-groups-meta.ts +4 -19
- package/src/functions/wirings/package/pikku-command-package.ts +81 -0
- package/src/functions/wirings/package/serialize-package.ts +69 -0
- package/src/functions/wirings/permissions/pikku-command-permissions.ts +2 -2
- package/src/functions/wirings/queue/pikku-command-queue.ts +47 -2
- package/src/functions/wirings/queue/pikku-queue.ts +26 -10
- package/src/functions/wirings/queue/serialize-queue-map.ts +18 -3
- package/src/functions/wirings/queue/serialize-queue-meta.ts +15 -1
- package/src/functions/wirings/queue/serialize-queue-types.ts +1 -1
- package/src/functions/wirings/rpc/pikku-command-rpc-map.ts +7 -4
- package/src/functions/wirings/rpc/pikku-command-rpc.ts +25 -2
- package/src/functions/wirings/rpc/serialize-public-rpc.ts +11 -4
- package/src/functions/wirings/rpc/serialize-remote-rpc.ts +4 -1
- package/src/functions/wirings/rpc/serialize-rpc-wrapper.ts +3 -3
- package/src/functions/wirings/rpc/serialize-typed-rpc-map.ts +74 -8
- package/src/functions/wirings/scheduler/pikku-command-scheduler.ts +51 -4
- package/src/functions/wirings/scheduler/serialize-scheduler-meta.ts +20 -1
- package/src/functions/wirings/scheduler/serialize-scheduler-types.ts +1 -1
- package/src/functions/wirings/services/pikku-command-service-metadata.ts +25 -0
- package/src/functions/wirings/workflow/pikku-command-workflow.ts +114 -19
- package/src/functions/wirings/workflow/serialize-workflow-map.ts +38 -40
- package/src/functions/wirings/workflow/serialize-workflow-meta.ts +68 -11
- package/src/functions/wirings/workflow/serialize-workflow-registration.ts +83 -0
- package/src/functions/wirings/workflow/serialize-workflow-types.ts +311 -49
- package/src/functions/wirings/workflow/serialize-workflow-workers.ts +16 -29
- package/src/middleware/log-command-info-and-time.ts +3 -6
- package/src/services/cli-logger-forwarder.service.ts +1 -1
- package/src/services.ts +23 -16
- package/src/utils/check-required-types.ts +4 -7
- package/src/utils/command-summary.ts +4 -0
- package/src/utils/custom-types-generator.ts +15 -15
- package/src/utils/generate-bootstrap-file.ts +1 -1
- package/src/utils/pikku-cli-config.ts +105 -5
- package/src/utils/pikku-files-and-methods.ts +10 -13
- package/src/utils/schema-generator.ts +185 -22
- package/src/utils/strip-verbose-meta.ts +254 -0
- package/types/application-types.d.ts +1 -1
- package/types/config.d.ts +47 -2
- package/.pikku/function/pikku-functions-meta.min.gen.ts +0 -211
- package/.pikku/function/pikku-functions.gen.ts +0 -84
- package/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.ts +0 -47
- package/dist/.pikku/function/pikku-functions-meta.min.gen.d.ts +0 -1
- package/dist/.pikku/function/pikku-functions-meta.min.gen.js +0 -211
- package/dist/.pikku/function/pikku-functions.gen.d.ts +0 -1
- package/dist/.pikku/function/pikku-functions.gen.js +0 -83
- package/dist/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.d.ts +0 -1
- package/dist/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.js +0 -47
- package/dist/.pikku/schemas/schemas/PikkuRemoteInternalRPCInput.schema.json +0 -1
- package/dist/src/functions/wirings/workflow/pikku-command-workflow-map.d.ts +0 -1
- package/dist/src/functions/wirings/workflow/pikku-command-workflow-map.js +0 -12
- package/dist/src/functions/wirings/workflow/pikku-command-workflow-types.d.ts +0 -1
- package/dist/src/functions/wirings/workflow/pikku-command-workflow-types.js +0 -11
- package/src/functions/wirings/workflow/pikku-command-workflow-map.ts +0 -24
- package/src/functions/wirings/workflow/pikku-command-workflow-types.ts +0 -22
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "secrets",
|
|
3
|
+
"summary": "Interface for retrieving secrets.",
|
|
4
|
+
"description": "",
|
|
5
|
+
"package": "@pikku/core",
|
|
6
|
+
"path": "../core/dist/types/core.types.d.ts",
|
|
7
|
+
"version": "0.11.2",
|
|
8
|
+
"interface": "export interface SecretService {\n /**\n * Retrieves a secret by key.\n * @param key - The key of the secret to retrieve.\n * @returns A promise that resolves to the secret value.\n */\n getSecretJSON<Return = {}>(key: string): Promise<Return>;\n /**\n * Retrieves a secret by key.\n * @param key - The key of the secret to retrieve.\n * @returns A promise that resolves to the secret value.\n */\n getSecret(key: string): Promise<string>;\n}",
|
|
9
|
+
"expandedProperties": {
|
|
10
|
+
"getSecretJSON": "<Return = {}>(key: string) => Promise<Return>",
|
|
11
|
+
"getSecret": "(key: string) => Promise<string>"
|
|
12
|
+
}
|
|
13
|
+
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "variables",
|
|
3
|
+
"summary": "",
|
|
4
|
+
"description": "",
|
|
5
|
+
"package": "@pikku/core",
|
|
6
|
+
"path": "../core/dist/types/core.types.d.ts",
|
|
7
|
+
"version": "0.11.2",
|
|
8
|
+
"interface": "export interface VariablesService {\n get: (name: string) => Promise<string | undefined> | string | undefined;\n getAll: () => Promise<Record<string, string | undefined>> | Record<string, string | undefined>;\n}",
|
|
9
|
+
"expandedProperties": {
|
|
10
|
+
"get": "(name: string) => Promise<string | undefined> | string | undefined",
|
|
11
|
+
"getAll": "() => Promise<Record<string, string | undefined>> | Record<string, string | undefined>"
|
|
12
|
+
}
|
|
13
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "workflowService",
|
|
3
|
+
"summary": "Interface for workflow orchestration",
|
|
4
|
+
"description": "Handles workflow execution, replay, orchestration logic, and run-level state",
|
|
5
|
+
"package": "@pikku/core",
|
|
6
|
+
"path": "../core/dist/types/core.types.d.ts",
|
|
7
|
+
"version": "0.11.2",
|
|
8
|
+
"interface": "export interface WorkflowService {\n createRun(workflowName: string, input: any, inline?: boolean): Promise<string>;\n getRun(id: string): Promise<WorkflowRun | null>;\n getRunHistory(runId: string): Promise<Array<StepState & {\n stepName: string;\n }>>;\n updateRunStatus(id: string, status: WorkflowStatus, output?: any, error?: SerializedError): Promise<void>;\n withRunLock<T>(id: string, fn: () => Promise<T>): Promise<T>;\n close(): Promise<void>;\n resumeWorkflow(runId: string): Promise<void>;\n setServices(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, config: CoreConfig): void;\n startWorkflow<I>(name: string, input: I, rpcService: any, options?: {\n inline?: boolean;\n startNode?: string;\n }): Promise<{\n runId: string;\n }>;\n runWorkflowJob(runId: string, rpcService: any): Promise<void>;\n orchestrateWorkflow(runId: string, rpcService: any): Promise<void>;\n executeWorkflowSleepCompleted(runId: string, stepId: string): Promise<void>;\n insertStepState(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: {\n retries?: number;\n retryDelay?: string | number;\n }): Promise<StepState>;\n getStepState(runId: string, stepName: string): Promise<StepState>;\n setStepRunning(stepId: string): Promise<void>;\n setStepScheduled(stepId: string): Promise<void>;\n setStepResult(stepId: string, result: any): Promise<void>;\n setStepError(stepId: string, error: Error): Promise<void>;\n createRetryAttempt(stepId: string, status: 'pending' | 'running'): Promise<StepState>;\n executeWorkflowStep(runId: string, stepName: string, rpcName: string | null, data: any, rpcService: any): Promise<void>;\n}",
|
|
9
|
+
"expandedProperties": {
|
|
10
|
+
"createRun": "(workflowName: string, input: any, inline?: boolean) => Promise<string>",
|
|
11
|
+
"getRun": "(id: string) => Promise<WorkflowRun | null>",
|
|
12
|
+
"getRunHistory": "(runId: string) => Promise<Array<StepState & { stepName: string; }>>",
|
|
13
|
+
"updateRunStatus": "(id: string, status: WorkflowStatus, output?: any, error?: SerializedError) => Promise<void>",
|
|
14
|
+
"withRunLock": "<T>(id: string, fn: () => Promise<T>) => Promise<T>",
|
|
15
|
+
"close": "() => Promise<void>",
|
|
16
|
+
"resumeWorkflow": "(runId: string) => Promise<void>",
|
|
17
|
+
"setServices": "(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, config: CoreConfig) => void",
|
|
18
|
+
"startWorkflow": "<I>(name: string, input: I, rpcService: any, options?: { inline?: boolean; startNode?: string; }) => Promise<{ runId: string; }>",
|
|
19
|
+
"runWorkflowJob": "(runId: string, rpcService: any) => Promise<void>",
|
|
20
|
+
"orchestrateWorkflow": "(runId: string, rpcService: any) => Promise<void>",
|
|
21
|
+
"executeWorkflowSleepCompleted": "(runId: string, stepId: string) => Promise<void>",
|
|
22
|
+
"insertStepState": "(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: { retries?: number; retryDelay?: string | number; }) => Promise<StepState>",
|
|
23
|
+
"getStepState": "(runId: string, stepName: string) => Promise<StepState>",
|
|
24
|
+
"setStepRunning": "(stepId: string) => Promise<void>",
|
|
25
|
+
"setStepScheduled": "(stepId: string) => Promise<void>",
|
|
26
|
+
"setStepResult": "(stepId: string, result: any) => Promise<void>",
|
|
27
|
+
"setStepError": "(stepId: string, error: Error) => Promise<void>",
|
|
28
|
+
"createRetryAttempt": "(stepId: string, status: \"pending\" | \"running\") => Promise<StepState>",
|
|
29
|
+
"executeWorkflowStep": "(runId: string, stepName: string, rpcName: string | null, data: any, rpcService: any) => Promise<void>"
|
|
30
|
+
}
|
|
31
|
+
}
|
|
@@ -1,28 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* This file was generated by @pikku/cli@0.11.
|
|
2
|
+
* This file was generated by @pikku/cli@0.11.3
|
|
3
3
|
*/
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* Workflow type map with input/output types for each workflow
|
|
6
6
|
*/
|
|
7
7
|
|
|
8
8
|
|
|
9
9
|
|
|
10
|
-
// Custom types are those that are defined directly within generics
|
|
11
|
-
// or are broken into simpler types
|
|
12
|
-
export type PikkuSchemasOutput = false | true
|
|
13
|
-
export type PikkuChannelsOutput = false | true
|
|
14
|
-
export type PikkuCLIOutput = false | true
|
|
15
|
-
export type PikkuFunctionsOutput = false | true
|
|
16
|
-
export type PikkuHTTPOutput = false | true
|
|
17
|
-
export type PikkuMCPOutput = false | true
|
|
18
|
-
export type PikkuMiddlewareOutput = false | true
|
|
19
|
-
export type PikkuPermissionsOutput = false | true
|
|
20
|
-
export type PikkuQueueOutput = false | true
|
|
21
|
-
export type PikkuPublicRPCOutput = false | true
|
|
22
|
-
export type PikkuRemoteRPCOutput = false | true
|
|
23
|
-
export type PikkuRPCOutput = false | true
|
|
24
|
-
export type PikkuSchedulerOutput = false | true
|
|
25
|
-
export type PikkuWorkflowOutput = false | true
|
|
26
10
|
|
|
27
11
|
interface WorkflowHandler<I, O> {
|
|
28
12
|
input: I;
|
|
@@ -33,30 +17,12 @@ export type WorkflowMap = {
|
|
|
33
17
|
};
|
|
34
18
|
|
|
35
19
|
|
|
36
|
-
/**
|
|
37
|
-
* Type-safe workflow client API
|
|
38
|
-
*/
|
|
39
20
|
export type WorkflowClient<Name extends keyof WorkflowMap> = {
|
|
40
|
-
/**
|
|
41
|
-
* Start a new workflow run
|
|
42
|
-
*/
|
|
43
21
|
start: (input: WorkflowMap[Name]['input']) => Promise<{ runId: string }>;
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Get a workflow run by ID
|
|
47
|
-
*/
|
|
48
22
|
getRun: <output extends keyof WorkflowMap[Name]>(runId: string) => Promise<WorkflowMap[Name][output]>;
|
|
49
|
-
|
|
50
|
-
/**
|
|
51
|
-
* Cancel a running workflow
|
|
52
|
-
*/
|
|
53
23
|
cancelRun: (runId: string) => Promise<boolean>;
|
|
54
24
|
}
|
|
55
25
|
|
|
56
|
-
/**
|
|
57
|
-
* Map of all registered workflows with type-safe client APIs
|
|
58
|
-
*/
|
|
59
26
|
export type TypedWorkflowClients = {
|
|
60
27
|
[Name in keyof WorkflowMap]: WorkflowClient<Name>;
|
|
61
28
|
}
|
|
62
|
-
|
|
@@ -1,33 +1,29 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* This file was generated by @pikku/cli@0.11.
|
|
2
|
+
* This file was generated by @pikku/cli@0.11.3
|
|
3
3
|
*/
|
|
4
4
|
/**
|
|
5
|
-
* Workflow
|
|
5
|
+
* Workflow type definitions and helpers
|
|
6
|
+
* Used for authoring both DSL and graph-based workflows
|
|
6
7
|
*/
|
|
7
8
|
|
|
8
|
-
import {
|
|
9
|
-
import { CorePikkuFunctionConfig, CorePikkuFunctionSessionless } from '@pikku/core'
|
|
10
|
-
import type { PikkuPermission, PikkuMiddleware } from '../function/pikku-function-types.gen.js'
|
|
11
|
-
import type { UserSession, SingletonServices } from '../../types/application-types.d.js'
|
|
12
|
-
import type { TypedPikkuRPC, RPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
|
|
9
|
+
import { PikkuWorkflowWire, WorkflowStepOptions, WorkflowCancelledException } from '@pikku/core/workflow'
|
|
13
10
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
type
|
|
19
|
-
|
|
20
|
-
|
|
11
|
+
// Re-export WorkflowCancelledException for use in workflow functions
|
|
12
|
+
export { WorkflowCancelledException }
|
|
13
|
+
import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
|
|
14
|
+
import type { RPCMap, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
|
|
15
|
+
import type { GraphNodeConfig, HTTPMethod } from '@pikku/core'
|
|
16
|
+
import { createGraph, wireWorkflow as coreWireWorkflow } from '@pikku/core'
|
|
17
|
+
|
|
18
|
+
// ============================================================================
|
|
19
|
+
// DSL Workflow Types (pikkuWorkflowFunc, pikkuWorkflowComplexFunc)
|
|
20
|
+
// ============================================================================
|
|
21
21
|
|
|
22
22
|
/**
|
|
23
|
-
* Typed workflow
|
|
23
|
+
* Typed workflow wire with RPC awareness
|
|
24
24
|
* Provides type-safe workflow.do() for RPC steps
|
|
25
25
|
*/
|
|
26
|
-
export interface TypedWorkflow extends
|
|
27
|
-
/**
|
|
28
|
-
* Execute a workflow step with RPC invocation (typed based on available RPCs)
|
|
29
|
-
* @template K - RPC name from the RPC map
|
|
30
|
-
*/
|
|
26
|
+
export interface TypedWorkflow extends PikkuWorkflowWire {
|
|
31
27
|
do<K extends keyof RPCMap>(
|
|
32
28
|
stepName: string,
|
|
33
29
|
rpcName: K,
|
|
@@ -35,10 +31,6 @@ export interface TypedWorkflow extends PikkuWorkflowInteraction {
|
|
|
35
31
|
options?: WorkflowStepOptions
|
|
36
32
|
): Promise<RPCMap[K]['output']>
|
|
37
33
|
|
|
38
|
-
/**
|
|
39
|
-
* Execute a workflow step with inline function
|
|
40
|
-
* @template T - Return type of the inline function
|
|
41
|
-
*/
|
|
42
34
|
do<T>(
|
|
43
35
|
stepName: string,
|
|
44
36
|
fn: () => T | Promise<T>,
|
|
@@ -48,45 +40,310 @@ export interface TypedWorkflow extends PikkuWorkflowInteraction {
|
|
|
48
40
|
|
|
49
41
|
/**
|
|
50
42
|
* Workflow function type with typed workflow service
|
|
51
|
-
* Includes the workflow interaction object with typed RPC methods
|
|
52
43
|
*/
|
|
53
44
|
export type PikkuFunctionWorkflow<
|
|
54
45
|
In = unknown,
|
|
55
46
|
Out = never
|
|
56
|
-
> =
|
|
57
|
-
In,
|
|
58
|
-
Out,
|
|
59
|
-
null,
|
|
60
|
-
SingletonServices & {
|
|
61
|
-
rpc: TypedPikkuRPC
|
|
62
|
-
workflow: TypedWorkflow
|
|
63
|
-
},
|
|
64
|
-
UserSession
|
|
65
|
-
>
|
|
47
|
+
> = PikkuFunctionSessionless<In, Out, 'workflow'>
|
|
66
48
|
|
|
67
49
|
/**
|
|
68
|
-
* Creates a workflow function
|
|
69
|
-
* Workflow functions have access to the workflow interaction object for step execution.
|
|
70
|
-
*
|
|
71
|
-
* @template In - Input type for the workflow
|
|
72
|
-
* @template Out - Output type for the workflow
|
|
73
|
-
* @param func - Function definition, either direct function or configuration object
|
|
74
|
-
* @returns The normalized configuration object
|
|
50
|
+
* Creates a DSL-compatible workflow function (serializable, shows in Forge UI)
|
|
75
51
|
*/
|
|
76
52
|
export const pikkuWorkflowFunc = <In, Out = unknown>(
|
|
77
53
|
func:
|
|
78
54
|
| PikkuFunctionWorkflow<In, Out>
|
|
79
|
-
|
|
|
55
|
+
| PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
|
|
56
|
+
) => {
|
|
57
|
+
return typeof func === 'function' ? { func } : func
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* Creates a complex workflow function (arbitrary code, hidden from Forge UI)
|
|
62
|
+
*/
|
|
63
|
+
export const pikkuWorkflowComplexFunc = <In, Out = unknown>(
|
|
64
|
+
func:
|
|
65
|
+
| PikkuFunctionWorkflow<In, Out>
|
|
66
|
+
| PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
|
|
80
67
|
) => {
|
|
81
68
|
return typeof func === 'function' ? { func } : func
|
|
82
69
|
}
|
|
83
70
|
|
|
71
|
+
// ============================================================================
|
|
72
|
+
// Graph Workflow Types (pikkuWorkflowGraph)
|
|
73
|
+
// ============================================================================
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Type-safe graph builder with full RPC autocomplete
|
|
77
|
+
*/
|
|
78
|
+
const graphBuilder = createGraph<FlattenedRPCMap>()
|
|
79
|
+
|
|
80
|
+
/** HTTP wire configuration for graph workflows */
|
|
81
|
+
interface GraphHttpWire<NodeIds extends string> {
|
|
82
|
+
route: string
|
|
83
|
+
method: HTTPMethod
|
|
84
|
+
startNode: NodeIds
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/** Channel wire configuration for graph workflows */
|
|
88
|
+
interface GraphChannelWire<NodeIds extends string> {
|
|
89
|
+
name: string
|
|
90
|
+
onConnect?: NodeIds
|
|
91
|
+
onDisconnect?: NodeIds
|
|
92
|
+
onMessage?: NodeIds
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Queue wire configuration for graph workflows */
|
|
96
|
+
interface GraphQueueWire<NodeIds extends string> {
|
|
97
|
+
name: string
|
|
98
|
+
startNode: NodeIds
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** CLI wire configuration for graph workflows */
|
|
102
|
+
interface GraphCliWire<NodeIds extends string> {
|
|
103
|
+
command: string
|
|
104
|
+
startNode: NodeIds
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/** MCP wire configurations for graph workflows */
|
|
108
|
+
interface GraphMcpWires<NodeIds extends string> {
|
|
109
|
+
tool?: Array<{ name: string; startNode: NodeIds }>
|
|
110
|
+
prompt?: Array<{ name: string; startNode: NodeIds }>
|
|
111
|
+
resource?: Array<{ uri: string; startNode: NodeIds }>
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
/** Schedule wire configuration for graph workflows */
|
|
115
|
+
interface GraphScheduleWire<NodeIds extends string> {
|
|
116
|
+
cron?: string
|
|
117
|
+
interval?: string
|
|
118
|
+
startNode: NodeIds
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Trigger wire configuration for graph workflows */
|
|
122
|
+
interface GraphTriggerWire<NodeIds extends string> {
|
|
123
|
+
name: string // RPC name of the trigger function
|
|
124
|
+
startNode: NodeIds
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** All wire configurations for graph workflows */
|
|
128
|
+
interface GraphWiresConfig<NodeIds extends string> {
|
|
129
|
+
http?: Array<GraphHttpWire<NodeIds>>
|
|
130
|
+
channel?: Array<GraphChannelWire<NodeIds>>
|
|
131
|
+
queue?: Array<GraphQueueWire<NodeIds>>
|
|
132
|
+
cli?: Array<GraphCliWire<NodeIds>>
|
|
133
|
+
mcp?: GraphMcpWires<NodeIds>
|
|
134
|
+
schedule?: Array<GraphScheduleWire<NodeIds>>
|
|
135
|
+
trigger?: Array<GraphTriggerWire<NodeIds>>
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** Configuration for graph-based workflow */
|
|
139
|
+
export interface PikkuWorkflowGraphConfig<
|
|
140
|
+
FuncMap extends Record<string, keyof FlattenedRPCMap & string>,
|
|
141
|
+
T
|
|
142
|
+
> {
|
|
143
|
+
/** Workflow name (optional - defaults to exported variable name) */
|
|
144
|
+
name?: string
|
|
145
|
+
/** Optional description */
|
|
146
|
+
description?: string
|
|
147
|
+
/** Optional tags for organization */
|
|
148
|
+
tags?: string[]
|
|
149
|
+
/** Node to RPC function mapping */
|
|
150
|
+
nodes: FuncMap
|
|
151
|
+
/** Wire configurations - how this workflow can be triggered */
|
|
152
|
+
wires?: GraphWiresConfig<Extract<keyof FuncMap, string>>
|
|
153
|
+
/** Node configurations (next, input, onError) */
|
|
154
|
+
config?: T
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/** Result of pikkuWorkflowGraph - includes metadata for wiring */
|
|
158
|
+
export interface PikkuWorkflowGraphResult<T, NodeIds extends string = string> {
|
|
159
|
+
__type: 'pikkuWorkflowGraph'
|
|
160
|
+
name?: string
|
|
161
|
+
description?: string
|
|
162
|
+
tags?: string[]
|
|
163
|
+
wires?: GraphWiresConfig<NodeIds>
|
|
164
|
+
graph: T
|
|
165
|
+
}
|
|
166
|
+
|
|
84
167
|
/**
|
|
85
|
-
*
|
|
86
|
-
*
|
|
168
|
+
* Creates a graph-based workflow definition with metadata
|
|
169
|
+
* Name defaults to the exported variable name if not provided.
|
|
170
|
+
*
|
|
171
|
+
* @example
|
|
172
|
+
* // Name inferred from exported variable name
|
|
173
|
+
* export const myWorkflow = pikkuWorkflowGraph({
|
|
174
|
+
* description: 'Handles user onboarding',
|
|
175
|
+
* tags: ['onboarding'],
|
|
176
|
+
* nodes: {
|
|
177
|
+
* entry: 'createUser',
|
|
178
|
+
* sendEmail: 'sendWelcomeEmail',
|
|
179
|
+
* },
|
|
180
|
+
* config: {
|
|
181
|
+
* entry: { next: 'sendEmail' },
|
|
182
|
+
* sendEmail: { input: (ref) => ({ to: ref('entry', 'email') }) },
|
|
183
|
+
* },
|
|
184
|
+
* })
|
|
185
|
+
*/
|
|
186
|
+
export function pikkuWorkflowGraph<
|
|
187
|
+
const FuncMap extends Record<string, keyof FlattenedRPCMap & string>
|
|
188
|
+
>(
|
|
189
|
+
config: PikkuWorkflowGraphConfig<FuncMap, GraphNodeConfigMap<FuncMap>>
|
|
190
|
+
): PikkuWorkflowGraphResult<Record<Extract<keyof FuncMap, string>, GraphNodeConfig<Extract<keyof FuncMap, string>>>, Extract<keyof FuncMap, string>> {
|
|
191
|
+
return {
|
|
192
|
+
__type: 'pikkuWorkflowGraph',
|
|
193
|
+
name: config.name,
|
|
194
|
+
description: config.description,
|
|
195
|
+
tags: config.tags,
|
|
196
|
+
wires: config.wires,
|
|
197
|
+
graph: graphBuilder(config.nodes, config.config as any),
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Typed ref value */
|
|
202
|
+
type TypedRef<T> = { $ref: string; path?: string } & { __phantomType?: T }
|
|
203
|
+
|
|
204
|
+
/** Template string type - assignable to string fields */
|
|
205
|
+
type TemplateString = {
|
|
206
|
+
$template: {
|
|
207
|
+
parts: string[]
|
|
208
|
+
expressions: Array<{ $ref: string; path?: string }>
|
|
209
|
+
}
|
|
210
|
+
} & { __brand: 'TemplateString' }
|
|
211
|
+
|
|
212
|
+
/**
|
|
213
|
+
* Creates a template string with variable interpolation
|
|
214
|
+
* Uses indexed placeholders $0, $1, etc. with refs array
|
|
215
|
+
*
|
|
216
|
+
* @example
|
|
217
|
+
* template('Hello $0, your order $1 is ready', [ref('trigger', 'name'), ref('step_0', 'orderId')])
|
|
218
|
+
*/
|
|
219
|
+
export function template(templateStr: string, refs: TypedRef<unknown>[]): TemplateString {
|
|
220
|
+
const parts: string[] = []
|
|
221
|
+
const expressions: Array<{ $ref: string; path?: string }> = []
|
|
222
|
+
|
|
223
|
+
// Parse template string: "Hello $0" -> parts: ["Hello ", ""], use refs[0] for expression
|
|
224
|
+
const regex = /$(d+)/g
|
|
225
|
+
let lastIndex = 0
|
|
226
|
+
let match
|
|
227
|
+
|
|
228
|
+
while ((match = regex.exec(templateStr)) !== null) {
|
|
229
|
+
// Add the part before this match
|
|
230
|
+
parts.push(templateStr.slice(lastIndex, match.index))
|
|
231
|
+
|
|
232
|
+
// Get the ref by index
|
|
233
|
+
const refIndex = parseInt(match[1]!, 10)
|
|
234
|
+
const refValue = refs[refIndex]
|
|
235
|
+
if (refValue) {
|
|
236
|
+
const expr: { $ref: string; path?: string } = { $ref: refValue.$ref }
|
|
237
|
+
if (refValue.path) {
|
|
238
|
+
expr.path = refValue.path
|
|
239
|
+
}
|
|
240
|
+
expressions.push(expr)
|
|
241
|
+
} else {
|
|
242
|
+
expressions.push({ $ref: 'unknown' })
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
lastIndex = regex.lastIndex
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
// Add the remaining part
|
|
249
|
+
parts.push(templateStr.slice(lastIndex))
|
|
250
|
+
|
|
251
|
+
return {
|
|
252
|
+
$template: { parts, expressions }
|
|
253
|
+
} as TemplateString
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/** Map input type fields to allow TypedRef or TemplateString for any field */
|
|
257
|
+
type InputWithRefs<T> = {
|
|
258
|
+
[K in keyof T]?: T[K] | TypedRef<T[K]> | TypedRef<unknown> | TemplateString
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/** Get the input type for a node based on its RPC mapping */
|
|
262
|
+
type NodeInputType<FuncMap extends Record<string, string>, K extends keyof FuncMap> =
|
|
263
|
+
FuncMap[K] extends keyof FlattenedRPCMap
|
|
264
|
+
? InputWithRefs<FlattenedRPCMap[FuncMap[K]]['input']>
|
|
265
|
+
: Record<string, unknown>
|
|
266
|
+
|
|
267
|
+
/** Get the output type keys for a node based on its RPC mapping */
|
|
268
|
+
type NodeOutputKeys<FuncMap extends Record<string, string>, N extends string> =
|
|
269
|
+
N extends keyof FuncMap
|
|
270
|
+
? FuncMap[N] extends keyof FlattenedRPCMap
|
|
271
|
+
? keyof FlattenedRPCMap[FuncMap[N]]['output'] & string
|
|
272
|
+
: string
|
|
273
|
+
: string
|
|
274
|
+
|
|
275
|
+
/** Ref function type with path validation */
|
|
276
|
+
type RefFunction<FuncMap extends Record<string, string>> = {
|
|
277
|
+
<N extends Extract<keyof FuncMap, string>>(
|
|
278
|
+
nodeId: N,
|
|
279
|
+
path: NodeOutputKeys<FuncMap, N>
|
|
280
|
+
): TypedRef<unknown>
|
|
281
|
+
(nodeId: 'trigger' | '$item', path?: string): TypedRef<unknown>
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** Template function type */
|
|
285
|
+
type TemplateFunction = (templateStr: string, refs: TypedRef<unknown>[]) => TemplateString
|
|
286
|
+
|
|
287
|
+
/** Type helper for node configuration */
|
|
288
|
+
type GraphNodeConfigMap<FuncMap extends Record<string, string>> = {
|
|
289
|
+
[K in Extract<keyof FuncMap, string>]?: {
|
|
290
|
+
next?: NextConfig<Extract<keyof FuncMap, string>>
|
|
291
|
+
input?:
|
|
292
|
+
| NodeInputType<FuncMap, K>
|
|
293
|
+
| (() => NodeInputType<FuncMap, K>)
|
|
294
|
+
| ((ref: RefFunction<FuncMap>, template: TemplateFunction) => NodeInputType<FuncMap, K>)
|
|
295
|
+
onError?: Extract<keyof FuncMap, string> | Extract<keyof FuncMap, string>[]
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
type NextConfig<NodeIds extends string> = NodeIds | NodeIds[] | { if: string; then: NodeIds; else?: NodeIds }
|
|
300
|
+
|
|
301
|
+
// ============================================================================
|
|
302
|
+
// Unified wireWorkflow
|
|
303
|
+
// ============================================================================
|
|
304
|
+
|
|
305
|
+
/** Workflow definition with DSL function */
|
|
306
|
+
interface WorkflowDefinitionFunc {
|
|
307
|
+
/** Whether this workflow wiring is enabled (default: true) */
|
|
308
|
+
enabled?: boolean
|
|
309
|
+
/** Wire configurations for the workflow */
|
|
310
|
+
wires: {
|
|
311
|
+
http?: { route: string; method: HTTPMethod }
|
|
312
|
+
channel?: string
|
|
313
|
+
queue?: string
|
|
314
|
+
}
|
|
315
|
+
/** DSL workflow function */
|
|
316
|
+
func: PikkuFunctionConfig<any, any, 'workflow', PikkuFunctionWorkflow<any, any>>
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/** Workflow definition with graph */
|
|
320
|
+
interface WorkflowDefinitionGraph<T, NodeIds extends string = string> {
|
|
321
|
+
/** Whether this workflow wiring is enabled (default: true) */
|
|
322
|
+
enabled?: boolean
|
|
323
|
+
/** Graph workflow definition - wires are defined in the graph itself */
|
|
324
|
+
graph: PikkuWorkflowGraphResult<T, NodeIds>
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
/**
|
|
328
|
+
* Wire a workflow with wires
|
|
329
|
+
* Accepts either a DSL function (func) or a graph definition (graph)
|
|
330
|
+
*
|
|
331
|
+
* @example
|
|
332
|
+
* // DSL workflow
|
|
333
|
+
* wireWorkflow({
|
|
334
|
+
* wires: { http: { route: '/start', method: 'post' } },
|
|
335
|
+
* func: myWorkflowFunc,
|
|
336
|
+
* })
|
|
87
337
|
*
|
|
88
|
-
* @
|
|
338
|
+
* @example
|
|
339
|
+
* // Graph workflow - wires are defined in the graph itself
|
|
340
|
+
* wireWorkflow({
|
|
341
|
+
* enabled: true, // default: true
|
|
342
|
+
* graph: myGraphWorkflow,
|
|
343
|
+
* })
|
|
89
344
|
*/
|
|
90
|
-
export
|
|
91
|
-
|
|
345
|
+
export function wireWorkflow<T extends Record<string, GraphNodeConfig<Extract<keyof T, string>>>, NodeIds extends string = string>(
|
|
346
|
+
definition: WorkflowDefinitionFunc | WorkflowDefinitionGraph<T, NodeIds>
|
|
347
|
+
): void {
|
|
348
|
+
coreWireWorkflow(definition as any)
|
|
92
349
|
}
|
|
@@ -1,5 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* This file was generated by @pikku/cli@0.11.
|
|
2
|
+
* This file was generated by @pikku/cli@0.11.3
|
|
3
3
|
*/
|
|
4
4
|
import { pikkuState } from '@pikku/core'
|
|
5
|
-
|
|
5
|
+
import type { SerializedWorkflowGraphs } from '@pikku/inspector/workflow-graph'
|
|
6
|
+
|
|
7
|
+
const workflowsMeta: SerializedWorkflowGraphs = {}
|
|
8
|
+
|
|
9
|
+
pikkuState(null, 'workflows', 'meta', workflowsMeta)
|
package/CHANGELOG.md
CHANGED
|
@@ -1,4 +1,47 @@
|
|
|
1
|
-
## 0.11.
|
|
1
|
+
## 0.11.3
|
|
2
|
+
|
|
3
|
+
## 0.11.3
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- 14a3dcd: fix: nextjs rpc route wasn't working
|
|
8
|
+
- db9c7bf: Add workflow graph code generation and fix HTTP routes count
|
|
9
|
+
- Updated dependencies [db9c7bf]
|
|
10
|
+
- Updated dependencies [db9c7bf]
|
|
11
|
+
- @pikku/core@0.11.2
|
|
12
|
+
- @pikku/inspector@0.11.2
|
|
13
|
+
|
|
14
|
+
### Features
|
|
15
|
+
|
|
16
|
+
- f35e89da: Add workflow graph code generation
|
|
17
|
+
- Workflow graph serialization and type generation
|
|
18
|
+
- DSL to graph conversion for workflow metadata
|
|
19
|
+
|
|
20
|
+
### Fixes
|
|
21
|
+
|
|
22
|
+
- ddd87eaf: Make CreateWireServices type compatible with custom Config types
|
|
23
|
+
- c42aad80: Correct HTTP routes count in CLI summary (was showing method count instead of route count)
|
|
24
|
+
|
|
25
|
+
## 0.11.2
|
|
26
|
+
|
|
27
|
+
### Patch Changes
|
|
28
|
+
|
|
29
|
+
- 4b811db: chore: updating all dependencies
|
|
30
|
+
- ce902b1: feat: serialize json files seperate to pikku meta state calls
|
|
31
|
+
- e12a00c: feat: adding initialSession to PikkuWire which is correctly typed (undefined / not depending on function type)
|
|
32
|
+
- ce902b1: feat: adding rpcName to rpc url so its nicer in network tabs
|
|
33
|
+
- 4579434: breaking: changing the signature of functions
|
|
34
|
+
- 28aeb7f: breaking: extract docs in the wiring meta
|
|
35
|
+
- ce902b1: feat: adding in pikkuSimpleWorkflowFunc
|
|
36
|
+
- 06e1a31: breaking: change session services to wire services
|
|
37
|
+
- Updated dependencies [4b811db]
|
|
38
|
+
- Updated dependencies [e12a00c]
|
|
39
|
+
- Updated dependencies [4579434]
|
|
40
|
+
- Updated dependencies [28aeb7f]
|
|
41
|
+
- Updated dependencies [ce902b1]
|
|
42
|
+
- Updated dependencies [06e1a31]
|
|
43
|
+
- @pikku/inspector@0.11.1
|
|
44
|
+
- @pikku/core@0.11.1
|
|
2
45
|
|
|
3
46
|
## 0.11.1
|
|
4
47
|
|
package/bin/pikku.ts
CHANGED
|
@@ -1,34 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import { Command } from 'commander'
|
|
3
3
|
import { createConfig, createSingletonServices } from '../src/services.js'
|
|
4
|
-
import { PikkuRPCService } from '@pikku/core/rpc'
|
|
5
4
|
import { LocalVariablesService } from '@pikku/core/services'
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import { dirname, join } from 'path'
|
|
5
|
+
import { all as allCommand } from '../src/functions/commands/all.js'
|
|
6
|
+
import { watch as watchCommand } from '../src/functions/commands/watch.js'
|
|
9
7
|
|
|
10
|
-
const __filename = fileURLToPath(import.meta.url)
|
|
11
|
-
const __dirname = dirname(__filename)
|
|
12
|
-
|
|
13
|
-
// Check if Pikku CLI is available
|
|
14
|
-
const pikkuCliPath = join(__dirname, '../.pikku/cli/pikku-cli.gen.js')
|
|
15
|
-
|
|
16
|
-
if (existsSync(pikkuCliPath)) {
|
|
17
|
-
try {
|
|
18
|
-
// Use the generated Pikku CLI
|
|
19
|
-
const { PikkuCLI } = await import(pikkuCliPath)
|
|
20
|
-
await PikkuCLI(process.argv.slice(2))
|
|
21
|
-
process.exit(0)
|
|
22
|
-
} catch (error) {
|
|
23
|
-
// If import fails, fall back to Commander.js
|
|
24
|
-
console.warn(
|
|
25
|
-
'Failed to load Pikku CLI, using fallback mode:',
|
|
26
|
-
error.message
|
|
27
|
-
)
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
// Fallback to Commander.js for initial setup
|
|
32
8
|
// Import bootstrap if it exists
|
|
33
9
|
try {
|
|
34
10
|
await import('../.pikku/pikku-bootstrap.gen.js')
|
|
@@ -36,16 +12,14 @@ try {
|
|
|
36
12
|
// Bootstrap doesn't exist yet, continue anyway
|
|
37
13
|
}
|
|
38
14
|
|
|
39
|
-
const action = async (command, cliConfig) => {
|
|
15
|
+
const action = async (command: string, cliConfig: any) => {
|
|
40
16
|
const config = await createConfig(new LocalVariablesService(), cliConfig)
|
|
41
17
|
const services = await createSingletonServices(config)
|
|
42
|
-
const rpcWrapper = new PikkuRPCService()
|
|
43
|
-
const { rpc } = await rpcWrapper.injectRPCService(services, {}, false)
|
|
44
18
|
|
|
45
19
|
if (command === 'watch') {
|
|
46
|
-
await
|
|
20
|
+
await watchCommand.func(services)
|
|
47
21
|
} else {
|
|
48
|
-
await
|
|
22
|
+
await allCommand.func(services)
|
|
49
23
|
}
|
|
50
24
|
}
|
|
51
25
|
|
|
@@ -60,7 +34,7 @@ const all = (program, name, description) => {
|
|
|
60
34
|
)
|
|
61
35
|
.option(
|
|
62
36
|
'--session-services-factory-type',
|
|
63
|
-
'The type of your
|
|
37
|
+
'The type of your wire services factory'
|
|
64
38
|
)
|
|
65
39
|
.option('-c, --config <string>', 'The path to pikku cli config file')
|
|
66
40
|
.option('-t, --tags <tags...>', 'Which tags to filter by')
|