@pikku/inspector 0.6.4 → 0.7.0

package/src/get-property-value.ts

@@ -1,84 +0,0 @@
-import { APIDocs } from '@pikku/core'
-import * as ts from 'typescript'
-
-export const getPropertyValue = (
-  obj: ts.ObjectLiteralExpression,
-  propertyName: string
-): string | string[] | null | APIDocs => {
-  const property = obj.properties.find(
-    (p) =>
-      ts.isPropertyAssignment(p) &&
-      ts.isIdentifier(p.name) &&
-      p.name.text === propertyName
-  )
-
-  if (property && ts.isPropertyAssignment(property)) {
-    const initializer = property.initializer
-
-    // Special handling for 'query' -> expect an array of strings
-    if (
-      ['query', 'tags'].includes(propertyName) &&
-      ts.isArrayLiteralExpression(initializer)
-    ) {
-      const stringArray = initializer.elements
-        .map((element) => {
-          if (ts.isStringLiteral(element)) {
-            return element.text
-          }
-          return null
-        })
-        .filter((item) => item !== null) as string[] // Filter non-null and assert type
-
-      return stringArray.length > 0 ? stringArray : null
-    }
-
-    // Special handling for 'docs' -> expect RouteDocs
-    if (propertyName === 'docs' && ts.isObjectLiteralExpression(initializer)) {
-      const docs: APIDocs = {}
-
-      initializer.properties.forEach((prop) => {
-        if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
-          const propName = prop.name.text
-
-          if (propName === 'summary' && ts.isStringLiteral(prop.initializer)) {
-            docs.summary = prop.initializer.text
-          } else if (
-            propName === 'description' &&
-            ts.isStringLiteral(prop.initializer)
-          ) {
-            docs.description = prop.initializer.text
-          } else if (
-            propName === 'tags' &&
-            ts.isArrayLiteralExpression(prop.initializer)
-          ) {
-            docs.tags = prop.initializer.elements
-              .filter(ts.isStringLiteral)
-              .map((element) => element.text)
-          } else if (
-            propName === 'errors' &&
-            ts.isArrayLiteralExpression(prop.initializer)
-          ) {
-            docs.errors = prop.initializer.elements
-              .filter(ts.isIdentifier)
-              .map((element) => element.text as unknown as string)
-          }
-        }
-      })
-
-      return docs
-    }
-
-    // Handle string literals for other properties
-    if (
-      ts.isStringLiteral(initializer) ||
-      ts.isNoSubstitutionTemplateLiteral(initializer)
-    ) {
-      return initializer.text
-    } else {
-      // Handle other initializer types if necessary
-      return initializer.getText()
-    }
-  }
-
-  return null
-}

package/src/index.ts

@@ -1,4 +0,0 @@
-export { inspect } from './inspector.js'
-export type { TypesMap } from './types-map.js'
-export type * from './types.js'
-export type { InspectorState } from './types.js'

package/src/inspector.ts

@@ -1,63 +0,0 @@
-import * as ts from 'typescript'
-import { visit } from './visit.js'
-import { TypesMap } from './types-map.js'
-import {
-  InspectorState,
-  InspectorHTTPState,
-  InspectorFilters,
-} from './types.js'
-
-export const normalizeHTTPTypes = (
-  httpState: InspectorHTTPState
-): InspectorHTTPState => {
-  return httpState
-}
-
-export const inspect = (
-  routeFiles: string[],
-  filters: InspectorFilters
-): InspectorState => {
-  const program = ts.createProgram(routeFiles, {
-    target: ts.ScriptTarget.ESNext,
-    module: ts.ModuleKind.CommonJS,
-  })
-  const checker = program.getTypeChecker()
-  const sourceFiles = program.getSourceFiles()
-
-  const state: InspectorState = {
-    singletonServicesTypeImportMap: new Map(),
-    sessionServicesTypeImportMap: new Map(),
-    userSessionTypeImportMap: new Map(),
-    singletonServicesFactories: new Map(),
-    sessionServicesFactories: new Map(),
-    configFactories: new Map(),
-    http: {
-      typesMap: new TypesMap(),
-      metaInputTypes: new Map(),
-      meta: [],
-      files: new Set(),
-    },
-    channels: {
-      typesMap: new TypesMap(),
-      metaInputTypes: new Map(),
-      files: new Set(),
-      meta: [],
-    },
-    scheduledTasks: {
-      meta: [],
-      files: new Set(),
-    },
-  }
-
-  for (const sourceFile of sourceFiles) {
-    ts.forEachChild(sourceFile, (child) =>
-      visit(checker, child, state, filters)
-    )
-  }
-
-  // Normalise the typesMap
-
-  state.http = normalizeHTTPTypes(state.http)
-
-  return state
-}

package/src/types-map.ts

@@ -1,130 +0,0 @@
-export class TypesMap {
-  private map: Map<string, { originalName: string; path: string | null }> =
-    new Map()
-  public customTypes: Map<string, { type: string; references: string[] }> =
-    new Map()
-
-  public addCustomType(name: string, type: string, references: string[]) {
-    this.customTypes.set(name, { type, references })
-  }
-
-  public addType(originalName: string, path: string) {
-    this.map.set(originalName, { originalName, path })
-  }
-
-  public addUniqueType(originalName: string, path: string): string {
-    const uniqueName = `${originalName}_${Math.random().toString(36).substring(7)}`
-    this.map.set(uniqueName, { originalName, path })
-    return uniqueName
-  }
-
-  public getUniqueName(name: string): string {
-    const meta = this.getTypeMeta(name)
-    return meta.uniqueName
-  }
-
-  public getTypeMeta(name: string): {
-    originalName: string
-    uniqueName: string
-    path: string | null
-  } {
-    if (['string', 'number', 'boolean', 'null'].includes(name)) {
-      return {
-        originalName: name,
-        uniqueName: name,
-        path: null,
-      }
-    }
-
-    if (this.customTypes.has(name)) {
-      return {
-        originalName: name,
-        uniqueName: name,
-        path: null,
-      }
-    }
-
-    let meta = this.map.get(name)
-    if (!meta) {
-      meta = Array.from(this.map.entries()).find(
-        ([_, { originalName }]) => originalName === name
-      )?.[1]
-    }
-    if (!meta) {
-      throw new Error(`Type ${name} not found in typesMap`)
-    }
-
-    const getName = this.squash()
-    return {
-      uniqueName: getName(name),
-      originalName: meta.originalName,
-      path: meta?.path,
-    }
-  }
-
-  public exists(originalName: string, path: string): string | undefined {
-    const found = Array.from(this.map.entries()).find(([_, type]) => {
-      return type.path === path && type.originalName === originalName
-    })
-    return found ? found[0] : undefined
-  }
-
-  private squash() {
-    const duplicateNames = new Set<string>()
-    const pathToNamesMap = new Map<string, Map<string, string>>()
-    const nameOccurrences = new Map<string, Set<string>>()
-
-    // First pass: Track occurrences of each original name across paths
-    this.map.forEach(({ path, originalName }) => {
-      if (path) {
-        if (!nameOccurrences.has(originalName)) {
-          nameOccurrences.set(originalName, new Set())
-        }
-        nameOccurrences.get(originalName)!.add(path)
-      }
-    })
-
-    // Second pass: Populate pathToNamesMap
-    this.map.forEach(({ path, originalName }, uniqueName) => {
-      if (!path) return
-
-      if (!pathToNamesMap.has(path)) {
-        pathToNamesMap.set(path, new Map())
-      }
-
-      const isDuplicate = nameOccurrences.get(originalName)!.size > 1
-      if (isDuplicate) {
-        duplicateNames.add(uniqueName)
-      }
-      // Use uniqueName only if the originalName is duplicated across files
-      const nameToUse = isDuplicate ? uniqueName : originalName
-      pathToNamesMap.get(path)!.set(nameToUse, originalName)
-    })
-
-    const getName = (uniqueName: string) => {
-      if (duplicateNames.has(uniqueName)) {
-        return uniqueName
-      }
-      if (
-        uniqueName === 'string' ||
-        uniqueName === 'number' ||
-        uniqueName === 'boolean' ||
-        uniqueName === 'null'
-      ) {
-        return uniqueName
-      }
-      if (!this.map.has(uniqueName)) {
-        const found = Array.from(this.map.entries()).find(
-          ([_, { originalName }]) => originalName === uniqueName
-        )?.[1]
-        if (!found) {
-          throw new Error(`Type ${uniqueName} not found in typesMap`)
-        }
-        return found.originalName
-      }
-      return this.map.get(uniqueName)!.originalName
-    }
-
-    return getName
-  }
-}

package/src/types.ts

@@ -1,62 +0,0 @@
-import { ChannelsMeta } from '@pikku/core/channel'
-import { HTTPRoutesMeta } from '@pikku/core/http'
-import { ScheduledTasksMeta } from '@pikku/core/scheduler'
-import { TypesMap } from './types-map.js'
-
-export type PathToNameAndType = Map<
-  string,
-  { variable: string; type: string | null; typePath: string | null }[]
->
-
-export type MetaInputTypes = Map<
-  string,
-  {
-    query: string[] | undefined
-    params: string[] | undefined
-    body: string[] | undefined
-  }
->
-
-export type APIFunctionMeta = Array<{
-  name: string
-  input: string
-  output: string
-  file: string
-}>
-
-export type InspectorAPIFunction = {
-  typesMap: TypesMap
-  meta: APIFunctionMeta
-}
-
-export interface InspectorHTTPState {
-  typesMap: TypesMap
-  metaInputTypes: MetaInputTypes
-  meta: HTTPRoutesMeta
-  files: Set<string>
-}
-
-export interface InspectorChannelState {
-  typesMap: TypesMap
-  metaInputTypes: MetaInputTypes
-  meta: ChannelsMeta
-  files: Set<string>
-}
-
-export type InspectorFilters = {
-  tags?: string[]
-}
-export interface InspectorState {
-  singletonServicesTypeImportMap: PathToNameAndType
-  sessionServicesTypeImportMap: PathToNameAndType
-  userSessionTypeImportMap: PathToNameAndType
-  singletonServicesFactories: PathToNameAndType
-  sessionServicesFactories: PathToNameAndType
-  configFactories: PathToNameAndType
-  http: InspectorHTTPState
-  channels: InspectorChannelState
-  scheduledTasks: {
-    meta: ScheduledTasksMeta
-    files: Set<string>
-  }
-}

package/src/utils.ts

@@ -1,371 +0,0 @@
-import * as ts from 'typescript'
-import { TypesMap } from './types-map.js'
-import { InspectorFilters } from './types.js'
-
-type FunctionTypes = {
-  type: string | null
-  inputTypes: ts.Type[]
-  inputs: null | string[]
-  outputTypes: ts.Type[]
-  outputs: null | string[]
-}
-
-export const extractTypeKeys = (type: ts.Type): string[] => {
-  return type.getProperties().map((symbol) => symbol.getName())
-}
-
-export const nullifyTypes = (type: string | null) => {
-  if (
-    type === 'void' ||
-    type === 'undefined' ||
-    type === 'unknown' ||
-    type === 'any'
-  ) {
-    return null
-  }
-  return type
-}
-
-const isValidVariableName = (name: string) => {
-  const regex = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/
-  return regex.test(name)
-}
-
-export const getNamesAndTypes = (
-  checker: ts.TypeChecker,
-  typesMap: TypesMap,
-  direction: 'Input' | 'Output',
-  funcName: string,
-  type: ts.Type
-) => {
-  const result: {
-    names: Set<string>
-    types: ts.Type[]
-  } = {
-    names: new Set(),
-    types: [],
-  }
-
-  const { names, types } = resolveUnionTypes(checker, type)
-  const firstName = names[0]
-  if (names.length > 1 || (firstName && !isValidVariableName(firstName))) {
-    const aliasType = names.join(' | ')
-    const aliasName = `${funcName.charAt(0).toUpperCase()}${funcName.slice(1)}${direction}`
-
-    result.names = new Set([aliasName])
-    result.types = types
-
-    const references = types
-      .map((t) => resolveTypeImports(t, typesMap, true))
-      .flat()
-    typesMap.addCustomType(aliasName, aliasType, references)
-  } else {
-    const uniqueNames = names
-      .map((name, i) => {
-        const type = types[i]
-        if (!type) {
-          throw new Error('TODO: Expected a type here to match name')
-        }
-        if (isPrimitiveType(type)) {
-          return name
-        }
-        return resolveTypeImports(type, typesMap, false)
-      })
-      .flat()
-    result.names = new Set(uniqueNames)
-    result.types = types
-  }
-
-  return {
-    names: Array.from(result.names),
-    types: result.types,
-  }
-}
-
-export const isPrimitiveType = (type: ts.Type): boolean => {
-  const primitiveFlags =
-    ts.TypeFlags.Number |
-    ts.TypeFlags.String |
-    ts.TypeFlags.Boolean |
-    ts.TypeFlags.BigInt |
-    ts.TypeFlags.ESSymbol |
-    ts.TypeFlags.Void |
-    ts.TypeFlags.Undefined |
-    ts.TypeFlags.Null |
-    ts.TypeFlags.Any |
-    ts.TypeFlags.Unknown
-
-  return (type.flags & primitiveFlags) !== 0
-}
-
-export const resolveUnionTypes = (
-  checker: ts.TypeChecker,
-  type: ts.Type
-): { types: ts.Type[]; names: string[] } => {
-  const types: ts.Type[] = []
-  const names: string[] = []
-
-  // Check if it's a union type AND not part of an intersection
-  if (type.isUnion() && !(type.flags & ts.TypeFlags.Intersection)) {
-    for (const t of type.types) {
-      const name = nullifyTypes(checker.typeToString(t))
-      if (name) {
-        types.push(t)
-        names.push(name)
-      }
-    }
-  } else {
-    const name = nullifyTypes(checker.typeToString(type))
-    if (name) {
-      types.push(type)
-      names.push(name)
-    }
-  }
-
-  return { types, names }
-}
-
-export const resolveTypeImports = (
-  type: ts.Type,
-  resolvedTypes: TypesMap,
-  isCustom: boolean
-): string[] => {
-  const types: string[] = []
-
-  const visitType = (currentType: ts.Type) => {
-    const symbol = currentType.aliasSymbol || currentType.getSymbol()
-
-    if (symbol) {
-      const declarations = symbol.getDeclarations()
-      const declaration = declarations?.[0]
-      if (declaration) {
-        const sourceFile = declaration.getSourceFile()
-        const path = sourceFile.fileName
-
-        // Skip built-in utility types or TypeScript lib types
-        if (
-          !path.includes('node_modules/typescript') &&
-          symbol.getName() !== '__type' &&
-          !isPrimitiveType(currentType)
-        ) {
-          const originalName = symbol.getName()
-          // Check if the type is already in the map
-          let uniqueName = resolvedTypes.exists(originalName, path)
-          if (!uniqueName) {
-            if (isCustom) {
-              uniqueName = resolvedTypes.addUniqueType(originalName, path)
-            } else {
-              resolvedTypes.addType(originalName, path)
-              uniqueName = originalName
-            }
-          }
-          types.push(uniqueName)
-        }
-      }
-    }
-
-    if (isCustom) {
-      // Handle nested utility types like Partial, Pick, etc.
-      if (currentType.aliasTypeArguments) {
-        currentType.aliasTypeArguments.forEach(visitType)
-      }
-
-      // Handle intersections and unions
-      if (currentType.isUnionOrIntersection()) {
-        currentType.types.forEach(visitType)
-      }
-
-      // Handle object types with type arguments
-      if (
-        currentType.flags & ts.TypeFlags.Object &&
-        (currentType as ts.ObjectType).objectFlags & ts.ObjectFlags.Reference
-      ) {
-        const typeRef = currentType as ts.TypeReference
-        typeRef.typeArguments?.forEach(visitType)
-      }
-    }
-  }
-
-  visitType(type)
-  return types
-}
-
-export const getPropertyAssignment = (
-  obj: ts.ObjectLiteralExpression,
-  name: string
-) => {
-  const property = obj.properties.find(
-    (p) =>
-      (ts.isPropertyAssignment(p) || ts.isShorthandPropertyAssignment(p)) &&
-      ts.isIdentifier(p.name) &&
-      p.name.text === name
-  )
-  if (!property) {
-    console.error(`Missing property '${name}' in object`)
-    return null
-  }
-  return property
-}
-
-export const getTypeArgumentsOfType = (
-  checker: ts.TypeChecker,
-  type: ts.Type
-): readonly ts.Type[] | null => {
-  if (type.isUnionOrIntersection()) {
-    const types: ts.Type[] = []
-    for (const subType of type.types) {
-      const subTypeArgs = getTypeArgumentsOfType(checker, subType)
-      if (subTypeArgs) {
-        types.push(...subTypeArgs)
-      }
-    }
-    return types.length > 0 ? types : null
-  }
-
-  // If the type is a TypeReference with typeArguments, return them
-  if (
-    type.flags & ts.TypeFlags.Object &&
-    (type as ts.ObjectType).objectFlags & ts.ObjectFlags.Reference
-  ) {
-    const typeRef = type as ts.TypeReference
-    if (typeRef.typeArguments && typeRef.typeArguments.length > 0) {
-      return typeRef.typeArguments
-    }
-  }
-
-  // If the type is an alias with aliasTypeArguments, return them
-  if (type.aliasTypeArguments && type.aliasTypeArguments.length > 0) {
-    return type.aliasTypeArguments as ts.Type[]
-  }
-
-  return null
-}
-
-export const getFunctionTypes = (
-  checker: ts.TypeChecker,
-  obj: ts.ObjectLiteralExpression,
-  {
-    typesMap,
-    funcName,
-    subFunctionName = funcName,
-    inputIndex,
-    outputIndex,
-  }: {
-    typesMap: TypesMap
-    subFunctionName?: string
-    funcName: string
-    inputIndex: number
-    outputIndex: number
-  }
-): FunctionTypes => {
-  const result: FunctionTypes = {
-    inputTypes: [],
-    inputs: null,
-    outputTypes: [],
-    outputs: null,
-    type: null,
-  }
-
-  const property = getPropertyAssignment(obj, subFunctionName)
-  if (!property) {
-    return result
-  }
-
-  let type: ts.Type | undefined
-
-  // Handle shorthand property assignment
-  if (ts.isShorthandPropertyAssignment(property)) {
-    const symbol = checker.getShorthandAssignmentValueSymbol(property)
-    if (symbol) {
-      type = checker.getTypeOfSymbolAtLocation(symbol, property)
-      if (funcName === 'func') {
-        funcName = symbol.name
-      }
-    }
-  }
-  // Handle regular property assignment
-  else if (ts.isPropertyAssignment(property)) {
-    if (ts.isObjectLiteralExpression(property.initializer)) {
-      return getFunctionTypes(checker, property.initializer, {
-        typesMap,
-        funcName,
-        subFunctionName: 'func',
-        inputIndex,
-        outputIndex,
-      })
-    }
-
-    if (property.initializer) {
-      type = checker.getTypeAtLocation(property.initializer)
-      if (funcName === 'func') {
-        funcName = property.initializer.getText()
-      }
-    }
-  }
-
-  if (!type) {
-    console.error(`Unable to resolve type for property '${funcName}'`)
-    return result
-  }
-
-  result.type = type.aliasSymbol?.getEscapedName() || null
-
-  // Access type arguments from TypeReference
-  const typeArguments = getTypeArgumentsOfType(checker, type)
-
-  if (!typeArguments || typeArguments.length === 0) {
-    // This is the case for inline functions. In this case we would want to
-    // get the types from the second argument of the function...
-    console.error(
-      `\x1b[31m• No generic type arguments found for ${funcName}. Support for inline functions is not yet implemented.\x1b[0m`
-    )
-    return result
-  }
-
-  if (inputIndex !== undefined && inputIndex < typeArguments.length) {
-    const { names, types } = getNamesAndTypes(
-      checker,
-      typesMap,
-      'Input',
-      funcName,
-      typeArguments[inputIndex]!
-    )
-    result.inputs = names
-    result.inputTypes = types
-  } else {
-    console.log(`No input defined for ${funcName}`)
-  }
-
-  if (outputIndex !== undefined && outputIndex < typeArguments.length) {
-    const { names, types } = getNamesAndTypes(
-      checker,
-      typesMap,
-      'Output',
-      funcName,
-      typeArguments[outputIndex]!
-    )
-    result.outputs = names
-    result.outputTypes = types
-  } else {
-    console.info(`No output defined for ${funcName}`)
-  }
-
-  return result
-}
-
-export const matchesFilters = (
-  filters: InspectorFilters,
-  params: { tags?: string[] },
-  meta: { type: 'schedule' | 'http' | 'channel'; name: string }
-) => {
-  if (Object.keys(filters).length === 0 || filters.tags?.length === 0) {
-    return true
-  }
-
-  if (filters.tags?.some((tag) => params.tags?.includes(tag))) {
-    return true
-  }
-
-  console.debug(`⒡ Filtered: ${meta.type}:${meta.name}`)
-  return false
-}