@feelflow/ffid-sdk 1.19.1 → 2.1.0

package/dist/{chunk-JT7IIDMS.cjs → chunk-C6Z4JPYE.cjs}

@@ -600,7 +600,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "1.19.1";
+var SDK_VERSION = "2.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1461,6 +1461,86 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/contract-wizard-methods.ts
+var CONTRACT_WIZARD_PATH = "/contract-wizard";
+function buildWizardUrl(baseUrl, flow, params) {
+  const query = new URLSearchParams();
+  query.set("flow", flow);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      query.set(key, value);
+    }
+  }
+  return `${baseUrl}${CONTRACT_WIZARD_PATH}?${query.toString()}`;
+}
+function performRedirect(url, logger) {
+  if (typeof window === "undefined") {
+    logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
+    return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
+  }
+  logger.debug("Redirecting to contract wizard:", url);
+  window.location.href = url;
+  return { success: true };
+}
+function createContractWizardMethods(deps) {
+  const { baseUrl, serviceCode, logger } = deps;
+  function buildSubscriptionWizardUrl(flow, subscriptionId, options) {
+    return buildWizardUrl(baseUrl, flow, {
+      service: serviceCode,
+      subscription: subscriptionId,
+      redirect: options?.redirect
+    });
+  }
+  function getSubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "new-subscription", {
+      service: serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToSubscribe(options) {
+    return performRedirect(getSubscribeUrl(options), logger);
+  }
+  function getChangePlanUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-plan", subscriptionId, options);
+  }
+  function redirectToChangePlan(subscriptionId, options) {
+    return performRedirect(getChangePlanUrl(subscriptionId, options), logger);
+  }
+  function getChangeSeatsUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-seats", subscriptionId, options);
+  }
+  function redirectToChangeSeats(subscriptionId, options) {
+    return performRedirect(getChangeSeatsUrl(subscriptionId, options), logger);
+  }
+  function getRecoverPaymentUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("payment-recovery", subscriptionId, options);
+  }
+  function redirectToRecoverPayment(subscriptionId, options) {
+    return performRedirect(getRecoverPaymentUrl(subscriptionId, options), logger);
+  }
+  function getResubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "resubscribe", {
+      service: options?.serviceCode ?? serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToResubscribe(options) {
+    return performRedirect(getResubscribeUrl(options), logger);
+  }
+  return {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1660,6 +1740,11 @@ function createFFIDClient(config) {
         error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059")
       };
     }
+    if (authMode === "token" && (params.userId === void 0 || !params.userId.trim())) {
+      return {
+        error: createError("VALIDATION_ERROR", "token \u30E2\u30FC\u30C9\u3067\u306F userId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
     if (params.userId !== void 0 && !params.userId.trim()) {
       return {
         error: createError("VALIDATION_ERROR", "userId \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093")
@@ -1708,6 +1793,22 @@ function createFFIDClient(config) {
     fetchWithAuth,
     errorCodes: FFID_ERROR_CODES
   });
+  const {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  } = createContractWizardMethods({
+    baseUrl,
+    serviceCode: config.serviceCode,
+    logger
+  });
   const { sendOtp, verifyOtp } = createOtpMethods({
     baseUrl,
     logger,
@@ -1751,6 +1852,16 @@ function createFFIDClient(config) {
     cancelSubscription,
     previewPlanChange,
     verifyAccessToken,
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe,
     requestPasswordReset,
     verifyPasswordResetToken,
     establishResetSession,
@@ -2066,7 +2177,17 @@ function useFFID() {
     switchOrganization: context.switchOrganization,
     refresh: context.refresh,
     getLoginUrl: client.getLoginUrl,
-    getSignupUrl: client.getSignupUrl
+    getSignupUrl: client.getSignupUrl,
+    getSubscribeUrl: client.getSubscribeUrl,
+    redirectToSubscribe: client.redirectToSubscribe,
+    getChangePlanUrl: client.getChangePlanUrl,
+    redirectToChangePlan: client.redirectToChangePlan,
+    getChangeSeatsUrl: client.getChangeSeatsUrl,
+    redirectToChangeSeats: client.redirectToChangeSeats,
+    getRecoverPaymentUrl: client.getRecoverPaymentUrl,
+    redirectToRecoverPayment: client.redirectToRecoverPayment,
+    getResubscribeUrl: client.getResubscribeUrl,
+    redirectToResubscribe: client.redirectToResubscribe
   };
 }
 function FFIDLoginButton({

package/dist/{chunk-66HJMEHY.js → chunk-NHVOLBE5.js}

@@ -598,7 +598,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "1.19.1";
+var SDK_VERSION = "2.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1459,6 +1459,86 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/contract-wizard-methods.ts
+var CONTRACT_WIZARD_PATH = "/contract-wizard";
+function buildWizardUrl(baseUrl, flow, params) {
+  const query = new URLSearchParams();
+  query.set("flow", flow);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      query.set(key, value);
+    }
+  }
+  return `${baseUrl}${CONTRACT_WIZARD_PATH}?${query.toString()}`;
+}
+function performRedirect(url, logger) {
+  if (typeof window === "undefined") {
+    logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
+    return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
+  }
+  logger.debug("Redirecting to contract wizard:", url);
+  window.location.href = url;
+  return { success: true };
+}
+function createContractWizardMethods(deps) {
+  const { baseUrl, serviceCode, logger } = deps;
+  function buildSubscriptionWizardUrl(flow, subscriptionId, options) {
+    return buildWizardUrl(baseUrl, flow, {
+      service: serviceCode,
+      subscription: subscriptionId,
+      redirect: options?.redirect
+    });
+  }
+  function getSubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "new-subscription", {
+      service: serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToSubscribe(options) {
+    return performRedirect(getSubscribeUrl(options), logger);
+  }
+  function getChangePlanUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-plan", subscriptionId, options);
+  }
+  function redirectToChangePlan(subscriptionId, options) {
+    return performRedirect(getChangePlanUrl(subscriptionId, options), logger);
+  }
+  function getChangeSeatsUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-seats", subscriptionId, options);
+  }
+  function redirectToChangeSeats(subscriptionId, options) {
+    return performRedirect(getChangeSeatsUrl(subscriptionId, options), logger);
+  }
+  function getRecoverPaymentUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("payment-recovery", subscriptionId, options);
+  }
+  function redirectToRecoverPayment(subscriptionId, options) {
+    return performRedirect(getRecoverPaymentUrl(subscriptionId, options), logger);
+  }
+  function getResubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "resubscribe", {
+      service: options?.serviceCode ?? serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToResubscribe(options) {
+    return performRedirect(getResubscribeUrl(options), logger);
+  }
+  return {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1658,6 +1738,11 @@ function createFFIDClient(config) {
         error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059")
       };
     }
+    if (authMode === "token" && (params.userId === void 0 || !params.userId.trim())) {
+      return {
+        error: createError("VALIDATION_ERROR", "token \u30E2\u30FC\u30C9\u3067\u306F userId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
     if (params.userId !== void 0 && !params.userId.trim()) {
       return {
         error: createError("VALIDATION_ERROR", "userId \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093")
@@ -1706,6 +1791,22 @@ function createFFIDClient(config) {
     fetchWithAuth,
     errorCodes: FFID_ERROR_CODES
   });
+  const {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  } = createContractWizardMethods({
+    baseUrl,
+    serviceCode: config.serviceCode,
+    logger
+  });
   const { sendOtp, verifyOtp } = createOtpMethods({
     baseUrl,
     logger,
@@ -1749,6 +1850,16 @@ function createFFIDClient(config) {
     cancelSubscription,
     previewPlanChange,
     verifyAccessToken,
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe,
     requestPasswordReset,
     verifyPasswordResetToken,
     establishResetSession,
@@ -2064,7 +2175,17 @@ function useFFID() {
     switchOrganization: context.switchOrganization,
     refresh: context.refresh,
     getLoginUrl: client.getLoginUrl,
-    getSignupUrl: client.getSignupUrl
+    getSignupUrl: client.getSignupUrl,
+    getSubscribeUrl: client.getSubscribeUrl,
+    redirectToSubscribe: client.redirectToSubscribe,
+    getChangePlanUrl: client.getChangePlanUrl,
+    redirectToChangePlan: client.redirectToChangePlan,
+    getChangeSeatsUrl: client.getChangeSeatsUrl,
+    redirectToChangeSeats: client.redirectToChangeSeats,
+    getRecoverPaymentUrl: client.getRecoverPaymentUrl,
+    redirectToRecoverPayment: client.redirectToRecoverPayment,
+    getResubscribeUrl: client.getResubscribeUrl,
+    redirectToResubscribe: client.redirectToResubscribe
   };
 }
 function FFIDLoginButton({

package/dist/components/index.cjs

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

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-66HJMEHY.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-NHVOLBE5.js';

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -113,6 +113,7 @@ interface FFIDPlanInfo {
     description: string | null;
     minSeats: number;
     maxSeats: number | null;
+    seatSelectionEnabled: boolean;
     trialDays: number;
     priceMonthly: number;
     priceYearly: number | null;
@@ -316,6 +317,28 @@ type FFIDResetSessionResponse = FFIDPasswordResetResponse;
 /** Response from confirmPasswordReset */
 type FFIDPasswordResetConfirmResponse = FFIDPasswordResetResponse;
 
+/** Contract Wizard navigation methods — URL generation and browser redirect for contract flows */
+
+/** Contract wizard flow types */
+type ContractWizardFlowType = 'new-subscription' | 'resubscribe' | 'change-plan' | 'change-seats' | 'payment-recovery';
+/** Options for the new-subscription wizard flow */
+interface ContractWizardSubscribeOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for the resubscribe wizard flow */
+interface ContractWizardResubscribeOptions {
+    /** Service code to resubscribe to (defaults to SDK's serviceCode) */
+    serviceCode?: string;
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for wizard flows that operate on an existing subscription */
+interface ContractWizardSubscriptionOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
 /** Options for redirectToAuthorize */
@@ -362,6 +385,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
     previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
     establishResetSession: (accessToken: string, refreshToken: string) => Promise<FFIDApiResponse<FFIDResetSessionResponse>>;
@@ -462,6 +495,26 @@ interface UseFFIDReturn {
     getLoginUrl: (redirectUrl?: string) => string;
     /** Get signup URL with redirect parameter */
     getSignupUrl: (redirectUrl?: string) => string;
+    /** Get URL for new subscription contract wizard */
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    /** Redirect to new subscription contract wizard */
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    /** Get URL for plan change contract wizard */
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to plan change contract wizard */
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for seat count change contract wizard */
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to seat count change contract wizard */
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for payment recovery contract wizard */
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to payment recovery contract wizard */
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for resubscribe contract wizard */
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    /** Redirect to resubscribe contract wizard */
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
 }
 /**
  * Hook to access FFID authentication and user data
@@ -641,4 +694,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, 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 };
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, 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

@@ -113,6 +113,7 @@ interface FFIDPlanInfo {
     description: string | null;
     minSeats: number;
     maxSeats: number | null;
+    seatSelectionEnabled: boolean;
     trialDays: number;
     priceMonthly: number;
     priceYearly: number | null;
@@ -316,6 +317,28 @@ type FFIDResetSessionResponse = FFIDPasswordResetResponse;
 /** Response from confirmPasswordReset */
 type FFIDPasswordResetConfirmResponse = FFIDPasswordResetResponse;
 
+/** Contract Wizard navigation methods — URL generation and browser redirect for contract flows */
+
+/** Contract wizard flow types */
+type ContractWizardFlowType = 'new-subscription' | 'resubscribe' | 'change-plan' | 'change-seats' | 'payment-recovery';
+/** Options for the new-subscription wizard flow */
+interface ContractWizardSubscribeOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for the resubscribe wizard flow */
+interface ContractWizardResubscribeOptions {
+    /** Service code to resubscribe to (defaults to SDK's serviceCode) */
+    serviceCode?: string;
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for wizard flows that operate on an existing subscription */
+interface ContractWizardSubscriptionOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
 /** Options for redirectToAuthorize */
@@ -362,6 +385,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
     previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
     establishResetSession: (accessToken: string, refreshToken: string) => Promise<FFIDApiResponse<FFIDResetSessionResponse>>;
@@ -462,6 +495,26 @@ interface UseFFIDReturn {
     getLoginUrl: (redirectUrl?: string) => string;
     /** Get signup URL with redirect parameter */
     getSignupUrl: (redirectUrl?: string) => string;
+    /** Get URL for new subscription contract wizard */
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    /** Redirect to new subscription contract wizard */
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    /** Get URL for plan change contract wizard */
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to plan change contract wizard */
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for seat count change contract wizard */
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to seat count change contract wizard */
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for payment recovery contract wizard */
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    /** Redirect to payment recovery contract wizard */
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    /** Get URL for resubscribe contract wizard */
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    /** Redirect to resubscribe contract wizard */
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
 }
 /**
  * Hook to access FFID authentication and user data
@@ -641,4 +694,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, 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 };
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, 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-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 { useFFIDContext } from './chunk-NHVOLBE5.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-NHVOLBE5.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -596,7 +596,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "1.19.1";
+var SDK_VERSION = "2.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1444,6 +1444,86 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/contract-wizard-methods.ts
+var CONTRACT_WIZARD_PATH = "/contract-wizard";
+function buildWizardUrl(baseUrl, flow, params) {
+  const query = new URLSearchParams();
+  query.set("flow", flow);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      query.set(key, value);
+    }
+  }
+  return `${baseUrl}${CONTRACT_WIZARD_PATH}?${query.toString()}`;
+}
+function performRedirect(url, logger) {
+  if (typeof window === "undefined") {
+    logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
+    return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
+  }
+  logger.debug("Redirecting to contract wizard:", url);
+  window.location.href = url;
+  return { success: true };
+}
+function createContractWizardMethods(deps) {
+  const { baseUrl, serviceCode, logger } = deps;
+  function buildSubscriptionWizardUrl(flow, subscriptionId, options) {
+    return buildWizardUrl(baseUrl, flow, {
+      service: serviceCode,
+      subscription: subscriptionId,
+      redirect: options?.redirect
+    });
+  }
+  function getSubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "new-subscription", {
+      service: serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToSubscribe(options) {
+    return performRedirect(getSubscribeUrl(options), logger);
+  }
+  function getChangePlanUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-plan", subscriptionId, options);
+  }
+  function redirectToChangePlan(subscriptionId, options) {
+    return performRedirect(getChangePlanUrl(subscriptionId, options), logger);
+  }
+  function getChangeSeatsUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-seats", subscriptionId, options);
+  }
+  function redirectToChangeSeats(subscriptionId, options) {
+    return performRedirect(getChangeSeatsUrl(subscriptionId, options), logger);
+  }
+  function getRecoverPaymentUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("payment-recovery", subscriptionId, options);
+  }
+  function redirectToRecoverPayment(subscriptionId, options) {
+    return performRedirect(getRecoverPaymentUrl(subscriptionId, options), logger);
+  }
+  function getResubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "resubscribe", {
+      service: options?.serviceCode ?? serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToResubscribe(options) {
+    return performRedirect(getResubscribeUrl(options), logger);
+  }
+  return {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1643,6 +1723,11 @@ function createFFIDClient(config) {
         error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059")
       };
     }
+    if (authMode === "token" && (params.userId === void 0 || !params.userId.trim())) {
+      return {
+        error: createError("VALIDATION_ERROR", "token \u30E2\u30FC\u30C9\u3067\u306F userId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
     if (params.userId !== void 0 && !params.userId.trim()) {
       return {
         error: createError("VALIDATION_ERROR", "userId \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093")
@@ -1691,6 +1776,22 @@ function createFFIDClient(config) {
     fetchWithAuth,
     errorCodes: FFID_ERROR_CODES
   });
+  const {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  } = createContractWizardMethods({
+    baseUrl,
+    serviceCode: config.serviceCode,
+    logger
+  });
   const { sendOtp, verifyOtp } = createOtpMethods({
     baseUrl,
     logger,
@@ -1734,6 +1835,16 @@ function createFFIDClient(config) {
     cancelSubscription,
     previewPlanChange,
     verifyAccessToken,
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe,
     requestPasswordReset,
     verifyPasswordResetToken,
     establishResetSession,

package/dist/server/index.d.cts

@@ -42,6 +42,7 @@ interface FFIDPlanInfo {
     description: string | null;
     minSeats: number;
     maxSeats: number | null;
+    seatSelectionEnabled: boolean;
     trialDays: number;
     priceMonthly: number;
     priceYearly: number | null;
@@ -581,6 +582,26 @@ type FFIDResetSessionResponse = FFIDPasswordResetResponse;
 /** Response from confirmPasswordReset */
 type FFIDPasswordResetConfirmResponse = FFIDPasswordResetResponse;
 
+/** Contract Wizard navigation methods — URL generation and browser redirect for contract flows */
+
+/** Options for the new-subscription wizard flow */
+interface ContractWizardSubscribeOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for the resubscribe wizard flow */
+interface ContractWizardResubscribeOptions {
+    /** Service code to resubscribe to (defaults to SDK's serviceCode) */
+    serviceCode?: string;
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for wizard flows that operate on an existing subscription */
+interface ContractWizardSubscriptionOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
 /** Options for redirectToAuthorize */
@@ -668,6 +689,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
     previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
     establishResetSession: (accessToken: string, refreshToken: string) => Promise<FFIDApiResponse<FFIDResetSessionResponse>>;

package/dist/server/index.d.ts

@@ -42,6 +42,7 @@ interface FFIDPlanInfo {
     description: string | null;
     minSeats: number;
     maxSeats: number | null;
+    seatSelectionEnabled: boolean;
     trialDays: number;
     priceMonthly: number;
     priceYearly: number | null;
@@ -581,6 +582,26 @@ type FFIDResetSessionResponse = FFIDPasswordResetResponse;
 /** Response from confirmPasswordReset */
 type FFIDPasswordResetConfirmResponse = FFIDPasswordResetResponse;
 
+/** Contract Wizard navigation methods — URL generation and browser redirect for contract flows */
+
+/** Options for the new-subscription wizard flow */
+interface ContractWizardSubscribeOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for the resubscribe wizard flow */
+interface ContractWizardResubscribeOptions {
+    /** Service code to resubscribe to (defaults to SDK's serviceCode) */
+    serviceCode?: string;
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+/** Options for wizard flows that operate on an existing subscription */
+interface ContractWizardSubscriptionOptions {
+    /** URL to redirect back to after completion */
+    redirect?: string;
+}
+
 /** Redirect and URL generation - redirectToLogin / redirectToAuthorize / redirectToLogout / getLoginUrl / getSignupUrl / getLogoutUrl */
 
 /** Options for redirectToAuthorize */
@@ -668,6 +689,16 @@ declare function createFFIDClient(config: FFIDConfig): {
     cancelSubscription: (params: FFIDCancelSubscriptionParams) => Promise<FFIDApiResponse<FFIDCancelSubscriptionResponse>>;
     previewPlanChange: (params: FFIDPreviewPlanChangeParams) => Promise<FFIDApiResponse<FFIDPlanChangePreviewResponse>>;
     verifyAccessToken: (accessToken: string, options?: FFIDVerifyAccessTokenOptions) => Promise<FFIDApiResponse<FFIDOAuthUserInfo>>;
+    getSubscribeUrl: (options?: ContractWizardSubscribeOptions) => string;
+    redirectToSubscribe: (options?: ContractWizardSubscribeOptions) => FFIDRedirectResult;
+    getChangePlanUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangePlan: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getChangeSeatsUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToChangeSeats: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getRecoverPaymentUrl: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => string;
+    redirectToRecoverPayment: (subscriptionId: string, options?: ContractWizardSubscriptionOptions) => FFIDRedirectResult;
+    getResubscribeUrl: (options?: ContractWizardResubscribeOptions) => string;
+    redirectToResubscribe: (options?: ContractWizardResubscribeOptions) => FFIDRedirectResult;
     requestPasswordReset: (email: string) => Promise<FFIDApiResponse<FFIDPasswordResetResponse>>;
     verifyPasswordResetToken: (accessToken: string) => Promise<FFIDApiResponse<FFIDPasswordResetVerifyResponse>>;
     establishResetSession: (accessToken: string, refreshToken: string) => Promise<FFIDApiResponse<FFIDResetSessionResponse>>;

package/dist/server/index.js

@@ -595,7 +595,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "1.19.1";
+var SDK_VERSION = "2.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1443,6 +1443,86 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/contract-wizard-methods.ts
+var CONTRACT_WIZARD_PATH = "/contract-wizard";
+function buildWizardUrl(baseUrl, flow, params) {
+  const query = new URLSearchParams();
+  query.set("flow", flow);
+  for (const [key, value] of Object.entries(params)) {
+    if (value !== void 0) {
+      query.set(key, value);
+    }
+  }
+  return `${baseUrl}${CONTRACT_WIZARD_PATH}?${query.toString()}`;
+}
+function performRedirect(url, logger) {
+  if (typeof window === "undefined") {
+    logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
+    return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
+  }
+  logger.debug("Redirecting to contract wizard:", url);
+  window.location.href = url;
+  return { success: true };
+}
+function createContractWizardMethods(deps) {
+  const { baseUrl, serviceCode, logger } = deps;
+  function buildSubscriptionWizardUrl(flow, subscriptionId, options) {
+    return buildWizardUrl(baseUrl, flow, {
+      service: serviceCode,
+      subscription: subscriptionId,
+      redirect: options?.redirect
+    });
+  }
+  function getSubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "new-subscription", {
+      service: serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToSubscribe(options) {
+    return performRedirect(getSubscribeUrl(options), logger);
+  }
+  function getChangePlanUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-plan", subscriptionId, options);
+  }
+  function redirectToChangePlan(subscriptionId, options) {
+    return performRedirect(getChangePlanUrl(subscriptionId, options), logger);
+  }
+  function getChangeSeatsUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("change-seats", subscriptionId, options);
+  }
+  function redirectToChangeSeats(subscriptionId, options) {
+    return performRedirect(getChangeSeatsUrl(subscriptionId, options), logger);
+  }
+  function getRecoverPaymentUrl(subscriptionId, options) {
+    return buildSubscriptionWizardUrl("payment-recovery", subscriptionId, options);
+  }
+  function redirectToRecoverPayment(subscriptionId, options) {
+    return performRedirect(getRecoverPaymentUrl(subscriptionId, options), logger);
+  }
+  function getResubscribeUrl(options) {
+    return buildWizardUrl(baseUrl, "resubscribe", {
+      service: options?.serviceCode ?? serviceCode,
+      redirect: options?.redirect
+    });
+  }
+  function redirectToResubscribe(options) {
+    return performRedirect(getResubscribeUrl(options), logger);
+  }
+  return {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1642,6 +1722,11 @@ function createFFIDClient(config) {
         error: createError("VALIDATION_ERROR", "organizationId \u306F\u5FC5\u9808\u3067\u3059")
       };
     }
+    if (authMode === "token" && (params.userId === void 0 || !params.userId.trim())) {
+      return {
+        error: createError("VALIDATION_ERROR", "token \u30E2\u30FC\u30C9\u3067\u306F userId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
     if (params.userId !== void 0 && !params.userId.trim()) {
       return {
         error: createError("VALIDATION_ERROR", "userId \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093")
@@ -1690,6 +1775,22 @@ function createFFIDClient(config) {
     fetchWithAuth,
     errorCodes: FFID_ERROR_CODES
   });
+  const {
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe
+  } = createContractWizardMethods({
+    baseUrl,
+    serviceCode: config.serviceCode,
+    logger
+  });
   const { sendOtp, verifyOtp } = createOtpMethods({
     baseUrl,
     logger,
@@ -1733,6 +1834,16 @@ function createFFIDClient(config) {
     cancelSubscription,
     previewPlanChange,
     verifyAccessToken,
+    getSubscribeUrl,
+    redirectToSubscribe,
+    getChangePlanUrl,
+    redirectToChangePlan,
+    getChangeSeatsUrl,
+    redirectToChangeSeats,
+    getRecoverPaymentUrl,
+    redirectToRecoverPayment,
+    getResubscribeUrl,
+    redirectToResubscribe,
     requestPasswordReset,
     verifyPasswordResetToken,
     establishResetSession,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelflow/ffid-sdk",
-  "version": "1.19.1",
+  "version": "2.1.0",
   "description": "FeelFlow ID Platform SDK for React/Next.js applications",
   "keywords": [
     "feelflow",
@@ -99,6 +99,8 @@
     "@testing-library/react": "^16.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
     "eslint-plugin-react-hooks": "^7.0.1",
     "jsdom": "^27.0.0",
     "react": "^19.0.0",