@taruvi/sdk 1.3.3 → 1.3.4

package/.claude/settings.local.json

@@ -0,0 +1,19 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tree:*)",
+      "Bash(npm run build:*)",
+      "Bash(npm ls:*)",
+      "Bash(npm link:*)",
+      "Bash(npx --yes markdownlint-cli:*)",
+      "Bash(cat:*)",
+      "Bash(test:*)",
+      "Bash(ls:*)",
+      "WebFetch(domain:www.markdownpaste.com)",
+      "WebSearch",
+      "WebFetch(domain:supabase.com)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

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/USAGE_EXAMPLE.md

@@ -0,0 +1,86 @@
+# 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/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@taruvi/sdk",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Taruvi SDK",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "src/index.ts",
   "type": "module",
-  "files": ["dist"],
+  "sideEffects": false,
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "taruvi",
@@ -19,9 +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"
   }
 }
-
-