@feelflow/ffid-sdk 4.1.0 → 4.3.0

package/dist/{ffid-client-ZcJhRbD6.d.cts → ffid-client-BaStAONh.d.ts}

@@ -1,3 +1,5 @@
+import { E as EffectiveSubscriptionStatus } from './types-5g_Bg6Ey.js';
+
 /**
  * Inquiry types exposed by the FFID SDK.
  *
@@ -183,6 +185,91 @@ interface FFIDCacheConfig {
     ttl: number;
 }
 
+/**
+ * Canonical service-access types for subscription lifecycle decisions.
+ */
+
+/** Subscription status values matching the FFID platform's SubscriptionStatus type */
+type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+interface FFIDSubscriptionCheckResponse {
+    hasActiveSubscription: boolean;
+    /**
+     * Canonical access decision returned by FFID's `/subscriptions/ext/check`.
+     *
+     * This is the server-side source of truth for service gates. Consumers
+     * should not recompute access from `currentPeriodEnd`, `past_due_since`, or
+     * local payment timestamps.
+     */
+    hasAccess?: boolean;
+    /** True when `effectiveStatus === 'past_due_grace'`. */
+    isGrace?: boolean;
+    /** True when FFID's canonical effective status denies service access. */
+    isBlocked?: boolean;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    /**
+     * Semantic FFID access-control status. `null` means the organization has no
+     * subscription row for this service.
+     */
+    effectiveStatus?: EffectiveSubscriptionStatus | null;
+    /**
+     * ISO timestamp at which `past_due_grace` flips to `blocked`; null outside
+     * the grace window.
+     */
+    gracePeriodEndsAt?: string | null;
+    /** Whether a canceled subscription can be resumed via a re-subscription flow. */
+    reactivatable?: boolean;
+}
+type FFIDServiceAccessFailPolicy = 'failClosed';
+type FFIDServiceAccessDenialReason = 'no_subscription' | 'grace_disallowed' | 'blocked' | 'canceled' | 'expired' | 'trial_expired' | 'ffid_unreachable';
+interface FFIDCheckServiceAccessParams {
+    userId?: string;
+    organizationId: string;
+    /**
+     * Whether `past_due_grace` should keep access open.
+     *
+     * @default true
+     */
+    allowGrace?: boolean;
+    /**
+     * Error policy when FFID cannot return a canonical decision.
+     *
+     * Currently only `failClosed` is supported: network/server/parse failures
+     * become `hasAccess=false` decisions with `denialReason='ffid_unreachable'`
+     * and the root cause in `decision.error`. Treat `hasAccess` as the gate.
+     */
+    failPolicy?: FFIDServiceAccessFailPolicy;
+}
+interface FFIDServiceAccessError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface FFIDServiceAccessDecision {
+    hasAccess: boolean;
+    effectiveStatus: EffectiveSubscriptionStatus | null;
+    isGrace: boolean;
+    isBlocked: boolean;
+    allowGrace: boolean;
+    failPolicy: FFIDServiceAccessFailPolicy;
+    denialReason: FFIDServiceAccessDenialReason | null;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    gracePeriodEndsAt: string | null;
+    reactivatable: boolean;
+    /**
+     * Present when the decision was produced by the SDK fail-closed policy
+     * rather than by a successful FFID response.
+     */
+    error?: FFIDServiceAccessError;
+}
+
 /** Billing interval for subscriptions */
 type FFIDBillingInterval = 'monthly' | 'yearly';
 /**
@@ -736,16 +823,7 @@ type FFIDApiResponse<T> = {
     data?: undefined;
     error: FFIDError;
 };
-/** Subscription status values matching the FFID platform's SubscriptionStatus type */
-type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
-interface FFIDSubscriptionCheckResponse {
-    hasActiveSubscription: boolean;
-    organizationId: string | null;
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    currentPeriodEnd: string | null;
-}
+
 /**
  * Checkout session response from billing checkout endpoint
  */
@@ -789,6 +867,8 @@ interface FFIDCreatePortalParams {
 
 /** 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 */
@@ -817,6 +897,19 @@ 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;
@@ -1140,9 +1233,15 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId?: string;
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDSubscriptionCheckResponse>>;
+    checkServiceAccess: (params: FFIDCheckServiceAccessParams) => Promise<FFIDApiResponse<FFIDServiceAccessDecision>>;
+    requireServiceAccess: (params: FFIDCheckServiceAccessParams) => Promise<FFIDApiResponse<FFIDServiceAccessDecision>>;
     listMembers: (params: {
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDListMembersResponse>>;
+    addMember: {
+        (params: FFIDAddMemberParams): Promise<FFIDApiResponse<FFIDAddMemberResponse>>;
+        (organizationId: string, data: FFIDAddMemberRequest): Promise<FFIDApiResponse<FFIDAddMemberResponse>>;
+    };
     updateMemberRole: (params: {
         organizationId: string;
         userId: string;
@@ -1212,4 +1311,4 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
-export { type FFIDLogger as F, type TokenData as T, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDCacheConfig as f, type FFIDClient as g, type FFIDConfig as h, type FFIDOrganization as i, type FFIDOtpSendResponse as j, type FFIDOtpVerifyResponse as k, type FFIDPasswordResetConfirmResponse as l, type FFIDPasswordResetResponse as m, type FFIDPasswordResetVerifyResponse as n, type FFIDProfileCallOptions as o, type FFIDResetSessionResponse as p, type FFIDSubscription as q, type FFIDUpdateUserProfileRequest as r, type FFIDUser as s, type FFIDUserProfile as t, type TokenStore as u, createFFIDClient as v, createTokenStore as w };
+export { type FFIDUpdateUserProfileRequest as A, type FFIDUser as B, type FFIDUserProfile as C, type TokenStore as D, createFFIDClient as E, type FFIDLogger as F, createTokenStore as G, type TokenData as T, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDAddMemberParams as f, type FFIDAddMemberRequest as g, type FFIDAddMemberResponse as h, type FFIDAssignableMemberRole as i, type FFIDCacheConfig as j, type FFIDClient as k, type FFIDConfig as l, type FFIDListMembersResponse as m, type FFIDMemberRole as n, type FFIDOrganization as o, type FFIDOrganizationMember as p, type FFIDOtpSendResponse as q, type FFIDOtpVerifyResponse as r, type FFIDPasswordResetConfirmResponse as s, type FFIDPasswordResetResponse as t, type FFIDPasswordResetVerifyResponse as u, type FFIDProfileCallOptions as v, type FFIDRemoveMemberResponse as w, type FFIDResetSessionResponse as x, type FFIDSubscription as y, type FFIDUpdateMemberRoleResponse as z };

package/dist/{ffid-client-ZcJhRbD6.d.ts → ffid-client-DgprK2ec.d.cts}

@@ -1,3 +1,5 @@
+import { E as EffectiveSubscriptionStatus } from './types-5g_Bg6Ey.cjs';
+
 /**
  * Inquiry types exposed by the FFID SDK.
  *
@@ -183,6 +185,91 @@ interface FFIDCacheConfig {
     ttl: number;
 }
 
+/**
+ * Canonical service-access types for subscription lifecycle decisions.
+ */
+
+/** Subscription status values matching the FFID platform's SubscriptionStatus type */
+type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+interface FFIDSubscriptionCheckResponse {
+    hasActiveSubscription: boolean;
+    /**
+     * Canonical access decision returned by FFID's `/subscriptions/ext/check`.
+     *
+     * This is the server-side source of truth for service gates. Consumers
+     * should not recompute access from `currentPeriodEnd`, `past_due_since`, or
+     * local payment timestamps.
+     */
+    hasAccess?: boolean;
+    /** True when `effectiveStatus === 'past_due_grace'`. */
+    isGrace?: boolean;
+    /** True when FFID's canonical effective status denies service access. */
+    isBlocked?: boolean;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    /**
+     * Semantic FFID access-control status. `null` means the organization has no
+     * subscription row for this service.
+     */
+    effectiveStatus?: EffectiveSubscriptionStatus | null;
+    /**
+     * ISO timestamp at which `past_due_grace` flips to `blocked`; null outside
+     * the grace window.
+     */
+    gracePeriodEndsAt?: string | null;
+    /** Whether a canceled subscription can be resumed via a re-subscription flow. */
+    reactivatable?: boolean;
+}
+type FFIDServiceAccessFailPolicy = 'failClosed';
+type FFIDServiceAccessDenialReason = 'no_subscription' | 'grace_disallowed' | 'blocked' | 'canceled' | 'expired' | 'trial_expired' | 'ffid_unreachable';
+interface FFIDCheckServiceAccessParams {
+    userId?: string;
+    organizationId: string;
+    /**
+     * Whether `past_due_grace` should keep access open.
+     *
+     * @default true
+     */
+    allowGrace?: boolean;
+    /**
+     * Error policy when FFID cannot return a canonical decision.
+     *
+     * Currently only `failClosed` is supported: network/server/parse failures
+     * become `hasAccess=false` decisions with `denialReason='ffid_unreachable'`
+     * and the root cause in `decision.error`. Treat `hasAccess` as the gate.
+     */
+    failPolicy?: FFIDServiceAccessFailPolicy;
+}
+interface FFIDServiceAccessError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface FFIDServiceAccessDecision {
+    hasAccess: boolean;
+    effectiveStatus: EffectiveSubscriptionStatus | null;
+    isGrace: boolean;
+    isBlocked: boolean;
+    allowGrace: boolean;
+    failPolicy: FFIDServiceAccessFailPolicy;
+    denialReason: FFIDServiceAccessDenialReason | null;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    gracePeriodEndsAt: string | null;
+    reactivatable: boolean;
+    /**
+     * Present when the decision was produced by the SDK fail-closed policy
+     * rather than by a successful FFID response.
+     */
+    error?: FFIDServiceAccessError;
+}
+
 /** Billing interval for subscriptions */
 type FFIDBillingInterval = 'monthly' | 'yearly';
 /**
@@ -736,16 +823,7 @@ type FFIDApiResponse<T> = {
     data?: undefined;
     error: FFIDError;
 };
-/** Subscription status values matching the FFID platform's SubscriptionStatus type */
-type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
-interface FFIDSubscriptionCheckResponse {
-    hasActiveSubscription: boolean;
-    organizationId: string | null;
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    currentPeriodEnd: string | null;
-}
+
 /**
  * Checkout session response from billing checkout endpoint
  */
@@ -789,6 +867,8 @@ interface FFIDCreatePortalParams {
 
 /** 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 */
@@ -817,6 +897,19 @@ 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;
@@ -1140,9 +1233,15 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId?: string;
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDSubscriptionCheckResponse>>;
+    checkServiceAccess: (params: FFIDCheckServiceAccessParams) => Promise<FFIDApiResponse<FFIDServiceAccessDecision>>;
+    requireServiceAccess: (params: FFIDCheckServiceAccessParams) => Promise<FFIDApiResponse<FFIDServiceAccessDecision>>;
     listMembers: (params: {
         organizationId: string;
     }) => Promise<FFIDApiResponse<FFIDListMembersResponse>>;
+    addMember: {
+        (params: FFIDAddMemberParams): Promise<FFIDApiResponse<FFIDAddMemberResponse>>;
+        (organizationId: string, data: FFIDAddMemberRequest): Promise<FFIDApiResponse<FFIDAddMemberResponse>>;
+    };
     updateMemberRole: (params: {
         organizationId: string;
         userId: string;
@@ -1212,4 +1311,4 @@ declare function createFFIDClient(config: FFIDConfig): {
 /** Type of the FFID client */
 type FFIDClient = ReturnType<typeof createFFIDClient>;
 
-export { type FFIDLogger as F, type TokenData as T, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDCacheConfig as f, type FFIDClient as g, type FFIDConfig as h, type FFIDOrganization as i, type FFIDOtpSendResponse as j, type FFIDOtpVerifyResponse as k, type FFIDPasswordResetConfirmResponse as l, type FFIDPasswordResetResponse as m, type FFIDPasswordResetVerifyResponse as n, type FFIDProfileCallOptions as o, type FFIDResetSessionResponse as p, type FFIDSubscription as q, type FFIDUpdateUserProfileRequest as r, type FFIDUser as s, type FFIDUserProfile as t, type TokenStore as u, createFFIDClient as v, createTokenStore as w };
+export { type FFIDUpdateUserProfileRequest as A, type FFIDUser as B, type FFIDUserProfile as C, type TokenStore as D, createFFIDClient as E, type FFIDLogger as F, createTokenStore as G, type TokenData as T, type FFIDError as a, type FFIDCacheAdapter as b, type FFIDVerifyAccessTokenOptions as c, type FFIDApiResponse as d, type FFIDOAuthUserInfo as e, type FFIDAddMemberParams as f, type FFIDAddMemberRequest as g, type FFIDAddMemberResponse as h, type FFIDAssignableMemberRole as i, type FFIDCacheConfig as j, type FFIDClient as k, type FFIDConfig as l, type FFIDListMembersResponse as m, type FFIDMemberRole as n, type FFIDOrganization as o, type FFIDOrganizationMember as p, type FFIDOtpSendResponse as q, type FFIDOtpVerifyResponse as r, type FFIDPasswordResetConfirmResponse as s, type FFIDPasswordResetResponse as t, type FFIDPasswordResetVerifyResponse as u, type FFIDProfileCallOptions as v, type FFIDRemoveMemberResponse as w, type FFIDResetSessionResponse as x, type FFIDSubscription as y, type FFIDUpdateMemberRoleResponse as z };

package/dist/{index-Cn8-3hgb.d.cts → index-CInGR4I9.d.cts}

@@ -58,6 +58,91 @@ interface FFIDCacheConfig {
  */
 type EffectiveSubscriptionStatus = 'active' | 'past_due_grace' | 'blocked' | 'canceled' | 'trial_expired' | 'expired';
 
+/**
+ * Canonical service-access types for subscription lifecycle decisions.
+ */
+
+/** Subscription status values matching the FFID platform's SubscriptionStatus type */
+type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+interface FFIDSubscriptionCheckResponse {
+    hasActiveSubscription: boolean;
+    /**
+     * Canonical access decision returned by FFID's `/subscriptions/ext/check`.
+     *
+     * This is the server-side source of truth for service gates. Consumers
+     * should not recompute access from `currentPeriodEnd`, `past_due_since`, or
+     * local payment timestamps.
+     */
+    hasAccess?: boolean;
+    /** True when `effectiveStatus === 'past_due_grace'`. */
+    isGrace?: boolean;
+    /** True when FFID's canonical effective status denies service access. */
+    isBlocked?: boolean;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    /**
+     * Semantic FFID access-control status. `null` means the organization has no
+     * subscription row for this service.
+     */
+    effectiveStatus?: EffectiveSubscriptionStatus | null;
+    /**
+     * ISO timestamp at which `past_due_grace` flips to `blocked`; null outside
+     * the grace window.
+     */
+    gracePeriodEndsAt?: string | null;
+    /** Whether a canceled subscription can be resumed via a re-subscription flow. */
+    reactivatable?: boolean;
+}
+type FFIDServiceAccessFailPolicy = 'failClosed';
+type FFIDServiceAccessDenialReason = 'no_subscription' | 'grace_disallowed' | 'blocked' | 'canceled' | 'expired' | 'trial_expired' | 'ffid_unreachable';
+interface FFIDCheckServiceAccessParams {
+    userId?: string;
+    organizationId: string;
+    /**
+     * Whether `past_due_grace` should keep access open.
+     *
+     * @default true
+     */
+    allowGrace?: boolean;
+    /**
+     * Error policy when FFID cannot return a canonical decision.
+     *
+     * Currently only `failClosed` is supported: network/server/parse failures
+     * become `hasAccess=false` decisions with `denialReason='ffid_unreachable'`
+     * and the root cause in `decision.error`. Treat `hasAccess` as the gate.
+     */
+    failPolicy?: FFIDServiceAccessFailPolicy;
+}
+interface FFIDServiceAccessError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface FFIDServiceAccessDecision {
+    hasAccess: boolean;
+    effectiveStatus: EffectiveSubscriptionStatus | null;
+    isGrace: boolean;
+    isBlocked: boolean;
+    allowGrace: boolean;
+    failPolicy: FFIDServiceAccessFailPolicy;
+    denialReason: FFIDServiceAccessDenialReason | null;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    gracePeriodEndsAt: string | null;
+    reactivatable: boolean;
+    /**
+     * Present when the decision was produced by the SDK fail-closed policy
+     * rather than by a successful FFID response.
+     */
+    error?: FFIDServiceAccessError;
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -444,16 +529,7 @@ type FFIDApiResponse<T> = {
     data?: undefined;
     error: FFIDError;
 };
-/** Subscription status values matching the FFID platform's SubscriptionStatus type */
-type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
-interface FFIDSubscriptionCheckResponse {
-    hasActiveSubscription: boolean;
-    organizationId: string | null;
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    currentPeriodEnd: string | null;
-}
+
 /**
  * Checkout session response from billing checkout endpoint
  */
@@ -497,6 +573,8 @@ interface FFIDCreatePortalParams {
 
 /** 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 */
@@ -525,6 +603,19 @@ 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;
@@ -1442,4 +1533,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 FFIDInquiryFormPlaceholderContext as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormLegalLayout as Z, type FFIDInquiryFormOrganization as _, type FFIDConfig as a, type FFIDInquiryFormPrefill as a0, type FFIDInquiryFormProps as a1, type FFIDInquiryFormSubmitData as a2, type FFIDInquiryFormSubmitResult as a3, type FFIDJwtClaims as a4, FFIDLoginButton as a5, type FFIDMemberStatus as a6, type FFIDOAuthTokenResponse as a7, type FFIDOAuthUserInfoMemberRole as a8, type FFIDOAuthUserInfoSubscription as a9, type FFIDOrganizationMember as aa, FFIDOrganizationSwitcher as ab, type FFIDRedirectErrorCode as ac, type FFIDSeatModel as ad, FFIDSubscriptionBadge as ae, type FFIDTokenIntrospectionResponse as af, FFIDUserMenu as ag, FFID_INQUIRY_CATEGORIES as ah, FFID_INQUIRY_CATEGORIES_SITE_2026 as ai, type UseFFIDAnnouncementsOptions as aj, type UseFFIDAnnouncementsReturn as ak, isFFIDInquiryCategorySite2026 as al, useFFIDAnnouncements as am, type FFIDAnnouncementBadgeClassNames as an, type FFIDAnnouncementBadgeProps as ao, type FFIDAnnouncementListClassNames as ap, type FFIDAnnouncementListProps as aq, type FFIDLoginButtonProps as ar, type FFIDOrganizationSwitcherClassNames as as, type FFIDOrganizationSwitcherProps as at, type FFIDSubscriptionBadgeClassNames as au, type FFIDSubscriptionBadgeProps as av, type FFIDUserMenuClassNames as aw, type FFIDUserMenuProps as ax, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };
+export { type FFIDInquiryCategorySite2026 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 FFIDAnnouncementsClientConfig as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsApiResponse as M, type AnnouncementListResponse as N, type FFIDAnnouncementsLogger as O, type Announcement as P, type AnnouncementStatus as Q, type AnnouncementType as R, FFIDAnnouncementBadge as S, FFIDAnnouncementList as T, type FFIDAnnouncementsError as U, type FFIDAnnouncementsErrorCode as V, type FFIDAnnouncementsServerResponse as W, type FFIDAssignableMemberRole as X, type FFIDCacheConfig as Y, type FFIDContextValue as Z, type FFIDInquiryCategory as _, type FFIDConfig as a, FFIDInquiryForm as a0, type FFIDInquiryFormCategoryItem as a1, type FFIDInquiryFormClassNames as a2, type FFIDInquiryFormLegalLayout as a3, type FFIDInquiryFormOrganization as a4, type FFIDInquiryFormPlaceholderContext as a5, type FFIDInquiryFormPrefill as a6, type FFIDInquiryFormProps as a7, type FFIDInquiryFormSubmitData as a8, type FFIDInquiryFormSubmitResult 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 FFIDJwtClaims as aa, FFIDLoginButton as ab, type FFIDMemberStatus as ac, type FFIDOAuthTokenResponse as ad, type FFIDOAuthUserInfoMemberRole as ae, type FFIDOAuthUserInfoSubscription 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 };

package/dist/{index-Cn8-3hgb.d.ts → index-CInGR4I9.d.ts}

@@ -58,6 +58,91 @@ interface FFIDCacheConfig {
  */
 type EffectiveSubscriptionStatus = 'active' | 'past_due_grace' | 'blocked' | 'canceled' | 'trial_expired' | 'expired';
 
+/**
+ * Canonical service-access types for subscription lifecycle decisions.
+ */
+
+/** Subscription status values matching the FFID platform's SubscriptionStatus type */
+type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
+interface FFIDSubscriptionCheckResponse {
+    hasActiveSubscription: boolean;
+    /**
+     * Canonical access decision returned by FFID's `/subscriptions/ext/check`.
+     *
+     * This is the server-side source of truth for service gates. Consumers
+     * should not recompute access from `currentPeriodEnd`, `past_due_since`, or
+     * local payment timestamps.
+     */
+    hasAccess?: boolean;
+    /** True when `effectiveStatus === 'past_due_grace'`. */
+    isGrace?: boolean;
+    /** True when FFID's canonical effective status denies service access. */
+    isBlocked?: boolean;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    /**
+     * Semantic FFID access-control status. `null` means the organization has no
+     * subscription row for this service.
+     */
+    effectiveStatus?: EffectiveSubscriptionStatus | null;
+    /**
+     * ISO timestamp at which `past_due_grace` flips to `blocked`; null outside
+     * the grace window.
+     */
+    gracePeriodEndsAt?: string | null;
+    /** Whether a canceled subscription can be resumed via a re-subscription flow. */
+    reactivatable?: boolean;
+}
+type FFIDServiceAccessFailPolicy = 'failClosed';
+type FFIDServiceAccessDenialReason = 'no_subscription' | 'grace_disallowed' | 'blocked' | 'canceled' | 'expired' | 'trial_expired' | 'ffid_unreachable';
+interface FFIDCheckServiceAccessParams {
+    userId?: string;
+    organizationId: string;
+    /**
+     * Whether `past_due_grace` should keep access open.
+     *
+     * @default true
+     */
+    allowGrace?: boolean;
+    /**
+     * Error policy when FFID cannot return a canonical decision.
+     *
+     * Currently only `failClosed` is supported: network/server/parse failures
+     * become `hasAccess=false` decisions with `denialReason='ffid_unreachable'`
+     * and the root cause in `decision.error`. Treat `hasAccess` as the gate.
+     */
+    failPolicy?: FFIDServiceAccessFailPolicy;
+}
+interface FFIDServiceAccessError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+interface FFIDServiceAccessDecision {
+    hasAccess: boolean;
+    effectiveStatus: EffectiveSubscriptionStatus | null;
+    isGrace: boolean;
+    isBlocked: boolean;
+    allowGrace: boolean;
+    failPolicy: FFIDServiceAccessFailPolicy;
+    denialReason: FFIDServiceAccessDenialReason | null;
+    organizationId: string | null;
+    subscriptionId: string | null;
+    status: FFIDSubscriptionStatus | null;
+    planCode: string | null;
+    currentPeriodEnd: string | null;
+    gracePeriodEndsAt: string | null;
+    reactivatable: boolean;
+    /**
+     * Present when the decision was produced by the SDK fail-closed policy
+     * rather than by a successful FFID response.
+     */
+    error?: FFIDServiceAccessError;
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -444,16 +529,7 @@ type FFIDApiResponse<T> = {
     data?: undefined;
     error: FFIDError;
 };
-/** Subscription status values matching the FFID platform's SubscriptionStatus type */
-type FFIDSubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'pending_invoice' | 'paused' | 'incomplete' | 'incomplete_expired' | 'unpaid';
-interface FFIDSubscriptionCheckResponse {
-    hasActiveSubscription: boolean;
-    organizationId: string | null;
-    subscriptionId: string | null;
-    status: FFIDSubscriptionStatus | null;
-    planCode: string | null;
-    currentPeriodEnd: string | null;
-}
+
 /**
  * Checkout session response from billing checkout endpoint
  */
@@ -497,6 +573,8 @@ interface FFIDCreatePortalParams {
 
 /** 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 */
@@ -525,6 +603,19 @@ 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;
@@ -1442,4 +1533,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 FFIDInquiryFormPlaceholderContext as $, type FFIDOrganization as A, type FFIDSubscription as B, type FFIDSubscriptionContextValue as C, type FFIDAnnouncementsClientConfig as D, type EffectiveSubscriptionStatus as E, type FFIDSubscriptionStatus as F, type FFIDAnnouncementsApiResponse as G, type AnnouncementListResponse as H, type FFIDAnnouncementsLogger as I, type Announcement as J, type AnnouncementStatus as K, type ListAnnouncementsOptions as L, type AnnouncementType as M, FFIDAnnouncementBadge as N, FFIDAnnouncementList as O, type FFIDAnnouncementsError as P, type FFIDAnnouncementsErrorCode as Q, type FFIDAnnouncementsServerResponse as R, type FFIDCacheConfig as S, type FFIDContextValue as T, type FFIDInquiryCategory as U, type FFIDInquiryCategorySite2026 as V, FFIDInquiryForm as W, type FFIDInquiryFormCategoryItem as X, type FFIDInquiryFormClassNames as Y, type FFIDInquiryFormLegalLayout as Z, type FFIDInquiryFormOrganization as _, type FFIDConfig as a, type FFIDInquiryFormPrefill as a0, type FFIDInquiryFormProps as a1, type FFIDInquiryFormSubmitData as a2, type FFIDInquiryFormSubmitResult as a3, type FFIDJwtClaims as a4, FFIDLoginButton as a5, type FFIDMemberStatus as a6, type FFIDOAuthTokenResponse as a7, type FFIDOAuthUserInfoMemberRole as a8, type FFIDOAuthUserInfoSubscription as a9, type FFIDOrganizationMember as aa, FFIDOrganizationSwitcher as ab, type FFIDRedirectErrorCode as ac, type FFIDSeatModel as ad, FFIDSubscriptionBadge as ae, type FFIDTokenIntrospectionResponse as af, FFIDUserMenu as ag, FFID_INQUIRY_CATEGORIES as ah, FFID_INQUIRY_CATEGORIES_SITE_2026 as ai, type UseFFIDAnnouncementsOptions as aj, type UseFFIDAnnouncementsReturn as ak, isFFIDInquiryCategorySite2026 as al, useFFIDAnnouncements as am, type FFIDAnnouncementBadgeClassNames as an, type FFIDAnnouncementBadgeProps as ao, type FFIDAnnouncementListClassNames as ap, type FFIDAnnouncementListProps as aq, type FFIDLoginButtonProps as ar, type FFIDOrganizationSwitcherClassNames as as, type FFIDOrganizationSwitcherProps as at, type FFIDSubscriptionBadgeClassNames as au, type FFIDSubscriptionBadgeProps as av, type FFIDUserMenuClassNames as aw, type FFIDUserMenuProps as ax, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDProfileCallOptions as k, type FFIDUserProfile as l, type FFIDUpdateUserProfileRequest as m, type FFIDAnalyticsConfig as n, type FFIDCreateCheckoutParams as o, type FFIDCheckoutSessionResponse as p, type FFIDCreatePortalParams as q, type FFIDPortalSessionResponse as r, type FFIDVerifyAccessTokenOptions as s, type FFIDOAuthUserInfo as t, type FFIDInquiryCreateParams as u, type FFIDInquiryCreateResponse as v, type FFIDAuthMode as w, type FFIDLogger as x, type FFIDCacheAdapter as y, type FFIDUser as z };
+export { type FFIDInquiryCategorySite2026 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 FFIDAnnouncementsClientConfig as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsApiResponse as M, type AnnouncementListResponse as N, type FFIDAnnouncementsLogger as O, type Announcement as P, type AnnouncementStatus as Q, type AnnouncementType as R, FFIDAnnouncementBadge as S, FFIDAnnouncementList as T, type FFIDAnnouncementsError as U, type FFIDAnnouncementsErrorCode as V, type FFIDAnnouncementsServerResponse as W, type FFIDAssignableMemberRole as X, type FFIDCacheConfig as Y, type FFIDContextValue as Z, type FFIDInquiryCategory as _, type FFIDConfig as a, FFIDInquiryForm as a0, type FFIDInquiryFormCategoryItem as a1, type FFIDInquiryFormClassNames as a2, type FFIDInquiryFormLegalLayout as a3, type FFIDInquiryFormOrganization as a4, type FFIDInquiryFormPlaceholderContext as a5, type FFIDInquiryFormPrefill as a6, type FFIDInquiryFormProps as a7, type FFIDInquiryFormSubmitData as a8, type FFIDInquiryFormSubmitResult 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 FFIDJwtClaims as aa, FFIDLoginButton as ab, type FFIDMemberStatus as ac, type FFIDOAuthTokenResponse as ad, type FFIDOAuthUserInfoMemberRole as ae, type FFIDOAuthUserInfoSubscription 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 };