remult 0.22.7-exp.0 → 0.22.7

package/esm/src/remult3/remult3.d.ts

@@ -1,397 +1,397 @@
-import type { ErrorInfo } from '../..';
-import type { ClassType } from '../../classType';
-import type { entityEventListener } from '../__EntityValueProvider';
-import type { FieldMetadata } from '../column-interfaces';
-import type { EntityOptions } from '../entity';
-import type { LiveQueryChange, SubscriptionListener, Unsubscribe } from '../live-query/SubscriptionChannel';
-import type { SortSegment } from '../sort';
-export interface EntityRef<entityType> extends Subscribable {
-    hasErrors(): boolean;
-    undoChanges(): any;
-    save(): Promise<entityType>;
-    reload(): Promise<entityType>;
-    delete(): Promise<void>;
-    isNew(): boolean;
-    wasChanged(): boolean;
-    wasDeleted(): boolean;
-    fields: FieldsRef<entityType>;
-    error: string;
-    getId(): idType<entityType>;
-    getOriginalId(): idType<entityType>;
-    repository: Repository<entityType>;
-    metadata: EntityMetadata<entityType>;
-    toApiJson(): any;
-    validate(): Promise<ErrorInfo<entityType> | undefined>;
-    readonly apiUpdateAllowed: boolean;
-    readonly apiDeleteAllowed: boolean;
-    readonly apiInsertAllowed: boolean;
-    readonly isLoading: boolean;
-}
-export interface ControllerRef<entityType> extends Subscribable {
-    hasErrors(): boolean;
-    fields: FieldsRef<entityType>;
-    error: string;
-    validate(): Promise<ErrorInfo<entityType> | undefined>;
-    readonly isLoading: boolean;
-}
-export interface RefSubscriberBase {
-    reportChanged: () => void;
-    reportObserved: () => void;
-}
-export declare type RefSubscriber = (() => void) | RefSubscriberBase;
-export interface Subscribable {
-    subscribe(listener: RefSubscriber): Unsubscribe;
-}
-export declare type FieldsRef<entityType> = {
-    [Properties in keyof OmitEB<entityType>]: entityType[Properties] extends {
-        id?: number | string;
-    } ? IdFieldRef<entityType, entityType[Properties]> : FieldRef<entityType, entityType[Properties]>;
-} & {
-    find(fieldMetadataOrKey: FieldMetadata | string): FieldRef<entityType, any>;
-    [Symbol.iterator]: () => IterableIterator<FieldRef<entityType, any>>;
-    toArray(): FieldRef<entityType, any>[];
-};
-export declare type FieldsMetadata<entityType> = {
-    [Properties in keyof OmitEB<entityType>]: FieldMetadata<entityType[Properties], entityType>;
-} & {
-    find(fieldMetadataOrKey: FieldMetadata | string): FieldMetadata<any, entityType>;
-    [Symbol.iterator]: () => IterableIterator<FieldMetadata<any, entityType>>;
-    toArray(): FieldMetadata<any, entityType>[];
-};
-export declare type SortSegments<entityType> = {
-    [Properties in keyof entityType]: SortSegment & {
-        descending(): SortSegment;
-    };
-};
-export interface IdFieldRef<entityType, valueType> extends FieldRef<entityType, valueType> {
-    setId(id: valueType extends {
-        id?: number;
-    } ? number : valueType extends {
-        id?: string;
-    } ? string : string | number): any;
-    getId(): valueType extends {
-        id?: number;
-    } ? number : valueType extends {
-        id?: string;
-    } ? string : string | number;
-}
-export interface FieldRef<entityType = any, valueType = any> extends Subscribable {
-    error: string;
-    displayValue: string;
-    value: valueType;
-    originalValue: valueType;
-    inputValue: string;
-    valueChanged(): boolean;
-    entityRef: EntityRef<entityType>;
-    container: entityType;
-    metadata: FieldMetadata<valueType>;
-    load(): Promise<valueType>;
-    valueIsNull(): boolean;
-    originalValueIsNull(): boolean;
-    validate(): Promise<boolean>;
-}
-export interface IdMetadata<entityType = any> {
-    /** Extracts the id value of an entity item. Useful in cases where the id column is not called id
-     * @example
-     * repo.metadata.idMetadata.getId(task)
-     */
-    getId(item: Partial<OmitEB<entityType>>): any;
-    field: FieldMetadata<any>;
-    getIdFilter(...ids: any[]): EntityFilter<entityType>;
-    isIdField(col: FieldMetadata): boolean;
-    createIdInFilter(items: Partial<OmitEB<entityType>>[]): EntityFilter<entityType>;
-}
-/** Metadata for an `Entity`, this metadata can be used in the user interface to provide a richer UI experience  */
-export interface EntityMetadata<entityType = any> {
-    /** The Entity's key also used as it's url  */
-    readonly key: string;
-    /** Metadata for the Entity's fields */
-    readonly fields: FieldsMetadata<entityType>;
-    /** A human readable caption for the entity. Can be used to achieve a consistent caption for a field throughout the app
-     * @example
-     * <h1>Create a new item in {taskRepo.metadata.caption}</h1>
-     */
-    readonly caption: string;
-    /** The options send to the `Entity`'s decorator */
-    readonly options: EntityOptions;
-    /** The class type of the entity */
-    readonly entityType: ClassType<entityType>;
-    /** true if the current user is allowed to update an entity instance
-     * @example
-     * const taskRepo = remult.repo(Task);
-     * if (taskRepo.metadata.apiUpdateAllowed(task)){
-     *   // Allow user to edit the entity
-     * }
-     */
-    apiUpdateAllowed(item?: entityType): boolean;
-    /** true if the current user is allowed to read from entity
-     * @example
-     * const taskRepo = remult.repo(Task);
-     * if (taskRepo.metadata.apiReadAllowed){
-     *   await taskRepo.find()
-     * }
-     */
-    readonly apiReadAllowed: boolean;
-    /** true if the current user is allowed to delete an entity instance
-     * @example
-     * const taskRepo = remult.repo(Task);
-     * if (taskRepo.metadata.apiDeleteAllowed(task)){
-     *   // display delete button
-     * }
-     */
-    apiDeleteAllowed(item?: entityType): boolean;
-    /** true if the current user is allowed to create an entity instance
-     * @example
-     * const taskRepo = remult.repo(Task);
-     * if (taskRepo.metadata.apiInsertAllowed(task)){
-     *   // display insert button
-     * }
-     */
-    apiInsertAllowed(item?: entityType): boolean;
-    /** Returns the dbName - based on it's `dbName` option and it's `sqlExpression` option */
-    getDbName(): Promise<string>;
-    /** Metadata for the Entity's id */
-    readonly idMetadata: IdMetadata<entityType>;
-}
-export declare type OmitEB<T> = Omit<T, keyof import('./RepositoryImplementation').EntityBase>;
-export declare type idType<entityType> = entityType extends {
-    id?: number;
-} ? number : entityType extends {
-    id?: string;
-} ? string : string | number;
-/**used to perform CRUD operations on an `entityType` */
-export interface Repository<entityType> {
-    /** returns a result array based on the provided options */
-    find(options?: FindOptions<entityType>): Promise<entityType[]>;
-    /** returns a result array based on the provided options */
-    liveQuery(options?: FindOptions<entityType>): LiveQuery<entityType>;
-    /** returns the first item that matchers the `where` condition
-     * @example
-     * await taskRepo.findFirst({ completed:false })
-     * @example
-     * await taskRepo.findFirst({ completed:false },{ createIfNotFound: true })
-     *      */
-    findFirst(where?: EntityFilter<entityType>, options?: FindFirstOptions<entityType>): Promise<entityType>;
-    /** returns the items that matches the idm the result is cached unless specified differently in the `options` parameter */
-    findId(id: idType<entityType>, options?: FindFirstOptionsBase<entityType>): Promise<entityType>;
-    /**  An alternative form of fetching data from the API server, which is intended for operating on large numbers of entity objects.
-     *
-     * It also has it's own paging mechanism that can be used n paging scenarios.
-     *
-     * The `query` method doesn't return an array (as the `find` method) and instead returns an `iterable` `QueryResult` object
-     * which supports iterations using the JavaScript `for await` statement.
-     * @example
-     * for await (const task of taskRepo.query()) {
-     *   // do something.
-     * }
-     * */
-    query(options?: QueryOptions<entityType>): QueryResult<entityType>;
-    /** Returns a count of the items matching the criteria.
-     * @see [EntityFilter](http://remult.dev/docs/entityFilter.html)
-     * @example
-     * await taskRepo.count({ completed:false })
-     */
-    count(where?: EntityFilter<entityType>): Promise<number>;
-    /**Validates an item
-     * @example
-     * const error = repo.validate(task);
-     * if (error){
-     *   alert(error.message);
-     *   alert(error.modelState.title);//shows the specific error for the title field
-     * }
-     * // Can also be used to validate specific fields
-     * const error = repo.validate(task,"title")
-     */
-    validate(item: Partial<entityType>, ...fields: Extract<keyof OmitEB<entityType>, string>[]): Promise<ErrorInfo<entityType> | undefined>;
-    /** saves an item or item[] to the data source. It assumes that if an `id` value exists, it's an existing row - otherwise it's a new row
-     * @example
-     * await taskRepo.save({...task, completed:true })
-     */
-    save(item: Partial<OmitEB<entityType>>[]): Promise<entityType[]>;
-    save(item: Partial<OmitEB<entityType>>): Promise<entityType>;
-    /**Insert an item or item[] to the data source
-     * @example
-     * await taskRepo.insert({title:"task a"})
-     * @example
-     * await taskRepo.insert([{title:"task a"}, {title:"task b", completed:true }])
-     */
-    insert(item: Partial<OmitEB<entityType>>[]): Promise<entityType[]>;
-    insert(item: Partial<OmitEB<entityType>>): Promise<entityType>;
-    /** Updates an item, based on its `id`
-     * @example
-     * taskRepo.update(task.id,{...task,completed:true})
-     */
-    update(id: entityType extends {
-        id?: number;
-    } ? number : entityType extends {
-        id?: string;
-    } ? string : string | number, item: Partial<OmitEB<entityType>>): Promise<entityType>;
-    update(id: Partial<OmitEB<entityType>>, item: Partial<OmitEB<entityType>>): Promise<entityType>;
-    /** Deletes an Item*/
-    delete(id: entityType extends {
-        id?: number;
-    } ? number : entityType extends {
-        id?: string;
-    } ? string : string | number): Promise<void>;
-    delete(item: Partial<OmitEB<entityType>>): Promise<void>;
-    /** Creates an instance of an item. It'll not be saved to the data source unless `save` or `insert` will be called for that item */
-    create(item?: Partial<OmitEB<entityType>>): entityType;
-    toJson(item: Promise<entityType[]>): Promise<any[]>;
-    toJson(item: entityType[]): any[];
-    toJson(item: Promise<entityType>): Promise<any>;
-    toJson(item: entityType): any;
-    /** Translates a json object to an item instance */
-    fromJson(x: any[], isNew?: boolean): entityType[];
-    fromJson(x: any, isNew?: boolean): entityType;
-    /** returns an `entityRef` for an item returned by `create`, `find` etc... */
-    getEntityRef(item: entityType): EntityRef<entityType>;
-    /** Provides information about the fields of the Repository's entity
-     * @example
-     * console.log(repo.fields.title.caption) // displays the caption of a specific field
-     * console.log(repo.fields.title.options)// writes the options that were defined for this field
-     */
-    fields: FieldsMetadata<entityType>;
-    /**The metadata for the `entity`
-     * @See [EntityMetadata](https://remult.dev/docs/ref_entitymetadata.html)
-     */
-    metadata: EntityMetadata<entityType>;
-    addEventListener(listener: entityEventListener<entityType>): Unsubscribe;
-}
-export interface LiveQuery<entityType> {
-    subscribe(next: (info: LiveQueryChangeInfo<entityType>) => void): Unsubscribe;
-    subscribe(listener: Partial<SubscriptionListener<LiveQueryChangeInfo<entityType>>>): Unsubscribe;
-}
-export interface LiveQueryChangeInfo<entityType> {
-    items: entityType[];
-    changes: LiveQueryChange[];
-    applyChanges(prevState: entityType[] | undefined): entityType[];
-}
-export interface FindOptions<entityType> extends FindOptionsBase<entityType> {
-    /** Determines the number of rows returned by the request, on the browser the default is 100 rows
-     * @example
-     * await this.remult.repo(Products).find({
-     *  limit:10,
-     *  page:2
-     * })
-     */
-    limit?: number;
-    /** Determines the page number that will be used to extract the data
-     * @example
-     * await this.remult.repo(Products).find({
-     *  limit:10,
-     *  page:2
-     * })
-     */
-    page?: number;
-}
-/** Determines the order of items returned .
- * @example
- * await this.remult.repo(Products).find({ orderBy: { name: "asc" }})
- * @example
- * await this.remult.repo(Products).find({ orderBy: { price: "desc", name: "asc" }})
- */
-export declare type EntityOrderBy<entityType> = {
-    [Properties in keyof Partial<OmitEB<entityType>>]?: 'asc' | 'desc';
-};
-/**Used to filter the desired result set
- * @see [EntityFilter](http://remult.dev/docs/entityFilter.html)
- */
-export declare type EntityFilter<entityType> = {
-    [Properties in keyof Partial<OmitEB<entityType>>]?: (Partial<OmitEB<entityType>>[Properties] extends number | Date | undefined ? ComparisonValueFilter<Partial<OmitEB<entityType>>[Properties]> : Partial<OmitEB<entityType>>[Properties] extends string | undefined ? ContainsStringValueFilter & ComparisonValueFilter<string> : Partial<OmitEB<entityType>>[Properties] extends boolean | undefined ? ValueFilter<boolean> : Partial<OmitEB<entityType>>[Properties] extends {
-        id?: string | number;
-    } | undefined ? IdFilter<Partial<OmitEB<entityType>>[Properties]> : ValueFilter<Partial<OmitEB<entityType>>[Properties]>) & ContainsStringValueFilter;
-} & {
-    $or?: EntityFilter<entityType>[];
-    $and?: EntityFilter<entityType>[];
-};
-export declare type ValueFilter<valueType> = valueType | valueType[] | {
-    $ne?: valueType | valueType[];
-    '!='?: valueType | valueType[];
-    $in?: valueType[];
-    $nin?: valueType[];
-};
-export declare type ComparisonValueFilter<valueType> = ValueFilter<valueType> & {
-    $gt?: valueType;
-    '>'?: valueType;
-    $gte?: valueType;
-    '>='?: valueType;
-    $lt?: valueType;
-    '<'?: valueType;
-    $lte?: valueType;
-    '<='?: valueType;
-};
-export interface ContainsStringValueFilter {
-    $contains?: string;
-}
-export declare type IdFilter<valueType> = ValueFilter<valueType> | {
-    $id: ValueFilter<valueType extends {
-        id?: number;
-    } ? number : string>;
-};
-export interface LoadOptions<entityType> {
-    load?: (entity: FieldsMetadata<entityType>) => FieldMetadata[];
-}
-export interface FindOptionsBase<entityType> extends LoadOptions<entityType> {
-    /** filters the data
-     * @example
-     * await taskRepo.find({where: { completed:false }})
-     * @see For more usage examples see [EntityFilter](https://remult.dev/docs/entityFilter.html)
-     */
-    where?: EntityFilter<entityType>;
-    /** Determines the order of items returned .
-     * @example
-     * await this.remult.repo(Products).find({ orderBy: { name: "asc" }})
-     * @example
-     * await this.remult.repo(Products).find({ orderBy: { price: "desc", name: "asc" }})
-     */
-    orderBy?: EntityOrderBy<entityType>;
-}
-export interface FindFirstOptions<entityType> extends FindOptionsBase<entityType>, FindFirstOptionsBase<entityType> {
-}
-export interface FindFirstOptionsBase<entityType> extends LoadOptions<entityType> {
-    /** determines if to cache the result, and return the results from cache.
-     */
-    useCache?: boolean;
-    /** If set to true and an item is not found, it's created and returned*/
-    createIfNotFound?: boolean;
-}
-export interface QueryOptions<entityType> extends FindOptionsBase<entityType> {
-    /** The number of items to return in each step */
-    pageSize?: number;
-    /** A callback method to indicate the progress of the iteration */
-    progress?: {
-        progress: (progress: number) => void;
-    };
-}
-/** The result of a call to the `query` method in the `Repository` object.
- */
-export interface QueryResult<entityType> {
-    /** returns an iterator that iterates the rows in the result using a paging mechanism
-     * @example
-     * for await (const task of taskRepo.query()) {
-     *   await taskRepo.save({ ...task, completed });
-     * }
-     */
-    [Symbol.asyncIterator](): {
-        next: () => Promise<IteratorResult<entityType, entityType>>;
-    };
-    /** returns the number of rows that match the query criteria */
-    count(): Promise<number>;
-    /** Returns a `Paginator` object that is used for efficient paging */
-    paginator(): Promise<Paginator<entityType>>;
-    /** gets the items in a specific page */
-    getPage(pageNumber?: number): Promise<entityType[]>;
-    /** Performs an operation on all the items matching the query criteria */
-    forEach(what: (item: entityType) => Promise<any>): Promise<number>;
-}
-/** An interface used to paginating using the `query` method in the `Repository` object */
-export interface Paginator<entityType> {
-    /** the items in the current page */
-    items: entityType[];
-    /** True if next page exists */
-    hasNextPage: boolean;
-    /** Gets the next page in the `query`'s result set */
-    nextPage(): Promise<Paginator<entityType>>;
-    /** the count of the total items in the `query`'s result */
-    count(): Promise<number>;
-}
+import type { ErrorInfo } from '../..';
+import type { ClassType } from '../../classType';
+import type { entityEventListener } from '../__EntityValueProvider';
+import type { FieldMetadata } from '../column-interfaces';
+import type { EntityOptions } from '../entity';
+import type { LiveQueryChange, SubscriptionListener, Unsubscribe } from '../live-query/SubscriptionChannel';
+import type { SortSegment } from '../sort';
+export interface EntityRef<entityType> extends Subscribable {
+    hasErrors(): boolean;
+    undoChanges(): any;
+    save(): Promise<entityType>;
+    reload(): Promise<entityType>;
+    delete(): Promise<void>;
+    isNew(): boolean;
+    wasChanged(): boolean;
+    wasDeleted(): boolean;
+    fields: FieldsRef<entityType>;
+    error: string;
+    getId(): idType<entityType>;
+    getOriginalId(): idType<entityType>;
+    repository: Repository<entityType>;
+    metadata: EntityMetadata<entityType>;
+    toApiJson(): any;
+    validate(): Promise<ErrorInfo<entityType> | undefined>;
+    readonly apiUpdateAllowed: boolean;
+    readonly apiDeleteAllowed: boolean;
+    readonly apiInsertAllowed: boolean;
+    readonly isLoading: boolean;
+}
+export interface ControllerRef<entityType> extends Subscribable {
+    hasErrors(): boolean;
+    fields: FieldsRef<entityType>;
+    error: string;
+    validate(): Promise<ErrorInfo<entityType> | undefined>;
+    readonly isLoading: boolean;
+}
+export interface RefSubscriberBase {
+    reportChanged: () => void;
+    reportObserved: () => void;
+}
+export declare type RefSubscriber = (() => void) | RefSubscriberBase;
+export interface Subscribable {
+    subscribe(listener: RefSubscriber): Unsubscribe;
+}
+export type FieldsRef<entityType> = {
+    [Properties in keyof OmitEB<entityType>]: entityType[Properties] extends {
+        id?: number | string;
+    } ? IdFieldRef<entityType, entityType[Properties]> : FieldRef<entityType, entityType[Properties]>;
+} & {
+    find(fieldMetadataOrKey: FieldMetadata | string): FieldRef<entityType, any>;
+    [Symbol.iterator]: () => IterableIterator<FieldRef<entityType, any>>;
+    toArray(): FieldRef<entityType, any>[];
+};
+export type FieldsMetadata<entityType> = {
+    [Properties in keyof OmitEB<entityType>]: FieldMetadata<entityType[Properties], entityType>;
+} & {
+    find(fieldMetadataOrKey: FieldMetadata | string): FieldMetadata<any, entityType>;
+    [Symbol.iterator]: () => IterableIterator<FieldMetadata<any, entityType>>;
+    toArray(): FieldMetadata<any, entityType>[];
+};
+export type SortSegments<entityType> = {
+    [Properties in keyof entityType]: SortSegment & {
+        descending(): SortSegment;
+    };
+};
+export interface IdFieldRef<entityType, valueType> extends FieldRef<entityType, valueType> {
+    setId(id: valueType extends {
+        id?: number;
+    } ? number : valueType extends {
+        id?: string;
+    } ? string : string | number): any;
+    getId(): valueType extends {
+        id?: number;
+    } ? number : valueType extends {
+        id?: string;
+    } ? string : string | number;
+}
+export interface FieldRef<entityType = any, valueType = any> extends Subscribable {
+    error: string;
+    displayValue: string;
+    value: valueType;
+    originalValue: valueType;
+    inputValue: string;
+    valueChanged(): boolean;
+    entityRef: EntityRef<entityType>;
+    container: entityType;
+    metadata: FieldMetadata<valueType>;
+    load(): Promise<valueType>;
+    valueIsNull(): boolean;
+    originalValueIsNull(): boolean;
+    validate(): Promise<boolean>;
+}
+export interface IdMetadata<entityType = any> {
+    /** Extracts the id value of an entity item. Useful in cases where the id column is not called id
+     * @example
+     * repo.metadata.idMetadata.getId(task)
+     */
+    getId(item: Partial<OmitEB<entityType>>): any;
+    field: FieldMetadata<any>;
+    getIdFilter(...ids: any[]): EntityFilter<entityType>;
+    isIdField(col: FieldMetadata): boolean;
+    createIdInFilter(items: Partial<OmitEB<entityType>>[]): EntityFilter<entityType>;
+}
+/** Metadata for an `Entity`, this metadata can be used in the user interface to provide a richer UI experience  */
+export interface EntityMetadata<entityType = any> {
+    /** The Entity's key also used as it's url  */
+    readonly key: string;
+    /** Metadata for the Entity's fields */
+    readonly fields: FieldsMetadata<entityType>;
+    /** A human readable caption for the entity. Can be used to achieve a consistent caption for a field throughout the app
+     * @example
+     * <h1>Create a new item in {taskRepo.metadata.caption}</h1>
+     */
+    readonly caption: string;
+    /** The options send to the `Entity`'s decorator */
+    readonly options: EntityOptions;
+    /** The class type of the entity */
+    readonly entityType: ClassType<entityType>;
+    /** true if the current user is allowed to update an entity instance
+     * @example
+     * const taskRepo = remult.repo(Task);
+     * if (taskRepo.metadata.apiUpdateAllowed(task)){
+     *   // Allow user to edit the entity
+     * }
+     */
+    apiUpdateAllowed(item?: entityType): boolean;
+    /** true if the current user is allowed to read from entity
+     * @example
+     * const taskRepo = remult.repo(Task);
+     * if (taskRepo.metadata.apiReadAllowed){
+     *   await taskRepo.find()
+     * }
+     */
+    readonly apiReadAllowed: boolean;
+    /** true if the current user is allowed to delete an entity instance
+     * @example
+     * const taskRepo = remult.repo(Task);
+     * if (taskRepo.metadata.apiDeleteAllowed(task)){
+     *   // display delete button
+     * }
+     */
+    apiDeleteAllowed(item?: entityType): boolean;
+    /** true if the current user is allowed to create an entity instance
+     * @example
+     * const taskRepo = remult.repo(Task);
+     * if (taskRepo.metadata.apiInsertAllowed(task)){
+     *   // display insert button
+     * }
+     */
+    apiInsertAllowed(item?: entityType): boolean;
+    /** Returns the dbName - based on it's `dbName` option and it's `sqlExpression` option */
+    getDbName(): Promise<string>;
+    /** Metadata for the Entity's id */
+    readonly idMetadata: IdMetadata<entityType>;
+}
+export declare type OmitEB<T> = Omit<T, keyof import('./RepositoryImplementation').EntityBase>;
+export declare type idType<entityType> = entityType extends {
+    id?: number;
+} ? number : entityType extends {
+    id?: string;
+} ? string : string | number;
+/**used to perform CRUD operations on an `entityType` */
+export interface Repository<entityType> {
+    /** returns a result array based on the provided options */
+    find(options?: FindOptions<entityType>): Promise<entityType[]>;
+    /** returns a result array based on the provided options */
+    liveQuery(options?: FindOptions<entityType>): LiveQuery<entityType>;
+    /** returns the first item that matchers the `where` condition
+     * @example
+     * await taskRepo.findFirst({ completed:false })
+     * @example
+     * await taskRepo.findFirst({ completed:false },{ createIfNotFound: true })
+     *      */
+    findFirst(where?: EntityFilter<entityType>, options?: FindFirstOptions<entityType>): Promise<entityType>;
+    /** returns the items that matches the idm the result is cached unless specified differently in the `options` parameter */
+    findId(id: idType<entityType>, options?: FindFirstOptionsBase<entityType>): Promise<entityType>;
+    /**  An alternative form of fetching data from the API server, which is intended for operating on large numbers of entity objects.
+     *
+     * It also has it's own paging mechanism that can be used n paging scenarios.
+     *
+     * The `query` method doesn't return an array (as the `find` method) and instead returns an `iterable` `QueryResult` object
+     * which supports iterations using the JavaScript `for await` statement.
+     * @example
+     * for await (const task of taskRepo.query()) {
+     *   // do something.
+     * }
+     * */
+    query(options?: QueryOptions<entityType>): QueryResult<entityType>;
+    /** Returns a count of the items matching the criteria.
+     * @see [EntityFilter](http://remult.dev/docs/entityFilter.html)
+     * @example
+     * await taskRepo.count({ completed:false })
+     */
+    count(where?: EntityFilter<entityType>): Promise<number>;
+    /**Validates an item
+     * @example
+     * const error = repo.validate(task);
+     * if (error){
+     *   alert(error.message);
+     *   alert(error.modelState.title);//shows the specific error for the title field
+     * }
+     * // Can also be used to validate specific fields
+     * const error = repo.validate(task,"title")
+     */
+    validate(item: Partial<entityType>, ...fields: Extract<keyof OmitEB<entityType>, string>[]): Promise<ErrorInfo<entityType> | undefined>;
+    /** saves an item or item[] to the data source. It assumes that if an `id` value exists, it's an existing row - otherwise it's a new row
+     * @example
+     * await taskRepo.save({...task, completed:true })
+     */
+    save(item: Partial<OmitEB<entityType>>[]): Promise<entityType[]>;
+    save(item: Partial<OmitEB<entityType>>): Promise<entityType>;
+    /**Insert an item or item[] to the data source
+     * @example
+     * await taskRepo.insert({title:"task a"})
+     * @example
+     * await taskRepo.insert([{title:"task a"}, {title:"task b", completed:true }])
+     */
+    insert(item: Partial<OmitEB<entityType>>[]): Promise<entityType[]>;
+    insert(item: Partial<OmitEB<entityType>>): Promise<entityType>;
+    /** Updates an item, based on its `id`
+     * @example
+     * taskRepo.update(task.id,{...task,completed:true})
+     */
+    update(id: entityType extends {
+        id?: number;
+    } ? number : entityType extends {
+        id?: string;
+    } ? string : string | number, item: Partial<OmitEB<entityType>>): Promise<entityType>;
+    update(id: Partial<OmitEB<entityType>>, item: Partial<OmitEB<entityType>>): Promise<entityType>;
+    /** Deletes an Item*/
+    delete(id: entityType extends {
+        id?: number;
+    } ? number : entityType extends {
+        id?: string;
+    } ? string : string | number): Promise<void>;
+    delete(item: Partial<OmitEB<entityType>>): Promise<void>;
+    /** Creates an instance of an item. It'll not be saved to the data source unless `save` or `insert` will be called for that item */
+    create(item?: Partial<OmitEB<entityType>>): entityType;
+    toJson(item: Promise<entityType[]>): Promise<any[]>;
+    toJson(item: entityType[]): any[];
+    toJson(item: Promise<entityType>): Promise<any>;
+    toJson(item: entityType): any;
+    /** Translates a json object to an item instance */
+    fromJson(x: any[], isNew?: boolean): entityType[];
+    fromJson(x: any, isNew?: boolean): entityType;
+    /** returns an `entityRef` for an item returned by `create`, `find` etc... */
+    getEntityRef(item: entityType): EntityRef<entityType>;
+    /** Provides information about the fields of the Repository's entity
+     * @example
+     * console.log(repo.fields.title.caption) // displays the caption of a specific field
+     * console.log(repo.fields.title.options)// writes the options that were defined for this field
+     */
+    fields: FieldsMetadata<entityType>;
+    /**The metadata for the `entity`
+     * @See [EntityMetadata](https://remult.dev/docs/ref_entitymetadata.html)
+     */
+    metadata: EntityMetadata<entityType>;
+    addEventListener(listener: entityEventListener<entityType>): Unsubscribe;
+}
+export interface LiveQuery<entityType> {
+    subscribe(next: (info: LiveQueryChangeInfo<entityType>) => void): Unsubscribe;
+    subscribe(listener: Partial<SubscriptionListener<LiveQueryChangeInfo<entityType>>>): Unsubscribe;
+}
+export interface LiveQueryChangeInfo<entityType> {
+    items: entityType[];
+    changes: LiveQueryChange[];
+    applyChanges(prevState: entityType[] | undefined): entityType[];
+}
+export interface FindOptions<entityType> extends FindOptionsBase<entityType> {
+    /** Determines the number of rows returned by the request, on the browser the default is 100 rows
+     * @example
+     * await this.remult.repo(Products).find({
+     *  limit:10,
+     *  page:2
+     * })
+     */
+    limit?: number;
+    /** Determines the page number that will be used to extract the data
+     * @example
+     * await this.remult.repo(Products).find({
+     *  limit:10,
+     *  page:2
+     * })
+     */
+    page?: number;
+}
+/** Determines the order of items returned .
+ * @example
+ * await this.remult.repo(Products).find({ orderBy: { name: "asc" }})
+ * @example
+ * await this.remult.repo(Products).find({ orderBy: { price: "desc", name: "asc" }})
+ */
+export declare type EntityOrderBy<entityType> = {
+    [Properties in keyof Partial<OmitEB<entityType>>]?: 'asc' | 'desc';
+};
+/**Used to filter the desired result set
+ * @see [EntityFilter](http://remult.dev/docs/entityFilter.html)
+ */
+export declare type EntityFilter<entityType> = {
+    [Properties in keyof Partial<OmitEB<entityType>>]?: (Partial<OmitEB<entityType>>[Properties] extends number | Date | undefined ? ComparisonValueFilter<Partial<OmitEB<entityType>>[Properties]> : Partial<OmitEB<entityType>>[Properties] extends string | undefined ? ContainsStringValueFilter & ComparisonValueFilter<string> : Partial<OmitEB<entityType>>[Properties] extends boolean | undefined ? ValueFilter<boolean> : Partial<OmitEB<entityType>>[Properties] extends {
+        id?: string | number;
+    } | undefined ? IdFilter<Partial<OmitEB<entityType>>[Properties]> : ValueFilter<Partial<OmitEB<entityType>>[Properties]>) & ContainsStringValueFilter;
+} & {
+    $or?: EntityFilter<entityType>[];
+    $and?: EntityFilter<entityType>[];
+};
+export type ValueFilter<valueType> = valueType | valueType[] | {
+    $ne?: valueType | valueType[];
+    '!='?: valueType | valueType[];
+    $in?: valueType[];
+    $nin?: valueType[];
+};
+export type ComparisonValueFilter<valueType> = ValueFilter<valueType> & {
+    $gt?: valueType;
+    '>'?: valueType;
+    $gte?: valueType;
+    '>='?: valueType;
+    $lt?: valueType;
+    '<'?: valueType;
+    $lte?: valueType;
+    '<='?: valueType;
+};
+export interface ContainsStringValueFilter {
+    $contains?: string;
+}
+export type IdFilter<valueType> = ValueFilter<valueType> | {
+    $id: ValueFilter<valueType extends {
+        id?: number;
+    } ? number : string>;
+};
+export interface LoadOptions<entityType> {
+    load?: (entity: FieldsMetadata<entityType>) => FieldMetadata[];
+}
+export interface FindOptionsBase<entityType> extends LoadOptions<entityType> {
+    /** filters the data
+     * @example
+     * await taskRepo.find({where: { completed:false }})
+     * @see For more usage examples see [EntityFilter](https://remult.dev/docs/entityFilter.html)
+     */
+    where?: EntityFilter<entityType>;
+    /** Determines the order of items returned .
+     * @example
+     * await this.remult.repo(Products).find({ orderBy: { name: "asc" }})
+     * @example
+     * await this.remult.repo(Products).find({ orderBy: { price: "desc", name: "asc" }})
+     */
+    orderBy?: EntityOrderBy<entityType>;
+}
+export interface FindFirstOptions<entityType> extends FindOptionsBase<entityType>, FindFirstOptionsBase<entityType> {
+}
+export interface FindFirstOptionsBase<entityType> extends LoadOptions<entityType> {
+    /** determines if to cache the result, and return the results from cache.
+     */
+    useCache?: boolean;
+    /** If set to true and an item is not found, it's created and returned*/
+    createIfNotFound?: boolean;
+}
+export interface QueryOptions<entityType> extends FindOptionsBase<entityType> {
+    /** The number of items to return in each step */
+    pageSize?: number;
+    /** A callback method to indicate the progress of the iteration */
+    progress?: {
+        progress: (progress: number) => void;
+    };
+}
+/** The result of a call to the `query` method in the `Repository` object.
+ */
+export interface QueryResult<entityType> {
+    /** returns an iterator that iterates the rows in the result using a paging mechanism
+     * @example
+     * for await (const task of taskRepo.query()) {
+     *   await taskRepo.save({ ...task, completed });
+     * }
+     */
+    [Symbol.asyncIterator](): {
+        next: () => Promise<IteratorResult<entityType, entityType>>;
+    };
+    /** returns the number of rows that match the query criteria */
+    count(): Promise<number>;
+    /** Returns a `Paginator` object that is used for efficient paging */
+    paginator(): Promise<Paginator<entityType>>;
+    /** gets the items in a specific page */
+    getPage(pageNumber?: number): Promise<entityType[]>;
+    /** Performs an operation on all the items matching the query criteria */
+    forEach(what: (item: entityType) => Promise<any>): Promise<number>;
+}
+/** An interface used to paginating using the `query` method in the `Repository` object */
+export interface Paginator<entityType> {
+    /** the items in the current page */
+    items: entityType[];
+    /** True if next page exists */
+    hasNextPage: boolean;
+    /** Gets the next page in the `query`'s result set */
+    nextPage(): Promise<Paginator<entityType>>;
+    /** the count of the total items in the `query`'s result */
+    count(): Promise<number>;
+}