@pikku/addon-meta-conversions 0.1.6 → 0.1.7

package/dist/.pikku/addon/channel/pikku-channel-types.gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-channel-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pikku-channel-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"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"}

package/dist/.pikku/addon/channel/pikku-channel-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization
@@ -12,6 +12,8 @@ import { defineChannelRoutes as defineChannelRoutesCore } from '@pikku/core/chan
  * @template Out - Output type for connection response
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelConnectionFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
@@ -22,6 +24,8 @@ export const pikkuChannelConnectionFunc = (func) => {
  *
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelDisconnectionFunc = (func) => {
     return typeof func === 'function' ? { func } : func;
@@ -36,6 +40,8 @@ export function pikkuChannelFunc(func) {
  * @template T - Record of channel route handlers
  * @param routes - The channel routes record
  * @returns The same routes record (identity function for type safety)
+ *
+ * @example snippet: channelRoutes
  */
 export function defineChannelRoutes(routes) {
     return defineChannelRoutesCore(routes);

package/dist/.pikku/addon/channel/pikku-channel-types.gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"pikku-channel-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAcpF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAEiE,EACjE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAEkE,EAClE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAmED,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAGD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAgC,MAAS;IAC1E,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}
+{"version":3,"file":"pikku-channel-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/channel/pikku-channel-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,OAAO,EAAE,mBAAmB,IAAI,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAcpF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAEiE,EACjE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAEkE,EAClE,EAAE;IACF,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC,CAAA;AAmDD,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACrD,CAAC;AAGD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAgC,MAAS;IAC1E,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AACxC,CAAC"}

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization
@@ -26,6 +26,8 @@ type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output> ? Outp
  * @template Out - Output type for connection response
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelConnectionFunc = <Out = unknown>(
   func:
@@ -41,6 +43,8 @@ export const pikkuChannelConnectionFunc = <Out = unknown>(
  *
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
+ *
+ * @example snippet: channelLifecycle
  */
 export const pikkuChannelDisconnectionFunc = (
   func:
@@ -86,23 +90,7 @@ type PikkuChannelFuncConfigWithSchema<
  * @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 })
- * })
- * ```
+ * @example snippet: orderStatusChannel
  */
 export function pikkuChannelFunc<
   InputSchema extends StandardSchemaV1,
@@ -127,6 +115,8 @@ export function pikkuChannelFunc(func: any) {
  * @template T - Record of channel route handlers
  * @param routes - The channel routes record
  * @returns The same routes record (identity function for type safety)
+ *
+ * @example snippet: channelRoutes
  */
 export function defineChannelRoutes<T extends Record<string, any>>(routes: T): T {
   return defineChannelRoutesCore(routes)

package/dist/.pikku/addon/cli/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/cli` resolves here.
+ */
+export * from './pikku-cli-types.gen.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/.pikku/addon/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,0BAA0B,CAAA"}

package/dist/.pikku/addon/cli/index.js

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/cli` resolves here.
+ */
+export * from './pikku-cli-types.gen.js';
+//# sourceMappingURL=index.js.map

package/dist/.pikku/addon/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../.pikku/addon/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;GAEG;AAEH,cAAc,0BAA0B,CAAA"}

package/dist/.pikku/addon/cli/index.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+ * Subpath entry — `#pikku/cli` resolves here.
+ */
+
+export * from './pikku-cli-types.gen.js'

package/dist/.pikku/addon/cli/pikku-cli-types.gen.d.ts

@@ -0,0 +1,62 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+
+ * CLI-specific type definitions for tree-shaking optimization
+ */
+import { CorePikkuCLIRender, CoreCLICommandConfig } from '@pikku/core/cli';
+import type { PikkuFunctionConfig } from '../function/pikku-function-types.gen.js';
+import type { PikkuMiddleware } from '../middleware/pikku-middleware-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 snippet: cliRenderer
+ */
+export declare const pikkuCLIRender: <Data, RequiredServices extends SingletonServices = SingletonServices>(render: (services: SingletonServices, data: Data) => void | Promise<void>) => PikkuCLIRender<Data, RequiredServices>;
+/**
+ * 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>;
+/**
+ * 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
+ *
+ * @example snippet: cliWiring
+ */
+export declare 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>;
+/**
+ * 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)
+ *
+ * @example snippet: cliCommandContract
+ */
+export declare const defineCLICommands: <T extends Record<string, CoreCLICommandConfig<any, PikkuMiddleware, PikkuCLIRender<any>, any>>>(commands: T) => T;
+export {};
+//# sourceMappingURL=pikku-cli-types.gen.d.ts.map

package/dist/.pikku/addon/cli/pikku-cli-types.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-cli-types.gen.d.ts","sourceRoot":"","sources":["../../../../.pikku/addon/cli/pikku-cli-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;GAGG;AAGH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAA;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAG9E,KAAK,OAAO,GAAG,WAAW,CAAA;AAE1B;;;;;;GAMG;AACH,KAAK,cAAc,CAAC,IAAI,EAAE,gBAAgB,SAAS,iBAAiB,GAAG,iBAAiB,IAAI,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAA;AAE/I;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,gBAAgB,SAAS,iBAAiB,GAAG,iBAAiB,UACzF,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KACxE,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAEvC,CAAA;AAED;;;GAGG;AACH,KAAK,gBAAgB,CAAC,IAAI,SAAS,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAA;AAG3N;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,SAAS,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC,EAC3E,MAAM,SAAS,MAAM,UAEb,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,KACrD,oBAAoB,CAAC,UAAU,EAAE,eAAe,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,CAE/E,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAAG,EAAE,eAAe,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,YACpH,CAAC,KACV,CAEF,CAAA"}

package/dist/.pikku/addon/cli/pikku-cli-types.gen.js

@@ -0,0 +1,49 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+
+ * CLI-specific type definitions for tree-shaking optimization
+ */
+import { defineCLICommands as defineCLICommandsCore } from '@pikku/core/cli';
+/**
+ * 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 snippet: cliRenderer
+ */
+export const pikkuCLIRender = (render) => {
+    return render;
+};
+/**
+ * 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
+ *
+ * @example snippet: cliWiring
+ */
+export const pikkuCLICommand = (config) => {
+    return config;
+};
+/**
+ * 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)
+ *
+ * @example snippet: cliCommandContract
+ */
+export const defineCLICommands = (commands) => {
+    return defineCLICommandsCore(commands);
+};
+//# sourceMappingURL=pikku-cli-types.gen.js.map

package/dist/.pikku/addon/cli/pikku-cli-types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pikku-cli-types.gen.js","sourceRoot":"","sources":["../../../../.pikku/addon/cli/pikku-cli-types.gen.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,IAAI,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAsB5E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAyE,EACjC,EAAE;IAC1C,OAAO,MAAa,CAAA;AACtB,CAAC,CAAA;AASD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAI7B,MAAsD,EAC0B,EAAE;IAClF,OAAO,MAAa,CAAA;AACtB,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,QAAW,EACR,EAAE;IACL,OAAO,qBAAqB,CAAC,QAAe,CAAM,CAAA;AACpD,CAAC,CAAA"}

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

@@ -0,0 +1,88 @@
+/**
+ * This file was generated by @pikku/cli@0.12.190
+ */
+/**
+
+ * CLI-specific type definitions for tree-shaking optimization
+ */
+
+import { defineCLICommands as defineCLICommandsCore } from '@pikku/core/cli'
+import {
+  CorePikkuCLIRender,
+  CoreCLICommandConfig,
+} from '@pikku/core/cli'
+import type { PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
+import type { PikkuMiddleware } from '../middleware/pikku-middleware-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 snippet: cliRenderer
+ */
+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>
+
+
+/**
+ * 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
+ *
+ * @example snippet: cliWiring
+ */
+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)
+ *
+ * @example snippet: cliCommandContract
+ */
+export const defineCLICommands = <T extends Record<string, CoreCLICommandConfig<any, PikkuMiddleware, PikkuCLIRender<any>, any>>>(
+  commands: T
+): T => {
+  return defineCLICommandsCore(commands as any) as T
+}

package/dist/.pikku/addon/db/pikku-db-meta.gen.json

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

package/dist/.pikku/addon/error/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/pikku-error-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/pikku-error-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/addon/error/pikku-error-types.gen.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Error catalogue — `#pikku/error` resolves here.

package/dist/.pikku/addon/function/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.

package/dist/.pikku/addon/function/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.

package/dist/.pikku/addon/function/index.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Subpath entry — `#pikku/function` resolves here.

package/dist/.pikku/addon/function/pikku-function-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.111
+ * This file was generated by @pikku/cli@0.12.190
  */
 /**
  * Core function types for all wirings
@@ -14,6 +14,7 @@ import type { PikkuMiddleware } from '../middleware/pikku-middleware-types.gen.j
 import type { PikkuPermission } from '../auth/pikku-auth-types.gen.js';
 import type { ScopeId } from '../scopes/pikku-scopes.gen.js';
 type CredentialsMap = Record<string, unknown>;
+import type { FeatureFlagName } from '../scopes/pikku-flags.gen.js';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function';
 import type { UserSession } from '../../../types/application-types.d.js';
@@ -22,9 +23,22 @@ import type { Services } from '../../../types/application-types.d.js';
 import type { TypedPikkuRPC, FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.d.js';
 import type { RequiredSingletonServices } from '../pikku-services.gen.js';
 import type { TypedWorkflow } from '../workflow/pikku-workflow-types.gen.js';
-import type { TypedScenario, TypedPersonas } from '../scenarios/pikku-scenario-types.gen.js';
+import type { TypedScenario, TypedVirtualUsers } from '../scenarios/pikku-scenario-types.gen.js';
+/**
+ * The services that live for the process — the ones built once in `createConfig`/
+ * `createSingletonServices` and shared by every request.
+ */
 export type { SingletonServices as SingletonServices };
+/**
+ * Everything a function is handed as its first argument: the singleton services
+ * plus whatever is built per request. This is the type to widen when you add a
+ * service.
+ */
 export type { Services as Services };
+/**
+ * The signed-in user as this project defines it. Reached on the wire as
+ * `session`, and replaced with `setSession`.
+ */
 export type Session = UserSession;
 /**
  * The services a wired function actually receives. The inspector records which
@@ -89,7 +103,7 @@ export declare const pikkuApprovalDescription: <In = unknown, RequiredServices e
  *   type vary with its return type and cost a `func` written against the
  *   `PikkuFunction | PikkuFunctionSessionless` union its contextual typing.
  */
-export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices, ScenarioOut = unknown> = CorePikkuFunctionSessionless<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, false, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario<ScenarioOut>, TypedPersonas, CredentialsMap>, RequiredWires>>;
+export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices, ScenarioOut = unknown> = CorePikkuFunctionSessionless<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, false, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario<ScenarioOut>, TypedVirtualUsers, CredentialsMap>, RequiredWires>>;
 /**
  * A session-aware API function that requires user authentication.
  * Use this for protected endpoints that need access to user session data.
@@ -98,7 +112,7 @@ export type PikkuFunctionSessionless<In = unknown, Out = never, RequiredWires ex
  * @template Out - The output type that the function returns
  * @template RequiredServices - Services required by this function
  */
-export type PikkuFunction<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = 'session', RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuFunction<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, true, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario, TypedPersonas, CredentialsMap>, RequiredWires>>;
+export type PikkuFunction<In = unknown, Out = never, RequiredWires extends keyof PikkuWire = 'session', RequiredServices extends SecretlessServices<Services> = WiredServices> = CorePikkuFunction<In, Out, RequiredServices, Session, PickRequired<PikkuWire<In, Out, true, Session, TypedPikkuRPC, null, any, TypedWorkflow, unknown, TypedScenario, TypedVirtualUsers, CredentialsMap>, RequiredWires>>;
 /**
  * Helper type to infer the output type from a Standard Schema
  */
@@ -111,14 +125,14 @@ export type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output>
  * @template Out - The output type
  * @template PikkuFunc - The function type (can be narrowed to PikkuFunction or PikkuFunctionSessionless)
  */
-export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunction<In, Out, RequiredWires, any> | PikkuFunctionSessionless<In, Out, RequiredWires, any, any> = PikkuFunction<In, Out, RequiredWires> | PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, ScopeId>, 'node'> & {
+export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunction<In, Out, RequiredWires, any> | PikkuFunctionSessionless<In, Out, RequiredWires, any, any> = PikkuFunction<In, Out, RequiredWires> | PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, ScopeId, FeatureFlagName>, 'node'> & {
     node?: NodeConfig;
 };
 /**
  * {@link PikkuFunctionConfig} for a function that runs without a session.
  * Has no `scopes`: an anonymous caller holds none, so none can ever be met.
  */
-type PikkuFunctionSessionlessConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunctionSessionless<In, Out, RequiredWires, any> = PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema>, 'node'> & {
+type PikkuFunctionSessionlessConfig<In = unknown, Out = unknown, RequiredWires extends keyof PikkuWire = never, PikkuFunc extends PikkuFunctionSessionless<In, Out, RequiredWires, any> = PikkuFunctionSessionless<In, Out, RequiredWires>, InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined> = Omit<CorePikkuSessionlessFunctionConfig<PikkuFunc, PikkuPermission<In>, PikkuMiddleware, InputSchema, OutputSchema, FeatureFlagName>, 'node'> & {
     node?: NodeConfig;
 };
 /**
@@ -131,7 +145,7 @@ type SchemaInferred<S, Fallback = unknown> = S extends StandardSchemaV1 ? InferS
  * Schema-overload variant for pikkuFunc. Derived from CorePikkuFunctionConfig
  * so adding a field on the core type automatically propagates here.
  */
-type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>, CorePikkuPermission<any>, PikkuMiddleware, undefined, undefined, ScopeId>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
+type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never, RequiredServices extends SecretlessServices<Services> = WiredServices> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>, CorePikkuPermission<any>, PikkuMiddleware, undefined, undefined, ScopeId, FeatureFlagName>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription' | 'node'> & {
     func: PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires, RequiredServices>;
     input?: InputSchema;
     output?: OutputSchema;
@@ -149,25 +163,18 @@ type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefi
  * @param config - Function definition with `input`/`output` Zod schemas and `func`.
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const createUserInput = z.object({ name: z.string(), email: z.string() })
- * const createUserOutput = z.object({ id: z.number() })
- *
- * const createUser = pikkuFunc({
- *   input: createUserInput,
- *   output: createUserOutput,
- *   func: async ({db}, input) => {
- *     // input is typed as { name: string, email: string }
- *     const user = await db.users.create(input)
- *     return { id: user.id } // must match output schema
- *   }
- * })
- * ```
+ * @example snippet: sessionFunction
  */
 export declare function pikkuFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuFunctionConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc'>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
 export declare function pikkuFunc<In, Out = unknown>(func: PikkuFunction<In, Out, 'session' | 'rpc'> | PikkuFunctionConfig<In, Out, 'session' | 'rpc'>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
-export declare const pikkuListFunc: <F extends Record<string, unknown> = {}, Row = unknown, S extends string = never>(config: PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">) => PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, "session" | "rpc">;
+/**
+ * A `pikkuFunc` whose input and output are already the shared list shape —
+ * filters, sort, paging in; rows and a total out — so a listing endpoint pages
+ * the same way everywhere.
+ *
+ * @example snippet: listFunction
+ */
+export declare const pikkuListFunc: <F extends Record<string, unknown> = {}, Row = unknown, S extends string = never>(config: PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, 'session' | 'rpc'>) => PikkuFunctionConfig<ListInput<F, S>, ListOutput<Row>, 'session' | 'rpc'>;
 /**
  * Configuration object for sessionless Pikku functions with Zod schema validation.
  */
@@ -194,19 +201,7 @@ type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchema
  * @param config - Function definition with `input`/`output` Zod schemas and `func`.
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const greetInput = z.object({ name: z.string() })
- * const greetOutput = z.object({ message: z.string() })
- *
- * const greet = pikkuSessionlessFunc({
- *   input: greetInput,
- *   output: greetOutput,
- *   func: async (_services, { name }) => {
- *     return { message: `Hello, ${name}!` }
- *   }
- * })
- * ```
+ * @example snippet: readFunction
  */
 export declare function pikkuSessionlessFunc<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredServices extends SecretlessServices<Services> = WiredServices>(config: PikkuFunctionSessionlessConfigWithSchema<InputSchema, OutputSchema, 'session' | 'rpc', RequiredServices>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'session' | 'rpc'>;
 export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices extends SecretlessServices<Services> = WiredServices>(func: PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices> | PikkuFunctionSessionlessConfig<In, Out, 'session' | 'rpc', PikkuFunctionSessionless<In, Out, 'session' | 'rpc', RequiredServices>>): PikkuFunctionConfig<In, Out, 'session' | 'rpc'>;
@@ -217,16 +212,9 @@ export declare function pikkuSessionlessFunc<In, Out = unknown, RequiredServices
  * @param func - Function definition, either direct function or configuration object
  * @returns The normalized configuration object
  *
- * @example
- * ```typescript
- * const cleanupTempFiles = pikkuVoidFunc(async ({fileSystem, logger}) => {
- *     logger.info('Starting cleanup of temporary files')
- *     await fileSystem.deleteDirectory('/tmp/uploads')
- *     logger.info('Cleanup completed')
- * })
- * ```
+ * @example snippet: cleanupFunction
  */
-export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionSessionlessConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "session" | "rpc">;
+export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, 'session' | 'rpc'> | PikkuFunctionSessionlessConfig<void, void, 'session' | 'rpc'>) => PikkuFunctionConfig<void, void, 'session' | 'rpc'>;
 /**
  * References a registered function by name for use in any wiring.
  * Works for both local and addon functions — resolves via RPC at runtime.
@@ -244,7 +232,7 @@ export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void,
  * wireHTTP({ route: '/greet', method: 'post', func: ref('greet') })
  * ```
  */
-export declare const ref: <Name extends keyof FlattenedRPCMap>(rpcName: Name) => PikkuFunctionConfig<FlattenedRPCMap[Name]["input"], FlattenedRPCMap[Name]["output"], "session" | "rpc">;
+export declare const ref: <Name extends keyof FlattenedRPCMap>(rpcName: Name) => PikkuFunctionConfig<FlattenedRPCMap[Name]['input'], FlattenedRPCMap[Name]['output'], 'session' | 'rpc'>;
 /**
  * Declares a capability the connected client answers, reachable from any
  * `wireChannel` function as `channel.remote(name, input)`.
@@ -272,9 +260,21 @@ export declare function pikkuRemoteChannelFunc<InputSchema extends StandardSchem
 declare const __addonHttp: {};
 declare const __addonChannel: {};
 declare const __addonCli: {};
+/**
+ * Names an HTTP route an installed addon wires, so you can link or redirect to
+ * it without hardcoding a path the addon may move.
+ */
 export declare const refHTTP: <Name extends keyof typeof __addonHttp>(name: Name, options?: {
     basePath?: string;
 }) => (typeof __addonHttp)[Name];
+/**
+ * Names a channel an installed addon wires, for connecting to it without
+ * hardcoding its name.
+ */
 export declare const refChannel: <Name extends keyof typeof __addonChannel>(name: Name) => (typeof __addonChannel)[Name];
+/**
+ * Names a CLI command an installed addon wires, for invoking it without
+ * hardcoding its name.
+ */
 export declare const refCLI: <Name extends keyof typeof __addonCli>(name: Name) => (typeof __addonCli)[Name];
 //# sourceMappingURL=pikku-function-types.gen.d.ts.map