@feelflow/ffid-sdk 2.5.2 → 2.6.0

package/dist/{chunk-DKWGMLCB.js → chunk-7FEWA2P2.js}

@@ -101,9 +101,15 @@ function createTokenStore(storageType) {
 }
 
 // src/client/oauth-userinfo.ts
-var VALID_SUBSCRIPTION_STATUSES = ["trialing", "active", "past_due", "canceled", "paused"];
-function isValidSubscriptionStatus(value) {
-  return VALID_SUBSCRIPTION_STATUSES.includes(value);
+var SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES = [
+  "trialing",
+  "active",
+  "past_due",
+  "canceled",
+  "paused"
+];
+function isSessionEligibleSubscriptionStatus(value) {
+  return typeof value === "string" && SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES.includes(value);
 }
 function normalizeUserinfo(raw) {
   return {
@@ -129,7 +135,7 @@ function normalizeUserinfo(raw) {
 }
 function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   const subscription = userinfo.subscription;
-  if (!subscription || !subscription.planCode || !isValidSubscriptionStatus(subscription.status)) {
+  if (!subscription || !subscription.planCode || !isSessionEligibleSubscriptionStatus(subscription.status)) {
     return [];
   }
   return [
@@ -613,7 +619,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.5.2";
+var SDK_VERSION = "2.6.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/{chunk-ZBBRUQGX.cjs → chunk-ZORI5YFR.cjs}

@@ -103,9 +103,15 @@ function createTokenStore(storageType) {
 }
 
 // src/client/oauth-userinfo.ts
-var VALID_SUBSCRIPTION_STATUSES = ["trialing", "active", "past_due", "canceled", "paused"];
-function isValidSubscriptionStatus(value) {
-  return VALID_SUBSCRIPTION_STATUSES.includes(value);
+var SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES = [
+  "trialing",
+  "active",
+  "past_due",
+  "canceled",
+  "paused"
+];
+function isSessionEligibleSubscriptionStatus(value) {
+  return typeof value === "string" && SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES.includes(value);
 }
 function normalizeUserinfo(raw) {
   return {
@@ -131,7 +137,7 @@ function normalizeUserinfo(raw) {
 }
 function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   const subscription = userinfo.subscription;
-  if (!subscription || !subscription.planCode || !isValidSubscriptionStatus(subscription.status)) {
+  if (!subscription || !subscription.planCode || !isSessionEligibleSubscriptionStatus(subscription.status)) {
     return [];
   }
   return [
@@ -615,7 +621,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.5.2";
+var SDK_VERSION = "2.6.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/components/index.cjs

@@ -1,30 +1,30 @@
 'use strict';
 
-var chunkZBBRUQGX_cjs = require('../chunk-ZBBRUQGX.cjs');
+var chunkZORI5YFR_cjs = require('../chunk-ZORI5YFR.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDLoginButton; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDUserMenu; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDUserMenu; }
 });

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-DKWGMLCB.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-7FEWA2P2.js';

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkZBBRUQGX_cjs = require('./chunk-ZBBRUQGX.cjs');
+var chunkZORI5YFR_cjs = require('./chunk-ZORI5YFR.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -46,7 +46,7 @@ function createKVCacheAdapter(kv) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkZBBRUQGX_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkZORI5YFR_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -71,83 +71,83 @@ function withFFIDAuth(Component, options = {}) {
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkZORI5YFR_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDLoginButton; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDProvider; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFIDUserMenu; }
+  get: function () { return chunkZORI5YFR_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkZORI5YFR_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkZORI5YFR_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.createFFIDClient; }
+  get: function () { return chunkZORI5YFR_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.createTokenStore; }
+  get: function () { return chunkZORI5YFR_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.generateCodeChallenge; }
+  get: function () { return chunkZORI5YFR_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.generateCodeVerifier; }
+  get: function () { return chunkZORI5YFR_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkZORI5YFR_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.storeCodeVerifier; }
+  get: function () { return chunkZORI5YFR_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.useFFID; }
+  get: function () { return chunkZORI5YFR_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkZORI5YFR_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.useSubscription; }
+  get: function () { return chunkZORI5YFR_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkZBBRUQGX_cjs.withSubscription; }
+  get: function () { return chunkZORI5YFR_cjs.withSubscription; }
 });
 exports.createKVCacheAdapter = createKVCacheAdapter;
 exports.createMemoryCacheAdapter = createMemoryCacheAdapter;

package/dist/index.d.cts

@@ -94,6 +94,11 @@ declare function retrieveCodeVerifier(logger?: PKCELogger): string | null;
 
 /** 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;
@@ -285,27 +290,56 @@ 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 total for the current quantity (unitPrice × quantity), not per-seat. */
+    currentPlan: {
+        name: string;
+        price: number;
+    };
+    /** New plan display info. `price` is the total for the effective quantity (unitPrice × quantity), not per-seat. */
+    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.
+ *
+ * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
+ * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
+ *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
+ *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
+ * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
+ *   (possibly Stripe-refined) day-basis difference.
+ */
+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;
+    /** Prorated difference charged within the current billing period */
+    proratedAmount: number;
+});
 /** Response from plan change preview endpoint */
 interface FFIDPlanChangePreviewResponse {
-    preview: {
-        currentPlan: {
-            name: string;
-            price: number;
-        };
-        newPlan: {
-            name: string;
-            price: number;
-        };
-        billingInterval: FFIDBillingInterval;
-        isUpgrade: boolean;
-        proratedAmount: number;
-        nextInvoiceAmount: number;
-        nextInvoiceDate: string | null;
-        currency: string;
-        isEstimate: boolean;
-        estimateReason?: string;
-        lineItems: FFIDPlanChangeLineItem[];
-    };
+    preview: FFIDPlanChangePreview;
 }
 
 /** OTP / magic link methods - sendOtp / verifyOtp */
@@ -729,4 +763,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.d.ts

@@ -94,6 +94,11 @@ declare function retrieveCodeVerifier(logger?: PKCELogger): string | null;
 
 /** 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;
@@ -285,27 +290,56 @@ 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 total for the current quantity (unitPrice × quantity), not per-seat. */
+    currentPlan: {
+        name: string;
+        price: number;
+    };
+    /** New plan display info. `price` is the total for the effective quantity (unitPrice × quantity), not per-seat. */
+    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.
+ *
+ * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
+ * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
+ *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
+ *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
+ * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
+ *   (possibly Stripe-refined) day-basis difference.
+ */
+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;
+    /** Prorated difference charged within the current billing period */
+    proratedAmount: number;
+});
 /** Response from plan change preview endpoint */
 interface FFIDPlanChangePreviewResponse {
-    preview: {
-        currentPlan: {
-            name: string;
-            price: number;
-        };
-        newPlan: {
-            name: string;
-            price: number;
-        };
-        billingInterval: FFIDBillingInterval;
-        isUpgrade: boolean;
-        proratedAmount: number;
-        nextInvoiceAmount: number;
-        nextInvoiceDate: string | null;
-        currency: string;
-        isEstimate: boolean;
-        estimateReason?: string;
-        lineItems: FFIDPlanChangeLineItem[];
-    };
+    preview: FFIDPlanChangePreview;
 }
 
 /** OTP / magic link methods - sendOtp / verifyOtp */
@@ -729,4 +763,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext } from './chunk-DKWGMLCB.js';
-export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-DKWGMLCB.js';
+import { useFFIDContext } from './chunk-7FEWA2P2.js';
+export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-7FEWA2P2.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -99,9 +99,15 @@ function createTokenStore(storageType) {
 }
 
 // src/client/oauth-userinfo.ts
-var VALID_SUBSCRIPTION_STATUSES = ["trialing", "active", "past_due", "canceled", "paused"];
-function isValidSubscriptionStatus(value) {
-  return VALID_SUBSCRIPTION_STATUSES.includes(value);
+var SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES = [
+  "trialing",
+  "active",
+  "past_due",
+  "canceled",
+  "paused"
+];
+function isSessionEligibleSubscriptionStatus(value) {
+  return typeof value === "string" && SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES.includes(value);
 }
 function normalizeUserinfo(raw) {
   return {
@@ -127,7 +133,7 @@ function normalizeUserinfo(raw) {
 }
 function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   const subscription = userinfo.subscription;
-  if (!subscription || !subscription.planCode || !isValidSubscriptionStatus(subscription.status)) {
+  if (!subscription || !subscription.planCode || !isSessionEligibleSubscriptionStatus(subscription.status)) {
     return [];
   }
   return [
@@ -611,7 +617,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.5.2";
+var SDK_VERSION = "2.6.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/index.d.cts

@@ -23,6 +23,11 @@ interface FFIDCacheConfig {
 
 /** 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;
@@ -214,27 +219,56 @@ 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 total for the current quantity (unitPrice × quantity), not per-seat. */
+    currentPlan: {
+        name: string;
+        price: number;
+    };
+    /** New plan display info. `price` is the total for the effective quantity (unitPrice × quantity), not per-seat. */
+    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.
+ *
+ * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
+ * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
+ *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
+ *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
+ * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
+ *   (possibly Stripe-refined) day-basis difference.
+ */
+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;
+    /** Prorated difference charged within the current billing period */
+    proratedAmount: number;
+});
 /** Response from plan change preview endpoint */
 interface FFIDPlanChangePreviewResponse {
-    preview: {
-        currentPlan: {
-            name: string;
-            price: number;
-        };
-        newPlan: {
-            name: string;
-            price: number;
-        };
-        billingInterval: FFIDBillingInterval;
-        isUpgrade: boolean;
-        proratedAmount: number;
-        nextInvoiceAmount: number;
-        nextInvoiceDate: string | null;
-        currency: string;
-        isEstimate: boolean;
-        estimateReason?: string;
-        lineItems: FFIDPlanChangeLineItem[];
-    };
+    preview: FFIDPlanChangePreview;
 }
 
 /**

package/dist/server/index.d.ts

@@ -23,6 +23,11 @@ interface FFIDCacheConfig {
 
 /** 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;
@@ -214,27 +219,56 @@ 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 total for the current quantity (unitPrice × quantity), not per-seat. */
+    currentPlan: {
+        name: string;
+        price: number;
+    };
+    /** New plan display info. `price` is the total for the effective quantity (unitPrice × quantity), not per-seat. */
+    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.
+ *
+ * `willApplyAtPeriodEnd` is a discriminant that constrains related fields at the type level:
+ * - `true`: period-end-deferred downgrade. `proratedAmount` is always 0; `effectiveDate` mirrors
+ *   the subscription's `currentPeriodEnd` (may be `null` when the subscription has no active
+ *   billing cycle yet — e.g. a pre-Stripe trial or a subscription whose billing cycle is unset).
+ * - `false`: immediate change. `effectiveDate` is always `null`; `proratedAmount` is the live
+ *   (possibly Stripe-refined) day-basis difference.
+ */
+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;
+    /** Prorated difference charged within the current billing period */
+    proratedAmount: number;
+});
 /** Response from plan change preview endpoint */
 interface FFIDPlanChangePreviewResponse {
-    preview: {
-        currentPlan: {
-            name: string;
-            price: number;
-        };
-        newPlan: {
-            name: string;
-            price: number;
-        };
-        billingInterval: FFIDBillingInterval;
-        isUpgrade: boolean;
-        proratedAmount: number;
-        nextInvoiceAmount: number;
-        nextInvoiceDate: string | null;
-        currency: string;
-        isEstimate: boolean;
-        estimateReason?: string;
-        lineItems: FFIDPlanChangeLineItem[];
-    };
+    preview: FFIDPlanChangePreview;
 }
 
 /**

package/dist/server/index.js

@@ -98,9 +98,15 @@ function createTokenStore(storageType) {
 }
 
 // src/client/oauth-userinfo.ts
-var VALID_SUBSCRIPTION_STATUSES = ["trialing", "active", "past_due", "canceled", "paused"];
-function isValidSubscriptionStatus(value) {
-  return VALID_SUBSCRIPTION_STATUSES.includes(value);
+var SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES = [
+  "trialing",
+  "active",
+  "past_due",
+  "canceled",
+  "paused"
+];
+function isSessionEligibleSubscriptionStatus(value) {
+  return typeof value === "string" && SESSION_ELIGIBLE_SUBSCRIPTION_STATUSES.includes(value);
 }
 function normalizeUserinfo(raw) {
   return {
@@ -126,7 +132,7 @@ function normalizeUserinfo(raw) {
 }
 function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   const subscription = userinfo.subscription;
-  if (!subscription || !subscription.planCode || !isValidSubscriptionStatus(subscription.status)) {
+  if (!subscription || !subscription.planCode || !isSessionEligibleSubscriptionStatus(subscription.status)) {
     return [];
   }
   return [
@@ -610,7 +616,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.5.2";
+var SDK_VERSION = "2.6.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelflow/ffid-sdk",
-  "version": "2.5.2",
+  "version": "2.6.0",
   "description": "FeelFlow ID Platform SDK for React/Next.js applications",
   "keywords": [
     "feelflow",
@@ -97,6 +97,7 @@
   "devDependencies": {
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^16.0.0",
+    "@types/node": "^22.19.17",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@typescript-eslint/eslint-plugin": "^8.58.0",