@feelflow/ffid-sdk 2.6.0 → 2.7.0

package/dist/{chunk-ZORI5YFR.cjs → chunk-I6MKRVUB.cjs}

@@ -621,7 +621,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.6.0";
+var SDK_VERSION = "2.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1565,6 +1565,118 @@ function createContractWizardMethods(deps) {
   };
 }
 
+// src/newsletter/ffid-newsletter-client.ts
+var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
+var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
+var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+function trimOrEmpty(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+async function postPublic(url, init, opts) {
+  let response;
+  try {
+    response = await fetch(url, init);
+  } catch (err) {
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        err instanceof Error ? err.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+      )
+    };
+  }
+  if (!response.ok) {
+    try {
+      const body = await response.json();
+      if (body?.error?.code || body?.error?.message) {
+        return {
+          error: opts.createError(
+            body.error.code ?? "UNKNOWN_ERROR",
+            body.error.message ?? `${opts.fallbackMessage} (status: ${response.status})`
+          )
+        };
+      }
+    } catch {
+    }
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        `${opts.fallbackMessage} (status: ${response.status})`
+      )
+    };
+  }
+  return { data: opts.success };
+}
+function createNewsletterMethods(deps) {
+  const { fetchWithAuth, baseUrl, createError } = deps;
+  async function subscribe(params) {
+    const email = trimOrEmpty(params.email);
+    const source = trimOrEmpty(params.source);
+    if (!email) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!source) {
+      return { error: createError("VALIDATION_ERROR", "source \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.types) || params.types.length === 0) {
+      return {
+        error: createError(
+          "VALIDATION_ERROR",
+          "types \u306B\u306F1\u3064\u4EE5\u4E0A\u306E newsletter \u7A2E\u5225\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(
+      EXT_SUBSCRIBE_ENDPOINT2,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          email,
+          types: params.types,
+          source,
+          locale: params.locale
+        })
+      }
+    );
+  }
+  async function confirm(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return postPublic(
+      `${baseUrl}${CONFIRM_ENDPOINT}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token })
+      },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u78BA\u8A8D\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  async function unsubscribe(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const url = new URL(`${baseUrl}${UNSUBSCRIBE_ENDPOINT}`);
+    url.searchParams.set("token", token);
+    return postPublic(
+      url.toString(),
+      { method: "POST" },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u89E3\u9664\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  return { subscribe, confirm, unsubscribe };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1840,6 +1952,11 @@ function createFFIDClient(config) {
     createError,
     errorCodes: FFID_ERROR_CODES
   });
+  const newsletter = createNewsletterMethods({
+    fetchWithAuth,
+    baseUrl,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1894,6 +2011,8 @@ function createFFIDClient(config) {
     confirmPasswordReset,
     sendOtp,
     verifyOtp,
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/dist/{chunk-7FEWA2P2.js → chunk-YQPG6Z7W.js}

@@ -619,7 +619,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.6.0";
+var SDK_VERSION = "2.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1563,6 +1563,118 @@ function createContractWizardMethods(deps) {
   };
 }
 
+// src/newsletter/ffid-newsletter-client.ts
+var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
+var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
+var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+function trimOrEmpty(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+async function postPublic(url, init, opts) {
+  let response;
+  try {
+    response = await fetch(url, init);
+  } catch (err) {
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        err instanceof Error ? err.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+      )
+    };
+  }
+  if (!response.ok) {
+    try {
+      const body = await response.json();
+      if (body?.error?.code || body?.error?.message) {
+        return {
+          error: opts.createError(
+            body.error.code ?? "UNKNOWN_ERROR",
+            body.error.message ?? `${opts.fallbackMessage} (status: ${response.status})`
+          )
+        };
+      }
+    } catch {
+    }
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        `${opts.fallbackMessage} (status: ${response.status})`
+      )
+    };
+  }
+  return { data: opts.success };
+}
+function createNewsletterMethods(deps) {
+  const { fetchWithAuth, baseUrl, createError } = deps;
+  async function subscribe(params) {
+    const email = trimOrEmpty(params.email);
+    const source = trimOrEmpty(params.source);
+    if (!email) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!source) {
+      return { error: createError("VALIDATION_ERROR", "source \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.types) || params.types.length === 0) {
+      return {
+        error: createError(
+          "VALIDATION_ERROR",
+          "types \u306B\u306F1\u3064\u4EE5\u4E0A\u306E newsletter \u7A2E\u5225\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(
+      EXT_SUBSCRIBE_ENDPOINT2,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          email,
+          types: params.types,
+          source,
+          locale: params.locale
+        })
+      }
+    );
+  }
+  async function confirm(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return postPublic(
+      `${baseUrl}${CONFIRM_ENDPOINT}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token })
+      },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u78BA\u8A8D\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  async function unsubscribe(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const url = new URL(`${baseUrl}${UNSUBSCRIBE_ENDPOINT}`);
+    url.searchParams.set("token", token);
+    return postPublic(
+      url.toString(),
+      { method: "POST" },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u89E3\u9664\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  return { subscribe, confirm, unsubscribe };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1838,6 +1950,11 @@ function createFFIDClient(config) {
     createError,
     errorCodes: FFID_ERROR_CODES
   });
+  const newsletter = createNewsletterMethods({
+    fetchWithAuth,
+    baseUrl,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1892,6 +2009,8 @@ function createFFIDClient(config) {
     confirmPasswordReset,
     sendOtp,
     verifyOtp,
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/dist/components/index.cjs

@@ -1,30 +1,30 @@
 'use strict';
 
-var chunkZORI5YFR_cjs = require('../chunk-ZORI5YFR.cjs');
+var chunkI6MKRVUB_cjs = require('../chunk-I6MKRVUB.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDLoginButton; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDUserMenu; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDUserMenu; }
 });

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-7FEWA2P2.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-YQPG6Z7W.js';

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkZORI5YFR_cjs = require('./chunk-ZORI5YFR.cjs');
+var chunkI6MKRVUB_cjs = require('./chunk-I6MKRVUB.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -46,7 +46,7 @@ function createKVCacheAdapter(kv) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkZORI5YFR_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkI6MKRVUB_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -69,86 +69,90 @@ function withFFIDAuth(Component, options = {}) {
   return WrappedComponent;
 }
 
+// src/newsletter/types.ts
+var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
+
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkI6MKRVUB_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDLoginButton; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDProvider; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFIDUserMenu; }
+  get: function () { return chunkI6MKRVUB_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkI6MKRVUB_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkI6MKRVUB_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.createFFIDClient; }
+  get: function () { return chunkI6MKRVUB_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.createTokenStore; }
+  get: function () { return chunkI6MKRVUB_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.generateCodeChallenge; }
+  get: function () { return chunkI6MKRVUB_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.generateCodeVerifier; }
+  get: function () { return chunkI6MKRVUB_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkI6MKRVUB_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.storeCodeVerifier; }
+  get: function () { return chunkI6MKRVUB_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.useFFID; }
+  get: function () { return chunkI6MKRVUB_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkI6MKRVUB_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.useSubscription; }
+  get: function () { return chunkI6MKRVUB_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkZORI5YFR_cjs.withSubscription; }
+  get: function () { return chunkI6MKRVUB_cjs.withSubscription; }
 });
+exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;
 exports.createKVCacheAdapter = createKVCacheAdapter;
 exports.createMemoryCacheAdapter = createMemoryCacheAdapter;
 exports.withFFIDAuth = withFFIDAuth;

package/dist/index.d.cts

@@ -475,6 +475,12 @@ declare function createFFIDClient(config: FFIDConfig): {
         accessToken: string;
         refreshToken: string;
     }) => Promise<FFIDApiResponse<FFIDOtpVerifyResponse>>;
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter: {
+        subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+        confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+        unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    };
     /** Token store (token mode only) */
     tokenStore: TokenStore;
     /** Resolved auth mode */
@@ -763,4 +769,64 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, 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, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+/**
+ * Newsletter types exposed by the FFID SDK.
+ *
+ * 2-layer newsletter model (#2078):
+ *   - `inquiry_followup`: 問い合わせフォローアップ (Type A)
+ *   - `general`:          定期ニュースレター (Type B)
+ *
+ * FFID account holders' preferences live in `user_marketing_preferences`;
+ * anonymous subscribers live in `newsletter_subscribers` with double
+ * opt-in required.
+ */
+declare const FFID_NEWSLETTER_TYPES: readonly ["inquiry_followup", "general"];
+type FFIDNewsletterType = (typeof FFID_NEWSLETTER_TYPES)[number];
+interface FFIDNewsletterSubscribeParams {
+    /** Subscriber email address */
+    email: string;
+    /** One or more newsletter types to opt in to */
+    types: FFIDNewsletterType[];
+    /** Origin string recorded on the subscriber row (e.g. your service code) */
+    source: string;
+    /** ISO 639-1 locale (e.g. 'ja', 'en') */
+    locale?: string;
+}
+interface FFIDNewsletterSubscribeResponse {
+    ok: true;
+    /** True when a double opt-in confirmation email was sent */
+    requiresConfirmation: boolean;
+    /** True when the email matched an existing FFID account; the caller
+     *  must sign in to update preferences. Preferences are NOT modified. */
+    requiresSignIn: boolean;
+}
+interface FFIDNewsletterConfirmParams {
+    /** Confirmation token received in the double opt-in email */
+    token: string;
+}
+interface FFIDNewsletterConfirmResponse {
+    ok: true;
+}
+interface FFIDNewsletterUnsubscribeParams {
+    /** Unsubscribe token received in the newsletter footer / List-Unsubscribe header */
+    token: string;
+}
+interface FFIDNewsletterUnsubscribeResponse {
+    ok: true;
+}
+
+/** Newsletter methods - subscribe / confirm / unsubscribe */
+
+interface NewsletterMethodsDeps {
+    fetchWithAuth: <T>(endpoint: string, options?: RequestInit) => Promise<FFIDApiResponse<T>>;
+    baseUrl: string;
+    createError: (code: string, message: string) => FFIDError;
+}
+declare function createNewsletterMethods(deps: NewsletterMethodsDeps): {
+    subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+    confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+    unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+};
+type FFIDNewsletterClient = ReturnType<typeof createNewsletterMethods>;
+
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, 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, 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, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.d.ts

@@ -475,6 +475,12 @@ declare function createFFIDClient(config: FFIDConfig): {
         accessToken: string;
         refreshToken: string;
     }) => Promise<FFIDApiResponse<FFIDOtpVerifyResponse>>;
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter: {
+        subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+        confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+        unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    };
     /** Token store (token mode only) */
     tokenStore: TokenStore;
     /** Resolved auth mode */
@@ -763,4 +769,64 @@ declare function createFFIDAnnouncementsClient(config?: FFIDAnnouncementsClientC
 /** Type of the FFID Announcements client */
 type FFIDAnnouncementsClient = ReturnType<typeof createFFIDAnnouncementsClient>;
 
-export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, 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, FFIDListMembersResponse, type FFIDListPlansResponse, FFIDLogger, FFIDMemberRole, FFIDOAuthUserInfo, FFIDOrganization, type FFIDOtpSendResponse, type FFIDOtpVerifyResponse, type FFIDPasswordResetConfirmResponse, type FFIDPasswordResetResponse, type FFIDPasswordResetVerifyResponse, type FFIDPlanChangeLineItem, type FFIDPlanChangePreview, type FFIDPlanChangePreviewResponse, type FFIDPlanInfo, FFIDPortalSessionResponse, type FFIDPreviewPlanChangeParams, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };
+/**
+ * Newsletter types exposed by the FFID SDK.
+ *
+ * 2-layer newsletter model (#2078):
+ *   - `inquiry_followup`: 問い合わせフォローアップ (Type A)
+ *   - `general`:          定期ニュースレター (Type B)
+ *
+ * FFID account holders' preferences live in `user_marketing_preferences`;
+ * anonymous subscribers live in `newsletter_subscribers` with double
+ * opt-in required.
+ */
+declare const FFID_NEWSLETTER_TYPES: readonly ["inquiry_followup", "general"];
+type FFIDNewsletterType = (typeof FFID_NEWSLETTER_TYPES)[number];
+interface FFIDNewsletterSubscribeParams {
+    /** Subscriber email address */
+    email: string;
+    /** One or more newsletter types to opt in to */
+    types: FFIDNewsletterType[];
+    /** Origin string recorded on the subscriber row (e.g. your service code) */
+    source: string;
+    /** ISO 639-1 locale (e.g. 'ja', 'en') */
+    locale?: string;
+}
+interface FFIDNewsletterSubscribeResponse {
+    ok: true;
+    /** True when a double opt-in confirmation email was sent */
+    requiresConfirmation: boolean;
+    /** True when the email matched an existing FFID account; the caller
+     *  must sign in to update preferences. Preferences are NOT modified. */
+    requiresSignIn: boolean;
+}
+interface FFIDNewsletterConfirmParams {
+    /** Confirmation token received in the double opt-in email */
+    token: string;
+}
+interface FFIDNewsletterConfirmResponse {
+    ok: true;
+}
+interface FFIDNewsletterUnsubscribeParams {
+    /** Unsubscribe token received in the newsletter footer / List-Unsubscribe header */
+    token: string;
+}
+interface FFIDNewsletterUnsubscribeResponse {
+    ok: true;
+}
+
+/** Newsletter methods - subscribe / confirm / unsubscribe */
+
+interface NewsletterMethodsDeps {
+    fetchWithAuth: <T>(endpoint: string, options?: RequestInit) => Promise<FFIDApiResponse<T>>;
+    baseUrl: string;
+    createError: (code: string, message: string) => FFIDError;
+}
+declare function createNewsletterMethods(deps: NewsletterMethodsDeps): {
+    subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+    confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+    unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+};
+type FFIDNewsletterClient = ReturnType<typeof createNewsletterMethods>;
+
+export { AnnouncementListResponse, type ContractWizardFlowType, type ContractWizardResubscribeOptions, type ContractWizardSubscribeOptions, type ContractWizardSubscriptionOptions, DEFAULT_API_BASE_URL, 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, 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, FFIDProvider, type FFIDProviderProps, FFIDRedirectResult, FFIDRemoveMemberResponse, type FFIDResetSessionResponse, type FFIDServiceInfo, FFIDSessionResponse, type FFIDSubscribeParams, type FFIDSubscribeResponse, FFIDSubscription, FFIDSubscriptionCheckResponse, FFIDSubscriptionContextValue, type FFIDSubscriptionDetail, FFIDSubscriptionStatus, type FFIDSubscriptionSummary, type FFIDSupportedCurrency, FFIDUpdateMemberRoleResponse, FFIDUser, FFIDVerifyAccessTokenOptions, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_NEWSLETTER_TYPES, type KVNamespaceLike, ListAnnouncementsOptions, type RedirectToAuthorizeOptions, type TokenData, type TokenStore, type UseFFIDReturn, type WithFFIDAuthOptions, type WithSubscriptionOptions, createFFIDAnnouncementsClient, createFFIDClient, createKVCacheAdapter, createMemoryCacheAdapter, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useSubscription, withFFIDAuth, withSubscription };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext } from './chunk-7FEWA2P2.js';
-export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-7FEWA2P2.js';
+import { useFFIDContext } from './chunk-YQPG6Z7W.js';
+export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-YQPG6Z7W.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 
@@ -68,4 +68,7 @@ function withFFIDAuth(Component, options = {}) {
   return WrappedComponent;
 }
 
-export { createKVCacheAdapter, createMemoryCacheAdapter, withFFIDAuth };
+// src/newsletter/types.ts
+var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
+
+export { FFID_NEWSLETTER_TYPES, createKVCacheAdapter, createMemoryCacheAdapter, withFFIDAuth };

package/dist/server/index.cjs

@@ -617,7 +617,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.6.0";
+var SDK_VERSION = "2.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1548,6 +1548,118 @@ function createContractWizardMethods(deps) {
   };
 }
 
+// src/newsletter/ffid-newsletter-client.ts
+var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
+var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
+var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+function trimOrEmpty(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+async function postPublic(url, init, opts) {
+  let response;
+  try {
+    response = await fetch(url, init);
+  } catch (err) {
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        err instanceof Error ? err.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+      )
+    };
+  }
+  if (!response.ok) {
+    try {
+      const body = await response.json();
+      if (body?.error?.code || body?.error?.message) {
+        return {
+          error: opts.createError(
+            body.error.code ?? "UNKNOWN_ERROR",
+            body.error.message ?? `${opts.fallbackMessage} (status: ${response.status})`
+          )
+        };
+      }
+    } catch {
+    }
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        `${opts.fallbackMessage} (status: ${response.status})`
+      )
+    };
+  }
+  return { data: opts.success };
+}
+function createNewsletterMethods(deps) {
+  const { fetchWithAuth, baseUrl, createError } = deps;
+  async function subscribe(params) {
+    const email = trimOrEmpty(params.email);
+    const source = trimOrEmpty(params.source);
+    if (!email) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!source) {
+      return { error: createError("VALIDATION_ERROR", "source \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.types) || params.types.length === 0) {
+      return {
+        error: createError(
+          "VALIDATION_ERROR",
+          "types \u306B\u306F1\u3064\u4EE5\u4E0A\u306E newsletter \u7A2E\u5225\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(
+      EXT_SUBSCRIBE_ENDPOINT2,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          email,
+          types: params.types,
+          source,
+          locale: params.locale
+        })
+      }
+    );
+  }
+  async function confirm(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return postPublic(
+      `${baseUrl}${CONFIRM_ENDPOINT}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token })
+      },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u78BA\u8A8D\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  async function unsubscribe(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const url = new URL(`${baseUrl}${UNSUBSCRIBE_ENDPOINT}`);
+    url.searchParams.set("token", token);
+    return postPublic(
+      url.toString(),
+      { method: "POST" },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u89E3\u9664\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  return { subscribe, confirm, unsubscribe };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1823,6 +1935,11 @@ function createFFIDClient(config) {
     createError,
     errorCodes: FFID_ERROR_CODES
   });
+  const newsletter = createNewsletterMethods({
+    fetchWithAuth,
+    baseUrl,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1877,6 +1994,8 @@ function createFFIDClient(config) {
     confirmPasswordReset,
     sendOtp,
     verifyOtp,
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/dist/server/index.d.cts

@@ -1,5 +1,51 @@
 export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.cjs';
 
+/**
+ * Newsletter types exposed by the FFID SDK.
+ *
+ * 2-layer newsletter model (#2078):
+ *   - `inquiry_followup`: 問い合わせフォローアップ (Type A)
+ *   - `general`:          定期ニュースレター (Type B)
+ *
+ * FFID account holders' preferences live in `user_marketing_preferences`;
+ * anonymous subscribers live in `newsletter_subscribers` with double
+ * opt-in required.
+ */
+declare const FFID_NEWSLETTER_TYPES: readonly ["inquiry_followup", "general"];
+type FFIDNewsletterType = (typeof FFID_NEWSLETTER_TYPES)[number];
+interface FFIDNewsletterSubscribeParams {
+    /** Subscriber email address */
+    email: string;
+    /** One or more newsletter types to opt in to */
+    types: FFIDNewsletterType[];
+    /** Origin string recorded on the subscriber row (e.g. your service code) */
+    source: string;
+    /** ISO 639-1 locale (e.g. 'ja', 'en') */
+    locale?: string;
+}
+interface FFIDNewsletterSubscribeResponse {
+    ok: true;
+    /** True when a double opt-in confirmation email was sent */
+    requiresConfirmation: boolean;
+    /** True when the email matched an existing FFID account; the caller
+     *  must sign in to update preferences. Preferences are NOT modified. */
+    requiresSignIn: boolean;
+}
+interface FFIDNewsletterConfirmParams {
+    /** Confirmation token received in the double opt-in email */
+    token: string;
+}
+interface FFIDNewsletterConfirmResponse {
+    ok: true;
+}
+interface FFIDNewsletterUnsubscribeParams {
+    /** Unsubscribe token received in the newsletter footer / List-Unsubscribe header */
+    token: string;
+}
+interface FFIDNewsletterUnsubscribeResponse {
+    ok: true;
+}
+
 /** Cache adapter interface for FFID SDK token verification */
 /**
  * Pluggable cache adapter interface.
@@ -779,6 +825,12 @@ declare function createFFIDClient(config: FFIDConfig): {
         accessToken: string;
         refreshToken: string;
     }) => Promise<FFIDApiResponse<FFIDOtpVerifyResponse>>;
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter: {
+        subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+        confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+        unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    };
     /** Token store (token mode only) */
     tokenStore: TokenStore;
     /** Resolved auth mode */

package/dist/server/index.d.ts

@@ -1,5 +1,51 @@
 export { D as DEFAULT_API_BASE_URL } from '../constants-DvTGHPZn.js';
 
+/**
+ * Newsletter types exposed by the FFID SDK.
+ *
+ * 2-layer newsletter model (#2078):
+ *   - `inquiry_followup`: 問い合わせフォローアップ (Type A)
+ *   - `general`:          定期ニュースレター (Type B)
+ *
+ * FFID account holders' preferences live in `user_marketing_preferences`;
+ * anonymous subscribers live in `newsletter_subscribers` with double
+ * opt-in required.
+ */
+declare const FFID_NEWSLETTER_TYPES: readonly ["inquiry_followup", "general"];
+type FFIDNewsletterType = (typeof FFID_NEWSLETTER_TYPES)[number];
+interface FFIDNewsletterSubscribeParams {
+    /** Subscriber email address */
+    email: string;
+    /** One or more newsletter types to opt in to */
+    types: FFIDNewsletterType[];
+    /** Origin string recorded on the subscriber row (e.g. your service code) */
+    source: string;
+    /** ISO 639-1 locale (e.g. 'ja', 'en') */
+    locale?: string;
+}
+interface FFIDNewsletterSubscribeResponse {
+    ok: true;
+    /** True when a double opt-in confirmation email was sent */
+    requiresConfirmation: boolean;
+    /** True when the email matched an existing FFID account; the caller
+     *  must sign in to update preferences. Preferences are NOT modified. */
+    requiresSignIn: boolean;
+}
+interface FFIDNewsletterConfirmParams {
+    /** Confirmation token received in the double opt-in email */
+    token: string;
+}
+interface FFIDNewsletterConfirmResponse {
+    ok: true;
+}
+interface FFIDNewsletterUnsubscribeParams {
+    /** Unsubscribe token received in the newsletter footer / List-Unsubscribe header */
+    token: string;
+}
+interface FFIDNewsletterUnsubscribeResponse {
+    ok: true;
+}
+
 /** Cache adapter interface for FFID SDK token verification */
 /**
  * Pluggable cache adapter interface.
@@ -779,6 +825,12 @@ declare function createFFIDClient(config: FFIDConfig): {
         accessToken: string;
         refreshToken: string;
     }) => Promise<FFIDApiResponse<FFIDOtpVerifyResponse>>;
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter: {
+        subscribe: (params: FFIDNewsletterSubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterSubscribeResponse>>;
+        confirm: (params: FFIDNewsletterConfirmParams) => Promise<FFIDApiResponse<FFIDNewsletterConfirmResponse>>;
+        unsubscribe: (params: FFIDNewsletterUnsubscribeParams) => Promise<FFIDApiResponse<FFIDNewsletterUnsubscribeResponse>>;
+    };
     /** Token store (token mode only) */
     tokenStore: TokenStore;
     /** Resolved auth mode */

package/dist/server/index.js

@@ -616,7 +616,7 @@ function createMembersMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.6.0";
+var SDK_VERSION = "2.7.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1547,6 +1547,118 @@ function createContractWizardMethods(deps) {
   };
 }
 
+// src/newsletter/ffid-newsletter-client.ts
+var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
+var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
+var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+function trimOrEmpty(s) {
+  return typeof s === "string" ? s.trim() : "";
+}
+async function postPublic(url, init, opts) {
+  let response;
+  try {
+    response = await fetch(url, init);
+  } catch (err) {
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        err instanceof Error ? err.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"
+      )
+    };
+  }
+  if (!response.ok) {
+    try {
+      const body = await response.json();
+      if (body?.error?.code || body?.error?.message) {
+        return {
+          error: opts.createError(
+            body.error.code ?? "UNKNOWN_ERROR",
+            body.error.message ?? `${opts.fallbackMessage} (status: ${response.status})`
+          )
+        };
+      }
+    } catch {
+    }
+    return {
+      error: opts.createError(
+        "NETWORK_ERROR",
+        `${opts.fallbackMessage} (status: ${response.status})`
+      )
+    };
+  }
+  return { data: opts.success };
+}
+function createNewsletterMethods(deps) {
+  const { fetchWithAuth, baseUrl, createError } = deps;
+  async function subscribe(params) {
+    const email = trimOrEmpty(params.email);
+    const source = trimOrEmpty(params.source);
+    if (!email) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!source) {
+      return { error: createError("VALIDATION_ERROR", "source \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!Array.isArray(params.types) || params.types.length === 0) {
+      return {
+        error: createError(
+          "VALIDATION_ERROR",
+          "types \u306B\u306F1\u3064\u4EE5\u4E0A\u306E newsletter \u7A2E\u5225\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(
+      EXT_SUBSCRIBE_ENDPOINT2,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          email,
+          types: params.types,
+          source,
+          locale: params.locale
+        })
+      }
+    );
+  }
+  async function confirm(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return postPublic(
+      `${baseUrl}${CONFIRM_ENDPOINT}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token })
+      },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u78BA\u8A8D\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  async function unsubscribe(params) {
+    const token = trimOrEmpty(params.token);
+    if (!token) {
+      return { error: createError("VALIDATION_ERROR", "token \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const url = new URL(`${baseUrl}${UNSUBSCRIBE_ENDPOINT}`);
+    url.searchParams.set("token", token);
+    return postPublic(
+      url.toString(),
+      { method: "POST" },
+      {
+        success: { ok: true },
+        createError,
+        fallbackMessage: "\u89E3\u9664\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F"
+      }
+    );
+  }
+  return { subscribe, confirm, unsubscribe };
+}
+
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
 var SDK_LOG_PREFIX = "[FFID SDK]";
@@ -1822,6 +1934,11 @@ function createFFIDClient(config) {
     createError,
     errorCodes: FFID_ERROR_CODES
   });
+  const newsletter = createNewsletterMethods({
+    fetchWithAuth,
+    baseUrl,
+    createError
+  });
   const verifyAccessToken = createVerifyAccessToken({
     authMode,
     baseUrl,
@@ -1876,6 +1993,8 @@ function createFFIDClient(config) {
     confirmPasswordReset,
     sendOtp,
     verifyOtp,
+    /** Newsletter methods (subscribe / confirm / unsubscribe) */
+    newsletter,
     /** Token store (token mode only) */
     tokenStore,
     /** Resolved auth mode */

package/package.json

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