v1.2.0 — TypeScript Port

What's New

GoldenFlow is now available in TypeScript with full feature parity to the Python library.

TypeScript Port (packages/goldenflow-js)

npm install goldenflow
npx goldenflow-js transform data.csv

import { TransformEngine } from "goldenflow";

const result = new TransformEngine().transformDf([
  { name: "  JOHN  ", phone: "(555) 123-4567", email: "John@Example.COM" },
]);

Highlights:

• 83 transforms across 11 categories (text, phone, names, address, dates, email, numeric, categorical, identifiers, URL, auto-correct)
• Edge-safe core — runs in browsers, Cloudflare Workers, Vercel Edge Runtime (import from "goldenflow/core")
• Node layer — CLI (12 commands), CSV/JSON connectors, MCP server (10 tools), REST API, directory watcher, scheduler
• 5 domain packs — people_hr, healthcare, finance, ecommerce, real_estate
• LLM-enhanced corrections — edge-safe via raw fetch() to Anthropic/OpenAI APIs
• 71 tests — smoke, parity, CSV parser, engine error handling, transform correctness
• Dual ESM + CJS build with TypeScript declarations
• Zero type errors with strict TypeScript (noUncheckedIndexedAccess, exactOptionalPropertyTypes)

Security Fixes (TS)

• Path traversal prevention in REST API and MCP server
• LLM corrector validates JSON responses and logs errors
• Config loader throws on invalid YAML (no silent defaults)

Architecture

• goldenflow/core — edge-safe (no Node APIs)
• goldenflow/node — Node 20+ (file I/O, MCP, CLI)
• Same YAML config format as Python
• Same transform names, same behavior

New CI

• TypeScript typecheck + test + build in GitHub Actions
• npm publish workflow on goldenflow-js-v* tags

Examples

• 6 TypeScript examples: zero-config, configured, schema-mapping, streaming, profiling, edge-safe

Full Changelog: v1.1.2...v1.2.0