@buildbase/sdk 0.0.47 → 0.0.49

package/dist/react/index.d.ts

@@ -27,6 +27,19 @@ interface IUser extends IDocument {
     currency?: string;
     attributes?: Record<string, string | number | boolean>;
 }
+/** A registered passkey (WebAuthn credential) — no key material exposed. */
+interface IPasskeySummary {
+    id: string;
+    name: string;
+    deviceType?: string;
+    backedUp?: boolean;
+    lastUsedAt?: string;
+    createdAt?: string;
+    /** Auth domain the credential is bound to */
+    rpId?: string;
+    /** False when the org's auth domain changed and this credential can no longer be used to sign in */
+    active?: boolean;
+}
 interface IAsset extends IDocument {
     _id: string;
     createdAt: string;
@@ -1108,8 +1121,12 @@ declare abstract class BaseApi {
     protected url(path: string): string;
     /** Merge auth + custom + per-request headers. */
     private buildHeaders;
+    /** Fire the onError callback exactly once per error, regardless of call path. */
+    private reportError;
     /** Execute fetch with timeout, retries, debug logging, and error callback. */
     private executeFetch;
+    /** Internal: execute fetch against a resolved URL with timeout, retries, debug logging, and error callback. */
+    private executeFetchUrl;
     /**
      * Execute request and parse JSON with handleApiResponse (throws on !response.ok).
      * Use for standard JSON APIs.
@@ -1120,6 +1137,12 @@ declare abstract class BaseApi {
      * Caller is responsible for checking response.ok and parsing body.
      */
     protected fetchResponse(path: string, init?: RequestInit): Promise<Response>;
+    /**
+     * Execute request against an absolute URL (bypasses baseUrl).
+     * Useful for endpoints outside the default basePath (e.g. /auth vs /public).
+     * Gets the same timeout, retry, header-merge, and error-callback handling as fetchResponse.
+     */
+    protected fetchAbsoluteUrl(absoluteUrl: string, init?: RequestInit): Promise<Response>;
     /**
      * Throw an error from a failed response.
      * Tries to parse JSON error body; falls back to status-based message.
@@ -1144,6 +1167,7 @@ interface AuthRequestParams {
         success: string;
         error: string;
     };
+    state?: string;
 }
 interface AuthRequestResponse {
     success: boolean;
@@ -1158,8 +1182,8 @@ declare class AuthApi extends BaseApi {
     });
     /**
      * Initiate OAuth sign-in flow. Returns redirect URL to the auth provider.
-     * Uses /api/v1/auth/request — auth endpoints sit outside the /public basePath,
-     * so we build the URL directly instead of using fetchResponse.
+     * Auth endpoints sit at /api/v1/auth/ (outside the /public basePath),
+     * so we use fetchAbsoluteUrl to get timeout, retry, and error handling via BaseApi.
      */
     requestAuth(params: AuthRequestParams): Promise<AuthRequestResponse>;
     /** Fetch user profile with the given session ID (used after OAuth redirect or from storage). */
@@ -1351,6 +1375,9 @@ declare class WorkspaceApi extends BaseApi {
     getWorkspace(workspaceId: string): Promise<IWorkspace>;
     getProfile(): Promise<IUser>;
     updateUserProfile(config: Partial<IUser>): Promise<IUser>;
+    getPasskeys(): Promise<IPasskeySummary[]>;
+    renamePasskey(passkeyId: string, name: string): Promise<void>;
+    deletePasskey(passkeyId: string): Promise<void>;
     /**
      * Get current subscription for a workspace
      * Returns subscription details including plan, plan version, and group information
@@ -2196,9 +2223,25 @@ declare function useFullScreenLoader(): FullScreenLoaderContextValue;
  * All user-facing strings are defined here.
  */
 interface SDKMessages {
+    security: {
+        inactive: string;
+        inactiveHint: string;
+        passkeysTitle: string;
+        passkeysDescription: string;
+        noPasskeys: string;
+        addHint: string;
+        rename: string;
+        remove: string;
+        removeTitle: string;
+        removeDescription: string;
+        renamePlaceholder: string;
+        lastUsed: string;
+        added: string;
+    };
     settings: {
         titles: {
             profile: string;
+            security: string;
             general: string;
             users: string;
             subscription: string;
@@ -2213,6 +2256,7 @@ interface SDKMessages {
             account: string;
             workspace: string;
             profile: string;
+            security: string;
             general: string;
             users: string;
             subscription: string;
@@ -2994,6 +3038,7 @@ declare const WhenUnauthenticated: {
 
 declare const SettingsScreen: {
     readonly Profile: "profile";
+    readonly Security: "security";
     readonly General: "general";
     readonly Users: "users";
     readonly Subscription: "subscription";
@@ -5231,37 +5276,6 @@ declare function useSeatStatus(workspace: {
     settingsMaxUsers?: number | null;
 }): SeatStatus;
 
-interface FullScreenLoaderProps {
-    /** Content to display centered on screen. Falls back to a default spinner + message. */
-    children?: react__default.ReactNode;
-    /** Message shown below the default spinner (only used when no children are provided). Defaults to "Loading..." */
-    message?: string;
-    /** Background color of the overlay. Defaults to white (dark mode: near-black). */
-    backgroundColor?: string;
-}
-/**
- * Full-screen overlay that centers its content.
- * Uses inline styles — works without any CSS imports.
- * Respects dark mode and reduced-motion preferences.
- *
- * @example Default spinner
- * ```tsx
- * <FullScreenLoader message="Signing you in..." />
- * ```
- *
- * @example Custom content
- * ```tsx
- * <FullScreenLoader>
- *   <img src="/logo.svg" alt="Logo" />
- *   <p>Loading your workspace...</p>
- * </FullScreenLoader>
- * ```
- */
-declare const FullScreenLoader: {
-    ({ children, message, backgroundColor, }: FullScreenLoaderProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
 interface BetaFormProps {
     onSuccess?: () => void;
     onError?: (error: string) => void;
@@ -5344,6 +5358,37 @@ interface PricingPageProps {
  */
 declare function PricingPage({ slug, children, loadingFallback, errorFallback, redirectBaseUrl, }: PricingPageProps): react_jsx_runtime.JSX.Element;
 
+interface FullScreenLoaderProps {
+    /** Content to display centered on screen. Falls back to a default spinner + message. */
+    children?: react__default.ReactNode;
+    /** Message shown below the default spinner (only used when no children are provided). Defaults to "Loading..." */
+    message?: string;
+    /** Background color of the overlay. Defaults to white (dark mode: near-black). */
+    backgroundColor?: string;
+}
+/**
+ * Full-screen overlay that centers its content.
+ * Uses inline styles — works without any CSS imports.
+ * Respects dark mode and reduced-motion preferences.
+ *
+ * @example Default spinner
+ * ```tsx
+ * <FullScreenLoader message="Signing you in..." />
+ * ```
+ *
+ * @example Custom content
+ * ```tsx
+ * <FullScreenLoader>
+ *   <img src="/logo.svg" alt="Logo" />
+ *   <p>Loading your workspace...</p>
+ * </FullScreenLoader>
+ * ```
+ */
+declare const FullScreenLoader: {
+    ({ children, message, backgroundColor, }: FullScreenLoaderProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+
 declare function WorkspaceSwitcher(props: {
     trigger: (isLoading: boolean, currentWorkspace: IWorkspace | null) => ReactNode;
 }): react_jsx_runtime.JSX.Element;
@@ -5382,5 +5427,48 @@ declare const PushNotificationProvider: react__default.FC<PushNotificationProvid
  */
 declare function usePushNotifications(): PushNotificationContextValue;
 
-export { ApiVersion, AuthApi, AuthStatus, BBAction, BBScreen, BBStatus, BB_PARAM, BaseApi, BetaForm, BillingIntervals, CURRENCY_DISPLAY, CURRENCY_FLAG, CreditActionsProvider, CreditBalance, CreditBalanceContextProvider, CreditBucketSource, CreditBucketStatus, CreditStorePage, CreditTransactionType, DEFAULT_ROLE_PERMISSIONS, DunningState, EventEmitter, FullScreenLoader, InvoiceStatuses, PLAN_CURRENCY_CODES, PLAN_CURRENCY_OPTIONS, PUSH_SERVICE_WORKER_SCRIPT, Permission, PricingPage, PushApi, PushNotificationProvider, QuotaUsageContextProvider, SDKEvent, SETTINGS_SCREENS, SUPPORTED_LOCALES, SaaSOSProvider, SettingsApi, SettingsScreen, SubscriptionContextProvider, SubscriptionItemType, SubscriptionStatus, UserApi, WhenAuthenticated, WhenCreditsAvailable, WhenCreditsExhausted, WhenCreditsLow, WhenNoSubscription, WhenNotTrialing, WhenPermission, WhenQuotaAvailable, WhenQuotaExhausted, WhenQuotaOverage, WhenQuotaThreshold, WhenRoles, WhenSubscription, WhenSubscriptionToPlans, WhenTrialEnding, WhenTrialing, WhenUnauthenticated, WhenUserFeatureDisabled, WhenUserFeatureEnabled, WhenWorkspaceFeatureDisabled, WhenWorkspaceFeatureEnabled, WhenWorkspaceRoles, WorkspaceApi, WorkspaceSwitcher, calculateBillableSeats, calculateSeatOverageCents, calculateTotalSubscriptionCents, cleanBBParams, clearAuthIntent, consumeAuthIntent, createBBUrl, createCheckoutRedirectUrls, createCreditPurchaseRedirectUrls, eventEmitter, formatCents, formatOverageRate, formatOverageRateWithLabel, formatQuotaIncludedOverage, formatQuotaWithPrice, getAvailableCurrenciesFromPlans, getBasePriceCents, getBillingIntervalAndCurrencyFromPriceId, getCurrencyFlag, getCurrencySymbol, getDisplayCurrency, getPerSeatPriceCents, getPricingVariant, getQuotaDisplayValue, getQuotaDisplayWithVariant, getQuotaOverageCents, getQuotaUnitLabelFromName, getSeatPricing, getStripePriceIdForInterval, hasPermission, invalidateCreditBalance, invalidateQuotaUsage, invalidateSubscription, readBBParams, resolveMaxUsers, resolvePermissions, safeRedirect, saveAuthIntent, useAllQuotaUsage, useBillingPortal, useCancelSubscription, useConsumeCredits, useCreateCheckoutSession, useCreditBalance, useCreditBalanceContext, useCreditPackages, useCreditTransactions, useExpiringCredits, useFullScreenLoader, useInvoice, useInvoices, usePermissions, usePlanGroup, usePlanGroupVersions, usePublicCreditPackages, usePublicPlanGroupVersion, usePublicPlans, usePurchaseCredits, usePushNotifications, useQuotaUsageContext, useQuotaUsageStatus, useRecordUsage, useResumeSubscription, useSaaSAuth, useSaaSOs, useSaaSSettings, useSaaSWorkspaces, useSeatStatus, useSubscription, useSubscriptionContext, useSubscriptionManagement, useTranslation, useTrialStatus, useUpdateSubscription, useUsageLogs, useUserAttributes, useUserFeatures, validateInvite, validateRedirectUrl };
-export type { BBActionType, BBScreenType, BBStatusType, BetaFormData, BetaFormResponse, BillingInterval, CheckoutResult, CreditActionsDetails, CreditBalanceContextValue, CreditBalanceDetails, CreditBucketSourceType, CreditBucketStatusType, CreditStorePageDetails, CreditTransactionTypeValue, DunningStateType, EventData, EventType, FormatQuotaWithPriceOptions, FullScreenLoaderProps, GetCheckoutStripeParams, IAllQuotaUsageResponse, IBaseApiConfig, IBasePricing, IBetaConfig, ICheckoutSessionRequest, ICheckoutSessionResponse, ICheckoutStripeOptions, IConsumeCreditsRequest, IConsumeCreditsResponse, ICreditBalance, ICreditBucket, ICreditBucketsQuery, ICreditBucketsResponse, ICreditPackage, ICreditPackagePricingVariant, ICreditPurchaseRequest, ICreditPurchaseResponse, ICreditTransaction, ICreditTransactionsQuery, ICreditTransactionsResponse, IEventCallbacks, IExpiringCreditsResponse, IInvoice, IInvoiceListResponse, IInvoiceResponse, IOsConfig, IOsState, IPlan, IPlanGroup, IPlanGroupInfo, IPlanGroupLatestVersion, IPlanGroupResponse, IPlanGroupVersion, IPlanGroupVersionWithPlans, IPlanGroupVersionsResponse, IPlanVersion, IPlanVersionSummary, IPlanVersionWithPlan, IPricingVariant, IPublicCreditPackage, IPublicCreditPackagesResponse, IPublicPlanItem, IPublicPlanItemCategory, IPublicPlanVersion, IPublicPlansResponse, IQuotaByInterval, IQuotaIntervalValue, IQuotaOveragePriceIdsByInterval, IQuotaOveragesByInterval, IQuotaUsageStatus, IQuotaUsageStatusResponse, IRecordUsageRequest, IRecordUsageResponse, IStripePricesByInterval, ISubscription, ISubscriptionItem, ISubscriptionResponse, ISubscriptionUpdateRequest, ISubscriptionUpdateResponse, IUsageLogEntry, IUsageLogsQuery, IUsageLogsResponse, InviteBlockReason, InviteValidation, InvoiceStatus, InvoiceStatusType, LoadingProps, MaxUsersConfig, NotificationData, NotificationEvent, NotificationResult, OnWorkspaceChangeParams, PermissionContext, PermissionKey, PlanVersionWithPricingVariants, PricingPageDetails, PricingPageProps, QuotaDisplayValue, QuotaDisplayWithOverage, QuotaUsageContextValue, RolePermissionMap, SDKLocale, SDKMessages, SaaSOSProviderProps, SeatStatus, SubscriptionContextValue, SubscriptionItemTypeValue, SubscriptionStatusType, TrialStatus, UserCreatedEventData, UserUpdatedEventData, WorkspaceChangedEventData, WorkspaceCreatedEventData, WorkspaceDeletedEventData, WorkspaceSettingsSection, WorkspaceUpdatedEventData, WorkspaceUserAddedEventData, WorkspaceUserRemovedEventData, WorkspaceUserRoleChangedEventData };
+interface SettingsManagerState {
+    open: boolean;
+    section: WorkspaceSettingsSection;
+    /** Optional params carried from BB URL (e.g. plan selection from pricing page). Cleared on close. */
+    params?: Record<string, string>;
+}
+/**
+ * Global settings manager for workspace settings dialog
+ * Handles opening/closing the dialog internally
+ */
+declare class WorkspaceSettingsManager {
+    private listeners;
+    private currentState;
+    /**
+     * Subscribe to settings dialog state changes
+     */
+    subscribe(listener: (state: SettingsManagerState) => void): () => void;
+    /**
+     * Get current state
+     */
+    getState(): SettingsManagerState;
+    /**
+     * Open workspace settings dialog
+     * @param section - Optional section to open to (defaults to 'profile')
+     * @param params - Optional params to pass to the section (e.g. plan selection from BB URL)
+     */
+    openWorkspaceSettings(section?: WorkspaceSettingsSection, params?: Record<string, string>): void;
+    /**
+     * Close settings dialog
+     */
+    closeSettings(): void;
+    /**
+     * Change section without opening/closing
+     */
+    setSection(section: WorkspaceSettingsSection): void;
+    /**
+     * Clear params without changing open/section state
+     */
+    clearParams(): void;
+    private notifyListeners;
+}
+declare const workspaceSettingsManager: WorkspaceSettingsManager;
+
+export { ApiVersion, AuthApi, AuthStatus, BBAction, BBScreen, BBStatus, BB_PARAM, BaseApi, BetaForm, BillingIntervals, CURRENCY_DISPLAY, CURRENCY_FLAG, CreditActionsProvider, CreditBalance, CreditBalanceContextProvider, CreditBucketSource, CreditBucketStatus, CreditStorePage, CreditTransactionType, DEFAULT_ROLE_PERMISSIONS, DunningState, EventEmitter, FullScreenLoader, InvoiceStatuses, PLAN_CURRENCY_CODES, PLAN_CURRENCY_OPTIONS, PUSH_SERVICE_WORKER_SCRIPT, Permission, PricingPage, PushApi, PushNotificationProvider, QuotaUsageContextProvider, SDKEvent, SETTINGS_SCREENS, SUPPORTED_LOCALES, SaaSOSProvider, SettingsApi, SettingsScreen, SubscriptionContextProvider, SubscriptionItemType, SubscriptionStatus, UserApi, WhenAuthenticated, WhenCreditsAvailable, WhenCreditsExhausted, WhenCreditsLow, WhenNoSubscription, WhenNotTrialing, WhenPermission, WhenQuotaAvailable, WhenQuotaExhausted, WhenQuotaOverage, WhenQuotaThreshold, WhenRoles, WhenSubscription, WhenSubscriptionToPlans, WhenTrialEnding, WhenTrialing, WhenUnauthenticated, WhenUserFeatureDisabled, WhenUserFeatureEnabled, WhenWorkspaceFeatureDisabled, WhenWorkspaceFeatureEnabled, WhenWorkspaceRoles, WorkspaceApi, WorkspaceSwitcher, calculateBillableSeats, calculateSeatOverageCents, calculateTotalSubscriptionCents, cleanBBParams, clearAuthIntent, consumeAuthIntent, createBBUrl, createCheckoutRedirectUrls, createCreditPurchaseRedirectUrls, eventEmitter, formatCents, formatOverageRate, formatOverageRateWithLabel, formatQuotaIncludedOverage, formatQuotaWithPrice, getAvailableCurrenciesFromPlans, getBasePriceCents, getBillingIntervalAndCurrencyFromPriceId, getCurrencyFlag, getCurrencySymbol, getDisplayCurrency, getPerSeatPriceCents, getPricingVariant, getQuotaDisplayValue, getQuotaDisplayWithVariant, getQuotaOverageCents, getQuotaUnitLabelFromName, getSeatPricing, getStripePriceIdForInterval, hasPermission, invalidateCreditBalance, invalidateQuotaUsage, invalidateSubscription, readBBParams, resolveMaxUsers, resolvePermissions, safeRedirect, saveAuthIntent, useAllQuotaUsage, useBillingPortal, useCancelSubscription, useConsumeCredits, useCreateCheckoutSession, useCreditBalance, useCreditBalanceContext, useCreditPackages, useCreditTransactions, useExpiringCredits, useFullScreenLoader, useInvoice, useInvoices, usePermissions, usePlanGroup, usePlanGroupVersions, usePublicCreditPackages, usePublicPlanGroupVersion, usePublicPlans, usePurchaseCredits, usePushNotifications, useQuotaUsageContext, useQuotaUsageStatus, useRecordUsage, useResumeSubscription, useSaaSAuth, useSaaSOs, useSaaSSettings, useSaaSWorkspaces, useSeatStatus, useSubscription, useSubscriptionContext, useSubscriptionManagement, useTranslation, useTrialStatus, useUpdateSubscription, useUsageLogs, useUserAttributes, useUserFeatures, validateInvite, validateRedirectUrl, workspaceSettingsManager };
+export type { BBActionType, BBScreenType, BBStatusType, BetaFormData, BetaFormResponse, BillingInterval, CheckoutResult, CreditActionsDetails, CreditBalanceContextValue, CreditBalanceDetails, CreditBucketSourceType, CreditBucketStatusType, CreditStorePageDetails, CreditTransactionTypeValue, DunningStateType, EventData, EventType, FormatQuotaWithPriceOptions, FullScreenLoaderProps, GetCheckoutStripeParams, IAllQuotaUsageResponse, IBaseApiConfig, IBasePricing, IBetaConfig, ICheckoutSessionRequest, ICheckoutSessionResponse, ICheckoutStripeOptions, IConsumeCreditsRequest, IConsumeCreditsResponse, ICreditBalance, ICreditBucket, ICreditBucketsQuery, ICreditBucketsResponse, ICreditPackage, ICreditPackagePricingVariant, ICreditPurchaseRequest, ICreditPurchaseResponse, ICreditTransaction, ICreditTransactionsQuery, ICreditTransactionsResponse, IEventCallbacks, IExpiringCreditsResponse, IInvoice, IInvoiceListResponse, IInvoiceResponse, IOsConfig, IOsState, IPlan, IPlanGroup, IPlanGroupInfo, IPlanGroupLatestVersion, IPlanGroupResponse, IPlanGroupVersion, IPlanGroupVersionWithPlans, IPlanGroupVersionsResponse, IPlanVersion, IPlanVersionSummary, IPlanVersionWithPlan, IPricingVariant, IPublicCreditPackage, IPublicCreditPackagesResponse, IPublicPlanItem, IPublicPlanItemCategory, IPublicPlanVersion, IPublicPlansResponse, IQuotaByInterval, IQuotaIntervalValue, IQuotaOveragePriceIdsByInterval, IQuotaOveragesByInterval, IQuotaUsageStatus, IQuotaUsageStatusResponse, IRecordUsageRequest, IRecordUsageResponse, IStripePricesByInterval, ISubscription, ISubscriptionItem, ISubscriptionResponse, ISubscriptionUpdateRequest, ISubscriptionUpdateResponse, IUsageLogEntry, IUsageLogsQuery, IUsageLogsResponse, InviteBlockReason, InviteValidation, InvoiceStatus, InvoiceStatusType, LoadingProps, MaxUsersConfig, NotificationData, NotificationEvent, NotificationResult, OnWorkspaceChangeParams, PermissionContext, PermissionKey, PlanVersionWithPricingVariants, PricingPageDetails, PricingPageProps, QuotaDisplayValue, QuotaDisplayWithOverage, QuotaUsageContextValue, RolePermissionMap, SDKLocale, SDKMessages, SaaSOSProviderProps, SeatStatus, SettingsManagerState, SubscriptionContextValue, SubscriptionItemTypeValue, SubscriptionStatusType, TrialStatus, UserCreatedEventData, UserUpdatedEventData, WorkspaceChangedEventData, WorkspaceCreatedEventData, WorkspaceDeletedEventData, WorkspaceSettingsSection, WorkspaceUpdatedEventData, WorkspaceUserAddedEventData, WorkspaceUserRemovedEventData, WorkspaceUserRoleChangedEventData };