@feelflow/ffid-sdk 5.28.0 → 5.29.0

package/dist/{chunk-75UNNOLV.js → chunk-4QQJMLL7.js}

@@ -1287,6 +1287,7 @@ function createMembersMethods(deps) {
 
 // src/client/provisioning-methods.ts
 var USER_PROVISION_ENDPOINT = "/api/v1/ext/users/provision";
+var USER_WELCOME_EMAIL_ENDPOINT = "/api/v1/ext/users/welcome-email";
 var ORGANIZATION_PROVISION_ENDPOINT = "/api/v1/ext/organizations/provision";
 var MAX_PROVISION_MEMBERS = 100;
 var ASSIGNABLE_MEMBER_ROLES = {
@@ -1303,7 +1304,7 @@ function createProvisioningMethods(deps) {
     if (authMode === "service-key") return null;
     return createError(
       "VALIDATION_ERROR",
-      "provisionUser / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
+      "provisionUser / sendProvisionWelcomeEmail / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
     );
   }
   async function provisionUser(params) {
@@ -1320,6 +1321,17 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
+  async function sendProvisionWelcomeEmail(params) {
+    const modeError = serviceKeyModeError();
+    if (modeError) return { error: modeError };
+    if (!params.email || !params.email.trim()) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ email: params.email.trim() })
+    });
+  }
   async function provisionOrganization(params) {
     const modeError = serviceKeyModeError();
     if (modeError) return { error: modeError };
@@ -1369,7 +1381,7 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
-  return { provisionUser, provisionOrganization };
+  return { provisionUser, sendProvisionWelcomeEmail, provisionOrganization };
 }
 
 // src/client/seat-methods.ts
@@ -1643,7 +1655,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.28.0";
+var SDK_VERSION = "5.29.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3689,7 +3701,7 @@ function createFFIDClient(config) {
     createError,
     serviceCode: config.serviceCode
   });
-  const { provisionUser, provisionOrganization } = createProvisioningMethods({
+  const { provisionUser, sendProvisionWelcomeEmail, provisionOrganization } = createProvisioningMethods({
     fetchWithAuth,
     createError,
     authMode
@@ -3790,6 +3802,7 @@ function createFFIDClient(config) {
     updateMemberRole,
     removeMember,
     provisionUser,
+    sendProvisionWelcomeEmail,
     provisionOrganization,
     getProfile,
     updateProfile,

package/dist/{chunk-S5FV6H2U.cjs → chunk-MESRDT7H.cjs}

@@ -1289,6 +1289,7 @@ function createMembersMethods(deps) {
 
 // src/client/provisioning-methods.ts
 var USER_PROVISION_ENDPOINT = "/api/v1/ext/users/provision";
+var USER_WELCOME_EMAIL_ENDPOINT = "/api/v1/ext/users/welcome-email";
 var ORGANIZATION_PROVISION_ENDPOINT = "/api/v1/ext/organizations/provision";
 var MAX_PROVISION_MEMBERS = 100;
 var ASSIGNABLE_MEMBER_ROLES = {
@@ -1305,7 +1306,7 @@ function createProvisioningMethods(deps) {
     if (authMode === "service-key") return null;
     return createError(
       "VALIDATION_ERROR",
-      "provisionUser / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
+      "provisionUser / sendProvisionWelcomeEmail / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
     );
   }
   async function provisionUser(params) {
@@ -1322,6 +1323,17 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
+  async function sendProvisionWelcomeEmail(params) {
+    const modeError = serviceKeyModeError();
+    if (modeError) return { error: modeError };
+    if (!params.email || !params.email.trim()) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ email: params.email.trim() })
+    });
+  }
   async function provisionOrganization(params) {
     const modeError = serviceKeyModeError();
     if (modeError) return { error: modeError };
@@ -1371,7 +1383,7 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
-  return { provisionUser, provisionOrganization };
+  return { provisionUser, sendProvisionWelcomeEmail, provisionOrganization };
 }
 
 // src/client/seat-methods.ts
@@ -1645,7 +1657,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.28.0";
+var SDK_VERSION = "5.29.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3691,7 +3703,7 @@ function createFFIDClient(config) {
     createError,
     serviceCode: config.serviceCode
   });
-  const { provisionUser, provisionOrganization } = createProvisioningMethods({
+  const { provisionUser, sendProvisionWelcomeEmail, provisionOrganization } = createProvisioningMethods({
     fetchWithAuth,
     createError,
     authMode
@@ -3792,6 +3804,7 @@ function createFFIDClient(config) {
     updateMemberRole,
     removeMember,
     provisionUser,
+    sendProvisionWelcomeEmail,
     provisionOrganization,
     getProfile,
     updateProfile,

package/dist/components/index.cjs

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

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-75UNNOLV.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-4QQJMLL7.js';

package/dist/{ffid-client-DEM1nYqe.d.ts → ffid-client-DCS-MoxK.d.ts}

@@ -852,6 +852,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -2178,6 +2203,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/{ffid-client-B_VBvIt4.d.cts → ffid-client-hv2PuUr7.d.cts}

@@ -852,6 +852,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -2178,6 +2203,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkS5FV6H2U_cjs = require('./chunk-S5FV6H2U.cjs');
+var chunkMESRDT7H_cjs = require('./chunk-MESRDT7H.cjs');
 var chunkH5O2CCAY_cjs = require('./chunk-H5O2CCAY.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
@@ -54,8 +54,8 @@ function defaultRedirect(url) {
 }
 function useRequireActiveSubscription(options) {
   const { redirectTo, allowGrace = true, onRedirect } = options;
-  const { isLoading, error } = chunkS5FV6H2U_cjs.useFFIDContext();
-  const { effectiveStatus, isBlocked, isGrace } = chunkS5FV6H2U_cjs.useSubscription();
+  const { isLoading, error } = chunkMESRDT7H_cjs.useFFIDContext();
+  const { effectiveStatus, isBlocked, isGrace } = chunkMESRDT7H_cjs.useSubscription();
   const hasFetchError = error !== null && effectiveStatus === null;
   const shouldRedirect = !isLoading && !hasFetchError && (isBlocked || !allowGrace && isGrace || effectiveStatus === null);
   react.useEffect(() => {
@@ -76,7 +76,7 @@ function useRequireActiveSubscription(options) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunkS5FV6H2U_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkMESRDT7H_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -105,219 +105,219 @@ var FFID_NEWSLETTER_DISPATCH_MAX_RECIPIENTS = 1e3;
 
 Object.defineProperty(exports, "ACCESS_GRANTING_EFFECTIVE_STATUSES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.ACCESS_GRANTING_EFFECTIVE_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.ACCESS_GRANTING_EFFECTIVE_STATUSES; }
 });
 Object.defineProperty(exports, "BLOCKING_EFFECTIVE_STATUSES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.BLOCKING_EFFECTIVE_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.BLOCKING_EFFECTIVE_STATUSES; }
 });
 Object.defineProperty(exports, "CATALOG_HASH_PATTERN", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.CATALOG_HASH_PATTERN; }
+  get: function () { return chunkMESRDT7H_cjs.CATALOG_HASH_PATTERN; }
 });
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkMESRDT7H_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "DEFAULT_OAUTH_SCOPES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.DEFAULT_OAUTH_SCOPES; }
+  get: function () { return chunkMESRDT7H_cjs.DEFAULT_OAUTH_SCOPES; }
 });
 Object.defineProperty(exports, "EFFECTIVE_SUBSCRIPTION_STATUSES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.EFFECTIVE_SUBSCRIPTION_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.EFFECTIVE_SUBSCRIPTION_STATUSES; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDCatalogHashError", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDCatalogHashError; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDCatalogHashError; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDInquiryForm; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDLoginButton; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDProvider; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDSDKError; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFIDUserMenu; }
+  get: function () { return chunkMESRDT7H_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_CATALOG_ENVIRONMENTS", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_CATALOG_ENVIRONMENTS; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_CATALOG_ENVIRONMENTS; }
 });
 Object.defineProperty(exports, "FFID_CATALOG_PUBLICATION_STATUSES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_CATALOG_PUBLICATION_STATUSES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_CATALOG_PUBLICATION_STATUSES; }
 });
 Object.defineProperty(exports, "FFID_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_ERROR_CODES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_ACQUISITION_SOURCES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_INQUIRY_ACQUISITION_SOURCES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_ACQUISITION_SOURCES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkMESRDT7H_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "canonicalizeCatalogValue", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.canonicalizeCatalogValue; }
+  get: function () { return chunkMESRDT7H_cjs.canonicalizeCatalogValue; }
 });
 Object.defineProperty(exports, "clearState", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.cleanupStateStorage; }
+  get: function () { return chunkMESRDT7H_cjs.cleanupStateStorage; }
 });
 Object.defineProperty(exports, "computeEffectiveStatusFromSession", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computeEffectiveStatusFromSession; }
+  get: function () { return chunkMESRDT7H_cjs.computeEffectiveStatusFromSession; }
 });
 Object.defineProperty(exports, "computeFFIDCheckoutCopyHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computeFFIDCheckoutCopyHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeFFIDCheckoutCopyHash; }
 });
 Object.defineProperty(exports, "computeLegalDisclosureHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computeLegalDisclosureHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeLegalDisclosureHash; }
 });
 Object.defineProperty(exports, "computePaymentConfigurationHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computePaymentConfigurationHash; }
+  get: function () { return chunkMESRDT7H_cjs.computePaymentConfigurationHash; }
 });
 Object.defineProperty(exports, "computePraxisCopyHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computePraxisCopyHash; }
+  get: function () { return chunkMESRDT7H_cjs.computePraxisCopyHash; }
 });
 Object.defineProperty(exports, "computeScopeHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computeScopeHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeScopeHash; }
 });
 Object.defineProperty(exports, "computeTaxConfigurationHash", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.computeTaxConfigurationHash; }
+  get: function () { return chunkMESRDT7H_cjs.computeTaxConfigurationHash; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkMESRDT7H_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.createFFIDClient; }
+  get: function () { return chunkMESRDT7H_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.createTokenStore; }
+  get: function () { return chunkMESRDT7H_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.generateCodeChallenge; }
+  get: function () { return chunkMESRDT7H_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.generateCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "handleRedirectCallback", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.handleRedirectCallback; }
+  get: function () { return chunkMESRDT7H_cjs.handleRedirectCallback; }
 });
 Object.defineProperty(exports, "hasAccessFromUserinfo", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.hasAccessFromUserinfo; }
+  get: function () { return chunkMESRDT7H_cjs.hasAccessFromUserinfo; }
 });
 Object.defineProperty(exports, "hashCanonicalJson", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.hashCanonicalJson; }
+  get: function () { return chunkMESRDT7H_cjs.hashCanonicalJson; }
 });
 Object.defineProperty(exports, "isBlockedFromUserinfo", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.isBlockedFromUserinfo; }
+  get: function () { return chunkMESRDT7H_cjs.isBlockedFromUserinfo; }
 });
 Object.defineProperty(exports, "isFFIDInquiryAcquisitionSource", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.isFFIDInquiryAcquisitionSource; }
+  get: function () { return chunkMESRDT7H_cjs.isFFIDInquiryAcquisitionSource; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkMESRDT7H_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.normalizeRedirectUri; }
+  get: function () { return chunkMESRDT7H_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveState", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.retrieveState; }
+  get: function () { return chunkMESRDT7H_cjs.retrieveState; }
 });
 Object.defineProperty(exports, "sha256Hex", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.sha256Hex; }
+  get: function () { return chunkMESRDT7H_cjs.sha256Hex; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.storeCodeVerifier; }
+  get: function () { return chunkMESRDT7H_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "storeState", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.storeState; }
+  get: function () { return chunkMESRDT7H_cjs.storeState; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.useFFID; }
+  get: function () { return chunkMESRDT7H_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkMESRDT7H_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.useSubscription; }
+  get: function () { return chunkMESRDT7H_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "validatePublishedCatalog", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.validatePublishedCatalog; }
+  get: function () { return chunkMESRDT7H_cjs.validatePublishedCatalog; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunkS5FV6H2U_cjs.withSubscription; }
+  get: function () { return chunkMESRDT7H_cjs.withSubscription; }
 });
 Object.defineProperty(exports, "ALL_DENIED_EXCEPT_NECESSARY", {
   enumerable: true,

package/dist/index.d.cts

@@ -625,6 +625,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -1577,6 +1602,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/index.d.ts

@@ -625,6 +625,31 @@ interface FFIDProvisionUserDryRun {
  * response. This mirrors how `FFIDApiResponse` is narrowed on `data` / `error`.
  */
 type FFIDProvisionUserResponse = FFIDProvisionUserOutcome | FFIDProvisionUserDryRun;
+/** Parameters for `sendProvisionWelcomeEmail` (#4449). */
+interface FFIDProvisionWelcomeEmailParams {
+    /** Email of the provisioned FFID user to notify (must already exist). */
+    email: string;
+}
+/**
+ * Response from `sendProvisionWelcomeEmail` (#4449).
+ *
+ * `status` is always `'sent'` on the data branch. Non-success outcomes arrive
+ * on the error branch instead:
+ * - `USER_NOT_FOUND` (404) — provision the user first.
+ * - `RATE_LIMITED` (429) — per-recipient cooldown; `details.retryAfterSeconds`
+ *   says when a resend will be accepted. The cooldown is claimed only after a
+ *   successful send, so a 429 always means an email really was just sent.
+ * - `RECOVERY_LINK_GENERATION_FAILED` (502) — the password-setup link could
+ *   not be generated; nothing was sent.
+ * - `EMAIL_SEND_FAILED` / `EMAIL_SEND_FAILED_PERMANENT` (502),
+ *   `EMAIL_SERVICE_UNAVAILABLE` (503) — delivery-side failures; the caller
+ *   should surface "not delivered" and offer a resend (failed attempts do not
+ *   consume the cooldown, so an immediate retry is accepted).
+ */
+interface FFIDProvisionWelcomeEmailResponse {
+    status: 'sent';
+    user: FFIDProvisionedUser;
+}
 /** A member to add to the provisioned organization. */
 interface FFIDProvisionOrganizationMemberInput {
     email: string;
@@ -1577,6 +1602,7 @@ declare function createFFIDClient(config: FFIDConfig): {
         userId: string;
     }) => Promise<FFIDApiResponse<FFIDRemoveMemberResponse>>;
     provisionUser: (params: FFIDProvisionUserParams) => Promise<FFIDApiResponse<FFIDProvisionUserResponse>>;
+    sendProvisionWelcomeEmail: (params: FFIDProvisionWelcomeEmailParams) => Promise<FFIDApiResponse<FFIDProvisionWelcomeEmailResponse>>;
     provisionOrganization: (params: FFIDProvisionOrganizationParams) => Promise<FFIDApiResponse<FFIDProvisionOrganizationResponse>>;
     getProfile: (options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;
     updateProfile: (data: FFIDUpdateUserProfileRequest, options?: FFIDProfileCallOptions) => Promise<FFIDApiResponse<FFIDUserProfile>>;

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext, useSubscription } from './chunk-75UNNOLV.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-75UNNOLV.js';
+import { useFFIDContext, useSubscription } from './chunk-4QQJMLL7.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-4QQJMLL7.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/server/index.cjs

@@ -1284,6 +1284,7 @@ function createMembersMethods(deps) {
 
 // src/client/provisioning-methods.ts
 var USER_PROVISION_ENDPOINT = "/api/v1/ext/users/provision";
+var USER_WELCOME_EMAIL_ENDPOINT = "/api/v1/ext/users/welcome-email";
 var ORGANIZATION_PROVISION_ENDPOINT = "/api/v1/ext/organizations/provision";
 var MAX_PROVISION_MEMBERS = 100;
 var ASSIGNABLE_MEMBER_ROLES = {
@@ -1300,7 +1301,7 @@ function createProvisioningMethods(deps) {
     if (authMode === "service-key") return null;
     return createError(
       "VALIDATION_ERROR",
-      "provisionUser / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
+      "provisionUser / sendProvisionWelcomeEmail / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
     );
   }
   async function provisionUser(params) {
@@ -1317,6 +1318,17 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
+  async function sendProvisionWelcomeEmail(params) {
+    const modeError = serviceKeyModeError();
+    if (modeError) return { error: modeError };
+    if (!params.email || !params.email.trim()) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ email: params.email.trim() })
+    });
+  }
   async function provisionOrganization(params) {
     const modeError = serviceKeyModeError();
     if (modeError) return { error: modeError };
@@ -1366,7 +1378,7 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
-  return { provisionUser, provisionOrganization };
+  return { provisionUser, sendProvisionWelcomeEmail, provisionOrganization };
 }
 
 // src/client/seat-methods.ts
@@ -1640,7 +1652,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.28.0";
+var SDK_VERSION = "5.29.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3516,7 +3528,7 @@ function createFFIDClient(config) {
     createError,
     serviceCode: config.serviceCode
   });
-  const { provisionUser, provisionOrganization } = createProvisioningMethods({
+  const { provisionUser, sendProvisionWelcomeEmail, provisionOrganization } = createProvisioningMethods({
     fetchWithAuth,
     createError,
     authMode
@@ -3617,6 +3629,7 @@ function createFFIDClient(config) {
     updateMemberRole,
     removeMember,
     provisionUser,
+    sendProvisionWelcomeEmail,
     provisionOrganization,
     getProfile,
     updateProfile,

package/dist/server/index.d.cts

@@ -1,5 +1,5 @@
-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-B_VBvIt4.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-B_VBvIt4.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-hv2PuUr7.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-hv2PuUr7.cjs';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.cjs';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.cjs';

package/dist/server/index.d.ts

@@ -1,5 +1,5 @@
-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-DEM1nYqe.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-DEM1nYqe.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-DCS-MoxK.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-DCS-MoxK.js';
 export { D as DEFAULT_API_BASE_URL, a as DEFAULT_OAUTH_SCOPES } from '../constants-D61jqRIO.js';
 import { z } from 'zod';
 import '../types-Cjb9J0rL.js';

package/dist/server/index.js

@@ -1283,6 +1283,7 @@ function createMembersMethods(deps) {
 
 // src/client/provisioning-methods.ts
 var USER_PROVISION_ENDPOINT = "/api/v1/ext/users/provision";
+var USER_WELCOME_EMAIL_ENDPOINT = "/api/v1/ext/users/welcome-email";
 var ORGANIZATION_PROVISION_ENDPOINT = "/api/v1/ext/organizations/provision";
 var MAX_PROVISION_MEMBERS = 100;
 var ASSIGNABLE_MEMBER_ROLES = {
@@ -1299,7 +1300,7 @@ function createProvisioningMethods(deps) {
     if (authMode === "service-key") return null;
     return createError(
       "VALIDATION_ERROR",
-      "provisionUser / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
+      "provisionUser / sendProvisionWelcomeEmail / provisionOrganization \u306F service-key \u8A8D\u8A3C\uFF08X-Service-Api-Key\uFF09\u3067\u306E\u307F\u5229\u7528\u3067\u304D\u307E\u3059\u3002Bearer / cookie \u30E2\u30FC\u30C9\u3067\u306F\u547C\u3073\u51FA\u305B\u307E\u305B\u3093"
     );
   }
   async function provisionUser(params) {
@@ -1316,6 +1317,17 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
+  async function sendProvisionWelcomeEmail(params) {
+    const modeError = serviceKeyModeError();
+    if (modeError) return { error: modeError };
+    if (!params.email || !params.email.trim()) {
+      return { error: createError("VALIDATION_ERROR", "email \u306F\u5FC5\u9808\u3067\u3059") };
+    }
+    return fetchWithAuth(USER_WELCOME_EMAIL_ENDPOINT, {
+      method: "POST",
+      body: JSON.stringify({ email: params.email.trim() })
+    });
+  }
   async function provisionOrganization(params) {
     const modeError = serviceKeyModeError();
     if (modeError) return { error: modeError };
@@ -1365,7 +1377,7 @@ function createProvisioningMethods(deps) {
       body: JSON.stringify(body)
     });
   }
-  return { provisionUser, provisionOrganization };
+  return { provisionUser, sendProvisionWelcomeEmail, provisionOrganization };
 }
 
 // src/client/seat-methods.ts
@@ -1639,7 +1651,7 @@ function validateTokenResponse(tokenResponse) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "5.28.0";
+var SDK_VERSION = "5.29.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {
@@ -3515,7 +3527,7 @@ function createFFIDClient(config) {
     createError,
     serviceCode: config.serviceCode
   });
-  const { provisionUser, provisionOrganization } = createProvisioningMethods({
+  const { provisionUser, sendProvisionWelcomeEmail, provisionOrganization } = createProvisioningMethods({
     fetchWithAuth,
     createError,
     authMode
@@ -3616,6 +3628,7 @@ function createFFIDClient(config) {
     updateMemberRole,
     removeMember,
     provisionUser,
+    sendProvisionWelcomeEmail,
     provisionOrganization,
     getProfile,
     updateProfile,

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

@@ -1,4 +1,4 @@
-import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-B_VBvIt4.cjs';
+import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-hv2PuUr7.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-DEM1nYqe.js';
+import { q as FFIDClient, e as FFIDOAuthUserInfo } from '../../ffid-client-DCS-MoxK.js';
 import '../../types-Cjb9J0rL.js';
 
 /**

package/package.json

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