@feelflow/ffid-sdk 2.20.0 → 3.0.0

package/README.md

@@ -351,6 +351,43 @@ await client.updateProfile({
 
 対応フィールド: `displayName` / `phone` / `companyName` / `department` / `jobTitle` / `preferences`。`timezone` / `locale` は application-level invariant（サーバー側 normalization が string 前提）のため null 非許容。クリアは不可 — キー未指定で現状維持、もしくは新しい有効な値を渡す。
 
+### getAnalyticsConfig() (#2347)
+
+外部サービスが自身に割り当てられた GA4 Measurement ID を取得するメソッド。
+
+- エンドポイント: `GET /api/v1/ext/analytics/config?service=<code>`
+- 必要 scope: `analytics:read`（Bearer / API Key 両方で enforce）
+- レスポンス: `FFIDAnalyticsConfig` (`{ code, measurementId, displayName, isActive }`)
+- **archived service** (`isActive: false`) でも 200 を返す — caller が次回 deploy で tracking 停止判断する間、in-flight events が 5xx を起こさないように measurementId は引き続き返す
+
+```ts
+import { createFFIDClient } from '@feelflow/ffid-sdk/server'
+
+const client = createFFIDClient({
+  serviceCode: 'flow-board-ai',
+  authMode: 'service-key',
+  serviceApiKey: process.env.FFID_SERVICE_API_KEY!,
+})
+
+const result = await client.getAnalyticsConfig('feel-agent-ai')
+if (result.error) {
+  if (result.error.code === 'SERVICE_NOT_FOUND') {
+    // 該当 GA4 stream がまだ sync されていない / typo
+  } else {
+    console.error(`[FFID] analytics config fetch failed: ${result.error.code}`)
+  }
+} else if (result.data.isActive) {
+  // GA4 タグを描画して events を送信
+  loadGA4Script(result.data.measurementId)
+}
+```
+
+エラーコード:
+- `VALIDATION_ERROR` — `serviceCode` が空 / kebab-case 形式違反（SDK 側 pre-validate）
+- `INSUFFICIENT_SCOPE` (403) — `analytics:read` scope なし
+- `SERVICE_NOT_FOUND` (404) — DB に未登録の service code
+- `INVALID_PARAM` (400) — server 側で形式違反を検出（pre-validate 通過後の boundary）
+
 ## 型定義
 
 ```typescript

package/dist/agency/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkYUIITYBE_cjs = require('../chunk-YUIITYBE.cjs');
+var chunkMDHKSVLP_cjs = require('../chunk-MDHKSVLP.cjs');
 
 // src/agency/ffid-agency-client.ts
 var API_PREFIX = "/api/v1/agencies";
@@ -26,7 +26,7 @@ var consoleLogger = {
   error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
 };
 function createFFIDAgencyClient(config = {}) {
-  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);
   function validateIds(...pairs) {
     for (const [value, name] of pairs) {
@@ -316,7 +316,7 @@ function createFFIDAgencyClient(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_AGENCY_ERROR_CODES = FFID_AGENCY_ERROR_CODES;
 exports.createFFIDAgencyClient = createFFIDAgencyClient;

package/dist/agency/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 Agency SDK Type Definitions

package/dist/agency/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 Agency SDK Type Definitions

package/dist/agency/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/agency/ffid-agency-client.ts
 var API_PREFIX = "/api/v1/agencies";

package/dist/announcements/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkYUIITYBE_cjs = require('../chunk-YUIITYBE.cjs');
+var chunkMDHKSVLP_cjs = require('../chunk-MDHKSVLP.cjs');
 
 // src/announcements/ffid-announcements-client.ts
 var API_PATH = "/api/v1/announcements";
@@ -29,7 +29,7 @@ var consoleLogger = {
   error: (...args) => console.error(SDK_LOG_PREFIX, ...args)
 };
 function createFFIDAnnouncementsClient(config = {}) {
-  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 : quietLogger);
   async function fetchApi(endpoint) {
     const url = `${baseUrl}${endpoint}`;

package/dist/announcements/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_API_BASE_URL } from '../chunk-QBRM2RRC.js';
+import { DEFAULT_API_BASE_URL } from '../chunk-JEVK2XUM.js';
 
 // src/announcements/ffid-announcements-client.ts
 var API_PATH = "/api/v1/announcements";

package/dist/chunk-JEVK2XUM.js

@@ -0,0 +1,5 @@
+// src/constants.ts
+var DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+var DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
+
+export { DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES };

package/dist/{chunk-KNEZ5OUQ.cjs → chunk-JNR4AKL5.cjs}

@@ -6,6 +6,7 @@ var jsxRuntime = require('react/jsx-runtime');
 
 // src/constants.ts
 var DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+var DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
 
 // src/auth/token-store.ts
 var STORAGE_KEY = "ffid_tokens";
@@ -807,7 +808,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.20.0";
+var SDK_VERSION = "3.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1462,6 +1463,7 @@ function createRedirectMethods(deps) {
     baseUrl,
     clientId,
     serviceCode,
+    scope,
     resolvedRedirectUri,
     logger
   } = deps;
@@ -1470,6 +1472,24 @@ function createRedirectMethods(deps) {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
+    if (authMode === "service-key") {
+      logger.error(
+        "[FFID SDK] service-key \u30E2\u30FC\u30C9\u3067\u306F redirectToAuthorize \u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093 \u2014 server-to-server \u7528\u9014\u306E\u305F\u3081 OAuth \u30D6\u30E9\u30A6\u30B6 flow \u3092\u6301\u3061\u307E\u305B\u3093"
+      );
+      return {
+        success: false,
+        error: "service-key \u30E2\u30FC\u30C9\u3067\u306F OAuth \u8A8D\u53EF\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u306F\u5229\u7528\u3067\u304D\u307E\u305B\u3093"
+      };
+    }
+    if (!scope || !scope.trim()) {
+      logger.error(
+        "[FFID SDK] scope \u304C\u672A\u8A2D\u5B9A\u306E\u305F\u3081 /oauth/authorize \u3092\u547C\u3073\u51FA\u305B\u307E\u305B\u3093 (#2674) \u2014 FFIDConfig.scope \u306B DEFAULT_OAUTH_SCOPES \u307E\u305F\u306F\u660E\u793A\u7684\u306A scope \u3092\u6E21\u3057\u3066\u304F\u3060\u3055\u3044"
+      );
+      return {
+        success: false,
+        error: "OAuth scope \u304C\u672A\u8A2D\u5B9A\u306E\u305F\u3081\u8A8D\u53EF\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3092\u5B9F\u884C\u3067\u304D\u307E\u305B\u3093"
+      };
+    }
     const authorizeKey = buildAuthorizeKey(baseUrl, clientId, options?.organizationId);
     const now = Date.now();
     const recentCount = getRecentRedirectCount(authorizeKey, now, logger);
@@ -1502,6 +1522,7 @@ function createRedirectMethods(deps) {
     const params = new URLSearchParams({
       response_type: "code",
       client_id: clientId,
+      scope,
       redirect_uri: redirectUri,
       state,
       code_challenge: challenge,
@@ -1840,6 +1861,63 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/analytics-methods.ts
+var EXT_ANALYTICS_CONFIG_ENDPOINT = "/api/v1/ext/analytics/config";
+function resolveAuthOverride2(options, createError) {
+  if (!options || options.accessToken === void 0) {
+    return {};
+  }
+  const token = options.accessToken;
+  if (typeof token !== "string" || token.trim() === "") {
+    return {
+      error: createError(
+        "VALIDATION_ERROR",
+        "accessToken \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u5217\u3084\u7A7A\u767D\u306E\u307F\u306E\u5024\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093"
+      )
+    };
+  }
+  return { override: { accessToken: token } };
+}
+var ANALYTICS_SERVICE_CODE_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function validateServiceCode(serviceCode, createError) {
+  if (typeof serviceCode !== "string" || serviceCode.trim() === "") {
+    return createError(
+      "VALIDATION_ERROR",
+      "serviceCode \u306F\u5FC5\u9808\u306E kebab-case \u6587\u5B57\u5217\u3067\u3059"
+    );
+  }
+  if (!ANALYTICS_SERVICE_CODE_PATTERN.test(serviceCode)) {
+    return createError(
+      "VALIDATION_ERROR",
+      "serviceCode \u306F kebab-case \u5F62\u5F0F (\u82F1\u5C0F\u6587\u5B57\u30FB\u6570\u5B57\u30FB\u30CF\u30A4\u30D5\u30F3) \u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+    );
+  }
+  return null;
+}
+function createAnalyticsMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function getAnalyticsConfig(serviceCode, options) {
+    const validationError = validateServiceCode(serviceCode, createError);
+    if (validationError) {
+      return { error: validationError };
+    }
+    const { override, error: overrideError } = resolveAuthOverride2(
+      options,
+      createError
+    );
+    if (overrideError) {
+      return { error: overrideError };
+    }
+    const endpoint = `${EXT_ANALYTICS_CONFIG_ENDPOINT}?service=${encodeURIComponent(serviceCode)}`;
+    return fetchWithAuth(
+      endpoint,
+      { method: "GET" },
+      override
+    );
+  }
+  return { getAnalyticsConfig };
+}
+
 // src/client/contract-wizard-methods.ts
 var CONTRACT_WIZARD_PATH = "/contract-wizard";
 function buildWizardUrl(baseUrl, flow, params) {
@@ -1927,6 +2005,7 @@ function createContractWizardMethods(deps) {
 var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
 var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
 var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+var DISPATCH_ENDPOINT = "/api/v1/newsletter/dispatch";
 function trimOrEmpty(s) {
   return typeof s === "string" ? s.trim() : "";
 }
@@ -2032,7 +2111,36 @@ function createNewsletterMethods(deps) {
       }
     );
   }
-  return { subscribe, confirm, unsubscribe };
+  async function dispatch(params) {
+    const subject = trimOrEmpty(params.subject);
+    if (!subject) {
+      return { error: createError("VALIDATION_ERROR", "subject \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!params.body || typeof params.body !== "object") {
+      return { error: createError("VALIDATION_ERROR", "body \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const bodySource = params.body;
+    const hasHtmlBody = typeof bodySource.htmlBody === "string" && bodySource.htmlBody.length > 0;
+    const hasTemplateId = typeof bodySource.templateId === "string" && bodySource.templateId.length > 0;
+    if (hasHtmlBody === hasTemplateId) {
+      return {
+        error: createError(
+          "BODY_SOURCE_REQUIRED",
+          "body \u306F htmlBody \u307E\u305F\u306F templateId \u306E\u3044\u305A\u308C\u304B\u4E00\u65B9\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(DISPATCH_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({
+        subject,
+        articleUrl: params.articleUrl,
+        body: params.body,
+        segment: params.segment
+      })
+    });
+  }
+  return { subscribe, confirm, unsubscribe, dispatch };
 }
 
 // src/inquiry/ffid-inquiry-client.ts
@@ -2134,8 +2242,21 @@ function createFFIDClient(config) {
   if (!config.serviceCode || !config.serviceCode.trim()) {
     throw new Error("FFID Client: serviceCode \u304C\u672A\u8A2D\u5B9A\u3067\u3059");
   }
+  const scope = config.scope?.trim() ?? "";
   const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
   const authMode = config.authMode ?? "cookie";
+  const VALID_AUTH_MODES = ["cookie", "token", "service-key"];
+  if (!VALID_AUTH_MODES.includes(authMode)) {
+    throw new Error(
+      `FFID Client: authMode \u304C\u4E0D\u6B63\u3067\u3059 (\u53D7\u4FE1: ${JSON.stringify(authMode)}, \u6709\u52B9\u5024: ${VALID_AUTH_MODES.join(" | ")})`
+    );
+  }
+  if (authMode !== "service-key" && !scope) {
+    const received = config.scope === void 0 ? "undefined" : JSON.stringify(config.scope);
+    throw new Error(
+      `FFID Client: scope \u304C\u672A\u8A2D\u5B9A\u3067\u3059 (\u53D7\u4FE1: ${received})\u3002\`DEFAULT_OAUTH_SCOPES\` \u3092 import \u3059\u308B\u304B\u3001\u660E\u793A\u7684\u306B scope \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044 (#2674)`
+    );
+  }
   const clientId = config.clientId ?? config.serviceCode;
   const rawRedirectUri = config.redirectUri ?? null;
   const serviceApiKey = config.serviceApiKey?.trim();
@@ -2306,6 +2427,7 @@ function createFFIDClient(config) {
     baseUrl,
     clientId,
     serviceCode: config.serviceCode,
+    scope,
     resolvedRedirectUri,
     logger
   });
@@ -2362,6 +2484,10 @@ function createFFIDClient(config) {
     fetchWithAuth,
     createError
   });
+  const { getAnalyticsConfig } = createAnalyticsMethods({
+    fetchWithAuth,
+    createError
+  });
   const {
     requestPasswordReset,
     verifyPasswordResetToken,
@@ -2435,6 +2561,7 @@ function createFFIDClient(config) {
     removeMember,
     getProfile,
     updateProfile,
+    getAnalyticsConfig,
     createCheckoutSession,
     createPortalSession,
     listPlans,
@@ -2485,6 +2612,7 @@ var FFIDClientContext = react.createContext(null);
 function FFIDProvider({
   children,
   serviceCode,
+  scope,
   apiBaseUrl,
   debug = false,
   logger,
@@ -2511,13 +2639,14 @@ function FFIDProvider({
   const client = react.useMemo(
     () => createFFIDClient({
       serviceCode,
+      scope,
       apiBaseUrl,
       debug,
       logger,
       authMode,
       clientId
     }),
-    [serviceCode, apiBaseUrl, debug, logger, authMode, clientId]
+    [serviceCode, scope, apiBaseUrl, debug, logger, authMode, clientId]
   );
   const refresh = react.useCallback(async () => {
     client.logger.debug("Refreshing session...");
@@ -4509,6 +4638,7 @@ function FFIDInquiryForm({
 }
 
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
+exports.DEFAULT_OAUTH_SCOPES = DEFAULT_OAUTH_SCOPES;
 exports.FFIDAnnouncementBadge = FFIDAnnouncementBadge;
 exports.FFIDAnnouncementList = FFIDAnnouncementList;
 exports.FFIDInquiryForm = FFIDInquiryForm;

package/dist/{chunk-YUIITYBE.cjs → chunk-MDHKSVLP.cjs}

@@ -2,5 +2,7 @@
 
 // src/constants.ts
 var DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+var DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
 
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
+exports.DEFAULT_OAUTH_SCOPES = DEFAULT_OAUTH_SCOPES;

package/dist/{chunk-GCUVFSB2.js → chunk-XWI4BFKW.js}

@@ -4,6 +4,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/constants.ts
 var DEFAULT_API_BASE_URL = "https://id.feelflow.net";
+var DEFAULT_OAUTH_SCOPES = "openid email profile subscription:read legal:read";
 
 // src/auth/token-store.ts
 var STORAGE_KEY = "ffid_tokens";
@@ -805,7 +806,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.20.0";
+var SDK_VERSION = "3.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -1460,6 +1461,7 @@ function createRedirectMethods(deps) {
     baseUrl,
     clientId,
     serviceCode,
+    scope,
     resolvedRedirectUri,
     logger
   } = deps;
@@ -1468,6 +1470,24 @@ function createRedirectMethods(deps) {
       logger.warn("SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093");
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
+    if (authMode === "service-key") {
+      logger.error(
+        "[FFID SDK] service-key \u30E2\u30FC\u30C9\u3067\u306F redirectToAuthorize \u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093 \u2014 server-to-server \u7528\u9014\u306E\u305F\u3081 OAuth \u30D6\u30E9\u30A6\u30B6 flow \u3092\u6301\u3061\u307E\u305B\u3093"
+      );
+      return {
+        success: false,
+        error: "service-key \u30E2\u30FC\u30C9\u3067\u306F OAuth \u8A8D\u53EF\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u306F\u5229\u7528\u3067\u304D\u307E\u305B\u3093"
+      };
+    }
+    if (!scope || !scope.trim()) {
+      logger.error(
+        "[FFID SDK] scope \u304C\u672A\u8A2D\u5B9A\u306E\u305F\u3081 /oauth/authorize \u3092\u547C\u3073\u51FA\u305B\u307E\u305B\u3093 (#2674) \u2014 FFIDConfig.scope \u306B DEFAULT_OAUTH_SCOPES \u307E\u305F\u306F\u660E\u793A\u7684\u306A scope \u3092\u6E21\u3057\u3066\u304F\u3060\u3055\u3044"
+      );
+      return {
+        success: false,
+        error: "OAuth scope \u304C\u672A\u8A2D\u5B9A\u306E\u305F\u3081\u8A8D\u53EF\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3092\u5B9F\u884C\u3067\u304D\u307E\u305B\u3093"
+      };
+    }
     const authorizeKey = buildAuthorizeKey(baseUrl, clientId, options?.organizationId);
     const now = Date.now();
     const recentCount = getRecentRedirectCount(authorizeKey, now, logger);
@@ -1500,6 +1520,7 @@ function createRedirectMethods(deps) {
     const params = new URLSearchParams({
       response_type: "code",
       client_id: clientId,
+      scope,
       redirect_uri: redirectUri,
       state,
       code_challenge: challenge,
@@ -1838,6 +1859,63 @@ function createOtpMethods(deps) {
   };
 }
 
+// src/client/analytics-methods.ts
+var EXT_ANALYTICS_CONFIG_ENDPOINT = "/api/v1/ext/analytics/config";
+function resolveAuthOverride2(options, createError) {
+  if (!options || options.accessToken === void 0) {
+    return {};
+  }
+  const token = options.accessToken;
+  if (typeof token !== "string" || token.trim() === "") {
+    return {
+      error: createError(
+        "VALIDATION_ERROR",
+        "accessToken \u3092\u6307\u5B9A\u3059\u308B\u5834\u5408\u3001\u7A7A\u6587\u5B57\u5217\u3084\u7A7A\u767D\u306E\u307F\u306E\u5024\u306F\u4F7F\u7528\u3067\u304D\u307E\u305B\u3093"
+      )
+    };
+  }
+  return { override: { accessToken: token } };
+}
+var ANALYTICS_SERVICE_CODE_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function validateServiceCode(serviceCode, createError) {
+  if (typeof serviceCode !== "string" || serviceCode.trim() === "") {
+    return createError(
+      "VALIDATION_ERROR",
+      "serviceCode \u306F\u5FC5\u9808\u306E kebab-case \u6587\u5B57\u5217\u3067\u3059"
+    );
+  }
+  if (!ANALYTICS_SERVICE_CODE_PATTERN.test(serviceCode)) {
+    return createError(
+      "VALIDATION_ERROR",
+      "serviceCode \u306F kebab-case \u5F62\u5F0F (\u82F1\u5C0F\u6587\u5B57\u30FB\u6570\u5B57\u30FB\u30CF\u30A4\u30D5\u30F3) \u3067\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+    );
+  }
+  return null;
+}
+function createAnalyticsMethods(deps) {
+  const { fetchWithAuth, createError } = deps;
+  async function getAnalyticsConfig(serviceCode, options) {
+    const validationError = validateServiceCode(serviceCode, createError);
+    if (validationError) {
+      return { error: validationError };
+    }
+    const { override, error: overrideError } = resolveAuthOverride2(
+      options,
+      createError
+    );
+    if (overrideError) {
+      return { error: overrideError };
+    }
+    const endpoint = `${EXT_ANALYTICS_CONFIG_ENDPOINT}?service=${encodeURIComponent(serviceCode)}`;
+    return fetchWithAuth(
+      endpoint,
+      { method: "GET" },
+      override
+    );
+  }
+  return { getAnalyticsConfig };
+}
+
 // src/client/contract-wizard-methods.ts
 var CONTRACT_WIZARD_PATH = "/contract-wizard";
 function buildWizardUrl(baseUrl, flow, params) {
@@ -1925,6 +2003,7 @@ function createContractWizardMethods(deps) {
 var EXT_SUBSCRIBE_ENDPOINT2 = "/api/v1/ext/newsletter/subscribe";
 var CONFIRM_ENDPOINT = "/api/newsletter/confirm";
 var UNSUBSCRIBE_ENDPOINT = "/api/newsletter/unsubscribe";
+var DISPATCH_ENDPOINT = "/api/v1/newsletter/dispatch";
 function trimOrEmpty(s) {
   return typeof s === "string" ? s.trim() : "";
 }
@@ -2030,7 +2109,36 @@ function createNewsletterMethods(deps) {
       }
     );
   }
-  return { subscribe, confirm, unsubscribe };
+  async function dispatch(params) {
+    const subject = trimOrEmpty(params.subject);
+    if (!subject) {
+      return { error: createError("VALIDATION_ERROR", "subject \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    if (!params.body || typeof params.body !== "object") {
+      return { error: createError("VALIDATION_ERROR", "body \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    const bodySource = params.body;
+    const hasHtmlBody = typeof bodySource.htmlBody === "string" && bodySource.htmlBody.length > 0;
+    const hasTemplateId = typeof bodySource.templateId === "string" && bodySource.templateId.length > 0;
+    if (hasHtmlBody === hasTemplateId) {
+      return {
+        error: createError(
+          "BODY_SOURCE_REQUIRED",
+          "body \u306F htmlBody \u307E\u305F\u306F templateId \u306E\u3044\u305A\u308C\u304B\u4E00\u65B9\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044"
+        )
+      };
+    }
+    return fetchWithAuth(DISPATCH_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({
+        subject,
+        articleUrl: params.articleUrl,
+        body: params.body,
+        segment: params.segment
+      })
+    });
+  }
+  return { subscribe, confirm, unsubscribe, dispatch };
 }
 
 // src/inquiry/ffid-inquiry-client.ts
@@ -2132,8 +2240,21 @@ function createFFIDClient(config) {
   if (!config.serviceCode || !config.serviceCode.trim()) {
     throw new Error("FFID Client: serviceCode \u304C\u672A\u8A2D\u5B9A\u3067\u3059");
   }
+  const scope = config.scope?.trim() ?? "";
   const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
   const authMode = config.authMode ?? "cookie";
+  const VALID_AUTH_MODES = ["cookie", "token", "service-key"];
+  if (!VALID_AUTH_MODES.includes(authMode)) {
+    throw new Error(
+      `FFID Client: authMode \u304C\u4E0D\u6B63\u3067\u3059 (\u53D7\u4FE1: ${JSON.stringify(authMode)}, \u6709\u52B9\u5024: ${VALID_AUTH_MODES.join(" | ")})`
+    );
+  }
+  if (authMode !== "service-key" && !scope) {
+    const received = config.scope === void 0 ? "undefined" : JSON.stringify(config.scope);
+    throw new Error(
+      `FFID Client: scope \u304C\u672A\u8A2D\u5B9A\u3067\u3059 (\u53D7\u4FE1: ${received})\u3002\`DEFAULT_OAUTH_SCOPES\` \u3092 import \u3059\u308B\u304B\u3001\u660E\u793A\u7684\u306B scope \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044 (#2674)`
+    );
+  }
   const clientId = config.clientId ?? config.serviceCode;
   const rawRedirectUri = config.redirectUri ?? null;
   const serviceApiKey = config.serviceApiKey?.trim();
@@ -2304,6 +2425,7 @@ function createFFIDClient(config) {
     baseUrl,
     clientId,
     serviceCode: config.serviceCode,
+    scope,
     resolvedRedirectUri,
     logger
   });
@@ -2360,6 +2482,10 @@ function createFFIDClient(config) {
     fetchWithAuth,
     createError
   });
+  const { getAnalyticsConfig } = createAnalyticsMethods({
+    fetchWithAuth,
+    createError
+  });
   const {
     requestPasswordReset,
     verifyPasswordResetToken,
@@ -2433,6 +2559,7 @@ function createFFIDClient(config) {
     removeMember,
     getProfile,
     updateProfile,
+    getAnalyticsConfig,
     createCheckoutSession,
     createPortalSession,
     listPlans,
@@ -2483,6 +2610,7 @@ var FFIDClientContext = createContext(null);
 function FFIDProvider({
   children,
   serviceCode,
+  scope,
   apiBaseUrl,
   debug = false,
   logger,
@@ -2509,13 +2637,14 @@ function FFIDProvider({
   const client = useMemo(
     () => createFFIDClient({
       serviceCode,
+      scope,
       apiBaseUrl,
       debug,
       logger,
       authMode,
       clientId
     }),
-    [serviceCode, apiBaseUrl, debug, logger, authMode, clientId]
+    [serviceCode, scope, apiBaseUrl, debug, logger, authMode, clientId]
   );
   const refresh = useCallback(async () => {
     client.logger.debug("Refreshing session...");
@@ -4506,4 +4635,4 @@ function FFIDInquiryForm({
   );
 }
 
-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, useFFIDContext, useSubscription, withSubscription };
+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, useFFIDContext, useSubscription, withSubscription };

package/dist/components/index.cjs

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

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { M as FFIDAnnouncementBadge, al as FFIDAnnouncementBadgeClassNames, am as FFIDAnnouncementBadgeProps, N as FFIDAnnouncementList, an as FFIDAnnouncementListClassNames, ao as FFIDAnnouncementListProps, V as FFIDInquiryForm, W as FFIDInquiryFormCategoryItem, X as FFIDInquiryFormClassNames, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a3 as FFIDLoginButton, ap as FFIDLoginButtonProps, a9 as FFIDOrganizationSwitcher, aq as FFIDOrganizationSwitcherClassNames, ar as FFIDOrganizationSwitcherProps, ac as FFIDSubscriptionBadge, as as FFIDSubscriptionBadgeClassNames, at as FFIDSubscriptionBadgeProps, ae as FFIDUserMenu, au as FFIDUserMenuClassNames, av as FFIDUserMenuProps } from '../index-0D2vYSLq.cjs';
+export { N as FFIDAnnouncementBadge, am as FFIDAnnouncementBadgeClassNames, an as FFIDAnnouncementBadgeProps, O as FFIDAnnouncementList, ao as FFIDAnnouncementListClassNames, ap as FFIDAnnouncementListProps, 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, a4 as FFIDLoginButton, aq as FFIDLoginButtonProps, aa as FFIDOrganizationSwitcher, ar as FFIDOrganizationSwitcherClassNames, as as FFIDOrganizationSwitcherProps, ad as FFIDSubscriptionBadge, at as FFIDSubscriptionBadgeClassNames, au as FFIDSubscriptionBadgeProps, af as FFIDUserMenu, av as FFIDUserMenuClassNames, aw as FFIDUserMenuProps } from '../index-C3zyNa4j.cjs';
 import 'react/jsx-runtime';
 import 'react';