@pikku/cli 0.12.20 → 0.12.22

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 import '../../src/cli.wiring.js';
 import '../../src/services.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 /* The files with an wireCLI function call */
 import '../../src/cli.wiring.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 import '../pikku-bootstrap.gen.js';
 export declare function PikkuCLI(args: string[]): Promise<void>;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 import { executeCLI, CLIError } from '@pikku/core/cli';
 import { createConfig as createConfig } from '../../src/services.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.js';
 export type NodeCategory = never;

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

@@ -1,13 +1,12 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 /**
  * Core function, middleware, and permission types for all wirings
  */
-import type { CorePikkuMiddleware, CorePermissionGroup, PikkuWire, PickRequired } from '@pikku/core';
+import type { CorePikkuMiddleware, CorePermissionGroup, ListInput, ListOutput, PikkuWire, PickRequired } from '@pikku/core';
 import type { CorePikkuFunctionConfig, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission } from '@pikku/core/function';
 import { CreateWireServices } from '@pikku/core/internal';
-import { PikkuError } from '@pikku/core/errors';
 import type { NodeType } from '@pikku/core/node';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function';
@@ -244,22 +243,17 @@ export type PikkuFunctionConfig<In = unknown, Out = unknown, RequiredWires exten
  * Use this when you want to define input/output schemas using Zod.
  * Types are automatically inferred from the schemas.
  */
-export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never> = {
-    name?: string;
-    tags?: string[];
-    expose?: boolean;
-    mcp?: boolean;
-    internal?: boolean;
-    approvalRequired?: boolean;
-    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
-    func: PikkuFunction<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires> | PikkuFunctionSessionless<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires>;
-    auth?: boolean;
-    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
-    middleware?: PikkuMiddleware[];
+type SchemaInferred<S, Fallback = unknown> = S extends StandardSchemaV1 ? InferSchemaOutput<S> : Fallback;
+/**
+ * Schema-overload variant for pikkuFunc. Derived from CorePikkuFunctionConfig
+ * so adding a field on the core type automatically propagates here.
+ */
+export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never> = Omit<CorePikkuFunctionConfig<PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'> & {
+    func: PikkuFunction<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires> | PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>;
     input?: InputSchema;
     output?: OutputSchema;
-    node?: NodeConfig;
-    errors?: Array<typeof PikkuError>;
+    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
+    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
 };
 /**
  * Creates a Pikku function that can be either session-aware or sessionless.
@@ -301,27 +295,21 @@ export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1 |
  */
 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 type PikkuListFunction<F extends Record<string, unknown> = {}, Row = unknown, S extends string = never> = PikkuFunction<ListInput<F, S>, ListOutput<Row>, 'session' | 'rpc'> | PikkuFunctionSessionless<ListInput<F, S>, ListOutput<Row>, '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">;
 /**
  * Configuration object for sessionless Pikku functions with Zod schema validation.
  */
-export type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never> = {
-    name?: string;
-    description?: string;
-    tags?: string[];
-    expose?: boolean;
-    mcp?: boolean;
-    internal?: boolean;
-    remote?: boolean;
-    approvalRequired?: boolean;
-    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
-    func: PikkuFunctionSessionless<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires>;
-    auth?: boolean;
-    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
-    middleware?: PikkuMiddleware[];
+/**
+ * Schema-overload variant for pikkuSessionlessFunc. Derived from
+ * CorePikkuFunctionConfig to stay in sync with the generic-typed config.
+ */
+export type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined, RequiredWires extends keyof PikkuWire = never> = Omit<CorePikkuFunctionConfig<PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>>, 'func' | 'input' | 'output' | 'permissions' | 'approvalDescription'> & {
+    func: PikkuFunctionSessionless<SchemaInferred<InputSchema>, SchemaInferred<OutputSchema>, RequiredWires>;
     input?: InputSchema;
     output?: OutputSchema;
-    node?: NodeConfig;
-    errors?: Array<typeof PikkuError>;
+    permissions?: InputSchema extends StandardSchemaV1 ? CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>> : undefined;
+    approvalDescription?: InputSchema extends StandardSchemaV1 ? PikkuApprovalDescription<InferSchemaOutput<InputSchema>> : never;
 };
 /**
  * Creates a sessionless Pikku function that doesn't require user authentication.
@@ -376,7 +364,7 @@ export declare function pikkuSessionlessFunc<In, Out = unknown>(func: PikkuFunct
  * })
  * ```
  */
-export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "session" | "rpc", PikkuFunctionSessionless<void, void, "session" | "rpc", Services> | PikkuFunction<void, void, "session" | "rpc", Services>, undefined, undefined>;
+export declare const pikkuVoidFunc: (func: PikkuFunctionSessionless<void, void, "session" | "rpc"> | PikkuFunctionConfig<void, void, "session" | "rpc">) => PikkuFunctionConfig<void, void, "rpc" | "session", PikkuFunctionSessionless<void, void, "rpc" | "session", Services> | PikkuFunction<void, void, "rpc" | "session", Services>, undefined, undefined>;
 /**
  * References a registered function by name for use in any wiring.
  * Works for both local and addon functions — resolves via RPC at runtime.
@@ -451,52 +439,38 @@ export declare const pikkuServices: (func: (config: Config, existingServices: Pa
  */
 export declare const pikkuWireServices: (func: (services: SingletonServices, wire: any) => Promise<RequiredWireServices>) => CreateWireServices;
 /**
- * Adds global middleware for a specific tag.
- *
- * This function allows you to register middleware that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
- *
- * @param tag - The tag that the middleware should apply to.
- * @param middleware - The middleware array to apply for the specified tag.
- *
- * @throws Error if middleware for the tag already exists.
+ * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin middleware for admin endpoints
- * addMiddleware('admin', [adminMiddleware])
- *
- * // Add authentication middleware for auth endpoints
- * addMiddleware('auth', [authMiddleware])
- *
- * // Add logging middleware for all API endpoints
- * addMiddleware('api', [loggingMiddleware])
- * ```
+ * addTagMiddleware('admin', [adminMiddleware])
  */
-export declare const addMiddleware: (tag: string, middleware: PikkuMiddleware[]) => void;
+export declare const addTagMiddleware: (tag: string, middleware: PikkuMiddleware[]) => void;
 /**
- * Adds global permissions for a specific tag.
+ * Wire-agnostic global middleware. Runs at the top of every wiring's
+ * middleware chain — before wire-, tag-, and function-level entries.
  *
- * This function allows you to register permissions that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * Resolution order: global -> wire -> tag -> function.
  *
- * @param tag - The tag that the permissions should apply to.
- * @param permissions - The permissions array or object to apply for the specified tag.
- *
- * @throws Error if permissions for the tag already exist.
+ * @example
+ * addGlobalMiddleware([telemetryMiddleware])
+ */
+export declare const addGlobalMiddleware: (middleware: PikkuMiddleware[]) => void;
+/**
+ * Tag-scoped permissions. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin permissions for admin endpoints
- * addPermission('admin', [adminPermission])
+ * addTagPermission('admin', [adminPermission])
+ */
+export declare const addTagPermission: <In = unknown>(tag: string, permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => void;
+/**
+ * Wire-agnostic global permissions. Runs at the top of every wiring's
+ * permission resolution — before wire-, tag-, and function-level entries.
  *
- * // Add authentication permissions for auth endpoints
- * addPermission('auth', [authPermission])
+ * Resolution order: global -> wire -> tag -> function.
  *
- * // Add read permissions for all API endpoints (as object)
- * addPermission('api', { read: readPermission })
- * ```
+ * @example
+ * addGlobalPermission([signedInUser])
  */
-export declare const addPermission: <In = unknown>(tag: string, permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => void;
+export declare const addGlobalPermission: <In = unknown>(permissions: CorePermissionGroup<PikkuPermission<In>> | PikkuPermission<In>[]) => void;
 export { wireAddon } from '@pikku/core/rpc';
 export type { WireAddonConfig } from '@pikku/core/rpc';

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

@@ -1,11 +1,11 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 /**
  * Core function, middleware, and permission types for all wirings
  */
 import { pikkuAuth as pikkuAuthCore } from '@pikku/core/function';
-import { addMiddleware as addMiddlewareCore, addPermission as addPermissionCore } from '@pikku/core/middleware';
+import { addTagMiddleware as addTagMiddlewareCore, addGlobalMiddleware as addGlobalMiddlewareCore, addTagPermission as addTagPermissionCore, addGlobalPermission as addGlobalPermissionCore, } from '@pikku/core/middleware';
 import { pikkuState as __pikkuState } from '@pikku/core/internal';
 /**
  * Factory function for creating permissions with tree-shaking support.
@@ -143,6 +143,9 @@ export const pikkuApprovalDescription = (fn) => {
 export function pikkuFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }
+export const pikkuListFunc = (config) => {
+    return pikkuFunc(config);
+};
 export function pikkuSessionlessFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }
@@ -255,55 +258,45 @@ export const pikkuWireServices = (func) => {
     return func;
 };
 /**
- * Adds global middleware for a specific tag.
- *
- * This function allows you to register middleware that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
- *
- * @param tag - The tag that the middleware should apply to.
- * @param middleware - The middleware array to apply for the specified tag.
- *
- * @throws Error if middleware for the tag already exists.
+ * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin middleware for admin endpoints
- * addMiddleware('admin', [adminMiddleware])
- *
- * // Add authentication middleware for auth endpoints
- * addMiddleware('auth', [authMiddleware])
- *
- * // Add logging middleware for all API endpoints
- * addMiddleware('api', [loggingMiddleware])
- * ```
+ * addTagMiddleware('admin', [adminMiddleware])
  */
-export const addMiddleware = (tag, middleware) => {
-    addMiddlewareCore(tag, middleware, null);
+export const addTagMiddleware = (tag, middleware) => {
+    addTagMiddlewareCore(tag, middleware, null);
 };
 /**
- * Adds global permissions for a specific tag.
+ * Wire-agnostic global middleware. Runs at the top of every wiring's
+ * middleware chain — before wire-, tag-, and function-level entries.
  *
- * This function allows you to register permissions that will be applied to
- * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * Resolution order: global -> wire -> tag -> function.
  *
- * @param tag - The tag that the permissions should apply to.
- * @param permissions - The permissions array or object to apply for the specified tag.
- *
- * @throws Error if permissions for the tag already exist.
+ * @example
+ * addGlobalMiddleware([telemetryMiddleware])
+ */
+export const addGlobalMiddleware = (middleware) => {
+    addGlobalMiddlewareCore(middleware, null);
+};
+/**
+ * Tag-scoped permissions. Applies to any wiring that carries the matching tag.
  *
  * @example
- * ```typescript
- * // Add admin permissions for admin endpoints
- * addPermission('admin', [adminPermission])
+ * addTagPermission('admin', [adminPermission])
+ */
+export const addTagPermission = (tag, permissions) => {
+    addTagPermissionCore(tag, permissions, null);
+};
+/**
+ * Wire-agnostic global permissions. Runs at the top of every wiring's
+ * permission resolution — before wire-, tag-, and function-level entries.
  *
- * // Add authentication permissions for auth endpoints
- * addPermission('auth', [authPermission])
+ * Resolution order: global -> wire -> tag -> function.
  *
- * // Add read permissions for all API endpoints (as object)
- * addPermission('api', { read: readPermission })
- * ```
+ * @example
+ * addGlobalPermission([signedInUser])
  */
-export const addPermission = (tag, permissions) => {
-    addPermissionCore(tag, permissions, null);
+export const addGlobalPermission = (permissions) => {
+    addGlobalPermissionCore(permissions, null);
 };
 export { wireAddon } from '@pikku/core/rpc';

package/dist/.pikku/function/pikku-functions-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.20
+ * This file was generated by @pikku/cli@0.12.22
  */
 import { pikkuState } from '@pikku/core/internal';
 import metaData from './pikku-functions-meta.gen.json' with { type: 'json' };