@harperfast/rocksdb-js 1.4.2 → 1.5.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;
@@ -1361,6 +1365,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();
 	}
@@ -2107,7 +2165,7 @@ function loadLastPosition(transactionLog, readUncommitted) {
 //#region src/index.ts
 const versions = {
 	rocksdb: version,
-	"rocksdb-js": "1.4.2"
+	"rocksdb-js": "1.5.0"
 };
 
 //#endregion