@wildo-ai/saas-frontend-lib 1.1.6 → 1.1.7

package/dist/esm/core/external-providers/ProviderAddressLookupCombobox.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderAddressLookupCombobox.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderAddressLookupCombobox.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework's address-lookup COMPONENT, for any vendor that supplies a `ProviderAddressLookupAdapter` (#561).\n *\n * A vendor's lookup is four pure functions (build the suggest input, read the suggestions, build the retrieve\n * input, read the address). Everything else a lookup must get right is the same for every vendor and is written\n * once here:\n *\n * - **The keyboard and screen-reader pattern is the engine's `Combobox`**, not new markup: a trigger with\n *   `role=\"combobox\"` and `aria-expanded`, and inside it the command list whose text box is a WAI-ARIA combobox\n *   over a `listbox` — arrow keys move the active option, which is announced through `aria-activedescendant`,\n *   Enter chooses it and Escape closes the list. Server-side results, so the list is not filtered again locally.\n * - **Suggestions start at {@link PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH} characters and are debounced**\n *   by {@link PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS} (#561 D5): fewer characters match half a country, and a\n *   request per keystroke spends the person's per-operation allowance at the door.\n * - **A slower, older answer never replaces a newer one.** Each search carries a sequence number and only the\n *   latest may write the list — the ordinary way a typeahead shows results for text the person already changed.\n * - **Nothing vendor-owned is kept.** The suggestion's id lives only until the retrieval; the address that comes\n *   back is handed to `onSelect` and the field takes it as typed text.\n * - **Every failure is reported, never thrown** (`onError`), so the host can say the lookup is unavailable while\n *   the address parts below keep working by hand.\n *\n * The session token and the choice of backend operations are NOT here: the host binds `suggest` / `retrieve` to the\n * operations the provider declared and fills the token itself (#561 D4). The vendor attribution arrives from the host\n * as data and is shown here, inside the suggestion popup beside the results, by {@link ProviderAddressLookupAttribution}.\n */\n\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { z } from 'zod';\nimport { FormFieldAddressLookupLabel, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport type {\n  ProviderAddressLookupAdapter,\n  ProviderAddressLookupAttributionText,\n  ProviderAddressLookupProps,\n  ProviderAddressLookupSuggestion,\n} from '@wildo-ai/saas-models';\n\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { Combobox } from '~wildo-frontend-lib/components/form/combobox';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\n\n/** Characters typed before a search runs (#561 D5). */\nexport const PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH = 3;\n\n/** Quiet time after the last keystroke before a search runs, in milliseconds. */\nexport const PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS = 300;\n\n/** The search box holds text, never a stored value: the combobox is used for its interaction pattern only. */\nconst LOOKUP_QUERY_SCHEMA = z.string();\n\nexport interface ProviderAddressLookupComboboxProps extends ProviderAddressLookupProps {\n  /** The vendor's four functions. */\n  readonly adapter: ProviderAddressLookupAdapter;\n}\n\n/**\n * The vendor answered the retrieval, and the place it describes has no postal address the field can hold (no\n * street line, no town or no country). Reported through `onError` like any failure, as its own class so the host\n * can say \"this place cannot be used\" rather than \"the lookup is unavailable\" — the lookup worked.\n */\nexport class ProviderAddressLookupPlaceWithoutAddressError extends Error {\n  constructor() {\n    super('The chosen place has no postal address the field can hold.');\n    this.name = 'ProviderAddressLookupPlaceWithoutAddressError';\n  }\n}\n\n/**\n * A vendor's required attribution, rendered to the vendor's text rules (#561 D4).\n *\n * Google's rules for its \"Google Maps\" text, when its logo is not used: never translated (`translate=\"no\"`), never\n * wrapped onto two lines, weight 400, 12–16 px, normal letter spacing, and white, #1F1F1F or #5E5E5E with at least\n * 4.5:1 contrast against its background. The mark is therefore set in #1F1F1F on its own white ground, which keeps\n * that contrast on every theme the application ships — the one place a vendor's colours override the design\n * system's tokens, as a logo would. The sentence around it, for assistive technology, comes from the application's\n * labels; the mark itself is hidden from them so it is not read twice.\n * spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — \"Font color: White, black\n * (#1F1F1F), or gray (#5E5E5E)\", \"Don't wrap Google Maps onto multiple lines\", \"Prevent browsers from translating\n * Google Maps by using the HTML attribute translate='no'\". Fetched 2026-09-29.\n */\nexport function ProviderAddressLookupAttribution({ attribution }: { readonly attribution: ProviderAddressLookupAttributionText }): React.ReactElement {\n  return (\n    <span data-address-lookup-attribution=\"\" className=\"inline-flex\">\n      <span className=\"sr-only\">{attribution.accessibleLabel}</span>\n      <span\n        aria-hidden=\"true\"\n        translate=\"no\"\n        className=\"whitespace-nowrap rounded-sm px-1 text-xs font-normal tracking-normal\"\n        style={{ color: '#1F1F1F', backgroundColor: '#FFFFFF' }}\n      >\n        {attribution.mark}\n      </span>\n    </span>\n  );\n}\n\nfunction asError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value));\n}\n\nexport function ProviderAddressLookupCombobox(props: ProviderAddressLookupComboboxProps): React.ReactElement {\n  const { adapter, suggest, retrieve, onSelect, onCancel, onError, countriesAllowed, defaultCountry, languageCode, disabled, name, attribution } = props;\n  const { tComponent } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n  const label = (key: FormFieldAddressLookupLabel, params?: Record<string, string | number>) =>\n    tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, key, params);\n\n  const [query, setQuery] = useState('');\n  const [suggestions, setSuggestions] = useState<readonly ProviderAddressLookupSuggestion[]>([]);\n  const [searching, setSearching] = useState(false);\n  /** Incremented by every search and every reset; an answer is written only while it is still the latest. */\n  const sequenceRef = useRef(0);\n  /** Set while a chosen suggestion is being retrieved, so the list closing on a choice is not read as a cancel. */\n  const choosingRef = useRef(false);\n\n  const trimmed = query.trim();\n  const searchable = trimmed.length >= PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH;\n\n  useEffect(() => {\n    const sequence = ++sequenceRef.current;\n    if (!searchable || disabled) {\n      setSuggestions([]);\n      setSearching(false);\n      return undefined;\n    }\n    setSearching(true);\n    const timer = setTimeout(() => {\n      let input: Record<string, unknown>;\n      try {\n        input = adapter.buildSuggestInput({ query: trimmed, countriesAllowed, defaultCountry, languageCode });\n      } catch (error) {\n        setSearching(false);\n        onError(asError(error));\n        return;\n      }\n      suggest(input)\n        .then((output) => {\n          if (sequence !== sequenceRef.current) return;\n          setSuggestions(adapter.readSuggestions(output));\n        })\n        .catch((error: unknown) => {\n          if (sequence !== sequenceRef.current) return;\n          setSuggestions([]);\n          onError(asError(error));\n        })\n        .finally(() => {\n          if (sequence === sequenceRef.current) setSearching(false);\n        });\n    }, PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n    // `countriesAllowed` is an array the field re-creates per render; its content is what matters.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [trimmed, searchable, disabled, adapter, suggest, onError, languageCode, defaultCountry, (countriesAllowed ?? []).join(',')]);\n\n  // The option VALUE is the suggestion's position, never the vendor's id: the command list may normalise an item\n  // value (trim it), and a vendor id is opaque text the framework must hand back exactly as it came.\n  const options = useMemo<FieldOption<string, ProviderAddressLookupSuggestion>[]>(\n    () => suggestions.map((suggestion, index) => ({ value: `suggestion-${index}`, label: suggestion.primaryText, data: suggestion })),\n    [suggestions],\n  );\n\n  const reset = useCallback(() => {\n    sequenceRef.current += 1;\n    setQuery('');\n    setSuggestions([]);\n    setSearching(false);\n  }, []);\n\n  const handleChoose = useCallback(\n    (optionValue: string) => {\n      const suggestion = options.find((option) => option.value === optionValue)?.data;\n      if (suggestion === undefined) return;\n      choosingRef.current = true;\n      let input: Record<string, unknown>;\n      try {\n        input = adapter.buildRetrieveInput({ suggestion, languageCode });\n      } catch (error) {\n        choosingRef.current = false;\n        onError(asError(error));\n        return;\n      }\n      retrieve(input)\n        .then((output) => {\n          const address = adapter.readAddress(output);\n          if (address === undefined) {\n            onError(new ProviderAddressLookupPlaceWithoutAddressError());\n            return;\n          }\n          onSelect({ address });\n        })\n        .catch((error: unknown) => onError(asError(error)))\n        .finally(() => {\n          choosingRef.current = false;\n          reset();\n        });\n    },\n    [adapter, languageCode, onError, onSelect, options, reset, retrieve],\n  );\n\n  const handleOpenChange = useCallback(\n    (open: boolean) => {\n      if (open || choosingRef.current) return;\n      // Closed without a choice: the lookup session is abandoned, and the host starts a new one.\n      reset();\n      onCancel();\n    },\n    [onCancel, reset],\n  );\n\n  const emptyMessage = !searchable\n    ? label(FormFieldAddressLookupLabel.LOOKUP_TYPE_MORE, { minimum: PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH })\n    : label(FormFieldAddressLookupLabel.LOOKUP_NO_RESULTS);\n\n  return (\n    <Combobox\n      schema={LOOKUP_QUERY_SCHEMA}\n      name={name}\n      // Always empty: the trigger keeps inviting a search, and a chosen place lands in the address parts.\n      value=\"\"\n      options={options}\n      onChange={handleChoose}\n      onSearchChange={setQuery}\n      onOpenChange={handleOpenChange}\n      shouldFilter={false}\n      isLoading={searching}\n      disabled={disabled}\n      placeholder={label(FormFieldAddressLookupLabel.LOOKUP_PLACEHOLDER)}\n      searchPlaceholder={label(FormFieldAddressLookupLabel.LOOKUP_SEARCH_PLACEHOLDER)}\n      emptyMessage={emptyMessage}\n      // Inside the suggestion popup, below the results: the container the vendor's terms put the attribution in.\n      listFooter={attribution === undefined ? undefined : <ProviderAddressLookupAttribution attribution={attribution} />}\n      renderOption={(option) => {\n        // The combobox wrapper erases its option payload type; the payload is the suggestion set above.\n        const suggestion = option.data as ProviderAddressLookupSuggestion | undefined;\n        return (\n          <span className=\"flex min-w-0 flex-col\">\n            <span className=\"truncate\">{suggestion?.primaryText ?? option.label}</span>\n            {suggestion?.secondaryText ? <span className=\"truncate text-xs text-muted-foreground\">{suggestion.secondaryText}</span> : null}\n          </span>\n        );\n      }}\n    />\n  );\n}\n"]}
+{"version":3,"file":"ProviderAddressLookupCombobox.js","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderAddressLookupCombobox.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework's address-lookup COMPONENT, for any vendor that supplies a `ProviderAddressLookupAdapter` (#561).\n *\n * A vendor's lookup is four pure functions (build the suggest input, read the suggestions, build the retrieve\n * input, read the address). Everything else a lookup must get right is the same for every vendor and is written\n * once here:\n *\n * - **The keyboard and screen-reader pattern is the engine's `Combobox`**, not new markup: a trigger with\n *   `role=\"combobox\"` and `aria-expanded`, and inside it the command list whose text box is a WAI-ARIA combobox\n *   over a `listbox` — arrow keys move the active option, which is announced through `aria-activedescendant`,\n *   Enter chooses it and Escape closes the list. Server-side results, so the list is not filtered again locally.\n * - **Suggestions start at {@link PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH} characters and are debounced**\n *   by {@link PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS} (#561 D5): fewer characters match half a country, and a\n *   request per keystroke spends the person's per-operation allowance at the door.\n * - **A slower, older answer never replaces a newer one.** Each search carries a sequence number and only the\n *   latest may write the list — the ordinary way a typeahead shows results for text the person already changed.\n * - **Nothing vendor-owned is kept.** The suggestion's id lives only until the retrieval; the address that comes\n *   back is handed to `onSelect` and the field takes it as typed text.\n * - **Every failure is reported, never thrown** (`onError`), so the host can say the lookup is unavailable while\n *   the address parts below keep working by hand.\n *\n * The session token and the choice of backend operations are NOT here: the host binds `suggest` / `retrieve` to the\n * operations the provider declared and fills the token itself (#561 D4). The vendor attribution arrives from the host\n * as data and is shown here, inside the suggestion popup beside the results, by {@link ProviderAddressLookupAttribution}.\n */\n\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { z } from 'zod';\nimport { FormFieldAddressLookupLabel, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport type {\n  ProviderAddressLookupAdapter,\n  ProviderAddressLookupAttributionText,\n  ProviderAddressLookupProps,\n  ProviderAddressLookupSuggestion,\n} from '@wildo-ai/saas-models';\n\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { Combobox } from '~wildo-frontend-lib/components/form/combobox';\nimport type { FieldOption } from '~wildo-frontend-lib/components/form/form-field-types';\n\n/** Characters typed before a search runs (#561 D5). */\nexport const PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH = 3;\n\n/** Quiet time after the last keystroke before a search runs, in milliseconds. */\nexport const PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS = 300;\n\n/** The search box holds text, never a stored value: the combobox is used for its interaction pattern only. */\nconst LOOKUP_QUERY_SCHEMA = z.string();\n\nexport interface ProviderAddressLookupComboboxProps extends ProviderAddressLookupProps {\n  /** The vendor's four functions. */\n  readonly adapter: ProviderAddressLookupAdapter;\n}\n\n/**\n * The vendor answered the retrieval, and the place it describes has no postal address the field can hold (no\n * street line, no town or no country). Reported through `onError` like any failure, as its own class so the host\n * can say \"this place cannot be used\" rather than \"the lookup is unavailable\" — the lookup worked.\n */\nexport class ProviderAddressLookupPlaceWithoutAddressError extends Error {\n  constructor() {\n    super('The chosen place has no postal address the field can hold.');\n    this.name = 'ProviderAddressLookupPlaceWithoutAddressError';\n  }\n}\n\n/**\n * A vendor's required attribution, rendered to the vendor's text rules (#561 D4).\n *\n * Google's rules for its \"Google Maps\" text, when its logo is not used: never translated (`translate=\"no\"`), never\n * wrapped onto two lines, weight 400, 12–16 px, normal letter spacing, and white, #1F1F1F or #5E5E5E with at least\n * 4.5:1 contrast against its background. The mark is therefore set in #1F1F1F on its own white ground, which keeps\n * that contrast on every theme the application ships — the one place a vendor's colours override the design\n * system's tokens, as a logo would. The sentence around it, for assistive technology, comes from the application's\n * labels; the mark itself is hidden from them so it is not read twice.\n * spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — \"Font color: White, black\n * (#1F1F1F), or gray (#5E5E5E)\", \"Don't wrap Google Maps onto multiple lines\", \"Prevent browsers from translating\n * Google Maps by using the HTML attribute translate='no'\". Fetched 2026-09-29.\n */\nexport function ProviderAddressLookupAttribution({ attribution }: { readonly attribution: ProviderAddressLookupAttributionText }): React.ReactElement {\n  return (\n    <span data-address-lookup-attribution=\"\" className=\"inline-flex\">\n      <span className=\"sr-only\">{attribution.accessibleLabel}</span>\n      <span\n        aria-hidden=\"true\"\n        translate=\"no\"\n        className=\"whitespace-nowrap rounded-sm px-1 text-xs font-normal tracking-normal\"\n        style={{ color: '#1F1F1F', backgroundColor: '#FFFFFF' }}\n      >\n        {attribution.mark}\n      </span>\n    </span>\n  );\n}\n\nfunction asError(value: unknown): Error {\n  return value instanceof Error ? value : new Error(String(value));\n}\n\nexport function ProviderAddressLookupCombobox(props: ProviderAddressLookupComboboxProps): React.ReactElement {\n  const { adapter, suggest, retrieve, onSelect, onCancel, onError, countriesAllowed, defaultCountry, languageCode, disabled, name, attribution } = props;\n  const { tComponent } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n  const label = (key: FormFieldAddressLookupLabel, params?: Record<string, string | number>) =>\n    tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, key, params);\n\n  const [query, setQuery] = useState('');\n  const [suggestions, setSuggestions] = useState<readonly ProviderAddressLookupSuggestion[]>([]);\n  const [searching, setSearching] = useState(false);\n  /** Incremented by every search and every reset; an answer is written only while it is still the latest. */\n  const sequenceRef = useRef(0);\n  /** Set while a chosen suggestion is being retrieved, so the list closing on a choice is not read as a cancel. */\n  const choosingRef = useRef(false);\n\n  const trimmed = query.trim();\n  const searchable = trimmed.length >= PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH;\n\n  useEffect(() => {\n    const sequence = ++sequenceRef.current;\n    if (!searchable || disabled) {\n      setSuggestions([]);\n      setSearching(false);\n      return undefined;\n    }\n    setSearching(true);\n    const timer = setTimeout(() => {\n      let input: Record<string, unknown>;\n      try {\n        input = adapter.buildSuggestInput({ query: trimmed, countriesAllowed, defaultCountry, languageCode });\n      } catch (error) {\n        setSearching(false);\n        onError(asError(error));\n        return;\n      }\n      suggest(input)\n        .then((output) => {\n          if (sequence !== sequenceRef.current) return;\n          setSuggestions(adapter.readSuggestions(output));\n        })\n        .catch((error: unknown) => {\n          if (sequence !== sequenceRef.current) return;\n          setSuggestions([]);\n          onError(asError(error));\n        })\n        .finally(() => {\n          if (sequence === sequenceRef.current) setSearching(false);\n        });\n    }, PROVIDER_ADDRESS_LOOKUP_DEBOUNCE_MS);\n    return () => clearTimeout(timer);\n    // `countriesAllowed` is an array the field re-creates per render; its content is what matters.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [trimmed, searchable, disabled, adapter, suggest, onError, languageCode, defaultCountry, (countriesAllowed ?? []).join(',')]);\n\n  // The option VALUE is the suggestion's position, never the vendor's id: the command list may normalise an item\n  // value (trim it), and a vendor id is opaque text the framework must hand back exactly as it came.\n  const options = useMemo<FieldOption<string, ProviderAddressLookupSuggestion>[]>(\n    () => suggestions.map((suggestion, index) => ({ value: `suggestion-${index}`, label: suggestion.primaryText, data: suggestion })),\n    [suggestions],\n  );\n\n  const reset = useCallback(() => {\n    sequenceRef.current += 1;\n    setQuery('');\n    setSuggestions([]);\n    setSearching(false);\n  }, []);\n\n  const handleChoose = useCallback(\n    (optionValue: string) => {\n      const suggestion = options.find((option) => option.value === optionValue)?.data;\n      if (suggestion === undefined) return;\n      choosingRef.current = true;\n      let input: Record<string, unknown>;\n      try {\n        input = adapter.buildRetrieveInput({ suggestion, languageCode });\n      } catch (error) {\n        choosingRef.current = false;\n        onError(asError(error));\n        return;\n      }\n      retrieve(input)\n        .then((output) => {\n          const address = adapter.readAddress(output);\n          if (address === undefined) {\n            onError(new ProviderAddressLookupPlaceWithoutAddressError());\n            return;\n          }\n          onSelect({ address });\n        })\n        .catch((error: unknown) => onError(asError(error)))\n        .finally(() => {\n          choosingRef.current = false;\n          reset();\n        });\n    },\n    [adapter, languageCode, onError, onSelect, options, reset, retrieve],\n  );\n\n  const handleOpenChange = useCallback(\n    (open: boolean) => {\n      if (open || choosingRef.current) return;\n      // Closed without a choice: the lookup session is abandoned, and the host starts a new one.\n      reset();\n      onCancel();\n    },\n    [onCancel, reset],\n  );\n\n  const emptyMessage = !searchable\n    ? label(FormFieldAddressLookupLabel.LOOKUP_TYPE_MORE, { minimum: PROVIDER_ADDRESS_LOOKUP_MINIMUM_QUERY_LENGTH })\n    : label(FormFieldAddressLookupLabel.LOOKUP_NO_RESULTS);\n\n  return (\n    <Combobox\n      schema={LOOKUP_QUERY_SCHEMA}\n      name={name}\n      // Always empty: the trigger keeps inviting a search, and a chosen place lands in the address parts.\n      value=\"\"\n      options={options}\n      onChange={handleChoose}\n      onSearchChange={setQuery}\n      onOpenChange={handleOpenChange}\n      shouldFilter={false}\n      isLoading={searching}\n      disabled={disabled}\n      placeholder={label(FormFieldAddressLookupLabel.LOOKUP_PLACEHOLDER)}\n      searchPlaceholder={label(FormFieldAddressLookupLabel.LOOKUP_SEARCH_PLACEHOLDER)}\n      emptyMessage={emptyMessage}\n      // Inside the suggestion popup, below the results: the container the vendor's terms put the attribution in.\n      listFooter={attribution === undefined ? undefined : <ProviderAddressLookupAttribution attribution={attribution} />}\n      renderOption={(option) => {\n        // The combobox wrapper erases its option payload type; the payload is the suggestion set above.\n        const suggestion = option.data as ProviderAddressLookupSuggestion | undefined;\n        return (\n          <span className=\"flex min-w-0 flex-col\">\n            <span className=\"truncate\">{suggestion?.primaryText ?? option.label}</span>\n            {suggestion?.secondaryText ? <span className=\"truncate text-xs text-muted-foreground\">{suggestion.secondaryText}</span> : null}\n          </span>\n        );\n      }}\n    />\n  );\n}\n"]}

package/dist/esm/core/external-providers/ProviderAddressLookupHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderAddressLookupHost.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderAddressLookupHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkB7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAS5G,iFAAiF;AACjF,oBAAY,2BAA2B;IACrC,wDAAwD;IACxD,WAAW,gBAAgB;IAC3B,kDAAkD;IAClD,eAAe,oBAAoB;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,mHAAmH;IACnH,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAgB,yBAAyB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,8BAA8B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkKvI"}
+{"version":3,"file":"ProviderAddressLookupHost.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderAddressLookupHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkB7B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+DAA+D,CAAC;AAS5G,iFAAiF;AACjF,oBAAY,2BAA2B;IACrC,wDAAwD;IACxD,WAAW,gBAAgB;IAC3B,kDAAkD;IAClD,eAAe,oBAAoB;CACpC;AAED,MAAM,WAAW,8BAA8B;IAC7C,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,mHAAmH;IACnH,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAgB,yBAAyB,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,8BAA8B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAkKvI"}

package/dist/esm/core/external-providers/ProviderAddressLookupHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderAddressLookupHost.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderAddressLookupHost.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework side of an address lookup (#561): offer the live `FRONTEND_ADDRESS_LOOKUP` providers, load the\n * chosen one's component, run its vendor calls through the application backend, hold what it returns to the\n * field's own rules, and keep the field usable by hand whatever happens.\n *\n * `FormField` renders it in every `z_address()` field's `renderLookup` slot. With no live lookup provider — every\n * application that declared none — it renders NOTHING, and the field is the plain multi-part control.\n *\n * ## What the host ENFORCES, because a component could forget (#561 D2, D4)\n *\n * - **The vendor is reached only through the provider-operation door.** The component receives `suggest` and\n *   `retrieve`, bound to the two operations its descriptor declares and run through\n *   `POST /provider-operations/:providerRef/:operationId` on the application's own account. The page holds no\n *   vendor key; the backend admits each operation by `providers.browserOperations`, counts it against the person,\n *   and records it. A provider whose component declares no `addressLookup` operations is not offered at all.\n * - **One vendor session per lookup.** The host writes a UUIDv4 into the declared `sessionTokenInput` of every\n *   suggestion and of the retrieval, and starts a new one after a retrieval or when the lookup is abandoned — so a\n *   vendor that bills by session is never billed per keystroke by a component that forgot the token.\n * - **The vendor's attribution is handed to the component** from the descriptor's `attributionMark` — the mark\n *   verbatim and a sentence from the application's labels naming it — for the component to show inside its\n *   suggestion popup, the container the vendor's terms require (the framework combobox does, with\n *   `ProviderAddressLookupAttribution`).\n * - **The field decides.** A chosen address passes `receiveProviderAddressLookupSelection` against the field's own\n *   schema (countries, required parts) and the component's declared place-id retention before `applyAddress`; a\n *   refused one fills nothing and says so.\n *\n * ## Manual entry always works (#561 D5)\n *\n * A refusal, a throttle, a vendor timeout, a component that fails to load: each leaves the parts exactly as they\n * were, editable, and shows one status line telling the person to enter the address below. Nothing blocks the\n * form's submission.\n */\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport type { z } from 'zod';\nimport { ButtonSize, FormFieldAddressLookupLabel, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport type { ProviderAddressLookupProps, ProviderAddressLookupSelection, ProviderCapability } from '@wildo-ai/saas-models';\nimport { CoreResourceType, UserPrivacySchema } from '@wildo-ai/saas-models';\nimport { BUILTIN_PROVIDER_CAPABILITY, type ProviderAddressLookupDeclaration } from '@wildo-ai/saas-models/public-runtime';\nimport { getZodObjectShape } from '@wildo-ai/zod-decorators';\nimport { ProviderComponentStatus } from '@wildo-ai/external-connectors-public/app';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useGrantedConsentPurposes } from '~wildo-frontend-lib/core/security/useGrantedConsentPurposes';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport {\n  useProviderComponent,\n  useProviderComponentChoices,\n} from '~wildo-frontend-lib/core/components-registry/useProviderComponent.frontend.hooks';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { FieldLabel } from '~wildo-frontend-lib/components/form/chromes/field';\nimport type { AddressFieldLookupHost } from '~wildo-frontend-lib/components/form/fields/form-field-address';\nimport { receiveProviderAddressLookupSelection } from './provider-address-lookup-selection.frontend.utils';\nimport { ProviderAddressLookupPlaceWithoutAddressError } from './ProviderAddressLookupCombobox';\n\nconst ADDRESS_LOOKUP_CAPABILITY = BUILTIN_PROVIDER_CAPABILITY.FRONTEND_ADDRESS_LOOKUP as ProviderCapability;\n\n/** Consent purposes are worded through the field that stores a person's grant (#966), as the file field does. */\nconst CONSENTED_PURPOSES_FIELD_SCHEMA = getZodObjectShape(UserPrivacySchema).consentedPurposes;\n\n/** Why the lookup is showing a status line instead of (or beside) its search. */\nexport enum ProviderAddressLookupNotice {\n  /** The lookup could not run; the parts work by hand. */\n  UNAVAILABLE = 'UNAVAILABLE',\n  /** The chosen place could not fill this field. */\n  ADDRESS_REFUSED = 'ADDRESS_REFUSED',\n}\n\nexport interface ProviderAddressLookupHostProps {\n  /** What the field hands its `renderLookup` slot. */\n  readonly host: AddressFieldLookupHost;\n  /** The field's own `z_address()` schema: a chosen address it refuses is refused here, before it fills anything. */\n  readonly addressSchema: z.ZodType;\n  /** The field's form name; the lookup control is named `<name>.lookup`. */\n  readonly fieldName: string;\n}\n\n/** A fresh vendor session token: a version 4 UUID, as Google recommends for Places session tokens. */\nfunction newSessionToken(): string {\n  return globalThis.crypto.randomUUID();\n}\n\nexport function ProviderAddressLookupHost({ host, addressSchema, fieldName }: ProviderAddressLookupHostProps): React.ReactElement | null {\n  const { providerComponentRegistry, frontendProviderRegistry } = useApplication();\n  const { t, tComponent, tResourceFieldEnumValue, currentLanguage } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n  const label = (key: FormFieldAddressLookupLabel, params?: Record<string, string | number>) =>\n    tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, key, params);\n\n  const allChoices = useProviderComponentChoices(ADDRESS_LOOKUP_CAPABILITY);\n  // Offered only when the component declares how it reaches its vendor: without declared operations there is no\n  // call this host could make on its behalf, and a component making its own would bypass the door.\n  const choices = useMemo(\n    () => allChoices.filter((choice) => providerComponentRegistry?.describe(ADDRESS_LOOKUP_CAPABILITY, choice.providerRef)?.addressLookup !== undefined),\n    [allChoices, providerComponentRegistry],\n  );\n  const [pickedRef, setPickedRef] = useState<string | undefined>(undefined);\n  // A single provider needs no chooser; several are a genuine choice the person makes, never this host.\n  const chosen = pickedRef ?? (choices.length === 1 ? choices[0]?.providerRef : undefined);\n  const { status, Component, missingConsentPurposes } = useProviderComponent(ADDRESS_LOOKUP_CAPABILITY, chosen);\n  const { grant: grantConsent } = useGrantedConsentPurposes();\n  const [notice, setNotice] = useState<ProviderAddressLookupNotice | undefined>(undefined);\n\n  const descriptor = chosen === undefined ? undefined : providerComponentRegistry?.describe(ADDRESS_LOOKUP_CAPABILITY, chosen);\n  const declaration: ProviderAddressLookupDeclaration | undefined = descriptor?.addressLookup;\n\n  /** The current vendor session; `undefined` until the first call of a session needs one. */\n  const sessionTokenRef = useRef<string | undefined>(undefined);\n  const endSession = useCallback(() => {\n    sessionTokenRef.current = undefined;\n  }, []);\n\n  const run = useCallback(\n    async (operationId: string, input: Readonly<Record<string, unknown>>): Promise<unknown> => {\n      if (chosen === undefined) throw new Error('No address lookup provider is chosen.');\n      const tokenInput = declaration?.sessionTokenInput;\n      let sent: Record<string, unknown> = { ...input };\n      if (tokenInput !== undefined) {\n        sessionTokenRef.current ??= newSessionToken();\n        // Written by the host AFTER the component's input, so a component cannot send its own token instead.\n        sent = { ...sent, [tokenInput]: sessionTokenRef.current };\n      }\n      const answer = await getManualCallsHttpClient().executeProviderOperation(chosen, operationId, { input: sent });\n      return answer.output;\n    },\n    [chosen, declaration?.sessionTokenInput],\n  );\n\n  const suggest = useCallback(\n    (input: Readonly<Record<string, unknown>>) => {\n      if (declaration === undefined) return Promise.reject(new Error('The address lookup declares no operations.'));\n      return run(declaration.suggestOperationId, input);\n    },\n    [declaration, run],\n  );\n\n  const retrieve = useCallback(\n    (input: Readonly<Record<string, unknown>>) => {\n      if (declaration === undefined) return Promise.reject(new Error('The address lookup declares no operations.'));\n      // The retrieval ends the vendor session whatever it answers: the next search is a new session.\n      return run(declaration.retrieveOperationId, input).finally(endSession);\n    },\n    [declaration, endSession, run],\n  );\n\n  const handleSelect = useCallback(\n    (selection: ProviderAddressLookupSelection) => {\n      if (chosen === undefined) return;\n      endSession();\n      const outcome = receiveProviderAddressLookupSelection({ providerRef: chosen, descriptor, selection, addressSchema });\n      if (outcome.accepted === undefined) {\n        setNotice(ProviderAddressLookupNotice.ADDRESS_REFUSED);\n        return;\n      }\n      setNotice(undefined);\n      host.applyAddress(outcome.accepted.address);\n    },\n    [addressSchema, chosen, descriptor, endSession, host],\n  );\n\n  const handleCancel = useCallback(() => endSession(), [endSession]);\n\n  const handleError = useCallback((error: Error) => {\n    endSession();\n    // A place with no holdable address is the lookup WORKING and the place being unusable — said as such.\n    setNotice(error instanceof ProviderAddressLookupPlaceWithoutAddressError ? ProviderAddressLookupNotice.ADDRESS_REFUSED : ProviderAddressLookupNotice.UNAVAILABLE);\n  }, [endSession]);\n\n  if (choices.length === 0) return null;\n\n  const chosenChoice = choices.find((choice) => choice.providerRef === chosen);\n  const providerName = (choice: (typeof choices)[number]): string => t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef;\n  const lookupName = `${fieldName}.lookup`;\n  const Lookup = Component as React.ComponentType<ProviderAddressLookupProps> | null;\n  const failedToLoad = status === ProviderComponentStatus.UNAVAILABLE;\n  const shownNotice = failedToLoad ? ProviderAddressLookupNotice.UNAVAILABLE : notice;\n\n  return (\n    <div className=\"flex flex-col gap-1\" data-address-lookup={chosen ?? ''}>\n      <FieldLabel htmlFor={`field-${lookupName}`} className=\"text-sm text-muted-foreground\">\n        {label(FormFieldAddressLookupLabel.LOOKUP_LABEL)}\n      </FieldLabel>\n      {choices.length > 1 ? (\n        <div role=\"group\" className=\"flex flex-wrap gap-item-xs\">\n          {choices.map((choice) => (\n            <Button\n              key={choice.providerRef}\n              type=\"button\"\n              size={ButtonSize.SM}\n              variant={choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE}\n              aria-pressed={choice.providerRef === chosen}\n              onClick={() => { setNotice(undefined); endSession(); setPickedRef(choice.providerRef); }}\n            >\n              {providerName(choice)}\n            </Button>\n          ))}\n        </div>\n      ) : null}\n      {status === ProviderComponentStatus.CONSENT_REQUIRED && chosenChoice !== undefined ? (\n        <div role=\"status\" className=\"flex flex-wrap items-center gap-item-xs text-sm text-muted-foreground\">\n          {(() => {\n            const purposes = missingConsentPurposes\n              .map((purpose) => tResourceFieldEnumValue(CoreResourceType.USER_SELF_PREFERENCES, 'privacy.consentedPurposes', purpose, CONSENTED_PURPOSES_FIELD_SCHEMA))\n              .join(', ');\n            return (\n              <>\n                <span>{label(FormFieldAddressLookupLabel.LOOKUP_CONSENT_REQUIRED, { provider: providerName(chosenChoice), purposes })}</span>\n                {grantConsent === undefined ? null : (\n                  <Button type=\"button\" size={ButtonSize.SM} variant={ButtonVariants_Variant.OUTLINE} onClick={() => void grantConsent(missingConsentPurposes)}>\n                    {label(FormFieldAddressLookupLabel.LOOKUP_CONSENT_GRANT, { purposes })}\n                  </Button>\n                )}\n              </>\n            );\n          })()}\n        </div>\n      ) : null}\n      {status === ProviderComponentStatus.READY && Lookup !== null && chosen !== undefined && declaration !== undefined ? (\n        <>\n          <Lookup\n            providerRef={chosen}\n            publicConfig={frontendProviderRegistry?.getProviderByRef(chosen as never)?.publicConfig ?? {}}\n            {...(host.countriesAllowed !== undefined ? { countriesAllowed: host.countriesAllowed } : {})}\n            {...(host.defaultCountry !== undefined ? { defaultCountry: host.defaultCountry } : {})}\n            languageCode={currentLanguage}\n            disabled={host.disabled}\n            name={lookupName}\n            {...(declaration.attributionMark !== undefined\n              ? { attribution: { mark: declaration.attributionMark, accessibleLabel: label(FormFieldAddressLookupLabel.LOOKUP_ATTRIBUTION, { mark: declaration.attributionMark }) } }\n              : {})}\n            suggest={suggest}\n            retrieve={retrieve}\n            onSelect={handleSelect}\n            onCancel={handleCancel}\n            onError={handleError}\n          />\n        </>\n      ) : null}\n      {shownNotice !== undefined ? (\n        <p role=\"status\" className=\"text-sm text-muted-foreground\">\n          {label(shownNotice === ProviderAddressLookupNotice.UNAVAILABLE ? FormFieldAddressLookupLabel.LOOKUP_UNAVAILABLE : FormFieldAddressLookupLabel.LOOKUP_ADDRESS_REFUSED)}\n        </p>\n      ) : null}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ProviderAddressLookupHost.js","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderAddressLookupHost.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework side of an address lookup (#561): offer the live `FRONTEND_ADDRESS_LOOKUP` providers, load the\n * chosen one's component, run its vendor calls through the application backend, hold what it returns to the\n * field's own rules, and keep the field usable by hand whatever happens.\n *\n * `FormField` renders it in every `z_address()` field's `renderLookup` slot. With no live lookup provider — every\n * application that declared none — it renders NOTHING, and the field is the plain multi-part control.\n *\n * ## What the host ENFORCES, because a component could forget (#561 D2, D4)\n *\n * - **The vendor is reached only through the provider-operation door.** The component receives `suggest` and\n *   `retrieve`, bound to the two operations its descriptor declares and run through\n *   `POST /provider-operations/:providerRef/:operationId` on the application's own account. The page holds no\n *   vendor key; the backend admits each operation by `providers.browserOperations`, counts it against the person,\n *   and records it. A provider whose component declares no `addressLookup` operations is not offered at all.\n * - **One vendor session per lookup.** The host writes a UUIDv4 into the declared `sessionTokenInput` of every\n *   suggestion and of the retrieval, and starts a new one after a retrieval or when the lookup is abandoned — so a\n *   vendor that bills by session is never billed per keystroke by a component that forgot the token.\n * - **The vendor's attribution is handed to the component** from the descriptor's `attributionMark` — the mark\n *   verbatim and a sentence from the application's labels naming it — for the component to show inside its\n *   suggestion popup, the container the vendor's terms require (the framework combobox does, with\n *   `ProviderAddressLookupAttribution`).\n * - **The field decides.** A chosen address passes `receiveProviderAddressLookupSelection` against the field's own\n *   schema (countries, required parts) and the component's declared place-id retention before `applyAddress`; a\n *   refused one fills nothing and says so.\n *\n * ## Manual entry always works (#561 D5)\n *\n * A refusal, a throttle, a vendor timeout, a component that fails to load: each leaves the parts exactly as they\n * were, editable, and shows one status line telling the person to enter the address below. Nothing blocks the\n * form's submission.\n */\n\nimport React, { useCallback, useMemo, useRef, useState } from 'react';\nimport type { z } from 'zod';\nimport { ButtonSize, FormFieldAddressLookupLabel, FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport type { ProviderAddressLookupProps, ProviderAddressLookupSelection, ProviderCapability } from '@wildo-ai/saas-models';\nimport { CoreResourceType, UserPrivacySchema } from '@wildo-ai/saas-models';\nimport { BUILTIN_PROVIDER_CAPABILITY, type ProviderAddressLookupDeclaration } from '@wildo-ai/saas-models/public-runtime';\nimport { getZodObjectShape } from '@wildo-ai/zod-decorators';\nimport { ProviderComponentStatus } from '@wildo-ai/external-connectors-public/app';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useI18n } from '~wildo-frontend-lib/core/i18n/useI18n';\nimport { useGrantedConsentPurposes } from '~wildo-frontend-lib/core/security/useGrantedConsentPurposes';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport {\n  useProviderComponent,\n  useProviderComponentChoices,\n} from '~wildo-frontend-lib/core/components-registry/useProviderComponent.frontend.hooks';\nimport { Button, ButtonVariants_Variant } from '~wildo-frontend-lib/components/actions/button';\nimport { FieldLabel } from '~wildo-frontend-lib/components/form/chromes/field';\nimport type { AddressFieldLookupHost } from '~wildo-frontend-lib/components/form/fields/form-field-address';\nimport { receiveProviderAddressLookupSelection } from './provider-address-lookup-selection.frontend.utils';\nimport { ProviderAddressLookupPlaceWithoutAddressError } from './ProviderAddressLookupCombobox';\n\nconst ADDRESS_LOOKUP_CAPABILITY = BUILTIN_PROVIDER_CAPABILITY.FRONTEND_ADDRESS_LOOKUP as ProviderCapability;\n\n/** Consent purposes are worded through the field that stores a person's grant (#966), as the file field does. */\nconst CONSENTED_PURPOSES_FIELD_SCHEMA = getZodObjectShape(UserPrivacySchema).consentedPurposes;\n\n/** Why the lookup is showing a status line instead of (or beside) its search. */\nexport enum ProviderAddressLookupNotice {\n  /** The lookup could not run; the parts work by hand. */\n  UNAVAILABLE = 'UNAVAILABLE',\n  /** The chosen place could not fill this field. */\n  ADDRESS_REFUSED = 'ADDRESS_REFUSED',\n}\n\nexport interface ProviderAddressLookupHostProps {\n  /** What the field hands its `renderLookup` slot. */\n  readonly host: AddressFieldLookupHost;\n  /** The field's own `z_address()` schema: a chosen address it refuses is refused here, before it fills anything. */\n  readonly addressSchema: z.ZodType;\n  /** The field's form name; the lookup control is named `<name>.lookup`. */\n  readonly fieldName: string;\n}\n\n/** A fresh vendor session token: a version 4 UUID, as Google recommends for Places session tokens. */\nfunction newSessionToken(): string {\n  return globalThis.crypto.randomUUID();\n}\n\nexport function ProviderAddressLookupHost({ host, addressSchema, fieldName }: ProviderAddressLookupHostProps): React.ReactElement | null {\n  const { providerComponentRegistry, frontendProviderRegistry } = useApplication();\n  const { t, tComponent, tResourceFieldEnumValue, currentLanguage } = useI18n({ component: [FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS] });\n  const label = (key: FormFieldAddressLookupLabel, params?: Record<string, string | number>) =>\n    tComponent(FrontendComponentType.LOW_LEVEL_FORM_FIELD_ADDRESS, key, params);\n\n  const allChoices = useProviderComponentChoices(ADDRESS_LOOKUP_CAPABILITY);\n  // Offered only when the component declares how it reaches its vendor: without declared operations there is no\n  // call this host could make on its behalf, and a component making its own would bypass the door.\n  const choices = useMemo(\n    () => allChoices.filter((choice) => providerComponentRegistry?.describe(ADDRESS_LOOKUP_CAPABILITY, choice.providerRef)?.addressLookup !== undefined),\n    [allChoices, providerComponentRegistry],\n  );\n  const [pickedRef, setPickedRef] = useState<string | undefined>(undefined);\n  // A single provider needs no chooser; several are a genuine choice the person makes, never this host.\n  const chosen = pickedRef ?? (choices.length === 1 ? choices[0]?.providerRef : undefined);\n  const { status, Component, missingConsentPurposes } = useProviderComponent(ADDRESS_LOOKUP_CAPABILITY, chosen);\n  const { grant: grantConsent } = useGrantedConsentPurposes();\n  const [notice, setNotice] = useState<ProviderAddressLookupNotice | undefined>(undefined);\n\n  const descriptor = chosen === undefined ? undefined : providerComponentRegistry?.describe(ADDRESS_LOOKUP_CAPABILITY, chosen);\n  const declaration: ProviderAddressLookupDeclaration | undefined = descriptor?.addressLookup;\n\n  /** The current vendor session; `undefined` until the first call of a session needs one. */\n  const sessionTokenRef = useRef<string | undefined>(undefined);\n  const endSession = useCallback(() => {\n    sessionTokenRef.current = undefined;\n  }, []);\n\n  const run = useCallback(\n    async (operationId: string, input: Readonly<Record<string, unknown>>): Promise<unknown> => {\n      if (chosen === undefined) throw new Error('No address lookup provider is chosen.');\n      const tokenInput = declaration?.sessionTokenInput;\n      let sent: Record<string, unknown> = { ...input };\n      if (tokenInput !== undefined) {\n        sessionTokenRef.current ??= newSessionToken();\n        // Written by the host AFTER the component's input, so a component cannot send its own token instead.\n        sent = { ...sent, [tokenInput]: sessionTokenRef.current };\n      }\n      const answer = await getManualCallsHttpClient().executeProviderOperation(chosen, operationId, { input: sent });\n      return answer.output;\n    },\n    [chosen, declaration?.sessionTokenInput],\n  );\n\n  const suggest = useCallback(\n    (input: Readonly<Record<string, unknown>>) => {\n      if (declaration === undefined) return Promise.reject(new Error('The address lookup declares no operations.'));\n      return run(declaration.suggestOperationId, input);\n    },\n    [declaration, run],\n  );\n\n  const retrieve = useCallback(\n    (input: Readonly<Record<string, unknown>>) => {\n      if (declaration === undefined) return Promise.reject(new Error('The address lookup declares no operations.'));\n      // The retrieval ends the vendor session whatever it answers: the next search is a new session.\n      return run(declaration.retrieveOperationId, input).finally(endSession);\n    },\n    [declaration, endSession, run],\n  );\n\n  const handleSelect = useCallback(\n    (selection: ProviderAddressLookupSelection) => {\n      if (chosen === undefined) return;\n      endSession();\n      const outcome = receiveProviderAddressLookupSelection({ providerRef: chosen, descriptor, selection, addressSchema });\n      if (outcome.accepted === undefined) {\n        setNotice(ProviderAddressLookupNotice.ADDRESS_REFUSED);\n        return;\n      }\n      setNotice(undefined);\n      host.applyAddress(outcome.accepted.address);\n    },\n    [addressSchema, chosen, descriptor, endSession, host],\n  );\n\n  const handleCancel = useCallback(() => endSession(), [endSession]);\n\n  const handleError = useCallback((error: Error) => {\n    endSession();\n    // A place with no holdable address is the lookup WORKING and the place being unusable — said as such.\n    setNotice(error instanceof ProviderAddressLookupPlaceWithoutAddressError ? ProviderAddressLookupNotice.ADDRESS_REFUSED : ProviderAddressLookupNotice.UNAVAILABLE);\n  }, [endSession]);\n\n  if (choices.length === 0) return null;\n\n  const chosenChoice = choices.find((choice) => choice.providerRef === chosen);\n  const providerName = (choice: (typeof choices)[number]): string => t(choice.displayNameLabelKey) ?? choice.displayName ?? choice.providerRef;\n  const lookupName = `${fieldName}.lookup`;\n  const Lookup = Component as React.ComponentType<ProviderAddressLookupProps> | null;\n  const failedToLoad = status === ProviderComponentStatus.UNAVAILABLE;\n  const shownNotice = failedToLoad ? ProviderAddressLookupNotice.UNAVAILABLE : notice;\n\n  return (\n    <div className=\"flex flex-col gap-1\" data-address-lookup={chosen ?? ''}>\n      <FieldLabel htmlFor={`field-${lookupName}`} className=\"text-sm text-muted-foreground\">\n        {label(FormFieldAddressLookupLabel.LOOKUP_LABEL)}\n      </FieldLabel>\n      {choices.length > 1 ? (\n        <div role=\"group\" className=\"flex flex-wrap gap-item-xs\">\n          {choices.map((choice) => (\n            <Button\n              key={choice.providerRef}\n              type=\"button\"\n              size={ButtonSize.SM}\n              variant={choice.providerRef === chosen ? ButtonVariants_Variant.DEFAULT : ButtonVariants_Variant.OUTLINE}\n              aria-pressed={choice.providerRef === chosen}\n              onClick={() => { setNotice(undefined); endSession(); setPickedRef(choice.providerRef); }}\n            >\n              {providerName(choice)}\n            </Button>\n          ))}\n        </div>\n      ) : null}\n      {status === ProviderComponentStatus.CONSENT_REQUIRED && chosenChoice !== undefined ? (\n        <div role=\"status\" className=\"flex flex-wrap items-center gap-item-xs text-sm text-muted-foreground\">\n          {(() => {\n            const purposes = missingConsentPurposes\n              .map((purpose) => tResourceFieldEnumValue(CoreResourceType.USER_SELF_PREFERENCES, 'privacy.consentedPurposes', purpose, CONSENTED_PURPOSES_FIELD_SCHEMA))\n              .join(', ');\n            return (\n              <>\n                <span>{label(FormFieldAddressLookupLabel.LOOKUP_CONSENT_REQUIRED, { provider: providerName(chosenChoice), purposes })}</span>\n                {grantConsent === undefined ? null : (\n                  <Button type=\"button\" size={ButtonSize.SM} variant={ButtonVariants_Variant.OUTLINE} onClick={() => void grantConsent(missingConsentPurposes)}>\n                    {label(FormFieldAddressLookupLabel.LOOKUP_CONSENT_GRANT, { purposes })}\n                  </Button>\n                )}\n              </>\n            );\n          })()}\n        </div>\n      ) : null}\n      {status === ProviderComponentStatus.READY && Lookup !== null && chosen !== undefined && declaration !== undefined ? (\n        <>\n          <Lookup\n            providerRef={chosen}\n            publicConfig={frontendProviderRegistry?.getProviderByRef(chosen as never)?.publicConfig ?? {}}\n            {...(host.countriesAllowed !== undefined ? { countriesAllowed: host.countriesAllowed } : {})}\n            {...(host.defaultCountry !== undefined ? { defaultCountry: host.defaultCountry } : {})}\n            languageCode={currentLanguage}\n            disabled={host.disabled}\n            name={lookupName}\n            {...(declaration.attributionMark !== undefined\n              ? { attribution: { mark: declaration.attributionMark, accessibleLabel: label(FormFieldAddressLookupLabel.LOOKUP_ATTRIBUTION, { mark: declaration.attributionMark }) } }\n              : {})}\n            suggest={suggest}\n            retrieve={retrieve}\n            onSelect={handleSelect}\n            onCancel={handleCancel}\n            onError={handleError}\n          />\n        </>\n      ) : null}\n      {shownNotice !== undefined ? (\n        <p role=\"status\" className=\"text-sm text-muted-foreground\">\n          {label(shownNotice === ProviderAddressLookupNotice.UNAVAILABLE ? FormFieldAddressLookupLabel.LOOKUP_UNAVAILABLE : FormFieldAddressLookupLabel.LOOKUP_ADDRESS_REFUSED)}\n        </p>\n      ) : null}\n    </div>\n  );\n}\n"]}

package/dist/esm/core/external-providers/ProviderFilePickerHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderFilePickerHost.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,KAAK,EACV,6BAA6B,EAE7B,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7J;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;QACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,KAAK,CAAC,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,KAAK,EAAE,sCAAsC,GAAG,KAAK,CAAC,SAAS,CAAC;CACxF;AAED,+DAA+D;AAC/D,MAAM,WAAW,sCAAsC;IACrD,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,qFAAqF;IACrF,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAuJpG"}
+{"version":3,"file":"ProviderFilePickerHost.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,KAAK,EACV,6BAA6B,EAE7B,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAK9C,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,kFAAkF,CAAC;AAC1F,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,0CAA0C,CAAC;AAIlD,MAAM,WAAW,2BAA2B;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,6BAA6B,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7J;;;;OAIG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;QACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,KAAK,CAAC,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,KAAK,EAAE,sCAAsC,GAAG,KAAK,CAAC,SAAS,CAAC;CACxF;AAED,+DAA+D;AAC/D,MAAM,WAAW,sCAAsC;IACrD,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,qFAAqF;IACrF,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAuJpG"}

package/dist/esm/core/external-providers/ProviderFilePickerHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderFilePickerHost.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework side of a provider file picker: choose a provider, load its\n * component on demand, mount it, and hold whatever it returns to the contract\n * it declared.\n *\n * This is the seam issue #380 exists to create. Before it, a provider could not\n * contribute a component at all, and resolution beside the registry was\n * first-match — so a Drive picker and a Dropbox picker could not coexist for one\n * field, and which one won depended on map order.\n *\n * ## What this component decides and what it deliberately does not\n *\n * It decides NOTHING about which provider is right. `useProviderComponentChoices`\n * returns every live provider that carries a picker, in a stable order, and this\n * host renders them for a person to choose between. A framework that picked one\n * would be making a product decision in a lookup table, which is the defect the\n * registry was rebuilt to remove.\n *\n * It also does not interpret a selection. Routing a `REMOTE_REFERENCE` to the\n * application's executor door, or uploading a `BROWSER_READABLE_FILE`, is the\n * FIELD's job — this host hands up an outcome that is already checked against\n * the provider's declaration, so the field can branch on a `kind` it can trust.\n *\n * ## Chrome\n *\n * There is none beyond a list of buttons and the mounted component. Every label\n * is an i18n KEY resolved by the caller: a provider's display name is\n * locale-bound copy, and freezing it into a framework component is how a missing\n * translation becomes invisible.\n */\n\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport { BUILTIN_PROVIDER_CAPABILITY, layerProviderFilePickerConstraints } from '@wildo-ai/saas-models/public-runtime';\nimport type { ConsentPurpose, FileStorageAccepted } from '@wildo-ai/saas-models/public-runtime';\nimport type {\n  ProviderFilePickerConstraints,\n  ProviderFilePickerProps,\n  ProviderFileSelection,\n} from '@wildo-ai/saas-models/public-runtime';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useGrantedConsentPurposes } from '~wildo-frontend-lib/core/security/useGrantedConsentPurposes';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { ProviderComponentStatus } from '@wildo-ai/external-connectors-public/app';\nimport {\n  useProviderComponent,\n  useProviderComponentChoices,\n  type ProviderComponentChoice,\n} from '~wildo-frontend-lib/core/components-registry/useProviderComponent.frontend.hooks';\nimport {\n  receiveProviderFileSelections,\n  type ProviderFileSelectionRejection,\n} from './provider-file-selection.frontend.utils';\n\nconst FILE_PICKER_CAPABILITY = BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER as ProviderCapability;\n\nexport interface ProviderFilePickerHostProps {\n  /**\n   * The FIELD's own constraints, read from its Zod metadata. The chosen\n   * provider's declared limits are laid UNDER these, here, per provider — never\n   * resolved once by the caller, which is how one vendor's limit came to govern\n   * every other vendor's picker (#380).\n   */\n  readonly constraints: ProviderFilePickerConstraints;\n  /**\n   * Whether the field accepts several files. A `maxSelectionCount` a provider\n   * declares applies only to a `multiple` field; a single-file field never\n   * inherits a selection count, whatever the vendor allows.\n   */\n  readonly multiple: boolean;\n  /**\n   * The field's `z_file({ storageAccepted })` (#394 P5). A provider whose picker\n   * fronts a storage (a `REMOTE_REFERENCE` picker — the file stays at the\n   * vendor) is offered only when this names that storage, because the link it\n   * produces lands in that storage and the backend refuses it otherwise. A\n   * provider declaring no storage delivers bytes into the field's own storage\n   * and is offered regardless. Undefined — the field declared nothing — accepts\n   * no vendor storage: the default storage is the framework's.\n   */\n  readonly acceptedStorages?: ReadonlyArray<FileStorageAccepted>;\n  /**\n   * Called with selections that have already been checked against the chosen\n   * provider's declaration, so every `kind` here is the one that provider said\n   * it would produce.\n   */\n  onSelect(providerRef: string, selections: readonly ProviderFileSelection[]): void;\n  onCancel?(): void;\n  /**\n   * A provider's picker failed, or contradicted its own declaration. Both reach\n   * here because both mean the same thing to a user — this picker did not work —\n   * while the distinction that matters to a developer is in the rejection.\n   */\n  onProviderFailure?(failure: { readonly providerRef: string; readonly error?: Error; readonly rejections?: readonly ProviderFileSelectionRejection[] }): void;\n  /**\n   * Renders the chooser. Supplied by the caller, because a chooser is chrome and\n   * this package's components are injected rather than hard-coded. The default\n   * below is plain buttons: enough to be usable, not enough to be a design.\n   */\n  renderChooser?(input: {\n    readonly choices: readonly ProviderComponentChoice[];\n    readonly chosen: string | undefined;\n    choose(providerRef: string): void;\n  }): React.ReactNode;\n  /**\n   * Renders the state shown when the chosen provider rests on consent the person has not granted (#1702):\n   * nothing of the provider has been downloaded, and the surface owes the person the reason and the way to\n   * change it. Supplied by the caller for the same reason as `renderChooser` — it is chrome, and its words\n   * are the caller's i18n. The default below names the purposes by their raw values: a missing label that\n   * LOOKS missing, never invented text.\n   */\n  renderConsentRequired?(input: ProviderFilePickerConsentRequiredInput): React.ReactNode;\n}\n\n/** What a consent-required state needs to say and to offer. */\nexport interface ProviderFilePickerConsentRequiredInput {\n  /** The chosen provider, as a choice — its display-name label KEY included. */\n  readonly choice: ProviderComponentChoice;\n  /** The purposes the person would have to grant, in vocabulary order. Never empty. */\n  readonly missingPurposes: readonly ConsentPurpose[];\n  /**\n   * Records a grant of exactly `missingPurposes` through the person's audited preference write; the picker\n   * then loads without a re-mount. `undefined` when there is no signed-in person to record it for — the\n   * state must then say what is missing without offering an action it cannot perform.\n   */\n  readonly grant: (() => Promise<void>) | undefined;\n}\n\nexport function ProviderFilePickerHost(props: ProviderFilePickerHostProps): React.ReactElement | null {\n  const { providerComponentRegistry, frontendProviderRegistry } = useApplication();\n  const allChoices = useProviderComponentChoices(FILE_PICKER_CAPABILITY);\n  const acceptedStorages = props.acceptedStorages;\n  const choices = useMemo(\n    () => allChoices.filter((choice) => choice.fileStorage === undefined || (acceptedStorages?.includes(choice.fileStorage) ?? false)),\n    [allChoices, acceptedStorages],\n  );\n  const [chosen, setChosen] = useState<string | undefined>(\n    // A single provider needs no chooser: presenting one option as a choice is\n    // a click that carries no information. Several is a genuine decision and is\n    // never made here.\n    () => (choices.length === 1 ? choices[0]?.providerRef : undefined),\n  );\n\n  const soleProviderRef = choices.length === 1 ? choices[0]?.providerRef : undefined;\n  useEffect(() => {\n    // The initializer above runs ONCE. In today's runtime that is enough — the\n    // registry is populated before application services are handed out and the\n    // context gates children on them — but a host whose only correctness\n    // argument lives in another file's ordering is one refactor from rendering\n    // nothing at all: with a single late-arriving provider there would be no\n    // chooser (length is 1) and no picker (nothing chosen).\n    if (soleProviderRef !== undefined && chosen === undefined) setChosen(soleProviderRef);\n  }, [soleProviderRef, chosen]);\n  const { status, Component, missingConsentPurposes } = useProviderComponent(FILE_PICKER_CAPABILITY, chosen);\n  const { grant: grantConsent } = useGrantedConsentPurposes();\n\n  const publicConfig = useMemo(() => {\n    if (chosen === undefined) return {};\n    return frontendProviderRegistry?.getProviderByRef(chosen as never)?.publicConfig ?? {};\n  }, [chosen, frontendProviderRegistry]);\n\n  // The chosen provider's half, laid under the field's own. Recomputed when the\n  // person picks a different vendor, which is the whole point: the two vendors\n  // may declare different limits and each picker must be told its own.\n  const fieldConstraints = props.constraints;\n  const multiple = props.multiple;\n  const constraints = useMemo(\n    () => layerProviderFilePickerConstraints({ base: fieldConstraints, multiple, publicConfig }),\n    [fieldConstraints, multiple, publicConfig],\n  );\n\n  // Destructured, not read off `props` inside the callbacks: `props` is a fresh\n  // object every render, so depending on it would give both callbacks a new\n  // identity on every parent render — and a picker keying an effect on\n  // `onSelect` would then re-run its whole open sequence each time.\n  const { onSelect, onCancel, onProviderFailure } = props;\n\n  const handleSelect = useCallback(\n    (selections: readonly ProviderFileSelection[]) => {\n      if (chosen === undefined) return;\n\n      const outcome = receiveProviderFileSelections({\n        providerRef: chosen,\n        descriptor: providerComponentRegistry?.describe(FILE_PICKER_CAPABILITY, chosen),\n        selections,\n      });\n\n      if (outcome.rejections.length > 0) {\n        onProviderFailure?.({ providerRef: chosen, rejections: outcome.rejections });\n        return;\n      }\n\n      onSelect(chosen, outcome.accepted);\n    },\n    [chosen, providerComponentRegistry, onSelect, onProviderFailure],\n  );\n\n  const handleError = useCallback(\n    (error: Error) => {\n      if (chosen === undefined) return;\n      onProviderFailure?.({ providerRef: chosen, error });\n    },\n    [chosen, onProviderFailure],\n  );\n\n  const handleCancel = useCallback(() => onCancel?.(), [onCancel]);\n\n  /*\n   * A chosen provider whose picker can never mount — its component failed to load, or a\n   * `<script>` its provider declares did not (`SCRIPT_LOAD_FAILED`) — is a failure the\n   * surface must hear about. Rendering nothing and saying nothing would leave a person who\n   * clicked a provider looking at a control that silently ignores them; the registry's\n   * diagnostic reaches a developer's log, not the field. Reported ONCE per chosen provider:\n   * `onProviderFailure` may change identity on every parent render, and the registry never\n   * retries, so a second report would describe the same failure again.\n   */\n  const reportedUnavailableRef = useRef<string | undefined>(undefined);\n  useEffect(() => {\n    if (status !== ProviderComponentStatus.UNAVAILABLE || chosen === undefined) {\n      reportedUnavailableRef.current = undefined;\n      return;\n    }\n    if (reportedUnavailableRef.current === chosen) return;\n    reportedUnavailableRef.current = chosen;\n    onProviderFailure?.({\n      providerRef: chosen,\n      error: new Error(\n        `Provider \"${chosen}\" cannot open its file picker: its component or a script it declares did not load. `\n        + 'The provider component registry logged the cause.',\n      ),\n    });\n  }, [status, chosen, onProviderFailure]);\n\n  // The caller's own token for the chosen provider, from the one door that hands one out (#394 P4).\n  // Resolved lazily — a picker asks when it opens, never before — and `undefined` when nothing is\n  // connected, which the picker reports in its own words. Never read from `publicConfig`, which is\n  // served to every browser.\n  const getAccessToken = useCallback(async (): Promise<string | undefined> => {\n    if (chosen === undefined) return undefined;\n    const granted = await getManualCallsHttpClient().getProviderConnectionAccessToken(chosen);\n    return granted?.accessToken;\n  }, [chosen]);\n\n  if (choices.length === 0) return null;\n\n  const chooser = props.renderChooser?.({ choices, chosen, choose: setChosen })\n    ?? defaultChooser({ choices, chosen, choose: setChosen });\n\n  const chosenChoice = choices.find((choice) => choice.providerRef === chosen);\n  const consentRequired = status === ProviderComponentStatus.CONSENT_REQUIRED && chosenChoice !== undefined\n    ? (props.renderConsentRequired ?? defaultConsentRequired)({\n      choice: chosenChoice,\n      missingPurposes: missingConsentPurposes,\n      grant: grantConsent === undefined ? undefined : () => grantConsent(missingConsentPurposes),\n    })\n    : null;\n\n  // `Component` is typed as the registry's opaque component: this package must\n  // not make the registry know any capability's props. The narrowing happens\n  // HERE, where the capability is known, and it is the only cast in the path.\n  const Picker = Component as React.ComponentType<ProviderFilePickerProps> | null;\n\n  return (\n    <>\n      {choices.length > 1 ? chooser : null}\n      {consentRequired}\n      {status === ProviderComponentStatus.READY && Picker !== null && chosen !== undefined ? (\n        <Picker\n          providerRef={chosen}\n          publicConfig={publicConfig}\n          constraints={constraints}\n          getAccessToken={getAccessToken}\n          onSelect={handleSelect}\n          onCancel={handleCancel}\n          onError={handleError}\n        />\n      ) : null}\n    </>\n  );\n}\n\nfunction defaultChooser(input: {\n  readonly choices: readonly ProviderComponentChoice[];\n  readonly chosen: string | undefined;\n  choose(providerRef: string): void;\n}): React.ReactNode {\n  return (\n    <div role=\"group\">\n      {input.choices.map((choice) => (\n        <button\n          key={choice.providerRef}\n          type=\"button\"\n          aria-pressed={choice.providerRef === input.chosen}\n          onClick={() => input.choose(choice.providerRef)}\n        >\n          {/* The authored fallback, NOT a translation — a surface that has an\n              i18n service should pass `renderChooser` and resolve the key. */}\n          {choice.displayName ?? choice.providerRef}\n        </button>\n      ))}\n    </div>\n  );\n}\n\n/**\n * The fallback consent-required state: announced (`role=\"status\"`), with a real, keyboard-reachable\n * button when a grant can be recorded. It names purposes by their RAW values on purpose — a surface with an\n * i18n service passes `renderConsentRequired` and words them; this default must not invent the words.\n */\nfunction defaultConsentRequired(input: ProviderFilePickerConsentRequiredInput): React.ReactNode {\n  const purposes = input.missingPurposes.join(', ');\n  return (\n    <div role=\"status\" data-provider-consent-required={input.choice.providerRef}>\n      <span>{purposes}</span>\n      {input.grant === undefined ? null : (\n        <button type=\"button\" onClick={() => void input.grant?.()}>\n          {purposes}\n        </button>\n      )}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ProviderFilePickerHost.js","sourceRoot":"","sources":["../../../../src/core/external-providers/ProviderFilePickerHost.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * The framework side of a provider file picker: choose a provider, load its\n * component on demand, mount it, and hold whatever it returns to the contract\n * it declared.\n *\n * This is the seam issue #380 exists to create. Before it, a provider could not\n * contribute a component at all, and resolution beside the registry was\n * first-match — so a Drive picker and a Dropbox picker could not coexist for one\n * field, and which one won depended on map order.\n *\n * ## What this component decides and what it deliberately does not\n *\n * It decides NOTHING about which provider is right. `useProviderComponentChoices`\n * returns every live provider that carries a picker, in a stable order, and this\n * host renders them for a person to choose between. A framework that picked one\n * would be making a product decision in a lookup table, which is the defect the\n * registry was rebuilt to remove.\n *\n * It also does not interpret a selection. Routing a `REMOTE_REFERENCE` to the\n * application's executor door, or uploading a `BROWSER_READABLE_FILE`, is the\n * FIELD's job — this host hands up an outcome that is already checked against\n * the provider's declaration, so the field can branch on a `kind` it can trust.\n *\n * ## Chrome\n *\n * There is none beyond a list of buttons and the mounted component. Every label\n * is an i18n KEY resolved by the caller: a provider's display name is\n * locale-bound copy, and freezing it into a framework component is how a missing\n * translation becomes invisible.\n */\n\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport type { ProviderCapability } from '@wildo-ai/saas-models';\nimport { BUILTIN_PROVIDER_CAPABILITY, layerProviderFilePickerConstraints } from '@wildo-ai/saas-models/public-runtime';\nimport type { ConsentPurpose, FileStorageAccepted } from '@wildo-ai/saas-models/public-runtime';\nimport type {\n  ProviderFilePickerConstraints,\n  ProviderFilePickerProps,\n  ProviderFileSelection,\n} from '@wildo-ai/saas-models/public-runtime';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useGrantedConsentPurposes } from '~wildo-frontend-lib/core/security/useGrantedConsentPurposes';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { ProviderComponentStatus } from '@wildo-ai/external-connectors-public/app';\nimport {\n  useProviderComponent,\n  useProviderComponentChoices,\n  type ProviderComponentChoice,\n} from '~wildo-frontend-lib/core/components-registry/useProviderComponent.frontend.hooks';\nimport {\n  receiveProviderFileSelections,\n  type ProviderFileSelectionRejection,\n} from './provider-file-selection.frontend.utils';\n\nconst FILE_PICKER_CAPABILITY = BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER as ProviderCapability;\n\nexport interface ProviderFilePickerHostProps {\n  /**\n   * The FIELD's own constraints, read from its Zod metadata. The chosen\n   * provider's declared limits are laid UNDER these, here, per provider — never\n   * resolved once by the caller, which is how one vendor's limit came to govern\n   * every other vendor's picker (#380).\n   */\n  readonly constraints: ProviderFilePickerConstraints;\n  /**\n   * Whether the field accepts several files. A `maxSelectionCount` a provider\n   * declares applies only to a `multiple` field; a single-file field never\n   * inherits a selection count, whatever the vendor allows.\n   */\n  readonly multiple: boolean;\n  /**\n   * The field's `z_file({ storageAccepted })` (#394 P5). A provider whose picker\n   * fronts a storage (a `REMOTE_REFERENCE` picker — the file stays at the\n   * vendor) is offered only when this names that storage, because the link it\n   * produces lands in that storage and the backend refuses it otherwise. A\n   * provider declaring no storage delivers bytes into the field's own storage\n   * and is offered regardless. Undefined — the field declared nothing — accepts\n   * no vendor storage: the default storage is the framework's.\n   */\n  readonly acceptedStorages?: ReadonlyArray<FileStorageAccepted>;\n  /**\n   * Called with selections that have already been checked against the chosen\n   * provider's declaration, so every `kind` here is the one that provider said\n   * it would produce.\n   */\n  onSelect(providerRef: string, selections: readonly ProviderFileSelection[]): void;\n  onCancel?(): void;\n  /**\n   * A provider's picker failed, or contradicted its own declaration. Both reach\n   * here because both mean the same thing to a user — this picker did not work —\n   * while the distinction that matters to a developer is in the rejection.\n   */\n  onProviderFailure?(failure: { readonly providerRef: string; readonly error?: Error; readonly rejections?: readonly ProviderFileSelectionRejection[] }): void;\n  /**\n   * Renders the chooser. Supplied by the caller, because a chooser is chrome and\n   * this package's components are injected rather than hard-coded. The default\n   * below is plain buttons: enough to be usable, not enough to be a design.\n   */\n  renderChooser?(input: {\n    readonly choices: readonly ProviderComponentChoice[];\n    readonly chosen: string | undefined;\n    choose(providerRef: string): void;\n  }): React.ReactNode;\n  /**\n   * Renders the state shown when the chosen provider rests on consent the person has not granted (#1702):\n   * nothing of the provider has been downloaded, and the surface owes the person the reason and the way to\n   * change it. Supplied by the caller for the same reason as `renderChooser` — it is chrome, and its words\n   * are the caller's i18n. The default below names the purposes by their raw values: a missing label that\n   * LOOKS missing, never invented text.\n   */\n  renderConsentRequired?(input: ProviderFilePickerConsentRequiredInput): React.ReactNode;\n}\n\n/** What a consent-required state needs to say and to offer. */\nexport interface ProviderFilePickerConsentRequiredInput {\n  /** The chosen provider, as a choice — its display-name label KEY included. */\n  readonly choice: ProviderComponentChoice;\n  /** The purposes the person would have to grant, in vocabulary order. Never empty. */\n  readonly missingPurposes: readonly ConsentPurpose[];\n  /**\n   * Records a grant of exactly `missingPurposes` through the person's audited preference write; the picker\n   * then loads without a re-mount. `undefined` when there is no signed-in person to record it for — the\n   * state must then say what is missing without offering an action it cannot perform.\n   */\n  readonly grant: (() => Promise<void>) | undefined;\n}\n\nexport function ProviderFilePickerHost(props: ProviderFilePickerHostProps): React.ReactElement | null {\n  const { providerComponentRegistry, frontendProviderRegistry } = useApplication();\n  const allChoices = useProviderComponentChoices(FILE_PICKER_CAPABILITY);\n  const acceptedStorages = props.acceptedStorages;\n  const choices = useMemo(\n    () => allChoices.filter((choice) => choice.fileStorage === undefined || (acceptedStorages?.includes(choice.fileStorage) ?? false)),\n    [allChoices, acceptedStorages],\n  );\n  const [chosen, setChosen] = useState<string | undefined>(\n    // A single provider needs no chooser: presenting one option as a choice is\n    // a click that carries no information. Several is a genuine decision and is\n    // never made here.\n    () => (choices.length === 1 ? choices[0]?.providerRef : undefined),\n  );\n\n  const soleProviderRef = choices.length === 1 ? choices[0]?.providerRef : undefined;\n  useEffect(() => {\n    // The initializer above runs ONCE. In today's runtime that is enough — the\n    // registry is populated before application services are handed out and the\n    // context gates children on them — but a host whose only correctness\n    // argument lives in another file's ordering is one refactor from rendering\n    // nothing at all: with a single late-arriving provider there would be no\n    // chooser (length is 1) and no picker (nothing chosen).\n    if (soleProviderRef !== undefined && chosen === undefined) setChosen(soleProviderRef);\n  }, [soleProviderRef, chosen]);\n  const { status, Component, missingConsentPurposes } = useProviderComponent(FILE_PICKER_CAPABILITY, chosen);\n  const { grant: grantConsent } = useGrantedConsentPurposes();\n\n  const publicConfig = useMemo(() => {\n    if (chosen === undefined) return {};\n    return frontendProviderRegistry?.getProviderByRef(chosen as never)?.publicConfig ?? {};\n  }, [chosen, frontendProviderRegistry]);\n\n  // The chosen provider's half, laid under the field's own. Recomputed when the\n  // person picks a different vendor, which is the whole point: the two vendors\n  // may declare different limits and each picker must be told its own.\n  const fieldConstraints = props.constraints;\n  const multiple = props.multiple;\n  const constraints = useMemo(\n    () => layerProviderFilePickerConstraints({ base: fieldConstraints, multiple, publicConfig }),\n    [fieldConstraints, multiple, publicConfig],\n  );\n\n  // Destructured, not read off `props` inside the callbacks: `props` is a fresh\n  // object every render, so depending on it would give both callbacks a new\n  // identity on every parent render — and a picker keying an effect on\n  // `onSelect` would then re-run its whole open sequence each time.\n  const { onSelect, onCancel, onProviderFailure } = props;\n\n  const handleSelect = useCallback(\n    (selections: readonly ProviderFileSelection[]) => {\n      if (chosen === undefined) return;\n\n      const outcome = receiveProviderFileSelections({\n        providerRef: chosen,\n        descriptor: providerComponentRegistry?.describe(FILE_PICKER_CAPABILITY, chosen),\n        selections,\n      });\n\n      if (outcome.rejections.length > 0) {\n        onProviderFailure?.({ providerRef: chosen, rejections: outcome.rejections });\n        return;\n      }\n\n      onSelect(chosen, outcome.accepted);\n    },\n    [chosen, providerComponentRegistry, onSelect, onProviderFailure],\n  );\n\n  const handleError = useCallback(\n    (error: Error) => {\n      if (chosen === undefined) return;\n      onProviderFailure?.({ providerRef: chosen, error });\n    },\n    [chosen, onProviderFailure],\n  );\n\n  const handleCancel = useCallback(() => onCancel?.(), [onCancel]);\n\n  /*\n   * A chosen provider whose picker can never mount — its component failed to load, or a\n   * `<script>` its provider declares did not (`SCRIPT_LOAD_FAILED`) — is a failure the\n   * surface must hear about. Rendering nothing and saying nothing would leave a person who\n   * clicked a provider looking at a control that silently ignores them; the registry's\n   * diagnostic reaches a developer's log, not the field. Reported ONCE per chosen provider:\n   * `onProviderFailure` may change identity on every parent render, and the registry never\n   * retries, so a second report would describe the same failure again.\n   */\n  const reportedUnavailableRef = useRef<string | undefined>(undefined);\n  useEffect(() => {\n    if (status !== ProviderComponentStatus.UNAVAILABLE || chosen === undefined) {\n      reportedUnavailableRef.current = undefined;\n      return;\n    }\n    if (reportedUnavailableRef.current === chosen) return;\n    reportedUnavailableRef.current = chosen;\n    onProviderFailure?.({\n      providerRef: chosen,\n      error: new Error(\n        `Provider \"${chosen}\" cannot open its file picker: its component or a script it declares did not load. `\n        + 'The provider component registry logged the cause.',\n      ),\n    });\n  }, [status, chosen, onProviderFailure]);\n\n  // The caller's own token for the chosen provider, from the one door that hands one out (#394 P4).\n  // Resolved lazily — a picker asks when it opens, never before — and `undefined` when nothing is\n  // connected, which the picker reports in its own words. Never read from `publicConfig`, which is\n  // served to every browser.\n  const getAccessToken = useCallback(async (): Promise<string | undefined> => {\n    if (chosen === undefined) return undefined;\n    const granted = await getManualCallsHttpClient().getProviderConnectionAccessToken(chosen);\n    return granted?.accessToken;\n  }, [chosen]);\n\n  if (choices.length === 0) return null;\n\n  const chooser = props.renderChooser?.({ choices, chosen, choose: setChosen })\n    ?? defaultChooser({ choices, chosen, choose: setChosen });\n\n  const chosenChoice = choices.find((choice) => choice.providerRef === chosen);\n  const consentRequired = status === ProviderComponentStatus.CONSENT_REQUIRED && chosenChoice !== undefined\n    ? (props.renderConsentRequired ?? defaultConsentRequired)({\n      choice: chosenChoice,\n      missingPurposes: missingConsentPurposes,\n      grant: grantConsent === undefined ? undefined : () => grantConsent(missingConsentPurposes),\n    })\n    : null;\n\n  // `Component` is typed as the registry's opaque component: this package must\n  // not make the registry know any capability's props. The narrowing happens\n  // HERE, where the capability is known, and it is the only cast in the path.\n  const Picker = Component as React.ComponentType<ProviderFilePickerProps> | null;\n\n  return (\n    <>\n      {choices.length > 1 ? chooser : null}\n      {consentRequired}\n      {status === ProviderComponentStatus.READY && Picker !== null && chosen !== undefined ? (\n        <Picker\n          providerRef={chosen}\n          publicConfig={publicConfig}\n          constraints={constraints}\n          getAccessToken={getAccessToken}\n          onSelect={handleSelect}\n          onCancel={handleCancel}\n          onError={handleError}\n        />\n      ) : null}\n    </>\n  );\n}\n\nfunction defaultChooser(input: {\n  readonly choices: readonly ProviderComponentChoice[];\n  readonly chosen: string | undefined;\n  choose(providerRef: string): void;\n}): React.ReactNode {\n  return (\n    <div role=\"group\">\n      {input.choices.map((choice) => (\n        <button\n          key={choice.providerRef}\n          type=\"button\"\n          aria-pressed={choice.providerRef === input.chosen}\n          onClick={() => input.choose(choice.providerRef)}\n        >\n          {/* The authored fallback, NOT a translation — a surface that has an\n              i18n service should pass `renderChooser` and resolve the key. */}\n          {choice.displayName ?? choice.providerRef}\n        </button>\n      ))}\n    </div>\n  );\n}\n\n/**\n * The fallback consent-required state: announced (`role=\"status\"`), with a real, keyboard-reachable\n * button when a grant can be recorded. It names purposes by their RAW values on purpose — a surface with an\n * i18n service passes `renderConsentRequired` and words them; this default must not invent the words.\n */\nfunction defaultConsentRequired(input: ProviderFilePickerConsentRequiredInput): React.ReactNode {\n  const purposes = input.missingPurposes.join(', ');\n  return (\n    <div role=\"status\" data-provider-consent-required={input.choice.providerRef}>\n      <span>{purposes}</span>\n      {input.grant === undefined ? null : (\n        <button type=\"button\" onClick={() => void input.grant?.()}>\n          {purposes}\n        </button>\n      )}\n    </div>\n  );\n}\n"]}

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-display-label.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAClD,MAAM,EAAE,CASV;AAED;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GACvC,MAAM,CASR"}
+{"version":3,"file":"frontend-provider-display-label.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,uCAAuC,CACrD,SAAS,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAClD,MAAM,EAAE,CASV;AAED;;;;;;;;;GASG;AACH,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,iCAAiC,GACvC,MAAM,CASR"}

package/dist/esm/core/external-providers/frontend-provider-display-label.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-display-label.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAcxF;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,SAAmD;IAEnD,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,SAAS,CAAC,MAAM,CACd,CAAC,QAAQ,EAAsB,EAAE,CAC/B,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CACtD,CACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,KAAwC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClG,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,UAAU,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,CAAC;AACvE,CAAC","sourcesContent":["import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\n\nexport interface FrontendProviderDisplayLabelInput {\n  providerRef: string;\n  displayName?: string;\n  displayNameLabelKey?: string;\n  /**\n   * Optional explicit fallback when the caller wants a non-ref technical\n   * fallback (for example a brand label sourced from a static map).\n   */\n  fallbackLabel?: string;\n  translate?: (key: string) => string;\n}\n\n/**\n * Collect unique, non-empty provider display-label keys for `useI18n({ keys })`.\n *\n * The helper intentionally stays tiny and framework-agnostic: call sites can\n * build whatever provider view-model they need, then hand only the optional\n * label keys here to get the deduped request list.\n */\nexport function collectFrontendProviderDisplayLabelKeys(\n  labelKeys: ReadonlyArray<string | undefined | null>,\n): string[] {\n  return Array.from(\n    new Set(\n      labelKeys.filter(\n        (labelKey): labelKey is string =>\n          typeof labelKey === 'string' && labelKey.length > 0,\n      ),\n    ),\n  );\n}\n\n/**\n * Resolve a user-facing provider label without freezing locale-bound copy into\n * provider metadata or generated artifacts.\n *\n * Order of preference:\n * 1. Translation resolved from the provider label key.\n * 2. Authored display name on the provider metadata.\n * 3. Optional caller-supplied fallback label.\n * 4. Raw provider ref as the technical last resort.\n */\nexport function resolveFrontendProviderDisplayLabel(\n  input: FrontendProviderDisplayLabelInput,\n): string {\n  const labelKey = input.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(input.providerRef);\n  const translated = input.translate?.(labelKey);\n\n  if (translated && translated !== labelKey) {\n    return translated;\n  }\n\n  return input.displayName ?? input.fallbackLabel ?? input.providerRef;\n}\n"]}
+{"version":3,"file":"frontend-provider-display-label.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/external-providers/frontend-provider-display-label.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAcxF;;;;;;GAMG;AACH,MAAM,UAAU,uCAAuC,CACrD,SAAmD;IAEnD,OAAO,KAAK,CAAC,IAAI,CACf,IAAI,GAAG,CACL,SAAS,CAAC,MAAM,CACd,CAAC,QAAQ,EAAsB,EAAE,CAC/B,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CACtD,CACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mCAAmC,CACjD,KAAwC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC,mBAAmB,IAAI,gCAAgC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAClG,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,UAAU,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,CAAC;AACvE,CAAC","sourcesContent":["import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\n\nexport interface FrontendProviderDisplayLabelInput {\n  providerRef: string;\n  displayName?: string;\n  displayNameLabelKey?: string;\n  /**\n   * Optional explicit fallback when the caller wants a non-ref technical\n   * fallback (for example a brand label sourced from a static map).\n   */\n  fallbackLabel?: string;\n  translate?: (key: string) => string;\n}\n\n/**\n * Collect unique, non-empty provider display-label keys for `useI18n({ keys })`.\n *\n * The helper intentionally stays tiny and framework-agnostic: call sites can\n * build whatever provider view-model they need, then hand only the optional\n * label keys here to get the deduped request list.\n */\nexport function collectFrontendProviderDisplayLabelKeys(\n  labelKeys: ReadonlyArray<string | undefined | null>,\n): string[] {\n  return Array.from(\n    new Set(\n      labelKeys.filter(\n        (labelKey): labelKey is string =>\n          typeof labelKey === 'string' && labelKey.length > 0,\n      ),\n    ),\n  );\n}\n\n/**\n * Resolve a user-facing provider label without freezing locale-bound copy into\n * provider metadata or generated artifacts.\n *\n * Order of preference:\n * 1. Translation resolved from the provider label key.\n * 2. Authored display name on the provider metadata.\n * 3. Optional caller-supplied fallback label.\n * 4. Raw provider ref as the technical last resort.\n */\nexport function resolveFrontendProviderDisplayLabel(\n  input: FrontendProviderDisplayLabelInput,\n): string {\n  const labelKey = input.displayNameLabelKey ?? buildProviderDisplayNameLabelKey(input.providerRef);\n  const translated = input.translate?.(labelKey);\n\n  if (translated && translated !== labelKey) {\n    return translated;\n  }\n\n  return input.displayName ?? input.fallbackLabel ?? input.providerRef;\n}\n"]}

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,mCAAmC,EACnC,2BAA2B,EAC5B,MAAM,0CAA0C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,uCAAuC;IACtD,gEAAgE;IAChE,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAErF,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS,CAAC;IAEzC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS,CAAC;IAEzC,iEAAiE;IACjE,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,qBAAa,+CACX,YAAW,uCAAuC;IAElD,OAAO,CAAC,QAAQ,CAEb;IAEH,UAAU,CAAC,KAAK,CAAC,EAAE,sCAAsC,GAAG,IAAI;IAQhE,gBAAgB,CACd,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,GAAG,SAAS;IAIxC,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC;IAI3C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS;IAIxC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS;IAQxC,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC;CAGpD;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,CAAC,EAAE,sCAAsC,GAC7C,uCAAuC,CAIzC"}
+{"version":3,"file":"frontend-provider-registry.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAK7E,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,mCAAmC,EACnC,2BAA2B,EAC5B,MAAM,0CAA0C,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,mCAAmC,KAAK,IAAI,CAAC;CACnF;AAED,MAAM,WAAW,uCAAuC;IACtD,gEAAgE;IAChE,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,yBAAyB,GAAG,SAAS,CAAC;IAErF,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE5C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS,CAAC;IAEzC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS,CAAC;IAEzC,iEAAiE;IACjE,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC,CAAC;CACrD;AAED,qBAAa,+CACX,YAAW,uCAAuC;IAElD,OAAO,CAAC,QAAQ,CAEb;IAEH,UAAU,CAAC,KAAK,CAAC,EAAE,sCAAsC,GAAG,IAAI;IAQhE,gBAAgB,CACd,GAAG,EAAE,sBAAsB,GAC1B,yBAAyB,GAAG,SAAS;IAIxC,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,aAAa,CAAC,yBAAyB,CAAC;IAI3C,wBAAwB,CACtB,kBAAkB,EAAE,kBAAkB,GACrC,yBAAyB,GAAG,SAAS;IAIxC,mCAAmC,CACjC,kBAAkB,EAAE,kBAAkB,EACtC,gBAAgB,EAAE,gBAAgB,GAAG,MAAM,GAC1C,yBAAyB,GAAG,SAAS;IAQxC,OAAO,IAAI,aAAa,CAAC,yBAAyB,CAAC;CAGpD;AAED,wBAAgB,6CAA6C,CAC3D,KAAK,CAAC,EAAE,sCAAsC,GAC7C,uCAAuC,CAIzC"}

package/dist/esm/core/external-providers/frontend-provider-registry.frontend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontend-provider-registry.frontend.service.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,0CAA0C,CAAC;AAyClD,MAAM,OAAO,+CAA+C;IAGlD,QAAQ,GAAG,2BAA2B,CAAC;QAC7C,OAAO,EAAE,IAAI,GAAG,EAAqD;KACtE,CAAC,CAAC;IAEH,UAAU,CAAC,KAA8C;QACvD,IAAI,CAAC,QAAQ,GAAG,mCAAmC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CACd,GAA2B;QAE3B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,mCAAmC,CACjC,kBAAsC,EACtC,gBAA2C;QAE3C,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,kBAAkB,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,6CAA6C,CAC3D,KAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,+CAA+C,EAAE,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * `FrontendProviderRegistryFrontendService` — frontend-side API for\n * reading the per-app provider catalog.\n *\n * The registry is built from TWO channels and no longer from a cast (#332):\n *\n *   - **DATA** — `FrontendAppBootstrapPayload.frontendProviders`, hydrated\n *     once at app start from `/application-config`. Built by\n *     `FrontendBootstrapBackendService.buildPayload()`, which is the SOLE\n *     cross-facet seam where backend code projects a `BackendProviderModule`\n *     into a `FrontendProviderEntry`. It is the authority on WHICH providers\n *     this frontend service has turned on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the app's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and passed in through `StartApplicationOptions`. It\n *     is the authority on what code this bundle contains — an SDK loader, a\n *     public-config validator — none of which JSON could ever carry.\n *\n * From the frontend's perspective this service is still the only legal way to\n * read provider information — direct imports from\n * `@wildo-ai/external-connectors-private/*` are a TypeScript error because the\n * frontend bundle does not depend on that package.\n */\n\nimport type {\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models';\nimport type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';\nimport {\n  composeFrontendAppProviders,\n  composeHydratedFrontendAppProviders,\n} from '@wildo-ai/external-connectors-public/app';\nimport type {\n  FrontendAppProviderModule,\n  FrontendAppProviderRef,\n  FrontendProviderHydrationDiagnostic,\n  GeneratedAppProviderModules,\n} from '@wildo-ai/external-connectors-public/app';\n\n/**\n * Everything the registry needs to join the two channels.\n *\n * `modules` absent is the ordinary case for an application that declares no\n * frontend provider. Config sync emits an empty map so startup imports remain stable.\n */\nexport interface FrontendProviderRegistryHydrationInput {\n  readonly entries?: FrontendProvidersBlock;\n  readonly modules?: GeneratedAppProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\nexport interface FrontendProviderRegistryFrontendService {\n  /** Hydrated from `FrontendAppBootstrapPayload` at app start. */\n  getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule>;\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined;\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined;\n\n  /** All providers (read-only). For debug / introspection only. */\n  listAll(): ReadonlyArray<FrontendAppProviderModule>;\n}\n\nexport class InMemoryFrontendProviderRegistryFrontendService\n  implements FrontendProviderRegistryFrontendService\n{\n  private registry = composeFrontendAppProviders({\n    modules: new Map<FrontendAppProviderRef, FrontendAppProviderModule>(),\n  });\n\n  initialize(input?: FrontendProviderRegistryHydrationInput): void {\n    this.registry = composeHydratedFrontendAppProviders({\n      entries: input?.entries,\n      modules: input?.modules,\n      onDiagnostic: input?.onDiagnostic,\n    });\n  }\n\n  getProviderByRef(\n    ref: FrontendAppProviderRef,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.getProviderByRef(ref);\n  }\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule> {\n    return this.registry.getProvidersByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.findProviderByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry\n      .getProvidersByProviderCapability(providerCapability)\n      .find((provider) =>\n        provider.protocols.some((protocol) => protocol === providerProtocol),\n      );\n  }\n\n  listAll(): ReadonlyArray<FrontendAppProviderModule> {\n    return [...this.registry.modules.values()];\n  }\n}\n\nexport function createFrontendProviderRegistryFrontendService(\n  input?: FrontendProviderRegistryHydrationInput,\n): FrontendProviderRegistryFrontendService {\n  const service = new InMemoryFrontendProviderRegistryFrontendService();\n  service.initialize(input);\n  return service;\n}\n"]}
+{"version":3,"file":"frontend-provider-registry.frontend.service.js","sourceRoot":"","sources":["../../../../src/core/external-providers/frontend-provider-registry.frontend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EACL,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,0CAA0C,CAAC;AAyClD,MAAM,OAAO,+CAA+C;IAGlD,QAAQ,GAAG,2BAA2B,CAAC;QAC7C,OAAO,EAAE,IAAI,GAAG,EAAqD;KACtE,CAAC,CAAC;IAEH,UAAU,CAAC,KAA8C;QACvD,IAAI,CAAC,QAAQ,GAAG,mCAAmC,CAAC;YAClD,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,OAAO,EAAE,KAAK,EAAE,OAAO;YACvB,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CACd,GAA2B;QAE3B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,wBAAwB,CACtB,kBAAsC;QAEtC,OAAO,IAAI,CAAC,QAAQ,CAAC,gCAAgC,CAAC,kBAAkB,CAAC,CAAC;IAC5E,CAAC;IAED,mCAAmC,CACjC,kBAAsC,EACtC,gBAA2C;QAE3C,OAAO,IAAI,CAAC,QAAQ;aACjB,gCAAgC,CAAC,kBAAkB,CAAC;aACpD,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACjB,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,gBAAgB,CAAC,CACrE,CAAC;IACN,CAAC;IAED,OAAO;QACL,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,UAAU,6CAA6C,CAC3D,KAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,+CAA+C,EAAE,CAAC;IACtE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC1B,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * `FrontendProviderRegistryFrontendService` — frontend-side API for\n * reading the per-app provider catalog.\n *\n * The registry is built from TWO channels and no longer from a cast (#332):\n *\n *   - **DATA** — `FrontendAppBootstrapPayload.frontendProviders`, hydrated\n *     once at app start from `/application-config`. Built by\n *     `FrontendBootstrapBackendService.buildPayload()`, which is the SOLE\n *     cross-facet seam where backend code projects a `BackendProviderModule`\n *     into a `FrontendProviderEntry`. It is the authority on WHICH providers\n *     this frontend service has turned on, in this environment.\n *   - **CODE** — `generatedFrontendProviderModules` from the app's own\n *     `src/generated/frontend-providers.generated.ts`, written by\n *     `wildo config sync` and passed in through `StartApplicationOptions`. It\n *     is the authority on what code this bundle contains — an SDK loader, a\n *     public-config validator — none of which JSON could ever carry.\n *\n * From the frontend's perspective this service is still the only legal way to\n * read provider information — direct imports from\n * `@wildo-ai/external-connectors-private/*` are a TypeScript error because the\n * frontend bundle does not depend on that package.\n */\n\nimport type {\n  FrontendProvidersBlock,\n  ProviderCapability,\n} from '@wildo-ai/saas-models';\nimport type { ProviderProtocol } from '@wildo-ai/saas-models/public-runtime';\nimport {\n  composeFrontendAppProviders,\n  composeHydratedFrontendAppProviders,\n} from '@wildo-ai/external-connectors-public/app';\nimport type {\n  FrontendAppProviderModule,\n  FrontendAppProviderRef,\n  FrontendProviderHydrationDiagnostic,\n  GeneratedAppProviderModules,\n} from '@wildo-ai/external-connectors-public/app';\n\n/**\n * Everything the registry needs to join the two channels.\n *\n * `modules` absent is the ordinary case for an application that declares no\n * frontend provider. Config sync emits an empty map so startup imports remain stable.\n */\nexport interface FrontendProviderRegistryHydrationInput {\n  readonly entries?: FrontendProvidersBlock;\n  readonly modules?: GeneratedAppProviderModules;\n  readonly onDiagnostic?: (diagnostic: FrontendProviderHydrationDiagnostic) => void;\n}\n\nexport interface FrontendProviderRegistryFrontendService {\n  /** Hydrated from `FrontendAppBootstrapPayload` at app start. */\n  getProviderByRef(ref: FrontendAppProviderRef): FrontendAppProviderModule | undefined;\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule>;\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined;\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined;\n\n  /** All providers (read-only). For debug / introspection only. */\n  listAll(): ReadonlyArray<FrontendAppProviderModule>;\n}\n\nexport class InMemoryFrontendProviderRegistryFrontendService\n  implements FrontendProviderRegistryFrontendService\n{\n  private registry = composeFrontendAppProviders({\n    modules: new Map<FrontendAppProviderRef, FrontendAppProviderModule>(),\n  });\n\n  initialize(input?: FrontendProviderRegistryHydrationInput): void {\n    this.registry = composeHydratedFrontendAppProviders({\n      entries: input?.entries,\n      modules: input?.modules,\n      onDiagnostic: input?.onDiagnostic,\n    });\n  }\n\n  getProviderByRef(\n    ref: FrontendAppProviderRef,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.getProviderByRef(ref);\n  }\n\n  listByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): ReadonlyArray<FrontendAppProviderModule> {\n    return this.registry.getProvidersByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapability(\n    providerCapability: ProviderCapability,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry.findProviderByProviderCapability(providerCapability);\n  }\n\n  findByProviderCapabilityAndProtocol(\n    providerCapability: ProviderCapability,\n    providerProtocol: ProviderProtocol | string,\n  ): FrontendAppProviderModule | undefined {\n    return this.registry\n      .getProvidersByProviderCapability(providerCapability)\n      .find((provider) =>\n        provider.protocols.some((protocol) => protocol === providerProtocol),\n      );\n  }\n\n  listAll(): ReadonlyArray<FrontendAppProviderModule> {\n    return [...this.registry.modules.values()];\n  }\n}\n\nexport function createFrontendProviderRegistryFrontendService(\n  input?: FrontendProviderRegistryHydrationInput,\n): FrontendProviderRegistryFrontendService {\n  const service = new InMemoryFrontendProviderRegistryFrontendService();\n  service.initialize(input);\n  return service;\n}\n"]}

package/dist/esm/core/external-providers/provider-address-lookup-selection.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-address-lookup-selection.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-address-lookup-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAE5E,wDAAwD;AACxD,oBAAY,kCAAkC;IAC5C,8EAA8E;IAC9E,gCAAgC,qCAAqC;IACrE,iFAAiF;IACjF,wBAAwB,6BAA6B;CACtD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,uHAAuH;AACvH,MAAM,MAAM,sCAAsC,GAAG,8BAA8B,CAAC;AAEpF,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAA;CAAE,CAAC;AAE1F,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4GAA4G;IAC5G,QAAQ,CAAC,UAAU,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAC;IACnD,yGAAyG;IACzG,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;CACpC,GAAG,4BAA4B,CAqC/B"}
+{"version":3,"file":"provider-address-lookup-selection.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-address-lookup-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAEL,KAAK,mCAAmC,EACzC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAE5E,wDAAwD;AACxD,oBAAY,kCAAkC;IAC5C,8EAA8E;IAC9E,gCAAgC,qCAAqC;IACrE,iFAAiF;IACjF,wBAAwB,6BAA6B;CACtD;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,uHAAuH;AACvH,MAAM,MAAM,sCAAsC,GAAG,8BAA8B,CAAC;AAEpF,MAAM,MAAM,4BAA4B,GACpC;IAAE,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAC7F;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAA;CAAE,CAAC;AAE1F,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4GAA4G;IAC5G,QAAQ,CAAC,UAAU,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,SAAS,EAAE,8BAA8B,CAAC;IACnD,yGAAyG;IACzG,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;CACpC,GAAG,4BAA4B,CAqC/B"}

package/dist/esm/core/external-providers/provider-address-lookup-selection.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-address-lookup-selection.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-address-lookup-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EACL,qCAAqC,GAEtC,MAAM,sCAAsC,CAAC;AAG9C,wDAAwD;AACxD,MAAM,CAAN,IAAY,kCAKX;AALD,WAAY,kCAAkC;IAC5C,8EAA8E;IAC9E,2GAAqE,CAAA;IACrE,iFAAiF;IACjF,2FAAqD,CAAA;AACvD,CAAC,EALW,kCAAkC,KAAlC,kCAAkC,QAK7C;AAeD,MAAM,UAAU,qCAAqC,CAAC,KAOrD;IACC,uGAAuG;IACvG,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,gBAAgB,IAAI,qCAAqC,CAAC,IAAI,CAAC;IAClG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAE7C,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,qCAAqC,CAAC,IAAI,EAAE,CAAC;QACrF,OAAO;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,kCAAkC,CAAC,gCAAgC;gBACzE,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,sEAAsE;sBAClG,qGAAqG;sBACrG,qDAAqD;aAC1D;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACzF,OAAO;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,kCAAkC,CAAC,wBAAwB;gBACjE,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,0EAA0E;sBACtG,kGAAkG;aACvG;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,OAAO;YACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Holding what an address-lookup component hands back to the contract it DECLARED (#1702) — the\n * `FRONTEND_ADDRESS_LOOKUP` twin of `receiveProviderFileSelections`, and the slot the address field of #561\n * fills from.\n *\n * ## What is checked, and why here\n *\n * The address itself is the application's value: the field validates it against its own `z_address()`\n * schema, as it validates a typed address, and this function applies that schema when the caller passes it\n * so a lookup cannot hand the field a value the field would refuse.\n *\n * The vendor's PLACE ID is the part a vendor's terms govern, so a component declares once, statically,\n * whether it returns one (`ProviderAddressLookupPlaceIdRetention`), and this function holds every selection\n * to that declaration (the #383 rule). A component that declared `NONE` and returns a place id contradicts\n * itself and is refused — a surface that silently kept the id would be holding a vendor key nobody reviewed\n * the terms for. A `TRANSIENT` id is passed through for the interaction.\n *\n * Nothing here says the id may be stored, because nothing may store it (#561 D3): the address field keeps\n * only the address (`AddressFieldLookupHost.applyAddress` takes an `AddressValue`, which has no place for one).\n * The `placeIdStorable` flag this function returned until #561 had no reader and was removed with the\n * `STORABLE` declaration it reported.\n */\n\nimport type { z } from 'zod';\nimport {\n  ProviderAddressLookupPlaceIdRetention,\n  type ProviderFrontendComponentDescriptor,\n} from '@wildo-ai/saas-models/public-runtime';\nimport type { ProviderAddressLookupSelection } from '@wildo-ai/saas-models';\n\n/** Why an address-lookup selection was not accepted. */\nexport enum ProviderAddressLookupRejectionKind {\n  /** The component returned a place id although it declared it returns none. */\n  PLACE_ID_CONTRADICTS_DECLARATION = 'PLACE_ID_CONTRADICTS_DECLARATION',\n  /** The address it returned does not satisfy the receiving field's own schema. */\n  ADDRESS_REFUSED_BY_FIELD = 'ADDRESS_REFUSED_BY_FIELD',\n}\n\nexport interface ProviderAddressLookupRejection {\n  readonly kind: ProviderAddressLookupRejectionKind;\n  readonly providerRef: string;\n  readonly message: string;\n}\n\n/** A selection the field may take: its address, and a place id only when the component declared one (never stored). */\nexport type AcceptedProviderAddressLookupSelection = ProviderAddressLookupSelection;\n\nexport type ProviderAddressLookupOutcome =\n  | { readonly accepted: AcceptedProviderAddressLookupSelection; readonly rejection?: undefined }\n  | { readonly accepted?: undefined; readonly rejection: ProviderAddressLookupRejection };\n\nexport function receiveProviderAddressLookupSelection(input: {\n  readonly providerRef: string;\n  /** The component's declaration, from `providerComponentRegistry.describe(FRONTEND_ADDRESS_LOOKUP, ref)`. */\n  readonly descriptor: ProviderFrontendComponentDescriptor | undefined;\n  readonly selection: ProviderAddressLookupSelection;\n  /** The receiving field's own `z_address()` schema. When given, an address it refuses is refused here. */\n  readonly addressSchema?: z.ZodType;\n}): ProviderAddressLookupOutcome {\n  // Absent means NONE: a component that says nothing about place ids is read as returning none, which is\n  // the reading that can never store a vendor key by default.\n  const declared = input.descriptor?.placeIdRetention ?? ProviderAddressLookupPlaceIdRetention.NONE;\n  const { address, placeId } = input.selection;\n\n  if (placeId !== undefined && declared === ProviderAddressLookupPlaceIdRetention.NONE) {\n    return {\n      rejection: {\n        kind: ProviderAddressLookupRejectionKind.PLACE_ID_CONTRADICTS_DECLARATION,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" declared its address lookup returns no place id and returned one. `\n          + 'Whether a vendor place id is returned is a declaration (`placeIdRetention`), not a runtime choice, '\n          + 'so the selection is refused rather than guessed at.',\n      },\n    };\n  }\n\n  if (input.addressSchema !== undefined && !input.addressSchema.safeParse(address).success) {\n    return {\n      rejection: {\n        kind: ProviderAddressLookupRejectionKind.ADDRESS_REFUSED_BY_FIELD,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" returned an address the field's own schema refuses (a country outside `\n          + 'the ones it accepts, or a missing required part). The lookup is a suggestion; the field decides.',\n      },\n    };\n  }\n\n  return {\n    accepted: {\n      address,\n      ...(placeId !== undefined ? { placeId } : {}),\n    },\n  };\n}\n"]}
+{"version":3,"file":"provider-address-lookup-selection.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-address-lookup-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EACL,qCAAqC,GAEtC,MAAM,sCAAsC,CAAC;AAG9C,wDAAwD;AACxD,MAAM,CAAN,IAAY,kCAKX;AALD,WAAY,kCAAkC;IAC5C,8EAA8E;IAC9E,2GAAqE,CAAA;IACrE,iFAAiF;IACjF,2FAAqD,CAAA;AACvD,CAAC,EALW,kCAAkC,KAAlC,kCAAkC,QAK7C;AAeD,MAAM,UAAU,qCAAqC,CAAC,KAOrD;IACC,uGAAuG;IACvG,4DAA4D;IAC5D,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,gBAAgB,IAAI,qCAAqC,CAAC,IAAI,CAAC;IAClG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAE7C,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,qCAAqC,CAAC,IAAI,EAAE,CAAC;QACrF,OAAO;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,kCAAkC,CAAC,gCAAgC;gBACzE,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,sEAAsE;sBAClG,qGAAqG;sBACrG,qDAAqD;aAC1D;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACzF,OAAO;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,kCAAkC,CAAC,wBAAwB;gBACjE,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,0EAA0E;sBACtG,kGAAkG;aACvG;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,OAAO;YACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Holding what an address-lookup component hands back to the contract it DECLARED (#1702) — the\n * `FRONTEND_ADDRESS_LOOKUP` twin of `receiveProviderFileSelections`, and the slot the address field of #561\n * fills from.\n *\n * ## What is checked, and why here\n *\n * The address itself is the application's value: the field validates it against its own `z_address()`\n * schema, as it validates a typed address, and this function applies that schema when the caller passes it\n * so a lookup cannot hand the field a value the field would refuse.\n *\n * The vendor's PLACE ID is the part a vendor's terms govern, so a component declares once, statically,\n * whether it returns one (`ProviderAddressLookupPlaceIdRetention`), and this function holds every selection\n * to that declaration (the #383 rule). A component that declared `NONE` and returns a place id contradicts\n * itself and is refused — a surface that silently kept the id would be holding a vendor key nobody reviewed\n * the terms for. A `TRANSIENT` id is passed through for the interaction.\n *\n * Nothing here says the id may be stored, because nothing may store it (#561 D3): the address field keeps\n * only the address (`AddressFieldLookupHost.applyAddress` takes an `AddressValue`, which has no place for one).\n * The `placeIdStorable` flag this function returned until #561 had no reader and was removed with the\n * `STORABLE` declaration it reported.\n */\n\nimport type { z } from 'zod';\nimport {\n  ProviderAddressLookupPlaceIdRetention,\n  type ProviderFrontendComponentDescriptor,\n} from '@wildo-ai/saas-models/public-runtime';\nimport type { ProviderAddressLookupSelection } from '@wildo-ai/saas-models';\n\n/** Why an address-lookup selection was not accepted. */\nexport enum ProviderAddressLookupRejectionKind {\n  /** The component returned a place id although it declared it returns none. */\n  PLACE_ID_CONTRADICTS_DECLARATION = 'PLACE_ID_CONTRADICTS_DECLARATION',\n  /** The address it returned does not satisfy the receiving field's own schema. */\n  ADDRESS_REFUSED_BY_FIELD = 'ADDRESS_REFUSED_BY_FIELD',\n}\n\nexport interface ProviderAddressLookupRejection {\n  readonly kind: ProviderAddressLookupRejectionKind;\n  readonly providerRef: string;\n  readonly message: string;\n}\n\n/** A selection the field may take: its address, and a place id only when the component declared one (never stored). */\nexport type AcceptedProviderAddressLookupSelection = ProviderAddressLookupSelection;\n\nexport type ProviderAddressLookupOutcome =\n  | { readonly accepted: AcceptedProviderAddressLookupSelection; readonly rejection?: undefined }\n  | { readonly accepted?: undefined; readonly rejection: ProviderAddressLookupRejection };\n\nexport function receiveProviderAddressLookupSelection(input: {\n  readonly providerRef: string;\n  /** The component's declaration, from `providerComponentRegistry.describe(FRONTEND_ADDRESS_LOOKUP, ref)`. */\n  readonly descriptor: ProviderFrontendComponentDescriptor | undefined;\n  readonly selection: ProviderAddressLookupSelection;\n  /** The receiving field's own `z_address()` schema. When given, an address it refuses is refused here. */\n  readonly addressSchema?: z.ZodType;\n}): ProviderAddressLookupOutcome {\n  // Absent means NONE: a component that says nothing about place ids is read as returning none, which is\n  // the reading that can never store a vendor key by default.\n  const declared = input.descriptor?.placeIdRetention ?? ProviderAddressLookupPlaceIdRetention.NONE;\n  const { address, placeId } = input.selection;\n\n  if (placeId !== undefined && declared === ProviderAddressLookupPlaceIdRetention.NONE) {\n    return {\n      rejection: {\n        kind: ProviderAddressLookupRejectionKind.PLACE_ID_CONTRADICTS_DECLARATION,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" declared its address lookup returns no place id and returned one. `\n          + 'Whether a vendor place id is returned is a declaration (`placeIdRetention`), not a runtime choice, '\n          + 'so the selection is refused rather than guessed at.',\n      },\n    };\n  }\n\n  if (input.addressSchema !== undefined && !input.addressSchema.safeParse(address).success) {\n    return {\n      rejection: {\n        kind: ProviderAddressLookupRejectionKind.ADDRESS_REFUSED_BY_FIELD,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" returned an address the field's own schema refuses (a country outside `\n          + 'the ones it accepts, or a missing required part). The lookup is a suggestion; the field decides.',\n      },\n    };\n  }\n\n  return {\n    accepted: {\n      address,\n      ...(placeId !== undefined ? { placeId } : {}),\n    },\n  };\n}\n"]}

package/dist/esm/core/external-providers/provider-file-selection.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-file-selection.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-file-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EACL,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,mCAAmC,EACzC,MAAM,sCAAsC,CAAC;AAE9C,0DAA0D;AAC1D,oBAAY,kCAAkC;IAC5C;;;;;OAKG;IACH,6BAA6B,kCAAkC;IAC/D;;;;;OAKG;IACH,gCAAgC,qCAAqC;CACtE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CAAC;IACtD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,4BAA4B;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAChE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACvD,GAAG,4BAA4B,CAqC/B"}
+{"version":3,"file":"provider-file-selection.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-file-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAEH,OAAO,EACL,iCAAiC,EACjC,KAAK,qBAAqB,EAC1B,KAAK,mCAAmC,EACzC,MAAM,sCAAsC,CAAC;AAE9C,0DAA0D;AAC1D,oBAAY,kCAAkC;IAC5C;;;;;OAKG;IACH,6BAA6B,kCAAkC;IAC/D;;;;;OAKG;IACH,gCAAgC,qCAAqC;CACtE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CAAC;IACtD,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,4BAA4B;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,SAAS,8BAA8B,EAAE,CAAC;CAChE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,mCAAmC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACvD,GAAG,4BAA4B,CAqC/B"}

package/dist/esm/core/external-providers/provider-file-selection.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-file-selection.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-file-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAQH,0DAA0D;AAC1D,MAAM,CAAN,IAAY,kCAeX;AAfD,WAAY,kCAAkC;IAC5C;;;;;OAKG;IACH,qGAA+D,CAAA;IAC/D;;;;;OAKG;IACH,2GAAqE,CAAA;AACvE,CAAC,EAfW,kCAAkC,KAAlC,kCAAkC,QAe7C;AAkBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAI7C;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAErD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,CAAC;oBACX,IAAI,EAAE,kCAAkC,CAAC,6BAA6B;oBACtE,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,8CAA8C;0BAC1E,qFAAqF;0BACrF,wFAAwF;0BACxF,4FAA4F;iBACjG,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAqC,EAAE,CAAC;IACxD,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAC1C,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,kCAAkC,CAAC,gCAAgC;YACzE,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ;YACR,QAAQ,EAAE,SAAS,CAAC,IAAI;YACxB,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,wCAAwC,QAAQ,mBAAmB;kBAC/F,IAAI,SAAS,CAAC,IAAI,0EAA0E;kBAC5F,6FAA6F;kBAC7F,yEAAyE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE;QAC9B,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Holding a provider's file picker to the selection contract it DECLARED.\n *\n * ## Why this exists at all\n *\n * Issue #383 (Q5) settled what \"an application calls a third party directly from\n * a custom frontend component\" means when the component is a file picker, and\n * the answer was **per vendor, declared**: a picker for a credentialed vendor\n * hands back an opaque remote reference the backend resolves, a picker running\n * on a browser-safe grant hands back bytes or a URL the browser already has, and\n * a provider states which of the two it is.\n *\n * The union alone would have been the hedge that decision rejected. Three arms\n * with a runtime discriminant is a shape that says *\"one of these three, we will\n * find out when it happens\"* — and an application's file field cannot be written\n * against that: the reference arm has to be posted to the executor door, the\n * browser-readable arms go through the ordinary upload path, and choosing\n * between them at runtime means every field carries both.\n *\n * So the declaration is enforced here. A provider that declares\n * `REMOTE_REFERENCE` and hands back a `File` is refused, loudly, naming both\n * sides. Without this the declaration would be decoration, and a reviewer\n * reading a provider's manifest would be reading a wish rather than a contract.\n *\n * ## It is the SANCTIONED seam, not the only possible one\n *\n * `ProviderFilePickerHost` is the path that calls this, and it is what a surface\n * should use. But the registry and the `useProviderComponent` hooks are public\n * too — an application can resolve a provider's component itself, cast it and\n * mount it, and a selection then reaches that application without passing\n * through here.\n *\n * That is deliberate and it is stated rather than closed off: a framework that\n * could only mount a provider component one way would be unable to serve a\n * surface the framework has not thought of, which is the whole reason the\n * capability vocabulary is open. What the framework guarantees is that ITS\n * routing honours the declaration; an application taking the component directly\n * has taken the contract with it, and should call this function.\n *\n * An earlier revision of this paragraph said \"the one seam every selection\n * crosses\", which stopped being true in the same change that exported the other\n * path. Kept as a correction because a load-bearing sentence that quietly goes\n * false is how the next reader inherits a guarantee nobody makes.\n *\n * ## Why refusal is REPORTED rather than thrown\n *\n * This runs inside a picker's own callback, which is usually a vendor SDK's\n * event handler rather than a React render. A throw there does not reach an\n * error boundary — it reaches the vendor's own dispatcher, which typically\n * swallows it — so the surface would stop responding with nothing on screen and\n * nothing in the log. A returned result lets the mounting surface show the user\n * that the picker misbehaved and lets the diagnostic name the provider.\n */\n\nimport {\n  ProviderFrontendSelectionDelivery,\n  type ProviderFileSelection,\n  type ProviderFrontendComponentDescriptor,\n} from '@wildo-ai/saas-models/public-runtime';\n\n/** Why a selection a picker produced was not accepted. */\nexport enum ProviderFileSelectionRejectionKind {\n  /**\n   * The provider declared no `selectionDelivery` for its file picker, so the\n   * framework cannot know whether the result is a backend reference or bytes —\n   * and therefore cannot route it anywhere. An authoring defect in the provider\n   * package, not a user error.\n   */\n  PROVIDER_DECLARED_NO_DELIVERY = 'PROVIDER_DECLARED_NO_DELIVERY',\n  /**\n   * The picker returned a selection whose kind is not the one it declared. This\n   * is the case the whole declaration exists to catch: a `REMOTE_REFERENCE`\n   * provider handing back a `File` means bytes reached the browser on a path\n   * nobody reviewed for it.\n   */\n  DELIVERY_CONTRADICTS_DECLARATION = 'DELIVERY_CONTRADICTS_DECLARATION',\n}\n\nexport interface ProviderFileSelectionRejection {\n  readonly kind: ProviderFileSelectionRejectionKind;\n  readonly providerRef: string;\n  readonly message: string;\n  /** The delivery the provider declared, when it declared one. */\n  readonly declared?: ProviderFrontendSelectionDelivery;\n  /** The kind the picker actually produced, for the contradiction case. */\n  readonly received?: ProviderFileSelection['kind'];\n}\n\nexport interface ProviderFileSelectionOutcome {\n  /** Selections that match the declaration. Empty when anything was rejected — see below. */\n  readonly accepted: readonly ProviderFileSelection[];\n  readonly rejections: readonly ProviderFileSelectionRejection[];\n}\n\n/**\n * Checks every selection against what the provider declared.\n *\n * **All or nothing.** One contradicting selection rejects the whole batch rather\n * than the offending item, and that is deliberate: a picker that returned three\n * files of which one has the wrong shape is a picker whose contract is not what\n * it says, and accepting the other two would leave an application holding a\n * partial result it never asked for from a component it can no longer trust.\n * Silently dropping one of a user's three chosen files is the worse outcome —\n * the user sees two, has no idea why, and nothing anywhere says so.\n */\nexport function receiveProviderFileSelections(input: {\n  readonly providerRef: string;\n  readonly descriptor: ProviderFrontendComponentDescriptor | undefined;\n  readonly selections: readonly ProviderFileSelection[];\n}): ProviderFileSelectionOutcome {\n  const declared = input.descriptor?.selectionDelivery;\n\n  if (declared === undefined) {\n    return {\n      accepted: [],\n      rejections: [{\n        kind: ProviderFileSelectionRejectionKind.PROVIDER_DECLARED_NO_DELIVERY,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" contributes a file picker but declares no `\n          + '`selectionDelivery`, so the framework cannot tell whether a selection is a backend '\n          + 'reference or bytes the browser already holds — and therefore cannot route it. Declare '\n          + 'one on the component: `components: { FRONTEND_FILE_PICKER: { load, selectionDelivery } }`.',\n      }],\n    };\n  }\n\n  const rejections: ProviderFileSelectionRejection[] = [];\n  for (const selection of input.selections) {\n    if (selection.kind === declared) continue;\n    rejections.push({\n      kind: ProviderFileSelectionRejectionKind.DELIVERY_CONTRADICTS_DECLARATION,\n      providerRef: input.providerRef,\n      declared,\n      received: selection.kind,\n      message:\n        `Provider \"${input.providerRef}\" declared its file picker delivers \"${declared}\" and returned a `\n        + `\"${selection.kind}\" selection. Which one a provider emits is a declaration, not a runtime `\n        + 'choice (issue #383): a surface routes a selection before it mounts the picker, so a picker '\n        + 'that contradicts its own declaration is refused rather than guessed at.',\n    });\n  }\n\n  return rejections.length > 0\n    ? { accepted: [], rejections }\n    : { accepted: input.selections, rejections: [] };\n}\n"]}
+{"version":3,"file":"provider-file-selection.frontend.utils.js","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-file-selection.frontend.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AAQH,0DAA0D;AAC1D,MAAM,CAAN,IAAY,kCAeX;AAfD,WAAY,kCAAkC;IAC5C;;;;;OAKG;IACH,qGAA+D,CAAA;IAC/D;;;;;OAKG;IACH,2GAAqE,CAAA;AACvE,CAAC,EAfW,kCAAkC,KAAlC,kCAAkC,QAe7C;AAkBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAI7C;IACC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC;IAErD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,CAAC;oBACX,IAAI,EAAE,kCAAkC,CAAC,6BAA6B;oBACtE,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,8CAA8C;0BAC1E,qFAAqF;0BACrF,wFAAwF;0BACxF,4FAA4F;iBACjG,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAqC,EAAE,CAAC;IACxD,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAC1C,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,kCAAkC,CAAC,gCAAgC;YACzE,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ;YACR,QAAQ,EAAE,SAAS,CAAC,IAAI;YACxB,OAAO,EACL,aAAa,KAAK,CAAC,WAAW,wCAAwC,QAAQ,mBAAmB;kBAC/F,IAAI,SAAS,CAAC,IAAI,0EAA0E;kBAC5F,6FAA6F;kBAC7F,yEAAyE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC;QAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE;QAC9B,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AACrD,CAAC","sourcesContent":["/**\n * Holding a provider's file picker to the selection contract it DECLARED.\n *\n * ## Why this exists at all\n *\n * Issue #383 (Q5) settled what \"an application calls a third party directly from\n * a custom frontend component\" means when the component is a file picker, and\n * the answer was **per vendor, declared**: a picker for a credentialed vendor\n * hands back an opaque remote reference the backend resolves, a picker running\n * on a browser-safe grant hands back bytes or a URL the browser already has, and\n * a provider states which of the two it is.\n *\n * The union alone would have been the hedge that decision rejected. Three arms\n * with a runtime discriminant is a shape that says *\"one of these three, we will\n * find out when it happens\"* — and an application's file field cannot be written\n * against that: the reference arm has to be posted to the executor door, the\n * browser-readable arms go through the ordinary upload path, and choosing\n * between them at runtime means every field carries both.\n *\n * So the declaration is enforced here. A provider that declares\n * `REMOTE_REFERENCE` and hands back a `File` is refused, loudly, naming both\n * sides. Without this the declaration would be decoration, and a reviewer\n * reading a provider's manifest would be reading a wish rather than a contract.\n *\n * ## It is the SANCTIONED seam, not the only possible one\n *\n * `ProviderFilePickerHost` is the path that calls this, and it is what a surface\n * should use. But the registry and the `useProviderComponent` hooks are public\n * too — an application can resolve a provider's component itself, cast it and\n * mount it, and a selection then reaches that application without passing\n * through here.\n *\n * That is deliberate and it is stated rather than closed off: a framework that\n * could only mount a provider component one way would be unable to serve a\n * surface the framework has not thought of, which is the whole reason the\n * capability vocabulary is open. What the framework guarantees is that ITS\n * routing honours the declaration; an application taking the component directly\n * has taken the contract with it, and should call this function.\n *\n * An earlier revision of this paragraph said \"the one seam every selection\n * crosses\", which stopped being true in the same change that exported the other\n * path. Kept as a correction because a load-bearing sentence that quietly goes\n * false is how the next reader inherits a guarantee nobody makes.\n *\n * ## Why refusal is REPORTED rather than thrown\n *\n * This runs inside a picker's own callback, which is usually a vendor SDK's\n * event handler rather than a React render. A throw there does not reach an\n * error boundary — it reaches the vendor's own dispatcher, which typically\n * swallows it — so the surface would stop responding with nothing on screen and\n * nothing in the log. A returned result lets the mounting surface show the user\n * that the picker misbehaved and lets the diagnostic name the provider.\n */\n\nimport {\n  ProviderFrontendSelectionDelivery,\n  type ProviderFileSelection,\n  type ProviderFrontendComponentDescriptor,\n} from '@wildo-ai/saas-models/public-runtime';\n\n/** Why a selection a picker produced was not accepted. */\nexport enum ProviderFileSelectionRejectionKind {\n  /**\n   * The provider declared no `selectionDelivery` for its file picker, so the\n   * framework cannot know whether the result is a backend reference or bytes —\n   * and therefore cannot route it anywhere. An authoring defect in the provider\n   * package, not a user error.\n   */\n  PROVIDER_DECLARED_NO_DELIVERY = 'PROVIDER_DECLARED_NO_DELIVERY',\n  /**\n   * The picker returned a selection whose kind is not the one it declared. This\n   * is the case the whole declaration exists to catch: a `REMOTE_REFERENCE`\n   * provider handing back a `File` means bytes reached the browser on a path\n   * nobody reviewed for it.\n   */\n  DELIVERY_CONTRADICTS_DECLARATION = 'DELIVERY_CONTRADICTS_DECLARATION',\n}\n\nexport interface ProviderFileSelectionRejection {\n  readonly kind: ProviderFileSelectionRejectionKind;\n  readonly providerRef: string;\n  readonly message: string;\n  /** The delivery the provider declared, when it declared one. */\n  readonly declared?: ProviderFrontendSelectionDelivery;\n  /** The kind the picker actually produced, for the contradiction case. */\n  readonly received?: ProviderFileSelection['kind'];\n}\n\nexport interface ProviderFileSelectionOutcome {\n  /** Selections that match the declaration. Empty when anything was rejected — see below. */\n  readonly accepted: readonly ProviderFileSelection[];\n  readonly rejections: readonly ProviderFileSelectionRejection[];\n}\n\n/**\n * Checks every selection against what the provider declared.\n *\n * **All or nothing.** One contradicting selection rejects the whole batch rather\n * than the offending item, and that is deliberate: a picker that returned three\n * files of which one has the wrong shape is a picker whose contract is not what\n * it says, and accepting the other two would leave an application holding a\n * partial result it never asked for from a component it can no longer trust.\n * Silently dropping one of a user's three chosen files is the worse outcome —\n * the user sees two, has no idea why, and nothing anywhere says so.\n */\nexport function receiveProviderFileSelections(input: {\n  readonly providerRef: string;\n  readonly descriptor: ProviderFrontendComponentDescriptor | undefined;\n  readonly selections: readonly ProviderFileSelection[];\n}): ProviderFileSelectionOutcome {\n  const declared = input.descriptor?.selectionDelivery;\n\n  if (declared === undefined) {\n    return {\n      accepted: [],\n      rejections: [{\n        kind: ProviderFileSelectionRejectionKind.PROVIDER_DECLARED_NO_DELIVERY,\n        providerRef: input.providerRef,\n        message:\n          `Provider \"${input.providerRef}\" contributes a file picker but declares no `\n          + '`selectionDelivery`, so the framework cannot tell whether a selection is a backend '\n          + 'reference or bytes the browser already holds — and therefore cannot route it. Declare '\n          + 'one on the component: `components: { FRONTEND_FILE_PICKER: { load, selectionDelivery } }`.',\n      }],\n    };\n  }\n\n  const rejections: ProviderFileSelectionRejection[] = [];\n  for (const selection of input.selections) {\n    if (selection.kind === declared) continue;\n    rejections.push({\n      kind: ProviderFileSelectionRejectionKind.DELIVERY_CONTRADICTS_DECLARATION,\n      providerRef: input.providerRef,\n      declared,\n      received: selection.kind,\n      message:\n        `Provider \"${input.providerRef}\" declared its file picker delivers \"${declared}\" and returned a `\n        + `\"${selection.kind}\" selection. Which one a provider emits is a declaration, not a runtime `\n        + 'choice (issue #383): a surface routes a selection before it mounts the picker, so a picker '\n        + 'that contradicts its own declaration is refused rather than guessed at.',\n    });\n  }\n\n  return rejections.length > 0\n    ? { accepted: [], rejections }\n    : { accepted: input.selections, rejections: [] };\n}\n"]}

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-scope-reauthorization-offers.frontend.d.ts","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjI;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,OAAO,GAAG,iCAAiC,GAAG,SAAS,CAMlH;AAED,sHAAsH;AACtH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,sCAAsC,EAAE,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAIrJ;AAED,2GAA2G;AAC3G,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjI;AAED,qDAAqD;AACrD,wBAAgB,0CAA0C,IAAI,IAAI,CAGjE;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,EAC9D,KAAK,EAAE,sCAAsC,EAC7C,aAAa,EAAE,MAAM,GACpB,iCAAiC,GAAG,SAAS,CAE/C;AAOD,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G"}
+{"version":3,"file":"provider-scope-reauthorization-offers.frontend.d.ts","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,uBAAuB,CAAC;AAE/E,6EAA6E;AAC7E,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD;;;GAGG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjI;AAED;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE,OAAO,GAAG,iCAAiC,GAAG,SAAS,CAMlH;AAED,sHAAsH;AACtH,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,sCAAsC,EAAE,KAAK,EAAE,iCAAiC,GAAG,IAAI,CAIrJ;AAED,2GAA2G;AAC3G,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,sCAAsC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjI;AAED,qDAAqD;AACrD,wBAAgB,0CAA0C,IAAI,IAAI,CAGjE;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G;AAED,kFAAkF;AAClF,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,EAC9D,KAAK,EAAE,sCAAsC,EAC7C,aAAa,EAAE,MAAM,GACpB,iCAAiC,GAAG,SAAS,CAE/C;AAOD,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,WAAW,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAE9G"}

package/dist/esm/core/external-providers/provider-scope-reauthorization-offers.frontend.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-scope-reauthorization-offers.frontend.js","sourceRoot":"","sources":["../../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The re-authorization OFFERS a browser has been handed and not yet acted on (#1671, #1727).\n *\n * ## Why a store, and why it lives here\n *\n * A provider operation refused for a missing scope answers `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` carrying a\n * `reauthorization` offer: which scopes a person may add by re-authorizing the connection, for which operation. The\n * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while\n * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the\n * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing\n * about it.\n *\n * The manual-calls client records every offer it sees (`executeProviderOperation`, `loadProviderOperationInputOptions`),\n * so no feature has to remember to; the connected-accounts screen reads them and shows \"grant more access\" on the\n * connection they belong to.\n *\n * ## Keyed on the OWNER as well as the connection\n *\n * One vendor connection exists per owner: a person's own Microsoft grant and their organization's Microsoft grant are\n * two grants with one `connectionRef`. An offer keyed on the connection alone would appear on whichever owner's screen\n * was opened next — and pressing it would grow a DIFFERENT owner's grant while its audit row named an operation that\n * was refused on the first. So an offer is recorded under the owner the refused call spent (`ownerScope`, `ownerId`),\n * and a screen reads only its own owner's.\n *\n * ## Deliberately in-memory, one per owner and connection\n *\n * An offer is a statement about ONE refused call in this browser session. It is not persisted: a reload loses it, and\n * the next refused call records it again — the backend recomputes the offer on every refusal, so nothing durable is\n * lost and nothing stale can outlive the page. Growing the grant leaves the page for the vendor, which also ends it.\n * The latest refusal replaces an earlier one for the same owner and connection; scopes the connection has since been\n * granted are filtered by the screen, not here.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ProviderScopeReauthorizationOffer } from '@wildo-ai/saas-models';\n\n/** Whose grant a refused call spent — the connection target's owner half. */\nexport interface ProviderScopeReauthorizationOfferOwner {\n  readonly ownerScope: string;\n  /** Absent for the application's own connection, which no settings screen grows. */\n  readonly ownerId?: string;\n}\n\ntype Listener = () => void;\n\nlet offersByKey: ReadonlyMap<string, ProviderScopeReauthorizationOffer> = new Map();\nconst listeners = new Set<Listener>();\n\nfunction publish(next: ReadonlyMap<string, ProviderScopeReauthorizationOffer>): void {\n  offersByKey = next;\n  for (const listener of listeners) listener();\n}\n\n/**\n * The store key of one owner's offer for one connection. JSON of a fixed-order tuple rather than a joined string, so\n * no separator a ref or an id could contain can make two different owners collide.\n */\nexport function providerScopeReauthorizationOfferKey(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): string {\n  return JSON.stringify([owner.ownerScope, owner.ownerId ?? null, connectionRef]);\n}\n\n/**\n * Whether a refused call's body carries a re-authorization offer — read by SHAPE, so the frontend holds no copy of the\n * backend's door error code. An offer names its connection, the ref to start through, the operation and the scope\n * lists; anything missing one of them is not an offer and is ignored rather than half-recorded.\n */\nexport function readProviderScopeReauthorizationOffer(body: unknown): ProviderScopeReauthorizationOffer | undefined {\n  const offer = (body as { reauthorization?: unknown } | null | undefined)?.reauthorization as Partial<ProviderScopeReauthorizationOffer> | undefined;\n  if (offer === undefined || offer === null || typeof offer !== 'object') return undefined;\n  if (typeof offer.connectionRef !== 'string' || typeof offer.providerRef !== 'string' || typeof offer.operationId !== 'string') return undefined;\n  if (!Array.isArray(offer.requestableScopes) || !Array.isArray(offer.administratorConsentScopes) || !Array.isArray(offer.unrequestableScopes)) return undefined;\n  return offer as ProviderScopeReauthorizationOffer;\n}\n\n/** Record an offer for the owner whose grant the refused call spent, replacing an earlier one for that connection. */\nexport function recordProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, offer: ProviderScopeReauthorizationOffer): void {\n  const next = new Map(offersByKey);\n  next.set(providerScopeReauthorizationOfferKey(owner, offer.connectionRef), offer);\n  publish(next);\n}\n\n/** Forget one owner's offer for one connection — after it was acted on, or when the connection is gone. */\nexport function clearProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): void {\n  const key = providerScopeReauthorizationOfferKey(owner, connectionRef);\n  if (!offersByKey.has(key)) return;\n  const next = new Map(offersByKey);\n  next.delete(key);\n  publish(next);\n}\n\n/** Forget every offer. For a test's `beforeEach`. */\nexport function clearAllProviderScopeReauthorizationOffers(): void {\n  if (offersByKey.size === 0) return;\n  publish(new Map());\n}\n\n/** Every pending offer, keyed by {@link providerScopeReauthorizationOfferKey}. */\nexport function getProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return offersByKey;\n}\n\n/** One owner's pending offer for one connection, from a snapshot of the store. */\nexport function findProviderScopeReauthorizationOffer(\n  offers: ReadonlyMap<string, ProviderScopeReauthorizationOffer>,\n  owner: ProviderScopeReauthorizationOfferOwner,\n  connectionRef: string,\n): ProviderScopeReauthorizationOffer | undefined {\n  return offers.get(providerScopeReauthorizationOfferKey(owner, connectionRef));\n}\n\nfunction subscribe(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => { listeners.delete(listener); };\n}\n\n/** The pending offers, re-rendering the caller when one is recorded or cleared. */\nexport function useProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return useSyncExternalStore(subscribe, getProviderScopeReauthorizationOffers, getProviderScopeReauthorizationOffers);\n}\n"]}
+{"version":3,"file":"provider-scope-reauthorization-offers.frontend.js","sourceRoot":"","sources":["../../../../src/core/external-providers/provider-scope-reauthorization-offers.frontend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The re-authorization OFFERS a browser has been handed and not yet acted on (#1671, #1727).\n *\n * ## Why a store, and why it lives here\n *\n * A provider operation refused for a missing scope answers `409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` carrying a\n * `reauthorization` offer: which scopes a person may add by re-authorizing the connection, for which operation. The\n * refusal happens wherever the operation was called — a feature's own screen, a picker loading its options — while\n * growing the grant is an act on the CONNECTION, which the connected-accounts screen owns. Something has to carry the\n * offer from the one to the other, or the person meets a dead end at the feature and a screen that knows nothing\n * about it.\n *\n * The manual-calls client records every offer it sees (`executeProviderOperation`, `loadProviderOperationInputOptions`),\n * so no feature has to remember to; the connected-accounts screen reads them and shows \"grant more access\" on the\n * connection they belong to.\n *\n * ## Keyed on the OWNER as well as the connection\n *\n * One vendor connection exists per owner: a person's own Microsoft grant and their organization's Microsoft grant are\n * two grants with one `connectionRef`. An offer keyed on the connection alone would appear on whichever owner's screen\n * was opened next — and pressing it would grow a DIFFERENT owner's grant while its audit row named an operation that\n * was refused on the first. So an offer is recorded under the owner the refused call spent (`ownerScope`, `ownerId`),\n * and a screen reads only its own owner's.\n *\n * ## Deliberately in-memory, one per owner and connection\n *\n * An offer is a statement about ONE refused call in this browser session. It is not persisted: a reload loses it, and\n * the next refused call records it again — the backend recomputes the offer on every refusal, so nothing durable is\n * lost and nothing stale can outlive the page. Growing the grant leaves the page for the vendor, which also ends it.\n * The latest refusal replaces an earlier one for the same owner and connection; scopes the connection has since been\n * granted are filtered by the screen, not here.\n */\n\nimport { useSyncExternalStore } from 'react';\nimport type { ProviderScopeReauthorizationOffer } from '@wildo-ai/saas-models';\n\n/** Whose grant a refused call spent — the connection target's owner half. */\nexport interface ProviderScopeReauthorizationOfferOwner {\n  readonly ownerScope: string;\n  /** Absent for the application's own connection, which no settings screen grows. */\n  readonly ownerId?: string;\n}\n\ntype Listener = () => void;\n\nlet offersByKey: ReadonlyMap<string, ProviderScopeReauthorizationOffer> = new Map();\nconst listeners = new Set<Listener>();\n\nfunction publish(next: ReadonlyMap<string, ProviderScopeReauthorizationOffer>): void {\n  offersByKey = next;\n  for (const listener of listeners) listener();\n}\n\n/**\n * The store key of one owner's offer for one connection. JSON of a fixed-order tuple rather than a joined string, so\n * no separator a ref or an id could contain can make two different owners collide.\n */\nexport function providerScopeReauthorizationOfferKey(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): string {\n  return JSON.stringify([owner.ownerScope, owner.ownerId ?? null, connectionRef]);\n}\n\n/**\n * Whether a refused call's body carries a re-authorization offer — read by SHAPE, so the frontend holds no copy of the\n * backend's door error code. An offer names its connection, the ref to start through, the operation and the scope\n * lists; anything missing one of them is not an offer and is ignored rather than half-recorded.\n */\nexport function readProviderScopeReauthorizationOffer(body: unknown): ProviderScopeReauthorizationOffer | undefined {\n  const offer = (body as { reauthorization?: unknown } | null | undefined)?.reauthorization as Partial<ProviderScopeReauthorizationOffer> | undefined;\n  if (offer === undefined || offer === null || typeof offer !== 'object') return undefined;\n  if (typeof offer.connectionRef !== 'string' || typeof offer.providerRef !== 'string' || typeof offer.operationId !== 'string') return undefined;\n  if (!Array.isArray(offer.requestableScopes) || !Array.isArray(offer.administratorConsentScopes) || !Array.isArray(offer.unrequestableScopes)) return undefined;\n  return offer as ProviderScopeReauthorizationOffer;\n}\n\n/** Record an offer for the owner whose grant the refused call spent, replacing an earlier one for that connection. */\nexport function recordProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, offer: ProviderScopeReauthorizationOffer): void {\n  const next = new Map(offersByKey);\n  next.set(providerScopeReauthorizationOfferKey(owner, offer.connectionRef), offer);\n  publish(next);\n}\n\n/** Forget one owner's offer for one connection — after it was acted on, or when the connection is gone. */\nexport function clearProviderScopeReauthorizationOffer(owner: ProviderScopeReauthorizationOfferOwner, connectionRef: string): void {\n  const key = providerScopeReauthorizationOfferKey(owner, connectionRef);\n  if (!offersByKey.has(key)) return;\n  const next = new Map(offersByKey);\n  next.delete(key);\n  publish(next);\n}\n\n/** Forget every offer. For a test's `beforeEach`. */\nexport function clearAllProviderScopeReauthorizationOffers(): void {\n  if (offersByKey.size === 0) return;\n  publish(new Map());\n}\n\n/** Every pending offer, keyed by {@link providerScopeReauthorizationOfferKey}. */\nexport function getProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return offersByKey;\n}\n\n/** One owner's pending offer for one connection, from a snapshot of the store. */\nexport function findProviderScopeReauthorizationOffer(\n  offers: ReadonlyMap<string, ProviderScopeReauthorizationOffer>,\n  owner: ProviderScopeReauthorizationOfferOwner,\n  connectionRef: string,\n): ProviderScopeReauthorizationOffer | undefined {\n  return offers.get(providerScopeReauthorizationOfferKey(owner, connectionRef));\n}\n\nfunction subscribe(listener: Listener): () => void {\n  listeners.add(listener);\n  return () => { listeners.delete(listener); };\n}\n\n/** The pending offers, re-rendering the caller when one is recorded or cleared. */\nexport function useProviderScopeReauthorizationOffers(): ReadonlyMap<string, ProviderScopeReauthorizationOffer> {\n  return useSyncExternalStore(subscribe, getProviderScopeReauthorizationOffers, getProviderScopeReauthorizationOffers);\n}\n"]}

package/dist/esm/core/features/FeatureGate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM5F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAgC7C"}
+{"version":3,"file":"FeatureGate.d.ts","sourceRoot":"","sources":["../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM5F,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E;AAED,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GAClB,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAgC7C"}

package/dist/esm/core/features/FeatureGate.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureGate.js","sourceRoot":"","sources":["../../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":";AAsBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6EAA6E,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAgBrF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GACA;IACjB,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,yCAAyC;IACzC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,IAAI,YAAY,CAAC,QAAQ,KAAK,6BAA6B,CAAC,IAAI,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,4BAAG,iBAAiB,CAAC,YAAY,CAAC,GAAI,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,CACL,KAAC,wBAAwB,IACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,eAAe,EAAE,YAAY,CAAC,eAAe,EAC7C,SAAS,EAAE,YAAY,CAAC,SAAS,EACjC,mBAAmB,EAAE,YAAY,CAAC,cAAc,EAAE,MAAM,EACxD,kBAAkB,EAAE,YAAY,CAAC,kBAAkB,EACnD,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAC3C,CACH,CAAC;AACJ,CAAC","sourcesContent":["/**\n * FeatureGate — Declarative feature gating component\n * \n * Wraps children with a feature availability check. If the feature is available,\n * renders children. If not, automatically renders the policy-driven prompt.\n * \n * Usage:\n *   const analyticsFeatureId = APP_FEATURE_IDS.ADVANCED_ANALYTICS;\n *\n *   <FeatureGate featureId={analyticsFeatureId}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n * \n *   // Custom rendering when unavailable:\n *   <FeatureGate featureId={analyticsFeatureId} renderUnavailable={(availability) => (\n *     <MyCustomUpsell availability={availability} />\n *   )}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n */\n\nimport React from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\n\n// Note: useFeatureGate hook is in a separate file (useFeatureGate.ts) for React Fast Refresh compatibility.\n\nexport interface FeatureGateProps {\n  /** Feature identifier to check */\n  featureId: string;\n  /** Content to render when the feature is available */\n  children: React.ReactNode;\n  /** \n   * Optional custom renderer when the feature is unavailable.\n   * If omitted, renders the policy-driven FeatureUnavailablePrompt automatically.\n   */\n  renderUnavailable?: (availability: FeatureAvailability) => React.ReactNode;\n}\n\nexport function FeatureGate({\n  featureId,\n  children,\n  renderUnavailable,\n}: FeatureGateProps): React.JSX.Element | null {\n  const availability = useFeatureAvailability(featureId);\n  const billingAction = useBillingAction();\n\n  // Feature is available → render children\n  if (availability.isAvailable) {\n    return <>{children}</>;\n  }\n\n  // HIDE behavior → render nothing\n  if (availability.behavior === FeatureUnavailabilityBehavior.HIDE) {\n    return null;\n  }\n\n  // Custom renderer provided → delegate\n  if (renderUnavailable) {\n    return <>{renderUnavailable(availability)}</>;\n  }\n\n  // Default: policy-driven prompt. Inline FeatureGate surfaces do not expose a\n  // generic \"go back\" action because they are embedded into the current page.\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      customComponentRef={availability.customComponentRef}\n      onDismiss={undefined}\n      onAction={() => billingAction(availability)}\n    />\n  );\n}\n"]}
+{"version":3,"file":"FeatureGate.js","sourceRoot":"","sources":["../../../../src/core/features/FeatureGate.tsx"],"names":[],"mappings":";AAsBA,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAA4B,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,6EAA6E,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAgBrF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,QAAQ,EACR,iBAAiB,GACA;IACjB,MAAM,YAAY,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IAEzC,yCAAyC;IACzC,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,IAAI,YAAY,CAAC,QAAQ,KAAK,6BAA6B,CAAC,IAAI,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,4BAAG,iBAAiB,CAAC,YAAY,CAAC,GAAI,CAAC;IAChD,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,CACL,KAAC,wBAAwB,IACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAC/B,eAAe,EAAE,YAAY,CAAC,eAAe,EAC7C,SAAS,EAAE,YAAY,CAAC,SAAS,EACjC,mBAAmB,EAAE,YAAY,CAAC,cAAc,EAAE,MAAM,EACxD,kBAAkB,EAAE,YAAY,CAAC,kBAAkB,EACnD,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,YAAY,CAAC,GAC3C,CACH,CAAC;AACJ,CAAC","sourcesContent":["/**\n * FeatureGate — Declarative feature gating component\n * \n * Wraps children with a feature availability check. If the feature is available,\n * renders children. If not, automatically renders the policy-driven prompt.\n * \n * Usage:\n *   const analyticsFeatureId = APP_FEATURE_IDS.ADVANCED_ANALYTICS;\n *\n *   <FeatureGate featureId={analyticsFeatureId}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n * \n *   // Custom rendering when unavailable:\n *   <FeatureGate featureId={analyticsFeatureId} renderUnavailable={(availability) => (\n *     <MyCustomUpsell availability={availability} />\n *   )}>\n *     <AnalyticsDashboard />\n *   </FeatureGate>\n */\n\nimport React from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport { useFeatureAvailability, type FeatureAvailability } from './useFeatureAvailability';\nimport { FeatureUnavailablePrompt } from '~wildo-frontend-lib/components/feedback/features/feature-unavailable-prompt';\nimport { useBillingAction } from '~wildo-frontend-lib/core/billing/useBillingAction';\n\n// Note: useFeatureGate hook is in a separate file (useFeatureGate.ts) for React Fast Refresh compatibility.\n\nexport interface FeatureGateProps {\n  /** Feature identifier to check */\n  featureId: string;\n  /** Content to render when the feature is available */\n  children: React.ReactNode;\n  /** \n   * Optional custom renderer when the feature is unavailable.\n   * If omitted, renders the policy-driven FeatureUnavailablePrompt automatically.\n   */\n  renderUnavailable?: (availability: FeatureAvailability) => React.ReactNode;\n}\n\nexport function FeatureGate({\n  featureId,\n  children,\n  renderUnavailable,\n}: FeatureGateProps): React.JSX.Element | null {\n  const availability = useFeatureAvailability(featureId);\n  const billingAction = useBillingAction();\n\n  // Feature is available → render children\n  if (availability.isAvailable) {\n    return <>{children}</>;\n  }\n\n  // HIDE behavior → render nothing\n  if (availability.behavior === FeatureUnavailabilityBehavior.HIDE) {\n    return null;\n  }\n\n  // Custom renderer provided → delegate\n  if (renderUnavailable) {\n    return <>{renderUnavailable(availability)}</>;\n  }\n\n  // Default: policy-driven prompt. Inline FeatureGate surfaces do not expose a\n  // generic \"go back\" action because they are embedded into the current page.\n  return (\n    <FeatureUnavailablePrompt\n      behavior={availability.behavior}\n      missingFeatures={availability.missingFeatures}\n      limitInfo={availability.limitInfo}\n      upgradeOptionsCount={availability.upgradeOptions?.length}\n      customComponentRef={availability.customComponentRef}\n      onDismiss={undefined}\n      onAction={() => billingAction(availability)}\n    />\n  );\n}\n"]}