@harperfast/rocksdb-js 1.4.2 → 2.0.0

package/dist/index.d.cts

@@ -1146,6 +1146,48 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   * ```
   */
   static config(options: RocksDatabaseConfig): void;
+  /**
+  * Registers a process-wide event listener. Internal events emitted by the
+  * native binding use namespaced keys (e.g. `'transactionLog:warning'`).
+  *
+  * Listeners are not tied to any specific database — they fire for every
+  * matching event emitted in this process.
+  *
+  * @example
+  * ```typescript
+  * RocksDatabase.on('transactionLog:warning', (warning) => {
+  *   console.warn(warning);
+  * });
+  * ```
+  */
+  static on(event: string, callback: (...args: any[]) => void): void;
+  /**
+  * Alias for {@link RocksDatabase.on}, mirroring the Node `EventEmitter` API.
+  */
+  static addListener(event: string, callback: (...args: any[]) => void): void;
+  /**
+  * Removes a previously-registered process-wide event listener. The
+  * callback identity must match the one passed to {@link RocksDatabase.on}.
+  *
+  * @returns `true` if a matching listener was removed.
+  */
+  static off(event: string, callback: (...args: any[]) => void): boolean;
+  /**
+  * Alias for {@link RocksDatabase.off}, mirroring the Node `EventEmitter` API.
+  */
+  static removeListener(event: string, callback: (...args: any[]) => void): boolean;
+  /**
+  * Returns the number of process-wide listeners registered for the given event.
+  */
+  static listenerCount(event: string): number;
+  /**
+  * Emits a process-wide event. Mostly intended for tests and as a peer to
+  * {@link RocksDatabase.on} — native code should call `emitGlobalEvent` in
+  * `napi/global_events.h` directly rather than round-tripping through JS.
+  *
+  * @returns `true` if there was at least one listener.
+  */
+  static notify(event: string, ...args: any[]): boolean;
   destroy(): void;
   drop(): Promise<void>;
   dropSync(): void;

package/dist/index.d.mts

@@ -1146,6 +1146,48 @@ declare class RocksDatabase extends DBI<DBITransactional> {
   * ```
   */
   static config(options: RocksDatabaseConfig): void;
+  /**
+  * Registers a process-wide event listener. Internal events emitted by the
+  * native binding use namespaced keys (e.g. `'transactionLog:warning'`).
+  *
+  * Listeners are not tied to any specific database — they fire for every
+  * matching event emitted in this process.
+  *
+  * @example
+  * ```typescript
+  * RocksDatabase.on('transactionLog:warning', (warning) => {
+  *   console.warn(warning);
+  * });
+  * ```
+  */
+  static on(event: string, callback: (...args: any[]) => void): void;
+  /**
+  * Alias for {@link RocksDatabase.on}, mirroring the Node `EventEmitter` API.
+  */
+  static addListener(event: string, callback: (...args: any[]) => void): void;
+  /**
+  * Removes a previously-registered process-wide event listener. The
+  * callback identity must match the one passed to {@link RocksDatabase.on}.
+  *
+  * @returns `true` if a matching listener was removed.
+  */
+  static off(event: string, callback: (...args: any[]) => void): boolean;
+  /**
+  * Alias for {@link RocksDatabase.off}, mirroring the Node `EventEmitter` API.
+  */
+  static removeListener(event: string, callback: (...args: any[]) => void): boolean;
+  /**
+  * Returns the number of process-wide listeners registered for the given event.
+  */
+  static listenerCount(event: string): number;
+  /**
+  * Emits a process-wide event. Mostly intended for tests and as a peer to
+  * {@link RocksDatabase.on} — native code should call `emitGlobalEvent` in
+  * `napi/global_events.h` directly rather than round-tripping through JS.
+  *
+  * @returns `true` if there was at least one listener.
+  */
+  static notify(event: string, ...args: any[]): boolean;
   destroy(): void;
   drop(): Promise<void>;
   dropSync(): void;

package/dist/index.mjs

@@ -55,6 +55,10 @@ function locateBinding() {
 }
 const binding = req(locateBinding());
 const config = binding.config;
+const addGlobalListener = binding.addListener;
+const removeGlobalListener = binding.removeListener;
+const globalListenerCount = binding.listenerCount;
+const globalNotify = binding.notify;
 const constants = binding.constants;
 const NativeDatabase = binding.Database;
 const NativeIterator = binding.Iterator;
@@ -570,8 +574,6 @@ const VALUE_BUFFER = createFixedBuffer(64 * 1024);
 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;
 const SAVE_BUFFER_SIZE = 8192;
 /**
 * A store wraps the `NativeDatabase` binding and database settings so that a
@@ -861,7 +863,7 @@ var Store = class {
 	encodeValue(value) {
 		if (value && value["binary-data"]) return value["binary-data"];
 		if (typeof this.encoder?.encode === "function") {
-			if (this.encoder.copyBuffers) return this.encoder.encode(value, REUSE_BUFFER_MODE | RESET_BUFFER_MODE);
+			if (this.encoder.copyBuffers) return this.encoder.encode(value, 1536);
 			const valueBuffer = this.encoder.encode(value);
 			if (typeof valueBuffer === "string") return Buffer.from(valueBuffer);
 			return valueBuffer;
@@ -1361,6 +1363,60 @@ var RocksDatabase = class RocksDatabase extends DBI {
 	static config(options) {
 		config(options);
 	}
+	/**
+	* Registers a process-wide event listener. Internal events emitted by the
+	* native binding use namespaced keys (e.g. `'transactionLog:warning'`).
+	*
+	* Listeners are not tied to any specific database — they fire for every
+	* matching event emitted in this process.
+	*
+	* @example
+	* ```typescript
+	* RocksDatabase.on('transactionLog:warning', (warning) => {
+	*   console.warn(warning);
+	* });
+	* ```
+	*/
+	static on(event, callback) {
+		addGlobalListener(event, callback);
+	}
+	/**
+	* Alias for {@link RocksDatabase.on}, mirroring the Node `EventEmitter` API.
+	*/
+	static addListener(event, callback) {
+		addGlobalListener(event, callback);
+	}
+	/**
+	* Removes a previously-registered process-wide event listener. The
+	* callback identity must match the one passed to {@link RocksDatabase.on}.
+	*
+	* @returns `true` if a matching listener was removed.
+	*/
+	static off(event, callback) {
+		return removeGlobalListener(event, callback);
+	}
+	/**
+	* Alias for {@link RocksDatabase.off}, mirroring the Node `EventEmitter` API.
+	*/
+	static removeListener(event, callback) {
+		return removeGlobalListener(event, callback);
+	}
+	/**
+	* Returns the number of process-wide listeners registered for the given event.
+	*/
+	static listenerCount(event) {
+		return globalListenerCount(event);
+	}
+	/**
+	* Emits a process-wide event. Mostly intended for tests and as a peer to
+	* {@link RocksDatabase.on} — native code should call `emitGlobalEvent` in
+	* `napi/global_events.h` directly rather than round-tripping through JS.
+	*
+	* @returns `true` if there was at least one listener.
+	*/
+	static notify(event, ...args) {
+		return globalNotify(event, args);
+	}
 	destroy() {
 		this.store.db.destroy();
 	}
@@ -1836,7 +1892,6 @@ var RocksDatabase = class RocksDatabase extends DBI {
 //#region src/parse-transaction-log.ts
 const { TRANSACTION_LOG_TOKEN, TRANSACTION_LOG_ENTRY_HEADER_SIZE: TRANSACTION_LOG_ENTRY_HEADER_SIZE$1 } = constants;
 const MIN_VALID_TIMESTAMP = Date.UTC(2026, 0, 27);
-const VALID_FLAGS_MASK = 1;
 /**
 * Loads an entire transaction log file into memory.
 * @param path - The path to the transaction log file.
@@ -1890,7 +1945,7 @@ function parseTransactionLog(path, options = {}) {
 			const data = read(length);
 			const entryAnomalies = [];
 			if (!Number.isFinite(timestamp) || timestamp < MIN_VALID_TIMESTAMP) entryAnomalies.push(`timestamp ${timestamp} predates 2026-01-27 (possible corruption)`);
-			if ((flags & ~VALID_FLAGS_MASK) !== 0) entryAnomalies.push(`flags 0x${flags.toString(16).padStart(2, "0")} contains undefined bits (expected 0x00 or 0x01)`);
+			if ((flags & -2) !== 0) entryAnomalies.push(`flags 0x${flags.toString(16).padStart(2, "0")} contains undefined bits (expected 0x00 or 0x01)`);
 			const entry = {
 				timestamp,
 				length,
@@ -2107,7 +2162,7 @@ function loadLastPosition(transactionLog, readUncommitted) {
 //#region src/index.ts
 const versions = {
 	rocksdb: version,
-	"rocksdb-js": "1.4.2"
+	"rocksdb-js": "2.0.0"
 };
 
 //#endregion