@xata.io/client 0.23.5 → 0.24.1

package/.turbo/turbo-add-version.log

@@ -1,4 +1,4 @@
 
-> @xata.io/client@0.23.5 add-version /home/runner/work/client-ts/client-ts/packages/client
+> @xata.io/client@0.24.1 add-version /home/runner/work/client-ts/client-ts/packages/client
 > node ../../scripts/add-version-file.mjs
 

package/.turbo/turbo-build.log

@@ -1,13 +1,13 @@
 
-> @xata.io/client@0.23.5 build /home/runner/work/client-ts/client-ts/packages/client
+> @xata.io/client@0.24.1 build /home/runner/work/client-ts/client-ts/packages/client
 > rimraf dist && rollup -c
 
 
 src/index.ts → dist/index.cjs...
-created dist/index.cjs in 1.8s
+created dist/index.cjs in 1.3s
 
 src/index.ts → dist/index.mjs...
-created dist/index.mjs in 1.2s
+created dist/index.mjs in 970ms
 
 src/index.ts → dist/index.d.ts...
-created dist/index.d.ts in 8s
+created dist/index.d.ts in 5.9s

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @xata.io/client
 
+## 0.24.1
+
+### Patch Changes
+
+- [#1030](https://github.com/xataio/client-ts/pull/1030) [`eaa774f5`](https://github.com/xataio/client-ts/commit/eaa774f542185ef92448155bcdff331686c4da9f) Thanks [@SferaDev](https://github.com/SferaDev)! - Make `xata` property enumerable
+
+## 0.24.0
+
+### Minor Changes
+
+- [#1009](https://github.com/xataio/client-ts/pull/1009) [`45aa2207`](https://github.com/xataio/client-ts/commit/45aa220728e98dd716a55a9a307474732a9b2bc1) Thanks [@SferaDev](https://github.com/SferaDev)! - Add `createdAt` and `updatedAt` properties
+
+### Patch Changes
+
+- [#1008](https://github.com/xataio/client-ts/pull/1008) [`f28080f0`](https://github.com/xataio/client-ts/commit/f28080f034f02704fe00d64b8f42e1127bde30c7) Thanks [@SferaDev](https://github.com/SferaDev)! - Add `failIfMissing` to delete transactions
+
+- [#994](https://github.com/xataio/client-ts/pull/994) [`ac9c0604`](https://github.com/xataio/client-ts/commit/ac9c06042bb85105d9a38624676ce6ea5a27d488) Thanks [@xata-bot](https://github.com/xata-bot)! - Update internal endpoints
+
+- [#1015](https://github.com/xataio/client-ts/pull/1015) [`c163b365`](https://github.com/xataio/client-ts/commit/c163b3658f23fb2eaad6243ebebc92624754099a) Thanks [@SferaDev](https://github.com/SferaDev)! - Add `factor` to date boosters
+
 ## 0.23.5
 
 ### Patch Changes

package/dist/index.cjs

@@ -266,7 +266,7 @@ class ApiRequestPool {
     return __privateGet$8(this, _fetch);
   }
   request(url, options) {
-    const start = new Date();
+    const start = /* @__PURE__ */ new Date();
     const fetch2 = this.getFetch();
     const runRequest = async (stalled = false) => {
       const response = await fetch2(url, options);
@@ -276,7 +276,7 @@ class ApiRequestPool {
         return await runRequest(true);
       }
       if (stalled) {
-        const stalledTime = new Date().getTime() - start.getTime();
+        const stalledTime = (/* @__PURE__ */ new Date()).getTime() - start.getTime();
         console.warn(`A request to Xata hit your workspace limits, was retried and stalled for ${stalledTime}ms`);
       }
       return response;
@@ -492,7 +492,7 @@ function defaultOnOpen(response) {
   }
 }
 
-const VERSION = "0.23.5";
+const VERSION = "0.24.1";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -864,6 +864,12 @@ const putFile = (variables, signal) => dataPlaneFetch({
   ...variables,
   signal
 });
+const deleteFile = (variables, signal) => dataPlaneFetch({
+  url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}/column/{columnName}/file",
+  method: "delete",
+  ...variables,
+  signal
+});
 const getRecord = (variables, signal) => dataPlaneFetch({
   url: "/db/{dbBranchName}/tables/{tableName}/data/{recordId}",
   method: "get",
@@ -908,6 +914,12 @@ const askTable = (variables, signal) => dataPlaneFetch({
 });
 const summarizeTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/summarize", method: "post", ...variables, signal });
 const aggregateTable = (variables, signal) => dataPlaneFetch({ url: "/db/{dbBranchName}/tables/{tableName}/aggregate", method: "post", ...variables, signal });
+const fileAccess = (variables, signal) => dataPlaneFetch({
+  url: "/file/{fileId}",
+  method: "get",
+  ...variables,
+  signal
+});
 const operationsByTag$2 = {
   branch: {
     getBranchList,
@@ -967,7 +979,7 @@ const operationsByTag$2 = {
     deleteRecord,
     bulkInsertTableRecords
   },
-  files: { getFileItem, putFileItem, deleteFileItem, getFile, putFile },
+  files: { getFileItem, putFileItem, deleteFileItem, getFile, putFile, deleteFile, fileAccess },
   searchAndFilter: {
     queryTable,
     searchBranch,
@@ -1898,6 +1910,7 @@ class FilesApi {
         columnName: column,
         fileId
       },
+      // @ts-ignore
       body: file,
       ...this.extraProps
     });
@@ -1969,6 +1982,43 @@ class FilesApi {
       ...this.extraProps
     });
   }
+  deleteFile({
+    workspace,
+    region,
+    database,
+    branch,
+    table,
+    record,
+    column
+  }) {
+    return operationsByTag.files.deleteFile({
+      pathParams: {
+        workspace,
+        region,
+        dbBranchName: `${database}:${branch}`,
+        tableName: table,
+        recordId: record,
+        columnName: column
+      },
+      ...this.extraProps
+    });
+  }
+  fileAccess({
+    workspace,
+    region,
+    fileId,
+    verify
+  }) {
+    return operationsByTag.files.fileAccess({
+      pathParams: {
+        workspace,
+        region,
+        fileId
+      },
+      queryParams: { verify },
+      ...this.extraProps
+    });
+  }
 }
 class SearchAndFilterApi {
   constructor(extraProps) {
@@ -2479,18 +2529,46 @@ class Page {
     this.meta = meta;
     this.records = new RecordArray(this, records);
   }
+  /**
+   * Retrieves the next page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The next page or results.
+   */
   async nextPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, after: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the previous page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The previous page or results.
+   */
   async previousPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, before: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the start page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The start page or results.
+   */
   async startPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, start: this.meta.page.cursor } });
   }
+  /**
+   * Retrieves the end page of results.
+   * @param size Maximum number of results to be retrieved.
+   * @param offset Number of results to skip when retrieving the results.
+   * @returns The end page or results.
+   */
   async endPage(size, offset) {
     return __privateGet$6(this, _query).getPaginated({ pagination: { size, offset, end: this.meta.page.cursor } });
   }
+  /**
+   * Shortcut method to check if there will be additional results if the next page of results is retrieved.
+   * @returns Whether or not there will be additional results in the next page of results.
+   */
   hasNextPage() {
     return this.meta.page.more;
   }
@@ -2531,22 +2609,45 @@ const _RecordArray = class extends Array {
   map(callbackfn, thisArg) {
     return this.toArray().map(callbackfn, thisArg);
   }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new array of objects
+   */
   async nextPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).nextPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new array of objects
+   */
   async previousPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).previousPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve start page of records
+   *
+   * @returns A new array of objects
+   */
   async startPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).startPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * Retrieve end page of records
+   *
+   * @returns A new array of objects
+   */
   async endPage(size, offset) {
     const newPage = await __privateGet$6(this, _page).endPage(size, offset);
     return new _RecordArray(newPage);
   }
+  /**
+   * @returns Boolean indicating if there is a next page
+   */
   hasNextPage() {
     return __privateGet$6(this, _page).meta.page.more;
   }
@@ -2583,6 +2684,7 @@ const _Query = class {
     __privateAdd$5(this, _table$1, void 0);
     __privateAdd$5(this, _repository, void 0);
     __privateAdd$5(this, _data, { filter: {} });
+    // Implements pagination
     this.meta = { page: { cursor: "start", more: true, size: PAGINATION_DEFAULT_SIZE } };
     this.records = new RecordArray(this, []);
     __privateSet$5(this, _table$1, table);
@@ -2620,18 +2722,38 @@ const _Query = class {
     const key = JSON.stringify({ columns, filter, sort, pagination });
     return toBase64(key);
   }
+  /**
+   * Builds a new query object representing a logical OR between the given subqueries.
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   any(...queries) {
     const $any = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $any } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical AND between the given subqueries.
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   all(...queries) {
     const $all = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $all } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical OR negating each subquery. In pseudo-code: !q1 OR !q2
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   not(...queries) {
     const $not = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $not } }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query object representing a logical AND negating each subquery. In pseudo-code: !q1 AND !q2
+   * @param queries An array of subqueries.
+   * @returns A new Query object.
+   */
   none(...queries) {
     const $none = queries.map((query) => query.getQueryOptions().filter ?? {});
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { filter: { $none } }, __privateGet$5(this, _data));
@@ -2654,6 +2776,11 @@ const _Query = class {
     const sort = [...originalSort, { column, direction }];
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { sort }, __privateGet$5(this, _data));
   }
+  /**
+   * Builds a new query specifying the set of columns to be returned in the query response.
+   * @param columns Array of column names to be returned by the query.
+   * @returns A new Query object.
+   */
   select(columns) {
     return new _Query(
       __privateGet$5(this, _repository),
@@ -2666,6 +2793,12 @@ const _Query = class {
     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);
   }
+  /**
+   * Get results in an iterator
+   *
+   * @async
+   * @returns Async interable of results
+   */
   async *[Symbol.asyncIterator]() {
     for await (const [record] of this.getIterator({ batchSize: 1 })) {
       yield record;
@@ -2726,21 +2859,49 @@ const _Query = class {
     );
     return __privateGet$5(this, _repository).summarizeTable(query, summaries, summariesFilter);
   }
+  /**
+   * Builds a new query object adding a cache TTL in milliseconds.
+   * @param ttl The cache TTL in milliseconds.
+   * @returns A new Query object.
+   */
   cache(ttl) {
     return new _Query(__privateGet$5(this, _repository), __privateGet$5(this, _table$1), { cache: ttl }, __privateGet$5(this, _data));
   }
+  /**
+   * Retrieve next page of records
+   *
+   * @returns A new page object.
+   */
   nextPage(size, offset) {
     return this.startPage(size, offset);
   }
+  /**
+   * Retrieve previous page of records
+   *
+   * @returns A new page object
+   */
   previousPage(size, offset) {
     return this.startPage(size, offset);
   }
+  /**
+   * Retrieve start page of records
+   *
+   * @returns A new page object
+   */
   startPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset } });
   }
+  /**
+   * Retrieve last page of records
+   *
+   * @returns A new page object
+   */
   endPage(size, offset) {
     return this.getPaginated({ pagination: { size, offset, before: "end" } });
   }
+  /**
+   * @returns Boolean indicating if there is a next page
+   */
   hasNextPage() {
     return this.meta.page.more;
   }
@@ -3430,7 +3591,7 @@ deleteRecords_fn = async function(recordIds) {
 };
 _setCacheQuery = new WeakSet();
 setCacheQuery_fn = async function(query, meta, records) {
-  await __privateGet$4(this, _cache)?.set(`query_${__privateGet$4(this, _table)}:${query.key()}`, { date: new Date(), meta, records });
+  await __privateGet$4(this, _cache)?.set(`query_${__privateGet$4(this, _table)}:${query.key()}`, { date: /* @__PURE__ */ new Date(), meta, records });
 };
 _getCacheQuery = new WeakSet();
 getCacheQuery_fn = async function(query) {
@@ -3514,6 +3675,8 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
     }
   }
   const record = { ...data };
+  const serializable = { xata, ...transformObjectLinks(data) };
+  const metadata = xata !== void 0 ? { ...xata, createdAt: new Date(xata.createdAt), updatedAt: new Date(xata.updatedAt) } : void 0;
   record.read = function(columns2) {
     return db[table].read(record["id"], columns2);
   };
@@ -3530,14 +3693,15 @@ const initObject = (db, schemaTables, table, object, selectedColumns) => {
   record.delete = function() {
     return db[table].delete(record["id"]);
   };
+  record.xata = Object.freeze(metadata);
   record.getMetadata = function() {
-    return xata;
+    return record.xata;
   };
   record.toSerializable = function() {
-    return JSON.parse(JSON.stringify(transformObjectLinks(data)));
+    return JSON.parse(JSON.stringify(serializable));
   };
   record.toString = function() {
-    return JSON.stringify(transformObjectLinks(data));
+    return JSON.stringify(transformObjectLinks(serializable));
   };
   for (const prop of ["read", "update", "replace", "delete", "getMetadata", "toSerializable", "toString"]) {
     Object.defineProperty(record, prop, { enumerable: false });
@@ -3756,6 +3920,7 @@ search_fn = async function(query, options, pluginOptions) {
   const { tables, fuzziness, highlight, prefix, page } = options ?? {};
   const { records } = await searchBranch({
     pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", region: "{region}" },
+    // @ts-ignore https://github.com/xataio/client-ts/issues/313
     body: { tables, query, fuzziness, prefix, highlight, page },
     ...pluginOptions
   });
@@ -3910,6 +4075,7 @@ const buildClient = (plugins) => {
       fetch,
       apiKey,
       apiUrl: "",
+      // Instead of using workspace and dbBranch, we inject a probably CNAME'd URL
       workspacesApiUrl: (path, params) => {
         const hasBranch = params.dbBranchName ?? params.branch;
         const newPath = path.replace(/^\/db\/[^/]+/, hasBranch !== void 0 ? `:${branch}` : "");
@@ -4062,6 +4228,7 @@ exports.deleteBranch = deleteBranch;
 exports.deleteColumn = deleteColumn;
 exports.deleteDatabase = deleteDatabase;
 exports.deleteDatabaseGithubSettings = deleteDatabaseGithubSettings;
+exports.deleteFile = deleteFile;
 exports.deleteFileItem = deleteFileItem;
 exports.deleteRecord = deleteRecord;
 exports.deleteTable = deleteTable;
@@ -4073,6 +4240,7 @@ exports.endsWith = endsWith;
 exports.equals = equals;
 exports.executeBranchMigrationPlan = executeBranchMigrationPlan;
 exports.exists = exists;
+exports.fileAccess = fileAccess;
 exports.ge = ge;
 exports.getAPIKey = getAPIKey;
 exports.getBranch = getBranch;