fix: polyfill support and fixes

Author: jcabrero

README.md

@@ -150,6 +150,7 @@ const client = new NilaiOpenAIClient({
 - **🛡️ Secure Delegation**: Server-side token management with configurable expiration and usage limits.
 - **🌐 Network Flexibility**: Support for sandbox and production `nilauth` environments.
 - **🔒 Type Safety**: Strongly typed with Zod schema validation for robust development.
+- **🔧 Universal Compatibility**: Built-in polyfills for Node.js environments ensure seamless operation across different platforms without manual configuration.
 
 ## 🏗️ Architecture
 

package.json

@@ -10,6 +10,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./polyfills": {
+      "types": "./dist/polyfills.d.ts",
+      "import": "./dist/polyfills.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
@@ -51,19 +55,22 @@
     "@typescript-eslint/eslint-plugin": "^8.34.0",
     "@typescript-eslint/parser": "^8.34.0",
     "@vitest/coverage-v8": "^3.2.4",
-    "dotenv": "^16.5.0",
+    "dotenv": "17.2.0",
     "eslint": "^9.29.0",
     "tsup": "^8.5.0",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^2.1.9"
+    "vitest": "3.2.4"
   },
   "dependencies": {
     "@nillion/nuc": "0.1.0-rc.8",
     "@noble/curves": "^1.9.2",
     "@noble/secp256k1": "^2.3.0",
     "openai": "^5.3.0",
     "zod": "^3.25.64"
+  },
+  "optionalDependencies": {
+    "buffer": "^6.0.3"
   }
 }

pnpm-lock.yaml

@@ -1,3 +1,6 @@
+// Import polyfills first to ensure they're available when other modules load
+import './polyfills';
+
 export { NilaiOpenAIClient } from "./client";
 export { DelegationTokenServer } from './server';
 export {

src/index.ts

@@ -0,0 +1,102 @@
+/**
+ * Polyfills for Node.js environment compatibility
+ * This module ensures that browser APIs like atob, btoa, Buffer, and crypto
+ * are available in Node.js environments where they might be missing.
+ */
+
+function ensureGlobals() {
+  // Ensure globalThis is available (for older Node.js versions)
+  if (typeof globalThis === 'undefined') {
+    // @ts-ignore
+    global.globalThis = global;
+  }
+
+  // Node.js environment polyfills
+  if (typeof globalThis !== 'undefined') {
+    // atob polyfill for Node.js (base64 decode)
+    if (typeof globalThis.atob === 'undefined') {
+      globalThis.atob = function(str: string): string {
+        try {
+          // Use Node.js Buffer if available
+          if (typeof Buffer !== 'undefined') {
+            return Buffer.from(str, 'base64').toString('binary');
+          }
+          // Fallback for environments without Buffer
+          throw new Error('atob not supported in this environment');
+        } catch (error) {
+          throw new Error(`Invalid base64 string: ${error}`);
+        }
+      };
+    }
+
+    // btoa polyfill for Node.js (base64 encode)
+    if (typeof globalThis.btoa === 'undefined') {
+      globalThis.btoa = function(str: string): string {
+        try {
+          // Use Node.js Buffer if available
+          if (typeof Buffer !== 'undefined') {
+            return Buffer.from(str, 'binary').toString('base64');
+          }
+          // Fallback for environments without Buffer
+          throw new Error('btoa not supported in this environment');
+        } catch (error) {
+          throw new Error(`Invalid string for base64 encoding: ${error}`);
+        }
+      };
+    }
+
+    // Buffer polyfill for environments that don't have it globally
+    if (typeof globalThis.Buffer === 'undefined') {
+      try {
+        // Try to import Buffer from Node.js
+        if (typeof require !== 'undefined') {
+          const { Buffer: NodeBuffer } = require('buffer');
+          globalThis.Buffer = NodeBuffer;
+        } else {
+          // Try to use a buffer polyfill if available via dynamic import
+          // Note: This is a best-effort approach for ESM environments
+          import('buffer').then(({ Buffer: PolyfillBuffer }) => {
+            globalThis.Buffer = PolyfillBuffer;
+          }).catch(() => {
+            // Buffer not available, some functionality may be limited
+            console.warn('@nillion/nilai-ts: Buffer not available, some functionality may be limited');
+          });
+        }
+      } catch {
+        // Buffer not available
+      }
+    }
+
+    // Crypto polyfill for Node.js
+    if (typeof globalThis.crypto === 'undefined') {
+      try {
+        if (typeof require !== 'undefined') {
+          const crypto = require('crypto');
+          // Use webcrypto if available (Node.js 16+), otherwise use crypto
+          globalThis.crypto = crypto.webcrypto || crypto;
+        }
+      } catch {
+        // crypto not available
+        console.warn('@nillion/nilai-ts: crypto not available, some functionality may be limited');
+      }
+    }
+
+    // TextEncoder/TextDecoder polyfills for older Node.js versions
+    if (typeof globalThis.TextEncoder === 'undefined') {
+      try {
+        if (typeof require !== 'undefined') {
+          const util = require('util');
+          globalThis.TextEncoder = util.TextEncoder;
+          globalThis.TextDecoder = util.TextDecoder;
+        }
+      } catch {
+        // TextEncoder/TextDecoder not available
+      }
+    }
+  }
+}
+
+// Auto-initialize when module is imported
+ensureGlobals();
+
+export { ensureGlobals }; 

src/polyfills.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from "tsup";
 
 export default defineConfig({
-  entry: ["src/index.ts"],
+  entry: ["src/index.ts", "src/polyfills.ts"],
   format: ["esm"],
   dts: true,
   splitting: false,