@nxtedition/lib 28.0.5 → 28.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxtedition/lib",
-  "version": "28.0.5",
+  "version": "28.0.6",
   "license": "UNLICENSED",
   "author": "Robert Nagy <robert.nagy@boffins.se>",
   "type": "module",
@@ -92,5 +92,5 @@
     "pino": ">=7.0.0",
     "rxjs": "^7.0.0"
   },
-  "gitHead": "f778b4c525a240411f681137d8dd0fe19031c7b0"
+  "gitHead": "008526f8d31968edaa2e642998deaa3880a34bb8"
 }

package/sequence.js

@@ -26,14 +26,14 @@ export class Sequence {
   #identity
   #count = 0
 
-  // TODO (perf): Optimize
   /**
    *
    * @param {string|Sequence|null|undefined} a
    * @param {string|Sequence|null|undefined} b
    * @param {boolean} [strict=true]
-   * @returns
+   * @returns {-1|0|1}
    */
+  /** @deprecated */
   static compare(a, b, strict) {
     if (!a && !b) {
       return 0
@@ -58,6 +58,17 @@ export class Sequence {
     return a.compare(b, strict)
   }
 
+  /**
+   *
+   * @param {string|Sequence|null|undefined} a
+   * @param {string|Sequence|null|undefined} b
+   * @param {boolean} [strict=true]
+   * @returns {boolean}
+   */
+  static has(a, b, strict) {
+    return Sequence.compare(a, b, strict) >= 0
+  }
+
   /**
    *
    * @param {string} seq
@@ -75,6 +86,10 @@ export class Sequence {
     }
   }
 
+  /**
+   * @param {null|undefined|string|Sequence|Array<string|number|{id:string,sequence:number}>>} value
+   * @param {null|undefined|number|Array<string|{id:string}>>} [identity]
+   */
   constructor(value, identity) {
     try {
       if (!value) {
@@ -174,6 +189,9 @@ export class Sequence {
     }
   }
 
+  /**
+   * @returns {number}
+   */
   get identity() {
     if (this.#identity == null) {
       if (this.#parts.length === 0) {
@@ -190,6 +208,9 @@ export class Sequence {
     return this.#identity
   }
 
+  /**
+   * @returns {number}
+   */
   get count() {
     if (this.#count == null) {
       let count = 0
@@ -201,10 +222,17 @@ export class Sequence {
     return this.#count
   }
 
+  /**
+   * @returns {number}
+   */
   get length() {
     return this.#parts.length / 2
   }
 
+  /**
+   * @param {number} index
+   * @returns {number}
+   */
   at(index) {
     if (!Number.isInteger(index)) {
       throw new TypeError('index must be an integer')
@@ -216,6 +244,10 @@ export class Sequence {
     return this.#parts[index * 2 + 1]
   }
 
+  /**
+   * @param {number} index
+   * @param {number} sequence
+   */
   set(index, sequence) {
     if (!Number.isInteger(index)) {
       throw new TypeError('index must be an integer')
@@ -236,6 +268,7 @@ export class Sequence {
     }
   }
 
+  /** @deprecated */
   compare(other, strict) {
     if (strict === undefined) {
       strict = true
@@ -256,7 +289,7 @@ export class Sequence {
       throw new TypeError('strict must be a boolean')
     }
 
-    if (strict && other.identity && this.identity && other.identity !== this.identity) {
+    if (strict && (other.identity || this.identity) && other.identity !== this.identity) {
       throw new Error('Cannot compare sequences with different identities')
     }
 
@@ -273,6 +306,19 @@ export class Sequence {
     return 0
   }
 
+  /**
+   *
+   * @param {string|Sequence|null|undefined} other
+   * @param {boolean} [strict=true]
+   * @returns {boolean}
+   */
+  has(other, strict = true) {
+    return this.compare(other, strict) >= 0
+  }
+
+  /**
+   * @returns {string}
+   */
   toString() {
     if (!this.#value) {
       let count = 0
@@ -286,10 +332,16 @@ export class Sequence {
     return this.#value
   }
 
+  /**
+   * @returns {string}
+   */
   [Symbol.toStringTag]() {
     return this.toString()
   }
 
+  /**
+   * @returns {string}
+   */
   [util.inspect.custom](depth, options, inspect) {
     return `Sequence: "${this.toString()}"`
   }