@ricsam/isolate-encoding 0.1.1 → 0.1.2

package/README.md

@@ -0,0 +1,50 @@
+# @ricsam/isolate-encoding
+
+Base64 encoding and decoding via `atob` and `btoa`.
+
+```typescript
+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:**
+
+```javascript
+// 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:**
+
+```javascript
+// 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");
+}
+```

package/dist/cjs/index.cjs

@@ -0,0 +1,190 @@
+// @bun @bun-cjs
+(function(exports, require, module, __filename, __dirname) {var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// packages/encoding/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  setupEncoding: () => setupEncoding
+});
+module.exports = __toCommonJS(exports_src);
+var encodingCode = `
+(function() {
+  // Define DOMException if not available
+  if (typeof DOMException === 'undefined') {
+    globalThis.DOMException = class DOMException extends Error {
+      constructor(message, name) {
+        super(message);
+        this.name = name || 'DOMException';
+      }
+    };
+  }
+
+  const base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
+
+  // Build reverse lookup table
+  const base64Lookup = new Map();
+  for (let i = 0; i < base64Chars.length; i++) {
+    base64Lookup.set(base64Chars[i], i);
+  }
+
+  globalThis.btoa = function btoa(str) {
+    if (str === undefined) {
+      throw new TypeError("1 argument required, but only 0 present.");
+    }
+
+    str = String(str);
+
+    // Check for characters outside Latin-1 range
+    for (let i = 0; i < str.length; i++) {
+      if (str.charCodeAt(i) > 255) {
+        throw new DOMException(
+          "The string to be encoded contains characters outside of the Latin1 range.",
+          "InvalidCharacterError"
+        );
+      }
+    }
+
+    if (str.length === 0) {
+      return '';
+    }
+
+    let result = '';
+    let i = 0;
+
+    while (i < str.length) {
+      const a = str.charCodeAt(i++);
+      const bExists = i < str.length;
+      const b = bExists ? str.charCodeAt(i++) : 0;
+      const cExists = i < str.length;
+      const c = cExists ? str.charCodeAt(i++) : 0;
+
+      const triplet = (a << 16) | (b << 8) | c;
+
+      result += base64Chars[(triplet >> 18) & 0x3F];
+      result += base64Chars[(triplet >> 12) & 0x3F];
+      result += bExists ? base64Chars[(triplet >> 6) & 0x3F] : '=';
+      result += cExists ? base64Chars[triplet & 0x3F] : '=';
+    }
+
+    return result;
+  };
+
+  globalThis.atob = function atob(str) {
+    if (str === undefined) {
+      throw new TypeError("1 argument required, but only 0 present.");
+    }
+
+    str = String(str);
+
+    // Remove whitespace
+    str = str.replace(/[\\t\\n\\f\\r ]/g, '');
+
+    // Validate characters and length
+    if (str.length === 0) {
+      return '';
+    }
+
+    // Check for invalid characters (before padding normalization)
+    for (let i = 0; i < str.length; i++) {
+      const c = str[i];
+      if (c !== '=' && !base64Lookup.has(c)) {
+        throw new DOMException(
+          "The string to be decoded is not correctly encoded.",
+          "InvalidCharacterError"
+        );
+      }
+    }
+
+    // Validate padding position (must be at end)
+    const paddingIndex = str.indexOf('=');
+    if (paddingIndex !== -1) {
+      for (let i = paddingIndex; i < str.length; i++) {
+        if (str[i] !== '=') {
+          throw new DOMException(
+            "The string to be decoded is not correctly encoded.",
+            "InvalidCharacterError"
+          );
+        }
+      }
+      const paddingLength = str.length - paddingIndex;
+      if (paddingLength > 2) {
+        throw new DOMException(
+          "The string to be decoded is not correctly encoded.",
+          "InvalidCharacterError"
+        );
+      }
+    }
+
+    // Length without padding must be valid (can't have remainder of 1)
+    const strWithoutPadding = str.replace(/=/g, '');
+    if (strWithoutPadding.length % 4 === 1) {
+      throw new DOMException(
+        "The string to be decoded is not correctly encoded.",
+        "InvalidCharacterError"
+      );
+    }
+
+    // Pad to multiple of 4 if needed (for inputs without explicit padding)
+    while (str.length % 4 !== 0) {
+      str += '=';
+    }
+
+    let result = '';
+    let i = 0;
+
+    while (i < str.length) {
+      const a = base64Lookup.get(str[i++]) ?? 0;
+      const b = base64Lookup.get(str[i++]) ?? 0;
+      const c = base64Lookup.get(str[i++]) ?? 0;
+      const d = base64Lookup.get(str[i++]) ?? 0;
+
+      const triplet = (a << 18) | (b << 12) | (c << 6) | d;
+
+      result += String.fromCharCode((triplet >> 16) & 0xFF);
+      if (str[i - 2] !== '=') {
+        result += String.fromCharCode((triplet >> 8) & 0xFF);
+      }
+      if (str[i - 1] !== '=') {
+        result += String.fromCharCode(triplet & 0xFF);
+      }
+    }
+
+    return result;
+  };
+})();
+`;
+async function setupEncoding(context) {
+  context.evalSync(encodingCode);
+  return {
+    dispose() {}
+  };
+}
+})
+
+//# debugId=46FB9F757DF172F564756E2164756E21

package/dist/cjs/index.cjs.map

@@ -0,0 +1,10 @@
+{
+  "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"
+  ],
+  "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": "46FB9F757DF172F564756E2164756E21",
+  "names": []
+}

package/dist/cjs/package.json

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

package/{src/index.ts → dist/mjs/index.mjs}

@@ -1,10 +1,6 @@
-import type ivm from "isolated-vm";
-
-export interface EncodingHandle {
-  dispose(): void;
-}
-
-const encodingCode = `
+// @bun
+// packages/encoding/src/index.ts
+var encodingCode = `
 (function() {
   // Define DOMException if not available
   if (typeof DOMException === 'undefined') {
@@ -150,26 +146,14 @@ const encodingCode = `
   };
 })();
 `;
-
-/**
- * Setup encoding APIs in an isolated-vm context
- *
- * Injects atob and btoa for Base64 encoding/decoding
- *
- * @example
- * const handle = await setupEncoding(context);
- * await context.eval(`
- *   const encoded = btoa("hello");
- *   const decoded = atob(encoded);
- * `);
- */
-export async function setupEncoding(
-  context: ivm.Context
-): Promise<EncodingHandle> {
+async function setupEncoding(context) {
   context.evalSync(encodingCode);
   return {
-    dispose() {
-      // No resources to cleanup for pure JS injection
-    },
+    dispose() {}
   };
 }
+export {
+  setupEncoding
+};
+
+//# debugId=3CBBC64AA7F4E2EC64756E2164756E21

package/dist/mjs/index.mjs.map

@@ -0,0 +1,10 @@
+{
+  "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"
+  ],
+  "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": "3CBBC64AA7F4E2EC64756E2164756E21",
+  "names": []
+}

package/dist/mjs/package.json

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

package/dist/types/index.d.ts

@@ -0,0 +1,17 @@
+import type ivm from "isolated-vm";
+export interface EncodingHandle {
+    dispose(): void;
+}
+/**
+ * Setup encoding APIs in an isolated-vm context
+ *
+ * Injects atob and btoa for Base64 encoding/decoding
+ *
+ * @example
+ * const handle = await setupEncoding(context);
+ * await context.eval(`
+ *   const encoded = btoa("hello");
+ *   const decoded = atob(encoded);
+ * `);
+ */
+export declare function setupEncoding(context: ivm.Context): Promise<EncodingHandle>;

package/dist/types/isolate.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Global Type Definitions for @ricsam/isolate-encoding
+ *
+ * These types define the globals injected by setupEncoding() into an isolated-vm context.
+ * Use these types to typecheck user code that will run inside the V8 isolate.
+ */
+
+export {};
+
+declare global {
+  /**
+   * Decodes a Base64-encoded string.
+   *
+   * @param encodedData - The Base64 string to decode
+   * @returns The decoded string
+   * @throws DOMException if the input is not valid Base64
+   *
+   * @example
+   * atob("SGVsbG8="); // "Hello"
+   */
+  function atob(encodedData: string): string;
+
+  /**
+   * Encodes a string to Base64.
+   *
+   * @param stringToEncode - The string to encode (must contain only Latin1 characters)
+   * @returns The Base64 encoded string
+   * @throws DOMException if the string contains characters outside Latin1 range (0-255)
+   *
+   * @example
+   * btoa("Hello"); // "SGVsbG8="
+   */
+  function btoa(stringToEncode: string): string;
+}

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@ricsam/isolate-encoding",
-  "version": "0.1.1",
-  "type": "module",
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "version": "0.1.2",
+  "main": "./dist/cjs/index.cjs",
+  "types": "./dist/types/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "types": "./src/index.ts"
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/mjs/index.mjs"
+    },
+    "./isolate": {
+      "types": "./dist/types/isolate.d.ts"
     }
   },
   "scripts": {
@@ -19,11 +22,37 @@
     "@ricsam/isolate-core": "*",
     "isolated-vm": "^6"
   },
-  "devDependencies": {
-    "@types/node": "^24",
-    "typescript": "^5"
-  },
   "peerDependencies": {
     "isolated-vm": "^6"
-  }
-}
+  },
+  "author": "Richard Samuelsson",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricsam/isolate.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricsam/isolate/issues"
+  },
+  "homepage": "https://github.com/ricsam/isolate#readme",
+  "keywords": [
+    "isolated-vm",
+    "sandbox",
+    "javascript",
+    "runtime",
+    "fetch",
+    "filesystem",
+    "streams",
+    "v8",
+    "isolate"
+  ],
+  "description": "Base64 encoding APIs (atob, btoa) for isolated-vm V8 sandbox",
+  "module": "./dist/mjs/index.mjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}

package/CHANGELOG.md

@@ -1,9 +0,0 @@
-# @ricsam/isolate-encoding
-
-## 0.1.1
-
-### Patch Changes
-
-- initial release
-- Updated dependencies
-  - @ricsam/isolate-core@0.1.1

package/src/setup.test.ts

@@ -1,134 +0,0 @@
-import { test, describe, beforeEach, afterEach } from "node:test";
-import assert from "node:assert";
-import ivm from "isolated-vm";
-import { setupEncoding } from "./index.ts";
-
-describe("@ricsam/isolate-encoding", () => {
-  let isolate: ivm.Isolate;
-  let context: ivm.Context;
-
-  beforeEach(async () => {
-    isolate = new ivm.Isolate();
-    context = await isolate.createContext();
-  });
-
-  afterEach(() => {
-    context.release();
-    isolate.dispose();
-  });
-
-  describe("btoa", () => {
-    test("encodes string to base64", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`btoa("hello")`);
-      assert.strictEqual(result, "aGVsbG8=");
-    });
-
-    test("handles empty string", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`btoa("")`);
-      assert.strictEqual(result, "");
-    });
-
-    test("handles Latin-1 characters", async () => {
-      await setupEncoding(context);
-      // Test with Latin-1 extended characters (char codes 128-255)
-      const result = await context.eval(`btoa("café")`);
-      // café uses é which is Latin-1 (char code 233)
-      assert.strictEqual(result, "Y2Fm6Q==");
-    });
-
-    test("throws on characters outside Latin-1 range", async () => {
-      await setupEncoding(context);
-      await assert.rejects(
-        async () => {
-          await context.eval(`btoa("hello 世界")`);
-        },
-        {
-          name: "InvalidCharacterError",
-        }
-      );
-    });
-
-    test("converts non-string arguments to string", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`btoa(123)`);
-      assert.strictEqual(result, "MTIz");
-    });
-  });
-
-  describe("atob", () => {
-    test("decodes base64 to string", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`atob("aGVsbG8=")`);
-      assert.strictEqual(result, "hello");
-    });
-
-    test("handles empty string", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`atob("")`);
-      assert.strictEqual(result, "");
-    });
-
-    test("throws on invalid base64", async () => {
-      await setupEncoding(context);
-      await assert.rejects(
-        async () => {
-          await context.eval(`atob("not valid base64!@#")`);
-        },
-        {
-          name: "InvalidCharacterError",
-        }
-      );
-    });
-
-    test("handles input without padding", async () => {
-      await setupEncoding(context);
-      // "aGVsbG8" is "hello" without the = padding
-      const result = await context.eval(`atob("aGVsbG8")`);
-      assert.strictEqual(result, "hello");
-    });
-
-    test("ignores whitespace in input", async () => {
-      await setupEncoding(context);
-      const result = await context.eval(`atob("aGVs bG8=")`);
-      assert.strictEqual(result, "hello");
-    });
-  });
-
-  describe("roundtrip", () => {
-    test("btoa and atob are inverse operations", async () => {
-      await setupEncoding(context);
-      const testStrings = [
-        "hello",
-        "Hello World!",
-        "test123",
-        "a",
-        "ab",
-        "abc",
-        "",
-      ];
-
-      for (const str of testStrings) {
-        const result = await context.eval(
-          `atob(btoa(${JSON.stringify(str)}))`
-        );
-        assert.strictEqual(result, str, `Roundtrip failed for: ${str}`);
-      }
-    });
-
-    test("handles binary data roundtrip", async () => {
-      await setupEncoding(context);
-      // Create a string with all Latin-1 bytes
-      const result = await context.eval(`
-        const bytes = [];
-        for (let i = 0; i < 256; i++) {
-          bytes.push(String.fromCharCode(i));
-        }
-        const str = bytes.join('');
-        atob(btoa(str)) === str;
-      `);
-      assert.strictEqual(result, true);
-    });
-  });
-});

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}