@taruvi/sdk 1.3.7-beta.0 → 1.3.8-beta.0

package/package.json

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

package/src/index.ts

@@ -24,7 +24,7 @@ export type { TaruviConfig, TaruviResponse, PaginationInfo, StorageFilters, Data
 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 } from "./lib/users/types.js"
+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 } from "./lib/policy/types.js"

package/src/lib/auth/types.ts

@@ -13,17 +13,23 @@ export interface UserCreateRequest {
 }
 
 export interface UserCreateResponse {
-    id: number
-    uuid: string
+    id: string
     username: string
     email: string
     first_name: string
     last_name: string
+    full_name: string
     is_active: boolean
-    is_staff: boolean
     is_superuser: boolean
     is_deleted: boolean
     date_joined: string
+    last_login: string
+    groups: UserGroup[]
+    user_permissions: UserPermission[]
+    attributes: Record<string, unknown>
+    missing_attributes: string[]
+    roles: UserRole[]
+    icon_url: string | null
 }
 
 export interface UserGroup {
@@ -47,23 +53,23 @@ export interface UserRole {
 }
 
 export interface UserDataResponse {
-    id: number
+    id: string
     username: string
     email: string
     first_name: string
     last_name: string
     full_name: string
     is_active: boolean
-    is_staff: boolean
     is_superuser: boolean
     is_deleted: boolean
-    date_joined: string // ISO 8601 date-time string
-    last_login: string // ISO 8601 date-time string
+    date_joined: string
+    last_login: string
     groups: UserGroup[]
     user_permissions: UserPermission[]
     attributes: Record<string, unknown>
     missing_attributes: string[]
     roles: UserRole[]
+    icon_url: string | null
 }
 
 export interface UserUpdateRequest {
@@ -76,17 +82,23 @@ export interface UserUpdateRequest {
 }
 
 export interface UserUpdateResponse {
-    id: number
-    uuid: string
+    id: string
     username: string
     email: string
     first_name: string
     last_name: string
+    full_name: string
     is_active: boolean
-    is_staff: boolean
     is_superuser: boolean
     is_deleted: boolean
     date_joined: string
+    last_login: string
+    groups: UserGroup[]
+    user_permissions: UserPermission[]
+    attributes: Record<string, unknown>
+    missing_attributes: string[]
+    roles: UserRole[]
+    icon_url: string | null
 }
 
 export interface UserList {

package/src/lib/database/DatabaseClient.ts

@@ -66,6 +66,34 @@ export class Database<T = Record<string, unknown>> {
         })
     }
 
+    search(query: string): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            search: query
+        })
+    }
+
+    aggregate(...expressions: string[]): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            _aggregate: expressions.join(',')
+        })
+    }
+
+    groupBy(...fields: string[]): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            _group_by: fields.join(',')
+        })
+    }
+
+    having(condition: string): Database<T> {
+        return new Database<T>(this.client, { ...this.urlParams }, undefined, undefined, {
+            ...this.queryParams,
+            _having: condition
+        })
+    }
+
     get(recordId: string): Database<T> {
         return new Database<T>(this.client, { ...this.urlParams, recordId }, HttpMethod.GET)
     }

package/src/lib/database/types.ts

@@ -4,23 +4,43 @@ import type { TaruviResponse } from "../../types.js"
 
 export type DatabaseOperation = HttpMethod
 
-// Filter operators matching Python SDK
+// Filter operators matching backend FilterParams.OPERATORS (32 operators)
 export type FilterOperator =
+    // Comparison
     | 'eq'           // Equal
     | 'ne'           // Not equal
     | 'gt'           // Greater than
     | 'gte'          // Greater than or equal
     | 'lt'           // Less than
     | 'lte'          // Less than or equal
+    // IN operators
     | '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
+    | 'ina'          // In array (case-insensitive)
+    | 'nina'         // Not in array (case-insensitive)
+    // String contains
+    | 'contains'     // Contains (case-sensitive)
+    | 'ncontains'    // Not contains (case-sensitive)
+    | 'containss'    // Contains (case-sensitive, strict)
+    | 'ncontainss'   // Not contains (case-sensitive, strict)
+    | 'icontains'    // Contains (case-insensitive)
+    | 'nicontains'   // Not contains (case-insensitive)
+    // Starts with
+    | 'startswith'   // Starts with (case-sensitive)
+    | 'nstartswith'  // Not starts with (case-sensitive)
+    | 'startswiths'  // Starts with (case-sensitive, strict)
+    | 'nstartswiths' // Not starts with (case-sensitive, strict)
+    // Ends with
+    | 'endswith'     // Ends with (case-sensitive)
+    | 'nendswith'    // Not ends with (case-sensitive)
+    | 'endswiths'    // Ends with (case-sensitive, strict)
+    | 'nendswiths'   // Not ends with (case-sensitive, strict)
+    // Range
+    | 'between'      // Between two values
+    | 'nbetween'     // Not between two values
+    // Null checks
+    | 'null'         // Is null
+    | 'nnull'        // Is not null
 
 export type SortOrder = 'asc' | 'desc'
 

package/src/lib/functions/types.ts

@@ -9,7 +9,9 @@ export interface FunctionInvocation {
     function: number
     function_name: string
     function_slug: string
+    user_id: string | null
     user_username: string
+    user_email: string
     task_status: string
     trigger_type: string
     created_at: string

package/src/lib/settings/SettingsClient.ts

@@ -11,4 +11,12 @@ export class Settings {
     async get<T = unknown>(): Promise<T> {
         return await this.client.httpClient.get<T>(SettingsRoutes.metadata)
     }
+
+    async getUserAttributes<T = unknown>(): Promise<T> {
+        return await this.client.httpClient.get<T>(SettingsRoutes.userAttributes)
+    }
+
+    async updateUserAttributes<T = unknown>(schema: Record<string, unknown>): Promise<T> {
+        return await this.client.httpClient.post<T>(SettingsRoutes.userAttributes, schema)
+    }
 }

package/src/lib/storage/types.ts

@@ -43,8 +43,8 @@ export interface StorageObject {
     visibility?: string
     created_at: string
     updated_at: string
-    created_by?: number
-    modified_by?: number
+    created_by?: string
+    modified_by?: string
 }
 
 // Response types - uses standard wrapper

package/src/lib/users/UserClient.ts

@@ -1,5 +1,5 @@
 import type { Client } from "../../client.js";
-import type { UserCreateRequest, UserResponse, UserListResponse, UserListFilters, UserUpdateRequest, UserAppsResponse, AssignRolesRequest, RevokeRolesRequest, RolesResponse } from "./types.js";
+import type { UserCreateRequest, UserResponse, UserListResponse, UserListFilters, UserUpdateRequest, UserAppsResponse, AssignRolesRequest, RevokeRolesRequest, RolesResponse, UserPreferencesResponse, UserPreferencesUpdate } from "./types.js";
 import { UserRoutes } from "../../lib-internal/routes/UserRoutes.js";
 import { buildQueryString } from "../../utils/utils.js";
 
@@ -52,4 +52,12 @@ export class User {
             request
         )
     }
+
+    async getPreferences(): Promise<UserPreferencesResponse> {
+        return await this.client.httpClient.get<UserPreferencesResponse>(UserRoutes.preferences())
+    }
+
+    async updatePreferences(body: UserPreferencesUpdate): Promise<UserPreferencesResponse> {
+        return await this.client.httpClient.put<UserPreferencesResponse>(UserRoutes.preferences(), body)
+    }
 }

package/src/lib/users/types.ts

@@ -88,6 +88,24 @@ export type UserResponse = TaruviResponse<UserData>
 export type UserListResponse = TaruviResponse<UserData[]>
 export type UserAppsResponse = TaruviResponse<UserApp[]>
 
+export interface UserPreferences {
+    date_format: string
+    time_format: string
+    timezone: string
+    theme: string
+    widget_config: Record<string, unknown>
+}
+
+export interface UserPreferencesUpdate {
+    date_format?: string
+    time_format?: string
+    timezone?: string
+    theme?: string
+    widget_config?: Record<string, unknown>
+}
+
+export type UserPreferencesResponse = TaruviResponse<UserPreferences>
+
 export interface AssignRolesRequest {
     roles: string[]
     usernames: string[]

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

@@ -6,7 +6,7 @@ export const GraphRoutes = {
 
 export const GraphEdgeRoutes = {
     baseUrl: (appSlug: string) => `api/apps/${appSlug}`,
-    edges: (tableName: string): string => `/datatables/${tableName}/edges`,
+    edges: (tableName: string): string => `/datatables/${tableName}_edges/data`,
     edgeId: (edgeId: string): string => `/${edgeId}`
 }
 

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

@@ -1,3 +1,4 @@
 export const SettingsRoutes = {
-    metadata: "api/settings/metadata/"
+    metadata: "api/settings/metadata/",
+    userAttributes: "api/settings/user-attributes/"
 }

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

@@ -1,6 +1,7 @@
 export const UserRoutes = {
     baseUrl: "api/users/",
     getCurrentUser: () => `${UserRoutes.baseUrl}me/`,
+    preferences: () => `${UserRoutes.baseUrl}me/preferences/`,
     getUser: (username: string) => `${UserRoutes.baseUrl}${username}/`,
     updateUser: (username: string) => `${UserRoutes.baseUrl}${username}/`,
     deleteUser: (username: string) => `${UserRoutes.baseUrl}${username}/`,

package/src/types.ts

@@ -85,6 +85,14 @@ export interface DatabaseFilters {
     // Populate relations
     populate?: string
 
+    // Search (translates to search_vector__search on backend)
+    search?: string
+
+    // Aggregates
+    _aggregate?: string
+    _group_by?: string
+    _having?: string
+
     // Dynamic filters - allows any field with operators
     [key: string]: string | number | boolean | undefined
 }

package/tests/unit/edge-cases/robustness.test.ts

@@ -254,6 +254,6 @@ describe('Builder immutability', () => {
         await edge.execute()
 
         expect(mockHttpClient.get.mock.calls[0][0]).toContain('/data/1/')
-        expect(mockHttpClient.post.mock.calls[0][0]).toContain('/edges/')
+        expect(mockHttpClient.post.mock.calls[0][0]).toContain('_edges/data/')
     })
 })

package/tests/unit/graphs/GraphClient.test.ts

@@ -126,7 +126,7 @@ describe('Graph', () => {
         it('list() calls GET on edges route', async () => {
             mockHttpClient.get.mockResolvedValue({ edges: [], total: 0 })
             await new Graph(mockClient).from('employees').list().execute()
-            expect(mockHttpClient.get).toHaveBeenCalledWith('api/apps/test-app/datatables/employees/edges/')
+            expect(mockHttpClient.get).toHaveBeenCalledWith('api/apps/test-app/datatables/employees_edges/data/')
         })
 
         it('create() calls POST with array of edges', async () => {
@@ -137,7 +137,7 @@ describe('Graph', () => {
             mockHttpClient.post.mockResolvedValue({ status: 'success', data: edges, total: 2 })
             await new Graph(mockClient).from('employees').create(edges).execute()
             expect(mockHttpClient.post).toHaveBeenCalledWith(
-                'api/apps/test-app/datatables/employees/edges/',
+                'api/apps/test-app/datatables/employees_edges/data/',
                 edges
             )
         })
@@ -147,7 +147,7 @@ describe('Graph', () => {
             mockHttpClient.post.mockResolvedValue({ status: 'success', data: edges, total: 1 })
             await new Graph(mockClient).from('employees').create(edges).execute()
             expect(mockHttpClient.post).toHaveBeenCalledWith(
-                'api/apps/test-app/datatables/employees/edges/',
+                'api/apps/test-app/datatables/employees_edges/data/',
                 edges
             )
         })
@@ -157,7 +157,7 @@ describe('Graph', () => {
             mockHttpClient.patch.mockResolvedValue({ id: 9, ...edge })
             await new Graph(mockClient).from('employees').update('9', edge).execute()
             expect(mockHttpClient.patch).toHaveBeenCalledWith(
-                'api/apps/test-app/datatables/employees/edges/9/',
+                'api/apps/test-app/datatables/employees_edges/data/9/',
                 edge
             )
         })
@@ -166,7 +166,7 @@ describe('Graph', () => {
             mockHttpClient.delete.mockResolvedValue({ deleted: 2 })
             await new Graph(mockClient).from('employees').delete([9, 10]).execute()
             expect(mockHttpClient.delete).toHaveBeenCalledWith(
-                'api/apps/test-app/datatables/employees/edges/',
+                'api/apps/test-app/datatables/employees_edges/data/',
                 { edge_ids: [9, 10] }
             )
         })