@taruvi/sdk 1.3.2 → 1.3.4-beta.0

package/.kiro/settings/lsp.json

@@ -0,0 +1,198 @@
+{
+  "languages": {
+    "java": {
+      "name": "jdtls",
+      "command": "jdtls",
+      "args": [],
+      "file_extensions": [
+        "java"
+      ],
+      "project_patterns": [
+        "pom.xml",
+        "build.gradle",
+        "build.gradle.kts",
+        ".project"
+      ],
+      "exclude_patterns": [
+        "**/target/**",
+        "**/build/**",
+        "**/.gradle/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "settings": {
+          "java": {
+            "compile": {
+              "nullAnalysis": {
+                "mode": "automatic"
+              }
+            },
+            "configuration": {
+              "annotationProcessing": {
+                "enabled": true
+              }
+            }
+          }
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "cpp": {
+      "name": "clangd",
+      "command": "clangd",
+      "args": [
+        "--background-index"
+      ],
+      "file_extensions": [
+        "cpp",
+        "cc",
+        "cxx",
+        "c",
+        "h",
+        "hpp",
+        "hxx"
+      ],
+      "project_patterns": [
+        "CMakeLists.txt",
+        "compile_commands.json",
+        "Makefile"
+      ],
+      "exclude_patterns": [
+        "**/build/**",
+        "**/cmake-build-**/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    },
+    "go": {
+      "name": "gopls",
+      "command": "gopls",
+      "args": [],
+      "file_extensions": [
+        "go"
+      ],
+      "project_patterns": [
+        "go.mod",
+        "go.sum"
+      ],
+      "exclude_patterns": [
+        "**/vendor/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "usePlaceholders": true,
+        "completeUnimported": true
+      },
+      "request_timeout_secs": 60
+    },
+    "python": {
+      "name": "pyright",
+      "command": "pyright-langserver",
+      "args": [
+        "--stdio"
+      ],
+      "file_extensions": [
+        "py"
+      ],
+      "project_patterns": [
+        "pyproject.toml",
+        "setup.py",
+        "requirements.txt",
+        "pyrightconfig.json"
+      ],
+      "exclude_patterns": [
+        "**/__pycache__/**",
+        "**/venv/**",
+        "**/.venv/**",
+        "**/.pytest_cache/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    },
+    "rust": {
+      "name": "rust-analyzer",
+      "command": "rust-analyzer",
+      "args": [],
+      "file_extensions": [
+        "rs"
+      ],
+      "project_patterns": [
+        "Cargo.toml"
+      ],
+      "exclude_patterns": [
+        "**/target/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "cargo": {
+          "buildScripts": {
+            "enable": true
+          }
+        },
+        "diagnostics": {
+          "enable": true,
+          "enableExperimental": true
+        },
+        "workspace": {
+          "symbol": {
+            "search": {
+              "scope": "workspace"
+            }
+          }
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "typescript": {
+      "name": "typescript-language-server",
+      "command": "typescript-language-server",
+      "args": [
+        "--stdio"
+      ],
+      "file_extensions": [
+        "ts",
+        "js",
+        "tsx",
+        "jsx"
+      ],
+      "project_patterns": [
+        "package.json",
+        "tsconfig.json"
+      ],
+      "exclude_patterns": [
+        "**/node_modules/**",
+        "**/dist/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "preferences": {
+          "disableSuggestions": false
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "ruby": {
+      "name": "solargraph",
+      "command": "solargraph",
+      "args": [
+        "stdio"
+      ],
+      "file_extensions": [
+        "rb"
+      ],
+      "project_patterns": [
+        "Gemfile",
+        "Rakefile"
+      ],
+      "exclude_patterns": [
+        "**/vendor/**",
+        "**/tmp/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    }
+  }
+}

package/MODULE_NAMING_CHANGES.md

@@ -0,0 +1,81 @@
+# Module Naming Convention Changes - Completed
+
+**Date**: 2026-01-22  
+**Status**: ✅ Completed
+
+## Changes Made
+
+### Folder Renaming
+
+All module folders in `src/lib/` have been renamed to lowercase and pluralized where appropriate:
+
+| Old Name | New Name | Change Type |
+|----------|----------|-------------|
+| `Analytics/` | `analytics/` | Lowercase |
+| `App/` | `app/` | Lowercase |
+| `auth/` | `auth/` | ✓ Already correct |
+| `Database/` | `database/` | Lowercase |
+| `Function/` | `functions/` | Lowercase + Plural |
+| `Policy/` | `policy/` | Lowercase |
+| `Secrets/` | `secrets/` | Lowercase |
+| `Settings/` | `settings/` | Lowercase |
+| `Storage/` | `storage/` | Lowercase |
+| `user/` | `users/` | Plural |
+
+### Files Updated
+
+1. **src/index.ts** - Updated all import paths to reflect new folder names
+
+### Build Status
+
+✅ TypeScript compilation successful  
+✅ No errors or warnings
+
+## Benefits
+
+1. **Consistency** - All module folders now follow lowercase naming
+2. **Alignment** - Matches Python SDK naming conventions
+3. **Clarity** - Plural names (`users`, `functions`) match REST conventions
+4. **Maintainability** - Easier to navigate and understand structure
+
+## Next Steps
+
+As per the SDK Alignment Analysis, the next priorities are:
+
+1. ✅ **Module naming** - COMPLETED
+2. ⏭️ Add direct CRUD methods to Database module
+3. ⏭️ Remove `.execute()` requirement from Storage
+4. ⏭️ Add missing methods to Functions module
+5. ⏭️ Implement AuthManager pattern
+
+## Breaking Changes
+
+⚠️ **This is a breaking change for existing users**
+
+Users will need to update their imports:
+
+```typescript
+// Old imports (will break)
+import { User } from '@taruvi/sdk'
+import { Functions } from '@taruvi/sdk'
+
+// New imports (correct)
+import { User } from '@taruvi/sdk'  // Still works - export name unchanged
+import { Functions } from '@taruvi/sdk'  // Still works - export name unchanged
+```
+
+**Note**: The exported class names remain unchanged (`User`, `Functions`, etc.), only the internal folder structure changed. This means existing code will continue to work without modifications.
+
+## Verification
+
+```bash
+# Build successful
+npm run build
+# ✓ No errors
+
+# Folder structure
+ls src/lib/
+# analytics  app  auth  database  functions  policy  secrets  settings  storage  users
+```
+
+All folders now follow consistent lowercase naming conventions! 🎉

package/PARAMETER_NAMING_CHANGES.md

@@ -0,0 +1,106 @@
+# Parameter Naming Change: baseUrl → apiUrl
+
+**Date**: 2026-01-22  
+**Status**: ✅ Completed
+
+## Changes Made
+
+### Type Definitions
+
+**File**: `src/types.ts`
+- Changed `baseUrl: string` → `apiUrl: string`
+- Updated comment: "Base API URL"
+
+### Client Constructor
+
+**File**: `src/client.ts`
+- Updated validation: `config.baseUrl` → `config.apiUrl`
+- Updated error message: "Base URL is required" → "API URL is required"
+
+### HTTP Client
+
+**File**: `src/lib-internal/http/HttpClient.ts`
+- Updated all HTTP methods to use `config.apiUrl` instead of `config.baseUrl`:
+  - `get()` method
+  - `post()` method
+  - `put()` method
+  - `delete()` method
+  - `patch()` method
+
+### Auth Client
+
+**File**: `src/lib/auth/AuthClient.ts`
+- Updated `login()`: `config.deskUrl || config.baseUrl` → `config.deskUrl || config.apiUrl`
+- Updated `signup()`: `config.baseUrl` → `config.apiUrl`
+- Updated `logout()`: `config.deskUrl || config.baseUrl` → `config.deskUrl || config.apiUrl`
+- Updated `refreshAccessToken()`: `config.baseUrl` → `config.apiUrl`
+
+### Documentation
+
+**File**: `README.md`
+- Updated all examples: `baseUrl:` → `apiUrl:`
+- Updated environment variable: `VITE_TARUVI_BASE_URL` → `VITE_TARUVI_API_URL`
+
+## Build Status
+
+✅ TypeScript compilation successful  
+✅ No errors or warnings
+
+## Alignment with Python SDK
+
+This change aligns the JavaScript SDK with the Python SDK naming convention:
+
+**Python SDK**:
+```python
+client = Client(
+    api_url="https://api.taruvi.cloud",
+    app_slug="my-app"
+)
+```
+
+**JavaScript SDK** (now aligned):
+```typescript
+const client = new Client({
+    apiUrl: "https://api.taruvi.cloud",
+    appSlug: "my-app",
+    apiKey: "your-api-key"
+})
+```
+
+## Breaking Change
+
+⚠️ **This is a breaking change**
+
+Users must update their configuration:
+
+```typescript
+// ❌ Old (will break)
+const client = new Client({
+    baseUrl: "https://api.taruvi.cloud",
+    appSlug: "my-app",
+    apiKey: "key"
+})
+
+// ✅ New (correct)
+const client = new Client({
+    apiUrl: "https://api.taruvi.cloud",
+    appSlug: "my-app",
+    apiKey: "key"
+})
+```
+
+## Migration Guide
+
+1. Find all `baseUrl` references in your code
+2. Replace with `apiUrl`
+3. Update environment variables: `VITE_TARUVI_BASE_URL` → `VITE_TARUVI_API_URL`
+
+## Next Steps
+
+As per the SDK Alignment Analysis:
+
+1. ✅ Module naming - COMPLETED
+2. ✅ Parameter naming (baseUrl → apiUrl) - COMPLETED
+3. ⏭️ Add direct CRUD methods to Database module
+4. ⏭️ Remove `.execute()` requirement from Storage
+5. ⏭️ Add missing methods to Functions module

package/README.md

@@ -32,7 +32,7 @@ import { Client } from '@taruvi/sdk'
 const taruviClient = new Client({
   apiKey: "your-site-api-key",
   appSlug: "your-app-slug", 
-  baseUrl: "https://taruvi-site.taruvi.cloud"
+  apiUrl: "https://taruvi-site.taruvi.cloud"
 })
 ```
 
@@ -1141,7 +1141,7 @@ import type {
 const config: TaruviConfig = {
   apiKey: "key",
   appSlug: "app",
-  baseUrl: "https://api.taruvi.cloud",
+  apiUrl: "https://api.taruvi.cloud",
   deskUrl: "https://desk.taruvi.cloud", // optional
   token: "existing-token" // optional
 }
@@ -1305,14 +1305,14 @@ await storage.from("bucket").download("path/to/file.pdf").execute()
 ```env
 VITE_TARUVI_API_KEY=your-api-key
 VITE_TARUVI_APP_SLUG=your-app
-VITE_TARUVI_BASE_URL=https://taruvi-site.taruvi.cloud
+VITE_TARUVI_API_URL=https://taruvi-site.taruvi.cloud
 ```
 
 ```typescript
 const client = new Client({
   apiKey: import.meta.env.VITE_TARUVI_API_KEY,
   appSlug: import.meta.env.VITE_TARUVI_APP_SLUG,
-  baseUrl: import.meta.env.VITE_TARUVI_BASE_URL
+  apiUrl: import.meta.env.VITE_TARUVI_API_URL
 })
 ```
 

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@taruvi/sdk",
-  "version": "1.3.2",
+  "version": "1.3.4-beta.0",
   "description": "Taruvi SDK",
   "main": "src/index.ts",
   "type": "module",
+  "sideEffects": false,
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "taruvi",
@@ -16,7 +19,10 @@
   "license": "MIT",
   "peerDependencies": {
     "@types/node": ">=18 <25",
-    "typescript": ">=5.7 <6",
-    "axios": ">=1 <2"
+    "axios": ">=1 <2",
+    "typescript": ">=5.7 <6"
+  },
+  "devDependencies": {
+    "vitest": "^4.0.18"
   }
 }

package/src/client.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from "./lib-internal/http/HttpClient.js";
-import { TokenClient } from "./lib-internal/token/TokenClient.js";
+import { TokenClient, type AuthTokens } from "./lib-internal/token/TokenClient.js";
 import type { TaruviConfig } from "./types.js";
 
 export class Client {
@@ -16,8 +16,8 @@ export class Client {
             throw new Error("API key is required")
         }
 
-        if (!config.baseUrl) {
-            throw new Error("Base URL is required")
+        if (!config.apiUrl) {
+            throw new Error("API URL is required")
         }
 
         this.config = config
@@ -62,7 +62,7 @@ export class Client {
         }
 
         // Store tokens using TokenClient
-        const tokens: any = {
+        const tokens: AuthTokens = {
             accessToken,
             refreshToken,
             tokenType: tokenType || "Bearer"

package/src/index.ts

@@ -1,41 +1,54 @@
 // Export main client
 export { Client } from "./client.js"
 
+// Export error classes
+export { TaruviError, ValidationError, AuthError, ForbiddenError, NotFoundError, ConflictError, TimeoutError, NetworkError } 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/user/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/Function/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 { Graph } from "./lib/Graphs/GraphClient.js"
-
-// Export types
-export type { TaruviConfig, StorageFilters, DatabaseFilters } from "./types.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 { Graph } from "./lib/graphs/GraphClient.js"
+
+// Export core types
+export type { TaruviConfig, TaruviResponse, PaginationInfo, StorageFilters, DatabaseFilters } from "./types.js"
 export type { AuthTokens } from "./lib-internal/token/TokenClient.js"
-export type {
-  UserCreateRequest,
-  UserCreateResponse as UserResponse,
-  UserDataResponse as TaruviUser,
-  UserUpdateRequest,
-  UserUpdateResponse,
-  UserGroup,
-  UserPermission,
-  UserRole,
-  UserList,
-  UserApp,
-  UserAppsResponse
-} from "./lib/user/types.js"
-export type { Principal, Resource, Resources } from "./lib/Policy/types.js"
-export type { RoleResponse, SettingsResponse as AppSettingsResponse } from "./lib/App/types.js"
-export type { FunctionRequest, FunctionResponse, FunctionInvocation } from "./lib/Function/types.js"
-export type { DatabaseRequest, DatabaseResponse, FilterOperator, SortOrder } from "./lib/Database/types.js"
-export type { StorageRequest, StorageUpdateRequest, StorageResponse } from "./lib/Storage/types.js"
-export type { SettingsResponse } from "./lib/Settings/types.js"
-export type { SecretRequest, SecretResponse } from "./lib/Secrets/types.js"
-export type { AnalyticsRequest, AnalyticsResponse } from "./lib/Analytics/types.js"
-export type { GraphInclude, GraphFormat, GraphQueryParams, EdgeRequest, EdgeResponse } from "./lib/Graphs/types.js"
+
+// User types
+export type { UserCreateRequest, UserData, UserUpdateRequest, UserListFilters, UserApp, UserResponse, UserListResponse, UserAppsResponse, AssignRolesRequest, RevokeRolesRequest, RolesResponse, UserGroup, UserPermission, UserRole } from "./lib/users/types.js"
+
+// Policy types
+export type { Principal, Resource, Resources, PolicyCheckResult, PolicyCheckBatchResult, ResourceCheckResponse } 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 } 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"
+
+// Graph types
+export type { GraphInclude, GraphFormat, GraphQueryParams, EdgeRequest, EdgeResponse, EdgeDeleteRequest } from "./lib/graphs/types.js"

package/src/lib/analytics/types.ts

@@ -0,0 +1,8 @@
+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 → app}/types.ts

@@ -1,5 +1,6 @@
 import type { Client } from "../../client.js"
 import { HttpMethod } from "../../lib-internal/http/types.js"
+import type { TaruviResponse } from "../../types.js"
 
 export type AppOperation = HttpMethod
 
@@ -15,17 +16,19 @@ export interface AppClientInterface {
     urlParams?: UrlParams
 }
 
-// Response types
-export interface RoleResponse {
-    id?: string | number
-    name?: string
+// Role data
+export interface RoleData {
+    id: string | number
+    name: string
+    slug: string
+    description?: string
     permissions?: string[]
     created_at?: string
     updated_at?: string
-    [key: string]: unknown
 }
 
-export interface SettingsResponse {
+// App settings data
+export interface AppSettingsData {
     display_name: string
     icon: string | null
     icon_url: string | null
@@ -40,3 +43,8 @@ export interface SettingsResponse {
     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,5 +1,6 @@
 import type { Client } from "../../client.js";
-import type { UserDataResponse } from "../user/types.js";
+import type { TaruviResponse } from "../../types.js";
+import type { UserData } from "../users/types.js";
 import { UserRoutes } from "../../lib-internal/routes/UserRoutes.js";
 
 /**
@@ -31,7 +32,7 @@ export class Auth {
 
         const config = this.client.getConfig()
         const callback = callbackUrl || window.location.origin + window.location.pathname
-        const deskUrl = config.deskUrl || config.baseUrl
+        const deskUrl = config.deskUrl || config.apiUrl
 
         // Redirect to /accounts/login/ with redirect_to parameter
         const loginUrl = `${deskUrl}/accounts/login/?redirect_to=${encodeURIComponent(callback)}`
@@ -61,7 +62,7 @@ export class Auth {
         const callback = callbackUrl || window.location.origin + window.location.pathname
 
         // Redirect to /accounts/signup/ with redirect_to parameter
-        const signupUrl = `${config.baseUrl}/accounts/signup/?redirect_to=${encodeURIComponent(callback)}`
+        const signupUrl = `${config.apiUrl}/accounts/signup/?redirect_to=${encodeURIComponent(callback)}`
 
         // Optional: Store state before redirecting
         if (typeof sessionStorage !== "undefined") {
@@ -89,7 +90,7 @@ export class Auth {
         this.client.tokenClient.clearTokens()
 
         const config = this.client.getConfig()
-        const deskUrl = config.deskUrl || config.baseUrl
+        const deskUrl = config.deskUrl || config.apiUrl
         let callback: string = callbackUrl || ""
 
         // If no callback provided, fetch frontendUrl from site settings
@@ -156,7 +157,7 @@ export class Auth {
 
         try {
             const config = this.client.getConfig()
-            const response = await fetch(`${config.baseUrl}/api/cloud/auth/jwt/token/refresh/`, {
+            const response = await fetch(`${config.apiUrl}/api/cloud/auth/jwt/token/refresh/`, {
                 method: "POST",
                 headers: { "Content-Type": "application/json" },
                 body: JSON.stringify({ refresh: refreshToken })
@@ -198,13 +199,13 @@ export class Auth {
      * Get current user from API
      * @returns Promise with user data or null if not authenticated
      */
-    async getCurrentUser(): Promise<UserDataResponse | null> {
+    async getCurrentUser(): Promise<TaruviResponse<UserData> | null> {
         if (!this.isUserAuthenticated()) {
             return null
         }
 
         try {
-            return await this.client.httpClient.get<UserDataResponse>(UserRoutes.getCurrentUser())
+            return await this.client.httpClient.get<TaruviResponse<UserData>>(UserRoutes.getCurrentUser())
         } catch (error) {
             console.error("Failed to fetch current user:", error)
             return null