@ricsam/isolate-encoding 0.0.1 → 0.1.2

package/README.md

@@ -1,45 +1,50 @@
 # @ricsam/isolate-encoding
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@ricsam/isolate-encoding`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+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/dist/mjs/index.mjs

@@ -0,0 +1,159 @@
+// @bun
+// packages/encoding/src/index.ts
+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() {}
+  };
+}
+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,10 +1,58 @@
 {
   "name": "@ricsam/isolate-encoding",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @ricsam/isolate-encoding",
+  "version": "0.1.2",
+  "main": "./dist/cjs/index.cjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/cjs/index.cjs",
+      "import": "./dist/mjs/index.mjs"
+    },
+    "./isolate": {
+      "types": "./dist/types/isolate.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test --experimental-strip-types 'src/**/*.test.ts'",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ricsam/isolate-core": "*",
+    "isolated-vm": "^6"
+  },
+  "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": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
+    "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"
   ]
-}
+}