@ricsam/isolate-encoding

Base64 encoding and decoding via atob and btoa for isolated-vm V8 sandbox.

Installation

npm add @ricsam/isolate-encoding

Usage

import { setupEncoding } from "@ricsam/isolate-encoding";

const handle = await setupEncoding(context);

Injected Globals

• atob(encodedData) - Decode a Base64-encoded string
• btoa(stringToEncode) - Encode a string to Base64

Usage in Isolate

// Encode string to Base64
const encoded = btoa("Hello, World!");
console.log(encoded); // "SGVsbG8sIFdvcmxkIQ=="

// Decode Base64 to string
const decoded = atob("SGVsbG8sIFdvcmxkIQ==");
console.log(decoded); // "Hello, World!"

// Common use case: encoding JSON for transport
const data = { user: "john", token: "abc123" };
const base64Data = btoa(JSON.stringify(data));

// Decode it back
const originalData = JSON.parse(atob(base64Data));

Error Handling

// btoa throws for characters outside Latin1 range (0-255)
try {
  btoa("Hello 世界"); // Throws DOMException
} catch (e) {
  console.error("Cannot encode non-Latin1 characters");
}

// atob throws for invalid Base64
try {
  atob("not valid base64!!!");
} catch (e) {
  console.error("Invalid Base64 string");
}

License

MIT