@taruvi/sdk 1.5.0-beta.1 → 1.5.0-beta.2

package/src/client.ts

@@ -1,88 +0,0 @@
-import { HttpClient } from "./lib-internal/http/HttpClient.js";
-import { TokenClient } from "./lib-internal/token/TokenClient.js";
-import type { TaruviConfig } from "./types.js";
-import packageJson from "../package.json" with { type: "json" };
-
-export class Client {
-    private readonly config: TaruviConfig
-    private readonly _httpClient: HttpClient
-    private readonly _tokenClient: TokenClient
-
-    constructor(config: TaruviConfig) {
-        if (!config) {
-            throw new Error("Config is required")
-        }
-
-        if (!config.apiKey) {
-            throw new Error("API key is required")
-        }
-
-        if (!config.apiUrl) {
-            throw new Error("API URL is required")
-        }
-
-        this.config = config
-
-        // Internal clients for SDK use only
-        // TokenClient must be created first, then passed to HttpClient
-
-        this._tokenClient = new TokenClient(config.token)
-        this._httpClient = new HttpClient(this.config, this._tokenClient)
-
-        // Check URL hash for tokens (OAuth callback)
-        this.extractTokensFromUrl()
-
-        console.info(`Taruvi SDK v${packageJson.version} initialized`)
-    }
-
-    /**
-     * Extracts session token from URL hash and stores it using TokenClient.
-     * Handles callback URLs like: #session_token=xxx
-     * After extraction, the URL hash is cleared.
-     */
-    private extractTokensFromUrl(): void {
-        if (typeof window === "undefined" || typeof localStorage === "undefined") {
-            return
-        }
-
-        const hash = window.location.hash
-        if (!hash) {
-            return
-        }
-
-        const params = new URLSearchParams(hash.substring(1))
-        const sessionToken = params.get("session_token")
-
-        if (!sessionToken) {
-            return
-        }
-
-        this._tokenClient.setTokens({ sessionToken })
-
-        // Clear hash from URL without reloading page
-        if (window.history && window.history.replaceState) {
-            const urlWithoutHash = window.location.pathname + window.location.search
-            window.history.replaceState(null, "", urlWithoutHash)
-        }
-    }
-
-    /**
-     * @internal
-     * Internal use only - not part of public API
-     */
-    get httpClient(): HttpClient {
-        return this._httpClient
-    }
-
-    /**
-     * @internal
-     * Internal use only - not part of public API
-     */
-    get tokenClient(): TokenClient {
-        return this._tokenClient
-    }
-
-    getConfig(): Readonly<TaruviConfig> {
-        return { ...this.config }
-    }
-}

package/src/index.ts

@@ -1,51 +0,0 @@
-// Export main client
-export { Client } from "./client.js"
-
-// Export error classes
-export { TaruviError, ValidationError, AuthError, ForbiddenError, NotFoundError, ConflictError, TimeoutError, NetworkError, RateLimitError } from "./lib-internal/errors/index.js"
-export { ErrorCode } from "./lib-internal/errors/index.js"
-export type { ErrorResponseBody } from "./lib-internal/errors/index.js"
-
-// Export public client classes
-export { Auth } from "./lib/auth/AuthClient.js"
-export { User } from "./lib/users/UserClient.js"
-export { Storage } from "./lib/storage/StorageClient.js"
-export { Database } from "./lib/database/DatabaseClient.js"
-export { Settings } from "./lib/settings/SettingsClient.js"
-export { Functions } from "./lib/functions/FunctionsClient.js"
-export { Secrets } from "./lib/secrets/SecretsClient.js"
-export { Policy } from "./lib/policy/PolicyClient.js"
-export { App } from "./lib/app/AppClient.js"
-export { Analytics } from "./lib/analytics/AnalyticsClient.js"
-
-// Export core types
-export type { TaruviConfig, TaruviResponse, PaginationInfo, StorageFilters, DatabaseFilters } from "./types.js"
-export type { AuthTokens } from "./lib-internal/token/TokenClient.js"
-
-// User types
-export type { UserCreateRequest, UserData, UserUpdateRequest, UserListFilters, UserApp, UserResponse, UserListResponse, UserAppsResponse, AssignRolesRequest, RevokeRolesRequest, RolesResponse, UserGroup, UserPermission, UserRole, UserPreferences, UserPreferencesUpdate, UserPreferencesResponse } from "./lib/users/types.js"
-
-// Policy types
-export type { Principal, Resource, Resources, PolicyCheckResult, PolicyCheckBatchResult, ResourceCheckResponse, GetAllowedActionsOptions } from "./lib/policy/types.js"
-
-// App types
-export type { RoleData, AppSettingsData, RoleResponse, RolesListResponse, AppSettingsResponse } from "./lib/app/types.js"
-
-// Function types
-export type { FunctionRequest, FunctionResponse, FunctionInvocation } from "./lib/functions/types.js"
-
-// Database types
-export type { DatabaseRequest, DatabaseResponse, DatabaseSingleResponse, FilterOperator, SortOrder, GraphInclude, GraphFormat, EdgeRequest, EdgeResponse, EdgeDeleteRequest, PgRangeValue, BackendFilterLeafNode, BackendFilterLogicalNode, BackendFilterNode, BackendFilterTreeRoot } from "./lib/database/types.js"
-export { isBackendFilterTreeRoot } from "./lib/database/types.js"
-
-// Storage types
-export type { StorageRequest, StorageUpdateRequest, StorageObject, StorageResponse, StorageListResponse, StorageUploadBatchResponse, StorageDeleteBatchResponse } from "./lib/storage/types.js"
-
-// Settings types
-export type { SiteSettingsData, SettingsResponse } from "./lib/settings/types.js"
-
-// Secrets types
-export type { SecretCreateRequest, SecretUpdateRequest, SecretData, SecretResponse, SecretsListResponse, SecretsBatchResponse, SecretsBatchMetadataResponse, GetSecretOptions, GetSecretsOptions } from "./lib/secrets/types.js"
-
-// Analytics types
-export type { AnalyticsRequest, AnalyticsResponse } from "./lib/analytics/types.js"

package/src/lib/analytics/AnalyticsClient.ts

@@ -1,24 +0,0 @@
-import type { Client } from "../../client.js";
-import type { TaruviConfig } from "../../types.js";
-import type { AnalyticsRequest, AnalyticsResponse } from "./types.js";
-import { AnalyticsRoutes } from "../../lib-internal/routes/AnalyticsRoutes.js";
-
-export class Analytics {
-    private client: Client
-    private config: TaruviConfig
-
-    constructor(client: Client) {
-        this.client = client
-        this.config = this.client.getConfig()
-    }
-
-    async execute<T = unknown>(querySlug: string, options: AnalyticsRequest = {}): Promise<AnalyticsResponse<T>> {
-        const url = AnalyticsRoutes.baseUrl(this.config.appSlug, querySlug)
-
-        const body = {
-            params: options.params || {}
-        }
-
-        return await this.client.httpClient.post<AnalyticsResponse<T>>(url, body)
-    }
-}

package/src/lib/analytics/types.ts

@@ -1,8 +0,0 @@
-import type { TaruviResponse } from "../../types.js"
-
-export interface AnalyticsRequest {
-    params?: Record<string, unknown>
-}
-
-// Response type - uses standard wrapper
-export type AnalyticsResponse<T = unknown> = TaruviResponse<T>

package/src/lib/app/AppClient.ts

@@ -1,54 +0,0 @@
-import type { Client } from "../../client.js";
-import { AppRoutes, type AppRouteKey } from "../../lib-internal/routes/AppRoutes.js";
-import { HttpMethod } from "../../lib-internal/http/types.js";
-import type { TaruviConfig } from "../../types.js";
-import type { UrlParams } from "./types.js";
-
-export class App {
-    private client: Client
-    private urlParams: UrlParams
-    private config: TaruviConfig
-    private operation: HttpMethod | undefined
-
-    constructor(client: Client, urlParams: UrlParams = {}, operation?: HttpMethod | undefined) {
-        this.client = client
-        this.urlParams = urlParams
-        this.operation = operation
-        this.config = this.client.getConfig()
-    }
-
-    roles() {
-        return new App(this.client, { ...this.urlParams, roles: "roles" }, HttpMethod.GET)
-    }
-
-    settings() {
-        return new App(this.client, {...this.urlParams, settings: "settings"}, HttpMethod.GET)
-    }
-
-    private buildRoute(): string {
-        return (
-            AppRoutes.baseUrl(this.config.appSlug) +
-            (Object.keys(this.urlParams) as AppRouteKey[]).reduce((acc, key) => {
-                const value = this.urlParams[key]
-                const routeBuilder = AppRoutes[key]
-
-                if (value && routeBuilder) {
-                    acc += routeBuilder()
-                }
-
-                return acc
-            }, "")
-        )
-    }
-
-    async execute() {
-        const url = this.buildRoute()
-        const operation = this.operation || HttpMethod.GET
-
-        switch (operation) {
-            case HttpMethod.GET:
-            default:
-                return await this.client.httpClient.get(url)
-        }
-    }
-}

package/src/lib/app/types.ts

@@ -1,50 +0,0 @@
-import type { Client } from "../../client.js"
-import { HttpMethod } from "../../lib-internal/http/types.js"
-import type { TaruviResponse } from "../../types.js"
-
-export type AppOperation = HttpMethod
-
-// Internal types
-export interface UrlParams {
-    appSlug?: string
-    roles?: string
-    settings?: string
-}
-
-export interface AppClientInterface {
-    client: Client
-    urlParams?: UrlParams
-}
-
-// Role data
-export interface RoleData {
-    id: string | number
-    name: string
-    slug: string
-    description?: string
-    permissions?: string[]
-    created_at?: string
-    updated_at?: string
-}
-
-// App settings data
-export interface AppSettingsData {
-    display_name: string
-    icon: string | null
-    icon_url: string | null
-    primary_color: string
-    secondary_color: string
-    banner_image: string | null
-    banner_image_url: string | null
-    category: string
-    documentation_url: string | null
-    support_email: string | null
-    default_frontend_worker_url: string | null
-    created_at: string
-    updated_at: string
-}
-
-// Response types - uses standard wrapper
-export type RoleResponse = TaruviResponse<RoleData>
-export type RolesListResponse = TaruviResponse<RoleData[]>
-export type AppSettingsResponse = TaruviResponse<AppSettingsData>

package/src/lib/auth/AuthClient.ts

@@ -1,126 +0,0 @@
-import type { Client } from "../../client.js";
-import type { TaruviResponse } from "../../types.js";
-import type { UserData } from "../users/types.js";
-import { UserRoutes } from "../../lib-internal/routes/UserRoutes.js";
-
-/**
- * Auth Client - Handles user authentication using Web UI Flow
- * Uses session token for API authentication via X-Session-Token header.
- * On 401/403, tokens are cleared automatically by HttpClient interceptor.
- */
-export class Auth {
-    private client: Client
-
-    constructor(client: Client) {
-        this.client = client
-    }
-
-    /**
-     * Redirect to login page (Web UI Flow)
-     */
-    login(callbackUrl?: string): void {
-        if (typeof window === "undefined") {
-            console.error("login() can only be called in browser environment")
-            return
-        }
-
-        const config = this.client.getConfig()
-        const callback = callbackUrl || window.location.origin + window.location.pathname
-        const deskUrl = config.deskUrl || config.apiUrl
-        const loginUrl = `${deskUrl}/accounts/login/?redirect_to=${encodeURIComponent(callback)}`
-
-        if (typeof sessionStorage !== "undefined") {
-            sessionStorage.setItem("auth_state", JSON.stringify({
-                returnTo: window.location.pathname,
-                timestamp: Date.now()
-            }))
-        }
-
-        window.location.href = loginUrl
-    }
-
-    /**
-     * Redirect to signup page (Web UI Flow)
-     */
-    signup(callbackUrl?: string): void {
-        if (typeof window === "undefined") {
-            console.error("signup() can only be called in browser environment")
-            return
-        }
-
-        const config = this.client.getConfig()
-        const callback = callbackUrl || window.location.origin + window.location.pathname
-        const signupUrl = `${config.apiUrl}/accounts/signup/?redirect_to=${encodeURIComponent(callback)}`
-
-        if (typeof sessionStorage !== "undefined") {
-            sessionStorage.setItem("auth_state", JSON.stringify({
-                returnTo: window.location.pathname,
-                timestamp: Date.now()
-            }))
-        }
-
-        window.location.href = signupUrl
-    }
-
-    /**
-     * Logout user and redirect to logout page
-     */
-    async logout(callbackUrl?: string): Promise<void> {
-        if (typeof window === "undefined") {
-            console.error("logout() can only be called in browser environment")
-            return
-        }
-
-        this.client.tokenClient.clearTokens()
-
-        const config = this.client.getConfig()
-        const deskUrl = config.deskUrl || config.apiUrl
-        let callback: string = callbackUrl || ""
-
-        if (!callback) {
-            try {
-                const settings = await this.client.httpClient.get<{ frontend_url?: string }>(
-                    `api/sites/${config.appSlug}/metadata`
-                )
-                callback = settings.frontend_url || window.location.origin
-            } catch (error) {
-                console.error("Failed to fetch site settings, using origin:", error)
-                callback = window.location.origin
-            }
-        }
-
-        const logoutUrl = `${deskUrl}/accounts/logout/?redirect_to=${encodeURIComponent(callback)}`
-        window.location.href = logoutUrl
-    }
-
-    /**
-     * Check if user is authenticated (has session token)
-     */
-    isUserAuthenticated(): boolean {
-        return this.client.tokenClient.isAuthenticated()
-    }
-
-    /**
-     * Get the current session token
-     */
-    getSessionToken(): string | null {
-        return this.client.tokenClient.getSessionToken()
-    }
-
-    /**
-     * Get current user from API
-     * @returns Promise with user data or null if not authenticated
-     */
-    async getCurrentUser(): Promise<TaruviResponse<UserData> | null> {
-        if (!this.isUserAuthenticated()) {
-            return null
-        }
-
-        try {
-            return await this.client.httpClient.get<TaruviResponse<UserData>>(UserRoutes.getCurrentUser())
-        } catch (error) {
-            console.error("Failed to fetch current user:", error)
-            return null
-        }
-    }
-}

package/src/lib/auth/types.ts

@@ -1,123 +0,0 @@
-export interface UserCreateRequest {
-    // Required fields
-    username: string
-    email: string
-    first_name: string
-    last_name: string
-    password: string
-    confirm_password: string
-    // Optional fields
-    is_active?: boolean
-    is_staff?: boolean
-    attributes?: string
-}
-
-export interface UserCreateResponse {
-    id: string
-    username: string
-    email: string
-    first_name: string
-    last_name: string
-    full_name: string
-    is_active: boolean
-    is_superuser: boolean
-    is_deleted: boolean
-    date_joined: string
-    last_login: string
-    groups: UserGroup[]
-    user_permissions: UserPermission[]
-    attributes: Record<string, unknown>
-    missing_attributes: string[]
-    roles: UserRole[]
-    icon_url: string | null
-}
-
-export interface UserGroup {
-    id: number
-    name: string
-}
-
-export interface UserPermission {
-    id: number
-    name: string
-    codename: string
-    content_type: string // "app_label.model"
-}
-
-export interface UserRole {
-    name: string
-    slug: string
-    type: "app_role"
-    app_slug: string
-    source: "direct" | "site_role" | "inherited"
-}
-
-export interface UserDataResponse {
-    id: string
-    username: string
-    email: string
-    first_name: string
-    last_name: string
-    full_name: string
-    is_active: boolean
-    is_superuser: boolean
-    is_deleted: boolean
-    date_joined: string
-    last_login: string
-    groups: UserGroup[]
-    user_permissions: UserPermission[]
-    attributes: Record<string, unknown>
-    missing_attributes: string[]
-    roles: UserRole[]
-    icon_url: string | null
-}
-
-export interface UserUpdateRequest {
-    username?: string
-    email?: string
-    first_name?: string
-    last_name?: string
-    is_active?: boolean
-    is_staff?: boolean
-}
-
-export interface UserUpdateResponse {
-    id: string
-    username: string
-    email: string
-    first_name: string
-    last_name: string
-    full_name: string
-    is_active: boolean
-    is_superuser: boolean
-    is_deleted: boolean
-    date_joined: string
-    last_login: string
-    groups: UserGroup[]
-    user_permissions: UserPermission[]
-    attributes: Record<string, unknown>
-    missing_attributes: string[]
-    roles: UserRole[]
-    icon_url: string | null
-}
-
-export interface UserList {
-    search: string
-    is_active: boolean
-    is_staff: boolean
-    is_superuser: boolean
-    is_deleted: boolean
-    ordering: string
-    page: Number
-    page_size: Number
-}
-
-export interface UserApp {
-    name: string
-    slug: string
-    icon: string
-    url: string
-    display_name: string
-}
-
-export type UserAppsResponse = UserApp[]