@pikku/inspector 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @pikku/inspector
 
+## 0.9.0
+
+### Breaking Changes
+
+- Normalized all transports to use "wirings" instead of events/routes/transports for consistency across the framework
+
 ## 0.8.1
 
 ### Patch Changes

package/dist/add-channel.d.ts

@@ -5,7 +5,7 @@ import type { InspectorFilters, InspectorState, InspectorLogger } from './types.
  * Build out the nested message-routes by looking up each handler
  * in state.functions.meta instead of re-inferring it here.
  */
-export declare function addMessagesRoutes(obj: ts.ObjectLiteralExpression, state: InspectorState, checker: ts.TypeChecker): ChannelMeta['messageRoutes'];
+export declare function addMessagesRoutes(obj: ts.ObjectLiteralExpression, state: InspectorState, checker: ts.TypeChecker): ChannelMeta['messageWirings'];
 /**
  * Inspect addChannel calls, look up all handlers in state.functions.meta,
  * and emit one entry into state.channels.meta.

package/dist/add-channel.js

@@ -1,7 +1,7 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
 import { pathToRegexp } from 'path-to-regexp';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 /**
  * Safely get the “initializer” expression of a property-like AST node:
@@ -76,7 +76,7 @@ function getHandlerNameFromExpression(expr, checker) {
  */
 export function addMessagesRoutes(obj, state, checker) {
     const result = {};
-    const onMsgRouteProp = getPropertyAssignmentInitializer(obj, 'onMessageRoute', true, checker);
+    const onMsgRouteProp = getPropertyAssignmentInitializer(obj, 'onMessageWiring', true, checker);
     if (!onMsgRouteProp)
         return result;
     if (!onMsgRouteProp || !ts.isObjectLiteralExpression(onMsgRouteProp))
@@ -271,7 +271,7 @@ export function addChannel(node, checker, state, filters, logger) {
     if (!ts.isCallExpression(node))
         return;
     const { expression, arguments: args } = node;
-    if (!ts.isIdentifier(expression) || expression.text !== 'addChannel')
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireChannel')
         return;
     const first = args[0];
     if (!first || !ts.isObjectLiteralExpression(first))
@@ -293,7 +293,7 @@ export function addChannel(node, checker, state, filters, logger) {
     const tags = getPropertyValue(obj, 'tags');
     const query = getPropertyValue(obj, 'query');
     const filePath = node.getSourceFile().fileName;
-    if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.channel, name, filePath }, logger))
+    if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.channel, name, filePath }, logger))
         return;
     const connect = getPropertyAssignmentInitializer(obj, 'onConnect', false, checker);
     const disconnect = getPropertyAssignmentInitializer(obj, 'onDisconnect', false, checker);
@@ -315,7 +315,7 @@ export function addChannel(node, checker, state, filters, logger) {
         }
     }
     // nested message-routes
-    const messageRoutes = addMessagesRoutes(obj, state, checker);
+    const messageWirings = addMessagesRoutes(obj, state, checker);
     // record into state
     state.channels.files.add(node.getSourceFile().fileName);
     state.channels.meta[name] = {
@@ -341,7 +341,7 @@ export function addChannel(node, checker, state, filters, logger) {
             }
             : null,
         message,
-        messageRoutes,
+        messageWirings,
         docs: docs ?? undefined,
         tags: tags ?? undefined,
     };

package/dist/add-file-extends-core-type.js

@@ -1,5 +1,4 @@
 import * as ts from 'typescript';
-// const VRAMEWORK_TYPES = ['CoreConfig', 'CoreService', 'CoreServices', 'CoreSingletonService', 'CoreSessionService']
 export const addFileExtendsCoreType = (node, checker, methods, expectedTypeName) => {
     if (ts.isClassDeclaration(node) || ts.isInterfaceDeclaration(node)) {
         const fileName = node.getSourceFile().fileName;

package/dist/add-http-route.d.ts

@@ -10,7 +10,7 @@ export declare const getInputTypes: (metaTypes: Map<string, {
     body?: string[];
 }>, methodType: string, inputType: string | null, queryValues: string[], paramsValues: string[]) => undefined;
 /**
- * Simplified addHTTPRoute: re-uses function metadata from state.functions.meta
+ * Simplified wireHTTP: re-uses function metadata from state.functions.meta
  * instead of re-inferring types here.
  */
 export declare const addHTTPRoute: (node: ts.Node, checker: ts.TypeChecker, state: InspectorState, filters: InspectorFilters, logger: InspectorLogger) => void;

package/dist/add-http-route.js

@@ -1,7 +1,7 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
 import { pathToRegexp } from 'path-to-regexp';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 /**
  * Populate metaInputTypes for a given route based on method, input type,
@@ -20,7 +20,7 @@ export const getInputTypes = (metaTypes, methodType, inputType, queryValues, par
     return;
 };
 /**
- * Simplified addHTTPRoute: re-uses function metadata from state.functions.meta
+ * Simplified wireHTTP: re-uses function metadata from state.functions.meta
  * instead of re-inferring types here.
  */
 export const addHTTPRoute = (node, checker, state, filters, logger) => {
@@ -28,7 +28,7 @@ export const addHTTPRoute = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node))
         return;
     const { expression, arguments: args } = node;
-    if (!ts.isIdentifier(expression) || expression.text !== 'addHTTPRoute')
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireHTTP')
         return;
     // must pass an object literal
     const firstArg = args[0];
@@ -46,7 +46,7 @@ export const addHTTPRoute = (node, checker, state, filters, logger) => {
     const tags = getPropertyValue(obj, 'tags') || undefined;
     const query = getPropertyValue(obj, 'query') || [];
     const filePath = node.getSourceFile().fileName;
-    if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.http, name: route, filePath }, logger)) {
+    if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.http, name: route, filePath }, logger)) {
         return;
     }
     // --- find the referenced function ---

package/dist/add-mcp-prompt.js

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 export const addMCPPrompt = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node)) {
@@ -9,8 +9,8 @@ export const addMCPPrompt = (node, checker, state, filters, logger) => {
     const args = node.arguments;
     const firstArg = args[0];
     const expression = node.expression;
-    // Check if the call is to addMCPPrompt
-    if (!ts.isIdentifier(expression) || expression.text !== 'addMCPPrompt') {
+    // Check if the call is to wireMCPPrompt
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireMCPPrompt') {
         return;
     }
     if (!firstArg) {
@@ -36,7 +36,7 @@ export const addMCPPrompt = (node, checker, state, filters, logger) => {
             return;
         }
         const filePath = node.getSourceFile().fileName;
-        if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.mcp, name: nameValue, filePath }, logger)) {
+        if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.mcp, name: nameValue, filePath }, logger)) {
             return;
         }
         // lookup existing function metadata

package/dist/add-mcp-resource.js

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 export const addMCPResource = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node)) {
@@ -9,8 +9,8 @@ export const addMCPResource = (node, checker, state, filters, logger) => {
     const args = node.arguments;
     const firstArg = args[0];
     const expression = node.expression;
-    // Check if the call is to addMCPResource
-    if (!ts.isIdentifier(expression) || expression.text !== 'addMCPResource') {
+    // Check if the call is to wireMCPResource
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireMCPResource') {
         return;
     }
     if (!firstArg) {
@@ -42,7 +42,7 @@ export const addMCPResource = (node, checker, state, filters, logger) => {
             return;
         }
         const filePath = node.getSourceFile().fileName;
-        if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.mcp, name: uriValue, filePath }, logger)) {
+        if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.mcp, name: uriValue, filePath }, logger)) {
             return;
         }
         // lookup existing function metadata

package/dist/add-mcp-tool.js

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 export const addMCPTool = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node)) {
@@ -9,8 +9,8 @@ export const addMCPTool = (node, checker, state, filters, logger) => {
     const args = node.arguments;
     const firstArg = args[0];
     const expression = node.expression;
-    // Check if the call is to addMCPTool
-    if (!ts.isIdentifier(expression) || expression.text !== 'addMCPTool') {
+    // Check if the call is to wireMCPTool
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireMCPTool') {
         return;
     }
     if (!firstArg) {
@@ -38,7 +38,7 @@ export const addMCPTool = (node, checker, state, filters, logger) => {
             return;
         }
         const filePath = node.getSourceFile().fileName;
-        if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.mcp, name: nameValue, filePath }, logger)) {
+        if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.mcp, name: nameValue, filePath }, logger)) {
             return;
         }
         // lookup existing function metadata

package/dist/add-queue-worker.js

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 export const addQueueWorker = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node)) {
@@ -10,7 +10,7 @@ export const addQueueWorker = (node, checker, state, filters, logger) => {
     const firstArg = args[0];
     const expression = node.expression;
     // Check if the call is to addQueueWorker
-    if (!ts.isIdentifier(expression) || expression.text !== 'addQueueWorker') {
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireQueueWorker') {
         return;
     }
     if (!firstArg) {
@@ -33,7 +33,7 @@ export const addQueueWorker = (node, checker, state, filters, logger) => {
             return;
         }
         const filePath = node.getSourceFile().fileName;
-        if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.queue, name: queueName, filePath }, logger)) {
+        if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.queue, name: queueName, filePath }, logger)) {
             console.info(`• Skipping queue processor '${pikkuFuncName}' for queue '${queueName}' due to filter mismatch.`);
             return;
         }

package/dist/add-schedule.js

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { getPropertyValue } from './get-property-value.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 import { extractFunctionName, getPropertyAssignmentInitializer, matchesFilters, } from './utils.js';
 export const addSchedule = (node, checker, state, filters, logger) => {
     if (!ts.isCallExpression(node)) {
@@ -10,7 +10,7 @@ export const addSchedule = (node, checker, state, filters, logger) => {
     const firstArg = args[0];
     const expression = node.expression;
     // Check if the call is to addScheduledTask
-    if (!ts.isIdentifier(expression) || expression.text !== 'addScheduledTask') {
+    if (!ts.isIdentifier(expression) || expression.text !== 'wireScheduler') {
         return;
     }
     if (!firstArg) {
@@ -32,7 +32,7 @@ export const addSchedule = (node, checker, state, filters, logger) => {
             return;
         }
         const filePath = node.getSourceFile().fileName;
-        if (!matchesFilters(filters, { tags }, { type: PikkuEventTypes.scheduler, name: nameValue, filePath }, logger)) {
+        if (!matchesFilters(filters, { tags }, { type: PikkuWiringTypes.scheduler, name: nameValue, filePath }, logger)) {
             return;
         }
         state.scheduledTasks.files.add(node.getSourceFile().fileName);

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { ChannelsMeta } from '@pikku/core/channel';
-import { HTTPRoutesMeta } from '@pikku/core/http';
+import { HTTPWiringsMeta } from '@pikku/core/http';
 import { ScheduledTasksMeta } from '@pikku/core/scheduler';
 import { queueWorkersMeta } from '@pikku/core/queue';
 import { MCPResourceMeta, MCPToolMeta, MCPPromptMeta } from '@pikku/core';
@@ -18,7 +18,7 @@ export type MetaInputTypes = Map<string, {
 }>;
 export interface InspectorHTTPState {
     metaInputTypes: MetaInputTypes;
-    meta: HTTPRoutesMeta;
+    meta: HTTPWiringsMeta;
     files: Set<string>;
 }
 export interface InspectorFunctionState {

package/dist/utils.d.ts

@@ -1,6 +1,6 @@
 import * as ts from 'typescript';
 import { InspectorFilters, InspectorLogger } from './types.js';
-import { PikkuEventTypes } from '@pikku/core';
+import { PikkuWiringTypes } from '@pikku/core';
 type ExtractedFunctionName = {
     pikkuFuncName: string;
     name: string;
@@ -28,7 +28,7 @@ export declare function getPropertyAssignmentInitializer(obj: ts.ObjectLiteralEx
 export declare const matchesFilters: (filters: InspectorFilters, params: {
     tags?: string[];
 }, meta: {
-    type: PikkuEventTypes;
+    type: PikkuWiringTypes;
     name: string;
     filePath?: string;
 }, logger: InspectorLogger) => boolean;

package/dist/utils.js

@@ -204,7 +204,7 @@ export function extractFunctionName(callExpr, checker) {
         propertyName: null,
         explicitName: null,
     };
-    // Special case for addHTTPRoute: if this is an identifier within an object literal,
+    // Special case for wireHTTP: if this is an identifier within an object literal,
     // it might be coming from the HTTP route handling flow
     if (ts.isIdentifier(callExpr) &&
         callExpr.parent &&