@happyvertical/smrt-scanner

High-performance TypeScript AST scanner using OXC for SMRT manifest generation. Extracts class, field, method, and decorator metadata from source files without executing them.

Installation

pnpm add @happyvertical/smrt-scanner

Usage

import { OxcScanner, InheritanceResolver, ManifestAdapter } from '@happyvertical/smrt-scanner';
import { parseFile, parseSource, extractSmrtImports } from '@happyvertical/smrt-scanner';

// Scan a single file
const result = parseFile('/path/to/Product.ts');
// result.classes → RawClassDefinition[]
// result.smrtImports → Map of SMRT package imports

// Scan from source string
const source = `
  @smrt({ api: true })
  class Product extends SmrtObject {
    name: string = '';
    price: number = 0.0;
  }
`;
const parsed = parseSource(source, 'Product.ts');

// Full scanner with glob support
const scanner = new OxcScanner({ include: ['src/**/*.ts'] });
const results = await scanner.scan();

// Resolve inheritance across files
const resolver = new InheritanceResolver();
resolver.addClasses(results.classes);
const resolved = resolver.resolveAll();

// Convert to SMRT manifest format
const adapter = new ManifestAdapter();
const manifest = adapter.toManifest(resolved);

CLI

# Scan and output manifest
smrt-scan src/**/*.ts

API

Classes

| Export | Description | |--------|------------| | OxcScanner | Scans TypeScript files for @smrt() decorated classes | | InheritanceResolver | Resolves class inheritance chains across files | | ManifestAdapter | Converts raw scan results to SMRT manifest format |

Functions

| Export | Description | |--------|------------| | parseFile | Parse a single TypeScript file and extract metadata | | parseSource | Parse a TypeScript source string | | extractSmrtImports | Extract SMRT-related imports from a file |

Key Types

RawClassDefinition, RawFieldDefinition, RawMethodDefinition, RawDecoratorConfig, ResolvedClassDefinition, ScanResults, FileScanResult, OxcScannerOptions, InferredFieldType, FieldTypeInference

Dependencies

• Peer (optional): @happyvertical/smrt-core