@pikku/cli 0.11.2 → 0.12.0

package/.pikku/services/config.gen.json

@@ -1,99 +0,0 @@
-{
-  "name": "config",
-  "summary": "",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "export interface Config extends CoreConfig<PikkuCLIConfig> {\n  // Preloaded inspector state from stateInput file (if provided)\n  preloadedInspectorState?: Omit<InspectorState, 'typesLookup'>\n}",
-  "expandedProperties": {
-    "preloadedInspectorState": "Omit<InspectorState, \"typesLookup\"> | undefined",
-    "logLevel": "LogLevel | undefined",
-    "secrets": "{} | undefined",
-    "workflow": "WorkflowServiceConfig | undefined",
-    "$schema": "string | undefined",
-    "extends": "string | undefined",
-    "rootDir": "string",
-    "srcDirectories": "string[]",
-    "ignoreFiles": "string[] | undefined",
-    "packageMappings": "Record<string, string>",
-    "configFile": "string | undefined",
-    "tags": "string[] | undefined",
-    "types": "string[] | undefined",
-    "userSessionType": "string | undefined",
-    "singletonServicesFactoryType": "string | undefined",
-    "wireServicesFactoryType": "string | undefined",
-    "configDir": "string",
-    "tsconfig": "string",
-    "nextBackendFile": "string | undefined",
-    "nextHTTPFile": "string | undefined",
-    "fetchFile": "string | undefined",
-    "websocketFile": "string | undefined",
-    "rpcWiringsFile": "string | undefined",
-    "queueWiringsFile": "string | undefined",
-    "mcpJsonFile": "string | undefined",
-    "openAPI": "{ outputFile: string; additionalInfo: OpenAPISpecInfo; } | undefined",
-    "schema": "{ additionalProperties?: boolean; supportsImportAttributes?: boolean; } | undefined",
-    "cli": "{ entrypoints?: Record<string, string | { type: \"local\"; path: string; } | { type: \"channel\"; name?: string; route?: string; wirePath: string; path?: string; } | Array<string | { type: \"local\"; path: string; } | { type: \"channel\"; name?: string; route?: string; wirePath: string; path?: string; }>>; } | undefined",
-    "workflows": "{ singleQueue: true; path: string; orchestratorQueue?: string; workerQueue?: string; } | { singleQueue: false; dir: string; orchestratorQueuePrefix?: string; workerQueuePrefix?: string; } | undefined",
-    "rpc": "{ remoteRpcWorkersPath?: string; publicRpcPath?: string; } | undefined",
-    "forceRequiredServices": "string[] | undefined",
-    "schemasFromTypes": "string[] | undefined",
-    "stateOutput": "string | undefined",
-    "stateInput": "string | undefined",
-    "filters": "InspectorFilters",
-    "outDir": "string",
-    "schemaDirectory": "string",
-    "typesDeclarationFile": "string",
-    "functionsFile": "string",
-    "functionsMetaFile": "string",
-    "functionsMetaJsonFile": "string",
-    "functionsMetaMinFile": "string",
-    "functionsMetaMinJsonFile": "string",
-    "functionTypesFile": "string",
-    "httpWiringsFile": "string",
-    "httpWiringMetaFile": "string",
-    "httpWiringMetaJsonFile": "string",
-    "httpMapDeclarationFile": "string",
-    "httpTypesFile": "string",
-    "channelsWiringFile": "string",
-    "channelsWiringMetaFile": "string",
-    "channelsWiringMetaJsonFile": "string",
-    "channelsMapDeclarationFile": "string",
-    "channelsTypesFile": "string",
-    "rpcInternalWiringMetaFile": "string",
-    "rpcInternalWiringMetaJsonFile": "string",
-    "rpcInternalMapDeclarationFile": "string",
-    "rpcMapDeclarationFile": "string",
-    "schedulersWiringFile": "string",
-    "schedulersWiringMetaFile": "string",
-    "schedulersWiringMetaJsonFile": "string",
-    "schedulersTypesFile": "string",
-    "queueWorkersWiringFile": "string",
-    "queueWorkersWiringMetaFile": "string",
-    "queueWorkersWiringMetaJsonFile": "string",
-    "queueMapDeclarationFile": "string",
-    "queueTypesFile": "string",
-    "workflowsWiringFile": "string",
-    "workflowsWiringMetaFile": "string",
-    "workflowsWiringMetaJsonFile": "string",
-    "workflowsWorkersFile": "string",
-    "workflowMapDeclarationFile": "string",
-    "workflowTypesFile": "string",
-    "mcpWiringsFile": "string",
-    "mcpWiringsMetaFile": "string",
-    "mcpWiringsMetaJsonFile": "string",
-    "mcpTypesFile": "string",
-    "cliWiringsFile": "string",
-    "cliWiringMetaFile": "string",
-    "cliWiringMetaJsonFile": "string",
-    "cliBootstrapFile": "string",
-    "cliTypesFile": "string",
-    "servicesFile": "string",
-    "middlewareFile": "string",
-    "middlewareGroupsMetaFile": "string",
-    "middlewareGroupsMetaJsonFile": "string",
-    "permissionsFile": "string",
-    "bootstrapFile": "string"
-  }
-}

package/.pikku/services/getInspectorState.gen.json

@@ -1,10 +0,0 @@
-{
-  "name": "getInspectorState",
-  "summary": "",
-  "description": "",
-  "package": "@pikku/cli",
-  "path": "home/runner/work/pikku/pikku/packages/cli/types/application-types.d.ts",
-  "version": "0.11.2",
-  "interface": "(refresh?: boolean, setupOnly?: boolean, bootstrapMode?: boolean) => Promise<InspectorState>",
-  "expandedProperties": {}
-}

package/.pikku/services/jwt.gen.json

@@ -1,13 +0,0 @@
-{
-  "name": "jwt",
-  "summary": "Interface for handling JSON Web Tokens (JWT).",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "export interface JWTService {\n    /**\n     * Encodes a payload into a JWT.\n     * @param expiresIn - The expiration time of the token.\n     * @param payload - The payload to encode.\n     * @returns A promise that resolves to the encoded JWT.\n     */\n    encode: <T extends any>(expiresIn: RelativeTimeInput, payload: T) => Promise<string>;\n    /**\n     * Decodes a JWT into its payload.\n     * @param hash - The JWT to decode.\n     * @param invalidHashError - An optional error to throw if the hash is invalid.\n     * @param debug - An optional flag for debugging.\n     * @returns A promise that resolves to the decoded payload.\n     */\n    decode: <T>(hash: string, invalidHashError?: Error, debug?: boolean) => Promise<T>;\n}",
-  "expandedProperties": {
-    "encode": "<T extends unknown>(expiresIn: RelativeTimeInput, payload: T) => Promise<string>",
-    "decode": "<T>(hash: string, invalidHashError?: Error, debug?: boolean) => Promise<T>"
-  }
-}

package/.pikku/services/logger.gen.json

@@ -1,25 +0,0 @@
-{
-  "name": "logger",
-  "summary": "",
-  "description": "",
-  "package": "@pikku/cli",
-  "path": "home/runner/work/pikku/pikku/packages/cli/types/application-types.d.ts",
-  "version": "0.11.2",
-  "interface": "class CLILogger {\n  constructor({\n    logLogo,\n    silent = false,\n  }: {\n    logLogo: boolean\n    silent?: boolean\n  });\n  setLevel(level: LogLevel): void;\n  setSilent(silent: boolean): void;\n  isSilent(): boolean;\n  info(message: string | { message: string; type?: string }): void;\n  error(message: string): void;\n  warn(message: string): void;\n  debug(message: string | { message: string; type?: string }): void;\n  critical(code: ErrorCode, message: string): void;\n  hasCriticalErrors(): boolean;\n  logLogo(): void;\n}",
-  "expandedProperties": {
-    "silent": "boolean",
-    "level": "LogLevel",
-    "criticalErrors": "string[]",
-    "setLevel": "(level: LogLevel) => void",
-    "setSilent": "(silent: boolean) => void",
-    "isSilent": "() => boolean",
-    "info": "(message: string | { message: string; type?: string; }) => void",
-    "error": "(message: string) => void",
-    "warn": "(message: string) => void",
-    "debug": "(message: string | { message: string; type?: string; }) => void",
-    "critical": "(code: ErrorCode, message: string) => void",
-    "hasCriticalErrors": "() => boolean",
-    "logLogo": "() => void",
-    "primary": "(message: string) => void"
-  }
-}

package/.pikku/services/queueService.gen.json

@@ -1,14 +0,0 @@
-{
-  "name": "queueService",
-  "summary": "Queue provider interface for job publishing operations",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "export interface QueueService {\n    /** Whether this queue provider supports job results */\n    readonly supportsResults: boolean;\n    /** Add a job to the queue with type safety */\n    add<T>(queueName: string, data: T, options?: JobOptions): Promise<string>;\n    /** Get job status and result */\n    getJob<T, R>(queueName: string, jobId: string): Promise<QueueJob<T, R> | null>;\n}",
-  "expandedProperties": {
-    "supportsResults": "boolean",
-    "add": "<T>(queueName: string, data: T, options?: JobOptions) => Promise<string>",
-    "getJob": "<T, R>(queueName: string, jobId: string) => Promise<QueueJob<T, R> | null>"
-  }
-}

package/.pikku/services/schedulerService.gen.json

@@ -1,17 +0,0 @@
-{
-  "name": "schedulerService",
-  "summary": "Abstract scheduler service for persistent scheduled task management",
-  "description": "Implementations use queue backends (pg-boss, BullMQ) for distributed scheduling",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "class SchedulerService {\n  init(): Promise<void>;\n  scheduleRPC(delay: number | string, rpcName: string, data?: any, session?: CoreUserSession): Promise<string>;\n  unschedule(taskId: string): Promise<boolean>;\n  getTask(taskId: string): Promise<ScheduledTaskInfo | null>;\n  getAllTasks(): Promise<ScheduledTaskSummary[]>;\n  close(): Promise<void>;\n}",
-  "expandedProperties": {
-    "init": "() => Promise<void>",
-    "scheduleRPC": "(delay: number | string, rpcName: string, data?: any, session?: CoreUserSession) => Promise<string>",
-    "unschedule": "(taskId: string) => Promise<boolean>",
-    "getTask": "(taskId: string) => Promise<ScheduledTaskInfo | null>",
-    "getAllTasks": "() => Promise<ScheduledTaskSummary[]>",
-    "close": "() => Promise<void>"
-  }
-}

package/.pikku/services/schema.gen.json

@@ -1,14 +0,0 @@
-{
-  "name": "schema",
-  "summary": "Interface for a schema service that handles schema compilation, validation, and management.",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "export interface SchemaService {\n    /**\n     * Compiles a schema with the provided name and value, making it available for use.\n     * @param {string} name - The unique name for the schema.\n     * @param {any} value - The schema definition or configuration to be compiled.\n     * @returns {Promise<void> | void} A promise if asynchronous, or void if synchronous.\n     */\n    compileSchema: (name: string, value: any) => Promise<void> | void;\n    /**\n     * Validates data against a specified schema.\n     * @param {string} schema - The name of the schema to validate against.\n     * @param {any} data - The data to validate against the schema.\n     * @returns {Promise<void> | void} A promise if asynchronous, or void if synchronous.\n     */\n    validateSchema: (schema: string, data: any) => Promise<void> | void;\n    /**\n     * Retrieves a set of all registered schema names.\n     * @returns {Set<string>} A set containing the names of all available schemas.\n     */\n    getSchemaNames: () => Set<string>;\n}",
-  "expandedProperties": {
-    "compileSchema": "(name: string, value: any) => Promise<void> | void",
-    "validateSchema": "(schema: string, data: any) => Promise<void> | void",
-    "getSchemaNames": "() => Set<string>"
-  }
-}

package/.pikku/services/variables.gen.json

@@ -1,13 +0,0 @@
-{
-  "name": "variables",
-  "summary": "",
-  "description": "",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "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}",
-  "expandedProperties": {
-    "get": "(name: string) => Promise<string | undefined> | string | undefined",
-    "getAll": "() => Promise<Record<string, string | undefined>> | Record<string, string | undefined>"
-  }
-}

package/.pikku/services/workflowService.gen.json

@@ -1,31 +0,0 @@
-{
-  "name": "workflowService",
-  "summary": "Interface for workflow orchestration",
-  "description": "Handles workflow execution, replay, orchestration logic, and run-level state",
-  "package": "@pikku/core",
-  "path": "home/runner/work/pikku/pikku/packages/core/dist/types/core.types.d.ts",
-  "version": "0.11.1",
-  "interface": "export interface WorkflowService {\n    createRun(workflowName: string, input: any): 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): Promise<{\n        runId: string;\n    }>;\n    runWorkflowJob(runId: string, rpcService: any): Promise<void>;\n    orchestrateWorkflow(runId: string, rpcService: any): Promise<void>;\n    executeWorkflowSleep(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}",
-  "expandedProperties": {
-    "createRun": "(workflowName: string, input: any) => Promise<string>",
-    "getRun": "(id: string) => Promise<WorkflowRun | null>",
-    "getRunHistory": "(runId: string) => Promise<Array<StepState & { stepName: string; }>>",
-    "updateRunStatus": "(id: string, status: WorkflowStatus, output?: any, error?: SerializedError) => Promise<void>",
-    "withRunLock": "<T>(id: string, fn: () => Promise<T>) => Promise<T>",
-    "close": "() => Promise<void>",
-    "resumeWorkflow": "(runId: string) => Promise<void>",
-    "setServices": "(singletonServices: CoreSingletonServices, createWireServices: CreateWireServices, config: CoreConfig) => void",
-    "startWorkflow": "<I>(name: string, input: I, rpcService: any) => Promise<{ runId: string; }>",
-    "runWorkflowJob": "(runId: string, rpcService: any) => Promise<void>",
-    "orchestrateWorkflow": "(runId: string, rpcService: any) => Promise<void>",
-    "executeWorkflowSleep": "(runId: string, stepId: string) => Promise<void>",
-    "insertStepState": "(runId: string, stepName: string, rpcName: string, data: any, stepOptions?: { retries?: number; retryDelay?: string | number; }) => Promise<StepState>",
-    "getStepState": "(runId: string, stepName: string) => Promise<StepState>",
-    "setStepRunning": "(stepId: string) => Promise<void>",
-    "setStepScheduled": "(stepId: string) => Promise<void>",
-    "setStepResult": "(stepId: string, result: any) => Promise<void>",
-    "setStepError": "(stepId: string, error: Error) => Promise<void>",
-    "createRetryAttempt": "(stepId: string, status: \"pending\" | \"running\") => Promise<StepState>",
-    "executeWorkflowStep": "(runId: string, stepName: string, rpcName: string | null, data: any, rpcService: any) => Promise<void>"
-  }
-}

package/.pikku/workflow/pikku-workflow-map.gen.d.ts

@@ -1,62 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.2
- */
-/**
- * This provides the structure needed for TypeScript to be aware of workflows and their input/output types
- */
-
-
-
-// Custom types are those that are defined directly within generics
-// or are broken into simpler types
-export type PikkuSchemasOutput = false | true
-export type PikkuFunctionsOutput = false | true
-export type PikkuMiddlewareOutput = false | true
-export type PikkuPermissionsOutput = false | true
-export type PikkuRPCOutput = false | true
-export type PikkuPublicRPCOutput = false | true
-export type PikkuHTTPOutput = false | true
-export type PikkuSchedulerOutput = false | true
-export type PikkuWorkflowOutput = false | true
-export type PikkuRemoteRPCOutput = false | true
-export type PikkuQueueOutput = false | true
-export type PikkuChannelsOutput = false | true
-export type PikkuMCPOutput = false | true
-export type PikkuCLIOutput = false | true
-
-interface WorkflowHandler<I, O> {
-    input: I;
-    output: O;
-}
-
-export type WorkflowMap = {
-};
-
-
-/**
- * Type-safe workflow client API
- */
-export type WorkflowClient<Name extends keyof WorkflowMap> = {
-  /**
-   * Start a new workflow run
-   */
-  start: (input: WorkflowMap[Name]['input']) => Promise<{ runId: string }>;
-
-  /**
-   * Get a workflow run by ID
-   */
-  getRun: <output extends keyof WorkflowMap[Name]>(runId: string) => Promise<WorkflowMap[Name][output]>;
-
-  /**
-   * Cancel a running workflow
-   */
-  cancelRun: (runId: string) => Promise<boolean>;
-}
-
-/**
- * Map of all registered workflows with type-safe client APIs
- */
-export type TypedWorkflowClients = {
-  [Name in keyof WorkflowMap]: WorkflowClient<Name>;
-}
-  

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

@@ -1,97 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.2
- */
-/**
- * Workflow-specific type definitions for tree-shaking optimization
- */
-
-import { PikkuWorkflowWire, WorkflowStepOptions } from '@pikku/core/workflow'
-import type { PikkuFunctionSessionless, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
-import type { RPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js'
-
-/**
- * Typed workflow wire with RPC awareness
- * Provides type-safe workflow.do() for RPC steps
- */
-export interface TypedWorkflow extends PikkuWorkflowWire {
-  /**
-   * Execute a workflow step with RPC invocation (typed based on available RPCs)
-   * @template K - RPC name from the RPC map
-   */
-  do<K extends keyof RPCMap>(
-    stepName: string,
-    rpcName: K,
-    data: RPCMap[K]['input'],
-    options?: WorkflowStepOptions
-  ): Promise<RPCMap[K]['output']>
-
-  /**
-   * Execute a workflow step with inline function
-   * @template T - Return type of the inline function
-   */
-  do<T>(
-    stepName: string,
-    fn: () => T | Promise<T>,
-    options?: WorkflowStepOptions
-  ): Promise<T>
-}
-
-/**
- * Workflow function type with typed workflow service
- * Includes the workflow wire object with typed RPC methods
- */
-export type PikkuFunctionWorkflow<
-  In = unknown,
-  Out = never
-> = PikkuFunctionSessionless<
-  In,
-  Out,
-  'workflow'
->
-
-/**
- * Creates a workflow function with typed input and output.
- * Workflow functions have access to the workflow wire object for step execution.
- *
- * This is the permissive mode - workflows that don't conform to simple DSL will fall back
- * to basic extraction with a warning.
- *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
- */
-export const pikkuWorkflowFunc = <In, Out = unknown>(
-  func:
-    | PikkuFunctionWorkflow<In, Out>
-    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-/**
- * Creates a simple workflow function with typed input and output.
- * Simple workflows must conform to the restricted DSL for static analysis.
- *
- * This is the strict mode - workflows that don't conform to simple DSL will cause
- * a critical error during inspection.
- *
- * Constraints:
- * - Must use only workflow.do() with RPC form (no inline functions)
- * - Only if/else, for..of, and Promise.all(array.map()) control flow allowed
- * - Step names must be unique (except across mutually exclusive branches)
- * - All workflow calls must be awaited
- *
- * @template In - Input type for the workflow
- * @template Out - Output type for the workflow
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
- */
-export const pikkuSimpleWorkflowFunc = <In, Out = unknown>(
-  func:
-    | PikkuFunctionWorkflow<In, Out>
-    | PikkuFunctionConfig<In, Out, 'workflow', PikkuFunctionWorkflow<In, Out>>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-

package/.pikku/workflow/pikku-workflow-wirings-meta.gen.json

@@ -1 +0,0 @@
-{}

package/.pikku/workflow/pikku-workflow-wirings-meta.gen.ts

@@ -1,8 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.2
- */
-import { pikkuState } from '@pikku/core'
-import { WorkflowsMeta } from '@pikku/core/workflow'
-import metaData from './pikku-workflow-wirings-meta.gen.json' with { type: 'json' }
-
-pikkuState('workflows', 'meta', metaData as WorkflowsMeta)

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

@@ -1,8 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.11.2
- */
-/**
- * Auto-generated workflow registrations
- * Do not edit manually - regenerate with 'npx pikku'
- */
-