@buildbase/sdk 0.0.12 → 0.0.13

package/dist/types/components/dropdowns/country/selectCountry.d.ts

@@ -1,6 +1,6 @@
-interface ITimeZone {
+interface SelectCountryProps {
     value?: string;
     onChange?: (value: string) => void;
 }
-export declare function SelectCountry(props: ITimeZone): import("react/jsx-runtime").JSX.Element;
+export declare function SelectCountry({ value, onChange }: SelectCountryProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/dropdowns/currency/selectCurrency.d.ts

@@ -1,6 +1,6 @@
-interface ITimeZone {
+interface SelectCurrencyProps {
     value?: string;
     onChange?: (value: string) => void;
 }
-export declare function SelectCurrency(props: ITimeZone): import("react/jsx-runtime").JSX.Element;
+export declare function SelectCurrency({ value, onChange }: SelectCurrencyProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/dropdowns/language/selectLanguage.d.ts

@@ -1,6 +1,6 @@
-interface ITimeZone {
+interface SelectLanguageProps {
     value?: string;
     onChange?: (value: string) => void;
 }
-export declare function SelectLanguage(props: ITimeZone): import("react/jsx-runtime").JSX.Element;
+export declare function SelectLanguage({ value, onChange }: SelectLanguageProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/dropdowns/timezone/selectTimeZone.d.ts

@@ -1,6 +1,6 @@
-interface ITimeZone {
+interface SelectTimeZoneProps {
     value?: string;
     onChange?: (value: string) => void;
 }
-export declare function SelectTimeZone(props: ITimeZone): import("react/jsx-runtime").JSX.Element;
+export declare function SelectTimeZone({ value, onChange }: SelectTimeZoneProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/ui/command-select.d.ts

@@ -0,0 +1,13 @@
+export interface CommandSelectOption {
+    value: string;
+    label: string;
+    icon?: string;
+}
+export interface CommandSelectProps {
+    options: CommandSelectOption[];
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    emptyLabel?: string;
+}
+export declare function CommandSelect({ options, value: valueProp, onChange, placeholder, emptyLabel, }: CommandSelectProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/ui/command.d.ts

@@ -24,7 +24,7 @@ declare const CommandInput: React.ForwardRefExoticComponent<Omit<Omit<Pick<Pick<
     ref?: React.Ref<HTMLInputElement>;
 } & {
     asChild?: boolean;
-}, "key" | "asChild" | keyof React.InputHTMLAttributes<HTMLInputElement>>, "value" | "onChange" | "type"> & {
+}, "key" | "asChild" | keyof React.InputHTMLAttributes<HTMLInputElement>>, "value" | "type" | "onChange"> & {
     value?: string;
     onValueChange?: (search: string) => void;
 } & React.RefAttributes<HTMLInputElement>, "ref"> & React.RefAttributes<HTMLInputElement>>;
@@ -68,7 +68,7 @@ declare const CommandItem: React.ForwardRefExoticComponent<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>>, "value" | "onSelect" | "disabled"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>>, "value" | "disabled" | "onSelect"> & {
     disabled?: boolean;
     onSelect?: (value: string) => void;
     value?: string;

package/dist/types/contexts/WorkspaceContext/actions.d.ts

@@ -12,5 +12,5 @@ export declare const workspaceActions: {
     setLoading: (loading: boolean) => WorkspaceAction;
     setError: (error: string | null) => WorkspaceAction;
     setRefreshing: (refreshing: boolean) => WorkspaceAction;
-    setSwitching: (switching: boolean) => WorkspaceAction;
+    setSwitchingToId: (workspaceId: string | null) => WorkspaceAction;
 };

package/dist/types/contexts/WorkspaceContext/types.d.ts

@@ -24,8 +24,8 @@ export type WorkspaceAction = {
     type: 'SET_REFRESHING';
     payload: boolean;
 } | {
-    type: 'SET_SWITCHING';
-    payload: boolean;
+    type: 'SET_SWITCHING_TO_ID';
+    payload: string | null;
 };
 export interface WorkspaceState {
     workspaces: IWorkspace[];
@@ -33,7 +33,7 @@ export interface WorkspaceState {
     error: string | null;
     currentWorkspace: IWorkspace | null;
     refreshing: boolean;
-    switching: boolean;
+    switchingToId: string | null;
     isInitialized: boolean;
     allFeatures: IWorkspaceFeature[];
 }

package/dist/types/contexts/shared/useSelectWithEquality.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared selector hook with equality-based memoization.
+ * Only re-renders when the selected value changes (according to equalityFn).
+ *
+ * @param state - The state to select from
+ * @param selector - Function that selects a value from state
+ * @param equalityFn - Optional equality function (default: Object.is)
+ * @returns The selected value
+ */
+export declare function useSelectWithEquality<TState, TSelected>(state: TState, selector: (state: TState) => TSelected, equalityFn?: (a: TSelected, b: TSelected) => boolean): TSelected;

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export { WhenAuthenticated, WhenUnauthenticated } from './components/user/auth';
 export { WhenRoles, WhenWorkspaceRoles } from './components/user/role';
 export { WhenUserFeatureDisabled, WhenUserFeatureEnabled, WhenWorkspaceFeatureDisabled, WhenWorkspaceFeatureEnabled, } from './components/features';
 export { AuthStatus } from './providers/auth/types';
+export type { OnWorkspaceChangeParams } from './providers/auth/types';
 export { useSaaSAuth } from './providers/auth/hooks';
 export { useSaaSSettings } from './providers/os/hooks';
 export { useUserAttributes, useUserFeatures } from './providers/user/hooks';
@@ -14,7 +15,4 @@ export { WorkspaceSwitcher } from './providers/workspace/provider';
 export { useCreateCheckoutSession, useInvoice, useInvoices, usePlanGroup, usePlanGroupVersions, useSubscription, useSubscriptionManagement, useUpdateSubscription, } from './providers/workspace/subscription-hooks';
 export { eventEmitter } from './providers/events';
 export type { EventData, EventType, IEventCallbacks, UserCreatedEventData, UserUpdatedEventData, WorkspaceChangedEventData, WorkspaceCreatedEventData, WorkspaceDeletedEventData, WorkspaceUpdatedEventData, WorkspaceUserAddedEventData, WorkspaceUserRemovedEventData, WorkspaceUserRoleChangedEventData, } from './providers/events/types';
-export { default as ErrorBoundary, SDKErrorBoundary } from './components/ErrorBoundary';
-export { SDKError, createSDKError, errorHandler, handleError } from './lib/error-handler';
-export type { ErrorHandlerConfig, SDKErrorContext } from './lib/error-handler';
 export type { BillingInterval, IBasePricing, ICheckoutSessionRequest, ICheckoutSessionResponse, IInvoice, IInvoiceListResponse, IInvoiceResponse, InvoiceStatus, IPlan, IPlanGroup, IPlanGroupLatestVersion, IPlanGroupResponse, IPlanGroupVersion, IPlanGroupVersionsResponse, IPlanGroupVersionWithPlans, IPlanVersion, IPlanVersionWithPlan, IQuotaValue, ISubscription, ISubscriptionItem, ISubscriptionResponse, ISubscriptionUpdateRequest, ISubscriptionUpdateResponse, } from './api/types';

package/dist/types/lib/api-utils.d.ts

@@ -71,6 +71,24 @@ export declare function isAbortError(error: unknown): boolean;
  * ```
  */
 export declare function safeFetch(url: string, options?: RequestInit): Promise<Response>;
+/**
+ * Extract error message from a failed response.
+ * Parses JSON body and returns message/error field, or defaultMsg if not available.
+ *
+ * @param response - The Response object (typically from a failed request)
+ * @param defaultMsg - Default message if parsing fails or no message in body
+ * @returns Promise resolving to the error message string
+ *
+ * @example
+ * ```tsx
+ * const response = await safeFetch('/api/users');
+ * if (!response.ok) {
+ *   const msg = await getErrorMessage(response, 'Failed to fetch users');
+ *   throw new Error(msg);
+ * }
+ * ```
+ */
+export declare function getErrorMessage(response: Response, defaultMsg: string): Promise<string>;
 /**
  * Parse JSON response with error handling.
  * Provides better error messages if response is not valid JSON.

package/dist/types/lib/error-handler.d.ts

@@ -76,6 +76,24 @@ export declare const errorHandler: ErrorHandler;
  * ```
  */
 export declare function handleError(error: Error | unknown, context?: SDKErrorContext): void;
+/**
+ * Handle an error only if it is not an AbortError.
+ * Convenience for async code that uses AbortSignal - call this in catch and abort errors are ignored.
+ *
+ * @param error - The error that occurred
+ * @param context - Optional context about where the error occurred
+ * @returns true if error was handled, false if it was an abort error (ignored)
+ *
+ * @example
+ * ```tsx
+ * try {
+ *   await safeFetch(url, { signal });
+ * } catch (error) {
+ *   handleErrorUnlessAborted(error, { component: 'MyComponent', action: 'fetch' });
+ * }
+ * ```
+ */
+export declare function handleErrorUnlessAborted(error: Error | unknown, context?: SDKErrorContext): boolean;
 /**
  * Creates a new SDKError instance with optional code and context.
  * Useful for creating standardized errors throughout the SDK.

package/dist/types/lib/logger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Centralized logger for SDK
+ * All console output should go through this for consistency and configurable behavior
+ */
+/**
+ * Configure the SDK logger
+ */
+export declare function configureLogger(config: {
+    enableLogging?: boolean;
+}): void;
+/**
+ * Log info (dev only, respects enableLogging)
+ */
+export declare function sdkLog(message: string, ...args: unknown[]): void;
+/**
+ * Log warning (dev only, respects enableLogging)
+ */
+export declare function sdkWarn(message: string, ...args: unknown[]): void;
+/**
+ * Log error (dev only, respects enableLogging)
+ */
+export declare function sdkLogError(message: string, ...args: unknown[]): void;
+/**
+ * Log internal/critical error - always logs.
+ * Use when the error handling system itself fails (e.g. user's onError callback throws).
+ */
+export declare function sdkError(message: string, ...args: unknown[]): void;

package/dist/types/lib/useAsyncEffect.d.ts

@@ -0,0 +1,29 @@
+import type { DependencyList } from 'react';
+export interface UseAsyncEffectOptions {
+    /**
+     * Called when the effect promise rejects (except for AbortError which is ignored).
+     */
+    onError?: (err: unknown) => void;
+}
+/**
+ * Encapsulates the AbortController + async effect pattern.
+ * Provides cancellation on cleanup and optional error handling.
+ *
+ * @param effect - Async function that receives AbortSignal for cancellation
+ * @param deps - Dependency array (same as useEffect)
+ * @param options - Optional onError callback for unhandled rejections
+ *
+ * @example
+ * ```tsx
+ * useAsyncEffect(
+ *   async (signal) => {
+ *     const response = await safeFetch(url, { signal });
+ *     const data = await response.json();
+ *     setData(data);
+ *   },
+ *   [url],
+ *   { onError: (err) => handleError(err, { component: 'MyComponent', action: 'fetch' }) }
+ * );
+ * ```
+ */
+export declare function useAsyncEffect(effect: (signal: AbortSignal) => Promise<void>, deps: DependencyList, options?: UseAsyncEffectOptions): void;

package/dist/types/lib/utils.d.ts

@@ -1,2 +1,7 @@
 import { type ClassValue } from 'clsx';
+/**
+ * Check if running in development mode.
+ * Safe for browser bundles where process may be undefined.
+ */
+export declare function isDevelopment(): boolean;
 export declare function cn(...inputs: ClassValue[]): string;

package/dist/types/providers/auth/types.d.ts

@@ -1,4 +1,5 @@
 import type { EventData, EventType } from '../events/types';
+import type { IWorkspace } from '../workspace/types';
 export declare enum AuthStatus {
     loading = "loading",
     redirecting = "redirecting",
@@ -47,4 +48,15 @@ export interface IAuthCallbacks {
      * @param data - The event data (type varies based on eventType)
      */
     handleEvent?: (eventType: EventType, data: EventData) => void | Promise<void>;
+    /**
+     * Called before switching workspace (e.g. generate token, save state).
+     * Used when user clicks "Switch to" and when restoring from storage on page refresh.
+     * Switch proceeds only when this resolves; reject to abort.
+     */
+    onWorkspaceChange?: (params: OnWorkspaceChangeParams) => Promise<void>;
+}
+export interface OnWorkspaceChangeParams {
+    workspace: IWorkspace;
+    user: AuthUser | null;
+    role: string | null;
 }

package/dist/types/providers/auth/utils.d.ts

@@ -1,5 +1,10 @@
-import type { AuthSession } from './types';
-import { AuthUser } from './types';
+import { IUser } from '../../api/types';
+import type { AuthSession, AuthUser } from './types';
+/**
+ * Map IUser from API to AuthUser for session
+ * @throws Error if user data is missing required ID or email fields
+ */
+export declare function mapIUserToAuthUser(userData: IUser, orgId: string, clientId: string): AuthUser;
 /**
  * Centralized Session Management
  * Only stores sessionId in localStorage - user data is kept in context only

package/dist/types/providers/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const AUTH_TOKEN_PARAM = "code";
 export declare const AUTH_SESSION_ID_KEY = "saas-session-id";
+export declare const WORKSPACE_STORAGE_KEY = "saas-workspace-current";

package/dist/types/providers/workspace/hooks.d.ts

@@ -1,5 +1,4 @@
 import { IUser } from '../../api/types';
-import { WorkspaceSwitcher } from './provider';
 import { IWorkspace, IWorkspaceUser } from './types';
 /**
  * Main workspace management hook for the SDK.
@@ -11,11 +10,11 @@ import { IWorkspace, IWorkspaceUser } from './types';
  * - `loading`: Boolean indicating if workspaces are being fetched
  * - `error`: Error message string (null if no error)
  * - `refreshing`: Boolean indicating if workspaces are being refreshed in background
- * - `switching`: Boolean indicating if workspace is being switched
- * - `WorkspaceSwitcher`: Component for switching between workspaces
+ * - `switching`: Boolean - true when a workspace switch is in progress
  * - `fetchWorkspaces()`: Function to fetch all workspaces
  * - `refreshWorkspaces()`: Function to refresh workspaces in background (non-blocking)
- * - `setCurrentWorkspace(workspace)`: Function to set the current workspace
+ * - `setCurrentWorkspace(workspace)`: Function to set the current workspace (direct, no callback)
+ * - `switchToWorkspace(workspace)`: Centralized switch - calls onWorkspaceChange first, then sets workspace
  * - `resetCurrentWorkspace()`: Function to clear the current workspace
  * - `createWorkspace(name, image?)`: Function to create a new workspace
  * - `updateWorkspace(workspace, data)`: Function to update a workspace
@@ -113,16 +112,19 @@ export declare const useSaaSWorkspaces: () => {
     fetchWorkspaces: () => Promise<void>;
     refreshWorkspaces: () => Promise<void>;
     refreshing: boolean;
-    WorkspaceSwitcher: typeof WorkspaceSwitcher;
     currentWorkspace: IWorkspace | null;
-    setCurrentWorkspace: (ws: IWorkspace) => void;
+    setCurrentWorkspace: (ws: IWorkspace, options?: {
+        forceEmit?: boolean;
+    }) => void;
+    switchToWorkspace: (ws: IWorkspace, options?: {
+        forceEmit?: boolean;
+    }) => Promise<void>;
     resetCurrentWorkspace: () => void;
     createWorkspace: (name: string, image: string) => Promise<void>;
     allFeatures: import("./types").IWorkspaceFeature[];
     getFeatures: () => Promise<import("./types").IWorkspaceFeature[] | null>;
     updateFeature: (workspaceId: string, key: string, value: boolean) => Promise<IWorkspace>;
     getWorkspace: (workspaceId: string) => Promise<IWorkspace>;
-    switching: boolean;
     updateWorkspace: (ws: IWorkspace, _data: Partial<IWorkspace>) => Promise<void>;
     getUsers: (workspaceId: string) => Promise<IWorkspaceUser[]>;
     addUser: (workspaceId: string, email: string, role: string) => Promise<{
@@ -145,4 +147,5 @@ export declare const useSaaSWorkspaces: () => {
     deleteWorkspace: (workspaceId: string) => Promise<{
         success: boolean;
     }>;
+    switching: boolean;
 };

package/dist/types/providers/workspace/provider.d.ts

@@ -5,5 +5,4 @@ export declare const WorkspaceProvider: ({ children }: {
 }) => import("react/jsx-runtime").JSX.Element;
 export declare function WorkspaceSwitcher(props: {
     trigger: (isLoading: boolean, currentWorkspace: IWorkspace | null) => ReactNode;
-    onWorkspaceChange: (workspace: IWorkspace) => Promise<void>;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/providers/workspace/types.d.ts

@@ -29,7 +29,7 @@ export interface WorkspaceContextValue {
     workspaces: IWorkspace[];
     currentWorkspace: IWorkspace | null;
     loading: boolean;
-    switching: boolean;
+    switchingToId: string | null;
     refreshing: boolean;
     error: string | null;
     fetchWorkspaces: () => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildbase/sdk",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "type": "module",
   "description": "A SDK for Buildbase",
   "main": "dist/index.js",