@buildbase/sdk 0.0.1

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

@@ -0,0 +1,28 @@
+import type { AuthAction, OSAction, WorkspaceAction } from './types';
+/**
+ * Combined SDK Dispatch
+ * Provides dispatch functions for all contexts
+ */
+export interface SDKDispatch {
+    auth: (action: AuthAction) => void;
+    os: (action: OSAction) => void;
+    workspaces: (action: WorkspaceAction) => void;
+}
+/**
+ * Combined dispatch hook - dispatch actions to all contexts
+ *
+ * @example
+ * ```tsx
+ * const dispatch = useAppDispatch();
+ *
+ * // Dispatch to auth context
+ * dispatch.auth(authActions.setSession(session));
+ *
+ * // Dispatch to workspace context
+ * dispatch.workspaces(workspaceActions.setCurrentWorkspace(workspace));
+ *
+ * // Dispatch to OS context
+ * dispatch.os(osActions.setSaaSOSConfig(config));
+ * ```
+ */
+export declare function useAppDispatch(): SDKDispatch;

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

@@ -0,0 +1,36 @@
+import type { IAuthState } from '../providers/auth/types';
+import type { IOsState } from '../providers/os/types';
+import type { WorkspaceState } from './types';
+/**
+ * Combined SDK State
+ * Represents the complete state structure across all contexts
+ */
+export interface SDKState {
+    os: IOsState;
+    auth: IAuthState;
+    workspaces: WorkspaceState;
+}
+/**
+ * Combined selector hook - select from all contexts at once
+ *
+ * @param selector Function that selects a value from the combined SDK state
+ * @param equalityFn Optional equality function for comparison (default: Object.is)
+ *
+ * @example
+ * ```tsx
+ * // Get entire combined state
+ * const sdk = useAppSelector();
+ *
+ * // Get specific context
+ * const auth = useAppSelector(state => state.auth);
+ * const user = useAppSelector(state => state.auth.user);
+ *
+ * // Get multiple fields across contexts
+ * const { user, currentWorkspace, serverUrl } = useAppSelector(state => ({
+ *   user: state.auth.user,
+ *   currentWorkspace: state.workspaces.currentWorkspace,
+ *   serverUrl: state.os.serverUrl,
+ * }));
+ * ```
+ */
+export declare function useAppSelector<Selected = SDKState>(selector?: (state: SDKState) => Selected, equalityFn?: (a: Selected, b: Selected) => boolean): Selected;

package/dist/types/contexts/utils/reducerHelpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reducer helper utilities
+ */
+/**
+ * Creates a simple reducer case that updates a single field
+ */
+export declare function updateField<State extends Record<string, any>>(state: State, field: keyof State, value: any): State;
+/**
+ * Creates a reducer case that updates multiple fields
+ */
+export declare function updateFields<State extends Record<string, any>>(state: State, updates: Partial<State>): State;

package/dist/types/contexts/utils/storage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared localStorage utilities
+ */
+/**
+ * Safe localStorage getter
+ */
+export declare function getStorageItem(key: string): string | null;
+/**
+ * Safe localStorage setter
+ */
+export declare function setStorageItem(key: string, value: string): void;
+/**
+ * Safe localStorage remover
+ */
+export declare function removeStorageItem(key: string): void;
+/**
+ * Safe JSON parse from localStorage
+ */
+export declare function getStorageJSON<T>(key: string): T | null;
+/**
+ * Safe JSON stringify to localStorage
+ */
+export declare function setStorageJSON<T>(key: string, value: T): void;

package/dist/types/hooks/use-mobile.d.ts

@@ -0,0 +1 @@
+export declare function useIsMobile(): boolean;

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+import './styles/globals.css';
+export { SaaSOSProvider } from './providers/SaaSOSProvider';
+export type { SaaSOSProviderProps } from './providers/SaaSOSProvider';
+export { BetaForm } from './components/beta/BetaForm';
+export { WhenAuthenticated, WhenUnauthenticated } from './components/user/auth';
+export { WhenRoles, WhenWorkspaceRoles } from './components/user/role';
+export { WhenWorkspaceFeatureDisabled, WhenWorkspaceFeatureEnabled } from './components/features';
+export { useSaaSAuth } from './providers/auth/hooks';
+export { useSaaSWorkspaces } from './providers/workspace/hooks';
+export { WorkspaceSwitcher } from './providers/workspace/provider';
+export { useAppSelector } from './contexts/useAppSelector';
+export type { SDKState } from './contexts/useAppSelector';
+export { useAppDispatch } from './contexts/useAppDispatch';
+export type { SDKDispatch } from './contexts/useAppDispatch';

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

@@ -0,0 +1,29 @@
+import { AxiosRequestConfig } from 'axios';
+export interface ApiClientConfig {
+    baseURL?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface ApiResponse<T = any> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: any;
+}
+export declare class ApiClient {
+    private client;
+    constructor(config?: ApiClientConfig);
+    private getAuthToken;
+    private handleUnauthorized;
+    get<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    post<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    put<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    delete<T = any>(url: string, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    patch<T = any>(url: string, data?: any, config?: AxiosRequestConfig): Promise<ApiResponse<T>>;
+    setAuthToken(token: string): void;
+    removeAuthToken(): void;
+    setBaseURL(baseURL: string): void;
+    setHeader(key: string, value: string): void;
+    removeHeader(key: string): void;
+}
+export declare const defaultApiClient: ApiClient;

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

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { IAuthConfig } from './auth/types';
+import type { IOsState } from './os/types';
+interface ContextConfigProviderProps {
+    config: IOsState;
+    auth?: IAuthConfig;
+    children: React.ReactNode;
+}
+/**
+ * Context Config Provider
+ * Initializes OS configuration in Context API mode
+ * Similar to SaaSConfigProvider but for Context API
+ */
+export declare const ContextConfigProvider: React.FC<ContextConfigProviderProps>;
+export {};

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

@@ -0,0 +1,8 @@
+import React from 'react';
+export declare const PortalContext: React.Context<{
+    container: HTMLDivElement | null;
+    setContainer: (container: HTMLDivElement | null) => void;
+}>;
+export default function PortalProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,7 @@
+import React from 'react';
+import '../styles/globals.css';
+import { IOsState } from './os/types';
+export interface SaaSOSProviderProps extends IOsState {
+    children: React.ReactNode;
+}
+export declare const SaaSOSProvider: React.FC<SaaSOSProviderProps>;

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

@@ -0,0 +1,10 @@
+export declare function useSaaSAuth(): {
+    user: import("./types").AuthUser | null;
+    session: import("./types").AuthSession | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    isRedirecting: boolean;
+    status: import("./types").AuthStatus;
+    signIn: () => Promise<void>;
+    signOut: () => Promise<void>;
+};

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

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { IAuthCallbacks } from './types';
+interface IProps {
+    children: ReactNode;
+    callbacks?: IAuthCallbacks;
+}
+export declare function AuthProvider({ children, callbacks }: IProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,38 @@
+export declare enum AuthStatus {
+    loading = "loading",
+    authenticated = "authenticated",
+    unauthenticated = "unauthenticated",
+    authenticating = "authenticating"
+}
+export interface AuthUser {
+    id: string;
+    name: string;
+    org: string;
+    email: string;
+    emailVerified: boolean;
+    clientId: string;
+    role: string;
+    image?: string;
+}
+export interface AuthSession {
+    user: AuthUser;
+    accessToken: string;
+    expires: string;
+}
+export interface IAuthState {
+    user: AuthUser | null;
+    session: AuthSession | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+    isRedirecting: boolean;
+    status: AuthStatus;
+}
+export interface IAuthConfig {
+    clientId: string;
+    redirectUrl: string;
+    callbacks?: IAuthCallbacks;
+}
+export interface IAuthCallbacks {
+    handleAuthentication: (token: string) => Promise<void>;
+    verifyToken: (token: string) => Promise<boolean>;
+}

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

@@ -0,0 +1,10 @@
+import { AuthSession, AuthUser } from './types';
+export declare const AUTH_TOKEN_KEY = "saas_os_auth_token";
+export declare function getAccessToken(): string | null;
+export declare function getTokenFromUrl(): string | null;
+export declare function removeTokenFromUrl(): void;
+export declare function createSession(user: AuthUser, token: string, hours?: number): AuthSession;
+export declare const AUTH_CONSTANTS: {
+    TOKEN_PARAM: string;
+    AUTH_TOKEN_KEY: string;
+};

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

@@ -0,0 +1,9 @@
+import { IAuthConfig } from '../auth/types';
+export interface IOsConfig {
+    serverUrl: string;
+    version: string;
+    orgId: string;
+}
+export interface IOsState extends IOsConfig {
+    auth?: IAuthConfig;
+}

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

@@ -0,0 +1,33 @@
+import { IUser } from '../../api/types';
+import { IOsConfig } from '../os/types';
+import type { IWorkspace, IWorkspaceFeature, IWorkspaceUser } from './types';
+export declare class WorkspaceApi {
+    private version;
+    private orgId;
+    private serverUrl;
+    constructor(config: IOsConfig);
+    getAuthHeader(): Record<string, string>;
+    getWorkspaces(): Promise<IWorkspace[]>;
+    createWorkspace(data: {
+        name: string;
+        image?: string;
+    }): Promise<IWorkspace>;
+    updateWorkspace(id: string, data: Partial<IWorkspace>): Promise<IWorkspace>;
+    deleteWorkspace(id: string): Promise<{
+        success: boolean;
+    }>;
+    getWorkspaceUsers(workspaceId: string): Promise<IWorkspaceUser[]>;
+    addUser(workspaceId: string, config: {
+        email: string;
+        role: string;
+    }): Promise<IWorkspaceUser>;
+    removeUser(workspaceId: string, userId: string): Promise<{
+        success: boolean;
+    }>;
+    updateUser(workspaceId: string, userId: string, data: Partial<IWorkspaceUser>): Promise<IWorkspaceUser>;
+    getFeatures(): Promise<IWorkspaceFeature[]>;
+    updateFeature(workspaceId: string, key: string, value: boolean): Promise<IWorkspace>;
+    getWorkspace(workspaceId: string): Promise<IWorkspace>;
+    getProfile(): Promise<IUser>;
+    updateUserProfile(config: Partial<IUser>): Promise<IUser>;
+}

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

@@ -0,0 +1,30 @@
+import { IUser } from '../../api/types';
+import { WorkspaceSwitcher } from './provider';
+import { IWorkspace, IWorkspaceUser } from './types';
+export declare const useSaaSWorkspaces: () => {
+    workspaces: IWorkspace[];
+    loading: boolean;
+    error: string | null;
+    fetchWorkspaces: () => Promise<void>;
+    refreshWorkspaces: () => Promise<void>;
+    refreshing: boolean;
+    WorkspaceSwitcher: typeof WorkspaceSwitcher;
+    currentWorkspace: IWorkspace | null;
+    setCurrentWorkspace: (ws: IWorkspace) => void;
+    resetCurrentWorkspace: () => void;
+    createWorkspace: (name: string, image: string) => Promise<void>;
+    allFeatures: import("./types").IWorkspaceFeature[];
+    getFeatures: () => Promise<import("./types").IWorkspaceFeature[]>;
+    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<IWorkspaceUser>;
+    removeUser: (workspaceId: string, userId: string) => Promise<{
+        success: boolean;
+    }>;
+    updateUser: (workspaceId: string, userId: string, config: Partial<IWorkspaceUser>) => Promise<IWorkspaceUser>;
+    getProfile: () => Promise<IUser>;
+    updateUserProfile: (config: Partial<IUser>) => Promise<IUser>;
+};

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

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+import type { IWorkspace } from './types';
+export declare const WorkspaceProvider: ({ children }: {
+    children: ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare function WorkspaceSwitcher(props: {
+    trigger: (currentWorkspace: IWorkspace | null) => ReactNode;
+    onWorkspaceChange: (workspace: IWorkspace) => Promise<void>;
+}): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,38 @@
+export interface IWorkspace {
+    _id: string;
+    name: string;
+    image?: string;
+    workspaceId: string;
+    users: IUser[];
+    roles: string[];
+    createdBy: string | IUser;
+    features: Record<string, boolean>;
+}
+export interface IWorkspaceFeature {
+    _id: string;
+    name: string;
+    description: string;
+    userManaged: boolean;
+    defaultValue: boolean;
+    slug: string;
+    category: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface IWorkspaceUser {
+    _id: string;
+    workspace: string | IWorkspace;
+    user: string | IUser;
+    role: string;
+}
+export interface WorkspaceContextValue {
+    workspaces: IWorkspace[];
+    currentWorkspace: IWorkspace | null;
+    loading: boolean;
+    switching: boolean;
+    refreshing: boolean;
+    error: string | null;
+    fetchWorkspaces: () => Promise<void>;
+    refreshWorkspaces: () => Promise<void>;
+}
+import type { IUser } from '../../api/types';

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import { IWorkspace } from '../types';
+export type WorkspaceSettingsSection = 'profile' | 'general' | 'users' | 'features';
+declare const WorkspaceSettingsDialog: React.FC<{
+    workspace: IWorkspace;
+    onClose: () => void;
+}>;
+export default WorkspaceSettingsDialog;

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

@@ -0,0 +1,5 @@
+import React from 'react';
+declare const WorkspaceSettingsFeatures: React.FC<{
+    workspaceId: string;
+}>;
+export default WorkspaceSettingsFeatures;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import { IWorkspace } from '../types';
+declare const WorkspaceSettingsGeneral: React.FC<{
+    workspace: IWorkspace;
+}>;
+export default WorkspaceSettingsGeneral;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import { IWorkspace } from '../types';
+declare const WorkspaceSettingsProfile: React.FC<{
+    workspace: IWorkspace;
+}>;
+export default WorkspaceSettingsProfile;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import { IWorkspace } from '../types';
+declare const WorkspaceSettingsUsers: React.FC<{
+    workspace: IWorkspace;
+}>;
+export default WorkspaceSettingsUsers;

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

@@ -0,0 +1,10 @@
+import React from 'react';
+import { IWorkspace } from '../types';
+import type { WorkspaceSettingsSection } from './SettingsDialog';
+interface Props {
+    workspace: IWorkspace;
+    section: WorkspaceSettingsSection;
+    setSection: (section: WorkspaceSettingsSection) => void;
+}
+declare const Sidebar: React.FC<Props>;
+export default Sidebar;

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

@@ -0,0 +1,2 @@
+export declare function getSvgImage(emoji: string): string;
+export declare const workspaceEmojis: string[];

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

@@ -0,0 +1,8 @@
+import { IWorkspace } from './types';
+export declare const workspaceStorage: {
+    saveCurrentWorkspace: (workspace: IWorkspace | null) => void;
+    loadCurrentWorkspace: () => string | null;
+    clearCurrentWorkspace: () => void;
+    isWorkspaceValid: (workspaceId: string | null, availableWorkspaces: IWorkspace[]) => boolean;
+    getStorageKey: () => string;
+};

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "@buildbase/sdk",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "A SDK for Buildbase",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "browser": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "prepublishOnly": "npm run build",
+    "publish:npm": "npm publish",
+    "publish:npm:beta": "npm publish --tag beta",
+    "publish:npm:dry-run": "npm publish --dry-run",
+    "yalc:add": "yalc add",
+    "yalc:push": "yalc push",
+    "yalc:remove": "yalc remove",
+    "format": "prettier --write . --plugin=prettier-plugin-organize-imports",
+    "push:sdk": "npm run build && yalc push",
+    "watch:push": "nodemon",
+    "watch:push:light": "chokidar \"src/**/*\" -c \"npm run push:sdk\" --initial --ignore dist"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "dependencies": {
+    "@radix-ui/react-icons": "^1.3.2",
+    "@radix-ui/react-toast": "^1.2.14",
+    "axios": "^1.6.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.0.0",
+    "cmdk": "^1.1.1",
+    "date-fns": "^4.1.0",
+    "javascript-time-ago": "^2.5.11",
+    "jwt-decode": "^4.0.0",
+    "lucide-react": "^0.544.0",
+    "luxon": "^3.7.2",
+    "moment": "^2.30.1",
+    "react-day-picker": "^9.7.0",
+    "react-hook-form": "^7.60.0",
+    "tailwind-merge": "^3.3.1",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "@hookform/resolvers": "^5.0.1",
+    "@radix-ui/react-accordion": "^1.2.10",
+    "@radix-ui/react-alert-dialog": "^1.1.13",
+    "@radix-ui/react-aspect-ratio": "^1.1.6",
+    "@radix-ui/react-avatar": "^1.1.9",
+    "@radix-ui/react-checkbox": "^1.3.1",
+    "@radix-ui/react-collapsible": "^1.1.10",
+    "@radix-ui/react-context-menu": "^2.2.14",
+    "@radix-ui/react-dialog": "^1.1.13",
+    "@radix-ui/react-dropdown-menu": "^2.1.14",
+    "@radix-ui/react-hover-card": "^1.1.13",
+    "@radix-ui/react-label": "^2.1.6",
+    "@radix-ui/react-menubar": "^1.1.14",
+    "@radix-ui/react-navigation-menu": "^1.2.12",
+    "@radix-ui/react-popover": "^1.1.13",
+    "@radix-ui/react-progress": "^1.1.6",
+    "@radix-ui/react-radio-group": "^1.3.6",
+    "@radix-ui/react-scroll-area": "^1.2.8",
+    "@radix-ui/react-select": "^2.2.4",
+    "@radix-ui/react-separator": "^1.1.6",
+    "@radix-ui/react-slider": "^1.3.4",
+    "@radix-ui/react-slot": "^1.2.2",
+    "@radix-ui/react-switch": "^1.2.4",
+    "@radix-ui/react-tabs": "^1.1.11",
+    "@radix-ui/react-toggle": "^1.1.8",
+    "@radix-ui/react-toggle-group": "^1.1.9",
+    "@radix-ui/react-tooltip": "^1.2.6",
+    "@rollup/plugin-commonjs": "^28.0.6",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.1",
+    "@rollup/plugin-terser": "^0.4.0",
+    "@rollup/plugin-typescript": "^12.1.4",
+    "@types/luxon": "^3.7.1",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "autoprefixer": "^10.4.16",
+    "chokidar-cli": "^3.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "nodemon": "^3.0.0",
+    "postcss": "^8.4.31",
+    "postcss-prefixwrap": "^1.55.0",
+    "prettier": "^3.0.3",
+    "prettier-plugin-organize-imports": "^4.1.0",
+    "prettier-plugin-tailwindcss": "^0.6.14",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "rollup-plugin-postcss": "^4.0.0",
+    "tailwindcss": "^3.4.17",
+    "tslib": "^2.8.1",
+    "typescript": "^5.2.0"
+  },
+  "keywords": [
+    "react",
+    "shadcn",
+    "tailwind",
+    "axios",
+    "ui-components"
+  ],
+  "author": "Buildbase",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}