@feelflow/ffid-sdk 5.31.1 → 6.0.0

package/dist/index.d.cts

@@ -18,13 +18,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
@@ -633,10 +636,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).
@@ -1303,8 +1327,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';
 /**

package/dist/index.d.ts

@@ -18,13 +18,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
@@ -633,10 +636,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).
@@ -1303,8 +1327,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';
 /**

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-SLYSWV4S.js';
-export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EFFECTIVE_SUBSCRIPTION_STATUSES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDCatalogHashError, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_ERROR_CODES, FFID_INQUIRY_ACQUISITION_SOURCES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, canonicalizeCatalogValue, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, isFFIDInquiryAcquisitionSource, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useFFIDAnnouncements, useSubscription, validatePublishedCatalog, withSubscription } from './chunk-SLYSWV4S.js';
+import { useFFIDContext, useSubscription } from './chunk-NBBHMLXO.js';
+export { ACCESS_GRANTING_EFFECTIVE_STATUSES, BLOCKING_EFFECTIVE_STATUSES, CATALOG_HASH_PATTERN, DEFAULT_API_BASE_URL, DEFAULT_OAUTH_SCOPES, EFFECTIVE_SUBSCRIPTION_STATUSES, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDCatalogHashError, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_CATALOG_ENVIRONMENTS, FFID_CATALOG_PUBLICATION_STATUSES, FFID_ERROR_CODES, FFID_INQUIRY_ACQUISITION_SOURCES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, canonicalizeCatalogValue, cleanupStateStorage as clearState, computeEffectiveStatusFromSession, computeFFIDCheckoutCopyHash, computeLegalDisclosureHash, computePaymentConfigurationHash, computePraxisCopyHash, computeScopeHash, computeTaxConfigurationHash, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, handleRedirectCallback, hasAccessFromUserinfo, hashCanonicalJson, isBlockedFromUserinfo, isFFIDInquiryAcquisitionSource, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, retrieveState, sha256Hex, storeCodeVerifier, storeState, useFFID, useFFIDAnnouncements, useSubscription, validatePublishedCatalog, withSubscription } from './chunk-NBBHMLXO.js';
 export { ALL_DENIED_EXCEPT_NECESSARY, CONSENT_COOKIE_NAME, CONSENT_DISMISSAL_TIMESTAMP_KEY, COOKIE_VERSION, DEFAULT_CONSENT_ERROR_MESSAGES, FFIDAnalyticsProvider, FFIDConsentError, FFIDCookieBanner, FFIDCookieLink, FFIDCookieSettings, FFID_CONSENT_ERROR_CODES, clearConsentDismissalTimestamp, decodeConsentCookie, encodeConsentCookie, readConsentCookie, readConsentDismissalTimestamp, useFFIDConsent, useFFIDConsentPreferences, writeConsentCookie, writeConsentDismissalTimestamp } from './chunk-G7VOX64X.js';
 import { useEffect, useRef } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';

package/dist/legal/index.cjs

@@ -16,7 +16,14 @@ var FFID_LEGAL_ERROR_CODES = {
   /** Server returned error without structured error body */
   UNKNOWN_ERROR: "UNKNOWN_ERROR",
   /** Input validation failed (empty required parameters) */
-  VALIDATION_ERROR: "VALIDATION_ERROR"
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  /**
+   * `externalUserEmail` was missing or blank (since 6.0.0).
+   *
+   * The same code the API returns with HTTP 422, so a consumer can branch on
+   * one value whether the request was refused locally or by the server.
+   */
+  EXTERNAL_USER_EMAIL_REQUIRED: "EXTERNAL_USER_EMAIL_REQUIRED"
 };
 var noopLogger = {
   debug: () => {
@@ -125,6 +132,14 @@ function createFFIDLegalClient(config) {
         }
       };
     }
+    if (typeof request.externalUserEmail !== "string" || !request.externalUserEmail.trim()) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.EXTERNAL_USER_EMAIL_REQUIRED,
+          message: "externalUserEmail is required"
+        }
+      };
+    }
     return fetchWithApiKey("/agreements", {
       method: "POST",
       body: JSON.stringify(request)

package/dist/legal/index.d.cts

@@ -1,4 +1,4 @@
-export { D as DEFAULT_API_BASE_URL } from '../constants-D61jqRIO.cjs';
+export { D as DEFAULT_API_BASE_URL } from '../constants-Ce2eXQtB.cjs';
 
 /**
  * FFID Legal SDK Type Definitions
@@ -79,10 +79,21 @@ interface FFIDServiceUserAgreement {
     id: string;
     /** Service ID (UUID) */
     serviceId: string;
-    /** External user ID (from the calling service) */
+    /**
+     * Opaque user identifier owned by the calling service (its own primary key,
+     * or the upstream IdP's `sub`).
+     *
+     * Do **not** put an FFID user ID here — FFID resolves its own linkage from
+     * `externalUserEmail` and exposes it as {@link FFIDServiceUserAgreement.userId}.
+     */
     externalUserId: string;
-    /** External user email (optional) */
+    /** External user email recorded at agreement time */
     externalUserEmail: string | null;
+    /**
+     * FFID user this consent resolved to, or `null` when no FFID account matched
+     * `externalUserEmail`. The consent record is kept either way.
+     */
+    userId: string | null;
     /** Document ID (UUID) */
     documentId: string;
     /** Agreement timestamp (ISO 8601) */
@@ -108,10 +119,19 @@ interface FFIDServiceUserAgreement {
  * Request to record an agreement
  */
 interface FFIDRecordAgreementRequest {
-    /** External user ID (from the calling service, e.g., Google OAuth ID) */
+    /**
+     * Opaque user identifier owned by the calling service (its own primary key,
+     * or the upstream IdP's `sub`). Do **not** send an FFID user ID.
+     */
     externalUserId: string;
-    /** External user email (optional) */
-    externalUserEmail?: string;
+    /**
+     * External user email. **Required.**
+     *
+     * FFID uses it as the only input for resolving this consent to an FFID user,
+     * and rejects the request with HTTP 422 (`EXTERNAL_USER_EMAIL_REQUIRED`) when
+     * it is missing or blank.
+     */
+    externalUserEmail: string;
     /** Document ID to agree to */
     documentId: string;
     /** Method of agreement (defaults to 'click_through') */
@@ -295,6 +315,13 @@ declare const FFID_LEGAL_ERROR_CODES: {
     readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
     /** Input validation failed (empty required parameters) */
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /**
+     * `externalUserEmail` was missing or blank (since 6.0.0).
+     *
+     * The same code the API returns with HTTP 422, so a consumer can branch on
+     * one value whether the request was refused locally or by the server.
+     */
+    readonly EXTERNAL_USER_EMAIL_REQUIRED: "EXTERNAL_USER_EMAIL_REQUIRED";
 };
 /**
  * Creates an FFID Legal API client instance

package/dist/legal/index.d.ts

@@ -1,4 +1,4 @@
-export { D as DEFAULT_API_BASE_URL } from '../constants-D61jqRIO.js';
+export { D as DEFAULT_API_BASE_URL } from '../constants-Ce2eXQtB.js';
 
 /**
  * FFID Legal SDK Type Definitions
@@ -79,10 +79,21 @@ interface FFIDServiceUserAgreement {
     id: string;
     /** Service ID (UUID) */
     serviceId: string;
-    /** External user ID (from the calling service) */
+    /**
+     * Opaque user identifier owned by the calling service (its own primary key,
+     * or the upstream IdP's `sub`).
+     *
+     * Do **not** put an FFID user ID here — FFID resolves its own linkage from
+     * `externalUserEmail` and exposes it as {@link FFIDServiceUserAgreement.userId}.
+     */
     externalUserId: string;
-    /** External user email (optional) */
+    /** External user email recorded at agreement time */
     externalUserEmail: string | null;
+    /**
+     * FFID user this consent resolved to, or `null` when no FFID account matched
+     * `externalUserEmail`. The consent record is kept either way.
+     */
+    userId: string | null;
     /** Document ID (UUID) */
     documentId: string;
     /** Agreement timestamp (ISO 8601) */
@@ -108,10 +119,19 @@ interface FFIDServiceUserAgreement {
  * Request to record an agreement
  */
 interface FFIDRecordAgreementRequest {
-    /** External user ID (from the calling service, e.g., Google OAuth ID) */
+    /**
+     * Opaque user identifier owned by the calling service (its own primary key,
+     * or the upstream IdP's `sub`). Do **not** send an FFID user ID.
+     */
     externalUserId: string;
-    /** External user email (optional) */
-    externalUserEmail?: string;
+    /**
+     * External user email. **Required.**
+     *
+     * FFID uses it as the only input for resolving this consent to an FFID user,
+     * and rejects the request with HTTP 422 (`EXTERNAL_USER_EMAIL_REQUIRED`) when
+     * it is missing or blank.
+     */
+    externalUserEmail: string;
     /** Document ID to agree to */
     documentId: string;
     /** Method of agreement (defaults to 'click_through') */
@@ -295,6 +315,13 @@ declare const FFID_LEGAL_ERROR_CODES: {
     readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
     /** Input validation failed (empty required parameters) */
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    /**
+     * `externalUserEmail` was missing or blank (since 6.0.0).
+     *
+     * The same code the API returns with HTTP 422, so a consumer can branch on
+     * one value whether the request was refused locally or by the server.
+     */
+    readonly EXTERNAL_USER_EMAIL_REQUIRED: "EXTERNAL_USER_EMAIL_REQUIRED";
 };
 /**
  * Creates an FFID Legal API client instance

package/dist/legal/index.js

@@ -15,7 +15,14 @@ var FFID_LEGAL_ERROR_CODES = {
   /** Server returned error without structured error body */
   UNKNOWN_ERROR: "UNKNOWN_ERROR",
   /** Input validation failed (empty required parameters) */
-  VALIDATION_ERROR: "VALIDATION_ERROR"
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  /**
+   * `externalUserEmail` was missing or blank (since 6.0.0).
+   *
+   * The same code the API returns with HTTP 422, so a consumer can branch on
+   * one value whether the request was refused locally or by the server.
+   */
+  EXTERNAL_USER_EMAIL_REQUIRED: "EXTERNAL_USER_EMAIL_REQUIRED"
 };
 var noopLogger = {
   debug: () => {
@@ -124,6 +131,14 @@ function createFFIDLegalClient(config) {
         }
       };
     }
+    if (typeof request.externalUserEmail !== "string" || !request.externalUserEmail.trim()) {
+      return {
+        error: {
+          code: FFID_LEGAL_ERROR_CODES.EXTERNAL_USER_EMAIL_REQUIRED,
+          message: "externalUserEmail is required"
+        }
+      };
+    }
     return fetchWithApiKey("/agreements", {
       method: "POST",
       body: JSON.stringify(request)

package/dist/server/index.cjs

@@ -1342,7 +1342,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) {
@@ -1668,7 +1672,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.31.1";
+var SDK_VERSION = "6.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/index.d.cts

@@ -1,6 +1,6 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-BTTbDVj7.cjs';
-export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAssignableMemberRole, n as FFIDCacheConfig, o as FFIDCatalogPublication, p as FFIDCatalogPublicationStatus, q as FFIDClient, r as FFIDConfig, s as FFIDListMembersResponse, t as FFIDMemberRole, u as FFIDOrganization, v as FFIDOrganizationMember, w as FFIDOtpSendResponse, x as FFIDOtpVerifyResponse, y as FFIDPasswordResetConfirmResponse, z as FFIDPasswordResetResponse, A as FFIDPasswordResetVerifyResponse, B as FFIDProfileCallOptions, C as FFIDProvisionMemberPlan, D as FFIDProvisionMemberPlanStatus, E as FFIDProvisionMemberResult, G as FFIDProvisionMemberStatus, H as FFIDProvisionOrganizationDryRun, I as FFIDProvisionOrganizationMemberInput, J as FFIDProvisionOrganizationOutcome, K as FFIDProvisionOrganizationParams, L as FFIDProvisionOrganizationResponse, M as FFIDProvisionUserDryRun, N as FFIDProvisionUserOutcome, O as FFIDProvisionUserParams, P as FFIDProvisionUserProfileInput, Q as FFIDProvisionUserResponse, R as FFIDProvisionedOrganization, S as FFIDProvisionedUser, T as FFIDPublishedPlan, U as FFIDRemoveMemberResponse, V as FFIDResetSessionResponse, W as FFIDSubscription, X as FFIDUpdateMemberRoleResponse, Y as FFIDUpdateUserProfileRequest, Z as FFIDUser, _ as FFIDUserProfile, $ as FFID_CATALOG_ENVIRONMENTS, a0 as FFID_CATALOG_PUBLICATION_STATUSES, a1 as TokenData, a2 as TokenStore, a3 as createFFIDClient, a4 as createTokenStore } from '../ffid-client-BTTbDVj7.cjs';
-export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.cjs';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-C8XV7lUt.cjs';
+export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAssignableMemberRole, n as FFIDCacheConfig, o as FFIDCatalogPublication, p as FFIDCatalogPublicationStatus, q as FFIDClient, r as FFIDConfig, s as FFIDListMembersResponse, t as FFIDMemberRole, u as FFIDOrganization, v as FFIDOrganizationMember, w as FFIDOtpSendResponse, x as FFIDOtpVerifyResponse, y as FFIDPasswordResetConfirmResponse, z as FFIDPasswordResetResponse, A as FFIDPasswordResetVerifyResponse, B as FFIDProfileCallOptions, C as FFIDProvisionMemberPlan, D as FFIDProvisionMemberPlanStatus, E as FFIDProvisionMemberResult, G as FFIDProvisionMemberStatus, H as FFIDProvisionOrganizationDryRun, I as FFIDProvisionOrganizationMemberInput, J as FFIDProvisionOrganizationOutcome, K as FFIDProvisionOrganizationParams, L as FFIDProvisionOrganizationResponse, M as FFIDProvisionUserDryRun, N as FFIDProvisionUserOutcome, O as FFIDProvisionUserParams, P as FFIDProvisionUserProfileInput, Q as FFIDProvisionUserResponse, R as FFIDProvisionedOrganization, S as FFIDProvisionedUser, T as FFIDPublishedPlan, U as FFIDRemoveMemberResponse, V as FFIDResetSessionResponse, W as FFIDSubscription, X as FFIDUpdateMemberRoleResponse, Y as FFIDUpdateUserProfileRequest, Z as FFIDUser, _ as FFIDUserProfile, $ as FFID_CATALOG_ENVIRONMENTS, a0 as FFID_CATALOG_PUBLICATION_STATUSES, a1 as TokenData, a2 as TokenStore, a3 as createFFIDClient, a4 as createTokenStore } from '../ffid-client-C8XV7lUt.cjs';
+export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-Ce2eXQtB.cjs';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.cjs';
 

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-C5lc7SkY.js';
-export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAssignableMemberRole, n as FFIDCacheConfig, o as FFIDCatalogPublication, p as FFIDCatalogPublicationStatus, q as FFIDClient, r as FFIDConfig, s as FFIDListMembersResponse, t as FFIDMemberRole, u as FFIDOrganization, v as FFIDOrganizationMember, w as FFIDOtpSendResponse, x as FFIDOtpVerifyResponse, y as FFIDPasswordResetConfirmResponse, z as FFIDPasswordResetResponse, A as FFIDPasswordResetVerifyResponse, B as FFIDProfileCallOptions, C as FFIDProvisionMemberPlan, D as FFIDProvisionMemberPlanStatus, E as FFIDProvisionMemberResult, G as FFIDProvisionMemberStatus, H as FFIDProvisionOrganizationDryRun, I as FFIDProvisionOrganizationMemberInput, J as FFIDProvisionOrganizationOutcome, K as FFIDProvisionOrganizationParams, L as FFIDProvisionOrganizationResponse, M as FFIDProvisionUserDryRun, N as FFIDProvisionUserOutcome, O as FFIDProvisionUserParams, P as FFIDProvisionUserProfileInput, Q as FFIDProvisionUserResponse, R as FFIDProvisionedOrganization, S as FFIDProvisionedUser, T as FFIDPublishedPlan, U as FFIDRemoveMemberResponse, V as FFIDResetSessionResponse, W as FFIDSubscription, X as FFIDUpdateMemberRoleResponse, Y as FFIDUpdateUserProfileRequest, Z as FFIDUser, _ as FFIDUserProfile, $ as FFID_CATALOG_ENVIRONMENTS, a0 as FFID_CATALOG_PUBLICATION_STATUSES, a1 as TokenData, a2 as TokenStore, a3 as createFFIDClient, a4 as createTokenStore } from '../ffid-client-C5lc7SkY.js';
-export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.js';
+import { F as FFIDLogger, a as FFIDError, b as FFIDCacheAdapter, c as FFIDVerifyAccessTokenOptions, d as FFIDApiResponse, e as FFIDOAuthUserInfo, f as FFIDCatalogEnvironment, g as FFIDBillingInterval, h as FFIDTaxBehavior, i as FFIDPublishedCatalog } from '../ffid-client-CpVixUM3.js';
+export { j as FFIDAddMemberParams, k as FFIDAddMemberRequest, l as FFIDAddMemberResponse, m as FFIDAssignableMemberRole, n as FFIDCacheConfig, o as FFIDCatalogPublication, p as FFIDCatalogPublicationStatus, q as FFIDClient, r as FFIDConfig, s as FFIDListMembersResponse, t as FFIDMemberRole, u as FFIDOrganization, v as FFIDOrganizationMember, w as FFIDOtpSendResponse, x as FFIDOtpVerifyResponse, y as FFIDPasswordResetConfirmResponse, z as FFIDPasswordResetResponse, A as FFIDPasswordResetVerifyResponse, B as FFIDProfileCallOptions, C as FFIDProvisionMemberPlan, D as FFIDProvisionMemberPlanStatus, E as FFIDProvisionMemberResult, G as FFIDProvisionMemberStatus, H as FFIDProvisionOrganizationDryRun, I as FFIDProvisionOrganizationMemberInput, J as FFIDProvisionOrganizationOutcome, K as FFIDProvisionOrganizationParams, L as FFIDProvisionOrganizationResponse, M as FFIDProvisionUserDryRun, N as FFIDProvisionUserOutcome, O as FFIDProvisionUserParams, P as FFIDProvisionUserProfileInput, Q as FFIDProvisionUserResponse, R as FFIDProvisionedOrganization, S as FFIDProvisionedUser, T as FFIDPublishedPlan, U as FFIDRemoveMemberResponse, V as FFIDResetSessionResponse, W as FFIDSubscription, X as FFIDUpdateMemberRoleResponse, Y as FFIDUpdateUserProfileRequest, Z as FFIDUser, _ as FFIDUserProfile, $ as FFID_CATALOG_ENVIRONMENTS, a0 as FFID_CATALOG_PUBLICATION_STATUSES, a1 as TokenData, a2 as TokenStore, a3 as createFFIDClient, a4 as createTokenStore } from '../ffid-client-CpVixUM3.js';
+export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-Ce2eXQtB.js';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.js';
 

package/dist/server/index.js

@@ -1341,7 +1341,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 +1671,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.31.1";
+var SDK_VERSION = "6.0.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/server/test/index.d.cts

@@ -1,4 +1,4 @@
-import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-BTTbDVj7.cjs';
+import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-C8XV7lUt.cjs';
 import '../../types-Cjb9J0rL.cjs';
 
 /**

package/dist/server/test/index.d.ts

@@ -1,4 +1,4 @@
-import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-C5lc7SkY.js';
+import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-CpVixUM3.js';
 import '../../types-Cjb9J0rL.js';
 
 /**

package/package.json

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