@feelflow/ffid-sdk 7.2.0 → 8.0.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDAccountType, c as FFIDPrompt, d as FFIDConfig, e as FFIDApiResponse, f as FFIDSessionResponse, g as FFIDSignOutResult, h as FFIDError, i as FFIDSubscriptionCheckResponse, j as FFIDCheckServiceAccessParams, k as FFIDServiceAccessDecision, l as FFIDAnalyticsConfig, m as FFIDVerifyAccessTokenOptions, n as FFIDOAuthUserInfo, o as FFIDInquiryCreateParams, p as FFIDInquiryCreateResponse, T as TokenStore, q as FFIDAuthMode, r as FFIDLogger, s as FFIDCacheAdapter, t as FFIDUser, u as FFIDOrganization, v as FFIDSubscription, w as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, x as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, y as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, z as FFIDAnnouncementsLogger } from './index-BMKhKhzF.cjs';
-export { B as Announcement, C as AnnouncementStatus, D as AnnouncementType, G as EFFECTIVE_SUBSCRIPTION_STATUSES, H as FFIDAnnouncementBadge, I as FFIDAnnouncementList, J as FFIDAnnouncementsError, K as FFIDAnnouncementsErrorCode, M as FFIDAnnouncementsServerResponse, N as FFIDApiResponseMeta, O as FFIDCacheConfig, P as FFIDContextValue, Q as FFIDInquiryAcquisitionSource, R as FFIDInquiryCategory, S as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a2 as FFIDJwtClaims, a3 as FFIDLoginButton, a4 as FFIDOAuthUserInfoMemberRole, a5 as FFIDOrganizationSwitcher, a6 as FFIDSeatAssignmentClaim, a7 as FFIDSeatAssignmentStatus, a8 as FFIDSeatModel, a9 as FFIDServiceAccessDenialReason, aa as FFIDServiceAccessFailPolicy, ab as FFIDSubscriptionBadge, ac as FFIDUserMenu, ad as FFID_INQUIRY_ACQUISITION_SOURCES, ae as FFID_INQUIRY_CATEGORIES, af as FFID_INQUIRY_CATEGORIES_SITE_2026, ag as TokenData, ah as UseFFIDAnnouncementsOptions, ai as UseFFIDAnnouncementsReturn, aj as createTokenStore, ak as isFFIDInquiryAcquisitionSource, al as isFFIDInquiryCategorySite2026, am as useFFIDAnnouncements } from './index-BMKhKhzF.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDOAuthUserInfoSubscription, b as FFIDAccountType, c as FFIDPrompt, d as FFIDConfig, e as FFIDApiResponse, f as FFIDSessionResponse, g as FFIDSignOutResult, h as FFIDError, i as FFIDSubscriptionCheckResponse, j as FFIDCheckServiceAccessParams, k as FFIDServiceAccessDecision, l as FFIDAnalyticsConfig, m as FFIDVerifyAccessTokenOptions, n as FFIDOAuthUserInfo, o as FFIDInquiryCreateParams, p as FFIDInquiryCreateResponse, T as TokenStore, q as FFIDAuthMode, r as FFIDLogger, s as FFIDCacheAdapter, t as FFIDUser, u as FFIDOrganization, v as FFIDSubscription, w as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, x as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, y as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, z as FFIDAnnouncementsLogger } from './index-BG7g99pK.cjs';
+export { B as Announcement, C as AnnouncementStatus, D as AnnouncementType, G as EFFECTIVE_SUBSCRIPTION_STATUSES, H as FFIDAnnouncementBadge, I as FFIDAnnouncementList, J as FFIDAnnouncementsError, K as FFIDAnnouncementsErrorCode, M as FFIDAnnouncementsServerResponse, N as FFIDApiResponseMeta, O as FFIDCacheConfig, P as FFIDContextValue, Q as FFIDInquiryAcquisitionSource, R as FFIDInquiryCategory, S as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a2 as FFIDJwtClaims, a3 as FFIDLoginButton, a4 as FFIDOAuthUserInfoMemberRole, a5 as FFIDOrganizationSwitcher, a6 as FFIDSeatAssignmentClaim, a7 as FFIDSeatAssignmentStatus, a8 as FFIDSeatModel, a9 as FFIDServiceAccessDenialReason, aa as FFIDServiceAccessFailPolicy, ab as FFIDSubscriptionBadge, ac as FFIDUserMenu, ad as FFID_INQUIRY_ACQUISITION_SOURCES, ae as FFID_INQUIRY_CATEGORIES, af as FFID_INQUIRY_CATEGORIES_SITE_2026, ag as TokenData, ah as UseFFIDAnnouncementsOptions, ai as UseFFIDAnnouncementsReturn, aj as createTokenStore, ak as isFFIDInquiryAcquisitionSource, al as isFFIDInquiryCategorySite2026, am as useFFIDAnnouncements } from './index-BG7g99pK.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, n as FFIDAnalyticsProvider, o as FFIDAnalyticsProviderProps, c as FFIDConsentCategories, q as FFIDConsentCategoryCode, e as FFIDConsentCategoryMetadata, v as FFIDConsentError, w as FFIDConsentErrorCode, x as FFIDConsentMergeStrategy, z as FFIDConsentMergeWarning, B as FFIDConsentMergeWarningEvent, F as FFIDConsentResult, H as FFIDConsentSource, a as FFIDConsentState, d as FFIDConsentSyncResult, L as FFIDCookieBanner, M as FFIDCookieBannerClassNames, N as FFIDCookieBannerProps, O as FFIDCookieLink, Q as FFIDCookieLinkProps, f as FFIDCookiePolicy, S as FFIDCookieSettings, T as FFIDCookieSettingsClassNames, U as FFIDCookieSettingsProps, Z as FFID_CONSENT_ERROR_CODES, ad as UseFFIDConsentPreferencesReturn, ae as UseFFIDConsentReturn, af as clearConsentDismissalTimestamp, ai as decodeConsentCookie, ak as encodeConsentCookie, am as readConsentCookie, an as readConsentDismissalTimestamp, ap as useFFIDConsent, aq as useFFIDConsentPreferences, ar as writeConsentCookie, as as writeConsentDismissalTimestamp } from './FFIDCookieLink-Bwr0FBrV.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
@@ -226,12 +226,31 @@ interface FFIDSubscriptionDetail {
     trialStart: string | null;
     trialEnd: string | null;
     canceledAt: string | null;
+    /**
+     * `true` while a cancellation is reserved until the period end. `status` stays
+     * `active` until then; the subscription becomes `canceled` at `currentPeriodEnd`.
+     * The reservation can only be withdrawn in the FFID portal (there is no SDK method).
+     */
     cancelAtPeriodEnd: boolean;
-    /** Pending period-end downgrade info (null = no scheduled downgrade) */
+    /**
+     * Change reserved until the period end (null = nothing reserved).
+     *
+     * Every decrease — a lower plan, paid → free, fewer seats, yearly → monthly — is
+     * reserved instead of applied immediately (FFID #6327). The current plan, seats and
+     * interval stay in effect until `scheduledAt`. Withdraw it with `cancelPendingDowngrade()`.
+     */
     pendingDowngrade: {
+        /** Plan in effect after the period end. Equals `planCode` for a seat-only or interval-only reservation. */
         planCode: string;
         planName: string;
+        /** Billing interval in effect after the period end */
         billingInterval: FFIDBillingInterval;
+        /**
+         * Seat count in effect after the period end. `null` = the seat count does not change.
+         * Seat reductions are made in the FFID portal; this lets you show them (8.0.0).
+         * FFID servers released before #6327 omit it, so compare with `== null` at runtime.
+         */
+        quantity: number | null;
         scheduledAt: string;
         requestedAt: string;
     } | null;
@@ -298,7 +317,17 @@ interface FFIDChangePlanParams {
     /** New billing interval (default: keeps current) */
     billingInterval?: FFIDBillingInterval;
 }
-/** Response from change plan endpoint */
+/**
+ * Response from change plan endpoint.
+ *
+ * - An increase (higher plan / monthly → yearly) applies immediately and the difference up to
+ *   the current period end is charged now. `pendingDowngrade` is absent.
+ * - A decrease (lower plan / paid → free / yearly → monthly) is reserved until the period end:
+ *   `pendingDowngrade` is present and `subscription.planCode` is still the current plan.
+ *   Nothing is charged or refunded. A contract that cannot be reserved still changes
+ *   immediately, without a refund: one with no period end, or a paid → paid decrease on a
+ *   contract without a Stripe subscription.
+ */
 interface FFIDChangePlanResponse {
     message: string;
     subscription: {
@@ -311,7 +340,7 @@ interface FFIDChangePlanResponse {
         status: FFIDSubscriptionStatus;
         isUpgrade: boolean;
     };
-    /** Present when downgrade is scheduled for period end instead of immediate */
+    /** Present when the change is a decrease reserved until the period end */
     pendingDowngrade?: {
         planCode: string;
         planName: string;
@@ -327,17 +356,41 @@ interface FFIDCancelSubscriptionParams {
     /** Additional cancellation details */
     reasonDetails?: string;
 }
-/** Response from cancel subscription endpoint */
+/**
+ * Response from cancel subscription endpoint.
+ *
+ * Since 8.0.0 a contract billed through Stripe is **reserved** for cancellation at the period
+ * end (FFID #6327): `status` stays `active`, `cancelAtPeriodEnd` is `true` and `cancelAt` is the
+ * period end. Access continues until then and nothing is refunded. A contract that cannot be
+ * reserved (no Stripe subscription, no period end yet, or Stripe not configured on FFID) is
+ * canceled immediately (`status: 'canceled'`, `cancelAtPeriodEnd: false`, `cancelAt: null`).
+ * Branch on `cancelAtPeriodEnd`, not on whether the contract uses Stripe.
+ *
+ * Do not treat this response as "access revoked". The `subscription.canceled` webhook arrives
+ * at reservation (`source: 'user_initiated'`) and again at the period end
+ * (`source: 'stripe_confirmed'`); see `FFIDSubscriptionCanceledPayload`.
+ */
 interface FFIDCancelSubscriptionResponse {
     message: string;
     subscription: {
         id: string;
         organizationId: string;
+        /** `active` while the cancellation is reserved; `canceled` only for an immediate cancellation */
         status: FFIDSubscriptionStatus;
         canceledAt: string | null;
+        /** `true` when the cancellation is reserved until the period end */
+        cancelAtPeriodEnd: boolean;
+        /** When the reserved cancellation takes effect (the period end). `null` for an immediate cancellation */
+        cancelAt: string | null;
     };
 }
-/** Response from cancel pending downgrade endpoint */
+/**
+ * Response from cancel pending downgrade endpoint.
+ *
+ * Withdraws the reserved change on the Stripe side as well, so the current plan, seats and
+ * interval simply continue after the period end. It does not withdraw a reserved
+ * cancellation — that is done in the FFID portal.
+ */
 interface FFIDCancelPendingDowngradeResponse {
     message: string;
     subscription: {
@@ -392,14 +445,18 @@ interface FFIDPlanChangePreviewBase {
     lineItems: FFIDPlanChangeLineItem[];
 }
 /**
- * Plan change proration preview.
+ * Plan change proration preview. It is computed with the same rules as `changePlan()`.
  *
  * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
- * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
- *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
- *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
- * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
- *   (possibly Stripe-refined) day-basis difference.
+ * - `true`: a decrease reserved until the period end. `proratedAmount` is always 0 (nothing is
+ *   charged or refunded now); `effectiveDate` mirrors the subscription's `currentPeriodEnd`
+ *   (may be `null` when the subscription has no active billing cycle yet).
+ * - `false`: immediate change. `effectiveDate` is always `null`. For an increase,
+ *   `proratedAmount` is the difference up to the current period end that is charged now
+ *   (possibly Stripe-refined). A decrease on a contract that cannot be reserved also lands here:
+ *   `0` for a contract without a Stripe subscription (no refund), but Stripe's prorated amount —
+ *   negative, credited on the next invoice — for a Stripe contract with no period end yet
+ *   (e.g. during a trial).
  */
 type FFIDPlanChangePreview = FFIDPlanChangePreviewBase & ({
     willApplyAtPeriodEnd: true;
@@ -409,7 +466,7 @@ type FFIDPlanChangePreview = FFIDPlanChangePreviewBase & ({
 } | {
     willApplyAtPeriodEnd: false;
     effectiveDate: null;
-    /** Prorated difference charged within the current billing period */
+    /** Difference up to the current period end charged now (see the type doc for the decrease cases) */
     proratedAmount: number;
 });
 /** Response from plan change preview endpoint */
@@ -434,14 +491,27 @@ interface FFIDSeatChangeLineItem {
  * Sister type to `FFIDPlanChangePreview`. The shared `type` discriminant lets
  * consumers narrow a preview payload without inspecting unrelated fields.
  *
+ * - `willApplyAtPeriodEnd=true`: a seat reduction reserved until the period end.
+ *   `proratedAmount` is 0 and `effectiveDate` is when the new seat count applies.
+ * - Otherwise the change applies immediately. For an increase, `proratedAmount` is the amount
+ *   charged now up to the current period end. A reduction that cannot be reserved is normally
+ *   `0`, but can be negative (a credit on the next invoice) for a Stripe contract with no period
+ *   end yet or when only the contract unit price is known.
  * - `isEstimate=true` (default when Stripe is not configured or data is unavailable):
- *   `proratedAmount` is computed locally as `(newQuantity - currentQuantity) * unitPrice`.
- * - `isEstimate=false`: `proratedAmount` reflects Stripe's live proration calculation.
+ *   `proratedAmount` is computed locally. `isEstimate=false`: it reflects Stripe's live
+ *   proration calculation.
  *
  * `nextInvoiceAmount` is always a local estimate (`unitPrice * newQuantity`).
  *
- * `pricingUnavailable=true` indicates the plan uses custom pricing with a zero unit
- * price (Enterprise). Consumers should hide monetary amounts in this case.
+ * `pricingUnavailable=true` means custom pricing or an unverified contracted Stripe
+ * Price. Hide amounts; zero is not a quote. `custom_pricing` permits the existing
+ * unbilled seat-change flow. Require another preview before confirmation only when
+ * pricing is unavailable and the reason is not `custom_pricing`. `stripe_error` also
+ * covers invoice/address failures after the contract price is known; use
+ * `pricingUnavailable`, not the reason alone, to decide whether to hide amounts.
+ * `no_stripe_data` means invoice proration is unavailable even if the contract unit
+ * price is known. Portal seat PUT independently enforces subscription limits;
+ * external consumers should guide users to the FFID portal for seat changes.
  */
 interface FFIDSeatChangePreview {
     /** Discriminant for preview response variants (pairs with `FFIDPlanChangePreview.type`) */
@@ -452,20 +522,28 @@ interface FFIDSeatChangePreview {
     unitPrice: number;
     billingInterval: FFIDBillingInterval;
     /**
-     * Prorated cost for the current billing period. Negative when seats are decreased
-     * (credit). `0` when `pricingUnavailable === true` (Enterprise custom pricing).
+     * Amount charged now for the rest of the current billing period. A reserved seat reduction
+     * (`willApplyAtPeriodEnd: true`) is always `0`; see the type doc for reductions that cannot
+     * be reserved. Also `0` when `pricingUnavailable === true`; hide it instead of quoting zero.
      */
     proratedAmount: number;
     /** Next invoice full amount — always a local estimate (`unitPrice * newQuantity`) */
     nextInvoiceAmount: number;
     nextInvoiceDate: string | null;
     currency: FFIDSupportedCurrency;
-    /** true when proratedAmount is estimated from local prices rather than Stripe proration data */
+    /** true when proratedAmount is a local estimate rather than Stripe invoice/proration data */
     isEstimate: boolean;
-    /** true when unit price is 0 due to custom pricing (Enterprise) — hide monetary amounts */
+    /** Hide amounts: custom pricing or contracted Stripe Price could not be verified. */
     pricingUnavailable?: boolean;
     /** Reason why `isEstimate` is true. Only meaningful when `isEstimate === true`. */
     estimateReason?: 'no_stripe_data' | 'custom_pricing' | 'stripe_error';
+    /**
+     * `true` when the seat reduction would be reserved until the period end (8.0.0).
+     * Absent or `false` = the change applies immediately.
+     */
+    willApplyAtPeriodEnd?: boolean;
+    /** When the reserved seat count applies (present when `willApplyAtPeriodEnd` is `true`) */
+    effectiveDate?: string | null;
     lineItems: FFIDSeatChangeLineItem[];
 }
 /** Response from seat change preview endpoint */
@@ -550,6 +628,7 @@ interface FFIDProvisionUserProfileInput {
     /** Display name (1–255 chars). */
     displayName?: string;
     /** Company name (≤255 chars). */
+    /** @deprecated Accepted for compatibility but ignored by FFID. */
     companyName?: string;
     /** Department (≤255 chars). */
     department?: string;
@@ -1258,7 +1337,7 @@ interface FFIDUserProfile {
     avatarUrl: string | null;
     /** Phone number (nullable when not set) */
     phone: string | null;
-    /** Company name (nullable when not set) */
+    /** @deprecated Individual employer name is retired; this field is always null. Use the organization entity's name. */
     companyName: string | null;
     /** Department (nullable when not set) */
     department: string | null;
@@ -1339,7 +1418,7 @@ interface FFIDUpdateUserProfileRequest {
     displayName?: string | null;
     /** Phone number (null clears the field) */
     phone?: string | null;
-    /** Company name (null clears the field) */
+    /** @deprecated Accepted for compatibility but ignored. Use the organization entity's name. */
     companyName?: string | null;
     /** Department (null clears the field) */
     department?: string | null;
@@ -1428,6 +1507,7 @@ interface FFIDTokenIntrospectionResponse {
     email_verified?: boolean;
     name?: string;
     picture?: string | null;
+    /** @deprecated Kept on the wire for compatibility; FFID returns null. */
     company_name?: string | null;
     department?: string | null;
     position?: string | null;
@@ -1739,6 +1819,45 @@ declare const FFID_ERROR_CODES: {
  * error codes pass through verbatim and must not be narrowed away.
  */
 type FFIDErrorCode = (typeof FFID_ERROR_CODES)[keyof typeof FFID_ERROR_CODES];
+/**
+ * Server error codes returned by the subscription endpoints (`changePlan`,
+ * `cancelSubscription`, `cancelPendingDowngrade` and the two previews) that callers
+ * are expected to branch on (FFID #6327 billing rules). They arrive verbatim in
+ * `FFIDError.code`.
+ *
+ * - `CANCELLATION_SCHEDULED` (409): a cancellation is reserved until the period end, so
+ *   plan / seat changes are refused. The reservation can only be withdrawn in the FFID
+ *   portal — send the user to the subscription page there.
+ * - `PENDING_CHANGE_EXISTS` (409): another change is already reserved. Withdraw it with
+ *   `cancelPendingDowngrade()` first.
+ * - `CHANGE_DIRECTION_MIXED` (422): the request mixes an increase (applied now) and a
+ *   decrease (reserved), e.g. a higher plan billed yearly → monthly. Split it.
+ * - `CHANGE_PAYMENT_FAILED` (402): the immediate charge for an increase failed; nothing
+ *   changed.
+ * - `SAME_PLAN_SELECTED` (400): nothing would change.
+ * - `NO_PENDING_DOWNGRADE` (400): `cancelPendingDowngrade()` found nothing reserved.
+ * - `SUBSCRIPTION_NOT_CANCELABLE` (400): the cancellation is already reserved.
+ * - `SUBSCRIPTION_ALREADY_CANCELED` (400): the subscription is already canceled.
+ * - `FREE_DOWNGRADE_NOT_ALLOWED` (400): the service does not allow paid → free.
+ * - `PAYMENT_METHOD_REQUIRED` (402): an increase needs a payment method on file.
+ *
+ * The values are checked against the FFID server's definitions by a test in the
+ * FFID repository, so they cannot drift silently.
+ */
+declare const FFID_SUBSCRIPTION_ERROR_CODES: {
+    readonly CANCELLATION_SCHEDULED: "CANCELLATION_SCHEDULED";
+    readonly PENDING_CHANGE_EXISTS: "PENDING_CHANGE_EXISTS";
+    readonly CHANGE_DIRECTION_MIXED: "CHANGE_DIRECTION_MIXED";
+    readonly CHANGE_PAYMENT_FAILED: "CHANGE_PAYMENT_FAILED";
+    readonly SAME_PLAN_SELECTED: "SAME_PLAN_SELECTED";
+    readonly NO_PENDING_DOWNGRADE: "NO_PENDING_DOWNGRADE";
+    readonly SUBSCRIPTION_NOT_CANCELABLE: "SUBSCRIPTION_NOT_CANCELABLE";
+    readonly SUBSCRIPTION_ALREADY_CANCELED: "SUBSCRIPTION_ALREADY_CANCELED";
+    readonly FREE_DOWNGRADE_NOT_ALLOWED: "FREE_DOWNGRADE_NOT_ALLOWED";
+    readonly PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED";
+};
+/** Union of `FFID_SUBSCRIPTION_ERROR_CODES` values */
+type FFIDSubscriptionErrorCode = (typeof FFID_SUBSCRIPTION_ERROR_CODES)[keyof typeof FFID_SUBSCRIPTION_ERROR_CODES];
 
 /** Creates an FFID API client instance */
 declare function createFFIDClient(config: FFIDConfig): {
@@ -1754,7 +1873,9 @@ declare function createFFIDClient(config: FFIDConfig): {
         prompt?: FFIDPrompt;
     }) => string;
     getLogoutUrl: (postLogoutRedirectUri?: string) => string;
-    getSignupUrl: (redirectUrl?: string) => string;
+    getSignupUrl: (redirectUrl?: string, options?: {
+        inviteToken?: string;
+    }) => string;
     createError: (code: string, message: string) => FFIDError;
     exchangeCodeForTokens: (code: string, codeVerifier?: string, opts?: ExchangeCodeForTokensOptions) => Promise<FFIDApiResponse<void>>;
     refreshAccessToken: () => Promise<FFIDApiResponse<void>>;
@@ -1983,6 +2104,237 @@ interface NormalizeRedirectUriResult {
 }
 declare function normalizeRedirectUri(input: string): NormalizeRedirectUriResult;
 
+/**
+ * 代理店の招待トークン（`invite`）の捕捉・保持・ログ抑止（#5823）。
+ *
+ * ## 何のための仕組みか
+ *
+ * 代理店の招待リンクから来た顧客が FFID に登録すると、作られた組織がその代理店に
+ * 紐付く。紐付けの実務は FFID 側（`/signup?invite=…` を読む `SignupPageClient`）が
+ * 行うので、SDK の責務は **トークンを signup URL まで運ぶこと** だけである。
+ *
+ * ⚠️ **代理店ポータルが現在発行するリンクは FFID の origin を指す**
+ * （`buildInviteLinkUrl` が `https://id.feelflow.net/signup?invite=<token>` を組む）。
+ * サービスサイトを着地点にする形（`https://<サービス>/?invite=<token>`）はポータルの
+ * UI が提示しておらず、代理店がトークンを自分のキャンペーン URL に貼って初めて
+ * 成立する。このモジュールが有効になるのはその形の導線である。
+ *
+ * ## なぜ cookie が要るのか
+ *
+ * 「着地した URL で即 signup する」利用者だけなら `location.search` を読めば足りる。
+ * しかし実際の導線は「`/?invite=abc` に着地 → 回遊 → パラメータの無い別ページで
+ * 登録を押す」であり、`getSignupUrl()` が呼ばれる時点の URL には `invite` が無い。
+ * 着地時点で捕捉して保持しておく以外に、この経路を救う方法が無い。
+ *
+ * ### 保持期間 30 日の費用
+ *
+ * 便益は「リンクを踏んでから検討して戻ってくる」までを覆えること。費用は
+ * **意図しない紐付け**である。招待リンクは既定で使用回数が無制限
+ * （`agency_invite_links.max_uses` は nullable で「NULL = 無制限」、発行ダイアログの
+ * 既定は未入力）なので、保持中の cookie は**同じブラウザで後から作られた組織も
+ * 同じ代理店に紐付ける**。共有ブラウザではこれが誤紐付けになる。
+ *
+ * 姉妹の `AGENCY_INVITE_TOKEN_COOKIE`（FFID 側・OAuth 往復用・15 分）が短いのは
+ * 同じ費用を避けるためである（`src/lib/auth/shared-utils.ts` のその docstring を参照）。
+ * こちらが 30 日なのは覆いたい導線の長さが違うからで、費用が無いからではない。
+ *
+ * ### 消す責任者は現在いない
+ *
+ * {@link clearAgencyInviteToken} は公開しているが、SDK 内・FFID 側のどちらからも
+ * 登録完了時に呼んでいない。登録完了は FFID のドメインで起こるため consumer から
+ * 検知しにくい。したがって現在の挙動は「30 日経過・上書き・consumer による明示的な
+ * 削除のいずれかまで保持し続ける」である。これを単回にすべきかは製品判断で、
+ * 本モジュールは現挙動を明文化するに留める。
+ *
+ * ## 誰が捕捉を起動するか
+ *
+ * SDK 自身はページ読み込みを hook できない。したがって捕捉の起動点は 2 つある。
+ *
+ * | 起動点 | 対象 | 利用者側の配線 |
+ * |---|---|---|
+ * | `FFIDProvider` の mount effect | React 利用者 | 不要 |
+ * | {@link captureAgencyInviteToken} の直接呼び出し | 非 React / provider 未使用 | ページ遷移ごとに呼ぶ |
+ *
+ * 配線を忘れた場合は「着地ページで即 signup した人だけ紐付く」= URL 直読み相当まで
+ * **劣化する**（紐付けが壊れるのではなく、上記の回遊経路を救えなくなる）。
+ *
+ * ℹ️ **`authMode: 'token'`（OAuth モード）も v7.4.0 から転送される（#5958）。**
+ * その経路の signup 意図は `getSignupUrl()` に到達しないが、`redirectToAuthorize` が
+ * `invite` を `/api/v1/oauth/authorize` へ載せ、FFID 本体が `/signup` へ引き継ぐ。
+ * **SDK と FFID 本体の両方が新しい必要がある**（2 段で成立するため）。
+ * 詳細は `redirect.ts` の `getSignupUrl` / `redirectToAuthorize` の docstring を参照。
+ *
+ * ## トークンを平文で扱うことの帰結
+ *
+ * このトークンは URL に載る平文の資格情報である。**単回使用ではない** — FFID 側の
+ * `consume_agency_invite_link` RPC が担保するのは「同時実行下でも `max_uses` を
+ * 超えない」ことである。DB の `max_uses` は DEFAULT を持たず NULL 可で、発行処理も
+ * 未指定時は NULL を保存する（= 回数無制限）。したがって漏れた
+ * トークンは、新規組織が作られる限り何度でも紐付けに使える。
+ *
+ * それゆえ SDK 側では **ログ・エラーレポート・アナリティクスに値を出さない**。
+ * URL を出力する経路には {@link redactAgencyInviteToken} を通すこと。
+ *
+ * ⚠️ `AGENCY_INVITE_TOKEN_PARAM` は FFID 本体の `INVITE_TOKEN_PARAM`
+ * (`src/lib/auth/shared-utils.ts`) と**同じ値でなければならない**。
+ */
+/**
+ * signup URL に載せるクエリパラメータ名。
+ *
+ * ⚠️ FFID 本体の `INVITE_TOKEN_PARAM`（`src/lib/auth/shared-utils.ts`）と同値。
+ * これは**ワイヤプロトコル定数**であって共有型ではない。publish 済みの全 SDK
+ * バージョンが同じ値を送るので、片側を改名すると古い SDK からの紐付けが静かに
+ * 落ちる。**改名ではなく凍結する**のが正しい扱いで、
+ * `src/lib/auth/__tests__/shared-utils.test.ts` のドリフトガードが落ちたときの
+ * 対応は「両側を揃える」ではなく「SDK 側の改名を戻す」である。
+ */
+declare const AGENCY_INVITE_TOKEN_PARAM = "invite";
+/** 招待トークンを保持する first-party cookie の名前。 */
+declare const AGENCY_INVITE_COOKIE_NAME = "ffid_invite";
+/** cookie の Max-Age（秒）。 */
+declare const AGENCY_INVITE_COOKIE_MAX_AGE_SEC: number;
+/** ログ出力時にトークン値を置き換える文字列。 */
+declare const AGENCY_INVITE_TOKEN_REDACTION = "[REDACTED]";
+/** cookie の書き込み先を制御するオプション。`consent/storage/cookie.ts` と同形。 */
+interface AgencyInviteCookieOptions {
+    /**
+     * `Secure` 属性の明示指定。既定は本番のみ（`NODE_ENV === 'production'`）で、
+     * これは `consent/storage/cookie.ts` の `defaultSecure()` と同じ既定である。
+     *
+     * 明示上書きが必要になるのは **https でない独自ドメイン**（LAN IP や plain http
+     * の検証機）で動かす場合。そこではブラウザが `Secure` cookie を黙って捨てる。
+     * `http://localhost` は W3C の secure context として扱われるため `Secure` でも
+     * 保持される（Chrome 153 で実測）ので、ローカル開発では上書き不要。
+     */
+    secure?: boolean;
+    /** cookie の Path。既定は `'/'`（サイト全体で読めないと回遊経路を救えない）。 */
+    path?: string;
+    /**
+     * cookie の Domain。既定は未指定 = 現在のホストのみ（first-party）。
+     * サブドメイン間で共有する場合だけ明示する。
+     */
+    domain?: string;
+}
+/** 招待トークンの読み取り元。 */
+interface ReadAgencyInviteTokenOptions {
+    /**
+     * `window.location.search` の代わりに読む URL または `?` 始まりの query string。
+     * SSR とテストのための seam。fragment は無視される（{@link toQueryString} 参照）。
+     */
+    url?: string;
+}
+/** {@link captureAgencyInviteToken} の引数。 */
+interface CaptureAgencyInviteTokenOptions extends AgencyInviteCookieOptions, ReadAgencyInviteTokenOptions {
+}
+/**
+ * {@link captureAgencyInviteToken} の結果。
+ *
+ * `source` を判別子にした union にしてあるのは、3 フィールドを独立に持たせると
+ * `{ source: 'none', persisted: true }` のような**起こりえない組み合わせが型で
+ * 構築できてしまう**ため。分解代入（`const { token, source, persisted } = …`）は
+ * 全メンバーが 3 プロパティを持つのでそのまま通る。
+ */
+type CaptureAgencyInviteTokenResult = 
+/**
+ * 今回の URL から読んだ。**cookie が更新されたかは `persisted` を見る** —
+ * `false`（ブラウザが落とした）と `undefined`（SSR で書ける環境が無い）のとき、
+ * cookie は上書きされていない。
+ */
+{
+    readonly source: 'url';
+    readonly token: string;
+    /**
+     * cookie 書き込みが read-back で確認できたか。
+     *
+     * - `true`: 保持できた
+     * - `false`: **ブラウザが黙って落とした。** 今回の URL 経由では紐付くが、
+     *   パラメータの無い別ページへ回遊した時点で失われる。現実的な原因は
+     *   `Secure` cookie を https でない独自ドメインへ書いた場合、ITP、
+     *   全 cookie ブロック、プライベートモードの挙動差
+     * - `undefined`: **書ける環境が無かった**（`document` が無い = SSR）。
+     *   ブラウザ側で捕捉し直す必要がある、という別の対処になるので `false` と
+     *   混ぜない
+     */
+    readonly persisted: boolean | undefined;
+}
+/** URL には無く、以前保持したものを読んだ（cookie は触っていない）。 */
+ | {
+    readonly source: 'cookie';
+    readonly token: string;
+    readonly persisted: undefined;
+}
+/** URL・cookie のいずれにも無い。 */
+ | {
+    readonly source: 'none';
+    readonly token: undefined;
+    readonly persisted: undefined;
+};
+/**
+ * cookie に保持された招待トークンを読む。
+ *
+ * 戻り値の `undefined` は「トークンが無い」と「`document` が無い（SSR）」と
+ * 「値が壊れていて読めない」を畳んでいる。呼び出し側が取る対応がいずれも同じ
+ * （トークン無しとして進む）ため、ここでは区別しない。
+ *
+ * 前方一致に `=` を含めるのは、`ffid_invite_foo=` のような別 cookie を誤って
+ * 掴まないため（`consent/storage/cookie.ts` と同じ形）。
+ */
+declare function readAgencyInviteCookie(): string | undefined;
+/**
+ * 現在有効な招待トークンを読む。**URL が cookie に勝つ**（最後に踏んだリンクが
+ * 勝つ）。副作用は無い — cookie の更新は {@link captureAgencyInviteToken} の責務。
+ */
+declare function readAgencyInviteToken(options?: ReadAgencyInviteTokenOptions): string | undefined;
+/**
+ * 保持中の招待トークンを削除する。
+ *
+ * ⚠️ **書き込み時と同じ `path` / `domain` / `secure` を渡すこと。** ブラウザは
+ * 削除にこれらの一致を要求するので、既定以外で書いた cookie は既定の呼び出しでは
+ * 消えない。
+ *
+ * @returns 削除が確認できたか（read-back で不在）。`document` が無い（SSR）=
+ *   **試みていない**場合は `undefined`。
+ */
+declare function clearAgencyInviteToken(options?: AgencyInviteCookieOptions): boolean | undefined;
+/**
+ * ページ URL の `invite` を読み、あれば first-party cookie に保存する。
+ *
+ * **ページ遷移ごとに呼ぶ**。`FFIDProvider` を mount している React 利用者は
+ * provider が呼ぶので配線不要。
+ *
+ * URL にトークンがあれば cookie を**上書きする**（最後に踏んだリンクが勝つ）。
+ * URL に無ければ cookie は触らず、保持中の値をそのまま返す。
+ *
+ * @example
+ * ```typescript
+ * // 非 React 利用者: ページ読み込みごとに呼ぶ
+ * const { token, persisted } = captureAgencyInviteToken()
+ * if (persisted === false) {
+ *   // 紐付けは今回の URL 経由では効くが、別ページへ回遊すると失われる
+ * }
+ * ```
+ */
+declare function captureAgencyInviteToken(options?: CaptureAgencyInviteTokenOptions): CaptureAgencyInviteTokenResult;
+/**
+ * URL 文字列中の `invite` の値を潰す。**URL をログ・エラーレポート・アナリティクスへ
+ * 出す経路は必ずこれを通す**（トークンは平文の資格情報で、単回使用ではない / #5823）。
+ *
+ * 素の `invite=` と、percent-encode されて入れ子になった形（`%3Finvite%3D` /
+ * `%253Finvite%253D`）を潰す。入れ子が必要なのは、signup URL の `redirect`
+ * パラメータに着地 URL がそのまま入るためで、着地 URL が `?invite=…` なら
+ * `redirect=…%3Finvite%3Dtoken` の形で二重に載る。さらにその signup URL 自体が
+ * 別の `redirect` の値になると 1 段深くなる。
+ *
+ * ⚠️ **覆う encode の深さは 2 段まで**（`%3F` と `%253F`）。任意深さは正規表現で
+ * 表現できないので、3 段以上入れ子にした URL をログへ出さないこと。
+ *
+ * 過剰に潰す方向（無関係な文字列を `[REDACTED]` にする）は安全側なので許容し、
+ * 潰し漏れは許容しない。正規表現で処理するのは、`URL` でのパースが失敗した経路
+ * （相対 URL・壊れた URL）で**元の文字列をそのまま返す = 漏らす**実装になるのを
+ * 避けるため。
+ */
+declare function redactAgencyInviteToken(url: string): string;
+
 /**
  * Create an in-memory cache adapter using a Map.
  * Suitable for single-process environments (e.g., development, testing).
@@ -2898,4 +3250,4 @@ declare function createInquiryMethods(deps: InquiryMethodsDeps): {
 };
 type FFIDInquiryClient = ReturnType<typeof createInquiryMethods>;
 
-export { ACCESS_GRANTING_EFFECTIVE_STATUSES, AnnouncementListResponse, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EffectiveSubscriptionStatus, type ExchangeCodeForTokensOptions, FFIDAccountType, type FFIDAddMemberParams, type FFIDAddMemberRequest, type FFIDAddMemberResponse, type FFIDAllowedLogoMimeType, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDAssignableMemberRole, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDCanonicalJsonValue, type FFIDCatalogEnvironment, FFIDCatalogHashError, type FFIDCatalogPublication, type FFIDCatalogPublicationStatus, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckServiceAccessParams, type FFIDCheckoutSessionResponse, type FFIDClient, type FFIDCompanySizeCode, FFIDConfig, type FFIDCreateCheckoutParams, type FFIDCreatePortalParams, FFIDError, type FFIDErrorCode, type FFIDIndustryCode, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, type FFIDInvitationStatus, type FFIDInviteMemberRequest, type FFIDInviteMemberResponse, type FFIDLeaveOrganizationParams, type FFIDLeaveOrganizationResponse, type FFIDListMembersResponse, type FFIDListPlansResponse, type FFIDListingConsentInput, FFIDLogger, type FFIDLoginHistoryEntry, type FFIDLoginHistoryResponse, type FFIDLogoWallEntry, type FFIDLogoWallResponse, type FFIDMemberRole, type FFIDMemberStatus, type FFIDNewsletterBodySource, type FFIDNewsletterCampaignStatus, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterDispatchParams, type FFIDNewsletterDispatchResponse, type FFIDNewsletterSegment, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, type FFIDOAuthTokenResponse, FFIDOAuthUserInfo, FFIDOAuthUserInfoSubscription, FFIDOrganization, type FFIDOrganizationDomain, type FFIDOrganizationDomainsResponse, type FFIDOrganizationLogoUploadResponse, type FFIDOrganizationMember, type FFIDOrganizationNotificationPreferences, type FFIDOrganizationNotificationPreferencesResponse, type FFIDOrganizationProfile, type FFIDOrganizationProfileErrorCode, type FFIDOrganizationProfileResponse, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPaymentConfiguration, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, type FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, type FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, type FFIDProvisionMemberPlan, type FFIDProvisionMemberPlanStatus, type FFIDProvisionMemberResult, type FFIDProvisionMemberStatus, type FFIDProvisionOrganizationDryRun, type FFIDProvisionOrganizationMemberInput, type FFIDProvisionOrganizationOutcome, type FFIDProvisionOrganizationParams, type FFIDProvisionOrganizationResponse, type FFIDProvisionUserDryRun, type FFIDProvisionUserOutcome, type FFIDProvisionUserParams, type FFIDProvisionUserProfileInput, type FFIDProvisionUserResponse, type FFIDProvisionedOrganization, type FFIDProvisionedUser, type FFIDPublishedCatalog, type FFIDPublishedPlan, type FFIDRedirectErrorCode, type FFIDRedirectResult, type FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDScopeHashInput, type FFIDScopeHashPlan, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, FFIDServiceAccessDecision, type FFIDServiceInfo, FFIDSessionResponse, FFIDSignOutResult, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, type FFIDTaxBehavior, type FFIDTaxConfiguration, type FFIDTokenIntrospectionResponse, type FFIDUpdateMemberRoleResponse, type FFIDUpdateNotificationPreferencesRequest, type FFIDUpdateUserProfileRequest, type FFIDUploadOrganizationLogoParams, type FFIDUpsertOrganizationProfileParams, type FFIDUpsertOrganizationProfileRequest, FFIDUser, type FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_COMPANY_SIZE_CODES, FFID_ERROR_CODES, FFID_INDUSTRY_CODES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS, FFID_NEWSLETTER_TYPES, FFID_ORGANIZATION_PROFILE_ERROR_CODES, type HandleRedirectCallbackClient, type HandleRedirectCallbackOptions, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type RedirectToAuthorizeOptions, TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, canonicalizeCatalogValue, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, normalizeRedirectUri, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useRequireActiveSubscription, useSubscription, validatePublishedCatalog, withFFIDAuth, withSubscription };
+export { ACCESS_GRANTING_EFFECTIVE_STATUSES, AGENCY_INVITE_COOKIE_MAX_AGE_SEC, AGENCY_INVITE_COOKIE_NAME, AGENCY_INVITE_TOKEN_PARAM, AGENCY_INVITE_TOKEN_REDACTION, type AgencyInviteCookieOptions, AnnouncementListResponse, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, type CaptureAgencyInviteTokenOptions, type CaptureAgencyInviteTokenResult, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EffectiveSubscriptionStatus, type ExchangeCodeForTokensOptions, FFIDAccountType, type FFIDAddMemberParams, type FFIDAddMemberRequest, type FFIDAddMemberResponse, type FFIDAllowedLogoMimeType, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDAssignableMemberRole, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDCanonicalJsonValue, type FFIDCatalogEnvironment, FFIDCatalogHashError, type FFIDCatalogPublication, type FFIDCatalogPublicationStatus, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckServiceAccessParams, type FFIDCheckoutSessionResponse, type FFIDClient, type FFIDCompanySizeCode, FFIDConfig, type FFIDCreateCheckoutParams, type FFIDCreatePortalParams, FFIDError, type FFIDErrorCode, type FFIDIndustryCode, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, type FFIDInvitationStatus, type FFIDInviteMemberRequest, type FFIDInviteMemberResponse, type FFIDLeaveOrganizationParams, type FFIDLeaveOrganizationResponse, type FFIDListMembersResponse, type FFIDListPlansResponse, type FFIDListingConsentInput, FFIDLogger, type FFIDLoginHistoryEntry, type FFIDLoginHistoryResponse, type FFIDLogoWallEntry, type FFIDLogoWallResponse, type FFIDMemberRole, type FFIDMemberStatus, type FFIDNewsletterBodySource, type FFIDNewsletterCampaignStatus, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterDispatchParams, type FFIDNewsletterDispatchResponse, type FFIDNewsletterSegment, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, type FFIDOAuthTokenResponse, FFIDOAuthUserInfo, FFIDOAuthUserInfoSubscription, FFIDOrganization, type FFIDOrganizationDomain, type FFIDOrganizationDomainsResponse, type FFIDOrganizationLogoUploadResponse, type FFIDOrganizationMember, type FFIDOrganizationNotificationPreferences, type FFIDOrganizationNotificationPreferencesResponse, type FFIDOrganizationProfile, type FFIDOrganizationProfileErrorCode, type FFIDOrganizationProfileResponse, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPaymentConfiguration, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, type FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, type FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, type FFIDProvisionMemberPlan, type FFIDProvisionMemberPlanStatus, type FFIDProvisionMemberResult, type FFIDProvisionMemberStatus, type FFIDProvisionOrganizationDryRun, type FFIDProvisionOrganizationMemberInput, type FFIDProvisionOrganizationOutcome, type FFIDProvisionOrganizationParams, type FFIDProvisionOrganizationResponse, type FFIDProvisionUserDryRun, type FFIDProvisionUserOutcome, type FFIDProvisionUserParams, type FFIDProvisionUserProfileInput, type FFIDProvisionUserResponse, type FFIDProvisionedOrganization, type FFIDProvisionedUser, type FFIDPublishedCatalog, type FFIDPublishedPlan, type FFIDRedirectErrorCode, type FFIDRedirectResult, type FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDScopeHashInput, type FFIDScopeHashPlan, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, FFIDServiceAccessDecision, type FFIDServiceInfo, FFIDSessionResponse, FFIDSignOutResult, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, type FFIDSubscriptionErrorCode, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, type FFIDTaxBehavior, type FFIDTaxConfiguration, type FFIDTokenIntrospectionResponse, type FFIDUpdateMemberRoleResponse, type FFIDUpdateNotificationPreferencesRequest, type FFIDUpdateUserProfileRequest, type FFIDUploadOrganizationLogoParams, type FFIDUpsertOrganizationProfileParams, type FFIDUpsertOrganizationProfileRequest, FFIDUser, type FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_COMPANY_SIZE_CODES, FFID_ERROR_CODES, FFID_INDUSTRY_CODES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS, FFID_NEWSLETTER_TYPES, FFID_ORGANIZATION_PROFILE_ERROR_CODES, FFID_SUBSCRIPTION_ERROR_CODES, type HandleRedirectCallbackClient, type HandleRedirectCallbackOptions, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type ReadAgencyInviteTokenOptions, type RedirectToAuthorizeOptions, TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, canonicalizeCatalogValue, captureAgencyInviteToken, clearAgencyInviteToken, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, normalizeRedirectUri, readAgencyInviteCookie, readAgencyInviteToken, redactAgencyInviteToken, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useRequireActiveSubscription, useSubscription, validatePublishedCatalog, withFFIDAuth, withSubscription };