@pikku/addon-graph 0.12.0 → 0.12.3

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

@@ -1,177 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.12.19
- */
-/**
- * Channel-specific type definitions for tree-shaking optimization
- */
-
-import { CoreChannel, CorePikkuChannelMiddleware, CorePikkuChannelMiddlewareFactory, wireChannel as wireChannelCore, defineChannelRoutes as defineChannelRoutesCore, addChannelMiddleware as addChannelMiddlewareCore } from '@pikku/core/channel'
-import { AssertHTTPWiringParams } from '@pikku/core/http'
-import type { PikkuFunctionConfig, PikkuFunctionSessionless, PikkuPermission, PikkuMiddleware, Services } from '../function/pikku-function-types.gen.js'
-import type { CorePermissionGroup } from '@pikku/core'
-import type { StandardSchemaV1 } from '@standard-schema/spec'
-
-/**
- * Helper type to infer the output type from a Standard Schema
- */
-type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output> ? Output : never
-
-/**
- * Type definition for WebSocket channels with typed data exchange.
- * Supports connection, disconnection, and message handling.
- * Accepts both session-based (PikkuFunction) and sessionless (PikkuFunctionSessionless) functions.
- *
- * @template ChannelData - Type of data exchanged through the channel
- * @template Channel - String literal type for the channel name
- */
-type ChannelWiring<ChannelData, Channel extends string> = CoreChannel<
-  ChannelData,
-  Channel,
-  PikkuFunctionConfig<void, any, 'channel' | 'session' | 'rpc'>,
-  PikkuFunctionConfig<void, void, 'channel' | 'session' | 'rpc'>,
-  PikkuFunctionConfig<any, any, 'channel' | 'session' | 'rpc'>,
-  PikkuPermission,
-  PikkuMiddleware
->
-
-/**
- * Creates a function that handles WebSocket channel connections.
- * Called when a client connects to a channel.
- *
- * @template Out - Output type for connection response
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
- */
-export const pikkuChannelConnectionFunc = <Out = unknown>(
-  func:
-    | PikkuFunctionSessionless<void, Out, 'channel' | 'session' | 'rpc'>
-    | PikkuFunctionConfig<void, Out, 'channel' | 'session' | 'rpc'>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-/**
- * Creates a function that handles WebSocket channel disconnections.
- * Called when a client disconnects from a channel.
- *
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
- */
-export const pikkuChannelDisconnectionFunc = (
-  func:
-    | PikkuFunctionSessionless<void, void, 'channel'>
-    | PikkuFunctionConfig<void, void, 'channel' | 'session' | 'rpc'>
-) => {
-  return typeof func === 'function' ? { func } : func
-}
-
-/**
- * Configuration object for channel functions with Zod schema validation.
- */
-type PikkuChannelFuncConfigWithSchema<
-  InputSchema extends StandardSchemaV1,
-  OutputSchema extends StandardSchemaV1 | undefined = undefined
-> = {
-  name?: string
-  tags?: string[]
-  expose?: boolean
-  remote?: boolean
-  func: PikkuFunctionSessionless<
-    InferSchemaOutput<InputSchema>,
-    OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown,
-    'channel' | 'session' | 'rpc'
-  >
-  auth?: boolean
-  permissions?: CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>
-  middleware?: PikkuMiddleware[]
-  input: InputSchema
-  output?: OutputSchema
-}
-
-/**
- * Creates a function that handles WebSocket channel messages.
- * Called when a message is received on a channel.
- *
- * Supports two patterns:
- * 1. Generic types: `pikkuChannelFunc<Input, Output>({ func: ... })`
- * 2. Zod schemas: `pikkuChannelFunc({ input: z.object(...), func: ... })`
- *
- * @template In - Input type for channel messages (inferred from schema if provided)
- * @template Out - Output type for channel responses (inferred from schema if provided)
- * @param func - Function definition, either direct function or configuration object
- * @returns The normalized configuration object
- *
- * @example
- * ```typescript
- * // Pattern 1: Using generic types
- * const handleMessage = pikkuChannelFunc<{text: string}, {received: boolean}>({
- *   func: async (_services, { text }) => ({ received: true })
- * })
- *
- * // Pattern 2: Using Zod schemas
- * const messageInput = z.object({ text: z.string() })
- * const messageOutput = z.object({ received: z.boolean() })
- *
- * const handleMessage = pikkuChannelFunc({
- *   input: messageInput,
- *   output: messageOutput,
- *   func: async (_services, { text }) => ({ received: true })
- * })
- * ```
- */
-export function pikkuChannelFunc<
-  InputSchema extends StandardSchemaV1,
-  OutputSchema extends StandardSchemaV1 | undefined = undefined
->(
-  config: PikkuChannelFuncConfigWithSchema<InputSchema, OutputSchema>
-): PikkuFunctionConfig<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'channel' | 'session' | 'rpc'>
-export function pikkuChannelFunc<In, Out = unknown>(
-  func:
-    | PikkuFunctionSessionless<In, Out, 'channel' | 'session' | 'rpc'>
-    | PikkuFunctionConfig<In, Out, 'channel' | 'session' | 'rpc'>
-): PikkuFunctionConfig<In, Out, 'channel' | 'session' | 'rpc'>
-export function pikkuChannelFunc(func: any) {
-  return typeof func === 'function' ? { func } : func
-}
-
-/**
- * Registers a WebSocket channel with the Pikku framework.
- *
- * @template ChannelData - Type of data associated with the channel
- * @template Channel - String literal type for the channel name
- * @param channel - Channel definition with connection, disconnection, and message handlers
- */
-export const wireChannel = <ChannelData, Channel extends string>(
-  channel: ChannelWiring<ChannelData, Channel> & AssertHTTPWiringParams<ChannelData, Channel>
-) => {
-  wireChannelCore(channel as any)
-}
-
-/**
- * Type-safe helper for defining channel message routes that can be composed.
- * Returns the routes record as-is for use with wireChannel's onMessageWiring.
- *
- * @template T - Record of channel route handlers
- * @param routes - The channel routes record
- * @returns The same routes record (identity function for type safety)
- */
-export function defineChannelRoutes<T extends Record<string, any>>(routes: T): T {
-  return defineChannelRoutesCore(routes)
-}
-
-export type PikkuChannelMiddleware<RequiredServices extends Services = Services, Event = unknown> = CorePikkuChannelMiddleware<RequiredServices, Event>
-
-export const pikkuChannelMiddleware = <RequiredServices extends Services = Services, Event = unknown>(
-  middleware: PikkuChannelMiddleware<RequiredServices, Event>
-): PikkuChannelMiddleware<RequiredServices, Event> => {
-  return middleware
-}
-
-export const pikkuChannelMiddlewareFactory = <In = any>(
-  factory: CorePikkuChannelMiddlewareFactory<In>
-): CorePikkuChannelMiddlewareFactory<In> => {
-  return factory
-}
-
-export const addChannelMiddleware = (tag: string, middleware: PikkuChannelMiddleware[]) =>
-  addChannelMiddlewareCore(tag, middleware, '@pikku/addon-graph')

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

@@ -1,105 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.12.19
- */
-/**
-
- * CLI-specific type definitions for tree-shaking optimization
- */
-
-import { CoreCLI, wireCLI as wireCLICore, CorePikkuCLIRender, CoreCLICommandConfig, defineCLICommands as defineCLICommandsCore } from '@pikku/core/cli'
-import type { PikkuFunctionConfig, PikkuMiddleware } from '../function/pikku-function-types.gen.js'
-import type { UserSession } from '../../types/application-types.d.js'
-import type { SingletonServices } from '../../types/application-types.d.js'
-
-
-type Session = UserSession
-
-/**
- * Type-safe CLI renderer definition that can access your application's services.
- * Use this to define custom renderers for CLI command output.
- *
- * @template Data - The output data type from the CLI command
- * @template RequiredServices - The services required for this renderer
- */
-type PikkuCLIRender<Data, RequiredServices extends SingletonServices = SingletonServices> = CorePikkuCLIRender<Data, RequiredServices, Session>
-
-/**
- * Creates a type-safe CLI renderer with access to your application's singleton services.
- * The renderer receives the full singleton services and output data to format and display results.
- *
- * @template Data - The output data type from the CLI command
- * @template RequiredServices - The minimum services required for type checking (defaults to SingletonServices)
- * @param render - Function that receives singleton services and data to render output
- * @returns A CLI renderer configuration
- *
- * @example
- * ```typescript
- * const myRenderer = pikkuCLIRender<MyData>(({ logger }, data) => {
- *   logger.info(data.message)
- * })
- * ```
- */
-export const pikkuCLIRender = <Data, RequiredServices extends SingletonServices = SingletonServices>(
-  render: (services: SingletonServices, data: Data) => void | Promise<void>
-): PikkuCLIRender<Data, RequiredServices> => {
-  return render as any
-}
-
-/**
- * CLI command configuration with project-specific types.
- * Uses CoreCLICommandConfig from @pikku/core with local middleware and render types.
- */
-type CLICommandConfig<Func extends PikkuFunctionConfig<In, Out, 'cli' | 'rpc' | 'session'>, In = any, Out = any, Params extends string = string> = CoreCLICommandConfig<Func, PikkuMiddleware, PikkuCLIRender<any>, Params>
-
-/**
- * Type definition for CLI applications with commands and global options.
- *
- * @template Commands - Type describing the command structure
- * @template GlobalOptions - Type for global CLI options
- */
-type CLIWiring<Commands extends Record<string, CoreCLICommandConfig<any, PikkuMiddleware, PikkuCLIRender<any>, any>>, GlobalOptions> = CoreCLI<Commands, GlobalOptions, PikkuMiddleware, PikkuCLIRender<any>>
-
-/**
- * Registers a CLI application with the Pikku framework.
- * Creates command-line interfaces with type-safe commands and options.
- *
- * @template Commands - Type describing the command structure
- * @template GlobalOptions - Type for global CLI options
- * @param cli - CLI definition with program name, commands, and global options
- */
-export const wireCLI = <Commands extends Record<string, CoreCLICommandConfig<any, PikkuMiddleware, PikkuCLIRender<any>, any>>, GlobalOptions>(
-  cli: CLIWiring<Commands, GlobalOptions>
-) => {
-  wireCLICore(cli as any)
-}
-
-/**
- * Creates a CLI command definition with automatic option inference from the function's input type.
- * This allows TypeScript to automatically derive CLI options from the function signature.
- *
- * @template FuncConfig - The Pikku function config type
- * @template Params - The parameters string literal type
- * @param config - CLI command configuration
- * @returns CLI command configuration with inferred types
- */
-export const pikkuCLICommand = <
-  FuncConfig extends PikkuFunctionConfig<any, any, 'cli' | 'rpc' | 'session'>,
-  Params extends string
->(
-  config: CLICommandConfig<FuncConfig, any, any, Params>
-): CoreCLICommandConfig<FuncConfig, PikkuMiddleware, PikkuCLIRender<any>, string> => {
-  return config as any
-}
-
-/**
- * Type-safe helper for defining CLI commands that can be composed and spread into wireCLI.
- *
- * @template T - Record of CLI command configurations
- * @param commands - The CLI commands record
- * @returns The same commands record (identity function for type safety)
- */
-export const defineCLICommands = <T extends Record<string, CoreCLICommandConfig<any, PikkuMiddleware, PikkuCLIRender<any>, any>>>(
-  commands: T
-): T => {
-  return defineCLICommandsCore(commands as any) as T
-}

package/.pikku/console/pikku-addon-meta.gen.json

@@ -1,281 +0,0 @@
-{
-  "nodes": {
-    "aggregate": {
-      "name": "aggregate",
-      "displayName": "Aggregate",
-      "category": "Array",
-      "type": "action",
-      "rpc": "aggregate",
-      "description": "Combine a field from many items into a list in a single item",
-      "errorOutput": false,
-      "inputSchemaName": "AggregateInput",
-      "outputSchemaName": "AggregateOutput"
-    },
-    "chunk": {
-      "name": "chunk",
-      "displayName": "Chunk",
-      "category": "Array",
-      "type": "action",
-      "rpc": "chunk",
-      "description": "Split array into chunks of specified size",
-      "errorOutput": false,
-      "inputSchemaName": "ChunkInput",
-      "outputSchemaName": "ChunkOutput"
-    },
-    "find": {
-      "name": "find",
-      "displayName": "Find",
-      "category": "Array",
-      "type": "action",
-      "rpc": "find",
-      "description": "Find the first item matching a field value",
-      "errorOutput": false,
-      "inputSchemaName": "FindInput",
-      "outputSchemaName": "FindOutput"
-    },
-    "groupBy": {
-      "name": "groupBy",
-      "displayName": "Group By",
-      "category": "Array",
-      "type": "action",
-      "rpc": "groupBy",
-      "description": "Group items by a field value",
-      "errorOutput": false,
-      "inputSchemaName": "GroupByInput",
-      "outputSchemaName": "GroupByOutput"
-    },
-    "limit": {
-      "name": "limit",
-      "displayName": "Limit",
-      "category": "Array",
-      "type": "action",
-      "rpc": "limit",
-      "description": "Restrict the number of items",
-      "errorOutput": false,
-      "inputSchemaName": "LimitInput",
-      "outputSchemaName": "LimitOutput"
-    },
-    "removeDuplicates": {
-      "name": "removeDuplicates",
-      "displayName": "Remove Duplicates",
-      "category": "Array",
-      "type": "action",
-      "rpc": "removeDuplicates",
-      "description": "Delete items with matching field values",
-      "errorOutput": false,
-      "inputSchemaName": "RemoveDuplicatesInput",
-      "outputSchemaName": "RemoveDuplicatesOutput"
-    },
-    "reverse": {
-      "name": "reverse",
-      "displayName": "Reverse",
-      "category": "Array",
-      "type": "action",
-      "rpc": "reverse",
-      "description": "Reverse the order of items in an array",
-      "errorOutput": false,
-      "inputSchemaName": "ReverseInput",
-      "outputSchemaName": "ReverseOutput"
-    },
-    "sort": {
-      "name": "sort",
-      "displayName": "Sort",
-      "category": "Array",
-      "type": "action",
-      "rpc": "sort",
-      "description": "Change items order",
-      "errorOutput": false,
-      "inputSchemaName": "SortInput",
-      "outputSchemaName": "SortOutput"
-    },
-    "splitOut": {
-      "name": "splitOut",
-      "displayName": "Split Out",
-      "category": "Array",
-      "type": "action",
-      "rpc": "splitOut",
-      "description": "Turn a list inside item(s) into separate items",
-      "errorOutput": false,
-      "inputSchemaName": "SplitOutInput",
-      "outputSchemaName": "SplitOutOutput"
-    },
-    "summarize": {
-      "name": "summarize",
-      "displayName": "Summarize",
-      "category": "Array",
-      "type": "action",
-      "rpc": "summarize",
-      "description": "Sum, count, max, etc. across items",
-      "errorOutput": false,
-      "inputSchemaName": "SummarizeInput",
-      "outputSchemaName": "SummarizeOutput"
-    },
-    "unique": {
-      "name": "unique",
-      "displayName": "Unique",
-      "category": "Array",
-      "type": "action",
-      "rpc": "unique",
-      "description": "Get unique values from an array",
-      "errorOutput": false,
-      "inputSchemaName": "UniqueInput",
-      "outputSchemaName": "UniqueOutput"
-    },
-    "coalesce": {
-      "name": "coalesce",
-      "displayName": "Coalesce",
-      "category": "Data",
-      "type": "action",
-      "rpc": "coalesce",
-      "description": "Return the first non-null value",
-      "errorOutput": false,
-      "inputSchemaName": "CoalesceInput",
-      "outputSchemaName": "CoalesceOutput"
-    },
-    "crypto": {
-      "name": "crypto",
-      "displayName": "Crypto",
-      "category": "Data",
-      "type": "action",
-      "rpc": "crypto",
-      "description": "Provide cryptographic utilities",
-      "errorOutput": false,
-      "inputSchemaName": "CryptoInput",
-      "outputSchemaName": "CryptoOutput"
-    },
-    "dateTime": {
-      "name": "dateTime",
-      "displayName": "Date & Time",
-      "category": "Data",
-      "type": "action",
-      "rpc": "dateTime",
-      "description": "Manipulate date and time values",
-      "errorOutput": false,
-      "inputSchemaName": "DateTimeInput",
-      "outputSchemaName": "DateTimeOutput"
-    },
-    "jwtSign": {
-      "name": "jwtSign",
-      "displayName": "JWT Sign",
-      "category": "Data",
-      "type": "action",
-      "rpc": "jwtSign",
-      "description": "Sign a payload into a JWT token",
-      "errorOutput": false,
-      "inputSchemaName": "JwtSignInput",
-      "outputSchemaName": "JwtSignOutput"
-    },
-    "jwtDecode": {
-      "name": "jwtDecode",
-      "displayName": "JWT Decode",
-      "category": "Data",
-      "type": "action",
-      "rpc": "jwtDecode",
-      "description": "Decode a JWT token into its payload",
-      "errorOutput": false,
-      "inputSchemaName": "JwtDecodeInput",
-      "outputSchemaName": "JwtDecodeOutput"
-    },
-    "math": {
-      "name": "math",
-      "displayName": "Math",
-      "category": "Data",
-      "type": "action",
-      "rpc": "math",
-      "description": "Perform math operations",
-      "errorOutput": false,
-      "inputSchemaName": "MathInput",
-      "outputSchemaName": "MathOutput"
-    },
-    "sleep": {
-      "name": "sleep",
-      "displayName": "Sleep",
-      "category": "Data",
-      "type": "action",
-      "rpc": "sleep",
-      "description": "Sleep for a specified duration before continuing",
-      "errorOutput": false,
-      "inputSchemaName": "SleepInput",
-      "outputSchemaName": null
-    },
-    "stringTransform": {
-      "name": "stringTransform",
-      "displayName": "String Transform",
-      "category": "Data",
-      "type": "action",
-      "rpc": "stringTransform",
-      "description": "Transform strings (case, trim, split, replace, etc.)",
-      "errorOutput": false,
-      "inputSchemaName": "StringTransformInput",
-      "outputSchemaName": "StringTransformOutput"
-    },
-    "typeConvert": {
-      "name": "typeConvert",
-      "displayName": "Type Convert",
-      "category": "Data",
-      "type": "action",
-      "rpc": "typeConvert",
-      "description": "Convert between types (string, number, boolean, json, array)",
-      "errorOutput": false,
-      "inputSchemaName": "TypeConvertInput",
-      "outputSchemaName": "TypeConvertOutput"
-    },
-    "editFields": {
-      "name": "editFields",
-      "displayName": "Edit Fields",
-      "category": "Transform",
-      "type": "action",
-      "rpc": "editFields",
-      "description": "Modify, add, or remove item fields",
-      "errorOutput": false,
-      "inputSchemaName": "EditFieldsInput",
-      "outputSchemaName": "EditFieldsOutput"
-    },
-    "merge": {
-      "name": "merge",
-      "displayName": "Merge",
-      "category": "Transform",
-      "type": "action",
-      "rpc": "merge",
-      "description": "Merge multiple objects into one",
-      "errorOutput": false,
-      "inputSchemaName": "MergeInput",
-      "outputSchemaName": "MergeOutput"
-    },
-    "omit": {
-      "name": "omit",
-      "displayName": "Omit",
-      "category": "Transform",
-      "type": "action",
-      "rpc": "omit",
-      "description": "Remove specified fields from an object",
-      "errorOutput": false,
-      "inputSchemaName": "OmitInput",
-      "outputSchemaName": "OmitOutput"
-    },
-    "pick": {
-      "name": "pick",
-      "displayName": "Pick",
-      "category": "Transform",
-      "type": "action",
-      "rpc": "pick",
-      "description": "Keep only specified fields from an object",
-      "errorOutput": false,
-      "inputSchemaName": "PickInput",
-      "outputSchemaName": "PickOutput"
-    },
-    "renameKeys": {
-      "name": "renameKeys",
-      "displayName": "Rename Keys",
-      "category": "Transform",
-      "type": "action",
-      "rpc": "renameKeys",
-      "description": "Update item field names",
-      "errorOutput": false,
-      "inputSchemaName": "RenameKeysInput",
-      "outputSchemaName": "RenameKeysOutput"
-    }
-  },
-  "secrets": {},
-  "package": {}
-}

package/.pikku/console/pikku-node-types.gen.ts

@@ -1,8 +0,0 @@
-/**
- * This file was generated by @pikku/cli@0.12.19
- */
-import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.js'
-
-export type NodeCategory = never
-
-export type NodeRPCName = keyof FlattenedRPCMap