remult 3.3.0-next.1 → 3.3.1

package/src/remult3/remult3.d.ts

@@ -13,7 +13,7 @@ export interface UpsertOptions<entityType> {
 export interface EntityRefBase<entityType> extends Subscribable {
     hasErrors(): boolean;
     undoChanges(): void;
-    save(): Promise<entityType>;
+    save(options?: InsertOrUpdateOptions): Promise<entityType>;
     reload(): Promise<entityType>;
     delete(): Promise<void>;
     isNew(): boolean;
@@ -395,9 +395,14 @@ export type GroupByResult<entityType, groupByFields extends (keyof entityType)[]
 };
 /** used to perform CRUD operations on an `entityType` */
 export interface Repository<entityType> {
-    /** returns a result array based on the provided options */
+    /** returns an array based on the provided options */
     find(options?: FindOptions<entityType>): Promise<entityType[]>;
-    /** returns a result array based on the provided options */
+    /** Using the same options as the {@link find} method, but subscribing to entity changes.
+     *
+     * _Note that today it subscribes to entity changes, but not included entities [Feature Request](https://github.com/remult/remult/issues/712)!_
+     *
+     * @see {@link LiveQuery}
+     */
     liveQuery(options?: FindOptions<entityType>): LiveQuery<entityType>;
     /** returns the first item that matchers the `where` condition
      * @example
@@ -547,27 +552,27 @@ export interface Repository<entityType> {
      * @example
      * await taskRepo.save({...task, completed:true })
      */
-    save(item: Partial<MembersOnly<entityType>>[]): Promise<entityType[]>;
-    save(item: Partial<MembersOnly<entityType>>): Promise<entityType>;
+    save(item: Partial<MembersOnly<entityType>>[], options?: InsertOrUpdateOptions): Promise<entityType[]>;
+    save(item: Partial<MembersOnly<entityType>>, options?: InsertOrUpdateOptions): 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<MembersOnly<entityType>>[]): Promise<entityType[]>;
-    insert(item: Partial<MembersOnly<entityType>>): Promise<entityType>;
+    insert(item: Partial<MembersOnly<entityType>>[], options?: InsertOrUpdateOptions): Promise<entityType[]>;
+    insert(item: Partial<MembersOnly<entityType>>, options?: InsertOrUpdateOptions): Promise<entityType>;
     /** Updates an item, based on its `id`
      * @example
      * taskRepo.update(task.id,{...task,completed:true})
      */
-    update(id: idType<entityType>, item: Partial<MembersOnly<entityType>>): Promise<entityType>;
-    update(id: Partial<MembersOnly<entityType>>, item: Partial<MembersOnly<entityType>>): Promise<entityType>;
+    update(id: idType<entityType>, item: Partial<MembersOnly<entityType>>, options?: InsertOrUpdateOptions): Promise<entityType>;
+    update(id: Partial<MembersOnly<entityType>>, item: Partial<MembersOnly<entityType>>, options?: InsertOrUpdateOptions): Promise<entityType>;
     /**
      * Updates all items that match the `where` condition.
      */
     updateMany(options: {
-        where: EntityFilter<entityType>;
+        where: EntityFilter<entityType> | 'all';
         set: Partial<MembersOnly<entityType>>;
     }): Promise<number>;
     /**
@@ -607,7 +612,7 @@ export interface Repository<entityType> {
      * Deletes all items that match the `where` condition.
      */
     deleteMany(options: {
-        where: EntityFilter<entityType>;
+        where: EntityFilter<entityType> | 'all';
     }): Promise<number>;
     /** Creates an instance of an item. It'll not be saved to the data source unless `save` or `insert` will be called.
      *
@@ -674,7 +679,7 @@ export interface LiveQuery<entityType> {
      *
      * @example
      * // Subscribing to changes in a live query
-     * const unsubscribe = taskRepo
+     * const unsubscribe = repo(Task)
      *   .liveQuery({
      *     limit: 20,
      *     orderBy: { createdAt: 'asc' }
@@ -734,20 +739,14 @@ export interface LiveQueryChangeInfo<entityType> {
     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
+    /** Number of rows returned. _(Defaults to 100 in the browser)_
      * @example
-     * await repo(Products).find({
-     *   limit: 10,
-     *   page: 2
-     * })
+     * await repo(Products).find({ limit: 10 })
      */
     limit?: number;
-    /** Determines the page number that will be used to extract the data
+    /** Determines the page number to retrieve. Works in tandem with the `limit` option.
      * @example
-     * await repo(Products).find({
-     *   limit: 10,
-     *  page: 2
-     * })
+     * await repo(Products).find({ page: 2 })
      */
     page?: number;
 }
@@ -1058,7 +1057,7 @@ export interface FindOptionsBase<entityType> extends LoadOptions<entityType> {
     select?: EntitySelectFields<entityType>;
     /** filters the data
      * @example
-     * await taskRepo.find({where: { completed:false }})
+     * await taskRepo.find({ where: { completed:false } })
      * @see For more usage examples see [EntityFilter](https://remult.dev/docs/entityFilter.html)
      */
     where?: EntityFilter<entityType>;
@@ -1198,6 +1197,9 @@ export declare type EntityIdFields<entityType> = {
 export declare type EntitySelectFields<entityType> = {
     [Properties in keyof Partial<MembersOnly<entityType>>]?: boolean;
 };
+export declare type InsertOrUpdateOptions = {
+    select: 'none';
+};
 export interface ClassFieldDecoratorContextStub<entityType, valueType> {
     readonly access: {
         set(object: entityType, value: valueType | null): void;

package/src/server-action.js

@@ -295,7 +295,7 @@ function BackendMethod(options) {
                     reg(controllerOptions.key +
                         '/' +
                         ((options === null || options === void 0 ? void 0 : options.apiPrefix) ? options.apiPrefix + '/' : '') +
-                        key, options ? (_b = options.queue) !== null && _b !== void 0 ? _b : false : false, options.allowed, function (d, req, res) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+                        key, options ? ((_b = options.queue) !== null && _b !== void 0 ? _b : false) : false, options.allowed, function (d, req, res) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
                         var allowed, remult_1, r_1, err_3;
                         var _this = this;
                         return tslib_1.__generator(this, function (_a) {
@@ -475,7 +475,7 @@ function BackendMethod(options) {
                                     http])];
                             case 4:
                                 r = _k.sent();
-                                return [4 /*yield*/, defs._updateEntityBasedOnApi(r.rowInfo.data, true)];
+                                return [4 /*yield*/, defs._updateResultsFromServerAction(r.rowInfo)];
                             case 5:
                                 _k.sent();
                                 return [2 /*return*/, r.result];

package/src/valueConverters.d.ts

@@ -2,7 +2,9 @@ import type { ValueConverter } from './column-interfaces.js';
 export declare class ValueConverters {
     static readonly Date: ValueConverter<Date>;
     static readonly DateOnly: ValueConverter<Date>;
-    static readonly DateOnlyString: ValueConverter<Date>;
+    static readonly DateOnlyString: ValueConverter<Date> & {
+        zeroDate: Date;
+    };
     static readonly Boolean: ValueConverter<Boolean>;
     static readonly Number: ValueConverter<number>;
     static readonly String: ValueConverter<String>;

package/src/valueConverters.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValueConverters = void 0;
 var tslib_1 = require("tslib");
 var inputTypes_js_1 = require("../inputTypes.js");
+var zeroDate = new Date('0000-01-01');
 var ValueConverters = /** @class */ (function () {
     function ValueConverters() {
     }
@@ -71,6 +72,8 @@ var ValueConverters = /** @class */ (function () {
         fromJson: function (value) {
             if (!value || value == '' || value == '0000-00-00')
                 return null;
+            if (value == '0000-01-01')
+                return zeroDate;
             var d = new Date(Date.parse(value));
             d.setMinutes(d.getMinutes() + d.getTimezoneOffset());
             return d;
@@ -92,6 +95,8 @@ var ValueConverters = /** @class */ (function () {
         },
     };
     ValueConverters.DateOnlyString = tslib_1.__assign(tslib_1.__assign({}, ValueConverters.DateOnly), { toDb: function (d) {
+            if (d === zeroDate)
+                return '00000000';
             var val = ValueConverters.DateOnly.toJson(d);
             if (!val)
                 return undefined;
@@ -101,12 +106,10 @@ var ValueConverters = /** @class */ (function () {
                 return null;
             if (!val)
                 return undefined;
-            return new Date(val.substring(0, 4) +
-                '-' +
-                val.substring(4, 6) +
-                '-' +
-                val.substring(6, 8));
-        } });
+            if (val === '00000000')
+                return zeroDate;
+            return new Date(Number(val.substring(0, 4)), Number(val.substring(4, 6)) - 1, Number(val.substring(6, 8)));
+        }, zeroDate: zeroDate });
     ValueConverters.Boolean = {
         toDb: function (val) { return val; },
         inputType: inputTypes_js_1.InputTypes.checkbox,