@elevasis/ui 2.65.0 → 2.67.0

package/dist/organization/index.d.ts

@@ -63,6 +63,20 @@ interface OrganizationMembership {
 type MembershipProvisioningState = 'linked' | 'pre_provisioned' | 'workos_only';
 /**
  * Extended membership with user and organization details for UI
+ *
+ * **ID convention (step 17 of the auth/invitations architecture refactor):**
+ * `id`, `userId`, and `organizationId` are the canonical Supabase UUIDs
+ * (`org_memberships.id` / `users.id` / `organizations.id`) on every producer
+ * of this type. `workosMembershipId` / `workosUserId` /
+ * `organization.workos_org_id` carry the WorkOS-side forms explicitly instead
+ * -- the contract does not overload the canonical fields with either form.
+ *
+ * The one exception: a `workos_only` row (a WorkOS membership with no
+ * `org_memberships` row -- a sync gap) has no canonical membership UUID to
+ * report, because no such row exists. `id` stays the WorkOS `om_...` form for
+ * that `provisioningState` alone; `userId` / `organizationId` are still
+ * resolved to their Supabase forms where the user/organization themselves
+ * exist.
  */
 interface MembershipWithDetails extends OrganizationMembership {
     /**
@@ -70,6 +84,18 @@ interface MembershipWithDetails extends OrganizationMembership {
      * treat `undefined` as "not reported by this endpoint".
      */
     provisioningState?: MembershipProvisioningState;
+    /**
+     * WorkOS `om_...` form of `id`. `null` when the membership is
+     * pre-provisioned (invited, signup not completed -- no WorkOS record yet).
+     * Explicit companion to the canonical `id`; see the type-level doc comment.
+     */
+    workosMembershipId?: string | null;
+    /**
+     * WorkOS `user_...` form of `userId`. `null` when the member has not
+     * completed WorkOS signup yet. Explicit companion to the canonical
+     * `userId`; see the type-level doc comment.
+     */
+    workosUserId?: string | null;
     user?: {
         id: string;
         email: string;
@@ -162,15 +188,34 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ currentOrganization, memberships, isLoading, onSwitch }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element;
 
+interface OrganizationSwitcherConnectedProps {
+    /**
+     * Extra loading condition, OR'd with this component's own internal
+     * loading state (org context initializing/refreshing). Use this instead of
+     * forking the component when a consuming app tracks an additional
+     * org-readiness signal (e.g. an app-specific initialization hook).
+     */
+    isLoading?: boolean;
+    /**
+     * Called after `switchToOrganization` (WorkOS JWT refresh) and
+     * `switchOrganization` (provider state sync) have both resolved
+     * successfully. Use this for app-specific post-switch side effects (e.g.
+     * resetting route-local search params) instead of forking this component.
+     */
+    onSwitched?: (workosOrgId: string) => void;
+}
 /**
  * Self-wired OrganizationSwitcher that internally handles both the WorkOS JWT update
  * (via AuthKit switchToOrganization) and the provider state update (via switchOrganization).
  *
- * Drop-in replacement for a custom onSwitch handler in most apps. If the app needs
- * post-switch side effects (e.g. navigating away from an org-scoped route), keep that
- * logic app-local and call useOrganization().switchOrganization directly.
+ * Drop-in replacement for a custom onSwitch handler in most apps. If an app needs
+ * post-switch side effects (e.g. navigating away from an org-scoped route), pass
+ * `onSwitched` rather than reimplementing this component -- a prior fork
+ * (Command Center's `AppOrgSwitcher`) existed solely to add one such side effect
+ * and silently dropped this component's own extra-loading-state handling in the
+ * process.
  */
-declare function OrganizationSwitcherConnected(): react_jsx_runtime.JSX.Element;
+declare function OrganizationSwitcherConnected({ isLoading: extraLoading, onSwitched }?: OrganizationSwitcherConnectedProps): react_jsx_runtime.JSX.Element;
 
 interface OrganizationsState {
     currentWorkOSOrganizationId: WorkOsOrgId | null;

package/dist/organization/index.js

@@ -1,15 +1,15 @@
-export { OrganizationProvider, OrganizationSwitcher, OrganizationSwitcherConnected, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from '../chunk-3WVZRN37.js';
+export { OrganizationProvider, OrganizationSwitcher, OrganizationSwitcherConnected, createOrganizationsSlice, createUseOrgInitialization, createUseOrganizations } from '../chunk-5TERYXOO.js';
 import '../chunk-4OEVLV66.js';
 import '../chunk-RBGVNPA6.js';
-import '../chunk-ZTWA5H77.js';
+import '../chunk-6ZAP3FOA.js';
 import '../chunk-AUDNF2Q7.js';
 import '../chunk-6M6OLGQY.js';
 import '../chunk-MKH2KOAO.js';
 import '../chunk-XNW3O6QW.js';
-import '../chunk-T4LA4RY2.js';
+import '../chunk-L7BZZ4SI.js';
 import '../chunk-GMXGDO3I.js';
 import '../chunk-62GVNH5U.js';
-import '../chunk-LO7GWG24.js';
+import '../chunk-P45GQ3ZW.js';
 export { OrganizationContext, useOrganization } from '../chunk-DD3CCMCZ.js';
 import '../chunk-M7WWRZ5Z.js';
 import '../chunk-JFBZ6XDW.js';
@@ -18,7 +18,7 @@ import '../chunk-Q7DJKLEN.js';
 import '../chunk-HENXLGVD.js';
 import '../chunk-BLXJEIQS.js';
 import '../chunk-RNP5R5I3.js';
-import '../chunk-EIXSQONC.js';
+import '../chunk-RT4KRGZT.js';
 import '../chunk-I7BZVVVU.js';
 import '../chunk-Y6I3IC45.js';
 import '../chunk-6SSQGWK7.js';

package/dist/profile/index.d.ts

@@ -1,5 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
+import { QueryKey } from '@tanstack/react-query';
 
 type Json = string | number | boolean | null | {
     [key: string]: Json | undefined;
@@ -3323,15 +3324,35 @@ interface UseUserProfileReturn {
     error: Error | null;
     refetch: () => Promise<void>;
 }
+/**
+ * Canonical TanStack Query key for the current user's profile.
+ *
+ * Every consumer (ProfileProvider, Command Center's root layout, the
+ * onboarding gate, the welcome flow, account settings, ...) reads and writes
+ * this exact key, so they share one cache entry instead of each issuing an
+ * independent `/users/me/sync` call. Not user-scoped: a full sign-out /
+ * sign-in cycle in this app navigates through WorkOS (a real page load),
+ * which tears down the QueryClient, so no explicit user id is needed to
+ * avoid stale cross-user reads within a single session.
+ */
+declare const USER_PROFILE_QUERY_KEY: QueryKey;
 /**
  * Hook for managing user profile data with automatic WorkOS -> Supabase sync
  *
- * This hook:
+ * Backed by a single shared TanStack Query cache entry keyed on
+ * {@link USER_PROFILE_QUERY_KEY}. This hook:
  * 1. Automatically syncs WorkOS user data to Supabase on authentication
  * 2. Provides access to the user's Supabase profile data
  * 3. Handles loading states and errors
  * 4. Includes a refetch function for manual updates
  *
+ * Because every consumer queries the same key, calling this hook from
+ * multiple places in the tree (directly or via `useProfile()`) triggers at
+ * most one `/users/me/sync` request per session — later mounts simply read
+ * the cached result. Call `refetch()` (or invalidate {@link USER_PROFILE_QUERY_KEY}
+ * via `useQueryClient()`) to force a fresh sync after a mutation that changes
+ * the profile, e.g. completing onboarding.
+ *
  * @param options - Optional configuration including error handler and apiRequest
  */
 declare const useUserProfile: (options?: UseUserProfileOptions) => UseUserProfileReturn;
@@ -3364,5 +3385,5 @@ declare class UserProfileService {
     }>): Promise<SupabaseUserProfile | null>;
 }
 
-export { ProfileProvider, UserProfileService, useProfile, useUserProfile };
+export { ProfileProvider, USER_PROFILE_QUERY_KEY, UserProfileService, useProfile, useUserProfile };
 export type { ProfileContextValue, SupabaseUserProfile, UseUserProfileReturn };

package/dist/profile/index.js

@@ -1,5 +1,5 @@
 import '../chunk-RNP5R5I3.js';
-export { ProfileProvider, UserProfileService, useProfile, useUserProfile } from '../chunk-EIXSQONC.js';
+export { ProfileProvider, USER_PROFILE_QUERY_KEY, UserProfileService, useProfile, useUserProfile } from '../chunk-RT4KRGZT.js';
 import '../chunk-BI5VDO2K.js';
 import '../chunk-MQZE7SUI.js';
 import '../chunk-TVTSASST.js';

package/dist/provider/index.js

@@ -1,15 +1,15 @@
-export { AppearanceProvider, CrmActionsProvider, ElevasisCoreProvider, ElevasisSystemsProvider, ElevasisUIProvider, ListActionsProvider, NotificationProvider, SystemShell, createTestSystemsProvider, useAppearance, useCrmActions, useElevasisSystems, useListActions, useNotificationAdapter, useOptionalElevasisSystems, useResolvedOrganizationModel } from '../chunk-3WVZRN37.js';
+export { AppearanceProvider, CrmActionsProvider, ElevasisCoreProvider, ElevasisSystemsProvider, ElevasisUIProvider, ListActionsProvider, NotificationProvider, SystemShell, createTestSystemsProvider, useAppearance, useCrmActions, useElevasisSystems, useListActions, useNotificationAdapter, useOptionalElevasisSystems, useResolvedOrganizationModel } from '../chunk-5TERYXOO.js';
 import '../chunk-4OEVLV66.js';
 import '../chunk-RBGVNPA6.js';
-import '../chunk-ZTWA5H77.js';
+import '../chunk-6ZAP3FOA.js';
 import '../chunk-AUDNF2Q7.js';
 import '../chunk-6M6OLGQY.js';
 import '../chunk-MKH2KOAO.js';
 import '../chunk-XNW3O6QW.js';
-import '../chunk-T4LA4RY2.js';
+import '../chunk-L7BZZ4SI.js';
 import '../chunk-GMXGDO3I.js';
 import '../chunk-62GVNH5U.js';
-import '../chunk-LO7GWG24.js';
+import '../chunk-P45GQ3ZW.js';
 import '../chunk-DD3CCMCZ.js';
 import '../chunk-M7WWRZ5Z.js';
 import '../chunk-JFBZ6XDW.js';
@@ -18,7 +18,7 @@ import '../chunk-Q7DJKLEN.js';
 import '../chunk-HENXLGVD.js';
 import '../chunk-BLXJEIQS.js';
 import '../chunk-RNP5R5I3.js';
-import '../chunk-EIXSQONC.js';
+import '../chunk-RT4KRGZT.js';
 import '../chunk-I7BZVVVU.js';
 import '../chunk-Y6I3IC45.js';
 import '../chunk-6SSQGWK7.js';

package/dist/provider/published.js

@@ -1,15 +1,15 @@
-export { AppearanceProvider, ElevasisCoreProvider, ElevasisSystemsProvider, NotificationProvider, SystemShell, useAppearance, useElevasisSystems, useNotificationAdapter, useOptionalElevasisSystems } from '../chunk-3WVZRN37.js';
+export { AppearanceProvider, ElevasisCoreProvider, ElevasisSystemsProvider, NotificationProvider, SystemShell, useAppearance, useElevasisSystems, useNotificationAdapter, useOptionalElevasisSystems } from '../chunk-5TERYXOO.js';
 import '../chunk-4OEVLV66.js';
 import '../chunk-RBGVNPA6.js';
-import '../chunk-ZTWA5H77.js';
+import '../chunk-6ZAP3FOA.js';
 import '../chunk-AUDNF2Q7.js';
 import '../chunk-6M6OLGQY.js';
 import '../chunk-MKH2KOAO.js';
 import '../chunk-XNW3O6QW.js';
-import '../chunk-T4LA4RY2.js';
+import '../chunk-L7BZZ4SI.js';
 import '../chunk-GMXGDO3I.js';
 import '../chunk-62GVNH5U.js';
-import '../chunk-LO7GWG24.js';
+import '../chunk-P45GQ3ZW.js';
 import '../chunk-DD3CCMCZ.js';
 import '../chunk-M7WWRZ5Z.js';
 import '../chunk-JFBZ6XDW.js';
@@ -18,7 +18,7 @@ import '../chunk-Q7DJKLEN.js';
 import '../chunk-HENXLGVD.js';
 import '../chunk-BLXJEIQS.js';
 import '../chunk-RNP5R5I3.js';
-import '../chunk-EIXSQONC.js';
+import '../chunk-RT4KRGZT.js';
 import '../chunk-I7BZVVVU.js';
 import '../chunk-Y6I3IC45.js';
 import '../chunk-6SSQGWK7.js';