@oschwald/maxminddb 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.1] - 2026-07-03
+
+* Test fix. No other changes.
+
+## [0.2.0] - 2026-07-03
+
+### Changed
+
+- Updated the Rust `maxminddb` dependency to 0.29.0 and refreshed Rust and npm
+  development dependencies.
+- Coalesced watched file reload events so bursts trigger fewer duplicate reloads
+  and hook calls while preserving serialized reloads.
+
+### Performance
+
+- Decoded path lookup results directly into JavaScript values to reduce
+  intermediate allocations for `getPath()`, `getManyPath()`, and compiled path
+  lookups.
+- Decoded network iteration records directly into JavaScript values to reduce
+  intermediate allocations for `networks()`, `within()`, and paginated network
+  iteration.
+
 ## [0.1.0] - 2026-06-14
 
 ### Added
@@ -61,4 +83,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added Rust formatting, `cargo check`, clippy, TypeScript, Node test, npm pack,
   and packed-package smoke-test validation.
 
+[0.2.0]: https://github.com/oschwald/maxminddb-node/releases/tag/v0.2.0
 [0.1.0]: https://github.com/oschwald/maxminddb-node/releases/tag/v0.1.0

package/README.md

@@ -16,8 +16,11 @@ npm install @oschwald/maxminddb
 
 ## Usage
 
+These examples use ES modules. Save them as `.mjs`, or set `"type": "module"`
+in your `package.json`.
+
 ```js
-const maxmind = require('@oschwald/maxminddb');
+import maxmind from '@oschwald/maxminddb';
 
 const reader = await maxmind.open('/path/to/GeoIP2-City.mmdb');
 
@@ -26,6 +29,9 @@ console.log(reader.getWithPrefixLength('8.8.8.8'));
 console.log(reader.getPath('8.8.8.8', ['country', 'iso_code']));
 ```
 
+CommonJS `require()` is also supported for compatibility with existing
+`node-maxmind` users.
+
 ## Compatibility API
 
 - `open(filepath, options?)`
@@ -116,6 +122,8 @@ Use `MODE_BUFFER` if you want `open()` to read the file into a Node `Buffer`
 before constructing the reader.
 
 ```js
+import maxmind from '@oschwald/maxminddb';
+
 const reader = await maxmind.open('/path/to/db.mmdb', {
   mode: maxmind.MODE_MEMORY,
 });

package/index.js

@@ -337,6 +337,8 @@ class Reader {
     this._filepath = null;
     this._watchFilepath = null;
     this._watchListener = null;
+    this._watchReloadActive = false;
+    this._watchReloadPending = false;
     this._watchReloadPromise = Promise.resolve();
     this._lastReloadError = null;
     this._cacheCapacity = normalizeCacheCapacity(options);
@@ -352,6 +354,8 @@ class Reader {
     reader._filepath = filepath;
     reader._watchFilepath = null;
     reader._watchListener = null;
+    reader._watchReloadActive = false;
+    reader._watchReloadPending = false;
     reader._watchReloadPromise = Promise.resolve();
     reader._lastReloadError = null;
     reader._cacheCapacity = normalizeCacheCapacity(options);
@@ -400,12 +404,35 @@ class Reader {
       this._watchFilepath = null;
       this._watchListener = null;
     }
+    this._watchReloadPending = false;
     this._reader.close();
   }
 
   _queueWatchedReload(filepath, mode, hook) {
-    const reload = () => this._reloadWatchedFile(filepath, mode, hook);
-    this._watchReloadPromise = this._watchReloadPromise.then(reload, reload);
+    this._watchReloadPending = true;
+    if (this._watchReloadActive) {
+      return;
+    }
+
+    this._watchReloadActive = true;
+    const drainReloads = async () => {
+      try {
+        while (this._watchReloadPending) {
+          this._watchReloadPending = false;
+          await this._reloadWatchedFile(filepath, mode, hook);
+        }
+      } finally {
+        this._watchReloadActive = false;
+        if (this._watchReloadPending) {
+          this._queueWatchedReload(filepath, mode, hook);
+        }
+      }
+    };
+
+    this._watchReloadPromise = this._watchReloadPromise.then(
+      drainReloads,
+      drainReloads
+    );
   }
 
   async _reloadWatchedFile(filepath, mode, hook) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oschwald/maxminddb",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Rust-backed Node.js reader for MaxMind DB files",
   "main": "index.js",
   "types": "index.d.ts",
@@ -52,8 +52,8 @@
   "license": "ISC",
   "devDependencies": {
     "@napi-rs/cli": "^3.7.2",
-    "@types/node": "^25.9.3",
-    "typescript": "^5.9.2"
+    "@types/node": "^26.1.0",
+    "typescript": "^6.0.3"
   },
   "engines": {
     "node": ">=20"