js-base64 3.7.5 → 3.7.7

package/README.md

@@ -25,7 +25,7 @@ Locally…
 … or Directly from CDN.  In which case you don't even need to install.
 
 ```html
-<script src="https://cdn.jsdelivr.net/npm/js-base64@3.7.5/base64.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/js-base64@3.7.7/base64.min.js"></script>
 ```
 
 This good old way loads `Base64` in the global context (`window`).  Though `Base64.noConflict()` is made available, you should consider using ES6 Module to avoid tainting `window`.
@@ -48,14 +48,14 @@ or even remotely.
 ```html
 <script type="module">
 // note jsdelivr.net does not automatically minify .mjs
-import { Base64 } from 'https://cdn.jsdelivr.net/npm/js-base64@3.7.5/base64.mjs';
+import { Base64 } from 'https://cdn.jsdelivr.net/npm/js-base64@3.7.7/base64.mjs';
 </script>
 ```
 
 ```html
 <script type="module">
 // or if you prefer no Base64 namespace
-import { encode, decode } from 'https://cdn.jsdelivr.net/npm/js-base64@3.7.5/base64.mjs';
+import { encode, decode } from 'https://cdn.jsdelivr.net/npm/js-base64@3.7.7/base64.mjs';
 </script>
 ```
 

package/base64.d.mts

@@ -0,0 +1,135 @@
+/**
+ *  base64.ts
+ *
+ *  Licensed under the BSD 3-Clause License.
+ *    http://opensource.org/licenses/BSD-3-Clause
+ *
+ *  References:
+ *    http://en.wikipedia.org/wiki/Base64
+ *
+ * @author Dan Kogai (https://github.com/dankogai)
+ */
+declare const version = "3.7.7";
+/**
+ * @deprecated use lowercase `version`.
+ */
+declare const VERSION = "3.7.7";
+/**
+ * polyfill version of `btoa`
+ */
+declare const btoaPolyfill: (bin: string) => string;
+/**
+ * does what `window.btoa` of web browsers do.
+ * @param {String} bin binary string
+ * @returns {string} Base64-encoded string
+ */
+declare const _btoa: (bin: string) => string;
+/**
+ * converts a Uint8Array to a Base64 string.
+ * @param {boolean} [urlsafe] URL-and-filename-safe a la RFC4648 §5
+ * @returns {string} Base64 string
+ */
+declare const fromUint8Array: (u8a: Uint8Array, urlsafe?: boolean) => string;
+/**
+ * @deprecated should have been internal use only.
+ * @param {string} src UTF-8 string
+ * @returns {string} UTF-16 string
+ */
+declare const utob: (u: string) => string;
+/**
+ * converts a UTF-8-encoded string to a Base64 string.
+ * @param {boolean} [urlsafe] if `true` make the result URL-safe
+ * @returns {string} Base64 string
+ */
+declare const encode: (src: string, urlsafe?: boolean) => string;
+/**
+ * converts a UTF-8-encoded string to URL-safe Base64 RFC4648 §5.
+ * @returns {string} Base64 string
+ */
+declare const encodeURI: (src: string) => string;
+/**
+ * @deprecated should have been internal use only.
+ * @param {string} src UTF-16 string
+ * @returns {string} UTF-8 string
+ */
+declare const btou: (b: string) => string;
+/**
+ * polyfill version of `atob`
+ */
+declare const atobPolyfill: (asc: string) => string;
+/**
+ * does what `window.atob` of web browsers do.
+ * @param {String} asc Base64-encoded string
+ * @returns {string} binary string
+ */
+declare const _atob: (asc: string) => string;
+/**
+ * converts a Base64 string to a Uint8Array.
+ */
+declare const toUint8Array: (a: string) => Uint8Array;
+/**
+ * converts a Base64 string to a UTF-8 string.
+ * @param {String} src Base64 string.  Both normal and URL-safe are supported
+ * @returns {string} UTF-8 string
+ */
+declare const decode: (src: string) => string;
+/**
+ * check if a value is a valid Base64 string
+ * @param {String} src a value to check
+  */
+declare const isValid: (src: any) => boolean;
+/**
+ * extend String.prototype with relevant methods
+ */
+declare const extendString: () => void;
+/**
+ * extend Uint8Array.prototype with relevant methods
+ */
+declare const extendUint8Array: () => void;
+/**
+ * extend Builtin prototypes with relevant methods
+ */
+declare const extendBuiltins: () => void;
+declare const gBase64: {
+    version: string;
+    VERSION: string;
+    atob: (asc: string) => string;
+    atobPolyfill: (asc: string) => string;
+    btoa: (bin: string) => string;
+    btoaPolyfill: (bin: string) => string;
+    fromBase64: (src: string) => string;
+    toBase64: (src: string, urlsafe?: boolean) => string;
+    encode: (src: string, urlsafe?: boolean) => string;
+    encodeURI: (src: string) => string;
+    encodeURL: (src: string) => string;
+    utob: (u: string) => string;
+    btou: (b: string) => string;
+    decode: (src: string) => string;
+    isValid: (src: any) => boolean;
+    fromUint8Array: (u8a: Uint8Array, urlsafe?: boolean) => string;
+    toUint8Array: (a: string) => Uint8Array;
+    extendString: () => void;
+    extendUint8Array: () => void;
+    extendBuiltins: () => void;
+};
+export { version };
+export { VERSION };
+export { _atob as atob };
+export { atobPolyfill };
+export { _btoa as btoa };
+export { btoaPolyfill };
+export { decode as fromBase64 };
+export { encode as toBase64 };
+export { utob };
+export { encode };
+export { encodeURI };
+export { encodeURI as encodeURL };
+export { btou };
+export { decode };
+export { isValid };
+export { fromUint8Array };
+export { toUint8Array };
+export { extendString };
+export { extendUint8Array };
+export { extendBuiltins };
+export { gBase64 as Base64 };

package/base64.d.ts

@@ -9,11 +9,11 @@
  *
  * @author Dan Kogai (https://github.com/dankogai)
  */
-declare const version = "3.7.5";
+declare const version = "3.7.7";
 /**
  * @deprecated use lowercase `version`.
  */
-declare const VERSION = "3.7.5";
+declare const VERSION = "3.7.7";
 /**
  * polyfill version of `btoa`
  */

package/base64.js

@@ -37,13 +37,11 @@
      *
      * @author Dan Kogai (https://github.com/dankogai)
      */
-    var version = '3.7.5';
+    var version = '3.7.7';
     /**
      * @deprecated use lowercase `version`.
      */
     var VERSION = version;
-    var _hasatob = typeof atob === 'function';
-    var _hasbtoa = typeof btoa === 'function';
     var _hasBuffer = typeof Buffer === 'function';
     var _TD = typeof TextDecoder === 'function' ? new TextDecoder() : undefined;
     var _TE = typeof TextEncoder === 'function' ? new TextEncoder() : undefined;
@@ -87,7 +85,7 @@
      * @param {String} bin binary string
      * @returns {string} Base64-encoded string
      */
-    var _btoa = _hasbtoa ? function (bin) { return btoa(bin); }
+    var _btoa = typeof btoa === 'function' ? function (bin) { return btoa(bin); }
         : _hasBuffer ? function (bin) { return Buffer.from(bin, 'binary').toString('base64'); }
             : btoaPolyfill;
     var _fromUint8Array = _hasBuffer
@@ -216,7 +214,7 @@
      * @param {String} asc Base64-encoded string
      * @returns {string} binary string
      */
-    var _atob = _hasatob ? function (asc) { return atob(_tidyB64(asc)); }
+    var _atob = typeof atob === 'function' ? function (asc) { return atob(_tidyB64(asc)); }
         : _hasBuffer ? function (asc) { return Buffer.from(asc, 'base64').toString('binary'); }
             : atobPolyfill;
     //

package/base64.mjs

@@ -9,13 +9,11 @@
  *
  * @author Dan Kogai (https://github.com/dankogai)
  */
-const version = '3.7.5';
+const version = '3.7.7';
 /**
  * @deprecated use lowercase `version`.
  */
 const VERSION = version;
-const _hasatob = typeof atob === 'function';
-const _hasbtoa = typeof btoa === 'function';
 const _hasBuffer = typeof Buffer === 'function';
 const _TD = typeof TextDecoder === 'function' ? new TextDecoder() : undefined;
 const _TE = typeof TextEncoder === 'function' ? new TextEncoder() : undefined;
@@ -59,7 +57,7 @@ const btoaPolyfill = (bin) => {
  * @param {String} bin binary string
  * @returns {string} Base64-encoded string
  */
-const _btoa = _hasbtoa ? (bin) => btoa(bin)
+const _btoa = typeof btoa === 'function' ? (bin) => btoa(bin)
     : _hasBuffer ? (bin) => Buffer.from(bin, 'binary').toString('base64')
         : btoaPolyfill;
 const _fromUint8Array = _hasBuffer
@@ -182,7 +180,7 @@ const atobPolyfill = (asc) => {
  * @param {String} asc Base64-encoded string
  * @returns {string} binary string
  */
-const _atob = _hasatob ? (asc) => atob(_tidyB64(asc))
+const _atob = typeof atob === 'function' ? (asc) => atob(_tidyB64(asc))
     : _hasBuffer ? (asc) => Buffer.from(asc, 'base64').toString('binary')
         : atobPolyfill;
 //
@@ -269,7 +267,7 @@ const gBase64 = {
     toUint8Array: toUint8Array,
     extendString: extendString,
     extendUint8Array: extendUint8Array,
-    extendBuiltins: extendBuiltins,
+    extendBuiltins: extendBuiltins
 };
 // makecjs:CUT //
 export { version };

package/package.json

@@ -1,38 +1,43 @@
 {
-  "name": "js-base64",
-  "version": "3.7.5",
-  "description": "Yet another Base64 transcoder in pure-JS",
-  "main": "base64.js",
-  "module": "base64.mjs",
-  "types": "base64.d.ts",
-  "sideEffects": false,
-  "files": [
-    "base64.js",
-    "base64.mjs",
-    "base64.d.ts"
-  ],
-  "exports": {
-    ".": {
-      "types": "./base64.d.ts",
-      "import": "./base64.mjs",
-      "require": "./base64.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "scripts": {
-    "test": "make clean && make test"
-  },
-  "devDependencies": {
-    "@types/node": "^14.0.26",
-    "esm": "^3.2.25",
-    "mocha": "^8.4.0",
-    "typescript": "^3.9.7"
-  },
-  "repository": "git+https://github.com/dankogai/js-base64.git",
-  "keywords": [
-    "base64",
-    "binary"
-  ],
-  "author": "Dan Kogai",
-  "license": "BSD-3-Clause"
+	"name": "js-base64",
+	"version": "3.7.7",
+	"description": "Yet another Base64 transcoder in pure-JS",
+	"main": "base64.js",
+	"module": "base64.mjs",
+	"types": "base64.d.ts",
+	"sideEffects": false,
+	"files": [
+		"base64.js",
+		"base64.mjs",
+		"base64.d.ts",
+		"base64.d.mts"
+	],
+	"exports": {
+		".": {
+			"import": {
+				"types": "./base64.d.mts",
+				"default": "./base64.mjs"
+			},
+			"require": {
+				"types": "./base64.d.ts",
+				"default": "./base64.js"
+			}
+		},
+		"./package.json": "./package.json"
+	},
+	"scripts": {
+		"test": "make clean && make test"
+	},
+	"devDependencies": {
+		"@types/node": "^20.11.5",
+		"mocha": "^10.2.0",
+		"typescript": "^5.3.3"
+	},
+	"repository": "git+https://github.com/dankogai/js-base64.git",
+	"keywords": [
+		"base64",
+		"binary"
+	],
+	"author": "Dan Kogai",
+	"license": "BSD-3-Clause"
 }