@editframe/elements 0.19.4-beta.0 → 0.20.1-beta.0

package/src/utils/LRUCache.ts

@@ -151,3 +151,546 @@ export class SizeAwareLRUCache<K> {
     return this.maxSizeBytes;
   }
 }
+
+/**
+ * Red-Black Tree node colors
+ */
+enum Color {
+  RED = "RED",
+  BLACK = "BLACK",
+}
+
+/**
+ * Red-Black Tree node for ordered key storage
+ */
+class RBTreeNode<K> {
+  constructor(
+    public key: K,
+    public color: Color = Color.RED,
+    public left: RBTreeNode<K> | null = null,
+    public right: RBTreeNode<K> | null = null,
+    public parent: RBTreeNode<K> | null = null,
+  ) {}
+}
+
+/**
+ * Red-Black Tree implementation for O(log n) operations
+ * Supports insert, delete, search, range queries, and nearest neighbor
+ */
+class RedBlackTree<K> {
+  private root: RBTreeNode<K> | null = null;
+  private readonly compareFn: (a: K, b: K) => number;
+
+  constructor(compareFn: (a: K, b: K) => number) {
+    this.compareFn = compareFn;
+  }
+
+  insert(key: K): void {
+    const node = new RBTreeNode(key);
+
+    if (!this.root) {
+      this.root = node;
+      node.color = Color.BLACK;
+      return;
+    }
+
+    this.insertNode(node);
+    this.fixInsert(node);
+  }
+
+  delete(key: K): boolean {
+    const node = this.findNode(key);
+    if (!node) return false;
+
+    this.deleteNode(node);
+    return true;
+  }
+
+  find(key: K): K | null {
+    const node = this.findNode(key);
+    return node ? node.key : null;
+  }
+
+  findNearestInRange(center: K, distance: K): K[] {
+    // Calculate the range bounds
+    const start = this.subtractDistance(center, distance);
+    const end = this.addDistance(center, distance);
+
+    // Use existing range search (O(log n + k))
+    return this.findRange(start, end);
+  }
+
+  private subtractDistance(center: K, distance: K): K {
+    if (typeof center === "number" && typeof distance === "number") {
+      return (center - distance) as K;
+    }
+
+    // For strings, we can't easily subtract distance, so just return center
+    // This means string searches will be exact matches only
+    return center;
+  }
+
+  private addDistance(center: K, distance: K): K {
+    if (typeof center === "number" && typeof distance === "number") {
+      return (center + distance) as K;
+    }
+
+    // For strings, we can't easily add distance, so just return center
+    // This means string searches will be exact matches only
+    return center;
+  }
+
+  findRange(start: K, end: K): K[] {
+    const result: K[] = [];
+    this.inorderRange(this.root, start, end, result);
+    return result;
+  }
+
+  getAllSorted(): K[] {
+    const result: K[] = [];
+    this.inorder(this.root, result);
+    return result;
+  }
+
+  private findNode(key: K): RBTreeNode<K> | null {
+    let current = this.root;
+
+    while (current) {
+      const cmp = this.compareFn(key, current.key);
+      if (cmp === 0) return current;
+      current = cmp < 0 ? current.left : current.right;
+    }
+
+    return null;
+  }
+
+  private insertNode(node: RBTreeNode<K>): void {
+    let parent = null;
+    let current = this.root;
+
+    while (current) {
+      parent = current;
+      const cmp = this.compareFn(node.key, current.key);
+      current = cmp < 0 ? current.left : current.right;
+    }
+
+    node.parent = parent;
+    if (!parent) {
+      this.root = node;
+    } else {
+      const cmp = this.compareFn(node.key, parent.key);
+      if (cmp < 0) {
+        parent.left = node;
+      } else {
+        parent.right = node;
+      }
+    }
+  }
+
+  private fixInsert(node: RBTreeNode<K>): void {
+    while (node.parent && node.parent.color === Color.RED) {
+      if (node.parent === node.parent.parent?.left) {
+        const uncle = node.parent.parent.right;
+
+        if (uncle?.color === Color.RED) {
+          node.parent.color = Color.BLACK;
+          uncle.color = Color.BLACK;
+          node.parent.parent.color = Color.RED;
+          node = node.parent.parent;
+        } else {
+          if (node === node.parent.right) {
+            node = node.parent;
+            this.rotateLeft(node);
+          }
+
+          if (node.parent) {
+            node.parent.color = Color.BLACK;
+            if (node.parent.parent) {
+              node.parent.parent.color = Color.RED;
+              this.rotateRight(node.parent.parent);
+            }
+          }
+        }
+      } else {
+        const uncle = node.parent.parent?.left;
+
+        if (uncle?.color === Color.RED) {
+          node.parent.color = Color.BLACK;
+          uncle.color = Color.BLACK;
+          if (node.parent.parent) {
+            node.parent.parent.color = Color.RED;
+            node = node.parent.parent;
+          }
+        } else {
+          if (node === node.parent.left) {
+            node = node.parent;
+            this.rotateRight(node);
+          }
+
+          if (node.parent) {
+            node.parent.color = Color.BLACK;
+            if (node.parent.parent) {
+              node.parent.parent.color = Color.RED;
+              this.rotateLeft(node.parent.parent);
+            }
+          }
+        }
+      }
+    }
+
+    if (this.root) {
+      this.root.color = Color.BLACK;
+    }
+  }
+
+  private deleteNode(node: RBTreeNode<K>): void {
+    let y = node;
+    let yOriginalColor = y.color;
+    let x: RBTreeNode<K> | null;
+
+    if (!node.left) {
+      x = node.right;
+      this.transplant(node, node.right);
+    } else if (!node.right) {
+      x = node.left;
+      this.transplant(node, node.left);
+    } else {
+      y = this.minimum(node.right);
+      yOriginalColor = y.color;
+      x = y.right;
+
+      if (y.parent === node) {
+        if (x) x.parent = y;
+      } else {
+        this.transplant(y, y.right);
+        y.right = node.right;
+        if (y.right) y.right.parent = y;
+      }
+
+      this.transplant(node, y);
+      y.left = node.left;
+      if (y.left) y.left.parent = y;
+      y.color = node.color;
+    }
+
+    if (yOriginalColor === Color.BLACK && x) {
+      this.fixDelete(x);
+    }
+  }
+
+  private fixDelete(node: RBTreeNode<K>): void {
+    while (node !== this.root && node.color === Color.BLACK) {
+      if (node === node.parent?.left) {
+        let sibling = node.parent.right;
+
+        if (sibling?.color === Color.RED) {
+          sibling.color = Color.BLACK;
+          node.parent.color = Color.RED;
+          this.rotateLeft(node.parent);
+          sibling = node.parent.right;
+        }
+
+        if (
+          sibling?.left?.color !== Color.RED &&
+          sibling?.right?.color !== Color.RED
+        ) {
+          if (sibling) {
+            sibling.color = Color.RED;
+          }
+          node = node.parent;
+        } else {
+          if (sibling?.right?.color !== Color.RED) {
+            if (sibling.left) sibling.left.color = Color.BLACK;
+            sibling.color = Color.RED;
+            this.rotateRight(sibling);
+            sibling = node.parent.right;
+          }
+
+          if (sibling) {
+            sibling.color = node.parent.color;
+            node.parent.color = Color.BLACK;
+            if (sibling.right) sibling.right.color = Color.BLACK;
+            this.rotateLeft(node.parent);
+          }
+          if (!this.root) {
+            throw new Error("Root is null");
+          }
+          node = this.root;
+        }
+      } else {
+        let sibling = node.parent?.left;
+
+        if (sibling?.color === Color.RED) {
+          sibling.color = Color.BLACK;
+          if (node.parent) node.parent.color = Color.RED;
+          if (node.parent) this.rotateRight(node.parent);
+          sibling = node.parent?.left;
+        }
+
+        if (
+          sibling?.right?.color !== Color.RED &&
+          sibling?.left?.color !== Color.RED
+        ) {
+          if (sibling) {
+            sibling.color = Color.RED;
+          }
+          if (node.parent === null) {
+            throw new Error("Node parent is null");
+          }
+          node = node.parent;
+        } else {
+          if (sibling?.left?.color !== Color.RED) {
+            if (sibling.right) sibling.right.color = Color.BLACK;
+            sibling.color = Color.RED;
+            this.rotateLeft(sibling);
+            sibling = node.parent?.left;
+          }
+
+          if (sibling) {
+            sibling.color = node.parent?.color || Color.BLACK;
+            if (node.parent) node.parent.color = Color.BLACK;
+            if (sibling.left) sibling.left.color = Color.BLACK;
+            if (node.parent) this.rotateRight(node.parent);
+          }
+          if (!this.root) {
+            throw new Error("Root is null");
+          }
+          node = this.root;
+        }
+      }
+    }
+
+    node.color = Color.BLACK;
+  }
+
+  private rotateLeft(node: RBTreeNode<K>): void {
+    const rightChild = node.right;
+    if (!rightChild) {
+      throw new Error("Right child is null");
+    }
+    node.right = rightChild.left;
+
+    if (rightChild.left) {
+      rightChild.left.parent = node;
+    }
+
+    rightChild.parent = node.parent;
+
+    if (!node.parent) {
+      this.root = rightChild;
+    } else if (node === node.parent.left) {
+      node.parent.left = rightChild;
+    } else {
+      node.parent.right = rightChild;
+    }
+
+    rightChild.left = node;
+    node.parent = rightChild;
+  }
+
+  private rotateRight(node: RBTreeNode<K>): void {
+    const leftChild = node.left;
+    if (!leftChild) {
+      throw new Error("Left child is null");
+    }
+    node.left = leftChild.right;
+
+    if (leftChild.right) {
+      leftChild.right.parent = node;
+    }
+
+    leftChild.parent = node.parent;
+
+    if (!node.parent) {
+      this.root = leftChild;
+    } else if (node === node.parent.right) {
+      node.parent.right = leftChild;
+    } else {
+      node.parent.left = leftChild;
+    }
+
+    leftChild.right = node;
+    node.parent = leftChild;
+  }
+
+  private transplant(u: RBTreeNode<K>, v: RBTreeNode<K> | null): void {
+    if (!u.parent) {
+      this.root = v;
+    } else if (u === u.parent.left) {
+      u.parent.left = v;
+    } else {
+      u.parent.right = v;
+    }
+
+    if (v) {
+      v.parent = u.parent;
+    }
+  }
+
+  private minimum(node: RBTreeNode<K>): RBTreeNode<K> {
+    while (node.left) {
+      node = node.left;
+    }
+    return node;
+  }
+
+  private inorder(node: RBTreeNode<K> | null, result: K[]): void {
+    if (node) {
+      this.inorder(node.left, result);
+      result.push(node.key);
+      this.inorder(node.right, result);
+    }
+  }
+
+  private inorderRange(
+    node: RBTreeNode<K> | null,
+    start: K,
+    end: K,
+    result: K[],
+  ): void {
+    if (!node) return;
+
+    const startCmp = this.compareFn(node.key, start);
+    const endCmp = this.compareFn(node.key, end);
+
+    if (startCmp > 0) {
+      this.inorderRange(node.left, start, end, result);
+    }
+
+    if (startCmp >= 0 && endCmp <= 0) {
+      result.push(node.key);
+    }
+
+    if (endCmp < 0) {
+      this.inorderRange(node.right, start, end, result);
+    }
+  }
+}
+
+/**
+ * LRU cache with binary search capabilities using Red-Black tree
+ * All operations are O(log n) for ordered queries and O(1) for LRU operations
+ */
+export class OrderedLRUCache<K extends number | string, V> {
+  private cache = new Map<K, V>();
+  private tree: RedBlackTree<K>;
+  private readonly maxSize: number;
+  private readonly compareFn: (a: K, b: K) => number;
+
+  constructor(maxSize: number, compareFn?: (a: K, b: K) => number) {
+    this.maxSize = maxSize;
+    this.compareFn = compareFn || ((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+    this.tree = new RedBlackTree(this.compareFn);
+  }
+
+  /**
+   * Get value by exact key (O(1))
+   */
+  get(key: K): V | undefined {
+    const value = this.cache.get(key);
+    if (value) {
+      // Refresh position by removing and re-adding
+      this.cache.delete(key);
+      this.cache.set(key, value);
+    }
+    return value;
+  }
+
+  /**
+   * Set key-value pair (O(log n) for tree operations, O(1) for cache)
+   */
+  set(key: K, value: V): void {
+    const isUpdate = this.cache.has(key);
+
+    if (isUpdate) {
+      this.cache.delete(key);
+    } else {
+      if (this.cache.size >= this.maxSize) {
+        // Remove oldest entry (first item in map)
+        const firstKey = this.cache.keys().next().value;
+        if (firstKey) {
+          this.cache.delete(firstKey);
+          this.tree.delete(firstKey);
+        }
+      }
+      // Add to tree index for new keys
+      this.tree.insert(key);
+    }
+
+    this.cache.set(key, value);
+  }
+
+  /**
+   * Find exact key using tree search (O(log n))
+   */
+  findExact(key: K): V | undefined {
+    const foundKey = this.tree.find(key);
+    if (foundKey !== null) {
+      return this.get(key);
+    }
+    return undefined;
+  }
+
+  /**
+   * Find keys within distance of center point (O(log n + k) where k is result count)
+   * Returns empty array if no keys found in range
+   */
+  findNearestInRange(center: K, distance: K): Array<{ key: K; value: V }> {
+    const nearestKeys = this.tree.findNearestInRange(center, distance);
+    const result: Array<{ key: K; value: V }> = [];
+
+    for (const key of nearestKeys) {
+      const value = this.get(key);
+      if (value !== undefined) {
+        result.push({ key, value });
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Find all key-value pairs in range [start, end] (O(log n + k) where k is result count)
+   */
+  findRange(start: K, end: K): Array<{ key: K; value: V }> {
+    const keys = this.tree.findRange(start, end);
+    const result: Array<{ key: K; value: V }> = [];
+
+    for (const key of keys) {
+      const value = this.get(key);
+      if (value !== undefined) {
+        result.push({ key, value });
+      }
+    }
+
+    return result;
+  }
+
+  /**
+   * Get all keys in sorted order (O(n))
+   */
+  getSortedKeys(): ReadonlyArray<K> {
+    return this.tree.getAllSorted();
+  }
+
+  has(key: K): boolean {
+    return this.cache.has(key);
+  }
+
+  delete(key: K): boolean {
+    const deleted = this.cache.delete(key);
+    if (deleted) {
+      this.tree.delete(key);
+    }
+    return deleted;
+  }
+
+  clear(): void {
+    this.cache.clear();
+    this.tree = new RedBlackTree(this.compareFn);
+  }
+
+  get size(): number {
+    return this.cache.size;
+  }
+}

package/test/__cache__/GET__api_v1_transcode_high_1_m4s_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__26197f6f7c46cacb0a71134131c3f775/metadata.json

@@ -6,7 +6,7 @@
     "access-control-allow-origin": "*",
     "access-control-expose-headers": "Content-Length, Content-Range, X-Cache, X-Actual-Start-Time, X-Actual-Duration, X-Transcode-Time-Ms, X-Total-Server-Time-Ms",
     "cache-control": "public, max-age=3600",
-    "content-length": "2057283",
+    "content-length": "2055451",
     "content-type": "video/iso.segment",
     "x-powered-by": "Express"
   },

package/test/__cache__/GET__api_v1_transcode_high_2_m4s_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__4cb6774cd3650ccf59c8f8dc6678c0b9/metadata.json

@@ -6,7 +6,7 @@
     "access-control-allow-origin": "*",
     "access-control-expose-headers": "Content-Length, Content-Range, X-Cache, X-Actual-Start-Time, X-Actual-Duration, X-Transcode-Time-Ms, X-Total-Server-Time-Ms",
     "cache-control": "public, max-age=3600",
-    "content-length": "2185975",
+    "content-length": "2192280",
     "content-type": "video/iso.segment",
     "x-powered-by": "Express"
   },

package/test/__cache__/GET__api_v1_transcode_high_3_m4s_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__0b3b2b1c8933f7fcf8a9ecaa88d58b41/metadata.json

@@ -6,7 +6,7 @@
     "access-control-allow-origin": "*",
     "access-control-expose-headers": "Content-Length, Content-Range, X-Cache, X-Actual-Start-Time, X-Actual-Duration, X-Transcode-Time-Ms, X-Total-Server-Time-Ms",
     "cache-control": "public, max-age=3600",
-    "content-length": "2120135",
+    "content-length": "2115680",
     "content-type": "video/iso.segment",
     "x-powered-by": "Express"
   },

package/test/__cache__/GET__api_v1_transcode_high_4_m4s_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__a6fb05a22b18d850f7f2950bbcdbdeed/metadata.json

@@ -6,7 +6,7 @@
     "access-control-allow-origin": "*",
     "access-control-expose-headers": "Content-Length, Content-Range, X-Cache, X-Actual-Start-Time, X-Actual-Duration, X-Transcode-Time-Ms, X-Total-Server-Time-Ms",
     "cache-control": "public, max-age=3600",
-    "content-length": "2221511",
+    "content-length": "2217276",
     "content-type": "video/iso.segment",
     "x-powered-by": "Express"
   },

package/test/__cache__/GET__api_v1_transcode_high_5_m4s_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__a50058c7c3602e90879fe3428ed891f4/metadata.json

@@ -6,7 +6,7 @@
     "access-control-allow-origin": "*",
     "access-control-expose-headers": "Content-Length, Content-Range, X-Cache, X-Actual-Start-Time, X-Actual-Duration, X-Transcode-Time-Ms, X-Total-Server-Time-Ms",
     "cache-control": "public, max-age=3600",
-    "content-length": "2037521",
+    "content-length": "2025221",
     "content-type": "video/iso.segment",
     "x-powered-by": "Express"
   },

package/test/__cache__/GET__api_v1_transcode_manifest_json_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__3be92a0437de726b431ed5af2369158a/data.bin

@@ -1 +1 @@
-{"version":"1.0","type":"com.editframe/manifest","sourceUrl":"http://web:3000/head-moov-480p.mp4","duration":10,"durationMs":10000,"baseUrl":"http://localhost:63315","videoRenditions":[{"id":"high","width":1920,"height":1080,"bitrate":5000000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"medium","width":1280,"height":720,"bitrate":2500000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"low","width":854,"height":480,"bitrate":1000000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"scrub","width":320,"height":180,"bitrate":100000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029\"","segmentDuration":30,"segmentDurationMs":30000,"segmentDurationsMs":[30000],"frameRate":15,"profile":"High","level":"4.1"}],"audioRenditions":[{"id":"audio","channels":1,"sampleRate":48000,"bitrate":128000,"codec":"mp4a.40.2","container":"audio/mp4","mimeType":"audio/mp4; codecs=\"mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2026.66,2005.33,1984,2005.33,2026.66],"language":"en"}],"endpoints":{"initSegment":"http://localhost:63315/api/v1/transcode/{rendition}/init.m4s?url=http%3A%2F%2Fweb%3A3000%2Fhead-moov-480p.mp4","mediaSegment":"http://localhost:63315/api/v1/transcode/{rendition}/{segmentId}.m4s?url=http%3A%2F%2Fweb%3A3000%2Fhead-moov-480p.mp4"},"jitInfo":{"parallelTranscodingSupported":true,"expectedTranscodeLatency":500,"segmentCount":5,"scrubSegmentCount":1}}
+{"version":"1.0","type":"com.editframe/manifest","sourceUrl":"http://web:3000/head-moov-480p.mp4","duration":10,"durationMs":10000,"baseUrl":"http://localhost:63315","videoRenditions":[{"id":"high","width":1920,"height":1078,"bitrate":5000000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"medium","width":1280,"height":718,"bitrate":2500000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"low","width":854,"height":480,"bitrate":1000000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029,mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2000,2000,2000,2000,2000],"frameRate":30,"profile":"High","level":"4.1"},{"id":"scrub","width":320,"height":180,"bitrate":100000,"codec":"avc1.640029","container":"video/mp4","mimeType":"video/mp4; codecs=\"avc1.640029\"","segmentDuration":30,"segmentDurationMs":30000,"segmentDurationsMs":[30000],"frameRate":15,"profile":"High","level":"4.1"}],"audioRenditions":[{"id":"audio","channels":1,"sampleRate":48000,"bitrate":128000,"codec":"mp4a.40.2","container":"audio/mp4","mimeType":"audio/mp4; codecs=\"mp4a.40.2\"","segmentDuration":2,"segmentDurationMs":2000,"segmentDurationsMs":[2026.66,2005.33,1984,2005.33,2026.66],"language":"en"}],"endpoints":{"initSegment":"http://localhost:63315/api/v1/transcode/{rendition}/init.m4s?url=http%3A%2F%2Fweb%3A3000%2Fhead-moov-480p.mp4","mediaSegment":"http://localhost:63315/api/v1/transcode/{rendition}/{segmentId}.m4s?url=http%3A%2F%2Fweb%3A3000%2Fhead-moov-480p.mp4"},"jitInfo":{"parallelTranscodingSupported":true,"expectedTranscodeLatency":500,"segmentCount":5,"scrubSegmentCount":1}}

package/test/__cache__/GET__api_v1_transcode_manifest_json_url_http_3A_2F_2Fweb_3A3000_2Fhead_moov_480p_mp4__3be92a0437de726b431ed5af2369158a/metadata.json

@@ -8,7 +8,7 @@
     "cache-control": "public, max-age=300",
     "content-length": "2045",
     "content-type": "application/json; charset=utf-8",
-    "etag": "W/\"81b-wi6z588RhWTgs57jivyDs3lEkkA\"",
+    "etag": "W/\"81b-HUWtw7SxFRSpD9Ic54e9i9HWJnc\"",
     "x-powered-by": "Express"
   },
   "url": "/api/v1/transcode/manifest.json?url=http%3A%2F%2Fweb%3A3000%2Fhead-moov-480p.mp4",