@pikku/cli 0.11.3 → 0.12.1

package/bin/pikku.ts

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander'
-import { createConfig, createSingletonServices } from '../src/services.js'
-import { LocalVariablesService } from '@pikku/core/services'
-import { all as allCommand } from '../src/functions/commands/all.js'
-import { watch as watchCommand } from '../src/functions/commands/watch.js'
-
-// Import bootstrap if it exists
-try {
-  await import('../.pikku/pikku-bootstrap.gen.js')
-} catch {
-  // Bootstrap doesn't exist yet, continue anyway
-}
-
-const action = async (command: string, cliConfig: any) => {
-  const config = await createConfig(new LocalVariablesService(), cliConfig)
-  const services = await createSingletonServices(config)
-
-  if (command === 'watch') {
-    await watchCommand.func(services)
-  } else {
-    await allCommand.func(services)
-  }
-}
-
-const all = (program, name, description) => {
-  program
-    .command(name, { isDefault: name === 'all' })
-    .description(description)
-    .option('--pikku-config-type', 'The type of your pikku config object')
-    .option(
-      '--singleton-services-factory-type',
-      'The type of your singleton services factory'
-    )
-    .option(
-      '--session-services-factory-type',
-      'The type of your wire services factory'
-    )
-    .option('-c, --config <string>', 'The path to pikku cli config file')
-    .option('-t, --tags <tags...>', 'Which tags to filter by')
-    .option(
-      '--types <types...>',
-      'Which types to filter by (http, channel, queue, scheduler, rpc, mcp)'
-    )
-    .option(
-      '-d, --directories <directories...>',
-      'Which directories to filter by'
-    )
-    .option(
-      '-n, --names <names...>',
-      'Filter functions by name patterns (supports wildcards)'
-    )
-    .option(
-      '--httpMethods <methods...>',
-      'Filter HTTP routes by methods (comma-separated)'
-    )
-    .option(
-      '--httpRoutes <routes...>',
-      'Filter HTTP routes by route patterns (comma-separated)'
-    )
-    .option('-s, --silent', 'Silent mode - only show critical errors')
-    .option(
-      '--info',
-      'Show info messages and above (info, warn, error, critical)'
-    )
-    .option('--verbose', 'Show all debug messages (most detailed)')
-    .option(
-      '--loglevel <level>',
-      'Set explicit log level (trace, debug, info, warn, error, critical)'
-    )
-    .option(
-      '--state-output <path>',
-      'Save inspector state to JSON file for reuse'
-    )
-    .option(
-      '--state-input <path>',
-      'Load inspector state from JSON file (skips inspection)'
-    )
-    .action((c) => action(name, c))
-}
-
-const program = new Command('pikku')
-program.usage('[command]')
-
-all(program, 'all', 'Generate all pikku wirings and files')
-all(program, 'watch', 'Watch for changes in pikku files')
-
-program.parse(process.argv)

package/build.sh

@@ -1,75 +0,0 @@
-#!/bin/bash
-
-set -e
-
-echo "Starting Pikku CLI build process..."
-
-# Clean .pikku directory
-rm -rf .pikku
-
-# Create minimal bootstrap stub files
-echo "Creating minimal bootstrap stub files..."
-mkdir -p .pikku/function .pikku/cli
-
-cat > .pikku/pikku-types.gen.ts << 'EOF'
-/**
- * Bootstrap stub - minimal types for initial build
- */
-export * from './function/pikku-function-types.gen.js'
-export * from './cli/pikku-cli-types.gen.js'
-EOF
-
-cat > .pikku/function/pikku-function-types.gen.ts << 'EOF'
-/**
- * Bootstrap stub - minimal function types
- */
-export const pikkuFunc = <In, Out = unknown>(func: any) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-export const pikkuSessionlessFunc = <In, Out = unknown>(func: any) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-export const pikkuVoidFunc = (func: any) => {
-  return typeof func === 'function' ? { func } : func
-}
-EOF
-
-cat > .pikku/cli/pikku-cli-types.gen.ts << 'EOF'
-/**
- * Bootstrap stub - minimal CLI types
- */
-export { wireCLI } from '@pikku/core/cli'
-
-export const pikkuCLICommand = (config: any) => {
-  return config
-}
-EOF
-
-cat > .pikku/pikku-bootstrap.gen.ts << 'EOF'
-/**
- * Bootstrap stub - empty bootstrap file
- */
-EOF
-
-# Build TypeScript with stubs
-echo "Building TypeScript to dist..."
-yarn tsc -b
-
-# Regenerate types with newly built CLI
-echo "Removing .pikku directory (generated from published version)..."
-rm -rf .pikku
-
-echo "Regenerating Pikku types using local CLI..."
-yarn pikku
-
-# Rebuild with generated types
-echo "Rebuilding TypeScript with local types..."
-yarn tsc -b
-
-# Copy schema file
-echo "Copying schema file..."
-cp .pikku/schemas/schemas/PikkuCLIConfig.schema.json cli.schema.json
-
-echo "Build complete! ✓"

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

@@ -1,72 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */
-/**
- * Forge-specific type definitions for typed wireForgeNode and wireForgeCredential
- */
-import type { CoreForgeNode, CoreForgeCredential } from '@pikku/core/forge-node';
-import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.js';
-/**
- * Valid category values for forge nodes.
- * No categories configured - wireForgeNode cannot be used until forge.node.categories is defined in pikku.config.json.
- */
-export type ForgeCategory = never;
-/**
- * Valid RPC names that can be used with forge nodes.
- * These are derived from the FlattenedRPCMap which includes both local and external package RPCs.
- */
-export type ForgeRPCName = keyof FlattenedRPCMap;
-/**
- * Typed forge node configuration.
- * Validates that category and rpc are valid values.
- */
-export type TypedForgeNode = Omit<CoreForgeNode, 'category' | 'rpc'> & {
-    /** Grouping category (validated against forge.node.categories in config) */
-    category: ForgeCategory;
-    /** RPC name to call when node executes (must be a valid RPC name) */
-    rpc: ForgeRPCName;
-};
-/**
- * Registers a Forge node with validated category and RPC.
- *
- * @param config - Forge node configuration with typed category and rpc
- *
- * @example
- * ```typescript
- * wireForgeNode({
- *   name: 'send-email',
- *   displayName: 'Send Email',
- *   category: 'Communication', // Must be in forge.node.categories
- *   type: 'action',
- *   rpc: 'sendEmail', // Must be a valid RPC name
- *   description: 'Sends an email to a recipient'
- * })
- * ```
- */
-export declare const wireForgeNode: (config: TypedForgeNode) => void;
-/**
- * Registers a Forge credential definition.
- * Credentials define secrets/API keys required by the package.
- *
- * @template T - Zod schema type for the credential structure
- * @param config - Forge credential configuration
- *
- * @example
- * ```typescript
- * import { z } from 'zod'
- *
- * const apiCredentials = z.object({
- *   apiKey: z.string().describe('API key for authentication'),
- *   apiSecret: z.string().describe('API secret')
- * })
- *
- * wireForgeCredential({
- *   name: 'example-api',
- *   displayName: 'Example API Credentials',
- *   description: 'Credentials for the example external API',
- *   secretId: 'EXAMPLE_API_CREDENTIALS',
- *   schema: apiCredentials
- * })
- * ```
- */
-export declare const wireForgeCredential: <T>(config: CoreForgeCredential<T>) => void;

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

@@ -1,55 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.3
- */
-/**
- * Forge-specific type definitions for typed wireForgeNode and wireForgeCredential
- */
-import { wireForgeNode as wireForgeNodeCore, wireForgeCredential as wireForgeCredentialCore } from '@pikku/core/forge-node';
-/**
- * Registers a Forge node with validated category and RPC.
- *
- * @param config - Forge node configuration with typed category and rpc
- *
- * @example
- * ```typescript
- * wireForgeNode({
- *   name: 'send-email',
- *   displayName: 'Send Email',
- *   category: 'Communication', // Must be in forge.node.categories
- *   type: 'action',
- *   rpc: 'sendEmail', // Must be a valid RPC name
- *   description: 'Sends an email to a recipient'
- * })
- * ```
- */
-export const wireForgeNode = (config) => {
-    wireForgeNodeCore(config);
-};
-/**
- * Registers a Forge credential definition.
- * Credentials define secrets/API keys required by the package.
- *
- * @template T - Zod schema type for the credential structure
- * @param config - Forge credential configuration
- *
- * @example
- * ```typescript
- * import { z } from 'zod'
- *
- * const apiCredentials = z.object({
- *   apiKey: z.string().describe('API key for authentication'),
- *   apiSecret: z.string().describe('API secret')
- * })
- *
- * wireForgeCredential({
- *   name: 'example-api',
- *   displayName: 'Example API Credentials',
- *   description: 'Credentials for the example external API',
- *   secretId: 'EXAMPLE_API_CREDENTIALS',
- *   schema: apiCredentials
- * })
- * ```
- */
-export const wireForgeCredential = (config) => {
-    wireForgeCredentialCore(config);
-};

package/dist/.pikku/schemas/schemas/PikkuForgeNodesOutput.schema.json

@@ -1 +0,0 @@
-{ "type": "boolean" }

package/dist/src/functions/wirings/channels/pikku-command-websocket-typed.d.ts

@@ -1 +0,0 @@
-export declare const pikkuWebSocketTyped: any;

package/dist/src/functions/wirings/fetch/index.d.ts

@@ -1 +0,0 @@
-export declare const pikkuFetch: any;

package/dist/src/functions/wirings/forge/pikku-command-forge-nodes.d.ts

@@ -1 +0,0 @@
-export declare const pikkuForgeNodes: any;

package/dist/src/functions/wirings/forge/pikku-command-forge-nodes.js

@@ -1,90 +0,0 @@
-import { pikkuSessionlessFunc } from '../../../../.pikku/pikku-types.gen.js';
-import { ErrorCode } from '@pikku/inspector';
-import { writeFileInDir } from '../../../utils/file-writer.js';
-import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
-import { readFile } from 'fs/promises';
-import { join, isAbsolute } from 'path';
-import { stripVerboseFields, hasVerboseFields, } from '../../../utils/strip-verbose-meta.js';
-/**
- * Load and sanitize an SVG icon file.
- * Returns the SVG content as a string, or undefined if not found.
- */
-const loadIcon = async (iconPath, rootDir, logger) => {
-    if (!iconPath)
-        return undefined;
-    // Resolve the full path to the icon
-    const fullPath = isAbsolute(iconPath) ? iconPath : join(rootDir, iconPath);
-    try {
-        const content = await readFile(fullPath, 'utf-8');
-        // Basic SVG validation - must start with <svg
-        const trimmed = content.trim();
-        if (!trimmed.startsWith('<svg') && !trimmed.startsWith('<?xml')) {
-            logger.warn(`Icon file is not a valid SVG: ${fullPath}`);
-            return undefined;
-        }
-        // Return the sanitized SVG (remove XML declaration if present)
-        return trimmed.replace(/<\?xml[^?]*\?>\s*/g, '').trim();
-    }
-    catch (e) {
-        logger.warn(`Could not load icon: ${fullPath}`);
-        return undefined;
-    }
-};
-export const pikkuForgeNodes = pikkuSessionlessFunc({
-    func: async ({ logger, config, getInspectorState }) => {
-        const { forgeNodes, forgeCredentials } = await getInspectorState();
-        const { forgeNodesMetaJsonFile, forge, rootDir } = config;
-        const hasNodes = Object.keys(forgeNodes.meta).length > 0;
-        const hasCredentials = Object.keys(forgeCredentials.meta).length > 0;
-        // Only generate if there are forge nodes or credentials
-        if (!hasNodes && !hasCredentials) {
-            return undefined;
-        }
-        // Validate categories if configured
-        const allowedCategories = forge?.node?.categories;
-        if (allowedCategories && allowedCategories.length > 0) {
-            for (const [name, meta] of Object.entries(forgeNodes.meta)) {
-                if (!allowedCategories.includes(meta.category)) {
-                    logger.critical(ErrorCode.INVALID_VALUE, `Forge node '${name}' has invalid category '${meta.category}'. ` +
-                        `Allowed categories: ${allowedCategories.join(', ')}`);
-                }
-            }
-        }
-        // Build the output metadata - remove per-node icon field
-        const outputMeta = {};
-        for (const [name, meta] of Object.entries(forgeNodes.meta)) {
-            // Remove icon from node meta - only package-level icon is used
-            const { icon: _icon, ...nodeMetaWithoutIcon } = meta;
-            outputMeta[name] = nodeMetaWithoutIcon;
-        }
-        // Load package-level icon
-        const packageIcon = await loadIcon(forge?.node?.icon, rootDir, logger);
-        const metaData = {
-            nodes: outputMeta,
-            credentials: forgeCredentials.meta,
-            package: {
-                displayName: forge?.node?.displayName,
-                description: forge?.node?.description,
-                icon: packageIcon,
-                categories: forge?.node?.categories,
-            },
-        };
-        if (forgeNodesMetaJsonFile) {
-            // Write minimal JSON (runtime-only fields)
-            const minimalMeta = stripVerboseFields(metaData);
-            await writeFileInDir(logger, forgeNodesMetaJsonFile, JSON.stringify(minimalMeta, null, 2), { ignoreModifyComment: true });
-            // Write verbose JSON only if it has additional fields
-            if (hasVerboseFields(metaData)) {
-                const verbosePath = forgeNodesMetaJsonFile.replace(/\.gen\.json$/, '-verbose.gen.json');
-                await writeFileInDir(logger, verbosePath, JSON.stringify(metaData, null, 2), { ignoreModifyComment: true });
-            }
-        }
-        return true;
-    },
-    middleware: [
-        logCommandInfoAndTime({
-            commandStart: 'Generating Forge nodes metadata',
-            commandEnd: 'Generated Forge nodes metadata',
-        }),
-    ],
-});

package/dist/src/functions/wirings/forge/pikku-command-forge-types.d.ts

@@ -1 +0,0 @@
-export declare const pikkuForgeTypes: any;

package/dist/src/functions/wirings/forge/pikku-command-forge-types.js

@@ -1,26 +0,0 @@
-import { pikkuSessionlessFunc } from '../../../../.pikku/pikku-types.gen.js';
-import { writeFileInDir } from '../../../utils/file-writer.js';
-import { getFileImportRelativePath } from '../../../utils/file-import-path.js';
-import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
-import { serializeForgeTypes } from './serialize-forge-types.js';
-export const pikkuForgeTypes = pikkuSessionlessFunc({
-    func: async ({ logger, config }) => {
-        const { forgeTypesFile, rpcInternalMapDeclarationFile, packageMappings, forge, } = config;
-        // Get the import path for the RPC map declaration file
-        // The declaration file ends in .d.ts, but we need to import from .js
-        // getFileImportRelativePath converts .ts -> .js, so .d.ts -> .d.js
-        // We need to remove the extra .d extension
-        let rpcMapImportPath = getFileImportRelativePath(forgeTypesFile, rpcInternalMapDeclarationFile, packageMappings);
-        // Fix: .d.ts files should be imported as .js (TypeScript resolves types from .d.ts)
-        rpcMapImportPath = rpcMapImportPath.replace('.d.js', '.js');
-        const categories = forge?.node?.categories;
-        const content = serializeForgeTypes(rpcMapImportPath, categories);
-        await writeFileInDir(logger, forgeTypesFile, content);
-    },
-    middleware: [
-        logCommandInfoAndTime({
-            commandStart: 'Creating Forge types',
-            commandEnd: 'Created Forge types',
-        }),
-    ],
-});

package/dist/src/functions/wirings/forge/serialize-forge-types.d.ts

@@ -1,4 +0,0 @@
-/**
- * Generates type definitions for Forge wirings with typed category and RPC validation
- */
-export declare const serializeForgeTypes: (rpcMapImportPath: string, categories: string[] | undefined) => string;

package/dist/src/functions/wirings/forge/serialize-forge-types.js

@@ -1,90 +0,0 @@
-/**
- * Generates type definitions for Forge wirings with typed category and RPC validation
- */
-export const serializeForgeTypes = (rpcMapImportPath, categories) => {
-    // Generate category union type - 'never' if no categories configured
-    const categoryType = categories?.length
-        ? categories.map((c) => `'${c}'`).join(' | ')
-        : 'never';
-    return `/**
- * Forge-specific type definitions for typed wireForgeNode and wireForgeCredential
- */
-
-import { wireForgeNode as wireForgeNodeCore, wireForgeCredential as wireForgeCredentialCore } from '@pikku/core/forge-node'
-import type { CoreForgeNode, CoreForgeCredential } from '@pikku/core/forge-node'
-import type { FlattenedRPCMap } from '${rpcMapImportPath}'
-
-/**
- * Valid category values for forge nodes.
- * ${categories?.length ? `Configured categories: ${categories.join(', ')}` : 'No categories configured - wireForgeNode cannot be used until forge.node.categories is defined in pikku.config.json.'}
- */
-export type ForgeCategory = ${categoryType}
-
-/**
- * Valid RPC names that can be used with forge nodes.
- * These are derived from the FlattenedRPCMap which includes both local and external package RPCs.
- */
-export type ForgeRPCName = keyof FlattenedRPCMap
-
-/**
- * Typed forge node configuration.
- * Validates that category and rpc are valid values.
- */
-export type TypedForgeNode = Omit<CoreForgeNode, 'category' | 'rpc'> & {
-  /** Grouping category (validated against forge.node.categories in config) */
-  category: ForgeCategory
-  /** RPC name to call when node executes (must be a valid RPC name) */
-  rpc: ForgeRPCName
-}
-
-/**
- * Registers a Forge node with validated category and RPC.
- *
- * @param config - Forge node configuration with typed category and rpc
- *
- * @example
- * \`\`\`typescript
- * wireForgeNode({
- *   name: 'send-email',
- *   displayName: 'Send Email',
- *   category: 'Communication', // Must be in forge.node.categories
- *   type: 'action',
- *   rpc: 'sendEmail', // Must be a valid RPC name
- *   description: 'Sends an email to a recipient'
- * })
- * \`\`\`
- */
-export const wireForgeNode = (config: TypedForgeNode): void => {
-  wireForgeNodeCore(config as CoreForgeNode)
-}
-
-/**
- * Registers a Forge credential definition.
- * Credentials define secrets/API keys required by the package.
- *
- * @template T - Zod schema type for the credential structure
- * @param config - Forge credential configuration
- *
- * @example
- * \`\`\`typescript
- * import { z } from 'zod'
- *
- * const apiCredentials = z.object({
- *   apiKey: z.string().describe('API key for authentication'),
- *   apiSecret: z.string().describe('API secret')
- * })
- *
- * wireForgeCredential({
- *   name: 'example-api',
- *   displayName: 'Example API Credentials',
- *   description: 'Credentials for the example external API',
- *   secretId: 'EXAMPLE_API_CREDENTIALS',
- *   schema: apiCredentials
- * })
- * \`\`\`
- */
-export const wireForgeCredential = <T>(config: CoreForgeCredential<T>): void => {
-  wireForgeCredentialCore(config)
-}
-`;
-};

package/dist/src/functions/wirings/functions/pikku-function-types.d.ts

@@ -1 +0,0 @@
-export declare const pikkuFunctionTypes: any;

package/dist/src/functions/wirings/functions/pikku-function-types.js

@@ -1,18 +0,0 @@
-import { pikkuSessionlessFunc } from '../../../../.pikku/pikku-types.gen.js';
-import { getFileImportRelativePath } from '../../../utils/file-import-path.js';
-import { writeFileInDir } from '../../../utils/file-writer.js';
-import { logCommandInfoAndTime } from '../../../middleware/log-command-info-and-time.js';
-import { serializePikkuTypesHub } from './serialize-pikku-types-hub.js';
-export const pikkuFunctionTypes = pikkuSessionlessFunc({
-    func: async ({ logger, config }) => {
-        const { typesDeclarationFile: typesFile, packageMappings, functionTypesFile, httpTypesFile, channelsTypesFile, schedulersTypesFile, queueTypesFile, mcpTypesFile, cliTypesFile, forgeTypesFile, } = config;
-        const content = serializePikkuTypesHub(getFileImportRelativePath(typesFile, functionTypesFile, packageMappings), getFileImportRelativePath(typesFile, httpTypesFile, packageMappings), getFileImportRelativePath(typesFile, channelsTypesFile, packageMappings), getFileImportRelativePath(typesFile, schedulersTypesFile, packageMappings), getFileImportRelativePath(typesFile, queueTypesFile, packageMappings), getFileImportRelativePath(typesFile, mcpTypesFile, packageMappings), getFileImportRelativePath(typesFile, cliTypesFile, packageMappings), getFileImportRelativePath(typesFile, forgeTypesFile, packageMappings));
-        await writeFileInDir(logger, typesFile, content);
-    },
-    middleware: [
-        logCommandInfoAndTime({
-            commandStart: 'Creating api types hub',
-            commandEnd: 'Created api types hub',
-        }),
-    ],
-});

package/dist/src/functions/wirings/http/openapi-spec-generator.d.ts

@@ -1,81 +0,0 @@
-import { FunctionsMeta } from '@pikku/core';
-import { HTTPWiringsMeta } from '@pikku/core/http';
-import { CLILogger } from '../../../services/cli-logger.service.js';
-interface OpenAPISpec {
-    openapi: string;
-    info: {
-        title: string;
-        version: string;
-        description?: string;
-        termsOfService?: string;
-        contact?: {
-            name?: string;
-            url?: string;
-            email?: string;
-        };
-        license?: {
-            name: string;
-            url?: string;
-        };
-    };
-    servers: {
-        url: string;
-        description?: string;
-    }[];
-    paths: Record<string, any>;
-    components: {
-        schemas: Record<string, any>;
-        responses?: Record<string, any>;
-        parameters?: Record<string, any>;
-        examples?: Record<string, any>;
-        requestBodies?: Record<string, any>;
-        headers?: Record<string, any>;
-        securitySchemes?: Record<string, any>;
-    };
-    security?: {
-        [key: string]: any[];
-    }[];
-    tags?: {
-        name: string;
-        description?: string;
-    }[];
-    externalDocs?: {
-        description?: string;
-        url: string;
-    };
-}
-export interface OpenAPISpecInfo {
-    info: {
-        title: string;
-        version: string;
-        description: string;
-        termsOfService?: string;
-        contact?: {
-            name?: string;
-            url?: string;
-            email?: string;
-        };
-        license?: {
-            name: string;
-            url?: string;
-        };
-    };
-    servers: {
-        url: string;
-        description?: string;
-    }[];
-    tags?: {
-        name: string;
-        description?: string;
-    }[];
-    externalDocs?: {
-        description?: string;
-        url: string;
-    };
-    securitySchemes?: Record<string, any>;
-    security?: {
-        [key: string]: any[];
-    }[];
-}
-export declare function generateOpenAPISpec(logger: CLILogger, functionsMeta: FunctionsMeta, httpMeta: HTTPWiringsMeta, schemas: Record<string, any>, additionalInfo: OpenAPISpecInfo): Promise<OpenAPISpec>;
-export {};