extended-buffer 7.5.0 → 7.5.1

package/README.md

@@ -30,8 +30,17 @@ If your bundler does not expose `Buffer` globally, add a small shim in your app
 ```ts
 import { Buffer } from "buffer";
 
-if (!globalThis.Buffer) {
-  globalThis.Buffer = Buffer;
+const globalScope: any =
+  typeof globalThis !== "undefined"
+    ? globalThis
+    : typeof self !== "undefined"
+      ? self
+      : typeof window !== "undefined"
+        ? window
+        : undefined;
+
+if (globalScope && !globalScope.Buffer) {
+  globalScope.Buffer = Buffer;
 }
 ```
 
@@ -64,7 +73,7 @@ import { defineConfig } from "vite";
 export default defineConfig({
   resolve: {
     alias: {
-      buffer: "buffer"
+      buffer: "buffer/"
     }
   },
   optimizeDeps: {
@@ -400,6 +409,7 @@ Rules:
 
 - If the callback **returns normally**, changes are kept (committed).
 - If the callback **throws**, the buffer is restored (rolled back) and the error is re-thrown.
+- The callback must be **synchronous** (returned Promises are not awaited).
 - Transactions are **re-entrant**: nested `transaction()` calls do not create extra snapshots.
 
 What gets rolled back:
@@ -510,7 +520,7 @@ Common error codes you may see:
 - `VALUE_MUST_BE_AN_BIG_INTEGER`: value is not a `bigint`
 - `VALUE_MUST_BE_AN_UNSIGNED_BIG_INTEGER`: value is not a `bigint` or less than 0
 - `EXECUTION_ENVIRONMENT_NOT_SUPPORT_BIG_INT`: BigInt methods are not supported in the current runtime
-- `EXCEEDING_MAXIMUM_BUFFER_SIZE`: allocation exceeds Node’s `kMaxLength` or `os.totalmem()`
+- `EXCEEDING_MAXIMUM_BUFFER_SIZE`: allocation exceeds Node’s maximum buffer size (`kMaxLength` or `os.totalmem()` when available)
 
 ---
 
@@ -530,8 +540,8 @@ b.writeUInt16BE(123, true);
 
 ### `nodeGc()` is Node-specific
 
-`nodeGc()` calls `global.gc()` if it exists. In Node.js it requires starting the process with `--expose-gc`.
-In non-Node runtimes, `global` may not exist.
+`nodeGc()` calls `gc()` on the detected global object if it exists. In Node.js it requires starting the process with `--expose-gc`.
+In browsers/non-Node runtimes it simply no-ops.
 
 ---
 

package/dist/utils/alloc-native-buffer.js

@@ -5,13 +5,35 @@ exports.allocNativeBuffer = allocNativeBuffer;
 const buffer_1 = require("buffer");
 const errors_1 = require("../errors");
 const assert_unsigned_integer_1 = require("./assert-unsigned-integer");
-const maxBufferSize = typeof buffer_1.kMaxLength === 'number'
+const totalMem = (function () {
+    try {
+        const req = typeof module !== 'undefined' && typeof module.require === 'function'
+            ? module.require.bind(module)
+            : typeof require === 'function'
+                ? require
+                : undefined;
+        if (!req) {
+            return undefined;
+        }
+        const os = req('os');
+        if (typeof (os === null || os === void 0 ? void 0 : os.totalmem) !== 'function') {
+            return undefined;
+        }
+        const result = os.totalmem();
+        return Number.isSafeInteger(result) && result > 0 ? result : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+})();
+const fallbackMaxLength = typeof buffer_1.kMaxLength === 'number'
     ? buffer_1.kMaxLength
     : typeof buffer_1.Buffer.kMaxLength === 'number'
         ? buffer_1.Buffer.kMaxLength
         : typeof ((_a = buffer_1.Buffer.constants) === null || _a === void 0 ? void 0 : _a.MAX_LENGTH) === 'number'
             ? buffer_1.Buffer.constants.MAX_LENGTH
             : Number.MAX_SAFE_INTEGER;
+const maxBufferSize = typeof totalMem === 'number' ? Math.min(fallbackMaxLength, totalMem) : fallbackMaxLength;
 (0, assert_unsigned_integer_1.assertUnsignedInteger)(maxBufferSize);
 function allocNativeBuffer(size, allocSlow) {
     (0, assert_unsigned_integer_1.assertUnsignedInteger)(size);

package/dist/utils/assert-support-big-integer.js

@@ -3,13 +3,20 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertSupportBigInteger = assertSupportBigInteger;
 const buffer_1 = require("buffer");
 const errors_1 = require("../errors");
+const requiredMethods = [
+    'readBigUInt64LE',
+    'readBigUInt64BE',
+    'readBigInt64LE',
+    'readBigInt64BE',
+    'writeBigUInt64LE',
+    'writeBigUInt64BE',
+    'writeBigInt64LE',
+    'writeBigInt64BE'
+];
+const isSupported = typeof BigInt === 'function' &&
+    requiredMethods.every(method => typeof buffer_1.Buffer.prototype[method] === 'function');
 function assertSupportBigInteger() {
-    let isSupported = false;
-    try {
-        isSupported = typeof BigInt(0) === 'bigint';
-    }
-    catch (e) { }
-    if (!isSupported || typeof buffer_1.Buffer.prototype.readBigUInt64LE !== 'function') {
+    if (!isSupported) {
         throw new errors_1.ExtendedBufferUnsupportedError('EXECUTION_ENVIRONMENT_NOT_SUPPORT_BIG_INT');
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extended-buffer",
-  "version": "7.5.0",
+  "version": "7.5.1",
   "description": "Node JS extended Buffer",
   "type": "commonjs",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "test": "node ./node_modules/.bin/mocha",
     "coverage": "node ./node_modules/.bin/nyc --reporter=lcov --reporter=html --reporter=text ./node_modules/.bin/mocha",
     "clean": "node -e \"['./dist', './coverage', './.nyc_output'].forEach(item => require('fs').rmSync(item, {recursive:true,force:true}));\"",
-    "prepack": "npm run build"
+    "prepack": "npm run build && npm run test"
   },
   "engines": {
     "node": ">=6.0.0"