@xata.io/client 0.24.2 → 0.24.3

package/dist/index.d.ts

@@ -1823,6 +1823,14 @@ type RecordMeta = {
          * The record's version. Can be used for optimistic concurrency control.
          */
         version: number;
+        /**
+         * The time when the record was created.
+         */
+        createdAt?: string;
+        /**
+         * The time when the record was last updated.
+         */
+        updatedAt?: string;
         /**
          * The record's table name. APIs that return records from multiple tables will set this field accordingly.
          */
@@ -1862,6 +1870,10 @@ type FileResponse = {
     version: number;
     attributes?: Record<string, any>;
 };
+type ProjectionConfig = {
+    name?: string;
+};
+type QueryColumnsProjection = (string | ProjectionConfig)[];
 /**
  * The target expression is used to filter the search results by the target columns.
  */
@@ -2318,6 +2330,8 @@ type RecordUpdateResponse = XataRecord$1 | {
     id: string;
     xata: {
         version: number;
+        createdAt: string;
+        updatedAt: string;
     };
 };
 type PutFileResponse = FileResponse;
@@ -4358,7 +4372,7 @@ type QueryTableRequestBody = {
     filter?: FilterExpression;
     sort?: SortExpression;
     page?: PageConfig;
-    columns?: ColumnsProjection;
+    columns?: QueryColumnsProjection;
     /**
      * The consistency level for this request.
      *
@@ -5899,6 +5913,8 @@ type schemas_NumericHistogramAgg = NumericHistogramAgg;
 type schemas_ObjectValue = ObjectValue;
 type schemas_PageConfig = PageConfig;
 type schemas_PrefixExpression = PrefixExpression;
+type schemas_ProjectionConfig = ProjectionConfig;
+type schemas_QueryColumnsProjection = QueryColumnsProjection;
 type schemas_RecordID = RecordID;
 type schemas_RecordMeta = RecordMeta;
 type schemas_RecordsMetadata = RecordsMetadata;
@@ -6023,6 +6039,8 @@ declare namespace schemas {
     schemas_ObjectValue as ObjectValue,
     schemas_PageConfig as PageConfig,
     schemas_PrefixExpression as PrefixExpression,
+    schemas_ProjectionConfig as ProjectionConfig,
+    schemas_QueryColumnsProjection as QueryColumnsProjection,
     schemas_RecordID as RecordID,
     schemas_RecordMeta as RecordMeta,
     schemas_RecordsMetadata as RecordsMetadata,
@@ -6839,6 +6857,7 @@ type NestedValueAtColumn<O, Key extends SelectableColumn<O>> = Key extends `${in
 } : unknown;
 type ForwardNullable<T, R> = T extends NonNullable<T> ? R : R | null;
 
+type Identifier = string;
 /**
  * Represents an identifiable record from the database.
  */
@@ -6846,7 +6865,7 @@ interface Identifiable {
     /**
      * Unique id of this record.
      */
-    id: string;
+    id: Identifier;
 }
 interface BaseData {
     [key: string]: any;
@@ -6961,10 +6980,10 @@ type NumericOperator = ExclusiveOr<{
     $divide?: number;
 }>>>;
 type EditableDataFields<T> = T extends XataRecord ? {
-    id: string;
-} | string : NonNullable<T> extends XataRecord ? {
-    id: string;
-} | string | null | undefined : T extends Date ? string | Date : NonNullable<T> extends Date ? string | Date | null | undefined : T extends number ? number | NumericOperator : T;
+    id: Identifier;
+} | Identifier : NonNullable<T> extends XataRecord ? {
+    id: Identifier;
+} | Identifier | null | undefined : T extends Date ? string | Date : NonNullable<T> extends Date ? string | Date | null | undefined : T extends number ? number | NumericOperator : T;
 type EditableData<O extends XataRecord> = Identifiable & Partial<Omit<{
     [K in keyof O]: EditableDataFields<O[K]>;
 }, keyof XataRecord>>;
@@ -7894,7 +7913,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record>, 'id'>, columns: K[], options?: {
+    abstract create<K extends SelectableColumn<Record>>(id: Identifier, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -7903,7 +7922,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record>, 'id'>, options?: {
+    abstract create(id: Identifier, object: Omit<EditableData<Record>, 'id'>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -7925,26 +7944,26 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The persisted record for the given id or null if the record could not be found.
      */
-    abstract read<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
+    abstract read<K extends SelectableColumn<Record>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns> | null>>;
     /**
      * Queries a single record from the table given its unique id.
      * @param id The unique id.
      * @returns The persisted record for the given id or null if the record could not be found.
      */
-    abstract read(id: string): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
+    abstract read(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']> | null>>;
     /**
      * Queries multiple records from the table given their unique id.
      * @param ids The unique ids array.
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
      */
-    abstract read<K extends SelectableColumn<Record>>(ids: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    abstract read<K extends SelectableColumn<Record>>(ids: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
     /**
      * Queries multiple records from the table given their unique id.
      * @param ids The unique ids array.
      * @returns The persisted records for the given ids in order (if a record could not be found null is returned).
      */
-    abstract read(ids: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    abstract read(ids: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     /**
      * Queries a single record from the table by the id in the object.
      * @param object Object containing the id of the record.
@@ -7978,14 +7997,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns The persisted record for the given id.
      * @throws If the record could not be found.
      */
-    abstract readOrThrow<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract readOrThrow<K extends SelectableColumn<Record>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Queries a single record from the table given its unique id.
      * @param id The unique id.
      * @returns The persisted record for the given id.
      * @throws If the record could not be found.
      */
-    abstract readOrThrow(id: string): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract readOrThrow(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Queries multiple records from the table given their unique id.
      * @param ids The unique ids array.
@@ -7993,14 +8012,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns The persisted records for the given ids in order.
      * @throws If one or more records could not be found.
      */
-    abstract readOrThrow<K extends SelectableColumn<Record>>(ids: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
+    abstract readOrThrow<K extends SelectableColumn<Record>>(ids: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
     /**
      * Queries multiple records from the table given their unique id.
      * @param ids The unique ids array.
      * @returns The persisted records for the given ids in order.
      * @throws If one or more records could not be found.
      */
-    abstract readOrThrow(ids: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    abstract readOrThrow(ids: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
     /**
      * Queries a single record from the table by the id in the object.
      * @param object Object containing the id of the record.
@@ -8055,7 +8074,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[], options?: {
+    abstract update<K extends SelectableColumn<Record>>(id: Identifier, object: Partial<EditableData<Record>>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
     /**
@@ -8064,7 +8083,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param object The column names and their values that have to be updated.
      * @returns The full persisted record, null if the record could not be found.
      */
-    abstract update(id: string, object: Partial<EditableData<Record>>, options?: {
+    abstract update(id: Identifier, object: Partial<EditableData<Record>>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
     /**
@@ -8107,7 +8126,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns The full persisted record.
      * @throws If the record could not be found.
      */
-    abstract updateOrThrow<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[], options?: {
+    abstract updateOrThrow<K extends SelectableColumn<Record>>(id: Identifier, object: Partial<EditableData<Record>>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -8117,7 +8136,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns The full persisted record.
      * @throws If the record could not be found.
      */
-    abstract updateOrThrow(id: string, object: Partial<EditableData<Record>>, options?: {
+    abstract updateOrThrow(id: Identifier, object: Partial<EditableData<Record>>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -8142,7 +8161,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record> & Identifiable, columns: K[], options?: {
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -8151,7 +8170,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record> & Identifiable, options?: {
+    abstract createOrUpdate(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -8162,7 +8181,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record>, 'id'>, columns: K[], options?: {
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -8172,7 +8191,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param object The column names and the values to be persisted.
      * @returns The full persisted record.
      */
-    abstract createOrUpdate(id: string, object: Omit<EditableData<Record>, 'id'>, options?: {
+    abstract createOrUpdate(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -8182,14 +8201,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<Record> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    abstract createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<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 partially updated, 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<Record> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract createOrUpdate(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
     /**
      * Creates or replaces a single record. If a record exists with the given id,
      * it will be replaced, otherwise a new record will be created.
@@ -8197,7 +8216,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record.
      */
-    abstract createOrReplace<K extends SelectableColumn<Record>>(object: EditableData<Record> & Identifiable, columns: K[], options?: {
+    abstract createOrReplace<K extends SelectableColumn<Record>>(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -8206,7 +8225,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param object Object containing the column names with their values to be persisted in the table.
      * @returns The full persisted record.
      */
-    abstract createOrReplace(object: EditableData<Record> & Identifiable, options?: {
+    abstract createOrReplace(object: Omit<EditableData<Record>, 'id'> & Partial<Identifiable>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -8217,7 +8236,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns The full persisted record.
      */
-    abstract createOrReplace<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
+    abstract createOrReplace<K extends SelectableColumn<Record>>(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
@@ -8227,7 +8246,7 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param object The column names and the values to be persisted.
      * @returns The full persisted record.
      */
-    abstract createOrReplace(id: string, object: Omit<EditableData<Record>, 'id'>, options?: {
+    abstract createOrReplace(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
@@ -8237,14 +8256,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @param columns Array of columns to be returned. If not specified, first level columns will be returned.
      * @returns Array of the persisted records.
      */
-    abstract createOrReplace<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    abstract createOrReplace<K extends SelectableColumn<Record>>(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
     /**
      * Creates or replaces a single record. If a record exists with the given id,
      * it will be replaced, 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 createOrReplace(objects: Array<EditableData<Record> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    abstract createOrReplace(objects: Array<Omit<EditableData<Record>, 'id'> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
     /**
      * Deletes a record given its unique id.
      * @param object An object with a unique id.
@@ -8264,13 +8283,13 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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>;
+    abstract delete<K extends SelectableColumn<Record>>(id: Identifier, 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>;
+    abstract delete(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
     /**
      * Deletes multiple records given an array of objects with ids.
      * @param objects An array of objects with unique ids.
@@ -8290,13 +8309,13 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @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<K extends SelectableColumn<Record>>(objects: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    abstract delete<K extends SelectableColumn<Record>>(objects: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
     /**
      * 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(objects: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
+    abstract delete(objects: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     /**
      * Deletes a record given its unique id.
      * @param object An object with a unique id.
@@ -8319,14 +8338,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns The deleted record, null if the record could not be found.
      * @throws If the record could not be found.
      */
-    abstract deleteOrThrow<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    abstract deleteOrThrow<K extends SelectableColumn<Record>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     /**
      * Deletes a record given a unique id.
      * @param id The unique id.
      * @returns The deleted record, null if the record could not be found.
      * @throws If the record could not be found.
      */
-    abstract deleteOrThrow(id: string): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    abstract deleteOrThrow(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     /**
      * Deletes multiple records given an array of objects with ids.
      * @param objects An array of objects with unique ids.
@@ -8349,14 +8368,14 @@ declare abstract class Repository<Record extends XataRecord> extends Query<Recor
      * @returns Array of the deleted records in order (if a record could not be found null is returned).
      * @throws If one or more records could not be found.
      */
-    abstract deleteOrThrow<K extends SelectableColumn<Record>>(objects: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
+    abstract deleteOrThrow<K extends SelectableColumn<Record>>(objects: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
     /**
      * Deletes multiple records given an array of unique ids.
      * @param objects An array of ids.
      * @returns Array of the deleted records in order.
      * @throws If one or more records could not be found.
      */
-    abstract deleteOrThrow(objects: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    abstract deleteOrThrow(objects: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
     /**
      * Search for records in the table.
      * @param query The query to search for.
@@ -8429,26 +8448,26 @@ declare class RestRepository<Record extends XataRecord> extends Query<Record, Se
     create(object: EditableData<Record> & Partial<Identifiable>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    create<K extends SelectableColumn<Record>>(id: string, object: EditableData<Record>, columns: K[], options?: {
+    create<K extends SelectableColumn<Record>>(id: Identifier, object: EditableData<Record>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    create(id: string, object: EditableData<Record>, options?: {
+    create(id: Identifier, object: EditableData<Record>, options?: {
         ifVersion?: number;
     }): 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<K extends SelectableColumn<Record>>(id: Identifier, 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>>(ids: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    read(ids: Identifier[]): 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>>;
-    readOrThrow<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    readOrThrow(id: string): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    readOrThrow<K extends SelectableColumn<Record>>(ids: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
-    readOrThrow(ids: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    readOrThrow<K extends SelectableColumn<Record>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    readOrThrow(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    readOrThrow<K extends SelectableColumn<Record>>(ids: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
+    readOrThrow(ids: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
     readOrThrow<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     readOrThrow(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     readOrThrow<K extends SelectableColumn<Record>>(objects: Identifiable[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
@@ -8459,10 +8478,10 @@ declare class RestRepository<Record extends XataRecord> extends Query<Record, Se
     update(object: Partial<EditableData<Record>> & Identifiable, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>> | null>;
-    update<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[], options?: {
+    update<K extends SelectableColumn<Record>>(id: Identifier, object: Partial<EditableData<Record>>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
-    update(id: string, object: Partial<EditableData<Record>>, options?: {
+    update(id: Identifier, object: Partial<EditableData<Record>>, options?: {
         ifVersion?: number;
     }): 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>>;
@@ -8473,58 +8492,58 @@ declare class RestRepository<Record extends XataRecord> extends Query<Record, Se
     updateOrThrow(object: Partial<EditableData<Record>> & Identifiable, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    updateOrThrow<K extends SelectableColumn<Record>>(id: string, object: Partial<EditableData<Record>>, columns: K[], options?: {
+    updateOrThrow<K extends SelectableColumn<Record>>(id: Identifier, object: Partial<EditableData<Record>>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    updateOrThrow(id: string, object: Partial<EditableData<Record>>, options?: {
+    updateOrThrow(id: Identifier, object: Partial<EditableData<Record>>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     updateOrThrow<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
     updateOrThrow(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
-    createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Record> & Identifiable, columns: K[], options?: {
+    createOrUpdate<K extends SelectableColumn<Record>>(object: EditableData<Record> & Partial<Identifiable>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    createOrUpdate(object: EditableData<Record> & Identifiable, options?: {
+    createOrUpdate(object: EditableData<Record> & Partial<Identifiable>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    createOrUpdate<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
+    createOrUpdate<K extends SelectableColumn<Record>>(id: Identifier, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    createOrUpdate(id: string, object: Omit<EditableData<Record>, 'id'>, options?: {
+    createOrUpdate(id: Identifier, object: Omit<EditableData<Record>, 'id'>, options?: {
         ifVersion?: number;
     }): 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, ['*']>>[]>;
-    createOrReplace<K extends SelectableColumn<Record>>(object: EditableData<Record> & Identifiable, columns: K[], options?: {
+    createOrUpdate<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    createOrUpdate(objects: Array<EditableData<Record> & Partial<Identifiable>>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    createOrReplace<K extends SelectableColumn<Record>>(object: EditableData<Record> & Partial<Identifiable>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    createOrReplace(object: EditableData<Record> & Identifiable, options?: {
+    createOrReplace(object: EditableData<Record> & Partial<Identifiable>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    createOrReplace<K extends SelectableColumn<Record>>(id: string, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
+    createOrReplace<K extends SelectableColumn<Record>>(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, columns: K[], options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    createOrReplace(id: string, object: Omit<EditableData<Record>, 'id'>, options?: {
+    createOrReplace(id: Identifier | undefined, object: Omit<EditableData<Record>, 'id'>, options?: {
         ifVersion?: number;
     }): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    createOrReplace<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Identifiable>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
-    createOrReplace(objects: Array<EditableData<Record> & Identifiable>): Promise<Readonly<SelectedPick<Record, ['*']>>[]>;
+    createOrReplace<K extends SelectableColumn<Record>>(objects: Array<EditableData<Record> & Partial<Identifiable>>, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>[]>;
+    createOrReplace(objects: Array<EditableData<Record> & Partial<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>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>> | null>;
+    delete(id: Identifier): 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>>;
+    delete<K extends SelectableColumn<Record>>(objects: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>> | null>>;
+    delete(objects: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>> | null>>;
     deleteOrThrow<K extends SelectableColumn<Record>>(object: Identifiable, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
     deleteOrThrow(object: Identifiable): Promise<Readonly<SelectedPick<Record, ['*']>>>;
-    deleteOrThrow<K extends SelectableColumn<Record>>(id: string, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
-    deleteOrThrow(id: string): Promise<Readonly<SelectedPick<Record, ['*']>>>;
+    deleteOrThrow<K extends SelectableColumn<Record>>(id: Identifier, columns: K[]): Promise<Readonly<SelectedPick<Record, typeof columns>>>;
+    deleteOrThrow(id: Identifier): Promise<Readonly<SelectedPick<Record, ['*']>>>;
     deleteOrThrow<K extends SelectableColumn<Record>>(objects: Array<Partial<EditableData<Record>> & Identifiable>, columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
     deleteOrThrow(objects: Array<Partial<EditableData<Record>> & Identifiable>): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
-    deleteOrThrow<K extends SelectableColumn<Record>>(objects: string[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
-    deleteOrThrow(objects: string[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
+    deleteOrThrow<K extends SelectableColumn<Record>>(objects: Identifier[], columns: K[]): Promise<Array<Readonly<SelectedPick<Record, typeof columns>>>>;
+    deleteOrThrow(objects: Identifier[]): Promise<Array<Readonly<SelectedPick<Record, ['*']>>>>;
     search(query: string, options?: {
         fuzziness?: FuzzinessExpression;
         prefix?: PrefixExpression;

package/dist/index.mjs

@@ -490,7 +490,7 @@ function defaultOnOpen(response) {
   }
 }
 
-const VERSION = "0.24.2";
+const VERSION = "0.24.3";
 
 class ErrorWithCause extends Error {
   constructor(message, options) {
@@ -3183,12 +3183,22 @@ class RestRepository extends Query {
         return result;
       }
       if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
         const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
+        return await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a, b, columns, { ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
         const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+        return await __privateMethod$2(this, _upsertRecordWithID, upsertRecordWithID_fn).call(this, a.id, { ...a, id: void 0 }, columns, { ifVersion });
+      }
+      if (!isDefined(a) && isObject(b)) {
+        return await this.create(b, c);
+      }
+      if (isObject(a) && !isDefined(a.id)) {
+        return await this.create(a, b);
       }
       throw new Error("Invalid arguments for createOrUpdate method");
     });
@@ -3205,12 +3215,22 @@ class RestRepository extends Query {
         return result;
       }
       if (isString(a) && isObject(b)) {
+        if (a === "")
+          throw new Error("The id can't be empty");
         const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: false, ifVersion });
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a, b, columns, { createOnly: false, ifVersion });
       }
       if (isObject(a) && isString(a.id)) {
+        if (a.id === "")
+          throw new Error("The id can't be empty");
         const columns = isStringArray(c) ? c : void 0;
-        return __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+        return await __privateMethod$2(this, _insertRecordWithId, insertRecordWithId_fn).call(this, a.id, { ...a, id: void 0 }, columns, { createOnly: false, ifVersion });
+      }
+      if (!isDefined(a) && isObject(b)) {
+        return await this.create(b, c);
+      }
+      if (isObject(a) && !isDefined(a.id)) {
+        return await this.create(a, b);
       }
       throw new Error("Invalid arguments for createOrReplace method");
     });
@@ -3430,6 +3450,8 @@ insertRecordWithoutId_fn = async function(object, columns = ["*"]) {
 };
 _insertRecordWithId = new WeakSet();
 insertRecordWithId_fn = async function(recordId, object, columns = ["*"], { createOnly, ifVersion }) {
+  if (!recordId)
+    return null;
   const record = transformObjectLinks(object);
   const response = await insertRecordWithID({
     pathParams: {
@@ -3477,6 +3499,8 @@ insertRecords_fn = async function(objects, { createOnly, ifVersion }) {
 };
 _updateRecordWithID = new WeakSet();
 updateRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
+  if (!recordId)
+    return null;
   const { id: _id, ...record } = transformObjectLinks(object);
   try {
     const response = await updateRecordWithID({
@@ -3531,6 +3555,8 @@ updateRecords_fn = async function(objects, { ifVersion, upsert }) {
 };
 _upsertRecordWithID = new WeakSet();
 upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVersion }) {
+  if (!recordId)
+    return null;
   const response = await upsertRecordWithID({
     pathParams: {
       workspace: "{workspaceId}",
@@ -3548,6 +3574,8 @@ upsertRecordWithID_fn = async function(recordId, object, columns = ["*"], { ifVe
 };
 _deleteRecord = new WeakSet();
 deleteRecord_fn = async function(recordId, columns = ["*"]) {
+  if (!recordId)
+    return null;
   try {
     const response = await deleteRecord({
       pathParams: {
@@ -3572,7 +3600,7 @@ deleteRecord_fn = async function(recordId, columns = ["*"]) {
 _deleteRecords = new WeakSet();
 deleteRecords_fn = async function(recordIds) {
   const chunkedOperations = chunk(
-    recordIds.map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
+    compact(recordIds).map((id) => ({ delete: { table: __privateGet$4(this, _table), id } })),
     BULK_OPERATION_MAX_SIZE
   );
   for (const operations of chunkedOperations) {