@oino-ts/db 0.13.4 → 0.14.1

package/dist/cjs/OINODbSqlParams.js

@@ -5,7 +5,7 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OINODbSqlSelect = exports.OINODbSqlAggregate = exports.OINODbSqlAggregateFunctions = exports.OINODbSqlLimit = exports.OINODbSqlOrder = exports.OINODbSqlFilter = exports.OINODbSqlComparison = exports.OINODbSqlBooleanOperation = void 0;
+exports.OINODbSqlSelect = exports.OINODbSqlAggregate = exports.OINODbSqlAggregateFunctions = exports.OINODbSqlLimit = exports.OINODbSqlOrder = exports.OINODbSqlFilter = exports.OINODbSqlNullCheck = exports.OINODbSqlComparison = exports.OINODbSqlBooleanOperation = void 0;
 const index_js_1 = require("./index.js");
 const OINO_FIELD_NAME_CHARS = "\\w\\s\\-\\_\\#\\¤";
 /**
@@ -27,10 +27,20 @@ var OINODbSqlComparison;
     OINODbSqlComparison["lt"] = "lt";
     OINODbSqlComparison["le"] = "le";
     OINODbSqlComparison["eq"] = "eq";
+    OINODbSqlComparison["ne"] = "ne";
     OINODbSqlComparison["ge"] = "ge";
     OINODbSqlComparison["gt"] = "gt";
     OINODbSqlComparison["like"] = "like";
 })(OINODbSqlComparison || (exports.OINODbSqlComparison = OINODbSqlComparison = {}));
+/**
+ * Supported logical conjunctions in filter predicates.
+ * @enum
+ */
+var OINODbSqlNullCheck;
+(function (OINODbSqlNullCheck) {
+    OINODbSqlNullCheck["isnull"] = "isnull";
+    OINODbSqlNullCheck["isnotnull"] = "isnotnull";
+})(OINODbSqlNullCheck || (exports.OINODbSqlNullCheck = OINODbSqlNullCheck = {}));
 /**
  * Class for recursively parsing of filters and printing them as SQL conditions.
  * Supports three types of statements
@@ -42,8 +52,9 @@ var OINODbSqlComparison;
  */
 class OINODbSqlFilter {
     static _booleanOperationRegex = /^\s?\-(and|or)\s?$/i;
-    static _negationRegex = /^-(not|)\((.+)\)$/i;
-    static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i;
+    static _negationRegex = /^-(not)\((.+)\)$/i;
+    static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ne|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i;
+    static _filterNullCheckRegex = /^-(isnull|isnotnull)\((.+)\)$/i;
     _leftSide;
     _rightSide;
     _operator;
@@ -57,6 +68,7 @@ class OINODbSqlFilter {
         if (!(((operation === null) && (leftSide == "") && (rightSide == "")) ||
             ((operation !== null) && (Object.values(OINODbSqlComparison).includes(operation)) && (typeof (leftSide) == "string") && (leftSide != "") && (typeof (rightSide) == "string") && (rightSide != "")) ||
             ((operation == OINODbSqlBooleanOperation.not) && (leftSide == "") && (rightSide instanceof OINODbSqlFilter)) ||
+            (((operation == OINODbSqlNullCheck.isnull) || (operation == OINODbSqlNullCheck.isnotnull)) && (typeof (leftSide) == "string") && (rightSide == "")) ||
             (((operation == OINODbSqlBooleanOperation.and) || (operation == OINODbSqlBooleanOperation.or)) && (leftSide instanceof OINODbSqlFilter) && (rightSide instanceof OINODbSqlFilter)))) {
             index_js_1.OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Unsupported OINODbSqlFilter format", { leftSide: leftSide, operation: operation, rightSide: rightSide });
             throw new Error(index_js_1.OINO_ERROR_PREFIX + ": Unsupported OINODbSqlFilter format!");
@@ -72,6 +84,7 @@ class OINODbSqlFilter {
      * - comparison: (field)-lt|le|eq|ge|gt|like(value)
      * - negation: -not(filter)
      * - conjunction/disjunction: (filter)-and|or(filter)
+     * - null check: -isnull(field) or -isnotnull(field)
      *
      * @param filterString string representation of filter from HTTP-request
      *
@@ -82,7 +95,7 @@ class OINODbSqlFilter {
         }
         else {
             let match = OINODbSqlFilter._filterComparisonRegex.exec(filterString);
-            if (match != null) {
+            if ((match != null) && (match.length == 4)) {
                 return new OINODbSqlFilter(match[1], match[2].toLowerCase(), match[3]);
             }
             else {
@@ -96,8 +109,14 @@ class OINODbSqlFilter {
                         return new OINODbSqlFilter(OINODbSqlFilter.parse(boolean_parts[0]), boolean_parts[1].trim().toLowerCase().substring(1), OINODbSqlFilter.parse(boolean_parts[2]));
                     }
                     else {
-                        index_js_1.OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", { filterString: filterString });
-                        throw new Error(index_js_1.OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'"); // invalid filter could be a security risk, stop processing
+                        let match = OINODbSqlFilter._filterNullCheckRegex.exec(filterString);
+                        if ((match != null)) {
+                            return new OINODbSqlFilter(match[2], match[1].toLowerCase(), "");
+                        }
+                        else {
+                            index_js_1.OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", { filterString: filterString });
+                            throw new Error(index_js_1.OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'"); // invalid filter could be a security risk, stop processing
+                        }
                     }
                 }
             }
@@ -125,6 +144,50 @@ class OINODbSqlFilter {
             return undefined;
         }
     }
+    /**
+     * Combine two filters with an AND operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static and(leftSide, rightSide) {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.and, rightSide);
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Combine two filters with an OR operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static or(leftSide, rightSide) {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.or, rightSide);
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Negate a filter with a NOT operation.
+     *
+     * @param leftSide left side filter
+     *
+     */
+    static not(leftSide) {
+        if ((leftSide) && (!leftSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.not, "");
+        }
+        else {
+            return undefined;
+        }
+    }
     _operatorToSql() {
         switch (this._operator) {
             case "and": return " AND ";
@@ -133,9 +196,12 @@ class OINODbSqlFilter {
             case "lt": return " < ";
             case "le": return " <= ";
             case "eq": return " = ";
+            case "ne": return " != ";
             case "ge": return " >= ";
             case "gt": return " > ";
             case "like": return " LIKE ";
+            case "isnull": return " IS NULL";
+            case "isnotnull": return " IS NOT NULL";
         }
         return " ";
     }
@@ -173,6 +239,9 @@ class OINODbSqlFilter {
         if (this._rightSide instanceof OINODbSqlFilter) {
             result += this._rightSide.toSql(dataModel);
         }
+        else if (this._operator == OINODbSqlNullCheck.isnull || this._operator == OINODbSqlNullCheck.isnotnull) {
+            // nothing to do, IS NULL and IS NOT NULL do not have a right side
+        }
         else {
             const value = field.deserializeCell(this._rightSide);
             if ((value == null) || (value === "")) {

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OINODB_UNDEFINED = exports.OINODB_EMPTY_ROWS = exports.OINODB_EMPTY_ROW = exports.OINODbParser = exports.OINODbSwagger = exports.OINODbFactory = exports.OINODbConfig = exports.OINODbSqlSelect = exports.OINODbSqlAggregateFunctions = exports.OINODbSqlAggregate = exports.OINODbSqlBooleanOperation = exports.OINODbSqlLimit = exports.OINODbSqlComparison = exports.OINODbSqlOrder = exports.OINODbSqlFilter = exports.OINODb = exports.OINODbMemoryDataSet = exports.OINODbDataSet = exports.OINODatetimeDataField = exports.OINOBlobDataField = exports.OINOStringDataField = exports.OINONumberDataField = exports.OINOBooleanDataField = exports.OINODbDataField = exports.OINODbModelSet = exports.OINODbDataModel = exports.OINODbApi = exports.OINODbHtmlTemplate = exports.OINODbApiResult = exports.OINOHtmlTemplate = exports.OINOHttpResult = exports.OINOResult = exports.OINOConsoleLog = exports.OINOLogLevel = exports.OINOLog = exports.OINOMemoryBenchmark = exports.OINOBenchmark = exports.OINOStr = exports.OINO_DEBUG_PREFIX = exports.OINO_INFO_PREFIX = exports.OINO_WARNING_PREFIX = exports.OINO_ERROR_PREFIX = exports.OINOContentType = void 0;
+exports.OINODB_UNDEFINED = exports.OINODB_EMPTY_ROWS = exports.OINODB_EMPTY_ROW = exports.OINODbParser = exports.OINODbSwagger = exports.OINODbFactory = exports.OINODbConfig = exports.OINODbSqlNullCheck = exports.OINODbSqlSelect = exports.OINODbSqlAggregateFunctions = exports.OINODbSqlAggregate = exports.OINODbSqlBooleanOperation = exports.OINODbSqlLimit = exports.OINODbSqlComparison = exports.OINODbSqlOrder = exports.OINODbSqlFilter = exports.OINODb = exports.OINODbMemoryDataSet = exports.OINODbDataSet = exports.OINODatetimeDataField = exports.OINOBlobDataField = exports.OINOStringDataField = exports.OINONumberDataField = exports.OINOBooleanDataField = exports.OINODbDataField = exports.OINODbModelSet = exports.OINODbDataModel = exports.OINODbApi = exports.OINODbHtmlTemplate = exports.OINODbApiResult = exports.OINOHtmlTemplate = exports.OINOHttpResult = exports.OINOResult = exports.OINOConsoleLog = exports.OINOLogLevel = exports.OINOLog = exports.OINOMemoryBenchmark = exports.OINOBenchmark = exports.OINOStr = exports.OINO_DEBUG_PREFIX = exports.OINO_INFO_PREFIX = exports.OINO_WARNING_PREFIX = exports.OINO_ERROR_PREFIX = exports.OINOContentType = void 0;
 const common_1 = require("@oino-ts/common");
 Object.defineProperty(exports, "OINOContentType", { enumerable: true, get: function () { return common_1.OINOContentType; } });
 var common_2 = require("@oino-ts/common");
@@ -45,6 +45,7 @@ Object.defineProperty(exports, "OINODbSqlBooleanOperation", { enumerable: true,
 Object.defineProperty(exports, "OINODbSqlAggregate", { enumerable: true, get: function () { return OINODbSqlParams_js_1.OINODbSqlAggregate; } });
 Object.defineProperty(exports, "OINODbSqlAggregateFunctions", { enumerable: true, get: function () { return OINODbSqlParams_js_1.OINODbSqlAggregateFunctions; } });
 Object.defineProperty(exports, "OINODbSqlSelect", { enumerable: true, get: function () { return OINODbSqlParams_js_1.OINODbSqlSelect; } });
+Object.defineProperty(exports, "OINODbSqlNullCheck", { enumerable: true, get: function () { return OINODbSqlParams_js_1.OINODbSqlNullCheck; } });
 var OINODbConfig_js_1 = require("./OINODbConfig.js");
 Object.defineProperty(exports, "OINODbConfig", { enumerable: true, get: function () { return OINODbConfig_js_1.OINODbConfig; } });
 var OINODbFactory_js_1 = require("./OINODbFactory.js");

package/dist/esm/OINODbSqlParams.js

@@ -24,10 +24,20 @@ export var OINODbSqlComparison;
     OINODbSqlComparison["lt"] = "lt";
     OINODbSqlComparison["le"] = "le";
     OINODbSqlComparison["eq"] = "eq";
+    OINODbSqlComparison["ne"] = "ne";
     OINODbSqlComparison["ge"] = "ge";
     OINODbSqlComparison["gt"] = "gt";
     OINODbSqlComparison["like"] = "like";
 })(OINODbSqlComparison || (OINODbSqlComparison = {}));
+/**
+ * Supported logical conjunctions in filter predicates.
+ * @enum
+ */
+export var OINODbSqlNullCheck;
+(function (OINODbSqlNullCheck) {
+    OINODbSqlNullCheck["isnull"] = "isnull";
+    OINODbSqlNullCheck["isnotnull"] = "isnotnull";
+})(OINODbSqlNullCheck || (OINODbSqlNullCheck = {}));
 /**
  * Class for recursively parsing of filters and printing them as SQL conditions.
  * Supports three types of statements
@@ -39,8 +49,9 @@ export var OINODbSqlComparison;
  */
 export class OINODbSqlFilter {
     static _booleanOperationRegex = /^\s?\-(and|or)\s?$/i;
-    static _negationRegex = /^-(not|)\((.+)\)$/i;
-    static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i;
+    static _negationRegex = /^-(not)\((.+)\)$/i;
+    static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ne|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i;
+    static _filterNullCheckRegex = /^-(isnull|isnotnull)\((.+)\)$/i;
     _leftSide;
     _rightSide;
     _operator;
@@ -54,6 +65,7 @@ export class OINODbSqlFilter {
         if (!(((operation === null) && (leftSide == "") && (rightSide == "")) ||
             ((operation !== null) && (Object.values(OINODbSqlComparison).includes(operation)) && (typeof (leftSide) == "string") && (leftSide != "") && (typeof (rightSide) == "string") && (rightSide != "")) ||
             ((operation == OINODbSqlBooleanOperation.not) && (leftSide == "") && (rightSide instanceof OINODbSqlFilter)) ||
+            (((operation == OINODbSqlNullCheck.isnull) || (operation == OINODbSqlNullCheck.isnotnull)) && (typeof (leftSide) == "string") && (rightSide == "")) ||
             (((operation == OINODbSqlBooleanOperation.and) || (operation == OINODbSqlBooleanOperation.or)) && (leftSide instanceof OINODbSqlFilter) && (rightSide instanceof OINODbSqlFilter)))) {
             OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Unsupported OINODbSqlFilter format", { leftSide: leftSide, operation: operation, rightSide: rightSide });
             throw new Error(OINO_ERROR_PREFIX + ": Unsupported OINODbSqlFilter format!");
@@ -69,6 +81,7 @@ export class OINODbSqlFilter {
      * - comparison: (field)-lt|le|eq|ge|gt|like(value)
      * - negation: -not(filter)
      * - conjunction/disjunction: (filter)-and|or(filter)
+     * - null check: -isnull(field) or -isnotnull(field)
      *
      * @param filterString string representation of filter from HTTP-request
      *
@@ -79,7 +92,7 @@ export class OINODbSqlFilter {
         }
         else {
             let match = OINODbSqlFilter._filterComparisonRegex.exec(filterString);
-            if (match != null) {
+            if ((match != null) && (match.length == 4)) {
                 return new OINODbSqlFilter(match[1], match[2].toLowerCase(), match[3]);
             }
             else {
@@ -93,8 +106,14 @@ export class OINODbSqlFilter {
                         return new OINODbSqlFilter(OINODbSqlFilter.parse(boolean_parts[0]), boolean_parts[1].trim().toLowerCase().substring(1), OINODbSqlFilter.parse(boolean_parts[2]));
                     }
                     else {
-                        OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", { filterString: filterString });
-                        throw new Error(OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'"); // invalid filter could be a security risk, stop processing
+                        let match = OINODbSqlFilter._filterNullCheckRegex.exec(filterString);
+                        if ((match != null)) {
+                            return new OINODbSqlFilter(match[2], match[1].toLowerCase(), "");
+                        }
+                        else {
+                            OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", { filterString: filterString });
+                            throw new Error(OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'"); // invalid filter could be a security risk, stop processing
+                        }
                     }
                 }
             }
@@ -122,6 +141,50 @@ export class OINODbSqlFilter {
             return undefined;
         }
     }
+    /**
+     * Combine two filters with an AND operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static and(leftSide, rightSide) {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.and, rightSide);
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Combine two filters with an OR operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static or(leftSide, rightSide) {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.or, rightSide);
+        }
+        else {
+            return undefined;
+        }
+    }
+    /**
+     * Negate a filter with a NOT operation.
+     *
+     * @param leftSide left side filter
+     *
+     */
+    static not(leftSide) {
+        if ((leftSide) && (!leftSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.not, "");
+        }
+        else {
+            return undefined;
+        }
+    }
     _operatorToSql() {
         switch (this._operator) {
             case "and": return " AND ";
@@ -130,9 +193,12 @@ export class OINODbSqlFilter {
             case "lt": return " < ";
             case "le": return " <= ";
             case "eq": return " = ";
+            case "ne": return " != ";
             case "ge": return " >= ";
             case "gt": return " > ";
             case "like": return " LIKE ";
+            case "isnull": return " IS NULL";
+            case "isnotnull": return " IS NOT NULL";
         }
         return " ";
     }
@@ -170,6 +236,9 @@ export class OINODbSqlFilter {
         if (this._rightSide instanceof OINODbSqlFilter) {
             result += this._rightSide.toSql(dataModel);
         }
+        else if (this._operator == OINODbSqlNullCheck.isnull || this._operator == OINODbSqlNullCheck.isnotnull) {
+            // nothing to do, IS NULL and IS NOT NULL do not have a right side
+        }
         else {
             const value = field.deserializeCell(this._rightSide);
             if ((value == null) || (value === "")) {

package/dist/esm/index.js

@@ -6,7 +6,7 @@ export { OINODbDataModel } from "./OINODbDataModel.js";
 export { OINODbModelSet } from "./OINODbModelSet.js";
 export { OINODbDataField, OINOBooleanDataField, OINONumberDataField, OINOStringDataField, OINOBlobDataField, OINODatetimeDataField } from "./OINODbDataField.js";
 export { OINODbDataSet, OINODbMemoryDataSet, OINODb } from "./OINODb.js";
-export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect } from "./OINODbSqlParams.js";
+export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect, OINODbSqlNullCheck } from "./OINODbSqlParams.js";
 export { OINODbConfig } from "./OINODbConfig.js";
 export { OINODbFactory } from "./OINODbFactory.js";
 export { OINODbSwagger } from "./OINODbSwagger.js";

package/dist/types/OINODbApi.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { OINODbApiParams, OINODb, OINODbDataModel, OINODataRow, OINODbModelSet, OINODbApiRequestParams, OINOHttpResult, OINOHtmlTemplate } from "./index.js";
 import { OINOResult } from "@oino-ts/common";
 import { OINOHashid } from "@oino-ts/hashid";

package/dist/types/OINODbParser.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { OINODbDataModel, OINODataRow, OINODbApiRequestParams } from "./index.js";
 /**
  * Static factory class for easily creating things based on data

package/dist/types/OINODbSqlParams.d.ts

@@ -16,10 +16,19 @@ export declare enum OINODbSqlComparison {
     lt = "lt",
     le = "le",
     eq = "eq",
+    ne = "ne",
     ge = "ge",
     gt = "gt",
     like = "like"
 }
+/**
+ * Supported logical conjunctions in filter predicates.
+ * @enum
+ */
+export declare enum OINODbSqlNullCheck {
+    isnull = "isnull",
+    isnotnull = "isnotnull"
+}
 /**
  * Class for recursively parsing of filters and printing them as SQL conditions.
  * Supports three types of statements
@@ -33,6 +42,7 @@ export declare class OINODbSqlFilter {
     private static _booleanOperationRegex;
     private static _negationRegex;
     private static _filterComparisonRegex;
+    private static _filterNullCheckRegex;
     private _leftSide;
     private _rightSide;
     private _operator;
@@ -42,7 +52,7 @@ export declare class OINODbSqlFilter {
      * @param operation operation of the filter, either `OINODbSqlComparison` or `OINODbSqlBooleanOperation`
      * @param rightSide right side of the filter, either another filter or a value
      */
-    constructor(leftSide: OINODbSqlFilter | string, operation: OINODbSqlComparison | OINODbSqlBooleanOperation | null, rightSide: OINODbSqlFilter | string);
+    constructor(leftSide: OINODbSqlFilter | string, operation: OINODbSqlComparison | OINODbSqlBooleanOperation | OINODbSqlNullCheck | null, rightSide: OINODbSqlFilter | string);
     /**
      * Constructor for `OINODbSqlFilter` as parser of http parameter.
      *
@@ -50,6 +60,7 @@ export declare class OINODbSqlFilter {
      * - comparison: (field)-lt|le|eq|ge|gt|like(value)
      * - negation: -not(filter)
      * - conjunction/disjunction: (filter)-and|or(filter)
+     * - null check: -isnull(field) or -isnotnull(field)
      *
      * @param filterString string representation of filter from HTTP-request
      *
@@ -64,6 +75,29 @@ export declare class OINODbSqlFilter {
      *
      */
     static combine(leftSide: OINODbSqlFilter | undefined, operation: OINODbSqlBooleanOperation, rightSide: OINODbSqlFilter | undefined): OINODbSqlFilter | undefined;
+    /**
+     * Combine two filters with an AND operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static and(leftSide: OINODbSqlFilter, rightSide: OINODbSqlFilter): OINODbSqlFilter | undefined;
+    /**
+     * Combine two filters with an OR operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static or(leftSide: OINODbSqlFilter, rightSide: OINODbSqlFilter): OINODbSqlFilter | undefined;
+    /**
+     * Negate a filter with a NOT operation.
+     *
+     * @param leftSide left side filter
+     *
+     */
+    static not(leftSide: OINODbSqlFilter): OINODbSqlFilter | undefined;
     private _operatorToSql;
     /**
      * Does filter contain any valid conditions.

package/dist/types/index.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import { OINOContentType } from "@oino-ts/common";
 export { OINOContentType };
 export { OINO_ERROR_PREFIX, OINO_WARNING_PREFIX, OINO_INFO_PREFIX, OINO_DEBUG_PREFIX, OINOStr, OINOBenchmark, OINOMemoryBenchmark, OINOLog, OINOLogLevel, OINOConsoleLog, OINOResult, OINOHttpResult, OINOHtmlTemplate } from "@oino-ts/common";
@@ -11,7 +9,7 @@ export { OINODbDataModel } from "./OINODbDataModel.js";
 export { OINODbModelSet } from "./OINODbModelSet.js";
 export { OINODbDataField, OINOBooleanDataField, OINONumberDataField, OINOStringDataField, OINOBlobDataField, OINODatetimeDataField } from "./OINODbDataField.js";
 export { OINODbDataSet, OINODbMemoryDataSet, OINODb } from "./OINODb.js";
-export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect } from "./OINODbSqlParams.js";
+export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect, OINODbSqlNullCheck } from "./OINODbSqlParams.js";
 export { OINODbConfig } from "./OINODbConfig.js";
 export { OINODbFactory } from "./OINODbFactory.js";
 export { OINODbSwagger } from "./OINODbSwagger.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oino-ts/db",
-  "version": "0.13.4",
+  "version": "0.14.1",
   "description": "OINO TS library package for publishing an SQL database tables as a REST API.",
   "author": "Matias Kiviniemi (pragmatta)",
   "license": "MPL-2.0",
@@ -19,11 +19,11 @@
   "module": "./dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
   "dependencies": {
-    "@oino-ts/common": "0.13.4",
+    "@oino-ts/common": "0.14.1",
     "oino-ts": "file:.."
   },
   "devDependencies": {
-    "@oino-ts/types": "0.13.4",
+    "@oino-ts/types": "0.14.1",
     "@types/bun": "^1.1.14",
     "@types/node": "^20.14.10",
     "typescript": "~5.9.0"

package/src/OINODbApi.test.ts

@@ -6,7 +6,7 @@
 
 import { expect, test } from "bun:test";
 
-import { OINODbApi, OINODbApiParams, OINOContentType, OINODataRow, OINODbDataField, OINOStringDataField, OINODb, OINODbFactory, OINODbParams, OINODbMemoryDataSet, OINODbModelSet, OINOBenchmark, OINOConsoleLog, OINODbSqlFilter, OINODbConfig, OINODbSqlOrder, OINOLogLevel, OINOLog, OINODbSqlLimit, OINODbApiResult, OINODbSqlComparison, OINONumberDataField, OINODatetimeDataField, OINODbApiRequestParams, OINODbHtmlTemplate, OINODbParser } from "./index.js";
+import { OINODbApi, OINODbApiParams, OINOContentType, OINODataRow, OINODbDataField, OINOStringDataField, OINODb, OINODbFactory, OINODbParams, OINODbMemoryDataSet, OINODbModelSet, OINOBenchmark, OINOConsoleLog, OINODbSqlFilter, OINODbConfig, OINODbSqlOrder, OINOLogLevel, OINOLog, OINODbSqlLimit, OINODbApiResult, OINODbSqlComparison, OINONumberDataField, OINODatetimeDataField, OINODbApiRequestParams, OINODbHtmlTemplate, OINODbParser, OINODbSqlBooleanOperation } from "./index.js";
 
 import { OINODbBunSqlite } from "@oino-ts/db-bunsqlite"
 import { OINODbPostgresql } from "@oino-ts/db-postgresql"
@@ -40,7 +40,13 @@ const API_TESTS:OINOTestParams[] = [
         name: "API 1",
         apiParams: { apiName: "Orders", tableName: "Orders" },
         requestParams: {
-            sqlParams: { filter: OINODbSqlFilter.parse("(ShipPostalCode)-like(0502%)"), order: OINODbSqlOrder.parse("ShipPostalCode-,Freight+"), limit: OINODbSqlLimit.parse("5 page 2") }
+            sqlParams: { filter: OINODbSqlFilter.and(
+                    OINODbSqlFilter.parse("(ShipPostalCode)-like(0502%)"), 
+                    OINODbSqlFilter.parse("-isnull(ShipRegion)")
+                ), 
+                order: OINODbSqlOrder.parse("ShipPostalCode-,Freight+"), 
+                limit: OINODbSqlLimit.parse("5 page 2") 
+            }
         },
         postRow: [30000,"CACTU",1,new Date("2024-04-05"),new Date("2024-04-06"),new Date("2024-04-07"),2,"184.75","a'b\"c%d_e\tf\rg\nh\\i","Garden House Crowther Way","Cowes","British Isles","PO31 7PJ","UK"],
         putRow: [30000,"CACTU",1,new Date("2023-04-05"),new Date("2023-04-06"),new Date("2023-04-07"),2,"847.51","k'l\"m%n_o\tp\rq\nr\\s","59 rue de l'Abbaye","Cowes2","Western Europe","PO31 8PJ","UK"]
@@ -49,7 +55,13 @@ const API_TESTS:OINOTestParams[] = [
         name: "API 2",
         apiParams: { apiName: "Products", tableName: "Products", failOnOversizedValues: true },
         requestParams: {
-            sqlParams: { filter: OINODbSqlFilter.parse("(UnitsInStock)-le(5)"), order: OINODbSqlOrder.parse("UnitsInStock,UnitPrice"), limit: OINODbSqlLimit.parse("7") }
+            sqlParams: { filter: OINODbSqlFilter.and(
+                    OINODbSqlFilter.parse("(UnitsInStock)-le(5)"), 
+                    OINODbSqlFilter.parse("(UnitsInStock)-ne(4)"),
+                ), 
+                order: OINODbSqlOrder.parse("UnitsInStock,UnitPrice"), 
+                limit: OINODbSqlLimit.parse("7") 
+            }
         },
         postRow: [99, "Umeshu", 1, 1, "500 ml", 12.99, 2, 0, 20, 0],
         putRow: [99, "Umeshu", 1, 1, undefined, 24.99, 3, 0, 20, 0]

package/src/OINODbSqlParams.ts

@@ -18,7 +18,14 @@ export enum OINODbSqlBooleanOperation { and = "and", or = "or", not = "not" }
  * Supported logical conjunctions in filter predicates.
  * @enum
  */
-export enum OINODbSqlComparison { lt = "lt", le = "le", eq = "eq", ge = "ge", gt = "gt", like = "like" } 
+export enum OINODbSqlComparison { lt = "lt", le = "le", eq = "eq", ne = "ne", ge = "ge", gt = "gt", like = "like" } 
+
+/**
+ * Supported logical conjunctions in filter predicates.
+ * @enum
+ */
+export enum OINODbSqlNullCheck { isnull = "isnull", isnotnull = "isnotnull" } 
+
 
 /**
  * Class for recursively parsing of filters and printing them as SQL conditions. 
@@ -31,12 +38,13 @@ export enum OINODbSqlComparison { lt = "lt", le = "le", eq = "eq", ge = "ge", gt
  */
 export class OINODbSqlFilter {
     private static _booleanOperationRegex = /^\s?\-(and|or)\s?$/i
-    private static _negationRegex = /^-(not|)\((.+)\)$/i
-    private static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i
+    private static _negationRegex = /^-(not)\((.+)\)$/i
+    private static _filterComparisonRegex = /^\(([^'"\(\)]+)\)\s?\-(lt|le|eq|ne|ge|gt|like)\s?\(([^'"\(\)]+)\)$/i
+    private static _filterNullCheckRegex = /^-(isnull|isnotnull)\((.+)\)$/i
     
     private _leftSide: OINODbSqlFilter | string
     private _rightSide: OINODbSqlFilter | string
-    private _operator:OINODbSqlComparison|OINODbSqlBooleanOperation|null
+    private _operator:OINODbSqlComparison|OINODbSqlBooleanOperation|OINODbSqlNullCheck|null
 
     /**
      * Constructor of `OINODbSqlFilter`
@@ -44,11 +52,12 @@ export class OINODbSqlFilter {
      * @param operation operation of the filter, either `OINODbSqlComparison` or `OINODbSqlBooleanOperation`
      * @param rightSide right side of the filter, either another filter or a value
      */
-    constructor(leftSide:OINODbSqlFilter|string, operation:OINODbSqlComparison|OINODbSqlBooleanOperation|null, rightSide:OINODbSqlFilter|string) {
+    constructor(leftSide:OINODbSqlFilter|string, operation:OINODbSqlComparison|OINODbSqlBooleanOperation|OINODbSqlNullCheck|null, rightSide:OINODbSqlFilter|string) {
         if (!(
             ((operation === null) && (leftSide == "") && (rightSide == "")) ||
             ((operation !== null) && (Object.values(OINODbSqlComparison).includes(operation as OINODbSqlComparison)) && (typeof(leftSide) == "string") && (leftSide != "") && (typeof(rightSide) == "string") && (rightSide != "")) ||
             ((operation == OINODbSqlBooleanOperation.not) && (leftSide == "") && (rightSide instanceof OINODbSqlFilter)) ||
+            (((operation == OINODbSqlNullCheck.isnull) || (operation == OINODbSqlNullCheck.isnotnull)) && (typeof(leftSide) == "string") && (rightSide == "")) ||
             (((operation == OINODbSqlBooleanOperation.and) || (operation == OINODbSqlBooleanOperation.or)) && (leftSide instanceof OINODbSqlFilter) && (rightSide instanceof OINODbSqlFilter))
         )) {
             OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Unsupported OINODbSqlFilter format", {leftSide:leftSide, operation:operation, rightSide:rightSide})
@@ -66,6 +75,7 @@ export class OINODbSqlFilter {
      * - comparison: (field)-lt|le|eq|ge|gt|like(value)
      * - negation: -not(filter)
      * - conjunction/disjunction: (filter)-and|or(filter)
+     * - null check: -isnull(field) or -isnotnull(field)
      * 
      * @param filterString string representation of filter from HTTP-request
      *
@@ -76,20 +86,28 @@ export class OINODbSqlFilter {
 
         } else {
             let match = OINODbSqlFilter._filterComparisonRegex.exec(filterString)
-            if (match != null) {
+            if ((match != null) && (match.length == 4)) {
                 return new OINODbSqlFilter(match[1], match[2].toLowerCase() as OINODbSqlComparison, match[3])
+
             } else {
                 let match = OINODbSqlFilter._negationRegex.exec(filterString)
                 if (match != null) {
                     return new OINODbSqlFilter("", OINODbSqlBooleanOperation.not, OINODbSqlFilter.parse(match[3]))
+
                 } else {
                     let boolean_parts = OINOStr.splitByBrackets(filterString, true, false, '(', ')')
                     if (boolean_parts.length == 3 && (boolean_parts[1].match(OINODbSqlFilter._booleanOperationRegex))) {
                         return new OINODbSqlFilter(OINODbSqlFilter.parse(boolean_parts[0]), boolean_parts[1].trim().toLowerCase().substring(1) as OINODbSqlBooleanOperation, OINODbSqlFilter.parse(boolean_parts[2]))
-        
+
                     } else {
-                        OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", {filterString:filterString})
-                        throw new Error(OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'") // invalid filter could be a security risk, stop processing
+                        let match = OINODbSqlFilter._filterNullCheckRegex.exec(filterString)
+                        if ((match != null)) {
+                            return new OINODbSqlFilter(match[2], match[1].toLowerCase() as OINODbSqlComparison, "")
+
+                        } else {
+                            OINOLog.error("@oino-ts/db", "OINODbSqlFilter", "constructor", "Invalid filter", {filterString:filterString})
+                            throw new Error(OINO_ERROR_PREFIX + ": Invalid filter '" + filterString + "'") // invalid filter could be a security risk, stop processing
+                        }
                     }                
                 }            
             }
@@ -119,6 +137,53 @@ export class OINODbSqlFilter {
         }
     }
 
+    /**
+     * Combine two filters with an AND operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static and(leftSide:OINODbSqlFilter, rightSide:OINODbSqlFilter):OINODbSqlFilter|undefined {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.and, rightSide)
+
+        } else {
+            return undefined
+        }
+    }
+
+    /**
+     * Combine two filters with an OR operation.
+     *
+     * @param leftSide left side filter
+     * @param rightSide right side filter
+     *
+     */
+    static or(leftSide:OINODbSqlFilter, rightSide:OINODbSqlFilter):OINODbSqlFilter|undefined {
+        if ((leftSide) && (!leftSide.isEmpty()) && (rightSide) && (!rightSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.or, rightSide)
+
+        } else {
+            return undefined
+        }
+    }
+
+    /**
+     * Negate a filter with a NOT operation.
+     *
+     * @param leftSide left side filter
+     *
+     */
+    static not(leftSide:OINODbSqlFilter):OINODbSqlFilter|undefined {
+        if ((leftSide) && (!leftSide.isEmpty())) {
+            return new OINODbSqlFilter(leftSide, OINODbSqlBooleanOperation.not, "")
+
+        } else {
+            return undefined
+        }
+    }
+
 
     private _operatorToSql():string {
         switch (this._operator) {
@@ -128,9 +193,12 @@ export class OINODbSqlFilter {
             case "lt": return " < "
             case "le": return " <= "
             case "eq": return " = "
+            case "ne": return " != "
             case "ge": return " >= "
             case "gt": return " > "
             case "like": return " LIKE "
+            case "isnull": return " IS NULL"
+            case "isnotnull": return " IS NOT NULL"
         }
         return " "
     }
@@ -168,6 +236,8 @@ export class OINODbSqlFilter {
         result += this._operatorToSql()
         if (this._rightSide instanceof OINODbSqlFilter) {
             result += this._rightSide.toSql(dataModel)
+        } else if (this._operator == OINODbSqlNullCheck.isnull || this._operator == OINODbSqlNullCheck.isnotnull) {
+            // nothing to do, IS NULL and IS NOT NULL do not have a right side
         } else {
             const value = field!.deserializeCell(this._rightSide)
             if ((value == null) || (value === "")) {

package/src/index.ts

@@ -12,7 +12,7 @@ export { OINODbDataModel } from "./OINODbDataModel.js"
 export { OINODbModelSet } from "./OINODbModelSet.js"
 export { OINODbDataField, OINOBooleanDataField, OINONumberDataField, OINOStringDataField, OINOBlobDataField, OINODatetimeDataField } from "./OINODbDataField.js"
 export { OINODbDataSet, OINODbMemoryDataSet, OINODb } from "./OINODb.js"
-export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect } from "./OINODbSqlParams.js"
+export { OINODbSqlFilter, OINODbSqlOrder, OINODbSqlComparison, OINODbSqlLimit, OINODbSqlBooleanOperation, OINODbSqlAggregate, OINODbSqlAggregateFunctions, OINODbSqlSelect, OINODbSqlNullCheck } from "./OINODbSqlParams.js"
 export { OINODbConfig } from "./OINODbConfig.js"
 export { OINODbFactory } from "./OINODbFactory.js"
 export { OINODbSwagger } from "./OINODbSwagger.js"