@teliagen/build

Build tooling for Teliagen applications.

Overview

@teliagen/build provides build utilities for Teliagen applications:

• TypeScript Compilation – Incremental TypeScript builds
• Watch Mode – File watching with debouncing
• Metadata Generation – Action metadata for federation
• Bundle Optimization – Production bundle optimizations
• Multi-App Support – Build multiple apps in monorepo

Installation

npm install -D @teliagen/build
# or
pnpm add -D @teliagen/build

Usage

This package is primarily used internally by @teliagen/cli.

Programmatic API

import { TeliagenBuild } from '@teliagen/build';

const builder = new TeliagenBuild({
  projectRoot: process.cwd(),
  mode: 'production',
  optimize: true
});

// Build once
await builder.build();

// Build with watch
await builder.watch();

// Generate metadata only
await builder.generateMetadata();

Configuration

interface BuildOptions {
  projectRoot: string;           // Project root directory
  mode?: 'development' | 'production';
  
  // TypeScript
  tsconfig?: string;             // tsconfig.json path
  outDir?: string;               // Output directory
  
  // Features
  optimize?: boolean;            // Enable optimizations
  sourceMaps?: boolean;          // Generate source maps
  generateMetadata?: boolean;    // Generate action metadata
  
  // Watch
  watchDebounce?: number;        // Watch debounce (ms)
}

Build Phases

1. Clean – Remove previous build artifacts
2. Compile – TypeScript to JavaScript
3. Generate – Metadata and federation proxies
4. Optimize – Minification, tree-shaking (if enabled)
5. Output – Write to dist/

Output Structure

dist/
├── server/
│   ├── main.js
│   ├── entities/
│   ├── modules/
│   └── plugins/
├── .teliagen/
│   ├── metadata.json
│   └── proxies/
└── index.js

Requirements

• Node.js >= 18.0.0
• TypeScript >= 5.0.0

Documentation

For full documentation, visit docs.teliagen.org.

License

Apache-2.0