@pikku/cli 0.12.17 → 0.12.20

package/dist/.pikku/workflow/pikku-workflow-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.17
+ * This file was generated by @pikku/cli@0.12.20
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { template } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.17
+ * This file was generated by @pikku/cli@0.12.20
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { template } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,6 +1,9 @@
 /**
- * This file was generated by @pikku/cli@0.12.17
+ * This file was generated by @pikku/cli@0.12.20
  */
 import { pikkuState } from '@pikku/core/internal';
-const workflowsMeta = {};
+import allWorkflowMeta from './meta/allWorkflow.gen.json' with { type: 'json' };
+const workflowsMeta = {
+    'allWorkflow': allWorkflowMeta,
+};
 pikkuState(null, 'workflows', 'meta', workflowsMeta);

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.d.ts

@@ -1,4 +1,2 @@
-export {};
-/**
- * This file was generated by @pikku/cli@0.12.17
- */
+import './pikku-workflow-wirings-meta.gen.js';
+export type WorkflowNames = 'allWorkflow';

package/dist/.pikku/workflow/pikku-workflow-wirings.gen.js

@@ -1,4 +1,7 @@
-export {};
 /**
- * This file was generated by @pikku/cli@0.12.17
+ * This file was generated by @pikku/cli@0.12.20
  */
+import { addWorkflow } from '@pikku/core/workflow';
+import './pikku-workflow-wirings-meta.gen.js';
+import { allWorkflow } from '../../src/functions/workflows/all.workflow.js';
+addWorkflow('allWorkflow', allWorkflow);

package/dist/src/cli.wiring.js

@@ -2,6 +2,7 @@ import { pikkuSchemas } from './functions/wirings/functions/schemas.js';
 import { pikkuFetch } from './functions/runtimes/fetch/index.js';
 import { pikkuWebSocketTyped } from './functions/runtimes/websocket/pikku-command-websocket-typed.js';
 import { pikkuRPCClient } from './functions/wirings/rpc/pikku-command-rpc-client.js';
+import { pikkuReactQuery } from './functions/wirings/rpc/pikku-command-react-query.js';
 import { pikkuQueueService } from './functions/wirings/queue/pikku-command-queue-service.js';
 import { pikkuOpenAPI } from './functions/wirings/http/pikku-command-openapi.js';
 import { pikkuNext } from './functions/runtimes/nextjs/pikku-command-nextjs.js';
@@ -10,6 +11,7 @@ import { all } from './functions/commands/all.js';
 import { bootstrap } from './functions/commands/bootstrap.js';
 import { watch } from './functions/commands/watch.js';
 import { consoleCommand } from './functions/commands/console.js';
+import { dev } from './functions/commands/dev.js';
 import { pikkuVersionsInit } from './functions/commands/versions-init.js';
 import { pikkuVersionsCheck } from './functions/commands/versions-check.js';
 import { pikkuVersionsUpdate } from './functions/commands/versions-update.js';
@@ -101,6 +103,25 @@ wireCLI({
                 },
             },
         }),
+        dev: pikkuCLICommand({
+            func: dev,
+            description: 'Start a local development server with all services wired',
+            options: {
+                port: {
+                    description: 'Port for the dev server',
+                    default: '3000',
+                    short: 'p',
+                },
+                watch: {
+                    description: 'Watch for file changes and regenerate',
+                    default: true,
+                },
+                hmr: {
+                    description: 'Enable hot module reload',
+                    default: true,
+                },
+            },
+        }),
         console: pikkuCLICommand({
             func: consoleCommand,
             description: 'Start the Pikku Console UI with live file watching',
@@ -137,6 +158,10 @@ wireCLI({
             func: pikkuRPCClient,
             description: 'Generate RPC client wrappers',
         }),
+        'react-query': pikkuCLICommand({
+            func: pikkuReactQuery,
+            description: 'Generate React Query hooks from RPC map',
+        }),
         'queue-service': pikkuCLICommand({
             func: pikkuQueueService,
             description: 'Generate queue service wrapper',

package/dist/src/deploy/analyzer/analyzer.d.ts

@@ -14,3 +14,4 @@ export interface AnalyzerOptions {
     serverlessIncompatible?: string[];
 }
 export declare function analyzeDeployment(state: InspectorState, options: AnalyzerOptions): DeploymentManifest;
+export declare function toSafeKebab(str: string): string;

package/dist/src/deploy/analyzer/analyzer.js

@@ -71,7 +71,7 @@ export function analyzeDeployment(state, options) {
                 handlers.push({ type: 'queue', queueName: queueMeta.name ?? queueName });
                 queues.push({
                     name: queueMeta.name ?? queueName,
-                    consumerUnit: toKebab(funcId),
+                    consumerUnit: toSafeKebab(funcId),
                     consumerFunctionId: funcId,
                 });
             }
@@ -87,7 +87,7 @@ export function analyzeDeployment(state, options) {
                 scheduledTasks.push({
                     name: schedMeta.name,
                     schedule: schedMeta.schedule,
-                    unitName: toKebab(funcId),
+                    unitName: toSafeKebab(funcId),
                     functionId: funcId,
                 });
             }
@@ -129,7 +129,7 @@ export function analyzeDeployment(state, options) {
             continue;
         }
         units.push({
-            name: toKebab(funcId),
+            name: toSafeKebab(funcId),
             role: 'function',
             target: resolveDeployTarget(funcMeta, serverlessIncompatible),
             functionIds: [funcId],
@@ -143,10 +143,10 @@ export function analyzeDeployment(state, options) {
     for (const [agentName, agentMeta] of entries(state.agents.agentsMeta)) {
         const toolIds = agentMeta.tools ?? [];
         const subAgentNames = agentMeta.agents ?? [];
-        const unitName = `agent-${toKebab(agentName)}`;
+        const unitName = `agent-${toSafeKebab(agentName)}`;
         // Agent gateway depends on its tool function units
-        const toolUnitNames = toolIds.map((id) => toKebab(id));
-        const subAgentUnitNames = subAgentNames.map((sa) => `agent-${toKebab(sa)}`);
+        const toolUnitNames = toolIds.map((id) => toSafeKebab(id));
+        const subAgentUnitNames = subAgentNames.map((sa) => `agent-${toSafeKebab(sa)}`);
         // Agent needs AI services
         const agentServices = [
             { capability: 'ai-model', sourceServiceName: 'aiAgentRunner' },
@@ -209,7 +209,7 @@ export function analyzeDeployment(state, options) {
     const allMcpIds = [...mcpToolIds, ...mcpResourceIds, ...mcpPromptIds];
     if (allMcpIds.length > 0) {
         const unitName = 'mcp-server';
-        const mcpFuncUnitNames = allMcpIds.map((id) => toKebab(id));
+        const mcpFuncUnitNames = allMcpIds.map((id) => toSafeKebab(id));
         units.push({
             name: unitName,
             role: 'mcp',
@@ -232,8 +232,8 @@ export function analyzeDeployment(state, options) {
         const funcIds = collectChannelFunctionIds(channelMeta);
         if (funcIds.length === 0)
             continue;
-        const unitName = `channel-${toKebab(channelName)}`;
-        const funcUnitNames = funcIds.map((id) => toKebab(id));
+        const unitName = `channel-${toSafeKebab(channelName)}`;
+        const funcUnitNames = funcIds.map((id) => toSafeKebab(id));
         units.push({
             name: unitName,
             role: 'channel',
@@ -346,7 +346,7 @@ function buildWorkflows(graphMeta, _functionsMeta, _httpMeta, units, workflows,
                 continue;
             if (!('rpcName' in node))
                 continue;
-            const stepUnitName = toKebab(node.rpcName);
+            const stepUnitName = toSafeKebab(node.rpcName);
             const isAsync = node.options?.async === true;
             const isInline = !isAsync && graph.inline === true;
             steps.push({
@@ -358,7 +358,7 @@ function buildWorkflows(graphMeta, _functionsMeta, _httpMeta, units, workflows,
             stepUnitNames.push(stepUnitName);
         }
         // Build orchestrator unit — no function code, just orchestration
-        const orchUnitName = `wf-${toKebab(graph.name)}`;
+        const orchUnitName = `wf-${toSafeKebab(graph.name)}`;
         const orchServices = [
             { capability: 'workflow-state', sourceServiceName: 'workflowService' },
             { capability: 'queue', sourceServiceName: 'queueService' },
@@ -387,7 +387,7 @@ function buildWorkflows(graphMeta, _functionsMeta, _httpMeta, units, workflows,
             },
         ];
         // Orchestrator queue — the orchestrator consumes from this
-        const orchQueueName = `wf-orchestrator-${toKebab(graph.name)}`;
+        const orchQueueName = `wf-orchestrator-${toSafeKebab(graph.name)}`;
         const orchHandlers = [
             { type: 'fetch', routes: wfRoutes },
             { type: 'queue', queueName: orchQueueName },
@@ -413,10 +413,10 @@ function buildWorkflows(graphMeta, _functionsMeta, _httpMeta, units, workflows,
         for (const step of steps) {
             if (step.inline || !step.functionId)
                 continue;
-            const stepQueueName = `wf-step-${toKebab(step.functionId)}`;
+            const stepQueueName = `wf-step-${toSafeKebab(step.functionId)}`;
             queues.push({
                 name: stepQueueName,
-                consumerUnit: toKebab(step.functionId),
+                consumerUnit: toSafeKebab(step.functionId),
                 consumerFunctionId: `pikkuWorkflowWorker:${step.functionId}`,
             });
         }
@@ -523,10 +523,13 @@ function collectChannelFunctionIds(channelMeta) {
 // ---------------------------------------------------------------------------
 // Naming helpers
 // ---------------------------------------------------------------------------
-function toKebab(str) {
+export function toSafeKebab(str) {
     return str
         .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
         .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .replace(/[:/\\]/g, '-')
+        .replace(/--+/g, '-')
+        .replace(/^-|-$/g, '')
         .toLowerCase();
 }
 function fromKebab(str) {

package/dist/src/deploy/codegen/per-unit-codegen.js

@@ -14,6 +14,7 @@ import { tmpdir } from 'node:os';
 import { randomBytes } from 'node:crypto';
 import { promisify } from 'node:util';
 import { serializeInspectorState } from '@pikku/inspector';
+import { toSafeKebab } from '../analyzer/analyzer.js';
 const execFileAsync = promisify(execFile);
 /**
  * Resolve the pikku CLI binary path.
@@ -122,12 +123,11 @@ function collectFilterNames(unit, manifest, inspectorState) {
                 names.add('http:get:/workflow/:workflowName/status/:runId/stream');
                 names.add('http:post:/workflow/:workflowName/graph/:nodeId');
                 // Queue names for orchestrator and step workers
-                const toKebab = (s) => s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
-                names.add(`wf-orchestrator-${toKebab(wfDef.name)}`);
+                names.add(`wf-orchestrator-${toSafeKebab(wfDef.name)}`);
                 for (const step of wfDef.steps) {
                     if (step.functionId) {
                         names.add(step.functionId);
-                        names.add(`wf-step-${toKebab(step.functionId)}`);
+                        names.add(`wf-step-${toSafeKebab(step.functionId)}`);
                     }
                 }
             }

package/dist/src/functions/commands/all.js

@@ -1,191 +1,7 @@
-import { existsSync } from 'fs';
 import { pikkuVoidFunc } from '#pikku';
-const scaffoldFiles = (config) => {
-    const files = [];
-    if (config.scaffold?.rpc && config.publicRpcFile)
-        files.push({ file: config.publicRpcFile, generator: 'pikkuPublicRPC' });
-    if (config.scaffold?.console && config.consoleFunctionsFile)
-        files.push({
-            file: config.consoleFunctionsFile,
-            generator: 'pikkuConsoleFunctions',
-        });
-    if (config.scaffold?.agent && config.publicAgentFile)
-        files.push({
-            file: config.publicAgentFile,
-            generator: 'pikkuPublicAgent',
-        });
-    return files;
-};
 export const all = pikkuVoidFunc({
     remote: true,
-    func: async ({ logger, config, getInspectorState }, _data, { rpc }) => {
-        const allImports = [];
-        let typesDeclarationFileExists = true;
-        if (!existsSync(config.outDir)) {
-            logger.debug(`• .pikku directory not found, running bootstrap first...`);
-            await getInspectorState(false, false, true);
-            await rpc.invoke('pikkuFunctionTypes', null);
-            await rpc.invoke('pikkuFunctionTypesSplit', null);
-            await rpc.invoke('pikkuHTTPTypes', null);
-            await rpc.invoke('pikkuChannelTypes', null);
-            await rpc.invoke('pikkuSchedulerTypes', null);
-            await rpc.invoke('pikkuQueueTypes', null);
-            await rpc.invoke('pikkuWorkflow', null);
-            await rpc.invoke('pikkuMCPTypes', null);
-            await rpc.invoke('pikkuAIAgentTypes', null);
-            await rpc.invoke('pikkuCLITypes', null);
-            await getInspectorState(true);
-        }
-        if (!existsSync(config.typesDeclarationFile)) {
-            typesDeclarationFileExists = false;
-        }
-        const missingScaffolds = scaffoldFiles(config).filter((s) => !existsSync(s.file));
-        if (missingScaffolds.length > 0) {
-            for (const { generator } of missingScaffolds) {
-                await rpc.invoke(generator, null);
-            }
-        }
-        await rpc.invoke('pikkuFunctionTypes', null);
-        if (!typesDeclarationFileExists || missingScaffolds.length > 0) {
-            logger.debug(`• Type file or scaffolds first created, inspecting again...`);
-            await getInspectorState(true);
-        }
-        await rpc.invoke('pikkuFunctionTypesSplit', null);
-        await rpc.invoke('pikkuTriggerTypes', null);
-        await rpc.invoke('pikkuAIAgentTypes', null);
-        if (!config.addon) {
-            await rpc.invoke('pikkuHTTPTypes', null);
-            await rpc.invoke('pikkuChannelTypes', null);
-            await rpc.invoke('pikkuSchedulerTypes', null);
-            await rpc.invoke('pikkuQueueTypes', null);
-            await rpc.invoke('pikkuMCPTypes', null);
-            await rpc.invoke('pikkuCLITypes', null);
-        }
-        const middleware = await rpc.invoke('pikkuMiddleware', null);
-        if (middleware) {
-            allImports.push(config.middlewareFile);
-        }
-        const permissions = await rpc.invoke('pikkuPermissions', null);
-        if (permissions) {
-            allImports.push(config.permissionsFile);
-        }
-        await rpc.invoke('pikkuServices', null);
-        const hasPackageFactories = await rpc.invoke('pikkuPackage', null);
-        if (hasPackageFactories) {
-            allImports.push(config.packageFile);
-        }
-        const hasInternalRPCs = await rpc.invoke('pikkuRPC', null);
-        const agents = await rpc.invoke('pikkuAIAgent', null);
-        if (agents) {
-            allImports.push(config.agentWiringMetaFile, config.agentWiringsFile);
-            if (config.scaffold?.agent) {
-                await rpc.invoke('pikkuPublicAgent', null);
-            }
-        }
-        await rpc.invoke('pikkuPublicRPC', null);
-        await rpc.invoke('pikkuConsoleFunctions', null);
-        await rpc.invoke('pikkuNodeTypes', null);
-        await rpc.invoke('pikkuSecretDefinitionTypes', null);
-        await rpc.invoke('pikkuSecrets', null);
-        await rpc.invoke('pikkuCredentials', null);
-        await rpc.invoke('pikkuVariableDefinitionTypes', null);
-        await rpc.invoke('pikkuVariables', null);
-        await rpc.invoke('pikkuAddonTypes', null);
-        if (hasInternalRPCs) {
-            allImports.push(config.rpcInternalWiringMetaFile);
-        }
-        if (agents || !config.addon) {
-            await getInspectorState(true);
-        }
-        const schemas = await rpc.invoke('pikkuSchemas', null);
-        if (schemas) {
-            allImports.push(`${config.schemaDirectory}/register.gen.ts`);
-        }
-        await rpc.invoke('pikkuRPCInternalMap', null);
-        await rpc.invoke('pikkuRPCExposedMap', null);
-        const workflows = await rpc.invoke('pikkuWorkflow', null);
-        let remoteRPC = false;
-        let workflowRoutes = false;
-        if (!config.addon) {
-            remoteRPC = await rpc.invoke('pikkuRemoteRPC', null);
-            if (workflows) {
-                workflowRoutes = await rpc.invoke('pikkuWorkflowRoutes', null);
-            }
-        }
-        if (workflows || remoteRPC || workflowRoutes) {
-            await getInspectorState(true);
-            await rpc.invoke('pikkuSchemas', null);
-        }
-        if (!config.addon) {
-            const http = await rpc.invoke('pikkuHTTP', null);
-            if (http) {
-                await rpc.invoke('pikkuHTTPMap', null);
-                await rpc.invoke('pikkuFetch', null);
-                await rpc.invoke('pikkuRPCClient', null);
-                allImports.push(config.httpWiringMetaFile, config.httpWiringsFile);
-            }
-            const scheduler = await rpc.invoke('pikkuScheduler', null);
-            if (scheduler) {
-                allImports.push(config.schedulersWiringMetaFile, config.schedulersWiringFile);
-            }
-            const triggers = await rpc.invoke('pikkuTrigger', null);
-            if (triggers) {
-                allImports.push(config.triggersWiringMetaFile, config.triggerSourcesMetaFile, config.triggersWiringFile);
-            }
-        }
-        const hasFunctionRegistrations = await rpc.invoke('pikkuFunctions', null);
-        allImports.push(config.functionsMetaFile);
-        if (hasFunctionRegistrations) {
-            allImports.push(config.functionsFile);
-        }
-        if (workflows) {
-            allImports.push(config.workflowsWiringFile);
-        }
-        if (!config.addon) {
-            const queues = await rpc.invoke('pikkuQueue', null);
-            if (queues) {
-                await rpc.invoke('pikkuQueueMap', null);
-                await rpc.invoke('pikkuQueueService', null);
-                allImports.push(config.queueWorkersWiringMetaFile, config.queueWorkersWiringFile);
-            }
-            const channels = await rpc.invoke('pikkuChannels', null);
-            if (channels) {
-                await rpc.invoke('pikkuChannelsMap', null);
-                await rpc.invoke('pikkuWebSocketTyped', null);
-                allImports.push(config.channelsWiringMetaFile, config.channelsWiringFile);
-            }
-            const gateways = await rpc.invoke('pikkuGateway', null);
-            if (gateways) {
-                allImports.push(config.gatewaysWiringFile);
-            }
-            const mcp = await rpc.invoke('pikkuMCP', null);
-            if (mcp) {
-                await rpc.invoke('pikkuMCPJSON', null);
-                allImports.push(config.mcpWiringsMetaFile, config.mcpWiringsFile);
-            }
-            const cli = await rpc.invoke('pikkuCLI', null);
-            if (cli) {
-                await rpc.invoke('pikkuCLIEntry', null);
-                allImports.push(config.cliWiringMetaFile, config.cliWiringsFile);
-            }
-        }
-        await rpc.invoke('pikkuNodesMeta', null);
-        if (config.clientFiles?.nextBackendFile ||
-            config.clientFiles?.nextHTTPFile) {
-            await rpc.invoke('pikkuNext', null);
-        }
-        if (config.openAPI) {
-            logger.debug(`• OpenAPI requires a reinspection to pickup new generated types..`);
-            await getInspectorState(true);
-            await rpc.invoke('pikkuOpenAPI', null);
-        }
-        try {
-            await rpc.invoke('pikkuVersionsUpdate', null);
-        }
-        catch {
-            logger.warn(`Run 'pikku versions init' to enable contract versioning.`);
-        }
-        await rpc.invoke('pikkuBootstrap', { allImports });
-        await rpc.invoke('pikkuSummary', null);
+    func: async (services, _data, { rpc }) => {
+        await services.workflowService.runToCompletion('allWorkflow', {}, rpc);
     },
 });

package/dist/src/functions/commands/bootstrap.js

@@ -3,16 +3,16 @@ export const bootstrap = pikkuVoidFunc({
     remote: true,
     func: async ({ logger, getInspectorState }, _data, { rpc }) => {
         await getInspectorState(false, false, true);
-        await rpc.invoke('pikkuFunctionTypes', null);
-        await rpc.invoke('pikkuFunctionTypesSplit', null);
-        await rpc.invoke('pikkuHTTPTypes', null);
-        await rpc.invoke('pikkuChannelTypes', null);
-        await rpc.invoke('pikkuSchedulerTypes', null);
-        await rpc.invoke('pikkuQueueTypes', null);
-        await rpc.invoke('pikkuWorkflow', null);
-        await rpc.invoke('pikkuMCPTypes', null);
-        await rpc.invoke('pikkuAIAgentTypes', null);
-        await rpc.invoke('pikkuCLITypes', null);
+        await rpc.invoke('pikkuFunctionTypes');
+        await rpc.invoke('pikkuFunctionTypesSplit');
+        await rpc.invoke('pikkuHTTPTypes');
+        await rpc.invoke('pikkuChannelTypes');
+        await rpc.invoke('pikkuSchedulerTypes');
+        await rpc.invoke('pikkuQueueTypes');
+        await rpc.invoke('pikkuWorkflow');
+        await rpc.invoke('pikkuMCPTypes');
+        await rpc.invoke('pikkuAIAgentTypes');
+        await rpc.invoke('pikkuCLITypes');
         if (logger.hasCriticalErrors()) {
             process.exit(1);
         }

package/dist/src/functions/commands/console.js

@@ -88,7 +88,7 @@ export const consoleCommand = pikkuSessionlessFunc({
                 const handle = async () => {
                     try {
                         const start = Date.now();
-                        await rpc.invoke('all', null);
+                        await rpc.invoke('all');
                         logger.info({
                             message: `✓ Generated in ${Date.now() - start}ms`,
                             type: 'timing',

package/dist/src/functions/commands/dev.d.ts

@@ -0,0 +1,13 @@
+export declare const dev: import("#pikku").PikkuFunctionConfig<{
+    port?: string;
+    watch?: boolean;
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
+    port?: string;
+    watch?: boolean;
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    port?: string;
+    watch?: boolean;
+    hmr?: boolean;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;