@typokit/transform-native 0.1.4

package/dist/index.d.ts

@@ -0,0 +1,148 @@
+import type { SchemaTypeMap } from "@typokit/types";
+interface JsPropertyMetadata {
+    type: string;
+    optional: boolean;
+}
+interface JsSchemaChange {
+    type: string;
+    entity: string;
+    field?: string;
+    details?: Record<string, string>;
+}
+interface JsMigrationDraft {
+    name: string;
+    sql: string;
+    destructive: boolean;
+    changes: JsSchemaChange[];
+}
+interface JsTypeValidatorInput {
+    name: string;
+    properties: Record<string, JsPropertyMetadata>;
+}
+/** Options for the output pipeline */
+export interface PipelineOptions {
+    /** Paths to TypeScript files containing type definitions */
+    typeFiles: string[];
+    /** Paths to TypeScript files containing route contracts */
+    routeFiles: string[];
+    /** Output directory (defaults to ".typokit") */
+    outputDir?: string;
+    /** Optional validator callback — receives type inputs, returns [name, code] pairs */
+    validatorCallback?: (inputs: JsTypeValidatorInput[]) => Promise<[string, string][]> | [string, string][];
+    /** Path to cache hash file (defaults to ".typokit/.cache-hash") */
+    cacheFile?: string;
+}
+/** Result of a full pipeline run */
+export interface PipelineOutput {
+    /** Whether outputs were regenerated (false = cache hit) */
+    regenerated: boolean;
+    /** Content hash of source files */
+    contentHash: string;
+    /** Extracted type metadata */
+    types: SchemaTypeMap;
+    /** Files written to outputDir */
+    filesWritten: string[];
+}
+/**
+ * Parse TypeScript source files and extract type metadata.
+ *
+ * Uses the Rust-native SWC parser for high-performance AST parsing and
+ * type extraction. Extracts interface definitions including JSDoc tags
+ * (@table, @id, @generated, @format, @unique, @minLength, @maxLength,
+ * @default, @onUpdate).
+ *
+ * @param filePaths - Array of file paths to parse
+ * @returns SchemaTypeMap mapping type names to their metadata
+ */
+export declare function parseAndExtractTypes(filePaths: string[]): Promise<SchemaTypeMap>;
+/**
+ * Compile route contracts from TypeScript files into a radix tree.
+ *
+ * Parses interfaces with route contract keys (e.g., "GET /users") and
+ * builds a compiled radix tree serialized as TypeScript source code.
+ *
+ * @param filePaths - Array of file paths containing route contract interfaces
+ * @returns TypeScript source code for the compiled route table
+ */
+export declare function compileRoutes(filePaths: string[]): Promise<string>;
+/**
+ * Generate an OpenAPI 3.1.0 specification from route contracts and type definitions.
+ *
+ * @param routeFilePaths - Array of file paths containing route contract interfaces
+ * @param typeFilePaths - Array of file paths containing type definitions
+ * @returns OpenAPI 3.1.0 specification as a JSON string
+ */
+export declare function generateOpenApi(routeFilePaths: string[], typeFilePaths: string[]): Promise<string>;
+/**
+ * Diff two schema versions and produce a migration draft.
+ *
+ * Compares old types against new types to detect added, removed, and
+ * modified entities and fields. Generates SQL DDL stubs for the changes.
+ *
+ * @param oldTypes - Previous schema version
+ * @param newTypes - New schema version
+ * @param migrationName - Name for the migration draft
+ * @returns MigrationDraft with SQL, changes, and destructive flag
+ */
+export declare function diffSchemas(oldTypes: SchemaTypeMap, newTypes: SchemaTypeMap, migrationName: string): Promise<JsMigrationDraft>;
+/**
+ * Generate contract test scaffolding from route contract files.
+ *
+ * Parses route contracts and generates TypeScript test stubs with
+ * describe/it blocks for each route.
+ *
+ * @param filePaths - Array of file paths containing route contract interfaces
+ * @returns TypeScript test code string
+ */
+export declare function generateTestStubs(filePaths: string[]): Promise<string>;
+/**
+ * Prepare type metadata for Typia validator generation.
+ *
+ * Converts parsed type metadata into a format suitable for passing
+ * to the @typokit/transform-typia bridge callback.
+ *
+ * @param typeFilePaths - Array of file paths containing type definitions
+ * @returns Array of type validator inputs
+ */
+export declare function prepareValidatorInputs(typeFilePaths: string[]): Promise<JsTypeValidatorInput[]>;
+/**
+ * Collect validator code results into a file path map.
+ *
+ * Maps type names and their generated code to output file paths
+ * under .typokit/validators/.
+ *
+ * @param results - Array of [typeName, code] pairs
+ * @returns Map of file paths to validator code
+ */
+export declare function collectValidatorOutputs(results: [string, string][]): Promise<Record<string, string>>;
+/**
+ * Compute a SHA-256 content hash of source files.
+ *
+ * Used for cache invalidation: if the hash matches a previous build,
+ * outputs can be reused without regeneration.
+ *
+ * @param filePaths - Array of file paths to hash
+ * @returns Hex-encoded SHA-256 hash string
+ */
+export declare function computeContentHash(filePaths: string[]): Promise<string>;
+/**
+ * Run the full output pipeline with content-hash caching.
+ *
+ * Orchestrates all transform steps: parse types, compile routes, generate
+ * OpenAPI spec, generate test stubs, and prepare validator inputs. Writes
+ * all outputs to the `.typokit/` directory structure:
+ *
+ * - `.typokit/routes/compiled-router.ts` — Compiled radix tree
+ * - `.typokit/schemas/openapi.json` — OpenAPI 3.1.0 spec
+ * - `.typokit/tests/contract.test.ts` — Contract test stubs
+ * - `.typokit/validators/*.ts` — Typia validators (if callback provided)
+ *
+ * Content-hash caching: If the hash of all source files matches the cached
+ * hash, no outputs are regenerated. Force a rebuild by deleting `.typokit/.cache-hash`.
+ *
+ * @param options - Pipeline configuration
+ * @returns Pipeline output with metadata about what was generated
+ */
+export declare function buildPipeline(options: PipelineOptions): Promise<PipelineOutput>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,290 @@
+// Load the platform-specific native addon
+async function loadNativeAddon() {
+    const g = globalThis;
+    const proc = g["process"];
+    const platform = proc?.platform ?? "unknown";
+    const arch = proc?.arch ?? "unknown";
+    const triples = {
+        win32: { x64: "win32-x64-msvc" },
+        darwin: { x64: "darwin-x64", arm64: "darwin-arm64" },
+        linux: { x64: "linux-x64-gnu", arm64: "linux-arm64-gnu" },
+    };
+    const triple = triples[platform]?.[arch];
+    if (!triple) {
+        throw new Error(`@typokit/transform-native: unsupported platform ${platform}-${arch}`);
+    }
+    // In ESM, require() is not global. Use createRequire from 'module' built-in.
+    const { createRequire } = (await import(/* @vite-ignore */ "module"));
+    const req = createRequire(import.meta.url);
+    // Try loading the platform-specific native addon
+    try {
+        return req(`../index.${triple}.node`);
+    }
+    catch {
+        try {
+            return req(`@typokit/transform-native-${triple}`);
+        }
+        catch {
+            throw new Error(`@typokit/transform-native: failed to load native addon for ${triple}. ` +
+                `Make sure the native addon is built.`);
+        }
+    }
+}
+let _native;
+let _loading;
+async function getNative() {
+    if (_native)
+        return _native;
+    if (!_loading) {
+        _loading = loadNativeAddon().then((n) => {
+            _native = n;
+            return n;
+        });
+    }
+    return _loading;
+}
+/**
+ * Parse TypeScript source files and extract type metadata.
+ *
+ * Uses the Rust-native SWC parser for high-performance AST parsing and
+ * type extraction. Extracts interface definitions including JSDoc tags
+ * (@table, @id, @generated, @format, @unique, @minLength, @maxLength,
+ * @default, @onUpdate).
+ *
+ * @param filePaths - Array of file paths to parse
+ * @returns SchemaTypeMap mapping type names to their metadata
+ */
+export async function parseAndExtractTypes(filePaths) {
+    const native = await getNative();
+    const raw = native.parseAndExtractTypes(filePaths);
+    // Convert JsTypeMetadata to TypeMetadata (compatible shape)
+    const result = {};
+    for (const [name, meta] of Object.entries(raw)) {
+        result[name] = {
+            name: meta.name,
+            properties: {},
+        };
+        for (const [propName, prop] of Object.entries(meta.properties)) {
+            result[name].properties[propName] = {
+                type: prop.type,
+                optional: prop.optional,
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Compile route contracts from TypeScript files into a radix tree.
+ *
+ * Parses interfaces with route contract keys (e.g., "GET /users") and
+ * builds a compiled radix tree serialized as TypeScript source code.
+ *
+ * @param filePaths - Array of file paths containing route contract interfaces
+ * @returns TypeScript source code for the compiled route table
+ */
+export async function compileRoutes(filePaths) {
+    const native = await getNative();
+    return native.compileRoutes(filePaths);
+}
+/**
+ * Generate an OpenAPI 3.1.0 specification from route contracts and type definitions.
+ *
+ * @param routeFilePaths - Array of file paths containing route contract interfaces
+ * @param typeFilePaths - Array of file paths containing type definitions
+ * @returns OpenAPI 3.1.0 specification as a JSON string
+ */
+export async function generateOpenApi(routeFilePaths, typeFilePaths) {
+    const native = await getNative();
+    return native.generateOpenApi(routeFilePaths, typeFilePaths);
+}
+/**
+ * Diff two schema versions and produce a migration draft.
+ *
+ * Compares old types against new types to detect added, removed, and
+ * modified entities and fields. Generates SQL DDL stubs for the changes.
+ *
+ * @param oldTypes - Previous schema version
+ * @param newTypes - New schema version
+ * @param migrationName - Name for the migration draft
+ * @returns MigrationDraft with SQL, changes, and destructive flag
+ */
+export async function diffSchemas(oldTypes, newTypes, migrationName) {
+    const native = await getNative();
+    const oldJs = schemaTypeMapToJs(oldTypes);
+    const newJs = schemaTypeMapToJs(newTypes);
+    return native.diffSchemas(oldJs, newJs, migrationName);
+}
+/**
+ * Generate contract test scaffolding from route contract files.
+ *
+ * Parses route contracts and generates TypeScript test stubs with
+ * describe/it blocks for each route.
+ *
+ * @param filePaths - Array of file paths containing route contract interfaces
+ * @returns TypeScript test code string
+ */
+export async function generateTestStubs(filePaths) {
+    const native = await getNative();
+    return native.generateTestStubs(filePaths);
+}
+/**
+ * Prepare type metadata for Typia validator generation.
+ *
+ * Converts parsed type metadata into a format suitable for passing
+ * to the @typokit/transform-typia bridge callback.
+ *
+ * @param typeFilePaths - Array of file paths containing type definitions
+ * @returns Array of type validator inputs
+ */
+export async function prepareValidatorInputs(typeFilePaths) {
+    const native = await getNative();
+    return native.prepareValidatorInputs(typeFilePaths);
+}
+/**
+ * Collect validator code results into a file path map.
+ *
+ * Maps type names and their generated code to output file paths
+ * under .typokit/validators/.
+ *
+ * @param results - Array of [typeName, code] pairs
+ * @returns Map of file paths to validator code
+ */
+export async function collectValidatorOutputs(results) {
+    const native = await getNative();
+    return native.collectValidatorOutputs(results);
+}
+/**
+ * Compute a SHA-256 content hash of source files.
+ *
+ * Used for cache invalidation: if the hash matches a previous build,
+ * outputs can be reused without regeneration.
+ *
+ * @param filePaths - Array of file paths to hash
+ * @returns Hex-encoded SHA-256 hash string
+ */
+export async function computeContentHash(filePaths) {
+    const native = await getNative();
+    return native.computeContentHash(filePaths);
+}
+/**
+ * Run the full output pipeline with content-hash caching.
+ *
+ * Orchestrates all transform steps: parse types, compile routes, generate
+ * OpenAPI spec, generate test stubs, and prepare validator inputs. Writes
+ * all outputs to the `.typokit/` directory structure:
+ *
+ * - `.typokit/routes/compiled-router.ts` — Compiled radix tree
+ * - `.typokit/schemas/openapi.json` — OpenAPI 3.1.0 spec
+ * - `.typokit/tests/contract.test.ts` — Contract test stubs
+ * - `.typokit/validators/*.ts` — Typia validators (if callback provided)
+ *
+ * Content-hash caching: If the hash of all source files matches the cached
+ * hash, no outputs are regenerated. Force a rebuild by deleting `.typokit/.cache-hash`.
+ *
+ * @param options - Pipeline configuration
+ * @returns Pipeline output with metadata about what was generated
+ */
+export async function buildPipeline(options) {
+    const { join, dirname } = (await import(/* @vite-ignore */ "path"));
+    const nodeFs = (await import(/* @vite-ignore */ "fs"));
+    const native = await getNative();
+    const outputDir = options.outputDir ?? ".typokit";
+    const cacheFile = options.cacheFile ?? join(outputDir, ".cache-hash");
+    // 1. Compute content hash of all input files
+    const allPaths = [...options.typeFiles, ...options.routeFiles];
+    const contentHash = native.computeContentHash(allPaths);
+    // 2. Check cache
+    if (nodeFs.existsSync(cacheFile)) {
+        const cachedHash = nodeFs.readFileSync(cacheFile, "utf-8").trim();
+        if (cachedHash === contentHash) {
+            return {
+                regenerated: false,
+                contentHash,
+                types: {},
+                filesWritten: [],
+            };
+        }
+    }
+    // 3. Run native pipeline
+    const result = native.runPipeline(options.typeFiles, options.routeFiles);
+    // 4. Ensure output directories exist
+    const dirs = [
+        join(outputDir, "routes"),
+        join(outputDir, "schemas"),
+        join(outputDir, "tests"),
+        join(outputDir, "validators"),
+        join(outputDir, "client"),
+    ];
+    for (const dir of dirs) {
+        nodeFs.mkdirSync(dir, { recursive: true });
+    }
+    const filesWritten = [];
+    // 5. Write compiled routes
+    const routesPath = join(outputDir, "routes", "compiled-router.ts");
+    nodeFs.writeFileSync(routesPath, result.compiledRoutes, "utf-8");
+    filesWritten.push(routesPath);
+    // 6. Write OpenAPI spec
+    const openapiPath = join(outputDir, "schemas", "openapi.json");
+    nodeFs.writeFileSync(openapiPath, result.openapiSpec, "utf-8");
+    filesWritten.push(openapiPath);
+    // 7. Write test stubs
+    const testsPath = join(outputDir, "tests", "contract.test.ts");
+    nodeFs.writeFileSync(testsPath, result.testStubs, "utf-8");
+    filesWritten.push(testsPath);
+    // 8. Generate and write validators (if callback provided)
+    if (options.validatorCallback && result.validatorInputs.length > 0) {
+        const validatorResults = await options.validatorCallback(result.validatorInputs);
+        const validatorOutputs = native.collectValidatorOutputs(validatorResults);
+        for (const [filePath, code] of Object.entries(validatorOutputs)) {
+            const fullPath = filePath.startsWith(outputDir)
+                ? filePath
+                : join(outputDir, filePath.replace(/^\.typokit\//, ""));
+            const dir = dirname(fullPath);
+            nodeFs.mkdirSync(dir, { recursive: true });
+            nodeFs.writeFileSync(fullPath, code, "utf-8");
+            filesWritten.push(fullPath);
+        }
+    }
+    // 9. Write cache hash
+    nodeFs.mkdirSync(dirname(cacheFile), { recursive: true });
+    nodeFs.writeFileSync(cacheFile, contentHash, "utf-8");
+    filesWritten.push(cacheFile);
+    // 10. Convert types to SchemaTypeMap
+    const types = {};
+    for (const [name, meta] of Object.entries(result.types)) {
+        types[name] = {
+            name: meta.name,
+            properties: {},
+        };
+        for (const [propName, prop] of Object.entries(meta.properties)) {
+            types[name].properties[propName] = {
+                type: prop.type,
+                optional: prop.optional,
+            };
+        }
+    }
+    return {
+        regenerated: true,
+        contentHash,
+        types,
+        filesWritten,
+    };
+}
+/** Convert SchemaTypeMap to JsTypeMetadata format for native binding */
+function schemaTypeMapToJs(types) {
+    const result = {};
+    for (const [name, meta] of Object.entries(types)) {
+        result[name] = {
+            name: meta.name,
+            properties: {},
+        };
+        for (const [propName, prop] of Object.entries(meta.properties)) {
+            result[name].properties[propName] = {
+                type: prop.type,
+                optional: prop.optional,
+            };
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@typokit/transform-native",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "version": "0.1.4",
+  "type": "module",
+  "files": [
+    "dist",
+    "src",
+    "*.node"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@typokit/types": "0.1.4"
+  },
+  "napi": {
+    "binaryName": "index",
+    "targets": [
+      "x86_64-pc-windows-msvc",
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KyleBastien/typokit",
+    "directory": "packages/transform-native"
+  },
+  "scripts": {
+    "test": "rstest run --passWithNoTests",
+    "build:native": "napi build --platform --dts src/index.d.ts --js false",
+    "build:native:release": "napi build --platform --release --dts src/index.d.ts --js false"
+  }
+}

package/src/env.d.ts

@@ -0,0 +1,40 @@
+// Minimal type declarations for Node.js APIs used by transform-native
+// Avoids adding @types/node as a dependency
+
+declare module "module" {
+  export function createRequire(url: string | URL): (id: string) => unknown;
+}
+
+declare module "path" {
+  export function join(...paths: string[]): string;
+  export function dirname(p: string): string;
+}
+
+declare module "fs" {
+  export function existsSync(path: string): boolean;
+  export function mkdirSync(
+    path: string,
+    options?: { recursive?: boolean },
+  ): void;
+  export function readFileSync(path: string, encoding: string): string;
+  export function writeFileSync(
+    path: string,
+    data: string,
+    encoding?: string,
+  ): void;
+  export function unlinkSync(path: string): void;
+  export function rmSync(
+    path: string,
+    options?: { recursive?: boolean; force?: boolean },
+  ): void;
+  export function readdirSync(path: string): string[];
+  export function statSync(path: string): { isDirectory(): boolean };
+}
+
+declare module "os" {
+  export function tmpdir(): string;
+}
+
+interface ImportMeta {
+  url: string;
+}

package/src/index.d.ts

@@ -0,0 +1,135 @@
+/* auto-generated by NAPI-RS */
+/**
+ * Collect validator code results into a file path map.
+ *
+ * Maps type names to their output file paths under .typokit/validators/.
+ */
+export declare function collectValidatorOutputs(
+  results: Array<Array<string>>,
+): Record<string, string>;
+
+/**
+ * Compile route contracts from TypeScript files into a radix tree.
+ * Returns TypeScript source code for the compiled route table.
+ */
+export declare function compileRoutes(filePaths: Array<string>): string;
+
+/**
+ * Compute a SHA-256 content hash of the given file paths and their contents.
+ *
+ * Used for cache invalidation: if the hash matches a previous build, outputs
+ * can be reused without regeneration.
+ */
+export declare function computeContentHash(filePaths: Array<string>): string;
+
+/**
+ * Diff two schema versions and produce a migration draft.
+ *
+ * Compares old_types against new_types to detect added/removed/modified
+ * entities and fields. Generates SQL DDL stubs for the changes.
+ */
+export declare function diffSchemas(
+  oldTypes: Record<string, JsTypeMetadata>,
+  newTypes: Record<string, JsTypeMetadata>,
+  migrationName: string,
+): JsMigrationDraft;
+
+/**
+ * Generate an OpenAPI 3.1.0 specification from route contracts and type definitions.
+ * Returns the OpenAPI spec as a JSON string.
+ */
+export declare function generateOpenApi(
+  routeFilePaths: Array<string>,
+  typeFilePaths: Array<string>,
+): string;
+
+/**
+ * Generate contract test scaffolding from route contract files.
+ *
+ * Parses route contracts from the given files and generates TypeScript
+ * test stubs with describe/it blocks for each route.
+ */
+export declare function generateTestStubs(filePaths: Array<string>): string;
+
+/** A migration draft (matches @typokit/types MigrationDraft) */
+export interface JsMigrationDraft {
+  name: string;
+  sql: string;
+  destructive: boolean;
+  changes: Array<JsSchemaChange>;
+}
+
+/** Result of running the full output pipeline */
+export interface JsPipelineResult {
+  /** SHA-256 content hash of all input source files */
+  contentHash: string;
+  /** Extracted type metadata (SchemaTypeMap-compatible) */
+  types: Record<string, JsTypeMetadata>;
+  /** Compiled route table as TypeScript source */
+  compiledRoutes: string;
+  /** OpenAPI 3.1.0 spec as JSON string */
+  openapiSpec: string;
+  /** Generated contract test stubs as TypeScript source */
+  testStubs: string;
+  /** Validator inputs ready for Typia bridge callback */
+  validatorInputs: Array<JsTypeValidatorInput>;
+}
+
+/** Property metadata matching @typokit/types PropertyMetadata shape */
+export interface JsPropertyMetadata {
+  type: string;
+  optional: boolean;
+}
+
+/** A single schema change (matches @typokit/types SchemaChange) */
+export interface JsSchemaChange {
+  type: string;
+  entity: string;
+  field?: string;
+  details?: Record<string, string>;
+}
+
+/** Type metadata matching @typokit/types TypeMetadata shape */
+export interface JsTypeMetadata {
+  name: string;
+  properties: Record<string, JsPropertyMetadata>;
+}
+
+/** Validator input for a single type (passed to Typia bridge callback) */
+export interface JsTypeValidatorInput {
+  name: string;
+  properties: Record<string, JsPropertyMetadata>;
+}
+
+/**
+ * Parse TypeScript source files and extract type metadata.
+ *
+ * Returns a SchemaTypeMap (Record<string, TypeMetadata>) mapping type names
+ * to their extracted metadata including property types, optionality, and JSDoc tags.
+ */
+export declare function parseAndExtractTypes(
+  filePaths: Array<string>,
+): Record<string, JsTypeMetadata>;
+
+/**
+ * Prepare type metadata for Typia validator generation.
+ *
+ * Converts parsed type metadata into a format suitable for passing
+ * to the @typokit/transform-typia bridge callback.
+ */
+export declare function prepareValidatorInputs(
+  typeFilePaths: Array<string>,
+): Array<JsTypeValidatorInput>;
+
+/**
+ * Run the full output pipeline: parse types, compile routes, generate OpenAPI,
+ * generate test stubs, and prepare validator inputs.
+ *
+ * Returns all generated outputs plus a content hash for caching.
+ * Validators are returned as inputs — the caller should pass them to
+ * the Typia bridge callback and then call collectValidatorOutputs.
+ */
+export declare function runPipeline(
+  typeFilePaths: Array<string>,
+  routeFilePaths: Array<string>,
+): JsPipelineResult;