@happyvertical/smrt-scanner

High-performance TypeScript AST scanner using OXC for s-m-r-t 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 s-m-r-t manifest format

Functions

Export	Description
parseFile	Parse a single TypeScript file and extract metadata
parseSource	Parse a TypeScript source string
extractSmrtImports	Extract s-m-r-t-related imports from a file

Key Types

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

Dependencies

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