@exodus/bytes 1.0.0-rc.9 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exodus/bytes",
-  "version": "1.0.0-rc.9",
+  "version": "1.1.0",
   "description": "Various operations on Uint8Array data",
   "scripts": {
     "lint": "eslint .",
@@ -39,13 +39,14 @@
   },
   "homepage": "https://github.com/ExodusOSS/bytes#readme",
   "engines": {
-    "node": "^20.19.0 || >=22.13.0"
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
   },
   "type": "module",
   "files": [
     "/fallback/_utils.js",
     "/fallback/base32.js",
     "/fallback/base64.js",
+    "/fallback/encoding.js",
     "/fallback/encoding.labels.js",
     "/fallback/encoding.util.js",
     "/fallback/hex.js",
@@ -59,14 +60,19 @@
     "/fallback/utf16.js",
     "/fallback/utf8.js",
     "/array.js",
+    "/array.d.ts",
     "/assert.js",
     "/base32.js",
     "/base58.js",
     "/base58check.js",
     "/base64.js",
+    "/base64.d.ts",
     "/bech32.js",
+    "/bigint.js",
     "/encoding.js",
+    "/encoding-lite.js",
     "/hex.js",
+    "/hex.d.ts",
     "/hex.node.js",
     "/multi-byte.js",
     "/multi-byte.node.js",
@@ -75,17 +81,26 @@
     "/utf16.js",
     "/utf16.node.js",
     "/utf8.js",
+    "/utf8.d.ts",
     "/utf8.node.js",
     "/wif.js"
   ],
   "exports": {
-    "./array.js": "./array.js",
+    "./array.js": {
+      "types": "./array.d.ts",
+      "default": "./array.js"
+    },
     "./base32.js": "./base32.js",
     "./base58.js": "./base58.js",
     "./base58check.js": "./base58check.js",
-    "./base64.js": "./base64.js",
+    "./base64.js": {
+      "types": "./base64.d.ts",
+      "default": "./base64.js"
+    },
     "./bech32.js": "./bech32.js",
+    "./bigint.js": "./bigint.js",
     "./hex.js": {
+      "types": "./hex.d.ts",
       "node": "./hex.node.js",
       "default": "./hex.js"
     },
@@ -98,11 +113,13 @@
       "default": "./single-byte.js"
     },
     "./encoding.js": "./encoding.js",
+    "./encoding-lite.js": "./encoding-lite.js",
     "./utf16.js": {
       "node": "./utf16.node.js",
       "default": "./utf16.js"
     },
     "./utf8.js": {
+      "types": "./utf8.d.ts",
       "node": "./utf8.node.js",
       "default": "./utf8.js"
     },
@@ -126,9 +143,10 @@
     "@scure/base": "^1.2.6",
     "@stablelib/base64": "^2.0.1",
     "@stablelib/hex": "^2.0.1",
-    "@types/node": "^22.13.0",
+    "@types/node": "^22.12.0",
     "base-x": "^5.0.1",
     "base32.js": "^0.1.0",
+    "base58-js": "^3.0.3",
     "base64-js": "^1.5.1",
     "bech32": "^2.0.0",
     "bs58": "^6.0.0",
@@ -144,7 +162,7 @@
     "hextreme": "^1.0.7",
     "hi-base32": "^0.5.1",
     "iconv-lite": "^0.7.0",
-    "jsvu": "^3.0.0",
+    "jsvu": "^3.0.3",
     "text-encoding": "^0.7.0",
     "typescript": "^5.9.3",
     "uint8array-tools": "^0.0.9",

package/single-byte.js

@@ -29,7 +29,6 @@ function shouldUseNative(enc) {
 }
 
 export function createSinglebyteDecoder(encoding, loose = false) {
-  if (encoding === 'iso-8859-8-i') encoding = 'iso-8859-8'
   assertEncoding(encoding)
 
   if (canDecoders && shouldUseNative(encoding)) {

package/single-byte.node.js

@@ -1,7 +1,7 @@
 import { assertUint8 } from './assert.js'
 import { isAscii } from 'node:buffer'
 import { isDeno, isLE } from './fallback/_utils.js'
-import { asciiPrefix, decodeLatin1 } from './fallback/latin1.js'
+import { asciiPrefix } from './fallback/latin1.js'
 import { encodingMapper, encodingDecoder, E_STRICT } from './fallback/single-byte.js'
 
 const toBuf = (x) => Buffer.from(x.buffer, x.byteOffset, x.byteLength)
@@ -24,8 +24,7 @@ function latin1Prefix(arr, start) {
 }
 
 export function createSinglebyteDecoder(encoding, loose = false) {
-  if (encoding === 'iso-8859-8-i') encoding = 'iso-8859-8'
-  const latin1path = encoding === 'windows-1252' // TODO: are there more?
+  const latin1path = encoding === 'windows-1252'
   if (isDeno) {
     const jsDecoder = encodingDecoder(encoding) // asserts
     return (arr) => {
@@ -52,8 +51,9 @@ export function createSinglebyteDecoder(encoding, loose = false) {
       if (prefixBytes === arr.length) return prefix
     }
 
-    const b = mapper(arr, prefix.length) // prefix.length can mismatch prefixBytes
-    const suffix = isLE ? toBuf(b).ucs2Slice(0, b.byteLength) : decodeLatin1(b, 0, b.length) // decodeLatin1 is actually capable of decoding 16-bit codepoints
+    const b = toBuf(mapper(arr, prefix.length)) // prefix.length can mismatch prefixBytes
+    if (!isLE) b.swap16()
+    const suffix = b.ucs2Slice(0, b.byteLength)
     if (!loose && incomplete && suffix.includes('\uFFFD')) throw new TypeError(E_STRICT)
     return prefix + suffix
   }

package/utf8.d.ts

@@ -0,0 +1,42 @@
+/// <reference types="node" />
+
+import type { OutputFormat, Uint8ArrayBuffer } from './array.js';
+
+/**
+ * Encodes a string to UTF-8 bytes (strict mode)
+ * Throws on invalid Unicode (unpaired surrogates)
+ * @param str - The string to encode
+ * @param format - Output format (default: 'uint8')
+ * @returns The encoded bytes
+ */
+export function utf8fromString(str: string, format?: 'uint8'): Uint8ArrayBuffer;
+export function utf8fromString(str: string, format: 'buffer'): Buffer;
+export function utf8fromString(str: string, format?: OutputFormat): Uint8ArrayBuffer | Buffer;
+
+/**
+ * Encodes a string to UTF-8 bytes (loose mode)
+ * Replaces invalid Unicode with replacement character
+ * @param str - The string to encode
+ * @param format - Output format (default: 'uint8')
+ * @returns The encoded bytes
+ */
+export function utf8fromStringLoose(str: string, format?: 'uint8'): Uint8ArrayBuffer;
+export function utf8fromStringLoose(str: string, format: 'buffer'): Buffer;
+export function utf8fromStringLoose(str: string, format?: OutputFormat): Uint8ArrayBuffer | Buffer;
+
+/**
+ * Decodes UTF-8 bytes to a string (strict mode)
+ * Throws on invalid UTF-8 sequences
+ * @param arr - The bytes to decode
+ * @returns The decoded string
+ */
+export function utf8toString(arr: Uint8ArrayBuffer): string;
+
+/**
+ * Decodes UTF-8 bytes to a string (loose mode)
+ * Replaces invalid sequences with replacement character
+ * @param arr - The bytes to decode
+ * @returns The decoded string
+ */
+export function utf8toStringLoose(arr: Uint8ArrayBuffer): string;
+