@feelflow/ffid-sdk 1.18.0 → 1.19.1

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDRedirectResult, d as FFIDError, e as FFIDSubscriptionCheckResponse, f as FFIDListMembersResponse, g as FFIDMemberRole, h as FFIDUpdateMemberRoleResponse, i as FFIDRemoveMemberResponse, j as FFIDCreateCheckoutParams, k as FFIDCheckoutSessionResponse, l as FFIDCreatePortalParams, m as FFIDPortalSessionResponse, n as FFIDVerifyAccessTokenOptions, o as FFIDOAuthUserInfo, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-BHh-uxYS.cjs';
-export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as FFIDAnnouncementBadge, E as FFIDAnnouncementList, G as FFIDAnnouncementsError, H as FFIDAnnouncementsErrorCode, I as FFIDAnnouncementsServerResponse, J as FFIDCacheConfig, K as FFIDContextValue, M as FFIDJwtClaims, N as FFIDLoginButton, O as FFIDMemberStatus, P as FFIDOAuthTokenResponse, Q as FFIDOAuthUserInfoMemberRole, R as FFIDOAuthUserInfoSubscription, S as FFIDOrganizationMember, T as FFIDOrganizationSwitcher, U as FFIDSeatModel, V as FFIDSubscriptionBadge, W as FFIDSubscriptionStatus, X as FFIDTokenIntrospectionResponse, Y as FFIDUserMenu, Z as UseFFIDAnnouncementsOptions, _ as UseFFIDAnnouncementsReturn, $ as useFFIDAnnouncements } from './index-BHh-uxYS.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDCreateCheckoutParams, l as FFIDCheckoutSessionResponse, m as FFIDCreatePortalParams, n as FFIDPortalSessionResponse, o as FFIDVerifyAccessTokenOptions, p as FFIDOAuthUserInfo, q as FFIDAuthMode, r as FFIDLogger, s as FFIDCacheAdapter, t as FFIDUser, u as FFIDOrganization, v as FFIDSubscription, w as FFIDSubscriptionContextValue, x as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, y as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, z as FFIDAnnouncementsLogger } from './index-p4dJw3qR.cjs';
+export { B as Announcement, C as AnnouncementStatus, D as AnnouncementType, E as FFIDAnnouncementBadge, G as FFIDAnnouncementList, H as FFIDAnnouncementsError, I as FFIDAnnouncementsErrorCode, J as FFIDAnnouncementsServerResponse, K as FFIDCacheConfig, M as FFIDContextValue, N as FFIDJwtClaims, O as FFIDLoginButton, P as FFIDMemberStatus, Q as FFIDOAuthTokenResponse, R as FFIDOAuthUserInfoMemberRole, S as FFIDOAuthUserInfoSubscription, T as FFIDOrganizationMember, U as FFIDOrganizationSwitcher, V as FFIDSeatModel, W as FFIDSubscriptionBadge, X as FFIDTokenIntrospectionResponse, Y as FFIDUserMenu, Z as UseFFIDAnnouncementsOptions, _ as UseFFIDAnnouncementsReturn, $ as useFFIDAnnouncements } from './index-p4dJw3qR.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -92,6 +92,193 @@ declare function storeCodeVerifier(verifier: string, logger?: PKCELogger): boole
  */
 declare function retrieveCodeVerifier(logger?: PKCELogger): string | null;
 
+/** Billing interval for subscriptions */
+type FFIDBillingInterval = 'monthly' | 'yearly';
+/** Service information returned by plans endpoint */
+interface FFIDServiceInfo {
+    id: string;
+    code: string;
+    name: string;
+    description: string | null;
+    isActive: boolean;
+    createdAt: string;
+    plans: FFIDPlanInfo[];
+}
+/** Plan information returned by plans endpoint */
+interface FFIDPlanInfo {
+    id: string;
+    serviceId: string;
+    code: string;
+    name: string;
+    description: string | null;
+    minSeats: number;
+    maxSeats: number | null;
+    trialDays: number;
+    priceMonthly: number;
+    priceYearly: number | null;
+    currency: string;
+    isActive: boolean;
+    displayOrder: number;
+    customPricing: boolean;
+    createdAt: string;
+}
+/** Response from list plans endpoint */
+interface FFIDListPlansResponse {
+    services: FFIDServiceInfo[];
+    count: number;
+}
+/** Subscription details returned by ext API (sanitized, no Stripe IDs) */
+interface FFIDSubscriptionDetail {
+    id: string;
+    organizationId: string;
+    organizationName: string;
+    serviceCode: string;
+    serviceName: string;
+    planCode: string;
+    planName: string;
+    status: FFIDSubscriptionStatus;
+    paymentMethod: string | null;
+    billingInterval: FFIDBillingInterval;
+    quantity: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    trialStart: string | null;
+    trialEnd: string | null;
+    canceledAt: string | null;
+    cancelAtPeriodEnd: boolean;
+    createdAt: string;
+}
+/** Parameters for subscribing to a plan */
+interface FFIDSubscribeParams {
+    /** Organization ID (UUID) */
+    organizationId: string;
+    /** Plan code (e.g., 'free', 'basic', 'pro') */
+    planCode: string;
+    /** Billing interval (default: 'monthly') */
+    billingInterval?: FFIDBillingInterval;
+    /** Number of seats (default: plan's minSeats) */
+    quantity?: number;
+    /** User ID for seat auto-assignment (only needed for service-key mode) */
+    userId?: string;
+}
+/** Sanitized subscription fields returned by subscribe/reactivate endpoints (no Stripe IDs) */
+interface FFIDSubscriptionSummary {
+    id: string;
+    organizationId: string;
+    serviceId: string;
+    planId: string;
+    status: FFIDSubscriptionStatus;
+    paymentMethod: string | null;
+    billingInterval: FFIDBillingInterval;
+    quantity: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    trialStart: string | null;
+    trialEnd: string | null;
+    canceledAt: string | null;
+    cancelAtPeriodEnd: boolean;
+    createdAt: string;
+}
+/** Response from subscribe endpoint */
+interface FFIDSubscribeResponse {
+    subscription: FFIDSubscriptionSummary;
+    service: {
+        id: string;
+        code: string;
+        name: string;
+    };
+    plan: {
+        id: string;
+        code: string;
+        name: string;
+        priceMonthly: number;
+        priceYearly: number | null;
+        trialDays: number;
+    };
+    /** True if a canceled subscription was reactivated */
+    reactivated?: boolean;
+    /** True if Stripe checkout is needed (canceled paid plan reactivation) */
+    needsCheckout?: boolean;
+}
+/** Parameters for changing plan */
+interface FFIDChangePlanParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** New plan code */
+    planCode: string;
+    /** New billing interval (default: keeps current) */
+    billingInterval?: FFIDBillingInterval;
+}
+/** Response from change plan endpoint */
+interface FFIDChangePlanResponse {
+    message: string;
+    subscription: {
+        id: string;
+        organizationId: string;
+        serviceCode: string;
+        planCode: string;
+        planName: string;
+        billingInterval: FFIDBillingInterval;
+        status: FFIDSubscriptionStatus;
+        isUpgrade: boolean;
+    };
+}
+/** Parameters for canceling subscription */
+interface FFIDCancelSubscriptionParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** Cancellation reason code */
+    reason?: 'too_expensive' | 'missing_features' | 'switched_service' | 'rarely_used' | 'customer_service' | 'other';
+    /** Additional cancellation details */
+    reasonDetails?: string;
+}
+/** Response from cancel subscription endpoint */
+interface FFIDCancelSubscriptionResponse {
+    message: string;
+    subscription: {
+        id: string;
+        organizationId: string;
+        status: FFIDSubscriptionStatus;
+        canceledAt: string | null;
+    };
+}
+/** Parameters for previewing plan change */
+interface FFIDPreviewPlanChangeParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** New plan code */
+    planCode: string;
+    /** New billing interval (default: keeps current) */
+    billingInterval?: FFIDBillingInterval;
+}
+/** Plan change preview line item */
+interface FFIDPlanChangeLineItem {
+    description: string;
+    amount: number;
+}
+/** 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[];
+    };
+}
+
 /** OTP / magic link methods - sendOtp / verifyOtp */
 
 /** Response from sendOtp */
@@ -151,7 +338,7 @@ declare function createFFIDClient(config: FFIDConfig): {
     exchangeCodeForTokens: (code: string, codeVerifier?: string) => Promise<FFIDApiResponse<void>>;
     refreshAccessToken: () => Promise<FFIDApiResponse<void>>;
     checkSubscription: (params: {
-        userId: string;
+        userId?: string;
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDSubscriptionCheckResponse>>;
     listMembers: (params: {
@@ -168,6 +355,12 @@ declare function createFFIDClient(config: FFIDConfig): {
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     createCheckoutSession: (params: FFIDCreateCheckoutParams) => Promise<FFIDApiResponse<FFIDCheckoutSessionResponse>>;
     createPortalSession: (params: FFIDCreatePortalParams) => Promise<FFIDApiResponse<FFIDPortalSessionResponse>>;
+    listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
+    getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
+    subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;
+    changePlan: (params: FFIDChangePlanParams) => Promise<FFIDApiResponse<FFIDChangePlanResponse>>;
+    cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
+    previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
@@ -448,4 +641,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCacheAdapter, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, 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, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, 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 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDConfig, a as FFIDApiResponse, b as FFIDSessionResponse, c as FFIDRedirectResult, d as FFIDError, e as FFIDSubscriptionCheckResponse, f as FFIDListMembersResponse, g as FFIDMemberRole, h as FFIDUpdateMemberRoleResponse, i as FFIDRemoveMemberResponse, j as FFIDCreateCheckoutParams, k as FFIDCheckoutSessionResponse, l as FFIDCreatePortalParams, m as FFIDPortalSessionResponse, n as FFIDVerifyAccessTokenOptions, o as FFIDOAuthUserInfo, p as FFIDAuthMode, q as FFIDLogger, r as FFIDCacheAdapter, s as FFIDUser, t as FFIDOrganization, u as FFIDSubscription, v as FFIDSubscriptionContextValue, w as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, x as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, y as FFIDAnnouncementsLogger } from './index-BHh-uxYS.js';
-export { z as Announcement, B as AnnouncementStatus, C as AnnouncementType, D as FFIDAnnouncementBadge, E as FFIDAnnouncementList, G as FFIDAnnouncementsError, H as FFIDAnnouncementsErrorCode, I as FFIDAnnouncementsServerResponse, J as FFIDCacheConfig, K as FFIDContextValue, M as FFIDJwtClaims, N as FFIDLoginButton, O as FFIDMemberStatus, P as FFIDOAuthTokenResponse, Q as FFIDOAuthUserInfoMemberRole, R as FFIDOAuthUserInfoSubscription, S as FFIDOrganizationMember, T as FFIDOrganizationSwitcher, U as FFIDSeatModel, V as FFIDSubscriptionBadge, W as FFIDSubscriptionStatus, X as FFIDTokenIntrospectionResponse, Y as FFIDUserMenu, Z as UseFFIDAnnouncementsOptions, _ as UseFFIDAnnouncementsReturn, $ as useFFIDAnnouncements } from './index-BHh-uxYS.js';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDCreateCheckoutParams, l as FFIDCheckoutSessionResponse, m as FFIDCreatePortalParams, n as FFIDPortalSessionResponse, o as FFIDVerifyAccessTokenOptions, p as FFIDOAuthUserInfo, q as FFIDAuthMode, r as FFIDLogger, s as FFIDCacheAdapter, t as FFIDUser, u as FFIDOrganization, v as FFIDSubscription, w as FFIDSubscriptionContextValue, x as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, y as FFIDAnnouncementsApiResponse, A as AnnouncementListResponse, z as FFIDAnnouncementsLogger } from './index-p4dJw3qR.js';
+export { B as Announcement, C as AnnouncementStatus, D as AnnouncementType, E as FFIDAnnouncementBadge, G as FFIDAnnouncementList, H as FFIDAnnouncementsError, I as FFIDAnnouncementsErrorCode, J as FFIDAnnouncementsServerResponse, K as FFIDCacheConfig, M as FFIDContextValue, N as FFIDJwtClaims, O as FFIDLoginButton, P as FFIDMemberStatus, Q as FFIDOAuthTokenResponse, R as FFIDOAuthUserInfoMemberRole, S as FFIDOAuthUserInfoSubscription, T as FFIDOrganizationMember, U as FFIDOrganizationSwitcher, V as FFIDSeatModel, W as FFIDSubscriptionBadge, X as FFIDTokenIntrospectionResponse, Y as FFIDUserMenu, Z as UseFFIDAnnouncementsOptions, _ as UseFFIDAnnouncementsReturn, $ as useFFIDAnnouncements } from './index-p4dJw3qR.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -92,6 +92,193 @@ declare function storeCodeVerifier(verifier: string, logger?: PKCELogger): boole
  */
 declare function retrieveCodeVerifier(logger?: PKCELogger): string | null;
 
+/** Billing interval for subscriptions */
+type FFIDBillingInterval = 'monthly' | 'yearly';
+/** Service information returned by plans endpoint */
+interface FFIDServiceInfo {
+    id: string;
+    code: string;
+    name: string;
+    description: string | null;
+    isActive: boolean;
+    createdAt: string;
+    plans: FFIDPlanInfo[];
+}
+/** Plan information returned by plans endpoint */
+interface FFIDPlanInfo {
+    id: string;
+    serviceId: string;
+    code: string;
+    name: string;
+    description: string | null;
+    minSeats: number;
+    maxSeats: number | null;
+    trialDays: number;
+    priceMonthly: number;
+    priceYearly: number | null;
+    currency: string;
+    isActive: boolean;
+    displayOrder: number;
+    customPricing: boolean;
+    createdAt: string;
+}
+/** Response from list plans endpoint */
+interface FFIDListPlansResponse {
+    services: FFIDServiceInfo[];
+    count: number;
+}
+/** Subscription details returned by ext API (sanitized, no Stripe IDs) */
+interface FFIDSubscriptionDetail {
+    id: string;
+    organizationId: string;
+    organizationName: string;
+    serviceCode: string;
+    serviceName: string;
+    planCode: string;
+    planName: string;
+    status: FFIDSubscriptionStatus;
+    paymentMethod: string | null;
+    billingInterval: FFIDBillingInterval;
+    quantity: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    trialStart: string | null;
+    trialEnd: string | null;
+    canceledAt: string | null;
+    cancelAtPeriodEnd: boolean;
+    createdAt: string;
+}
+/** Parameters for subscribing to a plan */
+interface FFIDSubscribeParams {
+    /** Organization ID (UUID) */
+    organizationId: string;
+    /** Plan code (e.g., 'free', 'basic', 'pro') */
+    planCode: string;
+    /** Billing interval (default: 'monthly') */
+    billingInterval?: FFIDBillingInterval;
+    /** Number of seats (default: plan's minSeats) */
+    quantity?: number;
+    /** User ID for seat auto-assignment (only needed for service-key mode) */
+    userId?: string;
+}
+/** Sanitized subscription fields returned by subscribe/reactivate endpoints (no Stripe IDs) */
+interface FFIDSubscriptionSummary {
+    id: string;
+    organizationId: string;
+    serviceId: string;
+    planId: string;
+    status: FFIDSubscriptionStatus;
+    paymentMethod: string | null;
+    billingInterval: FFIDBillingInterval;
+    quantity: number;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    trialStart: string | null;
+    trialEnd: string | null;
+    canceledAt: string | null;
+    cancelAtPeriodEnd: boolean;
+    createdAt: string;
+}
+/** Response from subscribe endpoint */
+interface FFIDSubscribeResponse {
+    subscription: FFIDSubscriptionSummary;
+    service: {
+        id: string;
+        code: string;
+        name: string;
+    };
+    plan: {
+        id: string;
+        code: string;
+        name: string;
+        priceMonthly: number;
+        priceYearly: number | null;
+        trialDays: number;
+    };
+    /** True if a canceled subscription was reactivated */
+    reactivated?: boolean;
+    /** True if Stripe checkout is needed (canceled paid plan reactivation) */
+    needsCheckout?: boolean;
+}
+/** Parameters for changing plan */
+interface FFIDChangePlanParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** New plan code */
+    planCode: string;
+    /** New billing interval (default: keeps current) */
+    billingInterval?: FFIDBillingInterval;
+}
+/** Response from change plan endpoint */
+interface FFIDChangePlanResponse {
+    message: string;
+    subscription: {
+        id: string;
+        organizationId: string;
+        serviceCode: string;
+        planCode: string;
+        planName: string;
+        billingInterval: FFIDBillingInterval;
+        status: FFIDSubscriptionStatus;
+        isUpgrade: boolean;
+    };
+}
+/** Parameters for canceling subscription */
+interface FFIDCancelSubscriptionParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** Cancellation reason code */
+    reason?: 'too_expensive' | 'missing_features' | 'switched_service' | 'rarely_used' | 'customer_service' | 'other';
+    /** Additional cancellation details */
+    reasonDetails?: string;
+}
+/** Response from cancel subscription endpoint */
+interface FFIDCancelSubscriptionResponse {
+    message: string;
+    subscription: {
+        id: string;
+        organizationId: string;
+        status: FFIDSubscriptionStatus;
+        canceledAt: string | null;
+    };
+}
+/** Parameters for previewing plan change */
+interface FFIDPreviewPlanChangeParams {
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** New plan code */
+    planCode: string;
+    /** New billing interval (default: keeps current) */
+    billingInterval?: FFIDBillingInterval;
+}
+/** Plan change preview line item */
+interface FFIDPlanChangeLineItem {
+    description: string;
+    amount: number;
+}
+/** 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[];
+    };
+}
+
 /** OTP / magic link methods - sendOtp / verifyOtp */
 
 /** Response from sendOtp */
@@ -151,7 +338,7 @@ declare function createFFIDClient(config: FFIDConfig): {
     exchangeCodeForTokens: (code: string, codeVerifier?: string) => Promise<FFIDApiResponse<void>>;
     refreshAccessToken: () => Promise<FFIDApiResponse<void>>;
     checkSubscription: (params: {
-        userId: string;
+        userId?: string;
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDSubscriptionCheckResponse>>;
     listMembers: (params: {
@@ -168,6 +355,12 @@ declare function createFFIDClient(config: FFIDConfig): {
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     createCheckoutSession: (params: FFIDCreateCheckoutParams) => Promise<FFIDApiResponse<FFIDCheckoutSessionResponse>>;
     createPortalSession: (params: FFIDCreatePortalParams) => Promise<FFIDApiResponse<FFIDPortalSessionResponse>>;
+    listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
+    getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
+    subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;
+    changePlan: (params: FFIDChangePlanParams) => Promise<FFIDApiResponse<FFIDChangePlanResponse>>;
+    cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
+    previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
@@ -448,4 +641,4 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, FFIDCacheAdapter, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, FFIDListMembersResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, FFIDPortalSessionResponse, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSessionResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, 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, DEFAULT_API_BASE_URL, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, 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 };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext } from './chunk-ZJIZTYXQ.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-ZJIZTYXQ.js';
+import { useFFIDContext } from './chunk-66HJMEHY.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-66HJMEHY.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -443,6 +443,106 @@ function createBillingMethods(deps) {
   return { createCheckoutSession, createPortalSession };
 }
 
+// src/client/subscription-methods.ts
+var EXT_PLANS_ENDPOINT = "/api/v1/subscriptions/ext/plans";
+var EXT_SUBSCRIPTION_ENDPOINT = "/api/v1/subscriptions/ext";
+var EXT_SUBSCRIBE_ENDPOINT = "/api/v1/subscriptions/ext/subscribe";
+function createSubscriptionMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function listPlans() {
+    return fetchWithAuth(EXT_PLANS_ENDPOINT);
+  }
+  async function getSubscription(subscriptionId) {
+    if (!subscriptionId) {
+      return {
+        error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    return fetchWithAuth(
+      `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(subscriptionId)}`
+    );
+  }
+  async function subscribe(params) {
+    if (!params.organizationId || !params.planCode) {
+      return {
+        error: createError("VALIDATION_ERROR", "organizationId \u3068 planCode \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    return fetchWithAuth(
+      EXT_SUBSCRIBE_ENDPOINT,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          organizationId: params.organizationId,
+          planCode: params.planCode,
+          ...params.billingInterval ? { billingInterval: params.billingInterval } : {},
+          ...params.quantity !== void 0 ? { quantity: params.quantity } : {},
+          ...params.userId ? { userId: params.userId } : {}
+        })
+      }
+    );
+  }
+  async function changePlan(params) {
+    if (!params.subscriptionId || !params.planCode) {
+      return {
+        error: createError("VALIDATION_ERROR", "subscriptionId \u3068 planCode \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    return fetchWithAuth(
+      `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(params.subscriptionId)}/plan`,
+      {
+        method: "PUT",
+        body: JSON.stringify({
+          planCode: params.planCode,
+          ...params.billingInterval ? { billingInterval: params.billingInterval } : {}
+        })
+      }
+    );
+  }
+  async function cancelSubscription(params) {
+    if (!params.subscriptionId) {
+      return {
+        error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    const body = {};
+    if (params.reason) body.reason = params.reason;
+    if (params.reasonDetails) body.reasonDetails = params.reasonDetails;
+    return fetchWithAuth(
+      `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(params.subscriptionId)}`,
+      {
+        method: "DELETE",
+        ...Object.keys(body).length > 0 ? { body: JSON.stringify(body) } : {}
+      }
+    );
+  }
+  async function previewPlanChange(params) {
+    if (!params.subscriptionId || !params.planCode) {
+      return {
+        error: createError("VALIDATION_ERROR", "subscriptionId \u3068 planCode \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    return fetchWithAuth(
+      `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(params.subscriptionId)}/plan/preview`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          planCode: params.planCode,
+          ...params.billingInterval ? { billingInterval: params.billingInterval } : {}
+        })
+      }
+    );
+  }
+  return {
+    listPlans,
+    getSubscription,
+    subscribe,
+    changePlan,
+    cancelSubscription,
+    previewPlanChange
+  };
+}
+
 // src/client/members-methods.ts
 var EXT_MEMBERS_ENDPOINT = "/api/v1/organizations/ext/members";
 function createMembersMethods(deps) {
@@ -496,7 +596,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "1.18.0";
+var SDK_VERSION = "1.19.1";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1538,16 +1638,23 @@ function createFFIDClient(config) {
     logger
   });
   async function checkSubscription(params) {
-    if (!params.userId || !params.organizationId) {
+    if (!params.organizationId) {
+      return {
+        error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    if (params.userId !== void 0 && !params.userId.trim()) {
       return {
-        error: createError("VALIDATION_ERROR", "userId \u3068 organizationId \u306F\u5FC5\u9808\u3067\u3059")
+        error: createError("VALIDATION_ERROR", "userId \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093")
       };
     }
     const query = new URLSearchParams({
-      userId: params.userId,
       organizationId: params.organizationId,
       serviceCode: config.serviceCode
     });
+    if (params.userId) {
+      query.set("userId", params.userId);
+    }
     return fetchWithAuth(
       `${EXT_CHECK_ENDPOINT}?${query.toString()}`
     );
@@ -1556,6 +1663,17 @@ function createFFIDClient(config) {
     fetchWithAuth,
     createError
   });
+  const {
+    listPlans,
+    getSubscription,
+    subscribe,
+    changePlan,
+    cancelSubscription,
+    previewPlanChange
+  } = createSubscriptionMethods({
+    fetchWithAuth,
+    createError
+  });
   const { listMembers, updateMemberRole, removeMember } = createMembersMethods({
     fetchWithAuth,
     createError,
@@ -1609,6 +1727,12 @@ function createFFIDClient(config) {
     removeMember,
     createCheckoutSession,
     createPortalSession,
+    listPlans,
+    getSubscription,
+    subscribe,
+    changePlan,
+    cancelSubscription,
+    previewPlanChange,
     verifyAccessToken,
     requestPasswordReset,
     verifyPasswordResetToken,