@feelflow/ffid-sdk 5.5.0 → 5.7.0

package/dist/{chunk-JKP3MBTT.cjs → chunk-FXIDKFXQ.cjs}

@@ -842,7 +842,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.5.0";
+var SDK_VERSION = "5.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -2247,7 +2247,7 @@ function isExpired(isoTimestamp, nowMs) {
   return parsed < nowMs;
 }
 function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
-  const { status, currentPeriodEnd, trialEnd, pastDueSince } = input;
+  const { status, currentPeriodEnd, trialEnd, pastDueSince, cancelAtPeriodEnd = false } = input;
   switch (status) {
     case "trialing": {
       const relevantEnd = trialEnd ?? currentPeriodEnd;
@@ -2256,7 +2256,8 @@ function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
     }
     case "active": {
       const expired = isExpired(currentPeriodEnd, nowMs);
-      return expired === true ? "expired" : "active";
+      if (expired === true) return "expired";
+      return cancelAtPeriodEnd ? "active_canceling" : "active";
     }
     case "past_due": {
       const baselineIso = pastDueSince ?? currentPeriodEnd;
@@ -2285,6 +2286,7 @@ function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
 // src/subscriptions/userinfo-helpers.ts
 var ACCESS_GRANTING_EFFECTIVE_STATUSES = [
   "active",
+  "active_canceling",
   "past_due_grace"
 ];
 var BLOCKING_EFFECTIVE_STATUSES = [
@@ -2338,6 +2340,12 @@ var EXT_CHECK_ENDPOINT = "/api/v1/subscriptions/ext/check";
 var DEFAULT_ALLOW_GRACE = true;
 var DEFAULT_SERVICE_ACCESS_FAIL_POLICY = "failClosed";
 var SERVICE_ACCESS_DENIED_CODE = "SERVICE_ACCESS_DENIED";
+var DENIAL_REASON_BY_DENYING_STATUS = {
+  blocked: "blocked",
+  canceled: "canceled",
+  expired: "expired",
+  trial_expired: "trial_expired"
+};
 function resolveServiceAccessDenialReason(params, allowGrace) {
   if (params.hasAccess) {
     return null;
@@ -2348,10 +2356,10 @@ function resolveServiceAccessDenialReason(params, allowGrace) {
   if (params.isGrace && !allowGrace) {
     return "grace_disallowed";
   }
-  if (params.effectiveStatus === "active" || params.effectiveStatus === "past_due_grace") {
+  if (ACCESS_GRANTING_EFFECTIVE_STATUSES.includes(params.effectiveStatus)) {
     return "blocked";
   }
-  return params.effectiveStatus;
+  return DENIAL_REASON_BY_DENYING_STATUS[params.effectiveStatus];
 }
 function toServiceAccessDecision(response, allowGrace) {
   const effectiveStatus = response.effectiveStatus ?? null;
@@ -3522,6 +3530,7 @@ function FFIDOrganizationSwitcher({
 }
 var ACCESS_GRANTING_STATUSES = [
   "active",
+  "active_canceling",
   "past_due_grace"
 ];
 var BLOCKING_STATUSES = [
@@ -3558,7 +3567,8 @@ function useSubscription() {
       //   のため `computeEffectiveStatusFromSession` 内で currentPeriodEnd を
       //   fallback に使う (Stripe は period end 近辺で past_due にする)。
       //   Canonical な verdict が必要な consumer は `/ext/check` を直接呼ぶ。
-      pastDueSince: void 0
+      pastDueSince: void 0,
+      cancelAtPeriodEnd: subscription.cancelAtPeriodEnd
     });
   }, [subscription]);
   const isGrace = effectiveStatus === "past_due_grace";

package/dist/{chunk-WNYMSUHN.js → chunk-YAJN36SD.js}

@@ -840,7 +840,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.5.0";
+var SDK_VERSION = "5.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -2245,7 +2245,7 @@ function isExpired(isoTimestamp, nowMs) {
   return parsed < nowMs;
 }
 function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
-  const { status, currentPeriodEnd, trialEnd, pastDueSince } = input;
+  const { status, currentPeriodEnd, trialEnd, pastDueSince, cancelAtPeriodEnd = false } = input;
   switch (status) {
     case "trialing": {
       const relevantEnd = trialEnd ?? currentPeriodEnd;
@@ -2254,7 +2254,8 @@ function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
     }
     case "active": {
       const expired = isExpired(currentPeriodEnd, nowMs);
-      return expired === true ? "expired" : "active";
+      if (expired === true) return "expired";
+      return cancelAtPeriodEnd ? "active_canceling" : "active";
     }
     case "past_due": {
       const baselineIso = pastDueSince ?? currentPeriodEnd;
@@ -2283,6 +2284,7 @@ function computeEffectiveStatusFromSession(input, nowMs = Date.now()) {
 // src/subscriptions/userinfo-helpers.ts
 var ACCESS_GRANTING_EFFECTIVE_STATUSES = [
   "active",
+  "active_canceling",
   "past_due_grace"
 ];
 var BLOCKING_EFFECTIVE_STATUSES = [
@@ -2336,6 +2338,12 @@ var EXT_CHECK_ENDPOINT = "/api/v1/subscriptions/ext/check";
 var DEFAULT_ALLOW_GRACE = true;
 var DEFAULT_SERVICE_ACCESS_FAIL_POLICY = "failClosed";
 var SERVICE_ACCESS_DENIED_CODE = "SERVICE_ACCESS_DENIED";
+var DENIAL_REASON_BY_DENYING_STATUS = {
+  blocked: "blocked",
+  canceled: "canceled",
+  expired: "expired",
+  trial_expired: "trial_expired"
+};
 function resolveServiceAccessDenialReason(params, allowGrace) {
   if (params.hasAccess) {
     return null;
@@ -2346,10 +2354,10 @@ function resolveServiceAccessDenialReason(params, allowGrace) {
   if (params.isGrace && !allowGrace) {
     return "grace_disallowed";
   }
-  if (params.effectiveStatus === "active" || params.effectiveStatus === "past_due_grace") {
+  if (ACCESS_GRANTING_EFFECTIVE_STATUSES.includes(params.effectiveStatus)) {
     return "blocked";
   }
-  return params.effectiveStatus;
+  return DENIAL_REASON_BY_DENYING_STATUS[params.effectiveStatus];
 }
 function toServiceAccessDecision(response, allowGrace) {
   const effectiveStatus = response.effectiveStatus ?? null;
@@ -3520,6 +3528,7 @@ function FFIDOrganizationSwitcher({
 }
 var ACCESS_GRANTING_STATUSES = [
   "active",
+  "active_canceling",
   "past_due_grace"
 ];
 var BLOCKING_STATUSES = [
@@ -3556,7 +3565,8 @@ function useSubscription() {
       //   のため `computeEffectiveStatusFromSession` 内で currentPeriodEnd を
       //   fallback に使う (Stripe は period end 近辺で past_due にする)。
       //   Canonical な verdict が必要な consumer は `/ext/check` を直接呼ぶ。
-      pastDueSince: void 0
+      pastDueSince: void 0,
+      cancelAtPeriodEnd: subscription.cancelAtPeriodEnd
     });
   }, [subscription]);
   const isGrace = effectiveStatus === "past_due_grace";

package/dist/components/index.cjs

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

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { T as FFIDAnnouncementBadge, av as FFIDAnnouncementBadgeClassNames, aw as FFIDAnnouncementBadgeProps, U as FFIDAnnouncementList, ax as FFIDAnnouncementListClassNames, ay as FFIDAnnouncementListProps, a1 as FFIDInquiryForm, a2 as FFIDInquiryFormCategoryItem, a3 as FFIDInquiryFormClassNames, a4 as FFIDInquiryFormLegalLayout, a5 as FFIDInquiryFormOrganization, a6 as FFIDInquiryFormPlaceholderContext, a7 as FFIDInquiryFormPrefill, a8 as FFIDInquiryFormProps, a9 as FFIDInquiryFormSubmitData, aa as FFIDInquiryFormSubmitResult, ac as FFIDLoginButton, az as FFIDLoginButtonProps, ah as FFIDOrganizationSwitcher, aA as FFIDOrganizationSwitcherClassNames, aB as FFIDOrganizationSwitcherProps, am as FFIDSubscriptionBadge, aC as FFIDSubscriptionBadgeClassNames, aD as FFIDSubscriptionBadgeProps, ao as FFIDUserMenu, aE as FFIDUserMenuClassNames, aF as FFIDUserMenuProps } from '../index-lAvUS_oz.cjs';
+export { M as FFIDAnnouncementBadge, al as FFIDAnnouncementBadgeClassNames, am as FFIDAnnouncementBadgeProps, N as FFIDAnnouncementList, an as FFIDAnnouncementListClassNames, ao as FFIDAnnouncementListProps, V as FFIDInquiryForm, W as FFIDInquiryFormCategoryItem, X as FFIDInquiryFormClassNames, Y as FFIDInquiryFormLegalLayout, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, ap as FFIDLoginButtonProps, a7 as FFIDOrganizationSwitcher, aq as FFIDOrganizationSwitcherClassNames, ar as FFIDOrganizationSwitcherProps, ac as FFIDSubscriptionBadge, as as FFIDSubscriptionBadgeClassNames, at as FFIDSubscriptionBadgeProps, ae as FFIDUserMenu, au as FFIDUserMenuClassNames, av as FFIDUserMenuProps } from '../index-EFp_ZgK9.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { T as FFIDAnnouncementBadge, av as FFIDAnnouncementBadgeClassNames, aw as FFIDAnnouncementBadgeProps, U as FFIDAnnouncementList, ax as FFIDAnnouncementListClassNames, ay as FFIDAnnouncementListProps, a1 as FFIDInquiryForm, a2 as FFIDInquiryFormCategoryItem, a3 as FFIDInquiryFormClassNames, a4 as FFIDInquiryFormLegalLayout, a5 as FFIDInquiryFormOrganization, a6 as FFIDInquiryFormPlaceholderContext, a7 as FFIDInquiryFormPrefill, a8 as FFIDInquiryFormProps, a9 as FFIDInquiryFormSubmitData, aa as FFIDInquiryFormSubmitResult, ac as FFIDLoginButton, az as FFIDLoginButtonProps, ah as FFIDOrganizationSwitcher, aA as FFIDOrganizationSwitcherClassNames, aB as FFIDOrganizationSwitcherProps, am as FFIDSubscriptionBadge, aC as FFIDSubscriptionBadgeClassNames, aD as FFIDSubscriptionBadgeProps, ao as FFIDUserMenu, aE as FFIDUserMenuClassNames, aF as FFIDUserMenuProps } from '../index-lAvUS_oz.js';
+export { M as FFIDAnnouncementBadge, al as FFIDAnnouncementBadgeClassNames, am as FFIDAnnouncementBadgeProps, N as FFIDAnnouncementList, an as FFIDAnnouncementListClassNames, ao as FFIDAnnouncementListProps, V as FFIDInquiryForm, W as FFIDInquiryFormCategoryItem, X as FFIDInquiryFormClassNames, Y as FFIDInquiryFormLegalLayout, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, ap as FFIDLoginButtonProps, a7 as FFIDOrganizationSwitcher, aq as FFIDOrganizationSwitcherClassNames, ar as FFIDOrganizationSwitcherProps, ac as FFIDSubscriptionBadge, as as FFIDSubscriptionBadgeClassNames, at as FFIDSubscriptionBadgeProps, ae as FFIDUserMenu, au as FFIDUserMenuClassNames, av as FFIDUserMenuProps } from '../index-EFp_ZgK9.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

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

package/dist/{ffid-client-CARfFhtf.d.cts → ffid-client-C0k2PTbO.d.ts}

@@ -1,4 +1,4 @@
-import { E as EffectiveSubscriptionStatus } from './types-5g_Bg6Ey.cjs';
+import { E as EffectiveSubscriptionStatus } from './types-s3y11uT6.js';
 
 /**
  * Inquiry types exposed by the FFID SDK.
@@ -576,6 +576,67 @@ interface FFIDSeatChangePreviewResponse {
     preview: FFIDSeatChangePreview;
 }
 
+/** Member role in an organization */
+type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
+/** Member role assignable through organization member management APIs */
+type FFIDAssignableMemberRole = Exclude<FFIDMemberRole, 'owner'>;
+/** Member status in an organization */
+type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
+/** Organization member returned by the ext members API */
+interface FFIDOrganizationMember {
+    /** User ID (UUID) */
+    userId: string;
+    /** Email address */
+    email: string;
+    /** Display name */
+    displayName: string | null;
+    /** Avatar URL */
+    avatarUrl: string | null;
+    /** Role in the organization */
+    role: FFIDMemberRole;
+    /** Membership status */
+    status: FFIDMemberStatus;
+    /**
+     * Whether the member's email address is confirmed.
+     *
+     * `null` means FFID could not determine the auth user confirmation state
+     * (for example, the auth user row was not readable).
+     */
+    emailVerified: boolean | null;
+    /** When the user joined */
+    joinedAt: string | null;
+    /** When the user was invited */
+    invitedAt: string | null;
+    /** Last sign-in timestamp */
+    lastSignInAt: string | null;
+}
+/** Response from listMembers (ext) */
+interface FFIDListMembersResponse {
+    organizationId: string;
+    members: FFIDOrganizationMember[];
+}
+/** Request body for addMember (ext) */
+interface FFIDAddMemberRequest {
+    email: string;
+    role?: FFIDAssignableMemberRole;
+}
+/** Params object for addMember (ext), matching the existing organization members methods */
+interface FFIDAddMemberParams extends FFIDAddMemberRequest {
+    organizationId: string;
+}
+/** Response from addMember (ext) */
+interface FFIDAddMemberResponse {
+    member: FFIDOrganizationMember;
+}
+/** Response from updateMemberRole (ext) */
+interface FFIDUpdateMemberRoleResponse {
+    member: FFIDOrganizationMember;
+}
+/** Response from removeMember (ext) */
+interface FFIDRemoveMemberResponse {
+    message: string;
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -663,6 +724,16 @@ interface FFIDSubscription {
     currentPeriodEnd: string | null;
     /** Trial end date (null if not a trial or no trial_end set) */
     trialEnd: string | null;
+    /**
+     * Whether the subscription is scheduled to cancel at the end of the current
+     * billing period (Stripe `cancel_at_period_end`). Optional for backward
+     * compatibility with FFID backends that pre-date #3460 — when absent,
+     * `useSubscription` treats the value as `false` and surfaces plain `active`.
+     * When `true` and the period has not yet ended, `effectiveStatus` becomes
+     * `active_canceling` so consumers can render a cancellation-scheduled badge
+     * + reactivation CTA without losing access.
+     */
+    cancelAtPeriodEnd?: boolean;
     /** Service seat model (available when sourced from OAuth userinfo) */
     seatModel?: FFIDSeatModel | undefined;
     /** Member role in the resolved organization context */
@@ -900,59 +971,6 @@ interface FFIDCreatePortalParams {
     returnUrl: string;
 }
 
-/** Member role in an organization */
-type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
-/** Member role assignable through organization member management APIs */
-type FFIDAssignableMemberRole = Exclude<FFIDMemberRole, 'owner'>;
-/** Member status in an organization */
-type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
-/** Organization member returned by the ext members API */
-interface FFIDOrganizationMember {
-    /** User ID (UUID) */
-    userId: string;
-    /** Email address */
-    email: string;
-    /** Display name */
-    displayName: string | null;
-    /** Avatar URL */
-    avatarUrl: string | null;
-    /** Role in the organization */
-    role: FFIDMemberRole;
-    /** Membership status */
-    status: FFIDMemberStatus;
-    /** When the user joined */
-    joinedAt: string | null;
-    /** When the user was invited */
-    invitedAt: string | null;
-    /** Last sign-in timestamp */
-    lastSignInAt: string | null;
-}
-/** Response from listMembers (ext) */
-interface FFIDListMembersResponse {
-    organizationId: string;
-    members: FFIDOrganizationMember[];
-}
-/** Request body for addMember (ext) */
-interface FFIDAddMemberRequest {
-    email: string;
-    role?: FFIDAssignableMemberRole;
-}
-/** Params object for addMember (ext), matching the existing organization members methods */
-interface FFIDAddMemberParams extends FFIDAddMemberRequest {
-    organizationId: string;
-}
-/** Response from addMember (ext) */
-interface FFIDAddMemberResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from updateMemberRole (ext) */
-interface FFIDUpdateMemberRoleResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from removeMember (ext) */
-interface FFIDRemoveMemberResponse {
-    message: string;
-}
 /**
  * User profile for the authenticated user (returned by `getProfile` / `updateProfile`).
  *

package/dist/{ffid-client-w1s-JnFf.d.ts → ffid-client-CknwTgly.d.cts}

@@ -1,4 +1,4 @@
-import { E as EffectiveSubscriptionStatus } from './types-5g_Bg6Ey.js';
+import { E as EffectiveSubscriptionStatus } from './types-s3y11uT6.cjs';
 
 /**
  * Inquiry types exposed by the FFID SDK.
@@ -576,6 +576,67 @@ interface FFIDSeatChangePreviewResponse {
     preview: FFIDSeatChangePreview;
 }
 
+/** Member role in an organization */
+type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
+/** Member role assignable through organization member management APIs */
+type FFIDAssignableMemberRole = Exclude<FFIDMemberRole, 'owner'>;
+/** Member status in an organization */
+type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
+/** Organization member returned by the ext members API */
+interface FFIDOrganizationMember {
+    /** User ID (UUID) */
+    userId: string;
+    /** Email address */
+    email: string;
+    /** Display name */
+    displayName: string | null;
+    /** Avatar URL */
+    avatarUrl: string | null;
+    /** Role in the organization */
+    role: FFIDMemberRole;
+    /** Membership status */
+    status: FFIDMemberStatus;
+    /**
+     * Whether the member's email address is confirmed.
+     *
+     * `null` means FFID could not determine the auth user confirmation state
+     * (for example, the auth user row was not readable).
+     */
+    emailVerified: boolean | null;
+    /** When the user joined */
+    joinedAt: string | null;
+    /** When the user was invited */
+    invitedAt: string | null;
+    /** Last sign-in timestamp */
+    lastSignInAt: string | null;
+}
+/** Response from listMembers (ext) */
+interface FFIDListMembersResponse {
+    organizationId: string;
+    members: FFIDOrganizationMember[];
+}
+/** Request body for addMember (ext) */
+interface FFIDAddMemberRequest {
+    email: string;
+    role?: FFIDAssignableMemberRole;
+}
+/** Params object for addMember (ext), matching the existing organization members methods */
+interface FFIDAddMemberParams extends FFIDAddMemberRequest {
+    organizationId: string;
+}
+/** Response from addMember (ext) */
+interface FFIDAddMemberResponse {
+    member: FFIDOrganizationMember;
+}
+/** Response from updateMemberRole (ext) */
+interface FFIDUpdateMemberRoleResponse {
+    member: FFIDOrganizationMember;
+}
+/** Response from removeMember (ext) */
+interface FFIDRemoveMemberResponse {
+    message: string;
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -663,6 +724,16 @@ interface FFIDSubscription {
     currentPeriodEnd: string | null;
     /** Trial end date (null if not a trial or no trial_end set) */
     trialEnd: string | null;
+    /**
+     * Whether the subscription is scheduled to cancel at the end of the current
+     * billing period (Stripe `cancel_at_period_end`). Optional for backward
+     * compatibility with FFID backends that pre-date #3460 — when absent,
+     * `useSubscription` treats the value as `false` and surfaces plain `active`.
+     * When `true` and the period has not yet ended, `effectiveStatus` becomes
+     * `active_canceling` so consumers can render a cancellation-scheduled badge
+     * + reactivation CTA without losing access.
+     */
+    cancelAtPeriodEnd?: boolean;
     /** Service seat model (available when sourced from OAuth userinfo) */
     seatModel?: FFIDSeatModel | undefined;
     /** Member role in the resolved organization context */
@@ -900,59 +971,6 @@ interface FFIDCreatePortalParams {
     returnUrl: string;
 }
 
-/** Member role in an organization */
-type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
-/** Member role assignable through organization member management APIs */
-type FFIDAssignableMemberRole = Exclude<FFIDMemberRole, 'owner'>;
-/** Member status in an organization */
-type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
-/** Organization member returned by the ext members API */
-interface FFIDOrganizationMember {
-    /** User ID (UUID) */
-    userId: string;
-    /** Email address */
-    email: string;
-    /** Display name */
-    displayName: string | null;
-    /** Avatar URL */
-    avatarUrl: string | null;
-    /** Role in the organization */
-    role: FFIDMemberRole;
-    /** Membership status */
-    status: FFIDMemberStatus;
-    /** When the user joined */
-    joinedAt: string | null;
-    /** When the user was invited */
-    invitedAt: string | null;
-    /** Last sign-in timestamp */
-    lastSignInAt: string | null;
-}
-/** Response from listMembers (ext) */
-interface FFIDListMembersResponse {
-    organizationId: string;
-    members: FFIDOrganizationMember[];
-}
-/** Request body for addMember (ext) */
-interface FFIDAddMemberRequest {
-    email: string;
-    role?: FFIDAssignableMemberRole;
-}
-/** Params object for addMember (ext), matching the existing organization members methods */
-interface FFIDAddMemberParams extends FFIDAddMemberRequest {
-    organizationId: string;
-}
-/** Response from addMember (ext) */
-interface FFIDAddMemberResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from updateMemberRole (ext) */
-interface FFIDUpdateMemberRoleResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from removeMember (ext) */
-interface FFIDRemoveMemberResponse {
-    message: string;
-}
 /**
  * User profile for the authenticated user (returned by `getProfile` / `updateProfile`).
  *

package/dist/{index-lAvUS_oz.d.cts → index-EFp_ZgK9.d.cts}

@@ -41,6 +41,10 @@ interface FFIDCacheConfig {
  * branch on a single value:
  *
  * - `active` — normal paying subscription; grant full access.
+ * - `active_canceling` — paying subscription with `cancel_at_period_end=true`.
+ *   Access stays live until `currentPeriodEnd`; callers SHOULD surface a
+ *   "cancellation scheduled" badge and a reactivation CTA. Session-only
+ *   refinement of `active` — see the asymmetry note below.
  * - `past_due_grace` — payment failed but FFID is still retrying. Service
  *   SHOULD keep access and surface a recovery banner.
  * - `blocked` — payment dunning exhausted (`past_due` over grace,
@@ -53,10 +57,27 @@ interface FFIDCacheConfig {
  *   This is the FFID-internal runtime-expired case (see
  *   `getEffectiveSubscriptionStatus` on the server). Deny access.
  *
+ * **SDK / server asymmetry — `active_canceling` is session-only (#3460).**
+ * The backend `EffectiveSubscriptionStatus` in
+ * `src/lib/common/subscription-helpers.ts` does NOT currently include
+ * `active_canceling`; cancellation-scheduled subscriptions surface as plain
+ * `'active'` on `/api/v1/subscriptions/ext/check` and `/oauth/userinfo`, and
+ * consumers that branch on the server verdict will not see the new literal.
+ * The SDK enriches `computeEffectiveStatusFromSession` with
+ * `cancelAtPeriodEnd` (carried on `FFIDSubscription` for FFID backends from
+ * #3460 onward — older backends omit the field and the helper defaults to
+ * `false`, preserving the pre-#3460 `'active'` verdict) so `useSubscription`
+ * can surface a "cancellation scheduled" badge without waiting for an
+ * `/ext/check` round-trip. The asymmetry is safe because the new literal is
+ * access-granting (no security regression on the userinfo path); when the
+ * server's `EffectiveSubscriptionStatus` is later extended to emit
+ * `active_canceling`, this docstring MUST be updated to drop the
+ * session-only note.
+ *
  * @see /api/v1/subscriptions/ext/check
  * @see docs/03-implementation/EXPIRED_CONTRACT_HANDLING.md
  */
-type EffectiveSubscriptionStatus = 'active' | 'past_due_grace' | 'blocked' | 'canceled' | 'trial_expired' | 'expired';
+type EffectiveSubscriptionStatus = 'active' | 'active_canceling' | 'past_due_grace' | 'blocked' | 'canceled' | 'trial_expired' | 'expired';
 
 /**
  * Canonical service-access types for subscription lifecycle decisions.
@@ -230,6 +251,16 @@ interface FFIDSubscription {
     currentPeriodEnd: string | null;
     /** Trial end date (null if not a trial or no trial_end set) */
     trialEnd: string | null;
+    /**
+     * Whether the subscription is scheduled to cancel at the end of the current
+     * billing period (Stripe `cancel_at_period_end`). Optional for backward
+     * compatibility with FFID backends that pre-date #3460 — when absent,
+     * `useSubscription` treats the value as `false` and surfaces plain `active`.
+     * When `true` and the period has not yet ended, `effectiveStatus` becomes
+     * `active_canceling` so consumers can render a cancellation-scheduled badge
+     * + reactivation CTA without losing access.
+     */
+    cancelAtPeriodEnd?: boolean;
     /** Service seat model (available when sourced from OAuth userinfo) */
     seatModel?: FFIDSeatModel | undefined;
     /** Member role in the resolved organization context */
@@ -606,59 +637,6 @@ interface FFIDCreatePortalParams {
     returnUrl: string;
 }
 
-/** Member role in an organization */
-type FFIDMemberRole = 'owner' | 'admin' | 'member' | 'viewer';
-/** Member role assignable through organization member management APIs */
-type FFIDAssignableMemberRole = Exclude<FFIDMemberRole, 'owner'>;
-/** Member status in an organization */
-type FFIDMemberStatus = 'active' | 'invited' | 'suspended';
-/** Organization member returned by the ext members API */
-interface FFIDOrganizationMember {
-    /** User ID (UUID) */
-    userId: string;
-    /** Email address */
-    email: string;
-    /** Display name */
-    displayName: string | null;
-    /** Avatar URL */
-    avatarUrl: string | null;
-    /** Role in the organization */
-    role: FFIDMemberRole;
-    /** Membership status */
-    status: FFIDMemberStatus;
-    /** When the user joined */
-    joinedAt: string | null;
-    /** When the user was invited */
-    invitedAt: string | null;
-    /** Last sign-in timestamp */
-    lastSignInAt: string | null;
-}
-/** Response from listMembers (ext) */
-interface FFIDListMembersResponse {
-    organizationId: string;
-    members: FFIDOrganizationMember[];
-}
-/** Request body for addMember (ext) */
-interface FFIDAddMemberRequest {
-    email: string;
-    role?: FFIDAssignableMemberRole;
-}
-/** Params object for addMember (ext), matching the existing organization members methods */
-interface FFIDAddMemberParams extends FFIDAddMemberRequest {
-    organizationId: string;
-}
-/** Response from addMember (ext) */
-interface FFIDAddMemberResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from updateMemberRole (ext) */
-interface FFIDUpdateMemberRoleResponse {
-    member: FFIDOrganizationMember;
-}
-/** Response from removeMember (ext) */
-interface FFIDRemoveMemberResponse {
-    message: string;
-}
 /**
  * User profile for the authenticated user (returned by `getProfile` / `updateProfile`).
  *
@@ -1570,4 +1548,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 FFIDInquiryCategory as $, type FFIDInquiryCreateResponse as A, type FFIDAuthMode as B, type FFIDLogger as C, type FFIDCacheAdapter as D, type FFIDUser as E, type FFIDSubscriptionStatus as F, type FFIDOrganization as G, type FFIDSubscription as H, type FFIDSubscriptionContextValue as I, type EffectiveSubscriptionStatus as J, type FFIDOAuthUserInfoSubscription as K, type FFIDAnnouncementsClientConfig as L, type ListAnnouncementsOptions as M, type FFIDAnnouncementsApiResponse as N, type AnnouncementListResponse as O, type FFIDAnnouncementsLogger as P, type Announcement as Q, type AnnouncementStatus as R, type AnnouncementType as S, FFIDAnnouncementBadge as T, FFIDAnnouncementList as U, type FFIDAnnouncementsError as V, type FFIDAnnouncementsErrorCode as W, type FFIDAnnouncementsServerResponse as X, type FFIDAssignableMemberRole as Y, type FFIDCacheConfig as Z, type FFIDContextValue as _, type FFIDConfig as a, type FFIDInquiryCategorySite2026 as a0, FFIDInquiryForm as a1, type FFIDInquiryFormCategoryItem as a2, type FFIDInquiryFormClassNames as a3, type FFIDInquiryFormLegalLayout as a4, type FFIDInquiryFormOrganization as a5, type FFIDInquiryFormPlaceholderContext as a6, type FFIDInquiryFormPrefill as a7, type FFIDInquiryFormProps as a8, type FFIDInquiryFormSubmitData as a9, type FFIDOrganizationSwitcherClassNames as aA, type FFIDOrganizationSwitcherProps as aB, type FFIDSubscriptionBadgeClassNames as aC, type FFIDSubscriptionBadgeProps as aD, type FFIDUserMenuClassNames as aE, type FFIDUserMenuProps as aF, type FFIDInquiryFormSubmitResult as aa, type FFIDJwtClaims as ab, FFIDLoginButton as ac, type FFIDMemberStatus as ad, type FFIDOAuthTokenResponse as ae, type FFIDOAuthUserInfoMemberRole as af, type FFIDOrganizationMember as ag, FFIDOrganizationSwitcher as ah, type FFIDRedirectErrorCode as ai, type FFIDSeatModel as aj, type FFIDServiceAccessDenialReason as ak, type FFIDServiceAccessFailPolicy as al, FFIDSubscriptionBadge as am, type FFIDTokenIntrospectionResponse as an, FFIDUserMenu as ao, FFID_INQUIRY_CATEGORIES as ap, FFID_INQUIRY_CATEGORIES_SITE_2026 as aq, type UseFFIDAnnouncementsOptions as ar, type UseFFIDAnnouncementsReturn as as, isFFIDInquiryCategorySite2026 as at, useFFIDAnnouncements as au, type FFIDAnnouncementBadgeClassNames as av, type FFIDAnnouncementBadgeProps as aw, type FFIDAnnouncementListClassNames as ax, type FFIDAnnouncementListProps as ay, type FFIDLoginButtonProps as az, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDCheckServiceAccessParams as g, type FFIDServiceAccessDecision as h, type FFIDListMembersResponse as i, type FFIDAddMemberParams as j, type FFIDAddMemberResponse as k, type FFIDAddMemberRequest as l, type FFIDMemberRole as m, type FFIDUpdateMemberRoleResponse as n, type FFIDRemoveMemberResponse as o, type FFIDProfileCallOptions as p, type FFIDUserProfile as q, type FFIDUpdateUserProfileRequest as r, type FFIDAnalyticsConfig as s, type FFIDCreateCheckoutParams as t, type FFIDCheckoutSessionResponse as u, type FFIDCreatePortalParams as v, type FFIDPortalSessionResponse as w, type FFIDVerifyAccessTokenOptions as x, type FFIDOAuthUserInfo as y, type FFIDInquiryCreateParams as z };
+export { type FFIDInquiryFormPrefill as $, type FFIDSubscriptionContextValue as A, type FFIDOAuthUserInfoSubscription as B, type FFIDAnnouncementsClientConfig as C, type FFIDAnnouncementsApiResponse as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type AnnouncementListResponse as G, type FFIDAnnouncementsLogger as H, type Announcement as I, type AnnouncementStatus as J, type AnnouncementType as K, type ListAnnouncementsOptions as L, FFIDAnnouncementBadge as M, FFIDAnnouncementList as N, type FFIDAnnouncementsError as O, type FFIDAnnouncementsErrorCode as P, type FFIDAnnouncementsServerResponse as Q, type FFIDCacheConfig as R, type FFIDContextValue as S, type FFIDInquiryCategory as T, type FFIDInquiryCategorySite2026 as U, FFIDInquiryForm as V, type FFIDInquiryFormCategoryItem as W, type FFIDInquiryFormClassNames as X, type FFIDInquiryFormLegalLayout as Y, type FFIDInquiryFormOrganization as Z, type FFIDInquiryFormPlaceholderContext as _, type FFIDConfig as a, type FFIDInquiryFormProps as a0, type FFIDInquiryFormSubmitData as a1, type FFIDInquiryFormSubmitResult as a2, type FFIDJwtClaims as a3, FFIDLoginButton as a4, type FFIDOAuthTokenResponse as a5, type FFIDOAuthUserInfoMemberRole as a6, FFIDOrganizationSwitcher as a7, type FFIDRedirectErrorCode as a8, type FFIDSeatModel as a9, type FFIDServiceAccessDenialReason as aa, type FFIDServiceAccessFailPolicy as ab, FFIDSubscriptionBadge as ac, type FFIDTokenIntrospectionResponse as ad, FFIDUserMenu as ae, FFID_INQUIRY_CATEGORIES as af, FFID_INQUIRY_CATEGORIES_SITE_2026 as ag, type UseFFIDAnnouncementsOptions as ah, type UseFFIDAnnouncementsReturn 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 FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDCheckServiceAccessParams as g, type FFIDServiceAccessDecision as h, type FFIDProfileCallOptions as i, type FFIDUserProfile as j, type FFIDUpdateUserProfileRequest as k, type FFIDAnalyticsConfig as l, type FFIDCreateCheckoutParams as m, type FFIDCheckoutSessionResponse as n, type FFIDCreatePortalParams as o, type FFIDPortalSessionResponse as p, type FFIDVerifyAccessTokenOptions as q, type FFIDOAuthUserInfo as r, type FFIDInquiryCreateParams as s, type FFIDInquiryCreateResponse as t, type FFIDAuthMode as u, type FFIDLogger as v, type FFIDCacheAdapter as w, type FFIDUser as x, type FFIDOrganization as y, type FFIDSubscription as z };