@feelflow/ffid-sdk 7.1.0 → 8.0.0

package/README.md

@@ -464,7 +464,7 @@ const ffid = createFFIDClient({
 // 1. ユーザーを冪等に作成（新規なら created:true / 既存なら created:false）
 const userRes = await ffid.provisionUser({
   email: 'owner@example.com',
-  profile: { displayName: '山田 太郎', companyName: 'Example Inc.' },
+  profile: { displayName: '山田 太郎' },
 })
 if (userRes.error) throw new Error(userRes.error.message)
 if (!userRes.data.dryRun) {
@@ -561,12 +561,13 @@ const { data: updated, error: updateError } = await client.updateProfile({
 
 #### フィールドのクリア（null を渡す）
 
-optional フィールドに `null` を渡すと、FFID backend 側で該当カラムを SQL NULL にクリアします（v2.16.0〜 / #2354）。
+対応する optional フィールドに `null` を渡すと、FFID backend 側で該当カラムを
+SQL NULL にクリアします（v2.16.0〜 / #2354）。個人プロフィールの
+`companyName` は廃止予定で、旧クライアントからの値は受理しても無視します。
 
 ```tsx
-// 会社名と部署をクリア
+// 部署をクリア
 await client.updateProfile({
-  companyName: null,
   department: null,
 })
 ```
@@ -579,7 +580,7 @@ await client.updateProfile({
 | `null` | クリア（SQL NULL を書き込む） |
 | `""`（空文字列） | 空文字リテラルをそのまま保存（`null` 扱いには**ならない**） |
 
-対応フィールド: `displayName` / `phone` / `companyName` / `department` / `jobTitle` / `preferences`。`timezone` / `locale` は application-level invariant（サーバー側 normalization が string 前提）のため null 非許容。クリアは不可 — キー未指定で現状維持、もしくは新しい有効な値を渡す。
+対応フィールド: `displayName` / `phone` / `department` / `jobTitle` / `preferences`。`timezone` / `locale` は application-level invariant（サーバー側 normalization が string 前提）のため null 非許容。クリアは不可 — キー未指定で現状維持、もしくは新しい有効な値を渡す。
 
 ### getAnalyticsConfig() (#2347)
 
@@ -618,6 +619,115 @@ if (result.error) {
 - `SERVICE_NOT_FOUND` (404) — DB に未登録の service code
 - `INVALID_PARAM` (400) — server 側で形式違反を検出（pre-validate 通過後の boundary）
 
+## 代理店の招待リンク（`?invite=`）
+
+代理店の招待リンクから来た顧客が FFID で登録すると、作られた組織がその代理店に紐付きます。SDK の役割は**トークンを signup URL まで運ぶこと**だけで、紐付けの実務は FFID 側が行います。
+
+> 代理店ポータルが発行するリンクは FFID の origin（`https://id.feelflow.net/signup?invite=…`）を指します。サービスサイトを着地点にする形（`https://<あなたのサービス>/?invite=…`）は、代理店がトークンを自分のキャンペーン URL に貼って成立させる導線です。この節が効くのはその形です。
+
+### React 利用者（`FFIDProvider` を mount している場合）
+
+**配線は不要です。** provider が mount 時に着地 URL の `invite` を捕捉し、first-party cookie へ保存します。`getSignupUrl()` が自動でトークンを載せます。
+
+ただし provider は捕捉結果を返さないので、**cookie の保持に失敗したことを利用者側で観測する経路はありません**（debug ログには落ちます）。検知したい場合は provider に加えて自分で `captureAgencyInviteToken()` を呼び、戻り値の `persisted` を見てください。
+
+### React 以外 / provider を使わない場合
+
+`captureAgencyInviteToken()` を**ページ遷移ごとに**呼びます。
+
+```typescript
+import { captureAgencyInviteToken } from '@feelflow/ffid-sdk'
+
+// ページ読み込みごと（SPA ならルート遷移ごと）に呼ぶ
+const { token, source, persisted } = captureAgencyInviteToken()
+
+if (persisted === false) {
+  // cookie がブラウザに落とされた。今回の URL 経由では紐付くが、
+  // パラメータの無い別ページへ回遊すると失われる。
+} else if (persisted === undefined && source === 'url') {
+  // 書ける環境が無かった（SSR）。ブラウザ側で捕捉し直す必要がある。
+}
+```
+
+呼ばなかった場合は「着地ページで即 signup した人だけ紐付く」まで**劣化します**（壊れるのではなく、下記の回遊経路を救えなくなります）。
+
+### なぜページ遷移ごとに呼ぶ必要があるのか
+
+実際の導線は次の形です。
+
+```
+/?invite=abc に着地 → 料金ページを見る → /pricing で「登録」を押す
+```
+
+`getSignupUrl()` が呼ばれる時点の URL には `invite` がありません。着地時点で捕捉して保持する以外にこの経路を救う方法がなく、**SDK 自身はページ読み込みを hook できない**ため、起動点は利用者側にあります。
+
+### ⚠️ 効かない経路: SSR（Server Component）で signup URL を組む場合
+
+サーバーには `window.location.search` も `document.cookie` もありません。`getSignupUrl()` をそのまま呼ぶとトークンは載らないので、呼び出し側が読んだ値を渡してください（渡さない場合はプロセスあたり 1 度 warn します）。
+
+```typescript
+// Server Component
+import { cookies } from 'next/headers'
+import { AGENCY_INVITE_COOKIE_NAME } from '@feelflow/ffid-sdk'
+
+const inviteToken = (await cookies()).get(AGENCY_INVITE_COOKIE_NAME)?.value
+const href = ffid.getSignupUrl(undefined, { inviteToken })
+```
+
+### `authMode: 'token'`（OAuth モード）は v7.4.0 で対応済み
+
+この設定では signup 意図が `/api/v1/oauth/authorize` を経由するため `getSignupUrl()` を通りません。**v7.4.0 以降は `redirectToAuthorize` が `invite` を authorize URL へ転送し、FFID 側が `/signup` へ引き継ぎます**（`redirectToLogin({ screenHint: 'signup' })` は token モードでは `redirectToAuthorize` へ委譲されるので、こちらも同様に載ります）。配線は不要です。
+
+v7.3.x までは token モードでトークンが FFID に 1 度も届かず、紐付けが無言で落ちていました。**v7.4.0 未満を使っている場合は、SDK と FFID 本体の両方を更新してください** — 転送は SDK が `invite` を送り、FFID が `/signup` へ stamp する 2 段で成立します。
+
+⚠️ 転送の gate は `screenHint === 'signup'` です。`prompt` に `'create'` を指定して signup 画面へ向かう経路は SDK の `FFIDPrompt`（`'select_account' | 'login'`）が受け付けないため到達しません。
+
+### cookie の仕様
+
+| 項目 | 値 |
+|---|---|
+| 名前 | `ffid_invite`（first-party・consumer 自身のホスト） |
+| 有効期限 | 30 日 |
+| `Path` | `/` |
+| `SameSite` | `Lax` |
+| `Secure` | `NODE_ENV === 'production'` のときだけ（`options.secure` で上書き可） |
+| `Domain` | 既定は現在のホストのみ（`options.domain` で指定可） |
+
+`Secure` を本番限定にしているのは、**https でない独自ドメイン**（LAN IP や plain http の検証機）でブラウザが `Secure` cookie を黙って捨てるためです。`http://localhost` は secure context として扱われるので `Secure` でも保持されます（ローカル開発では上書き不要）。
+
+URL と cookie の両方にトークンがある場合は **URL が勝ち、cookie も更新されます**（最後に踏んだリンクが勝つ）。
+
+**削除には書き込み時と同じ `path` / `domain` / `secure` が必要です。** ブラウザが一致を要求するため、既定以外で書いた cookie は既定の `clearAgencyInviteToken()` では消えません。
+
+### ⚠️ 保持期間 30 日の副作用
+
+招待リンクは既定で使用回数が無制限です。したがって保持中の cookie は、**同じブラウザで後から作られた組織も同じ代理店に紐付けます**。共有ブラウザではこれが誤紐付けになります。
+
+SDK は登録完了時に cookie を消しません（登録完了は FFID のドメインで起こるため consumer から検知しにくい）。単回にしたい場合は、登録完了を検知できる地点で明示的に消してください。
+
+```typescript
+import { clearAgencyInviteToken } from '@feelflow/ffid-sdk'
+
+clearAgencyInviteToken() // 削除が read-back で確認できたら true / SSR では undefined
+```
+
+### ⚠️ トークンをログに出さないこと
+
+このトークンは URL に載る**平文の資格情報**で、**単回使用ではありません**（招待リンクの使用回数上限は既定で無制限）。漏れたトークンは、新規組織が作られる限り何度でも紐付けに使えます。
+
+SDK 内部ではログ・エラーレポート・アナリティクスに値を出しません。`getSignupUrl()` の出力を自前でログや解析イベントに送っている場合は、`redactAgencyInviteToken()` を通してください。
+
+```typescript
+import { redactAgencyInviteToken } from '@feelflow/ffid-sdk'
+
+logger.info('signup url', redactAgencyInviteToken(ffid.getSignupUrl()))
+// → https://id.feelflow.net/signup?redirect=...&service=svc&invite=[REDACTED]
+```
+
+素の `invite=` だけでなく、`redirect` パラメータに着地 URL が percent-encode されて入る**入れ子**（`redirect=…%3Finvite%3D…`）も潰します。覆う encode の深さは **2 段まで**です。GA4 の `page_location` のように URL を丸ごと送るイベントでも同じ経路を通してください。
+
+**login URL にも `redirect` 経由で入れ子で載ります。** 専用の `&invite=` は付きませんが（紐付けは新規登録時の組織作成に対して起こるため）、着地 URL が `?invite=…` なら login URL の `redirect` の中に入ります。login URL をログに出す場合も redact してください。
+
 ## 型定義
 
 ```typescript

package/dist/{chunk-CI4N7KJK.cjs → chunk-RNCK5E3Y.cjs}

@@ -160,7 +160,7 @@ function normalizeUserinfo(raw) {
     emailVerified: raw.email_verified,
     name: raw.name,
     picture: raw.picture,
-    companyName: raw.company_name ?? null,
+    companyName: null,
     department: raw.department ?? null,
     position: raw.position ?? null,
     phoneNumber: raw.phone_number ?? null,
@@ -228,13 +228,18 @@ function mapUserinfoSubscriptionToSession(userinfo, serviceCode) {
   ];
 }
 var JWKS_ENDPOINT = "/.well-known/jwks.json";
-var JWT_ISSUER = "https://id.feelflow.net";
+var LEGACY_JWT_ISSUER = "https://id.feelflow.net";
 var JWT_ALGORITHM = "ES256";
 var JWT_CLOCK_TOLERANCE_SECONDS = 30;
+function resolveAcceptedIssuers(baseUrl) {
+  const deployedOrigin = new URL(baseUrl).origin;
+  return deployedOrigin === LEGACY_JWT_ISSUER ? [LEGACY_JWT_ISSUER] : [deployedOrigin, LEGACY_JWT_ISSUER];
+}
 function createJwtVerifier(deps) {
   const { baseUrl, serviceCode, logger, createError, errorCodes } = deps;
   const jwksUrl = new URL(JWKS_ENDPOINT, baseUrl);
   const jwks = jose.createRemoteJWKSet(jwksUrl);
+  const acceptedIssuers = resolveAcceptedIssuers(baseUrl);
   async function verifyJwt(accessToken) {
     if (!accessToken || !accessToken.trim()) {
       return {
@@ -247,7 +252,7 @@ function createJwtVerifier(deps) {
     try {
       const { payload } = await jose.jwtVerify(accessToken, jwks, {
         algorithms: [JWT_ALGORITHM],
-        issuer: JWT_ISSUER,
+        issuer: acceptedIssuers,
         audience: serviceCode,
         clockTolerance: JWT_CLOCK_TOLERANCE_SECONDS
       });
@@ -464,7 +469,7 @@ function createVerifyAccessToken(deps) {
       email_verified: introspectResponse.email_verified,
       name: introspectResponse.name ?? null,
       picture: introspectResponse.picture ?? null,
-      company_name: introspectResponse.company_name ?? null,
+      company_name: null,
       department: introspectResponse.department ?? null,
       position: introspectResponse.position ?? null,
       phone_number: introspectResponse.phone_number ?? null,
@@ -715,6 +720,24 @@ function validateSeatChangePreview(preview) {
       `SDK: server returned malformed SeatChangePreview \u2014 estimateReason must be one of 'no_stripe_data' | 'custom_pricing' | 'stripe_error' (got ${JSON.stringify(p.estimateReason)})`
     );
   }
+  if (p.willApplyAtPeriodEnd !== void 0 && typeof p.willApplyAtPeriodEnd !== "boolean") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 willApplyAtPeriodEnd must be boolean when present (got ${typeof p.willApplyAtPeriodEnd})`
+    );
+  }
+  if (p.effectiveDate !== void 0 && p.effectiveDate !== null && typeof p.effectiveDate !== "string") {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 effectiveDate must be string or null when present (got ${typeof p.effectiveDate})`
+    );
+  }
+  if (p.willApplyAtPeriodEnd === true && p.proratedAmount !== 0) {
+    throw new FFIDSDKError(
+      MALFORMED_SEAT_PREVIEW_CODE,
+      `SDK: server returned malformed SeatChangePreview \u2014 willApplyAtPeriodEnd=true requires proratedAmount=0 (got ${JSON.stringify(p.proratedAmount)})`
+    );
+  }
   if (!Array.isArray(p.lineItems)) {
     throw new FFIDSDKError(
       MALFORMED_SEAT_PREVIEW_CODE,
@@ -1355,7 +1378,7 @@ var FFID_ORGANIZATION_PROFILE_ERROR_CODES = {
 };
 
 // src/client/version-check.ts
-var SDK_VERSION = "7.1.0";
+var SDK_VERSION = "8.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -2609,6 +2632,129 @@ function cleanupStateStorage(logger) {
   }
 }
 
+// src/client/agency-invite-token.ts
+var AGENCY_INVITE_TOKEN_PARAM = "invite";
+var AGENCY_INVITE_COOKIE_NAME = "ffid_invite";
+var SECONDS_PER_MINUTE = 60;
+var MINUTES_PER_HOUR = 60;
+var HOURS_PER_DAY = 24;
+var RETENTION_DAYS = 30;
+var AGENCY_INVITE_COOKIE_MAX_AGE_SEC = SECONDS_PER_MINUTE * MINUTES_PER_HOUR * HOURS_PER_DAY * RETENTION_DAYS;
+var AGENCY_INVITE_TOKEN_REDACTION = "[REDACTED]";
+function hasDocument() {
+  return typeof document !== "undefined";
+}
+function defaultSecure() {
+  if (typeof process === "undefined") return true;
+  return process.env?.NODE_ENV === "production";
+}
+function toQueryString(source) {
+  const queryStart = source.indexOf("?");
+  if (queryStart < 0) return "";
+  const afterQuery = source.slice(queryStart);
+  const fragmentStart = afterQuery.indexOf("#");
+  return fragmentStart < 0 ? afterQuery : afterQuery.slice(0, fragmentStart);
+}
+function readTokenFromUrl(options) {
+  const source = options.url ?? (typeof window !== "undefined" ? window.location.search : void 0);
+  if (source === void 0) return void 0;
+  const params = new URLSearchParams(toQueryString(source));
+  return params.get(AGENCY_INVITE_TOKEN_PARAM)?.trim() || void 0;
+}
+function readAgencyInviteCookie() {
+  if (!hasDocument()) return void 0;
+  const prefix = `${AGENCY_INVITE_COOKIE_NAME}=`;
+  const raw = document.cookie.split(";").map((entry) => entry.trim()).find((entry) => entry.startsWith(prefix));
+  if (!raw) return void 0;
+  try {
+    return decodeURIComponent(raw.slice(prefix.length)).trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function readAgencyInviteToken(options = {}) {
+  return readTokenFromUrl(options) ?? readAgencyInviteCookie();
+}
+function buildAgencyInviteCookie(value, maxAgeSec, options) {
+  const attrs = [
+    `${AGENCY_INVITE_COOKIE_NAME}=${value}`,
+    `Max-Age=${maxAgeSec}`,
+    `Path=${options.path ?? "/"}`,
+    "SameSite=Lax"
+  ];
+  if (options.domain) attrs.push(`Domain=${options.domain}`);
+  if (options.secure ?? defaultSecure()) attrs.push("Secure");
+  return attrs.join("; ");
+}
+function writeAgencyInviteCookie(token, options) {
+  if (!hasDocument()) return void 0;
+  document.cookie = buildAgencyInviteCookie(
+    encodeURIComponent(token),
+    AGENCY_INVITE_COOKIE_MAX_AGE_SEC,
+    options
+  );
+  return readAgencyInviteCookie() === token;
+}
+function clearAgencyInviteToken(options = {}) {
+  if (!hasDocument()) return void 0;
+  const CLEAR_MAX_AGE = 0;
+  document.cookie = buildAgencyInviteCookie("", CLEAR_MAX_AGE, options);
+  return readAgencyInviteCookie() === void 0;
+}
+function captureAgencyInviteToken(options = {}) {
+  const fromUrl = readTokenFromUrl(options);
+  if (fromUrl !== void 0) {
+    return { source: "url", token: fromUrl, persisted: writeAgencyInviteCookie(fromUrl, options) };
+  }
+  const fromCookie = readAgencyInviteCookie();
+  return fromCookie !== void 0 ? { source: "cookie", token: fromCookie, persisted: void 0 } : { source: "none", token: void 0, persisted: void 0 };
+}
+var REDACT_BOUNDARIES = [
+  "%2526",
+  "%2523",
+  "%253B",
+  "%26",
+  "%23",
+  "%3B",
+  "&",
+  "#",
+  ";"
+];
+var REDACT_LEADS = ["%253F", "%3F", "?", ...REDACT_BOUNDARIES];
+var REDACT_SEPARATORS = ["%253D", "%3D", "="];
+function escapeForRegExp(literal) {
+  return literal.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+var REDACT_PATTERN = new RegExp(
+  [
+    // 先頭区切り。`\b` が使えないのは、入れ子形 (`%3Finvite%3D`) では `F` と `i` が
+    // どちらも単語文字なので単語境界が存在しないため。
+    `(^|${REDACT_LEADS.map(escapeForRegExp).join("|")})`,
+    // パラメータ名と区切りはキャプチャして再出力する。`i` フラグがあるので、
+    // 入力の `INVITE=` / `%3d` などの元の表記を保つ必要がある。
+    `(${AGENCY_INVITE_TOKEN_PARAM})`,
+    `(${REDACT_SEPARATORS.map(escapeForRegExp).join("|")})`,
+    // 値。境界の直前まで貪欲に食う。`\s` は終端にしない — 生の空白や改行を含む
+    // トークンでマスクが途中で切れ、後半が漏れる。
+    `(?:(?!${REDACT_BOUNDARIES.map(escapeForRegExp).join("|")})[^&#;])*`
+  ].join(""),
+  "gi"
+);
+function redactAgencyInviteToken(url) {
+  return url.replace(
+    REDACT_PATTERN,
+    // 文字列 replacement（`'$1$2$3[REDACTED]'`）にしないのは、
+    // `AGENCY_INVITE_TOKEN_REDACTION` に `$` が入った瞬間に置換パターンとして
+    // 解釈される罠を作らないため。
+    (_match, lead, name, separator) => `${lead}${name}${separator}${AGENCY_INVITE_TOKEN_REDACTION}`
+  );
+}
+function appendAgencyInviteToken(signupUrl, token) {
+  if (token === void 0) return signupUrl;
+  const separator = signupUrl.includes("?") ? "&" : "?";
+  return `${signupUrl}${separator}${AGENCY_INVITE_TOKEN_PARAM}=${encodeURIComponent(token)}`;
+}
+
 // src/client/redirect.ts
 var OAUTH_AUTHORIZE_ENDPOINT = "/api/v1/oauth/authorize";
 var AUTH_LOGOUT_ENDPOINT = "/api/v1/auth/logout";
@@ -2621,6 +2767,7 @@ var REDIRECT_LOOP_WINDOW_MS = 6e4;
 var REDIRECT_LOOP_THRESHOLD = 3;
 var storageReadFailureLogged = false;
 var storageWriteFailureLogged = false;
+var ssrInviteTokenUnavailableLogged = false;
 function isLoopDetectionDegraded() {
   return storageReadFailureLogged || storageWriteFailureLogged;
 }
@@ -2799,12 +2946,16 @@ function createRedirectMethods(deps) {
     }
     if (options?.screenHint === SCREEN_HINT_SIGNUP) {
       params.set(SCREEN_HINT_PARAM, SCREEN_HINT_SIGNUP);
+      const inviteToken = readAgencyInviteToken();
+      if (inviteToken !== void 0) {
+        params.set(AGENCY_INVITE_TOKEN_PARAM, inviteToken);
+      }
     }
     if (options?.prompt) {
       params.set("prompt", options.prompt);
     }
     const authorizeUrl = `${baseUrl}${OAUTH_AUTHORIZE_ENDPOINT}?${params.toString()}`;
-    logger.debug("Redirecting to authorize:", authorizeUrl);
+    logger.debug("Redirecting to authorize:", redactAgencyInviteToken(authorizeUrl));
     recordRedirectAttempt(authorizeKey, now, logger);
     try {
       window.location.href = authorizeUrl;
@@ -2823,7 +2974,7 @@ function createRedirectMethods(deps) {
       return redirectToAuthorize(options);
     }
     const targetUrl = options?.screenHint === SCREEN_HINT_SIGNUP ? getSignupUrl() : getLoginUrl(void 0, options?.prompt ? { prompt: options.prompt } : void 0);
-    logger.debug("Redirecting to auth page:", targetUrl);
+    logger.debug("Redirecting to auth page:", redactAgencyInviteToken(targetUrl));
     window.location.href = targetUrl;
     return { success: true };
   }
@@ -2840,7 +2991,7 @@ function createRedirectMethods(deps) {
     const promptSuffix = options?.prompt ? `&prompt=${encodeURIComponent(options.prompt)}` : "";
     return `${baseUrl}/login?redirect=${encodeURIComponent(redirect)}&service=${encodeURIComponent(serviceCode)}${promptSuffix}`;
   }
-  function getSignupUrl(redirectUrl) {
+  function getSignupUrl(redirectUrl, options) {
     let redirect;
     if (redirectUrl != null) {
       redirect = redirectUrl;
@@ -2850,7 +3001,22 @@ function createRedirectMethods(deps) {
       logger.warn("getSignupUrl: SSR \u74B0\u5883\u3067 redirectUrl \u304C\u672A\u6307\u5B9A\u306E\u305F\u3081\u7A7A\u6587\u5B57\u306B\u30D5\u30A9\u30FC\u30EB\u30D0\u30C3\u30AF\u3057\u307E\u3059");
       redirect = "";
     }
-    return `${baseUrl}/signup?redirect=${encodeURIComponent(redirect)}&service=${encodeURIComponent(serviceCode)}`;
+    let inviteToken = options?.inviteToken;
+    if (inviteToken === void 0) {
+      inviteToken = readAgencyInviteToken();
+      if (inviteToken === void 0 && typeof window === "undefined") {
+        if (!ssrInviteTokenUnavailableLogged) {
+          ssrInviteTokenUnavailableLogged = true;
+          logger.warn(
+            "[FFID SDK] getSignupUrl: SSR \u3067\u306F\u62DB\u5F85\u30C8\u30FC\u30AF\u30F3\uFF08invite\uFF09\u3092\u8AAD\u3081\u307E\u305B\u3093\u3002\u4EE3\u7406\u5E97\u306E\u62DB\u5F85\u30EA\u30F3\u30AF\u3092\u4F7F\u3046\u5834\u5408\u306F options.inviteToken \u306B\u6E21\u3057\u3066\u304F\u3060\u3055\u3044\uFF08\u4F7F\u3063\u3066\u3044\u306A\u3044\u5834\u5408\u306F\u3053\u306E\u8B66\u544A\u3092\u7121\u8996\u3057\u3066\u3088\u3044\uFF09"
+          );
+        }
+      }
+    }
+    return appendAgencyInviteToken(
+      `${baseUrl}/signup?redirect=${encodeURIComponent(redirect)}&service=${encodeURIComponent(serviceCode)}`,
+      inviteToken
+    );
   }
   function getLogoutUrl(postLogoutRedirectUri) {
     const url = new URL(`${baseUrl}${AUTH_LOGOUT_ENDPOINT}`);
@@ -2866,7 +3032,7 @@ function createRedirectMethods(deps) {
       return { success: false, error: "SSR \u74B0\u5883\u3067\u306F\u30EA\u30C0\u30A4\u30EC\u30AF\u30C8\u3067\u304D\u307E\u305B\u3093" };
     }
     const logoutUrl = getLogoutUrl(postLogoutRedirectUri);
-    logger.debug("Redirecting to logout:", logoutUrl);
+    logger.debug("Redirecting to logout:", redactAgencyInviteToken(logoutUrl));
     window.location.href = logoutUrl;
     return { success: true };
   }
@@ -3479,11 +3645,11 @@ var EFFECTIVE_SUBSCRIPTION_STATUSES = [
   "expired"
 ];
 var PAST_DUE_GRACE_PERIOD_DAYS = 7;
-var HOURS_PER_DAY = 24;
-var MINUTES_PER_HOUR = 60;
-var SECONDS_PER_MINUTE = 60;
+var HOURS_PER_DAY2 = 24;
+var MINUTES_PER_HOUR2 = 60;
+var SECONDS_PER_MINUTE2 = 60;
 var MS_PER_SECOND2 = 1e3;
-var MS_PER_DAY = HOURS_PER_DAY * MINUTES_PER_HOUR * SECONDS_PER_MINUTE * MS_PER_SECOND2;
+var MS_PER_DAY = HOURS_PER_DAY2 * MINUTES_PER_HOUR2 * SECONDS_PER_MINUTE2 * MS_PER_SECOND2;
 
 // src/subscriptions/compute-effective-status.ts
 function isExpired(isoTimestamp, nowMs) {
@@ -3636,6 +3802,18 @@ var FFID_ERROR_CODES = {
   TOKEN_EXPIRED: "TOKEN_EXPIRED",
   STATE_MISMATCH_ERROR: "STATE_MISMATCH_ERROR"
 };
+var FFID_SUBSCRIPTION_ERROR_CODES = {
+  CANCELLATION_SCHEDULED: "CANCELLATION_SCHEDULED",
+  PENDING_CHANGE_EXISTS: "PENDING_CHANGE_EXISTS",
+  CHANGE_DIRECTION_MIXED: "CHANGE_DIRECTION_MIXED",
+  CHANGE_PAYMENT_FAILED: "CHANGE_PAYMENT_FAILED",
+  SAME_PLAN_SELECTED: "SAME_PLAN_SELECTED",
+  NO_PENDING_DOWNGRADE: "NO_PENDING_DOWNGRADE",
+  SUBSCRIPTION_NOT_CANCELABLE: "SUBSCRIPTION_NOT_CANCELABLE",
+  SUBSCRIPTION_ALREADY_CANCELED: "SUBSCRIPTION_ALREADY_CANCELED",
+  FREE_DOWNGRADE_NOT_ALLOWED: "FREE_DOWNGRADE_NOT_ALLOWED",
+  PAYMENT_METHOD_REQUIRED: "PAYMENT_METHOD_REQUIRED"
+};
 
 // src/client/ffid-client.ts
 var UNAUTHORIZED_STATUS2 = 401;
@@ -4319,6 +4497,15 @@ function FFIDProvider({
     }),
     [serviceCode, scope, apiBaseUrl, debug, logger, authMode, clientId, timeout, tokenStore]
   );
+  react.useEffect(() => {
+    const captured = captureAgencyInviteToken();
+    if (captured.persisted === false) {
+      client.logger.debug(
+        "[FFID SDK] \u62DB\u5F85\u30C8\u30FC\u30AF\u30F3\u306E cookie \u4FDD\u6301\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF08\u5225\u30DA\u30FC\u30B8\u3078\u56DE\u904A\u3059\u308B\u3068\u4EE3\u7406\u5E97\u306E\u7D10\u4ED8\u3051\u304C\u5931\u308F\u308C\u307E\u3059\uFF09",
+        { source: captured.source }
+      );
+    }
+  }, [client]);
   const refresh = react.useCallback(async () => {
     client.logger.debug("Refreshing session...");
     try {
@@ -6295,6 +6482,10 @@ function FFIDInquiryForm({
 }
 
 exports.ACCESS_GRANTING_EFFECTIVE_STATUSES = ACCESS_GRANTING_EFFECTIVE_STATUSES;
+exports.AGENCY_INVITE_COOKIE_MAX_AGE_SEC = AGENCY_INVITE_COOKIE_MAX_AGE_SEC;
+exports.AGENCY_INVITE_COOKIE_NAME = AGENCY_INVITE_COOKIE_NAME;
+exports.AGENCY_INVITE_TOKEN_PARAM = AGENCY_INVITE_TOKEN_PARAM;
+exports.AGENCY_INVITE_TOKEN_REDACTION = AGENCY_INVITE_TOKEN_REDACTION;
 exports.BLOCKING_EFFECTIVE_STATUSES = BLOCKING_EFFECTIVE_STATUSES;
 exports.CATALOG_HASH_PATTERN = CATALOG_HASH_PATTERN;
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
@@ -6323,8 +6514,11 @@ exports.FFID_INQUIRY_CATEGORIES_SITE_2026 = FFID_INQUIRY_CATEGORIES_SITE_2026;
 exports.FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES = FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_BYTES;
 exports.FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB = FFID_MAX_ORGANIZATION_LOGO_FILE_SIZE_MB;
 exports.FFID_ORGANIZATION_PROFILE_ERROR_CODES = FFID_ORGANIZATION_PROFILE_ERROR_CODES;
+exports.FFID_SUBSCRIPTION_ERROR_CODES = FFID_SUBSCRIPTION_ERROR_CODES;
 exports.canonicalizeCatalogValue = canonicalizeCatalogValue;
+exports.captureAgencyInviteToken = captureAgencyInviteToken;
 exports.cleanupStateStorage = cleanupStateStorage;
+exports.clearAgencyInviteToken = clearAgencyInviteToken;
 exports.computeEffectiveStatusFromSession = computeEffectiveStatusFromSession;
 exports.computeFFIDCheckoutCopyHash = computeFFIDCheckoutCopyHash;
 exports.computeLegalDisclosureHash = computeLegalDisclosureHash;
@@ -6344,6 +6538,9 @@ exports.isBlockedFromUserinfo = isBlockedFromUserinfo;
 exports.isFFIDInquiryAcquisitionSource = isFFIDInquiryAcquisitionSource;
 exports.isFFIDInquiryCategorySite2026 = isFFIDInquiryCategorySite2026;
 exports.normalizeRedirectUri = normalizeRedirectUri;
+exports.readAgencyInviteCookie = readAgencyInviteCookie;
+exports.readAgencyInviteToken = readAgencyInviteToken;
+exports.redactAgencyInviteToken = redactAgencyInviteToken;
 exports.retrieveCodeVerifier = retrieveCodeVerifier;
 exports.retrieveState = retrieveState;
 exports.sha256Hex = sha256Hex;