@xata.io/client 0.0.0-alpha.vec0bff6 → 0.0.0-alpha.vec88a57

package/dist/index.cjs

@@ -20,6 +20,30 @@ function _interopNamespace(e) {
   return Object.freeze(n);
 }
 
+const defaultTrace = async (_name, fn, _options) => {
+  return await fn({
+    setAttributes: () => {
+      return;
+    },
+    onError: () => {
+      return;
+    }
+  });
+};
+const TraceAttributes = {
+  VERSION: "xata.sdk.version",
+  TABLE: "xata.table",
+  HTTP_REQUEST_ID: "http.request_id",
+  HTTP_STATUS_CODE: "http.status_code",
+  HTTP_HOST: "http.host",
+  HTTP_SCHEME: "http.scheme",
+  HTTP_USER_AGENT: "http.user_agent",
+  HTTP_METHOD: "http.method",
+  HTTP_URL: "http.url",
+  HTTP_ROUTE: "http.route",
+  HTTP_TARGET: "http.target"
+};
+
 function notEmpty(value) {
   return value !== null && value !== void 0;
 }
@@ -150,7 +174,7 @@ function getFetchImplementation(userFetch) {
   return fetchImpl;
 }
 
-const VERSION = "0.0.0-alpha.vec0bff6";
+const VERSION = "0.0.0-alpha.vec88a57";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -229,34 +253,62 @@ async function fetch$1({
   fetchImpl,
   apiKey,
   apiUrl,
-  workspacesApiUrl
+  workspacesApiUrl,
+  trace
 }) {
-  const baseUrl = buildBaseUrl({ path, workspacesApiUrl, pathParams, apiUrl });
-  const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
-  const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
-  const response = await fetchImpl(url, {
-    method: method.toUpperCase(),
-    body: body ? JSON.stringify(body) : void 0,
-    headers: {
-      "Content-Type": "application/json",
-      "User-Agent": `Xata client-ts/${VERSION}`,
-      ...headers,
-      ...hostHeader(fullUrl),
-      Authorization: `Bearer ${apiKey}`
-    }
-  });
-  if (response.status === 204) {
-    return {};
-  }
-  const requestId = response.headers?.get("x-request-id") ?? void 0;
+  return trace(
+    `${method.toUpperCase()} ${path}`,
+    async ({ setAttributes, onError }) => {
+      const baseUrl = buildBaseUrl({ path, workspacesApiUrl, pathParams, apiUrl });
+      const fullUrl = resolveUrl(baseUrl, queryParams, pathParams);
+      const url = fullUrl.includes("localhost") ? fullUrl.replace(/^[^.]+\./, "http://") : fullUrl;
+      setAttributes({
+        [TraceAttributes.HTTP_URL]: url,
+        [TraceAttributes.HTTP_TARGET]: resolveUrl(path, queryParams, pathParams)
+      });
+      const response = await fetchImpl(url, {
+        method: method.toUpperCase(),
+        body: body ? JSON.stringify(body) : void 0,
+        headers: {
+          "Content-Type": "application/json",
+          "User-Agent": `Xata client-ts/${VERSION}`,
+          ...headers,
+          ...hostHeader(fullUrl),
+          Authorization: `Bearer ${apiKey}`
+        }
+      });
+      if (response.status === 204) {
+        return {};
+      }
+      const { host, protocol } = parseUrl(response.url);
+      const requestId = response.headers?.get("x-request-id") ?? void 0;
+      setAttributes({
+        [TraceAttributes.HTTP_REQUEST_ID]: requestId,
+        [TraceAttributes.HTTP_STATUS_CODE]: response.status,
+        [TraceAttributes.HTTP_HOST]: host,
+        [TraceAttributes.HTTP_SCHEME]: protocol?.replace(":", "")
+      });
+      try {
+        const jsonResponse = await response.json();
+        if (response.ok) {
+          return jsonResponse;
+        }
+        throw new FetcherError(response.status, jsonResponse, requestId);
+      } catch (error) {
+        const fetcherError = new FetcherError(response.status, error, requestId);
+        onError(fetcherError.message);
+        throw fetcherError;
+      }
+    },
+    { [TraceAttributes.HTTP_METHOD]: method.toUpperCase(), [TraceAttributes.HTTP_ROUTE]: path }
+  );
+}
+function parseUrl(url) {
   try {
-    const jsonResponse = await response.json();
-    if (response.ok) {
-      return jsonResponse;
-    }
-    throw new FetcherError(response.status, jsonResponse, requestId);
+    const { host, protocol } = new URL(url);
+    return { host, protocol };
   } catch (error) {
-    throw new FetcherError(response.status, error, requestId);
+    return {};
   }
 }
 
@@ -351,6 +403,11 @@ const deleteDatabase = (variables) => fetch$1({
   method: "delete",
   ...variables
 });
+const getDatabaseMetadata = (variables) => fetch$1({
+  url: "/dbs/{dbName}/metadata",
+  method: "get",
+  ...variables
+});
 const getGitBranchesMapping = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "get", ...variables });
 const addGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "post", ...variables });
 const removeGitBranchesEntry = (variables) => fetch$1({ url: "/dbs/{dbName}/gitBranches", method: "delete", ...variables });
@@ -489,6 +546,7 @@ const operationsByTag = {
     getDatabaseList,
     createDatabase,
     deleteDatabase,
+    getDatabaseMetadata,
     getGitBranchesMapping,
     addGitBranchesEntry,
     removeGitBranchesEntry,
@@ -581,7 +639,8 @@ class XataApiClient {
     __privateAdd$7(this, _extraProps, void 0);
     __privateAdd$7(this, _namespaces, {});
     const provider = options.host ?? "production";
-    const apiKey = options?.apiKey ?? getAPIKey();
+    const apiKey = options.apiKey ?? getAPIKey();
+    const trace = options.trace ?? defaultTrace;
     if (!apiKey) {
       throw new Error("Could not resolve a valid apiKey");
     }
@@ -589,7 +648,8 @@ class XataApiClient {
       apiUrl: getHostUrl(provider, "main"),
       workspacesApiUrl: getHostUrl(provider, "workspaces"),
       fetchImpl: getFetchImplementation(options.fetch),
-      apiKey
+      apiKey,
+      trace
     });
   }
   get user() {
@@ -761,6 +821,12 @@ class DatabaseApi {
       ...this.extraProps
     });
   }
+  getDatabaseMetadata(workspace, dbName) {
+    return operationsByTag.database.getDatabaseMetadata({
+      pathParams: { workspace, dbName },
+      ...this.extraProps
+    });
+  }
   getGitBranchesMapping(workspace, dbName) {
     return operationsByTag.database.getGitBranchesMapping({
       pathParams: { workspace, dbName },
@@ -1200,7 +1266,7 @@ const _Query = class {
       return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
     }
   }
-  sort(column, direction) {
+  sort(column, direction = "asc") {
     const originalSort = [__privateGet$5(this, _data).sort ?? []].flat();
     const sort = [...originalSort, { column, direction }];
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { sort }, __privateGet$5(this, _data));
@@ -1336,7 +1402,7 @@ var __privateMethod$2 = (obj, member, method) => {
   __accessCheck$4(obj, member, "access private method");
   return method;
 };
-var _table, _getFetchProps, _db, _cache, _schemaTables$2, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1;
+var _table, _getFetchProps, _db, _cache, _schemaTables$2, _trace, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchemaTables$1, getSchemaTables_fn$1;
 class Repository extends Query {
 }
 class RestRepository extends Query {
@@ -1356,168 +1422,196 @@ class RestRepository extends Query {
     __privateAdd$4(this, _db, void 0);
     __privateAdd$4(this, _cache, void 0);
     __privateAdd$4(this, _schemaTables$2, void 0);
+    __privateAdd$4(this, _trace, void 0);
     __privateSet$4(this, _table, options.table);
     __privateSet$4(this, _getFetchProps, options.pluginOptions.getFetchProps);
     __privateSet$4(this, _db, options.db);
     __privateSet$4(this, _cache, options.pluginOptions.cache);
     __privateSet$4(this, _schemaTables$2, options.schemaTables);
+    const trace = options.pluginOptions.trace ?? defaultTrace;
+    __privateSet$4(this, _trace, async (name, fn, options2 = {}) => {
+      return trace(name, fn, {
+        ...options2,
+        [TraceAttributes.TABLE]: __privateGet$4(this, _table),
+        [TraceAttributes.VERSION]: VERSION
+      });
+    });
   }
   async create(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a, columns);
-    }
-    if (isString(a) && isObject(b)) {
-      if (a === "")
-        throw new Error("The id can't be empty");
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      if (a.id === "")
-        throw new Error("The id can't be empty");
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    if (isObject(a)) {
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a, columns);
-    }
-    throw new Error("Invalid arguments for create method");
+    return __privateGet$4(this, _trace).call(this, "create", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _bulkInsertTableRecords, bulkInsertTableRecords_fn).call(this, a, columns);
+      }
+      if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns);
+      }
+      if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns);
+      }
+      if (isObject(a)) {
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _insertRecordWithoutId, insertRecordWithoutId_fn).call(this, a, columns);
+      }
+      throw new Error("Invalid arguments for create method");
+    });
   }
   async read(a, b) {
-    const columns = isStringArray(b) ? b : ["*"];
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      const ids = a.map((item) => isString(item) ? item : item.id).filter((id2) => isString(id2));
-      const finalObjects = await this.getAll({ filter: { id: { $any: ids } }, columns });
-      const dictionary = finalObjects.reduce((acc, object) => {
-        acc[object.id] = object;
-        return acc;
-      }, {});
-      return ids.map((id2) => dictionary[id2] ?? null);
-    }
-    const id = isString(a) ? a : a.id;
-    if (isString(id)) {
-      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-      try {
-        const response = await getRecord({
-          pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId: id },
-          queryParams: { columns },
-          ...fetchProps
-        });
-        const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-        return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response);
-      } catch (e) {
-        if (isObject(e) && e.status === 404) {
-          return null;
+    return __privateGet$4(this, _trace).call(this, "read", async () => {
+      const columns = isStringArray(b) ? b : ["*"];
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        const ids = a.map((item) => isString(item) ? item : item.id).filter((id2) => isString(id2));
+        const finalObjects = await this.getAll({ filter: { id: { $any: ids } }, columns });
+        const dictionary = finalObjects.reduce((acc, object) => {
+          acc[object.id] = object;
+          return acc;
+        }, {});
+        return ids.map((id2) => dictionary[id2] ?? null);
+      }
+      const id = isString(a) ? a : a.id;
+      if (isString(id)) {
+        const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+        try {
+          const response = await getRecord({
+            pathParams: {
+              workspace: "{workspaceId}",
+              dbBranchName: "{dbBranch}",
+              tableName: __privateGet$4(this, _table),
+              recordId: id
+            },
+            queryParams: { columns },
+            ...fetchProps
+          });
+          const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+          return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response);
+        } catch (e) {
+          if (isObject(e) && e.status === 404) {
+            return null;
+          }
+          throw e;
         }
-        throw e;
       }
-    }
-    return null;
+      return null;
+    });
   }
   async update(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+    return __privateGet$4(this, _trace).call(this, "update", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        if (a.length > 100) {
+          console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        const columns = isStringArray(b) ? b : ["*"];
+        return Promise.all(a.map((object) => this.update(object, columns)));
       }
-      const columns = isStringArray(b) ? b : ["*"];
-      return Promise.all(a.map((object) => this.update(object, columns)));
-    }
-    if (isString(a) && isObject(b)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      const columns = isStringArray(b) ? b : void 0;
-      return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    throw new Error("Invalid arguments for update method");
+      if (isString(a) && isObject(b)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a, b, columns);
+      }
+      if (isObject(a) && isString(a.id)) {
+        const columns = isStringArray(b) ? b : void 0;
+        return __privateMethod$2(this, _updateRecordWithID, updateRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
+      }
+      throw new Error("Invalid arguments for update method");
+    });
   }
   async createOrUpdate(a, b, c) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
-        return [];
-      if (a.length > 100) {
-        console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+    return __privateGet$4(this, _trace).call(this, "createOrUpdate", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return [];
+        if (a.length > 100) {
+          console.warn("Bulk update operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        const columns = isStringArray(b) ? b : ["*"];
+        return Promise.all(a.map((object) => this.createOrUpdate(object, columns)));
       }
-      const columns = isStringArray(b) ? b : ["*"];
-      return Promise.all(a.map((object) => this.createOrUpdate(object, columns)));
-    }
-    if (isString(a) && isObject(b)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns);
-    }
-    if (isObject(a) && isString(a.id)) {
-      const columns = isStringArray(c) ? c : void 0;
-      return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
-    }
-    throw new Error("Invalid arguments for createOrUpdate method");
+      if (isString(a) && isObject(b)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns);
+      }
+      if (isObject(a) && isString(a.id)) {
+        const columns = isStringArray(c) ? c : void 0;
+        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns);
+      }
+      throw new Error("Invalid arguments for createOrUpdate method");
+    });
   }
   async delete(a) {
-    if (Array.isArray(a)) {
-      if (a.length === 0)
+    return __privateGet$4(this, _trace).call(this, "delete", async () => {
+      if (Array.isArray(a)) {
+        if (a.length === 0)
+          return;
+        if (a.length > 100) {
+          console.warn("Bulk delete operation is not optimized in the Xata API yet, this request might be slow");
+        }
+        await Promise.all(a.map((id) => this.delete(id)));
         return;
-      if (a.length > 100) {
-        console.warn("Bulk delete operation is not optimized in the Xata API yet, this request might be slow");
       }
-      await Promise.all(a.map((id) => this.delete(id)));
-      return;
-    }
-    if (isString(a)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a);
-      return;
-    }
-    if (isObject(a) && isString(a.id)) {
-      await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id);
-      return;
-    }
-    throw new Error("Invalid arguments for delete method");
+      if (isString(a)) {
+        await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a);
+        return;
+      }
+      if (isObject(a) && isString(a.id)) {
+        await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id);
+        return;
+      }
+      throw new Error("Invalid arguments for delete method");
+    });
   }
   async search(query, options = {}) {
-    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-    const { records } = await searchTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
-      body: {
-        query,
-        fuzziness: options.fuzziness,
-        prefix: options.prefix,
-        highlight: options.highlight,
-        filter: options.filter,
-        boosters: options.boosters
-      },
-      ...fetchProps
+    return __privateGet$4(this, _trace).call(this, "search", async () => {
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const { records } = await searchTable({
+        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
+        body: {
+          query,
+          fuzziness: options.fuzziness,
+          prefix: options.prefix,
+          highlight: options.highlight,
+          filter: options.filter,
+          boosters: options.boosters
+        },
+        ...fetchProps
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+      return records.map((item) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), item));
     });
-    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-    return records.map((item) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), item));
   }
   async query(query) {
-    const cacheQuery = await __privateMethod$2(this, _getCacheQuery, getCacheQuery_fn).call(this, query);
-    if (cacheQuery)
-      return new Page(query, cacheQuery.meta, cacheQuery.records);
-    const data = query.getQueryOptions();
-    const body = {
-      filter: Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0,
-      sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
-      page: data.pagination,
-      columns: data.columns
-    };
-    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-    const { meta, records: objects } = await queryTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
-      body,
-      ...fetchProps
+    return __privateGet$4(this, _trace).call(this, "query", async () => {
+      const cacheQuery = await __privateMethod$2(this, _getCacheQuery, getCacheQuery_fn).call(this, query);
+      if (cacheQuery)
+        return new Page(query, cacheQuery.meta, cacheQuery.records);
+      const data = query.getQueryOptions();
+      const body = {
+        filter: Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0,
+        sort: data.sort !== void 0 ? buildSortFilter(data.sort) : void 0,
+        page: data.pagination,
+        columns: data.columns
+      };
+      const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+      const { meta, records: objects } = await queryTable({
+        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
+        body,
+        ...fetchProps
+      });
+      const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
+      const records = objects.map((record) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), record));
+      await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
+      return new Page(query, meta, records);
     });
-    const schemaTables = await __privateMethod$2(this, _getSchemaTables$1, getSchemaTables_fn$1).call(this);
-    const records = objects.map((record) => initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), record));
-    await __privateMethod$2(this, _setCacheQuery, setCacheQuery_fn).call(this, query, meta, records);
-    return new Page(query, meta, records);
   }
 }
 _table = new WeakMap();
@@ -1525,6 +1619,7 @@ _getFetchProps = new WeakMap();
 _db = new WeakMap();
 _cache = new WeakMap();
 _schemaTables$2 = new WeakMap();
+_trace = new WeakMap();
 _insertRecordWithoutId = new WeakSet();
 insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
@@ -1745,18 +1840,25 @@ class SimpleCache {
 }
 _map = new WeakMap();
 
-const gt = (value) => ({ $gt: value });
-const ge = (value) => ({ $ge: value });
-const gte = (value) => ({ $ge: value });
-const lt = (value) => ({ $lt: value });
-const lte = (value) => ({ $le: value });
-const le = (value) => ({ $le: value });
+const greaterThan = (value) => ({ $gt: value });
+const gt = greaterThan;
+const greaterThanEquals = (value) => ({ $ge: value });
+const greaterEquals = greaterThanEquals;
+const gte = greaterThanEquals;
+const ge = greaterThanEquals;
+const lessThan = (value) => ({ $lt: value });
+const lt = lessThan;
+const lessThanEquals = (value) => ({ $le: value });
+const lessEquals = lessThanEquals;
+const lte = lessThanEquals;
+const le = lessThanEquals;
 const exists = (column) => ({ $exists: column });
 const notExists = (column) => ({ $notExists: column });
 const startsWith = (value) => ({ $startsWith: value });
 const endsWith = (value) => ({ $endsWith: value });
 const pattern = (value) => ({ $pattern: value });
 const is = (value) => ({ $is: value });
+const equals = is;
 const isNot = (value) => ({ $isNot: value });
 const contains = (value) => ({ $contains: value });
 const includes = (value) => ({ $includes: value });
@@ -1933,7 +2035,8 @@ async function resolveXataBranch(gitBranch, options) {
     fetchImpl: getFetchImplementation(options?.fetchImpl),
     workspacesApiUrl: `${protocol}//${host}`,
     pathParams: { dbName, workspace },
-    queryParams: { gitBranch, fallbackBranch }
+    queryParams: { gitBranch, fallbackBranch },
+    trace: defaultTrace
   });
   return branch;
 }
@@ -1957,7 +2060,8 @@ async function getDatabaseBranch(branch, options) {
       apiUrl: databaseURL,
       fetchImpl: getFetchImplementation(options?.fetchImpl),
       workspacesApiUrl: `${protocol}//${host}`,
-      pathParams: { dbBranchName, workspace }
+      pathParams: { dbBranchName, workspace },
+      trace: defaultTrace
     });
   } catch (err) {
     if (isObject(err) && err.status === 404)
@@ -2009,7 +2113,8 @@ const buildClient = (plugins) => {
       __privateSet(this, _options, safeOptions);
       const pluginOptions = {
         getFetchProps: () => __privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
-        cache: safeOptions.cache
+        cache: safeOptions.cache,
+        trace: safeOptions.trace
       };
       const db = new SchemaPlugin(schemaTables).build(pluginOptions);
       const search = new SearchPlugin(db, schemaTables).build(pluginOptions);
@@ -2038,12 +2143,16 @@ const buildClient = (plugins) => {
     const databaseURL = options?.databaseURL || getDatabaseURL();
     const apiKey = options?.apiKey || getAPIKey();
     const cache = options?.cache ?? new SimpleCache({ defaultQueryTTL: 0 });
+    const trace = options?.trace ?? defaultTrace;
     const branch = async () => options?.branch !== void 0 ? await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, options.branch) : await getCurrentBranchName({ apiKey, databaseURL, fetchImpl: options?.fetch });
-    if (!databaseURL || !apiKey) {
-      throw new Error("Options databaseURL and apiKey are required");
+    if (!apiKey) {
+      throw new Error("Option apiKey is required");
+    }
+    if (!databaseURL) {
+      throw new Error("Option databaseURL is required");
     }
-    return { fetch, databaseURL, apiKey, branch, cache };
-  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({ fetch, apiKey, databaseURL, branch }) {
+    return { fetch, databaseURL, apiKey, branch, cache, trace };
+  }, _getFetchProps = new WeakSet(), getFetchProps_fn = async function({ fetch, apiKey, databaseURL, branch, trace }) {
     const branchValue = await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, branch);
     if (!branchValue)
       throw new Error("Unable to resolve branch value");
@@ -2055,7 +2164,8 @@ const buildClient = (plugins) => {
         const hasBranch = params.dbBranchName ?? params.branch;
         const newPath = path.replace(/^\/db\/[^/]+/, hasBranch ? `:${branchValue}` : "");
         return databaseURL + newPath;
-      }
+      },
+      trace
     };
   }, _evaluateBranch = new WeakSet(), evaluateBranch_fn = async function(param) {
     if (__privateGet(this, _branch))
@@ -2078,6 +2188,88 @@ const buildClient = (plugins) => {
 class BaseClient extends buildClient() {
 }
 
+const META = "__";
+const VALUE = "___";
+class Serializer {
+  constructor() {
+    this.classes = {};
+  }
+  add(clazz) {
+    this.classes[clazz.name] = clazz;
+  }
+  toJSON(data) {
+    function visit(obj) {
+      if (Array.isArray(obj))
+        return obj.map(visit);
+      const type = typeof obj;
+      if (type === "undefined")
+        return { [META]: "undefined" };
+      if (type === "bigint")
+        return { [META]: "bigint", [VALUE]: obj.toString() };
+      if (obj === null || type !== "object")
+        return obj;
+      const constructor = obj.constructor;
+      const o = { [META]: constructor.name };
+      for (const [key, value] of Object.entries(obj)) {
+        o[key] = visit(value);
+      }
+      if (constructor === Date)
+        o[VALUE] = obj.toISOString();
+      if (constructor === Map)
+        o[VALUE] = Object.fromEntries(obj);
+      if (constructor === Set)
+        o[VALUE] = [...obj];
+      return o;
+    }
+    return JSON.stringify(visit(data));
+  }
+  fromJSON(json) {
+    return JSON.parse(json, (key, value) => {
+      if (value && typeof value === "object" && !Array.isArray(value)) {
+        const { [META]: clazz, [VALUE]: val, ...rest } = value;
+        const constructor = this.classes[clazz];
+        if (constructor) {
+          return Object.assign(Object.create(constructor.prototype), rest);
+        }
+        if (clazz === "Date")
+          return new Date(val);
+        if (clazz === "Set")
+          return new Set(val);
+        if (clazz === "Map")
+          return new Map(Object.entries(val));
+        if (clazz === "bigint")
+          return BigInt(val);
+        if (clazz === "undefined")
+          return void 0;
+        return rest;
+      }
+      return value;
+    });
+  }
+}
+const defaultSerializer = new Serializer();
+const serialize = (data) => {
+  return defaultSerializer.toJSON(data);
+};
+const deserialize = (json) => {
+  return defaultSerializer.fromJSON(json);
+};
+
+function buildWorkerRunner(config) {
+  return function xataWorker(name, _worker) {
+    return async (...args) => {
+      const url = process.env.NODE_ENV === "development" ? `http://localhost:64749/${name}` : `https://dispatcher.xata.workers.dev/${config.workspace}/${config.worker}/${name}`;
+      const result = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: serialize({ args })
+      });
+      const text = await result.text();
+      return deserialize(text);
+    };
+  };
+}
+
 class XataError extends Error {
   constructor(message, status) {
     super(message);
@@ -2098,6 +2290,7 @@ exports.Repository = Repository;
 exports.RestRepository = RestRepository;
 exports.SchemaPlugin = SchemaPlugin;
 exports.SearchPlugin = SearchPlugin;
+exports.Serializer = Serializer;
 exports.SimpleCache = SimpleCache;
 exports.XataApiClient = XataApiClient;
 exports.XataApiPlugin = XataApiPlugin;
@@ -2107,6 +2300,7 @@ exports.acceptWorkspaceMemberInvite = acceptWorkspaceMemberInvite;
 exports.addGitBranchesEntry = addGitBranchesEntry;
 exports.addTableColumn = addTableColumn;
 exports.buildClient = buildClient;
+exports.buildWorkerRunner = buildWorkerRunner;
 exports.bulkInsertTableRecords = bulkInsertTableRecords;
 exports.cancelWorkspaceMemberInvite = cancelWorkspaceMemberInvite;
 exports.contains = contains;
@@ -2123,7 +2317,9 @@ exports.deleteTable = deleteTable;
 exports.deleteUser = deleteUser;
 exports.deleteUserAPIKey = deleteUserAPIKey;
 exports.deleteWorkspace = deleteWorkspace;
+exports.deserialize = deserialize;
 exports.endsWith = endsWith;
+exports.equals = equals;
 exports.executeBranchMigrationPlan = executeBranchMigrationPlan;
 exports.exists = exists;
 exports.ge = ge;
@@ -2138,6 +2334,7 @@ exports.getColumn = getColumn;
 exports.getCurrentBranchDetails = getCurrentBranchDetails;
 exports.getCurrentBranchName = getCurrentBranchName;
 exports.getDatabaseList = getDatabaseList;
+exports.getDatabaseMetadata = getDatabaseMetadata;
 exports.getDatabaseURL = getDatabaseURL;
 exports.getGitBranchesMapping = getGitBranchesMapping;
 exports.getRecord = getRecord;
@@ -2148,6 +2345,9 @@ exports.getUserAPIKeys = getUserAPIKeys;
 exports.getWorkspace = getWorkspace;
 exports.getWorkspaceMembersList = getWorkspaceMembersList;
 exports.getWorkspacesList = getWorkspacesList;
+exports.greaterEquals = greaterEquals;
+exports.greaterThan = greaterThan;
+exports.greaterThanEquals = greaterThanEquals;
 exports.gt = gt;
 exports.gte = gte;
 exports.includes = includes;
@@ -2163,6 +2363,9 @@ exports.isIdentifiable = isIdentifiable;
 exports.isNot = isNot;
 exports.isXataRecord = isXataRecord;
 exports.le = le;
+exports.lessEquals = lessEquals;
+exports.lessThan = lessThan;
+exports.lessThanEquals = lessThanEquals;
 exports.lt = lt;
 exports.lte = lte;
 exports.notExists = notExists;
@@ -2175,6 +2378,7 @@ exports.resendWorkspaceMemberInvite = resendWorkspaceMemberInvite;
 exports.resolveBranch = resolveBranch;
 exports.searchBranch = searchBranch;
 exports.searchTable = searchTable;
+exports.serialize = serialize;
 exports.setTableSchema = setTableSchema;
 exports.startsWith = startsWith;
 exports.updateBranchMetadata = updateBranchMetadata;