@feelflow/ffid-sdk 8.1.0 → 9.0.0

package/dist/webhooks/index.d.cts

@@ -64,12 +64,27 @@ interface FFIDSubscriptionCreatedPayload {
      */
     serviceCode?: string;
 }
+/**
+ * `subscription.updated`.
+ *
+ * 9.0.0 aligned this type with what FFID sends (#6380): `status` is always present, and
+ * `subscriptionId` / `organizationId` are absent when the event comes from a Stripe notice
+ * whose subscription FFID could not match to its own record (check before use).
+ * `previousPlan` was removed — FFID never sent it.
+ */
 interface FFIDSubscriptionUpdatedPayload {
-    subscriptionId: string;
+    /**
+     * Subscription status after the change — the raw status string (FFID's or Stripe's), not a
+     * closed enum. Use `effectiveStatus` for access decisions.
+     */
+    status: string;
+    /** FFID subscription UUID. Absent when FFID could not match the Stripe subscription */
+    subscriptionId?: string;
+    /** Stripe subscription id (`sub_...`). Present on events that come from Stripe notices */
+    stripeSubscriptionId?: string;
     organizationId?: string;
+    /** Plan code after the change */
     plan?: string;
-    previousPlan?: string;
-    status?: string;
     effectiveStatus?: EffectiveSubscriptionStatus;
     gracePeriodEndsAt?: string | null;
     /**
@@ -242,9 +257,27 @@ interface FFIDSubscriptionDowngradeCanceledPayload {
      */
     serviceCode?: string;
 }
+/**
+ * `subscription.trial_ending` — sent when Stripe announces that a trial is about to end.
+ *
+ * 9.0.0 aligned this type with what FFID sends (#6380). FFID does not resolve its own
+ * subscription UUID for this event; identify the subscription by `stripeSubscriptionId`
+ * (and the service by `serviceCode`).
+ */
 interface FFIDSubscriptionTrialEndingPayload {
-    subscriptionId: string;
-    organizationId?: string;
+    /** Stripe subscription id (`sub_...`) */
+    stripeSubscriptionId: string;
+    /**
+     * Days until the trial ends, rounded **up** at the moment FFID processed Stripe's notice
+     * (a trial ending later the same day is `1`). `0` only when the trial had already ended by
+     * then. Fixed when the event is created — a redelivered event carries the same value.
+     */
+    daysRemaining: number;
+    /**
+     * Trial end date **for display**, in Japanese long form in JST (e.g. `2026年10月3日`) — not
+     * an ISO timestamp. `(無効な日時)` when FFID could not read Stripe's timestamp. Use
+     * `daysRemaining` for any calculation.
+     */
     trialEndDate: string;
     /**
      * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when

package/dist/webhooks/index.d.ts

@@ -64,12 +64,27 @@ interface FFIDSubscriptionCreatedPayload {
      */
     serviceCode?: string;
 }
+/**
+ * `subscription.updated`.
+ *
+ * 9.0.0 aligned this type with what FFID sends (#6380): `status` is always present, and
+ * `subscriptionId` / `organizationId` are absent when the event comes from a Stripe notice
+ * whose subscription FFID could not match to its own record (check before use).
+ * `previousPlan` was removed — FFID never sent it.
+ */
 interface FFIDSubscriptionUpdatedPayload {
-    subscriptionId: string;
+    /**
+     * Subscription status after the change — the raw status string (FFID's or Stripe's), not a
+     * closed enum. Use `effectiveStatus` for access decisions.
+     */
+    status: string;
+    /** FFID subscription UUID. Absent when FFID could not match the Stripe subscription */
+    subscriptionId?: string;
+    /** Stripe subscription id (`sub_...`). Present on events that come from Stripe notices */
+    stripeSubscriptionId?: string;
     organizationId?: string;
+    /** Plan code after the change */
     plan?: string;
-    previousPlan?: string;
-    status?: string;
     effectiveStatus?: EffectiveSubscriptionStatus;
     gracePeriodEndsAt?: string | null;
     /**
@@ -242,9 +257,27 @@ interface FFIDSubscriptionDowngradeCanceledPayload {
      */
     serviceCode?: string;
 }
+/**
+ * `subscription.trial_ending` — sent when Stripe announces that a trial is about to end.
+ *
+ * 9.0.0 aligned this type with what FFID sends (#6380). FFID does not resolve its own
+ * subscription UUID for this event; identify the subscription by `stripeSubscriptionId`
+ * (and the service by `serviceCode`).
+ */
 interface FFIDSubscriptionTrialEndingPayload {
-    subscriptionId: string;
-    organizationId?: string;
+    /** Stripe subscription id (`sub_...`) */
+    stripeSubscriptionId: string;
+    /**
+     * Days until the trial ends, rounded **up** at the moment FFID processed Stripe's notice
+     * (a trial ending later the same day is `1`). `0` only when the trial had already ended by
+     * then. Fixed when the event is created — a redelivered event carries the same value.
+     */
+    daysRemaining: number;
+    /**
+     * Trial end date **for display**, in Japanese long form in JST (e.g. `2026年10月3日`) — not
+     * an ISO timestamp. `(無効な日時)` when FFID could not read Stripe's timestamp. Use
+     * `daysRemaining` for any calculation.
+     */
     trialEndDate: string;
     /**
      * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when

package/package.json

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