Latest
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356import * as path from "https://deno.land/std/path/mod.ts";
/** * Determines the MIME type from a file extension. * * @private * * @param {string} filePath is the path to a file * @returns {string} the MIME type */function _determineMimeType(filePath: string) : string { const fileExtension: string = path.extname(filePath);
switch (fileExtension) { case ".aac": return "audio/aac"; case ".abw": return "application/x-abiword"; case ".arc": return "application/x-freearc"; case ".avi": return "video/x-msvideo"; case ".azw": return "application/vnd.amazon.ebook"; case ".bin": return "application/octet-stream"; case ".bmp": return "image/bmp"; case ".bz": return "application/x-bzip"; case ".bz2": return "application/x-bzip2"; case ".csh": return "application/x-csh"; case ".css": return "text/css"; case ".csv": return "text/csv"; case ".doc": return "application/msword"; case ".docx": return "application/vnd.openxmlformats-officedocument.wordprocessingml.document"; case ".eot": return "application/vnd.ms-fontobject"; case ".epub": return "application/epub+zip"; case ".gz": return "application/gzip"; case ".gif": return "image/gif"; case ".htm": return "text/html"; case ".html": return "text/html"; case ".ico": return "image/vnd.microsoft.icon"; case ".ics": return "text/calendar"; case ".jar": return "application/java-archive"; case ".jpeg": return "image/jpeg"; case ".jpg": return "image/jpeg"; case ".js": return "text/javascript"; case ".json": return "application/json"; case ".jsonld": return "application/ld+json"; case ".mid": return "audio/midi"; case ".midi": return "audio/midi"; case ".mjs": return "text/javascript"; case ".mp3": return "audio/mpeg"; case ".mpeg": return "video/mpeg"; case ".mpkg": return "application/vnd.apple.installer+xml"; case ".odp": return "application/vnd.oasis.opendocument.presentation"; case ".ods": return "application/vnd.oasis.opendocument.spreadsheet"; case ".odt": return "application/vnd.oasis.opendocument.text"; case ".oga": return "audio/ogg"; case ".ogv": return "video/ogg"; case ".ogx": return "application/ogg"; case ".opus": return "audio/opus"; case ".otf": return "font/otf"; case ".png": return "image/png"; case ".pdf": return "application/pdf"; case ".php": return "application/php"; case ".ppt": return "application/vnd.ms-powerpoint"; case ".pptx": return "application/vnd.openxmlformats-officedocument.presentationml.presentation"; case ".rar": return "application/vnd.rar"; case ".rtf": return "application/rtf"; case ".sh": return "application/x-sh"; case ".svg": return "image/svg+xml"; case ".swf": return "application/x-shockwave-flash"; case ".tar": return "application/x-tar"; case ".tif": return "image/tiff"; case ".tiff": return "image/tiff"; case ".ts": return "video/mp2t"; case ".ttf": return "font/ttf"; case ".txt": return "text/plain"; case ".vsd": return "application/vnd.visio"; case ".wav": return "audio/wav"; case ".weba": return "audio/webm"; case ".webm": return "video/webm"; case ".webp": return "image/webp"; case ".woff": return "font/woff"; case ".woff2": return "font/woff2"; case ".xhtml": return "application/xhtml+xml"; case ".xls": return "application/vnd.ms-excel"; case ".xlsx": return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"; case ".xml": return "application/xml"; case ".xul": return "application/vnd.mozilla.xul+xml"; case ".zip": return "application/zip"; case ".3gp": return "video/3gpp"; case ".3g2": return "video/3gpp2"; case ".7z": return "application/x-7z-compressed"; } throw new Error("File extension has no known mimetype");}
/** * Encodes a Uint8Array into a base64 string * * @private * * @param {any} uint8arr a Uint8Array * @returns {string} a base64 encoded string */function _encodeU8intToBase64String(uint8arr: any) : string { const CHUNK_SIZE = 0x8000; const charArray: string[] = []; for (let i = 0; i < uint8arr.length; i += CHUNK_SIZE) { charArray.push(String.fromCharCode.apply(null, uint8arr.subarray(i, i + CHUNK_SIZE))); } return btoa(charArray.join(""));}
/** * Converts a string to a Uint8Array * * @private * * @param {string} str a string * @returns {Uint8Array} a Uint8Array from the string */function _convertStringToUint8(str: string) : Uint8Array { return new Uint8Array(new TextEncoder().encode(str))}
/** * Decodes a UInt8Array that contains base64 data into a base64 decoded string * * @private * * @param {Uint8Array} bytes a Uint8Array that contains base64 encoded data * @returns {string} an base64 unencoded string */function _decodeBase64Bytes(bytes: Uint8Array) : string { return new TextDecoder().decode(Uint8Array.from(atob(new TextDecoder().decode(bytes)), c => c.charCodeAt(0)))}
/** * Decodes a Uint8Array that contains base64 data into a base64 decoded Uint8Array * * @private * * @param {Uint8Array} bytes a Uint8Array that contains base64 encoded data * @returns {Uint8Array} an base64 unencoded Uint8Array */function _decodeBase64BytesToUint8(bytes: Uint8Array) : Uint8Array { return Uint8Array.from(atob(new TextDecoder().decode(bytes)), c => c.charCodeAt(0));}
/** * This class provides an easy interface to perform base64 encoding on strings * and files. */export class Base64 { private bytes: Uint8Array; private mime: string; private isBase64Encoded: boolean; public constructor(data: any) { this.bytes = data.bytes; this.mime = data.mime; this.isBase64Encoded = data.isBase64Encoded; } /** * Creates a Base64 object from a string * * @public * @static * * @param {string} unencodedString a string that will be base64 encoded * @returns {Base64} a Base64 object */ public static fromString(unencodedString: string) : Base64 { return new Base64({ bytes: _convertStringToUint8(unencodedString), mime: null, isBase64Encoded: false, }); } /** * Creates a Base64 object from an already base64 encoded string * * @public * @static * * @param {string} encodedString a string that is already base64 encoded * @returns {Base64} a Base64 object */ public static fromBase64String(encodedString: string) : Base64 { return new Base64({ bytes: _convertStringToUint8(encodedString), mime: null, isBase64Encoded: true, }); } /** * Creates a Base64 object from a Uint8Array * * @public * @static * * @param {Uint8Array} uint8arr a Uint8Array that will be base64 encoded * @returns {Base64} a Base64 object */ public static fromUint8Array(uint8arr: Uint8Array) : Base64 { return new Base64({ bytes: uint8arr, mime: null, isBase64Encoded: false, }); }
/** * Creates a Base64 object from a base64 encoded Uint8Array * * @public * @static * * @param {Uint8Array} uint8arr a Uint8Array that contains base64 encoded data * @returns {Base64} a Base64 object */ public static fromBase64Uint8Array(uint8arr: Uint8Array) : Base64 { return new Base64({ bytes: uint8arr, mime: null, isBase64Encoded: true, }); } /** * Creates a Base64 object from the contents of a file * * @public * @static * * @param {string} filePath the path to a file that will be base64 encoded * @returns {Base64} a Base64 object */ public static fromFile(filePath: string) : Base64 { return new Base64({ bytes: Deno.readFileSync(filePath), mime: `data:${_determineMimeType(filePath)};base64,`, isBase64Encoded: false, }); } /** * Creates a Base64 object from the contents of an already base64 encoded file * * @public * @static * * @param {string} filePath the path to a file that will be base64 decoded * @returns {Base64} a Base64 object */ public static fromBase64File(filePath: string) : Base64 { return new Base64({ bytes: Deno.readFileSync(filePath), mime: null, isBase64Encoded: true, }); } /** * Returns the base64 encoded string from the Base64 object * * @public * * @returns {Base64} a base64 encoded string */ public toString() : string { if (this.isBase64Encoded) { return _decodeBase64Bytes(this.bytes); } else { return _encodeU8intToBase64String(this.bytes); } } /** * Returns the base64 encoded string from the Base64 object, with the * inclusion of the MIME type if the Base64 object was created from a file * (and if not created from a file, works the same as the .toString() method) * * @public * * @returns {string} a base64 encoded string with MIME type included when from a file */ public toStringWithMime() : string { if (this.mime) { if (this.isBase64Encoded) { return _decodeBase64Bytes(this.bytes); } else { return this.mime + _encodeU8intToBase64String(this.bytes); } } else { if (this.isBase64Encoded) { return _decodeBase64Bytes(this.bytes); } else { return _encodeU8intToBase64String(this.bytes); } } } /** * Writes the base64 string from the Base64 object to a file * * @public * * @param {string} filePath the path to the file that the Base64 contents will be written to */ public toFile(filePath: string) : void { if (this.isBase64Encoded) { Deno.writeFileSync(filePath, _decodeBase64BytesToUint8(this.bytes)) } else { Deno.writeFileSync(filePath, new TextEncoder().encode(_encodeU8intToBase64String(this.bytes))); } } /** * Writes the base64 string from the Base64 object to a file, including the * MIME type when writing to the file. * * @public * * @param {string} filePath the path to the file that the Base64 contents will be written to */ public toFileWithMime(filePath: string) : void { if (!this.mime) { this.toFile(filePath); } else { Deno.writeFileSync(filePath, new TextEncoder().encode(this.mime + _encodeU8intToBase64String(this.bytes))); } }}