Add a cross-platform base64 encoder/decoder

Author: jeskew

packages/util-base64-browser/package.json

@@ -2,7 +2,7 @@
   "name": "@aws/util-base64-browser",
   "private": true,
   "version": "0.0.1",
-  "description": "A cross-platform Base64 <-> UInt8Array converter",
+  "description": "A pure JS Base64 <-> UInt8Array converter",
   "main": "index.js",
   "scripts": {
     "prepublishOnly": "tsc",

packages/util-base64-universal/.gitignore

@@ -0,0 +1,4 @@
+/node_modules/
+*.js
+*.js.map
+*.d.ts

packages/util-base64-universal/__tests__/index.ts

@@ -0,0 +1,62 @@
+import { fromBase64, toBase64 } from "../";
+
+jest.mock("@aws/util-base64-browser", () => {
+  return {
+    fromBase64: jest.fn(),
+    toBase64: jest.fn()
+  };
+});
+import {
+  fromBase64 as browserFromBase64,
+  toBase64 as browserToBase64
+} from "@aws/util-base64-browser";
+
+jest.mock("@aws/util-base64-node", () => {
+  return {
+    fromBase64: jest.fn(),
+    toBase64: jest.fn()
+  };
+});
+import {
+  fromBase64 as nodeFromBase64,
+  toBase64 as nodeToBase64
+} from "@aws/util-base64-node";
+
+jest.mock("@aws/is-node", () => {
+  return { isNode: jest.fn() };
+});
+import { isNode } from "@aws/is-node";
+
+beforeEach(() => {
+  (browserFromBase64 as any).mockReset();
+  (browserToBase64 as any).mockReset();
+  (nodeFromBase64 as any).mockReset();
+  (nodeToBase64 as any).mockReset();
+  (isNode as any).mockReset();
+});
+
+describe("implementation selection", () => {
+  it("should use the node implementation in node", () => {
+    (isNode as any).mockReturnValue(true);
+
+    fromBase64("foo");
+    expect((nodeFromBase64 as any).mock.calls.length).toBe(1);
+    expect((browserFromBase64 as any).mock.calls.length).toBe(0);
+
+    toBase64(new Uint8Array(0));
+    expect((nodeToBase64 as any).mock.calls.length).toBe(1);
+    expect((browserToBase64 as any).mock.calls.length).toBe(0);
+  });
+
+  it("should use the browser implementation elsewhere", () => {
+    (isNode as any).mockReturnValue(false);
+
+    fromBase64("foo");
+    expect((nodeFromBase64 as any).mock.calls.length).toBe(0);
+    expect((browserFromBase64 as any).mock.calls.length).toBe(1);
+
+    toBase64(new Uint8Array(0));
+    expect((nodeToBase64 as any).mock.calls.length).toBe(0);
+    expect((browserToBase64 as any).mock.calls.length).toBe(1);
+  });
+});

packages/util-base64-universal/index.ts

@@ -0,0 +1,25 @@
+import { isNode } from "@aws/is-node";
+import {
+  fromBase64 as browserFromBase64,
+  toBase64 as browserToBase64
+} from "@aws/util-base64-browser";
+import {
+  fromBase64 as nodeFromBase64,
+  toBase64 as nodeToBase64
+} from "@aws/util-base64-node";
+
+export function fromBase64(input: string): Uint8Array {
+  if (isNode()) {
+    return nodeFromBase64(input);
+  }
+
+  return browserFromBase64(input);
+}
+
+export function toBase64(input: Uint8Array): string {
+  if (isNode()) {
+    return nodeToBase64(input);
+  }
+
+  return browserToBase64(input);
+}

packages/util-base64-universal/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@aws/util-base64-universal",
+  "private": true,
+  "version": "0.0.1",
+  "description": "A cross-platform Base64 <-> UInt8Array converter",
+  "main": "index.js",
+  "scripts": {
+    "prepublishOnly": "tsc",
+    "pretest": "tsc",
+    "test": "jest"
+  },
+  "author": "[email protected]",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@aws/is-node": "^0.0.1",
+    "@aws/util-base64-browser": "^0.0.1",
+    "@aws/util-base64-node": "^0.0.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^19.2.2",
+    "@types/node": "^7.0.12",
+    "jest": "^19.0.2",
+    "typescript": "^2.3"
+  }
+}

packages/util-base64-universal/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "module": "commonjs",
+    "declaration": true,
+    "sourceMap": true,
+    "strict": true
+  }
+}