serializable-bptree 9.0.2 → 9.0.3

package/dist/cjs/index.cjs

@@ -3236,6 +3236,9 @@ var BPTreeSyncTransaction = class extends BPTreeTransaction {
     this._verifierMapCached = createVerifierMap(this.comparator, this._cachedRegexp, ensureValues);
     this._searchConfigsCached = createSearchConfigs(this.comparator, ensureValues);
   }
+  getRootNode() {
+    return this.getNode(this.rootId);
+  }
   // ─── Legacy protected methods (delegating to ops) ────────────────
   getNode(id) {
     return this._ops.getNode(id);
@@ -4674,6 +4677,9 @@ var BPTreeAsyncTransaction = class extends BPTreeTransaction {
       this.lock.writeUnlock(lockId);
     });
   }
+  async getRootNode() {
+    return this.getNode(this.rootId);
+  }
   // ─── Legacy protected methods (delegating to ops) ────────────────
   async getNode(id) {
     return this._ops.getNode(id);
@@ -5107,21 +5113,18 @@ var BPTreePureSync = class {
     );
     flush();
   }
-  /**
-   * Returns the ID of the root node.
-   */
+  getRootNode() {
+    const ctx = this._readCtx();
+    return this.strategy.read(ctx.rootId);
+  }
   getRootId() {
-    return this._readCtx().rootId;
+    const ctx = this._readCtx();
+    return ctx.rootId;
   }
-  /**
-   * Returns the order of the B+Tree.
-   */
   getOrder() {
-    return this._readCtx().order;
+    const ctx = this._readCtx();
+    return ctx.order;
   }
-  /**
-   * Verified if the value satisfies the condition.
-   */
   verify(nodeValue, condition) {
     for (const key in condition) {
       const verifyFn = this._verifierMap[key];
@@ -5134,18 +5137,18 @@ var BPTreePureSync = class {
   }
   // ─── Query ───────────────────────────────────────────────────────
   get(key) {
-    const { rootId } = this._readCtx();
-    return getOp(this._createReadOps(), rootId, key);
+    const ctx = this._readCtx();
+    return getOp(this._createReadOps(), ctx.rootId, key);
   }
   exists(key, value) {
-    const { rootId } = this._readCtx();
-    return existsOp(this._createReadOps(), rootId, key, value, this.comparator);
+    const ctx = this._readCtx();
+    return existsOp(this._createReadOps(), ctx.rootId, key, value, this.comparator);
   }
   *keysStream(condition, options) {
-    const { rootId } = this._readCtx();
+    const ctx = this._readCtx();
     yield* keysStreamOp(
       this._createReadOps(),
-      rootId,
+      ctx.rootId,
       condition,
       this.comparator,
       this._verifierMap,
@@ -5155,10 +5158,10 @@ var BPTreePureSync = class {
     );
   }
   *whereStream(condition, options) {
-    const { rootId } = this._readCtx();
+    const ctx = this._readCtx();
     yield* whereStreamOp(
       this._createReadOps(),
-      rootId,
+      ctx.rootId,
       condition,
       this.comparator,
       this._verifierMap,
@@ -5366,11 +5369,17 @@ var BPTreePureAsync = class {
       await flush();
     });
   }
+  async getRootNode() {
+    const ctx = await this._readCtx();
+    return await this.strategy.read(ctx.rootId);
+  }
   async getRootId() {
-    return (await this._readCtx()).rootId;
+    const ctx = await this._readCtx();
+    return ctx.rootId;
   }
   async getOrder() {
-    return (await this._readCtx()).order;
+    const ctx = await this._readCtx();
+    return ctx.order;
   }
   verify(nodeValue, condition) {
     for (const key in condition) {
@@ -5382,21 +5391,21 @@ var BPTreePureAsync = class {
   }
   // ─── Query ───────────────────────────────────────────────────────
   async get(key) {
-    const { rootId } = await this._readCtx();
-    return getOpAsync(this._createReadOps(), rootId, key);
+    const ctx = await this._readCtx();
+    return getOpAsync(this._createReadOps(), ctx.rootId, key);
   }
   async exists(key, value) {
-    const { rootId } = await this._readCtx();
-    return existsOpAsync(this._createReadOps(), rootId, key, value, this.comparator);
+    const ctx = await this._readCtx();
+    return existsOpAsync(this._createReadOps(), ctx.rootId, key, value, this.comparator);
   }
   async *keysStream(condition, options) {
     let lockId;
     try {
       lockId = await this.lock.readLock([0, 0.1], async (id) => id);
-      const { rootId } = await this._readCtx();
+      const ctx = await this._readCtx();
       yield* keysStreamOpAsync(
         this._createReadOps(),
-        rootId,
+        ctx.rootId,
         condition,
         this.comparator,
         this._verifierMap,
@@ -5412,10 +5421,10 @@ var BPTreePureAsync = class {
     let lockId;
     try {
       lockId = await this.lock.readLock([0, 0.1], async (id) => id);
-      const { rootId } = await this._readCtx();
+      const ctx = await this._readCtx();
       yield* whereStreamOpAsync(
         this._createReadOps(),
-        rootId,
+        ctx.rootId,
         condition,
         this.comparator,
         this._verifierMap,

package/dist/esm/index.mjs

@@ -3198,6 +3198,9 @@ var BPTreeSyncTransaction = class extends BPTreeTransaction {
     this._verifierMapCached = createVerifierMap(this.comparator, this._cachedRegexp, ensureValues);
     this._searchConfigsCached = createSearchConfigs(this.comparator, ensureValues);
   }
+  getRootNode() {
+    return this.getNode(this.rootId);
+  }
   // ─── Legacy protected methods (delegating to ops) ────────────────
   getNode(id) {
     return this._ops.getNode(id);
@@ -4636,6 +4639,9 @@ var BPTreeAsyncTransaction = class extends BPTreeTransaction {
       this.lock.writeUnlock(lockId);
     });
   }
+  async getRootNode() {
+    return this.getNode(this.rootId);
+  }
   // ─── Legacy protected methods (delegating to ops) ────────────────
   async getNode(id) {
     return this._ops.getNode(id);
@@ -5069,21 +5075,18 @@ var BPTreePureSync = class {
     );
     flush();
   }
-  /**
-   * Returns the ID of the root node.
-   */
+  getRootNode() {
+    const ctx = this._readCtx();
+    return this.strategy.read(ctx.rootId);
+  }
   getRootId() {
-    return this._readCtx().rootId;
+    const ctx = this._readCtx();
+    return ctx.rootId;
   }
-  /**
-   * Returns the order of the B+Tree.
-   */
   getOrder() {
-    return this._readCtx().order;
+    const ctx = this._readCtx();
+    return ctx.order;
   }
-  /**
-   * Verified if the value satisfies the condition.
-   */
   verify(nodeValue, condition) {
     for (const key in condition) {
       const verifyFn = this._verifierMap[key];
@@ -5096,18 +5099,18 @@ var BPTreePureSync = class {
   }
   // ─── Query ───────────────────────────────────────────────────────
   get(key) {
-    const { rootId } = this._readCtx();
-    return getOp(this._createReadOps(), rootId, key);
+    const ctx = this._readCtx();
+    return getOp(this._createReadOps(), ctx.rootId, key);
   }
   exists(key, value) {
-    const { rootId } = this._readCtx();
-    return existsOp(this._createReadOps(), rootId, key, value, this.comparator);
+    const ctx = this._readCtx();
+    return existsOp(this._createReadOps(), ctx.rootId, key, value, this.comparator);
   }
   *keysStream(condition, options) {
-    const { rootId } = this._readCtx();
+    const ctx = this._readCtx();
     yield* keysStreamOp(
       this._createReadOps(),
-      rootId,
+      ctx.rootId,
       condition,
       this.comparator,
       this._verifierMap,
@@ -5117,10 +5120,10 @@ var BPTreePureSync = class {
     );
   }
   *whereStream(condition, options) {
-    const { rootId } = this._readCtx();
+    const ctx = this._readCtx();
     yield* whereStreamOp(
       this._createReadOps(),
-      rootId,
+      ctx.rootId,
       condition,
       this.comparator,
       this._verifierMap,
@@ -5328,11 +5331,17 @@ var BPTreePureAsync = class {
       await flush();
     });
   }
+  async getRootNode() {
+    const ctx = await this._readCtx();
+    return await this.strategy.read(ctx.rootId);
+  }
   async getRootId() {
-    return (await this._readCtx()).rootId;
+    const ctx = await this._readCtx();
+    return ctx.rootId;
   }
   async getOrder() {
-    return (await this._readCtx()).order;
+    const ctx = await this._readCtx();
+    return ctx.order;
   }
   verify(nodeValue, condition) {
     for (const key in condition) {
@@ -5344,21 +5353,21 @@ var BPTreePureAsync = class {
   }
   // ─── Query ───────────────────────────────────────────────────────
   async get(key) {
-    const { rootId } = await this._readCtx();
-    return getOpAsync(this._createReadOps(), rootId, key);
+    const ctx = await this._readCtx();
+    return getOpAsync(this._createReadOps(), ctx.rootId, key);
   }
   async exists(key, value) {
-    const { rootId } = await this._readCtx();
-    return existsOpAsync(this._createReadOps(), rootId, key, value, this.comparator);
+    const ctx = await this._readCtx();
+    return existsOpAsync(this._createReadOps(), ctx.rootId, key, value, this.comparator);
   }
   async *keysStream(condition, options) {
     let lockId;
     try {
       lockId = await this.lock.readLock([0, 0.1], async (id) => id);
-      const { rootId } = await this._readCtx();
+      const ctx = await this._readCtx();
       yield* keysStreamOpAsync(
         this._createReadOps(),
-        rootId,
+        ctx.rootId,
         condition,
         this.comparator,
         this._verifierMap,
@@ -5374,10 +5383,10 @@ var BPTreePureAsync = class {
     let lockId;
     try {
       lockId = await this.lock.readLock([0, 0.1], async (id) => id);
-      const { rootId } = await this._readCtx();
+      const ctx = await this._readCtx();
       yield* whereStreamOpAsync(
         this._createReadOps(),
-        rootId,
+        ctx.rootId,
         condition,
         this.comparator,
         this._verifierMap,

package/dist/types/BPTreePureAsync.d.ts

@@ -1,8 +1,8 @@
-import type { BPTreeCondition, BPTreeConstructorOption, BPTreePair, BPTreeSearchOption, SerializableData } from './types';
+import type { BPTreeCondition, BPTreeConstructorOption, BPTreePair, BPTreeSearchOption, BPTreeUnknownNode, SerializableData } from './types';
+import { Ryoiki } from 'ryoiki';
 import { SerializeStrategyAsync } from './SerializeStrategyAsync';
 import { ValueComparator } from './base/ValueComparator';
 import { BPTreeTransaction } from './base/BPTreeTransaction';
-import { Ryoiki } from 'ryoiki';
 export declare class BPTreePureAsync<K, V> {
     protected readonly strategy: SerializeStrategyAsync<K, V>;
     protected readonly comparator: ValueComparator<V>;
@@ -19,6 +19,7 @@ export declare class BPTreePureAsync<K, V> {
     private _createCtx;
     protected writeLock<T>(fn: () => Promise<T>): Promise<T>;
     init(): Promise<void>;
+    getRootNode(): Promise<BPTreeUnknownNode<K, V>>;
     getRootId(): Promise<string>;
     getOrder(): Promise<number>;
     verify(nodeValue: V, condition: BPTreeCondition<V>): boolean;

package/dist/types/BPTreePureSync.d.ts

@@ -1,4 +1,4 @@
-import type { BPTreeCondition, BPTreeConstructorOption, BPTreePair, BPTreeSearchOption, SerializableData } from './types';
+import type { BPTreeCondition, BPTreeConstructorOption, BPTreePair, BPTreeSearchOption, BPTreeUnknownNode, SerializableData } from './types';
 import { SerializeStrategySync } from './SerializeStrategySync';
 import { ValueComparator } from './base/ValueComparator';
 import { BPTreeTransaction } from './base/BPTreeTransaction';
@@ -16,17 +16,9 @@ export declare class BPTreePureSync<K, V> {
     private _readCtx;
     private _createCtx;
     init(): void;
-    /**
-     * Returns the ID of the root node.
-     */
+    getRootNode(): BPTreeUnknownNode<K, V>;
     getRootId(): string;
-    /**
-     * Returns the order of the B+Tree.
-     */
     getOrder(): number;
-    /**
-     * Verified if the value satisfies the condition.
-     */
     verify(nodeValue: V, condition: BPTreeCondition<V>): boolean;
     get(key: K): V | undefined;
     exists(key: K, value: V): boolean;

package/dist/types/base/BPTreeTransaction.d.ts

@@ -57,6 +57,11 @@ export declare abstract class BPTreeTransaction<K, V> {
      * @returns An array of keys that are in conflict. Empty array if no conflicts.
      */
     static CheckConflicts<K, V>(transactions: BPTreeTransaction<K, V>[]): string[];
+    /**
+     * Returns the root node of the B+Tree.
+     * @returns The root node.
+     */
+    abstract getRootNode(): Deferred<BPTreeUnknownNode<K, V>>;
     /**
      * Returns the ID of the root node.
      * @returns The root node ID.

package/dist/types/transaction/BPTreeAsyncTransaction.d.ts

@@ -20,6 +20,7 @@ export declare class BPTreeAsyncTransaction<K, V> extends BPTreeTransaction<K, V
     constructor(rootTx: BPTreeAsyncTransaction<K, V> | null, mvccRoot: AsyncBPTreeMVCC<K, V>, mvcc: AsyncBPTreeMVCC<K, V>, strategy: SerializeStrategyAsync<K, V>, comparator: ValueComparator<V>, option?: BPTreeConstructorOption);
     private _initAlgoContext;
     protected writeLock<T>(id: number, fn: () => Promise<T>): Promise<T>;
+    getRootNode(): Promise<BPTreeUnknownNode<K, V>>;
     protected getNode(id: string): Promise<BPTreeUnknownNode<K, V>>;
     protected _createNode(leaf: boolean, keys: string[] | K[][], values: V[], parent?: string | null, next?: string | null, prev?: string | null): Promise<BPTreeUnknownNode<K, V>>;
     protected _updateNode(node: BPTreeUnknownNode<K, V>): Promise<void>;

package/dist/types/transaction/BPTreeSyncTransaction.d.ts

@@ -17,6 +17,7 @@ export declare class BPTreeSyncTransaction<K, V> extends BPTreeTransaction<K, V>
     private _searchConfigsCached;
     constructor(rootTx: BPTreeSyncTransaction<K, V>, mvccRoot: SyncBPTreeMVCC<K, V>, mvcc: SyncBPTreeMVCC<K, V>, strategy: SerializeStrategySync<K, V>, comparator: ValueComparator<V>, option?: BPTreeConstructorOption);
     private _initAlgoContext;
+    getRootNode(): BPTreeUnknownNode<K, V>;
     protected getNode(id: string): BPTreeUnknownNode<K, V>;
     protected _createNode(leaf: boolean, keys: string[] | K[][], values: V[], parent?: string | null, next?: string | null, prev?: string | null): BPTreeUnknownNode<K, V>;
     protected _updateNode(node: BPTreeUnknownNode<K, V>): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "serializable-bptree",
-  "version": "9.0.2",
+  "version": "9.0.3",
   "description": "Store the B+tree flexibly, not only in-memory.",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/cjs/index.cjs",