@feelflow/ffid-sdk 5.31.0 → 5.35.0

package/dist/agency/index.js

@@ -162,6 +162,14 @@ function createFFIDAgencyClient(config = {}) {
       { method: "DELETE" }
     );
   }
+  async function provisionOrganization(agencyId, data) {
+    const err = validateIds([agencyId, "agencyId"]);
+    if (err) return err;
+    return fetchWithCredentials(`/${encodeURIComponent(agencyId)}/organizations/provision`, {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
   async function getSubAgencies(agencyId) {
     const err = validateIds([agencyId, "agencyId"]);
     if (err) return err;
@@ -289,6 +297,7 @@ function createFFIDAgencyClient(config = {}) {
     getOrganizations,
     linkOrganization,
     unlinkOrganization,
+    provisionOrganization,
     // Sub-Agencies
     getSubAgencies,
     createSubAgency,
@@ -315,4 +324,106 @@ function createFFIDAgencyClient(config = {}) {
   };
 }
 
-export { FFID_AGENCY_ERROR_CODES, createFFIDAgencyClient };
+// src/agency/ffid-agency-server-client.ts
+var API_PREFIX2 = "/api/v1/ext/agencies";
+var AGENCY_API_KEY_HEADER = "X-Agency-Api-Key";
+var SDK_LOG_PREFIX2 = "[FFID Agency Server SDK]";
+var noopLogger2 = {
+  debug: () => {
+  },
+  info: () => {
+  },
+  warn: () => {
+  },
+  error: () => {
+  }
+};
+var consoleLogger2 = {
+  debug: (...args) => console.debug(SDK_LOG_PREFIX2, ...args),
+  info: (...args) => console.info(SDK_LOG_PREFIX2, ...args),
+  warn: (...args) => console.warn(SDK_LOG_PREFIX2, ...args),
+  error: (...args) => console.error(SDK_LOG_PREFIX2, ...args)
+};
+var DEFAULT_TIMEOUT_MS = 3e4;
+function createFFIDAgencyServerClient(config) {
+  const apiKey = config.apiKey?.trim() ?? "";
+  if (apiKey === "") {
+    throw new Error(
+      "createFFIDAgencyServerClient: apiKey is required (set it from an environment variable, never in browser code)"
+    );
+  }
+  const baseUrl = config.apiBaseUrl ?? DEFAULT_API_BASE_URL;
+  const logger = config.logger ?? (config.debug ? consoleLogger2 : noopLogger2);
+  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  async function request(endpoint, body) {
+    const url = `${baseUrl}${API_PREFIX2}${endpoint}`;
+    let response;
+    try {
+      response = await fetch(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          [AGENCY_API_KEY_HEADER]: apiKey
+        },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+    } catch (error) {
+      logger.error("Network error:", { url, error });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.NETWORK_ERROR,
+          // タイムアウトも組織が作られた後かもしれない。再試行の前に確認を促す。
+          message: `${error instanceof Error ? error.message : "\u30CD\u30C3\u30C8\u30EF\u30FC\u30AF\u30A8\u30E9\u30FC\u304C\u767A\u751F\u3057\u307E\u3057\u305F"}\u3002\u7D44\u7E54\u304C\u4F5C\u6210\u3055\u308C\u305F\u53EF\u80FD\u6027\u304C\u3042\u308B\u305F\u3081\u3001\u518D\u8A66\u884C\u524D\u306B\u7D44\u7E54\u4E00\u89A7\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044`
+        }
+      };
+    }
+    let payload;
+    try {
+      payload = await response.json();
+    } catch (parseError) {
+      logger.error("Parse error:", { url, status: response.status, parseError });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.PARSE_ERROR,
+          message: `\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u4E0D\u6B63\u306A\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u53D7\u4FE1\u3057\u307E\u3057\u305F (status: ${response.status})\u3002\u7D44\u7E54\u304C\u4F5C\u6210\u3055\u308C\u305F\u53EF\u80FD\u6027\u304C\u3042\u308B\u305F\u3081\u3001\u518D\u8A66\u884C\u524D\u306B\u7D44\u7E54\u4E00\u89A7\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044`
+        }
+      };
+    }
+    if (payload === null || typeof payload !== "object") {
+      logger.error("Malformed response body:", { url, status: response.status });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.PARSE_ERROR,
+          message: `\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u4E0D\u6B63\u306A\u30EC\u30B9\u30DD\u30F3\u30B9\u3092\u53D7\u4FE1\u3057\u307E\u3057\u305F (status: ${response.status})`
+        }
+      };
+    }
+    const parsed = payload;
+    if (!response.ok || parsed.success !== true) {
+      return {
+        error: {
+          code: parsed.error?.code ?? FFID_AGENCY_ERROR_CODES.UNKNOWN_ERROR,
+          message: parsed.error?.message ?? `\u30EA\u30AF\u30A8\u30B9\u30C8\u304C\u5931\u6557\u3057\u307E\u3057\u305F (${response.status})`
+        }
+      };
+    }
+    if (parsed.data === void 0) {
+      logger.error("Missing data in successful response:", { url });
+      return {
+        error: {
+          code: FFID_AGENCY_ERROR_CODES.UNKNOWN_ERROR,
+          message: "\u30B5\u30FC\u30D0\u30FC\u304B\u3089\u30C7\u30FC\u30BF\u304C\u8FD4\u3055\u308C\u307E\u305B\u3093\u3067\u3057\u305F"
+        }
+      };
+    }
+    return { data: parsed.data };
+  }
+  return {
+    async provisionCustomerOrganization(data) {
+      return request("/organizations/provision", data);
+    }
+  };
+}
+
+export { FFID_AGENCY_ERROR_CODES, createFFIDAgencyClient, createFFIDAgencyServerClient };

package/dist/{chunk-5HDQ2KPC.js → chunk-53IBN7NO.js}

@@ -132,13 +132,18 @@ function normalizeSeatAssignmentClaim(raw, organizationId, subscriptionId) {
     status
   };
 }
+var ACCOUNT_TYPE_WIRE_VALUES = ["personal", "organization"];
+function normalizeAccountTypeValue(value) {
+  if (value === null) return null;
+  return typeof value === "string" && ACCOUNT_TYPE_WIRE_VALUES.includes(value) ? value : void 0;
+}
 function normalizeUserinfo(raw) {
   const hasOrganizationId = hasOwnKey(raw, "organization_id");
   const hasOrganizationName = hasOwnKey(raw, "organization_name");
   const hasOrganizationMemberRole = hasOwnKey(raw, "organization_member_role");
   const organizationMemberRole = hasOrganizationMemberRole ? raw.organization_member_role ?? null : raw.subscription ? raw.subscription.member_role ?? null : void 0;
   const hasOrganizationAccountType = hasOwnKey(raw, "organization_account_type");
-  const organizationAccountType = hasOrganizationAccountType ? raw.organization_account_type ?? null : raw.subscription && hasOwnKey(raw.subscription, "account_type") ? raw.subscription.account_type ?? null : void 0;
+  const organizationAccountType = hasOrganizationAccountType ? normalizeAccountTypeValue(raw.organization_account_type) : raw.subscription && hasOwnKey(raw.subscription, "account_type") ? normalizeAccountTypeValue(raw.subscription.account_type) : void 0;
   const organizationFields = {
     ...hasOrganizationId ? { organizationId: raw.organization_id ?? null } : {},
     ...hasOrganizationId || hasOrganizationName ? { organizationName: raw.organization_name ?? null } : {},
@@ -169,8 +174,9 @@ function normalizeUserinfo(raw) {
       organizationName: hasOwnKey(raw.subscription, "organization_name") ? raw.subscription.organization_name ?? null : null,
       // #4531: `undefined` means an older FFID omitted the field on the
       // wire — genuinely unknown, not "no account type". Do not default
-      // to either literal.
-      accountType: hasOwnKey(raw.subscription, "account_type") ? raw.subscription.account_type ?? null : void 0,
+      // to either literal. An unrecognized non-null wire value folds to
+      // `undefined` the same way (see `normalizeAccountTypeValue`).
+      accountType: hasOwnKey(raw.subscription, "account_type") ? normalizeAccountTypeValue(raw.subscription.account_type) : void 0,
       hasSeatAssignment: raw.subscription.has_seat_assignment ?? false,
       seatAssignment: hasOwnKey(raw.subscription, "seat_assignment") ? normalizeSeatAssignmentClaim(
         raw.subscription.seat_assignment,
@@ -1339,7 +1345,11 @@ function createProvisioningMethods(deps) {
     }
     return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
       method: "POST",
-      body: JSON.stringify({ email: params.email.trim() })
+      body: JSON.stringify({
+        email: params.email.trim(),
+        ...params.template !== void 0 ? { template: params.template } : {},
+        ...params.returnTo !== void 0 ? { returnTo: params.returnTo } : {}
+      })
     });
   }
   async function provisionOrganization(params) {
@@ -1665,7 +1675,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.31.0";
+var SDK_VERSION = "5.35.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/{chunk-X7SWYOG3.cjs → chunk-WG2YHUGO.cjs}

@@ -134,13 +134,18 @@ function normalizeSeatAssignmentClaim(raw, organizationId, subscriptionId) {
     status
   };
 }
+var ACCOUNT_TYPE_WIRE_VALUES = ["personal", "organization"];
+function normalizeAccountTypeValue(value) {
+  if (value === null) return null;
+  return typeof value === "string" && ACCOUNT_TYPE_WIRE_VALUES.includes(value) ? value : void 0;
+}
 function normalizeUserinfo(raw) {
   const hasOrganizationId = hasOwnKey(raw, "organization_id");
   const hasOrganizationName = hasOwnKey(raw, "organization_name");
   const hasOrganizationMemberRole = hasOwnKey(raw, "organization_member_role");
   const organizationMemberRole = hasOrganizationMemberRole ? raw.organization_member_role ?? null : raw.subscription ? raw.subscription.member_role ?? null : void 0;
   const hasOrganizationAccountType = hasOwnKey(raw, "organization_account_type");
-  const organizationAccountType = hasOrganizationAccountType ? raw.organization_account_type ?? null : raw.subscription && hasOwnKey(raw.subscription, "account_type") ? raw.subscription.account_type ?? null : void 0;
+  const organizationAccountType = hasOrganizationAccountType ? normalizeAccountTypeValue(raw.organization_account_type) : raw.subscription && hasOwnKey(raw.subscription, "account_type") ? normalizeAccountTypeValue(raw.subscription.account_type) : void 0;
   const organizationFields = {
     ...hasOrganizationId ? { organizationId: raw.organization_id ?? null } : {},
     ...hasOrganizationId || hasOrganizationName ? { organizationName: raw.organization_name ?? null } : {},
@@ -171,8 +176,9 @@ function normalizeUserinfo(raw) {
       organizationName: hasOwnKey(raw.subscription, "organization_name") ? raw.subscription.organization_name ?? null : null,
       // #4531: `undefined` means an older FFID omitted the field on the
       // wire — genuinely unknown, not "no account type". Do not default
-      // to either literal.
-      accountType: hasOwnKey(raw.subscription, "account_type") ? raw.subscription.account_type ?? null : void 0,
+      // to either literal. An unrecognized non-null wire value folds to
+      // `undefined` the same way (see `normalizeAccountTypeValue`).
+      accountType: hasOwnKey(raw.subscription, "account_type") ? normalizeAccountTypeValue(raw.subscription.account_type) : void 0,
       hasSeatAssignment: raw.subscription.has_seat_assignment ?? false,
       seatAssignment: hasOwnKey(raw.subscription, "seat_assignment") ? normalizeSeatAssignmentClaim(
         raw.subscription.seat_assignment,
@@ -1341,7 +1347,11 @@ function createProvisioningMethods(deps) {
     }
     return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
       method: "POST",
-      body: JSON.stringify({ email: params.email.trim() })
+      body: JSON.stringify({
+        email: params.email.trim(),
+        ...params.template !== void 0 ? { template: params.template } : {},
+        ...params.returnTo !== void 0 ? { returnTo: params.returnTo } : {}
+      })
     });
   }
   async function provisionOrganization(params) {
@@ -1667,7 +1677,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.31.0";
+var SDK_VERSION = "5.35.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/components/index.cjs

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

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { H as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a3 as FFIDLoginButton, ar as FFIDLoginButtonProps, a5 as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ab as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-BY_GDJm6.cjs';
+export { H as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a3 as FFIDLoginButton, ar as FFIDLoginButtonProps, a5 as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ab as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-BMKhKhzF.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { H as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a3 as FFIDLoginButton, ar as FFIDLoginButtonProps, a5 as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ab as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-BY_GDJm6.js';
+export { H as FFIDAnnouncementBadge, an as FFIDAnnouncementBadgeClassNames, ao as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ap as FFIDAnnouncementListClassNames, aq as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormLegalLayout, Y as FFIDInquiryFormOrganization, Z as FFIDInquiryFormPlaceholderContext, _ as FFIDInquiryFormPrefill, $ as FFIDInquiryFormProps, a0 as FFIDInquiryFormSubmitData, a1 as FFIDInquiryFormSubmitResult, a3 as FFIDLoginButton, ar as FFIDLoginButtonProps, a5 as FFIDOrganizationSwitcher, as as FFIDOrganizationSwitcherClassNames, at as FFIDOrganizationSwitcherProps, ab as FFIDSubscriptionBadge, au as FFIDSubscriptionBadgeClassNames, av as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, aw as FFIDUserMenuClassNames, ax as FFIDUserMenuProps } from '../index-BMKhKhzF.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-5HDQ2KPC.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-53IBN7NO.js';

package/dist/{constants-D61jqRIO.d.cts → constants-Ce2eXQtB.d.cts}

@@ -11,13 +11,16 @@ declare const DEFAULT_API_BASE_URL = "https://id.feelflow.net";
  *
  * Coverage:
  * - `openid email profile` — OIDC standard claims (always required)
- * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系（プラン / 課金 gate）
+ * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系の **読み取り**
+ *   （`check` / `plans` / 契約詳細・シート参照。プラン / 課金 gate）
  * - `legal:read` — `/api/v1/legal/ext` 系（利用規約・同意状態）
  *
  * Add feature-specific scopes on top of this when needed (browser SDK):
  * - `analytics:read` for `/api/v1/ext/analytics/config`
  * - `organization:read` / `organization:write` for `/api/v1/organizations/ext/members`
- * - `subscription:write` for self-serve plan changes
+ * - `subscription:write` for every subscription **mutation** — `subscribe()`
+ *   (`POST /ext/subscribe`), plan changes, and cancellation. `subscription:read`
+ *   does NOT cover these despite the shared `/ext/*` prefix (FFID #4744)
  * - `legal:write` for recording user consent
  * - `profile:read` / `profile:write` for profile UI
  * - `organization:api-key` for org-level API key issuance

package/dist/{constants-D61jqRIO.d.ts → constants-Ce2eXQtB.d.ts}

@@ -11,13 +11,16 @@ declare const DEFAULT_API_BASE_URL = "https://id.feelflow.net";
  *
  * Coverage:
  * - `openid email profile` — OIDC standard claims (always required)
- * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系（プラン / 課金 gate）
+ * - `subscription:read` — `/api/v1/subscriptions/ext/*` 系の **読み取り**
+ *   （`check` / `plans` / 契約詳細・シート参照。プラン / 課金 gate）
  * - `legal:read` — `/api/v1/legal/ext` 系（利用規約・同意状態）
  *
  * Add feature-specific scopes on top of this when needed (browser SDK):
  * - `analytics:read` for `/api/v1/ext/analytics/config`
  * - `organization:read` / `organization:write` for `/api/v1/organizations/ext/members`
- * - `subscription:write` for self-serve plan changes
+ * - `subscription:write` for every subscription **mutation** — `subscribe()`
+ *   (`POST /ext/subscribe`), plan changes, and cancellation. `subscription:read`
+ *   does NOT cover these despite the shared `/ext/*` prefix (FFID #4744)
  * - `legal:write` for recording user consent
  * - `profile:read` / `profile:write` for profile UI
  * - `organization:api-key` for org-level API key issuance

package/dist/{ffid-client-B39Xy92M.d.cts → ffid-client-C8XV7lUt.d.cts}

@@ -860,10 +860,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
-/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+/**
+ * Copy variant for `sendProvisionWelcomeEmail` (#5035).
+ *
+ * Both variants carry the same password-setup link; only the wording differs.
+ * Mirrors the server's `provisionEmailTemplateSchema` — the API rejects unknown
+ * values rather than defaulting, so a typo here surfaces as a 400 instead of
+ * mailing the wrong copy.
+ */
+type FFIDProvisionEmailTemplate = 'account-provisioned' | 'password-reset';
+/** Parameters for `sendProvisionWelcomeEmail` (#4449, #4470, #5035). */
 interface FFIDProvisionWelcomeEmailParams {
     /** Email of the provisioned FFID user to notify (must already exist). */
     email: string;
+    /**
+     * Which copy to send (#5035). Omit for the historical
+     * `account-provisioned`（「アカウント発行のお知らせ」）; pass `'password-reset'`
+     * for an already-active member whose admin requested a reset
+     * （「パスワード再設定のご案内」）.
+     */
+    template?: FFIDProvisionEmailTemplate;
+    /**
+     * Post-setup landing URL (#4470). Validated against the calling service's
+     * `allowed_redirect_uris` server-side. Omit to keep the FFID login page.
+     */
+    returnTo?: string;
 }
 /**
  * Response from `sendProvisionWelcomeEmail` (#4449).
@@ -1461,8 +1482,8 @@ declare const FFID_CATALOG_ENVIRONMENTS: readonly ["staging", "production"];
 type FFIDCatalogEnvironment = (typeof FFID_CATALOG_ENVIRONMENTS)[number];
 /**
  * Tax behavior of a published price.
- * `inclusive`: displayed price contains Stripe-calculated tax (Personal/Pro).
- * `exclusive`: tax is added on top of the base price (Team).
+ * `inclusive`: displayed price contains Stripe-calculated tax.
+ * `exclusive`: tax is added on top of the base price.
  */
 type FFIDTaxBehavior = 'inclusive' | 'exclusive';
 /**
@@ -1687,7 +1708,7 @@ interface FFIDOAuthUserInfoSubscription {
     memberRole: FFIDOAuthUserInfoMemberRole | null;
     organizationId: string | null;
     organizationName?: string | null | undefined;
-    /** Personal/organization split (#4531). `undefined` = older FFID predates the field; treat as unknown, don't guess. */
+    /** Personal/organization split (#4531). `undefined` (older FFID predates the field) and `null` (introspect path; current FFID always sends non-null) are equally "unknown" — never fold either into `'organization'`. */
     accountType?: FFIDAccountType | null | undefined;
     hasSeatAssignment: boolean | null;
     /**
@@ -1787,7 +1808,7 @@ interface FFIDOAuthUserInfo {
      * are normalized from `subscription.member_role` when available.
      */
     organizationMemberRole?: FFIDOAuthUserInfoMemberRole | null | undefined;
-    /** Personal/organization split (#4531). Mirrors `organizationMemberRole` (same undefined/fallback rules). */
+    /** Personal/organization split (#4531). Same precedence as `organizationMemberRole` (top-level first, then `subscription` derivation), but unlike it this can be `undefined` even with `subscription` present — `subscription.account_type` is itself optional (pre-#4531 FFID), whereas `subscription.member_role` is always populated and only degrades to `null`. */
     organizationAccountType?: FFIDAccountType | null | undefined;
     /**
      * Subscription summary for `(user, service, organization)`. Branch on

package/dist/{ffid-client-BB_c4FGi.d.ts → ffid-client-CpVixUM3.d.ts}

@@ -860,10 +860,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
-/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+/**
+ * Copy variant for `sendProvisionWelcomeEmail` (#5035).
+ *
+ * Both variants carry the same password-setup link; only the wording differs.
+ * Mirrors the server's `provisionEmailTemplateSchema` — the API rejects unknown
+ * values rather than defaulting, so a typo here surfaces as a 400 instead of
+ * mailing the wrong copy.
+ */
+type FFIDProvisionEmailTemplate = 'account-provisioned' | 'password-reset';
+/** Parameters for `sendProvisionWelcomeEmail` (#4449, #4470, #5035). */
 interface FFIDProvisionWelcomeEmailParams {
     /** Email of the provisioned FFID user to notify (must already exist). */
     email: string;
+    /**
+     * Which copy to send (#5035). Omit for the historical
+     * `account-provisioned`（「アカウント発行のお知らせ」）; pass `'password-reset'`
+     * for an already-active member whose admin requested a reset
+     * （「パスワード再設定のご案内」）.
+     */
+    template?: FFIDProvisionEmailTemplate;
+    /**
+     * Post-setup landing URL (#4470). Validated against the calling service's
+     * `allowed_redirect_uris` server-side. Omit to keep the FFID login page.
+     */
+    returnTo?: string;
 }
 /**
  * Response from `sendProvisionWelcomeEmail` (#4449).
@@ -1461,8 +1482,8 @@ declare const FFID_CATALOG_ENVIRONMENTS: readonly ["staging", "production"];
 type FFIDCatalogEnvironment = (typeof FFID_CATALOG_ENVIRONMENTS)[number];
 /**
  * Tax behavior of a published price.
- * `inclusive`: displayed price contains Stripe-calculated tax (Personal/Pro).
- * `exclusive`: tax is added on top of the base price (Team).
+ * `inclusive`: displayed price contains Stripe-calculated tax.
+ * `exclusive`: tax is added on top of the base price.
  */
 type FFIDTaxBehavior = 'inclusive' | 'exclusive';
 /**
@@ -1687,7 +1708,7 @@ interface FFIDOAuthUserInfoSubscription {
     memberRole: FFIDOAuthUserInfoMemberRole | null;
     organizationId: string | null;
     organizationName?: string | null | undefined;
-    /** Personal/organization split (#4531). `undefined` = older FFID predates the field; treat as unknown, don't guess. */
+    /** Personal/organization split (#4531). `undefined` (older FFID predates the field) and `null` (introspect path; current FFID always sends non-null) are equally "unknown" — never fold either into `'organization'`. */
     accountType?: FFIDAccountType | null | undefined;
     hasSeatAssignment: boolean | null;
     /**
@@ -1787,7 +1808,7 @@ interface FFIDOAuthUserInfo {
      * are normalized from `subscription.member_role` when available.
      */
     organizationMemberRole?: FFIDOAuthUserInfoMemberRole | null | undefined;
-    /** Personal/organization split (#4531). Mirrors `organizationMemberRole` (same undefined/fallback rules). */
+    /** Personal/organization split (#4531). Same precedence as `organizationMemberRole` (top-level first, then `subscription` derivation), but unlike it this can be `undefined` even with `subscription` present — `subscription.account_type` is itself optional (pre-#4531 FFID), whereas `subscription.member_role` is always populated and only degrades to `null`. */
     organizationAccountType?: FFIDAccountType | null | undefined;
     /**
      * Subscription summary for `(user, service, organization)`. Branch on

package/dist/{index-BY_GDJm6.d.cts → index-BMKhKhzF.d.cts}

@@ -342,7 +342,7 @@ interface FFIDOAuthUserInfoSubscription {
     memberRole: FFIDOAuthUserInfoMemberRole | null;
     organizationId: string | null;
     organizationName?: string | null | undefined;
-    /** Personal/organization split (#4531). `undefined` = older FFID predates the field; treat as unknown, don't guess. */
+    /** Personal/organization split (#4531). `undefined` (older FFID predates the field) and `null` (introspect path; current FFID always sends non-null) are equally "unknown" — never fold either into `'organization'`. */
     accountType?: FFIDAccountType | null | undefined;
     hasSeatAssignment: boolean | null;
     /**
@@ -442,7 +442,7 @@ interface FFIDOAuthUserInfo {
      * are normalized from `subscription.member_role` when available.
      */
     organizationMemberRole?: FFIDOAuthUserInfoMemberRole | null | undefined;
-    /** Personal/organization split (#4531). Mirrors `organizationMemberRole` (same undefined/fallback rules). */
+    /** Personal/organization split (#4531). Same precedence as `organizationMemberRole` (top-level first, then `subscription` derivation), but unlike it this can be `undefined` even with `subscription` present — `subscription.account_type` is itself optional (pre-#4531 FFID), whereas `subscription.member_role` is always populated and only degrades to `null`. */
     organizationAccountType?: FFIDAccountType | null | undefined;
     /**
      * Subscription summary for `(user, service, organization)`. Branch on

package/dist/{index-BY_GDJm6.d.ts → index-BMKhKhzF.d.ts}

@@ -342,7 +342,7 @@ interface FFIDOAuthUserInfoSubscription {
     memberRole: FFIDOAuthUserInfoMemberRole | null;
     organizationId: string | null;
     organizationName?: string | null | undefined;
-    /** Personal/organization split (#4531). `undefined` = older FFID predates the field; treat as unknown, don't guess. */
+    /** Personal/organization split (#4531). `undefined` (older FFID predates the field) and `null` (introspect path; current FFID always sends non-null) are equally "unknown" — never fold either into `'organization'`. */
     accountType?: FFIDAccountType | null | undefined;
     hasSeatAssignment: boolean | null;
     /**
@@ -442,7 +442,7 @@ interface FFIDOAuthUserInfo {
      * are normalized from `subscription.member_role` when available.
      */
     organizationMemberRole?: FFIDOAuthUserInfoMemberRole | null | undefined;
-    /** Personal/organization split (#4531). Mirrors `organizationMemberRole` (same undefined/fallback rules). */
+    /** Personal/organization split (#4531). Same precedence as `organizationMemberRole` (top-level first, then `subscription` derivation), but unlike it this can be `undefined` even with `subscription` present — `subscription.account_type` is itself optional (pre-#4531 FFID), whereas `subscription.member_role` is always populated and only degrades to `null`. */
     organizationAccountType?: FFIDAccountType | null | undefined;
     /**
      * Subscription summary for `(user, service, organization)`. Branch on