@taruvi/sdk 1.5.0 → 1.5.1-beta.4

package/.kiro/settings/lsp.json

@@ -1,198 +0,0 @@
-{
-  "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

@@ -1,81 +0,0 @@
-# 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

@@ -1,106 +0,0 @@
-# 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/USAGE_EXAMPLE.md

@@ -1,86 +0,0 @@
-# Taruvi SDK - Usage Example
-
-## New Pattern: Dependency Injection (No Singleton)
-
-### Basic Usage
-
-```typescript
-import { Client, Auth, User, Database } from '@taruvi/sdk'
-
-// 1. Create the main client (can create multiple instances)
-const client = new Client({
-  apiKey: 'your-site-key',
-  appSlug: 'my-app',
-  baseUrl: 'https://api.taruvi.com',
-  token: 'optional-initial-token' // optional
-})
-
-// 2. Create only the clients you need (lazy initialization)
-const auth = new Auth(client)
-const user = new User(client)
-const database = new Database(client)
-
-// 3. Use the clients
-if (auth.isUserAuthenticated()) {
-  console.log('User is authenticated')
-}
-
-const token = auth.signInWithSSO()
-console.log('Token:', token)
-
-const userDetails = user.getUser()
-console.log('User:', userDetails)
-
-// Access token via User
-console.log('Current token:', user.token)
-```
-
-### Multiple Instances
-
-You can now create multiple instances for different environments or configs:
-
-```typescript
-const prodClient = new Client({
-  apiKey: 'prod-key',
-    appSlug: 'main-app',
-  baseUrl: 'https://api.taruvi.com'
-})
-
-const devClient = new Client({
-  apiKey: 'dev-key',
-    appSlug: 'dev-app',
-  baseUrl: 'https://dev-api.taruvi.com'
-})
-
-const prodAuth = new Auth(prodClient)
-const devAuth = new Auth(devClient)
-```
-
-### Benefits
-
-✅ **No singleton** - Multiple instances possible
-✅ **Lazy initialization** - Only create clients you need
-✅ **Better testability** - Easy to mock and test
-✅ **Explicit dependencies** - Clear what each client needs
-✅ **No global state** - No hidden global `taruvi` variable
-✅ **Tree-shakable** - Only bundle what you use
-
-### Internal Architecture
-
-The `taruvi` variable is no longer exported. Internal clients like `httpClient` and `tokenClient` are accessible only within the SDK through the `Client` instance passed to each client.
-
-```typescript
-// Inside Auth
-export class Auth {
-  private client: Client
-
-  constructor(client: Client) {
-    this.client = client
-  }
-
-  isUserAuthenticated(): boolean {
-    // Access internal tokenClient through the client instance
-    return !!this.client.tokenClient.getToken()
-  }
-}
-```

package/src/index.ts

@@ -1,50 +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 } 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>