@xata.io/client 0.16.2 → 0.17.0

package/dist/index.d.ts

@@ -3065,12 +3065,12 @@ interface XataRecord<OriginalRecord extends XataRecord<any> = XataRecord<any>> e
     /**
      * Retrieves a refreshed copy of the current record from the database.
      * @param columns The columns to retrieve. If not specified, all first level properties are retrieved.
-     * @returns The persisted record with the selected columns.
+     * @returns The persisted record with the selected columns, null if not found.
      */
     read<K extends SelectableColumn<OriginalRecord>>(columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>> | null>;
     /**
      * Retrieves a refreshed copy of the current record from the database.
-     * @returns The persisted record with all first level properties.
+     * @returns The persisted record with all first level properties, null if not found.
      */
     read(): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>> | null>;
     /**
@@ -3078,22 +3078,28 @@ interface XataRecord<OriginalRecord extends XataRecord<any> = XataRecord<any>> e
      * returned and the current object is not mutated.
      * @param partialUpdate The columns and their values that have to be updated.
      * @param columns The columns to retrieve. If not specified, all first level properties are retrieved.
-     * @returns The persisted record with the selected columns.
+     * @returns The persisted record with the selected columns, null if not found.
      */
-    update<K extends SelectableColumn<OriginalRecord>>(partialUpdate: Partial<EditableData<Omit<OriginalRecord, keyof XataRecord>>>, columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>>>;
+    update<K extends SelectableColumn<OriginalRecord>>(partialUpdate: Partial<EditableData<OriginalRecord>>, columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>> | null>;
     /**
      * Performs a partial update of the current record. On success a new object is
      * returned and the current object is not mutated.
      * @param partialUpdate The columns and their values that have to be updated.
-     * @returns The persisted record with all first level properties.
+     * @returns The persisted record with all first level properties, null if not found.
      */
-    update(partialUpdate: Partial<EditableData<Omit<OriginalRecord, keyof XataRecord>>>): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>>>;
+    update(partialUpdate: Partial<EditableData<OriginalRecord>>): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>> | null>;
     /**
      * Performs a deletion of the current record in the database.
-     *
-     * @throws If the record was already deleted or if an error happened while performing the deletion.
+     * @param columns The columns to retrieve. If not specified, all first level properties are retrieved.
+     * @returns The deleted record, null if not found.
      */
-    delete(): Promise<void>;
+    delete<K extends SelectableColumn<OriginalRecord>>(columns: K[]): Promise<Readonly<SelectedPick<OriginalRecord, typeof columns>> | null>;
+    /**
+     * Performs a deletion of the current record in the database.
+     * @returns The deleted record, null if not found.
+  
+     */
+    delete(): Promise<Readonly<SelectedPick<OriginalRecord, ['*']>> | null>;
 }
 declare type Link<Record extends XataRecord> = Omit<XataRecord, 'read' | 'update'> & {
     /**
@@ -3106,7 +3112,7 @@ declare type Link<Record extends XataRecord> = Omit<XataRecord, 'read' | 'update
      * @param partialUpdate The columns and their values that have to be updated.
      * @returns A new record containing the latest values for all the columns of the current record.
      */
-    update<K extends SelectableColumn<Record>>(partialUpdate: Partial<EditableData<Omit<Record, keyof XataRecord>>>, columns?: K[]): Promise<Readonly<SelectedPick<Record, typeof columns extends SelectableColumn<Record>[] ? typeof columns : ['*']>>>;
+    update<K extends SelectableColumn<Record>>(partialUpdate: Partial<EditableData<Record>>, columns?: K[]): Promise<Readonly<SelectedPick<Record, typeof columns extends SelectableColumn<Record>[] ? typeof columns : ['*']>>>;
     /**
      * Performs a deletion of the current record in the database.
      *
@@ -3123,13 +3129,13 @@ declare type XataRecordMetadata = {
 };
 declare function isIdentifiable(x: any): x is Identifiable & Record<string, unknown>;
 declare function isXataRecord(x: any): x is XataRecord & Record<string, unknown>;
-declare type EditableData<O extends BaseData> = {
+declare type EditableData<O extends XataRecord> = Identifiable & Omit<{
     [K in keyof O]: O[K] extends XataRecord ? {
         id: string;
     } | string : NonNullable<O[K]> extends XataRecord ? {
         id: string;
     } | string | null | undefined : O[K];
-};
+}, keyof XataRecord>;
 
 /**
  * PropertyMatchFilter
@@ -3280,7 +3286,7 @@ declare type SearchPluginResult<Schemas extends Record<string, BaseData>> = {
         [Model in ExtractTables<Schemas, Tables, GetArrayInnerType<NonNullable<NonNullable<typeof options>['tables']>>>]?: Awaited<SearchXataRecord<SelectedPick<Schemas[Model] & XataRecord, ['*']>>[]>;
     }>;
 };
-declare class SearchPlugin<Schemas extends Record<string, BaseData>> extends XataPlugin {
+declare class SearchPlugin<Schemas extends Record<string, XataRecord>> extends XataPlugin {
     #private;
     private db;
     constructor(db: SchemaPluginResult<Schemas>, schemaTables?: Schemas.Table[]);
@@ -3670,9 +3676,9 @@ declare class RecordArray<Result extends XataRecord> extends Array<Result> {
 /**
  * Common interface for performing operations on a table.
  */
-declare abstract class Repository<Data extends BaseData, Record extends XataRecord = Data & XataRecord> extends Query<Record, Readonly<SelectedPick<Record, ['*']>>> {
-    abstract create<K extends SelectableColumn<Record>>(object: Omit<EditableData<Data>, 'id'> & Partial<Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    abstract create(object: Omit<EditableData<Data>, 'id'> & Partial<Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+declare abstract class Repository<Record extends XataRecord> extends Query<Record, Readonly<SelectedPick<Record, ['*']>>> {
+    abstract create<K extends SelectableColumn<Record>>(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract create(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Creates a single record in the table with a unique id.
      * @param id The unique id.
@@ -3680,27 +3686,27 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record.
      */
-    abstract create<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Data>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract create<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates a single record in the table with a unique id.
      * @param id The unique id.
      * @param object Object containing the column names with their values to be stored in the table.
      * @returns The full persisted record.
      */
-    abstract create(id: string, object: Omit<EditableData<Data>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract create(id: string, object: Omit<EditableData<Record>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Creates multiple records in the table.
      * @param objects Array of objects with the column names and the values to be stored in the table.
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns Array of the persisted records in order.
      */
-    abstract create<K extends SelectableColumn<Record>>(objects: Array<Omit<EditableData<Data>, 'id'> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    abstract create<K extends SelectableColumn<Record>>(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
     /**
      * Creates multiple records in the table.
      * @param objects Array of objects with the column names and the values to be stored in the table.
      * @returns Array of the persisted records in order.
      */
-    abstract create(objects: Array<Omit<EditableData<Data>, 'id'> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract create(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
     /**
      * Queries a single record from the table given its unique id.
      * @param id The unique id.
@@ -3757,43 +3763,43 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * Partially update a single record.
      * @param object An object with its id and the columns to be updated.
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
-     * @returns The full persisted record.
+     * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Data>> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Record>> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
     /**
      * Partially update a single record.
      * @param object An object with its id and the columns to be updated.
-     * @returns The full persisted record.
+     * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update(object: Partial<EditableData<Data>> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract update(object: Partial<EditableData<Record>> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
     /**
      * Partially update a single record given its unique id.
      * @param id The unique id.
      * @param object The column names and their values that have to be updated.
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
-     * @returns The full persisted record.
+     * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Data>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
     /**
      * Partially update a single record given its unique id.
      * @param id The unique id.
      * @param object The column names and their values that have to be updated.
-     * @returns The full persisted record.
+     * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update(id: string, object: Partial<EditableData<Data>>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract update(id: string, object: Partial<EditableData<Record>>): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
     /**
      * Partially updates multiple records.
      * @param objects An array of objects with their ids and columns to be updated.
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
-     * @returns Array of the persisted records in order.
+     * @returns Array of the persisted records in order (if a record could not be found null is returned).
      */
-    abstract update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Data>> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    abstract update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
     /**
      * Partially updates multiple records.
      * @param objects An array of objects with their ids and columns to be updated.
-     * @returns Array of the persisted records in order.
+     * @returns Array of the persisted records in order (if a record could not be found null is returned).
      */
-    abstract update(objects: Array<Partial<EditableData<Data>> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract update(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3801,14 +3807,14 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Data> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Record> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
      * @param object Object containing the column names with their values to be persisted in the table.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate(object: EditableData<Data> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract createOrUpdate(object: EditableData<Record> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3817,7 +3823,7 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Data>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3825,7 +3831,7 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param object The column names and the values to be persisted.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate(id: string, object: Omit<EditableData<Data>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract createOrUpdate(id: string, object: Omit<EditableData<Record>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
@@ -3833,38 +3839,66 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns Array of the persisted records.
      */
-    abstract createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<EditableData<Data> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
     /**
      * Creates or updates a single record. If a record exists with the given id,
      * it will be update, otherwise a new record will be created.
      * @param objects Array of objects with the column names and the values to be stored in the table.
      * @returns Array of the persisted records.
      */
-    abstract createOrUpdate(objects: Array<EditableData<Data> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract createOrUpdate(objects: Array<EditableData<Record> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
     /**
      * Deletes a record given its unique id.
-     * @param id The unique id.
-     * @throws If the record could not be found or there was an error while performing the deletion.
+     * @param object An object with a unique id.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The deleted record, null if the record could not be found.
      */
-    abstract delete(id: string): Promise<void>;
+    abstract delete<K extends SelectableColumn<Record>>(object: Identifiable & Partial<EditableData<Record>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
     /**
      * Deletes a record given its unique id.
-     * @param id An object with a unique id.
-     * @throws If the record could not be found or there was an error while performing the deletion.
+     * @param object An object with a unique id.
+     * @returns The deleted record, null if the record could not be found.
+     */
+    abstract delete(object: Identifiable & Partial<EditableData<Record>>): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    /**
+     * Deletes a record given a unique id.
+     * @param id The unique id.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns The deleted record, null if the record could not be found.
+     */
+    abstract delete<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    /**
+     * Deletes a record given a unique id.
+     * @param id The unique id.
+     * @returns The deleted record, null if the record could not be found.
+     */
+    abstract delete(id: string): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    /**
+     * Deletes multiple records given an array of objects with ids.
+     * @param objects An array of objects with unique ids.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns Array of the deleted records in order (if a record could not be found null is returned).
      */
-    abstract delete(id: Identifiable): Promise<void>;
+    abstract delete<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
     /**
-     * Deletes a record given a list of unique ids.
-     * @param ids The array of unique ids.
-     * @throws If the record could not be found or there was an error while performing the deletion.
+     * Deletes multiple records given an array of objects with ids.
+     * @param objects An array of objects with unique ids.
+     * @returns Array of the deleted records in order (if a record could not be found null is returned).
+     */
+    abstract delete(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    /**
+     * Deletes multiple records given an array of unique ids.
+     * @param objects An array of ids.
+     * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
+     * @returns Array of the deleted records in order (if a record could not be found null is returned).
      */
-    abstract delete(ids: string[]): Promise<void>;
+    abstract delete<K extends SelectableColumn<Record>>(objects: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
     /**
-     * Deletes a record given a list of unique ids.
-     * @param ids An array of objects with unique ids.
-     * @throws If the record could not be found or there was an error while performing the deletion.
+     * Deletes multiple records given an array of unique ids.
+     * @param objects An array of ids.
+     * @returns Array of the deleted records in order (if a record could not be found null is returned).
      */
-    abstract delete(ids: Identifiable[]): Promise<void>;
+    abstract delete(objects: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     /**
      * Search for records in the table.
      * @param query The query to search for.
@@ -3880,7 +3914,7 @@ declare abstract class Repository<Data extends BaseData, Record extends XataReco
     }): Promise<SearchXataRecord<SelectedPick<Record, ['*']>>[]>;
     abstract query<Result extends XataRecord>(query: Query<Record, Result>): Promise<Page<Record, Result>>;
 }
-declare class RestRepository<Data extends BaseData, Record extends XataRecord = Data & XataRecord> extends Query<Record, SelectedPick<Record, ['*']>> implements Repository<Data, Record> {
+declare class RestRepository<Record extends XataRecord> extends Query<Record, SelectedPick<Record, ['*']>> implements Repository<Record> {
     #private;
     constructor(options: {
         table: string;
@@ -3888,33 +3922,40 @@ declare class RestRepository<Data extends BaseData, Record extends XataRecord =
         pluginOptions: XataPluginOptions;
         schemaTables?: Table[];
     });
-    create(object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    create(recordId: string, object: EditableData<Data>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    create(objects: EditableData<Data>[]): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
-    create<K extends SelectableColumn<Record>>(object: EditableData<Data>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    create<K extends SelectableColumn<Record>>(recordId: string, object: EditableData<Data>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    create<K extends SelectableColumn<Record>>(objects: EditableData<Data>[], columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
-    read(recordId: string): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
-    read(recordIds: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
-    read(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
-    read(objects: Identifiable[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
-    read<K extends SelectableColumn<Record>>(recordId: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
-    read<K extends SelectableColumn<Record>>(recordIds: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
-    read<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
-    read<K extends SelectableColumn<Record>>(objects: Identifiable[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
-    update(object: Partial<EditableData<Data>> & Identifiable): Promise<SelectedPick<Record, ['*']>>;
-    update(recordId: string, object: Partial<EditableData<Data>>): Promise<SelectedPick<Record, ['*']>>;
-    update(objects: Array<Partial<EditableData<Data>> & Identifiable>): Promise<SelectedPick<Record, ['*']>[]>;
-    update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Data>> & Identifiable, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
-    update<K extends SelectableColumn<Record>>(recordId: string, object: Partial<EditableData<Data>>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
-    update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Data>> & Identifiable>, columns: K[]): Promise<SelectedPick<Record, typeof columns>[]>;
-    createOrUpdate(object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
-    createOrUpdate(recordId: string, object: EditableData<Data>): Promise<SelectedPick<Record, ['*']>>;
-    createOrUpdate(objects: EditableData<Data>[]): Promise<SelectedPick<Record, ['*']>[]>;
-    createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Data>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
-    createOrUpdate<K extends SelectableColumn<Record>>(recordId: string, object: EditableData<Data>, columns: K[]): Promise<SelectedPick<Record, typeof columns>>;
-    createOrUpdate<K extends SelectableColumn<Record>>(objects: EditableData<Data>[], columns: K[]): Promise<SelectedPick<Record, typeof columns>[]>;
-    delete(a: string | Identifiable | Array<string | Identifiable>): Promise<void>;
+    create<K extends SelectableColumn<Record>>(object: EditableData<Record> & Partial<Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    create(object: EditableData<Record> & Partial<Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    create<K extends SelectableColumn<Record>>(id: string, object: EditableData<Record>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    create(id: string, object: EditableData<Record>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    create<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    create(objects: Array<EditableData<Record> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    read<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
+    read(id: string): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
+    read<K extends SelectableColumn<Record>>(ids: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    read(ids: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    read<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
+    read(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
+    read<K extends SelectableColumn<Record>>(objects: Identifiable[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    read(objects: Identifiable[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    update<K extends SelectableColumn<Record>>(object: Partial<EditableData<Record>> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    update(object: Partial<EditableData<Record>> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    update(id: string, object: Partial<EditableData<Record>>): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    update<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    update(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Record> & Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    createOrUpdate(object: EditableData<Record> & Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    createOrUpdate<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    createOrUpdate(id: string, object: Omit<EditableData<Record>, 'id'>): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    createOrUpdate(objects: Array<EditableData<Record> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    delete<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    delete(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    delete<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    delete(id: string): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
+    delete<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    delete(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    delete<K extends SelectableColumn<Record>>(objects: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    delete(objects: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     search(query: string, options?: {
         fuzziness?: FuzzinessExpression;
         prefix?: PrefixExpression;
@@ -4082,12 +4123,12 @@ declare const includesAny: <T>(value: T) => ArrayFilter<T>;
 declare type SchemaDefinition = {
     table: string;
 };
-declare type SchemaPluginResult<Schemas extends Record<string, BaseData>> = {
+declare type SchemaPluginResult<Schemas extends Record<string, XataRecord>> = {
     [Key in keyof Schemas]: Repository<Schemas[Key]>;
 } & {
-    [key: string]: Repository<XataRecord$1>;
+    [key: string]: Repository<XataRecord>;
 };
-declare class SchemaPlugin<Schemas extends Record<string, BaseData>> extends XataPlugin {
+declare class SchemaPlugin<Schemas extends Record<string, XataRecord>> extends XataPlugin {
     #private;
     constructor(schemaTables?: Schemas.Table[]);
     build(pluginOptions: XataPluginOptions): SchemaPluginResult<Schemas>;
@@ -4108,9 +4149,9 @@ declare type BaseClientOptions = {
 };
 declare const buildClient: <Plugins extends Record<string, XataPlugin> = {}>(plugins?: Plugins | undefined) => ClientConstructor<Plugins>;
 interface ClientConstructor<Plugins extends Record<string, XataPlugin>> {
-    new <T extends readonly BaseSchema[]>(options?: Partial<BaseClientOptions>, schemaTables?: T): Omit<{
-        db: Awaited<ReturnType<SchemaPlugin<SchemaInference<NonNullable<typeof schemaTables>>>['build']>>;
-        search: Awaited<ReturnType<SearchPlugin<SchemaInference<NonNullable<typeof schemaTables>>>['build']>>;
+    new <Schemas extends Record<string, XataRecord> = {}>(options?: Partial<BaseClientOptions>, schemaTables?: readonly BaseSchema[]): Omit<{
+        db: Awaited<ReturnType<SchemaPlugin<Schemas>['build']>>;
+        search: Awaited<ReturnType<SearchPlugin<Schemas>['build']>>;
     }, keyof Plugins> & {
         [Key in StringKeys<NonNullable<Plugins>>]: Awaited<ReturnType<NonNullable<Plugins>[Key]['build']>>;
     } & {
@@ -4121,7 +4162,7 @@ interface ClientConstructor<Plugins extends Record<string, XataPlugin>> {
     };
 }
 declare const BaseClient_base: ClientConstructor<{}>;
-declare class BaseClient extends BaseClient_base<[]> {
+declare class BaseClient extends BaseClient_base<Record<string, any>> {
 }
 
 declare class Serializer {

package/dist/index.mjs

@@ -152,7 +152,7 @@ function getFetchImplementation(userFetch) {
   return fetchImpl;
 }
 
-const VERSION = "0.16.2";
+const VERSION = "0.17.0";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -1448,16 +1448,16 @@ class RestRepository extends Query {
       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 ids = a.map((item) => extractId(item));
+        const finalObjects = await this.getAll({ filter: { id: { $any: compact(ids) } }, columns });
         const dictionary = finalObjects.reduce((acc, object) => {
           acc[object.id] = object;
           return acc;
         }, {});
-        return ids.map((id2) => dictionary[id2] ?? null);
+        return ids.map((id2) => dictionary[id2 ?? ""] ?? null);
       }
-      const id = isString(a) ? a : a.id;
-      if (isString(id)) {
+      const id = extractId(a);
+      if (id) {
         const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
         try {
           const response = await getRecord({
@@ -1526,24 +1526,21 @@ class RestRepository extends Query {
       throw new Error("Invalid arguments for createOrUpdate method");
     });
   }
-  async delete(a) {
+  async delete(a, b) {
     return __privateGet$4(this, _trace).call(this, "delete", async () => {
       if (Array.isArray(a)) {
         if (a.length === 0)
-          return;
+          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;
+        return Promise.all(a.map((id) => this.delete(id, b)));
       }
       if (isString(a)) {
-        await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a);
-        return;
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a, b);
       }
       if (isObject(a) && isString(a.id)) {
-        await __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id);
-        return;
+        return __privateMethod$2(this, _deleteRecord, deleteRecord_fn).call(this, a.id, b);
       }
       throw new Error("Invalid arguments for delete method");
     });
@@ -1653,14 +1650,21 @@ _updateRecordWithID = new WeakSet();
 updateRecordWithID_fn = async function(recordId, object, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
   const record = transformObjectLinks(object);
-  const response = await updateRecordWithID({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
-    queryParams: { columns },
-    body: record,
-    ...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);
+  try {
+    const response = await updateRecordWithID({
+      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
+      queryParams: { columns },
+      body: record,
+      ...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;
+  }
 };
 _upsertRecordWithID = new WeakSet();
 upsertRecordWithID_fn = async function(recordId, object, columns = ["*"]) {
@@ -1675,12 +1679,22 @@ upsertRecordWithID_fn = async function(recordId, object, columns = ["*"]) {
   return initObject(__privateGet$4(this, _db), schemaTables, __privateGet$4(this, _table), response);
 };
 _deleteRecord = new WeakSet();
-deleteRecord_fn = async function(recordId) {
+deleteRecord_fn = async function(recordId, columns = ["*"]) {
   const fetchProps = await __privateGet$4(this, _getFetchProps).call(this);
-  await deleteRecord({
-    pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
-    ...fetchProps
-  });
+  try {
+    const response = await deleteRecord({
+      pathParams: { workspace: "{workspaceId}", dbBranchName: "{dbBranch}", tableName: __privateGet$4(this, _table), recordId },
+      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;
+  }
 };
 _setCacheQuery = new WeakSet();
 setCacheQuery_fn = async function(query, meta, records) {
@@ -1768,6 +1782,13 @@ const initObject = (db, schemaTables, table, object) => {
 function isResponseWithRecords(value) {
   return isObject(value) && Array.isArray(value.records);
 }
+function extractId(value) {
+  if (isString(value))
+    return value;
+  if (isObject(value) && isString(value.id))
+    return value.id;
+  return void 0;
+}
 
 var __accessCheck$3 = (obj, member, msg) => {
   if (!member.has(obj))