@soda-gql/metro-plugin 0.11.0 → 0.11.2

package/README.md

@@ -84,6 +84,7 @@ The plugin automatically detects and uses the appropriate upstream transformer:
 | `configPath` | `string` | `undefined` | Path to soda-gql config file |
 | `enabled` | `boolean` | `true` | Enable/disable the plugin |
 | `debug` | `boolean` | `false` | Enable verbose logging |
+| `upstreamTransformer` | `string` | `undefined` | Explicit path to upstream transformer to chain |
 
 ## Watch Mode Considerations
 
@@ -105,7 +106,11 @@ npx react-native start --reset-cache
 
 ## Chaining with Other Transformers
 
-If you need to chain with other transformers (e.g., react-native-svg-transformer), ensure soda-gql's transformer is applied first:
+When using other Metro transformers (e.g., react-native-svg-transformer), soda-gql automatically detects and chains with them.
+
+### Automatic Chaining (Recommended)
+
+If you set `babelTransformerPath` before calling `withSodaGql`, it will be automatically preserved and chained:
 
 ```javascript
 // metro.config.js
@@ -114,17 +119,26 @@ const { withSodaGql } = require("@soda-gql/metro-plugin");
 
 const config = getDefaultConfig(__dirname);
 
-// Apply soda-gql first
-const sodaGqlConfig = withSodaGql(config);
-
-// Then chain other transformers
-module.exports = {
-  ...sodaGqlConfig,
-  transformer: {
-    ...sodaGqlConfig.transformer,
-    // Additional transformer customizations
-  },
-};
+// Set the other transformer first
+config.transformer.babelTransformerPath = require.resolve("react-native-svg-transformer");
+
+// soda-gql will automatically chain with it
+module.exports = withSodaGql(config);
+```
+
+### Explicit Upstream Transformer
+
+You can also explicitly specify the upstream transformer via options:
+
+```javascript
+// metro.config.js
+const { getDefaultConfig } = require("expo/metro-config");
+const { withSodaGql } = require("@soda-gql/metro-plugin");
+
+const config = getDefaultConfig(__dirname);
+module.exports = withSodaGql(config, {
+  upstreamTransformer: require.resolve("react-native-svg-transformer"),
+});
 ```
 
 ## Troubleshooting

package/dist/index.cjs

@@ -8,6 +8,9 @@ let __soda_gql_builder_plugin_support = require("@soda-gql/builder/plugin-suppor
 * This function modifies the Metro configuration to use the soda-gql
 * transformer, which applies GraphQL code transformations at build time.
 *
+* If the config already has a custom `babelTransformerPath` set (e.g., from
+* react-native-svg-transformer), soda-gql will automatically chain with it.
+*
 * @example
 * ```typescript
 * // Expo project (metro.config.js)
@@ -30,11 +33,22 @@ let __soda_gql_builder_plugin_support = require("@soda-gql/builder/plugin-suppor
 *
 * @example
 * ```typescript
-* // With options
+* // Chaining with another transformer (e.g., react-native-svg-transformer)
+* // The existing babelTransformerPath is automatically detected and chained.
+* const { getDefaultConfig } = require("expo/metro-config");
+* const { withSodaGql } = require("@soda-gql/metro-plugin");
+*
+* const config = getDefaultConfig(__dirname);
+* config.transformer.babelTransformerPath = require.resolve("react-native-svg-transformer");
+* module.exports = withSodaGql(config);
+* ```
+*
+* @example
+* ```typescript
+* // Explicitly specifying upstream transformer
 * const config = getDefaultConfig(__dirname);
 * module.exports = withSodaGql(config, {
-*   configPath: "./soda-gql.config.ts",
-*   debug: true,
+*   upstreamTransformer: require.resolve("react-native-svg-transformer"),
 * });
 * ```
 *
@@ -46,11 +60,18 @@ 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 }
+	};
 	return {
 		...config,
 		transformer: {
 			...config.transformer,
-			babelTransformerPath: transformerPath
+			babelTransformerPath: transformerPath,
+			...Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }
 		}
 	};
 }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions } 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  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 * @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 * // With options\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   configPath: \"./soda-gql.config.ts\",\n *   debug: true,\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  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,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;AAGzD,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GACvB;EACF"}
+{"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"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as TransformerType, r as MetroTransformParams, t as MetroConfig } from "./types-C6LTFGZE.cjs";
+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 { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builder/plugin-support";
 
 //#region packages/metro-plugin/src/index.d.ts
@@ -9,6 +9,9 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  * This function modifies the Metro configuration to use the soda-gql
  * transformer, which applies GraphQL code transformations at build time.
  *
+ * If the config already has a custom `babelTransformerPath` set (e.g., from
+ * react-native-svg-transformer), soda-gql will automatically chain with it.
+ *
  * @example
  * ```typescript
  * // Expo project (metro.config.js)
@@ -31,11 +34,22 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  *
  * @example
  * ```typescript
- * // With options
+ * // Chaining with another transformer (e.g., react-native-svg-transformer)
+ * // The existing babelTransformerPath is automatically detected and chained.
+ * const { getDefaultConfig } = require("expo/metro-config");
+ * const { withSodaGql } = require("@soda-gql/metro-plugin");
+ *
+ * const config = getDefaultConfig(__dirname);
+ * config.transformer.babelTransformerPath = require.resolve("react-native-svg-transformer");
+ * module.exports = withSodaGql(config);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Explicitly specifying upstream transformer
  * const config = getDefaultConfig(__dirname);
  * module.exports = withSodaGql(config, {
- *   configPath: "./soda-gql.config.ts",
- *   debug: true,
+ *   upstreamTransformer: require.resolve("react-native-svg-transformer"),
  * });
  * ```
  *
@@ -45,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 TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
+export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type SodaGqlTransformerOptions, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;AAsDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,sBAAsB,qBAAqB,aAAY,qBAA0B"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;AAqEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,sBAAsB,qBAAqB,aAAY,qBAA0B"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as MetroTransformer, i as MetroTransformResult, n as MetroPluginOptions, o as TransformerType, r as MetroTransformParams, t as MetroConfig } from "./types-C88YiO8c.mjs";
+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 { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builder/plugin-support";
 
 //#region packages/metro-plugin/src/index.d.ts
@@ -9,6 +9,9 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  * This function modifies the Metro configuration to use the soda-gql
  * transformer, which applies GraphQL code transformations at build time.
  *
+ * If the config already has a custom `babelTransformerPath` set (e.g., from
+ * react-native-svg-transformer), soda-gql will automatically chain with it.
+ *
  * @example
  * ```typescript
  * // Expo project (metro.config.js)
@@ -31,11 +34,22 @@ import { getSharedArtifact, getSharedState, getStateKey } from "@soda-gql/builde
  *
  * @example
  * ```typescript
- * // With options
+ * // Chaining with another transformer (e.g., react-native-svg-transformer)
+ * // The existing babelTransformerPath is automatically detected and chained.
+ * const { getDefaultConfig } = require("expo/metro-config");
+ * const { withSodaGql } = require("@soda-gql/metro-plugin");
+ *
+ * const config = getDefaultConfig(__dirname);
+ * config.transformer.babelTransformerPath = require.resolve("react-native-svg-transformer");
+ * module.exports = withSodaGql(config);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Explicitly specifying upstream transformer
  * const config = getDefaultConfig(__dirname);
  * module.exports = withSodaGql(config, {
- *   configPath: "./soda-gql.config.ts",
- *   debug: true,
+ *   upstreamTransformer: require.resolve("react-native-svg-transformer"),
  * });
  * ```
  *
@@ -45,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 TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
+export { type MetroConfig, type MetroPluginOptions, type MetroTransformParams, type MetroTransformResult, type MetroTransformer, type SodaGqlTransformerOptions, type TransformerType, getSharedArtifact, getSharedState, getStateKey, withSodaGql };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;AAsDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,sBAAsB,qBAAqB,aAAY,qBAA0B"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;AAqEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAgB,sBAAsB,qBAAqB,aAAY,qBAA0B"}

package/dist/index.mjs

@@ -8,6 +8,9 @@ import { getSharedArtifact, getSharedState, getStateKey, getStateKey as getState
 * This function modifies the Metro configuration to use the soda-gql
 * transformer, which applies GraphQL code transformations at build time.
 *
+* If the config already has a custom `babelTransformerPath` set (e.g., from
+* react-native-svg-transformer), soda-gql will automatically chain with it.
+*
 * @example
 * ```typescript
 * // Expo project (metro.config.js)
@@ -30,11 +33,22 @@ import { getSharedArtifact, getSharedState, getStateKey, getStateKey as getState
 *
 * @example
 * ```typescript
-* // With options
+* // Chaining with another transformer (e.g., react-native-svg-transformer)
+* // The existing babelTransformerPath is automatically detected and chained.
+* const { getDefaultConfig } = require("expo/metro-config");
+* const { withSodaGql } = require("@soda-gql/metro-plugin");
+*
+* const config = getDefaultConfig(__dirname);
+* config.transformer.babelTransformerPath = require.resolve("react-native-svg-transformer");
+* module.exports = withSodaGql(config);
+* ```
+*
+* @example
+* ```typescript
+* // Explicitly specifying upstream transformer
 * const config = getDefaultConfig(__dirname);
 * module.exports = withSodaGql(config, {
-*   configPath: "./soda-gql.config.ts",
-*   debug: true,
+*   upstreamTransformer: require.resolve("react-native-svg-transformer"),
 * });
 * ```
 *
@@ -46,11 +60,18 @@ 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 }
+	};
 	return {
 		...config,
 		transformer: {
 			...config.transformer,
-			babelTransformerPath: transformerPath
+			babelTransformerPath: transformerPath,
+			...Object.keys(sodaGqlTransformerOptions).length > 0 && { sodaGqlTransformerOptions }
 		}
 	};
 }

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["getStateKey"],"sources":["../src/index.ts"],"sourcesContent":["import { getStateKey, setSharedTransformerType } from \"@soda-gql/builder/plugin-support\";\nimport type { MetroConfig, MetroPluginOptions } 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  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 * @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 * // With options\n * const config = getDefaultConfig(__dirname);\n * module.exports = withSodaGql(config, {\n *   configPath: \"./soda-gql.config.ts\",\n *   debug: true,\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  return {\n    ...config,\n    transformer: {\n      ...config.transformer,\n      babelTransformerPath: transformerPath,\n    },\n  } as T;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,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;AAGzD,QAAO;EACL,GAAG;EACH,aAAa;GACX,GAAG,OAAO;GACV,sBAAsB;GACvB;EACF"}
+{"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"}

package/dist/transformer.cjs

@@ -819,6 +819,10 @@ 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.
 */
@@ -832,11 +836,29 @@ 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.
-* Tries multiple candidates in order of preference.
+* Priority:
+* 1. Custom upstream path from sodaGqlTransformerOptions (set via setCustomUpstreamPath)
+* 2. Default 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) {
@@ -900,6 +922,7 @@ const initializeSwcTransformer = async (artifact, config) => {
 async function transform(params) {
 	const { src, filename, options } = params;
 	const stateKey = (0, __soda_gql_builder_plugin_support.getStateKey)();
+	setCustomUpstreamPath(options.sodaGqlTransformerOptions);
 	const upstream = getUpstreamTransformer();
 	const session = ensurePluginSession();
 	if (!session) return upstream.transform(params);