feat!: parse and validate Configuration from native getConfig

The codegen spec returns colorScheme and logLevel as `string`, but the
consumer-facing Configuration type uses typed enums. Replace the previous
`as Configuration` cast with a parser that:

- Validates colorScheme/logLevel against known enum values, falling back
  to the safest default when the native side returns an unrecognised value
- Re-shapes the flat iOS color fields into the nested `colors.ios` shape
  so a round trip through setConfig preserves user overrides
- Omits undefined fields so consumers don't see spurious `title: undefined`

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: kieran-osgood-shopify

modules/@shopify/checkout-sheet-kit/src/index.ts

@@ -64,6 +64,15 @@ const defaultFeatures: Features = {
   handleGeolocationRequests: true,
 };
 
+// TurboModule codegen doesn't support TypeScript string literal unions or
+// enums — spec types collapse to plain `string`. These sets are used by the
+// coercion helpers below to narrow the string back to the consumer-facing
+// enum, falling back to a safe default if native returns an unknown value.
+const colorSchemeValues: ReadonlySet<string> = new Set(
+  Object.values(ColorScheme),
+);
+const logLevelValues: ReadonlySet<string> = new Set(Object.values(LogLevel));
+
 class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
   private static eventEmitter: NativeEventEmitter = new NativeEventEmitter(
     RNShopifyCheckoutSheetKit,
@@ -145,7 +154,7 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
    * @returns The current Configuration
    */
   public getConfig(): Configuration {
-    return RNShopifyCheckoutSheetKit.getConfig() as Configuration;
+    return this.coerceConfigurationResult(RNShopifyCheckoutSheetKit.getConfig());
   }
 
   /**
@@ -391,6 +400,45 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
     return status === 'granted';
   }
 
+  /**
+   * Coerces a native Configuration result into the consumer-facing
+   * Configuration type.
+   *
+   * The TurboModule codegen spec can only express primitive types — string
+   * literal unions and TypeScript enums collapse to plain `string` at the
+   * bridge boundary. On the JS side consumers expect the typed `ColorScheme`
+   * and `LogLevel` enums, so we coerce those two fields here. The rest of
+   * the payload (preloading, title, nested colors) passes through unchanged.
+   */
+  private coerceConfigurationResult(
+    raw: ReturnType<typeof RNShopifyCheckoutSheetKit.getConfig>,
+  ): Configuration {
+    return {
+      ...raw,
+      logLevel: this.coerceLogLevel(raw.logLevel),
+      colorScheme: this.coerceColorScheme(raw.colorScheme),
+    } as Configuration;
+  }
+
+  /**
+   * Narrows a raw string from the native bridge to the ColorScheme enum.
+   * Falls back to `automatic` if the native side returns an unrecognised
+   * value (e.g. future SDK version adds a new scheme).
+   */
+  private coerceColorScheme(value: string): ColorScheme {
+    return colorSchemeValues.has(value)
+      ? (value as ColorScheme)
+      : ColorScheme.automatic;
+  }
+
+  /**
+   * Narrows a raw string from the native bridge to the LogLevel enum.
+   * Falls back to `error` (the safest default) on unrecognised values.
+   */
+  private coerceLogLevel(value: string): LogLevel {
+    return logLevelValues.has(value) ? (value as LogLevel) : LogLevel.error;
+  }
+
   /**
    * Parses custom pixel event data from string to object if needed
    * @param eventData The pixel event data to parse

modules/@shopify/checkout-sheet-kit/tests/context.test.tsx

@@ -349,7 +349,11 @@ describe('useShopifyCheckoutSheet', () => {
     );
 
     const config = hookValue.getConfig();
-    expect(config).toEqual({preloading: true});
+    expect(config).toEqual({
+      preloading: true,
+      colorScheme: 'automatic',
+      logLevel: 'error',
+    });
 
     expect(NativeModules.ShopifyCheckoutSheetKit.getConfig).toHaveBeenCalled();
   });

modules/@shopify/checkout-sheet-kit/tests/index.test.ts

@@ -160,10 +160,12 @@ describe('ShopifyCheckoutSheetKit', () => {
   });
 
   describe('getConfig', () => {
-    it('returns the config from the Native Module', () => {
+    it('returns the parsed config from the Native Module', () => {
       const instance = new ShopifyCheckoutSheet();
       expect(instance.getConfig()).toStrictEqual({
         preloading: true,
+        colorScheme: ColorScheme.automatic,
+        logLevel: LogLevel.error,
       });
       expect(
         NativeModule.getConfig,