@boltic/sdk 0.0.7 → 0.0.8

package/dist/databases/{test-client-rQ1AmTo6.mjs → test-client-D8i2zDgI.mjs}

@@ -1,3 +1,9 @@
+function isErrorResponse(response) {
+  return "error" in response && response.error !== void 0;
+}
+function isListResponse(response) {
+  return "pagination" in response;
+}
 class ValidationError extends Error {
   constructor(message, failures = []) {
     super(message);
@@ -150,6 +156,39 @@ class AxiosAdapter {
         // Don't throw on non-2xx status codes
       };
       const response = await this.axios(axiosConfig);
+      if (response.status < 200 || response.status >= 300) {
+        const isHtmlError = typeof response.data === "string" && response.data.trim().startsWith("<!DOCTYPE") || typeof response.data === "string" && response.data.includes("<html");
+        if (isHtmlError) {
+          const htmlContent = response.data;
+          const preMatch = htmlContent.match(/<pre>(.*?)<\/pre>/s);
+          const errorMessage = preMatch ? preMatch[1].trim() : `HTTP ${response.status}: ${response.statusText}`;
+          throw createErrorWithContext(errorMessage, {
+            url: config.url,
+            method: config.method,
+            status: response.status,
+            statusText: response.statusText,
+            isHtmlError: true
+          });
+        }
+        if (response.data && typeof response.data === "object" && "error" in response.data) {
+          return {
+            data: response.data,
+            status: response.status,
+            statusText: response.statusText,
+            headers: response.headers || {}
+          };
+        }
+        throw createErrorWithContext(
+          `HTTP ${response.status}: ${response.statusText}`,
+          {
+            url: config.url,
+            method: config.method,
+            status: response.status,
+            statusText: response.statusText,
+            responseData: response.data
+          }
+        );
+      }
       return {
         data: response.data,
         status: response.status,
@@ -248,6 +287,39 @@ class FetchAdapter {
       response.headers.forEach((value, key) => {
         headers[key] = value;
       });
+      if (response.status < 200 || response.status >= 300) {
+        const isHtmlError = typeof data === "string" && (data.trim().startsWith("<!DOCTYPE") || data.includes("<html"));
+        if (isHtmlError) {
+          const htmlContent = data;
+          const preMatch = htmlContent.match(/<pre>(.*?)<\/pre>/s);
+          const errorMessage = preMatch ? preMatch[1].trim() : `HTTP ${response.status}: ${response.statusText}`;
+          throw createErrorWithContext(errorMessage, {
+            url: config.url,
+            method: config.method,
+            status: response.status,
+            statusText: response.statusText,
+            isHtmlError: true
+          });
+        }
+        if (data && typeof data === "object" && "error" in data) {
+          return {
+            data,
+            status: response.status,
+            statusText: response.statusText,
+            headers
+          };
+        }
+        throw createErrorWithContext(
+          `HTTP ${response.status}: ${response.statusText}`,
+          {
+            url: config.url,
+            method: config.method,
+            status: response.status,
+            statusText: response.statusText,
+            responseData: data
+          }
+        );
+      }
       const httpResponse = {
         data,
         status: response.status,
@@ -579,6 +651,13 @@ function filterArrayFields(arr, fields) {
   }
   return arr.map((obj) => filterObjectFields(obj, fields));
 }
+function addDbIdToUrl(url, dbId) {
+  if (!dbId || dbId === "") {
+    return url;
+  }
+  const separator = url.includes("?") ? "&" : "?";
+  return `${url}${separator}db_id=${encodeURIComponent(dbId)}`;
+}
 const COLUMN_ENDPOINTS = {
   list: {
     path: "/tables/{table_id}/fields/list",
@@ -812,7 +891,8 @@ class ColumnsApiClient {
   async listColumns(tableId, options = {}) {
     try {
       const endpoint = COLUMN_ENDPOINTS.list;
-      const url = `${this.baseURL}${buildEndpointPath$1(endpoint, { table_id: tableId })}?no_cache=true`;
+      let url = `${this.baseURL}${buildEndpointPath$1(endpoint, { table_id: tableId })}?no_cache=true`;
+      url = addDbIdToUrl(url, options.db_id);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -1442,7 +1522,8 @@ class TablesApiClient {
   async createTable(request, options = {}) {
     try {
       const endpoint = TABLE_ENDPOINTS.create;
-      const url = `${this.baseURL}${endpoint.path}`;
+      let url = `${this.baseURL}${endpoint.path}`;
+      url = addDbIdToUrl(url, options.db_id);
       const transformedRequest = transformTableCreateRequest(request, options);
       const response = await this.httpAdapter.request({
         url,
@@ -1462,7 +1543,8 @@ class TablesApiClient {
   async listTables(options = {}) {
     try {
       const endpoint = TABLE_ENDPOINTS.list;
-      const url = `${this.baseURL}${endpoint.path}`;
+      let url = `${this.baseURL}${endpoint.path}`;
+      url = addDbIdToUrl(url, options.db_id);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -1488,7 +1570,8 @@ class TablesApiClient {
   async getTable(tableId, options = {}) {
     try {
       const endpoint = TABLE_ENDPOINTS.get;
-      const url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, options.db_id);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -1512,9 +1595,10 @@ class TablesApiClient {
    */
   async updateTable(tableId, updates) {
     try {
-      const { fields, ...updateData } = updates;
+      const { fields, db_id, ...updateData } = updates;
       const endpoint = TABLE_ENDPOINTS.update;
-      const url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, db_id);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -1537,10 +1621,11 @@ class TablesApiClient {
   /**
    * Delete a table
    */
-  async deleteTable(tableId) {
+  async deleteTable(tableId, options = {}) {
     try {
       const endpoint = TABLE_ENDPOINTS.delete;
-      const url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, options.db_id);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -1596,12 +1681,6 @@ class TablesApiClient {
     };
   }
 }
-function isErrorResponse(response) {
-  return "error" in response && response.error !== void 0;
-}
-function isListResponse(response) {
-  return "pagination" in response;
-}
 class BaseResource {
   constructor(client, basePath) {
     this.client = client;
@@ -1703,13 +1782,16 @@ class TableResource extends BaseResource {
   /**
    * Create a new table
    */
-  async create(data) {
+  async create(data, dbId) {
     try {
       const processedData = { ...data };
       if (data.fields && data.fields.length > 0) {
         processedData.fields = await this.processFieldsDefaults(data.fields);
       }
-      const result = await this.tablesApiClient.createTable(processedData);
+      const result = await this.tablesApiClient.createTable(
+        processedData,
+        dbId ? { db_id: dbId } : {}
+      );
       if (isErrorResponse(result)) {
         throw new ApiError(
           result.error.message || "Create table failed",
@@ -1792,12 +1874,14 @@ class TableResource extends BaseResource {
   /**
    * Find all tables with optional filtering
    */
-  async findAll(options = {}) {
+  async findAll(options = {}, dbId) {
     try {
       const apiRequest = this.transformTableQueryToApiRequest(options);
-      const result = await this.tablesApiClient.listTables(
-        apiRequest
-      );
+      const listOptions = {
+        ...apiRequest,
+        ...dbId && { db_id: dbId }
+      };
+      const result = await this.tablesApiClient.listTables(listOptions);
       if (isErrorResponse(result)) {
         throw new ApiError(
           result.error.message || "List tables failed",
@@ -1813,7 +1897,7 @@ class TableResource extends BaseResource {
   /**
    * Find a single table by ID or name
    */
-  async findOne(options) {
+  async findOne(options, dbId) {
     var _a, _b, _c;
     try {
       if (!((_a = options.where) == null ? void 0 : _a.id) && !((_b = options.where) == null ? void 0 : _b.name)) {
@@ -1823,7 +1907,8 @@ class TableResource extends BaseResource {
       }
       if ((_c = options.where) == null ? void 0 : _c.id) {
         const result = await this.tablesApiClient.getTable(
-          options.where.id
+          options.where.id,
+          dbId ? { db_id: dbId } : {}
         );
         if (isErrorResponse(result)) {
           if (result.error.code === "TABLE_NOT_FOUND") {
@@ -1851,9 +1936,11 @@ class TableResource extends BaseResource {
           ],
           sort: []
         };
-        const listResult = await this.tablesApiClient.listTables(
-          apiRequest
-        );
+        const listOptions = {
+          ...apiRequest,
+          ...dbId && { db_id: dbId }
+        };
+        const listResult = await this.tablesApiClient.listTables(listOptions);
         if (isErrorResponse(listResult)) {
           throw new ApiError(
             listResult.error.message || "Find table by name failed",
@@ -1874,21 +1961,21 @@ class TableResource extends BaseResource {
   /**
    * Find a single table by name
    */
-  async findByName(name) {
-    return this.findOne({ where: { name } });
+  async findByName(name, dbId) {
+    return this.findOne({ where: { name } }, dbId);
   }
   /**
    * Find a single table by ID
    */
-  async findById(id) {
-    return this.findOne({ where: { id } });
+  async findById(id, dbId) {
+    return this.findOne({ where: { id } }, dbId);
   }
   /**
    * Update a table by name
    */
-  async update(name, data) {
+  async update(name, data, dbId) {
     try {
-      const tableResult = await this.findByName(name);
+      const tableResult = await this.findByName(name, dbId);
       if (!tableResult.data) {
         throw new ApiError(`Table '${name}' not found`, 404);
       }
@@ -1900,7 +1987,7 @@ class TableResource extends BaseResource {
       }
       const result = await this.tablesApiClient.updateTable(
         tableResult.data.id,
-        data
+        dbId ? { ...data, db_id: dbId } : data
       );
       if (isErrorResponse(result)) {
         throw new ApiError(
@@ -1917,9 +2004,9 @@ class TableResource extends BaseResource {
   /**
    * Delete a table by name
    */
-  async delete(name) {
+  async delete(name, dbId) {
     try {
-      const tableResult = await this.findByName(name);
+      const tableResult = await this.findByName(name, dbId);
       if (!tableResult.data) {
         throw new ApiError(`Table '${name}' not found`, 404);
       }
@@ -1930,7 +2017,8 @@ class TableResource extends BaseResource {
         );
       }
       const result = await this.tablesApiClient.deleteTable(
-        tableResult.data.id
+        tableResult.data.id,
+        dbId ? { db_id: dbId } : {}
       );
       if (isErrorResponse(result)) {
         throw new ApiError(
@@ -1947,11 +2035,15 @@ class TableResource extends BaseResource {
   /**
    * Rename a table
    */
-  async rename(oldName, newName) {
+  async rename(oldName, newName, dbId) {
     try {
-      const result = await this.update(oldName, {
-        name: newName
-      });
+      const result = await this.update(
+        oldName,
+        {
+          name: newName
+        },
+        dbId
+      );
       return result;
     } catch (error) {
       throw error instanceof ApiError ? error : new ApiError(this.formatError(error), 500);
@@ -1960,11 +2052,15 @@ class TableResource extends BaseResource {
   /**
    * Set table access permissions
    */
-  async setAccess(request) {
+  async setAccess(request, dbId) {
     try {
-      const result = await this.update(request.table_name, {
-        is_shared: request.is_shared
-      });
+      const result = await this.update(
+        request.table_name,
+        {
+          is_shared: request.is_shared
+        },
+        dbId
+      );
       return result;
     } catch (error) {
       throw error instanceof ApiError ? error : new ApiError(this.formatError(error), 500);
@@ -2355,6 +2451,652 @@ class ColumnResource extends BaseResource {
     return (tableInfo == null ? void 0 : tableInfo.id) || null;
   }
 }
+const DATABASE_ENDPOINTS = {
+  create: {
+    path: "/tables/databases",
+    method: "POST",
+    authenticated: true
+  },
+  list: {
+    path: "/tables/databases/list",
+    method: "POST",
+    authenticated: true
+  },
+  update: {
+    path: "/tables/databases/{db_id}",
+    method: "PATCH",
+    authenticated: true
+  },
+  delete: {
+    path: "/tables/databases/{db_id}",
+    method: "DELETE",
+    authenticated: true
+  },
+  listJobs: {
+    path: "/tables/databases/jobs/list",
+    method: "POST",
+    authenticated: true
+  },
+  pollDeleteStatus: {
+    path: "/tables/databases/delete-status/{job_id}",
+    method: "GET",
+    authenticated: true
+  }
+};
+const buildDatabaseEndpointPath = (endpoint, params = {}) => {
+  let path = endpoint.path;
+  Object.entries(params).forEach(([key, value]) => {
+    path = path.replace(`{${key}}`, value);
+  });
+  return path;
+};
+class DatabasesApiClient {
+  constructor(apiKey, config = {}) {
+    this.config = { apiKey, ...config };
+    this.httpAdapter = createHttpAdapter();
+    const environment = config.environment || "prod";
+    const region = config.region || "asia-south1";
+    this.baseURL = this.getBaseURL(environment, region);
+  }
+  getBaseURL(environment, region) {
+    const regionConfig = REGION_CONFIGS[region];
+    if (!regionConfig) {
+      throw new Error(`Unsupported region: ${region}`);
+    }
+    const envConfig = regionConfig[environment];
+    if (!envConfig) {
+      throw new Error(
+        `Unsupported environment: ${environment} for region: ${region}`
+      );
+    }
+    return `${envConfig.baseURL}/v1`;
+  }
+  /**
+   * Create a new database
+   */
+  async createDatabase(request) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.create;
+      const url = `${this.baseURL}${endpoint.path}`;
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        data: request,
+        timeout: this.config.timeout
+      });
+      return response.data;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * List databases with pagination, sorting, and filtering
+   */
+  async listDatabases(request = {}, queryParams, options) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.list;
+      let url = `${this.baseURL}${endpoint.path}`;
+      const params = new URLSearchParams();
+      if (queryParams == null ? void 0 : queryParams.connector_id) {
+        params.append("connector_id", queryParams.connector_id);
+      }
+      if (queryParams == null ? void 0 : queryParams.add_default_if_missing) {
+        params.append(
+          "add_default_if_missing",
+          queryParams.add_default_if_missing
+        );
+      }
+      if (params.toString()) {
+        url += `?${params.toString()}`;
+      }
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        data: request,
+        timeout: this.config.timeout
+      });
+      const result = response.data;
+      if ((options == null ? void 0 : options.fields) && !("error" in result)) {
+        return {
+          ...result,
+          data: filterArrayFields(
+            result.data,
+            options.fields
+          )
+        };
+      }
+      return result;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * Update a database
+   */
+  async updateDatabase(dbId, request) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.update;
+      const path = buildDatabaseEndpointPath(endpoint, { db_id: dbId });
+      const url = `${this.baseURL}${path}`;
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        data: request,
+        timeout: this.config.timeout
+      });
+      return response.data;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * Delete a database (initiates deletion job)
+   */
+  async deleteDatabase(dbId) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.delete;
+      const path = buildDatabaseEndpointPath(endpoint, { db_id: dbId });
+      const url = `${this.baseURL}${path}`;
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        timeout: this.config.timeout
+      });
+      return response.data;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * List database jobs
+   */
+  async listDatabaseJobs(request = {}, options) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.listJobs;
+      const url = `${this.baseURL}${endpoint.path}`;
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        data: request,
+        timeout: this.config.timeout
+      });
+      const result = response.data;
+      if ((options == null ? void 0 : options.fields) && !("error" in result)) {
+        return {
+          ...result,
+          data: filterArrayFields(
+            result.data,
+            options.fields
+          )
+        };
+      }
+      return result;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * Poll deletion status for a database job
+   */
+  async pollDeleteStatus(jobId) {
+    try {
+      const endpoint = DATABASE_ENDPOINTS.pollDeleteStatus;
+      const path = buildDatabaseEndpointPath(endpoint, { job_id: jobId });
+      const url = `${this.baseURL}${path}`;
+      const response = await this.httpAdapter.request({
+        url,
+        method: endpoint.method,
+        headers: {
+          "Content-Type": "application/json",
+          "x-boltic-token": this.config.apiKey
+        },
+        timeout: this.config.timeout
+      });
+      return response.data;
+    } catch (error) {
+      return this.handleError(error);
+    }
+  }
+  /**
+   * Handle API errors and convert to standard error format
+   */
+  handleError(error) {
+    if (this.config.debug) {
+      console.error("[DatabasesApiClient] Error:", error);
+    }
+    const hasErrorProperty = (err) => {
+      return typeof err === "object" && err !== null && "error" in err && typeof err.error === "object" && err.error !== null;
+    };
+    const hasResponseError = (err) => {
+      return typeof err === "object" && err !== null && "response" in err && typeof err.response === "object" && err.response !== null && "data" in err.response && typeof err.response.data === "object" && err.response.data !== null && "error" in err.response.data;
+    };
+    const isStandardError = (err) => {
+      return err instanceof Error;
+    };
+    if (hasErrorProperty(error)) {
+      return {
+        error: {
+          code: typeof error.error.code === "number" ? String(error.error.code) : error.error.code || "UNKNOWN_ERROR",
+          message: error.error.message || "An error occurred",
+          meta: error.error.meta || []
+        }
+      };
+    }
+    if (hasResponseError(error)) {
+      return {
+        error: {
+          code: typeof error.response.data.error.code === "number" ? String(error.response.data.error.code) : error.response.data.error.code || "UNKNOWN_ERROR",
+          message: error.response.data.error.message || "An error occurred",
+          meta: error.response.data.error.meta || []
+        }
+      };
+    }
+    if (isStandardError(error)) {
+      return {
+        error: {
+          code: error.code || "UNKNOWN_ERROR",
+          message: error.message || "An unexpected error occurred",
+          meta: []
+        }
+      };
+    }
+    return {
+      error: {
+        code: "UNKNOWN_ERROR",
+        message: "An unexpected error occurred",
+        meta: []
+      }
+    };
+  }
+}
+class DatabaseResource extends BaseResource {
+  constructor(client) {
+    super(client, "/v1/tables/databases");
+    this.apiClient = new DatabasesApiClient(client.getConfig().apiKey, {
+      environment: client.getConfig().environment,
+      region: client.getConfig().region,
+      timeout: client.getConfig().timeout,
+      debug: client.getConfig().debug
+    });
+  }
+  /**
+   * Create a new database
+   *
+   * @param request - Database creation request
+   * @returns Promise with created database or error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.databases.create({
+   *   db_name: 'My Database',
+   *   db_internal_name: 'my-database',
+   *   resource_id: 'boltic'
+   * });
+   * ```
+   */
+  async create(request) {
+    const result = await this.apiClient.createDatabase(request);
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    return result;
+  }
+  /**
+   * List all databases with optional filtering and pagination
+   * By default, only shows active databases
+   *
+   * @param options - Query options for listing databases
+   * @returns Promise with list of databases or error
+   *
+   * @example
+   * ```typescript
+   * // List all active databases (default)
+   * const result = await client.databases.findAll();
+   *
+   * // List with pagination
+   * const result = await client.databases.findAll({
+   *   page: { page_no: 1, page_size: 10 }
+   * });
+   *
+   * // List with sorting
+   * const result = await client.databases.findAll({
+   *   sort: [{ field: 'db_name', direction: 'asc' }]
+   * });
+   * ```
+   */
+  async findAll(options) {
+    const request = {};
+    if (options == null ? void 0 : options.page) {
+      request.page = options.page;
+    }
+    if (options == null ? void 0 : options.sort) {
+      request.sort = options.sort;
+    }
+    if (options == null ? void 0 : options.filters) {
+      const filtersWithoutStatus = options.filters.filter(
+        (f) => f.field !== "status"
+      );
+      request.filters = [
+        ...filtersWithoutStatus,
+        { field: "status", operator: "=", values: ["ACTIVE"] }
+      ];
+    } else {
+      request.filters = [
+        { field: "status", operator: "=", values: ["ACTIVE"] }
+      ];
+    }
+    const queryParams = {};
+    if (options == null ? void 0 : options.connector_id) {
+      queryParams.connector_id = options.connector_id;
+    }
+    if ((options == null ? void 0 : options.add_default_if_missing) !== void 0) {
+      queryParams.add_default_if_missing = options.add_default_if_missing ? "true" : "false";
+    }
+    const result = await this.apiClient.listDatabases(
+      request,
+      queryParams,
+      options
+    );
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    if ("pagination" in result && result.pagination) {
+      const pagination = result.pagination;
+      return {
+        ...result,
+        pagination: {
+          total_count: pagination.total_count,
+          total_pages: pagination.total_pages ?? Math.ceil(pagination.total_count / pagination.per_page),
+          current_page: pagination.current_page,
+          per_page: pagination.per_page,
+          type: "page"
+        }
+      };
+    }
+    return result;
+  }
+  /**
+   * Get a specific database by internal name (slug)
+   *
+   * @param dbInternalName - Database internal name (slug)
+   * @param options - Query options (e.g., fields to return)
+   * @returns Promise with database or error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.databases.findOne('my_database_slug');
+   * ```
+   */
+  async findOne(dbInternalName, options) {
+    const result = await this.findAll({
+      filters: [
+        {
+          field: "db_internal_name",
+          operator: "=",
+          values: [dbInternalName]
+        }
+      ],
+      fields: options == null ? void 0 : options.fields,
+      page: { page_no: 1, page_size: 1 }
+    });
+    if (isErrorResponse(result)) {
+      return result;
+    }
+    if (result.data.length === 0) {
+      return {
+        error: {
+          code: "NOT_FOUND",
+          message: `Database with internal name '${dbInternalName}' not found`,
+          meta: []
+        }
+      };
+    }
+    return {
+      data: result.data[0],
+      message: "Database found"
+    };
+  }
+  /**
+   * Get the default database
+   *
+   * @returns Promise with default database or error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.databases.getDefault();
+   * ```
+   */
+  async getDefault() {
+    const result = await this.findAll({
+      filters: [{ field: "is_default", operator: "=", values: [true] }],
+      page: { page_no: 1, page_size: 1 }
+    });
+    if (isErrorResponse(result)) {
+      return result;
+    }
+    if (result.data.length === 0) {
+      return {
+        error: {
+          code: "NOT_FOUND",
+          message: "Default database not found",
+          meta: []
+        }
+      };
+    }
+    return {
+      data: result.data[0],
+      message: "Default database found"
+    };
+  }
+  /**
+   * Update a database
+   * Only allows updating the display name (db_name)
+   *
+   * @param dbInternalName - Database internal name (slug)
+   * @param request - Update request (only db_name is allowed)
+   * @returns Promise with updated database or error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.databases.update('my_database_slug', {
+   *   db_name: 'Updated Database Name'
+   * });
+   * ```
+   */
+  async update(dbInternalName, request) {
+    const dbInfo = await this.findOne(dbInternalName);
+    if (isErrorResponse(dbInfo)) {
+      return {
+        error: {
+          code: "DATABASE_NOT_FOUND",
+          message: `Database with internal name '${dbInternalName}' not found`,
+          meta: []
+        }
+      };
+    }
+    const dbId = dbInfo.data.id;
+    const updateRequest = {
+      db_name: request.db_name
+    };
+    const result = await this.apiClient.updateDatabase(dbId, updateRequest);
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    return result;
+  }
+  /**
+   * Delete a database (initiates async deletion job)
+   *
+   * @param dbInternalName - Database internal name (slug)
+   * @returns Promise with job details or error
+   *
+   * @example
+   * ```typescript
+   * const result = await client.databases.delete('my_database_slug');
+   * if (!result.error) {
+   *   console.log('Deletion job started:', result.data.job_id);
+   *   // Poll for status
+   *   const status = await client.databases.pollDeleteStatus(result.data.job_id);
+   * }
+   * ```
+   */
+  async delete(dbInternalName) {
+    const dbInfo = await this.findOne(dbInternalName);
+    if (isErrorResponse(dbInfo)) {
+      return {
+        error: {
+          code: "DATABASE_NOT_FOUND",
+          message: `Database with internal name '${dbInternalName}' not found`,
+          meta: []
+        }
+      };
+    }
+    if (dbInfo.data.is_default) {
+      return {
+        error: {
+          code: "CANNOT_DELETE_DEFAULT",
+          message: "Cannot delete the default database",
+          meta: []
+        }
+      };
+    }
+    const dbId = dbInfo.data.id;
+    const result = await this.apiClient.deleteDatabase(dbId);
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    return result;
+  }
+  /**
+   * List database jobs (e.g., deletion jobs)
+   *
+   * @param options - Query options for listing jobs
+   * @returns Promise with list of jobs or error
+   *
+   * @example
+   * ```typescript
+   * // List all jobs
+   * const result = await client.databases.listJobs();
+   *
+   * // List jobs deleted by current user
+   * const result = await client.databases.listJobs({
+   *   deleted_by_me: true
+   * });
+   * ```
+   */
+  async listJobs(options) {
+    const request = {};
+    if ((options == null ? void 0 : options.deleted_by_me) !== void 0) {
+      request.deleted_by_me = options.deleted_by_me;
+    }
+    if (options == null ? void 0 : options.page) {
+      request.page = options.page;
+    }
+    if (options == null ? void 0 : options.sort) {
+      request.sort = options.sort;
+    }
+    if (options == null ? void 0 : options.filters) {
+      request.filters = options.filters;
+    }
+    const result = await this.apiClient.listDatabaseJobs(request, options);
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    if ("pagination" in result && result.pagination) {
+      const pagination = result.pagination;
+      const normalizedResult = {
+        ...result,
+        pagination: {
+          total_count: pagination.total_count,
+          total_pages: pagination.total_pages ?? Math.ceil(pagination.total_count / pagination.per_page),
+          current_page: pagination.current_page,
+          per_page: pagination.per_page,
+          type: "page"
+        }
+      };
+      return normalizedResult;
+    }
+    return result;
+  }
+  /**
+   * Poll the status of a database deletion job
+   *
+   * @param jobId - Job ID
+   * @returns Promise with job status or error
+   *
+   * @example
+   * ```typescript
+   * const status = await client.databases.pollDeleteStatus('job-uuid');
+   * if (!status.error) {
+   *   console.log('Job status:', status.data.status);
+   *   console.log('Message:', status.data.message);
+   * }
+   * ```
+   */
+  async pollDeleteStatus(jobId) {
+    const result = await this.apiClient.pollDeleteStatus(jobId);
+    if ("error" in result) {
+      return {
+        error: {
+          code: typeof result.error.code === "number" ? String(result.error.code) : result.error.code,
+          message: result.error.message,
+          meta: result.error.meta
+        }
+      };
+    }
+    return result;
+  }
+}
 const INDEX_ENDPOINTS = {
   create: {
     path: "/tables/indexes/{table_id}",
@@ -2404,10 +3146,11 @@ class IndexesApiClient {
     }
     return `${envConfig.baseURL}/v1`;
   }
-  async addIndex(tableId, request) {
+  async addIndex(tableId, request, dbId) {
     try {
       const endpoint = INDEX_ENDPOINTS.create;
-      const url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2420,10 +3163,11 @@ class IndexesApiClient {
       return this.formatErrorResponse(error);
     }
   }
-  async listIndexes(tableId, query) {
+  async listIndexes(tableId, query, dbId) {
     try {
       const endpoint = INDEX_ENDPOINTS.list;
-      const url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2436,10 +3180,11 @@ class IndexesApiClient {
       return this.formatErrorResponse(error);
     }
   }
-  async deleteIndex(tableId, request) {
+  async deleteIndex(tableId, request, dbId) {
     try {
       const endpoint = INDEX_ENDPOINTS.delete;
-      const url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      let url = `${this.baseURL}${buildIndexEndpointPath(endpoint, { table_id: tableId })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2510,15 +3255,15 @@ class IndexResource {
     });
     this.tableResource = new TableResource(client);
   }
-  async resolveTableId(tableName) {
-    const tableResult = await this.tableResource.findByName(tableName);
+  async resolveTableId(tableName, dbId) {
+    const tableResult = await this.tableResource.findByName(tableName, dbId);
     if (!tableResult.data) throw new Error(`Table not found: ${tableName}`);
     return tableResult.data.id;
   }
-  async addIndex(tableName, request) {
+  async addIndex(tableName, request, dbId) {
     try {
-      const tableId = await this.resolveTableId(tableName);
-      return await this.apiClient.addIndex(tableId, request);
+      const tableId = await this.resolveTableId(tableName, dbId);
+      return await this.apiClient.addIndex(tableId, request, dbId);
     } catch (error) {
       return {
         error: {
@@ -2529,10 +3274,10 @@ class IndexResource {
       };
     }
   }
-  async listIndexes(tableName, query) {
+  async listIndexes(tableName, query, dbId) {
     try {
-      const tableId = await this.resolveTableId(tableName);
-      return await this.apiClient.listIndexes(tableId, query);
+      const tableId = await this.resolveTableId(tableName, dbId);
+      return await this.apiClient.listIndexes(tableId, query, dbId);
     } catch (error) {
       return {
         error: {
@@ -2543,11 +3288,11 @@ class IndexResource {
       };
     }
   }
-  async deleteIndex(tableName, indexName) {
+  async deleteIndex(tableName, indexName, dbId) {
     try {
-      const tableId = await this.resolveTableId(tableName);
+      const tableId = await this.resolveTableId(tableName, dbId);
       const request = { index_name: indexName };
-      return await this.apiClient.deleteIndex(tableId, request);
+      return await this.apiClient.deleteIndex(tableId, request, dbId);
     } catch (error) {
       return {
         error: {
@@ -2583,8 +3328,8 @@ const RECORD_ENDPOINTS = {
     rateLimit: { requests: 200, window: 6e4 }
   },
   update: {
-    path: "/tables/{table_id}/records",
-    method: "PATCH",
+    path: "/tables/{table_id}/records/bulk-update",
+    method: "PUT",
     authenticated: true
   },
   updateById: {
@@ -2654,7 +3399,7 @@ class RecordsApiClient {
   /**
    * Insert a single record
    */
-  async insertRecord(request) {
+  async insertRecord(request, dbId) {
     try {
       const { table_id, fields, ...recordData } = request;
       if (!table_id) {
@@ -2663,7 +3408,8 @@ class RecordsApiClient {
         );
       }
       const endpoint = RECORD_ENDPOINTS.insert;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2686,7 +3432,7 @@ class RecordsApiClient {
   /**
    * Insert multiple records in bulk
    */
-  async insertManyRecords(records, tableId, options = { validation: true }) {
+  async insertManyRecords(records, tableId, options = { validation: true }, dbId) {
     try {
       if (!tableId) {
         return this.formatErrorResponse(
@@ -2707,6 +3453,7 @@ class RecordsApiClient {
       if (queryParams.toString()) {
         url += `?${queryParams.toString()}`;
       }
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2722,7 +3469,7 @@ class RecordsApiClient {
   /**
    * Get a single record by ID
    */
-  async getRecord(recordId, tableId, options = {}) {
+  async getRecord(recordId, tableId, options = {}, dbId) {
     try {
       if (!tableId) {
         return this.formatErrorResponse(
@@ -2730,10 +3477,11 @@ class RecordsApiClient {
         );
       }
       const endpoint = RECORD_ENDPOINTS.get;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, {
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, {
         table_id: tableId,
         record_id: recordId
       })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2755,7 +3503,7 @@ class RecordsApiClient {
   /**
    * List records with filtering and pagination
    */
-  async listRecords(options = {}) {
+  async listRecords(options = {}, dbId) {
     try {
       const { table_id, ...queryOptions } = options;
       if (!table_id) {
@@ -2764,7 +3512,8 @@ class RecordsApiClient {
         );
       }
       const endpoint = RECORD_ENDPOINTS.list;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2787,28 +3536,37 @@ class RecordsApiClient {
   /**
    * Update records by filters
    */
-  async updateRecords(request) {
+  async updateRecords(request, dbId) {
     try {
-      const { table_id, ...updateOptions } = request;
+      const { table_id, set, filters, fields, ...rest } = request;
       if (!table_id) {
         return this.formatErrorResponse(
           new Error("table_id is required for update operation")
         );
       }
+      const apiPayload = {
+        updates: set,
+        filters,
+        ...rest
+      };
+      if (fields) {
+        apiPayload.fields = fields;
+      }
       const endpoint = RECORD_ENDPOINTS.update;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
         headers: this.buildHeaders(),
-        data: updateOptions,
+        data: apiPayload,
         timeout: this.config.timeout
       });
       const responseData = response.data;
-      if (updateOptions.fields && responseData.data) {
+      if (fields && responseData.data) {
         responseData.data = filterArrayFields(
           responseData.data,
-          updateOptions.fields
+          fields
         );
       }
       return responseData;
@@ -2819,7 +3577,7 @@ class RecordsApiClient {
   /**
    * Update a single record by ID
    */
-  async updateRecordById(recordId, request) {
+  async updateRecordById(recordId, request, dbId) {
     try {
       const { table_id, ...updateOptions } = request;
       if (!table_id) {
@@ -2828,10 +3586,11 @@ class RecordsApiClient {
         );
       }
       const endpoint = RECORD_ENDPOINTS.updateById;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, {
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, {
         record_id: recordId,
         table_id
       })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2854,7 +3613,7 @@ class RecordsApiClient {
   /**
    * Unified delete records method that supports both record_ids and filters
    */
-  async deleteRecords(request) {
+  async deleteRecords(request, dbId) {
     try {
       const { table_id } = request;
       if (!table_id) {
@@ -2864,7 +3623,8 @@ class RecordsApiClient {
       }
       const transformedRequest = transformDeleteRequest(request);
       const endpoint = RECORD_ENDPOINTS.delete;
-      const url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      let url = `${this.baseURL}${buildRecordEndpointPath(endpoint, { table_id })}`;
+      url = addDbIdToUrl(url, dbId);
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -2880,11 +3640,14 @@ class RecordsApiClient {
   /**
    * Delete a single record by ID
    */
-  async deleteRecordById(recordId, request) {
-    return this.deleteRecords({
-      record_ids: [recordId],
-      table_id: request.table_id
-    });
+  async deleteRecordById(recordId, request, dbId) {
+    return this.deleteRecords(
+      {
+        record_ids: [recordId],
+        table_id: request.table_id
+      },
+      dbId
+    );
   }
   buildHeaders() {
     return {
@@ -2948,9 +3711,9 @@ class RecordResource {
   /**
    * Insert a single record
    */
-  async insert(tableName, data) {
+  async insert(tableName, data, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -2970,7 +3733,7 @@ class RecordResource {
         ...completeDataResult,
         table_id: tableInfo.id
       };
-      const result = await this.apiClient.insertRecord(requestData);
+      const result = await this.apiClient.insertRecord(requestData, dbId);
       if (isErrorResponse(result)) {
         return result;
       }
@@ -2987,7 +3750,7 @@ class RecordResource {
   /**
    * Insert multiple records in bulk
    */
-  async insertMany(tableName, records, options = { validation: true }) {
+  async insertMany(tableName, records, options = { validation: true }, dbId) {
     try {
       if (!records || !Array.isArray(records) || records.length === 0) {
         return {
@@ -2997,7 +3760,7 @@ class RecordResource {
           }
         };
       }
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3009,7 +3772,8 @@ class RecordResource {
       const result = await this.apiClient.insertManyRecords(
         records,
         tableInfo.id,
-        options
+        options,
+        dbId
       );
       if (isErrorResponse(result)) {
         return result;
@@ -3027,9 +3791,9 @@ class RecordResource {
   /**
    * Get a single record by ID
    */
-  async get(tableName, recordId) {
+  async get(tableName, recordId, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3038,7 +3802,12 @@ class RecordResource {
           }
         };
       }
-      const result = await this.apiClient.getRecord(recordId, tableInfo.id);
+      const result = await this.apiClient.getRecord(
+        recordId,
+        tableInfo.id,
+        {},
+        dbId
+      );
       if (isErrorResponse(result)) {
         return result;
       }
@@ -3055,9 +3824,9 @@ class RecordResource {
   /**
    * List records with filtering and pagination
    */
-  async list(tableName, options = {}) {
+  async list(tableName, options = {}, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3067,7 +3836,7 @@ class RecordResource {
         };
       }
       const requestOptions = { ...options, table_id: tableInfo.id };
-      const result = await this.apiClient.listRecords(requestOptions);
+      const result = await this.apiClient.listRecords(requestOptions, dbId);
       if (isErrorResponse(result)) {
         return result;
       }
@@ -3084,9 +3853,9 @@ class RecordResource {
   /**
    * Update records by filters
    */
-  async update(tableName, options) {
+  async update(tableName, options, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3096,7 +3865,7 @@ class RecordResource {
         };
       }
       const requestOptions = { ...options, table_id: tableInfo.id };
-      const result = await this.apiClient.updateRecords(requestOptions);
+      const result = await this.apiClient.updateRecords(requestOptions, dbId);
       if (isErrorResponse(result)) {
         return result;
       }
@@ -3113,9 +3882,9 @@ class RecordResource {
   /**
    * Update a single record by ID
    */
-  async updateById(tableName, recordId, data) {
+  async updateById(tableName, recordId, data, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3131,7 +3900,8 @@ class RecordResource {
       };
       const result = await this.apiClient.updateRecordById(
         recordId,
-        requestOptions
+        requestOptions,
+        dbId
       );
       if (isErrorResponse(result)) {
         return result;
@@ -3149,9 +3919,9 @@ class RecordResource {
   /**
    * Unified delete method that supports both record IDs and filters
    */
-  async delete(tableName, options) {
+  async delete(tableName, options, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3161,7 +3931,7 @@ class RecordResource {
         };
       }
       const requestOptions = { ...options, table_id: tableInfo.id };
-      const result = await this.apiClient.deleteRecords(requestOptions);
+      const result = await this.apiClient.deleteRecords(requestOptions, dbId);
       if (isErrorResponse(result)) {
         return result;
       }
@@ -3178,9 +3948,9 @@ class RecordResource {
   /**
    * Delete a single record by ID
    */
-  async deleteById(tableName, recordId) {
+  async deleteById(tableName, recordId, dbId) {
     try {
-      const tableInfo = await this.getTableInfo(tableName);
+      const tableInfo = await this.getTableInfo(tableName, dbId);
       if (!tableInfo) {
         return {
           error: {
@@ -3189,9 +3959,13 @@ class RecordResource {
           }
         };
       }
-      const result = await this.apiClient.deleteRecordById(recordId, {
-        table_id: tableInfo.id
-      });
+      const result = await this.apiClient.deleteRecordById(
+        recordId,
+        {
+          table_id: tableInfo.id
+        },
+        dbId
+      );
       if (isErrorResponse(result)) {
         return result;
       }
@@ -3208,10 +3982,10 @@ class RecordResource {
   /**
    * Helper method to get table information by name
    */
-  async getTableInfo(tableName) {
+  async getTableInfo(tableName, dbId) {
     try {
       const tableResource = new TableResource(this.client);
-      const tableResult = await tableResource.findByName(tableName);
+      const tableResult = await tableResource.findByName(tableName, dbId);
       if (tableResult.data) {
         return {
           id: tableResult.data.id,
@@ -3575,10 +4349,13 @@ class SqlApiClient extends BaseApiClient {
   /**
    * Convert natural language to SQL query (streaming)
    */
-  async textToSQL(request) {
+  async textToSQL(request, dbId) {
     try {
       const endpoint = SQL_ENDPOINTS.textToSQL;
-      const url = `${this.baseURL}${buildSqlEndpointPath(endpoint)}`;
+      let url = `${this.baseURL}${buildSqlEndpointPath(endpoint)}`;
+      if (dbId) {
+        url += `?db_id=${encodeURIComponent(dbId)}`;
+      }
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -3603,10 +4380,13 @@ class SqlApiClient extends BaseApiClient {
   /**
    * Execute SQL query
    */
-  async executeSQL(request) {
+  async executeSQL(request, dbId) {
     try {
       const endpoint = SQL_ENDPOINTS.executeSQL;
-      const url = `${this.baseURL}${buildSqlEndpointPath(endpoint)}`;
+      let url = `${this.baseURL}${buildSqlEndpointPath(endpoint)}`;
+      if (dbId) {
+        url += `?db_id=${encodeURIComponent(dbId)}`;
+      }
       const response = await this.httpAdapter.request({
         url,
         method: endpoint.method,
@@ -3663,9 +4443,9 @@ class SqlResource {
    * @returns AsyncIterable<string> for streaming SQL generation
    *
    */
-  async textToSQL(prompt, options = {}) {
+  async textToSQL(prompt, options = {}, dbId) {
     const request = transformTextToSQLRequest(prompt, options);
-    const response = await this.sqlApiClient.textToSQL(request);
+    const response = await this.sqlApiClient.textToSQL(request, dbId);
     if ("error" in response && response.error !== void 0) {
       throw response;
     }
@@ -3678,8 +4458,8 @@ class SqlResource {
    * @returns Promise<ExecuteSQLApiResponse> with raw API response following Boltic API Response Structure
    *
    */
-  async executeSQL(query) {
-    const response = await this.sqlApiClient.executeSQL({ query });
+  async executeSQL(query, dbId) {
+    const response = await this.sqlApiClient.executeSQL({ query }, dbId);
     if (isErrorResponse(response)) {
       return response;
     }
@@ -4028,25 +4808,76 @@ class BolticClient {
     this.recordResource = new RecordResource(this.baseClient);
     this.sqlResource = new SqlResource(this.baseClient);
     this.indexResource = new IndexResource(this.baseClient);
-    this.currentDatabase = {
-      databaseName: "Default"
-    };
+    this.databaseResource = new DatabaseResource(this.baseClient);
+    this.currentDatabase = null;
   }
+  /**
+   * Get current database context
+   */
   getCurrentDatabase() {
     return this.currentDatabase;
   }
+  /**
+   * Switch to a different database using its internal name (slug).
+   * All subsequent operations will use this database.
+   *
+   * If no internal name is provided, the SDK will switch back to the default database.
+   *
+   * @param dbInternalName - Database internal name/slug to switch to. If omitted or empty, default DB is used.
+   *
+   * @example
+   * ```typescript
+   * // Switch to a specific database by slug
+   * await client.useDatabase('my_database_slug');
+   *
+   * // Switch back to default database
+   * await client.useDatabase();
+   * ```
+   */
+  async useDatabase(dbInternalName) {
+    if (!dbInternalName || dbInternalName === "") {
+      this.currentDatabase = null;
+      return;
+    }
+    const result = await this.databaseResource.findOne(dbInternalName);
+    if (isErrorResponse(result)) {
+      throw new Error(
+        result.error.message || `Failed to switch database to internal name '${dbInternalName}'`
+      );
+    }
+    const db = result.data;
+    this.currentDatabase = {
+      databaseId: db.id,
+      dbInternalName: db.db_internal_name || dbInternalName
+    };
+  }
+  // Direct database operations
+  get databases() {
+    return {
+      create: (data) => this.databaseResource.create(data),
+      findAll: (options) => this.databaseResource.findAll(options),
+      findOne: (dbInternalName, options) => this.databaseResource.findOne(dbInternalName, options),
+      getDefault: () => this.databaseResource.getDefault(),
+      update: (dbInternalName, data) => this.databaseResource.update(dbInternalName, data),
+      delete: (dbInternalName) => this.databaseResource.delete(dbInternalName),
+      listJobs: (options) => this.databaseResource.listJobs(options),
+      pollDeleteStatus: (jobId) => this.databaseResource.pollDeleteStatus(jobId)
+    };
+  }
   // Direct table operations
   get tables() {
+    var _a;
+    const dbId = (_a = this.currentDatabase) == null ? void 0 : _a.databaseId;
     return {
-      create: (data) => this.tableResource.create(data),
-      findAll: (options) => this.tableResource.findAll(options),
-      findById: (id) => this.tableResource.findById(id),
-      findByName: (name) => this.tableResource.findByName(name),
-      findOne: (options) => this.tableResource.findOne(options),
-      update: (name, data) => this.tableResource.update(name, data),
-      delete: (name) => this.tableResource.delete(name),
-      rename: (oldName, newName) => this.tableResource.rename(oldName, newName),
-      setAccess: (request) => this.tableResource.setAccess(request)
+      create: (data) => this.tableResource.create(data, dbId),
+      findAll: (options) => this.tableResource.findAll(options, dbId),
+      findById: (id) => this.tableResource.findById(id, dbId),
+      findByName: (name) => this.tableResource.findByName(name, dbId),
+      findOne: (options) => this.tableResource.findOne(options, dbId),
+      update: (name, data) => this.tableResource.update(name, data, dbId),
+      delete: (name) => this.tableResource.delete(name, dbId),
+      rename: (oldName, newName) => this.tableResource.rename(oldName, newName, dbId),
+      setAccess: (request) => this.tableResource.setAccess(request, dbId)
     };
   }
   // Direct column operations
@@ -4074,53 +4905,42 @@ class BolticClient {
     const tableBuilder = createTableBuilder({ name });
     return tableBuilder;
   }
-  // Method 3: Table-scoped operations
+  // Table-scoped operations for method chaining
   from(tableName) {
+    var _a;
+    const dbId = (_a = this.currentDatabase) == null ? void 0 : _a.databaseId;
     return {
-      // Column operations for this table
-      columns: () => ({
-        create: (column) => this.columnResource.create(tableName, column),
-        findAll: (options) => this.columnResource.findAll(tableName, options),
-        get: (columnName) => this.columnResource.get(tableName, columnName),
-        update: (columnName, updates) => this.columnResource.update(tableName, columnName, updates),
-        delete: (columnName) => this.columnResource.delete(tableName, columnName)
+      // Index operations for this table
+      indexes: () => ({
+        addIndex: (payload) => this.indexResource.addIndex(tableName, payload, dbId),
+        listIndexes: (query) => this.indexResource.listIndexes(tableName, query, dbId),
+        deleteIndex: (indexName) => this.indexResource.deleteIndex(tableName, indexName, dbId)
       }),
       // Record operations for this table
       records: () => ({
-        insert: (data) => this.recordResource.insert(tableName, data),
-        insertMany: (records, options) => this.recordResource.insertMany(tableName, records, options),
-        findOne: (recordId) => this.recordResource.get(tableName, recordId),
-        update: (options) => this.recordResource.update(tableName, options),
-        updateById: (recordId, data) => this.recordResource.updateById(tableName, recordId, data),
-        // Unified delete method
-        delete: (options) => this.recordResource.delete(tableName, options),
-        // Single record delete method
-        deleteById: (recordId) => this.recordResource.deleteById(tableName, recordId)
-      }),
-      // Fluent record builder for this table
-      record: () => createRecordBuilder({
-        tableName,
-        recordResource: this.recordResource
-      }),
-      // Indexes - Method 2: Function chaining under from(tableName)
-      indexes: () => ({
-        addIndex: (payload) => this.indexResource.addIndex(tableName, payload),
-        listIndexes: (query) => this.indexResource.listIndexes(tableName, query),
-        deleteIndex: (indexName) => this.indexResource.deleteIndex(tableName, indexName)
+        insert: (data) => this.recordResource.insert(tableName, data, dbId),
+        insertMany: (records, options) => this.recordResource.insertMany(tableName, records, options, dbId),
+        findOne: (recordId) => this.recordResource.get(tableName, recordId, dbId),
+        update: (options) => this.recordResource.update(tableName, options, dbId),
+        updateById: (recordId, data) => this.recordResource.updateById(tableName, recordId, data, dbId),
+        delete: (options) => this.recordResource.delete(tableName, options, dbId),
+        deleteById: (recordId) => this.recordResource.deleteById(tableName, recordId, dbId)
       })
     };
   }
   // Direct record operations
   get records() {
+    var _a;
+    const dbId = (_a = this.currentDatabase) == null ? void 0 : _a.databaseId;
     return {
-      insert: (tableName, data) => this.recordResource.insert(tableName, data),
-      insertMany: (tableName, records, options) => this.recordResource.insertMany(tableName, records, options),
-      findAll: (tableName, options) => this.recordResource.list(tableName, options),
-      findOne: (tableName, recordId) => this.recordResource.get(tableName, recordId),
-      update: (tableName, options) => this.recordResource.update(tableName, options),
-      updateById: (tableName, recordId, data) => this.recordResource.updateById(tableName, recordId, data),
-      delete: (tableName, options) => this.recordResource.delete(tableName, options),
-      deleteById: (tableName, recordId) => this.recordResource.deleteById(tableName, recordId)
+      insert: (tableName, data) => this.recordResource.insert(tableName, data, dbId),
+      insertMany: (tableName, records, options) => this.recordResource.insertMany(tableName, records, options, dbId),
+      findAll: (tableName, options) => this.recordResource.list(tableName, options, dbId),
+      findOne: (tableName, recordId) => this.recordResource.get(tableName, recordId, dbId),
+      update: (tableName, options) => this.recordResource.update(tableName, options, dbId),
+      updateById: (tableName, recordId, data) => this.recordResource.updateById(tableName, recordId, data, dbId),
+      delete: (tableName, options) => this.recordResource.delete(tableName, options, dbId),
+      deleteById: (tableName, recordId) => this.recordResource.deleteById(tableName, recordId, dbId)
     };
   }
   // Method 4: Create fluent record builder
@@ -4132,9 +4952,11 @@ class BolticClient {
   }
   // Direct SQL operations
   get sql() {
+    var _a;
+    const dbId = (_a = this.currentDatabase) == null ? void 0 : _a.databaseId;
     return {
-      textToSQL: (prompt, options) => this.sqlResource.textToSQL(prompt, options),
-      executeSQL: (query) => this.sqlResource.executeSQL(query)
+      textToSQL: (prompt, options) => this.sqlResource.textToSQL(prompt, options, dbId),
+      executeSQL: (query) => this.sqlResource.executeSQL(query, dbId)
     };
   }
   // SQL resource access for testing
@@ -4218,6 +5040,7 @@ class BolticClient {
     this.recordResource = new RecordResource(this.baseClient);
     this.sqlResource = new SqlResource(this.baseClient);
     this.indexResource = new IndexResource(this.baseClient);
+    this.databaseResource = new DatabaseResource(this.baseClient);
   }
   // Security methods to prevent API key exposure
   toString() {
@@ -4286,4 +5109,4 @@ export {
   createMockResponse as p,
   createTestClient as q
 };
-//# sourceMappingURL=test-client-rQ1AmTo6.mjs.map
+//# sourceMappingURL=test-client-D8i2zDgI.mjs.map