@feelflow/ffid-sdk 5.24.3 → 5.27.0

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

@@ -1345,6 +1345,158 @@ interface FFIDUpdateUserProfileRequest {
     preferences?: Record<string, unknown> | null;
 }
 
+/**
+ * OAuth flow types: client-side redirect results and OAuth token / RFC 7662
+ * introspection payloads.
+ *
+ * Extracted from `types/index.ts` to keep that barrel under the 800-line hard
+ * limit (`scripts/check-file-size.sh`). Re-exported from `types/index.ts`, so
+ * the public API is unchanged — import from `@feelflow/ffid-sdk` as before.
+ */
+
+/**
+ * Discriminant for redirect failures that callers need to handle
+ * programmatically (vs. logging the human-readable `error` string).
+ *
+ * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
+ *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
+ *   has been fired **3 times within 60 seconds**. Caller should surface a
+ *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
+ *
+ * - `'state_persistence_failed'`: `redirectToAuthorize()` could not persist
+ *   the OAuth CSRF `state` (storage unavailable / quota). Redirect is aborted
+ *   fail-closed (#4136) — callers should surface a manual retry UI.
+ *
+ * Other failure paths (SSR environment, PKCE generation failure, empty
+ * organizationId) currently return `error` without a `code`. Treat this union
+ * as forward-extensible and do NOT exhaustively `switch` over it without a
+ * `default` branch for consumer code that must stay compatible across SDK
+ * upgrades.
+ */
+type FFIDRedirectErrorCode = 'redirect_loop_detected' | 'state_persistence_failed';
+/**
+ * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
+ *
+ * Structured return type so callers can inspect failure reasons
+ * instead of receiving a bare `false`. When `code` is set, branch on it
+ * for programmatic handling; otherwise log `error` for humans.
+ *
+ * `loopDetectionDisabled` (#4119): set to `true` when sessionStorage is
+ * unavailable (iOS WebKit private mode / eviction) so redirect-loop detection
+ * ran **fail-open** — the redirect fired, but repeated-redirect protection is
+ * disabled for this browser session. Callers that need loop protection on
+ * such browsers should add their own max-retry guard.
+ */
+type FFIDRedirectResult = {
+    success: true;
+    loopDetectionDisabled?: boolean;
+} | {
+    success: false;
+    error: string;
+    code?: FFIDRedirectErrorCode;
+};
+
+/** 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 (Personal/Pro).
+ * `exclusive`: tax is added on top of the base price (Team).
+ */
+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[];
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -1452,6 +1604,12 @@ interface FFIDSubscription {
     organizationName?: string | null | undefined;
 }
 /** OAuth userinfo subscription summary */
+type FFIDSeatAssignmentStatus = 'active' | 'revoking' | 'revoked';
+interface FFIDSeatAssignmentClaim {
+    organizationId: string;
+    subscriptionId: string;
+    status: FFIDSeatAssignmentStatus;
+}
 interface FFIDOAuthUserInfoSubscription {
     subscriptionId: string | null;
     status: FFIDSubscriptionStatus | null;
@@ -1469,6 +1627,12 @@ interface FFIDOAuthUserInfoSubscription {
     organizationId: string | null;
     organizationName?: string | null | undefined;
     hasSeatAssignment: boolean | null;
+    /**
+     * Organization/subscription-bound seat claim (#4352). `undefined` means an
+     * older FFID omitted the field; `null` means a present claim was malformed.
+     * Only `status === 'active'` grants Team access.
+     */
+    seatAssignment: FFIDSeatAssignmentClaim | null | undefined;
     /**
      * Stripe `cancel_at_period_end` (#3464, SDK 5.8.0). `true` while the
      * subscription is scheduled to terminate at `currentPeriodEnd`. The
@@ -1488,6 +1652,19 @@ interface FFIDOAuthUserInfoSubscription {
      * round-trip.
      */
     currentPeriodEnd: string | null;
+    /**
+     * Per-service entitlement codes (e.g. `praxis.pack.<slug>.access`) granting
+     * access to one-time / single-pack purchases not encoded in the plan tier
+     * (#4333, SDK 5.25.0). Read this list to gate per-pack access; an empty
+     * array means "no pack entitlements" (the normal case for Pro / Team tiers
+     * that unlock packs via `planCode`).
+     *
+     * The `normalizeUserinfo` boundary defaults this to `[]` when the server
+     * omits it (older FFID pre-#4333) or when the introspect path uses a service
+     * API key without `subscription:read`, so consumers always see a plain
+     * `readonly string[]` and never branch on an "unknown" sentinel.
+     */
+    entitlements: readonly string[];
 }
 /**
  * Unified user-identity shape returned by `getSession()` (→ `/oauth/userinfo`)
@@ -1789,47 +1966,6 @@ interface FFIDAnalyticsConfig {
      */
     isActive: boolean;
 }
-/**
- * Discriminant for redirect failures that callers need to handle
- * programmatically (vs. logging the human-readable `error` string).
- *
- * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
- *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
- *   has been fired **3 times within 60 seconds**. Caller should surface a
- *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
- *
- * - `'state_persistence_failed'`: `redirectToAuthorize()` could not persist
- *   the OAuth CSRF `state` (storage unavailable / quota). Redirect is aborted
- *   fail-closed (#4136) — callers should surface a manual retry UI.
- *
- * Other failure paths (SSR environment, PKCE generation failure, empty
- * organizationId) currently return `error` without a `code`. Treat this union
- * as forward-extensible and do NOT exhaustively `switch` over it without a
- * `default` branch for consumer code that must stay compatible across SDK
- * upgrades.
- */
-type FFIDRedirectErrorCode = 'redirect_loop_detected' | 'state_persistence_failed';
-/**
- * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
- *
- * Structured return type so callers can inspect failure reasons
- * instead of receiving a bare `false`. When `code` is set, branch on it
- * for programmatic handling; otherwise log `error` for humans.
- *
- * `loopDetectionDisabled` (#4119): set to `true` when sessionStorage is
- * unavailable (iOS WebKit private mode / eviction) so redirect-loop detection
- * ran **fail-open** — the redirect fired, but repeated-redirect protection is
- * disabled for this browser session. Callers that need loop protection on
- * such browsers should add their own max-retry guard.
- */
-type FFIDRedirectResult = {
-    success: true;
-    loopDetectionDisabled?: boolean;
-} | {
-    success: false;
-    error: string;
-    code?: FFIDRedirectErrorCode;
-};
 
 /** OTP / magic link methods - sendOtp / verifyOtp */
 
@@ -2046,6 +2182,7 @@ declare function createFFIDClient(config: FFIDConfig): {
     assignSeats: (params: FFIDAssignSeatsParams) => Promise<FFIDApiResponse<FFIDAssignSeatsResponse>>;
     unassignSeat: (params: FFIDUnassignSeatParams) => Promise<FFIDApiResponse<FFIDUnassignSeatResponse>>;
     listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
+    getPublishedCatalog: (serviceCode: string) => Promise<FFIDApiResponse<FFIDPublishedCatalog>>;
     getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
     subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;
     changePlan: (params: FFIDChangePlanParams) => Promise<FFIDApiResponse<FFIDChangePlanResponse>>;

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

@@ -1345,6 +1345,158 @@ interface FFIDUpdateUserProfileRequest {
     preferences?: Record<string, unknown> | null;
 }
 
+/**
+ * OAuth flow types: client-side redirect results and OAuth token / RFC 7662
+ * introspection payloads.
+ *
+ * Extracted from `types/index.ts` to keep that barrel under the 800-line hard
+ * limit (`scripts/check-file-size.sh`). Re-exported from `types/index.ts`, so
+ * the public API is unchanged — import from `@feelflow/ffid-sdk` as before.
+ */
+
+/**
+ * Discriminant for redirect failures that callers need to handle
+ * programmatically (vs. logging the human-readable `error` string).
+ *
+ * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
+ *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
+ *   has been fired **3 times within 60 seconds**. Caller should surface a
+ *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
+ *
+ * - `'state_persistence_failed'`: `redirectToAuthorize()` could not persist
+ *   the OAuth CSRF `state` (storage unavailable / quota). Redirect is aborted
+ *   fail-closed (#4136) — callers should surface a manual retry UI.
+ *
+ * Other failure paths (SSR environment, PKCE generation failure, empty
+ * organizationId) currently return `error` without a `code`. Treat this union
+ * as forward-extensible and do NOT exhaustively `switch` over it without a
+ * `default` branch for consumer code that must stay compatible across SDK
+ * upgrades.
+ */
+type FFIDRedirectErrorCode = 'redirect_loop_detected' | 'state_persistence_failed';
+/**
+ * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
+ *
+ * Structured return type so callers can inspect failure reasons
+ * instead of receiving a bare `false`. When `code` is set, branch on it
+ * for programmatic handling; otherwise log `error` for humans.
+ *
+ * `loopDetectionDisabled` (#4119): set to `true` when sessionStorage is
+ * unavailable (iOS WebKit private mode / eviction) so redirect-loop detection
+ * ran **fail-open** — the redirect fired, but repeated-redirect protection is
+ * disabled for this browser session. Callers that need loop protection on
+ * such browsers should add their own max-retry guard.
+ */
+type FFIDRedirectResult = {
+    success: true;
+    loopDetectionDisabled?: boolean;
+} | {
+    success: false;
+    error: string;
+    code?: FFIDRedirectErrorCode;
+};
+
+/** 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 (Personal/Pro).
+ * `exclusive`: tax is added on top of the base price (Team).
+ */
+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[];
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -1452,6 +1604,12 @@ interface FFIDSubscription {
     organizationName?: string | null | undefined;
 }
 /** OAuth userinfo subscription summary */
+type FFIDSeatAssignmentStatus = 'active' | 'revoking' | 'revoked';
+interface FFIDSeatAssignmentClaim {
+    organizationId: string;
+    subscriptionId: string;
+    status: FFIDSeatAssignmentStatus;
+}
 interface FFIDOAuthUserInfoSubscription {
     subscriptionId: string | null;
     status: FFIDSubscriptionStatus | null;
@@ -1469,6 +1627,12 @@ interface FFIDOAuthUserInfoSubscription {
     organizationId: string | null;
     organizationName?: string | null | undefined;
     hasSeatAssignment: boolean | null;
+    /**
+     * Organization/subscription-bound seat claim (#4352). `undefined` means an
+     * older FFID omitted the field; `null` means a present claim was malformed.
+     * Only `status === 'active'` grants Team access.
+     */
+    seatAssignment: FFIDSeatAssignmentClaim | null | undefined;
     /**
      * Stripe `cancel_at_period_end` (#3464, SDK 5.8.0). `true` while the
      * subscription is scheduled to terminate at `currentPeriodEnd`. The
@@ -1488,6 +1652,19 @@ interface FFIDOAuthUserInfoSubscription {
      * round-trip.
      */
     currentPeriodEnd: string | null;
+    /**
+     * Per-service entitlement codes (e.g. `praxis.pack.<slug>.access`) granting
+     * access to one-time / single-pack purchases not encoded in the plan tier
+     * (#4333, SDK 5.25.0). Read this list to gate per-pack access; an empty
+     * array means "no pack entitlements" (the normal case for Pro / Team tiers
+     * that unlock packs via `planCode`).
+     *
+     * The `normalizeUserinfo` boundary defaults this to `[]` when the server
+     * omits it (older FFID pre-#4333) or when the introspect path uses a service
+     * API key without `subscription:read`, so consumers always see a plain
+     * `readonly string[]` and never branch on an "unknown" sentinel.
+     */
+    entitlements: readonly string[];
 }
 /**
  * Unified user-identity shape returned by `getSession()` (→ `/oauth/userinfo`)
@@ -1789,47 +1966,6 @@ interface FFIDAnalyticsConfig {
      */
     isActive: boolean;
 }
-/**
- * Discriminant for redirect failures that callers need to handle
- * programmatically (vs. logging the human-readable `error` string).
- *
- * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
- *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
- *   has been fired **3 times within 60 seconds**. Caller should surface a
- *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
- *
- * - `'state_persistence_failed'`: `redirectToAuthorize()` could not persist
- *   the OAuth CSRF `state` (storage unavailable / quota). Redirect is aborted
- *   fail-closed (#4136) — callers should surface a manual retry UI.
- *
- * Other failure paths (SSR environment, PKCE generation failure, empty
- * organizationId) currently return `error` without a `code`. Treat this union
- * as forward-extensible and do NOT exhaustively `switch` over it without a
- * `default` branch for consumer code that must stay compatible across SDK
- * upgrades.
- */
-type FFIDRedirectErrorCode = 'redirect_loop_detected' | 'state_persistence_failed';
-/**
- * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
- *
- * Structured return type so callers can inspect failure reasons
- * instead of receiving a bare `false`. When `code` is set, branch on it
- * for programmatic handling; otherwise log `error` for humans.
- *
- * `loopDetectionDisabled` (#4119): set to `true` when sessionStorage is
- * unavailable (iOS WebKit private mode / eviction) so redirect-loop detection
- * ran **fail-open** — the redirect fired, but repeated-redirect protection is
- * disabled for this browser session. Callers that need loop protection on
- * such browsers should add their own max-retry guard.
- */
-type FFIDRedirectResult = {
-    success: true;
-    loopDetectionDisabled?: boolean;
-} | {
-    success: false;
-    error: string;
-    code?: FFIDRedirectErrorCode;
-};
 
 /** OTP / magic link methods - sendOtp / verifyOtp */
 
@@ -2046,6 +2182,7 @@ declare function createFFIDClient(config: FFIDConfig): {
     assignSeats: (params: FFIDAssignSeatsParams) => Promise<FFIDApiResponse<FFIDAssignSeatsResponse>>;
     unassignSeat: (params: FFIDUnassignSeatParams) => Promise<FFIDApiResponse<FFIDUnassignSeatResponse>>;
     listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
+    getPublishedCatalog: (serviceCode: string) => Promise<FFIDApiResponse<FFIDPublishedCatalog>>;
     getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
     subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;
     changePlan: (params: FFIDChangePlanParams) => Promise<FFIDApiResponse<FFIDChangePlanResponse>>;

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

@@ -318,6 +318,12 @@ interface FFIDSubscription {
     organizationName?: string | null | undefined;
 }
 /** OAuth userinfo subscription summary */
+type FFIDSeatAssignmentStatus = 'active' | 'revoking' | 'revoked';
+interface FFIDSeatAssignmentClaim {
+    organizationId: string;
+    subscriptionId: string;
+    status: FFIDSeatAssignmentStatus;
+}
 interface FFIDOAuthUserInfoSubscription {
     subscriptionId: string | null;
     status: FFIDSubscriptionStatus | null;
@@ -335,6 +341,12 @@ interface FFIDOAuthUserInfoSubscription {
     organizationId: string | null;
     organizationName?: string | null | undefined;
     hasSeatAssignment: boolean | null;
+    /**
+     * Organization/subscription-bound seat claim (#4352). `undefined` means an
+     * older FFID omitted the field; `null` means a present claim was malformed.
+     * Only `status === 'active'` grants Team access.
+     */
+    seatAssignment: FFIDSeatAssignmentClaim | null | undefined;
     /**
      * Stripe `cancel_at_period_end` (#3464, SDK 5.8.0). `true` while the
      * subscription is scheduled to terminate at `currentPeriodEnd`. The
@@ -354,6 +366,19 @@ interface FFIDOAuthUserInfoSubscription {
      * round-trip.
      */
     currentPeriodEnd: string | null;
+    /**
+     * Per-service entitlement codes (e.g. `praxis.pack.<slug>.access`) granting
+     * access to one-time / single-pack purchases not encoded in the plan tier
+     * (#4333, SDK 5.25.0). Read this list to gate per-pack access; an empty
+     * array means "no pack entitlements" (the normal case for Pro / Team tiers
+     * that unlock packs via `planCode`).
+     *
+     * The `normalizeUserinfo` boundary defaults this to `[]` when the server
+     * omits it (older FFID pre-#4333) or when the introspect path uses a service
+     * API key without `subscription:read`, so consumers always see a plain
+     * `readonly string[]` and never branch on an "unknown" sentinel.
+     */
+    entitlements: readonly string[];
 }
 /**
  * Unified user-identity shape returned by `getSession()` (→ `/oauth/userinfo`)
@@ -811,97 +836,6 @@ interface FFIDAnalyticsConfig {
      */
     isActive: boolean;
 }
-/**
- * Discriminant for redirect failures that callers need to handle
- * programmatically (vs. logging the human-readable `error` string).
- *
- * - `'redirect_loop_detected'`: `redirectToAuthorize()` detected that the
- *   same authorize URL (keyed by `baseUrl + client_id + organization_id`)
- *   has been fired **3 times within 60 seconds**. Caller should surface a
- *   manual "再度ログインする" UI rather than retry automatically (#2406 / #2411).
- *
- * - `'state_persistence_failed'`: `redirectToAuthorize()` could not persist
- *   the OAuth CSRF `state` (storage unavailable / quota). Redirect is aborted
- *   fail-closed (#4136) — callers should surface a manual retry UI.
- *
- * Other failure paths (SSR environment, PKCE generation failure, empty
- * organizationId) currently return `error` without a `code`. Treat this union
- * as forward-extensible and do NOT exhaustively `switch` over it without a
- * `default` branch for consumer code that must stay compatible across SDK
- * upgrades.
- */
-type FFIDRedirectErrorCode = 'redirect_loop_detected' | 'state_persistence_failed';
-/**
- * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)
- *
- * Structured return type so callers can inspect failure reasons
- * instead of receiving a bare `false`. When `code` is set, branch on it
- * for programmatic handling; otherwise log `error` for humans.
- *
- * `loopDetectionDisabled` (#4119): set to `true` when sessionStorage is
- * unavailable (iOS WebKit private mode / eviction) so redirect-loop detection
- * ran **fail-open** — the redirect fired, but repeated-redirect protection is
- * disabled for this browser session. Callers that need loop protection on
- * such browsers should add their own max-retry guard.
- */
-type FFIDRedirectResult = {
-    success: true;
-    loopDetectionDisabled?: boolean;
-} | {
-    success: false;
-    error: string;
-    code?: FFIDRedirectErrorCode;
-};
-/**
- * OAuth 2.0 token response from FFID token endpoint
- */
-interface FFIDOAuthTokenResponse {
-    access_token: string;
-    token_type: 'Bearer';
-    expires_in: number;
-    refresh_token: string;
-}
-/**
- * RFC 7662 Token Introspection response (raw format from server)
- *
- * Used internally by verifyAccessToken(). Consumers receive the normalized
- * FFIDOAuthUserInfo type instead.
- *
- * @see https://tools.ietf.org/html/rfc7662
- */
-interface FFIDTokenIntrospectionResponse {
-    active: boolean;
-    sub?: string;
-    email?: string;
-    /** Whether the user's email is verified (#3791). Optional for backward compat with older FFID. */
-    email_verified?: boolean;
-    name?: string;
-    picture?: string | null;
-    company_name?: string | null;
-    department?: string | null;
-    position?: string | null;
-    phone_number?: string | null;
-    scope?: string | null;
-    exp?: number;
-    iat?: number;
-    iss?: string;
-    token_type?: 'Bearer';
-    client_id?: string;
-    organization_id?: string | null;
-    organization_name?: string | null;
-    subscription?: {
-        subscription_id: string | null;
-        status: FFIDOAuthUserInfoSubscription['status'];
-        /** Optional for backward compat with older FFID (< 5.3.0 / #3353). */
-        effective_status?: FFIDOAuthUserInfoSubscription['effectiveStatus'];
-        plan_code: string | null;
-        seat_model: FFIDOAuthUserInfoSubscription['seatModel'];
-        member_role: FFIDOAuthUserInfoSubscription['memberRole'];
-        organization_id: string | null;
-        organization_name?: string | null;
-        has_seat_assignment?: boolean;
-    };
-}
 
 /**
  * FFID Announcements SDK Type Definitions
@@ -1602,4 +1536,4 @@ interface FFIDInquiryFormPlaceholderContext {
 }
 declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, legalLayout, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDInquiryFormSubmitData as $, type AnnouncementListResponse as A, type Announcement as B, type AnnouncementStatus as C, type AnnouncementType as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, EFFECTIVE_SUBSCRIPTION_STATUSES as G, FFIDAnnouncementBadge as H, FFIDAnnouncementList as I, type FFIDAnnouncementsError as J, type FFIDAnnouncementsErrorCode as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsServerResponse as M, type FFIDApiResponseMeta as N, type FFIDCacheConfig as O, type FFIDContextValue as P, type FFIDInquiryCategory as Q, type FFIDInquiryCategorySite2026 as R, FFIDInquiryForm as S, type TokenStore as T, type FFIDInquiryFormCategoryItem as U, type FFIDInquiryFormClassNames as V, type FFIDInquiryFormLegalLayout as W, type FFIDInquiryFormOrganization as X, type FFIDInquiryFormPlaceholderContext as Y, type FFIDInquiryFormPrefill as Z, type FFIDInquiryFormProps as _, type FFIDPrompt as a, type FFIDInquiryFormSubmitResult as a0, type FFIDJwtClaims as a1, FFIDLoginButton as a2, type FFIDOAuthTokenResponse as a3, type FFIDOAuthUserInfoMemberRole as a4, FFIDOrganizationSwitcher as a5, type FFIDRedirectErrorCode as a6, type FFIDSeatModel as a7, type FFIDServiceAccessDenialReason as a8, type FFIDServiceAccessFailPolicy as a9, FFIDSubscriptionBadge as aa, type FFIDTokenIntrospectionResponse as ab, FFIDUserMenu as ac, FFID_INQUIRY_CATEGORIES as ad, FFID_INQUIRY_CATEGORIES_SITE_2026 as ae, type TokenData as af, type UseFFIDAnnouncementsOptions as ag, type UseFFIDAnnouncementsReturn as ah, createTokenStore as ai, isFFIDInquiryCategorySite2026 as aj, useFFIDAnnouncements as ak, type FFIDAnnouncementBadgeClassNames as al, type FFIDAnnouncementBadgeProps as am, type FFIDAnnouncementListClassNames as an, type FFIDAnnouncementListProps as ao, type FFIDLoginButtonProps as ap, type FFIDOrganizationSwitcherClassNames as aq, type FFIDOrganizationSwitcherProps as ar, type FFIDSubscriptionBadgeClassNames as as, type FFIDSubscriptionBadgeProps as at, type FFIDUserMenuClassNames as au, type FFIDUserMenuProps as av, type FFIDConfig as b, type FFIDApiResponse as c, type FFIDSessionResponse as d, type FFIDSignOutResult as e, type FFIDRedirectResult as f, type FFIDError as g, type FFIDSubscriptionCheckResponse as h, type FFIDCheckServiceAccessParams as i, type FFIDServiceAccessDecision as j, type FFIDAnalyticsConfig as k, type FFIDVerifyAccessTokenOptions as l, type FFIDOAuthUserInfo as m, type FFIDInquiryCreateParams as n, type FFIDInquiryCreateResponse as o, type FFIDAuthMode as p, type FFIDLogger as q, type FFIDCacheAdapter as r, type FFIDUser as s, type FFIDOrganization as t, type FFIDSubscription as u, type FFIDSubscriptionContextValue as v, type FFIDOAuthUserInfoSubscription as w, type FFIDAnnouncementsClientConfig as x, type FFIDAnnouncementsApiResponse as y, type FFIDAnnouncementsLogger as z };
+export { type FFIDInquiryFormSubmitResult as $, type AnnouncementListResponse as A, type AnnouncementStatus as B, type AnnouncementType as C, EFFECTIVE_SUBSCRIPTION_STATUSES as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, FFIDAnnouncementBadge as G, FFIDAnnouncementList as H, type FFIDAnnouncementsError as I, type FFIDAnnouncementsErrorCode as J, type FFIDAnnouncementsServerResponse as K, type ListAnnouncementsOptions as L, type FFIDApiResponseMeta as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, type FFIDInquiryCategorySite2026 as Q, FFIDInquiryForm as R, type FFIDInquiryFormCategoryItem as S, type TokenStore as T, type FFIDInquiryFormClassNames as U, type FFIDInquiryFormLegalLayout as V, type FFIDInquiryFormOrganization as W, type FFIDInquiryFormPlaceholderContext as X, type FFIDInquiryFormPrefill as Y, type FFIDInquiryFormProps as Z, type FFIDInquiryFormSubmitData as _, type FFIDOAuthUserInfoSubscription as a, type FFIDJwtClaims as a0, FFIDLoginButton as a1, type FFIDOAuthUserInfoMemberRole as a2, FFIDOrganizationSwitcher as a3, type FFIDSeatAssignmentClaim as a4, type FFIDSeatAssignmentStatus as a5, type FFIDSeatModel as a6, type FFIDServiceAccessDenialReason as a7, type FFIDServiceAccessFailPolicy as a8, FFIDSubscriptionBadge as a9, FFIDUserMenu as aa, FFID_INQUIRY_CATEGORIES as ab, FFID_INQUIRY_CATEGORIES_SITE_2026 as ac, type TokenData as ad, type UseFFIDAnnouncementsOptions as ae, type UseFFIDAnnouncementsReturn as af, createTokenStore as ag, isFFIDInquiryCategorySite2026 as ah, useFFIDAnnouncements as ai, type FFIDAnnouncementBadgeClassNames as aj, type FFIDAnnouncementBadgeProps as ak, type FFIDAnnouncementListClassNames as al, type FFIDAnnouncementListProps as am, type FFIDLoginButtonProps as an, type FFIDOrganizationSwitcherClassNames as ao, type FFIDOrganizationSwitcherProps as ap, type FFIDSubscriptionBadgeClassNames as aq, type FFIDSubscriptionBadgeProps as ar, type FFIDUserMenuClassNames as as, type FFIDUserMenuProps as at, type FFIDPrompt as b, type FFIDConfig as c, type FFIDApiResponse as d, type FFIDSessionResponse as e, type FFIDSignOutResult as f, type FFIDError as g, type FFIDSubscriptionCheckResponse as h, type FFIDCheckServiceAccessParams as i, type FFIDServiceAccessDecision as j, type FFIDAnalyticsConfig as k, type FFIDVerifyAccessTokenOptions as l, type FFIDOAuthUserInfo as m, type FFIDInquiryCreateParams as n, type FFIDInquiryCreateResponse as o, type FFIDAuthMode as p, type FFIDLogger as q, type FFIDCacheAdapter as r, type FFIDUser as s, type FFIDOrganization as t, type FFIDSubscription as u, type FFIDSubscriptionContextValue as v, type FFIDAnnouncementsClientConfig as w, type FFIDAnnouncementsApiResponse as x, type FFIDAnnouncementsLogger as y, type Announcement as z };