@feelflow/ffid-sdk 2.15.0 → 2.16.0

package/README.md

@@ -266,6 +266,28 @@ const { data: updated, error: updateError } = await client.updateProfile({
 
 `updateProfile` に空オブジェクト `{}` を渡すと `VALIDATION_ERROR` が返ります（無意味なラウンドトリップを防止）。
 
+#### フィールドのクリア（null を渡す）
+
+optional フィールドに `null` を渡すと、FFID backend 側で該当カラムを SQL NULL にクリアします（v2.16.0〜 / #2354）。
+
+```tsx
+// 会社名と部署をクリア
+await client.updateProfile({
+  companyName: null,
+  department: null,
+})
+```
+
+値のセマンティクス:
+
+| 渡す値 | FFID backend の挙動 |
+| --- | --- |
+| `undefined` / キー未指定 | 未変更（partial update） |
+| `null` | クリア（SQL NULL を書き込む） |
+| `""`（空文字列） | 空文字リテラルをそのまま保存（`null` 扱いには**ならない**） |
+
+対応フィールド: `displayName` / `phone` / `companyName` / `department` / `jobTitle` / `preferences`。`timezone` / `locale` は application-level invariant（サーバー側 normalization が string 前提）のため null 非許容。クリアは不可 — キー未指定で現状維持、もしくは新しい有効な値を渡す。
+
 ## 型定義
 
 ```typescript

package/dist/{chunk-OOGFUCRJ.js → chunk-4IWCKZJV.js}

@@ -808,7 +808,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.15.0";
+var SDK_VERSION = "2.16.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/dist/{chunk-6XEWLARZ.cjs → chunk-PA6S2M7C.cjs}

@@ -810,7 +810,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.15.0";
+var SDK_VERSION = "2.16.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 chunk6XEWLARZ_cjs = require('../chunk-6XEWLARZ.cjs');
+var chunkPA6S2M7C_cjs = require('../chunk-PA6S2M7C.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDInquiryForm; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDLoginButton; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDUserMenu; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDUserMenu; }
 });

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { K as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, M as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a2 as FFIDLoginButton, an as FFIDLoginButtonProps, a8 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-LPTvxtgt.cjs';
+export { K as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, M as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a2 as FFIDLoginButton, an as FFIDLoginButtonProps, a8 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-DbEyptzr.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { K as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, M as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a2 as FFIDLoginButton, an as FFIDLoginButtonProps, a8 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-LPTvxtgt.js';
+export { K as FFIDAnnouncementBadge, aj as FFIDAnnouncementBadgeClassNames, ak as FFIDAnnouncementBadgeProps, M as FFIDAnnouncementList, al as FFIDAnnouncementListClassNames, am as FFIDAnnouncementListProps, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a2 as FFIDLoginButton, an as FFIDLoginButtonProps, a8 as FFIDOrganizationSwitcher, ao as FFIDOrganizationSwitcherClassNames, ap as FFIDOrganizationSwitcherProps, aa as FFIDSubscriptionBadge, aq as FFIDSubscriptionBadgeClassNames, ar as FFIDSubscriptionBadgeProps, ac as FFIDUserMenu, as as FFIDUserMenuClassNames, at as FFIDUserMenuProps } from '../index-DbEyptzr.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

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

package/dist/{index-LPTvxtgt.d.cts → index-DbEyptzr.d.cts}

@@ -497,24 +497,42 @@ interface FFIDProfileCallOptions {
  *
  * Mirrors the FFID backend `UpdateUserProfileRequest` shape. All fields are
  * optional — only the supplied keys will be updated (partial update semantics).
+ *
+ * Per-field value semantics:
+ * - `undefined` / key omitted → field is untouched (partial update)
+ * - `null` → clears the field (stores SQL NULL in the DB)
+ * - `""` (empty string) → stored as a literal empty string, **not** treated as
+ *   a clear. Use `null` when you want the DB value to become NULL
+ *
+ * `timezone` and `locale` are intentionally modeled as non-null in this
+ * request type (application-level invariant — the DB columns have DEFAULT
+ * values but no NOT NULL constraint, yet the server-side normalization
+ * pipeline assumes a string is always present). Pass a string to update the
+ * value, or omit the key to leave the current value in place. Do not pass
+ * `null` to clear — there is no meaningful "no timezone" state for a user.
+ *
+ * `preferences: null` is accepted and clears the column. Subsequent reads
+ * return `{}` because the FFID backend normalizes a null `preferences` column
+ * to an empty object (`toUserProfile` helper) before serializing the response —
+ * the SDK itself does not transform the payload.
  */
 interface FFIDUpdateUserProfileRequest {
-    /** Display name */
-    displayName?: string;
-    /** Phone number */
-    phone?: string;
-    /** Company name */
-    companyName?: string;
-    /** Department */
-    department?: string;
-    /** Job title */
-    jobTitle?: string;
-    /** IANA timezone */
+    /** Display name (null clears the field) */
+    displayName?: string | null;
+    /** Phone number (null clears the field) */
+    phone?: string | null;
+    /** Company name (null clears the field) */
+    companyName?: string | null;
+    /** Department (null clears the field) */
+    department?: string | null;
+    /** Job title (null clears the field) */
+    jobTitle?: string | null;
+    /** IANA timezone (non-null; omit the key to leave unchanged) */
     timezone?: string;
-    /** Locale */
+    /** Locale (non-null; omit the key to leave unchanged) */
     locale?: string;
-    /** Arbitrary user preferences bag */
-    preferences?: Record<string, unknown>;
+    /** Arbitrary user preferences bag (null clears the column; reads return {}) */
+    preferences?: Record<string, unknown> | null;
 }
 /**
  * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)

package/dist/{index-LPTvxtgt.d.ts → index-DbEyptzr.d.ts}

@@ -497,24 +497,42 @@ interface FFIDProfileCallOptions {
  *
  * Mirrors the FFID backend `UpdateUserProfileRequest` shape. All fields are
  * optional — only the supplied keys will be updated (partial update semantics).
+ *
+ * Per-field value semantics:
+ * - `undefined` / key omitted → field is untouched (partial update)
+ * - `null` → clears the field (stores SQL NULL in the DB)
+ * - `""` (empty string) → stored as a literal empty string, **not** treated as
+ *   a clear. Use `null` when you want the DB value to become NULL
+ *
+ * `timezone` and `locale` are intentionally modeled as non-null in this
+ * request type (application-level invariant — the DB columns have DEFAULT
+ * values but no NOT NULL constraint, yet the server-side normalization
+ * pipeline assumes a string is always present). Pass a string to update the
+ * value, or omit the key to leave the current value in place. Do not pass
+ * `null` to clear — there is no meaningful "no timezone" state for a user.
+ *
+ * `preferences: null` is accepted and clears the column. Subsequent reads
+ * return `{}` because the FFID backend normalizes a null `preferences` column
+ * to an empty object (`toUserProfile` helper) before serializing the response —
+ * the SDK itself does not transform the payload.
  */
 interface FFIDUpdateUserProfileRequest {
-    /** Display name */
-    displayName?: string;
-    /** Phone number */
-    phone?: string;
-    /** Company name */
-    companyName?: string;
-    /** Department */
-    department?: string;
-    /** Job title */
-    jobTitle?: string;
-    /** IANA timezone */
+    /** Display name (null clears the field) */
+    displayName?: string | null;
+    /** Phone number (null clears the field) */
+    phone?: string | null;
+    /** Company name (null clears the field) */
+    companyName?: string | null;
+    /** Department (null clears the field) */
+    department?: string | null;
+    /** Job title (null clears the field) */
+    jobTitle?: string | null;
+    /** IANA timezone (non-null; omit the key to leave unchanged) */
     timezone?: string;
-    /** Locale */
+    /** Locale (non-null; omit the key to leave unchanged) */
     locale?: string;
-    /** Arbitrary user preferences bag */
-    preferences?: Record<string, unknown>;
+    /** Arbitrary user preferences bag (null clears the column; reads return {}) */
+    preferences?: Record<string, unknown> | null;
 }
 /**
  * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk6XEWLARZ_cjs = require('./chunk-6XEWLARZ.cjs');
+var chunkPA6S2M7C_cjs = require('./chunk-PA6S2M7C.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -46,7 +46,7 @@ function createKVCacheAdapter(kv) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunk6XEWLARZ_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunkPA6S2M7C_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -74,107 +74,107 @@ var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunkPA6S2M7C_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDAnnouncementList; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDInquiryForm; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDLoginButton; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDProvider; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDProvider; }
 });
 Object.defineProperty(exports, "FFIDSDKError", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDSDKError; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFIDUserMenu; }
+  get: function () { return chunkPA6S2M7C_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunkPA6S2M7C_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunkPA6S2M7C_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES_SITE_2026", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
+  get: function () { return chunkPA6S2M7C_cjs.FFID_INQUIRY_CATEGORIES_SITE_2026; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunkPA6S2M7C_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.createFFIDClient; }
+  get: function () { return chunkPA6S2M7C_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.createTokenStore; }
+  get: function () { return chunkPA6S2M7C_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.generateCodeChallenge; }
+  get: function () { return chunkPA6S2M7C_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.generateCodeVerifier; }
+  get: function () { return chunkPA6S2M7C_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "isFFIDInquiryCategorySite2026", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.isFFIDInquiryCategorySite2026; }
+  get: function () { return chunkPA6S2M7C_cjs.isFFIDInquiryCategorySite2026; }
 });
 Object.defineProperty(exports, "normalizeRedirectUri", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.normalizeRedirectUri; }
+  get: function () { return chunkPA6S2M7C_cjs.normalizeRedirectUri; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.retrieveCodeVerifier; }
+  get: function () { return chunkPA6S2M7C_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.storeCodeVerifier; }
+  get: function () { return chunkPA6S2M7C_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.useFFID; }
+  get: function () { return chunkPA6S2M7C_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.useFFIDAnnouncements; }
+  get: function () { return chunkPA6S2M7C_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.useSubscription; }
+  get: function () { return chunkPA6S2M7C_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunk6XEWLARZ_cjs.withSubscription; }
+  get: function () { return chunkPA6S2M7C_cjs.withSubscription; }
 });
 exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;
 exports.createKVCacheAdapter = createKVCacheAdapter;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDCreateCheckoutParams, o as FFIDCheckoutSessionResponse, p as FFIDCreatePortalParams, q as FFIDPortalSessionResponse, r as FFIDVerifyAccessTokenOptions, s as FFIDOAuthUserInfo, t as FFIDInquiryCreateParams, u as FFIDInquiryCreateResponse, v as FFIDAuthMode, w as FFIDLogger, x as FFIDCacheAdapter, y as FFIDUser, z as FFIDOrganization, A as FFIDSubscription, B as FFIDSubscriptionContextValue, C as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, D as FFIDAnnouncementsApiResponse, E as AnnouncementListResponse, G as FFIDAnnouncementsLogger } from './index-LPTvxtgt.cjs';
-export { H as Announcement, I as AnnouncementStatus, J as AnnouncementType, K as FFIDAnnouncementBadge, M as FFIDAnnouncementList, N as FFIDAnnouncementsError, O as FFIDAnnouncementsErrorCode, P as FFIDAnnouncementsServerResponse, Q as FFIDCacheConfig, R as FFIDContextValue, S as FFIDInquiryCategory, T as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDMemberStatus, a4 as FFIDOAuthTokenResponse, a5 as FFIDOAuthUserInfoMemberRole, a6 as FFIDOAuthUserInfoSubscription, a7 as FFIDOrganizationMember, a8 as FFIDOrganizationSwitcher, a9 as FFIDSeatModel, aa as FFIDSubscriptionBadge, ab as FFIDTokenIntrospectionResponse, ac as FFIDUserMenu, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as UseFFIDAnnouncementsOptions, ag as UseFFIDAnnouncementsReturn, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-LPTvxtgt.cjs';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDCreateCheckoutParams, o as FFIDCheckoutSessionResponse, p as FFIDCreatePortalParams, q as FFIDPortalSessionResponse, r as FFIDVerifyAccessTokenOptions, s as FFIDOAuthUserInfo, t as FFIDInquiryCreateParams, u as FFIDInquiryCreateResponse, v as FFIDAuthMode, w as FFIDLogger, x as FFIDCacheAdapter, y as FFIDUser, z as FFIDOrganization, A as FFIDSubscription, B as FFIDSubscriptionContextValue, C as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, D as FFIDAnnouncementsApiResponse, E as AnnouncementListResponse, G as FFIDAnnouncementsLogger } from './index-DbEyptzr.cjs';
+export { H as Announcement, I as AnnouncementStatus, J as AnnouncementType, K as FFIDAnnouncementBadge, M as FFIDAnnouncementList, N as FFIDAnnouncementsError, O as FFIDAnnouncementsErrorCode, P as FFIDAnnouncementsServerResponse, Q as FFIDCacheConfig, R as FFIDContextValue, S as FFIDInquiryCategory, T as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDMemberStatus, a4 as FFIDOAuthTokenResponse, a5 as FFIDOAuthUserInfoMemberRole, a6 as FFIDOAuthUserInfoSubscription, a7 as FFIDOrganizationMember, a8 as FFIDOrganizationSwitcher, a9 as FFIDSeatModel, aa as FFIDSubscriptionBadge, ab as FFIDTokenIntrospectionResponse, ac as FFIDUserMenu, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as UseFFIDAnnouncementsOptions, ag as UseFFIDAnnouncementsReturn, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-DbEyptzr.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDCreateCheckoutParams, o as FFIDCheckoutSessionResponse, p as FFIDCreatePortalParams, q as FFIDPortalSessionResponse, r as FFIDVerifyAccessTokenOptions, s as FFIDOAuthUserInfo, t as FFIDInquiryCreateParams, u as FFIDInquiryCreateResponse, v as FFIDAuthMode, w as FFIDLogger, x as FFIDCacheAdapter, y as FFIDUser, z as FFIDOrganization, A as FFIDSubscription, B as FFIDSubscriptionContextValue, C as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, D as FFIDAnnouncementsApiResponse, E as AnnouncementListResponse, G as FFIDAnnouncementsLogger } from './index-LPTvxtgt.js';
-export { H as Announcement, I as AnnouncementStatus, J as AnnouncementType, K as FFIDAnnouncementBadge, M as FFIDAnnouncementList, N as FFIDAnnouncementsError, O as FFIDAnnouncementsErrorCode, P as FFIDAnnouncementsServerResponse, Q as FFIDCacheConfig, R as FFIDContextValue, S as FFIDInquiryCategory, T as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDMemberStatus, a4 as FFIDOAuthTokenResponse, a5 as FFIDOAuthUserInfoMemberRole, a6 as FFIDOAuthUserInfoSubscription, a7 as FFIDOrganizationMember, a8 as FFIDOrganizationSwitcher, a9 as FFIDSeatModel, aa as FFIDSubscriptionBadge, ab as FFIDTokenIntrospectionResponse, ac as FFIDUserMenu, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as UseFFIDAnnouncementsOptions, ag as UseFFIDAnnouncementsReturn, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-LPTvxtgt.js';
+import { F as FFIDSubscriptionStatus, a as FFIDConfig, b as FFIDApiResponse, c as FFIDSessionResponse, d as FFIDRedirectResult, e as FFIDError, f as FFIDSubscriptionCheckResponse, g as FFIDListMembersResponse, h as FFIDMemberRole, i as FFIDUpdateMemberRoleResponse, j as FFIDRemoveMemberResponse, k as FFIDProfileCallOptions, l as FFIDUserProfile, m as FFIDUpdateUserProfileRequest, n as FFIDCreateCheckoutParams, o as FFIDCheckoutSessionResponse, p as FFIDCreatePortalParams, q as FFIDPortalSessionResponse, r as FFIDVerifyAccessTokenOptions, s as FFIDOAuthUserInfo, t as FFIDInquiryCreateParams, u as FFIDInquiryCreateResponse, v as FFIDAuthMode, w as FFIDLogger, x as FFIDCacheAdapter, y as FFIDUser, z as FFIDOrganization, A as FFIDSubscription, B as FFIDSubscriptionContextValue, C as FFIDAnnouncementsClientConfig, L as ListAnnouncementsOptions, D as FFIDAnnouncementsApiResponse, E as AnnouncementListResponse, G as FFIDAnnouncementsLogger } from './index-DbEyptzr.js';
+export { H as Announcement, I as AnnouncementStatus, J as AnnouncementType, K as FFIDAnnouncementBadge, M as FFIDAnnouncementList, N as FFIDAnnouncementsError, O as FFIDAnnouncementsErrorCode, P as FFIDAnnouncementsServerResponse, Q as FFIDCacheConfig, R as FFIDContextValue, S as FFIDInquiryCategory, T as FFIDInquiryCategorySite2026, U as FFIDInquiryForm, V as FFIDInquiryFormCategoryItem, W as FFIDInquiryFormClassNames, X as FFIDInquiryFormOrganization, Y as FFIDInquiryFormPlaceholderContext, Z as FFIDInquiryFormPrefill, _ as FFIDInquiryFormProps, $ as FFIDInquiryFormSubmitData, a0 as FFIDInquiryFormSubmitResult, a1 as FFIDJwtClaims, a2 as FFIDLoginButton, a3 as FFIDMemberStatus, a4 as FFIDOAuthTokenResponse, a5 as FFIDOAuthUserInfoMemberRole, a6 as FFIDOAuthUserInfoSubscription, a7 as FFIDOrganizationMember, a8 as FFIDOrganizationSwitcher, a9 as FFIDSeatModel, aa as FFIDSubscriptionBadge, ab as FFIDTokenIntrospectionResponse, ac as FFIDUserMenu, ad as FFID_INQUIRY_CATEGORIES, ae as FFID_INQUIRY_CATEGORIES_SITE_2026, af as UseFFIDAnnouncementsOptions, ag as UseFFIDAnnouncementsReturn, ah as isFFIDInquiryCategorySite2026, ai as useFFIDAnnouncements } from './index-DbEyptzr.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, FC } from 'react';
 

package/dist/index.js

@@ -1,5 +1,5 @@
-import { useFFIDContext } from './chunk-OOGFUCRJ.js';
-export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-OOGFUCRJ.js';
+import { useFFIDContext } from './chunk-4IWCKZJV.js';
+export { DEFAULT_API_BASE_URL, FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDProvider, FFIDSDKError, FFIDSubscriptionBadge, FFIDUserMenu, FFID_ANNOUNCEMENTS_ERROR_CODES, FFID_INQUIRY_CATEGORIES, FFID_INQUIRY_CATEGORIES_SITE_2026, createFFIDAnnouncementsClient, createFFIDClient, createTokenStore, generateCodeChallenge, generateCodeVerifier, isFFIDInquiryCategorySite2026, normalizeRedirectUri, retrieveCodeVerifier, storeCodeVerifier, useFFID, useFFIDAnnouncements, useSubscription, withSubscription } from './chunk-4IWCKZJV.js';
 import { useRef, useEffect } from 'react';
 import { jsx, Fragment } from 'react/jsx-runtime';
 

package/dist/server/index.cjs

@@ -806,7 +806,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.15.0";
+var SDK_VERSION = "2.16.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

@@ -851,24 +851,42 @@ interface FFIDProfileCallOptions {
  *
  * Mirrors the FFID backend `UpdateUserProfileRequest` shape. All fields are
  * optional — only the supplied keys will be updated (partial update semantics).
+ *
+ * Per-field value semantics:
+ * - `undefined` / key omitted → field is untouched (partial update)
+ * - `null` → clears the field (stores SQL NULL in the DB)
+ * - `""` (empty string) → stored as a literal empty string, **not** treated as
+ *   a clear. Use `null` when you want the DB value to become NULL
+ *
+ * `timezone` and `locale` are intentionally modeled as non-null in this
+ * request type (application-level invariant — the DB columns have DEFAULT
+ * values but no NOT NULL constraint, yet the server-side normalization
+ * pipeline assumes a string is always present). Pass a string to update the
+ * value, or omit the key to leave the current value in place. Do not pass
+ * `null` to clear — there is no meaningful "no timezone" state for a user.
+ *
+ * `preferences: null` is accepted and clears the column. Subsequent reads
+ * return `{}` because the FFID backend normalizes a null `preferences` column
+ * to an empty object (`toUserProfile` helper) before serializing the response —
+ * the SDK itself does not transform the payload.
  */
 interface FFIDUpdateUserProfileRequest {
-    /** Display name */
-    displayName?: string;
-    /** Phone number */
-    phone?: string;
-    /** Company name */
-    companyName?: string;
-    /** Department */
-    department?: string;
-    /** Job title */
-    jobTitle?: string;
-    /** IANA timezone */
+    /** Display name (null clears the field) */
+    displayName?: string | null;
+    /** Phone number (null clears the field) */
+    phone?: string | null;
+    /** Company name (null clears the field) */
+    companyName?: string | null;
+    /** Department (null clears the field) */
+    department?: string | null;
+    /** Job title (null clears the field) */
+    jobTitle?: string | null;
+    /** IANA timezone (non-null; omit the key to leave unchanged) */
     timezone?: string;
-    /** Locale */
+    /** Locale (non-null; omit the key to leave unchanged) */
     locale?: string;
-    /** Arbitrary user preferences bag */
-    preferences?: Record<string, unknown>;
+    /** Arbitrary user preferences bag (null clears the column; reads return {}) */
+    preferences?: Record<string, unknown> | null;
 }
 /**
  * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)

package/dist/server/index.d.ts

@@ -851,24 +851,42 @@ interface FFIDProfileCallOptions {
  *
  * Mirrors the FFID backend `UpdateUserProfileRequest` shape. All fields are
  * optional — only the supplied keys will be updated (partial update semantics).
+ *
+ * Per-field value semantics:
+ * - `undefined` / key omitted → field is untouched (partial update)
+ * - `null` → clears the field (stores SQL NULL in the DB)
+ * - `""` (empty string) → stored as a literal empty string, **not** treated as
+ *   a clear. Use `null` when you want the DB value to become NULL
+ *
+ * `timezone` and `locale` are intentionally modeled as non-null in this
+ * request type (application-level invariant — the DB columns have DEFAULT
+ * values but no NOT NULL constraint, yet the server-side normalization
+ * pipeline assumes a string is always present). Pass a string to update the
+ * value, or omit the key to leave the current value in place. Do not pass
+ * `null` to clear — there is no meaningful "no timezone" state for a user.
+ *
+ * `preferences: null` is accepted and clears the column. Subsequent reads
+ * return `{}` because the FFID backend normalizes a null `preferences` column
+ * to an empty object (`toUserProfile` helper) before serializing the response —
+ * the SDK itself does not transform the payload.
  */
 interface FFIDUpdateUserProfileRequest {
-    /** Display name */
-    displayName?: string;
-    /** Phone number */
-    phone?: string;
-    /** Company name */
-    companyName?: string;
-    /** Department */
-    department?: string;
-    /** Job title */
-    jobTitle?: string;
-    /** IANA timezone */
+    /** Display name (null clears the field) */
+    displayName?: string | null;
+    /** Phone number (null clears the field) */
+    phone?: string | null;
+    /** Company name (null clears the field) */
+    companyName?: string | null;
+    /** Department (null clears the field) */
+    department?: string | null;
+    /** Job title (null clears the field) */
+    jobTitle?: string | null;
+    /** IANA timezone (non-null; omit the key to leave unchanged) */
     timezone?: string;
-    /** Locale */
+    /** Locale (non-null; omit the key to leave unchanged) */
     locale?: string;
-    /** Arbitrary user preferences bag */
-    preferences?: Record<string, unknown>;
+    /** Arbitrary user preferences bag (null clears the column; reads return {}) */
+    preferences?: Record<string, unknown> | null;
 }
 /**
  * Result of a redirect operation (redirectToLogin / redirectToAuthorize / redirectToLogout)

package/dist/server/index.js

@@ -805,7 +805,7 @@ function createProfileMethods(deps) {
 }
 
 // src/client/version-check.ts
-var SDK_VERSION = "2.15.0";
+var SDK_VERSION = "2.16.0";
 var SDK_USER_AGENT = `FFID-SDK/${SDK_VERSION} (TypeScript)`;
 var SDK_VERSION_HEADER = "X-FFID-SDK-Version";
 function sdkHeaders() {

package/package.json

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