@soda-gql/swc 0.11.0

package/dist/native.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.mjs","names":[],"sources":["../src/native/index.js"],"sourcesContent":["/* tslint:disable */\n/* eslint-disable */\n/* prettier-ignore */\n\n/* auto-generated by NAPI-RS */\n\nconst { existsSync, readFileSync } = require('fs')\nconst { join } = require('path')\n\nconst { platform, arch } = process\n\nlet nativeBinding = null\nlet localFileExisted = false\nlet loadError = null\n\nfunction isMusl() {\n  // For Node 10\n  if (!process.report || typeof process.report.getReport !== 'function') {\n    try {\n      const lddPath = require('child_process').execSync('which ldd').toString().trim()\n      return readFileSync(lddPath, 'utf8').includes('musl')\n    } catch (e) {\n      return true\n    }\n  } else {\n    const { glibcVersionRuntime } = process.report.getReport().header\n    return !glibcVersionRuntime\n  }\n}\n\nswitch (platform) {\n  case 'android':\n    switch (arch) {\n      case 'arm64':\n        localFileExisted = existsSync(join(__dirname, 'swc.android-arm64.node'))\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'android-arm64.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'android-arm64')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      case 'arm':\n        localFileExisted = existsSync(join(__dirname, 'swc.android-arm-eabi.node'))\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'android-arm-eabi.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'android-arm-eabi')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      default:\n        throw new Error(`Unsupported architecture on Android ${arch}`)\n    }\n    break\n  case 'win32':\n    switch (arch) {\n      case 'x64':\n        localFileExisted = existsSync(\n          join(__dirname, 'swc.win32-x64-msvc.node')\n        )\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'win32-x64-msvc.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'win32-x64-msvc')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      case 'ia32':\n        localFileExisted = existsSync(\n          join(__dirname, 'swc.win32-ia32-msvc.node')\n        )\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'win32-ia32-msvc.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'win32-ia32-msvc')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      case 'arm64':\n        localFileExisted = existsSync(\n          join(__dirname, 'swc.win32-arm64-msvc.node')\n        )\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'win32-arm64-msvc.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'win32-arm64-msvc')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      default:\n        throw new Error(`Unsupported architecture on Windows: ${arch}`)\n    }\n    break\n  case 'darwin':\n    localFileExisted = existsSync(join(__dirname, 'swc.darwin-universal.node'))\n    try {\n      if (localFileExisted) {\n        nativeBinding = require('./swc.'.slice(0) + 'darwin-universal.node')\n      } else {\n        nativeBinding = require('@soda-gql/swc-'.slice(0) + 'darwin-universal')\n      }\n      break\n    } catch {}\n    switch (arch) {\n      case 'x64':\n        localFileExisted = existsSync(join(__dirname, 'swc.darwin-x64.node'))\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'darwin-x64.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'darwin-x64')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      case 'arm64':\n        localFileExisted = existsSync(\n          join(__dirname, 'swc.darwin-arm64.node')\n        )\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'darwin-arm64.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'darwin-arm64')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      default:\n        throw new Error(`Unsupported architecture on macOS: ${arch}`)\n    }\n    break\n  case 'freebsd':\n    if (arch !== 'x64') {\n      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)\n    }\n    localFileExisted = existsSync(join(__dirname, 'swc.freebsd-x64.node'))\n    try {\n      if (localFileExisted) {\n        nativeBinding = require('./swc.'.slice(0) + 'freebsd-x64.node')\n      } else {\n        nativeBinding = require('@soda-gql/swc-'.slice(0) + 'freebsd-x64')\n      }\n    } catch (e) {\n      loadError = e\n    }\n    break\n  case 'linux':\n    switch (arch) {\n      case 'x64':\n        if (isMusl()) {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-x64-musl.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-x64-musl.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-x64-musl')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        } else {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-x64-gnu.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-x64-gnu.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-x64-gnu')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        }\n        break\n      case 'arm64':\n        if (isMusl()) {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-arm64-musl.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-arm64-musl.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-arm64-musl')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        } else {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-arm64-gnu.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-arm64-gnu.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-arm64-gnu')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        }\n        break\n      case 'arm':\n        if (isMusl()) {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-arm-musleabihf.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-arm-musleabihf.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-arm-musleabihf')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        } else {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-arm-gnueabihf.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-arm-gnueabihf.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-arm-gnueabihf')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        }\n        break\n      case 'riscv64':\n        if (isMusl()) {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-riscv64-musl.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-riscv64-musl.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-riscv64-musl')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        } else {\n          localFileExisted = existsSync(\n            join(__dirname, 'swc.linux-riscv64-gnu.node')\n          )\n          try {\n            if (localFileExisted) {\n              nativeBinding = require('./swc.'.slice(0) + 'linux-riscv64-gnu.node')\n            } else {\n              nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-riscv64-gnu')\n            }\n          } catch (e) {\n            loadError = e\n          }\n        }\n        break\n      case 's390x':\n        localFileExisted = existsSync(\n          join(__dirname, 'swc.linux-s390x-gnu.node')\n        )\n        try {\n          if (localFileExisted) {\n            nativeBinding = require('./swc.'.slice(0) + 'linux-s390x-gnu.node')\n          } else {\n            nativeBinding = require('@soda-gql/swc-'.slice(0) + 'linux-s390x-gnu')\n          }\n        } catch (e) {\n          loadError = e\n        }\n        break\n      default:\n        throw new Error(`Unsupported architecture on Linux: ${arch}`)\n    }\n    break\n  default:\n    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)\n}\n\nif (!nativeBinding) {\n  if (loadError) {\n    throw loadError\n  }\n  throw new Error(`Failed to load native binding`)\n}\n\nconst { transform, SwcTransformer } = nativeBinding\n\nmodule.exports.transform = transform\nmodule.exports.SwcTransformer = SwcTransformer\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@soda-gql/swc",
+  "version": "0.11.0",
+  "description": "SWC-based native transformer for soda-gql",
+  "type": "module",
+  "private": false,
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "author": {
+    "name": "Shota Hatada",
+    "email": "shota.hatada@whatasoda.me",
+    "url": "https://github.com/whatasoda"
+  },
+  "keywords": [
+    "graphql",
+    "codegen",
+    "zero-runtime",
+    "typescript",
+    "swc",
+    "transformer",
+    "native"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/whatasoda/soda-gql.git",
+    "directory": "packages/swc"
+  },
+  "homepage": "https://github.com/whatasoda/soda-gql#readme",
+  "bugs": {
+    "url": "https://github.com/whatasoda/soda-gql/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    "./native": {
+      "@soda-gql": "./@x-native.ts",
+      "types": "./dist/native.d.mts",
+      "import": "./dist/native.mjs",
+      "require": "./dist/native.cjs",
+      "default": "./dist/native.mjs"
+    },
+    ".": {
+      "@soda-gql": "./@x-index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@ampproject/remapping": "^2.3.0",
+    "@soda-gql/builder": "0.11.0",
+    "@soda-gql/common": "0.11.0",
+    "@soda-gql/config": "0.11.0",
+    "@soda-gql/core": "0.11.0"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "@soda-gql/tsc": "0.11.0",
+    "prettier": "^3.4.2"
+  },
+  "peerDependencies": {
+    "@swc/core": "^1.0.0"
+  },
+  "optionalDependencies": {
+    "@soda-gql/swc-darwin-x64": "0.11.0",
+    "@soda-gql/swc-darwin-arm64": "0.11.0",
+    "@soda-gql/swc-linux-x64-musl": "0.11.0",
+    "@soda-gql/swc-win32-x64-msvc": "0.11.0",
+    "@soda-gql/swc-linux-x64-gnu": "0.11.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,290 @@
+/**
+ * SWC-based transformer for soda-gql GraphQL code generation.
+ *
+ * This module provides a TypeScript wrapper around the native Rust transformer.
+ */
+
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import remapping from "@ampproject/remapping";
+import type { BuilderArtifact } from "@soda-gql/builder";
+import type { ResolvedSodaGqlConfig } from "@soda-gql/config";
+
+// The native module will be loaded at runtime via the napi-rs generated loader
+let nativeModule: NativeModule | null = null;
+
+interface NativeModule {
+  transform(inputJson: string): string;
+  SwcTransformer: new (artifactJson: string, configJson: string) => NativeTransformer;
+}
+
+interface NativeTransformer {
+  transform(sourceCode: string, sourcePath: string): string;
+}
+
+/**
+ * Plugin error from the SWC transformer.
+ * This matches the Rust PluginError structure for consistent error reporting.
+ */
+export type SwcPluginError = {
+  /** Always "PluginError" for type discrimination */
+  readonly type: "PluginError";
+  /** Error code for programmatic handling (e.g., "SODA_GQL_METADATA_NOT_FOUND") */
+  readonly code: string;
+  /** Human-readable error message */
+  readonly message: string;
+  /** Stage where the error occurred */
+  readonly stage: "analysis" | "transform";
+  /** Source filename if applicable */
+  readonly filename?: string;
+  /** Canonical ID if applicable */
+  readonly canonicalId?: string;
+  /** Artifact type if applicable */
+  readonly artifactType?: string;
+  /** Builder type if applicable */
+  readonly builderType?: string;
+  /** Argument name if applicable */
+  readonly argName?: string;
+};
+
+interface TransformResult {
+  outputCode: string;
+  transformed: boolean;
+  sourceMap?: string;
+  errors?: SwcPluginError[];
+}
+
+/**
+ * Load the native module.
+ * Uses the napi-rs generated loader which handles platform detection.
+ */
+const loadNativeModule = async (): Promise<NativeModule> => {
+  if (nativeModule) {
+    return nativeModule;
+  }
+
+  try {
+    // Use require() for the napi-rs generated loader (CommonJS)
+    const { createRequire } = await import("node:module");
+    const require = createRequire(import.meta.url);
+    nativeModule = require("./native/index.js") as NativeModule;
+    return nativeModule;
+  } catch (error) {
+    throw new Error(
+      "Failed to load @soda-gql/swc native module. " +
+        "Make sure the native module is built for your platform. " +
+        `Run 'bun run build' in the packages/swc directory. (${error})`,
+    );
+  }
+};
+
+export type ModuleFormat = "esm" | "cjs";
+
+export type TransformOptions = {
+  /** Compiler options for output format */
+  compilerOptions?: {
+    /** Module format: CommonJS or ESNext */
+    module?: "CommonJS" | "ESNext";
+  };
+  /** Resolved soda-gql configuration */
+  config: ResolvedSodaGqlConfig;
+  /** Pre-built artifact from the builder */
+  artifact: BuilderArtifact;
+  /** Whether to generate source maps */
+  sourceMap?: boolean;
+};
+
+export type TransformInput = {
+  /** Source code to transform */
+  sourceCode: string;
+  /** Path to the source file */
+  sourcePath: string;
+  /** Input source map from previous transformer (JSON string) */
+  inputSourceMap?: string;
+};
+
+/**
+ * Normalize path separators to forward slashes (cross-platform).
+ * This matches the behavior of @soda-gql/common normalizePath.
+ */
+const normalizePath = (value: string): string => value.replace(/\\/g, "/");
+
+/**
+ * Filter artifact to only include elements for the given source file.
+ * This significantly reduces JSON serialization overhead for large codebases.
+ *
+ * Canonical IDs have the format: "filepath::astPath"
+ * We filter by matching the filepath prefix.
+ */
+const filterArtifactForFile = (artifact: BuilderArtifact, sourcePath: string): BuilderArtifact => {
+  const prefix = `${sourcePath}::`;
+
+  const filteredElements: BuilderArtifact["elements"] = {};
+  for (const [id, element] of Object.entries(artifact.elements)) {
+    if (id.startsWith(prefix)) {
+      (filteredElements as Record<string, typeof element>)[id] = element;
+    }
+  }
+
+  return {
+    elements: filteredElements,
+    report: { stats: { hits: 0, misses: 0, skips: 0 }, durationMs: 0, warnings: [] },
+  };
+};
+
+/**
+ * Resolve the canonical path to the graphql-system file.
+ * Uses realpath to resolve symlinks for accurate comparison.
+ */
+const resolveGraphqlSystemPath = (config: ResolvedSodaGqlConfig): string => {
+  const graphqlSystemPath = resolve(config.outdir, "index.ts");
+  try {
+    return normalizePath(realpathSync(graphqlSystemPath));
+  } catch {
+    // If realpath fails (file doesn't exist yet), fall back to resolved path
+    return normalizePath(resolve(graphqlSystemPath));
+  }
+};
+
+export type TransformOutput = {
+  /** Whether any transformation was performed */
+  transformed: boolean;
+  /** The transformed source code (or original if no transformation) */
+  sourceCode: string;
+  /** Source map JSON, if source map generation was enabled */
+  sourceMap?: string;
+  /** Errors encountered during transformation (non-fatal) */
+  errors: SwcPluginError[];
+};
+
+/**
+ * Transformer interface.
+ */
+export interface Transformer {
+  transform(input: TransformInput): TransformOutput;
+}
+
+/**
+ * Create a transformer instance.
+ *
+ * @param options - Transform options including config and artifact
+ * @returns A transformer that can transform source files
+ */
+export const createTransformer = async (options: TransformOptions): Promise<Transformer> => {
+  const native = await loadNativeModule();
+
+  const isCJS = options.compilerOptions?.module === "CommonJS";
+
+  // Resolve the graphql-system file path for stubbing
+  const graphqlSystemPath = resolveGraphqlSystemPath(options.config);
+
+  const configJson = JSON.stringify({
+    graphqlSystemAliases: options.config.graphqlSystemAliases,
+    isCjs: isCJS,
+    graphqlSystemPath,
+    sourceMap: options.sourceMap ?? false,
+  });
+
+  // Store full artifact for per-file filtering
+  const fullArtifact = options.artifact;
+
+  return {
+    transform: ({ sourceCode, sourcePath, inputSourceMap }: TransformInput): TransformOutput => {
+      // Resolve to absolute path and normalize for canonical ID consistency
+      // This ensures bundlers can pass relative paths safely
+      const normalizedPath = normalizePath(resolve(sourcePath));
+
+      // Filter artifact to only include elements for this file
+      // This significantly reduces JSON serialization overhead for large codebases
+      const filteredArtifact = filterArtifactForFile(fullArtifact, normalizedPath);
+      const filteredArtifactJson = JSON.stringify(filteredArtifact);
+
+      // Create per-file transformer with filtered artifact
+      const fileTransformer = new native.SwcTransformer(filteredArtifactJson, configJson);
+      const resultJson = fileTransformer.transform(sourceCode, normalizedPath);
+      const result: TransformResult = JSON.parse(resultJson);
+
+      // Handle source map chaining
+      let finalSourceMap: string | undefined;
+      if (result.sourceMap) {
+        if (inputSourceMap) {
+          // Chain source maps: our map -> input map -> original source
+          const merged = remapping([JSON.parse(result.sourceMap), JSON.parse(inputSourceMap)], () => null);
+          finalSourceMap = JSON.stringify(merged);
+        } else {
+          finalSourceMap = result.sourceMap;
+        }
+      }
+
+      return {
+        transformed: result.transformed,
+        sourceCode: result.outputCode,
+        sourceMap: finalSourceMap,
+        errors: result.errors ?? [],
+      };
+    },
+  };
+};
+
+/**
+ * Transform a single source file (one-shot).
+ *
+ * For transforming multiple files, use createTransformer() to reuse the artifact.
+ *
+ * @param input - Transform input including source, path, artifact, and config
+ * @returns Transform output
+ */
+export const transform = async (
+  input: TransformInput & {
+    artifact: BuilderArtifact;
+    config: ResolvedSodaGqlConfig;
+    isCjs?: boolean;
+    sourceMap?: boolean;
+  },
+): Promise<TransformOutput> => {
+  const native = await loadNativeModule();
+
+  // Resolve to absolute path and normalize for canonical ID consistency
+  // This ensures bundlers can pass relative paths safely
+  const normalizedPath = normalizePath(resolve(input.sourcePath));
+
+  // Filter artifact to only include elements for this file
+  const filteredArtifact = filterArtifactForFile(input.artifact, normalizedPath);
+
+  // Resolve the graphql-system file path for stubbing
+  const graphqlSystemPath = resolveGraphqlSystemPath(input.config);
+
+  const inputJson = JSON.stringify({
+    sourceCode: input.sourceCode,
+    sourcePath: normalizedPath,
+    artifactJson: JSON.stringify(filteredArtifact),
+    config: {
+      graphqlSystemAliases: input.config.graphqlSystemAliases,
+      isCjs: input.isCjs ?? false,
+      graphqlSystemPath,
+      sourceMap: input.sourceMap ?? false,
+    },
+  });
+
+  const resultJson = native.transform(inputJson);
+  const result: TransformResult = JSON.parse(resultJson);
+
+  // Handle source map chaining
+  let finalSourceMap: string | undefined;
+  if (result.sourceMap) {
+    if (input.inputSourceMap) {
+      // Chain source maps: our map -> input map -> original source
+      const merged = remapping([JSON.parse(result.sourceMap), JSON.parse(input.inputSourceMap)], () => null);
+      finalSourceMap = JSON.stringify(merged);
+    } else {
+      finalSourceMap = result.sourceMap;
+    }
+  }
+
+  return {
+    transformed: result.transformed,
+    sourceCode: result.outputCode,
+    sourceMap: finalSourceMap,
+    errors: result.errors ?? [],
+  };
+};

package/src/lib.rs

@@ -0,0 +1,87 @@
+//! SWC-based transformer for soda-gql GraphQL code generation.
+//!
+//! This crate provides a native Node.js module using napi-rs that transforms
+//! `gql.default()` calls into `gqlRuntime.*` calls at build time.
+
+mod transform;
+mod types;
+
+use napi::bindgen_prelude::*;
+use napi_derive::napi;
+use types::config::{TransformConfig, TransformInput, TransformInputRef};
+use types::BuilderArtifact;
+
+/// Transform a single source file.
+///
+/// # Arguments
+/// * `input_json` - JSON-serialized TransformInput containing source code, file path, artifact, and config
+///
+/// # Returns
+/// JSON-serialized TransformResult containing the transformed code
+#[napi]
+pub fn transform(input_json: String) -> Result<String> {
+    let input: TransformInput = serde_json::from_str(&input_json)
+        .map_err(|e| Error::from_reason(format!("Failed to parse input: {}", e)))?;
+
+    let result = transform::transformer::transform_source(&input)
+        .map_err(|e| Error::from_reason(e))?;
+
+    serde_json::to_string(&result)
+        .map_err(|e| Error::from_reason(format!("Failed to serialize result: {}", e)))
+}
+
+/// Stateful transformer that caches artifact and config for multiple file transformations.
+///
+/// The artifact is parsed once in the constructor and reused for all subsequent
+/// transform calls, avoiding repeated JSON parsing overhead.
+#[napi]
+pub struct SwcTransformer {
+    /// Pre-parsed BuilderArtifact (parsed once in constructor)
+    artifact: BuilderArtifact,
+    config: TransformConfig,
+}
+
+#[napi]
+impl SwcTransformer {
+    /// Create a new transformer instance.
+    ///
+    /// # Arguments
+    /// * `artifact_json` - JSON-serialized BuilderArtifact
+    /// * `config_json` - JSON-serialized TransformConfig
+    #[napi(constructor)]
+    pub fn new(artifact_json: String, config_json: String) -> Result<Self> {
+        let config: TransformConfig = serde_json::from_str(&config_json)
+            .map_err(|e| Error::from_reason(format!("Failed to parse config: {}", e)))?;
+
+        // Parse artifact once in constructor to avoid repeated parsing
+        let artifact: BuilderArtifact = serde_json::from_str(&artifact_json)
+            .map_err(|e| Error::from_reason(format!("Failed to parse artifact: {}", e)))?;
+
+        Ok(SwcTransformer { artifact, config })
+    }
+
+    /// Transform a single source file.
+    ///
+    /// # Arguments
+    /// * `source_code` - The source code to transform
+    /// * `source_path` - The file path of the source
+    ///
+    /// # Returns
+    /// JSON-serialized TransformResult
+    #[napi]
+    pub fn transform(&self, source_code: String, source_path: String) -> Result<String> {
+        // Use pre-parsed artifact reference instead of re-parsing JSON
+        let input = TransformInputRef {
+            source_code,
+            source_path,
+            artifact: &self.artifact,
+            config: self.config.clone(),
+        };
+
+        let result = transform::transformer::transform_source_ref(&input)
+            .map_err(|e| Error::from_reason(e))?;
+
+        serde_json::to_string(&result)
+            .map_err(|e| Error::from_reason(format!("Failed to serialize result: {}", e)))
+    }
+}

package/src/native/index.d.ts

@@ -0,0 +1,42 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/**
+ * Transform a single source file.
+ *
+ * # Arguments
+ * * `input_json` - JSON-serialized TransformInput containing source code, file path, artifact, and config
+ *
+ * # Returns
+ * JSON-serialized TransformResult containing the transformed code
+ */
+export declare function transform(inputJson: string): string
+/**
+ * Stateful transformer that caches artifact and config for multiple file transformations.
+ *
+ * The artifact is parsed once in the constructor and reused for all subsequent
+ * transform calls, avoiding repeated JSON parsing overhead.
+ */
+export declare class SwcTransformer {
+  /**
+   * Create a new transformer instance.
+   *
+   * # Arguments
+   * * `artifact_json` - JSON-serialized BuilderArtifact
+   * * `config_json` - JSON-serialized TransformConfig
+   */
+  constructor(artifactJson: string, configJson: string)
+  /**
+   * Transform a single source file.
+   *
+   * # Arguments
+   * * `source_code` - The source code to transform
+   * * `source_path` - The file path of the source
+   *
+   * # Returns
+   * JSON-serialized TransformResult
+   */
+  transform(sourceCode: string, sourcePath: string): string
+}