@feelflow/ffid-sdk 2.21.0 → 3.0.0

package/dist/{ffid-client-DgJRU-YZ.d.ts → ffid-client-B26jbUp5.d.ts}

@@ -127,6 +127,40 @@ interface FFIDNewsletterUnsubscribeParams {
 interface FFIDNewsletterUnsubscribeResponse {
     ok: true;
 }
+type FFIDNewsletterCampaignStatus = 'draft' | 'queued' | 'sending' | 'sent' | 'failed' | 'cancelled';
+type FFIDNewsletterSegment = {
+    type: 'all';
+} | {
+    type: 'filter';
+    conditions: Record<string, unknown>;
+};
+/**
+ * Body source XOR — exactly one of `htmlBody` / `templateId` must be set.
+ * V1 only ships `htmlBody`; `templateId` is reserved for SendGrid dynamic
+ * templates and is rejected server-side until that work lands.
+ */
+type FFIDNewsletterBodySource = {
+    htmlBody: string;
+    templateId?: never;
+} | {
+    templateId: string;
+    htmlBody?: never;
+};
+interface FFIDNewsletterDispatchParams {
+    subject: string;
+    /** Optional landing-page URL persisted on `newsletter_campaigns.article_url`. */
+    articleUrl?: string;
+    body: FFIDNewsletterBodySource;
+    /** Defaults to `{ type: 'all' }` server-side when omitted. */
+    segment?: FFIDNewsletterSegment;
+}
+interface FFIDNewsletterDispatchResponse {
+    campaignId: string;
+    totalRecipients: number;
+    status: FFIDNewsletterCampaignStatus;
+    sentCount: number;
+    failedCount: number;
+}
 
 /** Cache adapter interface for FFID SDK token verification */
 /**
@@ -589,6 +623,19 @@ interface FFIDVerifyAccessTokenOptions {
 interface FFIDConfig {
     /** Service code to identify your application */
     serviceCode: string;
+    /**
+     * OAuth 2.0 scope (space-separated). Required since v3.0.0 (#2674).
+     *
+     * Use `DEFAULT_OAUTH_SCOPES` from `@feelflow/ffid-sdk` for the recommended
+     * baseline, or specify a least-privilege subset for your use case. Phase 3
+     * of `feelflow-id-platform#2656` will reject `/oauth/authorize` requests
+     * without this parameter, so passing an empty string here is also rejected
+     * — **except** in `service-key` mode (server-to-server, never calls
+     * `/oauth/authorize`), where `''` is permitted at runtime.
+     *
+     * @example 'openid email profile subscription:read legal:read'
+     */
+    scope: string;
     /** FFID API base URL (defaults to production) */
     apiBaseUrl?: string | undefined;
     /**
@@ -1125,6 +1172,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
         confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
         unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+        dispatch: (params: FFIDNewsletterDispatchParams) => Promise<FFIDApiResponse<FFIDNewsletterDispatchResponse>>;
     };
     /** Inquiry methods (create) */
     inquiry: {

package/dist/{index-Dr5G9HQ4.d.cts → index-C3zyNa4j.d.cts}

@@ -192,6 +192,19 @@ interface FFIDVerifyAccessTokenOptions {
 interface FFIDConfig {
     /** Service code to identify your application */
     serviceCode: string;
+    /**
+     * OAuth 2.0 scope (space-separated). Required since v3.0.0 (#2674).
+     *
+     * Use `DEFAULT_OAUTH_SCOPES` from `@feelflow/ffid-sdk` for the recommended
+     * baseline, or specify a least-privilege subset for your use case. Phase 3
+     * of `feelflow-id-platform#2656` will reject `/oauth/authorize` requests
+     * without this parameter, so passing an empty string here is also rejected
+     * — **except** in `service-key` mode (server-to-server, never calls
+     * `/oauth/authorize`), where `''` is permitted at runtime.
+     *
+     * @example 'openid email profile subscription:read legal:read'
+     */
+    scope: string;
     /** FFID API base URL (defaults to production) */
     apiBaseUrl?: string | undefined;
     /**

package/dist/{index-Dr5G9HQ4.d.ts → index-C3zyNa4j.d.ts}

@@ -192,6 +192,19 @@ interface FFIDVerifyAccessTokenOptions {
 interface FFIDConfig {
     /** Service code to identify your application */
     serviceCode: string;
+    /**
+     * OAuth 2.0 scope (space-separated). Required since v3.0.0 (#2674).
+     *
+     * Use `DEFAULT_OAUTH_SCOPES` from `@feelflow/ffid-sdk` for the recommended
+     * baseline, or specify a least-privilege subset for your use case. Phase 3
+     * of `feelflow-id-platform#2656` will reject `/oauth/authorize` requests
+     * without this parameter, so passing an empty string here is also rejected
+     * — **except** in `service-key` mode (server-to-server, never calls
+     * `/oauth/authorize`), where `''` is permitted at runtime.
+     *
+     * @example 'openid email profile subscription:read legal:read'
+     */
+    scope: string;
     /** FFID API base URL (defaults to production) */
     apiBaseUrl?: string | undefined;
     /**

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkHUU4Q5VH_cjs = require('./chunk-HUU4Q5VH.cjs');
+var chunkJNR4AKL5_cjs = require('./chunk-JNR4AKL5.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 } = chunkHUU4Q5VH_cjs.useFFIDContext();
-  const { effectiveStatus, isBlocked, isGrace } = chunkHUU4Q5VH_cjs.useSubscription();
+  const { isLoading, error } = chunkJNR4AKL5_cjs.useFFIDContext();
+  const { effectiveStatus, isBlocked, isGrace } = chunkJNR4AKL5_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 } = chunkHUU4Q5VH_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkJNR4AKL5_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -100,115 +100,121 @@ function withFFIDAuth(Component, options = {}) {
 
 // src/newsletter/types.ts
 var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
+var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkJNR4AKL5_cjs.DEFAULT_API_BASE_URL; }
+});
+Object.defineProperty(exports, "DEFAULT_OAUTH_SCOPES", {
+  enumerable: true,
+  get: function () { return chunkJNR4AKL5_cjs.DEFAULT_OAUTH_SCOPES; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDInquiryForm; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDLoginButton; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDProvider; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDSDKError; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFIDUserMenu; }
+  get: function () { return chunkJNR4AKL5_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkJNR4AKL5_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkJNR4AKL5_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkJNR4AKL5_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "computeEffectiveStatusFromSession", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.computeEffectiveStatusFromSession; }
+  get: function () { return chunkJNR4AKL5_cjs.computeEffectiveStatusFromSession; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkJNR4AKL5_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.createFFIDClient; }
+  get: function () { return chunkJNR4AKL5_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.createTokenStore; }
+  get: function () { return chunkJNR4AKL5_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.generateCodeChallenge; }
+  get: function () { return chunkJNR4AKL5_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.generateCodeVerifier; }
+  get: function () { return chunkJNR4AKL5_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkJNR4AKL5_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.normalizeRedirectUri; }
+  get: function () { return chunkJNR4AKL5_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkJNR4AKL5_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.storeCodeVerifier; }
+  get: function () { return chunkJNR4AKL5_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.useFFID; }
+  get: function () { return chunkJNR4AKL5_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkJNR4AKL5_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.useSubscription; }
+  get: function () { return chunkJNR4AKL5_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkHUU4Q5VH_cjs.withSubscription; }
+  get: function () { return chunkJNR4AKL5_cjs.withSubscription; }
 });
+exports.FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS;
 exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;
 exports.createKVCacheAdapter = createKVCacheAdapter;
 exports.createMemoryCacheAdapter = createMemoryCacheAdapter;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-Dr5G9HQ4.cjs';
-export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-Dr5G9HQ4.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-C3zyNa4j.cjs';
+export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-C3zyNa4j.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -11,6 +11,31 @@ import { ReactNode, ComponentType, FC } from 'react';
  */
 /** Default FFID API base URL (production) */
 declare const DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+/**
+ * Recommended default OAuth scope set for FFID-connected services (v3.0.0+).
+ *
+ * Coverage:
+ * - `openid email profile` — OIDC standard claims (always required)
+ * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系（プラン / 課金 gate）
+ * - `legal:read` — `/api/v1/legal/ext` 系（利用規約・同意状態）
+ *
+ * Add feature-specific scopes on top of this when needed (browser SDK):
+ * - `analytics:read` for `/api/v1/ext/analytics/config`
+ * - `organization:read` / `organization:write` for `/api/v1/organizations/ext/members`
+ * - `subscription:write` for self-serve plan changes
+ * - `legal:write` for recording user consent
+ * - `profile:read` / `profile:write` for profile UI
+ * - `organization:api-key` for org-level API key issuance
+ *
+ * **Note**: kept as a widened `string` (not `as const`) so consumers can
+ * concatenate additional scopes (e.g. `\`${DEFAULT_OAUTH_SCOPES} analytics:read\``)
+ * and so it remains assignable to `FFIDConfig.scope: string`. `widget:verify`
+ * is intentionally excluded — it is a service-key-only scope (`/api/v1/widget/*`),
+ * not used by the browser OAuth flow.
+ *
+ * Survey: feel-flow/feelflow-id-platform#2656 issuecomment-4324082742
+ */
+declare const DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
 
 /**
  * Token Store
@@ -543,6 +568,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
         confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
         unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+        dispatch: (params: FFIDNewsletterDispatchParams) => Promise<FFIDApiResponse<FFIDNewsletterDispatchResponse>>;
     };
     /** Inquiry methods (create) */
     inquiry: {
@@ -633,7 +659,7 @@ interface FFIDProviderProps extends FFIDConfig {
  * - Automatic session refresh
  * - Token mode: automatic code exchange and token refresh
  */
-declare function FFIDProvider({ children, serviceCode, apiBaseUrl, debug, logger, refreshInterval, onAuthStateChange, onError, authMode, clientId, }: FFIDProviderProps): react_jsx_runtime.JSX.Element;
+declare function FFIDProvider({ children, serviceCode, scope, apiBaseUrl, debug, logger, refreshInterval, onAuthStateChange, onError, authMode, clientId, }: FFIDProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Return type for useFFID hook
@@ -1082,6 +1108,42 @@ interface FFIDNewsletterUnsubscribeParams {
 interface FFIDNewsletterUnsubscribeResponse {
     ok: true;
 }
+/** Recipient cap on a single dispatch — mirrors NEWSLETTER_DISPATCH_MAX_RECIPIENTS. */
+declare const FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1000;
+type FFIDNewsletterCampaignStatus = 'draft' | 'queued' | 'sending' | 'sent' | 'failed' | 'cancelled';
+type FFIDNewsletterSegment = {
+    type: 'all';
+} | {
+    type: 'filter';
+    conditions: Record<string, unknown>;
+};
+/**
+ * Body source XOR — exactly one of `htmlBody` / `templateId` must be set.
+ * V1 only ships `htmlBody`; `templateId` is reserved for SendGrid dynamic
+ * templates and is rejected server-side until that work lands.
+ */
+type FFIDNewsletterBodySource = {
+    htmlBody: string;
+    templateId?: never;
+} | {
+    templateId: string;
+    htmlBody?: never;
+};
+interface FFIDNewsletterDispatchParams {
+    subject: string;
+    /** Optional landing-page URL persisted on `newsletter_campaigns.article_url`. */
+    articleUrl?: string;
+    body: FFIDNewsletterBodySource;
+    /** Defaults to `{ type: 'all' }` server-side when omitted. */
+    segment?: FFIDNewsletterSegment;
+}
+interface FFIDNewsletterDispatchResponse {
+    campaignId: string;
+    totalRecipients: number;
+    status: FFIDNewsletterCampaignStatus;
+    sentCount: number;
+    failedCount: number;
+}
 
 /** Newsletter methods - subscribe / confirm / unsubscribe */
 
@@ -1094,6 +1156,7 @@ declare function createNewsletterMethods(deps: NewsletterMethodsDeps): {
     subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
     confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
     unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    dispatch: (params: FFIDNewsletterDispatchParams) => Promise<FFIDApiResponse<FFIDNewsletterDispatchResponse>>;
 };
 type FFIDNewsletterClient = ReturnType<typeof createNewsletterMethods>;
 
@@ -1108,4 +1171,4 @@ declare function createInquiryMethods(deps: InquiryMethodsDeps): {
 };
 type FFIDInquiryClient = ReturnType<typeof createInquiryMethods>;
 
-export { AnnouncementListResponse, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, EffectiveSubscriptionStatus, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUpdateUserProfileRequest, FFIDUser, FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useRequireActiveSubscription, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EffectiveSubscriptionStatus, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, type FFIDNewsletterBodySource, type FFIDNewsletterCampaignStatus, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterDispatchParams, type FFIDNewsletterDispatchResponse, type FFIDNewsletterSegment, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUpdateUserProfileRequest, FFIDUser, FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useRequireActiveSubscription, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-Dr5G9HQ4.js';
-export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-Dr5G9HQ4.js';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDAnalyticsConfig, o as FFIDCreateCheckoutParams, p as FFIDCheckoutSessionResponse, q as FFIDCreatePortalParams, r as FFIDPortalSessionResponse, s as FFIDVerifyAccessTokenOptions, t as FFIDOAuthUserInfo, u as FFIDInquiryCreateParams, v as FFIDInquiryCreateResponse, w as FFIDAuthMode, x as FFIDLogger, y as FFIDCacheAdapter, z as FFIDUser, A as FFIDOrganization, B as FFIDSubscription, C as FFIDSubscriptionContextValue, E as EffectiveSubscriptionStatus, D as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, G as FFIDAnnouncementsApiResponse, H as AnnouncementListResponse, I as FFIDAnnouncementsLogger } from './index-C3zyNa4j.js';
+export { J as Announcement, K as AnnouncementStatus, M as AnnouncementType, N as FFIDAnnouncementBadge, O as FFIDAnnouncementList, P as FFIDAnnouncementsError, Q as FFIDAnnouncementsErrorCode, R as FFIDAnnouncementsServerResponse, S as FFIDCacheConfig, T as FFIDContextValue, U as FFIDInquiryCategory, V as FFIDInquiryCategorySite2026, W as FFIDInquiryForm, X as FFIDInquiryFormCategoryItem, Y as FFIDInquiryFormClassNames, Z as FFIDInquiryFormOrganization, _ as FFIDInquiryFormPlaceholderContext, $ as FFIDInquiryFormPrefill, a0 as FFIDInquiryFormProps, a1 as FFIDInquiryFormSubmitData, a2 as FFIDInquiryFormSubmitResult, a3 as FFIDJwtClaims, a4 as FFIDLoginButton, a5 as FFIDMemberStatus, a6 as FFIDOAuthTokenResponse, a7 as FFIDOAuthUserInfoMemberRole, a8 as FFIDOAuthUserInfoSubscription, a9 as FFIDOrganizationMember, aa as FFIDOrganizationSwitcher, ab as FFIDRedirectErrorCode, ac as FFIDSeatModel, ad as FFIDSubscriptionBadge, ae as FFIDTokenIntrospectionResponse, af as FFIDUserMenu, ag as FFID_INQUIRY_CATEGORIES, ah as FFID_INQUIRY_CATEGORIES_SITE_2026, ai as UseFFIDAnnouncementsOptions, aj as UseFFIDAnnouncementsReturn, ak as isFFIDInquiryCategorySite2026, al as useFFIDAnnouncements } from './index-C3zyNa4j.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 
@@ -11,6 +11,31 @@ import { ReactNode, ComponentType, FC } from 'react';
  */
 /** Default FFID API base URL (production) */
 declare const DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+/**
+ * Recommended default OAuth scope set for FFID-connected services (v3.0.0+).
+ *
+ * Coverage:
+ * - `openid email profile` — OIDC standard claims (always required)
+ * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系（プラン / 課金 gate）
+ * - `legal:read` — `/api/v1/legal/ext` 系（利用規約・同意状態）
+ *
+ * Add feature-specific scopes on top of this when needed (browser SDK):
+ * - `analytics:read` for `/api/v1/ext/analytics/config`
+ * - `organization:read` / `organization:write` for `/api/v1/organizations/ext/members`
+ * - `subscription:write` for self-serve plan changes
+ * - `legal:write` for recording user consent
+ * - `profile:read` / `profile:write` for profile UI
+ * - `organization:api-key` for org-level API key issuance
+ *
+ * **Note**: kept as a widened `string` (not `as const`) so consumers can
+ * concatenate additional scopes (e.g. `\`${DEFAULT_OAUTH_SCOPES} analytics:read\``)
+ * and so it remains assignable to `FFIDConfig.scope: string`. `widget:verify`
+ * is intentionally excluded — it is a service-key-only scope (`/api/v1/widget/*`),
+ * not used by the browser OAuth flow.
+ *
+ * Survey: feel-flow/feelflow-id-platform#2656 issuecomment-4324082742
+ */
+declare const DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
 
 /**
  * Token Store
@@ -543,6 +568,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
         confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
         unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+        dispatch: (params: FFIDNewsletterDispatchParams) => Promise<FFIDApiResponse<FFIDNewsletterDispatchResponse>>;
     };
     /** Inquiry methods (create) */
     inquiry: {
@@ -633,7 +659,7 @@ interface FFIDProviderProps extends FFIDConfig {
  * - Automatic session refresh
  * - Token mode: automatic code exchange and token refresh
  */
-declare function FFIDProvider({ children, serviceCode, apiBaseUrl, debug, logger, refreshInterval, onAuthStateChange, onError, authMode, clientId, }: FFIDProviderProps): react_jsx_runtime.JSX.Element;
+declare function FFIDProvider({ children, serviceCode, scope, apiBaseUrl, debug, logger, refreshInterval, onAuthStateChange, onError, authMode, clientId, }: FFIDProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Return type for useFFID hook
@@ -1082,6 +1108,42 @@ interface FFIDNewsletterUnsubscribeParams {
 interface FFIDNewsletterUnsubscribeResponse {
     ok: true;
 }
+/** Recipient cap on a single dispatch — mirrors NEWSLETTER_DISPATCH_MAX_RECIPIENTS. */
+declare const FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1000;
+type FFIDNewsletterCampaignStatus = 'draft' | 'queued' | 'sending' | 'sent' | 'failed' | 'cancelled';
+type FFIDNewsletterSegment = {
+    type: 'all';
+} | {
+    type: 'filter';
+    conditions: Record<string, unknown>;
+};
+/**
+ * Body source XOR — exactly one of `htmlBody` / `templateId` must be set.
+ * V1 only ships `htmlBody`; `templateId` is reserved for SendGrid dynamic
+ * templates and is rejected server-side until that work lands.
+ */
+type FFIDNewsletterBodySource = {
+    htmlBody: string;
+    templateId?: never;
+} | {
+    templateId: string;
+    htmlBody?: never;
+};
+interface FFIDNewsletterDispatchParams {
+    subject: string;
+    /** Optional landing-page URL persisted on `newsletter_campaigns.article_url`. */
+    articleUrl?: string;
+    body: FFIDNewsletterBodySource;
+    /** Defaults to `{ type: 'all' }` server-side when omitted. */
+    segment?: FFIDNewsletterSegment;
+}
+interface FFIDNewsletterDispatchResponse {
+    campaignId: string;
+    totalRecipients: number;
+    status: FFIDNewsletterCampaignStatus;
+    sentCount: number;
+    failedCount: number;
+}
 
 /** Newsletter methods - subscribe / confirm / unsubscribe */
 
@@ -1094,6 +1156,7 @@ declare function createNewsletterMethods(deps: NewsletterMethodsDeps): {
     subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
     confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
     unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    dispatch: (params: FFIDNewsletterDispatchParams) => Promise<FFIDApiResponse<FFIDNewsletterDispatchResponse>>;
 };
 type FFIDNewsletterClient = ReturnType<typeof createNewsletterMethods>;
 
@@ -1108,4 +1171,4 @@ declare function createInquiryMethods(deps: InquiryMethodsDeps): {
 };
 type FFIDInquiryClient = ReturnType<typeof createInquiryMethods>;
 
-export { AnnouncementListResponse, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, EffectiveSubscriptionStatus, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUpdateUserProfileRequest, FFIDUser, FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useRequireActiveSubscription, useSubscription, withFFIDAuth, withSubscription };
+export { AnnouncementListResponse, type ComputeEffectiveStatusInput, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EffectiveSubscriptionStatus, FFIDAnnouncementsApiResponse, type FFIDAnnouncementsClient, FFIDAnnouncementsClientConfig, FFIDAnnouncementsLogger, FFIDApiResponse, type FFIDBillingInterval, FFIDCacheAdapter, type FFIDCancelPendingDowngradeResponse, type FFIDCancelSubscriptionParams, type FFIDCancelSubscriptionResponse, type FFIDChangePlanParams, type FFIDChangePlanResponse, FFIDCheckoutSessionResponse, type FFIDClient, FFIDConfig, FFIDCreateCheckoutParams, FFIDCreatePortalParams, FFIDError, type FFIDInquiryClient, FFIDInquiryCreateParams, FFIDInquiryCreateResponse, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, type FFIDNewsletterBodySource, type FFIDNewsletterCampaignStatus, type FFIDNewsletterClient, type FFIDNewsletterConfirmParams, type FFIDNewsletterConfirmResponse, type FFIDNewsletterDispatchParams, type FFIDNewsletterDispatchResponse, type FFIDNewsletterSegment, type FFIDNewsletterSubscribeParams, type FFIDNewsletterSubscribeResponse, type FFIDNewsletterType, type FFIDNewsletterUnsubscribeParams, type FFIDNewsletterUnsubscribeResponse, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, type FFIDPreviewSeatChangeParams, FFIDProfileCallOptions, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, FFIDSDKError, type FFIDSeatChangeLineItem, type FFIDSeatChangePreview, type FFIDSeatChangePreviewResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUpdateUserProfileRequest, FFIDUser, FFIDUserProfile, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type NormalizeRedirectUriResult, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type UseRequireActiveSubscriptionOptions, type UseRequireActiveSubscriptionReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, computeEffectiveStatusFromSession, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useRequireActiveSubscription, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-I7NEMG52.js';
-export { DEFAULT_API_BASE_URL, 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-I7NEMG52.js';
+import { useFFIDContext, useSubscription } from './chunk-XWI4BFKW.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-XWI4BFKW.js';
 import { useEffect, useRef } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 
@@ -99,5 +99,6 @@ function withFFIDAuth(Component, options = {}) {
 
 // src/newsletter/types.ts
 var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
+var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
-export { FFID_NEWSLETTER_TYPES, createKVCacheAdapter, createMemoryCacheAdapter, useRequireActiveSubscription, withFFIDAuth };
+export { FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS, FFID_NEWSLETTER_TYPES, createKVCacheAdapter, createMemoryCacheAdapter, useRequireActiveSubscription, withFFIDAuth };

package/dist/legal/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkYUIITYBE_cjs = require('../chunk-YUIITYBE.cjs');
+var chunkMDHKSVLP_cjs = require('../chunk-MDHKSVLP.cjs');
 
 // src/legal/ffid-legal-client.ts
 var API_PREFIX = "/api/v1/legal/ext";
@@ -37,7 +37,7 @@ function createFFIDLegalClient(config) {
   if (!config.apiKey) {
     throw new Error("FFID Legal Client: apiKey \u304C\u672A\u8A2D\u5B9A\u3067\u3059");
   }
-  const baseUrl = config.apiBaseUrl ?? chunkYUIITYBE_cjs.DEFAULT_API_BASE_URL;
+  const baseUrl = config.apiBaseUrl ?? chunkMDHKSVLP_cjs.DEFAULT_API_BASE_URL;
   const logger = config.logger ?? (config.debug ? consoleLogger : noopLogger);
   async function fetchWithApiKey(endpoint, options = {}) {
     const url = `${baseUrl}${API_PREFIX}${endpoint}`;
@@ -176,7 +176,7 @@ function createFFIDLegalClient(config) {
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkYUIITYBE_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkMDHKSVLP_cjs.DEFAULT_API_BASE_URL; }
 });
 exports.FFID_LEGAL_ERROR_CODES = FFID_LEGAL_ERROR_CODES;
 exports.createFFIDLegalClient = createFFIDLegalClient;

package/dist/legal/index.d.cts

@@ -1,4 +1,4 @@
-export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.cjs';
+export { D as DEFAULT_API_BASE_URL } from '../constants-D61jqRIO.cjs';
 
 /**
  * FFID Legal SDK Type Definitions

package/dist/legal/index.d.ts

@@ -1,4 +1,4 @@
-export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.js';
+export { D as DEFAULT_API_BASE_URL } from '../constants-D61jqRIO.js';
 
 /**
  * FFID Legal SDK Type Definitions

package/dist/legal/index.js

@@ -1,5 +1,5 @@
-import { DEFAULT_API_BASE_URL } from '../chunk-QBRM2RRC.js';
-export { DEFAULT_API_BASE_URL } from '../chunk-QBRM2RRC.js';
+import { DEFAULT_API_BASE_URL } from '../chunk-JEVK2XUM.js';
+export { DEFAULT_API_BASE_URL } from '../chunk-JEVK2XUM.js';
 
 // src/legal/ffid-legal-client.ts
 var API_PREFIX = "/api/v1/legal/ext";