@pikku/cli 0.9.3 → 0.9.4

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @pikku/cli
 
+## 0.9.4
+
+### Patch Changes
+
+- 92c1926: feat: adding rpc and websocket client cli commands
+- c18800d: feat: adding queue and scheduledTask to interactions
+- Updated dependencies [c18800d]
+  - @pikku/core@0.9.4
+
 ## 0.9.3
 
 ### Patch Changes

package/bin/pikku-rpc.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander'
+import { CLILogger, PikkuCLIOptions } from '../src/utils.js'
+import { getPikkuCLIConfig } from '../src/pikku-cli-config.js'
+import { pikkuRPCClient } from '../src/wirings/rpc/pikku-command-rpc-client.js'
+
+export const action = async (options: PikkuCLIOptions): Promise<void> => {
+  const logger = new CLILogger({ logLogo: true })
+
+  const cliConfig = await getPikkuCLIConfig(
+    options.config,
+    ['rootDir', 'schemaDirectory', 'configDir', 'fetchFile'],
+    {
+      tags: options.tags,
+      types: options.types,
+      directories: options.directories,
+    },
+    true
+  )
+  await pikkuRPCClient(logger, cliConfig)
+}
+
+export const rpc = (program: Command): void => {
+  program
+    .command('rpc')
+    .description('generate rpc wrapper')
+    .option('-c | --config <string>', 'The path to pikku cli config file')
+    .action(action)
+}

package/bin/pikku.ts

@@ -5,6 +5,8 @@ import { nextjs } from './pikku-nextjs.js'
 import { all } from './pikku-all.js'
 import { fetch } from './pikku-fetch.js'
 import { queue } from './pikku-queue-service.js'
+import { websocket } from './pikku-websocket.js'
+import { rpc } from './pikku-rpc.js'
 
 const program = new Command('pikku')
 program.usage('[command]')
@@ -12,6 +14,8 @@ program.usage('[command]')
 all(program)
 schemas(program)
 nextjs(program)
+websocket(program)
+rpc(program)
 fetch(program)
 queue(program)
 

package/dist/bin/pikku-rpc.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { PikkuCLIOptions } from '../src/utils.js';
+export declare const action: (options: PikkuCLIOptions) => Promise<void>;
+export declare const rpc: (program: Command) => void;

package/dist/bin/pikku-rpc.js

@@ -0,0 +1,19 @@
+import { CLILogger } from '../src/utils.js';
+import { getPikkuCLIConfig } from '../src/pikku-cli-config.js';
+import { pikkuRPCClient } from '../src/wirings/rpc/pikku-command-rpc-client.js';
+export const action = async (options) => {
+    const logger = new CLILogger({ logLogo: true });
+    const cliConfig = await getPikkuCLIConfig(options.config, ['rootDir', 'schemaDirectory', 'configDir', 'fetchFile'], {
+        tags: options.tags,
+        types: options.types,
+        directories: options.directories,
+    }, true);
+    await pikkuRPCClient(logger, cliConfig);
+};
+export const rpc = (program) => {
+    program
+        .command('rpc')
+        .description('generate rpc wrapper')
+        .option('-c | --config <string>', 'The path to pikku cli config file')
+        .action(action);
+};

package/dist/bin/pikku.js

@@ -5,11 +5,15 @@ import { nextjs } from './pikku-nextjs.js';
 import { all } from './pikku-all.js';
 import { fetch } from './pikku-fetch.js';
 import { queue } from './pikku-queue-service.js';
+import { websocket } from './pikku-websocket.js';
+import { rpc } from './pikku-rpc.js';
 const program = new Command('pikku');
 program.usage('[command]');
 all(program);
 schemas(program);
 nextjs(program);
+websocket(program);
+rpc(program);
 fetch(program);
 queue(program);
 program.parse(process.argv);

package/dist/src/serialize-pikku-types.js

@@ -6,7 +6,7 @@ export const serializePikkuTypes = (userSessionTypeImport, userSessionTypeName,
 * This is used to provide the application types in the typescript project
 */
   
-import { CorePikkuFunctionConfig, CorePikkuPermission, CorePikkuMiddleware, addHTTPMiddleware } from '@pikku/core'
+import { CorePikkuFunctionConfig, CorePikkuPermission, CorePikkuMiddleware, addHTTPMiddleware, addMiddleware, addMiddlewareForTags, addPermission } from '@pikku/core'
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function'
 import { CoreHTTPFunctionWiring, AssertHTTPWiringParams, wireHTTP as wireHTTPCore } from '@pikku/core/http'
 import { CoreScheduledTask, wireScheduler as wireSchedulerCore } from '@pikku/core/scheduler'
@@ -111,7 +111,7 @@ type ChannelWiring<ChannelData, Channel extends string> = CoreChannel<ChannelDat
  * Type definition for scheduled tasks that run at specified intervals.
  * These are sessionless functions that execute based on cron expressions.
  */
-type SchedulerWiring = CoreScheduledTask<PikkuFunctionSessionless<void, void>>
+type SchedulerWiring = CoreScheduledTask<PikkuFunctionSessionless<void, void>, PikkuMiddleware>
 
 /**
  * Type definition for queue workers that process background jobs.
@@ -194,7 +194,7 @@ export const pikkuFunc = <In, Out = unknown>(
 export const pikkuSessionlessFunc = <In, Out = unknown>(
   func:
     | PikkuFunctionSessionless<In, Out>
-    | CorePikkuFunctionConfig<PikkuFunctionSessionless<In, Out>, PikkuPermission<In>>
+    | CorePikkuFunctionConfig<PikkuFunctionSessionless<In, Out>, PikkuPermission<In>, PikkuMiddleware>
 ) => {
   return typeof func === 'function' ? func : func.func
 }
@@ -344,6 +344,78 @@ export const wireChannel = <ChannelData, Channel extends string>(
  */
 export { addHTTPMiddleware }
 
+/**
+ * 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.
+ * 
+ * @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])
+ * \`\`\`
+ */
+export { addMiddleware }
+
+/**
+ * Combines tag-based middleware with wiring-specific middleware.
+ * 
+ * This helper function gets middleware for tags and combines it with any
+ * wiring-specific middleware, avoiding the need for manual spreading.
+ * 
+ * @param wiringMiddleware - Wiring-specific middleware.
+ * @param tags - Array of tags to look up middleware for.
+ * @returns Combined array of tag-based and wiring-specific middleware.
+ * 
+ * @example
+ * \`\`\`typescript
+ * // Instead of:
+ * const taggedMiddleware = getMiddlewareForTags(tags)
+ * const combined = [...taggedMiddleware, ...(middleware || [])]
+ * 
+ * // Use:
+ * const combined = addMiddlewareForTags(middleware, tags)
+ * \`\`\`
+ */
+export { addMiddlewareForTags }
+
+/**
+ * Adds global permissions for a specific tag.
+ * 
+ * This function allows you to register permissions that will be applied to 
+ * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * 
+ * @param tag - The tag that the permissions should apply to.
+ * @param permissions - The permissions array to apply for the specified tag.
+ * 
+ * @throws Error if permissions for the tag already exist.
+ * 
+ * @example
+ * \`\`\`typescript
+ * // Add admin permissions for admin endpoints
+ * addPermission('admin', [adminPermission])
+ * 
+ * // Add authentication permissions for auth endpoints
+ * addPermission('auth', [authPermission])
+ * 
+ * // Add read permissions for all API endpoints
+ * addPermission('api', [readPermission])
+ * \`\`\`
+ */
+export { addPermission }
+
 /**
  * Registers an HTTP wiring with the Pikku framework.
  * 

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../bin/pikku-all.ts","../bin/pikku-fetch.ts","../bin/pikku-nextjs.ts","../bin/pikku-openapi.ts","../bin/pikku-queue-service.ts","../bin/pikku-schemas.ts","../bin/pikku-websocket.ts","../bin/pikku.ts","../src/inspector-glob.ts","../src/pikku-cli-config.ts","../src/pikku-command-schemas.ts","../src/schema-generator.ts","../src/schemas.ts","../src/serialize-import-map.ts","../src/serialize-pikku-types.ts","../src/types.ts","../src/utils.ts","../src/runtimes/nextjs/pikku-command-nextjs.ts","../src/runtimes/nextjs/serialize-nextjs-backend-wrapper.ts","../src/runtimes/nextjs/serialize-nextjs-http-wrapper.ts","../src/wirings/channels/pikku-channels.ts","../src/wirings/channels/pikku-command-channels-map.ts","../src/wirings/channels/pikku-command-channels.ts","../src/wirings/channels/pikku-command-websocket-typed.ts","../src/wirings/channels/serialize-typed-channel-map.ts","../src/wirings/channels/serialize-websocket-wrapper.ts","../src/wirings/fetch/index.ts","../src/wirings/functions/pikku-command-function-types.ts","../src/wirings/functions/pikku-command-functions.ts","../src/wirings/functions/pikku-command-services.ts","../src/wirings/functions/pikku-function-types.ts","../src/wirings/functions/serialize-function-imports.ts","../src/wirings/http/openapi-spec-generator.ts","../src/wirings/http/pikku-command-http-map.ts","../src/wirings/http/pikku-command-http-routes.ts","../src/wirings/http/pikku-command-openapi.ts","../src/wirings/http/pikku-http-routes.ts","../src/wirings/http/serialize-fetch-wrapper.ts","../src/wirings/http/serialize-typed-http-map.ts","../src/wirings/mcp/pikku-command-mcp-json.ts","../src/wirings/mcp/pikku-command-mcp.ts","../src/wirings/mcp/serialize-mcp-json.ts","../src/wirings/queue/pikku-command-queue-map.ts","../src/wirings/queue/pikku-command-queue-service.ts","../src/wirings/queue/pikku-command-queue.ts","../src/wirings/queue/pikku-queue-map.ts","../src/wirings/queue/pikku-queue.ts","../src/wirings/queue/serialize-queue-map.ts","../src/wirings/queue/serialize-queue-meta.ts","../src/wirings/queue/serialize-queue-wrapper.ts","../src/wirings/rpc/pikku-command-rpc-client.ts","../src/wirings/rpc/pikku-command-rpc-map.ts","../src/wirings/rpc/pikku-command-rpc.ts","../src/wirings/rpc/serialize-rpc-wrapper.ts","../src/wirings/rpc/serialize-typed-rpc-map.ts","../src/wirings/scheduler/pikku-command-scheduler.ts","../src/wirings/scheduler/serialize-scheduler-meta.ts"],"version":"5.9.2"}
+{"root":["../bin/pikku-all.ts","../bin/pikku-fetch.ts","../bin/pikku-nextjs.ts","../bin/pikku-openapi.ts","../bin/pikku-queue-service.ts","../bin/pikku-rpc.ts","../bin/pikku-schemas.ts","../bin/pikku-websocket.ts","../bin/pikku.ts","../src/inspector-glob.ts","../src/pikku-cli-config.ts","../src/pikku-command-schemas.ts","../src/schema-generator.ts","../src/schemas.ts","../src/serialize-import-map.ts","../src/serialize-pikku-types.ts","../src/types.ts","../src/utils.ts","../src/runtimes/nextjs/pikku-command-nextjs.ts","../src/runtimes/nextjs/serialize-nextjs-backend-wrapper.ts","../src/runtimes/nextjs/serialize-nextjs-http-wrapper.ts","../src/wirings/channels/pikku-channels.ts","../src/wirings/channels/pikku-command-channels-map.ts","../src/wirings/channels/pikku-command-channels.ts","../src/wirings/channels/pikku-command-websocket-typed.ts","../src/wirings/channels/serialize-typed-channel-map.ts","../src/wirings/channels/serialize-websocket-wrapper.ts","../src/wirings/fetch/index.ts","../src/wirings/functions/pikku-command-function-types.ts","../src/wirings/functions/pikku-command-functions.ts","../src/wirings/functions/pikku-command-services.ts","../src/wirings/functions/pikku-function-types.ts","../src/wirings/functions/serialize-function-imports.ts","../src/wirings/http/openapi-spec-generator.ts","../src/wirings/http/pikku-command-http-map.ts","../src/wirings/http/pikku-command-http-routes.ts","../src/wirings/http/pikku-command-openapi.ts","../src/wirings/http/pikku-http-routes.ts","../src/wirings/http/serialize-fetch-wrapper.ts","../src/wirings/http/serialize-typed-http-map.ts","../src/wirings/mcp/pikku-command-mcp-json.ts","../src/wirings/mcp/pikku-command-mcp.ts","../src/wirings/mcp/serialize-mcp-json.ts","../src/wirings/queue/pikku-command-queue-map.ts","../src/wirings/queue/pikku-command-queue-service.ts","../src/wirings/queue/pikku-command-queue.ts","../src/wirings/queue/pikku-queue-map.ts","../src/wirings/queue/pikku-queue.ts","../src/wirings/queue/serialize-queue-map.ts","../src/wirings/queue/serialize-queue-meta.ts","../src/wirings/queue/serialize-queue-wrapper.ts","../src/wirings/rpc/pikku-command-rpc-client.ts","../src/wirings/rpc/pikku-command-rpc-map.ts","../src/wirings/rpc/pikku-command-rpc.ts","../src/wirings/rpc/serialize-rpc-wrapper.ts","../src/wirings/rpc/serialize-typed-rpc-map.ts","../src/wirings/scheduler/pikku-command-scheduler.ts","../src/wirings/scheduler/serialize-scheduler-meta.ts"],"version":"5.9.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/cli",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "bin": {
@@ -22,7 +22,7 @@
   },
   "dependencies": {
     "@openapi-contrib/json-schema-to-openapi-schema": "^4.0.2",
-    "@pikku/core": "^0.9.3",
+    "@pikku/core": "^0.9.4",
     "@pikku/inspector": "^0.9.3",
     "@types/cookie": "^1.0.0",
     "@types/uuid": "^10.0.0",

package/src/serialize-pikku-types.ts

@@ -13,7 +13,7 @@ export const serializePikkuTypes = (
 * This is used to provide the application types in the typescript project
 */
   
-import { CorePikkuFunctionConfig, CorePikkuPermission, CorePikkuMiddleware, addHTTPMiddleware } from '@pikku/core'
+import { CorePikkuFunctionConfig, CorePikkuPermission, CorePikkuMiddleware, addHTTPMiddleware, addMiddleware, addMiddlewareForTags, addPermission } from '@pikku/core'
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function'
 import { CoreHTTPFunctionWiring, AssertHTTPWiringParams, wireHTTP as wireHTTPCore } from '@pikku/core/http'
 import { CoreScheduledTask, wireScheduler as wireSchedulerCore } from '@pikku/core/scheduler'
@@ -118,7 +118,7 @@ type ChannelWiring<ChannelData, Channel extends string> = CoreChannel<ChannelDat
  * Type definition for scheduled tasks that run at specified intervals.
  * These are sessionless functions that execute based on cron expressions.
  */
-type SchedulerWiring = CoreScheduledTask<PikkuFunctionSessionless<void, void>>
+type SchedulerWiring = CoreScheduledTask<PikkuFunctionSessionless<void, void>, PikkuMiddleware>
 
 /**
  * Type definition for queue workers that process background jobs.
@@ -201,7 +201,7 @@ export const pikkuFunc = <In, Out = unknown>(
 export const pikkuSessionlessFunc = <In, Out = unknown>(
   func:
     | PikkuFunctionSessionless<In, Out>
-    | CorePikkuFunctionConfig<PikkuFunctionSessionless<In, Out>, PikkuPermission<In>>
+    | CorePikkuFunctionConfig<PikkuFunctionSessionless<In, Out>, PikkuPermission<In>, PikkuMiddleware>
 ) => {
   return typeof func === 'function' ? func : func.func
 }
@@ -351,6 +351,78 @@ export const wireChannel = <ChannelData, Channel extends string>(
  */
 export { addHTTPMiddleware }
 
+/**
+ * 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.
+ * 
+ * @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])
+ * \`\`\`
+ */
+export { addMiddleware }
+
+/**
+ * Combines tag-based middleware with wiring-specific middleware.
+ * 
+ * This helper function gets middleware for tags and combines it with any
+ * wiring-specific middleware, avoiding the need for manual spreading.
+ * 
+ * @param wiringMiddleware - Wiring-specific middleware.
+ * @param tags - Array of tags to look up middleware for.
+ * @returns Combined array of tag-based and wiring-specific middleware.
+ * 
+ * @example
+ * \`\`\`typescript
+ * // Instead of:
+ * const taggedMiddleware = getMiddlewareForTags(tags)
+ * const combined = [...taggedMiddleware, ...(middleware || [])]
+ * 
+ * // Use:
+ * const combined = addMiddlewareForTags(middleware, tags)
+ * \`\`\`
+ */
+export { addMiddlewareForTags }
+
+/**
+ * Adds global permissions for a specific tag.
+ * 
+ * This function allows you to register permissions that will be applied to 
+ * any wiring (HTTP, Channel, Queue, Scheduler, MCP) that includes the matching tag.
+ * 
+ * @param tag - The tag that the permissions should apply to.
+ * @param permissions - The permissions array to apply for the specified tag.
+ * 
+ * @throws Error if permissions for the tag already exist.
+ * 
+ * @example
+ * \`\`\`typescript
+ * // Add admin permissions for admin endpoints
+ * addPermission('admin', [adminPermission])
+ * 
+ * // Add authentication permissions for auth endpoints
+ * addPermission('auth', [authPermission])
+ * 
+ * // Add read permissions for all API endpoints
+ * addPermission('api', [readPermission])
+ * \`\`\`
+ */
+export { addPermission }
+
 /**
  * Registers an HTTP wiring with the Pikku framework.
  *