@pikku/inspector 0.8.1 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/inspector",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "test:coverage": "bash run-tests.sh --coverage"
   },
   "dependencies": {
-    "@pikku/core": "^0.8.1",
+    "@pikku/core": "^0.9.0",
     "path-to-regexp": "^8.2.0",
     "typescript": "^5.6"
   },

package/src/add-channel.ts

@@ -1,7 +1,7 @@
 import * as ts from 'typescript'
 import { getPropertyValue } from './get-property-value.js'
 import { pathToRegexp } from 'path-to-regexp'
-import { APIDocs, PikkuEventTypes } from '@pikku/core'
+import { APIDocs, PikkuWiringTypes } from '@pikku/core'
 import {
   extractFunctionName,
   getPropertyAssignmentInitializer,
@@ -107,11 +107,11 @@ export function addMessagesRoutes(
   obj: ts.ObjectLiteralExpression,
   state: InspectorState,
   checker: ts.TypeChecker
-): ChannelMeta['messageRoutes'] {
-  const result: ChannelMeta['messageRoutes'] = {}
+): ChannelMeta['messageWirings'] {
+  const result: ChannelMeta['messageWirings'] = {}
   const onMsgRouteProp = getPropertyAssignmentInitializer(
     obj,
-    'onMessageRoute',
+    'onMessageWiring',
     true,
     checker
   )
@@ -372,7 +372,7 @@ export function addChannel(
 ) {
   if (!ts.isCallExpression(node)) return
   const { expression, arguments: args } = node
-  if (!ts.isIdentifier(expression) || expression.text !== 'addChannel') return
+  if (!ts.isIdentifier(expression) || expression.text !== 'wireChannel') return
   const first = args[0]
   if (!first || !ts.isObjectLiteralExpression(first)) return
 
@@ -402,7 +402,7 @@ export function addChannel(
     !matchesFilters(
       filters,
       { tags },
-      { type: PikkuEventTypes.channel, name, filePath },
+      { type: PikkuWiringTypes.channel, name, filePath },
       logger
     )
   )
@@ -448,7 +448,7 @@ export function addChannel(
   }
 
   // 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)
@@ -475,7 +475,7 @@ export function addChannel(
         }
       : null,
     message,
-    messageRoutes,
+    messageWirings,
     docs: docs ?? undefined,
     tags: tags ?? undefined,
   }

package/src/add-file-extends-core-type.ts

@@ -1,8 +1,6 @@
 import * as ts from 'typescript'
 import { PathToNameAndType } from './types.js'
 
-// const VRAMEWORK_TYPES = ['CoreConfig', 'CoreService', 'CoreServices', 'CoreSingletonService', 'CoreSessionService']
-
 export const addFileExtendsCoreType = (
   node: ts.Node,
   checker: ts.TypeChecker,

package/src/add-http-route.ts

@@ -2,7 +2,7 @@ import * as ts from 'typescript'
 import { getPropertyValue } from './get-property-value.js'
 import { pathToRegexp } from 'path-to-regexp'
 import { HTTPMethod } from '@pikku/core/http'
-import { APIDocs, PikkuEventTypes } from '@pikku/core'
+import { APIDocs, PikkuWiringTypes } from '@pikku/core'
 import {
   extractFunctionName,
   getPropertyAssignmentInitializer,
@@ -36,7 +36,7 @@ export const getInputTypes = (
 }
 
 /**
- * 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 = (
@@ -50,7 +50,7 @@ export const addHTTPRoute = (
   if (!ts.isCallExpression(node)) return
 
   const { expression, arguments: args } = node
-  if (!ts.isIdentifier(expression) || expression.text !== 'addHTTPRoute') return
+  if (!ts.isIdentifier(expression) || expression.text !== 'wireHTTP') return
 
   // must pass an object literal
   const firstArg = args[0]
@@ -76,7 +76,7 @@ export const addHTTPRoute = (
     !matchesFilters(
       filters,
       { tags },
-      { type: PikkuEventTypes.http, name: route, filePath },
+      { type: PikkuWiringTypes.http, name: route, filePath },
       logger
     )
   ) {

package/src/add-mcp-prompt.ts

@@ -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 { InspectorFilters, InspectorState, InspectorLogger } from './types.js'
 import {
   extractFunctionName,
@@ -23,8 +23,8 @@ export const addMCPPrompt = (
   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
   }
 
@@ -73,7 +73,7 @@ export const addMCPPrompt = (
       !matchesFilters(
         filters,
         { tags },
-        { type: PikkuEventTypes.mcp, name: nameValue, filePath },
+        { type: PikkuWiringTypes.mcp, name: nameValue, filePath },
         logger
       )
     ) {

package/src/add-mcp-resource.ts

@@ -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 { InspectorFilters, InspectorState, InspectorLogger } from './types.js'
 import {
   extractFunctionName,
@@ -23,8 +23,8 @@ export const addMCPResource = (
   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
   }
 
@@ -84,7 +84,7 @@ export const addMCPResource = (
       !matchesFilters(
         filters,
         { tags },
-        { type: PikkuEventTypes.mcp, name: uriValue, filePath },
+        { type: PikkuWiringTypes.mcp, name: uriValue, filePath },
         logger
       )
     ) {

package/src/add-mcp-tool.ts

@@ -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 { InspectorFilters, InspectorState, InspectorLogger } from './types.js'
 import {
   extractFunctionName,
@@ -23,8 +23,8 @@ export const addMCPTool = (
   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
   }
 
@@ -75,7 +75,7 @@ export const addMCPTool = (
       !matchesFilters(
         filters,
         { tags },
-        { type: PikkuEventTypes.mcp, name: nameValue, filePath },
+        { type: PikkuWiringTypes.mcp, name: nameValue, filePath },
         logger
       )
     ) {

package/src/add-queue-worker.ts

@@ -1,6 +1,6 @@
 import * as ts from 'typescript'
 import { getPropertyValue } from './get-property-value.js'
-import { APIDocs, PikkuEventTypes } from '@pikku/core'
+import { APIDocs, PikkuWiringTypes } from '@pikku/core'
 import { InspectorFilters, InspectorState, InspectorLogger } from './types.js'
 import {
   extractFunctionName,
@@ -24,7 +24,7 @@ export const addQueueWorker = (
   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
   }
 
@@ -71,7 +71,7 @@ export const addQueueWorker = (
       !matchesFilters(
         filters,
         { tags },
-        { type: PikkuEventTypes.queue, name: queueName, filePath },
+        { type: PikkuWiringTypes.queue, name: queueName, filePath },
         logger
       )
     ) {

package/src/add-schedule.ts

@@ -1,6 +1,6 @@
 import * as ts from 'typescript'
 import { getPropertyValue } from './get-property-value.js'
-import { APIDocs, PikkuEventTypes } from '@pikku/core'
+import { APIDocs, PikkuWiringTypes } from '@pikku/core'
 import { InspectorFilters, InspectorState, InspectorLogger } from './types.js'
 import {
   extractFunctionName,
@@ -24,7 +24,7 @@ export const addSchedule = (
   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
   }
 
@@ -68,7 +68,7 @@ export const addSchedule = (
       !matchesFilters(
         filters,
         { tags },
-        { type: PikkuEventTypes.scheduler, name: nameValue, filePath },
+        { type: PikkuWiringTypes.scheduler, name: nameValue, filePath },
         logger
       )
     ) {

package/src/types.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'
@@ -23,7 +23,7 @@ export type MetaInputTypes = Map<
 
 export interface InspectorHTTPState {
   metaInputTypes: MetaInputTypes
-  meta: HTTPRoutesMeta
+  meta: HTTPWiringsMeta
   files: Set<string>
 }
 

package/src/utils.test.ts

@@ -2,7 +2,7 @@ import { test, describe } from 'node:test'
 import { strict as assert } from 'node:assert'
 import { matchesFilters } from './utils.js'
 import { InspectorFilters } from './types.js'
-import { PikkuEventTypes } from '@pikku/core'
+import { PikkuWiringTypes } from '@pikku/core'
 
 describe('matchesFilters', () => {
   // Mock logger for testing
@@ -20,7 +20,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -37,7 +37,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -54,7 +54,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['api', 'internal'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -69,7 +69,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['internal', 'private'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -84,7 +84,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: undefined },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -99,7 +99,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: [] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -116,7 +116,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -131,21 +131,21 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
       assert.equal(result, false)
     })
 
-    test('should handle all PikkuEventTypes correctly', () => {
+    test('should handle all PikkuWiringTypes correctly', () => {
       const eventTypes = [
-        PikkuEventTypes.http,
-        PikkuEventTypes.channel,
-        PikkuEventTypes.queue,
-        PikkuEventTypes.scheduler,
-        PikkuEventTypes.rpc,
-        PikkuEventTypes.mcp,
+        PikkuWiringTypes.http,
+        PikkuWiringTypes.channel,
+        PikkuWiringTypes.queue,
+        PikkuWiringTypes.scheduler,
+        PikkuWiringTypes.rpc,
+        PikkuWiringTypes.mcp,
       ]
 
       eventTypes.forEach((eventType) => {
@@ -175,7 +175,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -194,7 +194,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/public/routes.ts',
         },
@@ -213,7 +213,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: 'C:\\project\\src\\api\\routes.ts',
         },
@@ -232,7 +232,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: 'C:\\project\\src\\api\\routes.ts',
         },
@@ -250,7 +250,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: 'test-route' }, // no filePath
+        { type: PikkuWiringTypes.http, name: 'test-route' }, // no filePath
         mockLogger
       )
 
@@ -266,7 +266,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/v1/routes.ts',
         },
@@ -289,7 +289,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['api', 'public'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -310,7 +310,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['api', 'public'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -331,7 +331,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['api', 'public'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -352,7 +352,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['api', 'public'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -372,7 +372,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: undefined },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -387,7 +387,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.http, name: '' },
+        { type: PikkuWiringTypes.http, name: '' },
         mockLogger
       )
 
@@ -403,7 +403,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api-v2/routes.ts',
         },
@@ -422,7 +422,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/api/routes.ts',
         },
@@ -440,7 +440,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['api', 'public', 'v1'] },
-        { type: PikkuEventTypes.http, name: 'test-route' },
+        { type: PikkuWiringTypes.http, name: 'test-route' },
         mockLogger
       )
 
@@ -455,7 +455,7 @@ describe('matchesFilters', () => {
       const result = matchesFilters(
         filters,
         { tags: ['test'] },
-        { type: PikkuEventTypes.channel, name: 'test-channel' },
+        { type: PikkuWiringTypes.channel, name: 'test-channel' },
         mockLogger
       )
 
@@ -471,7 +471,7 @@ describe('matchesFilters', () => {
         filters,
         { tags: ['test'] },
         {
-          type: PikkuEventTypes.http,
+          type: PikkuWiringTypes.http,
           name: 'test-route',
           filePath: '/project/src/internal/routes.ts',
         },

package/src/utils.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
@@ -271,7 +271,7 @@ export function extractFunctionName(
     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) &&
@@ -845,7 +845,7 @@ export const matchesFilters = (
   filters: InspectorFilters,
   params: { tags?: string[] },
   meta: {
-    type: PikkuEventTypes
+    type: PikkuWiringTypes
     name: string
     filePath?: string
   },