@oino-ts/db 0.21.1 → 1.0.0

package/dist/cjs/OINODb.js

@@ -5,16 +5,15 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OINODbMemoryDataSet = exports.OINODbDataSet = exports.OINODb = void 0;
+exports.OINODb = void 0;
 const common_1 = require("@oino-ts/common");
-const index_js_1 = require("./index.js");
 /**
  * Base class for database abstraction, implementing methods for connecting, making queries and parsing/formatting data
  * between SQL and serialization formats.
  *
  */
-class OINODb {
-    _params;
+class OINODb extends common_1.OINODataSource {
+    dbParams;
     /** Name of the database */
     name;
     isConnected = false;
@@ -24,8 +23,9 @@ class OINODb {
      * @param params database parameters
      */
     constructor(params) {
-        this._params = { ...params }; // make a shallow copy of params so that changes to them do not affect the original object
-        this.name = this._params.database;
+        super();
+        this.dbParams = { ...params }; // make a shallow copy of params so that changes to them do not affect the original object
+        this.name = this.dbParams.database;
     }
     /**
      * Print SQL select statement with DB specific formatting.
@@ -74,141 +74,3 @@ class OINODb {
     }
 }
 exports.OINODb = OINODb;
-/**
- * Base class for SQL results that can be asynchronously iterated (but
- * not necessarity rewinded). Idea is to handle database specific mechanisms
- * for returning and formatting conventions in the database specific
- * implementation. Data might be in memory or streamed in chunks and
- * `OINODbDataSet` will serve it out consistently.
- *
- */
-class OINODbDataSet extends common_1.OINOResult {
-    _data;
-    /** Error messages */
-    messages;
-    /**
-     * Constructor for `OINODbDataSet`.
-     *
-     * @param data internal database specific data type (constructor will throw if invalid)
-     * @param messages error messages from SQL-query
-     *
-     */
-    constructor(data, messages = []) {
-        super();
-        this._data = data;
-        this.messages = messages;
-    }
-    /**
-     * Checks if the messages contain errors.
-     *
-     */
-    hasErrors() {
-        for (let i = 0; i < this.messages.length; i++) {
-            if (this.messages[i].startsWith(common_1.OINO_ERROR_PREFIX)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Checks if the messages contain errors.
-     *
-     */
-    getFirstError() {
-        for (let i = 0; i < this.messages.length; i++) {
-            if (this.messages[i].startsWith(common_1.OINO_ERROR_PREFIX)) {
-                return this.messages[i];
-            }
-        }
-        return "";
-    }
-}
-exports.OINODbDataSet = OINODbDataSet;
-/**
- * Generic in memory implementation of a data set where data is an array of rows. Used
- * by BunSqlite and automated testing. Can be rewinded.
- *
- */
-class OINODbMemoryDataSet extends OINODbDataSet {
-    _rows;
-    _currentRow;
-    _eof;
-    /**
-     * Constructor of `OINODbMemoryDataSet`.
-     *
-     * @param data data as OINODataRow[] (constructor will throw if invalid)
-     * @param errors error messages from SQL-query
-     *
-     */
-    constructor(data, errors = []) {
-        super(data, errors);
-        if ((data == null) || !(Array.isArray(data))) {
-            throw new Error(common_1.OINO_ERROR_PREFIX + ": Data needs to be compatible with OINORow[]!"); // TODO: maybe check all rows
-        }
-        this._rows = data;
-        if (this.isEmpty()) {
-            this._currentRow = -1;
-            this._eof = true;
-        }
-        else {
-            this._currentRow = 0;
-            this._eof = false;
-        }
-    }
-    /**
-     * Is data set empty.
-     *
-     */
-    isEmpty() {
-        return (this._rows.length == 0);
-    }
-    /**
-     * Is there no more content, i.e. either dataset is empty or we have moved beyond last line
-     *
-     */
-    isEof() {
-        return (this._eof);
-    }
-    /**
-     * Attempts to moves dataset to the next row, possibly waiting for more data to become available. Returns !isEof().
-     *
-     */
-    async next() {
-        if (this._currentRow < this._rows.length - 1) {
-            this._currentRow = this._currentRow + 1;
-        }
-        else {
-            this._eof = true;
-        }
-        return Promise.resolve(!this._eof);
-    }
-    /**
-     * Gets current row of data.
-     *
-     */
-    getRow() {
-        if ((this._currentRow >= 0) && (this._currentRow < this._rows.length)) {
-            return this._rows[this._currentRow];
-        }
-        else {
-            return index_js_1.OINODB_EMPTY_ROW;
-        }
-    }
-    /**
-     * Gets all rows of data.
-     *
-     */
-    async getAllRows() {
-        return this._rows; // at the moment theres no result streaming, so we can just return the rows
-    }
-    /**
-     * Rewinds data set to the first row, returns !isEof().
-     *
-     */
-    first() {
-        this._currentRow = 0;
-        this._eof = this._rows.length == 0;
-        return !this._eof;
-    }
-}
-exports.OINODbMemoryDataSet = OINODbMemoryDataSet;

package/dist/cjs/OINODbApi.js

@@ -5,281 +5,19 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OINODbApi = exports.OINODbHtmlTemplate = exports.OINODbApiResult = exports.OINODbApiRequest = void 0;
-const node_buffer_1 = require("node:buffer");
+exports.OINODbApi = void 0;
 const common_1 = require("@oino-ts/common");
-const index_js_1 = require("./index.js");
-const hashid_1 = require("@oino-ts/hashid");
-class OINODbApiRequest extends common_1.OINOHttpRequest {
-    rowId;
-    rowData;
-    sqlParams;
-    constructor(init) {
-        super(init);
-        this.rowId = init?.rowId || "";
-        this.rowData = init?.rowData || null; // rowData is not compatible with OINOHttpRequest body so it's not automatically set, caller can set both if needed
-        this.sqlParams = init?.sqlParams || {};
-        if (init?.filter) {
-            if (init.filter instanceof index_js_1.OINODbSqlFilter) {
-                this.sqlParams.filter = init.filter;
-            }
-            else {
-                this.sqlParams.filter = index_js_1.OINODbSqlFilter.parse(init.filter);
-            }
-        }
-        if (!this.sqlParams.filter) {
-            const filter_params = this.url?.searchParams.getAll(index_js_1.OINODbConfig.OINODB_SQL_FILTER_PARAM) || [];
-            for (let i = 0; i < filter_params.length; i++) {
-                const f = index_js_1.OINODbSqlFilter.parse(filter_params[i]);
-                if (i > 0) {
-                    this.sqlParams.filter = index_js_1.OINODbSqlFilter.combine(this.sqlParams.filter, index_js_1.OINODbSqlBooleanOperation.and, f);
-                }
-                else {
-                    this.sqlParams.filter = f;
-                }
-            }
-        }
-        if (init?.order) {
-            if (init.order instanceof index_js_1.OINODbSqlOrder) {
-                this.sqlParams.order = init.order;
-            }
-            else {
-                this.sqlParams.order = index_js_1.OINODbSqlOrder.parse(init.order);
-            }
-        }
-        if (!this.sqlParams.order) {
-            const order_param = this.url?.searchParams.get(index_js_1.OINODbConfig.OINODB_SQL_ORDER_PARAM);
-            if (order_param) {
-                this.sqlParams.order = index_js_1.OINODbSqlOrder.parse(order_param);
-            }
-        }
-        if (init?.limit) {
-            if (init.limit instanceof index_js_1.OINODbSqlLimit) {
-                this.sqlParams.limit = init.limit;
-            }
-            else {
-                this.sqlParams.limit = index_js_1.OINODbSqlLimit.parse(init.limit);
-            }
-        }
-        if (!this.sqlParams.limit) {
-            const limit_param = this.url?.searchParams.get(index_js_1.OINODbConfig.OINODB_SQL_LIMIT_PARAM);
-            if (limit_param) {
-                this.sqlParams.limit = index_js_1.OINODbSqlLimit.parse(limit_param);
-            }
-        }
-        if (init?.aggregate) {
-            if (init.aggregate instanceof index_js_1.OINODbSqlAggregate) {
-                this.sqlParams.aggregate = init.aggregate;
-            }
-            else {
-                this.sqlParams.aggregate = index_js_1.OINODbSqlAggregate.parse(init.aggregate);
-            }
-        }
-        if (!this.sqlParams.aggregate) {
-            const aggregate_param = this.url?.searchParams.get(index_js_1.OINODbConfig.OINODB_SQL_AGGREGATE_PARAM);
-            if (aggregate_param) {
-                this.sqlParams.aggregate = index_js_1.OINODbSqlAggregate.parse(aggregate_param);
-            }
-        }
-        if (init?.select) {
-            if (init.select instanceof index_js_1.OINODbSqlSelect) {
-                this.sqlParams.select = init.select;
-            }
-            else {
-                this.sqlParams.select = index_js_1.OINODbSqlSelect.parse(init.select);
-            }
-        }
-        if (!this.sqlParams.select) {
-            const select_param = this.url?.searchParams.get(index_js_1.OINODbConfig.OINODB_SQL_SELECT_PARAM);
-            if (select_param) {
-                this.sqlParams.select = index_js_1.OINODbSqlSelect.parse(select_param);
-            }
-        }
-    }
-    static async fromFetchRequest(request, rowId, rowData, sqlParams) {
-        return new OINODbApiRequest({
-            url: new URL(request.url),
-            method: request.method,
-            headers: Object.fromEntries(request.headers),
-            rowId: rowId,
-            rowData: rowData ?? node_buffer_1.Buffer.from(await request.arrayBuffer()),
-            sqlParams: sqlParams
-        });
-    }
-    static fromHttpRequest(request, rowId, rowData, sqlParams) {
-        return new OINODbApiRequest({
-            url: typeof request.url === "string" ? new URL(request.url) : request.url,
-            method: request.method,
-            headers: Object.fromEntries(request.headers),
-            rowId: rowId,
-            rowData: rowData ?? request.bodyAsBuffer(),
-            requestType: request.requestType,
-            responseType: request.responseType,
-            multipartBoundary: request.multipartBoundary,
-            lastModified: request.lastModified,
-            sqlParams: sqlParams
-        });
-    }
-}
-exports.OINODbApiRequest = OINODbApiRequest;
-/**
- * OINO API request result object with returned data and/or http status code/message and
- * error / warning messages.
- *
- */
-class OINODbApiResult extends common_1.OINOResult {
-    /** DbApi request params */
-    request;
-    /** Returned data if any */
-    data;
-    /**
-     * Constructor of OINODbApiResult.
-     *
-     * @param request DbApi request parameters
-     * @param data result data
-     *
-     */
-    constructor(request, data) {
-        super();
-        this.request = request;
-        this.data = data;
-    }
-    /**
-     * Creates a HTTP Response from API results.
-     *
-     * @param headers Headers to include in the response
-     *
-     */
-    async writeApiResponse(headers = {}) {
-        let response = null;
-        if (this.success && this.data) {
-            const body = await this.data.writeString(this.request.responseType);
-            response = new Response(body, { status: this.status, statusText: this.statusText, headers: headers });
-        }
-        else {
-            response = new Response(JSON.stringify(this, null, 3), { status: this.status, statusText: this.statusText, headers: headers });
-        }
-        for (let i = 0; i < this.messages.length; i++) {
-            response.headers.set('X-OINO-MESSAGE-' + i, this.messages[i]);
-        }
-        return Promise.resolve(response);
-    }
-}
-exports.OINODbApiResult = OINODbApiResult;
-/**
- * Specialized HTML template that can render ´OINODbApiResult´.
- *
- */
-class OINODbHtmlTemplate extends common_1.OINOHtmlTemplate {
-    /** Locale validation regex */
-    static LOCALE_REGEX = /^(\w\w)(\-\w\w)?$/;
-    /** Locale formatter */
-    _locale;
-    _numberDecimals = -1;
-    /**
-     * Constructor of OINODbHtmlTemplate.
-     *
-     * @param template HTML template string
-     * @param numberDecimals Number of decimals to use for numbers, -1 for no formatting
-     * @param dateLocaleStr Datetime format string, either "iso" for ISO8601 or "default" for system default or valid locale string
-     * @param dateLocaleStyle Datetime format style, either "short/medium/long/full" or Intl.DateTimeFormat options
-     *
-     */
-    constructor(template, numberDecimals = -1, dateLocaleStr = "", dateLocaleStyle = "") {
-        super(template);
-        let locale_opts;
-        if ((dateLocaleStyle == null) || (dateLocaleStyle == "")) {
-            locale_opts = { dateStyle: "medium", timeStyle: "medium" };
-        }
-        else if (typeof dateLocaleStyle == "string") {
-            locale_opts = { dateStyle: dateLocaleStyle, timeStyle: dateLocaleStyle };
-        }
-        else {
-            locale_opts = dateLocaleStyle;
-        }
-        this._locale = null;
-        this._numberDecimals = numberDecimals;
-        if ((dateLocaleStr != null) && (dateLocaleStr != "") && OINODbHtmlTemplate.LOCALE_REGEX.test(dateLocaleStr)) {
-            try {
-                this._locale = new Intl.DateTimeFormat(dateLocaleStr, locale_opts);
-            }
-            catch (e) { }
-        }
-    }
-    /**
-     * Creates HTML Response from API modelset.
-     *
-     * @param modelset OINO API dataset
-     * @param overrideValues values to override in the data
-     *
-     */
-    async renderFromDbData(modelset, overrideValues) {
-        common_1.OINOBenchmark.startMetric("OINOHtmlTemplate", "renderFromDbData");
-        let html = "";
-        const dataset = modelset.dataset;
-        const datamodel = modelset.datamodel;
-        const api = modelset.datamodel.api;
-        const modified_index = datamodel.findFieldIndexByName(api.params.cacheModifiedField || "");
-        let last_modified = this.modified;
-        while (!dataset.isEof()) {
-            const row = dataset.getRow();
-            if (modified_index >= 0) {
-                last_modified = Math.max(last_modified, new Date(row[modified_index]).getTime());
-            }
-            let row_id_seed = datamodel.getRowPrimarykeyValues(row).join(' ');
-            let primary_key_values = [];
-            this.clearVariables();
-            this.setVariableFromValue(index_js_1.OINODbConfig.OINODB_ID_FIELD, "");
-            for (let i = 0; i < datamodel.fields.length; i++) {
-                const f = datamodel.fields[i];
-                let value;
-                if ((f instanceof index_js_1.OINODatetimeDataField) && (this._locale != null)) {
-                    value = f.serializeCellWithLocale(row[i], this._locale);
-                }
-                else if ((f instanceof index_js_1.OINONumberDataField) && (this._numberDecimals >= 0) && (typeof row[i] === "number")) {
-                    // console.debug("renderFromDbData number decimals", { field: f.name, value: row[i], type: typeof row[i] });
-                    value = row[i].toFixed(this._numberDecimals);
-                }
-                else {
-                    value = f.serializeCell(row[i]);
-                }
-                if (f.fieldParams.isPrimaryKey || f.fieldParams.isForeignKey) {
-                    if (value && (f instanceof index_js_1.OINONumberDataField) && (datamodel.api.hashid)) {
-                        value = datamodel.api.hashid.encode(value, f.name + " " + row_id_seed);
-                    }
-                    if (f.fieldParams.isPrimaryKey) {
-                        primary_key_values.push(value || "");
-                    }
-                }
-                this.setVariableFromValue(f.name, value || "");
-            }
-            this.setVariableFromProperties(overrideValues);
-            this.setVariableFromValue(index_js_1.OINODbConfig.OINODB_ID_FIELD, index_js_1.OINODbConfig.printOINOId(primary_key_values));
-            html += this._renderHtml() + "\r\n";
-            await dataset.next();
-        }
-        this.modified = last_modified;
-        const result = this._createHttpResult(html);
-        common_1.OINOBenchmark.endMetric("OINOHtmlTemplate", "renderFromDbData");
-        return result;
-    }
-}
-exports.OINODbHtmlTemplate = OINODbHtmlTemplate;
 /**
  * API class with method to process HTTP REST requests.
  *
  */
-class OINODbApi {
-    /** Enable debug output on errors */
-    _debugOnError = false;
-    /** API database reference */
+class OINODbApi extends common_1.OINOApi {
+    /** DB reference */
     db;
-    /** API datamodel */
-    datamodel;
-    /** API parameters */
-    params;
-    /** API hashid */
-    hashid;
+    /** DB parameters reference */
+    dbParams;
+    /** DB datamodel reference */
+    dbDatamodel = null;
     /**
      * Constructor of API object.
      * NOTE! OINODb.initDatamodel must be called if created manually instead of the factory.
@@ -289,23 +27,22 @@ class OINODbApi {
      *
      */
     constructor(db, params) {
+        super(db, params);
         if (!params.tableName) {
-            throw new Error(common_1.OINO_ERROR_PREFIX + ": OINODbApiParams needs to define a table name!");
+            throw new Error(common_1.OINO_ERROR_PREFIX + ": OINOApiParams needs to define a table name!");
         }
         this.db = db;
-        this.params = params;
-        this.datamodel = new index_js_1.OINODbDataModel(this);
-        if (this.params.hashidKey) {
-            this.hashid = new hashid_1.OINOHashid(this.params.hashidKey, this.db.name, this.params.hashidLength, this.params.hashidStaticIds);
-        }
-        else {
-            this.hashid = null;
-        }
+        this.dbParams = params;
+    }
+    initializeDatamodel(datamodel) {
+        this.dbDatamodel = datamodel;
+        this.datamodel = datamodel;
+        this.initialized = true;
     }
     _validateRow(result, row, requirePrimaryKey) {
         let field;
-        for (let i = 0; i < this.datamodel.fields.length; i++) {
-            field = this.datamodel.fields[i];
+        for (let i = 0; i < this.dbDatamodel.fields.length; i++) {
+            field = this.dbDatamodel.fields[i];
             const val = row[i];
             if ((val === null) && ((field.fieldParams.isNotNull) || (field.fieldParams.isPrimaryKey))) { // null is a valid SQL value except if it's not allowed
                 result.setError(405, "Field '" + field.name + "' is not allowed to be NULL!", "ValidateRowValues");
@@ -313,14 +50,14 @@ class OINODbApi {
             else if ((val === undefined) && (requirePrimaryKey) && (field.fieldParams.isPrimaryKey) && (!field.fieldParams.isAutoInc)) {
                 result.setError(405, "Primary key '" + field.name + "' is not autoinc and missing from the data!", "ValidateRowValues");
             }
-            else if ((val !== undefined) && (this.params.failOnUpdateOnAutoinc) && (field.fieldParams.isAutoInc)) {
+            else if ((val !== undefined) && (this.dbParams.failOnUpdateOnAutoinc) && (field.fieldParams.isAutoInc)) {
                 result.setError(405, "Autoinc field '" + field.name + "' can't be updated!", "ValidateRowValues");
             }
             else {
-                if ((field instanceof index_js_1.OINOStringDataField) && ((field.maxLength > 0))) {
+                if ((field instanceof common_1.OINOStringDataField) && ((field.maxLength > 0))) {
                     const str_val = val?.toString() || "";
                     if (str_val.length > field.maxLength) {
-                        if (this.params.failOnOversizedValues) {
+                        if (this.dbParams.failOnOversizedValues) {
                             result.setError(405, "Field '" + field.name + "' length (" + str_val.length + ") exceeds maximum (" + field.maxLength + ") and can't be set!", "ValidateRowValues");
                         }
                         else {
@@ -340,7 +77,7 @@ class OINODbApi {
                 rows = data;
             }
             else if (data != null) {
-                rows = index_js_1.OINODbParser.createRows(this.datamodel, data, request.requestType, request.multipartBoundary);
+                rows = common_1.OINOParser.createRows(this.datamodel, data, request.requestType, request.multipartBoundary);
             }
         }
         catch (e) {
@@ -351,7 +88,7 @@ class OINODbApi {
     async _doGet(result, rowId, request) {
         let sql = "";
         try {
-            sql = this.datamodel.printSqlSelect(rowId, request.sqlParams || {});
+            sql = this.dbDatamodel.printSqlSelect(rowId, request.queryParams || {});
             common_1.OINOLog.debug("@oino-ts/db", "OINODbApi", "_doGet", "Print SQL", { sql: sql });
             const sql_res = await this.db.sqlSelect(sql);
             if (sql_res.success == false) {
@@ -361,7 +98,7 @@ class OINODbApi {
                 }
             }
             else {
-                result.data = new index_js_1.OINODbModelSet(this.datamodel, sql_res, request.sqlParams);
+                result.data = new common_1.OINOModelSet(this.datamodel, sql_res, request.queryParams);
             }
         }
         catch (e) {
@@ -376,11 +113,11 @@ class OINODbApi {
         let sql = "";
         try {
             for (let i = 0; i < rows.length; i++) {
-                this._validateRow(result, rows[i], this.params.failOnInsertWithoutKey || false);
+                this._validateRow(result, rows[i], this.dbParams.failOnInsertWithoutKey || false);
                 if (result.success) {
-                    sql += this.datamodel.printSqlInsert(rows[i]);
+                    sql += this.dbDatamodel.printSqlInsert(rows[i]);
                 }
-                else if (this.params.failOnAnyInvalidRows == false) {
+                else if (this.dbParams.failOnAnyInvalidRows == false) {
                     result.setOk(); // individual rows may fail and will just be messages in response similar to executing multiple sql statements
                 }
             }
@@ -397,8 +134,8 @@ class OINODbApi {
                         result.addDebug("OINO POST SQL [" + sql + "]", "DoPost");
                     }
                 }
-                else if (this.params.returnInsertedIds) {
-                    result.data = new index_js_1.OINODbModelSet(this.datamodel, sql_res, request.sqlParams); // return the inserted ids as data
+                else if (this.dbParams.returnInsertedIds) {
+                    result.data = new common_1.OINOModelSet(this.datamodel, sql_res, request.queryParams); // return the inserted ids as data
                 }
             }
         }
@@ -415,12 +152,12 @@ class OINODbApi {
         try {
             // this._validateRowValues(result, row, false)
             for (let i = 0; i < rows.length; i++) {
-                const row_id = id || index_js_1.OINODbConfig.printOINOId(this.datamodel.getRowPrimarykeyValues(rows[i], this.hashid != null));
-                this._validateRow(result, rows[i], this.params.failOnInsertWithoutKey || false);
+                const row_id = id || common_1.OINOConfig.printOINOId(this.dbDatamodel.getRowPrimarykeyValues(rows[i], this.hashid != null));
+                this._validateRow(result, rows[i], this.dbParams.failOnInsertWithoutKey || false);
                 if (result.success) {
-                    sql += this.datamodel.printSqlUpdate(row_id, rows[i]);
+                    sql += this.dbDatamodel.printSqlUpdate(row_id, rows[i]);
                 }
-                else if (this.params.failOnAnyInvalidRows == false) {
+                else if (this.dbParams.failOnAnyInvalidRows == false) {
                     result.setOk(); // individual rows may fail and will just be messages in response similar to executing multiple sql statements
                 }
             }
@@ -452,17 +189,17 @@ class OINODbApi {
         try {
             if (rows != null) {
                 for (let i = 0; i < rows.length; i++) {
-                    const row_id = index_js_1.OINODbConfig.printOINOId(this.datamodel.getRowPrimarykeyValues(rows[i], this.hashid != null));
+                    const row_id = common_1.OINOConfig.printOINOId(this.dbDatamodel.getRowPrimarykeyValues(rows[i], this.hashid != null));
                     if (row_id) {
-                        sql += this.datamodel.printSqlDelete(row_id);
+                        sql += this.dbDatamodel.printSqlDelete(row_id);
                     }
-                    else if (this.params.failOnAnyInvalidRows == false) {
+                    else if (this.dbParams.failOnAnyInvalidRows == false) {
                         result.setOk(); // individual rows may fail and will just be messages in response similar to executing multiple sql statements
                     }
                 }
             }
             else if (id) {
-                sql = this.datamodel.printSqlDelete(id);
+                sql = this.dbDatamodel.printSqlDelete(id);
             }
             if ((sql == "") && result.success) {
                 result.setError(405, "No valid rows for DELETE!", "DoDelete"); // only set error if there are multiple rows and no valid sql was created
@@ -487,14 +224,6 @@ class OINODbApi {
             }
         }
     }
-    /**
-     * Enable or disable debug output on errors.
-     *
-     * @param debugOnError true to enable debug output on errors, false to disable
-     */
-    setDebugOnError(debugOnError) {
-        this._debugOnError = debugOnError;
-    }
     /**
      * Method for handling a HTTP REST request with GET, POST, PUT, DELETE corresponding to
      * SQL select, insert, update and delete.
@@ -502,11 +231,11 @@ class OINODbApi {
      * @param request OINO HTTP request object containing all parameters of the REST request
      * @param rowId URL id of the REST request
      * @param rowData HTTP body data as either serialized string or unserialized JS object or OINODataRow-array or Buffer/Uint8Array binary data
-     * @param sqlParams SQL parameters for the REST request
+     * @param queryParams SQL parameters for the REST request
      *
      */
-    async doHttpRequest(request, rowId, rowData, sqlParams) {
-        const api_request = OINODbApiRequest.fromHttpRequest(request, rowId, rowData, sqlParams);
+    async doHttpRequest(request, rowId, rowData, queryParams) {
+        const api_request = common_1.OINOApiRequest.fromHttpRequest(request, rowId, rowData, queryParams);
         return this.doApiRequest(api_request);
     }
     /**
@@ -516,17 +245,20 @@ class OINODbApi {
      * @param method HTTP method of the REST request
      * @param rowId URL id of the REST request
      * @param rowData HTTP body data as either serialized string or unserialized JS object or OINODataRow-array or Buffer/Uint8Array binary data
-     * @param sqlParams SQL parameters for the REST request
+     * @param queryParams SQL parameters for the REST request
      * @param contentType content type of the HTTP body data, default is JSON
      *
      */
-    async doRequest(method, rowId, rowData, sqlParams, contentType = common_1.OINOContentType.json) {
-        return this.doApiRequest(new OINODbApiRequest({ method: method, rowId: rowId, rowData: rowData, sqlParams: sqlParams, requestType: contentType }));
+    async doRequest(method, rowId, rowData, queryParams, contentType = common_1.OINOContentType.json) {
+        return this.doApiRequest(new common_1.OINOApiRequest({ method: method, rowId: rowId, rowData: rowData, queryParams: queryParams, requestType: contentType }));
     }
     async doApiRequest(request) {
+        if (this.initialized == false) {
+            throw new Error(common_1.OINO_ERROR_PREFIX + ": API is not initialized yet!");
+        }
         common_1.OINOBenchmark.startMetric("OINODbApi", "doRequest." + request.method);
         common_1.OINOLog.debug("@oino-ts/db", "OINODbApi", "doRequest", "Request", { method: request.method, id: request.rowId, data: request.rowData });
-        let result = new OINODbApiResult(request);
+        let result = new common_1.OINOApiResult(request);
         let rows = [];
         if ((request.method == "POST") || (request.method == "PUT")) {
             rows = this._parseData(result, request);
@@ -593,8 +325,8 @@ class OINODbApi {
      * @param rowData HTTP body data as either serialized string or unserialized JS object or OINODataRow-array or Buffer/Uint8Array binary data
      *
      */
-    async doBatchUpdate(method, rowId, rowData, sqlParams) {
-        return this.doApiRequest(new OINODbApiRequest({ method: method, rowId: rowId, rowData: rowData, sqlParams: sqlParams }));
+    async doBatchUpdate(method, rowId, rowData, queryParams) {
+        return this.doApiRequest(new common_1.OINOApiRequest({ method: method, rowId: rowId, rowData: rowData, queryParams: queryParams }));
     }
     /**
      * Method for handling a HTTP REST request with batch update using PUT or DELETE methods.
@@ -602,9 +334,9 @@ class OINODbApi {
      * @param request HTTP URL parameters as key-value-pairs
      *
      */
-    async runBatchUpdate(request) {
+    async doBatchApiRequest(request) {
         common_1.OINOLog.debug("@oino-ts/db", "OINODbApi", "doBatchUpdate", "Request", { request: request, data: request.rowData });
-        let result = new OINODbApiResult(request);
+        let result = new common_1.OINOApiResult(request);
         if ((request.method != "PUT") && (request.method != "DELETE")) {
             result.setError(500, "Batch update only supports PUT and DELETE methods!", "DoBatchUpdate");
             return Promise.resolve(result);