@feelflow/ffid-sdk 5.10.0 → 5.12.0

package/dist/{chunk-IZSL6DI7.cjs → chunk-AOJDV3UO.cjs}

@@ -436,6 +436,8 @@ function createVerifyAccessToken(deps) {
 // src/client/billing-methods.ts
 var BILLING_CHECKOUT_ENDPOINT = "/api/v1/billing/checkout";
 var BILLING_PORTAL_ENDPOINT = "/api/v1/billing/portal";
+var EXT_INVOICES_ENDPOINT = "/api/v1/billing/ext/invoices";
+var EXT_RETRY_PAYMENT_ENDPOINT = "/api/v1/billing/ext/retry-payment";
 function createBillingMethods(deps) {
   const { fetchWithAuth, createError } = deps;
   async function createCheckoutSession(params) {
@@ -477,7 +479,31 @@ function createBillingMethods(deps) {
       `${BILLING_PORTAL_ENDPOINT}?${query.toString()}`
     );
   }
-  return { createCheckoutSession, createPortalSession };
+  async function listInvoices(params) {
+    if (!params.organizationId) {
+      return { error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const query = new URLSearchParams({ organizationId: params.organizationId });
+    return fetchWithAuth(`${EXT_INVOICES_ENDPOINT}?${query.toString()}`);
+  }
+  async function getInvoice(params) {
+    if (!params.invoiceId) {
+      return { error: createError("VALIDATION_ERROR", "invoiceId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(
+      `${EXT_INVOICES_ENDPOINT}/${encodeURIComponent(params.invoiceId)}`
+    );
+  }
+  async function retryPayment(params) {
+    if (!params.organizationId) {
+      return { error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(EXT_RETRY_PAYMENT_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ organizationId: params.organizationId })
+    });
+  }
+  return { createCheckoutSession, createPortalSession, listInvoices, getInvoice, retryPayment };
 }
 
 // src/client/subscription-methods.ts
@@ -819,6 +845,45 @@ function createMembersMethods(deps) {
   return { listMembers, addMember, updateMemberRole, removeMember };
 }
 
+// src/client/seat-methods.ts
+function seatsEndpoint(subscriptionId) {
+  return `/api/v1/subscriptions/ext/${encodeURIComponent(subscriptionId)}/seats/assignments`;
+}
+function createSeatMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function listSeatAssignments(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(seatsEndpoint(params.subscriptionId));
+  }
+  async function assignSeats(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.userIds) || params.userIds.length === 0) {
+      return { error: createError("VALIDATION_ERROR", "userIds \u306F 1 \u4EF6\u4EE5\u4E0A\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044") };
+    }
+    return fetchWithAuth(seatsEndpoint(params.subscriptionId), {
+      method: "POST",
+      body: JSON.stringify({ userIds: params.userIds })
+    });
+  }
+  async function unassignSeat(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!params.userId) {
+      return { error: createError("VALIDATION_ERROR", "userId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(
+      `${seatsEndpoint(params.subscriptionId)}/${encodeURIComponent(params.userId)}`,
+      { method: "DELETE" }
+    );
+  }
+  return { listSeatAssignments, assignSeats, unassignSeat };
+}
+
 // src/client/profile-methods.ts
 var EXT_PROFILE_ENDPOINT = "/api/v1/users/ext/me";
 function resolveAuthOverride(options, createError) {
@@ -869,7 +934,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.10.0";
+var SDK_VERSION = "5.12.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -2259,6 +2324,15 @@ function createInquiryMethods(deps) {
 }
 
 // src/subscriptions/types.ts
+var EFFECTIVE_SUBSCRIPTION_STATUSES = [
+  "active",
+  "active_canceling",
+  "past_due_grace",
+  "blocked",
+  "canceled",
+  "trial_expired",
+  "expired"
+];
 var PAST_DUE_GRACE_PERIOD_DAYS = 7;
 var HOURS_PER_DAY = 24;
 var MINUTES_PER_HOUR = 60;
@@ -2719,7 +2793,11 @@ function createFFIDClient(config) {
     }
     return result;
   }
-  const { createCheckoutSession, createPortalSession } = createBillingMethods({
+  const { createCheckoutSession, createPortalSession, listInvoices, getInvoice, retryPayment } = createBillingMethods({
+    fetchWithAuth,
+    createError
+  });
+  const { listSeatAssignments, assignSeats, unassignSeat } = createSeatMethods({
     fetchWithAuth,
     createError
   });
@@ -2828,6 +2906,12 @@ function createFFIDClient(config) {
     getAnalyticsConfig,
     createCheckoutSession,
     createPortalSession,
+    listInvoices,
+    getInvoice,
+    retryPayment,
+    listSeatAssignments,
+    assignSeats,
+    unassignSeat,
     listPlans,
     getSubscription,
     subscribe,
@@ -4860,6 +4944,7 @@ exports.ACCESS_GRANTING_EFFECTIVE_STATUSES = ACCESS_GRANTING_EFFECTIVE_STATUSES;
 exports.BLOCKING_EFFECTIVE_STATUSES = BLOCKING_EFFECTIVE_STATUSES;
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
 exports.DEFAULT_OAUTH_SCOPES = DEFAULT_OAUTH_SCOPES;
+exports.EFFECTIVE_SUBSCRIPTION_STATUSES = EFFECTIVE_SUBSCRIPTION_STATUSES;
 exports.FFIDAnnouncementBadge = FFIDAnnouncementBadge;
 exports.FFIDAnnouncementList = FFIDAnnouncementList;
 exports.FFIDInquiryForm = FFIDInquiryForm;

package/dist/{chunk-OJ3OJTIE.js → chunk-KB2JG64Z.js}

@@ -434,6 +434,8 @@ function createVerifyAccessToken(deps) {
 // src/client/billing-methods.ts
 var BILLING_CHECKOUT_ENDPOINT = "/api/v1/billing/checkout";
 var BILLING_PORTAL_ENDPOINT = "/api/v1/billing/portal";
+var EXT_INVOICES_ENDPOINT = "/api/v1/billing/ext/invoices";
+var EXT_RETRY_PAYMENT_ENDPOINT = "/api/v1/billing/ext/retry-payment";
 function createBillingMethods(deps) {
   const { fetchWithAuth, createError } = deps;
   async function createCheckoutSession(params) {
@@ -475,7 +477,31 @@ function createBillingMethods(deps) {
       `${BILLING_PORTAL_ENDPOINT}?${query.toString()}`
     );
   }
-  return { createCheckoutSession, createPortalSession };
+  async function listInvoices(params) {
+    if (!params.organizationId) {
+      return { error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const query = new URLSearchParams({ organizationId: params.organizationId });
+    return fetchWithAuth(`${EXT_INVOICES_ENDPOINT}?${query.toString()}`);
+  }
+  async function getInvoice(params) {
+    if (!params.invoiceId) {
+      return { error: createError("VALIDATION_ERROR", "invoiceId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(
+      `${EXT_INVOICES_ENDPOINT}/${encodeURIComponent(params.invoiceId)}`
+    );
+  }
+  async function retryPayment(params) {
+    if (!params.organizationId) {
+      return { error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(EXT_RETRY_PAYMENT_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ organizationId: params.organizationId })
+    });
+  }
+  return { createCheckoutSession, createPortalSession, listInvoices, getInvoice, retryPayment };
 }
 
 // src/client/subscription-methods.ts
@@ -817,6 +843,45 @@ function createMembersMethods(deps) {
   return { listMembers, addMember, updateMemberRole, removeMember };
 }
 
+// src/client/seat-methods.ts
+function seatsEndpoint(subscriptionId) {
+  return `/api/v1/subscriptions/ext/${encodeURIComponent(subscriptionId)}/seats/assignments`;
+}
+function createSeatMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function listSeatAssignments(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(seatsEndpoint(params.subscriptionId));
+  }
+  async function assignSeats(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.userIds) || params.userIds.length === 0) {
+      return { error: createError("VALIDATION_ERROR", "userIds \u306F 1 \u4EF6\u4EE5\u4E0A\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044") };
+    }
+    return fetchWithAuth(seatsEndpoint(params.subscriptionId), {
+      method: "POST",
+      body: JSON.stringify({ userIds: params.userIds })
+    });
+  }
+  async function unassignSeat(params) {
+    if (!params.subscriptionId) {
+      return { error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!params.userId) {
+      return { error: createError("VALIDATION_ERROR", "userId \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(
+      `${seatsEndpoint(params.subscriptionId)}/${encodeURIComponent(params.userId)}`,
+      { method: "DELETE" }
+    );
+  }
+  return { listSeatAssignments, assignSeats, unassignSeat };
+}
+
 // src/client/profile-methods.ts
 var EXT_PROFILE_ENDPOINT = "/api/v1/users/ext/me";
 function resolveAuthOverride(options, createError) {
@@ -867,7 +932,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.10.0";
+var SDK_VERSION = "5.12.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -2257,6 +2322,15 @@ function createInquiryMethods(deps) {
 }
 
 // src/subscriptions/types.ts
+var EFFECTIVE_SUBSCRIPTION_STATUSES = [
+  "active",
+  "active_canceling",
+  "past_due_grace",
+  "blocked",
+  "canceled",
+  "trial_expired",
+  "expired"
+];
 var PAST_DUE_GRACE_PERIOD_DAYS = 7;
 var HOURS_PER_DAY = 24;
 var MINUTES_PER_HOUR = 60;
@@ -2717,7 +2791,11 @@ function createFFIDClient(config) {
     }
     return result;
   }
-  const { createCheckoutSession, createPortalSession } = createBillingMethods({
+  const { createCheckoutSession, createPortalSession, listInvoices, getInvoice, retryPayment } = createBillingMethods({
+    fetchWithAuth,
+    createError
+  });
+  const { listSeatAssignments, assignSeats, unassignSeat } = createSeatMethods({
     fetchWithAuth,
     createError
   });
@@ -2826,6 +2904,12 @@ function createFFIDClient(config) {
     getAnalyticsConfig,
     createCheckoutSession,
     createPortalSession,
+    listInvoices,
+    getInvoice,
+    retryPayment,
+    listSeatAssignments,
+    assignSeats,
+    unassignSeat,
     listPlans,
     getSubscription,
     subscribe,
@@ -4854,4 +4938,4 @@ function FFIDInquiryForm({
   );
 }
 
-export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, hasAccessFromUserinfo, isBlockedFromUserinfo, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useFFIDContext, useSubscription, withSubscription };
+export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EFFECTIVE_SUBSCRIPTION_STATUSES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, hasAccessFromUserinfo, isBlockedFromUserinfo, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useFFIDContext, useSubscription, withSubscription };

package/dist/components/index.cjs

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

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { M as FFIDAnnouncementBadge, al as FFIDAnnouncementBadgeClassNames, am as FFIDAnnouncementBadgeProps, N as FFIDAnnouncementList, an as FFIDAnnouncementListClassNames, ao as FFIDAnnouncementListProps, V as FFIDInquiryForm, W as FFIDInquiryFormCategoryItem, X as FFIDInquiryFormClassNames, Y as FFIDInquiryFormLegalLayout, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, ap as FFIDLoginButtonProps, a7 as FFIDOrganizationSwitcher, aq as FFIDOrganizationSwitcherClassNames, ar as FFIDOrganizationSwitcherProps, ac as FFIDSubscriptionBadge, as as FFIDSubscriptionBadgeClassNames, at as FFIDSubscriptionBadgeProps, ae as FFIDUserMenu, au as FFIDUserMenuClassNames, av as FFIDUserMenuProps } from '../index-DSvX4q8E.cjs';
+export { I as FFIDAnnouncementBadge, ai as FFIDAnnouncementBadgeClassNames, aj as FFIDAnnouncementBadgeProps, J as FFIDAnnouncementList, ak as FFIDAnnouncementListClassNames, al as FFIDAnnouncementListProps, S as FFIDInquiryForm, T as FFIDInquiryFormCategoryItem, U as FFIDInquiryFormClassNames, V as FFIDInquiryFormLegalLayout, W as FFIDInquiryFormOrganization, X as FFIDInquiryFormPlaceholderContext, Y as FFIDInquiryFormPrefill, Z as FFIDInquiryFormProps, _ as FFIDInquiryFormSubmitData, $ as FFIDInquiryFormSubmitResult, a1 as FFIDLoginButton, am as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, an as FFIDOrganizationSwitcherClassNames, ao as FFIDOrganizationSwitcherProps, a9 as FFIDSubscriptionBadge, ap as FFIDSubscriptionBadgeClassNames, aq as FFIDSubscriptionBadgeProps, ab as FFIDUserMenu, ar as FFIDUserMenuClassNames, as as FFIDUserMenuProps } from '../index-DqsWKU16.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { M as FFIDAnnouncementBadge, al as FFIDAnnouncementBadgeClassNames, am as FFIDAnnouncementBadgeProps, N as FFIDAnnouncementList, an as FFIDAnnouncementListClassNames, ao as FFIDAnnouncementListProps, V as FFIDInquiryForm, W as FFIDInquiryFormCategoryItem, X as FFIDInquiryFormClassNames, Y as FFIDInquiryFormLegalLayout, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a4 as FFIDLoginButton, ap as FFIDLoginButtonProps, a7 as FFIDOrganizationSwitcher, aq as FFIDOrganizationSwitcherClassNames, ar as FFIDOrganizationSwitcherProps, ac as FFIDSubscriptionBadge, as as FFIDSubscriptionBadgeClassNames, at as FFIDSubscriptionBadgeProps, ae as FFIDUserMenu, au as FFIDUserMenuClassNames, av as FFIDUserMenuProps } from '../index-DSvX4q8E.js';
+export { I as FFIDAnnouncementBadge, ai as FFIDAnnouncementBadgeClassNames, aj as FFIDAnnouncementBadgeProps, J as FFIDAnnouncementList, ak as FFIDAnnouncementListClassNames, al as FFIDAnnouncementListProps, S as FFIDInquiryForm, T as FFIDInquiryFormCategoryItem, U as FFIDInquiryFormClassNames, V as FFIDInquiryFormLegalLayout, W as FFIDInquiryFormOrganization, X as FFIDInquiryFormPlaceholderContext, Y as FFIDInquiryFormPrefill, Z as FFIDInquiryFormProps, _ as FFIDInquiryFormSubmitData, $ as FFIDInquiryFormSubmitResult, a1 as FFIDLoginButton, am as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, an as FFIDOrganizationSwitcherClassNames, ao as FFIDOrganizationSwitcherProps, a9 as FFIDSubscriptionBadge, ap as FFIDSubscriptionBadgeClassNames, aq as FFIDSubscriptionBadgeProps, ab as FFIDUserMenu, ar as FFIDUserMenuClassNames, as as FFIDUserMenuProps } from '../index-DqsWKU16.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

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

package/dist/{ffid-client-DRjzfAaS.d.cts → ffid-client-5IprSUVR.d.ts}

@@ -1,4 +1,4 @@
-import { E as EffectiveSubscriptionStatus } from './types-BYdtyO_2.cjs';
+import { E as EffectiveSubscriptionStatus } from './types-BeVl-z12.js';
 
 /**
  * Inquiry types exposed by the FFID SDK.
@@ -270,6 +270,52 @@ interface FFIDServiceAccessDecision {
     error?: FFIDServiceAccessError;
 }
 
+/**
+ * Billing checkout / portal session types.
+ *
+ * types/index.ts のサイズ上限対応で切り出し（中身は逐語移設、#3787 Phase A）。
+ */
+/**
+ * Checkout session response from billing checkout endpoint
+ */
+interface FFIDCheckoutSessionResponse {
+    /** Stripe Checkout session ID */
+    sessionId: string;
+    /** Stripe Checkout session URL (null if session creation had issues) */
+    url: string | null;
+}
+/**
+ * Portal session response from billing portal endpoint
+ */
+interface FFIDPortalSessionResponse {
+    /** Stripe Billing Portal URL */
+    url: string;
+}
+/**
+ * Parameters for creating a checkout session
+ */
+interface FFIDCreateCheckoutParams {
+    /** Organization ID (UUID) */
+    organizationId: string;
+    /** Subscription ID (UUID) */
+    subscriptionId: string;
+    /** URL to redirect after successful checkout */
+    successUrl: string;
+    /** URL to redirect after cancelled checkout */
+    cancelUrl: string;
+    /** Optional plan ID for upgrade or resubscription */
+    planId?: string;
+}
+/**
+ * Parameters for creating a billing portal session
+ */
+interface FFIDCreatePortalParams {
+    /** Organization ID (UUID) */
+    organizationId: string;
+    /** URL to redirect when user exits the portal */
+    returnUrl: string;
+}
+
 /** Billing interval for subscriptions */
 type FFIDBillingInterval = 'monthly' | 'yearly';
 /**
@@ -637,6 +683,122 @@ interface FFIDRemoveMemberResponse {
     message: string;
 }
 
+/**
+ * Contract resource types (#3787 Phase A)
+ *
+ * シート割り当て・請求書・支払い再試行の ext API 型。
+ * サーバー側の sanitize 済みレスポンス（Stripe 内部 ID を含まない）と対になる。
+ */
+/** シート割り当て 1 件（ユーザー情報付き、一覧用） */
+interface FFIDSeatAssignmentWithUser {
+    userId: string;
+    email: string;
+    name: string | null;
+    role: string;
+    assignedAt: string;
+    assignedBy: string | null;
+}
+/** シート割り当てレコード（割り当て直後のレスポンス用） */
+interface FFIDSeatAssignmentRecord {
+    id: string;
+    subscriptionId: string;
+    userId: string;
+    assignedBy: string | null;
+    assignedAt: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** GET /api/v1/subscriptions/ext/{id}/seats/assignments のレスポンス */
+interface FFIDListSeatAssignmentsResponse {
+    assignments: FFIDSeatAssignmentWithUser[];
+    totalSeats: number;
+    assignedSeats: number;
+    availableSeats: number;
+}
+/** listSeatAssignments のパラメータ */
+interface FFIDListSeatAssignmentsParams {
+    subscriptionId: string;
+}
+/** assignSeats のパラメータ */
+interface FFIDAssignSeatsParams {
+    subscriptionId: string;
+    userIds: string[];
+}
+/** POST /api/v1/subscriptions/ext/{id}/seats/assignments のレスポンス */
+interface FFIDAssignSeatsResponse {
+    message: string;
+    assignments: FFIDSeatAssignmentRecord[];
+}
+/** unassignSeat のパラメータ */
+interface FFIDUnassignSeatParams {
+    subscriptionId: string;
+    userId: string;
+}
+/** DELETE /api/v1/subscriptions/ext/{id}/seats/assignments/{userId} のレスポンス */
+interface FFIDUnassignSeatResponse {
+    message: string;
+}
+/** 請求書サマリー（一覧用） */
+interface FFIDInvoiceSummary {
+    id: string;
+    organizationId: string;
+    subscriptionId: string | null;
+    invoiceNumber: string;
+    description: string | null;
+    subtotal: number;
+    taxRate: number;
+    taxAmount: number;
+    totalAmount: number;
+    currency: string;
+    status: string;
+    issuedAt: string | null;
+    dueDate: string | null;
+    paidAt: string | null;
+    pdfUrl: string | null;
+    createdAt: string;
+}
+/** 請求書詳細（請求先情報・備考を含む） */
+interface FFIDInvoiceDetail extends FFIDInvoiceSummary {
+    billingName: string | null;
+    billingEmail: string | null;
+    notes: string | null;
+}
+/** listInvoices のパラメータ */
+interface FFIDListInvoicesParams {
+    organizationId: string;
+}
+/** GET /api/v1/billing/ext/invoices のレスポンス */
+interface FFIDListInvoicesResponse {
+    invoices: FFIDInvoiceSummary[];
+    count: number;
+}
+/** getInvoice のパラメータ */
+interface FFIDGetInvoiceParams {
+    invoiceId: string;
+}
+/** GET /api/v1/billing/ext/invoices/{id} のレスポンス */
+interface FFIDGetInvoiceResponse {
+    invoice: FFIDInvoiceDetail;
+}
+/** retryPayment のパラメータ */
+interface FFIDRetryPaymentParams {
+    organizationId: string;
+}
+/** 再試行に失敗した契約の詳細 */
+interface FFIDRetryPaymentFailure {
+    subscriptionId: string;
+    reason: string;
+    stripeCode?: string;
+}
+/** POST /api/v1/billing/ext/retry-payment のレスポンス */
+interface FFIDRetryPaymentSummary {
+    totalAttempted: number;
+    succeeded: number;
+    failed: number;
+    noOpenInvoice: number;
+    failures: FFIDRetryPaymentFailure[];
+}
+
 /**
  * FFID SDK Type Definitions
  *
@@ -962,47 +1124,6 @@ type FFIDApiResponse<T> = {
     error: FFIDError;
 };
 
-/**
- * Checkout session response from billing checkout endpoint
- */
-interface FFIDCheckoutSessionResponse {
-    /** Stripe Checkout session ID */
-    sessionId: string;
-    /** Stripe Checkout session URL (null if session creation had issues) */
-    url: string | null;
-}
-/**
- * Portal session response from billing portal endpoint
- */
-interface FFIDPortalSessionResponse {
-    /** Stripe Billing Portal URL */
-    url: string;
-}
-/**
- * Parameters for creating a checkout session
- */
-interface FFIDCreateCheckoutParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** Subscription ID (UUID) */
-    subscriptionId: string;
-    /** URL to redirect after successful checkout */
-    successUrl: string;
-    /** URL to redirect after cancelled checkout */
-    cancelUrl: string;
-    /** Optional plan ID for upgrade or resubscription */
-    planId?: string;
-}
-/**
- * Parameters for creating a billing portal session
- */
-interface FFIDCreatePortalParams {
-    /** Organization ID (UUID) */
-    organizationId: string;
-    /** URL to redirect when user exits the portal */
-    returnUrl: string;
-}
-
 /**
  * User profile for the authenticated user (returned by `getProfile` / `updateProfile`).
  *
@@ -1341,6 +1462,12 @@ declare function createFFIDClient(config: FFIDConfig): {
     getAnalyticsConfig: (serviceCode: string, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDAnalyticsConfig>>;
     createCheckoutSession: (params: FFIDCreateCheckoutParams) => Promise<FFIDApiResponse<FFIDCheckoutSessionResponse>>;
     createPortalSession: (params: FFIDCreatePortalParams) => Promise<FFIDApiResponse<FFIDPortalSessionResponse>>;
+    listInvoices: (params: FFIDListInvoicesParams) => Promise<FFIDApiResponse<FFIDListInvoicesResponse>>;
+    getInvoice: (params: FFIDGetInvoiceParams) => Promise<FFIDApiResponse<FFIDGetInvoiceResponse>>;
+    retryPayment: (params: FFIDRetryPaymentParams) => Promise<FFIDApiResponse<FFIDRetryPaymentSummary>>;
+    listSeatAssignments: (params: FFIDListSeatAssignmentsParams) => Promise<FFIDApiResponse<FFIDListSeatAssignmentsResponse>>;
+    assignSeats: (params: FFIDAssignSeatsParams) => Promise<FFIDApiResponse<FFIDAssignSeatsResponse>>;
+    unassignSeat: (params: FFIDUnassignSeatParams) => Promise<FFIDApiResponse<FFIDUnassignSeatResponse>>;
     listPlans: () => Promise<FFIDApiResponse<FFIDListPlansResponse>>;
     getSubscription: (subscriptionId: string) => Promise<FFIDApiResponse<FFIDSubscriptionDetail>>;
     subscribe: (params: FFIDSubscribeParams) => Promise<FFIDApiResponse<FFIDSubscribeResponse>>;