@elevasis/ui 1.2.1 → 1.3.0

package/dist/provider/published.d.ts

@@ -10,6 +10,53 @@ interface ApiErrorDetails {
     requestId?: string;
 }
 
+/**
+ * Pluggable notification adapter interface.
+ *
+ * Implement this to connect any notification library (Mantine, react-toastify, etc.)
+ * to the Elevasis UI hooks.
+ */
+interface NotificationAdapter {
+    success(title: string, message: string): void;
+    error(title: string, message: string): void;
+    info(title: string, message: string): void;
+    warning(title: string, message: string): void;
+    /** Formats and displays an API error using structured error-utils helpers. */
+    apiError(error: unknown): void;
+}
+/**
+ * Provides a notification adapter to all descendant components.
+ *
+ * Pass a `MantineNotificationAdapter` for Command Center, or any custom
+ * adapter for other consumers (template, tests, etc.).
+ *
+ * When omitted, hooks fall back to the console adapter automatically.
+ *
+ * @example
+ * ```tsx
+ * import { NotificationProvider } from '@repo/ui/provider'
+ * import { mantineNotificationAdapter } from '@repo/ui/provider'
+ *
+ * <NotificationProvider adapter={mantineNotificationAdapter}>
+ *   <App />
+ * </NotificationProvider>
+ * ```
+ */
+declare function NotificationProvider({ adapter, children }: {
+    adapter: NotificationAdapter;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Returns the active notification adapter.
+ *
+ * Falls back to the console adapter when used outside a NotificationProvider,
+ * so hooks remain functional in template environments without Mantine.
+ *
+ * Named `useNotificationAdapter` to avoid collision with the data-fetching
+ * `useNotifications` hook exported from `hooks/monitoring`.
+ */
+declare function useNotificationAdapter(): NotificationAdapter;
+
 /** Flat + per-scheme override pattern. Flat values apply to both; `light`/`dark` win over flat. */
 type WithSchemes<T> = T & {
     light?: T;
@@ -99,16 +146,18 @@ interface ElevasisCoreProviderProps {
      */
     theme?: ElevasisCoreThemeConfig;
     /**
-     * Override organization ID resolution.
-     * Command-center passes Zustand-managed org ID here.
-     * SDK consumers typically omit this (auto-resolved from JWT/API key).
+     * @deprecated Organization ID is now resolved automatically via OrganizationProvider.
+     * This prop is accepted for backwards compatibility during migration but is no longer
+     * used when the full provider stack is active (apiUrl provided).
      */
     organizationId?: string | null;
     /** Custom QueryClient. If omitted, a default is created internally. */
     queryClient?: QueryClient;
     /**
      * API base URL (e.g., 'https://api.elevasis.com' or 'http://localhost:5170').
-     * When provided, ElevasisCoreProvider composes ApiClientProvider + ElevasisServiceProvider internally.
+     * When provided, ElevasisCoreProvider composes the full provider stack:
+     * ApiClientProvider + ElevasisServiceProvider + ProfileProvider +
+     * OrganizationProvider + NotificationProvider + InitializationProvider.
      * When omitted, no service context is provided (theme-only mode).
      */
     apiUrl?: string;
@@ -118,11 +167,19 @@ interface ElevasisCoreProviderProps {
      */
     onError?: (endpoint: string, error: Error, details?: ApiErrorDetails) => void;
     /**
-     * Override organization readiness check.
-     * Defaults to `!!organizationId` if not provided.
-     * Command-center passes `!!currentMembership` for its stricter readiness requirement.
+     * @deprecated Organization readiness is now managed internally by OrganizationProvider.
+     * Accepted for backwards compatibility but ignored when apiUrl is provided.
      */
     isOrganizationReady?: boolean;
+    /**
+     * Notification adapter for displaying success/error/info messages.
+     * When provided, wraps the subtree in a NotificationProvider with this adapter.
+     * When omitted, the console fallback adapter is used automatically.
+     *
+     * ElevasisUIProvider (Mantine variant) passes mantineNotificationAdapter here automatically.
+     * Headless/SDK consumers can pass a custom adapter or omit for console output.
+     */
+    notifications?: NotificationAdapter;
     /**
      * Whether to inject CSS variables, `data-elevasis-scheme` attribute, and font links.
      * Set to `false` when the consumer has its own complete design system and only
@@ -157,21 +214,36 @@ interface ElevasisServiceProviderProps {
  * variables, set `data-elevasis-scheme`, or load fonts. Consumers that need
  * Elevasis theming should use `ElevasisProvider` (Mantine) instead.
  *
- * Composes: QueryClientProvider + auth provider + auth bridge.
- * When apiUrl is provided, also composes ApiClientProvider + ElevasisServiceProvider.
+ * When `apiUrl` is provided, composes the full provider stack:
+ *   QueryClientProvider -> AuthProvider -> ApiClientProvider ->
+ *   ElevasisServiceProvider -> ProfileProvider -> OrganizationProvider ->
+ *   NotificationProvider -> InitializationProvider
+ *
+ * The `notifications` prop wires a custom adapter (e.g. mantineNotificationAdapter)
+ * into the NotificationProvider. When omitted, the console fallback is used.
  *
  * @example Headless SDK consumer
  * ```tsx
  * <ElevasisCoreProvider
  *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/' }}
- *   theme={{ colorScheme: 'dark', preset: 'default' }}
  *   apiUrl="https://api.elevasis.com"
  * >
  *   <Dashboard />
  * </ElevasisCoreProvider>
  * ```
+ *
+ * @example With custom notification adapter
+ * ```tsx
+ * <ElevasisCoreProvider
+ *   auth={{ mode: 'authkit', clientId: '...', redirectUri: '/' }}
+ *   apiUrl="https://api.elevasis.com"
+ *   notifications={myNotificationAdapter}
+ * >
+ *   <Dashboard />
+ * </ElevasisCoreProvider>
+ * ```
  */
-declare function ElevasisCoreProvider({ auth, organizationId, queryClient, apiUrl, onError, isOrganizationReady, children }: ElevasisCoreProviderProps): react_jsx_runtime.JSX.Element;
+declare function ElevasisCoreProvider({ auth, queryClient, apiUrl, onError, notifications, children }: ElevasisCoreProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Hook to access the ElevasisServiceProvider context.
@@ -202,5 +274,5 @@ declare function useElevasisServices(): ElevasisServiceContextValue;
  */
 declare function ElevasisServiceProvider({ apiRequest, organizationId, isReady, children }: ElevasisServiceProviderProps): react_jsx_runtime.JSX.Element;
 
-export { ElevasisCoreProvider, ElevasisServiceProvider, useElevasisServices };
-export type { ApiKeyConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisTokenOverrides, OAuthConfig, WithSchemes };
+export { ElevasisCoreProvider, ElevasisServiceProvider, NotificationProvider, useElevasisServices, useNotificationAdapter };
+export type { ApiKeyConfig, AuthConfig, AuthKitConfig, ElevasisCoreProviderProps, ElevasisCoreThemeConfig, ElevasisServiceContextValue, ElevasisServiceProviderProps, ElevasisTokenOverrides, NotificationAdapter, OAuthConfig, WithSchemes };

package/dist/provider/published.js

@@ -1,6 +1,12 @@
-export { ElevasisCoreProvider } from '../chunk-ZQVPUAGR.js';
-import '../chunk-GDV44UWF.js';
-export { ElevasisServiceProvider, useElevasisServices } from '../chunk-KA7LO7U5.js';
-import '../chunk-7AI5ZYJ4.js';
+export { ElevasisCoreProvider } from '../chunk-OLD3NQLI.js';
+import '../chunk-FLJXZ7YC.js';
+import '../chunk-BWCC6ZJC.js';
+export { NotificationProvider, useNotificationAdapter } from '../chunk-TIRMFDM4.js';
+import '../chunk-JVAZHVNV.js';
+import '../chunk-4VGWQ5AN.js';
 import '../chunk-QSVZP2NU.js';
+import '../chunk-QQOLC46E.js';
+import '../chunk-DD3CCMCZ.js';
+import '../chunk-4KAG5U7A.js';
+export { ElevasisServiceProvider, useElevasisServices } from '../chunk-KA7LO7U5.js';
 import '../chunk-7PLEQFHO.js';

package/dist/utils/index.js

@@ -1 +1,2 @@
-export { APIClientError, formatDate, formatErrorMessage, getErrorInfo, getErrorTitle, getResourceColor, getResourceIcon, isAPIClientError, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, validateEmail } from '../chunk-7AI5ZYJ4.js';
+export { formatDate, getResourceColor, getResourceIcon, showApiErrorNotification, showErrorNotification, showInfoNotification, showSuccessNotification, showWarningNotification, validateEmail } from '../chunk-JVAZHVNV.js';
+export { APIClientError, formatErrorMessage, getErrorInfo, getErrorTitle, isAPIClientError } from '../chunk-4VGWQ5AN.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elevasis/ui",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "UI components and platform-aware hooks for building custom frontends on the Elevasis platform",
   "type": "module",
   "license": "MIT",
@@ -26,6 +26,18 @@
     "./sse": {
       "types": "./dist/sse/index.d.ts",
       "import": "./dist/sse/index.js"
+    },
+    "./initialization": {
+      "types": "./dist/initialization/index.d.ts",
+      "import": "./dist/initialization/index.js"
+    },
+    "./profile": {
+      "types": "./dist/profile/index.d.ts",
+      "import": "./dist/profile/index.js"
+    },
+    "./organization": {
+      "types": "./dist/organization/index.d.ts",
+      "import": "./dist/organization/index.js"
     }
   },
   "publishConfig": {
@@ -33,7 +45,8 @@
     "peerDependencies": {
       "react": "^19.2.0",
       "react-dom": "^19.2.0",
-      "@tanstack/react-query": "^5.76.2"
+      "@tanstack/react-query": "^5.76.2",
+      "@tanstack/react-router": "^1.131.28"
     }
   },
   "peerDependencies": {
@@ -67,8 +80,8 @@
     "typescript": "5.9.2",
     "vite": "^7.0.0",
     "@repo/core": "0.0.0",
-    "@repo/eslint-config": "0.0.0",
-    "@repo/typescript-config": "0.0.0"
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
   },
   "dependencies": {
     "@dagrejs/dagre": "^1.1.4",

package/dist/chunk-GDV44UWF.js

@@ -1,138 +0,0 @@
-import { APIClientError } from './chunk-7AI5ZYJ4.js';
-import { createContext, useContext, useMemo, useCallback } from 'react';
-import { jsx } from 'react/jsx-runtime';
-
-var ApiClientContext = createContext(null);
-function useApiClientContext() {
-  const context = useContext(ApiClientContext);
-  if (!context) {
-    throw new Error("useApiClient must be used within ApiClientProvider");
-  }
-  return context;
-}
-function ApiClientProvider({
-  children,
-  getAccessToken,
-  organizationId,
-  isOrganizationReady,
-  onError
-}) {
-  const value = useMemo(
-    () => ({
-      getAccessToken,
-      organizationId,
-      isOrganizationReady,
-      onError
-    }),
-    [getAccessToken, organizationId, isOrganizationReady, onError]
-  );
-  return /* @__PURE__ */ jsx(ApiClientContext.Provider, { value, children });
-}
-
-// ../core/src/platform/constants/http.ts
-var HTTP_HEADERS = {
-  /**
-   * Organization context header
-   * Note: Node.js normalizes all headers to lowercase, so we use lowercase consistently
-   */
-  WORKOS_ORGANIZATION_ID: "workos-organization-id",
-  AGENT_ORGANIZATION: "x-agent-organization",
-  AGENT_MODE: "x-agent-mode"
-};
-
-// src/api/hooks/useApiClient.ts
-var DEFAULT_TIMEOUT_MS = 6e4;
-function createUseApiClient(useOrganizations, apiUrl) {
-  return function useApiClient() {
-    const { getAccessToken, organizationId, isOrganizationReady, onError } = useApiClientContext();
-    const { isInitializing, isOrgRefreshing } = useOrganizations();
-    const handleResponseError = useCallback(
-      async (endpoint, response, options) => {
-        const errorData = await response.json().catch(() => ({
-          error: `HTTP ${response.status}`,
-          code: "INTERNAL_SERVER_ERROR"
-        }));
-        if (response.status >= 500 && onError) {
-          onError(endpoint, new Error(errorData.error), {
-            method: options.method || "GET",
-            statusCode: response.status,
-            requestId: errorData.requestId
-          });
-        }
-        throw new APIClientError(errorData.error, errorData.code, response.status, errorData.requestId, errorData.fields, errorData.retryAfter);
-      },
-      [onError]
-    );
-    const apiRequest = useCallback(
-      async (endpoint, options = {}) => {
-        try {
-          const token = await getAccessToken();
-          const headers = {
-            ...options.body ? { "Content-Type": "application/json" } : {},
-            ...token ? { Authorization: `Bearer ${token}` } : {},
-            ...organizationId && { [HTTP_HEADERS.WORKOS_ORGANIZATION_ID]: organizationId },
-            ...options.headers
-          };
-          const timeoutSignal = AbortSignal.timeout(DEFAULT_TIMEOUT_MS);
-          const signal = options.signal ? AbortSignal.any([options.signal, timeoutSignal]) : timeoutSignal;
-          const response = await fetch(`${apiUrl}/api${endpoint}`, {
-            ...options,
-            headers,
-            signal
-          });
-          if (!response.ok) {
-            await handleResponseError(endpoint, response, options);
-          }
-          if (response.status === 204) {
-            return void 0;
-          }
-          const responseData = await response.json();
-          return responseData;
-        } catch (error) {
-          if (error instanceof Error && error.message.includes("No access token")) {
-            const headers = {
-              ...options.body ? { "Content-Type": "application/json" } : {},
-              ...options.headers
-            };
-            const fallbackTimeoutSignal = AbortSignal.timeout(DEFAULT_TIMEOUT_MS);
-            const fallbackSignal = options.signal ? AbortSignal.any([options.signal, fallbackTimeoutSignal]) : fallbackTimeoutSignal;
-            const response = await fetch(`${apiUrl}/api${endpoint}`, {
-              ...options,
-              headers,
-              signal: fallbackSignal
-            });
-            if (!response.ok) {
-              await handleResponseError(endpoint, response, options);
-            }
-            if (response.status === 204) {
-              return void 0;
-            }
-            return response.json();
-          }
-          throw error;
-        }
-      },
-      [getAccessToken, organizationId, handleResponseError, apiUrl]
-    );
-    const deferredApiRequest = useCallback(
-      async (endpoint, options = {}) => {
-        if (isInitializing || isOrgRefreshing) {
-          throw new Error("Organization context is still initializing. Please wait.");
-        }
-        if (!isOrganizationReady) {
-          throw new Error("No organization selected. Please select an organization.");
-        }
-        return apiRequest(endpoint, options);
-      },
-      [apiRequest, isInitializing, isOrgRefreshing, isOrganizationReady]
-    );
-    return {
-      apiRequest,
-      deferredApiRequest,
-      isOrganizationReady,
-      isInitializing: isInitializing || isOrgRefreshing
-    };
-  };
-}
-
-export { ApiClientProvider, createUseApiClient, useApiClientContext };

package/dist/chunk-HBRMWW6V.js

@@ -1,43 +0,0 @@
-import { useAuthContext } from './chunk-7PLEQFHO.js';
-import { useRef, useCallback, useEffect } from 'react';
-import { useQueryClient } from '@tanstack/react-query';
-
-function useStableAccessToken() {
-  const { getAccessToken } = useAuthContext();
-  const getAccessTokenRef = useRef(getAccessToken);
-  getAccessTokenRef.current = getAccessToken;
-  return useCallback(() => {
-    return getAccessTokenRef.current();
-  }, []);
-}
-function useSessionCheck() {
-  const { user } = useAuthContext();
-  const queryClient = useQueryClient();
-  const isCheckingRef = useRef(false);
-  useEffect(() => {
-    const handleVisibilityChange = async () => {
-      if (isCheckingRef.current || document.visibilityState !== "visible") {
-        return;
-      }
-      isCheckingRef.current = true;
-      try {
-        if (!user) {
-          window.location.replace("/login");
-          return;
-        }
-        await queryClient.cancelQueries();
-        queryClient.invalidateQueries();
-      } finally {
-        isCheckingRef.current = false;
-      }
-    };
-    document.addEventListener("visibilitychange", handleVisibilityChange);
-    window.addEventListener("focus", handleVisibilityChange);
-    return () => {
-      document.removeEventListener("visibilitychange", handleVisibilityChange);
-      window.removeEventListener("focus", handleVisibilityChange);
-    };
-  }, [user, queryClient]);
-}
-
-export { useSessionCheck, useStableAccessToken };