@xata.io/client 0.0.0-alpha.vfd071d9 → 0.0.0-alpha.vfde9dcf

package/dist/index.cjs

@@ -11,8 +11,11 @@ function compact(arr) {
 function isObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
+function isDefined(value) {
+  return value !== null && value !== void 0;
+}
 function isString(value) {
-  return value !== void 0 && value !== null && typeof value === "string";
+  return isDefined(value) && typeof value === "string";
 }
 function toBase64(value) {
   try {
@@ -370,6 +373,11 @@ const queryTable = (variables) => fetch$1({
   method: "post",
   ...variables
 });
+const searchTable = (variables) => fetch$1({
+  url: "/db/{dbBranchName}/tables/{tableName}/search",
+  method: "post",
+  ...variables
+});
 const searchBranch = (variables) => fetch$1({
   url: "/db/{dbBranchName}/search",
   method: "post",
@@ -433,6 +441,7 @@ const operationsByTag = {
     getRecord,
     bulkInsertTableRecords,
     queryTable,
+    searchTable,
     searchBranch
   }
 };
@@ -466,7 +475,7 @@ var __accessCheck$7 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$6 = (obj, member, getter) => {
+var __privateGet$7 = (obj, member, getter) => {
   __accessCheck$7(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -475,7 +484,7 @@ var __privateAdd$7 = (obj, member, value) => {
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$5 = (obj, member, value, setter) => {
+var __privateSet$6 = (obj, member, value, setter) => {
   __accessCheck$7(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
@@ -490,7 +499,7 @@ class XataApiClient {
     if (!apiKey) {
       throw new Error("Could not resolve a valid apiKey");
     }
-    __privateSet$5(this, _extraProps, {
+    __privateSet$6(this, _extraProps, {
       apiUrl: getHostUrl(provider, "main"),
       workspacesApiUrl: getHostUrl(provider, "workspaces"),
       fetchImpl: getFetchImplementation(options.fetch),
@@ -498,34 +507,34 @@ class XataApiClient {
     });
   }
   get user() {
-    if (!__privateGet$6(this, _namespaces).user)
-      __privateGet$6(this, _namespaces).user = new UserApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).user;
+    if (!__privateGet$7(this, _namespaces).user)
+      __privateGet$7(this, _namespaces).user = new UserApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).user;
   }
   get workspaces() {
-    if (!__privateGet$6(this, _namespaces).workspaces)
-      __privateGet$6(this, _namespaces).workspaces = new WorkspaceApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).workspaces;
+    if (!__privateGet$7(this, _namespaces).workspaces)
+      __privateGet$7(this, _namespaces).workspaces = new WorkspaceApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).workspaces;
   }
   get databases() {
-    if (!__privateGet$6(this, _namespaces).databases)
-      __privateGet$6(this, _namespaces).databases = new DatabaseApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).databases;
+    if (!__privateGet$7(this, _namespaces).databases)
+      __privateGet$7(this, _namespaces).databases = new DatabaseApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).databases;
   }
   get branches() {
-    if (!__privateGet$6(this, _namespaces).branches)
-      __privateGet$6(this, _namespaces).branches = new BranchApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).branches;
+    if (!__privateGet$7(this, _namespaces).branches)
+      __privateGet$7(this, _namespaces).branches = new BranchApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).branches;
   }
   get tables() {
-    if (!__privateGet$6(this, _namespaces).tables)
-      __privateGet$6(this, _namespaces).tables = new TableApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).tables;
+    if (!__privateGet$7(this, _namespaces).tables)
+      __privateGet$7(this, _namespaces).tables = new TableApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).tables;
   }
   get records() {
-    if (!__privateGet$6(this, _namespaces).records)
-      __privateGet$6(this, _namespaces).records = new RecordsApi(__privateGet$6(this, _extraProps));
-    return __privateGet$6(this, _namespaces).records;
+    if (!__privateGet$7(this, _namespaces).records)
+      __privateGet$7(this, _namespaces).records = new RecordsApi(__privateGet$7(this, _extraProps));
+    return __privateGet$7(this, _namespaces).records;
   }
 }
 _extraProps = new WeakMap();
@@ -703,10 +712,10 @@ class BranchApi {
       ...this.extraProps
     });
   }
-  createBranch(workspace, database, branch, from = "", options = {}) {
+  createBranch(workspace, database, branch, from, options = {}) {
     return operationsByTag.branch.createBranch({
       pathParams: { workspace, dbBranchName: `${database}:${branch}` },
-      queryParams: { from },
+      queryParams: isString(from) ? { from } : void 0,
       body: options,
       ...this.extraProps
     });
@@ -888,6 +897,13 @@ class RecordsApi {
       ...this.extraProps
     });
   }
+  searchTable(workspace, database, branch, tableName, query) {
+    return operationsByTag.records.searchTable({
+      pathParams: { workspace, dbBranchName: `${database}:${branch}`, tableName },
+      body: query,
+      ...this.extraProps
+    });
+  }
   searchBranch(workspace, database, branch, query) {
     return operationsByTag.records.searchBranch({
       pathParams: { workspace, dbBranchName: `${database}:${branch}` },
@@ -911,7 +927,7 @@ var __accessCheck$6 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$5 = (obj, member, getter) => {
+var __privateGet$6 = (obj, member, getter) => {
   __accessCheck$6(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -920,7 +936,7 @@ var __privateAdd$6 = (obj, member, value) => {
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$4 = (obj, member, value, setter) => {
+var __privateSet$5 = (obj, member, value, setter) => {
   __accessCheck$6(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
@@ -929,21 +945,21 @@ var _query;
 class Page {
   constructor(query, meta, records = []) {
     __privateAdd$6(this, _query, void 0);
-    __privateSet$4(this, _query, query);
+    __privateSet$5(this, _query, query);
     this.meta = meta;
     this.records = records;
   }
   async nextPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, after: this.meta.page.cursor } });
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, after: this.meta.page.cursor } });
   }
   async previousPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, before: this.meta.page.cursor } });
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, before: this.meta.page.cursor } });
   }
   async firstPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, first: this.meta.page.cursor } });
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, first: this.meta.page.cursor } });
   }
   async lastPage(size, offset) {
-    return __privateGet$5(this, _query).getPaginated({ page: { size, offset, last: this.meta.page.cursor } });
+    return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, last: this.meta.page.cursor } });
   }
   hasNextPage() {
     return this.meta.page.more;
@@ -954,12 +970,15 @@ const PAGINATION_MAX_SIZE = 200;
 const PAGINATION_DEFAULT_SIZE = 200;
 const PAGINATION_MAX_OFFSET = 800;
 const PAGINATION_DEFAULT_OFFSET = 0;
+function isCursorPaginationOptions(options) {
+  return isDefined(options) && (isDefined(options.first) || isDefined(options.last) || isDefined(options.after) || isDefined(options.before));
+}
 
 var __accessCheck$5 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$4 = (obj, member, getter) => {
+var __privateGet$5 = (obj, member, getter) => {
   __accessCheck$5(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -968,7 +987,7 @@ var __privateAdd$5 = (obj, member, value) => {
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$3 = (obj, member, value, setter) => {
+var __privateSet$4 = (obj, member, value, setter) => {
   __accessCheck$5(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
@@ -981,21 +1000,21 @@ const _Query = class {
     __privateAdd$5(this, _data, { filter: {} });
     this.meta = { page: { cursor: "start", more: true } };
     this.records = [];
-    __privateSet$3(this, _table$1, table);
+    __privateSet$4(this, _table$1, table);
     if (repository) {
-      __privateSet$3(this, _repository, repository);
+      __privateSet$4(this, _repository, repository);
     } else {
-      __privateSet$3(this, _repository, this);
+      __privateSet$4(this, _repository, this);
     }
-    __privateGet$4(this, _data).filter = data.filter ?? parent?.filter ?? {};
-    __privateGet$4(this, _data).filter.$any = data.filter?.$any ?? parent?.filter?.$any;
-    __privateGet$4(this, _data).filter.$all = data.filter?.$all ?? parent?.filter?.$all;
-    __privateGet$4(this, _data).filter.$not = data.filter?.$not ?? parent?.filter?.$not;
-    __privateGet$4(this, _data).filter.$none = data.filter?.$none ?? parent?.filter?.$none;
-    __privateGet$4(this, _data).sort = data.sort ?? parent?.sort;
-    __privateGet$4(this, _data).columns = data.columns ?? parent?.columns ?? ["*"];
-    __privateGet$4(this, _data).page = data.page ?? parent?.page;
-    __privateGet$4(this, _data).cache = data.cache ?? parent?.cache;
+    __privateGet$5(this, _data).filter = data.filter ?? parent?.filter ?? {};
+    __privateGet$5(this, _data).filter.$any = data.filter?.$any ?? parent?.filter?.$any;
+    __privateGet$5(this, _data).filter.$all = data.filter?.$all ?? parent?.filter?.$all;
+    __privateGet$5(this, _data).filter.$not = data.filter?.$not ?? parent?.filter?.$not;
+    __privateGet$5(this, _data).filter.$none = data.filter?.$none ?? parent?.filter?.$none;
+    __privateGet$5(this, _data).sort = data.sort ?? parent?.sort;
+    __privateGet$5(this, _data).columns = data.columns ?? parent?.columns ?? ["*"];
+    __privateGet$5(this, _data).pagination = data.pagination ?? parent?.pagination;
+    __privateGet$5(this, _data).cache = data.cache ?? parent?.cache;
     this.any = this.any.bind(this);
     this.all = this.all.bind(this);
     this.not = this.not.bind(this);
@@ -1006,83 +1025,85 @@ const _Query = class {
     Object.defineProperty(this, "repository", { enumerable: false });
   }
   getQueryOptions() {
-    return __privateGet$4(this, _data);
+    return __privateGet$5(this, _data);
   }
   key() {
-    const { columns = [], filter = {}, sort = [], page = {} } = __privateGet$4(this, _data);
-    const key = JSON.stringify({ columns, filter, sort, page });
+    const { columns = [], filter = {}, sort = [], pagination = {} } = __privateGet$5(this, _data);
+    const key = JSON.stringify({ columns, filter, sort, pagination });
     return toBase64(key);
   }
   any(...queries) {
     const $any = queries.map((query) => query.getQueryOptions().filter ?? {});
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $any } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $any } }, __privateGet$5(this, _data));
   }
   all(...queries) {
     const $all = queries.map((query) => query.getQueryOptions().filter ?? {});
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
   }
   not(...queries) {
     const $not = queries.map((query) => query.getQueryOptions().filter ?? {});
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $not } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $not } }, __privateGet$5(this, _data));
   }
   none(...queries) {
     const $none = queries.map((query) => query.getQueryOptions().filter ?? {});
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $none } }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $none } }, __privateGet$5(this, _data));
   }
   filter(a, b) {
     if (arguments.length === 1) {
       const constraints = Object.entries(a).map(([column, constraint]) => ({ [column]: constraint }));
-      const $all = compact([__privateGet$4(this, _data).filter?.$all].flat().concat(constraints));
-      return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+      const $all = compact([__privateGet$5(this, _data).filter?.$all].flat().concat(constraints));
+      return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
     } else {
-      const $all = compact([__privateGet$4(this, _data).filter?.$all].flat().concat([{ [a]: b }]));
-      return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { filter: { $all } }, __privateGet$4(this, _data));
+      const $all = compact([__privateGet$5(this, _data).filter?.$all].flat().concat([{ [a]: b }]));
+      return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
     }
   }
   sort(column, direction) {
-    const originalSort = [__privateGet$4(this, _data).sort ?? []].flat();
+    const originalSort = [__privateGet$5(this, _data).sort ?? []].flat();
     const sort = [...originalSort, { column, direction }];
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { sort }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { sort }, __privateGet$5(this, _data));
   }
   select(columns) {
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { columns }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { columns }, __privateGet$5(this, _data));
   }
   getPaginated(options = {}) {
-    const query = new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), options, __privateGet$4(this, _data));
-    return __privateGet$4(this, _repository).query(query);
+    const query = new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), options, __privateGet$5(this, _data));
+    return __privateGet$5(this, _repository).query(query);
   }
   async *[Symbol.asyncIterator]() {
-    for await (const [record] of this.getIterator(1)) {
+    for await (const [record] of this.getIterator({ batchSize: 1 })) {
       yield record;
     }
   }
-  async *getIterator(chunk, options = {}) {
-    let offset = 0;
-    let end = false;
-    while (!end) {
-      const { records, meta } = await this.getPaginated({ ...options, page: { size: chunk, offset } });
-      yield records;
-      offset += chunk;
-      end = !meta.page.more;
+  async *getIterator(options = {}) {
+    const { batchSize = 1 } = options;
+    let page = await this.getPaginated({ ...options, pagination: { size: batchSize, offset: 0 } });
+    let more = page.hasNextPage();
+    yield page.records;
+    while (more) {
+      page = await page.nextPage();
+      more = page.hasNextPage();
+      yield page.records;
     }
   }
   async getMany(options = {}) {
     const { records } = await this.getPaginated(options);
     return records;
   }
-  async getAll(chunk = PAGINATION_MAX_SIZE, options = {}) {
+  async getAll(options = {}) {
+    const { batchSize = PAGINATION_MAX_SIZE, ...rest } = options;
     const results = [];
-    for await (const page of this.getIterator(chunk, options)) {
+    for await (const page of this.getIterator({ ...rest, batchSize })) {
       results.push(...page);
     }
     return results;
   }
   async getFirst(options = {}) {
-    const records = await this.getMany({ ...options, page: { size: 1 } });
-    return records[0] || null;
+    const records = await this.getMany({ ...options, pagination: { size: 1 } });
+    return records[0] ?? null;
   }
   cache(ttl) {
-    return new _Query(__privateGet$4(this, _repository), __privateGet$4(this, _table$1), { cache: ttl }, __privateGet$4(this, _data));
+    return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { cache: ttl }, __privateGet$5(this, _data));
   }
   nextPage(size, offset) {
     return this.firstPage(size, offset);
@@ -1091,10 +1112,10 @@ const _Query = class {
     return this.firstPage(size, offset);
   }
   firstPage(size, offset) {
-    return this.getPaginated({ page: { size, offset } });
+    return this.getPaginated({ pagination: { size, offset } });
   }
   lastPage(size, offset) {
-    return this.getPaginated({ page: { size, offset, before: "end" } });
+    return this.getPaginated({ pagination: { size, offset, before: "end" } });
   }
   hasNextPage() {
     return this.meta.page.more;
@@ -1139,7 +1160,7 @@ var __accessCheck$4 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$3 = (obj, member, getter) => {
+var __privateGet$4 = (obj, member, getter) => {
   __accessCheck$4(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -1148,7 +1169,7 @@ var __privateAdd$4 = (obj, member, value) => {
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$2 = (obj, member, value, setter) => {
+var __privateSet$3 = (obj, member, value, setter) => {
   __accessCheck$4(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
@@ -1157,7 +1178,7 @@ var __privateMethod$2 = (obj, member, method) => {
   __accessCheck$4(obj, member, "access private method");
   return method;
 };
-var _table, _links, _getFetchProps, _cache, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _invalidateCache, invalidateCache_fn, _setCacheRecord, setCacheRecord_fn, _getCacheRecord, getCacheRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn;
+var _table, _getFetchProps, _cache, _schema$1, _insertRecordWithoutId, insertRecordWithoutId_fn, _insertRecordWithId, insertRecordWithId_fn, _bulkInsertTableRecords, bulkInsertTableRecords_fn, _updateRecordWithID, updateRecordWithID_fn, _upsertRecordWithID, upsertRecordWithID_fn, _deleteRecord, deleteRecord_fn, _invalidateCache, invalidateCache_fn, _setCacheRecord, setCacheRecord_fn, _getCacheRecord, getCacheRecord_fn, _setCacheQuery, setCacheQuery_fn, _getCacheQuery, getCacheQuery_fn, _getSchema$1, getSchema_fn$1;
 class Repository extends Query {
 }
 class RestRepository extends Query {
@@ -1174,15 +1195,15 @@ class RestRepository extends Query {
     __privateAdd$4(this, _getCacheRecord);
     __privateAdd$4(this, _setCacheQuery);
     __privateAdd$4(this, _getCacheQuery);
+    __privateAdd$4(this, _getSchema$1);
     __privateAdd$4(this, _table, void 0);
-    __privateAdd$4(this, _links, void 0);
     __privateAdd$4(this, _getFetchProps, void 0);
     __privateAdd$4(this, _cache, void 0);
-    __privateSet$2(this, _table, options.table);
-    __privateSet$2(this, _links, options.links ?? {});
-    __privateSet$2(this, _getFetchProps, options.pluginOptions.getFetchProps);
+    __privateAdd$4(this, _schema$1, void 0);
+    __privateSet$3(this, _table, options.table);
+    __privateSet$3(this, _getFetchProps, options.pluginOptions.getFetchProps);
     this.db = options.db;
-    __privateSet$2(this, _cache, options.pluginOptions.cache);
+    __privateSet$3(this, _cache, options.pluginOptions.cache);
   }
   async create(a, b) {
     if (Array.isArray(a)) {
@@ -1215,13 +1236,14 @@ class RestRepository extends Query {
     const cacheRecord = await __privateMethod$2(this, _getCacheRecord, getCacheRecord_fn).call(this, recordId);
     if (cacheRecord)
       return cacheRecord;
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
     try {
       const response = await getRecord({
-        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
+        pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
         ...fetchProps
       });
-      return initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), response);
+      const schema = await __privateMethod$2(this, _getSchema$1, getSchema_fn$1).call(this);
+      return initObject(this.db, schema, __privateGet$4(this, _table), response);
     } catch (e) {
       if (isObject(e) && e.status === 404) {
         return null;
@@ -1292,49 +1314,58 @@ class RestRepository extends Query {
     throw new Error("Invalid arguments for delete method");
   }
   async search(query, options = {}) {
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
-    const { records } = await searchBranch({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
-      body: { tables: [__privateGet$3(this, _table)], query, fuzziness: options.fuzziness },
+    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,
+        filter: options.filter
+      },
       ...fetchProps
     });
-    return records.map((item) => initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), item));
+    const schema = await __privateMethod$2(this, _getSchema$1, getSchema_fn$1).call(this);
+    return records.map((item) => initObject(this.db, schema, __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 filter = Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0;
+    const sort = data.sort !== void 0 ? buildSortFilter(data.sort) : void 0;
+    const isCursorPagination = isCursorPaginationOptions(data.pagination);
     const body = {
-      filter: Object.values(data.filter ?? {}).some(Boolean) ? data.filter : void 0,
-      sort: data.sort ? buildSortFilter(data.sort) : void 0,
-      page: data.page,
+      filter: isCursorPagination ? void 0 : filter,
+      sort: isCursorPagination ? void 0 : sort,
+      page: data.pagination,
       columns: data.columns
     };
-    const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+    const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
     const { meta, records: objects } = await queryTable({
-      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table) },
+      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
       body,
       ...fetchProps
     });
-    const records = objects.map((record) => initObject(this.db, __privateGet$3(this, _links), __privateGet$3(this, _table), record));
+    const schema = await __privateMethod$2(this, _getSchema$1, getSchema_fn$1).call(this);
+    const records = objects.map((record) => initObject(this.db, schema, __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();
-_links = new WeakMap();
 _getFetchProps = new WeakMap();
 _cache = new WeakMap();
+_schema$1 = new WeakMap();
 _insertRecordWithoutId = new WeakSet();
 insertRecordWithoutId_fn = async function(object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
   const response = await insertRecord({
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
-      tableName: __privateGet$3(this, _table)
+      tableName: __privateGet$4(this, _table)
     },
     body: record,
     ...fetchProps
@@ -1347,13 +1378,13 @@ insertRecordWithoutId_fn = async function(object) {
 };
 _insertRecordWithId = new WeakSet();
 insertRecordWithId_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
   const response = await insertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
       dbBranchName: "{dbBranch}",
-      tableName: __privateGet$3(this, _table),
+      tableName: __privateGet$4(this, _table),
       recordId
     },
     body: record,
@@ -1368,10 +1399,10 @@ insertRecordWithId_fn = async function(recordId, object) {
 };
 _bulkInsertTableRecords = new WeakSet();
 bulkInsertTableRecords_fn = async function(objects) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const records = objects.map((object) => transformObjectLinks(object));
   const response = await bulkInsertTableRecords({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table) },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table) },
     body: { records },
     ...fetchProps
   });
@@ -1383,10 +1414,10 @@ bulkInsertTableRecords_fn = async function(objects) {
 };
 _updateRecordWithID = new WeakSet();
 updateRecordWithID_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
   const response = await updateRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
     body: record,
     ...fetchProps
   });
@@ -1397,9 +1428,9 @@ updateRecordWithID_fn = async function(recordId, object) {
 };
 _upsertRecordWithID = new WeakSet();
 upsertRecordWithID_fn = async function(recordId, object) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const response = await upsertRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
     body: object,
     ...fetchProps
   });
@@ -1410,51 +1441,63 @@ upsertRecordWithID_fn = async function(recordId, object) {
 };
 _deleteRecord = new WeakSet();
 deleteRecord_fn = async function(recordId) {
-  const fetchProps = await __privateGet$3(this, _getFetchProps).call(this);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   await deleteRecord({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$3(this, _table), recordId },
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
     ...fetchProps
   });
 };
 _invalidateCache = new WeakSet();
 invalidateCache_fn = async function(recordId) {
-  await __privateGet$3(this, _cache).delete(`rec_${__privateGet$3(this, _table)}:${recordId}`);
-  const cacheItems = await __privateGet$3(this, _cache).getAll();
+  await __privateGet$4(this, _cache).delete(`rec_${__privateGet$4(this, _table)}:${recordId}`);
+  const cacheItems = await __privateGet$4(this, _cache).getAll();
   const queries = Object.entries(cacheItems).filter(([key]) => key.startsWith("query_"));
   for (const [key, value] of queries) {
     const ids = getIds(value);
     if (ids.includes(recordId))
-      await __privateGet$3(this, _cache).delete(key);
+      await __privateGet$4(this, _cache).delete(key);
   }
 };
 _setCacheRecord = new WeakSet();
 setCacheRecord_fn = async function(record) {
-  if (!__privateGet$3(this, _cache).cacheRecords)
+  if (!__privateGet$4(this, _cache).cacheRecords)
     return;
-  await __privateGet$3(this, _cache).set(`rec_${__privateGet$3(this, _table)}:${record.id}`, record);
+  await __privateGet$4(this, _cache).set(`rec_${__privateGet$4(this, _table)}:${record.id}`, record);
 };
 _getCacheRecord = new WeakSet();
 getCacheRecord_fn = async function(recordId) {
-  if (!__privateGet$3(this, _cache).cacheRecords)
+  if (!__privateGet$4(this, _cache).cacheRecords)
     return null;
-  return __privateGet$3(this, _cache).get(`rec_${__privateGet$3(this, _table)}:${recordId}`);
+  return __privateGet$4(this, _cache).get(`rec_${__privateGet$4(this, _table)}:${recordId}`);
 };
 _setCacheQuery = new WeakSet();
 setCacheQuery_fn = async function(query, meta, records) {
-  await __privateGet$3(this, _cache).set(`query_${__privateGet$3(this, _table)}:${query.key()}`, { date: new Date(), meta, records });
+  await __privateGet$4(this, _cache).set(`query_${__privateGet$4(this, _table)}:${query.key()}`, { date: new Date(), meta, records });
 };
 _getCacheQuery = new WeakSet();
 getCacheQuery_fn = async function(query) {
-  const key = `query_${__privateGet$3(this, _table)}:${query.key()}`;
-  const result = await __privateGet$3(this, _cache).get(key);
+  const key = `query_${__privateGet$4(this, _table)}:${query.key()}`;
+  const result = await __privateGet$4(this, _cache).get(key);
   if (!result)
     return null;
-  const { cache: ttl = __privateGet$3(this, _cache).defaultQueryTTL } = query.getQueryOptions();
-  if (!ttl || ttl < 0)
-    return result;
+  const { cache: ttl = __privateGet$4(this, _cache).defaultQueryTTL } = query.getQueryOptions();
+  if (ttl < 0)
+    return null;
   const hasExpired = result.date.getTime() + ttl < Date.now();
   return hasExpired ? null : result;
 };
+_getSchema$1 = new WeakSet();
+getSchema_fn$1 = async function() {
+  if (__privateGet$4(this, _schema$1))
+    return __privateGet$4(this, _schema$1);
+  const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
+  const { schema } = await getBranchDetails({
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
+    ...fetchProps
+  });
+  __privateSet$3(this, _schema$1, schema);
+  return schema;
+};
 const transformObjectLinks = (object) => {
   return Object.entries(object).reduce((acc, [key, value]) => {
     if (key === "xata")
@@ -1462,15 +1505,33 @@ const transformObjectLinks = (object) => {
     return { ...acc, [key]: isIdentifiable(value) ? value.id : value };
   }, {});
 };
-const initObject = (db, links, table, object) => {
+const initObject = (db, schema, table, object) => {
   const result = {};
   Object.assign(result, object);
-  const tableLinks = links[table] || [];
-  for (const link of tableLinks) {
-    const [field, linkTable] = link;
-    const value = result[field];
-    if (value && isObject(value)) {
-      result[field] = initObject(db, links, linkTable, value);
+  const { columns } = schema.tables.find(({ name }) => name === table) ?? {};
+  if (!columns)
+    console.error(`Table ${table} not found in schema`);
+  for (const column of columns ?? []) {
+    const value = result[column.name];
+    switch (column.type) {
+      case "datetime": {
+        const date = new Date(value);
+        if (isNaN(date.getTime())) {
+          console.error(`Failed to parse date ${value} for field ${column.name}`);
+        } else {
+          result[column.name] = date;
+        }
+        break;
+      }
+      case "link": {
+        const linkTable = column.link?.table;
+        if (!linkTable) {
+          console.error(`Failed to parse link for field ${column.name}`);
+        } else if (isObject(value)) {
+          result[column.name] = initObject(db, schema, linkTable, value);
+        }
+        break;
+      }
     }
   }
   result.read = function() {
@@ -1502,7 +1563,7 @@ var __accessCheck$3 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$2 = (obj, member, getter) => {
+var __privateGet$3 = (obj, member, getter) => {
   __accessCheck$3(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -1511,7 +1572,7 @@ var __privateAdd$3 = (obj, member, value) => {
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
-var __privateSet$1 = (obj, member, value, setter) => {
+var __privateSet$2 = (obj, member, value, setter) => {
   __accessCheck$3(obj, member, "write to private field");
   setter ? setter.call(obj, value) : member.set(obj, value);
   return value;
@@ -1520,30 +1581,30 @@ var _map;
 class SimpleCache {
   constructor(options = {}) {
     __privateAdd$3(this, _map, void 0);
-    __privateSet$1(this, _map, /* @__PURE__ */ new Map());
+    __privateSet$2(this, _map, /* @__PURE__ */ new Map());
     this.capacity = options.max ?? 500;
     this.cacheRecords = options.cacheRecords ?? true;
     this.defaultQueryTTL = options.defaultQueryTTL ?? 60 * 1e3;
   }
   async getAll() {
-    return Object.fromEntries(__privateGet$2(this, _map));
+    return Object.fromEntries(__privateGet$3(this, _map));
   }
   async get(key) {
-    return __privateGet$2(this, _map).get(key) ?? null;
+    return __privateGet$3(this, _map).get(key) ?? null;
   }
   async set(key, value) {
     await this.delete(key);
-    __privateGet$2(this, _map).set(key, value);
-    if (__privateGet$2(this, _map).size > this.capacity) {
-      const leastRecentlyUsed = __privateGet$2(this, _map).keys().next().value;
+    __privateGet$3(this, _map).set(key, value);
+    if (__privateGet$3(this, _map).size > this.capacity) {
+      const leastRecentlyUsed = __privateGet$3(this, _map).keys().next().value;
       await this.delete(leastRecentlyUsed);
     }
   }
   async delete(key) {
-    __privateGet$2(this, _map).delete(key);
+    __privateGet$3(this, _map).delete(key);
   }
   async clear() {
-    return __privateGet$2(this, _map).clear();
+    return __privateGet$3(this, _map).clear();
   }
 }
 _map = new WeakMap();
@@ -1571,7 +1632,7 @@ var __accessCheck$2 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
-var __privateGet$1 = (obj, member, getter) => {
+var __privateGet$2 = (obj, member, getter) => {
   __accessCheck$2(obj, member, "read from private field");
   return getter ? getter.call(obj) : member.get(obj);
 };
@@ -1582,26 +1643,24 @@ var __privateAdd$2 = (obj, member, value) => {
 };
 var _tables;
 class SchemaPlugin extends XataPlugin {
-  constructor(links, tableNames) {
+  constructor(tableNames) {
     super();
-    this.links = links;
     this.tableNames = tableNames;
     __privateAdd$2(this, _tables, {});
   }
   build(pluginOptions) {
-    const links = this.links;
     const db = new Proxy({}, {
       get: (_target, table) => {
         if (!isString(table))
           throw new Error("Invalid table name");
-        if (!__privateGet$1(this, _tables)[table]) {
-          __privateGet$1(this, _tables)[table] = new RestRepository({ db, pluginOptions, table, links });
+        if (__privateGet$2(this, _tables)[table] === void 0) {
+          __privateGet$2(this, _tables)[table] = new RestRepository({ db, pluginOptions, table });
         }
-        return __privateGet$1(this, _tables)[table];
+        return __privateGet$2(this, _tables)[table];
       }
     });
     for (const table of this.tableNames ?? []) {
-      db[table] = new RestRepository({ db, pluginOptions, table, links });
+      db[table] = new RestRepository({ db, pluginOptions, table });
     }
     return db;
   }
@@ -1612,44 +1671,57 @@ var __accessCheck$1 = (obj, member, msg) => {
   if (!member.has(obj))
     throw TypeError("Cannot " + msg);
 };
+var __privateGet$1 = (obj, member, getter) => {
+  __accessCheck$1(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
 var __privateAdd$1 = (obj, member, value) => {
   if (member.has(obj))
     throw TypeError("Cannot add the same private member more than once");
   member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 };
+var __privateSet$1 = (obj, member, value, setter) => {
+  __accessCheck$1(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
 var __privateMethod$1 = (obj, member, method) => {
   __accessCheck$1(obj, member, "access private method");
   return method;
 };
-var _search, search_fn;
+var _schema, _search, search_fn, _getSchema, getSchema_fn;
 class SearchPlugin extends XataPlugin {
-  constructor(db, links) {
+  constructor(db) {
     super();
     this.db = db;
-    this.links = links;
     __privateAdd$1(this, _search);
+    __privateAdd$1(this, _getSchema);
+    __privateAdd$1(this, _schema, void 0);
   }
   build({ getFetchProps }) {
     return {
       all: async (query, options = {}) => {
         const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
+        const schema = await __privateMethod$1(this, _getSchema, getSchema_fn).call(this, getFetchProps);
         return records.map((record) => {
           const { table = "orphan" } = record.xata;
-          return { table, record: initObject(this.db, this.links, table, record) };
+          return { table, record: initObject(this.db, schema, table, record) };
         });
       },
       byTable: async (query, options = {}) => {
         const records = await __privateMethod$1(this, _search, search_fn).call(this, query, options, getFetchProps);
+        const schema = await __privateMethod$1(this, _getSchema, getSchema_fn).call(this, getFetchProps);
         return records.reduce((acc, record) => {
           const { table = "orphan" } = record.xata;
           const items = acc[table] ?? [];
-          const item = initObject(this.db, this.links, table, record);
+          const item = initObject(this.db, schema, table, record);
           return { ...acc, [table]: [...items, item] };
         }, {});
       }
     };
   }
 }
+_schema = new WeakMap();
 _search = new WeakSet();
 search_fn = async function(query, options, getFetchProps) {
   const fetchProps = await getFetchProps();
@@ -1661,6 +1733,18 @@ search_fn = async function(query, options, getFetchProps) {
   });
   return records;
 };
+_getSchema = new WeakSet();
+getSchema_fn = async function(getFetchProps) {
+  if (__privateGet$1(this, _schema))
+    return __privateGet$1(this, _schema);
+  const fetchProps = await getFetchProps();
+  const { schema } = await getBranchDetails({
+    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}" },
+    ...fetchProps
+  });
+  __privateSet$1(this, _schema, schema);
+  return schema;
+};
 
 const isBranchStrategyBuilder = (strategy) => {
   return typeof strategy === "function";
@@ -1672,30 +1756,39 @@ const envBranchNames = [
   "CF_PAGES_BRANCH",
   "BRANCH"
 ];
-const defaultBranch = "main";
 async function getCurrentBranchName(options) {
-  const env = await getBranchByEnvVariable();
-  if (env)
-    return env;
-  const branch = await getGitBranch();
-  if (!branch)
-    return defaultBranch;
-  const details = await getDatabaseBranch(branch, options);
-  if (details)
-    return branch;
-  return defaultBranch;
+  const env = getBranchByEnvVariable();
+  if (env) {
+    const details = await getDatabaseBranch(env, options);
+    if (details)
+      return env;
+    console.warn(`Branch ${env} not found in Xata. Ignoring...`);
+  }
+  const gitBranch = await getGitBranch();
+  return resolveXataBranch(gitBranch, options);
 }
 async function getCurrentBranchDetails(options) {
-  const env = await getBranchByEnvVariable();
-  if (env)
-    return getDatabaseBranch(env, options);
-  const branch = await getGitBranch();
-  if (!branch)
-    return getDatabaseBranch(defaultBranch, options);
-  const details = await getDatabaseBranch(branch, options);
-  if (details)
-    return details;
-  return getDatabaseBranch(defaultBranch, options);
+  const branch = await getCurrentBranchName(options);
+  return getDatabaseBranch(branch, options);
+}
+async function resolveXataBranch(gitBranch, options) {
+  const databaseURL = options?.databaseURL || getDatabaseURL();
+  const apiKey = options?.apiKey || getAPIKey();
+  if (!databaseURL)
+    throw new Error("A databaseURL was not defined. Either set the XATA_DATABASE_URL env variable or pass the argument explicitely");
+  if (!apiKey)
+    throw new Error("An API key was not defined. Either set the XATA_API_KEY env variable or pass the argument explicitely");
+  const [protocol, , host, , dbName] = databaseURL.split("/");
+  const [workspace] = host.split(".");
+  const { branch } = await resolveBranch({
+    apiKey,
+    apiUrl: databaseURL,
+    fetchImpl: getFetchImplementation(options?.fetchImpl),
+    workspacesApiUrl: `${protocol}//${host}`,
+    pathParams: { dbName, workspace },
+    queryParams: { gitBranch, fallbackBranch: getEnvVariable("XATA_FALLBACK_BRANCH") }
+  });
+  return branch;
 }
 async function getDatabaseBranch(branch, options) {
   const databaseURL = options?.databaseURL || getDatabaseURL();
@@ -1769,7 +1862,7 @@ var __privateMethod = (obj, member, method) => {
 const buildClient = (plugins) => {
   var _branch, _parseOptions, parseOptions_fn, _getFetchProps, getFetchProps_fn, _evaluateBranch, evaluateBranch_fn, _a;
   return _a = class {
-    constructor(options = {}, links, tables) {
+    constructor(options = {}, tables) {
       __privateAdd(this, _parseOptions);
       __privateAdd(this, _getFetchProps);
       __privateAdd(this, _evaluateBranch);
@@ -1779,12 +1872,12 @@ const buildClient = (plugins) => {
         getFetchProps: () => __privateMethod(this, _getFetchProps, getFetchProps_fn).call(this, safeOptions),
         cache: safeOptions.cache
       };
-      const db = new SchemaPlugin(links, tables).build(pluginOptions);
-      const search = new SearchPlugin(db, links ?? {}).build(pluginOptions);
+      const db = new SchemaPlugin(tables).build(pluginOptions);
+      const search = new SearchPlugin(db).build(pluginOptions);
       this.db = db;
       this.search = search;
       for (const [key, namespace] of Object.entries(plugins ?? {})) {
-        if (!namespace)
+        if (namespace === void 0)
           continue;
         const result = namespace.build(pluginOptions);
         if (result instanceof Promise) {
@@ -1801,7 +1894,7 @@ const buildClient = (plugins) => {
     const databaseURL = options?.databaseURL || getDatabaseURL();
     const apiKey = options?.apiKey || getAPIKey();
     const cache = options?.cache ?? new SimpleCache({ cacheRecords: false, defaultQueryTTL: 0 });
-    const branch = async () => options?.branch ? await __privateMethod(this, _evaluateBranch, evaluateBranch_fn).call(this, options.branch) : await getCurrentBranchName({ apiKey, databaseURL, fetchImpl: options?.fetch });
+    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");
     }
@@ -1828,7 +1921,7 @@ const buildClient = (plugins) => {
   }, _evaluateBranch = new WeakSet(), evaluateBranch_fn = async function(param) {
     if (__privateGet(this, _branch))
       return __privateGet(this, _branch);
-    if (!param)
+    if (param === void 0)
       return void 0;
     const strategies = Array.isArray(param) ? [...param] : [param];
     const evaluateBranch = async (strategy) => {
@@ -1925,6 +2018,7 @@ exports.insertRecord = insertRecord;
 exports.insertRecordWithID = insertRecordWithID;
 exports.inviteWorkspaceMember = inviteWorkspaceMember;
 exports.is = is;
+exports.isCursorPaginationOptions = isCursorPaginationOptions;
 exports.isIdentifiable = isIdentifiable;
 exports.isNot = isNot;
 exports.isXataRecord = isXataRecord;
@@ -1940,6 +2034,7 @@ exports.removeWorkspaceMember = removeWorkspaceMember;
 exports.resendWorkspaceMemberInvite = resendWorkspaceMemberInvite;
 exports.resolveBranch = resolveBranch;
 exports.searchBranch = searchBranch;
+exports.searchTable = searchTable;
 exports.setTableSchema = setTableSchema;
 exports.startsWith = startsWith;
 exports.updateBranchMetadata = updateBranchMetadata;