@feelflow/ffid-sdk 2.10.0 → 2.12.0

package/dist/server/index.js

@@ -452,9 +452,118 @@ function createBillingMethods(deps) {
 var EXT_PLANS_ENDPOINT = "/api/v1/subscriptions/ext/plans";
 var EXT_SUBSCRIPTION_ENDPOINT = "/api/v1/subscriptions/ext";
 var EXT_SUBSCRIBE_ENDPOINT = "/api/v1/subscriptions/ext/subscribe";
+var FFIDSDKError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "FFIDSDKError";
+    this.code = code;
+  }
+};
 function isBlankString(value) {
   return typeof value !== "string" || value.trim() === "";
 }
+var MALFORMED_PREVIEW_CODE = "MALFORMED_PLAN_CHANGE_PREVIEW";
+var MALFORMED_SEAT_PREVIEW_CODE = "MALFORMED_SEAT_CHANGE_PREVIEW";
+var SEAT_ESTIMATE_REASONS = /* @__PURE__ */ new Set(["no_stripe_data", "custom_pricing", "stripe_error"]);
+function validatePlanChangePreview(preview) {
+  if (preview === null || typeof preview !== "object") {
+    throw new FFIDSDKError(
+      MALFORMED_PREVIEW_CODE,
+      "SDK: server returned malformed PlanChangePreview \u2014 expected object, got " + (preview === null ? "null" : typeof preview)
+    );
+  }
+  const p = preview;
+  const flag = p.willApplyAtPeriodEnd;
+  if (typeof flag !== "boolean") {
+    throw new FFIDSDKError(
+      MALFORMED_PREVIEW_CODE,
+      `SDK: server returned malformed PlanChangePreview \u2014 willApplyAtPeriodEnd must be boolean (got ${typeof flag})`
+    );
+  }
+  const { proratedAmount, effectiveDate } = p;
+  if (flag === true) {
+    if (proratedAmount !== 0) {
+      throw new FFIDSDKError(
+        MALFORMED_PREVIEW_CODE,
+        `SDK: server returned malformed PlanChangePreview \u2014 willApplyAtPeriodEnd=true requires proratedAmount=0 (got ${JSON.stringify(proratedAmount)})`
+      );
+    }
+    if (effectiveDate !== null && typeof effectiveDate !== "string") {
+      throw new FFIDSDKError(
+        MALFORMED_PREVIEW_CODE,
+        `SDK: server returned malformed PlanChangePreview \u2014 willApplyAtPeriodEnd=true requires effectiveDate to be string or null (got ${typeof effectiveDate})`
+      );
+    }
+    return;
+  }
+  if (effectiveDate !== null) {
+    throw new FFIDSDKError(
+      MALFORMED_PREVIEW_CODE,
+      `SDK: server returned malformed PlanChangePreview \u2014 willApplyAtPeriodEnd=false requires effectiveDate=null (got ${JSON.stringify(effectiveDate)})`
+    );
+  }
+  if (typeof proratedAmount !== "number") {
+    throw new FFIDSDKError(
+      MALFORMED_PREVIEW_CODE,
+      `SDK: server returned malformed PlanChangePreview \u2014 willApplyAtPeriodEnd=false requires proratedAmount to be a number (got ${typeof proratedAmount})`
+    );
+  }
+}
+function validateSeatChangePreview(preview) {
+  if (preview === null || typeof preview !== "object") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      "SDK: server returned malformed SeatChangePreview \u2014 expected object, got " + (preview === null ? "null" : typeof preview)
+    );
+  }
+  const p = preview;
+  if (p.type !== "seat-change") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 type must be 'seat-change' (got ${JSON.stringify(p.type)})`
+    );
+  }
+  const numericFields = [
+    "currentQuantity",
+    "newQuantity",
+    "unitPrice",
+    "proratedAmount",
+    "nextInvoiceAmount"
+  ];
+  for (const key of numericFields) {
+    if (typeof p[key] !== "number") {
+      throw new FFIDSDKError(
+        MALFORMED_SEAT_PREVIEW_CODE,
+        `SDK: server returned malformed SeatChangePreview \u2014 ${key} must be a number (got ${typeof p[key]})`
+      );
+    }
+  }
+  if (p.nextInvoiceDate !== null && typeof p.nextInvoiceDate !== "string") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 nextInvoiceDate must be string or null (got ${typeof p.nextInvoiceDate})`
+    );
+  }
+  if (typeof p.isEstimate !== "boolean") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 isEstimate must be boolean (got ${typeof p.isEstimate})`
+    );
+  }
+  if (p.estimateReason !== void 0 && !SEAT_ESTIMATE_REASONS.has(p.estimateReason)) {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 estimateReason must be one of 'no_stripe_data' | 'custom_pricing' | 'stripe_error' (got ${JSON.stringify(p.estimateReason)})`
+    );
+  }
+  if (!Array.isArray(p.lineItems)) {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 lineItems must be an array (got ${typeof p.lineItems})`
+    );
+  }
+}
 function createSubscriptionMethods(deps) {
   const { fetchWithAuth, createError } = deps;
   async function listPlans() {
@@ -541,7 +650,7 @@ function createSubscriptionMethods(deps) {
         error: createError("VALIDATION_ERROR", "subscriptionId \u3068 planCode \u306F\u5FC5\u9808\u3067\u3059")
       };
     }
-    return fetchWithAuth(
+    const response = await fetchWithAuth(
       `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(params.subscriptionId)}/plan/preview`,
       {
         method: "POST",
@@ -551,6 +660,36 @@ function createSubscriptionMethods(deps) {
         })
       }
     );
+    if (response.data !== void 0) {
+      validatePlanChangePreview(response.data.preview);
+    }
+    return response;
+  }
+  async function previewSeatChange(params) {
+    if (isBlankString(params.subscriptionId)) {
+      return {
+        error: createError("VALIDATION_ERROR", "subscriptionId \u306F\u5FC5\u9808\u3067\u3059")
+      };
+    }
+    if (typeof params.quantity !== "number" || !Number.isInteger(params.quantity) || params.quantity < 1) {
+      return {
+        error: createError(
+          "VALIDATION_ERROR",
+          `quantity \u306F 1 \u4EE5\u4E0A\u306E\u6574\u6570\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059 (received: ${String(params.quantity)})`
+        )
+      };
+    }
+    const response = await fetchWithAuth(
+      `${EXT_SUBSCRIPTION_ENDPOINT}/${encodeURIComponent(params.subscriptionId)}/seats/preview`,
+      {
+        method: "POST",
+        body: JSON.stringify({ quantity: params.quantity })
+      }
+    );
+    if (response.data !== void 0) {
+      validateSeatChangePreview(response.data.preview);
+    }
+    return response;
   }
   return {
     listPlans,
@@ -559,7 +698,8 @@ function createSubscriptionMethods(deps) {
     changePlan,
     cancelSubscription,
     cancelPendingDowngrade,
-    previewPlanChange
+    previewPlanChange,
+    previewSeatChange
   };
 }
 
@@ -616,7 +756,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.10.0";
+var SDK_VERSION = "2.12.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1940,7 +2080,8 @@ function createFFIDClient(config) {
     changePlan,
     cancelSubscription,
     cancelPendingDowngrade,
-    previewPlanChange
+    previewPlanChange,
+    previewSeatChange
   } = createSubscriptionMethods({
     fetchWithAuth,
     createError
@@ -2030,6 +2171,7 @@ function createFFIDClient(config) {
     cancelSubscription,
     cancelPendingDowngrade,
     previewPlanChange,
+    previewSeatChange,
     verifyAccessToken,
     getSubscribeUrl,
     redirectToSubscribe,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feelflow/ffid-sdk",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "description": "FeelFlow ID Platform SDK for React/Next.js applications",
   "keywords": [
     "feelflow",