@ricsam/isolate-encoding 0.1.11 → 0.1.12

package/dist/cjs/index.cjs

@@ -176,6 +176,227 @@ var encodingCode = `
 
     return result;
   };
+
+  // ============================================
+  // Buffer implementation
+  // ============================================
+
+  const BUFFER_SYMBOL = Symbol.for('__isBuffer');
+
+  class Buffer extends Uint8Array {
+    constructor(arg, encodingOrOffset, length) {
+      if (typeof arg === 'number') {
+        super(arg);
+      } else if (typeof arg === 'string') {
+        const bytes = stringToBytes(arg, encodingOrOffset || 'utf8');
+        super(bytes);
+      } else if (arg instanceof ArrayBuffer) {
+        if (typeof encodingOrOffset === 'number') {
+          super(arg, encodingOrOffset, length);
+        } else {
+          super(arg);
+        }
+      } else if (ArrayBuffer.isView(arg)) {
+        super(arg.buffer, arg.byteOffset, arg.byteLength);
+      } else if (Array.isArray(arg)) {
+        super(arg);
+      } else {
+        super(arg);
+      }
+      Object.defineProperty(this, BUFFER_SYMBOL, { value: true, writable: false });
+    }
+
+    toString(encoding = 'utf8') {
+      encoding = normalizeEncoding(encoding);
+      if (encoding === 'utf8') {
+        return new TextDecoder('utf-8').decode(this);
+      } else if (encoding === 'base64') {
+        return bytesToBase64(this);
+      } else if (encoding === 'hex') {
+        return bytesToHex(this);
+      }
+      return new TextDecoder('utf-8').decode(this);
+    }
+
+    slice(start, end) {
+      const sliced = super.slice(start, end);
+      return Buffer.from(sliced);
+    }
+
+    subarray(start, end) {
+      const sub = super.subarray(start, end);
+      const buf = new Buffer(sub.length);
+      buf.set(sub);
+      return buf;
+    }
+
+    static from(value, encodingOrOffset, length) {
+      if (typeof value === 'string') {
+        return new Buffer(value, encodingOrOffset);
+      }
+      if (value instanceof ArrayBuffer) {
+        if (typeof encodingOrOffset === 'number') {
+          return new Buffer(value, encodingOrOffset, length);
+        }
+        return new Buffer(value);
+      }
+      if (ArrayBuffer.isView(value)) {
+        return new Buffer(value);
+      }
+      if (Array.isArray(value)) {
+        return new Buffer(value);
+      }
+      if (value && typeof value[Symbol.iterator] === 'function') {
+        return new Buffer(Array.from(value));
+      }
+      throw new TypeError('First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object');
+    }
+
+    static alloc(size, fill, encoding) {
+      if (typeof size !== 'number' || size < 0) {
+        throw new RangeError('Invalid size');
+      }
+      const buf = new Buffer(size);
+      if (fill !== undefined) {
+        if (typeof fill === 'number') {
+          buf.fill(fill);
+        } else if (typeof fill === 'string') {
+          const fillBytes = stringToBytes(fill, encoding || 'utf8');
+          for (let i = 0; i < size; i++) {
+            buf[i] = fillBytes[i % fillBytes.length];
+          }
+        } else if (Buffer.isBuffer(fill) || fill instanceof Uint8Array) {
+          for (let i = 0; i < size; i++) {
+            buf[i] = fill[i % fill.length];
+          }
+        }
+      }
+      return buf;
+    }
+
+    static allocUnsafe(size) {
+      if (typeof size !== 'number' || size < 0) {
+        throw new RangeError('Invalid size');
+      }
+      return new Buffer(size);
+    }
+
+    static concat(list, totalLength) {
+      if (!Array.isArray(list)) {
+        throw new TypeError('list argument must be an array');
+      }
+      if (list.length === 0) {
+        return Buffer.alloc(0);
+      }
+      if (totalLength === undefined) {
+        totalLength = 0;
+        for (const buf of list) {
+          totalLength += buf.length;
+        }
+      }
+      const result = Buffer.alloc(totalLength);
+      let offset = 0;
+      for (const buf of list) {
+        if (offset + buf.length > totalLength) {
+          result.set(buf.subarray(0, totalLength - offset), offset);
+          break;
+        }
+        result.set(buf, offset);
+        offset += buf.length;
+      }
+      return result;
+    }
+
+    static isBuffer(obj) {
+      return obj != null && obj[BUFFER_SYMBOL] === true;
+    }
+
+    static byteLength(string, encoding = 'utf8') {
+      if (typeof string !== 'string') {
+        if (ArrayBuffer.isView(string) || string instanceof ArrayBuffer) {
+          return string.byteLength;
+        }
+        throw new TypeError('First argument must be a string, Buffer, or ArrayBuffer');
+      }
+      encoding = normalizeEncoding(encoding);
+      if (encoding === 'utf8') {
+        return new TextEncoder().encode(string).length;
+      } else if (encoding === 'base64') {
+        const padding = (string.match(/=+$/) || [''])[0].length;
+        return Math.floor((string.length * 3) / 4) - padding;
+      } else if (encoding === 'hex') {
+        return Math.floor(string.length / 2);
+      }
+      return new TextEncoder().encode(string).length;
+    }
+
+    static isEncoding(encoding) {
+      return ['utf8', 'utf-8', 'base64', 'hex'].includes(normalizeEncoding(encoding));
+    }
+  }
+
+  function normalizeEncoding(encoding) {
+    if (!encoding) return 'utf8';
+    const lower = String(encoding).toLowerCase().replace('-', '');
+    if (lower === 'utf8' || lower === 'utf-8') return 'utf8';
+    if (lower === 'base64') return 'base64';
+    if (lower === 'hex') return 'hex';
+    return lower;
+  }
+
+  function stringToBytes(str, encoding) {
+    encoding = normalizeEncoding(encoding);
+    if (encoding === 'utf8') {
+      return new TextEncoder().encode(str);
+    } else if (encoding === 'base64') {
+      return base64ToBytes(str);
+    } else if (encoding === 'hex') {
+      return hexToBytes(str);
+    }
+    return new TextEncoder().encode(str);
+  }
+
+  function base64ToBytes(str) {
+    const binary = atob(str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+  }
+
+  function bytesToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+      binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+  }
+
+  function hexToBytes(str) {
+    if (str.length % 2 !== 0) {
+      throw new TypeError('Invalid hex string');
+    }
+    const bytes = new Uint8Array(str.length / 2);
+    for (let i = 0; i < str.length; i += 2) {
+      const byte = parseInt(str.substr(i, 2), 16);
+      if (isNaN(byte)) {
+        throw new TypeError('Invalid hex string');
+      }
+      bytes[i / 2] = byte;
+    }
+    return bytes;
+  }
+
+  function bytesToHex(bytes) {
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+      hex += bytes[i].toString(16).padStart(2, '0');
+    }
+    return hex;
+  }
+
+  globalThis.Buffer = Buffer;
 })();
 `;
 async function setupEncoding(context) {
@@ -185,4 +406,4 @@ async function setupEncoding(context) {
   };
 }
 
-//# debugId=799BCB9316B516F464756E2164756E21
+//# debugId=49911E9EE082911E64756E2164756E21

package/dist/cjs/index.cjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "import type ivm from \"isolated-vm\";\n\nexport interface EncodingHandle {\n  dispose(): void;\n}\n\nconst encodingCode = `\n(function() {\n  // Define DOMException if not available\n  if (typeof DOMException === 'undefined') {\n    globalThis.DOMException = class DOMException extends Error {\n      constructor(message, name) {\n        super(message);\n        this.name = name || 'DOMException';\n      }\n    };\n  }\n\n  const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\n  // Build reverse lookup table\n  const base64Lookup = new Map();\n  for (let i = 0; i < base64Chars.length; i++) {\n    base64Lookup.set(base64Chars[i], i);\n  }\n\n  globalThis.btoa = function btoa(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Check for characters outside Latin-1 range\n    for (let i = 0; i < str.length; i++) {\n      if (str.charCodeAt(i) > 255) {\n        throw new DOMException(\n          \"The string to be encoded contains characters outside of the Latin1 range.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    if (str.length === 0) {\n      return '';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = str.charCodeAt(i++);\n      const bExists = i < str.length;\n      const b = bExists ? str.charCodeAt(i++) : 0;\n      const cExists = i < str.length;\n      const c = cExists ? str.charCodeAt(i++) : 0;\n\n      const triplet = (a << 16) | (b << 8) | c;\n\n      result += base64Chars[(triplet >> 18) & 0x3F];\n      result += base64Chars[(triplet >> 12) & 0x3F];\n      result += bExists ? base64Chars[(triplet >> 6) & 0x3F] : '=';\n      result += cExists ? base64Chars[triplet & 0x3F] : '=';\n    }\n\n    return result;\n  };\n\n  globalThis.atob = function atob(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Remove whitespace\n    str = str.replace(/[\\\\t\\\\n\\\\f\\\\r ]/g, '');\n\n    // Validate characters and length\n    if (str.length === 0) {\n      return '';\n    }\n\n    // Check for invalid characters (before padding normalization)\n    for (let i = 0; i < str.length; i++) {\n      const c = str[i];\n      if (c !== '=' && !base64Lookup.has(c)) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Validate padding position (must be at end)\n    const paddingIndex = str.indexOf('=');\n    if (paddingIndex !== -1) {\n      for (let i = paddingIndex; i < str.length; i++) {\n        if (str[i] !== '=') {\n          throw new DOMException(\n            \"The string to be decoded is not correctly encoded.\",\n            \"InvalidCharacterError\"\n          );\n        }\n      }\n      const paddingLength = str.length - paddingIndex;\n      if (paddingLength > 2) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Length without padding must be valid (can't have remainder of 1)\n    const strWithoutPadding = str.replace(/=/g, '');\n    if (strWithoutPadding.length % 4 === 1) {\n      throw new DOMException(\n        \"The string to be decoded is not correctly encoded.\",\n        \"InvalidCharacterError\"\n      );\n    }\n\n    // Pad to multiple of 4 if needed (for inputs without explicit padding)\n    while (str.length % 4 !== 0) {\n      str += '=';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = base64Lookup.get(str[i++]) ?? 0;\n      const b = base64Lookup.get(str[i++]) ?? 0;\n      const c = base64Lookup.get(str[i++]) ?? 0;\n      const d = base64Lookup.get(str[i++]) ?? 0;\n\n      const triplet = (a << 18) | (b << 12) | (c << 6) | d;\n\n      result += String.fromCharCode((triplet >> 16) & 0xFF);\n      if (str[i - 2] !== '=') {\n        result += String.fromCharCode((triplet >> 8) & 0xFF);\n      }\n      if (str[i - 1] !== '=') {\n        result += String.fromCharCode(triplet & 0xFF);\n      }\n    }\n\n    return result;\n  };\n})();\n`;\n\n/**\n * Setup encoding APIs in an isolated-vm context\n *\n * Injects atob and btoa for Base64 encoding/decoding\n *\n * @example\n * const handle = await setupEncoding(context);\n * await context.eval(`\n *   const encoded = btoa(\"hello\");\n *   const decoded = atob(encoded);\n * `);\n */\nexport async function setupEncoding(\n  context: ivm.Context\n): Promise<EncodingHandle> {\n  context.evalSync(encodingCode);\n  return {\n    dispose() {\n      // No resources to cleanup for pure JS injection\n    },\n  };\n}\n"
+    "import type ivm from \"isolated-vm\";\n\nexport interface EncodingHandle {\n  dispose(): void;\n}\n\nconst encodingCode = `\n(function() {\n  // Define DOMException if not available\n  if (typeof DOMException === 'undefined') {\n    globalThis.DOMException = class DOMException extends Error {\n      constructor(message, name) {\n        super(message);\n        this.name = name || 'DOMException';\n      }\n    };\n  }\n\n  const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\n  // Build reverse lookup table\n  const base64Lookup = new Map();\n  for (let i = 0; i < base64Chars.length; i++) {\n    base64Lookup.set(base64Chars[i], i);\n  }\n\n  globalThis.btoa = function btoa(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Check for characters outside Latin-1 range\n    for (let i = 0; i < str.length; i++) {\n      if (str.charCodeAt(i) > 255) {\n        throw new DOMException(\n          \"The string to be encoded contains characters outside of the Latin1 range.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    if (str.length === 0) {\n      return '';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = str.charCodeAt(i++);\n      const bExists = i < str.length;\n      const b = bExists ? str.charCodeAt(i++) : 0;\n      const cExists = i < str.length;\n      const c = cExists ? str.charCodeAt(i++) : 0;\n\n      const triplet = (a << 16) | (b << 8) | c;\n\n      result += base64Chars[(triplet >> 18) & 0x3F];\n      result += base64Chars[(triplet >> 12) & 0x3F];\n      result += bExists ? base64Chars[(triplet >> 6) & 0x3F] : '=';\n      result += cExists ? base64Chars[triplet & 0x3F] : '=';\n    }\n\n    return result;\n  };\n\n  globalThis.atob = function atob(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Remove whitespace\n    str = str.replace(/[\\\\t\\\\n\\\\f\\\\r ]/g, '');\n\n    // Validate characters and length\n    if (str.length === 0) {\n      return '';\n    }\n\n    // Check for invalid characters (before padding normalization)\n    for (let i = 0; i < str.length; i++) {\n      const c = str[i];\n      if (c !== '=' && !base64Lookup.has(c)) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Validate padding position (must be at end)\n    const paddingIndex = str.indexOf('=');\n    if (paddingIndex !== -1) {\n      for (let i = paddingIndex; i < str.length; i++) {\n        if (str[i] !== '=') {\n          throw new DOMException(\n            \"The string to be decoded is not correctly encoded.\",\n            \"InvalidCharacterError\"\n          );\n        }\n      }\n      const paddingLength = str.length - paddingIndex;\n      if (paddingLength > 2) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Length without padding must be valid (can't have remainder of 1)\n    const strWithoutPadding = str.replace(/=/g, '');\n    if (strWithoutPadding.length % 4 === 1) {\n      throw new DOMException(\n        \"The string to be decoded is not correctly encoded.\",\n        \"InvalidCharacterError\"\n      );\n    }\n\n    // Pad to multiple of 4 if needed (for inputs without explicit padding)\n    while (str.length % 4 !== 0) {\n      str += '=';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = base64Lookup.get(str[i++]) ?? 0;\n      const b = base64Lookup.get(str[i++]) ?? 0;\n      const c = base64Lookup.get(str[i++]) ?? 0;\n      const d = base64Lookup.get(str[i++]) ?? 0;\n\n      const triplet = (a << 18) | (b << 12) | (c << 6) | d;\n\n      result += String.fromCharCode((triplet >> 16) & 0xFF);\n      if (str[i - 2] !== '=') {\n        result += String.fromCharCode((triplet >> 8) & 0xFF);\n      }\n      if (str[i - 1] !== '=') {\n        result += String.fromCharCode(triplet & 0xFF);\n      }\n    }\n\n    return result;\n  };\n\n  // ============================================\n  // Buffer implementation\n  // ============================================\n\n  const BUFFER_SYMBOL = Symbol.for('__isBuffer');\n\n  class Buffer extends Uint8Array {\n    constructor(arg, encodingOrOffset, length) {\n      if (typeof arg === 'number') {\n        super(arg);\n      } else if (typeof arg === 'string') {\n        const bytes = stringToBytes(arg, encodingOrOffset || 'utf8');\n        super(bytes);\n      } else if (arg instanceof ArrayBuffer) {\n        if (typeof encodingOrOffset === 'number') {\n          super(arg, encodingOrOffset, length);\n        } else {\n          super(arg);\n        }\n      } else if (ArrayBuffer.isView(arg)) {\n        super(arg.buffer, arg.byteOffset, arg.byteLength);\n      } else if (Array.isArray(arg)) {\n        super(arg);\n      } else {\n        super(arg);\n      }\n      Object.defineProperty(this, BUFFER_SYMBOL, { value: true, writable: false });\n    }\n\n    toString(encoding = 'utf8') {\n      encoding = normalizeEncoding(encoding);\n      if (encoding === 'utf8') {\n        return new TextDecoder('utf-8').decode(this);\n      } else if (encoding === 'base64') {\n        return bytesToBase64(this);\n      } else if (encoding === 'hex') {\n        return bytesToHex(this);\n      }\n      return new TextDecoder('utf-8').decode(this);\n    }\n\n    slice(start, end) {\n      const sliced = super.slice(start, end);\n      return Buffer.from(sliced);\n    }\n\n    subarray(start, end) {\n      const sub = super.subarray(start, end);\n      const buf = new Buffer(sub.length);\n      buf.set(sub);\n      return buf;\n    }\n\n    static from(value, encodingOrOffset, length) {\n      if (typeof value === 'string') {\n        return new Buffer(value, encodingOrOffset);\n      }\n      if (value instanceof ArrayBuffer) {\n        if (typeof encodingOrOffset === 'number') {\n          return new Buffer(value, encodingOrOffset, length);\n        }\n        return new Buffer(value);\n      }\n      if (ArrayBuffer.isView(value)) {\n        return new Buffer(value);\n      }\n      if (Array.isArray(value)) {\n        return new Buffer(value);\n      }\n      if (value && typeof value[Symbol.iterator] === 'function') {\n        return new Buffer(Array.from(value));\n      }\n      throw new TypeError('First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object');\n    }\n\n    static alloc(size, fill, encoding) {\n      if (typeof size !== 'number' || size < 0) {\n        throw new RangeError('Invalid size');\n      }\n      const buf = new Buffer(size);\n      if (fill !== undefined) {\n        if (typeof fill === 'number') {\n          buf.fill(fill);\n        } else if (typeof fill === 'string') {\n          const fillBytes = stringToBytes(fill, encoding || 'utf8');\n          for (let i = 0; i < size; i++) {\n            buf[i] = fillBytes[i % fillBytes.length];\n          }\n        } else if (Buffer.isBuffer(fill) || fill instanceof Uint8Array) {\n          for (let i = 0; i < size; i++) {\n            buf[i] = fill[i % fill.length];\n          }\n        }\n      }\n      return buf;\n    }\n\n    static allocUnsafe(size) {\n      if (typeof size !== 'number' || size < 0) {\n        throw new RangeError('Invalid size');\n      }\n      return new Buffer(size);\n    }\n\n    static concat(list, totalLength) {\n      if (!Array.isArray(list)) {\n        throw new TypeError('list argument must be an array');\n      }\n      if (list.length === 0) {\n        return Buffer.alloc(0);\n      }\n      if (totalLength === undefined) {\n        totalLength = 0;\n        for (const buf of list) {\n          totalLength += buf.length;\n        }\n      }\n      const result = Buffer.alloc(totalLength);\n      let offset = 0;\n      for (const buf of list) {\n        if (offset + buf.length > totalLength) {\n          result.set(buf.subarray(0, totalLength - offset), offset);\n          break;\n        }\n        result.set(buf, offset);\n        offset += buf.length;\n      }\n      return result;\n    }\n\n    static isBuffer(obj) {\n      return obj != null && obj[BUFFER_SYMBOL] === true;\n    }\n\n    static byteLength(string, encoding = 'utf8') {\n      if (typeof string !== 'string') {\n        if (ArrayBuffer.isView(string) || string instanceof ArrayBuffer) {\n          return string.byteLength;\n        }\n        throw new TypeError('First argument must be a string, Buffer, or ArrayBuffer');\n      }\n      encoding = normalizeEncoding(encoding);\n      if (encoding === 'utf8') {\n        return new TextEncoder().encode(string).length;\n      } else if (encoding === 'base64') {\n        const padding = (string.match(/=+$/) || [''])[0].length;\n        return Math.floor((string.length * 3) / 4) - padding;\n      } else if (encoding === 'hex') {\n        return Math.floor(string.length / 2);\n      }\n      return new TextEncoder().encode(string).length;\n    }\n\n    static isEncoding(encoding) {\n      return ['utf8', 'utf-8', 'base64', 'hex'].includes(normalizeEncoding(encoding));\n    }\n  }\n\n  function normalizeEncoding(encoding) {\n    if (!encoding) return 'utf8';\n    const lower = String(encoding).toLowerCase().replace('-', '');\n    if (lower === 'utf8' || lower === 'utf-8') return 'utf8';\n    if (lower === 'base64') return 'base64';\n    if (lower === 'hex') return 'hex';\n    return lower;\n  }\n\n  function stringToBytes(str, encoding) {\n    encoding = normalizeEncoding(encoding);\n    if (encoding === 'utf8') {\n      return new TextEncoder().encode(str);\n    } else if (encoding === 'base64') {\n      return base64ToBytes(str);\n    } else if (encoding === 'hex') {\n      return hexToBytes(str);\n    }\n    return new TextEncoder().encode(str);\n  }\n\n  function base64ToBytes(str) {\n    const binary = atob(str);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n  }\n\n  function bytesToBase64(bytes) {\n    let binary = '';\n    for (let i = 0; i < bytes.length; i++) {\n      binary += String.fromCharCode(bytes[i]);\n    }\n    return btoa(binary);\n  }\n\n  function hexToBytes(str) {\n    if (str.length % 2 !== 0) {\n      throw new TypeError('Invalid hex string');\n    }\n    const bytes = new Uint8Array(str.length / 2);\n    for (let i = 0; i < str.length; i += 2) {\n      const byte = parseInt(str.substr(i, 2), 16);\n      if (isNaN(byte)) {\n        throw new TypeError('Invalid hex string');\n      }\n      bytes[i / 2] = byte;\n    }\n    return bytes;\n  }\n\n  function bytesToHex(bytes) {\n    let hex = '';\n    for (let i = 0; i < bytes.length; i++) {\n      hex += bytes[i].toString(16).padStart(2, '0');\n    }\n    return hex;\n  }\n\n  globalThis.Buffer = Buffer;\n})();\n`;\n\n/**\n * Setup encoding APIs in an isolated-vm context\n *\n * Injects:\n * - atob/btoa for Base64 encoding/decoding\n * - Buffer class for binary data handling (utf8, base64, hex)\n *\n * @example\n * const handle = await setupEncoding(context);\n * await context.eval(`\n *   const encoded = btoa(\"hello\");\n *   const decoded = atob(encoded);\n *   const buf = Buffer.from(\"hello\");\n *   const hex = buf.toString(\"hex\");\n * `);\n */\nexport async function setupEncoding(\n  context: ivm.Context\n): Promise<EncodingHandle> {\n  context.evalSync(encodingCode);\n  return {\n    dispose() {\n      // No resources to cleanup for pure JS injection\n    },\n  };\n}\n"
   ],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+JrB,eAAsB,aAAa,CACjC,SACyB;AAAA,EACzB,QAAQ,SAAS,YAAY;AAAA,EAC7B,OAAO;AAAA,IACL,OAAO,GAAG;AAAA,EAGZ;AAAA;",
-  "debugId": "799BCB9316B516F464756E2164756E21",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgYrB,eAAsB,aAAa,CACjC,SACyB;AAAA,EACzB,QAAQ,SAAS,YAAY;AAAA,EAC7B,OAAO;AAAA,IACL,OAAO,GAAG;AAAA,EAGZ;AAAA;",
+  "debugId": "49911E9EE082911E64756E2164756E21",
   "names": []
 }

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/isolate-encoding",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "type": "commonjs"
 }

package/dist/mjs/index.mjs

@@ -143,6 +143,227 @@ var encodingCode = `
 
     return result;
   };
+
+  // ============================================
+  // Buffer implementation
+  // ============================================
+
+  const BUFFER_SYMBOL = Symbol.for('__isBuffer');
+
+  class Buffer extends Uint8Array {
+    constructor(arg, encodingOrOffset, length) {
+      if (typeof arg === 'number') {
+        super(arg);
+      } else if (typeof arg === 'string') {
+        const bytes = stringToBytes(arg, encodingOrOffset || 'utf8');
+        super(bytes);
+      } else if (arg instanceof ArrayBuffer) {
+        if (typeof encodingOrOffset === 'number') {
+          super(arg, encodingOrOffset, length);
+        } else {
+          super(arg);
+        }
+      } else if (ArrayBuffer.isView(arg)) {
+        super(arg.buffer, arg.byteOffset, arg.byteLength);
+      } else if (Array.isArray(arg)) {
+        super(arg);
+      } else {
+        super(arg);
+      }
+      Object.defineProperty(this, BUFFER_SYMBOL, { value: true, writable: false });
+    }
+
+    toString(encoding = 'utf8') {
+      encoding = normalizeEncoding(encoding);
+      if (encoding === 'utf8') {
+        return new TextDecoder('utf-8').decode(this);
+      } else if (encoding === 'base64') {
+        return bytesToBase64(this);
+      } else if (encoding === 'hex') {
+        return bytesToHex(this);
+      }
+      return new TextDecoder('utf-8').decode(this);
+    }
+
+    slice(start, end) {
+      const sliced = super.slice(start, end);
+      return Buffer.from(sliced);
+    }
+
+    subarray(start, end) {
+      const sub = super.subarray(start, end);
+      const buf = new Buffer(sub.length);
+      buf.set(sub);
+      return buf;
+    }
+
+    static from(value, encodingOrOffset, length) {
+      if (typeof value === 'string') {
+        return new Buffer(value, encodingOrOffset);
+      }
+      if (value instanceof ArrayBuffer) {
+        if (typeof encodingOrOffset === 'number') {
+          return new Buffer(value, encodingOrOffset, length);
+        }
+        return new Buffer(value);
+      }
+      if (ArrayBuffer.isView(value)) {
+        return new Buffer(value);
+      }
+      if (Array.isArray(value)) {
+        return new Buffer(value);
+      }
+      if (value && typeof value[Symbol.iterator] === 'function') {
+        return new Buffer(Array.from(value));
+      }
+      throw new TypeError('First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object');
+    }
+
+    static alloc(size, fill, encoding) {
+      if (typeof size !== 'number' || size < 0) {
+        throw new RangeError('Invalid size');
+      }
+      const buf = new Buffer(size);
+      if (fill !== undefined) {
+        if (typeof fill === 'number') {
+          buf.fill(fill);
+        } else if (typeof fill === 'string') {
+          const fillBytes = stringToBytes(fill, encoding || 'utf8');
+          for (let i = 0; i < size; i++) {
+            buf[i] = fillBytes[i % fillBytes.length];
+          }
+        } else if (Buffer.isBuffer(fill) || fill instanceof Uint8Array) {
+          for (let i = 0; i < size; i++) {
+            buf[i] = fill[i % fill.length];
+          }
+        }
+      }
+      return buf;
+    }
+
+    static allocUnsafe(size) {
+      if (typeof size !== 'number' || size < 0) {
+        throw new RangeError('Invalid size');
+      }
+      return new Buffer(size);
+    }
+
+    static concat(list, totalLength) {
+      if (!Array.isArray(list)) {
+        throw new TypeError('list argument must be an array');
+      }
+      if (list.length === 0) {
+        return Buffer.alloc(0);
+      }
+      if (totalLength === undefined) {
+        totalLength = 0;
+        for (const buf of list) {
+          totalLength += buf.length;
+        }
+      }
+      const result = Buffer.alloc(totalLength);
+      let offset = 0;
+      for (const buf of list) {
+        if (offset + buf.length > totalLength) {
+          result.set(buf.subarray(0, totalLength - offset), offset);
+          break;
+        }
+        result.set(buf, offset);
+        offset += buf.length;
+      }
+      return result;
+    }
+
+    static isBuffer(obj) {
+      return obj != null && obj[BUFFER_SYMBOL] === true;
+    }
+
+    static byteLength(string, encoding = 'utf8') {
+      if (typeof string !== 'string') {
+        if (ArrayBuffer.isView(string) || string instanceof ArrayBuffer) {
+          return string.byteLength;
+        }
+        throw new TypeError('First argument must be a string, Buffer, or ArrayBuffer');
+      }
+      encoding = normalizeEncoding(encoding);
+      if (encoding === 'utf8') {
+        return new TextEncoder().encode(string).length;
+      } else if (encoding === 'base64') {
+        const padding = (string.match(/=+$/) || [''])[0].length;
+        return Math.floor((string.length * 3) / 4) - padding;
+      } else if (encoding === 'hex') {
+        return Math.floor(string.length / 2);
+      }
+      return new TextEncoder().encode(string).length;
+    }
+
+    static isEncoding(encoding) {
+      return ['utf8', 'utf-8', 'base64', 'hex'].includes(normalizeEncoding(encoding));
+    }
+  }
+
+  function normalizeEncoding(encoding) {
+    if (!encoding) return 'utf8';
+    const lower = String(encoding).toLowerCase().replace('-', '');
+    if (lower === 'utf8' || lower === 'utf-8') return 'utf8';
+    if (lower === 'base64') return 'base64';
+    if (lower === 'hex') return 'hex';
+    return lower;
+  }
+
+  function stringToBytes(str, encoding) {
+    encoding = normalizeEncoding(encoding);
+    if (encoding === 'utf8') {
+      return new TextEncoder().encode(str);
+    } else if (encoding === 'base64') {
+      return base64ToBytes(str);
+    } else if (encoding === 'hex') {
+      return hexToBytes(str);
+    }
+    return new TextEncoder().encode(str);
+  }
+
+  function base64ToBytes(str) {
+    const binary = atob(str);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+  }
+
+  function bytesToBase64(bytes) {
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++) {
+      binary += String.fromCharCode(bytes[i]);
+    }
+    return btoa(binary);
+  }
+
+  function hexToBytes(str) {
+    if (str.length % 2 !== 0) {
+      throw new TypeError('Invalid hex string');
+    }
+    const bytes = new Uint8Array(str.length / 2);
+    for (let i = 0; i < str.length; i += 2) {
+      const byte = parseInt(str.substr(i, 2), 16);
+      if (isNaN(byte)) {
+        throw new TypeError('Invalid hex string');
+      }
+      bytes[i / 2] = byte;
+    }
+    return bytes;
+  }
+
+  function bytesToHex(bytes) {
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+      hex += bytes[i].toString(16).padStart(2, '0');
+    }
+    return hex;
+  }
+
+  globalThis.Buffer = Buffer;
 })();
 `;
 async function setupEncoding(context) {
@@ -155,4 +376,4 @@ export {
   setupEncoding
 };
 
-//# debugId=2247BF7C4E326F2B64756E2164756E21
+//# debugId=EF7519E527710EEC64756E2164756E21

package/dist/mjs/index.mjs.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../src/index.ts"],
   "sourcesContent": [
-    "import type ivm from \"isolated-vm\";\n\nexport interface EncodingHandle {\n  dispose(): void;\n}\n\nconst encodingCode = `\n(function() {\n  // Define DOMException if not available\n  if (typeof DOMException === 'undefined') {\n    globalThis.DOMException = class DOMException extends Error {\n      constructor(message, name) {\n        super(message);\n        this.name = name || 'DOMException';\n      }\n    };\n  }\n\n  const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\n  // Build reverse lookup table\n  const base64Lookup = new Map();\n  for (let i = 0; i < base64Chars.length; i++) {\n    base64Lookup.set(base64Chars[i], i);\n  }\n\n  globalThis.btoa = function btoa(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Check for characters outside Latin-1 range\n    for (let i = 0; i < str.length; i++) {\n      if (str.charCodeAt(i) > 255) {\n        throw new DOMException(\n          \"The string to be encoded contains characters outside of the Latin1 range.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    if (str.length === 0) {\n      return '';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = str.charCodeAt(i++);\n      const bExists = i < str.length;\n      const b = bExists ? str.charCodeAt(i++) : 0;\n      const cExists = i < str.length;\n      const c = cExists ? str.charCodeAt(i++) : 0;\n\n      const triplet = (a << 16) | (b << 8) | c;\n\n      result += base64Chars[(triplet >> 18) & 0x3F];\n      result += base64Chars[(triplet >> 12) & 0x3F];\n      result += bExists ? base64Chars[(triplet >> 6) & 0x3F] : '=';\n      result += cExists ? base64Chars[triplet & 0x3F] : '=';\n    }\n\n    return result;\n  };\n\n  globalThis.atob = function atob(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Remove whitespace\n    str = str.replace(/[\\\\t\\\\n\\\\f\\\\r ]/g, '');\n\n    // Validate characters and length\n    if (str.length === 0) {\n      return '';\n    }\n\n    // Check for invalid characters (before padding normalization)\n    for (let i = 0; i < str.length; i++) {\n      const c = str[i];\n      if (c !== '=' && !base64Lookup.has(c)) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Validate padding position (must be at end)\n    const paddingIndex = str.indexOf('=');\n    if (paddingIndex !== -1) {\n      for (let i = paddingIndex; i < str.length; i++) {\n        if (str[i] !== '=') {\n          throw new DOMException(\n            \"The string to be decoded is not correctly encoded.\",\n            \"InvalidCharacterError\"\n          );\n        }\n      }\n      const paddingLength = str.length - paddingIndex;\n      if (paddingLength > 2) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Length without padding must be valid (can't have remainder of 1)\n    const strWithoutPadding = str.replace(/=/g, '');\n    if (strWithoutPadding.length % 4 === 1) {\n      throw new DOMException(\n        \"The string to be decoded is not correctly encoded.\",\n        \"InvalidCharacterError\"\n      );\n    }\n\n    // Pad to multiple of 4 if needed (for inputs without explicit padding)\n    while (str.length % 4 !== 0) {\n      str += '=';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = base64Lookup.get(str[i++]) ?? 0;\n      const b = base64Lookup.get(str[i++]) ?? 0;\n      const c = base64Lookup.get(str[i++]) ?? 0;\n      const d = base64Lookup.get(str[i++]) ?? 0;\n\n      const triplet = (a << 18) | (b << 12) | (c << 6) | d;\n\n      result += String.fromCharCode((triplet >> 16) & 0xFF);\n      if (str[i - 2] !== '=') {\n        result += String.fromCharCode((triplet >> 8) & 0xFF);\n      }\n      if (str[i - 1] !== '=') {\n        result += String.fromCharCode(triplet & 0xFF);\n      }\n    }\n\n    return result;\n  };\n})();\n`;\n\n/**\n * Setup encoding APIs in an isolated-vm context\n *\n * Injects atob and btoa for Base64 encoding/decoding\n *\n * @example\n * const handle = await setupEncoding(context);\n * await context.eval(`\n *   const encoded = btoa(\"hello\");\n *   const decoded = atob(encoded);\n * `);\n */\nexport async function setupEncoding(\n  context: ivm.Context\n): Promise<EncodingHandle> {\n  context.evalSync(encodingCode);\n  return {\n    dispose() {\n      // No resources to cleanup for pure JS injection\n    },\n  };\n}\n"
+    "import type ivm from \"isolated-vm\";\n\nexport interface EncodingHandle {\n  dispose(): void;\n}\n\nconst encodingCode = `\n(function() {\n  // Define DOMException if not available\n  if (typeof DOMException === 'undefined') {\n    globalThis.DOMException = class DOMException extends Error {\n      constructor(message, name) {\n        super(message);\n        this.name = name || 'DOMException';\n      }\n    };\n  }\n\n  const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\n\n  // Build reverse lookup table\n  const base64Lookup = new Map();\n  for (let i = 0; i < base64Chars.length; i++) {\n    base64Lookup.set(base64Chars[i], i);\n  }\n\n  globalThis.btoa = function btoa(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Check for characters outside Latin-1 range\n    for (let i = 0; i < str.length; i++) {\n      if (str.charCodeAt(i) > 255) {\n        throw new DOMException(\n          \"The string to be encoded contains characters outside of the Latin1 range.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    if (str.length === 0) {\n      return '';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = str.charCodeAt(i++);\n      const bExists = i < str.length;\n      const b = bExists ? str.charCodeAt(i++) : 0;\n      const cExists = i < str.length;\n      const c = cExists ? str.charCodeAt(i++) : 0;\n\n      const triplet = (a << 16) | (b << 8) | c;\n\n      result += base64Chars[(triplet >> 18) & 0x3F];\n      result += base64Chars[(triplet >> 12) & 0x3F];\n      result += bExists ? base64Chars[(triplet >> 6) & 0x3F] : '=';\n      result += cExists ? base64Chars[triplet & 0x3F] : '=';\n    }\n\n    return result;\n  };\n\n  globalThis.atob = function atob(str) {\n    if (str === undefined) {\n      throw new TypeError(\"1 argument required, but only 0 present.\");\n    }\n\n    str = String(str);\n\n    // Remove whitespace\n    str = str.replace(/[\\\\t\\\\n\\\\f\\\\r ]/g, '');\n\n    // Validate characters and length\n    if (str.length === 0) {\n      return '';\n    }\n\n    // Check for invalid characters (before padding normalization)\n    for (let i = 0; i < str.length; i++) {\n      const c = str[i];\n      if (c !== '=' && !base64Lookup.has(c)) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Validate padding position (must be at end)\n    const paddingIndex = str.indexOf('=');\n    if (paddingIndex !== -1) {\n      for (let i = paddingIndex; i < str.length; i++) {\n        if (str[i] !== '=') {\n          throw new DOMException(\n            \"The string to be decoded is not correctly encoded.\",\n            \"InvalidCharacterError\"\n          );\n        }\n      }\n      const paddingLength = str.length - paddingIndex;\n      if (paddingLength > 2) {\n        throw new DOMException(\n          \"The string to be decoded is not correctly encoded.\",\n          \"InvalidCharacterError\"\n        );\n      }\n    }\n\n    // Length without padding must be valid (can't have remainder of 1)\n    const strWithoutPadding = str.replace(/=/g, '');\n    if (strWithoutPadding.length % 4 === 1) {\n      throw new DOMException(\n        \"The string to be decoded is not correctly encoded.\",\n        \"InvalidCharacterError\"\n      );\n    }\n\n    // Pad to multiple of 4 if needed (for inputs without explicit padding)\n    while (str.length % 4 !== 0) {\n      str += '=';\n    }\n\n    let result = '';\n    let i = 0;\n\n    while (i < str.length) {\n      const a = base64Lookup.get(str[i++]) ?? 0;\n      const b = base64Lookup.get(str[i++]) ?? 0;\n      const c = base64Lookup.get(str[i++]) ?? 0;\n      const d = base64Lookup.get(str[i++]) ?? 0;\n\n      const triplet = (a << 18) | (b << 12) | (c << 6) | d;\n\n      result += String.fromCharCode((triplet >> 16) & 0xFF);\n      if (str[i - 2] !== '=') {\n        result += String.fromCharCode((triplet >> 8) & 0xFF);\n      }\n      if (str[i - 1] !== '=') {\n        result += String.fromCharCode(triplet & 0xFF);\n      }\n    }\n\n    return result;\n  };\n\n  // ============================================\n  // Buffer implementation\n  // ============================================\n\n  const BUFFER_SYMBOL = Symbol.for('__isBuffer');\n\n  class Buffer extends Uint8Array {\n    constructor(arg, encodingOrOffset, length) {\n      if (typeof arg === 'number') {\n        super(arg);\n      } else if (typeof arg === 'string') {\n        const bytes = stringToBytes(arg, encodingOrOffset || 'utf8');\n        super(bytes);\n      } else if (arg instanceof ArrayBuffer) {\n        if (typeof encodingOrOffset === 'number') {\n          super(arg, encodingOrOffset, length);\n        } else {\n          super(arg);\n        }\n      } else if (ArrayBuffer.isView(arg)) {\n        super(arg.buffer, arg.byteOffset, arg.byteLength);\n      } else if (Array.isArray(arg)) {\n        super(arg);\n      } else {\n        super(arg);\n      }\n      Object.defineProperty(this, BUFFER_SYMBOL, { value: true, writable: false });\n    }\n\n    toString(encoding = 'utf8') {\n      encoding = normalizeEncoding(encoding);\n      if (encoding === 'utf8') {\n        return new TextDecoder('utf-8').decode(this);\n      } else if (encoding === 'base64') {\n        return bytesToBase64(this);\n      } else if (encoding === 'hex') {\n        return bytesToHex(this);\n      }\n      return new TextDecoder('utf-8').decode(this);\n    }\n\n    slice(start, end) {\n      const sliced = super.slice(start, end);\n      return Buffer.from(sliced);\n    }\n\n    subarray(start, end) {\n      const sub = super.subarray(start, end);\n      const buf = new Buffer(sub.length);\n      buf.set(sub);\n      return buf;\n    }\n\n    static from(value, encodingOrOffset, length) {\n      if (typeof value === 'string') {\n        return new Buffer(value, encodingOrOffset);\n      }\n      if (value instanceof ArrayBuffer) {\n        if (typeof encodingOrOffset === 'number') {\n          return new Buffer(value, encodingOrOffset, length);\n        }\n        return new Buffer(value);\n      }\n      if (ArrayBuffer.isView(value)) {\n        return new Buffer(value);\n      }\n      if (Array.isArray(value)) {\n        return new Buffer(value);\n      }\n      if (value && typeof value[Symbol.iterator] === 'function') {\n        return new Buffer(Array.from(value));\n      }\n      throw new TypeError('First argument must be a string, Buffer, ArrayBuffer, Array, or array-like object');\n    }\n\n    static alloc(size, fill, encoding) {\n      if (typeof size !== 'number' || size < 0) {\n        throw new RangeError('Invalid size');\n      }\n      const buf = new Buffer(size);\n      if (fill !== undefined) {\n        if (typeof fill === 'number') {\n          buf.fill(fill);\n        } else if (typeof fill === 'string') {\n          const fillBytes = stringToBytes(fill, encoding || 'utf8');\n          for (let i = 0; i < size; i++) {\n            buf[i] = fillBytes[i % fillBytes.length];\n          }\n        } else if (Buffer.isBuffer(fill) || fill instanceof Uint8Array) {\n          for (let i = 0; i < size; i++) {\n            buf[i] = fill[i % fill.length];\n          }\n        }\n      }\n      return buf;\n    }\n\n    static allocUnsafe(size) {\n      if (typeof size !== 'number' || size < 0) {\n        throw new RangeError('Invalid size');\n      }\n      return new Buffer(size);\n    }\n\n    static concat(list, totalLength) {\n      if (!Array.isArray(list)) {\n        throw new TypeError('list argument must be an array');\n      }\n      if (list.length === 0) {\n        return Buffer.alloc(0);\n      }\n      if (totalLength === undefined) {\n        totalLength = 0;\n        for (const buf of list) {\n          totalLength += buf.length;\n        }\n      }\n      const result = Buffer.alloc(totalLength);\n      let offset = 0;\n      for (const buf of list) {\n        if (offset + buf.length > totalLength) {\n          result.set(buf.subarray(0, totalLength - offset), offset);\n          break;\n        }\n        result.set(buf, offset);\n        offset += buf.length;\n      }\n      return result;\n    }\n\n    static isBuffer(obj) {\n      return obj != null && obj[BUFFER_SYMBOL] === true;\n    }\n\n    static byteLength(string, encoding = 'utf8') {\n      if (typeof string !== 'string') {\n        if (ArrayBuffer.isView(string) || string instanceof ArrayBuffer) {\n          return string.byteLength;\n        }\n        throw new TypeError('First argument must be a string, Buffer, or ArrayBuffer');\n      }\n      encoding = normalizeEncoding(encoding);\n      if (encoding === 'utf8') {\n        return new TextEncoder().encode(string).length;\n      } else if (encoding === 'base64') {\n        const padding = (string.match(/=+$/) || [''])[0].length;\n        return Math.floor((string.length * 3) / 4) - padding;\n      } else if (encoding === 'hex') {\n        return Math.floor(string.length / 2);\n      }\n      return new TextEncoder().encode(string).length;\n    }\n\n    static isEncoding(encoding) {\n      return ['utf8', 'utf-8', 'base64', 'hex'].includes(normalizeEncoding(encoding));\n    }\n  }\n\n  function normalizeEncoding(encoding) {\n    if (!encoding) return 'utf8';\n    const lower = String(encoding).toLowerCase().replace('-', '');\n    if (lower === 'utf8' || lower === 'utf-8') return 'utf8';\n    if (lower === 'base64') return 'base64';\n    if (lower === 'hex') return 'hex';\n    return lower;\n  }\n\n  function stringToBytes(str, encoding) {\n    encoding = normalizeEncoding(encoding);\n    if (encoding === 'utf8') {\n      return new TextEncoder().encode(str);\n    } else if (encoding === 'base64') {\n      return base64ToBytes(str);\n    } else if (encoding === 'hex') {\n      return hexToBytes(str);\n    }\n    return new TextEncoder().encode(str);\n  }\n\n  function base64ToBytes(str) {\n    const binary = atob(str);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n  }\n\n  function bytesToBase64(bytes) {\n    let binary = '';\n    for (let i = 0; i < bytes.length; i++) {\n      binary += String.fromCharCode(bytes[i]);\n    }\n    return btoa(binary);\n  }\n\n  function hexToBytes(str) {\n    if (str.length % 2 !== 0) {\n      throw new TypeError('Invalid hex string');\n    }\n    const bytes = new Uint8Array(str.length / 2);\n    for (let i = 0; i < str.length; i += 2) {\n      const byte = parseInt(str.substr(i, 2), 16);\n      if (isNaN(byte)) {\n        throw new TypeError('Invalid hex string');\n      }\n      bytes[i / 2] = byte;\n    }\n    return bytes;\n  }\n\n  function bytesToHex(bytes) {\n    let hex = '';\n    for (let i = 0; i < bytes.length; i++) {\n      hex += bytes[i].toString(16).padStart(2, '0');\n    }\n    return hex;\n  }\n\n  globalThis.Buffer = Buffer;\n})();\n`;\n\n/**\n * Setup encoding APIs in an isolated-vm context\n *\n * Injects:\n * - atob/btoa for Base64 encoding/decoding\n * - Buffer class for binary data handling (utf8, base64, hex)\n *\n * @example\n * const handle = await setupEncoding(context);\n * await context.eval(`\n *   const encoded = btoa(\"hello\");\n *   const decoded = atob(encoded);\n *   const buf = Buffer.from(\"hello\");\n *   const hex = buf.toString(\"hex\");\n * `);\n */\nexport async function setupEncoding(\n  context: ivm.Context\n): Promise<EncodingHandle> {\n  context.evalSync(encodingCode);\n  return {\n    dispose() {\n      // No resources to cleanup for pure JS injection\n    },\n  };\n}\n"
   ],
-  "mappings": ";AAMA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+JrB,eAAsB,aAAa,CACjC,SACyB;AAAA,EACzB,QAAQ,SAAS,YAAY;AAAA,EAC7B,OAAO;AAAA,IACL,OAAO,GAAG;AAAA,EAGZ;AAAA;",
-  "debugId": "2247BF7C4E326F2B64756E2164756E21",
+  "mappings": ";AAMA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgYrB,eAAsB,aAAa,CACjC,SACyB;AAAA,EACzB,QAAQ,SAAS,YAAY;AAAA,EAC7B,OAAO;AAAA,IACL,OAAO,GAAG;AAAA,EAGZ;AAAA;",
+  "debugId": "EF7519E527710EEC64756E2164756E21",
   "names": []
 }

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/isolate-encoding",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "type": "module"
 }

package/dist/types/index.d.ts

@@ -5,13 +5,17 @@ export interface EncodingHandle {
 /**
  * Setup encoding APIs in an isolated-vm context
  *
- * Injects atob and btoa for Base64 encoding/decoding
+ * Injects:
+ * - atob/btoa for Base64 encoding/decoding
+ * - Buffer class for binary data handling (utf8, base64, hex)
  *
  * @example
  * const handle = await setupEncoding(context);
  * await context.eval(`
  *   const encoded = btoa("hello");
  *   const decoded = atob(encoded);
+ *   const buf = Buffer.from("hello");
+ *   const hex = buf.toString("hex");
  * `);
  */
 export declare function setupEncoding(context: ivm.Context): Promise<EncodingHandle>;

package/dist/types/isolate.d.ts

@@ -31,4 +31,162 @@ declare global {
    * btoa("Hello"); // "SGVsbG8="
    */
   function btoa(stringToEncode: string): string;
+
+  // ============================================
+  // Buffer
+  // ============================================
+
+  /**
+   * Buffer encoding types supported by the isolate Buffer implementation.
+   */
+  type BufferEncoding = "utf8" | "utf-8" | "base64" | "hex";
+
+  /**
+   * Buffer class for working with binary data.
+   * Extends Uint8Array for compatibility.
+   * @see https://nodejs.org/api/buffer.html
+   */
+  interface Buffer extends Uint8Array {
+    /**
+     * Convert the buffer to a string.
+     *
+     * @param encoding - The encoding to use (default: "utf8")
+     * @returns The string representation
+     *
+     * @example
+     * const buf = Buffer.from("hello");
+     * buf.toString(); // "hello"
+     * buf.toString("hex"); // "68656c6c6f"
+     * buf.toString("base64"); // "aGVsbG8="
+     */
+    toString(encoding?: BufferEncoding): string;
+
+    /**
+     * Returns a new Buffer that references the same memory as the original,
+     * but offset and cropped by the start and end indices.
+     *
+     * @param start - Start index (default: 0)
+     * @param end - End index (default: buffer.length)
+     * @returns A new Buffer instance
+     *
+     * @example
+     * const buf = Buffer.from("hello");
+     * buf.slice(1, 4).toString(); // "ell"
+     */
+    slice(start?: number, end?: number): Buffer;
+
+    /**
+     * Returns a new Buffer that references the same memory as the original,
+     * but offset and cropped by the start and end indices.
+     *
+     * @param start - Start index (default: 0)
+     * @param end - End index (default: buffer.length)
+     * @returns A new Buffer instance
+     */
+    subarray(start?: number, end?: number): Buffer;
+  }
+
+  /**
+   * Buffer constructor interface.
+   */
+  interface BufferConstructor {
+    /**
+     * Creates a new Buffer from a string, array, ArrayBuffer, or another Buffer.
+     *
+     * @param value - The value to create a buffer from
+     * @param encodingOrOffset - Encoding for strings, or byte offset for ArrayBuffer
+     * @param length - Length for ArrayBuffer (when offset is provided)
+     * @returns A new Buffer instance
+     *
+     * @example
+     * Buffer.from("hello"); // UTF-8 encoded
+     * Buffer.from("aGVsbG8=", "base64"); // base64 decoded
+     * Buffer.from("68656c6c6f", "hex"); // hex decoded
+     * Buffer.from([104, 101, 108, 108, 111]); // from array
+     */
+    from(value: string, encoding?: BufferEncoding): Buffer;
+    from(value: ArrayBuffer, byteOffset?: number, length?: number): Buffer;
+    from(value: Uint8Array | ReadonlyArray<number>): Buffer;
+    from(value: Iterable<number>): Buffer;
+
+    /**
+     * Allocates a new Buffer of the specified size, filled with zeros or the specified fill value.
+     *
+     * @param size - The size of the buffer in bytes
+     * @param fill - Value to fill the buffer with (default: 0)
+     * @param encoding - Encoding for string fill values
+     * @returns A new Buffer instance
+     *
+     * @example
+     * Buffer.alloc(5); // <Buffer 00 00 00 00 00>
+     * Buffer.alloc(5, 1); // <Buffer 01 01 01 01 01>
+     * Buffer.alloc(5, "ab"); // <Buffer 61 62 61 62 61>
+     */
+    alloc(size: number, fill?: number | string | Buffer, encoding?: BufferEncoding): Buffer;
+
+    /**
+     * Allocates a new Buffer of the specified size without initializing the memory.
+     * The contents are unknown and may contain sensitive data.
+     *
+     * @param size - The size of the buffer in bytes
+     * @returns A new Buffer instance
+     */
+    allocUnsafe(size: number): Buffer;
+
+    /**
+     * Concatenates a list of Buffers.
+     *
+     * @param list - Array of Buffer instances to concatenate
+     * @param totalLength - Total length of the buffers (optional)
+     * @returns A new Buffer instance
+     *
+     * @example
+     * const buf1 = Buffer.from("hel");
+     * const buf2 = Buffer.from("lo");
+     * Buffer.concat([buf1, buf2]).toString(); // "hello"
+     */
+    concat(list: ReadonlyArray<Uint8Array>, totalLength?: number): Buffer;
+
+    /**
+     * Returns true if the given object is a Buffer.
+     *
+     * @param obj - Object to test
+     * @returns true if obj is a Buffer
+     *
+     * @example
+     * Buffer.isBuffer(Buffer.from("test")); // true
+     * Buffer.isBuffer(new Uint8Array(5)); // false
+     */
+    isBuffer(obj: unknown): obj is Buffer;
+
+    /**
+     * Returns the byte length of a string when encoded.
+     *
+     * @param string - The string to measure
+     * @param encoding - The encoding (default: "utf8")
+     * @returns The byte length
+     *
+     * @example
+     * Buffer.byteLength("hello"); // 5
+     * Buffer.byteLength("aGVsbG8=", "base64"); // 5 (decoded length)
+     */
+    byteLength(string: string, encoding?: BufferEncoding): number;
+    byteLength(buffer: ArrayBufferView | ArrayBuffer): number;
+
+    /**
+     * Returns true if the encoding is a valid buffer encoding.
+     *
+     * @param encoding - The encoding to check
+     * @returns true if the encoding is supported
+     */
+    isEncoding(encoding: string): encoding is BufferEncoding;
+
+    readonly prototype: Buffer;
+  }
+
+  /**
+   * Buffer class for working with binary data.
+   * @see https://nodejs.org/api/buffer.html
+   */
+  const Buffer: BufferConstructor;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/isolate-encoding",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "main": "./dist/cjs/index.cjs",
   "types": "./dist/types/index.d.ts",
   "exports": {