@taruvi/sdk 1.0.0

package/src/lib/user/UserClient.ts

@@ -0,0 +1,44 @@
+import type { Client } from "../../client.js";
+import type { UserCreateRequest, UserCreateResponse, UserDataResponse, UserList, UserUpdateRequest } from "./types.js";
+import { UserRoutes } from "../../lib-internal/routes/UserRoutes.js";
+import { buildQueryString } from "../../utils/utils.js";
+
+
+export class User {
+    private client: Client
+
+    constructor(client: Client) {
+        this.client = client
+    }
+    
+    // - getUserProfile
+    async getUserData(): Promise<UserDataResponse> {
+        return await this.client.httpClient.get<UserDataResponse>(UserRoutes.getCurrentUser())
+    }
+
+    // - updateUser
+    async updateUser(username: string, body: UserUpdateRequest): Promise<UserCreateResponse> {
+        return await this.client.httpClient.put(UserRoutes.updateUser(username), body)
+    }
+
+    async list(filters: UserList) {
+        const queryString = buildQueryString(filters as unknown as Record<string, unknown>)
+        return await this.client.httpClient.get(UserRoutes.listUser(queryString))
+    }
+
+    // - createUser
+    async createUser(userData: UserCreateRequest): Promise<UserCreateResponse> {
+        return await this.client.httpClient.post<UserCreateResponse, UserCreateRequest>(
+            UserRoutes.baseUrl,
+            userData
+        )
+    }
+
+    // - deleteUser
+    async deleteUser(username: string): Promise<void> {
+        return await this.client.httpClient.delete(UserRoutes.deleteUser(username))
+    }
+
+    // TODO: Implement user management methods
+    // - token getter (access JWT token)
+}

package/src/lib/user/types.ts

@@ -0,0 +1,69 @@
+export interface UserCreateRequest {
+    username: string,
+    email: string,
+    password: string,
+    confirm_password: string,
+    first_name: string,
+    last_name: string,
+    is_active: boolean,
+    is_staff: boolean,
+    attributes: string
+}
+
+export interface UserCreateResponse {
+    username: string,
+    email: string,
+    first_name: string,
+    last_name: string,
+    is_active: boolean,
+    is_staff: boolean,
+    attributes: string
+}
+
+export interface UserDataResponse {
+    id: number,
+    username: string,
+    email: string,
+    first_name: string,
+    last_name: string,
+    full_name: string,
+    is_active: boolean,
+    is_staff: boolean,
+    is_deleted: boolean,
+    date_joined: string, // ISO 8601 date-time string
+    last_login: string, // ISO 8601 date-time string
+    attributes: string
+}
+
+export interface UserUpdateRequest {
+    username?: string,
+    email?: string,
+    password?: string,
+    confirm_password?: string,
+    first_name?: string,
+    last_name?: string,
+    is_active?: boolean,
+    is_staff?: boolean,
+    attributes?: string
+}
+
+export interface UserUpdateResponse {
+    username: string,
+    email: string,
+    first_name: string,
+    last_name: string,
+    is_active: boolean,
+    is_staff: boolean,
+    attributes: string
+}
+
+export interface UserList {
+    search: string
+    is_active: boolean
+    is_staff: boolean
+    is_superuser: boolean
+    is_deleted: boolean
+    ordering: string
+    page: Number
+    page_size: Number
+}

package/src/lib-internal/errors/ErrorClient.ts

@@ -0,0 +1,12 @@
+export class ErrorClient {
+
+    constructor() {
+        // No dependencies needed for now
+    }
+
+    // TODO: Implement error handling
+    // - handleError
+    // - logError
+    // - formatError
+    // - Custom error classes (AuthError, NetworkError, etc.)
+}

package/src/lib-internal/errors/index.ts

@@ -0,0 +1,25 @@
+/**
+ * Error handling module exports
+ *
+ * This module provides comprehensive error handling for the Taruvi SDK
+ * including typed error classes, error codes, and utility functions.
+ */
+
+// Export error client
+export { ErrorClient } from './ErrorClient.js';
+
+// TODO: Export all error classes when implemented
+// - TaruviError
+// - AuthError
+// - DatabaseError
+// - StorageError
+// - NetworkError
+// - ValidationError
+// - FunctionError
+
+// TODO: Export types when implemented
+// - ErrorCode
+// - ErrorSeverity
+// - ErrorResponse
+// - HttpErrorResponse
+// - ValidationErrorDetail

package/src/lib-internal/errors/types.ts

@@ -0,0 +1,105 @@
+/**
+ * Error severity levels for categorizing errors
+ */
+export enum ErrorSeverity {
+    LOW = 'low',
+    MEDIUM = 'medium',
+    HIGH = 'high',
+    CRITICAL = 'critical'
+}
+
+/**
+ * Standard error codes used across the SDK
+ */
+export enum ErrorCode {
+    // General errors (1000-1099)
+    UNKNOWN_ERROR = 'UNKNOWN_ERROR',
+    INTERNAL_ERROR = 'INTERNAL_ERROR',
+    TIMEOUT_ERROR = 'TIMEOUT_ERROR',
+
+    // Network errors (1100-1199)
+    NETWORK_ERROR = 'NETWORK_ERROR',
+    CONNECTION_ERROR = 'CONNECTION_ERROR',
+    REQUEST_FAILED = 'REQUEST_FAILED',
+
+    // Authentication errors (1200-1299)
+    AUTH_ERROR = 'AUTH_ERROR',
+    UNAUTHORIZED = 'UNAUTHORIZED',
+    TOKEN_EXPIRED = 'TOKEN_EXPIRED',
+    TOKEN_INVALID = 'TOKEN_INVALID',
+    SESSION_EXPIRED = 'SESSION_EXPIRED',
+    INVALID_CREDENTIALS = 'INVALID_CREDENTIALS',
+
+    // Authorization errors (1300-1399)
+    FORBIDDEN = 'FORBIDDEN',
+    INSUFFICIENT_PERMISSIONS = 'INSUFFICIENT_PERMISSIONS',
+
+    // Validation errors (1400-1499)
+    VALIDATION_ERROR = 'VALIDATION_ERROR',
+    INVALID_INPUT = 'INVALID_INPUT',
+    MISSING_REQUIRED_FIELD = 'MISSING_REQUIRED_FIELD',
+    INVALID_FORMAT = 'INVALID_FORMAT',
+
+    // Database errors (1500-1599)
+    DATABASE_ERROR = 'DATABASE_ERROR',
+    QUERY_FAILED = 'QUERY_FAILED',
+    RECORD_NOT_FOUND = 'RECORD_NOT_FOUND',
+    DUPLICATE_ENTRY = 'DUPLICATE_ENTRY',
+    CONSTRAINT_VIOLATION = 'CONSTRAINT_VIOLATION',
+
+    // Storage errors (1600-1699)
+    STORAGE_ERROR = 'STORAGE_ERROR',
+    FILE_NOT_FOUND = 'FILE_NOT_FOUND',
+    FILE_TOO_LARGE = 'FILE_TOO_LARGE',
+    INVALID_FILE_TYPE = 'INVALID_FILE_TYPE',
+    UPLOAD_FAILED = 'UPLOAD_FAILED',
+    DOWNLOAD_FAILED = 'DOWNLOAD_FAILED',
+
+    // Function errors (1700-1799)
+    FUNCTION_ERROR = 'FUNCTION_ERROR',
+    FUNCTION_NOT_FOUND = 'FUNCTION_NOT_FOUND',
+    FUNCTION_EXECUTION_FAILED = 'FUNCTION_EXECUTION_FAILED',
+    FUNCTION_TIMEOUT = 'FUNCTION_TIMEOUT',
+
+    // Rate limiting errors (1800-1899)
+    RATE_LIMIT_EXCEEDED = 'RATE_LIMIT_EXCEEDED',
+    QUOTA_EXCEEDED = 'QUOTA_EXCEEDED',
+
+    // Client errors (1900-1999)
+    CONFIGURATION_ERROR = 'CONFIGURATION_ERROR',
+    INVALID_API_KEY = 'INVALID_API_KEY',
+    INVALID_CONFIG = 'INVALID_CONFIG'
+}
+
+/**
+ * Base error response structure
+ */
+export interface ErrorResponse {
+    code: ErrorCode;
+    message: string;
+    severity: ErrorSeverity;
+    timestamp: string;
+    requestId?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    cause?: Error | undefined;
+}
+
+/**
+ * HTTP error response from the server
+ */
+export interface HttpErrorResponse {
+    status: number;
+    statusText: string;
+    message?: string;
+    code?: string;
+    details?: any;
+}
+
+/**
+ * Validation error details
+ */
+export interface ValidationErrorDetail {
+    field: string;
+    message: string;
+    value?: any;
+}

package/src/lib-internal/http/HttpClient.ts

@@ -0,0 +1,96 @@
+import type { TaruviConfig } from "../../types.js";
+import type { TokenClient } from "../token/TokenClient.js";
+import axios from "axios";
+
+/**
+ * HttpClient handles all HTTP requests to the Taruvi API.
+ * Automatically adds authentication headers:
+ * - Authorization: API key for site/app identification
+ * - X-Session-Token: User session token for authenticated requests
+ *
+ * @internal
+ */
+export class HttpClient {
+    private config: TaruviConfig
+    private tokenClient: TokenClient
+
+    constructor(config: TaruviConfig, tokenClient: TokenClient) {
+        this.config = config
+        this.tokenClient = tokenClient
+    }
+
+    private getAuthHeaders(isFormData: boolean = false): Record<string, string> {
+        const headers: Record<string, string> = {}
+
+        // Don't set Content-Type for FormData - let axios set it with the boundary
+        if (!isFormData) {
+            headers['Content-Type'] = 'application/json'
+        }
+
+        // Site/app API key (developer authentication)
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Token ${this.config.apiKey}`
+        }
+
+        // Tenant admin session token
+        const jwt = this.tokenClient.getToken()
+        if (jwt) {
+            headers['Authorization'] = `Bearer ${jwt}`
+        }
+
+        return headers
+    }
+
+    async get<T>(endpoint: string) {
+        const { data } = await axios.get(`${this.config.baseUrl}/${endpoint}`, {
+            headers: this.getAuthHeaders()
+        })
+        return data
+    }
+
+    async post<T, D = any>(endpoint: string, body: D): Promise<T> {
+        const isFormData = body instanceof FormData
+        const { data } = await axios.post<T>(
+            `${this.config.baseUrl}/${endpoint}`,
+            body,
+            {
+                headers: this.getAuthHeaders(isFormData)
+            }
+        )
+        return data
+    }
+
+    async put<T, D = any>(endpoint: string, body: D) {
+        const isFormData = body instanceof FormData
+        const { data } = await axios.put<T>(`${this.config.baseUrl}/${endpoint}`,
+            body,
+            {
+                headers: this.getAuthHeaders(isFormData)
+            })
+
+        return data
+    }
+
+    async delete<T, D = any>(endpoint: string, body?: D): Promise<T> {
+        const { data } = await axios.delete<T>(
+            `${this.config.baseUrl}/${endpoint}`,
+            {
+                headers: this.getAuthHeaders(),
+                data: body
+            }
+        )
+        return data
+    }
+
+    async patch<T, D = any>(endpoint: string, body: D): Promise<T> {
+        const isFormData = body instanceof FormData
+        const { data } = await axios.patch<T>(
+            `${this.config.baseUrl}/${endpoint}`,
+            body,
+            {
+                headers: this.getAuthHeaders(isFormData)
+            }
+        )
+        return data
+    }
+}

package/src/lib-internal/http/types.ts

@@ -0,0 +1,10 @@
+/**
+ * HTTP methods supported by the HttpClient
+ */
+export enum HttpMethod {
+    GET = 'GET',
+    POST = 'POST',
+    PUT = 'PUT',
+    PATCH = 'PATCH',
+    DELETE = 'DELETE'
+}

package/src/lib-internal/routes/DatabaseRoutes.ts

@@ -0,0 +1,5 @@
+export const DatabaseRoutes = {
+    baseUrl: (appSlug: string) => `api/apps/${appSlug}`,
+    dataTables: (tableName: string): string => `/datatables/${tableName}/data`,
+    recordId: (recordId: string): string => `/${recordId}`
+}

package/src/lib-internal/routes/FunctionRoutes.ts

@@ -0,0 +1,3 @@
+export const FunctionRoutes = {
+    baseUrl: (appSlug: string, functionSlug: string) => `api/functions/apps/${appSlug}/functions/${functionSlug}`
+}

package/src/lib-internal/routes/SecretsRoutes.ts

@@ -0,0 +1,5 @@
+export const SecretsRoutes = {
+    baseUrl: "api/secrets/",
+    get: (key: string) => `api/secrets/${key}/`,
+    update: (key: string) => `api/secrets/${key}/`
+}

package/src/lib-internal/routes/SettingsRoutes.ts

@@ -0,0 +1,3 @@
+export const SettingsRoutes = {
+    metadata: "api/settings/metadata/"
+}

package/src/lib-internal/routes/StorageRoutes.ts

@@ -0,0 +1,7 @@
+export const StorageRoutes = {
+    baseUrl: (appslug: string, bucket: string) => `api/apps/${appslug}/storage/buckets/${bucket}/objects`,
+    path: (path: string) => "/" + path,
+    upload: () => "/batch-upload",
+    delete: () => "/batch-delete"
+    // bucket: (appslug: string, bucketslug: string) => `${StorageRoutesClone.baseUrl(appslug)}/${bucketslug}`
+}

package/src/lib-internal/routes/UserRoutes.ts

@@ -0,0 +1,9 @@
+import type { UserList } from "../../lib/user/types.js";
+
+export const UserRoutes = {
+    baseUrl: "api/users/",
+    getCurrentUser: () => `${UserRoutes.baseUrl}me/`,
+    updateUser: (username: string) => `${UserRoutes.baseUrl}${username}/`,
+    deleteUser: (username: string) => `${UserRoutes.baseUrl}${username}/`,
+    listUser: (filter: string) => `${UserRoutes.baseUrl}${filter}`
+} as const

package/src/lib-internal/token/TokenClient.ts

@@ -0,0 +1,30 @@
+import { getRuntimeEnvironment } from "../../utils/utils.js"
+
+export class TokenClient {
+    // private tenantAdminToken: string | null = null
+    private runTimeEnvironment: string
+    private browserRunTime: boolean
+    // private adminSessionToken: string | null
+
+    constructor(token?: string) {
+        this.runTimeEnvironment = getRuntimeEnvironment()
+        this.browserRunTime = this.runTimeEnvironment == "Browser"
+        // this.adminSessionToken = this.getToken()
+    }
+
+    getToken(): string | null {
+        if (this.browserRunTime) {
+            // return localStorage.getItem("")
+            return localStorage.getItem("jwt")
+        }
+        return null
+        // return this.tenantAdminToken
+    }
+
+    // TODO: Implement token management
+    // - setToken
+    // - getToken
+    // - refreshToken
+    // - clearToken
+    // - isTokenExpired
+}

package/src/types.ts

@@ -0,0 +1,68 @@
+import { MimeTypeCategory, Visibility } from './utils/enums.js'
+
+export interface TaruviConfig {
+    apiKey: string      // Identifies which site the client belongs to
+    appSlug: string     // Identifies which app the client belongs to
+    baseUrl: string
+    deskUrl?: string    // URL for the desk/login page
+    token?: string      // Optional: Pre-existing auth token
+}
+
+export interface StorageFilters {
+    // Pagination (DRF style)
+    page?: number
+    pageSize?: number
+
+    // Range Filters - Size (in bytes)
+    size__gte?: number
+    size__lte?: number
+    size__gt?: number
+    size__lt?: number
+    min_size?: number
+    max_size?: number
+
+    // Range Filters - Dates (ISO 8601)
+    created_at__gte?: string
+    created_at__lte?: string
+    created_after?: string
+    created_before?: string
+    updated_at__gte?: string
+    updated_at__lte?: string
+
+    // Search Filters
+    search?: string
+    filename__icontains?: string
+    prefix?: string
+    file?: string
+    file__icontains?: string
+    file__startswith?: string
+    file__istartswith?: string
+    metadata_search?: string
+
+    // MIME Type Filters
+    mimetype?: string
+    mimetype__in?: string
+    mimetype_category?: MimeTypeCategory
+
+    // Visibility & User Filters
+    visibility?: Visibility
+    created_by_me?: boolean
+    modified_by_me?: boolean
+    created_by__username?: string
+    created_by__username__icontains?: string
+
+    // Sorting
+    ordering?: string
+}
+
+export interface DatabaseFilters {
+    // Pagination (DRF style)
+    page?: number
+    pageSize?: number
+
+    // Sorting (DRF style: "-field" for desc, "field" for asc)
+    ordering?: string
+
+    // Dynamic filters - allows any field with operators
+    [key: string]: string | number | boolean | undefined
+}

package/src/utils/enums.ts

@@ -0,0 +1,12 @@
+export enum MimeTypeCategory {
+    IMAGE = 'image',
+    VIDEO = 'video',
+    AUDIO = 'audio',
+    APPLICATION = 'application',
+    TEXT = 'text'
+}
+
+export enum Visibility {
+    PUBLIC = 'public',
+    PRIVATE = 'private'
+}

package/src/utils/utils.ts

@@ -0,0 +1,36 @@
+const _window = typeof window !== 'undefined' ? window : undefined
+const _global = typeof global !== 'undefined' ? global : undefined
+const _process = typeof process !== 'undefined' ? process : undefined
+const _navigator = typeof navigator !== 'undefined' ? navigator : undefined
+const _document = typeof document !== 'undefined' ? document : undefined
+const _self = typeof self !== 'undefined' ? self : undefined
+
+export const isBrowser = (): boolean => {
+    return _window !== undefined && _document !== undefined
+}
+
+export const isReactNative = (): boolean => {
+    return _navigator !== undefined &&
+        // @ts-ignore - navigator.product is deprecated but still used in RN detection
+        _navigator.product === 'ReactNative'
+}
+
+export const getRuntimeEnvironment = (): string => {
+    if (isBrowser()) return 'Browser'
+    if (isReactNative()) return 'ReactNative'
+    return 'Server'
+}
+
+export function buildQueryString(filters: Record<string, unknown> | undefined): string {
+    if (!filters || Object.keys(filters).length === 0) {
+        return ''
+    }
+    const params = new URLSearchParams()
+    Object.entries(filters).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+            params.append(key, String(value))
+        }
+    })
+    const queryString = params.toString()
+    return queryString ? `?${queryString}` : ''
+}

package/tests/mocks/db.json

@@ -0,0 +1 @@
+{}

package/tsconfig.json

@@ -0,0 +1,43 @@
+{
+  // Visit https://aka.ms/tsconfig to read more about this file
+  "compilerOptions": {
+    // File Layout
+    "rootDir": "./src",
+    "outDir": "./dist",
+
+    // Environment Settings
+    // See also https://aka.ms/tsconfig/module
+    "module": "nodenext",
+    "target": "esnext",
+    "lib": ["esnext", "dom"],
+    "types": ["node"],
+
+    // Other Outputs
+    "sourceMap": true,
+    "declaration": true,
+    "declarationMap": true,
+
+    // Stricter Typechecking Options
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+
+    // Style Options
+    // "noImplicitReturns": true,
+    // "noImplicitOverride": true,
+    // "noUnusedLocals": true,
+    // "noUnusedParameters": true,
+    // "noFallthroughCasesInSwitch": true,
+    // "noPropertyAccessFromIndexSignature": true,
+
+    // Recommended Options
+    "strict": true,
+    "jsx": "react-jsx",
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "noUncheckedSideEffectImports": true,
+    "moduleDetection": "force",
+    "skipLibCheck": true,
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "taruvi-platform", "tests"]
+}