@feelflow/ffid-sdk 5.27.0 → 5.29.0

package/dist/{index-D3S_Pkkv.d.ts → index-_-MqJCN3.d.ts}

@@ -1036,6 +1036,26 @@ type FFIDInquiryCategorySite2026 = (typeof FFID_INQUIRY_CATEGORIES_SITE_2026)[nu
  * parameter) to the canonical union.
  */
 declare const isFFIDInquiryCategorySite2026: (value: string) => value is FFIDInquiryCategorySite2026;
+/**
+ * Acquisition-source ("how did you first hear about us") survey slugs
+ * accepted by `/api/v1/ext/inquiry` (feelflow-id-platform#4377). Mirrors
+ * feelflow-website-2026 `ACQUISITION_SOURCE_OPTIONS`
+ * (`feelflow-site/src/lib/acquisition-source.ts`); FFID
+ * `src/lib/inquiry/acquisition-sources.ts` is the persistence-side
+ * source of truth.
+ *
+ * Unlike `category`, the server validates this field strictly: a value
+ * outside this list is rejected with `INQUIRY_VALIDATION_ERROR` rather than
+ * stored as-is. Ship a new slug to FFID first, then start sending it.
+ */
+declare const FFID_INQUIRY_ACQUISITION_SOURCES: readonly ["referral", "generative-ai", "social-media", "networking-event", "web-search", "company-blog", "sales-outreach", "press-release", "web-advertising", "other"];
+type FFIDInquiryAcquisitionSource = (typeof FFID_INQUIRY_ACQUISITION_SOURCES)[number];
+/**
+ * Runtime type guard for the acquisition-source allowlist. Use when
+ * narrowing an unknown string (e.g., a URL query parameter or analytics
+ * value) before passing it to `client.inquiry.create()`.
+ */
+declare const isFFIDInquiryAcquisitionSource: (value: string) => value is FFIDInquiryAcquisitionSource;
 /**
  * Parameters for `client.inquiry.create()`. When submitting from a
  * server-side SDK (Service API Key), set `source` to a stable
@@ -1055,6 +1075,18 @@ interface FFIDInquiryCreateParams {
     name: string;
     message: string;
     category?: FFIDInquiryCategorySite2026 | FFIDInquiryCategory | (string & {});
+    /**
+     * "How did you first hear about us" survey answer (#4377). Optional and
+     * backward compatible — `undefined` and `null` are both normalized to
+     * an omitted key on the wire (`null` is accepted so
+     * `FFIDInquiryFormSubmitData.acquisitionSource` can be forwarded
+     * verbatim) and the row is stored with NULL.
+     * Server-side validation is a strict allowlist (unlike `category`):
+     * values outside {@link FFID_INQUIRY_ACQUISITION_SOURCES} fail with
+     * `INQUIRY_VALIDATION_ERROR`. Narrow untrusted strings with
+     * {@link isFFIDInquiryAcquisitionSource} before submitting.
+     */
+    acquisitionSource?: FFIDInquiryAcquisitionSource | null;
     company?: string;
     phone?: string;
     locale?: 'ja' | 'en';
@@ -1420,6 +1452,15 @@ interface FFIDInquiryFormSubmitData {
     company: string | null;
     phone: string | null;
     category: string;
+    /**
+     * Acquisition-source slug forwarded verbatim from the
+     * `acquisitionSource` prop (#4377). `null` when the consumer does not
+     * collect the survey — existing `onSubmit` handlers that ignore the
+     * field keep working unchanged. Typed as the closed allowlist union so
+     * the payload can be handed to `client.inquiry.create()` without a
+     * re-narrowing cast.
+     */
+    acquisitionSource: FFIDInquiryAcquisitionSource | null;
     message: string;
     organizationId: string | null;
     inquiryFollowupOptIn: boolean;
@@ -1449,6 +1490,19 @@ interface FFIDInquiryFormProps {
     privacyHref?: string;
     /** Must be refreshed by the consumer when the Turnstile widget reissues a token. */
     turnstileToken?: string | null;
+    /**
+     * Acquisition-source survey answer collected by the consumer's own UI
+     * (#4377). The form renders no input for it — like `turnstileToken`,
+     * it is a consumer-controlled value passed through into
+     * `FFIDInquiryFormSubmitData.acquisitionSource` on every submit /
+     * `onChange` broadcast. Typed as the closed
+     * `FFID_INQUIRY_ACQUISITION_SOURCES` union so an invalid slug (e.g. a
+     * display label, or a new value not yet deployed to FFID) fails at the
+     * consumer's compile step instead of rejecting every end-user
+     * submission with `INQUIRY_VALIDATION_ERROR` at runtime. Narrow
+     * untrusted strings with `isFFIDInquiryAcquisitionSource` first.
+     */
+    acquisitionSource?: FFIDInquiryAcquisitionSource | null;
     /** Slot for the consumer's Turnstile widget (anonymous mode only). */
     turnstileSlot?: ReactNode;
     onSubmit: (data: FFIDInquiryFormSubmitData) => Promise<FFIDInquiryFormSubmitResult>;
@@ -1534,6 +1588,6 @@ interface FFIDInquiryFormProps {
 interface FFIDInquiryFormPlaceholderContext {
     category: string | null;
 }
-declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, legalLayout, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
+declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, acquisitionSource, turnstileSlot, onSubmit, onChange, legalLayout, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDInquiryFormSubmitResult as $, type AnnouncementListResponse as A, type AnnouncementStatus as B, type AnnouncementType as C, EFFECTIVE_SUBSCRIPTION_STATUSES as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, FFIDAnnouncementBadge as G, FFIDAnnouncementList as H, type FFIDAnnouncementsError as I, type FFIDAnnouncementsErrorCode as J, type FFIDAnnouncementsServerResponse as K, type ListAnnouncementsOptions as L, type FFIDApiResponseMeta as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, type FFIDInquiryCategorySite2026 as Q, FFIDInquiryForm as R, type FFIDInquiryFormCategoryItem as S, type TokenStore as T, type FFIDInquiryFormClassNames as U, type FFIDInquiryFormLegalLayout as V, type FFIDInquiryFormOrganization as W, type FFIDInquiryFormPlaceholderContext as X, type FFIDInquiryFormPrefill as Y, type FFIDInquiryFormProps as Z, type FFIDInquiryFormSubmitData as _, type FFIDOAuthUserInfoSubscription as a, type FFIDJwtClaims as a0, FFIDLoginButton as a1, type FFIDOAuthUserInfoMemberRole as a2, FFIDOrganizationSwitcher as a3, type FFIDSeatAssignmentClaim as a4, type FFIDSeatAssignmentStatus as a5, type FFIDSeatModel as a6, type FFIDServiceAccessDenialReason as a7, type FFIDServiceAccessFailPolicy as a8, FFIDSubscriptionBadge as a9, FFIDUserMenu as aa, FFID_INQUIRY_CATEGORIES as ab, FFID_INQUIRY_CATEGORIES_SITE_2026 as ac, type TokenData as ad, type UseFFIDAnnouncementsOptions as ae, type UseFFIDAnnouncementsReturn as af, createTokenStore as ag, isFFIDInquiryCategorySite2026 as ah, useFFIDAnnouncements as ai, type FFIDAnnouncementBadgeClassNames as aj, type FFIDAnnouncementBadgeProps as ak, type FFIDAnnouncementListClassNames as al, type FFIDAnnouncementListProps as am, type FFIDLoginButtonProps as an, type FFIDOrganizationSwitcherClassNames as ao, type FFIDOrganizationSwitcherProps as ap, type FFIDSubscriptionBadgeClassNames as aq, type FFIDSubscriptionBadgeProps as ar, type FFIDUserMenuClassNames as as, type FFIDUserMenuProps as at, type FFIDPrompt as b, type FFIDConfig as c, type FFIDApiResponse as d, type FFIDSessionResponse as e, type FFIDSignOutResult as f, type FFIDError as g, type FFIDSubscriptionCheckResponse as h, type FFIDCheckServiceAccessParams as i, type FFIDServiceAccessDecision as j, type FFIDAnalyticsConfig as k, type FFIDVerifyAccessTokenOptions as l, type FFIDOAuthUserInfo as m, type FFIDInquiryCreateParams as n, type FFIDInquiryCreateResponse as o, type FFIDAuthMode as p, type FFIDLogger as q, type FFIDCacheAdapter as r, type FFIDUser as s, type FFIDOrganization as t, type FFIDSubscription as u, type FFIDSubscriptionContextValue as v, type FFIDAnnouncementsClientConfig as w, type FFIDAnnouncementsApiResponse as x, type FFIDAnnouncementsLogger as y, type Announcement as z };
+export { type FFIDInquiryFormSubmitData as $, type AnnouncementListResponse as A, type AnnouncementStatus as B, type AnnouncementType as C, EFFECTIVE_SUBSCRIPTION_STATUSES as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, FFIDAnnouncementBadge as G, FFIDAnnouncementList as H, type FFIDAnnouncementsError as I, type FFIDAnnouncementsErrorCode as J, type FFIDAnnouncementsServerResponse as K, type ListAnnouncementsOptions as L, type FFIDApiResponseMeta as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryAcquisitionSource as P, type FFIDInquiryCategory as Q, type FFIDInquiryCategorySite2026 as R, FFIDInquiryForm as S, type TokenStore as T, type FFIDInquiryFormCategoryItem as U, type FFIDInquiryFormClassNames as V, type FFIDInquiryFormLegalLayout as W, type FFIDInquiryFormOrganization as X, type FFIDInquiryFormPlaceholderContext as Y, type FFIDInquiryFormPrefill as Z, type FFIDInquiryFormProps as _, type FFIDOAuthUserInfoSubscription as a, type FFIDInquiryFormSubmitResult as a0, type FFIDJwtClaims as a1, FFIDLoginButton as a2, type FFIDOAuthUserInfoMemberRole as a3, FFIDOrganizationSwitcher as a4, type FFIDSeatAssignmentClaim as a5, type FFIDSeatAssignmentStatus as a6, type FFIDSeatModel as a7, type FFIDServiceAccessDenialReason as a8, type FFIDServiceAccessFailPolicy as a9, FFIDSubscriptionBadge as aa, FFIDUserMenu as ab, FFID_INQUIRY_ACQUISITION_SOURCES as ac, FFID_INQUIRY_CATEGORIES as ad, FFID_INQUIRY_CATEGORIES_SITE_2026 as ae, type TokenData as af, type UseFFIDAnnouncementsOptions as ag, type UseFFIDAnnouncementsReturn as ah, createTokenStore as ai, isFFIDInquiryAcquisitionSource as aj, isFFIDInquiryCategorySite2026 as ak, useFFIDAnnouncements as al, type FFIDAnnouncementBadgeClassNames as am, type FFIDAnnouncementBadgeProps as an, type FFIDAnnouncementListClassNames as ao, type FFIDAnnouncementListProps as ap, type FFIDLoginButtonProps as aq, type FFIDOrganizationSwitcherClassNames as ar, type FFIDOrganizationSwitcherProps as as, type FFIDSubscriptionBadgeClassNames as at, type FFIDSubscriptionBadgeProps as au, type FFIDUserMenuClassNames as av, type FFIDUserMenuProps as aw, type FFIDPrompt as b, type FFIDConfig as c, type FFIDApiResponse as d, type FFIDSessionResponse as e, type FFIDSignOutResult as f, type FFIDError as g, type FFIDSubscriptionCheckResponse as h, type FFIDCheckServiceAccessParams as i, type FFIDServiceAccessDecision as j, type FFIDAnalyticsConfig as k, type FFIDVerifyAccessTokenOptions as l, type FFIDOAuthUserInfo as m, type FFIDInquiryCreateParams as n, type FFIDInquiryCreateResponse as o, type FFIDAuthMode as p, type FFIDLogger as q, type FFIDCacheAdapter as r, type FFIDUser as s, type FFIDOrganization as t, type FFIDSubscription as u, type FFIDSubscriptionContextValue as v, type FFIDAnnouncementsClientConfig as w, type FFIDAnnouncementsApiResponse as x, type FFIDAnnouncementsLogger as y, type Announcement as z };

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkR4KUHR4S_cjs = require('./chunk-R4KUHR4S.cjs');
+var chunkMESRDT7H_cjs = require('./chunk-MESRDT7H.cjs');
 var chunkH5O2CCAY_cjs = require('./chunk-H5O2CCAY.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -54,8 +54,8 @@ function defaultRedirect(url) {
 }
 function useRequireActiveSubscription(options) {
   const { redirectTo, allowGrace = true, onRedirect } = options;
-  const { isLoading, error } = chunkR4KUHR4S_cjs.useFFIDContext();
-  const { effectiveStatus, isBlocked, isGrace } = chunkR4KUHR4S_cjs.useSubscription();
+  const { isLoading, error } = chunkMESRDT7H_cjs.useFFIDContext();
+  const { effectiveStatus, isBlocked, isGrace } = chunkMESRDT7H_cjs.useSubscription();
   const hasFetchError = error !== null && effectiveStatus === null;
   const shouldRedirect = !isLoading && !hasFetchError && (isBlocked || !allowGrace && isGrace || effectiveStatus === null);
   react.useEffect(() => {
@@ -76,7 +76,7 @@ function useRequireActiveSubscription(options) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkR4KUHR4S_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkMESRDT7H_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -105,211 +105,219 @@ var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
 Object.defineProperty(exports, "ACCESS_GRANTING_EFFECTIVE_STATUSES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.ACCESS_GRANTING_EFFECTIVE_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.ACCESS_GRANTING_EFFECTIVE_STATUSES; }
 });
 Object.defineProperty(exports, "BLOCKING_EFFECTIVE_STATUSES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.BLOCKING_EFFECTIVE_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.BLOCKING_EFFECTIVE_STATUSES; }
 });
 Object.defineProperty(exports, "CATALOG_HASH_PATTERN", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.CATALOG_HASH_PATTERN; }
+  get: function () { return chunkMESRDT7H_cjs.CATALOG_HASH_PATTERN; }
 });
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkMESRDT7H_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "DEFAULT_OAUTH_SCOPES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.DEFAULT_OAUTH_SCOPES; }
+  get: function () { return chunkMESRDT7H_cjs.DEFAULT_OAUTH_SCOPES; }
 });
 Object.defineProperty(exports, "EFFECTIVE_SUBSCRIPTION_STATUSES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.EFFECTIVE_SUBSCRIPTION_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.EFFECTIVE_SUBSCRIPTION_STATUSES; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDCatalogHashError", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDCatalogHashError; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDCatalogHashError; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDInquiryForm; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDLoginButton; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDProvider; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDSDKError; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDUserMenu; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_CATALOG_ENVIRONMENTS", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_CATALOG_ENVIRONMENTS; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_CATALOG_ENVIRONMENTS; }
 });
 Object.defineProperty(exports, "FFID_CATALOG_PUBLICATION_STATUSES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_CATALOG_PUBLICATION_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_CATALOG_PUBLICATION_STATUSES; }
 });
 Object.defineProperty(exports, "FFID_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_ERROR_CODES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_ERROR_CODES; }
+});
+Object.defineProperty(exports, "FFID_INQUIRY_ACQUISITION_SOURCES", {
+  enumerable: true,
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_ACQUISITION_SOURCES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "canonicalizeCatalogValue", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.canonicalizeCatalogValue; }
+  get: function () { return chunkMESRDT7H_cjs.canonicalizeCatalogValue; }
 });
 Object.defineProperty(exports, "clearState", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.cleanupStateStorage; }
+  get: function () { return chunkMESRDT7H_cjs.cleanupStateStorage; }
 });
 Object.defineProperty(exports, "computeEffectiveStatusFromSession", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computeEffectiveStatusFromSession; }
+  get: function () { return chunkMESRDT7H_cjs.computeEffectiveStatusFromSession; }
 });
 Object.defineProperty(exports, "computeFFIDCheckoutCopyHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computeFFIDCheckoutCopyHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeFFIDCheckoutCopyHash; }
 });
 Object.defineProperty(exports, "computeLegalDisclosureHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computeLegalDisclosureHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeLegalDisclosureHash; }
 });
 Object.defineProperty(exports, "computePaymentConfigurationHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computePaymentConfigurationHash; }
+  get: function () { return chunkMESRDT7H_cjs.computePaymentConfigurationHash; }
 });
 Object.defineProperty(exports, "computePraxisCopyHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computePraxisCopyHash; }
+  get: function () { return chunkMESRDT7H_cjs.computePraxisCopyHash; }
 });
 Object.defineProperty(exports, "computeScopeHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computeScopeHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeScopeHash; }
 });
 Object.defineProperty(exports, "computeTaxConfigurationHash", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.computeTaxConfigurationHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeTaxConfigurationHash; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkMESRDT7H_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.createFFIDClient; }
+  get: function () { return chunkMESRDT7H_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.createTokenStore; }
+  get: function () { return chunkMESRDT7H_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.generateCodeChallenge; }
+  get: function () { return chunkMESRDT7H_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.generateCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "handleRedirectCallback", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.handleRedirectCallback; }
+  get: function () { return chunkMESRDT7H_cjs.handleRedirectCallback; }
 });
 Object.defineProperty(exports, "hasAccessFromUserinfo", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.hasAccessFromUserinfo; }
+  get: function () { return chunkMESRDT7H_cjs.hasAccessFromUserinfo; }
 });
 Object.defineProperty(exports, "hashCanonicalJson", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.hashCanonicalJson; }
+  get: function () { return chunkMESRDT7H_cjs.hashCanonicalJson; }
 });
 Object.defineProperty(exports, "isBlockedFromUserinfo", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.isBlockedFromUserinfo; }
+  get: function () { return chunkMESRDT7H_cjs.isBlockedFromUserinfo; }
+});
+Object.defineProperty(exports, "isFFIDInquiryAcquisitionSource", {
+  enumerable: true,
+  get: function () { return chunkMESRDT7H_cjs.isFFIDInquiryAcquisitionSource; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkMESRDT7H_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.normalizeRedirectUri; }
+  get: function () { return chunkMESRDT7H_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveState", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.retrieveState; }
+  get: function () { return chunkMESRDT7H_cjs.retrieveState; }
 });
 Object.defineProperty(exports, "sha256Hex", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.sha256Hex; }
+  get: function () { return chunkMESRDT7H_cjs.sha256Hex; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.storeCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "storeState", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.storeState; }
+  get: function () { return chunkMESRDT7H_cjs.storeState; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.useFFID; }
+  get: function () { return chunkMESRDT7H_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkMESRDT7H_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.useSubscription; }
+  get: function () { return chunkMESRDT7H_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "validatePublishedCatalog", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.validatePublishedCatalog; }
+  get: function () { return chunkMESRDT7H_cjs.validatePublishedCatalog; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.withSubscription; }
+  get: function () { return chunkMESRDT7H_cjs.withSubscription; }
 });
 Object.defineProperty(exports, "ALL_DENIED_EXCEPT_NECESSARY", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDPrompt, c as FFIDConfig, d as FFIDApiResponse, e as FFIDSessionResponse, f as FFIDSignOutResult, g as FFIDError, h as FFIDSubscriptionCheckResponse, i as FFIDCheckServiceAccessParams, j as FFIDServiceAccessDecision, k as FFIDAnalyticsConfig, l as FFIDVerifyAccessTokenOptions, m as FFIDOAuthUserInfo, n as FFIDInquiryCreateParams, o as FFIDInquiryCreateResponse, T as TokenStore, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-D3S_Pkkv.cjs';
-export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as EFFECTIVE_SUBSCRIPTION_STATUSES, G as FFIDAnnouncementBadge, H as FFIDAnnouncementList, I as FFIDAnnouncementsError, J as FFIDAnnouncementsErrorCode, K as FFIDAnnouncementsServerResponse, M as FFIDApiResponseMeta, N as FFIDCacheConfig, O as FFIDContextValue, P as FFIDInquiryCategory, Q as FFIDInquiryCategorySite2026, R as FFIDInquiryForm, S as FFIDInquiryFormCategoryItem, U as FFIDInquiryFormClassNames, V as FFIDInquiryFormLegalLayout, W as FFIDInquiryFormOrganization, X as FFIDInquiryFormPlaceholderContext, Y as FFIDInquiryFormPrefill, Z as FFIDInquiryFormProps, _ as FFIDInquiryFormSubmitData, $ as FFIDInquiryFormSubmitResult, a0 as FFIDJwtClaims, a1 as FFIDLoginButton, a2 as FFIDOAuthUserInfoMemberRole, a3 as FFIDOrganizationSwitcher, a4 as FFIDSeatAssignmentClaim, a5 as FFIDSeatAssignmentStatus, a6 as FFIDSeatModel, a7 as FFIDServiceAccessDenialReason, a8 as FFIDServiceAccessFailPolicy, a9 as FFIDSubscriptionBadge, aa as FFIDUserMenu, ab as FFID_INQUIRY_CATEGORIES, ac as FFID_INQUIRY_CATEGORIES_SITE_2026, ad as TokenData, ae as UseFFIDAnnouncementsOptions, af as UseFFIDAnnouncementsReturn, ag as createTokenStore, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-D3S_Pkkv.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDPrompt, c as FFIDConfig, d as FFIDApiResponse, e as FFIDSessionResponse, f as FFIDSignOutResult, g as FFIDError, h as FFIDSubscriptionCheckResponse, i as FFIDCheckServiceAccessParams, j as FFIDServiceAccessDecision, k as FFIDAnalyticsConfig, l as FFIDVerifyAccessTokenOptions, m as FFIDOAuthUserInfo, n as FFIDInquiryCreateParams, o as FFIDInquiryCreateResponse, T as TokenStore, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-_-MqJCN3.cjs';
+export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as EFFECTIVE_SUBSCRIPTION_STATUSES, G as FFIDAnnouncementBadge, H as FFIDAnnouncementList, I as FFIDAnnouncementsError, J as FFIDAnnouncementsErrorCode, K as FFIDAnnouncementsServerResponse, M as FFIDApiResponseMeta, N as FFIDCacheConfig, O as FFIDContextValue, P as FFIDInquiryAcquisitionSource, Q as FFIDInquiryCategory, R as FFIDInquiryCategorySite2026, S as FFIDInquiryForm, U as FFIDInquiryFormCategoryItem, V as FFIDInquiryFormClassNames, W as FFIDInquiryFormLegalLayout, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDOAuthUserInfoMemberRole, a4 as FFIDOrganizationSwitcher, a5 as FFIDSeatAssignmentClaim, a6 as FFIDSeatAssignmentStatus, a7 as FFIDSeatModel, a8 as FFIDServiceAccessDenialReason, a9 as FFIDServiceAccessFailPolicy, aa as FFIDSubscriptionBadge, ab as FFIDUserMenu, ac as FFID_INQUIRY_ACQUISITION_SOURCES, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as TokenData, ag as UseFFIDAnnouncementsOptions, ah as UseFFIDAnnouncementsReturn, ai as createTokenStore, aj as isFFIDInquiryAcquisitionSource, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-_-MqJCN3.cjs';
 export { A as ALL_DENIED_EXCEPT_NECESSARY, i as CONSENT_COOKIE_NAME, j as CONSENT_DISMISSAL_TIMESTAMP_KEY, l as COOKIE_VERSION, D as DEFAULT_CONSENT_ERROR_MESSAGES, o as FFIDAnalyticsProvider, p as FFIDAnalyticsProviderProps, c as FFIDConsentCategories, r as FFIDConsentCategoryCode, e as FFIDConsentCategoryMetadata, w as FFIDConsentError, x as FFIDConsentErrorCode, y as FFIDConsentMergeStrategy, B as FFIDConsentMergeWarning, E as FFIDConsentMergeWarningEvent, F as FFIDConsentResult, I as FFIDConsentSource, a as FFIDConsentState, d as FFIDConsentSyncResult, M as FFIDCookieBanner, N as FFIDCookieBannerClassNames, O as FFIDCookieBannerProps, Q as FFIDCookieLink, R as FFIDCookieLinkProps, f as FFIDCookiePolicy, T as FFIDCookieSettings, U as FFIDCookieSettingsClassNames, V as FFIDCookieSettingsProps, _ as FFID_CONSENT_ERROR_CODES, ae as UseFFIDConsentPreferencesReturn, af as UseFFIDConsentReturn, ag as clearConsentDismissalTimestamp, aj as decodeConsentCookie, al as encodeConsentCookie, an as readConsentCookie, ao as readConsentDismissalTimestamp, aq as useFFIDConsent, ar as useFFIDConsentPreferences, as as writeConsentCookie, at as writeConsentDismissalTimestamp } from './FFIDCookieLink-BJgVcJyw.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
@@ -625,6 +625,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -1577,6 +1602,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDPrompt, c as FFIDConfig, d as FFIDApiResponse, e as FFIDSessionResponse, f as FFIDSignOutResult, g as FFIDError, h as FFIDSubscriptionCheckResponse, i as FFIDCheckServiceAccessParams, j as FFIDServiceAccessDecision, k as FFIDAnalyticsConfig, l as FFIDVerifyAccessTokenOptions, m as FFIDOAuthUserInfo, n as FFIDInquiryCreateParams, o as FFIDInquiryCreateResponse, T as TokenStore, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-D3S_Pkkv.js';
-export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as EFFECTIVE_SUBSCRIPTION_STATUSES, G as FFIDAnnouncementBadge, H as FFIDAnnouncementList, I as FFIDAnnouncementsError, J as FFIDAnnouncementsErrorCode, K as FFIDAnnouncementsServerResponse, M as FFIDApiResponseMeta, N as FFIDCacheConfig, O as FFIDContextValue, P as FFIDInquiryCategory, Q as FFIDInquiryCategorySite2026, R as FFIDInquiryForm, S as FFIDInquiryFormCategoryItem, U as FFIDInquiryFormClassNames, V as FFIDInquiryFormLegalLayout, W as FFIDInquiryFormOrganization, X as FFIDInquiryFormPlaceholderContext, Y as FFIDInquiryFormPrefill, Z as FFIDInquiryFormProps, _ as FFIDInquiryFormSubmitData, $ as FFIDInquiryFormSubmitResult, a0 as FFIDJwtClaims, a1 as FFIDLoginButton, a2 as FFIDOAuthUserInfoMemberRole, a3 as FFIDOrganizationSwitcher, a4 as FFIDSeatAssignmentClaim, a5 as FFIDSeatAssignmentStatus, a6 as FFIDSeatModel, a7 as FFIDServiceAccessDenialReason, a8 as FFIDServiceAccessFailPolicy, a9 as FFIDSubscriptionBadge, aa as FFIDUserMenu, ab as FFID_INQUIRY_CATEGORIES, ac as FFID_INQUIRY_CATEGORIES_SITE_2026, ad as TokenData, ae as UseFFIDAnnouncementsOptions, af as UseFFIDAnnouncementsReturn, ag as createTokenStore, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-D3S_Pkkv.js';
+import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDPrompt, c as FFIDConfig, d as FFIDApiResponse, e as FFIDSessionResponse, f as FFIDSignOutResult, g as FFIDError, h as FFIDSubscriptionCheckResponse, i as FFIDCheckServiceAccessParams, j as FFIDServiceAccessDecision, k as FFIDAnalyticsConfig, l as FFIDVerifyAccessTokenOptions, m as FFIDOAuthUserInfo, n as FFIDInquiryCreateParams, o as FFIDInquiryCreateResponse, T as TokenStore, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-_-MqJCN3.js';
+export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as EFFECTIVE_SUBSCRIPTION_STATUSES, G as FFIDAnnouncementBadge, H as FFIDAnnouncementList, I as FFIDAnnouncementsError, J as FFIDAnnouncementsErrorCode, K as FFIDAnnouncementsServerResponse, M as FFIDApiResponseMeta, N as FFIDCacheConfig, O as FFIDContextValue, P as FFIDInquiryAcquisitionSource, Q as FFIDInquiryCategory, R as FFIDInquiryCategorySite2026, S as FFIDInquiryForm, U as FFIDInquiryFormCategoryItem, V as FFIDInquiryFormClassNames, W as FFIDInquiryFormLegalLayout, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDOAuthUserInfoMemberRole, a4 as FFIDOrganizationSwitcher, a5 as FFIDSeatAssignmentClaim, a6 as FFIDSeatAssignmentStatus, a7 as FFIDSeatModel, a8 as FFIDServiceAccessDenialReason, a9 as FFIDServiceAccessFailPolicy, aa as FFIDSubscriptionBadge, ab as FFIDUserMenu, ac as FFID_INQUIRY_ACQUISITION_SOURCES, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as TokenData, ag as UseFFIDAnnouncementsOptions, ah as UseFFIDAnnouncementsReturn, ai as createTokenStore, aj as isFFIDInquiryAcquisitionSource, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-_-MqJCN3.js';
 export { A as ALL_DENIED_EXCEPT_NECESSARY, i as CONSENT_COOKIE_NAME, j as CONSENT_DISMISSAL_TIMESTAMP_KEY, l as COOKIE_VERSION, D as DEFAULT_CONSENT_ERROR_MESSAGES, o as FFIDAnalyticsProvider, p as FFIDAnalyticsProviderProps, c as FFIDConsentCategories, r as FFIDConsentCategoryCode, e as FFIDConsentCategoryMetadata, w as FFIDConsentError, x as FFIDConsentErrorCode, y as FFIDConsentMergeStrategy, B as FFIDConsentMergeWarning, E as FFIDConsentMergeWarningEvent, F as FFIDConsentResult, I as FFIDConsentSource, a as FFIDConsentState, d as FFIDConsentSyncResult, M as FFIDCookieBanner, N as FFIDCookieBannerClassNames, O as FFIDCookieBannerProps, Q as FFIDCookieLink, R as FFIDCookieLinkProps, f as FFIDCookiePolicy, T as FFIDCookieSettings, U as FFIDCookieSettingsClassNames, V as FFIDCookieSettingsProps, _ as FFID_CONSENT_ERROR_CODES, ae as UseFFIDConsentPreferencesReturn, af as UseFFIDConsentReturn, ag as clearConsentDismissalTimestamp, aj as decodeConsentCookie, al as encodeConsentCookie, an as readConsentCookie, ao as readConsentDismissalTimestamp, aq as useFFIDConsent, ar as useFFIDConsentPreferences, as as writeConsentCookie, at as writeConsentDismissalTimestamp } from './FFIDCookieLink-BJgVcJyw.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
@@ -625,6 +625,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -1577,6 +1602,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-JZB2IM7Y.js';
-export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EFFECTIVE_SUBSCRIPTION_STATUSES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDCatalogHashError, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, canonicalizeCatalogValue, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useFFIDAnnouncements, useSubscription, validatePublishedCatalog, withSubscription } from './chunk-JZB2IM7Y.js';
+import { useFFIDContext, useSubscription } from './chunk-4QQJMLL7.js';
+export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EFFECTIVE_SUBSCRIPTION_STATUSES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDCatalogHashError, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_ERROR_CODES, FFID_INQUIRY_ACQUISITION_SOURCES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, canonicalizeCatalogValue, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, isFFIDInquiryAcquisitionSource, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useFFIDAnnouncements, useSubscription, validatePublishedCatalog, withSubscription } from './chunk-4QQJMLL7.js';
 export { ALL_DENIED_EXCEPT_NECESSARY, CONSENT_COOKIE_NAME, CONSENT_DISMISSAL_TIMESTAMP_KEY, COOKIE_VERSION, DEFAULT_CONSENT_ERROR_MESSAGES, FFIDAnalyticsProvider, FFIDConsentError, FFIDCookieBanner, FFIDCookieLink, FFIDCookieSettings, FFID_CONSENT_ERROR_CODES, clearConsentDismissalTimestamp, decodeConsentCookie, encodeConsentCookie, readConsentCookie, readConsentDismissalTimestamp, useFFIDConsent, useFFIDConsentPreferences, writeConsentCookie, writeConsentDismissalTimestamp } from './chunk-G7VOX64X.js';
 import { useEffect, useRef } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';