@shko.online/dataverse-odata 0.1.6 → 0.2.1

package/lib/modern/getFilterFromParser.js

@@ -1,5 +1,234 @@
 import { atMostOnce } from './validators/atMostOnce';
+import { hasContent } from './validators/hasContent';
 const option = '$filter';
+const STANDARD_OPERATORS = ['eq', 'ne', 'gt', 'ge', 'lt', 'le'];
+const QUERY_FUNCTION_OPERATORS = ['contains', 'endswith', 'startswith'];
+function isStandardOperator(s) {
+  return STANDARD_OPERATORS.includes(s);
+}
+function isQueryFunctionOperator(s) {
+  return QUERY_FUNCTION_OPERATORS.includes(s);
+}
+const GUID_REGEX = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/;
+function tokenize(input) {
+  const tokens = [];
+  let i = 0;
+  while (i < input.length) {
+    var _input;
+    if (/\s/.test(input[i])) {
+      i++;
+      continue;
+    }
+    if (input[i] === '(') {
+      tokens.push({
+        type: 'lparen',
+        value: '('
+      });
+      i++;
+    } else if (input[i] === ')') {
+      tokens.push({
+        type: 'rparen',
+        value: ')'
+      });
+      i++;
+    } else if (input[i] === ',') {
+      tokens.push({
+        type: 'comma',
+        value: ','
+      });
+      i++;
+    } else if (input[i] === "'") {
+      let j = i + 1;
+      let str = '';
+      while (j < input.length) {
+        if (input[j] === "'" && j + 1 < input.length && input[j + 1] === "'") {
+          str += "'";
+          j += 2;
+        } else if (input[j] === "'") {
+          break;
+        } else {
+          str += input[j];
+          j++;
+        }
+      }
+      tokens.push({
+        type: 'string',
+        value: str
+      });
+      i = j + 1;
+    } else if (/[0-9a-fA-F]/.test(input[i]) && GUID_REGEX.test(input.slice(i))) {
+      tokens.push({
+        type: 'string',
+        value: input.slice(i, i + 36)
+      });
+      i += 36;
+    } else if (/\d/.test(input[i]) || input[i] === '-' && /\d/.test((_input = input[i + 1]) !== null && _input !== void 0 ? _input : '')) {
+      let j = i;
+      if (input[j] === '-') j++;
+      while (j < input.length && /[0-9.]/.test(input[j])) j++;
+      tokens.push({
+        type: 'number',
+        value: input.slice(i, j)
+      });
+      i = j;
+    } else if (/[a-zA-Z_]/.test(input[i])) {
+      let j = i;
+      while (j < input.length && /\w/.test(input[j])) j++;
+      tokens.push({
+        type: 'word',
+        value: input.slice(i, j)
+      });
+      i = j;
+    } else {
+      i++;
+    }
+  }
+  return tokens;
+}
+class FilterParser {
+  constructor(tokens) {
+    this.tokens = void 0;
+    this.pos = 0;
+    this.tokens = tokens;
+  }
+  peek() {
+    var _this$tokens$this$pos;
+    return (_this$tokens$this$pos = this.tokens[this.pos]) !== null && _this$tokens$this$pos !== void 0 ? _this$tokens$this$pos : null;
+  }
+  consume(expected) {
+    const token = this.tokens[this.pos++];
+    const expectedString = expected ? `, expected ${expected}` : '';
+    if (!token) throw new Error(`Unexpected end of filter expression${expectedString}`);
+    return token;
+  }
+  expect(type, value) {
+    const valueString = value ? ` '${value}'` : '';
+    const token = this.consume(`${type}${valueString}`);
+    if (token.type !== type || value !== undefined && token.value !== value) {
+      throw new Error(`Expected ${type}${valueString} but got ${token.type} '${token.value}'`);
+    }
+    return token;
+  }
+  parse() {
+    const expr = this.parseOr();
+    if (this.pos < this.tokens.length) {
+      throw new Error(`Unexpected token '${this.tokens[this.pos].value}'`);
+    }
+    return expr;
+  }
+  parseOr() {
+    let left = this.parseAnd();
+    while (((_this$peek = this.peek()) === null || _this$peek === void 0 ? void 0 : _this$peek.value) === 'or') {
+      var _this$peek;
+      this.consume();
+      const right = this.parseAnd();
+      left = {
+        operator: 'or',
+        left,
+        right
+      };
+    }
+    return left;
+  }
+  parseAnd() {
+    let left = this.parseNot();
+    while (((_this$peek2 = this.peek()) === null || _this$peek2 === void 0 ? void 0 : _this$peek2.value) === 'and') {
+      var _this$peek2;
+      this.consume();
+      const right = this.parseNot();
+      left = {
+        operator: 'and',
+        left,
+        right
+      };
+    }
+    return left;
+  }
+  parseNot() {
+    var _this$peek3;
+    if (((_this$peek3 = this.peek()) === null || _this$peek3 === void 0 ? void 0 : _this$peek3.value) === 'not') {
+      this.consume();
+      const right = this.parseNot();
+      return {
+        operator: 'not',
+        right
+      };
+    }
+    return this.parsePrimary();
+  }
+  parsePrimary() {
+    const token = this.peek();
+    if (!token) throw new Error('Unexpected end of filter expression');
+    if (token.type === 'lparen') {
+      this.consume();
+      const expr = this.parseOr();
+      this.expect('rparen');
+      return expr;
+    }
+    if (token.type === 'word' && isQueryFunctionOperator(token.value.toLowerCase())) {
+      const func = this.consume().value.toLowerCase();
+      this.expect('lparen');
+      const left = this.expect('word').value;
+      this.expect('comma');
+      const right = this.expect('string').value;
+      this.expect('rparen');
+      return {
+        operator: func,
+        left,
+        right
+      };
+    }
+    if (token.type === 'word') {
+      const left = this.consume().value;
+      const opToken = this.consume(`a comparison operator`);
+      if (!isStandardOperator(opToken.value.toLowerCase())) {
+        throw new Error(`Invalid operator '${opToken.value}'`);
+      }
+      const operator = opToken.value.toLowerCase();
+      const right = this.consume(`a value or column name`);
+      if (right.type === 'string') {
+        return {
+          operator,
+          left,
+          right: right.value
+        };
+      } else if (right.type === 'number') {
+        return {
+          operator,
+          left,
+          right: Number(right.value)
+        };
+      } else if (right.type === 'word') {
+        // Constant keywords stay as StandardOperator; bare identifiers are column comparisons
+        const BOOL_CONSTANTS = ['true', 'false'];
+        if (BOOL_CONSTANTS.includes(right.value.toLowerCase())) {
+          return {
+            operator,
+            left,
+            isBooleanOperation: true,
+            right: right.value === 'true'
+          };
+        } else if (right.value.toLowerCase() === 'null') {
+          return {
+            operator,
+            left,
+            isNullOperation: true,
+            right: null
+          };
+        }
+        return {
+          left,
+          operator,
+          isColumnOperation: true,
+          right: right.value
+        };
+      } else {
+        throw new Error(`Invalid right-hand side value of type '${right.type}' in filter expression`);
+      }
+    }
+    throw new Error(`Unexpected token '${token.value}'`);
+  }
+}
 
 /**
  * Parses the {@link ODataFilter.$filter $filter} query
@@ -10,15 +239,19 @@ export const getFilterFromParser = (parser, result) => {
   if (value.length === 0) {
     return true;
   }
-  if (!atMostOnce(option, value, result)) {
+  if (!atMostOnce(option, value, result) || !hasContent(option, value, result)) {
     return false;
   }
-  if (value.length > 0) {
-    result.$filter = {
-      operator: 'eq',
-      left: '',
-      right: ''
+  try {
+    const tokens = tokenize(value[0]);
+    const p = new FilterParser(tokens);
+    result.$filter = p.parse();
+  } catch (e) {
+    result.error = {
+      code: '0x80060888',
+      message: `Syntax error in '$filter': ${e.message}`
     };
+    return false;
   }
   return true;
 };

package/lib/modern/index.js

@@ -1,9 +1,9 @@
+export { getAliasedProperty } from './getAliasedProperty';
 export { getExpandFromParser } from './getExpandFromParser';
 export { getFetchXmlFromParser } from './getFetchXmlFromParser';
+export { getFilterFromParser } from './getFilterFromParser';
 export { getOrderByFromParser } from './getOrderByFromParser';
 export { getSelectFromParser } from './getSelectFromParser';
 export { getTopFromParser } from './getTopFromParser';
 export { getXQueryFromParser } from './getXQueryFromParser';
-export { parseOData } from './parseOData';
-import { parseOData } from './parseOData';
-export default parseOData;
+export { parseOData, parseOData as default } from './parseOData';

package/lib/ts3.4/OData.types.d.ts

@@ -33,7 +33,7 @@ interface ODataFilter {
      */
     $filter?: FilterOperator;
 }
-type FilterOperator = StandardOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator;
+type FilterOperator = StandardOperator | BooleanColumnOperator | NullOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator;
 interface ODataFetch {
     /**
      * You can compose a FetchXML query for a specific table.
@@ -101,9 +101,40 @@ type StandardOperators = StandardEqualityOperators | 'gt' | 'ge' | 'lt' | 'le';
  * * Microsoft Docs: {@link https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query/filter-rows#column-comparison Column comparison }
  */
 interface ColumnOperator {
-    column: string;
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
     operator: StandardOperators;
-    otherColumn: string;
+    isColumnOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: string;
+}
+interface BooleanColumnOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isBooleanOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: boolean;
+}
+interface NullOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isNullOperation: true;
+    /**
+     * The right side of the 'X' operator must be null.
+     */
+    right: null;
 }
 interface StandardOperator {
     operator: StandardOperators;
@@ -138,4 +169,4 @@ interface BinaryOperator {
     right: FilterOperator;
 }
 type ODataQuery = ODataError & ODataExpand & ODataFetch & ODataFilter & ODataOrderBy & ODataSavedQuery & ODataSelect & ODataTop & ODataUserQuery;
-export { BinaryOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, StandardOperator, StandardOperators, UnaryOperator, };
+export { BinaryOperator, ColumnOperator, FilterOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, QueryFunctionOperator, QueryFunctionOperators, StandardOperator, StandardOperators, UnaryOperator, };

package/lib/ts3.4/index.d.ts

@@ -1,11 +1,11 @@
-export { BinaryOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataQuery, ODataSelect, ODataTop, StandardOperator, StandardOperators, } from './OData.types';
+export { BinaryOperator, ColumnOperator, FilterOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, QueryFunctionOperator, QueryFunctionOperators, StandardOperator, StandardOperators, UnaryOperator, } from './OData.types';
+export { getAliasedProperty } from './getAliasedProperty';
 export { getExpandFromParser } from './getExpandFromParser';
 export { getFetchXmlFromParser } from './getFetchXmlFromParser';
+export { getFilterFromParser } from './getFilterFromParser';
 export { getOrderByFromParser } from './getOrderByFromParser';
 export { getSelectFromParser } from './getSelectFromParser';
 export { getTopFromParser } from './getTopFromParser';
 export { getXQueryFromParser } from './getXQueryFromParser';
-export { parseOData } from './parseOData';
-import { parseOData } from './parseOData';
-export default parseOData;
+export { parseOData, parseOData as default } from './parseOData';
 //# sourceMappingURL=index.d.ts.map

package/lib/ts3.9/OData.types.d.ts

@@ -33,7 +33,7 @@ interface ODataFilter {
      */
     $filter?: FilterOperator;
 }
-type FilterOperator = StandardOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator;
+type FilterOperator = StandardOperator | BooleanColumnOperator | NullOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator;
 interface ODataFetch {
     /**
      * You can compose a FetchXML query for a specific table.
@@ -101,9 +101,40 @@ type StandardOperators = StandardEqualityOperators | 'gt' | 'ge' | 'lt' | 'le';
  * * Microsoft Docs: {@link https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query/filter-rows#column-comparison Column comparison }
  */
 interface ColumnOperator {
-    column: string;
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
     operator: StandardOperators;
-    otherColumn: string;
+    isColumnOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: string;
+}
+interface BooleanColumnOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isBooleanOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: boolean;
+}
+interface NullOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isNullOperation: true;
+    /**
+     * The right side of the 'X' operator must be null.
+     */
+    right: null;
 }
 interface StandardOperator {
     operator: StandardOperators;
@@ -138,4 +169,4 @@ interface BinaryOperator {
     right: FilterOperator;
 }
 type ODataQuery = ODataError & ODataExpand & ODataFetch & ODataFilter & ODataOrderBy & ODataSavedQuery & ODataSelect & ODataTop & ODataUserQuery;
-export type { BinaryOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, StandardOperator, StandardOperators, UnaryOperator, };
+export type { BinaryOperator, ColumnOperator, FilterOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, QueryFunctionOperator, QueryFunctionOperators, StandardOperator, StandardOperators, UnaryOperator, };

package/lib/ts3.9/index.d.ts

@@ -1,11 +1,11 @@
-export type { BinaryOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataQuery, ODataSelect, ODataTop, StandardOperator, StandardOperators, } from './OData.types';
+export type { BinaryOperator, ColumnOperator, FilterOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, QueryFunctionOperator, QueryFunctionOperators, StandardOperator, StandardOperators, UnaryOperator, } from './OData.types';
+export { getAliasedProperty } from './getAliasedProperty';
 export { getExpandFromParser } from './getExpandFromParser';
 export { getFetchXmlFromParser } from './getFetchXmlFromParser';
+export { getFilterFromParser } from './getFilterFromParser';
 export { getOrderByFromParser } from './getOrderByFromParser';
 export { getSelectFromParser } from './getSelectFromParser';
 export { getTopFromParser } from './getTopFromParser';
 export { getXQueryFromParser } from './getXQueryFromParser';
-export { parseOData } from './parseOData';
-import { parseOData } from './parseOData';
-export default parseOData;
+export { parseOData, parseOData as default } from './parseOData';
 //# sourceMappingURL=index.d.ts.map

package/lib/ts4.2/OData.types.d.ts

@@ -37,7 +37,14 @@ interface ODataFilter {
     $filter?: FilterOperator;
 }
 
-type FilterOperator = StandardOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator; 
+type FilterOperator =
+    | StandardOperator
+    | BooleanColumnOperator
+    | NullOperator
+    | ColumnOperator
+    | UnaryOperator
+    | BinaryOperator
+    | QueryFunctionOperator;
 
 interface ODataFetch {
     /**
@@ -107,15 +114,47 @@ type StandardEqualityOperators = 'eq' | 'ne';
 type StandardOperators = StandardEqualityOperators | 'gt' | 'ge' | 'lt' | 'le';
 
 /**
- * 
+ *
  * * Microsoft Docs: {@link https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query/filter-rows#column-comparison Column comparison }
  */
 interface ColumnOperator {
-    column: string;
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isColumnOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: string;
+}
+
+interface BooleanColumnOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
     operator: StandardOperators;
-    otherColumn: string;
+    isBooleanOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: boolean;
 }
 
+interface NullOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isNullOperation: true;
+    /**
+     * The right side of the 'X' operator must be null.
+     */
+    right: null;
+}
 
 interface StandardOperator {
     operator: StandardOperators;
@@ -166,6 +205,8 @@ type ODataQuery = ODataError &
 
 export type {
     BinaryOperator,
+    ColumnOperator,
+    FilterOperator,
     ODataError,
     ODataExpand,
     ODataExpandQuery,
@@ -177,7 +218,9 @@ export type {
     ODataSelect,
     ODataTop,
     ODataUserQuery,
+    QueryFunctionOperator,
+    QueryFunctionOperators,
     StandardOperator,
     StandardOperators,
-    UnaryOperator,    
+    UnaryOperator,
 };

package/lib/ts4.2/getFilterFromParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFilterFromParser.d.ts","sourceRoot":"","sources":["../../src/getFilterFromParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAK7D;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,eAAe,EAAE,QAAQ,UAAU,KAAG,OAajF,CAAC"}
+{"version":3,"file":"getFilterFromParser.d.ts","sourceRoot":"","sources":["../../src/getFilterFromParser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,eAAe,CAAC;AAyMhE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,eAAe,EAAE,QAAQ,UAAU,KAAG,OAoBjF,CAAC"}

package/lib/ts4.2/index.d.ts

@@ -1,11 +1,11 @@
-export type { BinaryOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataQuery, ODataSelect, ODataTop, StandardOperator, StandardOperators, } from './OData.types';
+export type { BinaryOperator, ColumnOperator, FilterOperator, ODataError, ODataExpand, ODataExpandQuery, ODataFetch, ODataFilter, ODataOrderBy, ODataQuery, ODataSavedQuery, ODataSelect, ODataTop, ODataUserQuery, QueryFunctionOperator, QueryFunctionOperators, StandardOperator, StandardOperators, UnaryOperator, } from './OData.types';
+export { getAliasedProperty } from './getAliasedProperty';
 export { getExpandFromParser } from './getExpandFromParser';
 export { getFetchXmlFromParser } from './getFetchXmlFromParser';
+export { getFilterFromParser } from './getFilterFromParser';
 export { getOrderByFromParser } from './getOrderByFromParser';
 export { getSelectFromParser } from './getSelectFromParser';
 export { getTopFromParser } from './getTopFromParser';
 export { getXQueryFromParser } from './getXQueryFromParser';
-export { parseOData } from './parseOData';
-import { parseOData } from './parseOData';
-export default parseOData;
+export { parseOData, parseOData as default } from './parseOData';
 //# sourceMappingURL=index.d.ts.map

package/lib/ts4.2/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,QAAQ,EACR,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shko.online/dataverse-odata",
-  "version": "0.1.6",
+  "version": "0.2.1",
   "description": "This package will help parse OData strings (only the Microsoft Dataverse subset). It can be used as a validator, or you can build some javascript library which consumes the output of this library.",
   "scripts": {
     "build": "npm run lint && build-npm-package",
@@ -43,8 +43,8 @@
   },
   "homepage": "https://github.com/shko-online/dataverse-odata#readme",
   "devDependencies": {
-    "@babel/cli": "^7.20.7",
-    "@babel/core": "^7.20.12",
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.29.0",
     "@babel/plugin-proposal-class-properties": "^7.18.6",
     "@babel/plugin-proposal-decorators": "^7.20.13",
     "@babel/plugin-proposal-export-default-from": "^7.18.10",
@@ -53,11 +53,11 @@
     "@babel/plugin-proposal-private-property-in-object": "^7.20.5",
     "@babel/plugin-syntax-dynamic-import": "^7.8.3",
     "@babel/plugin-transform-runtime": "^7.19.6",
-    "@babel/preset-env": "^7.20.2",
-    "@babel/preset-flow": "^7.18.6",
-    "@babel/preset-react": "^7.18.6",
-    "@babel/preset-typescript": "^7.18.6",
-    "@emotion/babel-plugin": "^11.10.5",
+    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-flow": "^7.27.1",
+    "@babel/preset-react": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@emotion/babel-plugin": "^11.13.5",
     "@jest/globals": "^29.4.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",

package/src/OData.types.d.ts

@@ -37,7 +37,14 @@ interface ODataFilter {
     $filter?: FilterOperator;
 }
 
-type FilterOperator = StandardOperator | ColumnOperator | UnaryOperator | BinaryOperator | QueryFunctionOperator; 
+type FilterOperator =
+    | StandardOperator
+    | BooleanColumnOperator
+    | NullOperator
+    | ColumnOperator
+    | UnaryOperator
+    | BinaryOperator
+    | QueryFunctionOperator;
 
 interface ODataFetch {
     /**
@@ -107,15 +114,47 @@ type StandardEqualityOperators = 'eq' | 'ne';
 type StandardOperators = StandardEqualityOperators | 'gt' | 'ge' | 'lt' | 'le';
 
 /**
- * 
+ *
  * * Microsoft Docs: {@link https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query/filter-rows#column-comparison Column comparison }
  */
 interface ColumnOperator {
-    column: string;
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isColumnOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: string;
+}
+
+interface BooleanColumnOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
     operator: StandardOperators;
-    otherColumn: string;
+    isBooleanOperation: true;
+    /**
+     * The right side of the 'X' operator must be a property of the entity.
+     */
+    right: boolean;
 }
 
+interface NullOperator {
+    /**
+     * The left side of the 'X' operator must be a property of the entity.
+     */
+    left: string;
+    operator: StandardOperators;
+    isNullOperation: true;
+    /**
+     * The right side of the 'X' operator must be null.
+     */
+    right: null;
+}
 
 interface StandardOperator {
     operator: StandardOperators;
@@ -166,6 +205,8 @@ type ODataQuery = ODataError &
 
 export type {
     BinaryOperator,
+    ColumnOperator,
+    FilterOperator,
     ODataError,
     ODataExpand,
     ODataExpandQuery,
@@ -177,7 +218,9 @@ export type {
     ODataSelect,
     ODataTop,
     ODataUserQuery,
+    QueryFunctionOperator,
+    QueryFunctionOperators,
     StandardOperator,
     StandardOperators,
-    UnaryOperator,    
+    UnaryOperator,
 };

package/src/getFetchXmlFromParser.ts

@@ -30,7 +30,7 @@ export const getFetchXmlFromParser = (parser: URLSearchParams, result: ODataQuer
     const entity = fetchXmlDocument
         .evaluate('fetch/entity', fetchXmlDocument, null, XPathResult.ANY_TYPE, null)
         .iterateNext() as Element;
-    if (fetchXmlDocument.documentElement.children.length != 1 || !entity || !entity.getAttribute('name')) {
+    if (fetchXmlDocument.documentElement.children.length != 1 || !entity?.getAttribute('name')) {
         result.error = {
             code: '0x80041102',
             message: 'Entity Name was not specified in FetchXml String.',