ordered-binary 1.2.2 → 1.2.5

package/README.md

@@ -32,3 +32,8 @@ The main module exports these functions:
 `toBufferKey(jsPrimitive)` - This accepts a string, number, or boolean as the argument, and returns a `Buffer`.
 
 `fromBufferKey(bufferKey, multiple)` - This accepts a Buffer and returns a JavaScript primitive value. This can also parse buffers that hold multiple values delimited by a byte `30`, by setting the second argument to true (in which case it will return an array).
+
+And these constants:
+
+`MINIMUM_KEY` - The minimum key supported (`null`, which is represented as single zero byte)
+`MAXIMUM_KEY` - A maximum key larger than any supported primitive (single 0xff byte)

package/dist/index.cjs

@@ -20,8 +20,6 @@ control character types:
 
 const float64Array = new Float64Array(2);
 const int32Array = new Int32Array(float64Array.buffer, 0, 4);
-new Uint8Array(float64Array.buffer, 2, 6);
-new Uint8Array(float64Array.buffer, 0, 8);
 let nullTerminate = false;
 let textEncoder;
 try {

package/index.d.ts

@@ -0,0 +1,23 @@
+type Key = Key[] | string | symbol | number | boolean | Uint8Array;
+/** Writes a key (a primitive value) to the target buffer, starting at the given position */
+export function writeKey(key: Key, target: Uint8Array, position: number, inSequence?: boolean): number;
+/** Reads a key from the provided buffer, from the given range */
+export function readKey(buffer: Uint8Array, start: number, end: number, inSequence?: boolean): Key;
+/** Converts key to a Buffer. This is generally much slower than using writeKey since it involves a full buffer allocation, and should be avoided for performance sensitive code. */
+export function toBufferKey(key: Key): Buffer;
+/** Coverts Buffer to Key */
+export function fromBufferKey(source: Buffer): Key;
+/** Compares two keys, returning -1 if `a` comes before `b` in the ordered binary representation of the keys, or 1 if `a` comes after `b`, or 0 if they are equivalent */
+export function compareKeys(a: Key, b: Key): number;
+/** The minimum key, with the "first" binary representation (one byte of zero) */
+export const MINIMUM_KEY: null
+/** A maximum key, with a binary representation after all other JS primitives (one byte of 0xff) */
+export const MAXIMUM_KEY: Uint8Array
+/** Enables null termination, ensuring that writing keys to buffers will end with a padding of zeros at the end to complete the following 32-bit word */
+export function enableNullTermination(): void;
+/** An object that holds the functions for encapsulation as a single encoder */
+export const encoder: {
+	writeKey: typeof writeKey,
+	readKey: typeof readKey,
+	enableNullTermination: typeof enableNullTermination,
+}

package/index.js

@@ -16,8 +16,6 @@ control character types:
 
 const float64Array = new Float64Array(2)
 const int32Array = new Int32Array(float64Array.buffer, 0, 4)
-const uint8Array6 = new Uint8Array(float64Array.buffer, 2, 6)
-const uint8Array8 = new Uint8Array(float64Array.buffer, 0, 8)
 let nullTerminate = false
 let textEncoder
 try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ordered-binary",
   "author": "Kris Zyp",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "description": "Conversion of JavaScript primitives to and from Buffer with binary order matching natural primitive order",
   "license": "MIT",
   "repository": {
@@ -14,6 +14,7 @@
     "test": "mocha tests -u tdd"
   },
   "type": "module",
+  "main": "dist/index.cjs",
   "module": "index.js",
   "exports": {
     ".": {
@@ -30,7 +31,7 @@
   "devDependencies": {
     "@types/node": "latest",
     "chai": "^4",
-    "mocha": "^9.1.3",
+    "mocha": "^9.2.0",
     "rollup": "^2.61.1"
   }
 }