@buildbase/sdk 0.0.23 → 0.0.25

package/dist/types/components/ErrorBoundary.d.ts

@@ -1,81 +0,0 @@
-import React, { Component, type ReactNode } from 'react';
-export interface ErrorBoundaryProps {
-    children: ReactNode;
-    /**
-     * Fallback UI to render when an error occurs
-     */
-    fallback?: ReactNode | ((error: Error, resetError: () => void) => ReactNode);
-    /**
-     * Called when an error is caught
-     */
-    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
-    /**
-     * Whether to reset error state when children change
-     * @default true
-     */
-    resetOnPropsChange?: boolean;
-}
-interface ErrorBoundaryState {
-    hasError: boolean;
-    error: Error | null;
-}
-/**
- * Error Boundary component for catching React component errors.
- * Wraps SDK components to prevent crashes from propagating to the entire app.
- * Automatically logs errors using the SDK error handler.
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <SDKErrorBoundary
- *       fallback={(error, reset) => (
- *         <div>
- *           <p>Error: {error.message}</p>
- *           <button onClick={reset}>Try Again</button>
- *         </div>
- *       )}
- *       onError={(error, errorInfo) => {
- *         // Custom error reporting
- *         reportError(error, errorInfo);
- *       }}
- *     >
- *       <YourApp />
- *     </SDKErrorBoundary>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Simple usage with default fallback
- * function App() {
- *   return (
- *     <SDKErrorBoundary>
- *       <YourApp />
- *     </SDKErrorBoundary>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Disable auto-reset on props change
- * function App() {
- *   return (
- *     <SDKErrorBoundary resetOnPropsChange={false}>
- *       <YourApp />
- *     </SDKErrorBoundary>
- *   );
- * }
- * ```
- */
-export declare class SDKErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
-    constructor(props: ErrorBoundaryProps);
-    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
-    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
-    resetError: () => void;
-    render(): ReactNode;
-}
-export default SDKErrorBoundary;

package/dist/types/components/beta/BetaForm.d.ts

@@ -1,24 +0,0 @@
-import React from 'react';
-type Language = 'en' | 'es' | 'fr' | 'de' | 'zh' | 'ja' | 'ko';
-interface FormText {
-    nameLabel: string;
-    emailLabel: string;
-    submitText: string;
-    submittingText: string;
-    errorMessage: string;
-}
-interface BetaFormProps {
-    onSuccess?: () => void;
-    onError?: (error: string) => void;
-    className?: string;
-    fieldClassName?: string;
-    language?: Language;
-    customTexts?: Partial<FormText>;
-    autoFocus?: boolean;
-    showSuccessMessage?: boolean;
-    successMessageDuration?: number;
-    hideLogo?: boolean;
-    hideTitles?: boolean;
-}
-export declare const BetaForm: React.FC<BetaFormProps>;
-export {};

package/dist/types/components/beta/api.d.ts

@@ -1,48 +0,0 @@
-import { IAsset, IDocument } from '../../api/types';
-import { IOsConfig } from '../../providers/os/types';
-interface IScreenDetail {
-    title: string;
-    description: string;
-}
-export interface IBetaConfig extends IDocument {
-    name: string;
-    smallName: string;
-    description: string;
-    logoFallBack: string;
-    logo: string | IAsset;
-    privacyPolicy: string;
-    termsOfService: string;
-    enabled: boolean;
-    screen: {
-        register: IScreenDetail;
-        thankYou: IScreenDetail;
-    };
-}
-interface ApiResponse {
-    status: string;
-    message: string;
-    data?: {
-        submissionId: string;
-        status: string;
-    };
-    code: string;
-    config?: IBetaConfig;
-    submissionId?: string;
-}
-export declare class BetaForm {
-    private api;
-    private orgId;
-    constructor(config: IOsConfig);
-    fetchConfig(): Promise<IBetaConfig>;
-    submitBetaUser(formData: {
-        name: string;
-        email: string;
-        context?: {
-            country?: string;
-            language?: string;
-            timezone?: string;
-            currency?: string;
-        };
-    }): Promise<ApiResponse>;
-}
-export default BetaForm;

package/dist/types/components/beta/hooks.d.ts

@@ -1,11 +0,0 @@
-import { IBetaConfig } from '../../api';
-import { BetaFormData, BetaFormResponse } from './types';
-export declare const useBetaForm: () => {
-    isLoading: boolean;
-    isSubmitting: boolean;
-    config: IBetaConfig | null;
-    error: string | null;
-    success: boolean;
-    message: string | null;
-    submitBetaForm: (data: BetaFormData) => Promise<BetaFormResponse>;
-};

package/dist/types/components/beta/schema.d.ts

@@ -1,6 +0,0 @@
-import { z } from 'zod';
-export declare const formSchema: z.ZodObject<{
-    name: z.ZodString;
-    email: z.ZodString;
-}, z.core.$strip>;
-export type formValuesType = z.infer<typeof formSchema>;

package/dist/types/components/beta/types.d.ts

@@ -1,8 +0,0 @@
-export interface BetaFormData {
-    name?: string;
-    email: string;
-}
-export interface BetaFormResponse {
-    success: boolean;
-    message: string;
-}

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

@@ -1,7 +0,0 @@
-export declare const countries: {
-    value: string;
-    flag: string;
-    text: string;
-    currencyCode: string;
-    currencyIcon: string;
-}[];

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

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

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

@@ -1,6 +0,0 @@
-declare const uniqueCurrencies: {
-    value: string;
-    text: string;
-    icon: any;
-}[];
-export { uniqueCurrencies as currencies };

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

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

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

@@ -1,6 +0,0 @@
-declare const languages: {
-    value: string;
-    label: string;
-    flag: string;
-}[];
-export { languages };

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

@@ -1,6 +0,0 @@
-interface SelectLanguageProps {
-    value?: string;
-    onChange?: (value: string) => void;
-}
-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 +0,0 @@
-interface SelectTimeZoneProps {
-    value?: string;
-    onChange?: (value: string) => void;
-}
-export declare function SelectTimeZone({ value, onChange }: SelectTimeZoneProps): import("react/jsx-runtime").JSX.Element;
-export {};

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

@@ -1,8 +0,0 @@
-export declare const timezones: {
-    value: string;
-    abbr: string;
-    offset: number;
-    isdst: boolean;
-    text: string;
-    utc: string[];
-}[];

package/dist/types/components/features/index.d.ts

@@ -1,130 +0,0 @@
-interface IProps {
-    slug: string;
-    children: React.ReactNode;
-}
-/**
- * Conditional component that renders children only when the specified workspace feature is enabled.
- * Checks feature flags at the workspace level.
- *
- * @param props - Component props
- * @param props.slug - Feature flag slug/key to check
- * @param props.children - Content to render when feature is enabled
- *
- * @example
- * ```tsx
- * function PremiumFeature() {
- *   return (
- *     <WhenWorkspaceFeatureEnabled slug="premium-analytics">
- *       <AnalyticsDashboard />
- *     </WhenWorkspaceFeatureEnabled>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Multiple features
- * function FeatureContent() {
- *   return (
- *     <>
- *       <WhenWorkspaceFeatureEnabled slug="feature-a">
- *         <FeatureA />
- *       </WhenWorkspaceFeatureEnabled>
- *       <WhenWorkspaceFeatureEnabled slug="feature-b">
- *         <FeatureB />
- *       </WhenWorkspaceFeatureEnabled>
- *     </>
- *   );
- * }
- * ```
- */
-export declare const WhenWorkspaceFeatureEnabled: {
-    (props: IProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Conditional component that renders children only when the specified workspace feature is disabled.
- * Checks feature flags at the workspace level.
- *
- * @param props - Component props
- * @param props.slug - Feature flag slug/key to check
- * @param props.children - Content to render when feature is disabled
- *
- * @example
- * ```tsx
- * function UpgradePrompt() {
- *   return (
- *     <WhenWorkspaceFeatureDisabled slug="premium-feature">
- *       <UpgradeButton />
- *     </WhenWorkspaceFeatureDisabled>
- *   );
- * }
- * ```
- */
-export declare const WhenWorkspaceFeatureDisabled: {
-    (props: IProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Conditional component that renders children only when the specified user feature is enabled.
- * Checks feature flags at the user level (from UserProvider).
- *
- * @param props - Component props
- * @param props.slug - Feature flag slug/key to check
- * @param props.children - Content to render when feature is enabled
- *
- * @example
- * ```tsx
- * function BetaFeature() {
- *   return (
- *     <WhenUserFeatureEnabled slug="beta-access">
- *       <BetaContent />
- *     </WhenUserFeatureEnabled>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // Edge case: Feature not loaded yet
- * function FeatureContent() {
- *   const { isLoading } = useUserFeatures();
- *
- *   if (isLoading) return <Loading />;
- *
- *   return (
- *     <WhenUserFeatureEnabled slug="feature-x">
- *       <FeatureX />
- *     </WhenUserFeatureEnabled>
- *   );
- * }
- * ```
- */
-export declare const WhenUserFeatureEnabled: {
-    (props: IProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Conditional component that renders children only when the specified user feature is disabled.
- * Checks feature flags at the user level (from UserProvider).
- *
- * @param props - Component props
- * @param props.slug - Feature flag slug/key to check
- * @param props.children - Content to render when feature is disabled
- *
- * @example
- * ```tsx
- * function UpgradePrompt() {
- *   return (
- *     <WhenUserFeatureDisabled slug="premium-access">
- *       <UpgradeButton />
- *     </WhenUserFeatureDisabled>
- *   );
- * }
- * ```
- */
-export declare const WhenUserFeatureDisabled: {
-    (props: IProps): import("react").ReactNode;
-    displayName: string;
-};
-export {};

package/dist/types/components/pricing/PricingPage.d.ts

@@ -1,49 +0,0 @@
-import { ReactNode } from 'react';
-import type { IPublicPlanItem, IPublicPlanVersion } from '../../api/types';
-export interface PricingPageDetails {
-    /** Whether plan data is being fetched */
-    loading: boolean;
-    /** Error message if fetch failed */
-    error: string | null;
-    /** Subscription items (features, limits, quotas) */
-    items: IPublicPlanItem[];
-    /** Plan versions with pricing, features, limits, quotas */
-    plans: IPublicPlanVersion[];
-    /** Optional note from API (e.g. "Pricing is in cents. Please convert to dollars for display.") */
-    notes?: string;
-    /** Refetch plan data */
-    refetch: () => Promise<void>;
-}
-export interface PricingPageProps {
-    /** Plan group slug (e.g. 'main-pricing', 'enterprise') */
-    slug: string;
-    /** Render prop receiving plan details - construct layout from items and plans */
-    children: (details: PricingPageDetails) => ReactNode;
-    /** Custom loading UI. Defaults to skeleton. */
-    loadingFallback?: ReactNode;
-    /** Custom error UI. Receives error message. */
-    errorFallback?: (error: string) => ReactNode;
-}
-/**
- * Fetches and provides plan/pricing details for public pricing pages (no login required).
- * Returns items (features, limits, quotas) and plans (with pricing) - user constructs layout.
- *
- * @example
- * ```tsx
- * <PricingPage slug="main-pricing">
- *   {({ loading, error, items, plans, refetch }) => {
- *     if (loading) return <Loading />;
- *     if (error) return <Error message={error} />;
- *
- *     return (
- *       <div>
- *         {plans.map(plan => (
- *           <PlanCard key={plan._id} plan={plan} items={items} />
- *         ))}
- *       </div>
- *     );
- *   }}
- * </PricingPage>
- * ```
- */
-export declare function PricingPage({ slug, children, loadingFallback, errorFallback }: PricingPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/pricing/index.d.ts

@@ -1,2 +0,0 @@
-export { PricingPage } from './PricingPage';
-export type { PricingPageDetails, PricingPageProps } from './PricingPage';

package/dist/types/components/quota/index.d.ts

@@ -1,121 +0,0 @@
-interface IWhenQuotaProps {
-    /** Quota slug to check (e.g. 'api_calls', 'emails', 'storage'). */
-    slug: string;
-    /** Content to render when the condition is met. */
-    children: React.ReactNode;
-    /** Optional component/element to show while quota usage is loading (e.g. <Skeleton />). */
-    loadingComponent?: React.ReactNode;
-    /** Optional component/element to show when condition is not met (e.g. <UpgradePrompt />). */
-    fallbackComponent?: React.ReactNode;
-}
-interface IWhenQuotaThresholdProps extends IWhenQuotaProps {
-    /** Usage percentage threshold (0-100). Children render when usage >= this percentage. */
-    threshold: number;
-}
-/**
- * Renders children only when the specified quota has remaining units (available > 0).
- * Must be used within QuotaUsageContextProvider (included in SaaSOSProvider by default).
- *
- * @example
- * ```tsx
- * <WhenQuotaAvailable slug="api_calls">
- *   <MakeApiCallButton />
- * </WhenQuotaAvailable>
- * ```
- *
- * @example
- * ```tsx
- * <WhenQuotaAvailable
- *   slug="emails"
- *   loadingComponent={<Skeleton />}
- *   fallbackComponent={<p>Email quota exhausted. <UpgradeLink /></p>}
- * >
- *   <SendEmailButton />
- * </WhenQuotaAvailable>
- * ```
- */
-export declare const WhenQuotaAvailable: {
-    (props: IWhenQuotaProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Renders children only when the specified quota is fully consumed (available <= 0).
- * Must be used within QuotaUsageContextProvider (included in SaaSOSProvider by default).
- *
- * @example
- * ```tsx
- * <WhenQuotaExhausted slug="api_calls">
- *   <UpgradePrompt message="You've used all your API calls this month." />
- * </WhenQuotaExhausted>
- * ```
- *
- * @example
- * ```tsx
- * <WhenQuotaExhausted
- *   slug="storage"
- *   loadingComponent={<Spinner />}
- *   fallbackComponent={null}
- * >
- *   <StorageFullBanner />
- * </WhenQuotaExhausted>
- * ```
- */
-export declare const WhenQuotaExhausted: {
-    (props: IWhenQuotaProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Renders children only when the specified quota is in overage (consumed > included).
- * Must be used within QuotaUsageContextProvider (included in SaaSOSProvider by default).
- *
- * @example
- * ```tsx
- * <WhenQuotaOverage slug="api_calls">
- *   <OverageBillingWarning />
- * </WhenQuotaOverage>
- * ```
- *
- * @example
- * ```tsx
- * <WhenQuotaOverage
- *   slug="emails"
- *   loadingComponent={<Skeleton />}
- *   fallbackComponent={null}
- * >
- *   <p>You are being billed for overage usage.</p>
- * </WhenQuotaOverage>
- * ```
- */
-export declare const WhenQuotaOverage: {
-    (props: IWhenQuotaProps): import("react").ReactNode;
-    displayName: string;
-};
-/**
- * Renders children when the specified quota's usage percentage reaches or exceeds the threshold.
- * Usage percentage = (consumed / included) * 100. If included is 0 and consumed > 0, treats as 100%.
- * Must be used within QuotaUsageContextProvider (included in SaaSOSProvider by default).
- *
- * @example
- * ```tsx
- * <WhenQuotaThreshold slug="api_calls" threshold={80}>
- *   <p>Warning: You've used over 80% of your API calls.</p>
- * </WhenQuotaThreshold>
- * ```
- *
- * @example
- * ```tsx
- * <WhenQuotaThreshold
- *   slug="storage"
- *   threshold={90}
- *   loadingComponent={<Spinner />}
- *   fallbackComponent={null}
- * >
- *   <StorageWarningBanner />
- * </WhenQuotaThreshold>
- * ```
- */
-export declare const WhenQuotaThreshold: {
-    (props: IWhenQuotaThresholdProps): import("react").ReactNode;
-    displayName: string;
-};
-export {};