@taruvi/sdk 1.2.0 → 1.2.2

package/.claude/settings.local.json

@@ -8,7 +8,10 @@
       "Bash(npx --yes markdownlint-cli:*)",
       "Bash(cat:*)",
       "Bash(test:*)",
-      "Bash(ls:*)"
+      "Bash(ls:*)",
+      "WebFetch(domain:www.markdownpaste.com)",
+      "WebSearch",
+      "WebFetch(domain:supabase.com)"
     ],
     "deny": [],
     "ask": []

package/README.md

@@ -564,7 +564,6 @@ const storage = new Storage(taruviClient)
 await storage
   .from("documents")
   .update("path/to/file.pdf", {
-    filename: "newname.pdf",
     visibility: "public",
     metadata: { category: "reports" }
   })
@@ -893,14 +892,7 @@ console.log(secret) // Secret object with value
 const secrets = new Secrets(taruviClient)
 
 await secrets.update("MY_SECRET", {
-  value: {
-    hostname: "db.example.com",
-    port_number: 3306,
-    username: "admin",
-    password: "secret123"
-  },
-  tags: ["mysql", "production"],
-  secret_type: "Mysql"
+  value: "my-secret-value"
 }).execute()
 ```
 
@@ -1162,7 +1154,8 @@ const userData: UserCreateRequest = {
   first_name: "John",
   last_name: "Doe",
   is_active: true,
-  is_staff: false
+  is_staff: false,
+  attributes: ""
 }
 
 // Database filters with operators
@@ -1325,4 +1318,4 @@ const client = new Client({
 
 ---
 
-**Generated from production code examples • Last updated: 2026-01-05**
+**Generated from production code examples • Last updated: 2026-01-12**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taruvi/sdk",
-  "version": "1.2.0",
+  "version": "1.2.02",
   "description": "Taruvi SDK",
   "main": "src/index.ts",
   "type": "module",

package/src/index.ts

@@ -20,7 +20,7 @@ export type { UserCreateRequest, UserCreateResponse as UserResponse, UserDataRes
 export type { Principal, Resource, Resources } from "./lib/Policy/types.js"
 export type { RoleResponse } from "./lib/App/types.js"
 export type { FunctionRequest, FunctionResponse, FunctionInvocation } from "./lib/Function/types.js"
-export type { DatabaseRequest, DatabaseResponse } from "./lib/Database/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"

package/src/lib/Database/DatabaseClient.ts

@@ -2,11 +2,11 @@ import type { Client } from "../../client.js";
 import { DatabaseRoutes, type DatabaseRouteKey } from "../../lib-internal/routes/DatabaseRoutes.js";
 import { HttpMethod } from "../../lib-internal/http/types.js";
 import type { TaruviConfig, DatabaseFilters } from "../../types.js";
-import type { UrlParams } from "./types.js";
+import type { UrlParams, FilterOperator, SortOrder } from "./types.js";
 import { buildQueryString } from "../../utils/utils.js";
 
 // Used to access app data
-export class Database {
+export class Database<T = Record<string, unknown>> {
     private client: Client
     private urlParams: UrlParams
     private config: TaruviConfig
@@ -21,35 +21,83 @@ export class Database {
         this.body = body
         this.config = this.client.getConfig()
         this.queryParams = queryParams
-    }       
+    }
+
+    from<U = Record<string, unknown>>(dataTables: string): Database<U> {
+        return new Database<U>(this.client, { ...this.urlParams, dataTables }, undefined, undefined)
+    }
+
+    filter(field: string, operator: FilterOperator, value: string | number | boolean | (string | number)[]): Database<T> {
+        const filterKey = operator === 'eq' ? field : `${field}__${operator}`
+        // For 'in' and 'nin' operators, join array values with comma
+        const filterValue = Array.isArray(value) ? value.join(',') : value
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            [filterKey]: filterValue
+        })
+    }
+
+    sort(field: string, order: SortOrder = 'asc'): Database<T> {
+        const ordering = order === 'desc' ? `-${field}` : field
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            ordering
+        })
+    }
+
+    pageSize(size: number): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            page_size: size
+        })
+    }
+
+    page(num: number): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            page: num
+        })
+    }
 
-    from(dataTables: string): Database {
-        return new Database(this.client, { ...this.urlParams, dataTables }, undefined, undefined)
+    populate(populate: string[]): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            populate: populate.join(',')
+        })
     }
 
-    filter(filters: DatabaseFilters): Database {
-        return new Database(this.client, { ...this.urlParams }, undefined, undefined, {...this.queryParams, ...filters})
+    get(recordId: string): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams, recordId }, HttpMethod.GET)
     }
 
-    populate(populate: string[]): Database {
-        return new Database(this.client, { ...this.urlParams, }, undefined, undefined, {...this.queryParams, populate: populate.join(',')})
+    create(body: Partial<T> | Partial<T>[]): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, HttpMethod.POST, body as object)
     }
 
-    get(recordId: string): Database {
-        return new Database(this.client, this.urlParams = { ...this.urlParams, recordId }, HttpMethod.GET)
+    update(body: Partial<T> | Partial<T>[]): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, HttpMethod.PATCH, body as object)
     }
 
-    create(body: any): Database {
-        return new Database(this.client, this.urlParams = { ...this.urlParams }, HttpMethod.POST, body)
+    delete(recordId: string): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams, recordId }, HttpMethod.DELETE)
     }
 
-    update(body: any): Database {
-        return new Database(this.client, this.urlParams = { ...this.urlParams }, HttpMethod.PATCH, body)
+    async first(): Promise<T | null> {
+        const results = await this.execute()
+        if (Array.isArray(results)) {
+            return results[0] ?? null
+        }
+        return results ?? null
     }
 
-    delete(recordId?: any): Database {
-        return new Database(this.client, this.urlParams = { ...this.urlParams, recordId }, HttpMethod.DELETE)
+    async count(): Promise<number> {
+        const results = await this.execute()
+        if (Array.isArray(results)) {
+            return results.length
+        }
+        return 0
     }
+
     private buildRoute(): string {
         return (
             DatabaseRoutes.baseUrl(this.config.appSlug) +
@@ -68,7 +116,7 @@ export class Database {
         )
     }
 
-    async execute() {
+    async execute(): Promise<T | T[]> {
         // Build the API URL
         const url = this.buildRoute()
 
@@ -93,10 +141,3 @@ export class Database {
         }
     }
 }
-
-
-// TODO: Implement storage operations
-// - upload files
-// - download files
-// - delete files
-// - list files

package/src/lib/Database/types.ts

@@ -3,6 +3,26 @@ import { HttpMethod } from "../../lib-internal/http/types.js"
 
 export type DatabaseOperation = HttpMethod
 
+// Filter operators matching Python SDK
+export type FilterOperator =
+    | 'eq'           // Equal
+    | 'ne'           // Not equal
+    | 'gt'           // Greater than
+    | 'gte'          // Greater than or equal
+    | 'lt'           // Less than
+    | 'lte'          // Less than or equal
+    | 'in'           // In array
+    | 'nin'          // Not in array
+    | 'contains'     // String contains (case-sensitive)
+    | 'icontains'    // String contains (case-insensitive)
+    | 'startswith'   // String starts with (case-sensitive)
+    | 'istartswith'  // String starts with (case-insensitive)
+    | 'endswith'     // String ends with (case-sensitive)
+    | 'iendswith'    // String ends with (case-insensitive)
+    | 'isnull'       // Is null
+
+export type SortOrder = 'asc' | 'desc'
+
 // Internal types
 export interface UrlParams {
     appSlug?: string

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

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

package/src/types.ts

@@ -11,7 +11,7 @@ export interface TaruviConfig {
 export interface StorageFilters {
     // Pagination (DRF style)
     page?: number
-    pageSize?: number
+    page_size?: number
 
     // Range Filters - Size (in bytes)
     size__gte?: number
@@ -58,11 +58,14 @@ export interface StorageFilters {
 export interface DatabaseFilters {
     // Pagination (DRF style)
     page?: number
-    pageSize?: number
+    page_size?: number
 
     // Sorting (DRF style: "-field" for desc, "field" for asc)
     ordering?: string
 
+    // Populate relations
+    populate?: string
+
     // Dynamic filters - allows any field with operators
     [key: string]: string | number | boolean | undefined
 }