@feelflow/ffid-sdk 8.0.0 → 9.0.0

package/dist/server/index.cjs

@@ -223,18 +223,16 @@ function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   ];
 }
 var JWKS_ENDPOINT = "/.well-known/jwks.json";
-var LEGACY_JWT_ISSUER = "https://id.feelflow.net";
 var JWT_ALGORITHM = "ES256";
 var JWT_CLOCK_TOLERANCE_SECONDS = 30;
-function resolveAcceptedIssuers(baseUrl) {
-  const deployedOrigin = new URL(baseUrl).origin;
-  return deployedOrigin === LEGACY_JWT_ISSUER ? [LEGACY_JWT_ISSUER] : [deployedOrigin, LEGACY_JWT_ISSUER];
+function resolveAcceptedIssuer(baseUrl) {
+  return new URL(baseUrl).origin;
 }
 function createJwtVerifier(deps) {
   const { baseUrl, serviceCode, logger, createError, errorCodes } = deps;
   const jwksUrl = new URL(JWKS_ENDPOINT, baseUrl);
   const jwks = jose.createRemoteJWKSet(jwksUrl);
-  const acceptedIssuers = resolveAcceptedIssuers(baseUrl);
+  const acceptedIssuer = resolveAcceptedIssuer(baseUrl);
   async function verifyJwt(accessToken) {
     if (!accessToken || !accessToken.trim()) {
       return {
@@ -247,7 +245,7 @@ function createJwtVerifier(deps) {
     try {
       const { payload } = await jose.jwtVerify(accessToken, jwks, {
         algorithms: [JWT_ALGORITHM],
-        issuer: acceptedIssuers,
+        issuer: acceptedIssuer,
         audience: serviceCode,
         clockTolerance: JWT_CLOCK_TOLERANCE_SECONDS
       });
@@ -1373,7 +1371,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "8.0.0";
+var SDK_VERSION = "9.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-BaEmw7jP.cjs';
-export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDOrganization, B as FFIDOrganizationLogoUploadResponse, C as FFIDOrganizationMember, D as FFIDOrganizationProfile, E as FFIDOrganizationProfileErrorCode, G as FFIDOrganizationProfileResponse, H as FFIDOtpSendResponse, I as FFIDOtpVerifyResponse, J as FFIDPasswordResetConfirmResponse, K as FFIDPasswordResetResponse, L as FFIDPasswordResetVerifyResponse, M as FFIDProfileCallOptions, N as FFIDProvisionMemberPlan, O as FFIDProvisionMemberPlanStatus, P as FFIDProvisionMemberResult, Q as FFIDProvisionMemberStatus, R as FFIDProvisionOrganizationDryRun, S as FFIDProvisionOrganizationMemberInput, T as FFIDProvisionOrganizationOutcome, U as FFIDProvisionOrganizationParams, V as FFIDProvisionOrganizationResponse, W as FFIDProvisionUserDryRun, X as FFIDProvisionUserOutcome, Y as FFIDProvisionUserParams, Z as FFIDProvisionUserProfileInput, _ as FFIDProvisionUserResponse, $ as FFIDProvisionedOrganization, a0 as FFIDProvisionedUser, a1 as FFIDPublishedPlan, a2 as FFIDRemoveMemberResponse, a3 as FFIDResetSessionResponse, a4 as FFIDSubscription, a5 as FFIDUpdateMemberRoleResponse, a6 as FFIDUpdateUserProfileRequest, a7 as FFIDUploadOrganizationLogoParams, a8 as FFIDUpsertOrganizationProfileParams, a9 as FFIDUpsertOrganizationProfileRequest, aa as FFIDUser, ab as FFIDUserProfile, ac as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ad as FFID_CATALOG_ENVIRONMENTS, ae as FFID_CATALOG_PUBLICATION_STATUSES, af as FFID_COMPANY_SIZE_CODES, ag as FFID_INDUSTRY_CODES, ah as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, aj as FFID_ORGANIZATION_PROFILE_ERROR_CODES, ak as TokenData, al as TokenStore, am as createFFIDClient, an as createTokenStore } from '../ffid-client-BaEmw7jP.cjs';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-6aLs9Fqc.cjs';
+export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDOrganization, B as FFIDOrganizationLogoUploadResponse, C as FFIDOrganizationMember, D as FFIDOrganizationProfile, E as FFIDOrganizationProfileErrorCode, G as FFIDOrganizationProfileResponse, H as FFIDOtpSendResponse, I as FFIDOtpVerifyResponse, J as FFIDPasswordResetConfirmResponse, K as FFIDPasswordResetResponse, L as FFIDPasswordResetVerifyResponse, M as FFIDProfileCallOptions, N as FFIDProvisionMemberPlan, O as FFIDProvisionMemberPlanStatus, P as FFIDProvisionMemberResult, Q as FFIDProvisionMemberStatus, R as FFIDProvisionOrganizationDryRun, S as FFIDProvisionOrganizationMemberInput, T as FFIDProvisionOrganizationOutcome, U as FFIDProvisionOrganizationParams, V as FFIDProvisionOrganizationResponse, W as FFIDProvisionUserDryRun, X as FFIDProvisionUserOutcome, Y as FFIDProvisionUserParams, Z as FFIDProvisionUserProfileInput, _ as FFIDProvisionUserResponse, $ as FFIDProvisionedOrganization, a0 as FFIDProvisionedUser, a1 as FFIDPublishedPlan, a2 as FFIDRemoveMemberResponse, a3 as FFIDResetSessionResponse, a4 as FFIDSubscription, a5 as FFIDUpdateMemberRoleResponse, a6 as FFIDUpdateUserProfileRequest, a7 as FFIDUploadOrganizationLogoParams, a8 as FFIDUpsertOrganizationProfileParams, a9 as FFIDUpsertOrganizationProfileRequest, aa as FFIDUser, ab as FFIDUserProfile, ac as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ad as FFID_CATALOG_ENVIRONMENTS, ae as FFID_CATALOG_PUBLICATION_STATUSES, af as FFID_COMPANY_SIZE_CODES, ag as FFID_INDUSTRY_CODES, ah as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, aj as FFID_ORGANIZATION_PROFILE_ERROR_CODES, ak as TokenData, al as TokenStore, am as createFFIDClient, an as createTokenStore } from '../ffid-client-6aLs9Fqc.cjs';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-Ce2eXQtB.cjs';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.cjs';

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-5GAPcRIG.js';
-export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDOrganization, B as FFIDOrganizationLogoUploadResponse, C as FFIDOrganizationMember, D as FFIDOrganizationProfile, E as FFIDOrganizationProfileErrorCode, G as FFIDOrganizationProfileResponse, H as FFIDOtpSendResponse, I as FFIDOtpVerifyResponse, J as FFIDPasswordResetConfirmResponse, K as FFIDPasswordResetResponse, L as FFIDPasswordResetVerifyResponse, M as FFIDProfileCallOptions, N as FFIDProvisionMemberPlan, O as FFIDProvisionMemberPlanStatus, P as FFIDProvisionMemberResult, Q as FFIDProvisionMemberStatus, R as FFIDProvisionOrganizationDryRun, S as FFIDProvisionOrganizationMemberInput, T as FFIDProvisionOrganizationOutcome, U as FFIDProvisionOrganizationParams, V as FFIDProvisionOrganizationResponse, W as FFIDProvisionUserDryRun, X as FFIDProvisionUserOutcome, Y as FFIDProvisionUserParams, Z as FFIDProvisionUserProfileInput, _ as FFIDProvisionUserResponse, $ as FFIDProvisionedOrganization, a0 as FFIDProvisionedUser, a1 as FFIDPublishedPlan, a2 as FFIDRemoveMemberResponse, a3 as FFIDResetSessionResponse, a4 as FFIDSubscription, a5 as FFIDUpdateMemberRoleResponse, a6 as FFIDUpdateUserProfileRequest, a7 as FFIDUploadOrganizationLogoParams, a8 as FFIDUpsertOrganizationProfileParams, a9 as FFIDUpsertOrganizationProfileRequest, aa as FFIDUser, ab as FFIDUserProfile, ac as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ad as FFID_CATALOG_ENVIRONMENTS, ae as FFID_CATALOG_PUBLICATION_STATUSES, af as FFID_COMPANY_SIZE_CODES, ag as FFID_INDUSTRY_CODES, ah as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, aj as FFID_ORGANIZATION_PROFILE_ERROR_CODES, ak as TokenData, al as TokenStore, am as createFFIDClient, an as createTokenStore } from '../ffid-client-5GAPcRIG.js';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-B0cORHac.js';
+export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAllowedLogoMimeType, n as FFIDAssignableMemberRole, o as FFIDCacheConfig, p as FFIDCatalogPublication, q as FFIDCatalogPublicationStatus, r as FFIDClient, s as FFIDCompanySizeCode, t as FFIDConfig, u as FFIDIndustryCode, v as FFIDListMembersResponse, w as FFIDListingConsentInput, x as FFIDLogoWallEntry, y as FFIDLogoWallResponse, z as FFIDMemberRole, A as FFIDOrganization, B as FFIDOrganizationLogoUploadResponse, C as FFIDOrganizationMember, D as FFIDOrganizationProfile, E as FFIDOrganizationProfileErrorCode, G as FFIDOrganizationProfileResponse, H as FFIDOtpSendResponse, I as FFIDOtpVerifyResponse, J as FFIDPasswordResetConfirmResponse, K as FFIDPasswordResetResponse, L as FFIDPasswordResetVerifyResponse, M as FFIDProfileCallOptions, N as FFIDProvisionMemberPlan, O as FFIDProvisionMemberPlanStatus, P as FFIDProvisionMemberResult, Q as FFIDProvisionMemberStatus, R as FFIDProvisionOrganizationDryRun, S as FFIDProvisionOrganizationMemberInput, T as FFIDProvisionOrganizationOutcome, U as FFIDProvisionOrganizationParams, V as FFIDProvisionOrganizationResponse, W as FFIDProvisionUserDryRun, X as FFIDProvisionUserOutcome, Y as FFIDProvisionUserParams, Z as FFIDProvisionUserProfileInput, _ as FFIDProvisionUserResponse, $ as FFIDProvisionedOrganization, a0 as FFIDProvisionedUser, a1 as FFIDPublishedPlan, a2 as FFIDRemoveMemberResponse, a3 as FFIDResetSessionResponse, a4 as FFIDSubscription, a5 as FFIDUpdateMemberRoleResponse, a6 as FFIDUpdateUserProfileRequest, a7 as FFIDUploadOrganizationLogoParams, a8 as FFIDUpsertOrganizationProfileParams, a9 as FFIDUpsertOrganizationProfileRequest, aa as FFIDUser, ab as FFIDUserProfile, ac as FFID_ALLOWED_ORGANIZATION_LOGO_MIME_TYPES, ad as FFID_CATALOG_ENVIRONMENTS, ae as FFID_CATALOG_PUBLICATION_STATUSES, af as FFID_COMPANY_SIZE_CODES, ag as FFID_INDUSTRY_CODES, ah as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES, ai as FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB, aj as FFID_ORGANIZATION_PROFILE_ERROR_CODES, ak as TokenData, al as TokenStore, am as createFFIDClient, an as createTokenStore } from '../ffid-client-B0cORHac.js';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-Ce2eXQtB.js';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.js';

package/dist/server/index.js

@@ -222,18 +222,16 @@ function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   ];
 }
 var JWKS_ENDPOINT = "/.well-known/jwks.json";
-var LEGACY_JWT_ISSUER = "https://id.feelflow.net";
 var JWT_ALGORITHM = "ES256";
 var JWT_CLOCK_TOLERANCE_SECONDS = 30;
-function resolveAcceptedIssuers(baseUrl) {
-  const deployedOrigin = new URL(baseUrl).origin;
-  return deployedOrigin === LEGACY_JWT_ISSUER ? [LEGACY_JWT_ISSUER] : [deployedOrigin, LEGACY_JWT_ISSUER];
+function resolveAcceptedIssuer(baseUrl) {
+  return new URL(baseUrl).origin;
 }
 function createJwtVerifier(deps) {
   const { baseUrl, serviceCode, logger, createError, errorCodes } = deps;
   const jwksUrl = new URL(JWKS_ENDPOINT, baseUrl);
   const jwks = createRemoteJWKSet(jwksUrl);
-  const acceptedIssuers = resolveAcceptedIssuers(baseUrl);
+  const acceptedIssuer = resolveAcceptedIssuer(baseUrl);
   async function verifyJwt(accessToken) {
     if (!accessToken || !accessToken.trim()) {
       return {
@@ -246,7 +244,7 @@ function createJwtVerifier(deps) {
     try {
       const { payload } = await jwtVerify(accessToken, jwks, {
         algorithms: [JWT_ALGORITHM],
-        issuer: acceptedIssuers,
+        issuer: acceptedIssuer,
         audience: serviceCode,
         clockTolerance: JWT_CLOCK_TOLERANCE_SECONDS
       });
@@ -1372,7 +1370,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "8.0.0";
+var SDK_VERSION = "9.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/test/index.d.cts

@@ -1,4 +1,4 @@
-import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-BaEmw7jP.cjs';
+import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-6aLs9Fqc.cjs';
 import '../../types-Cjb9J0rL.cjs';
 
 /**

package/dist/server/test/index.d.ts

@@ -1,4 +1,4 @@
-import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-5GAPcRIG.js';
+import { r as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-B0cORHac.js';
 import '../../types-Cjb9J0rL.js';
 
 /**

package/dist/webhooks/index.d.cts

@@ -55,15 +55,46 @@ interface FFIDSubscriptionCreatedPayload {
     status?: string;
     effectiveStatus?: EffectiveSubscriptionStatus;
     gracePeriodEndsAt?: string | null;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    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;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 /**
  * `subscription.reactivated` (8.0.0): a cancellation reserved until the period end was
@@ -81,7 +112,13 @@ interface FFIDSubscriptionReactivatedPayload {
     gracePeriodEndsAt?: string | null;
     stripeSubscriptionId: string;
     stripeCustomerId: string;
-    /** Code of the service the subscription belongs to (resolved by FFID when the event is sent) */
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
     serviceCode?: string;
 }
 /**
@@ -145,6 +182,14 @@ interface FFIDSubscriptionCanceledPayload {
     effectiveStatus?: EffectiveSubscriptionStatus;
     /** Always null for cancellation events because no grace window remains. */
     gracePeriodEndsAt?: string | null;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeScheduledPayload {
     /** FFID subscription UUID. */
@@ -161,6 +206,14 @@ interface FFIDSubscriptionDowngradeScheduledPayload {
     scheduledAt: string;
     /** ISO timestamp when the scheduled downgrade should take effect. */
     effectiveAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeAppliedPayload {
     /** FFID subscription UUID. */
@@ -175,6 +228,14 @@ interface FFIDSubscriptionDowngradeAppliedPayload {
     billingInterval: string;
     /** ISO timestamp when FFID applied the pending downgrade. */
     appliedAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeCanceledPayload {
     /** FFID subscription UUID. */
@@ -187,11 +248,45 @@ interface FFIDSubscriptionDowngradeCanceledPayload {
     currentPlanId: string;
     /** ISO timestamp when the pending downgrade was canceled. */
     canceledAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    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
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionPaymentFailedPayload {
     /**
@@ -249,6 +344,14 @@ interface FFIDSubscriptionPaymentFailedPayload {
      * "backend has no mapping yet" from "payload shape regression".
      */
     correlationUnavailable?: boolean;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDUserCreatedPayload {
     userId: string;

package/dist/webhooks/index.d.ts

@@ -55,15 +55,46 @@ interface FFIDSubscriptionCreatedPayload {
     status?: string;
     effectiveStatus?: EffectiveSubscriptionStatus;
     gracePeriodEndsAt?: string | null;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    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;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 /**
  * `subscription.reactivated` (8.0.0): a cancellation reserved until the period end was
@@ -81,7 +112,13 @@ interface FFIDSubscriptionReactivatedPayload {
     gracePeriodEndsAt?: string | null;
     stripeSubscriptionId: string;
     stripeCustomerId: string;
-    /** Code of the service the subscription belongs to (resolved by FFID when the event is sent) */
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
     serviceCode?: string;
 }
 /**
@@ -145,6 +182,14 @@ interface FFIDSubscriptionCanceledPayload {
     effectiveStatus?: EffectiveSubscriptionStatus;
     /** Always null for cancellation events because no grace window remains. */
     gracePeriodEndsAt?: string | null;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeScheduledPayload {
     /** FFID subscription UUID. */
@@ -161,6 +206,14 @@ interface FFIDSubscriptionDowngradeScheduledPayload {
     scheduledAt: string;
     /** ISO timestamp when the scheduled downgrade should take effect. */
     effectiveAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeAppliedPayload {
     /** FFID subscription UUID. */
@@ -175,6 +228,14 @@ interface FFIDSubscriptionDowngradeAppliedPayload {
     billingInterval: string;
     /** ISO timestamp when FFID applied the pending downgrade. */
     appliedAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionDowngradeCanceledPayload {
     /** FFID subscription UUID. */
@@ -187,11 +248,45 @@ interface FFIDSubscriptionDowngradeCanceledPayload {
     currentPlanId: string;
     /** ISO timestamp when the pending downgrade was canceled. */
     canceledAt: string;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    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
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDSubscriptionPaymentFailedPayload {
     /**
@@ -249,6 +344,14 @@ interface FFIDSubscriptionPaymentFailedPayload {
      * "backend has no mapping yet" from "payload shape regression".
      */
     correlationUnavailable?: boolean;
+    /**
+     * Code of the service the subscription belongs to (e.g. `chatbot-v2`), resolved by FFID when
+     * the event is sent. Every `subscription.*` event is broadcast to all endpoints subscribed to
+     * that event type, so compare this with your own service code to skip events for other
+     * services. Absent only when FFID could not resolve it — do not read absence as
+     * "not addressed to this service".
+     */
+    serviceCode?: string;
 }
 interface FFIDUserCreatedPayload {
     userId: string;

package/package.json

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