fix(maps-web): check apiKeyExp existence before falling back to static apiKey

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: iobuhov

packages/pluggableWidgets/maps-web/openspec/changes/archive/2026-06-17-maps-api-key-atom/specs/api-key-atom/spec.md

@@ -6,18 +6,26 @@ The Maps container SHALL provide a `ComputedAtom<string | null>` that reactively
 
 #### Scenario: Expression value takes priority
 
-- **WHEN** `apiKeyExp.value` is a non-empty string
+- **WHEN** `apiKeyExp` is configured (not undefined)
+- **AND** `apiKeyExp.value` is a non-empty string
 - **THEN** the atom returns that value
 
+#### Scenario: Returns null while expression is loading
+
+- **WHEN** `apiKeyExp` is configured (not undefined)
+- **AND** `apiKeyExp.value` is undefined (still loading)
+- **THEN** the atom returns `null`
+
 #### Scenario: Falls back to static apiKey
 
-- **WHEN** `apiKeyExp.value` is undefined or empty
+- **WHEN** `apiKeyExp` is undefined (not configured)
 - **AND** `apiKey` is a non-empty string
 - **THEN** the atom returns the static `apiKey` value
 
 #### Scenario: Returns null when no key available
 
-- **WHEN** both `apiKeyExp.value` and `apiKey` are empty or undefined
+- **WHEN** `apiKeyExp` is undefined
+- **AND** `apiKey` is empty or undefined
 - **THEN** the atom returns `null`
 
 ### Requirement: API key cached once resolved
@@ -45,18 +53,26 @@ The Maps container SHALL provide a `ComputedAtom<string | null>` that reactively
 
 #### Scenario: Expression value takes priority
 
-- **WHEN** `geodecodeApiKeyExp.value` is a non-empty string
+- **WHEN** `geodecodeApiKeyExp` is configured (not undefined)
+- **AND** `geodecodeApiKeyExp.value` is a non-empty string
 - **THEN** the atom returns that value
 
+#### Scenario: Returns null while expression is loading
+
+- **WHEN** `geodecodeApiKeyExp` is configured (not undefined)
+- **AND** `geodecodeApiKeyExp.value` is undefined (still loading)
+- **THEN** the atom returns `null`
+
 #### Scenario: Falls back to static geodecodeApiKey
 
-- **WHEN** `geodecodeApiKeyExp.value` is undefined or empty
+- **WHEN** `geodecodeApiKeyExp` is undefined (not configured)
 - **AND** `geodecodeApiKey` is a non-empty string
 - **THEN** the atom returns the static `geodecodeApiKey` value
 
 #### Scenario: Returns null when no key available
 
-- **WHEN** both `geodecodeApiKeyExp.value` and `geodecodeApiKey` are empty or undefined
+- **WHEN** `geodecodeApiKeyExp` is undefined
+- **AND** `geodecodeApiKey` is empty or undefined
 - **THEN** the atom returns `null`
 
 ### Requirement: Geodecode API key cached once resolved

packages/pluggableWidgets/maps-web/src/model/atoms/apiKey.atom.ts

@@ -6,7 +6,8 @@ export function apiKeyAtom(gate: DerivedPropsGate<MapsContainerProps>): Computed
     let cached: string | null = null;
     return computed(() => {
         if (cached !== null) return cached;
-        const value = (gate.props.apiKeyExp?.value ?? gate.props.apiKey) || null;
+        const value =
+            gate.props.apiKeyExp !== undefined ? gate.props.apiKeyExp.value || null : gate.props.apiKey || null;
         if (value) cached = value;
         return value;
     });

packages/pluggableWidgets/maps-web/src/model/atoms/geodecodeApiKey.atom.ts

@@ -6,7 +6,10 @@ export function geodecodeApiKeyAtom(gate: DerivedPropsGate<MapsContainerProps>):
     let cached: string | null = null;
     return computed(() => {
         if (cached !== null) return cached;
-        const value = (gate.props.geodecodeApiKeyExp?.value ?? gate.props.geodecodeApiKey) || null;
+        const value =
+            gate.props.geodecodeApiKeyExp !== undefined
+                ? gate.props.geodecodeApiKeyExp.value || null
+                : gate.props.geodecodeApiKey || null;
         if (value) cached = value;
         return value;
     });