remult 0.23.0-exp.2 → 0.23.0-exp.21

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

@@ -23,11 +23,56 @@ export interface EntityRef<entityType> extends Subscribable {
     metadata: EntityMetadata<entityType>;
     toApiJson(): any;
     validate(): Promise<ErrorInfo<entityType> | undefined>;
+    relations: RepositoryRelations<entityType>;
     readonly apiUpdateAllowed: boolean;
     readonly apiDeleteAllowed: boolean;
     readonly apiInsertAllowed: boolean;
     readonly isLoading: boolean;
 }
+/**
+ * Represents a lifecycle event associated with an entity instance. These events
+ * are triggered during various stages of the entity's lifecycle, such as validation,
+ * saving, saved, deleting, and deleted.
+ *
+ * @template entityType The type of the entity associated with the event.
+ * @see [Entity Lifecycle Hooks](http://remult.dev/docs/lifecycle-hooks)
+ */
+export interface LifecycleEvent<entityType> {
+    /**
+     * Indicates whether the entity is new or existing.
+     */
+    isNew: boolean;
+    /**
+     * A reference to the fields of the entity, providing access to its properties.
+     */
+    fields: FieldsRef<entityType>;
+    /**
+     * The ID of the entity.
+     */
+    id: idType<entityType>;
+    /**
+     * The original ID of the entity, useful for tracking changes.
+     */
+    originalId: idType<entityType>;
+    /**
+     * The repository associated with the entity, providing access to repository methods.
+     */
+    repository: Repository<entityType>;
+    /**
+     * Metadata describing the entity's structure and configuration.
+     */
+    metadata: EntityMetadata<entityType>;
+    /**
+     * A function that can be used to prevent the default behavior associated with
+     * the lifecycle event.
+     */
+    preventDefault: VoidFunction;
+    /**
+     * A reference to the repository relations associated with the entity, providing
+     * access to related entities and their data.
+     */
+    relations: RepositoryRelations<entityType>;
+}
 export interface ControllerRef<entityType> extends Subscribable {
     hasErrors(): boolean;
     fields: FieldsRef<entityType>;
@@ -44,7 +89,7 @@ export interface Subscribable {
     subscribe(listener: RefSubscriber): Unsubscribe;
 }
 export type FieldsRef<entityType> = {
-    [Properties in keyof OmitEB<entityType>]: entityType[Properties] extends {
+    [Properties in keyof OmitEB<entityType>]: NonNullable<entityType[Properties]> extends {
         id?: number | string;
     } ? IdFieldRef<entityType, entityType[Properties]> : FieldRef<entityType, entityType[Properties]>;
 } & {
@@ -301,7 +346,7 @@ export declare type EntityOrderBy<entityType> = {
 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;
+    } | undefined ? IdFilter<Partial<OmitEB<entityType>>[Properties]> : ValueFilter<Partial<OmitEB<entityType>>[Properties]>) | ContainsStringValueFilter;
 } & {
     $or?: EntityFilter<entityType>[];
     $and?: EntityFilter<entityType>[];
@@ -331,7 +376,46 @@ export type IdFilter<valueType> = ValueFilter<valueType> | {
     } ? number : string>;
 };
 export interface LoadOptions<entityType> {
+    /**
+     * @deprecated The 'load' option is deprecated and will be removed in future versions.
+     * Use 'Relations.toOne' along with the 'include' option instead.
+     *
+     * Example usage:
+     * ```
+     * // Deprecated usage with 'load' option
+     * await remult.repo(Order).find({
+     *   load: (o) => [o.customer],
+     * });
+     *
+     *
+     * // Preferred usage with 'Relations.toOne' and 'include' option
+     * await remult.repo(Order).find({
+     *   include: { customer: true },
+     * });
+     * ```
+     */
     load?: (entity: FieldsMetadata<entityType>) => FieldMetadata[];
+    /**
+     * An option used in the `find` and `findFirst` methods to specify which related entities should be included
+     * when querying the source entity. It allows you to eagerly load related data to avoid N+1 query problems.
+     *
+     * @param include An object specifying the related entities to include, their options, and filtering criteria.
+     *
+     * Example usage:
+     * ```
+     * const orders = await customerRepo.find({
+     *   include: {
+     *     // Include the 'tags' relation for each customer.
+     *     tags: true,
+     *   },
+     * });
+     * ```
+     * In this example, the `tags` relation for each customer will be loaded and included in the query result.
+     *
+     * @see {@link Relations.toMany}
+     * @see {@link Relations.toOne}
+     * @see {@link RelationOptions}
+     */
     include?: MembersToInclude<entityType>;
 }
 export interface FindOptionsBase<entityType> extends LoadOptions<entityType> {
@@ -402,26 +486,67 @@ export interface RelationInfo {
     toType: () => any;
     type: 'reference' | 'toOne' | 'toMany';
 }
+/**
+ * Options for configuring a relation between entities.
+ *
+ * @template fromEntity The type of the source entity (the entity defining the relation).
+ * @template toEntity The type of the target entity (the related entity).
+ * @template matchIdEntity The type used for matching IDs in the relation.
+ * @template optionsType The type of find options to apply to the relation (default is FindOptionsBase<toEntity>).
+ */
 export type RelationOptions<fromEntity, toEntity, matchIdEntity, optionsType extends FindOptionsBase<toEntity> = FindOptionsBase<toEntity>> = {
+    /**
+     * An object specifying custom field names for the relation.
+     * Each key represents a field in the related entity, and its value is the corresponding field in the source entity.
+     * For example, `{ customerId: 'id' }` maps the 'customerId' field in the related entity to the 'id' field in the source entity.
+     * This is useful when you want to define custom field mappings for the relation.
+     */
     fields?: {
         [K in keyof toEntity]?: keyof fromEntity;
     };
+    /**
+     * The name of the field for this relation.
+     */
     field?: keyof matchIdEntity;
-} & RelationOptionsBase<fromEntity, toEntity, optionsType>;
-export type RelationOptionsBase<fromEntity, toEntity, optionsType extends LoadOptions<toEntity> = LoadOptions<toEntity>> = {
+    /**
+     * Find options to apply to the relation when fetching related entities.
+     * You can specify a predefined set of find options or provide a function that takes the source entity
+     * and returns find options dynamically.
+     * These options allow you to customize how related entities are retrieved.
+     */
     findOptions?: optionsType | ((entity: fromEntity) => optionsType);
+    /**
+     * Determines whether the relation should be included by default when querying the source entity.
+     * When set to true, related entities will be automatically included when querying the source entity.
+     * If false or not specified, related entities will need to be explicitly included using the `include` option.
+     */
     defaultIncluded?: boolean;
-} & FieldOptions<fromEntity, toEntity>;
+} & Pick<FieldOptions, 'caption'>;
 export type ObjectMembersOnly<T> = {
     [K in keyof Pick<T, {
         [K in keyof T]: T[K] extends object | undefined | null ? T[K] extends Date | undefined | null ? never : K : never;
     }[keyof T]>]: T[K];
 };
 export type MembersToInclude<T> = {
-    [K in keyof ObjectMembersOnly<T>]?: true | (T[K] extends Array<any> ? FindOptions<T[K][number]> : FindFirstOptions<T[K]>);
+    [K in keyof ObjectMembersOnly<T>]?: boolean | (NonNullable<T[K]> extends Array<any> ? FindOptions<NonNullable<T[K]>[number]> : FindFirstOptions<NonNullable<T[K]>>);
 };
 export type RepositoryRelations<entityType> = {
-    [K in keyof ObjectMembersOnly<entityType>]: entityType[K] extends Array<infer R> ? Repository<R> : entityType[K] extends infer R ? {
+    [K in keyof ObjectMembersOnly<entityType>]-?: NonNullable<entityType[K]> extends Array<infer R> ? Repository<R> : entityType[K] extends infer R ? {
         findOne: (options?: FindOptionsBase<R>) => Promise<R>;
     } : never;
 };
+export declare type EntityIdFields<entityType> = {
+    [Properties in keyof Partial<OmitEB<entityType>>]?: true;
+};
+export interface ClassFieldDecoratorContextStub<entityType, valueType> {
+    readonly access: {
+        set(object: entityType, value: valueType): void;
+    };
+    readonly name: string;
+}
+export interface ClassDecoratorContextStub<Class extends new (...args: any) => any = new (...args: any) => any> {
+    readonly kind: 'class';
+    readonly name: string | undefined;
+    addInitializer(initializer: (this: Class) => void): void;
+}
+export type ClassFieldDecorator<entityType, valueType> = (target: any, context: string | ClassFieldDecoratorContextStub<entityType, valueType | undefined>, c?: any) => void;

package/esm/src/remult3/remult3.js

@@ -1 +1,31 @@
 export {};
+//p1 - include relations in the api docs
+//p1 - include Relation options in the api docs
+//p1 - fix { allowApiRead: r => r.user.name === 'superman' } } in allowed for instace docs
+//p1 - fix seeallowed in ref_entity
+//p1 - write doc about controlling updates of rows...
+//p1 - 'eventId' autocomplete in task app did not work
+//p1 - need a way to extract the fields from the relation - for generating relation based sql
+//p1 - remult object was used outside context
+// ```
+// sqlExpression: async (e) => {
+//   const v = await dbNamesOf(volunteerInTask)
+//   return `select true from ${v} where ${
+//     v.task
+//   }=${await e.getDbName()}.${await e.fields.id.getDbName()} and ${SqlDatabase.filterToRaw<volunteerInTask>(
+//     repo(volunteerInTask),
+//     {
+//       canceled: false,
+//     }
+//   )}`
+// },
+// })
+// ```
+//p2 - consider includeInApi as AllowedForInstance
+//p1 - why didn't this._.relations.statusChanges.insert({})work?
+//p1 - active record with include thinks that the row was change!
+//p1 - add docs for apply changes
+//p1 - update related field with null should respect it's allowed null - otherwise we get a null error for that field.
+//p1 - when the include doesn't find the many to one - it deletes the id!!!
+//y1 - discuss a default date formatter
+//p1 - consider using this in saving etc...

package/esm/src/remult3/repository-internals.d.ts

@@ -0,0 +1,14 @@
+import type { EntityDataProviderFindOptions } from '../data-interfaces';
+import type { Filter } from '../filter/filter-interfaces';
+import type { EntityFilter, EntityOrderBy, FindOptions, LoadOptions, Repository } from './remult3';
+export interface RepositoryInternal<entityType> {
+    createAfterFilter(orderBy: EntityOrderBy<entityType>, lastRow: entityType): Promise<EntityFilter<entityType>>;
+    fromJsonArray(jsonItems: any[], loadOptions: LoadOptions<entityType>): Promise<entityType[]>;
+    buildEntityDataProviderFindOptions(options: FindOptions<entityType>): Promise<EntityDataProviderFindOptions>;
+    translateWhereToFilter(where: EntityFilter<entityType>): Promise<Filter>;
+    getCachedById(id: any, doNotLoadIfNotFound: boolean): entityType;
+    getCachedByIdAsync(id: any, doNotLoadIfNotFound: boolean): Promise<entityType>;
+    addToCache(item: entityType): any;
+}
+export declare function getRepositoryInternals<entityType>(repo: Repository<entityType>): RepositoryInternal<entityType>;
+export declare const getInternalKey = "getInternal";

package/esm/src/remult3/repository-internals.js

@@ -0,0 +1,7 @@
+export function getRepositoryInternals(repo) {
+    const x = repo;
+    if (typeof x[getInternalKey] === 'function')
+        return x[getInternalKey]();
+    throw Error('Error getting repository internal from ' + repo);
+}
+export const getInternalKey = 'getInternal';

package/esm/src/server-action.js

@@ -268,7 +268,7 @@ export function BackendMethod(options) {
                                 id: defs.getOriginalId(),
                             },
                         }, baseUrl, http);
-                        await defs._updateEntityBasedOnApi(r.rowInfo.data);
+                        await defs._updateEntityBasedOnApi(r.rowInfo.data, true);
                         return r.result;
                     }
                     catch (err) {

package/esm/src/sort.d.ts

@@ -6,9 +6,9 @@ export declare class Sort {
     Segments: SortSegment[];
     reverse(): Sort;
     compare(a: any, b: any, getFieldKey?: (field: FieldMetadata) => string): number;
-    static translateOrderByToSort<T>(entityDefs: EntityMetadata<T>, orderBy: EntityOrderBy<T>): Sort;
-    static createUniqueSort<T>(entityMetadata: EntityMetadata<T>, orderBy: Sort): Sort;
-    static createUniqueEntityOrderBy<T>(entityMetadata: EntityMetadata<T>, orderBy: EntityOrderBy<T>): EntityOrderBy<T>;
+    static translateOrderByToSort<T>(entityDefs: EntityMetadata<T>, orderBy?: EntityOrderBy<T>): Sort;
+    static createUniqueSort<T>(entityMetadata: EntityMetadata<T>, orderBy?: Sort): Sort;
+    static createUniqueEntityOrderBy<T>(entityMetadata: EntityMetadata<T>, orderBy?: EntityOrderBy<T>): EntityOrderBy<T>;
 }
 export interface SortSegment {
     field: FieldMetadata;

package/esm/src/sort.js

@@ -1,3 +1,4 @@
+import { getRelationInfo } from '../internals';
 import { CompoundIdField } from './CompoundIdField';
 export class Sort {
     toEntityOrderBy() {
@@ -28,8 +29,8 @@ export class Sort {
         let r = 0;
         for (let i = 0; i < this.Segments.length; i++) {
             let seg = this.Segments[i];
-            let left = a[getFieldKey(seg.field)];
-            let right = b[getFieldKey(seg.field)];
+            let left = fixValueForSort(a[getFieldKey(seg.field)]);
+            let right = fixValueForSort(b[getFieldKey(seg.field)]);
             if (left > right)
                 r = 1;
             else if (left < right)
@@ -45,14 +46,13 @@ export class Sort {
     static translateOrderByToSort(entityDefs, orderBy) {
         if (!orderBy)
             return undefined;
-        let sort;
-        if (orderBy) {
-            sort = new Sort();
+        let sort = new Sort();
+        if (orderBy)
             for (const key in orderBy) {
                 if (Object.prototype.hasOwnProperty.call(orderBy, key)) {
                     const element = orderBy[key];
                     let field = entityDefs.fields.find(key);
-                    if (field) {
+                    const addSegment = (field) => {
                         switch (element) {
                             case 'desc':
                                 sort.Segments.push({ field, isDescending: true });
@@ -60,14 +60,35 @@ export class Sort {
                             case 'asc':
                                 sort.Segments.push({ field });
                         }
+                    };
+                    if (field) {
+                        const rel = getRelationInfo(field.options);
+                        const op = field.options;
+                        if (rel?.type === 'toOne') {
+                            if (typeof op.field === 'string') {
+                                addSegment(entityDefs.fields.find(op.field));
+                            }
+                            else {
+                                if (op.fields) {
+                                    for (const key in op.fields) {
+                                        if (Object.prototype.hasOwnProperty.call(op.fields, key)) {
+                                            const keyInMyEntity = op.fields[key];
+                                            addSegment(entityDefs.fields.find(keyInMyEntity.toString()));
+                                        }
+                                    }
+                                }
+                            }
+                        }
+                        else
+                            addSegment(field);
                     }
                 }
             }
-        }
         return sort;
     }
     static createUniqueSort(entityMetadata, orderBy) {
-        if (!orderBy || Object.keys(orderBy).length === 0)
+        if ((!orderBy || Object.keys(orderBy).length === 0) &&
+            entityMetadata.options.defaultOrderBy)
             orderBy = Sort.translateOrderByToSort(entityMetadata, entityMetadata.options.defaultOrderBy);
         if (!orderBy)
             orderBy = new Sort({ field: entityMetadata.idMetadata.field });
@@ -105,3 +126,10 @@ export class Sort {
         return orderBy;
     }
 }
+function fixValueForSort(a) {
+    if (a == undefined || a == null)
+        return a;
+    if (a.id !== undefined)
+        return a.id;
+    return a;
+}

package/graphql.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.translateWhereToRestBody = exports.remultGraphql = void 0;
 var tslib_1 = require("tslib");
+var internals_1 = require("./internals");
 var index_1 = require("./index");
 var data_api_1 = require("./src/data-api");
 var v2ConnectionAndPagination = false;
@@ -522,6 +523,11 @@ function remultGraphql(options) {
             }
             var whereTypeFields = [];
             var _loop_2 = function (f) {
+                var ri = (0, internals_1.getRelationInfo)(f.options);
+                // let's not consider toMany relations for now
+                if ((ri === null || ri === void 0 ? void 0 : ri.type) === 'toMany') {
+                    return "break";
+                }
                 if (f.options.includeInApi === false)
                     return "continue";
                 var type = 'String';
@@ -634,7 +640,9 @@ function remultGraphql(options) {
             try {
                 for (var _s = (e_6 = void 0, tslib_1.__values(meta.fields)), _t = _s.next(); !_t.done; _t = _s.next()) {
                     var f = _t.value;
-                    _loop_2(f);
+                    var state_1 = _loop_2(f);
+                    if (state_1 === "break")
+                        break;
                 }
             }
             catch (e_6_1) { e_6 = { error: e_6_1 }; }
@@ -900,7 +908,7 @@ function translateWhereToRestBody(fields, _a) {
     var result = {};
     var _loop_3 = function (field) {
         var e_8, _c;
-        if (field.includedInApi === false)
+        if (field.options.includeInApi === false)
             return "continue";
         var condition = where[field.key];
         if (condition) {

package/index.d.ts

@@ -1,8 +1,9 @@
-export { OmitEB, FieldsMetadata, FieldRef, IdFieldRef, FieldsRef, EntityMetadata, EntityOrderBy, EntityFilter, FindOptions, QueryResult, QueryOptions, Repository, FindFirstOptions, ComparisonValueFilter, ValueFilter, IdFilter, ContainsStringValueFilter, EntityRef, SortSegments, Paginator, LiveQuery, LiveQueryChangeInfo, Subscribable, RefSubscriber, RefSubscriberBase, RelationOptions, RelationOptionsBase, ObjectMembersOnly, MembersToInclude, RepositoryRelations, } from './src/remult3/remult3';
+import type { ClassType } from './classType';
+export { OmitEB, FieldsMetadata, FieldRef, IdFieldRef, FieldsRef, EntityMetadata, EntityOrderBy, EntityFilter, FindOptions, QueryResult, QueryOptions, Repository, FindFirstOptions, ComparisonValueFilter, ValueFilter, IdFilter, ContainsStringValueFilter, EntityRef, SortSegments, Paginator, LiveQuery, LiveQueryChangeInfo, Subscribable, RefSubscriber, RefSubscriberBase, RelationOptions, ObjectMembersOnly, MembersToInclude, RepositoryRelations, EntityIdFields, ClassFieldDecorator as MemberDecorator, ClassFieldDecoratorContextStub, } from './src/remult3/remult3';
 export { EntityBase, ControllerBase, FieldType, getFields, ValueListFieldType, getValueList, ValueListFieldOptions, ValueListInfo, CaptionTransformer, } from './src/remult3/RepositoryImplementation';
 export { Entity } from './src/remult3/entity';
 export { getEntityRef } from './src/remult3/getEntityRef';
-export { Field, Fields, StringFieldOptions } from './src/remult3/Fields';
+export { Field, Fields, StringFieldOptions, Relations, } from './src/remult3/Fields';
 export { IdEntity } from './src/remult3/IdEntity';
 export { describeClass } from './src/remult3/DecoratorReplacer';
 export { EntityOptions } from './src/entity';
@@ -21,7 +22,6 @@ export { Controller, BackendMethodOptions, BackendMethod, ProgressListener, } fr
 export { Allowed, Allow, Remult, RemultContext, ApiClient, isBackend, AllowedForInstance, EventDispatcher, EventSource, UserInfo, } from './src/context';
 export { ExternalHttpProvider } from './src/buildRestDataProvider';
 export { SortSegment, Sort } from './src/sort';
-export { OneToMany } from './src/column';
 export { CompoundIdField } from './src/CompoundIdField';
 export { Filter } from './src/filter/filter-interfaces';
 export { UrlBuilder } from './urlBuilder';
@@ -30,3 +30,16 @@ export { ValueConverters } from './src/valueConverters';
 export { remult } from './src/remult-proxy';
 export { SubscriptionServer, LiveQueryStorage, StoredQuery, InMemoryLiveQueryStorage, } from './src/live-query/SubscriptionServer';
 export { SubscriptionListener, SubscriptionClientConnection, SubscriptionClient, SubscriptionChannel, LiveQueryChange, Unsubscribe, } from './src/live-query/SubscriptionChannel';
+/**
+ * A convenient shortcut function to quickly obtain a repository for a specific entity type in Remult.
+ *
+ * @param entity The entity class type for which you want to get a repository.
+ * @returns A repository instance for the specified entity type.
+ *
+ * Example usage:
+ * ```ts
+ * await repo(Task).find()
+ * await repo(Customer).insert()
+ * ```
+ */
+export declare function repo<entityType>(entity: ClassType<entityType>): import("./src/remult3/remult3").Repository<entityType>;

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubscriptionChannel = exports.InMemoryLiveQueryStorage = exports.remult = exports.ValueConverters = exports.Validators = exports.UrlBuilder = exports.Filter = exports.CompoundIdField = exports.OneToMany = exports.Sort = exports.EventSource = exports.isBackend = exports.Remult = exports.Allow = exports.ProgressListener = exports.BackendMethod = exports.Controller = exports.JsonDataProvider = exports.dbNamesOf = exports.CustomSqlFilterBuilder = exports.SqlDatabase = exports.WebSqlDataProvider = exports.ArrayEntityDataProvider = exports.InMemoryDataProvider = exports.RestDataProvider = exports.describeClass = exports.IdEntity = exports.Fields = exports.Field = exports.getEntityRef = exports.Entity = exports.CaptionTransformer = exports.ValueListInfo = exports.getValueList = exports.ValueListFieldType = exports.getFields = exports.FieldType = exports.ControllerBase = exports.EntityBase = void 0;
+exports.repo = exports.SubscriptionChannel = exports.InMemoryLiveQueryStorage = exports.remult = exports.ValueConverters = exports.Validators = exports.UrlBuilder = exports.Filter = exports.CompoundIdField = exports.Sort = exports.EventSource = exports.isBackend = exports.Remult = exports.Allow = exports.ProgressListener = exports.BackendMethod = exports.Controller = exports.JsonDataProvider = exports.dbNamesOf = exports.CustomSqlFilterBuilder = exports.SqlDatabase = exports.WebSqlDataProvider = exports.ArrayEntityDataProvider = exports.InMemoryDataProvider = exports.RestDataProvider = exports.describeClass = exports.IdEntity = exports.Relations = exports.Fields = exports.Field = exports.getEntityRef = exports.Entity = exports.CaptionTransformer = exports.ValueListInfo = exports.getValueList = exports.ValueListFieldType = exports.getFields = exports.FieldType = exports.ControllerBase = exports.EntityBase = void 0;
 var RepositoryImplementation_1 = require("./src/remult3/RepositoryImplementation");
 Object.defineProperty(exports, "EntityBase", { enumerable: true, get: function () { return RepositoryImplementation_1.EntityBase; } });
 Object.defineProperty(exports, "ControllerBase", { enumerable: true, get: function () { return RepositoryImplementation_1.ControllerBase; } });
@@ -17,6 +17,7 @@ Object.defineProperty(exports, "getEntityRef", { enumerable: true, get: function
 var Fields_1 = require("./src/remult3/Fields");
 Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return Fields_1.Field; } });
 Object.defineProperty(exports, "Fields", { enumerable: true, get: function () { return Fields_1.Fields; } });
+Object.defineProperty(exports, "Relations", { enumerable: true, get: function () { return Fields_1.Relations; } });
 var IdEntity_1 = require("./src/remult3/IdEntity");
 Object.defineProperty(exports, "IdEntity", { enumerable: true, get: function () { return IdEntity_1.IdEntity; } });
 var DecoratorReplacer_1 = require("./src/remult3/DecoratorReplacer");
@@ -48,8 +49,6 @@ Object.defineProperty(exports, "isBackend", { enumerable: true, get: function ()
 Object.defineProperty(exports, "EventSource", { enumerable: true, get: function () { return context_1.EventSource; } });
 var sort_1 = require("./src/sort");
 Object.defineProperty(exports, "Sort", { enumerable: true, get: function () { return sort_1.Sort; } });
-var column_1 = require("./src/column");
-Object.defineProperty(exports, "OneToMany", { enumerable: true, get: function () { return column_1.OneToMany; } });
 var CompoundIdField_1 = require("./src/CompoundIdField");
 Object.defineProperty(exports, "CompoundIdField", { enumerable: true, get: function () { return CompoundIdField_1.CompoundIdField; } });
 var filter_interfaces_1 = require("./src/filter/filter-interfaces");
@@ -62,8 +61,25 @@ var valueConverters_1 = require("./src/valueConverters");
 Object.defineProperty(exports, "ValueConverters", { enumerable: true, get: function () { return valueConverters_1.ValueConverters; } });
 var remult_proxy_1 = require("./src/remult-proxy");
 Object.defineProperty(exports, "remult", { enumerable: true, get: function () { return remult_proxy_1.remult; } });
+var remult_proxy_2 = require("./src/remult-proxy");
 //export { getId } from './src/remult3/getId';
 var SubscriptionServer_1 = require("./src/live-query/SubscriptionServer");
 Object.defineProperty(exports, "InMemoryLiveQueryStorage", { enumerable: true, get: function () { return SubscriptionServer_1.InMemoryLiveQueryStorage; } });
 var SubscriptionChannel_1 = require("./src/live-query/SubscriptionChannel");
 Object.defineProperty(exports, "SubscriptionChannel", { enumerable: true, get: function () { return SubscriptionChannel_1.SubscriptionChannel; } });
+/**
+ * A convenient shortcut function to quickly obtain a repository for a specific entity type in Remult.
+ *
+ * @param entity The entity class type for which you want to get a repository.
+ * @returns A repository instance for the specified entity type.
+ *
+ * Example usage:
+ * ```ts
+ * await repo(Task).find()
+ * await repo(Customer).insert()
+ * ```
+ */
+function repo(entity) {
+    return remult_proxy_2.remult.repo(entity);
+}
+exports.repo = repo;

package/internals.d.ts

@@ -1,6 +1,7 @@
 export { getRelationInfo } from './src/remult3/relationInfoMember';
-export { decorateColumnSettings } from './src/remult3/RepositoryImplementation';
+export { decorateColumnSettings, controllerRefImpl, getControllerRef, } from './src/remult3/RepositoryImplementation';
 export { getEntitySettings } from './src/remult3/getEntityRef';
 export { __updateEntityBasedOnWhere } from './src/filter/filter-interfaces';
 export { actionInfo } from './src/server-action-info';
 export { RelationInfo } from './src/remult3/remult3';
+export { ClassType } from './classType';

package/internals.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.actionInfo = exports.__updateEntityBasedOnWhere = exports.getEntitySettings = exports.decorateColumnSettings = exports.getRelationInfo = void 0;
+exports.actionInfo = exports.__updateEntityBasedOnWhere = exports.getEntitySettings = exports.getControllerRef = exports.controllerRefImpl = exports.decorateColumnSettings = exports.getRelationInfo = void 0;
 var relationInfoMember_1 = require("./src/remult3/relationInfoMember");
 Object.defineProperty(exports, "getRelationInfo", { enumerable: true, get: function () { return relationInfoMember_1.getRelationInfo; } });
 var RepositoryImplementation_1 = require("./src/remult3/RepositoryImplementation");
 Object.defineProperty(exports, "decorateColumnSettings", { enumerable: true, get: function () { return RepositoryImplementation_1.decorateColumnSettings; } });
+Object.defineProperty(exports, "controllerRefImpl", { enumerable: true, get: function () { return RepositoryImplementation_1.controllerRefImpl; } });
+Object.defineProperty(exports, "getControllerRef", { enumerable: true, get: function () { return RepositoryImplementation_1.getControllerRef; } });
 var getEntityRef_1 = require("./src/remult3/getEntityRef");
 Object.defineProperty(exports, "getEntitySettings", { enumerable: true, get: function () { return getEntityRef_1.getEntitySettings; } });
 var filter_interfaces_1 = require("./src/filter/filter-interfaces");

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "remult",
-    "version": "0.23.0-exp.2",
+    "version": "0.23.0-exp.21",
     "description": "A CRUD framework for full-stack TypeScript",
     "types": "index.d.ts",
     "module": "esm/index.js",

package/remult-express.js

@@ -28,7 +28,7 @@ function remultExpress(options) {
         getRemult: function (req) { return server.getRemult(req); },
         openApiDoc: function (options) { return server.openApiDoc(options); },
         withRemult: function (req, res, next) { return server.withRemult(req, res, next); },
-        // [ ]- add with remult promise
+        // [ ] V1.5 add with remult promise
     });
 }
 exports.remultExpress = remultExpress;

package/remult-knex/index.js

@@ -11,6 +11,7 @@ var RepositoryImplementation_1 = require("../src/remult3/RepositoryImplementatio
 var sort_1 = require("../src/sort");
 var valueConverters_1 = require("../src/valueConverters");
 var resultCompoundIdFilter_1 = require("../src/resultCompoundIdFilter");
+var repository_internals_1 = require("../src/remult3/repository-internals");
 var KnexDataProvider = /** @class */ (function () {
     function KnexDataProvider(knex) {
         this.knex = knex;
@@ -91,7 +92,7 @@ var KnexDataProvider = /** @class */ (function () {
                     case 1:
                         b = new (_a.apply(FilterConsumerBridgeToKnexRequest, [void 0, _b.sent()]))();
                         b._addWhere = false;
-                        return [4 /*yield*/, repo.translateWhereToFilter(condition)];
+                        return [4 /*yield*/, (0, repository_internals_1.getRepositoryInternals)(repo).translateWhereToFilter(condition)];
                     case 2: return [4 /*yield*/, (_b.sent()).__applyToConsumer(b)];
                     case 3:
                         _b.sent();

package/remult-mongo.js

@@ -7,6 +7,7 @@ var filter_consumer_bridge_to_sql_request_1 = require("./src/filter/filter-consu
 var remult_proxy_1 = require("./src/remult-proxy");
 var RepositoryImplementation_1 = require("./src/remult3/RepositoryImplementation");
 var resultCompoundIdFilter_1 = require("./src/resultCompoundIdFilter");
+var repository_internals_1 = require("./src/remult3/repository-internals");
 var MongoDataProvider = /** @class */ (function () {
     function MongoDataProvider(db, client, options) {
         this.db = db;
@@ -80,7 +81,7 @@ var MongoDataProvider = /** @class */ (function () {
                     case 1:
                         b = new (_a.apply(FilterConsumerBridgeToMongo, [void 0, _b.sent()]))();
                         b._addWhere = false;
-                        return [4 /*yield*/, repo.translateWhereToFilter(condition)];
+                        return [4 /*yield*/, (0, repository_internals_1.getRepositoryInternals)(repo).translateWhereToFilter(condition)];
                     case 2: return [4 /*yield*/, (_b.sent()).__applyToConsumer(b)];
                     case 3:
                         _b.sent();

package/server/JsonEntityFileStorage.js

@@ -14,7 +14,7 @@ var JsonEntityFileStorage = /** @class */ (function () {
         if (fs.existsSync(fn)) {
             return fs.readFileSync(fn).toString();
         }
-        return undefined;
+        return null;
     };
     JsonEntityFileStorage.prototype.setItem = function (entityDbName, json) {
         if (!fs.existsSync(this.folderPath)) {

package/server/expressBridge.js

@@ -255,7 +255,7 @@ var RemultServerImplementation = /** @class */ (function () {
         });
     };
     RemultServerImplementation.prototype.getEntities = function () {
-        //TODO - consider using entitiesMetaData - but it may require making it all awaitable
+        //TODO V2 - consider using entitiesMetaData - but it may require making it all awaitable
         var r = new context_1.Remult();
         return this.options.entities.map(function (x) { return r.repo(x).metadata; });
     };

package/src/CompoundIdField.d.ts

@@ -6,7 +6,7 @@ export declare class CompoundIdField implements FieldMetadata<string> {
     constructor(...columns: FieldMetadata[]);
     apiUpdateAllowed(item: any): boolean;
     displayValue(item: any): string;
-    includedInApi: boolean;
+    includedInApi(item: any): boolean;
     toInput(value: string, inputType?: string): string;
     fromInput(inputValue: string, inputType?: string): string;
     getDbName(): Promise<string>;

package/src/CompoundIdField.js

@@ -15,6 +15,9 @@ var CompoundIdField = /** @class */ (function () {
     CompoundIdField.prototype.displayValue = function (item) {
         throw new Error('Method not implemented.');
     };
+    CompoundIdField.prototype.includedInApi = function (item) {
+        throw new Error('Method not implemented.');
+    };
     CompoundIdField.prototype.toInput = function (value, inputType) {
         throw new Error('Method not implemented.');
     };

package/src/buildRestDataProvider.d.ts

@@ -1,6 +1,5 @@
 import type { RestDataProviderHttpProvider } from './data-interfaces';
-import { RestDataProviderHttpProviderUsingFetch } from './data-providers/rest-data-provider';
-export declare function buildRestDataProvider(provider: ExternalHttpProvider | typeof fetch): RestDataProviderHttpProviderUsingFetch | RestDataProviderHttpProvider;
+export declare function buildRestDataProvider(provider: ExternalHttpProvider | typeof fetch): RestDataProviderHttpProvider;
 export declare function isExternalHttpProvider(item: any): boolean;
 export declare class HttpProviderBridgeToRestDataProviderHttpProvider implements RestDataProviderHttpProvider {
     private http;