@nxtedition/slice 1.1.7 → 1.1.8

package/lib/index.d.ts

@@ -10,6 +10,21 @@ export declare class Slice {
     byteLength: number;
     maxByteLength: number;
     static get EMPTY_BUF(): Buffer;
+    /**
+     * Fast factory for the common case of wrapping a full Buffer with no
+     * offset and no separate maxByteLength. Skips all the constructor's
+     * validation (Buffer instanceof check, byteOffset/byteLength range
+     * checks, integer checks, maxByteLength bounds). Use only when the
+     * caller already knows the input is a Buffer — e.g. wrapping freshly
+     * received network frames on a hot path.
+     *
+     * Note: instances produced here have a slightly different V8 hidden
+     * class than instances produced via `new Slice(buf)`. That introduces
+     * polymorphism at any downstream IC that reads slice fields. Measure
+     * end-to-end before adopting in code paths where consumers do heavy
+     * field access.
+     */
+    static fromBuffer(buffer: Buffer): Slice;
     constructor(buffer?: Buffer<ArrayBufferLike>, byteOffset?: number, byteLength?: number, maxByteLength?: number);
     reset(): void;
     get length(): number;

package/lib/index.js

@@ -18,6 +18,30 @@ export class Slice {
     return EMPTY_BUF
   }
 
+  /**
+   * Fast factory for the common case of wrapping a full Buffer with no
+   * offset and no separate maxByteLength. Skips all the constructor's
+   * validation (Buffer instanceof check, byteOffset/byteLength range
+   * checks, integer checks, maxByteLength bounds). Use only when the
+   * caller already knows the input is a Buffer — e.g. wrapping freshly
+   * received network frames on a hot path.
+   *
+   * Note: instances produced here have a slightly different V8 hidden
+   * class than instances produced via `new Slice(buf)`. That introduces
+   * polymorphism at any downstream IC that reads slice fields. Measure
+   * end-to-end before adopting in code paths where consumers do heavy
+   * field access.
+   */
+  static fromBuffer(buffer        )        {
+    const slice = Object.create(Slice.prototype)         
+    const len = buffer.byteLength
+    slice.buffer = buffer
+    slice.byteOffset = 0
+    slice.byteLength = len
+    slice.maxByteLength = len
+    return slice
+  }
+
   constructor(
     buffer = Slice.EMPTY_BUF,
     byteOffset = 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nxtedition/slice",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -30,5 +30,5 @@
     "tsd": "^0.33.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "7c9c7457c885c644c7a1e70ef894d4727ce240d6"
+  "gitHead": "088f6e6d615d4eeee0b2e317c9011dfa57308cc9"
 }