@feelflow/ffid-sdk 9.0.0 → 10.1.0

package/dist/index.d.ts

@@ -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-BG7g99pK.js';
-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.js';
+import { F as FFIDOAuthUserInfoSubscription, a as FFIDAccountType, b as FFIDPrompt, c as FFIDConfig, d as FFIDApiResponse, e as FFIDSessionResponse, f as FFIDSignOutResult, g as FFIDError, h as FFIDSubscriptionCheckResponse, i as FFIDCheckServiceAccessParams, j as FFIDServiceAccessDecision, k as FFIDAnalyticsConfig, l as FFIDSeatsSummary, m as FFIDListPlansResponse, n as FFIDPublishedCatalog, o as FFIDSubscriptionDetail, p as FFIDSubscribeParams, q as FFIDSubscribeResponse, r as FFIDChangePlanParams, s as FFIDChangePlanResponse, t as FFIDCancelSubscriptionParams, u as FFIDCancelSubscriptionResponse, v as FFIDCancelPendingDowngradeResponse, w as FFIDPreviewPlanChangeParams, x as FFIDPlanChangePreviewResponse, y as FFIDPreviewSeatChangeParams, z as FFIDSeatChangePreviewResponse, A as FFIDVerifyAccessTokenOptions, B as FFIDOAuthUserInfo, C as FFIDInquiryCreateParams, D as FFIDInquiryCreateResponse, E as FFIDCreditBalance, G as FFIDListCreditHistoryOptions, H as FFIDCreditHistoryPage, I as FFIDCreditPackList, J as FFIDCreatePackCheckoutParams, K as FFIDCreditPackCheckout, L as FFIDCreditConsumeParams, M as FFIDCreditConsumeResult, N as FFIDBuyCreditsUrlParams, T as TokenStore, O as FFIDAuthMode, P as FFIDLogger, Q as FFIDCacheAdapter, R as FFIDUser, S as FFIDOrganization, U as FFIDSubscription, V as FFIDSubscriptionContextValue, W as EffectiveSubscriptionStatus, X as FFIDSubscriptionStatus, Y as FFIDCatalogEnvironment, Z as FFIDBillingInterval, _ as FFIDTaxBehavior, $ as FFIDAnnouncementsClientConfig, a0 as ListAnnouncementsOptions, a1 as FFIDAnnouncementsApiResponse, a2 as AnnouncementListResponse, a3 as FFIDAnnouncementsLogger } from './index-CWGoIgYL.js';
+export { a4 as Announcement, a5 as AnnouncementStatus, a6 as AnnouncementType, a7 as EFFECTIVE_SUBSCRIPTION_STATUSES, a8 as FFIDAnnouncementBadge, a9 as FFIDAnnouncementList, aa as FFIDAnnouncementsError, ab as FFIDAnnouncementsErrorCode, ac as FFIDAnnouncementsServerResponse, ad as FFIDApiResponseMeta, ae as FFIDCacheConfig, af as FFIDCatalogPublication, ag as FFIDCatalogPublicationStatus, ah as FFIDContextValue, ai as FFIDCreditBreakdown, aj as FFIDCreditGrantKind, ak as FFIDCreditHistoryItem, al as FFIDCreditHistoryType, am as FFIDCreditPack, an as FFIDCreditsInsufficientDetails, ao as FFIDInquiryAcquisitionSource, ap as FFIDInquiryCategory, aq as FFIDInquiryCategorySite2026, ar as FFIDInquiryForm, as as FFIDInquiryFormCategoryItem, at as FFIDInquiryFormClassNames, au as FFIDInquiryFormLegalLayout, av as FFIDInquiryFormOrganization, aw as FFIDInquiryFormPlaceholderContext, ax as FFIDInquiryFormPrefill, ay as FFIDInquiryFormProps, az as FFIDInquiryFormSubmitData, aA as FFIDInquiryFormSubmitResult, aB as FFIDJwtClaims, aC as FFIDLoginButton, aD as FFIDOAuthUserInfoMemberRole, aE as FFIDOrganizationSwitcher, aF as FFIDPlanChangeLineItem, aG as FFIDPlanChangePreview, aH as FFIDPlanInfo, aI as FFIDPricingModel, aJ as FFIDPublishedPlan, aK as FFIDSeatAssignmentClaim, aL as FFIDSeatAssignmentStatus, aM as FFIDSeatChangeLineItem, aN as FFIDSeatChangePreview, aO as FFIDSeatModel, aP as FFIDServiceAccessDenialReason, aQ as FFIDServiceAccessFailPolicy, aR as FFIDServiceInfo, aS as FFIDSubscriptionBadge, aT as FFIDSubscriptionCheckCredits, aU as FFIDSubscriptionSummary, aV as FFIDSupportedCurrency, aW as FFIDUserMenu, aX as FFID_CATALOG_ENVIRONMENTS, aY as FFID_CATALOG_PUBLICATION_STATUSES, aZ as FFID_CREDITS_CONSUME_MAX_AMOUNT, a_ as FFID_CREDITS_CONSUME_MIN_AMOUNT, a$ as FFID_CREDITS_FEATURE_PATTERN, b0 as FFID_CREDITS_HISTORY_DEFAULT_LIMIT, b1 as FFID_CREDITS_HISTORY_MAX_LIMIT, b2 as FFID_CREDITS_HISTORY_MIN_LIMIT, b3 as FFID_CREDITS_IDEMPOTENCY_KEY_PATTERN, b4 as FFID_CREDITS_LOW_THRESHOLD_PERCENT, b5 as FFID_CREDITS_METADATA_MAX_BYTES, b6 as FFID_CREDIT_GRANT_KINDS, b7 as FFID_CREDIT_HISTORY_TYPES, b8 as FFID_CREDIT_PACK_MAX_QUANTITY, b9 as FFID_CREDIT_PACK_MIN_QUANTITY, ba as FFID_INQUIRY_ACQUISITION_SOURCES, bb as FFID_INQUIRY_CATEGORIES, bc as FFID_INQUIRY_CATEGORIES_SITE_2026, bd as TokenData, be as UseFFIDAnnouncementsOptions, bf as UseFFIDAnnouncementsReturn, bg as createTokenStore, bh as isFFIDInquiryAcquisitionSource, bi as isFFIDInquiryCategorySite2026, bj as useFFIDAnnouncements } from './index-CWGoIgYL.js';
 export { A as ALL_DENIED_EXCEPT_NECESSARY, i as CONSENT_COOKIE_NAME, j as CONSENT_DISMISSAL_TIMESTAMP_KEY, l as COOKIE_VERSION, D as DEFAULT_CONSENT_ERROR_MESSAGES, 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-yt5SUr-W.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
@@ -159,403 +159,6 @@ interface FFIDCreatePortalParams {
     returnUrl: string;
 }
 
-/** Billing interval for subscriptions */
-type FFIDBillingInterval = 'monthly' | 'yearly';
-/**
- * Supported currencies for billing responses.
- * Mirrors the platform's `SupportedCurrency` enum (`jpy` = zero-decimal Japanese Yen, `usd` = US Dollar).
- */
-type FFIDSupportedCurrency = 'jpy' | 'usd';
-/** Service information returned by plans endpoint */
-interface FFIDServiceInfo {
-    id: string;
-    code: string;
-    name: string;
-    description: string | null;
-    isActive: boolean;
-    createdAt: string;
-    plans: FFIDPlanInfo[];
-}
-/** Plan information returned by plans endpoint */
-interface FFIDPlanInfo {
-    id: string;
-    serviceId: string;
-    code: string;
-    name: string;
-    description: string | null;
-    minSeats: number;
-    maxSeats: number | null;
-    seatSelectionEnabled: boolean;
-    trialDays: number;
-    /** flat: period fee; per_seat: multiply by selected quantity. Older servers omit this. */
-    pricingModel?: 'per_seat' | 'flat';
-    /**
-     * Monthly price in the smallest currency unit.
-     *
-     * `null` when the plan is not self-serve priced. Once the FFID #4482 rollout
-     * is enabled, `customPricing: true` (Enterprise / "contact us") plans return
-     * `null` here — branch on `customPricing` to render an inquiry CTA rather than
-     * a price. Standard plans always return a number.
-     */
-    priceMonthly: number | null;
-    priceYearly: number | null;
-    currency: string;
-    isActive: boolean;
-    displayOrder: number;
-    customPricing: boolean;
-    createdAt: string;
-}
-/** Response from list plans endpoint */
-interface FFIDListPlansResponse {
-    services: FFIDServiceInfo[];
-    count: number;
-}
-/** Subscription details returned by ext API (sanitized, no Stripe IDs) */
-interface FFIDSubscriptionDetail {
-    id: string;
-    organizationId: string;
-    organizationName: string;
-    serviceCode: string;
-    serviceName: string;
-    planCode: string;
-    planName: string;
-    status: FFIDSubscriptionStatus;
-    paymentMethod: string | null;
-    billingInterval: FFIDBillingInterval;
-    quantity: number;
-    currentPeriodStart: string | null;
-    currentPeriodEnd: string | null;
-    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;
-    /**
-     * 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;
-    createdAt: string;
-}
-/** Parameters for subscribing to a plan */
-interface FFIDSubscribeParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** Plan code (e.g., 'free', 'basic', 'pro') */
-    planCode: string;
-    /** Billing interval (default: 'monthly') */
-    billingInterval?: FFIDBillingInterval;
-    /** Number of seats (default: plan's minSeats) */
-    quantity?: number;
-    /** User ID for seat auto-assignment (only needed for service-key mode) */
-    userId?: string;
-}
-/** Sanitized subscription fields returned by subscribe/reactivate endpoints (no Stripe IDs) */
-interface FFIDSubscriptionSummary {
-    id: string;
-    organizationId: string;
-    serviceId: string;
-    planId: string;
-    status: FFIDSubscriptionStatus;
-    paymentMethod: string | null;
-    billingInterval: FFIDBillingInterval;
-    quantity: number;
-    currentPeriodStart: string | null;
-    currentPeriodEnd: string | null;
-    trialStart: string | null;
-    trialEnd: string | null;
-    canceledAt: string | null;
-    cancelAtPeriodEnd: boolean;
-    createdAt: string;
-}
-/** Response from subscribe endpoint */
-interface FFIDSubscribeResponse {
-    subscription: FFIDSubscriptionSummary;
-    service: {
-        id: string;
-        code: string;
-        name: string;
-    };
-    plan: {
-        id: string;
-        code: string;
-        name: string;
-        priceMonthly: number;
-        priceYearly: number | null;
-        trialDays: number;
-    };
-    /** True if a canceled subscription was reactivated */
-    reactivated?: boolean;
-    /** True if Stripe checkout is needed (canceled paid plan reactivation) */
-    needsCheckout?: boolean;
-}
-/** Parameters for changing plan */
-interface FFIDChangePlanParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New plan code */
-    planCode: string;
-    /** New billing interval (default: keeps current) */
-    billingInterval?: FFIDBillingInterval;
-}
-/**
- * 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: {
-        id: string;
-        organizationId: string;
-        serviceCode: string;
-        planCode: string;
-        planName: string;
-        billingInterval: FFIDBillingInterval;
-        status: FFIDSubscriptionStatus;
-        isUpgrade: boolean;
-    };
-    /** Present when the change is a decrease reserved until the period end */
-    pendingDowngrade?: {
-        planCode: string;
-        planName: string;
-        scheduledAt: string;
-    };
-}
-/** Parameters for canceling subscription */
-interface FFIDCancelSubscriptionParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** Cancellation reason code */
-    reason?: 'too_expensive' | 'missing_features' | 'switched_service' | 'rarely_used' | 'customer_service' | 'other';
-    /** Additional cancellation details */
-    reasonDetails?: string;
-}
-/**
- * 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.
- *
- * 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: {
-        id: string;
-        organizationId: string;
-        serviceCode: string;
-        planCode: string;
-        billingInterval: FFIDBillingInterval;
-        status: FFIDSubscriptionStatus;
-        /** Always null after successful cancellation */
-        pendingDowngradePlanId: null;
-    };
-}
-/** Parameters for previewing plan change */
-interface FFIDPreviewPlanChangeParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New plan code */
-    planCode: string;
-    /** New billing interval (default: keeps current) */
-    billingInterval?: FFIDBillingInterval;
-}
-/** Plan change preview line item */
-interface FFIDPlanChangeLineItem {
-    description: string;
-    amount: number;
-}
-/** Fields shared by every plan-change preview variant (internal; consumers use `FFIDPlanChangePreview`) */
-interface FFIDPlanChangePreviewBase {
-    /** Discriminant for preview response variants (reserved for future unions with e.g. seat-change previews) */
-    type: 'plan-change';
-    /** Current plan display info. `price` is the period total: flat fee, or per-seat price times quantity. */
-    currentPlan: {
-        name: string;
-        price: number;
-    };
-    /** New plan display info. `price` is the period total: flat fee, or per-seat price times quantity. */
-    newPlan: {
-        name: string;
-        price: number;
-    };
-    billingInterval: FFIDBillingInterval;
-    isUpgrade: boolean;
-    /** Full amount of the next billing cycle at the new plan's standard price. Never overwritten by Stripe proration data. */
-    nextInvoiceAmount: number;
-    nextInvoiceDate: string | null;
-    currency: FFIDSupportedCurrency;
-    /** true when amounts are estimated from local prices (no Stripe proration data) */
-    isEstimate: boolean;
-    /** Reason why `isEstimate` is true. Only meaningful when `isEstimate === true`. */
-    estimateReason?: 'no_stripe_data' | 'custom_pricing' | 'stripe_error';
-    lineItems: FFIDPlanChangeLineItem[];
-}
-/**
- * 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`: 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;
-    effectiveDate: string | null;
-    /** 0 on period-end-deferred changes; charge happens at the next invoice */
-    proratedAmount: 0;
-} | {
-    willApplyAtPeriodEnd: false;
-    effectiveDate: null;
-    /** 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 */
-interface FFIDPlanChangePreviewResponse {
-    preview: FFIDPlanChangePreview;
-}
-/** Parameters for previewing a seat count change */
-interface FFIDPreviewSeatChangeParams {
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** New seat quantity. Must be an integer within the plan's allowed range. */
-    quantity: number;
-}
-/** Seat change preview line item */
-interface FFIDSeatChangeLineItem {
-    description: string;
-    amount: number;
-}
-/**
- * Seat change proration preview.
- *
- * 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. `isEstimate=false`: it reflects Stripe's live
- *   proration calculation.
- *
- * `nextInvoiceAmount` is a local estimate: flat period fee, or `unitPrice * newQuantity`.
- * Flat capacity changes have zero prorated cost.
- *
- * `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 {
-    /** flat: unitPrice is the whole period fee; per_seat: multiply by capacity. */
-    pricingModel?: 'per_seat' | 'flat';
-    /** Discriminant for preview response variants (pairs with `FFIDPlanChangePreview.type`) */
-    type: 'seat-change';
-    currentQuantity: number;
-    newQuantity: number;
-    /** Per-seat price for the current billing interval */
-    unitPrice: number;
-    billingInterval: FFIDBillingInterval;
-    /**
-     * 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 — flat period fee or per-seat price times newQuantity */
-    nextInvoiceAmount: number;
-    nextInvoiceDate: string | null;
-    currency: FFIDSupportedCurrency;
-    /** true when proratedAmount is a local estimate rather than Stripe invoice/proration data */
-    isEstimate: boolean;
-    /** 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 */
-interface FFIDSeatChangePreviewResponse {
-    preview: FFIDSeatChangePreview;
-}
-
 /** Member role in an organization */
 type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
 /** Member role assignable through organization member management APIs */
@@ -900,12 +503,28 @@ interface FFIDSeatAssignmentRecord {
     createdAt: string;
     updatedAt: string;
 }
-/** GET /api/v1/subscriptions/ext/{id}/seats/assignments のレスポンス */
+/**
+ * GET /api/v1/subscriptions/ext/{id}/seats/assignments のレスポンス
+ *
+ * 10.0.0（破壊的変更）: flat 契約では `totalSeats` = 人数枠（`maxMembers`）で、
+ * 無制限のプランでは `totalSeats` / `availableSeats` が `null` になる。
+ * `pricingModel` で分岐すること（#6395（10.0.0）で assignments にも追加。それより前の FFID は返さない）。
+ */
 interface FFIDListSeatAssignmentsResponse {
     assignments: FFIDSeatAssignmentWithUser[];
-    totalSeats: number;
+    /** 課金モデル。#6395（10.0.0）で assignments にも追加（それより前の FFID サーバーは返さない） */
+    pricingModel?: 'per_seat' | 'flat';
+    /** per_seat: 契約の席数。flat: 人数枠（`null` = 無制限） */
+    totalSeats: number | null;
     assignedSeats: number;
-    availableSeats: number;
+    /** 残り。flat で無制限のときは `null` */
+    availableSeats: number | null;
+    /** flat のみ: 人数枠（`null` = 無制限） */
+    maxMembers?: number | null;
+    /** flat のみ: 割り当て済みの人数 */
+    assignedMembers?: number;
+    /** flat のみ: 残りの人数枠（`null` = 無制限） */
+    availableMembers?: number | null;
 }
 /** listSeatAssignments のパラメータ */
 interface FFIDListSeatAssignmentsParams {
@@ -1551,107 +1170,6 @@ interface FFIDTokenIntrospectionResponse {
     };
 }
 
-/** Deployment environments a catalog publication can apply to (single source) */
-declare const FFID_CATALOG_ENVIRONMENTS: readonly ["staging", "production"];
-/** Deployment environment a catalog publication applies to */
-type FFIDCatalogEnvironment = (typeof FFID_CATALOG_ENVIRONMENTS)[number];
-/**
- * Tax behavior of a published price.
- * `inclusive`: displayed price contains Stripe-calculated tax.
- * `exclusive`: tax is added on top of the base price.
- */
-type FFIDTaxBehavior = 'inclusive' | 'exclusive';
-/**
- * Publication lifecycle statuses (single source — the type, the SDK runtime
- * validator, and consumer sets all derive from this tuple so a new literal
- * cannot be added to one side only).
- */
-declare const FFID_CATALOG_PUBLICATION_STATUSES: readonly ["approved", "superseded", "revoking", "revoked"];
-/**
- * Publication lifecycle status.
- * - `approved`: sellable — the only status that permits new paid checkout
- * - `superseded`: replaced by a newer revision (old sessions may sell through
- *   until `sellThroughUntil`)
- * - `revoking`: emergency stop in progress — never sellable
- * - `revoked`: emergency stop completed — never sellable
- */
-type FFIDCatalogPublicationStatus = (typeof FFID_CATALOG_PUBLICATION_STATUSES)[number];
-/**
- * Human-approved publication record binding a catalog revision to the
- * content/config hashes reviewed at approval time.
- *
- * All `*Hash` fields are lowercase SHA-256 hex computed with the shared
- * canonicalization helpers in `shared/catalog-hash` — consumers re-hash the
- * content they actually render and must refuse new sales on any mismatch.
- */
-interface FFIDCatalogPublication {
-    serviceCode: string;
-    environment: FFIDCatalogEnvironment;
-    catalogVersion: string;
-    praxisCopyHash: string;
-    ffidCheckoutCopyHash: string;
-    legalDisclosureHash: string;
-    taxConfigurationHash: string;
-    paymentConfigurationHash: string;
-    scopeHash: string;
-    /** Monotonically increasing per (service, environment) publication counter */
-    salesEpoch: number;
-    /** FFID-generated immutable human-review approval ID */
-    approvalId: string;
-    /** ISO 8601 timestamp of the recorded human review */
-    reviewedAt: string;
-    /** ISO 8601 timestamp the publication became effective */
-    effectiveAt: string;
-    /** ISO 8601 timestamp the publication was superseded (null while current) */
-    supersededAt: string | null;
-    /** ISO 8601 upper bound for old-session sell-through (null unless superseded) */
-    sellThroughUntil: string | null;
-    /** ISO 8601 timestamp an emergency revoke took effect (null unless revoking/revoked) */
-    revocationEffectiveAt: string | null;
-    status: FFIDCatalogPublicationStatus;
-}
-/**
- * A plan inside a published catalog revision (public-safe snapshot).
- * Never contains Stripe Product/Price identifiers or other secrets.
- */
-interface FFIDPublishedPlan {
-    /**
-     * Plan code — always a lowercase slug (`^[a-z0-9][a-z0-9_-]*$`).
-     * Per-service open set; see the FFID repo's
-     * `docs/04-api/PLAN_CODE_CONTRACT.md` for the full guarantees.
-     */
-    code: string;
-    name: string;
-    description: string | null;
-    /** Monthly price in the catalog currency; null when monthly is not offered */
-    priceMonthly: number | null;
-    /** Yearly price in the catalog currency; null when yearly is not offered */
-    priceYearly: number | null;
-    currency: string;
-    /** Billing intervals actually purchasable for this plan */
-    billingIntervals: FFIDBillingInterval[];
-    taxBehavior: FFIDTaxBehavior;
-    minSeats: number;
-    maxSeats: number | null;
-    displayOrder: number;
-}
-/**
- * Response of GET /api/v1/subscriptions/ext/catalog/{serviceCode}.
- *
- * `catalogVersion` always equals `publication.catalogVersion`; it is hoisted
- * to the top level so consumers can pin the version (e.g. as
- * `expectedCatalogVersion` for checkout) without digging into the publication.
- */
-interface FFIDPublishedCatalog {
-    service: {
-        code: string;
-        name: string;
-    };
-    catalogVersion: string;
-    publication: FFIDCatalogPublication;
-    plans: FFIDPublishedPlan[];
-}
-
 /** OTP / magic link methods - sendOtp / verifyOtp */
 
 /** Response from sendOtp */
@@ -1863,6 +1381,45 @@ declare const FFID_SUBSCRIPTION_ERROR_CODES: {
 };
 /** Union of `FFID_SUBSCRIPTION_ERROR_CODES` values */
 type FFIDSubscriptionErrorCode = (typeof FFID_SUBSCRIPTION_ERROR_CODES)[keyof typeof FFID_SUBSCRIPTION_ERROR_CODES];
+/**
+ * Server error codes of the Credits API and the flat-plan member limit (10.0.0,
+ * FFID CREDITS_API §6). They arrive verbatim in `FFIDError.code`.
+ *
+ * - `CREDITS_INSUFFICIENT` (409, `credits.consume`): nothing was consumed and the
+ *   idempotency key is still unused. `details` is `FFIDCreditsInsufficientDetails`.
+ *   Do not retry automatically; show the credit purchase path.
+ * - `CREDITS_IDEMPOTENCY_CONFLICT` (409): the same idempotency key with another amount.
+ *   A caller bug — do not retry.
+ * - `CREDITS_NOT_APPLICABLE` (409): the contract's plan is per_seat (not credit-based).
+ * - `CREDITS_BALANCE_CAP_EXCEEDED` (409): a grant would push the balance over the cap.
+ * - `SEAT_BILLING_NOT_APPLICABLE` (409): seat-count changes on a flat contract.
+ * - `MEMBER_LIMIT_REACHED` (409): seat assignment while the plan's member limit is full
+ *   (`details: { capacity, assigned }`).
+ * - `CREDIT_PACK_NOT_FOUND` (404): unknown or inactive `packCode`.
+ * - `CREDIT_PACK_REGION_NOT_SUPPORTED` (409): billing address outside the sales region.
+ * - `CREDIT_PACK_STRIPE_NOT_SYNCED` / `CREDIT_PACK_STRIPE_OUT_OF_SYNC` (409): the pack
+ *   is waiting for an operator to sync its Stripe price.
+ * - `CREDIT_PACK_CHANGED` (409): the pack changed while the checkout was being created.
+ *   Safe to retry.
+ *
+ * The values and statuses are checked against the FFID server's definitions by a test
+ * in the FFID repository.
+ */
+declare const FFID_CREDITS_ERROR_CODES: {
+    readonly CREDITS_INSUFFICIENT: "CREDITS_INSUFFICIENT";
+    readonly CREDITS_IDEMPOTENCY_CONFLICT: "CREDITS_IDEMPOTENCY_CONFLICT";
+    readonly CREDITS_NOT_APPLICABLE: "CREDITS_NOT_APPLICABLE";
+    readonly CREDITS_BALANCE_CAP_EXCEEDED: "CREDITS_BALANCE_CAP_EXCEEDED";
+    readonly SEAT_BILLING_NOT_APPLICABLE: "SEAT_BILLING_NOT_APPLICABLE";
+    readonly MEMBER_LIMIT_REACHED: "MEMBER_LIMIT_REACHED";
+    readonly CREDIT_PACK_NOT_FOUND: "CREDIT_PACK_NOT_FOUND";
+    readonly CREDIT_PACK_REGION_NOT_SUPPORTED: "CREDIT_PACK_REGION_NOT_SUPPORTED";
+    readonly CREDIT_PACK_STRIPE_NOT_SYNCED: "CREDIT_PACK_STRIPE_NOT_SYNCED";
+    readonly CREDIT_PACK_STRIPE_OUT_OF_SYNC: "CREDIT_PACK_STRIPE_OUT_OF_SYNC";
+    readonly CREDIT_PACK_CHANGED: "CREDIT_PACK_CHANGED";
+};
+/** Union of `FFID_CREDITS_ERROR_CODES` values */
+type FFIDCreditsErrorCode = (typeof FFID_CREDITS_ERROR_CODES)[keyof typeof FFID_CREDITS_ERROR_CODES];
 
 /** Creates an FFID API client instance */
 declare function createFFIDClient(config: FFIDConfig): {
@@ -1950,6 +1507,7 @@ declare function createFFIDClient(config: FFIDConfig): {
     getInvoice: (params: FFIDGetInvoiceParams) => Promise<FFIDApiResponse<FFIDGetInvoiceResponse>>;
     retryPayment: (params: FFIDRetryPaymentParams) => Promise<FFIDApiResponse<FFIDRetryPaymentSummary>>;
     listSeatAssignments: (params: FFIDListSeatAssignmentsParams) => Promise<FFIDApiResponse<FFIDListSeatAssignmentsResponse>>;
+    getSeats: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSeatsSummary>>;
     assignSeats: (params: FFIDAssignSeatsParams) => Promise<FFIDApiResponse<FFIDAssignSeatsResponse>>;
     unassignSeat: (params: FFIDUnassignSeatParams) => Promise<FFIDApiResponse<FFIDUnassignSeatResponse>>;
     listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
@@ -1960,13 +1518,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
     cancelPendingDowngrade: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDCancelPendingDowngradeResponse>>;
     previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
+    /** @deprecated 10.0.0: per_seat (praxis) only; removed in 11.0.0 */
     previewSeatChange: (params: FFIDPreviewSeatChangeParams) => Promise<FFIDApiResponse<FFIDSeatChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
     getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
     redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
     getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
     redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** @deprecated 10.0.0: per_seat (praxis) only; removed in 11.0.0 */
     getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** @deprecated 10.0.0: per_seat (praxis) only; removed in 11.0.0 */
     redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
     getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
     redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
@@ -1994,6 +1555,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     inquiry: {
         create: (params: FFIDInquiryCreateParams) => Promise<FFIDApiResponse<FFIDInquiryCreateResponse>>;
     };
+    /** Credits methods for flat plans (consume / balance / history / packs) */
+    credits: {
+        getBalance: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDCreditBalance>>;
+        listHistory: (subscriptionId: string, options?: FFIDListCreditHistoryOptions) => Promise<FFIDApiResponse<FFIDCreditHistoryPage>>;
+        listPacks: (packServiceCode?: string) => Promise<FFIDApiResponse<FFIDCreditPackList>>;
+        createPackCheckout: (params: FFIDCreatePackCheckoutParams) => Promise<FFIDApiResponse<FFIDCreditPackCheckout>>;
+        consume: (params: FFIDCreditConsumeParams) => Promise<FFIDApiResponse<FFIDCreditConsumeResult>>;
+        getBuyCreditsUrl: (params: FFIDBuyCreditsUrlParams) => FFIDApiResponse<string>;
+        redirectToBuyCredits: (params: FFIDBuyCreditsUrlParams) => FFIDRedirectResult;
+    };
     /** Token store (token mode only) */
     tokenStore: TokenStore;
     /**
@@ -2033,6 +1604,10 @@ declare class FFIDSDKError extends Error {
  * validates the OAuth `state` against the value persisted at authorize time
  * (CSRF protection, RFC 6749 §10.12), retrieves the PKCE verifier, exchanges
  * the code for tokens, and cleans the params out of the URL on success.
+ *
+ * When FFID refused the user, the callback carries `error` (+ FFID's
+ * `denial_reason`) instead of `code` (#6523). After the same `state` check the
+ * error is returned as an authorization error (see `./authorization-error`).
  */
 
 /**
@@ -2050,8 +1625,9 @@ interface HandleRedirectCallbackOptions {
     url?: string | undefined;
     /**
      * Whether to remove `code` / `state` from the browser URL via
-     * `window.history.replaceState` after a successful exchange. Defaults to
-     * `true`.
+     * `window.history.replaceState` after a successful exchange — and, on an
+     * authorization error, `state` only (#6523; see {@link ERROR_CALLBACK_CONSUMED_PARAMS}).
+     * Defaults to `true`.
      *
      * Set to `false` to take over URL cleanup on the consumer side. This matters
      * on Next.js App Router: the App Router patches `history.replaceState`, so
@@ -2071,7 +1647,9 @@ interface HandleRedirectCallbackOptions {
  * Complete an OAuth authorization-code redirect.
  *
  * Behavior:
- * 1. Reads `code` + `state` from `options.url ?? window.location.search`.
+ * 1. Reads `code` + `state` (or `error`) from `options.url ?? window.location.search`.
+ *    A URL with no `code` — and no `error` carrying a `state` — returns
+ *    `MISSING_AUTHORIZATION_CODE` without touching the stored state.
  * 2. CSRF guard: if a `state` exists on EITHER side (a stored state from
  *    authorize OR a `state` on the callback URL), the two MUST match — mismatch,
  *    a missing stored state, or an **omitted** callback `state` all **fail closed**
@@ -2081,6 +1659,17 @@ interface HandleRedirectCallbackOptions {
  * 3. Retrieves the PKCE verifier and exchanges the code for tokens.
  * 4. On success, removes `code` + `state` from the browser URL (skipped when
  *    `options.cleanUrl` is `false` — the consumer then owns URL cleanup).
+ * 5. When the URL carries `error` **and** `state` (FFID refused the user),
+ *    returns it as an authorization error after step 2 instead of exchanging
+ *    anything. Unlike a code callback there is no no-state leniency: the URL
+ *    `state` must match a stored one, so a crafted `?error=...&error_description=`
+ *    link cannot be shown as a denial (content spoofing). `code` is
+ *    the OAuth `error` (e.g. `access_denied`) and `details` holds FFID's
+ *    `denial_reason` — read it with `getFFIDAuthorizationError`. The PKCE
+ *    verifier is discarded and the consumed `state` is removed from the URL
+ *    (same `cleanUrl` rule), so a reload does not re-process it. `error` /
+ *    `error_description` / `denial_reason` stay in the URL.
+ *    Do not call `login()` again on this error: FFID refuses the same way.
  *
  * SSR-safe: when there is no `window` and no `options.url`, no exchange is
  * attempted and an error result is returned.
@@ -2090,6 +1679,77 @@ interface HandleRedirectCallbackOptions {
  */
 declare function handleRedirectCallback(client: HandleRedirectCallbackClient, options?: HandleRedirectCallbackOptions): Promise<FFIDApiResponse<void>>;
 
+/**
+ * OAuth authorization errors returned to the service's `redirect_uri` (#6523)
+ *
+ * When FFID's `/oauth/authorize` refuses a user, it redirects back with
+ * `error=<OAuth error>&error_description=...&state=...` (RFC 6749 §4.1.2.1). For
+ * subscription / seat denials it also adds the FFID extension `denial_reason`
+ * (#6498), so a service can tell "no seat in this organization" from "no
+ * subscription" without parsing `error_description`.
+ *
+ * Both callback paths build the same {@link FFIDError} from those params:
+ * - `handleRedirectCallback` / token-mode `FFIDProvider` (browser, PKCE)
+ * - `createServerAuthClient().handleCallback` (confidential / BFF)
+ *
+ * `error.code` is the OAuth `error` value verbatim (e.g. `access_denied`), and
+ * `error.details` is {@link FFIDAuthorizationErrorDetails}. Read it with
+ * {@link getFFIDAuthorizationError}.
+ *
+ * This module has no browser dependency so the server entry can share it.
+ */
+
+/**
+ * Values of FFID's `denial_reason` (the authorize error redirect and the
+ * `/oauth/userinfo` 403; `/oauth/introspect` only answers `active: false`). Kept
+ * identical to the FFID server's `DENIAL_REASONS` by a test in the FFID repository.
+ *
+ * This is a different vocabulary from `FFIDServiceAccessDenialReason`
+ * (`checkServiceAccess()`), which is derived from the subscription status.
+ */
+declare const FFID_OAUTH_DENIAL_REASONS: readonly ["no_membership", "no_active_subscription", "no_seat_assignment", "subscription_expired", "member_limit_reached"];
+type FFIDOAuthDenialReason = (typeof FFID_OAUTH_DENIAL_REASONS)[number];
+/** Runtime guard for {@link FFIDOAuthDenialReason}. Unknown values are `false`. */
+declare function isFFIDOAuthDenialReason(value: unknown): value is FFIDOAuthDenialReason;
+/** `FFIDError.details` of an authorization error */
+interface FFIDAuthorizationErrorDetails {
+    /** Marks the error as an authorize redirect error (vs. token / network errors) */
+    source: 'authorization';
+    /**
+     * FFID's `denial_reason`. `null` when FFID did not send one (any OAuth error other
+     * than a subscription / seat denial) **or** sent a value this SDK version does not
+     * know — the error itself is still returned, only the reason is unknown.
+     */
+    denialReason: FFIDOAuthDenialReason | null;
+    /**
+     * `error_description` as sent — short ASCII English meant for logs. The same text
+     * is `error.message` (when FFID sent one), so show end users guidance chosen by
+     * `denialReason` rather than the message itself.
+     */
+    errorDescription: string | null;
+}
+/** An authorization error read back by {@link getFFIDAuthorizationError} */
+interface FFIDAuthorizationError {
+    /** The OAuth `error` value, e.g. `access_denied`, `login_required` */
+    oauthError: string;
+    denialReason: FFIDOAuthDenialReason | null;
+    errorDescription: string | null;
+}
+/**
+ * Read an authorization error (and FFID's `denial_reason`) from an {@link FFIDError},
+ * e.g. `useFFID().error` or the result of `handleRedirectCallback` /
+ * `createServerAuthClient().handleCallback`. Returns `null` for any other error.
+ *
+ * ```ts
+ * const denial = getFFIDAuthorizationError(error)
+ * if (denial?.denialReason === 'no_seat_assignment') {
+ *   // Ask an organization owner / admin to add the user. Do not call login() again:
+ *   // FFID would refuse the same way.
+ * }
+ * ```
+ */
+declare function getFFIDAuthorizationError(error: FFIDError | null | undefined): FFIDAuthorizationError | null;
+
 /**
  * Redirect URI normalization (SDK copy)
  *
@@ -2380,7 +2040,10 @@ interface FFIDProviderProps extends FFIDConfig {
      * Set to `false` on Next.js App Router when the patched history API
      * re-evaluating `useSearchParams()` (and re-running effects that depend on
      * it) is a problem — then remove `code` / `state` yourself (keeping other
-     * query params) after authentication completes. Consumed callback params
+     * query params) after authentication completes. When FFID refused the user
+     * (`?error=` callback, #6523), the provider removes only the consumed `state`
+     * under the same rule (`error` / `denial_reason` stay for the app to read), so
+     * with `false` remove `state` too. Consumed callback params
      * left in the URL fail on reload with `STATE_MISMATCH_ERROR` (the one-time
      * OAuth `state` was already consumed), which also leaves an authenticated
      * user rendered as signed-out until the URL is cleaned.
@@ -2915,6 +2578,46 @@ declare function hasAccessFromUserinfo(sub: FFIDOAuthUserInfoSubscription | null
  */
 declare function isBlockedFromUserinfo(sub: FFIDOAuthUserInfoSubscription | null | undefined): boolean;
 
+/**
+ * Credits methods — `client.credits.*` (SDK 10.0.0 / FFID #6395, CREDITS_API.md v1.3.1).
+ *
+ * For `pricing_model='flat'` contracts. per_seat (praxis) contracts answer every
+ * call with 409 `CREDITS_NOT_APPLICABLE`.
+ *
+ * Auth modes (CREDITS_API §2):
+ * - `consume`: service-key only (`credits:write`). Other modes get `FORBIDDEN`
+ *   with `details.reason: 'api_key_required'` before the network — the same code
+ *   and shape the server returns.
+ * - `createPackCheckout`: token (Bearer) only, by an owner / admin of the contract's
+ *   organization. Other modes get `FORBIDDEN` with `details.reason: 'bearer_required'`.
+ * - `getBalance` / `listHistory` / `listPacks`: token or service-key.
+ *
+ * Nothing here throws: business errors such as `CREDITS_INSUFFICIENT` come back as
+ * `{ error }` with the server's `details`.
+ */
+
+/** Dependencies required by credits methods */
+interface CreditsMethodsDeps {
+    fetchWithAuth: <T>(endpoint: string, options?: RequestInit) => Promise<FFIDApiResponse<T>>;
+    createError: (code: string, message: string) => FFIDError;
+    authMode: FFIDAuthMode;
+    baseUrl: string;
+    serviceCode: string;
+    logger: FFIDLogger;
+}
+/** Create `client.credits.*` bound to the client's fetchWithAuth */
+declare function createCreditsMethods(deps: CreditsMethodsDeps): {
+    getBalance: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDCreditBalance>>;
+    listHistory: (subscriptionId: string, options?: FFIDListCreditHistoryOptions) => Promise<FFIDApiResponse<FFIDCreditHistoryPage>>;
+    listPacks: (packServiceCode?: string) => Promise<FFIDApiResponse<FFIDCreditPackList>>;
+    createPackCheckout: (params: FFIDCreatePackCheckoutParams) => Promise<FFIDApiResponse<FFIDCreditPackCheckout>>;
+    consume: (params: FFIDCreditConsumeParams) => Promise<FFIDApiResponse<FFIDCreditConsumeResult>>;
+    getBuyCreditsUrl: (params: FFIDBuyCreditsUrlParams) => FFIDApiResponse<string>;
+    redirectToBuyCredits: (params: FFIDBuyCreditsUrlParams) => FFIDRedirectResult;
+};
+/** Type of `client.credits` */
+type FFIDCreditsClient = ReturnType<typeof createCreditsMethods>;
+
 /**
  * Catalog approval hash helpers (#4342 / ASDD-PRICING-002 SP4A)
  *
@@ -3255,4 +2958,4 @@ declare function createInquiryMethods(deps: InquiryMethodsDeps): {
 };
 type FFIDInquiryClient = ReturnType<typeof createInquiryMethods>;
 
-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 };
+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 FFIDAuthorizationError, type FFIDAuthorizationErrorDetails, FFIDBillingInterval, FFIDBuyCreditsUrlParams, FFIDCacheAdapter, FFIDCancelPendingDowngradeResponse, FFIDCancelSubscriptionParams, FFIDCancelSubscriptionResponse, type FFIDCanonicalJsonValue, FFIDCatalogEnvironment, FFIDCatalogHashError, FFIDChangePlanParams, FFIDChangePlanResponse, FFIDCheckServiceAccessParams, type FFIDCheckoutSessionResponse, type FFIDClient, type FFIDCompanySizeCode, FFIDConfig, type FFIDCreateCheckoutParams, FFIDCreatePackCheckoutParams, type FFIDCreatePortalParams, FFIDCreditBalance, FFIDCreditConsumeParams, FFIDCreditConsumeResult, FFIDCreditHistoryPage, FFIDCreditPackCheckout, FFIDCreditPackList, type FFIDCreditsClient, type FFIDCreditsErrorCode, FFIDError, type FFIDErrorCode, type FFIDIndustryCode, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, type FFIDInvitationStatus, type FFIDInviteMemberRequest, type FFIDInviteMemberResponse, type FFIDLeaveOrganizationParams, type FFIDLeaveOrganizationResponse, FFIDListCreditHistoryOptions, type FFIDListMembersResponse, 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 FFIDOAuthDenialReason, 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, FFIDPlanChangePreviewResponse, type FFIDPortalSessionResponse, FFIDPreviewPlanChangeParams, 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, FFIDPublishedCatalog, type FFIDRedirectErrorCode, type FFIDRedirectResult, type FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDScopeHashInput, type FFIDScopeHashPlan, FFIDSeatChangePreviewResponse, FFIDSeatsSummary, FFIDServiceAccessDecision, FFIDSessionResponse, FFIDSignOutResult, FFIDSubscribeParams, FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, FFIDSubscriptionDetail, type FFIDSubscriptionErrorCode, FFIDSubscriptionStatus, 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_COMPANY_SIZE_CODES, FFID_CREDITS_ERROR_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_OAUTH_DENIAL_REASONS, 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, getFFIDAuthorizationError, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, isFFIDOAuthDenialReason, normalizeRedirectUri, readAgencyInviteCookie, readAgencyInviteToken, redactAgencyInviteToken, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useRequireActiveSubscription, useSubscription, validatePublishedCatalog, withFFIDAuth, withSubscription };