@soda-gql/metro-plugin 0.11.2 → 0.11.4

package/README.md

@@ -108,6 +108,14 @@ npx react-native start --reset-cache
 
 When using other Metro transformers (e.g., react-native-svg-transformer), soda-gql automatically detects and chains with them.
 
+### How Chaining Works
+
+When an upstream transformer is detected, soda-gql generates a wrapper transformer file in `node_modules/.cache/soda-gql/`. This wrapper:
+
+1. Hardcodes the upstream transformer path at build time
+2. Enables reliable chaining in Metro worker processes
+3. Is automatically regenerated when the upstream path changes
+
 ### Automatic Chaining (Recommended)
 
 If you set `babelTransformerPath` before calling `withSodaGql`, it will be automatically preserved and chained:

package/dist/index.cjs

@@ -1,6 +1,67 @@
 const require_transformer = require('./transformer.cjs');
 let __soda_gql_builder_plugin_support = require("@soda-gql/builder/plugin-support");
+let node_crypto = require("node:crypto");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
 
+//#region packages/metro-plugin/src/wrapper-generator.ts
+/** Cache directory location relative to project root */
+const CACHE_DIR = "node_modules/.cache/soda-gql";
+/** Wrapper file name suffix */
+const WRAPPER_FILE = "metro-transformer-wrapper.js";
+/**
+* Generate a deterministic hash for cache key.
+* Includes version prefix for cache invalidation on plugin updates.
+*/
+function generateCacheKey(upstreamPath) {
+	const hash = (0, node_crypto.createHash)("md5");
+	hash.update("@soda-gql/metro-plugin:wrapper:v1");
+	hash.update(upstreamPath);
+	return hash.digest("hex").slice(0, 12);
+}
+/**
+* Generate wrapper transformer content.
+* The generated file imports soda-gql transformer factory and creates
+* a transformer instance with the hardcoded upstream path.
+*/
+function generateWrapperContent(upstreamPath) {
+	return `// Generated by @soda-gql/metro-plugin
+// DO NOT EDIT - This file is auto-generated
+// Upstream: ${upstreamPath}
+
+const { createTransformerWithUpstream } = require("@soda-gql/metro-plugin/transformer");
+
+const transformer = createTransformerWithUpstream(${JSON.stringify(upstreamPath)});
+
+module.exports = transformer;
+module.exports.transform = transformer.transform;
+module.exports.getCacheKey = transformer.getCacheKey;
+`;
+}
+/**
+* Get or create wrapper transformer file.
+* Returns the absolute path to the wrapper file.
+*
+* The wrapper file is cached based on the upstream transformer path.
+* If the file already exists with the same content, it is reused.
+*
+* @param options - Wrapper generator options
+* @returns Absolute path to the wrapper transformer file
+*/
+function ensureWrapperTransformer(options) {
+	const { upstreamTransformerPath, projectRoot } = options;
+	const cacheDir = (0, node_path.join)(projectRoot, CACHE_DIR);
+	const wrapperPath = (0, node_path.join)(cacheDir, `${generateCacheKey(upstreamTransformerPath)}-${WRAPPER_FILE}`);
+	const expectedContent = generateWrapperContent(upstreamTransformerPath);
+	if ((0, node_fs.existsSync)(wrapperPath)) try {
+		if ((0, node_fs.readFileSync)(wrapperPath, "utf-8") === expectedContent) return wrapperPath;
+	} catch {}
+	(0, node_fs.mkdirSync)(cacheDir, { recursive: true });
+	(0, node_fs.writeFileSync)(wrapperPath, expectedContent, "utf-8");
+	return wrapperPath;
+}
+
+//#endregion
 //#region packages/metro-plugin/src/index.ts
 /**
 * Wrap Metro configuration with soda-gql support.
@@ -57,21 +118,27 @@ let __soda_gql_builder_plugin_support = require("@soda-gql/builder/plugin-suppor
 * @returns Modified Metro configuration with soda-gql transformer
 */
 function withSodaGql(config, options = {}) {
-	const transformerPath = require.resolve("@soda-gql/metro-plugin/transformer");
 	const stateKey = (0, __soda_gql_builder_plugin_support.getStateKey)(options.configPath);
 	if (options.transformer) (0, __soda_gql_builder_plugin_support.setSharedTransformerType)(stateKey, options.transformer);
 	const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;
-	const sodaGqlTransformerOptions = {
-		...upstreamTransformer && { upstreamTransformer },
-		...options.configPath && { configPath: options.configPath },
-		...options.transformer && { transformerType: options.transformer }
-	};
+	let transformerPath;
+	if (upstreamTransformer) {
+		let resolvedUpstream;
+		try {
+			resolvedUpstream = require.resolve(upstreamTransformer, { paths: [process.cwd()] });
+		} catch {
+			resolvedUpstream = upstreamTransformer;
+		}
+		transformerPath = ensureWrapperTransformer({
+			upstreamTransformerPath: resolvedUpstream,
+			projectRoot: process.cwd()
+		});
+	} else transformerPath = require.resolve("@soda-gql/metro-plugin/transformer");
 	return {
 		...config,
 		transformer: {
 			...config.transformer,
-			babelTransformerPath: transformerPath,
-			...Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }
+			babelTransformerPath: transformerPath
 		}
 	};
 }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["sodaGqlTransformerOptions: SodaGqlTransformerOptions"],"sources":["../src/index.ts"],"sourcesContent":["import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions, SodaGqlTransformerOptions } from \"./types\";\n\n// Re-export shared state utilities for advanced usage\nexport { getSharedArtifact, getSharedState, getStateKey } from \"@soda-gql/builder/plugin-support\";\nexport type {\n  MetroConfig,\n  MetroPluginOptions,\n  MetroTransformer,\n  MetroTransformParams,\n  MetroTransformResult,\n  SodaGqlTransformerOptions,\n  TransformerType,\n} from \"./types\";\n\n/**\n * Wrap Metro configuration with soda-gql support.\n *\n * This function modifies the Metro configuration to use the soda-gql\n * transformer, which applies GraphQL code transformations at build time.\n *\n * If the config already has a custom `babelTransformerPath` set (e.g., from\n * react-native-svg-transformer), soda-gql will automatically chain with it.\n *\n * @example\n * ```typescript\n * // Expo project (metro.config.js)\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // React Native bare project (metro.config.js)\n * const { getDefaultConfig, mergeConfig } = require(\"@react-native/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Chaining with another transformer (e.g., react-native-svg-transformer)\n * // The existing babelTransformerPath is automatically detected and chained.\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * config.transformer.babelTransformerPath = require.resolve(\"react-native-svg-transformer\");\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Explicitly specifying upstream transformer\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   upstreamTransformer: require.resolve(\"react-native-svg-transformer\"),\n * });\n * ```\n *\n * @param config - The Metro configuration to wrap\n * @param options - Optional plugin configuration\n * @returns Modified Metro configuration with soda-gql transformer\n */\nexport function withSodaGql<T extends MetroConfig>(config: T, options: MetroPluginOptions = {}): T {\n  // Use package export path to ensure correct resolution from any location\n  const transformerPath = require.resolve(\"@soda-gql/metro-plugin/transformer\");\n\n  // Store transformer type in shared state for the transformer module to read\n  const stateKey = getStateKey(options.configPath);\n  if (options.transformer) {\n    setSharedTransformerType(stateKey, options.transformer);\n  }\n\n  // Determine upstream transformer path:\n  // 1. Explicit option takes precedence\n  // 2. Fall back to existing babelTransformerPath from config (auto-detect)\n  const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;\n\n  // Build sodaGqlTransformerOptions to pass to the transformer\n  const sodaGqlTransformerOptions: SodaGqlTransformerOptions = {\n    ...(upstreamTransformer && { upstreamTransformer }),\n    ...(options.configPath && { configPath: options.configPath }),\n    ...(options.transformer && { transformerType: options.transformer }),\n  };\n\n  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n      // Pass options to transformer via Metro config\n      ...(Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }),\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,SAAgB,YAAmC,QAAW,UAA8B,EAAE,EAAK;CAEjG,MAAM,kBAAkB,QAAQ,QAAQ,qCAAqC;CAG7E,MAAM,8DAAuB,QAAQ,WAAW;AAChD,KAAI,QAAQ,YACV,iEAAyB,UAAU,QAAQ,YAAY;CAMzD,MAAM,sBAAsB,QAAQ,uBAAuB,OAAO,aAAa;CAG/E,MAAMA,4BAAuD;EAC3D,GAAI,uBAAuB,EAAE,qBAAqB;EAClD,GAAI,QAAQ,cAAc,EAAE,YAAY,QAAQ,YAAY;EAC5D,GAAI,QAAQ,eAAe,EAAE,iBAAiB,QAAQ,aAAa;EACpE;AAED,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GAEtB,GAAI,OAAO,KAAK,0BAA0B,CAAC,SAAS,KAAK,EAAE,2BAA2B;GACvF;EACF"}
+{"version":3,"file":"index.cjs","names":["transformerPath: string","resolvedUpstream: string"],"sources":["../src/wrapper-generator.ts","../src/index.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/** Cache directory location relative to project root */\nconst CACHE_DIR = \"node_modules/.cache/soda-gql\";\n\n/** Wrapper file name suffix */\nconst WRAPPER_FILE = \"metro-transformer-wrapper.js\";\n\n/**\n * Options for generating wrapper transformer.\n */\nexport type WrapperGeneratorOptions = {\n  /** Absolute path to the upstream transformer to chain */\n  readonly upstreamTransformerPath: string;\n  /** Absolute path to the project root */\n  readonly projectRoot: string;\n};\n\n/**\n * Generate a deterministic hash for cache key.\n * Includes version prefix for cache invalidation on plugin updates.\n */\nexport function generateCacheKey(upstreamPath: string): string {\n  const hash = createHash(\"md5\");\n  hash.update(\"@soda-gql/metro-plugin:wrapper:v1\");\n  hash.update(upstreamPath);\n  return hash.digest(\"hex\").slice(0, 12);\n}\n\n/**\n * Generate wrapper transformer content.\n * The generated file imports soda-gql transformer factory and creates\n * a transformer instance with the hardcoded upstream path.\n */\nexport function generateWrapperContent(upstreamPath: string): string {\n  return `// Generated by @soda-gql/metro-plugin\n// DO NOT EDIT - This file is auto-generated\n// Upstream: ${upstreamPath}\n\nconst { createTransformerWithUpstream } = require(\"@soda-gql/metro-plugin/transformer\");\n\nconst transformer = createTransformerWithUpstream(${JSON.stringify(upstreamPath)});\n\nmodule.exports = transformer;\nmodule.exports.transform = transformer.transform;\nmodule.exports.getCacheKey = transformer.getCacheKey;\n`;\n}\n\n/**\n * Get or create wrapper transformer file.\n * Returns the absolute path to the wrapper file.\n *\n * The wrapper file is cached based on the upstream transformer path.\n * If the file already exists with the same content, it is reused.\n *\n * @param options - Wrapper generator options\n * @returns Absolute path to the wrapper transformer file\n */\nexport function ensureWrapperTransformer(options: WrapperGeneratorOptions): string {\n  const { upstreamTransformerPath, projectRoot } = options;\n\n  const cacheDir = join(projectRoot, CACHE_DIR);\n  const cacheKey = generateCacheKey(upstreamTransformerPath);\n  const wrapperPath = join(cacheDir, `${cacheKey}-${WRAPPER_FILE}`);\n\n  // Generate expected content\n  const expectedContent = generateWrapperContent(upstreamTransformerPath);\n\n  // Check if wrapper needs regeneration\n  if (existsSync(wrapperPath)) {\n    try {\n      const existingContent = readFileSync(wrapperPath, \"utf-8\");\n      if (existingContent === expectedContent) {\n        return wrapperPath;\n      }\n    } catch {\n      // File exists but couldn't be read, regenerate\n    }\n  }\n\n  // Create cache directory if it doesn't exist\n  mkdirSync(cacheDir, { recursive: true });\n\n  // Write wrapper file\n  writeFileSync(wrapperPath, expectedContent, \"utf-8\");\n\n  return wrapperPath;\n}\n","import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions } from \"./types\";\nimport { ensureWrapperTransformer } from \"./wrapper-generator\";\n\n// Re-export shared state utilities for advanced usage\nexport { getSharedArtifact, getSharedState, getStateKey } from \"@soda-gql/builder/plugin-support\";\nexport type {\n  MetroConfig,\n  MetroPluginOptions,\n  MetroTransformer,\n  MetroTransformParams,\n  MetroTransformResult,\n  TransformerType,\n} from \"./types\";\n\n/**\n * Wrap Metro configuration with soda-gql support.\n *\n * This function modifies the Metro configuration to use the soda-gql\n * transformer, which applies GraphQL code transformations at build time.\n *\n * If the config already has a custom `babelTransformerPath` set (e.g., from\n * react-native-svg-transformer), soda-gql will automatically chain with it.\n *\n * @example\n * ```typescript\n * // Expo project (metro.config.js)\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // React Native bare project (metro.config.js)\n * const { getDefaultConfig, mergeConfig } = require(\"@react-native/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Chaining with another transformer (e.g., react-native-svg-transformer)\n * // The existing babelTransformerPath is automatically detected and chained.\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * config.transformer.babelTransformerPath = require.resolve(\"react-native-svg-transformer\");\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Explicitly specifying upstream transformer\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   upstreamTransformer: require.resolve(\"react-native-svg-transformer\"),\n * });\n * ```\n *\n * @param config - The Metro configuration to wrap\n * @param options - Optional plugin configuration\n * @returns Modified Metro configuration with soda-gql transformer\n */\nexport function withSodaGql<T extends MetroConfig>(config: T, options: MetroPluginOptions = {}): T {\n  // Store transformer type in shared state for the transformer module to read\n  const stateKey = getStateKey(options.configPath);\n  if (options.transformer) {\n    setSharedTransformerType(stateKey, options.transformer);\n  }\n\n  // Determine upstream transformer path:\n  // 1. Explicit option takes precedence\n  // 2. Fall back to existing babelTransformerPath from config (auto-detect)\n  const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;\n\n  let transformerPath: string;\n\n  if (upstreamTransformer) {\n    // Resolve upstream to absolute path for reliable worker loading\n    let resolvedUpstream: string;\n    try {\n      resolvedUpstream = require.resolve(upstreamTransformer, {\n        paths: [process.cwd()],\n      });\n    } catch {\n      // If resolution fails, use the path as-is (might be an absolute path already)\n      resolvedUpstream = upstreamTransformer;\n    }\n\n    // Generate wrapper transformer with hardcoded upstream\n    transformerPath = ensureWrapperTransformer({\n      upstreamTransformerPath: resolvedUpstream,\n      projectRoot: process.cwd(),\n    });\n  } else {\n    // No upstream - use main transformer directly\n    transformerPath = require.resolve(\"@soda-gql/metro-plugin/transformer\");\n  }\n\n  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;AAKA,MAAM,YAAY;;AAGlB,MAAM,eAAe;;;;;AAgBrB,SAAgB,iBAAiB,cAA8B;CAC7D,MAAM,mCAAkB,MAAM;AAC9B,MAAK,OAAO,oCAAoC;AAChD,MAAK,OAAO,aAAa;AACzB,QAAO,KAAK,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;;;;;AAQxC,SAAgB,uBAAuB,cAA8B;AACnE,QAAO;;eAEM,aAAa;;;;oDAIwB,KAAK,UAAU,aAAa,CAAC;;;;;;;;;;;;;;;;;AAkBjF,SAAgB,yBAAyB,SAA0C;CACjF,MAAM,EAAE,yBAAyB,gBAAgB;CAEjD,MAAM,+BAAgB,aAAa,UAAU;CAE7C,MAAM,kCAAmB,UAAU,GADlB,iBAAiB,wBAAwB,CACX,GAAG,eAAe;CAGjE,MAAM,kBAAkB,uBAAuB,wBAAwB;AAGvE,6BAAe,YAAY,CACzB,KAAI;AAEF,gCADqC,aAAa,QAAQ,KAClC,gBACtB,QAAO;SAEH;AAMV,wBAAU,UAAU,EAAE,WAAW,MAAM,CAAC;AAGxC,4BAAc,aAAa,iBAAiB,QAAQ;AAEpD,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBT,SAAgB,YAAmC,QAAW,UAA8B,EAAE,EAAK;CAEjG,MAAM,8DAAuB,QAAQ,WAAW;AAChD,KAAI,QAAQ,YACV,iEAAyB,UAAU,QAAQ,YAAY;CAMzD,MAAM,sBAAsB,QAAQ,uBAAuB,OAAO,aAAa;CAE/E,IAAIA;AAEJ,KAAI,qBAAqB;EAEvB,IAAIC;AACJ,MAAI;AACF,sBAAmB,QAAQ,QAAQ,qBAAqB,EACtD,OAAO,CAAC,QAAQ,KAAK,CAAC,EACvB,CAAC;UACI;AAEN,sBAAmB;;AAIrB,oBAAkB,yBAAyB;GACzC,yBAAyB;GACzB,aAAa,QAAQ,KAAK;GAC3B,CAAC;OAGF,mBAAkB,QAAQ,QAAQ,qCAAqC;AAGzE,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GACvB;EACF"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as SodaGqlTransformerOptions, r as MetroTransformParams, s as TransformerType, t as MetroConfig } from "./types-DEWrNhj2.cjs";
+import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as TransformerType, r as MetroTransformParams, t as MetroConfig } from "./types-DPugisG3.cjs";
 import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builder/plugin-support";
 
 //#region packages/metro-plugin/src/index.d.ts
@@ -59,5 +59,5 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  */
 declare function withSodaGql<T extends MetroConfig>(config: T, options?: MetroPluginOptions): T;
 //#endregion
-export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type SodaGqlTransformerOptions, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
+export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as SodaGqlTransformerOptions, r as MetroTransformParams, s as TransformerType, t as MetroConfig } from "./types-D-K1oBE_.mjs";
+import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as TransformerType, r as MetroTransformParams, t as MetroConfig } from "./types-BjrzxgOZ.mjs";
 import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builder/plugin-support";
 
 //#region packages/metro-plugin/src/index.d.ts
@@ -59,5 +59,5 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  */
 declare function withSodaGql<T extends MetroConfig>(config: T, options?: MetroPluginOptions): T;
 //#endregion
-export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type SodaGqlTransformerOptions, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
+export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,6 +1,67 @@
 import { t as __require } from "./chunk--GtjC1aJ.mjs";
 import { getSharedArtifact, getSharedState, getStateKey, getStateKey as getStateKey$1, setSharedTransformerType } from "@soda-gql/builder/plugin-support";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
+//#region packages/metro-plugin/src/wrapper-generator.ts
+/** Cache directory location relative to project root */
+const CACHE_DIR = "node_modules/.cache/soda-gql";
+/** Wrapper file name suffix */
+const WRAPPER_FILE = "metro-transformer-wrapper.js";
+/**
+* Generate a deterministic hash for cache key.
+* Includes version prefix for cache invalidation on plugin updates.
+*/
+function generateCacheKey(upstreamPath) {
+	const hash = createHash("md5");
+	hash.update("@soda-gql/metro-plugin:wrapper:v1");
+	hash.update(upstreamPath);
+	return hash.digest("hex").slice(0, 12);
+}
+/**
+* Generate wrapper transformer content.
+* The generated file imports soda-gql transformer factory and creates
+* a transformer instance with the hardcoded upstream path.
+*/
+function generateWrapperContent(upstreamPath) {
+	return `// Generated by @soda-gql/metro-plugin
+// DO NOT EDIT - This file is auto-generated
+// Upstream: ${upstreamPath}
+
+const { createTransformerWithUpstream } = require("@soda-gql/metro-plugin/transformer");
+
+const transformer = createTransformerWithUpstream(${JSON.stringify(upstreamPath)});
+
+module.exports = transformer;
+module.exports.transform = transformer.transform;
+module.exports.getCacheKey = transformer.getCacheKey;
+`;
+}
+/**
+* Get or create wrapper transformer file.
+* Returns the absolute path to the wrapper file.
+*
+* The wrapper file is cached based on the upstream transformer path.
+* If the file already exists with the same content, it is reused.
+*
+* @param options - Wrapper generator options
+* @returns Absolute path to the wrapper transformer file
+*/
+function ensureWrapperTransformer(options) {
+	const { upstreamTransformerPath, projectRoot } = options;
+	const cacheDir = join(projectRoot, CACHE_DIR);
+	const wrapperPath = join(cacheDir, `${generateCacheKey(upstreamTransformerPath)}-${WRAPPER_FILE}`);
+	const expectedContent = generateWrapperContent(upstreamTransformerPath);
+	if (existsSync(wrapperPath)) try {
+		if (readFileSync(wrapperPath, "utf-8") === expectedContent) return wrapperPath;
+	} catch {}
+	mkdirSync(cacheDir, { recursive: true });
+	writeFileSync(wrapperPath, expectedContent, "utf-8");
+	return wrapperPath;
+}
+
+//#endregion
 //#region packages/metro-plugin/src/index.ts
 /**
 * Wrap Metro configuration with soda-gql support.
@@ -57,21 +118,27 @@ import { getSharedArtifact, getSharedState, getStateKey, getStateKey as getState
 * @returns Modified Metro configuration with soda-gql transformer
 */
 function withSodaGql(config, options = {}) {
-	const transformerPath = __require.resolve("@soda-gql/metro-plugin/transformer");
 	const stateKey = getStateKey$1(options.configPath);
 	if (options.transformer) setSharedTransformerType(stateKey, options.transformer);
 	const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;
-	const sodaGqlTransformerOptions = {
-		...upstreamTransformer && { upstreamTransformer },
-		...options.configPath && { configPath: options.configPath },
-		...options.transformer && { transformerType: options.transformer }
-	};
+	let transformerPath;
+	if (upstreamTransformer) {
+		let resolvedUpstream;
+		try {
+			resolvedUpstream = __require.resolve(upstreamTransformer, { paths: [process.cwd()] });
+		} catch {
+			resolvedUpstream = upstreamTransformer;
+		}
+		transformerPath = ensureWrapperTransformer({
+			upstreamTransformerPath: resolvedUpstream,
+			projectRoot: process.cwd()
+		});
+	} else transformerPath = __require.resolve("@soda-gql/metro-plugin/transformer");
 	return {
 		...config,
 		transformer: {
 			...config.transformer,
-			babelTransformerPath: transformerPath,
-			...Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }
+			babelTransformerPath: transformerPath
 		}
 	};
 }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["getStateKey","sodaGqlTransformerOptions: SodaGqlTransformerOptions"],"sources":["../src/index.ts"],"sourcesContent":["import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions, SodaGqlTransformerOptions } from \"./types\";\n\n// Re-export shared state utilities for advanced usage\nexport { getSharedArtifact, getSharedState, getStateKey } from \"@soda-gql/builder/plugin-support\";\nexport type {\n  MetroConfig,\n  MetroPluginOptions,\n  MetroTransformer,\n  MetroTransformParams,\n  MetroTransformResult,\n  SodaGqlTransformerOptions,\n  TransformerType,\n} from \"./types\";\n\n/**\n * Wrap Metro configuration with soda-gql support.\n *\n * This function modifies the Metro configuration to use the soda-gql\n * transformer, which applies GraphQL code transformations at build time.\n *\n * If the config already has a custom `babelTransformerPath` set (e.g., from\n * react-native-svg-transformer), soda-gql will automatically chain with it.\n *\n * @example\n * ```typescript\n * // Expo project (metro.config.js)\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // React Native bare project (metro.config.js)\n * const { getDefaultConfig, mergeConfig } = require(\"@react-native/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Chaining with another transformer (e.g., react-native-svg-transformer)\n * // The existing babelTransformerPath is automatically detected and chained.\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * config.transformer.babelTransformerPath = require.resolve(\"react-native-svg-transformer\");\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Explicitly specifying upstream transformer\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   upstreamTransformer: require.resolve(\"react-native-svg-transformer\"),\n * });\n * ```\n *\n * @param config - The Metro configuration to wrap\n * @param options - Optional plugin configuration\n * @returns Modified Metro configuration with soda-gql transformer\n */\nexport function withSodaGql<T extends MetroConfig>(config: T, options: MetroPluginOptions = {}): T {\n  // Use package export path to ensure correct resolution from any location\n  const transformerPath = require.resolve(\"@soda-gql/metro-plugin/transformer\");\n\n  // Store transformer type in shared state for the transformer module to read\n  const stateKey = getStateKey(options.configPath);\n  if (options.transformer) {\n    setSharedTransformerType(stateKey, options.transformer);\n  }\n\n  // Determine upstream transformer path:\n  // 1. Explicit option takes precedence\n  // 2. Fall back to existing babelTransformerPath from config (auto-detect)\n  const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;\n\n  // Build sodaGqlTransformerOptions to pass to the transformer\n  const sodaGqlTransformerOptions: SodaGqlTransformerOptions = {\n    ...(upstreamTransformer && { upstreamTransformer }),\n    ...(options.configPath && { configPath: options.configPath }),\n    ...(options.transformer && { transformerType: options.transformer }),\n  };\n\n  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n      // Pass options to transformer via Metro config\n      ...(Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }),\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqEA,SAAgB,YAAmC,QAAW,UAA8B,EAAE,EAAK;CAEjG,MAAM,4BAA0B,QAAQ,qCAAqC;CAG7E,MAAM,WAAWA,cAAY,QAAQ,WAAW;AAChD,KAAI,QAAQ,YACV,0BAAyB,UAAU,QAAQ,YAAY;CAMzD,MAAM,sBAAsB,QAAQ,uBAAuB,OAAO,aAAa;CAG/E,MAAMC,4BAAuD;EAC3D,GAAI,uBAAuB,EAAE,qBAAqB;EAClD,GAAI,QAAQ,cAAc,EAAE,YAAY,QAAQ,YAAY;EAC5D,GAAI,QAAQ,eAAe,EAAE,iBAAiB,QAAQ,aAAa;EACpE;AAED,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GAEtB,GAAI,OAAO,KAAK,0BAA0B,CAAC,SAAS,KAAK,EAAE,2BAA2B;GACvF;EACF"}
+{"version":3,"file":"index.mjs","names":["getStateKey","transformerPath: string","resolvedUpstream: string"],"sources":["../src/wrapper-generator.ts","../src/index.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/** Cache directory location relative to project root */\nconst CACHE_DIR = \"node_modules/.cache/soda-gql\";\n\n/** Wrapper file name suffix */\nconst WRAPPER_FILE = \"metro-transformer-wrapper.js\";\n\n/**\n * Options for generating wrapper transformer.\n */\nexport type WrapperGeneratorOptions = {\n  /** Absolute path to the upstream transformer to chain */\n  readonly upstreamTransformerPath: string;\n  /** Absolute path to the project root */\n  readonly projectRoot: string;\n};\n\n/**\n * Generate a deterministic hash for cache key.\n * Includes version prefix for cache invalidation on plugin updates.\n */\nexport function generateCacheKey(upstreamPath: string): string {\n  const hash = createHash(\"md5\");\n  hash.update(\"@soda-gql/metro-plugin:wrapper:v1\");\n  hash.update(upstreamPath);\n  return hash.digest(\"hex\").slice(0, 12);\n}\n\n/**\n * Generate wrapper transformer content.\n * The generated file imports soda-gql transformer factory and creates\n * a transformer instance with the hardcoded upstream path.\n */\nexport function generateWrapperContent(upstreamPath: string): string {\n  return `// Generated by @soda-gql/metro-plugin\n// DO NOT EDIT - This file is auto-generated\n// Upstream: ${upstreamPath}\n\nconst { createTransformerWithUpstream } = require(\"@soda-gql/metro-plugin/transformer\");\n\nconst transformer = createTransformerWithUpstream(${JSON.stringify(upstreamPath)});\n\nmodule.exports = transformer;\nmodule.exports.transform = transformer.transform;\nmodule.exports.getCacheKey = transformer.getCacheKey;\n`;\n}\n\n/**\n * Get or create wrapper transformer file.\n * Returns the absolute path to the wrapper file.\n *\n * The wrapper file is cached based on the upstream transformer path.\n * If the file already exists with the same content, it is reused.\n *\n * @param options - Wrapper generator options\n * @returns Absolute path to the wrapper transformer file\n */\nexport function ensureWrapperTransformer(options: WrapperGeneratorOptions): string {\n  const { upstreamTransformerPath, projectRoot } = options;\n\n  const cacheDir = join(projectRoot, CACHE_DIR);\n  const cacheKey = generateCacheKey(upstreamTransformerPath);\n  const wrapperPath = join(cacheDir, `${cacheKey}-${WRAPPER_FILE}`);\n\n  // Generate expected content\n  const expectedContent = generateWrapperContent(upstreamTransformerPath);\n\n  // Check if wrapper needs regeneration\n  if (existsSync(wrapperPath)) {\n    try {\n      const existingContent = readFileSync(wrapperPath, \"utf-8\");\n      if (existingContent === expectedContent) {\n        return wrapperPath;\n      }\n    } catch {\n      // File exists but couldn't be read, regenerate\n    }\n  }\n\n  // Create cache directory if it doesn't exist\n  mkdirSync(cacheDir, { recursive: true });\n\n  // Write wrapper file\n  writeFileSync(wrapperPath, expectedContent, \"utf-8\");\n\n  return wrapperPath;\n}\n","import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions } from \"./types\";\nimport { ensureWrapperTransformer } from \"./wrapper-generator\";\n\n// Re-export shared state utilities for advanced usage\nexport { getSharedArtifact, getSharedState, getStateKey } from \"@soda-gql/builder/plugin-support\";\nexport type {\n  MetroConfig,\n  MetroPluginOptions,\n  MetroTransformer,\n  MetroTransformParams,\n  MetroTransformResult,\n  TransformerType,\n} from \"./types\";\n\n/**\n * Wrap Metro configuration with soda-gql support.\n *\n * This function modifies the Metro configuration to use the soda-gql\n * transformer, which applies GraphQL code transformations at build time.\n *\n * If the config already has a custom `babelTransformerPath` set (e.g., from\n * react-native-svg-transformer), soda-gql will automatically chain with it.\n *\n * @example\n * ```typescript\n * // Expo project (metro.config.js)\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // React Native bare project (metro.config.js)\n * const { getDefaultConfig, mergeConfig } = require(\"@react-native/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Chaining with another transformer (e.g., react-native-svg-transformer)\n * // The existing babelTransformerPath is automatically detected and chained.\n * const { getDefaultConfig } = require(\"expo/metro-config\");\n * const { withSodaGql } = require(\"@soda-gql/metro-plugin\");\n *\n * const config = getDefaultConfig(__dirname);\n * config.transformer.babelTransformerPath = require.resolve(\"react-native-svg-transformer\");\n * module.exports = withSodaGql(config);\n * ```\n *\n * @example\n * ```typescript\n * // Explicitly specifying upstream transformer\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   upstreamTransformer: require.resolve(\"react-native-svg-transformer\"),\n * });\n * ```\n *\n * @param config - The Metro configuration to wrap\n * @param options - Optional plugin configuration\n * @returns Modified Metro configuration with soda-gql transformer\n */\nexport function withSodaGql<T extends MetroConfig>(config: T, options: MetroPluginOptions = {}): T {\n  // Store transformer type in shared state for the transformer module to read\n  const stateKey = getStateKey(options.configPath);\n  if (options.transformer) {\n    setSharedTransformerType(stateKey, options.transformer);\n  }\n\n  // Determine upstream transformer path:\n  // 1. Explicit option takes precedence\n  // 2. Fall back to existing babelTransformerPath from config (auto-detect)\n  const upstreamTransformer = options.upstreamTransformer ?? config.transformer?.babelTransformerPath;\n\n  let transformerPath: string;\n\n  if (upstreamTransformer) {\n    // Resolve upstream to absolute path for reliable worker loading\n    let resolvedUpstream: string;\n    try {\n      resolvedUpstream = require.resolve(upstreamTransformer, {\n        paths: [process.cwd()],\n      });\n    } catch {\n      // If resolution fails, use the path as-is (might be an absolute path already)\n      resolvedUpstream = upstreamTransformer;\n    }\n\n    // Generate wrapper transformer with hardcoded upstream\n    transformerPath = ensureWrapperTransformer({\n      upstreamTransformerPath: resolvedUpstream,\n      projectRoot: process.cwd(),\n    });\n  } else {\n    // No upstream - use main transformer directly\n    transformerPath = require.resolve(\"@soda-gql/metro-plugin/transformer\");\n  }\n\n  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;AAKA,MAAM,YAAY;;AAGlB,MAAM,eAAe;;;;;AAgBrB,SAAgB,iBAAiB,cAA8B;CAC7D,MAAM,OAAO,WAAW,MAAM;AAC9B,MAAK,OAAO,oCAAoC;AAChD,MAAK,OAAO,aAAa;AACzB,QAAO,KAAK,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;;;;;AAQxC,SAAgB,uBAAuB,cAA8B;AACnE,QAAO;;eAEM,aAAa;;;;oDAIwB,KAAK,UAAU,aAAa,CAAC;;;;;;;;;;;;;;;;;AAkBjF,SAAgB,yBAAyB,SAA0C;CACjF,MAAM,EAAE,yBAAyB,gBAAgB;CAEjD,MAAM,WAAW,KAAK,aAAa,UAAU;CAE7C,MAAM,cAAc,KAAK,UAAU,GADlB,iBAAiB,wBAAwB,CACX,GAAG,eAAe;CAGjE,MAAM,kBAAkB,uBAAuB,wBAAwB;AAGvE,KAAI,WAAW,YAAY,CACzB,KAAI;AAEF,MADwB,aAAa,aAAa,QAAQ,KAClC,gBACtB,QAAO;SAEH;AAMV,WAAU,UAAU,EAAE,WAAW,MAAM,CAAC;AAGxC,eAAc,aAAa,iBAAiB,QAAQ;AAEpD,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACpBT,SAAgB,YAAmC,QAAW,UAA8B,EAAE,EAAK;CAEjG,MAAM,WAAWA,cAAY,QAAQ,WAAW;AAChD,KAAI,QAAQ,YACV,0BAAyB,UAAU,QAAQ,YAAY;CAMzD,MAAM,sBAAsB,QAAQ,uBAAuB,OAAO,aAAa;CAE/E,IAAIC;AAEJ,KAAI,qBAAqB;EAEvB,IAAIC;AACJ,MAAI;AACF,gCAA2B,QAAQ,qBAAqB,EACtD,OAAO,CAAC,QAAQ,KAAK,CAAC,EACvB,CAAC;UACI;AAEN,sBAAmB;;AAIrB,oBAAkB,yBAAyB;GACzC,yBAAyB;GACzB,aAAa,QAAQ,KAAK;GAC3B,CAAC;OAGF,6BAA0B,QAAQ,qCAAqC;AAGzE,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GACvB;EACF"}

package/dist/transformer.cjs

@@ -819,10 +819,6 @@ const UPSTREAM_TRANSFORMER_CANDIDATES = [
 */
 let upstreamTransformer = null;
 /**
-* Cached custom upstream transformer path (from sodaGqlTransformerOptions).
-*/
-let customUpstreamPath = null;
-/**
 * Try to resolve a module from multiple locations.
 * Falls back through various resolution strategies.
 */
@@ -836,29 +832,11 @@ const tryResolve = (moduleName) => {
 	return null;
 };
 /**
-* Set custom upstream transformer path from options.
-* Called once during the first transform to capture the path from Metro options.
-*/
-const setCustomUpstreamPath = (sodaGqlOptions) => {
-	if (customUpstreamPath !== null) return;
-	customUpstreamPath = sodaGqlOptions?.upstreamTransformer ?? null;
-};
-/**
 * Detect and load the upstream Metro Babel transformer.
-* Priority:
-* 1. Custom upstream path from sodaGqlTransformerOptions (set via setCustomUpstreamPath)
-* 2. Default candidates in order of preference
+* Tries candidates in order of preference.
 */
 const getUpstreamTransformer = () => {
 	if (upstreamTransformer) return upstreamTransformer;
-	if (customUpstreamPath) {
-		const resolved = tryResolve(customUpstreamPath);
-		if (resolved) {
-			upstreamTransformer = require(resolved);
-			return upstreamTransformer;
-		}
-		console.warn(`[@soda-gql/metro-plugin] Custom upstream transformer not found: ${customUpstreamPath}. Falling back to default transformers.`);
-	}
 	for (const candidate of UPSTREAM_TRANSFORMER_CANDIDATES) {
 		const resolved = tryResolve(candidate);
 		if (resolved) {
@@ -920,10 +898,16 @@ const initializeSwcTransformer = async (artifact, config) => {
 * Wraps the upstream Metro Babel transformer.
 */
 async function transform(params) {
+	return transformCore(params, getUpstreamTransformer);
+}
+/**
+* Core transformation logic.
+* @internal
+*/
+async function transformCore(params, getUpstream) {
 	const { src, filename, options } = params;
 	const stateKey = (0, __soda_gql_builder_plugin_support.getStateKey)();
-	setCustomUpstreamPath(options.sodaGqlTransformerOptions);
-	const upstream = getUpstreamTransformer();
+	const upstream = getUpstream();
 	const session = ensurePluginSession();
 	if (!session) return upstream.transform(params);
 	let artifact = (0, __soda_gql_builder_plugin_support.getSharedArtifact)(stateKey);
@@ -995,11 +979,19 @@ async function transform(params) {
 * Includes artifact generation to ensure cache invalidation when models change.
 */
 function getCacheKey() {
+	return getCacheKeyCore(getUpstreamTransformer);
+}
+/**
+* Core cache key generation logic.
+* @internal
+*/
+function getCacheKeyCore(getUpstream, upstreamPath) {
 	const state = (0, __soda_gql_builder_plugin_support.getSharedState)((0, __soda_gql_builder_plugin_support.getStateKey)());
 	const artifact = state.currentArtifact;
-	const upstream = getUpstreamTransformer();
+	const upstream = getUpstream();
 	const hash = node_crypto.default.createHash("md5");
-	hash.update("@soda-gql/metro-plugin:v2");
+	hash.update("@soda-gql/metro-plugin:v3");
+	if (upstreamPath) hash.update(upstreamPath);
 	if (upstream.getCacheKey) hash.update(upstream.getCacheKey());
 	hash.update(String(state.generation));
 	if (artifact) {
@@ -1008,9 +1000,39 @@ function getCacheKey() {
 	}
 	return hash.digest("hex");
 }
+/**
+* Create a transformer with a specific upstream transformer path.
+* Used by generated wrapper files to inject the upstream path at build time.
+*
+* @param upstreamPath - Absolute path to the upstream transformer module
+* @returns MetroTransformer instance configured with the specified upstream
+*/
+function createTransformerWithUpstream(upstreamPath) {
+	let cachedUpstream = null;
+	const getUpstream = () => {
+		if (cachedUpstream) return cachedUpstream;
+		const resolved = tryResolve(upstreamPath);
+		if (!resolved) throw new Error(`[@soda-gql/metro-plugin] Upstream transformer not found: ${upstreamPath}`);
+		cachedUpstream = require(resolved);
+		return cachedUpstream;
+	};
+	return {
+		transform: (params) => transformCore(params, getUpstream),
+		getCacheKey: () => getCacheKeyCore(getUpstream, upstreamPath)
+	};
+}
+/**
+* Reset upstream transformer cache for testing.
+* @internal
+*/
+function __resetUpstreamTransformer() {
+	upstreamTransformer = null;
+}
 
 //#endregion
+exports.__resetUpstreamTransformer = __resetUpstreamTransformer;
 exports.__toESM = __toESM;
+exports.createTransformerWithUpstream = createTransformerWithUpstream;
 exports.getCacheKey = getCacheKey;
 exports.transform = transform;
 //# sourceMappingURL=transformer.cjs.map