@feelflow/ffid-sdk 4.0.0 → 4.1.0

package/dist/{chunk-XQL4YSTL.cjs → chunk-OYCNHBMG.cjs}

@@ -808,7 +808,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "4.0.0";
+var SDK_VERSION = "4.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/{chunk-P35ULJLM.js → chunk-P7HSNT4U.js}

@@ -806,7 +806,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "4.0.0";
+var SDK_VERSION = "4.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/components/index.cjs

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

package/dist/components/index.js

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

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkXQL4YSTL_cjs = require('./chunk-XQL4YSTL.cjs');
+var chunkOYCNHBMG_cjs = require('./chunk-OYCNHBMG.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -53,8 +53,8 @@ function defaultRedirect(url) {
 }
 function useRequireActiveSubscription(options) {
   const { redirectTo, allowGrace = true, onRedirect } = options;
-  const { isLoading, error } = chunkXQL4YSTL_cjs.useFFIDContext();
-  const { effectiveStatus, isBlocked, isGrace } = chunkXQL4YSTL_cjs.useSubscription();
+  const { isLoading, error } = chunkOYCNHBMG_cjs.useFFIDContext();
+  const { effectiveStatus, isBlocked, isGrace } = chunkOYCNHBMG_cjs.useSubscription();
   const hasFetchError = error !== null && effectiveStatus === null;
   const shouldRedirect = !isLoading && !hasFetchError && (isBlocked || !allowGrace && isGrace || effectiveStatus === null);
   react.useEffect(() => {
@@ -75,7 +75,7 @@ function useRequireActiveSubscription(options) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkXQL4YSTL_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkOYCNHBMG_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -104,115 +104,115 @@ var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkOYCNHBMG_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "DEFAULT_OAUTH_SCOPES", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.DEFAULT_OAUTH_SCOPES; }
+  get: function () { return chunkOYCNHBMG_cjs.DEFAULT_OAUTH_SCOPES; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDInquiryForm; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDLoginButton; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDProvider; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDSDKError; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFIDUserMenu; }
+  get: function () { return chunkOYCNHBMG_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkOYCNHBMG_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkOYCNHBMG_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkOYCNHBMG_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "computeEffectiveStatusFromSession", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.computeEffectiveStatusFromSession; }
+  get: function () { return chunkOYCNHBMG_cjs.computeEffectiveStatusFromSession; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkOYCNHBMG_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.createFFIDClient; }
+  get: function () { return chunkOYCNHBMG_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.createTokenStore; }
+  get: function () { return chunkOYCNHBMG_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.generateCodeChallenge; }
+  get: function () { return chunkOYCNHBMG_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.generateCodeVerifier; }
+  get: function () { return chunkOYCNHBMG_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkOYCNHBMG_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.normalizeRedirectUri; }
+  get: function () { return chunkOYCNHBMG_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkOYCNHBMG_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.storeCodeVerifier; }
+  get: function () { return chunkOYCNHBMG_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.useFFID; }
+  get: function () { return chunkOYCNHBMG_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkOYCNHBMG_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.useSubscription; }
+  get: function () { return chunkOYCNHBMG_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkXQL4YSTL_cjs.withSubscription; }
+  get: function () { return chunkOYCNHBMG_cjs.withSubscription; }
 });
 exports.FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS;
 exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-P35ULJLM.js';
-export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-P35ULJLM.js';
+import { useFFIDContext, useSubscription } from './chunk-P7HSNT4U.js';
+export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-P7HSNT4U.js';
 import { useEffect, useRef } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -803,7 +803,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "4.0.0";
+var SDK_VERSION = "4.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/index.js

@@ -802,7 +802,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "4.0.0";
+var SDK_VERSION = "4.1.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/webhooks/index.d.cts

@@ -44,7 +44,7 @@ declare class FFIDWebhookPayloadError extends FFIDWebhookError {
  * Used by external services to handle real-time event notifications.
  */
 /** All supported webhook event types */
-type FFIDWebhookEventType = 'subscription.created' | 'subscription.updated' | 'subscription.canceled' | 'subscription.trial_ending' | 'subscription.payment_failed' | 'user.created' | 'user.updated' | 'user.deleted' | 'user.deletion_requested' | 'organization.created' | 'organization.updated' | 'organization.member.added' | 'organization.member.removed' | 'organization.member.role_changed' | 'legal.document.updated' | 'legal.agreement.required' | 'system.maintenance.scheduled' | 'system.maintenance.started' | 'system.maintenance.completed' | 'announcement.published' | 'test.ping';
+type FFIDWebhookEventType = 'subscription.created' | 'subscription.updated' | 'subscription.canceled' | 'subscription.downgrade_scheduled' | 'subscription.downgrade_applied' | 'subscription.downgrade_canceled' | 'subscription.trial_ending' | 'subscription.payment_failed' | 'user.created' | 'user.updated' | 'user.deleted' | 'user.deletion_requested' | 'organization.created' | 'organization.updated' | 'organization.member.added' | 'organization.member.removed' | 'organization.member.role_changed' | 'legal.document.updated' | 'legal.agreement.required' | 'system.maintenance.scheduled' | 'system.maintenance.started' | 'system.maintenance.completed' | 'announcement.published' | 'test.ping';
 interface FFIDSubscriptionCreatedPayload {
     subscriptionId: string;
     organizationId?: string;
@@ -87,6 +87,48 @@ interface FFIDSubscriptionCanceledPayload {
      */
     expiredAt?: string;
 }
+interface FFIDSubscriptionDowngradeScheduledPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID currently active on the subscription. */
+    currentPlanId: string;
+    /** Plan UUID scheduled to become active at period end. */
+    newPlanId: string;
+    /** Billing interval carried by the target period, typically 'monthly' or 'yearly'. */
+    billingInterval: string;
+    /** ISO timestamp when the downgrade was scheduled. */
+    scheduledAt: string;
+    /** ISO timestamp when the scheduled downgrade should take effect. */
+    effectiveAt: string;
+}
+interface FFIDSubscriptionDowngradeAppliedPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID active before the pending downgrade was applied. */
+    previousPlanId: string;
+    /** Plan UUID that became active after the downgrade was applied. */
+    newPlanId: string;
+    /** Billing interval on the applied downgraded plan, typically 'monthly' or 'yearly'. */
+    billingInterval: string;
+    /** ISO timestamp when FFID applied the pending downgrade. */
+    appliedAt: string;
+}
+interface FFIDSubscriptionDowngradeCanceledPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID that had been pending but was canceled before taking effect. */
+    canceledPlanId: string;
+    /** Plan UUID that remains active after canceling the pending downgrade. */
+    currentPlanId: string;
+    /** ISO timestamp when the pending downgrade was canceled. */
+    canceledAt: string;
+}
 interface FFIDSubscriptionTrialEndingPayload {
     subscriptionId: string;
     organizationId?: string;
@@ -221,6 +263,9 @@ interface FFIDWebhookEventMap {
     'subscription.created': FFIDSubscriptionCreatedPayload;
     'subscription.updated': FFIDSubscriptionUpdatedPayload;
     'subscription.canceled': FFIDSubscriptionCanceledPayload;
+    'subscription.downgrade_scheduled': FFIDSubscriptionDowngradeScheduledPayload;
+    'subscription.downgrade_applied': FFIDSubscriptionDowngradeAppliedPayload;
+    'subscription.downgrade_canceled': FFIDSubscriptionDowngradeCanceledPayload;
     'subscription.trial_ending': FFIDSubscriptionTrialEndingPayload;
     'subscription.payment_failed': FFIDSubscriptionPaymentFailedPayload;
     'user.created': FFIDUserCreatedPayload;
@@ -363,4 +408,4 @@ declare function createFFIDWebhookHandler(config: FFIDWebhookHandlerConfig): {
 /** Type of the FFID Webhook handler */
 type FFIDWebhookHandler = ReturnType<typeof createFFIDWebhookHandler>;
 
-export { DEFAULT_TOLERANCE_SECONDS, type FFIDLegalAgreementRequiredPayload, type FFIDLegalDocumentUpdatedPayload, type FFIDOrganizationCreatedPayload, type FFIDOrganizationMemberAddedPayload, type FFIDOrganizationMemberRemovedPayload, type FFIDOrganizationMemberRoleChangedPayload, type FFIDOrganizationUpdatedPayload, type FFIDSubscriptionCanceledPayload, type FFIDSubscriptionCreatedPayload, type FFIDSubscriptionPaymentFailedPayload, type FFIDSubscriptionTrialEndingPayload, type FFIDSubscriptionUpdatedPayload, type FFIDSystemMaintenancePayload, type FFIDTestPingPayload, type FFIDUserCreatedPayload, type FFIDUserDeletedPayload, type FFIDUserDeletionRequestedPayload, type FFIDUserUpdatedPayload, FFIDWebhookError, type FFIDWebhookEvent, type FFIDWebhookEventHandler, type FFIDWebhookEventMap, type FFIDWebhookEventType, type FFIDWebhookHandler, type FFIDWebhookHandlerConfig, type FFIDWebhookLogger, FFIDWebhookPayloadError, FFIDWebhookSignatureError, FFIDWebhookTimestampError, FFID_WEBHOOK_EVENT_ID_HEADER, FFID_WEBHOOK_SIGNATURE_HEADER, FFID_WEBHOOK_SIGNATURE_VERSION, FFID_WEBHOOK_TIMESTAMP_HEADER, computeSignature, createFFIDWebhookHandler, parseSignatureHeader, verifyWebhookSignature };
+export { DEFAULT_TOLERANCE_SECONDS, type FFIDLegalAgreementRequiredPayload, type FFIDLegalDocumentUpdatedPayload, type FFIDOrganizationCreatedPayload, type FFIDOrganizationMemberAddedPayload, type FFIDOrganizationMemberRemovedPayload, type FFIDOrganizationMemberRoleChangedPayload, type FFIDOrganizationUpdatedPayload, type FFIDSubscriptionCanceledPayload, type FFIDSubscriptionCreatedPayload, type FFIDSubscriptionDowngradeAppliedPayload, type FFIDSubscriptionDowngradeCanceledPayload, type FFIDSubscriptionDowngradeScheduledPayload, type FFIDSubscriptionPaymentFailedPayload, type FFIDSubscriptionTrialEndingPayload, type FFIDSubscriptionUpdatedPayload, type FFIDSystemMaintenancePayload, type FFIDTestPingPayload, type FFIDUserCreatedPayload, type FFIDUserDeletedPayload, type FFIDUserDeletionRequestedPayload, type FFIDUserUpdatedPayload, FFIDWebhookError, type FFIDWebhookEvent, type FFIDWebhookEventHandler, type FFIDWebhookEventMap, type FFIDWebhookEventType, type FFIDWebhookHandler, type FFIDWebhookHandlerConfig, type FFIDWebhookLogger, FFIDWebhookPayloadError, FFIDWebhookSignatureError, FFIDWebhookTimestampError, FFID_WEBHOOK_EVENT_ID_HEADER, FFID_WEBHOOK_SIGNATURE_HEADER, FFID_WEBHOOK_SIGNATURE_VERSION, FFID_WEBHOOK_TIMESTAMP_HEADER, computeSignature, createFFIDWebhookHandler, parseSignatureHeader, verifyWebhookSignature };

package/dist/webhooks/index.d.ts

@@ -44,7 +44,7 @@ declare class FFIDWebhookPayloadError extends FFIDWebhookError {
  * Used by external services to handle real-time event notifications.
  */
 /** All supported webhook event types */
-type FFIDWebhookEventType = 'subscription.created' | 'subscription.updated' | 'subscription.canceled' | 'subscription.trial_ending' | 'subscription.payment_failed' | 'user.created' | 'user.updated' | 'user.deleted' | 'user.deletion_requested' | 'organization.created' | 'organization.updated' | 'organization.member.added' | 'organization.member.removed' | 'organization.member.role_changed' | 'legal.document.updated' | 'legal.agreement.required' | 'system.maintenance.scheduled' | 'system.maintenance.started' | 'system.maintenance.completed' | 'announcement.published' | 'test.ping';
+type FFIDWebhookEventType = 'subscription.created' | 'subscription.updated' | 'subscription.canceled' | 'subscription.downgrade_scheduled' | 'subscription.downgrade_applied' | 'subscription.downgrade_canceled' | 'subscription.trial_ending' | 'subscription.payment_failed' | 'user.created' | 'user.updated' | 'user.deleted' | 'user.deletion_requested' | 'organization.created' | 'organization.updated' | 'organization.member.added' | 'organization.member.removed' | 'organization.member.role_changed' | 'legal.document.updated' | 'legal.agreement.required' | 'system.maintenance.scheduled' | 'system.maintenance.started' | 'system.maintenance.completed' | 'announcement.published' | 'test.ping';
 interface FFIDSubscriptionCreatedPayload {
     subscriptionId: string;
     organizationId?: string;
@@ -87,6 +87,48 @@ interface FFIDSubscriptionCanceledPayload {
      */
     expiredAt?: string;
 }
+interface FFIDSubscriptionDowngradeScheduledPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID currently active on the subscription. */
+    currentPlanId: string;
+    /** Plan UUID scheduled to become active at period end. */
+    newPlanId: string;
+    /** Billing interval carried by the target period, typically 'monthly' or 'yearly'. */
+    billingInterval: string;
+    /** ISO timestamp when the downgrade was scheduled. */
+    scheduledAt: string;
+    /** ISO timestamp when the scheduled downgrade should take effect. */
+    effectiveAt: string;
+}
+interface FFIDSubscriptionDowngradeAppliedPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID active before the pending downgrade was applied. */
+    previousPlanId: string;
+    /** Plan UUID that became active after the downgrade was applied. */
+    newPlanId: string;
+    /** Billing interval on the applied downgraded plan, typically 'monthly' or 'yearly'. */
+    billingInterval: string;
+    /** ISO timestamp when FFID applied the pending downgrade. */
+    appliedAt: string;
+}
+interface FFIDSubscriptionDowngradeCanceledPayload {
+    /** FFID subscription UUID. */
+    subscriptionId: string;
+    /** Organization UUID that owns the subscription. */
+    organizationId: string;
+    /** Plan UUID that had been pending but was canceled before taking effect. */
+    canceledPlanId: string;
+    /** Plan UUID that remains active after canceling the pending downgrade. */
+    currentPlanId: string;
+    /** ISO timestamp when the pending downgrade was canceled. */
+    canceledAt: string;
+}
 interface FFIDSubscriptionTrialEndingPayload {
     subscriptionId: string;
     organizationId?: string;
@@ -221,6 +263,9 @@ interface FFIDWebhookEventMap {
     'subscription.created': FFIDSubscriptionCreatedPayload;
     'subscription.updated': FFIDSubscriptionUpdatedPayload;
     'subscription.canceled': FFIDSubscriptionCanceledPayload;
+    'subscription.downgrade_scheduled': FFIDSubscriptionDowngradeScheduledPayload;
+    'subscription.downgrade_applied': FFIDSubscriptionDowngradeAppliedPayload;
+    'subscription.downgrade_canceled': FFIDSubscriptionDowngradeCanceledPayload;
     'subscription.trial_ending': FFIDSubscriptionTrialEndingPayload;
     'subscription.payment_failed': FFIDSubscriptionPaymentFailedPayload;
     'user.created': FFIDUserCreatedPayload;
@@ -363,4 +408,4 @@ declare function createFFIDWebhookHandler(config: FFIDWebhookHandlerConfig): {
 /** Type of the FFID Webhook handler */
 type FFIDWebhookHandler = ReturnType<typeof createFFIDWebhookHandler>;
 
-export { DEFAULT_TOLERANCE_SECONDS, type FFIDLegalAgreementRequiredPayload, type FFIDLegalDocumentUpdatedPayload, type FFIDOrganizationCreatedPayload, type FFIDOrganizationMemberAddedPayload, type FFIDOrganizationMemberRemovedPayload, type FFIDOrganizationMemberRoleChangedPayload, type FFIDOrganizationUpdatedPayload, type FFIDSubscriptionCanceledPayload, type FFIDSubscriptionCreatedPayload, type FFIDSubscriptionPaymentFailedPayload, type FFIDSubscriptionTrialEndingPayload, type FFIDSubscriptionUpdatedPayload, type FFIDSystemMaintenancePayload, type FFIDTestPingPayload, type FFIDUserCreatedPayload, type FFIDUserDeletedPayload, type FFIDUserDeletionRequestedPayload, type FFIDUserUpdatedPayload, FFIDWebhookError, type FFIDWebhookEvent, type FFIDWebhookEventHandler, type FFIDWebhookEventMap, type FFIDWebhookEventType, type FFIDWebhookHandler, type FFIDWebhookHandlerConfig, type FFIDWebhookLogger, FFIDWebhookPayloadError, FFIDWebhookSignatureError, FFIDWebhookTimestampError, FFID_WEBHOOK_EVENT_ID_HEADER, FFID_WEBHOOK_SIGNATURE_HEADER, FFID_WEBHOOK_SIGNATURE_VERSION, FFID_WEBHOOK_TIMESTAMP_HEADER, computeSignature, createFFIDWebhookHandler, parseSignatureHeader, verifyWebhookSignature };
+export { DEFAULT_TOLERANCE_SECONDS, type FFIDLegalAgreementRequiredPayload, type FFIDLegalDocumentUpdatedPayload, type FFIDOrganizationCreatedPayload, type FFIDOrganizationMemberAddedPayload, type FFIDOrganizationMemberRemovedPayload, type FFIDOrganizationMemberRoleChangedPayload, type FFIDOrganizationUpdatedPayload, type FFIDSubscriptionCanceledPayload, type FFIDSubscriptionCreatedPayload, type FFIDSubscriptionDowngradeAppliedPayload, type FFIDSubscriptionDowngradeCanceledPayload, type FFIDSubscriptionDowngradeScheduledPayload, type FFIDSubscriptionPaymentFailedPayload, type FFIDSubscriptionTrialEndingPayload, type FFIDSubscriptionUpdatedPayload, type FFIDSystemMaintenancePayload, type FFIDTestPingPayload, type FFIDUserCreatedPayload, type FFIDUserDeletedPayload, type FFIDUserDeletionRequestedPayload, type FFIDUserUpdatedPayload, FFIDWebhookError, type FFIDWebhookEvent, type FFIDWebhookEventHandler, type FFIDWebhookEventMap, type FFIDWebhookEventType, type FFIDWebhookHandler, type FFIDWebhookHandlerConfig, type FFIDWebhookLogger, FFIDWebhookPayloadError, FFIDWebhookSignatureError, FFIDWebhookTimestampError, FFID_WEBHOOK_EVENT_ID_HEADER, FFID_WEBHOOK_SIGNATURE_HEADER, FFID_WEBHOOK_SIGNATURE_VERSION, FFID_WEBHOOK_TIMESTAMP_HEADER, computeSignature, createFFIDWebhookHandler, parseSignatureHeader, verifyWebhookSignature };

package/package.json

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