@feelflow/ffid-sdk 5.27.0 → 5.28.0

package/dist/{chunk-JZB2IM7Y.js → chunk-75UNNOLV.js}

@@ -1643,7 +1643,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.27.0";
+var SDK_VERSION = "5.28.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3150,6 +3150,11 @@ function createInquiryMethods(deps) {
         name,
         message,
         category: params.category,
+        // Normalize null ("survey not collected", e.g. forwarded verbatim
+        // from FFIDInquiryFormSubmitData) to undefined so JSON.stringify
+        // drops the key entirely — older FFID deployments never see it and
+        // current ones treat the omission as NULL.
+        acquisitionSource: params.acquisitionSource ?? void 0,
         company: params.company,
         phone: params.phone,
         locale: params.locale,
@@ -5360,6 +5365,19 @@ var FFID_INQUIRY_CATEGORIES_SITE_2026 = [
   "other"
 ];
 var isFFIDInquiryCategorySite2026 = (value) => FFID_INQUIRY_CATEGORIES_SITE_2026.includes(value);
+var FFID_INQUIRY_ACQUISITION_SOURCES = [
+  "referral",
+  "generative-ai",
+  "social-media",
+  "networking-event",
+  "web-search",
+  "company-blog",
+  "sales-outreach",
+  "press-release",
+  "web-advertising",
+  "other"
+];
+var isFFIDInquiryAcquisitionSource = (value) => FFID_INQUIRY_ACQUISITION_SOURCES.includes(value);
 var CATEGORY_PLACEHOLDER_LABEL_JA = "\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044";
 var CATEGORY_REQUIRED_ERROR_JA = "\u304A\u554F\u3044\u5408\u308F\u305B\u7A2E\u5225\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
 var TERMS_REQUIRED_ERROR_JA = "\u5229\u7528\u898F\u7D04\u3078\u306E\u540C\u610F\u304C\u5FC5\u8981\u3067\u3059\u3002";
@@ -5492,6 +5510,7 @@ function FFIDInquiryForm({
   termsHref,
   privacyHref,
   turnstileToken = null,
+  acquisitionSource = null,
   turnstileSlot,
   onSubmit,
   onChange,
@@ -5573,6 +5592,7 @@ function FFIDInquiryForm({
       company: company.trim() || null,
       phone: phone.trim() || null,
       category,
+      acquisitionSource,
       message: message.trim(),
       organizationId,
       inquiryFollowupOptIn: inquiryFollowup,
@@ -5588,6 +5608,7 @@ function FFIDInquiryForm({
     company,
     phone,
     category,
+    acquisitionSource,
     message,
     organizationId,
     inquiryFollowup,
@@ -5636,6 +5657,7 @@ function FFIDInquiryForm({
         company: company.trim() || null,
         phone: phone.trim() || null,
         category,
+        acquisitionSource,
         message: message.trim(),
         organizationId,
         inquiryFollowupOptIn: inquiryFollowup,
@@ -5954,4 +5976,4 @@ function FFIDInquiryForm({
   );
 }
 
-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, 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, useFFIDContext, useSubscription, validatePublishedCatalog, withSubscription };
+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, 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, useFFIDContext, useSubscription, validatePublishedCatalog, withSubscription };

package/dist/{chunk-R4KUHR4S.cjs → chunk-S5FV6H2U.cjs}

@@ -1645,7 +1645,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.27.0";
+var SDK_VERSION = "5.28.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3152,6 +3152,11 @@ function createInquiryMethods(deps) {
         name,
         message,
         category: params.category,
+        // Normalize null ("survey not collected", e.g. forwarded verbatim
+        // from FFIDInquiryFormSubmitData) to undefined so JSON.stringify
+        // drops the key entirely — older FFID deployments never see it and
+        // current ones treat the omission as NULL.
+        acquisitionSource: params.acquisitionSource ?? void 0,
         company: params.company,
         phone: params.phone,
         locale: params.locale,
@@ -5362,6 +5367,19 @@ var FFID_INQUIRY_CATEGORIES_SITE_2026 = [
   "other"
 ];
 var isFFIDInquiryCategorySite2026 = (value) => FFID_INQUIRY_CATEGORIES_SITE_2026.includes(value);
+var FFID_INQUIRY_ACQUISITION_SOURCES = [
+  "referral",
+  "generative-ai",
+  "social-media",
+  "networking-event",
+  "web-search",
+  "company-blog",
+  "sales-outreach",
+  "press-release",
+  "web-advertising",
+  "other"
+];
+var isFFIDInquiryAcquisitionSource = (value) => FFID_INQUIRY_ACQUISITION_SOURCES.includes(value);
 var CATEGORY_PLACEHOLDER_LABEL_JA = "\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044";
 var CATEGORY_REQUIRED_ERROR_JA = "\u304A\u554F\u3044\u5408\u308F\u305B\u7A2E\u5225\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
 var TERMS_REQUIRED_ERROR_JA = "\u5229\u7528\u898F\u7D04\u3078\u306E\u540C\u610F\u304C\u5FC5\u8981\u3067\u3059\u3002";
@@ -5494,6 +5512,7 @@ function FFIDInquiryForm({
   termsHref,
   privacyHref,
   turnstileToken = null,
+  acquisitionSource = null,
   turnstileSlot,
   onSubmit,
   onChange,
@@ -5575,6 +5594,7 @@ function FFIDInquiryForm({
       company: company.trim() || null,
       phone: phone.trim() || null,
       category,
+      acquisitionSource,
       message: message.trim(),
       organizationId,
       inquiryFollowupOptIn: inquiryFollowup,
@@ -5590,6 +5610,7 @@ function FFIDInquiryForm({
     company,
     phone,
     category,
+    acquisitionSource,
     message,
     organizationId,
     inquiryFollowup,
@@ -5638,6 +5659,7 @@ function FFIDInquiryForm({
         company: company.trim() || null,
         phone: phone.trim() || null,
         category,
+        acquisitionSource,
         message: message.trim(),
         organizationId,
         inquiryFollowupOptIn: inquiryFollowup,
@@ -5976,6 +5998,7 @@ exports.FFID_ANNOUNCEMENTS_ERROR_CODES = FFID_ANNOUNCEMENTS_ERROR_CODES;
 exports.FFID_CATALOG_ENVIRONMENTS = FFID_CATALOG_ENVIRONMENTS;
 exports.FFID_CATALOG_PUBLICATION_STATUSES = FFID_CATALOG_PUBLICATION_STATUSES;
 exports.FFID_ERROR_CODES = FFID_ERROR_CODES;
+exports.FFID_INQUIRY_ACQUISITION_SOURCES = FFID_INQUIRY_ACQUISITION_SOURCES;
 exports.FFID_INQUIRY_CATEGORIES = FFID_INQUIRY_CATEGORIES;
 exports.FFID_INQUIRY_CATEGORIES_SITE_2026 = FFID_INQUIRY_CATEGORIES_SITE_2026;
 exports.canonicalizeCatalogValue = canonicalizeCatalogValue;
@@ -5996,6 +6019,7 @@ exports.handleRedirectCallback = handleRedirectCallback;
 exports.hasAccessFromUserinfo = hasAccessFromUserinfo;
 exports.hashCanonicalJson = hashCanonicalJson;
 exports.isBlockedFromUserinfo = isBlockedFromUserinfo;
+exports.isFFIDInquiryAcquisitionSource = isFFIDInquiryAcquisitionSource;
 exports.isFFIDInquiryCategorySite2026 = isFFIDInquiryCategorySite2026;
 exports.normalizeRedirectUri = normalizeRedirectUri;
 exports.retrieveCodeVerifier = retrieveCodeVerifier;

package/dist/components/index.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunkR4KUHR4S_cjs = require('../chunk-R4KUHR4S.cjs');
+var chunkS5FV6H2U_cjs = require('../chunk-S5FV6H2U.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDInquiryForm; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDLoginButton; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkR4KUHR4S_cjs.FFIDUserMenu; }
+  get: function () { return chunkS5FV6H2U_cjs.FFIDUserMenu; }
 });

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { G as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, H as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, 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, a1 as FFIDLoginButton, an as FFIDLoginButtonProps, a3 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, a9 as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, aa as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-D3S_Pkkv.cjs';
+export { G as FFIDAnnouncementBadge, am as FFIDAnnouncementBadgeClassNames, an as FFIDAnnouncementBadgeProps, H as FFIDAnnouncementList, ao as FFIDAnnouncementListClassNames, ap as FFIDAnnouncementListProps, 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, a2 as FFIDLoginButton, aq as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, ar as FFIDOrganizationSwitcherClassNames, as as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, at as FFIDSubscriptionBadgeClassNames, au as FFIDSubscriptionBadgeProps, ab as FFIDUserMenu, av as FFIDUserMenuClassNames, aw as FFIDUserMenuProps } from '../index-_-MqJCN3.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { G as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, H as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, 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, a1 as FFIDLoginButton, an as FFIDLoginButtonProps, a3 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, a9 as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, aa as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-D3S_Pkkv.js';
+export { G as FFIDAnnouncementBadge, am as FFIDAnnouncementBadgeClassNames, an as FFIDAnnouncementBadgeProps, H as FFIDAnnouncementList, ao as FFIDAnnouncementListClassNames, ap as FFIDAnnouncementListProps, 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, a2 as FFIDLoginButton, aq as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, ar as FFIDOrganizationSwitcherClassNames, as as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, at as FFIDSubscriptionBadgeClassNames, au as FFIDSubscriptionBadgeProps, ab as FFIDUserMenu, av as FFIDUserMenuClassNames, aw as FFIDUserMenuProps } from '../index-_-MqJCN3.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-JZB2IM7Y.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-75UNNOLV.js';

package/dist/{ffid-client-BlVuH6ja.d.cts → ffid-client-B_VBvIt4.d.cts}

@@ -46,6 +46,20 @@ type FFIDInquiryCategory = (typeof FFID_INQUIRY_CATEGORIES)[number];
  */
 declare const FFID_INQUIRY_CATEGORIES_SITE_2026: readonly ["consulting", "saas", "development", "agent-hub", "ai-feel-chatbot", "knowledge-db", "biz-simulator", "discussion-board", "realtime-ai", "partnership", "media", "recruiting", "other"];
 type FFIDInquiryCategorySite2026 = (typeof FFID_INQUIRY_CATEGORIES_SITE_2026)[number];
+/**
+ * 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];
 /**
  * Parameters for `client.inquiry.create()`. When submitting from a
  * server-side SDK (Service API Key), set `source` to a stable
@@ -65,6 +79,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';
@@ -2242,4 +2268,4 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
-export { type FFIDProvisionOrganizationDryRun as A, type FFIDProvisionOrganizationMemberInput as B, type FFIDProvisionOrganizationOutcome as C, type FFIDProvisionOrganizationParams as D, type FFIDProvisionOrganizationResponse as E, type FFIDLogger as F, type FFIDProvisionUserDryRun as G, type FFIDProvisionUserOutcome as H, type FFIDProvisionUserParams as I, type FFIDProvisionUserProfileInput as J, type FFIDProvisionUserResponse as K, type FFIDProvisionedOrganization as L, type FFIDProvisionedUser as M, type FFIDRemoveMemberResponse as N, type FFIDResetSessionResponse as O, type FFIDSubscription as P, type FFIDUpdateMemberRoleResponse as Q, type FFIDUpdateUserProfileRequest as R, type FFIDUser as S, type FFIDUserProfile as T, type TokenData as U, type TokenStore as V, createFFIDClient as W, createTokenStore as X, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDAddMemberParams as f, type FFIDAddMemberRequest as g, type FFIDAddMemberResponse as h, type FFIDAssignableMemberRole as i, type FFIDCacheConfig as j, type FFIDClient as k, type FFIDConfig as l, type FFIDListMembersResponse as m, type FFIDMemberRole as n, type FFIDOrganization as o, type FFIDOrganizationMember as p, type FFIDOtpSendResponse as q, type FFIDOtpVerifyResponse as r, type FFIDPasswordResetConfirmResponse as s, type FFIDPasswordResetResponse as t, type FFIDPasswordResetVerifyResponse as u, type FFIDProfileCallOptions as v, type FFIDProvisionMemberPlan as w, type FFIDProvisionMemberPlanStatus as x, type FFIDProvisionMemberResult as y, type FFIDProvisionMemberStatus as z };
+export { FFID_CATALOG_ENVIRONMENTS as $, type FFIDPasswordResetVerifyResponse as A, type FFIDProfileCallOptions as B, type FFIDProvisionMemberPlan as C, type FFIDProvisionMemberPlanStatus as D, type FFIDProvisionMemberResult as E, type FFIDLogger as F, type FFIDProvisionMemberStatus as G, type FFIDProvisionOrganizationDryRun as H, type FFIDProvisionOrganizationMemberInput as I, type FFIDProvisionOrganizationOutcome as J, type FFIDProvisionOrganizationParams as K, type FFIDProvisionOrganizationResponse as L, type FFIDProvisionUserDryRun as M, type FFIDProvisionUserOutcome as N, type FFIDProvisionUserParams as O, type FFIDProvisionUserProfileInput as P, type FFIDProvisionUserResponse as Q, type FFIDProvisionedOrganization as R, type FFIDProvisionedUser as S, type FFIDPublishedPlan as T, type FFIDRemoveMemberResponse as U, type FFIDResetSessionResponse as V, type FFIDSubscription as W, type FFIDUpdateMemberRoleResponse as X, type FFIDUpdateUserProfileRequest as Y, type FFIDUser as Z, type FFIDUserProfile as _, type FFIDError as a, FFID_CATALOG_PUBLICATION_STATUSES as a0, type TokenData as a1, type TokenStore as a2, createFFIDClient as a3, createTokenStore as a4, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDCatalogEnvironment as f, type FFIDBillingInterval as g, type FFIDTaxBehavior as h, type FFIDPublishedCatalog as i, type FFIDAddMemberParams as j, type FFIDAddMemberRequest as k, type FFIDAddMemberResponse as l, type FFIDAssignableMemberRole as m, type FFIDCacheConfig as n, type FFIDCatalogPublication as o, type FFIDCatalogPublicationStatus as p, type FFIDClient as q, type FFIDConfig as r, type FFIDListMembersResponse as s, type FFIDMemberRole as t, type FFIDOrganization as u, type FFIDOrganizationMember as v, type FFIDOtpSendResponse as w, type FFIDOtpVerifyResponse as x, type FFIDPasswordResetConfirmResponse as y, type FFIDPasswordResetResponse as z };

package/dist/{ffid-client-BqnzUmG7.d.ts → ffid-client-DEM1nYqe.d.ts}

@@ -46,6 +46,20 @@ type FFIDInquiryCategory = (typeof FFID_INQUIRY_CATEGORIES)[number];
  */
 declare const FFID_INQUIRY_CATEGORIES_SITE_2026: readonly ["consulting", "saas", "development", "agent-hub", "ai-feel-chatbot", "knowledge-db", "biz-simulator", "discussion-board", "realtime-ai", "partnership", "media", "recruiting", "other"];
 type FFIDInquiryCategorySite2026 = (typeof FFID_INQUIRY_CATEGORIES_SITE_2026)[number];
+/**
+ * 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];
 /**
  * Parameters for `client.inquiry.create()`. When submitting from a
  * server-side SDK (Service API Key), set `source` to a stable
@@ -65,6 +79,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';
@@ -2242,4 +2268,4 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
-export { type FFIDProvisionOrganizationDryRun as A, type FFIDProvisionOrganizationMemberInput as B, type FFIDProvisionOrganizationOutcome as C, type FFIDProvisionOrganizationParams as D, type FFIDProvisionOrganizationResponse as E, type FFIDLogger as F, type FFIDProvisionUserDryRun as G, type FFIDProvisionUserOutcome as H, type FFIDProvisionUserParams as I, type FFIDProvisionUserProfileInput as J, type FFIDProvisionUserResponse as K, type FFIDProvisionedOrganization as L, type FFIDProvisionedUser as M, type FFIDRemoveMemberResponse as N, type FFIDResetSessionResponse as O, type FFIDSubscription as P, type FFIDUpdateMemberRoleResponse as Q, type FFIDUpdateUserProfileRequest as R, type FFIDUser as S, type FFIDUserProfile as T, type TokenData as U, type TokenStore as V, createFFIDClient as W, createTokenStore as X, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDAddMemberParams as f, type FFIDAddMemberRequest as g, type FFIDAddMemberResponse as h, type FFIDAssignableMemberRole as i, type FFIDCacheConfig as j, type FFIDClient as k, type FFIDConfig as l, type FFIDListMembersResponse as m, type FFIDMemberRole as n, type FFIDOrganization as o, type FFIDOrganizationMember as p, type FFIDOtpSendResponse as q, type FFIDOtpVerifyResponse as r, type FFIDPasswordResetConfirmResponse as s, type FFIDPasswordResetResponse as t, type FFIDPasswordResetVerifyResponse as u, type FFIDProfileCallOptions as v, type FFIDProvisionMemberPlan as w, type FFIDProvisionMemberPlanStatus as x, type FFIDProvisionMemberResult as y, type FFIDProvisionMemberStatus as z };
+export { FFID_CATALOG_ENVIRONMENTS as $, type FFIDPasswordResetVerifyResponse as A, type FFIDProfileCallOptions as B, type FFIDProvisionMemberPlan as C, type FFIDProvisionMemberPlanStatus as D, type FFIDProvisionMemberResult as E, type FFIDLogger as F, type FFIDProvisionMemberStatus as G, type FFIDProvisionOrganizationDryRun as H, type FFIDProvisionOrganizationMemberInput as I, type FFIDProvisionOrganizationOutcome as J, type FFIDProvisionOrganizationParams as K, type FFIDProvisionOrganizationResponse as L, type FFIDProvisionUserDryRun as M, type FFIDProvisionUserOutcome as N, type FFIDProvisionUserParams as O, type FFIDProvisionUserProfileInput as P, type FFIDProvisionUserResponse as Q, type FFIDProvisionedOrganization as R, type FFIDProvisionedUser as S, type FFIDPublishedPlan as T, type FFIDRemoveMemberResponse as U, type FFIDResetSessionResponse as V, type FFIDSubscription as W, type FFIDUpdateMemberRoleResponse as X, type FFIDUpdateUserProfileRequest as Y, type FFIDUser as Z, type FFIDUserProfile as _, type FFIDError as a, FFID_CATALOG_PUBLICATION_STATUSES as a0, type TokenData as a1, type TokenStore as a2, createFFIDClient as a3, createTokenStore as a4, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDCatalogEnvironment as f, type FFIDBillingInterval as g, type FFIDTaxBehavior as h, type FFIDPublishedCatalog as i, type FFIDAddMemberParams as j, type FFIDAddMemberRequest as k, type FFIDAddMemberResponse as l, type FFIDAssignableMemberRole as m, type FFIDCacheConfig as n, type FFIDCatalogPublication as o, type FFIDCatalogPublicationStatus as p, type FFIDClient as q, type FFIDConfig as r, type FFIDListMembersResponse as s, type FFIDMemberRole as t, type FFIDOrganization as u, type FFIDOrganizationMember as v, type FFIDOtpSendResponse as w, type FFIDOtpVerifyResponse as x, type FFIDPasswordResetConfirmResponse as y, type FFIDPasswordResetResponse as z };

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

@@ -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-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 };