lemon-core 3.1.1 → 3.1.2

package/dist/cores/model-manager.js

@@ -1,192 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AbstractManager = void 0;
-/**
- * `model-manager.ts`
- * - base model manager
- *
- * @author      Tim Hong <tim@lemoncloud.io>
- * @date        2020-06-05 initial version
- *
- * @copyright (C) 2020 LemonCloud Co Ltd. - All Rights Reserved.
- */
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const engine_1 = require("../engine/");
-const proxy_storage_service_1 = require("./proxy-storage-service");
-const NS = engine_1.$U.NS('MMGR', 'cyan'); // default namespace name
-/**
- * class: `AbstractManager`
- *  - abstract model manager to cover all models which extend CoreModel.
- *  - feature to handle 'name' like unique value in same type.
- *  - typed-storage based.
- * @abstract
- */
-class AbstractManager extends proxy_storage_service_1.GeneralModelFilter {
-    /**
-     * default constructor
-     * @param type          model type string
-     * @param parent        service instance which implements StorageMakeable interface
-     * @param fields        list of model field names
-     * @param uniqueField   (optional) unique field name
-     * @param ns            (optional) namespace to be printed. pass NULL to suppress all logs.
-     *                      global NS value will be used if not specified or undefined.
-     */
-    constructor(type, parent, fields, uniqueField, ns) {
-        super(fields);
-        /**
-         * hello of this service-identity
-         */
-        this.hello = () => this.storage.hello();
-        this.NS = ns === undefined ? NS : ns;
-        this.parent = parent;
-        this.storage = parent.makeStorageService(type, fields, this);
-        this.$unique = uniqueField ? this.storage.makeUniqueFieldManager(uniqueField) : null;
-    }
-    /**
-     * type getter
-     */
-    get type() {
-        return this.storage.type;
-    }
-    /**
-     * callback invoked just before the model is saved
-     *  - override this to customize default behavior to perform model validation, cleansing or normalization
-     * @param model     model object
-     * @param origin    original model currently in the storage
-     */
-    onBeforeSave(model, origin) {
-        return super.onBeforeSave(model, origin);
-    }
-    /**
-     * default implementation of 'preparing' model
-     *  - prepare model w/ safe creation
-     * @param id        model-id to prepare
-     * @param $def      default model value
-     * @param isCreate  (optional) flag to allow creating a new model (default: true)
-     */
-    prepare(id, $def, isCreate = true) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!id)
-                throw new Error(`404 NOT FOUND - id is not valid!`);
-            // if 'isCreate' flag is set, read existing model or create initial model by calling abstract method 'prepareDefault'
-            if (isCreate)
-                return this.storage.readOrCreate(id, this.prepareDefault($def));
-            // otherwise just try to read model and throw 404 if it does not exist
-            return this.storage.read(id).catch(e => {
-                if (`${e.message || e}`.startsWith('404 NOT FOUND'))
-                    e = new Error(`404 NOT FOUND - ${this.type}:${id}`);
-                throw e;
-            });
-        });
-    }
-    /**
-     * default implementation of 'inserting' model
-     * @param model model object
-     */
-    insert(model) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.NS && (0, engine_1._inf)(this.NS, `insert(${this.type})...`);
-            if (!model)
-                throw new Error(`@model (${this.type}-model) is required!`);
-            const $def = this.prepareDefault(null);
-            const created = yield this.storage.insert($def);
-            const id = `${(created && created.id) || ''}`;
-            if (!id)
-                throw new Error('.id (string) is missing - insert() failed!');
-            this.NS && (0, engine_1._log)(this.NS, `> model.base =`, engine_1.$U.json(model));
-            const $saves = Object.assign({}, model); // clone
-            delete $saves.id; // ensure there is no 'id' field
-            const saved = yield this.storage.save(id, $saves);
-            this.NS && (0, engine_1._log)(this.NS, `> model.saved =`, engine_1.$U.json(saved));
-            return Object.assign(Object.assign(Object.assign({}, created), saved), { id });
-        });
-    }
-    /**
-     * default implementation of 'retrieving' model
-     * @param id    model id
-     */
-    retrieve(id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.NS && (0, engine_1._inf)(this.NS, `retrieve(${this.type}/${id})...`);
-            if (!id)
-                throw new Error(`@id is required!`);
-            return this.storage.read(id).catch(e => {
-                if (`${e.message}`.startsWith('404 NOT FOUND'))
-                    e = new Error(`404 NOT FOUND - ${this.type}:${id}`);
-                throw e;
-            });
-        });
-    }
-    /**
-     * default implementation of updating model
-     * @param id    model id
-     * @param model model object
-     * @param $inc  (optional) incremental set
-     */
-    update(id, model, $inc) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.NS && (0, engine_1._inf)(this.NS, `update(${this.type}/${id})...`);
-            return this._updateModel(id, model, $inc, false);
-        });
-    }
-    /**
-     * default implementation of 'upserting' model
-     * @param id    model id
-     * @param model model object
-     * @param $inc  (optional) incremental set
-     */
-    updateOrCreate(id, model, $inc) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.NS && (0, engine_1._inf)(this.NS, `updateOrCreate(${this.type}/${id})...`);
-            return this._updateModel(id, model, $inc, true);
-        });
-    }
-    /**
-     * default implementation of deleting model
-     * @param id        model id
-     * @param destroy   flag for hard delete or soft delete (by setting 'deletedAt' field)
-     */
-    delete(id, destroy = true) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.NS && (0, engine_1._inf)(this.NS, `delete(${this.type}/${id})...`);
-            if (!id)
-                throw new Error(`@id is required!`);
-            const $org = yield this.prepare(id, null, false);
-            this.NS && (0, engine_1._log)(this.NS, `> model.org =`, engine_1.$U.json($org));
-            const deleted = yield this.storage.delete(id, destroy);
-            this.NS && (0, engine_1._log)(this.NS, `> model.deleted =`, engine_1.$U.json(deleted));
-            return Object.assign(Object.assign(Object.assign({}, $org), deleted), { id });
-        });
-    }
-    /**
-     * internal implementation for 'update' and 'updateOrCreate'
-     * @param id        model id
-     * @param model     model object
-     * @param $inc      (optional) incremental set
-     * @param isCreate  (optional) flag to allow creating a new model (default: true)
-     * @private
-     */
-    _updateModel(id, model, $inc, isCreate = true) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!id)
-                throw new Error(`@id is required!`);
-            const $org = yield this.prepare(id, null, isCreate);
-            this.NS && (0, engine_1._log)(this.NS, `> model.org =`, engine_1.$U.json($org));
-            const $ups = Object.assign({}, model);
-            const updated = yield this.storage.update(id, $ups, $inc);
-            this.NS && (0, engine_1._log)(this.NS, `> model.updated =`, engine_1.$U.json(updated));
-            return Object.assign(Object.assign(Object.assign({}, $org), updated), { id });
-        });
-    }
-}
-exports.AbstractManager = AbstractManager;
-//# sourceMappingURL=model-manager.js.map

package/dist/cores/model-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"model-manager.js","sourceRoot":"","sources":["../../src/cores/model-manager.ts"],"names":[],"mappings":"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"}