@harperfast/rocksdb-js 1.1.1 → 1.2.0

package/dist/index.d.cts

@@ -36,16 +36,21 @@ interface DBIteratorValue<T> {
   value: T;
 }
 /**
-* Wraps an iterator, namely the `NativeIterator` class, and decodes the key
-* and value.
+* Wraps the `NativeIterator` C++ binding, decoding keys and values from the
+* shared key/value buffers (fast path) or from per-iteration buffers (slow
+* fallback path used for oversized data or stable-buffer decoders).
+*
+* The native `next()` returns a primitive signal (and writes lengths to the
+* shared `ITERATOR_STATE` buffer) instead of constructing a JS result object,
+* so this class is responsible for building the `IteratorResult`.
 */
 declare class DBIterator<T> implements Iterator<DBIteratorValue<T>> {
   #private;
-  iterator: Iterator<DBIteratorValue<T>>;
+  iterator: InstanceType<typeof NativeIteratorCls>;
   store: Store;
-  constructor(iterator: Iterator<DBIteratorValue<T>>, store: Store, options?: IteratorOptions & T);
+  constructor(iterator: InstanceType<typeof NativeIteratorCls>, store: Store, includeValues: boolean);
   [Symbol.iterator](): Iterator<DBIteratorValue<T>>;
-  next(...[_value]: [] | [any]): IteratorResult<DBIteratorValue<T>>;
+  next(): IteratorResult<DBIteratorValue<T>>;
   return(value?: any): IteratorResult<DBIteratorValue<T>, any>;
   throw(err: unknown): IteratorResult<DBIteratorValue<T>, any>;
 }
@@ -57,6 +62,10 @@ type StoreIteratorOptions = IteratorOptions & DBITransactional;
 type StorePutOptions = PutOptions & DBITransactional;
 type StoreRangeOptions = RangeOptions & DBITransactional;
 type StoreRemoveOptions = DBITransactional | unknown;
+type CompactOptions = {
+  start?: Key;
+  end?: Key;
+};
 /**
 * Options for the `Store` class.
 */
@@ -245,6 +254,28 @@ declare class Store {
   */
   close(): void;
   /**
+  * Compacts the entire key range of the database asynchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * await db.compact();
+  * ```
+  */
+  compact(options?: CompactOptions): Promise<void>;
+  /**
+  * Compacts the entire key range of the database synchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * db.compactSync();
+  * ```
+  */
+  compactSync(options?: CompactOptions): void;
+  /**
   * Decodes a key from the database.
   *
   * @param key - The key to decode.
@@ -429,6 +460,36 @@ type TransactionLog = {
   _lastCommittedPosition: Float64Array;
   _logBuffers: Map<number, WeakRef<LogBuffer>>;
 };
+/**
+* Shape of options that can be passed to the native iterator constructor for
+* the rare case of advanced RocksDB ReadOptions overrides. Common iterator
+* options are passed via the bitmask `flags` argument instead.
+*/
+type NativeIteratorAdvancedOptions = {
+  adaptiveReadahead?: boolean;
+  asyncIO?: boolean;
+  autoReadaheadSize?: boolean;
+  backgroundPurgeOnIteratorCleanup?: boolean;
+  fillCache?: boolean;
+  readaheadSize?: number;
+  tailing?: boolean;
+};
+/**
+* The result of a single native iterator step. A number value matches one of
+* the `ITERATOR_RESULT_*` constants. The slow-path object is returned when
+* the data does not fit in the shared key/value buffers, or when the decoder
+* needs a stable value buffer.
+*/
+type NativeIteratorResult = number | {
+  key: Buffer;
+  value?: Buffer;
+};
+declare class NativeIteratorCls {
+  constructor(context: StoreContext, flags: number, startKeyEnd: number, endKeyStart: number, endKeyEnd: number, options?: NativeIteratorAdvancedOptions);
+  next(): NativeIteratorResult;
+  return(): void;
+  throw(err?: unknown): void;
+}
 type NativeDatabaseMode = "optimistic" | "pessimistic";
 type NativeDatabaseOptions = {
   disableWAL?: boolean;
@@ -469,6 +530,8 @@ type NativeDatabase = {
   clear(resolve: ResolveCallback<void>, reject: RejectCallback): void;
   clearSync(): void;
   close(): void;
+  compact(resolve: ResolveCallback<void>, reject: RejectCallback, start?: Key, end?: Key): void;
+  compactSync(start?: Key, end?: Key): void;
   columns: string[];
   destroy(): void;
   drop(resolve: ResolveCallback<void>, reject: RejectCallback): void;
@@ -497,6 +560,7 @@ type NativeDatabase = {
   removeSync(key: BufferWithDataView, txnId?: number): void;
   setDefaultKeyBuffer(buffer: Buffer | Uint8Array | null): void;
   setDefaultValueBuffer(buffer: Buffer | Uint8Array | null): void;
+  setIteratorState(buffer: Buffer | Uint8Array): void;
   tryLock(key: BufferWithDataView, callback?: () => void): boolean;
   unlock(key: BufferWithDataView): void;
   useLog(name: string): TransactionLog;
@@ -504,6 +568,7 @@ type NativeDatabase = {
 };
 type RocksDatabaseConfig = {
   blockCacheSize?: number;
+  compactOnClose?: boolean;
 };
 type RegistryStatusDB = {
   path: string;
@@ -523,6 +588,14 @@ declare const constants: {
   TRANSACTION_LOG_TOKEN: number;
   TRANSACTION_LOG_ENTRY_HEADER_SIZE: number;
   TRANSACTION_LOG_FILE_HEADER_SIZE: number;
+  ITERATOR_REVERSE_FLAG: number;
+  ITERATOR_INCLUSIVE_END_FLAG: number;
+  ITERATOR_EXCLUSIVE_START_FLAG: number;
+  ITERATOR_INCLUDE_VALUES_FLAG: number;
+  ITERATOR_NEEDS_STABLE_VALUE_BUFFER_FLAG: number;
+  ITERATOR_CONTEXT_IS_TRANSACTION_FLAG: number;
+  ITERATOR_RESULT_DONE: number;
+  ITERATOR_RESULT_FAST: number;
 };
 declare const NativeDatabase: NativeDatabase;
 declare const NativeTransaction: NativeTransaction;
@@ -975,6 +1048,28 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   */
   close(): void;
   /**
+  * Compacts the entire key range of the database asynchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * await db.compact();
+  * ```
+  */
+  compact(options?: CompactOptions): Promise<void>;
+  /**
+  * Compacts the entire key range of the database synchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * db.compactSync();
+  * ```
+  */
+  compactSync(options?: CompactOptions): void;
+  /**
   * Returns the list of column families in the RocksDB database.
   */
   get columns(): string[];
@@ -1034,6 +1129,17 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   */
   getDBProperty(propertyName: string): string | undefined;
   /**
+  * Retrieves the estimated number of keys in the database.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * const estimated = db.getEstimatedKeyCount();
+  * console.log(estimated);
+  * ```
+  */
+  getEstimatedKeyCount(): number;
+  /**
   * Returns the current timestamp as a monotonically increasing timestamp in
   * milliseconds represented as a decimal number.
   *

package/dist/index.d.mts

@@ -36,16 +36,21 @@ interface DBIteratorValue<T> {
   value: T;
 }
 /**
-* Wraps an iterator, namely the `NativeIterator` class, and decodes the key
-* and value.
+* Wraps the `NativeIterator` C++ binding, decoding keys and values from the
+* shared key/value buffers (fast path) or from per-iteration buffers (slow
+* fallback path used for oversized data or stable-buffer decoders).
+*
+* The native `next()` returns a primitive signal (and writes lengths to the
+* shared `ITERATOR_STATE` buffer) instead of constructing a JS result object,
+* so this class is responsible for building the `IteratorResult`.
 */
 declare class DBIterator<T> implements Iterator<DBIteratorValue<T>> {
   #private;
-  iterator: Iterator<DBIteratorValue<T>>;
+  iterator: InstanceType<typeof NativeIteratorCls>;
   store: Store;
-  constructor(iterator: Iterator<DBIteratorValue<T>>, store: Store, options?: IteratorOptions & T);
+  constructor(iterator: InstanceType<typeof NativeIteratorCls>, store: Store, includeValues: boolean);
   [Symbol.iterator](): Iterator<DBIteratorValue<T>>;
-  next(...[_value]: [] | [any]): IteratorResult<DBIteratorValue<T>>;
+  next(): IteratorResult<DBIteratorValue<T>>;
   return(value?: any): IteratorResult<DBIteratorValue<T>, any>;
   throw(err: unknown): IteratorResult<DBIteratorValue<T>, any>;
 }
@@ -57,6 +62,10 @@ type StoreIteratorOptions = IteratorOptions & DBITransactional;
 type StorePutOptions = PutOptions & DBITransactional;
 type StoreRangeOptions = RangeOptions & DBITransactional;
 type StoreRemoveOptions = DBITransactional | unknown;
+type CompactOptions = {
+  start?: Key;
+  end?: Key;
+};
 /**
 * Options for the `Store` class.
 */
@@ -245,6 +254,28 @@ declare class Store {
   */
   close(): void;
   /**
+  * Compacts the entire key range of the database asynchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * await db.compact();
+  * ```
+  */
+  compact(options?: CompactOptions): Promise<void>;
+  /**
+  * Compacts the entire key range of the database synchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * db.compactSync();
+  * ```
+  */
+  compactSync(options?: CompactOptions): void;
+  /**
   * Decodes a key from the database.
   *
   * @param key - The key to decode.
@@ -429,6 +460,36 @@ type TransactionLog = {
   _lastCommittedPosition: Float64Array;
   _logBuffers: Map<number, WeakRef<LogBuffer>>;
 };
+/**
+* Shape of options that can be passed to the native iterator constructor for
+* the rare case of advanced RocksDB ReadOptions overrides. Common iterator
+* options are passed via the bitmask `flags` argument instead.
+*/
+type NativeIteratorAdvancedOptions = {
+  adaptiveReadahead?: boolean;
+  asyncIO?: boolean;
+  autoReadaheadSize?: boolean;
+  backgroundPurgeOnIteratorCleanup?: boolean;
+  fillCache?: boolean;
+  readaheadSize?: number;
+  tailing?: boolean;
+};
+/**
+* The result of a single native iterator step. A number value matches one of
+* the `ITERATOR_RESULT_*` constants. The slow-path object is returned when
+* the data does not fit in the shared key/value buffers, or when the decoder
+* needs a stable value buffer.
+*/
+type NativeIteratorResult = number | {
+  key: Buffer;
+  value?: Buffer;
+};
+declare class NativeIteratorCls {
+  constructor(context: StoreContext, flags: number, startKeyEnd: number, endKeyStart: number, endKeyEnd: number, options?: NativeIteratorAdvancedOptions);
+  next(): NativeIteratorResult;
+  return(): void;
+  throw(err?: unknown): void;
+}
 type NativeDatabaseMode = "optimistic" | "pessimistic";
 type NativeDatabaseOptions = {
   disableWAL?: boolean;
@@ -469,6 +530,8 @@ type NativeDatabase = {
   clear(resolve: ResolveCallback<void>, reject: RejectCallback): void;
   clearSync(): void;
   close(): void;
+  compact(resolve: ResolveCallback<void>, reject: RejectCallback, start?: Key, end?: Key): void;
+  compactSync(start?: Key, end?: Key): void;
   columns: string[];
   destroy(): void;
   drop(resolve: ResolveCallback<void>, reject: RejectCallback): void;
@@ -497,6 +560,7 @@ type NativeDatabase = {
   removeSync(key: BufferWithDataView, txnId?: number): void;
   setDefaultKeyBuffer(buffer: Buffer | Uint8Array | null): void;
   setDefaultValueBuffer(buffer: Buffer | Uint8Array | null): void;
+  setIteratorState(buffer: Buffer | Uint8Array): void;
   tryLock(key: BufferWithDataView, callback?: () => void): boolean;
   unlock(key: BufferWithDataView): void;
   useLog(name: string): TransactionLog;
@@ -504,6 +568,7 @@ type NativeDatabase = {
 };
 type RocksDatabaseConfig = {
   blockCacheSize?: number;
+  compactOnClose?: boolean;
 };
 type RegistryStatusDB = {
   path: string;
@@ -523,6 +588,14 @@ declare const constants: {
   TRANSACTION_LOG_TOKEN: number;
   TRANSACTION_LOG_ENTRY_HEADER_SIZE: number;
   TRANSACTION_LOG_FILE_HEADER_SIZE: number;
+  ITERATOR_REVERSE_FLAG: number;
+  ITERATOR_INCLUSIVE_END_FLAG: number;
+  ITERATOR_EXCLUSIVE_START_FLAG: number;
+  ITERATOR_INCLUDE_VALUES_FLAG: number;
+  ITERATOR_NEEDS_STABLE_VALUE_BUFFER_FLAG: number;
+  ITERATOR_CONTEXT_IS_TRANSACTION_FLAG: number;
+  ITERATOR_RESULT_DONE: number;
+  ITERATOR_RESULT_FAST: number;
 };
 declare const NativeDatabase: NativeDatabase;
 declare const NativeTransaction: NativeTransaction;
@@ -975,6 +1048,28 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   */
   close(): void;
   /**
+  * Compacts the entire key range of the database asynchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * await db.compact();
+  * ```
+  */
+  compact(options?: CompactOptions): Promise<void>;
+  /**
+  * Compacts the entire key range of the database synchronously.
+  * This triggers manual compaction which removes tombstones and reclaims space.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * db.compactSync();
+  * ```
+  */
+  compactSync(options?: CompactOptions): void;
+  /**
   * Returns the list of column families in the RocksDB database.
   */
   get columns(): string[];
@@ -1034,6 +1129,17 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   */
   getDBProperty(propertyName: string): string | undefined;
   /**
+  * Retrieves the estimated number of keys in the database.
+  *
+  * @example
+  * ```typescript
+  * const db = RocksDatabase.open('/path/to/database');
+  * const estimated = db.getEstimatedKeyCount();
+  * console.log(estimated);
+  * ```
+  */
+  getEstimatedKeyCount(): number;
+  /**
   * Returns the current timestamp as a monotonically increasing timestamp in
   * milliseconds represented as a decimal number.
   *

package/dist/index.mjs

@@ -428,42 +428,62 @@ var DBI = class DBI {
 
 //#endregion
 //#region src/dbi-iterator.ts
+const { ITERATOR_RESULT_DONE, ITERATOR_RESULT_FAST } = constants;
+const DONE_RESULT = Object.freeze({
+	done: true,
+	value: void 0
+});
 /**
-* Wraps an iterator, namely the `NativeIterator` class, and decodes the key
-* and value.
+* Wraps the `NativeIterator` C++ binding, decoding keys and values from the
+* shared key/value buffers (fast path) or from per-iteration buffers (slow
+* fallback path used for oversized data or stable-buffer decoders).
+*
+* The native `next()` returns a primitive signal (and writes lengths to the
+* shared `ITERATOR_STATE` buffer) instead of constructing a JS result object,
+* so this class is responsible for building the `IteratorResult`.
 */
 var DBIterator = class {
 	iterator;
 	store;
 	#includeValues;
-	constructor(iterator, store, options) {
+	constructor(iterator, store, includeValues) {
 		this.iterator = iterator;
 		this.store = store;
-		this.#includeValues = options?.values ?? true;
+		this.#includeValues = includeValues;
 	}
 	[Symbol.iterator]() {
 		return this;
 	}
-	next(...[_value]) {
+	next() {
 		const result = this.iterator.next();
-		if (result.done) return result;
+		if (result === ITERATOR_RESULT_DONE) return DONE_RESULT;
+		const includeValues = this.#includeValues;
 		const value = {};
-		value.key = this.store.decodeKey(result.value.key);
-		if (this.#includeValues) value.value = this.store.decodeValue(result.value.value);
+		if (result === ITERATOR_RESULT_FAST) {
+			value.key = this.store.readKey(KEY_BUFFER, 0, ITERATOR_STATE[0]);
+			if (includeValues) {
+				VALUE_BUFFER.end = ITERATOR_STATE[1];
+				value.value = this.store.decodeValue(VALUE_BUFFER);
+			}
+		} else {
+			const slow = result;
+			value.key = this.store.decodeKey(slow.key);
+			if (includeValues && slow.value !== void 0) value.value = this.store.decodeValue(slow.value);
+		}
 		return {
 			done: false,
 			value
 		};
 	}
 	return(value) {
-		if (this.iterator.return) return this.iterator.return(value);
+		this.iterator.return?.();
 		return {
 			done: true,
 			value
 		};
 	}
 	throw(err) {
-		if (this.iterator.throw) return this.iterator.throw(err);
+		this.iterator.throw?.(err);
 		throw err;
 	}
 };
@@ -538,10 +558,17 @@ function createFixedBuffer(size) {
 
 //#endregion
 //#region src/store.ts
-const { ONLY_IF_IN_MEMORY_CACHE_FLAG, NOT_IN_MEMORY_CACHE_FLAG, ALWAYS_CREATE_NEW_BUFFER_FLAG } = constants;
+const { ONLY_IF_IN_MEMORY_CACHE_FLAG, NOT_IN_MEMORY_CACHE_FLAG, ALWAYS_CREATE_NEW_BUFFER_FLAG, ITERATOR_REVERSE_FLAG, ITERATOR_INCLUSIVE_END_FLAG, ITERATOR_EXCLUSIVE_START_FLAG, ITERATOR_INCLUDE_VALUES_FLAG, ITERATOR_NEEDS_STABLE_VALUE_BUFFER_FLAG, ITERATOR_CONTEXT_IS_TRANSACTION_FLAG } = constants;
 const KEY_BUFFER_SIZE = 4096;
 const KEY_BUFFER = createFixedBuffer(KEY_BUFFER_SIZE);
 const VALUE_BUFFER = createFixedBuffer(64 * 1024);
+/**
+* Backing buffer for the shared iterator state. Layout (Uint32Array view):
+*   [0] = key length written into KEY_BUFFER by the most recent iterator step
+*   [1] = value length written into VALUE_BUFFER by the most recent step
+*/
+const ITERATOR_STATE_BUFFER = Buffer.allocUnsafeSlow(8);
+const ITERATOR_STATE = new Uint32Array(ITERATOR_STATE_BUFFER.buffer, ITERATOR_STATE_BUFFER.byteOffset, 2);
 const MAX_KEY_SIZE = 1024 * 1024;
 const RESET_BUFFER_MODE = 1024;
 const REUSE_BUFFER_MODE = 512;
@@ -720,6 +747,52 @@ var Store = class {
 		this.db.close();
 	}
 	/**
+	* Compacts the entire key range of the database asynchronously.
+	* This triggers manual compaction which removes tombstones and reclaims space.
+	*
+	* @example
+	* ```typescript
+	* const db = RocksDatabase.open('/path/to/database');
+	* await db.compact();
+	* ```
+	*/
+	compact(options) {
+		let startBuffer;
+		let endBuffer;
+		if (options?.start !== void 0) {
+			const start = this.encodeKey(options.start);
+			startBuffer = Buffer.from(start.subarray(start.start, start.end));
+		}
+		if (options?.end !== void 0) {
+			const end = this.encodeKey(options.end);
+			endBuffer = Buffer.from(end.subarray(end.start, end.end));
+		}
+		return new Promise((resolve, reject) => this.db.compact(resolve, reject, startBuffer, endBuffer));
+	}
+	/**
+	* Compacts the entire key range of the database synchronously.
+	* This triggers manual compaction which removes tombstones and reclaims space.
+	*
+	* @example
+	* ```typescript
+	* const db = RocksDatabase.open('/path/to/database');
+	* db.compactSync();
+	* ```
+	*/
+	compactSync(options) {
+		let startBuffer;
+		let endBuffer;
+		if (options?.start !== void 0) {
+			const start = this.encodeKey(options.start);
+			startBuffer = Buffer.from(start.subarray(start.start, start.end));
+		}
+		if (options?.end !== void 0) {
+			const end = this.encodeKey(options.end);
+			endBuffer = Buffer.from(end.subarray(end.start, end.end));
+		}
+		this.db.compactSync(startBuffer, endBuffer);
+	}
+	/**
 	* Decodes a key from the database.
 	*
 	* @param key - The key to decode.
@@ -807,27 +880,45 @@ var Store = class {
 	}
 	getRange(context, options) {
 		if (!this.db.opened) throw new Error("Database not open");
-		options = { ...options };
-		const unencodedStartKey = options.key ?? options.start;
-		if (unencodedStartKey !== void 0) {
-			const start = this.encodeKey(unencodedStartKey);
-			options.start = Buffer.from(start.subarray(start.start, start.end));
+		let startUnencoded = options?.key ?? options?.start;
+		let endUnencoded = options?.key ?? options?.end;
+		const includeValues = options?.values ?? true;
+		const reverse = options?.reverse ?? false;
+		let exclusiveStart = options?.exclusiveStart ?? false;
+		let inclusiveEnd = options?.inclusiveEnd ?? false;
+		if (options?.key !== void 0) inclusiveEnd = true;
+		if (reverse) {
+			const tmp = startUnencoded;
+			startUnencoded = endUnencoded;
+			endUnencoded = tmp;
+			exclusiveStart = options?.exclusiveStart ?? true;
+			inclusiveEnd = options?.inclusiveEnd ?? true;
 		}
-		if (options.key !== void 0) {
-			options.end = options.start;
-			options.inclusiveEnd = true;
-		} else if (options.end !== void 0) {
-			const end = this.encodeKey(options.end);
-			options.end = Buffer.from(end.subarray(end.start, end.end));
+		const keyBuffer = this.keyBuffer;
+		let startKeyEnd = 0;
+		let endKeyStart = 0;
+		let endKeyEnd = 0;
+		if (startUnencoded !== void 0) {
+			startKeyEnd = this.writeKey(startUnencoded, keyBuffer, 0);
+			if (startKeyEnd === 0) throw new Error("Zero length key is not allowed");
 		}
-		if (options.reverse) {
-			const start = options.start;
-			options.start = options.end;
-			options.end = start;
-			options.exclusiveStart = options.exclusiveStart ?? true;
-			options.inclusiveEnd = options.inclusiveEnd ?? true;
+		if (endUnencoded !== void 0) if (endUnencoded === startUnencoded) {
+			endKeyStart = 0;
+			endKeyEnd = startKeyEnd;
+		} else {
+			endKeyStart = startKeyEnd;
+			endKeyEnd = this.writeKey(endUnencoded, keyBuffer, endKeyStart);
+			if (endKeyEnd === endKeyStart) throw new Error("Zero length key is not allowed");
 		}
-		return new ExtendedIterable(new DBIterator(new NativeIterator(context, options), this, options));
+		let flags = 0;
+		if (reverse) flags |= ITERATOR_REVERSE_FLAG;
+		if (exclusiveStart) flags |= ITERATOR_EXCLUSIVE_START_FLAG;
+		if (inclusiveEnd) flags |= ITERATOR_INCLUSIVE_END_FLAG;
+		if (includeValues) flags |= ITERATOR_INCLUDE_VALUES_FLAG;
+		if (includeValues && !this.decoderCopies) flags |= ITERATOR_NEEDS_STABLE_VALUE_BUFFER_FLAG;
+		if (context !== this.db) flags |= ITERATOR_CONTEXT_IS_TRANSACTION_FLAG;
+		const advancedOptions = options !== void 0 && (options.adaptiveReadahead !== void 0 || options.asyncIO !== void 0 || options.autoReadaheadSize !== void 0 || options.backgroundPurgeOnIteratorCleanup !== void 0 || options.fillCache !== void 0 || options.readaheadSize !== void 0 || options.tailing !== void 0) ? options : void 0;
+		return new ExtendedIterable(new DBIterator(new NativeIterator(context, flags, startKeyEnd, endKeyStart, endKeyEnd, advancedOptions), this, includeValues));
 	}
 	getSync(context, key, alwaysCreateNewBuffer = false, options) {
 		const keyParam = getKeyParam(this.encodeKey(key));
@@ -1194,6 +1285,32 @@ var RocksDatabase = class RocksDatabase extends DBI {
 		this.store.close();
 	}
 	/**
+	* Compacts the entire key range of the database asynchronously.
+	* This triggers manual compaction which removes tombstones and reclaims space.
+	*
+	* @example
+	* ```typescript
+	* const db = RocksDatabase.open('/path/to/database');
+	* await db.compact();
+	* ```
+	*/
+	compact(options) {
+		return this.store.compact(options);
+	}
+	/**
+	* Compacts the entire key range of the database synchronously.
+	* This triggers manual compaction which removes tombstones and reclaims space.
+	*
+	* @example
+	* ```typescript
+	* const db = RocksDatabase.open('/path/to/database');
+	* db.compactSync();
+	* ```
+	*/
+	compactSync(options) {
+		return this.store.compactSync(options);
+	}
+	/**
 	* Returns the list of column families in the RocksDB database.
 	*/
 	get columns() {
@@ -1275,6 +1392,19 @@ var RocksDatabase = class RocksDatabase extends DBI {
 		return this.store.db.getDBProperty(propertyName);
 	}
 	/**
+	* Retrieves the estimated number of keys in the database.
+	*
+	* @example
+	* ```typescript
+	* const db = RocksDatabase.open('/path/to/database');
+	* const estimated = db.getEstimatedKeyCount();
+	* console.log(estimated);
+	* ```
+	*/
+	getEstimatedKeyCount() {
+		return this.getDBIntProperty("rocksdb.estimate-num-keys") ?? 0;
+	}
+	/**
 	* Returns the current timestamp as a monotonically increasing timestamp in
 	* milliseconds represented as a decimal number.
 	*
@@ -1413,6 +1543,7 @@ var RocksDatabase = class RocksDatabase extends DBI {
 		if (store.open()) return this;
 		store.db.setDefaultValueBuffer(VALUE_BUFFER);
 		store.db.setDefaultKeyBuffer(KEY_BUFFER);
+		store.db.setIteratorState(ITERATOR_STATE_BUFFER);
 		/**
 		* The encoder initialization precedence is:
 		* 1. encoder.Encoder
@@ -1784,6 +1915,7 @@ Object.defineProperty(TransactionLog.prototype, "query", { value({ start, end, e
 			logBuffer.logId = 0;
 			logBuffer.size = 0;
 			logBuffer.dataView = new DataView(logBuffer.buffer);
+			size = 0;
 		}
 	}
 	dataView = logBuffer.dataView;
@@ -1911,7 +2043,7 @@ function loadLastPosition(transactionLog, readUncommitted) {
 //#region src/index.ts
 const versions = {
 	rocksdb: version,
-	"rocksdb-js": "1.1.1"
+	"rocksdb-js": "1.2.0"
 };
 
 //#endregion