lucid-extension-sdk 0.0.8 → 0.0.15

package/interop.d.ts

@@ -1,8 +1,12 @@
+/** @ignore */
 declare namespace lucid {
     export function executeCommand(name: string, params: any): any;
     export function listen(msg: any): void;
+    export function getPackageId(): string;
+    export function getVersion(): string;
 }
 
+/** @ignore */
 declare namespace console {
     export function log(...args: any[]): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lucid-extension-sdk",
-    "version": "0.0.8",
+    "version": "0.0.15",
     "description": "Utility classes for writing Lucid Software editor extensions",
     "main": "sdk/index.js",
     "types": "sdk/index.d.ts",
@@ -8,10 +8,10 @@
     "license": "Apache-2.0",
     "declaration": true,
     "devDependencies": {
-        "@bazel/typescript": "2.0.1",
         "@types/jasmine": "^3.10.3",
         "@types/node": "^16.11.11",
-        "typedoc": "^0.22.11",
+        "typedoc": "^0.22.15",
+        "typedoc-plugin-markdown": "^3.12.1",
         "typescript": "4.3.5"
     }
 }

package/sdk/commandtypes.d.ts

@@ -5,13 +5,25 @@ import { JsonObject, JsonSerializable } from './core/jsonserializable';
 import { LinearOffsetType } from './core/offsettype';
 import { SerializedDataError } from './core/serializeddataerror';
 import { ShapeDataInheritance } from './core/shapedatainheritance';
+import { SerializedLineTextAreaPositioning } from './document/linetextareapositioning';
 import { Box, Point } from './math';
 import { MenuLocation, MenuType } from './ui/menu';
+import { PanelLocation } from './ui/panel';
+/**
+ * The lucid-extension-sdk library interacts with core Lucid products through this set of possible commands.
+ * Typically, an extension author will not need to access any of these commands directly, as they are all
+ * exposed through appropriate classes and methods elsewhere in this SDK.
+ *
+ * To use these directly, use [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand).
+ */
 export declare const enum CommandName {
+    AddLineTextArea = "alta",
     AddMenuItem = "ami",
     AddShapeData = "asd",
+    Alert = "a",
     AnimateViewport = "av",
     Bootstrap = "b",
+    Confirm = "c",
     CreateBlock = "cb",
     CreateCollection = "cc",
     CreateDataSource = "cds",
@@ -35,6 +47,10 @@ export declare const enum CommandName {
     GetSelection = "gs",
     GetShapeData = "gsd",
     HideModal = "hm",
+    HidePanel = "hp",
+    HookCreateItems = "hci",
+    HookSelection = "hs",
+    HookTextEdit = "hte",
     KillExtension = "k",
     ListBlocks = "lb",
     ListCollectionFields = "lcf",
@@ -52,6 +68,7 @@ export declare const enum CommandName {
     LogForTestCase = "log",
     OffsetItems = "oi",
     PatchDataItems = "pdi",
+    RegisterPanel = "rp",
     ReloadExtension = "r",
     SendOAuthRequest = "oauth",
     SendUIMessage = "suim",
@@ -61,12 +78,21 @@ export declare const enum CommandName {
     SetReferenceKey = "srk",
     SetShapeData = "ssd",
     ShowModal = "sm",
-    SleepForTestCase = "sleep"
+    ShowPanel = "spn",
+    SleepForTestCase = "sleep",
+    UnhookCreateItems = "uci",
+    UnhookSelection = "us",
+    UnhookTextEdit = "ute"
 }
+/**
+ * This is a type declaration whose purpose is to allow TypeScript to enforce the correct parameter and
+ * return types from [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand) based on
+ * which command name you pass in as the first parameter.
+ */
 export declare type CommandArgs = {
-    [CommandName.AnimateViewport]: {
-        query: AnimateViewportQuery;
-        result: AnimateViewportResult;
+    [CommandName.AddLineTextArea]: {
+        query: AddLineTextAreaQuery;
+        result: AddLineTextAreaResult;
     };
     [CommandName.AddMenuItem]: {
         query: AddMenuItemQuery;
@@ -76,10 +102,22 @@ export declare type CommandArgs = {
         query: AddShapeDataQuery;
         result: AddShapeDataResult;
     };
+    [CommandName.Alert]: {
+        query: AlertQuery;
+        result: AlertResult;
+    };
+    [CommandName.AnimateViewport]: {
+        query: AnimateViewportQuery;
+        result: AnimateViewportResult;
+    };
     [CommandName.Bootstrap]: {
         query: BootstrapQuery;
         result: BootstrapResult;
     };
+    [CommandName.Confirm]: {
+        query: ConfirmQuery;
+        result: ConfirmResult;
+    };
     [CommandName.CreateBlock]: {
         query: CreateBlockQuery;
         result: CreateBlockResult;
@@ -172,6 +210,22 @@ export declare type CommandArgs = {
         query: HideModalQuery;
         result: HideModalResult;
     };
+    [CommandName.HidePanel]: {
+        query: HidePanelQuery;
+        result: HidePanelResult;
+    };
+    [CommandName.HookCreateItems]: {
+        query: HookCreateItemsQuery;
+        result: HookCreateItemsResult;
+    };
+    [CommandName.HookSelection]: {
+        query: HookSelectionQuery;
+        result: HookSelectionResult;
+    };
+    [CommandName.HookTextEdit]: {
+        query: HookTextEditQuery;
+        result: HookTextEditResult;
+    };
     [CommandName.KillExtension]: {
         query: KillExtensionQuery;
         result: KillExtensionResult;
@@ -230,7 +284,7 @@ export declare type CommandArgs = {
     };
     [CommandName.LogForTestCase]: {
         query: JsonSerializable;
-        result: undefined;
+        result: JsonSerializable;
     };
     [CommandName.OffsetItems]: {
         query: OffsetItemsQuery;
@@ -240,6 +294,10 @@ export declare type CommandArgs = {
         query: PatchDataItemsQuery;
         result: PatchDataItemsResult;
     };
+    [CommandName.RegisterPanel]: {
+        query: RegisterPanelQuery;
+        result: RegisterPanelResult;
+    };
     [CommandName.ReloadExtension]: {
         query: ReloadExtensionQuery;
         result: ReloadExtensionResult;
@@ -276,28 +334,86 @@ export declare type CommandArgs = {
         query: ShowModalQuery;
         result: ShowModalResult;
     };
+    [CommandName.ShowPanel]: {
+        query: ShowPanelQuery;
+        result: ShowPanelResult;
+    };
     [CommandName.SleepForTestCase]: {
         query: SleepForTestCaseQuery;
         result: SleepForTestCaseResult;
     };
+    [CommandName.UnhookCreateItems]: {
+        query: UnhookCreateItemsQuery;
+        result: UnhookCreateItemsResult;
+    };
+    [CommandName.UnhookSelection]: {
+        query: UnhookSelectionQuery;
+        result: UnhookSelectionResult;
+    };
+    [CommandName.UnhookTextEdit]: {
+        query: UnhookTextEditQuery;
+        result: UnhookTextEditResult;
+    };
 };
+export declare type AddLineTextAreaQuery = {
+    /** Which line */
+    'id': string;
+    /** Where to place the text along the line */
+    'p': SerializedLineTextAreaPositioning;
+    /** Plain text to put at this location (will be styled with document theme) */
+    't': string;
+};
+/** The name of the created text area */
+export declare type AddLineTextAreaResult = string;
+/** @ignore */
 export declare type UnionToIntersection<T> = (T extends any ? (x: T) => unknown : never) extends (x: infer R) => unknown ? R : never;
 export declare type AddMenuItemQuery = {
+    /** Label to display on the menu item */
     'l': string;
-    'a': string;
+    /** Named action to run when the menu item is clicked */
+    'a'?: string;
+    /** Named action that returns whether the menu item should be visible */
     'v'?: string;
+    /** Named action that returns whether the menu item should be disabled */
     'd'?: string;
+    /** Which menu to put the item in */
     't': MenuType;
+    /** If specified, where to place the menu item; defaults to MenuLocation.Extension */
     'loc'?: MenuLocation;
+    /** If specified, this menu item should launch a file picker */
+    'f'?: {
+        /** Action to call when files are selected */
+        'a': string;
+        /** File types to accept */
+        'ac': string;
+        /** Single file only */
+        's'?: boolean;
+        /** Return content in a binary ArrayBuffer instead of as text */
+        'b'?: boolean;
+    };
 };
 export declare type AddMenuItemResult = undefined;
 export declare type AddShapeDataQuery = {
+    /** ID of the element to add this shape data to */
     'id'?: string | undefined;
+    /** Name for this shape data */
     'n': string;
+    /** Inheritance setting for the new shape data */
     'i': ShapeDataInheritance;
+    /** Initial value of this shape data; use a string beginning with '=' for a formula */
     'v'?: SerializedFieldType;
 };
 export declare type AddShapeDataResult = undefined;
+export declare type AlertQuery = {
+    /** Title; defaults to extension title */
+    't'?: string;
+    /** Body text */
+    'b': string;
+    /** Button text; defaults to i18n'ed "OK" */
+    'bt'?: string;
+};
+/** True if they click OK, false otherwise */
+export declare type AlertResult = Promise<boolean>;
 export declare type BootstrapQuery = {
     /**
      * Named action that accepts the bootstrap data, and which may return a Promise or void. After awaiting\
@@ -306,31 +422,61 @@ export declare type BootstrapQuery = {
     'c': string;
 };
 export declare type BootstrapResult = Promise<void>;
+export declare type ConfirmQuery = {
+    /** Title; defaults to extension title */
+    't'?: string;
+    /** Body text */
+    'b': string;
+    /** OK button text; defaults to i18n'ed "OK" */
+    'o'?: string;
+    /** Cancel button text; defaults to i18n'ed "Cancel" */
+    'c'?: string;
+};
+/** True if they click OK, false otherwise */
+export declare type ConfirmResult = Promise<boolean>;
 export declare type CreateBlockQuery = {
+    /**
+     * By default, we add the block to the current page & currently active group. If specified, the
+     * block will instead be created as a direct child of the given page.
+     */
     'p'?: string;
+    /** Class name of the block to create */
     'c': string;
+    /** If specified, the stencil for a custom shape. Only valid if the class name is 'CustomBlock' */
     's'?: JsonSerializable | undefined;
 };
 export declare type CreateBlockResult = string;
 export declare type CreateCollectionFieldDefinition = {
+    /** Name of the field */
     'n': string;
+    /** Type of the values in this field */
     't': SerializedFieldTypeDefinition;
 };
 export declare type CreateCollectionQuery = {
+    /** ID of the data source to add this collection to */
     's': string;
+    /** Name of the collection */
     'n': string;
+    /** Fields that can be set on data items in this collection */
     'f': CreateCollectionFieldDefinition[];
+    /** Field(s) to use as the primary key of this collection */
     'p': string[];
 };
 export declare type CreateCollectionResult = string;
 export declare type CreateDataSourceQuery = {
+    /** Name of the data source */
     'n': string;
+    /** Source configuration for this data source--information about where it came from, or any metadata that might be useful */
     's': {
         [key: string]: JsonSerializable;
     };
 };
 export declare type CreateDataSourceResult = string;
 export declare type CreateLineQuery = {
+    /**
+     * By default, we add the line to the current page & currently active group. If specified, the
+     * line will instead be created as a direct child of the given page.
+     */
     'p'?: string;
 };
 export declare type CreateLineResult = string;
@@ -341,14 +487,20 @@ export declare type DeleteItemResult = boolean;
 export declare type DeletePageQuery = string;
 export declare type DeletePageResult = boolean;
 export declare type DeleteShapeDataQuery = {
+    /** ID of the element to delete this shape data from */
     'id'?: string | undefined;
+    /** Name for this shape data */
     'n': string;
 };
 export declare type DeleteShapeDataResult = undefined;
 export declare type DownloadQuery = {
+    /** Filename of the download */
     'f': string;
+    /** Data to put in the file */
     'd': string;
+    /** MIME type for the download */
     'm': string;
+    /** If true, data is base64-encoded and should be converted to binary for download */
     'b64': boolean;
 };
 export declare type DownloadResult = undefined;
@@ -357,12 +509,16 @@ export declare type ElementExistsQuery = {
 };
 export declare type ElementExistsResult = boolean;
 export declare type ExecuteFormulaQuery = {
+    /** ID of the element to execute a formula on */
     'id': string;
+    /** Formula to execute, e.g. '@a + @b' or 'CONTAINEDBY' */
     'f': string;
 };
 export declare type ExecuteFormulaResult = SerializedFieldType | SerializedDataError;
 export declare type AnimateViewportQuery = {
+    /** ID of the page to view */
     'p': string;
+    /** Bounding box on that page that will fill as much of the viewport as possible */
     'bb': Box;
 };
 export declare type AnimateViewportResult = Promise<void>;
@@ -375,66 +531,109 @@ export declare type GetConnectedLinesResult = string[];
 export declare type GetCurrentPageQuery = void;
 export declare type GetCurrentPageResult = string | undefined;
 export declare type GetCustomShapeQuery = {
+    /** Name of the custom shape library in this same extension package */
     'l': string;
+    /** Name of the shape in that library to find */
     's': string;
 };
 export declare type GetCustomShapeResult = Promise<{
+    /** Value which can be used as the Stencil property on a dynamic shape */
     's': JsonSerializable;
+    /** Default size (x:0, y:0) of this custom shape */
     'bb': Box;
+    /** Other default property values */
     'p': JsonObject;
 } | undefined>;
 export declare type GetDataItemFieldQuery = {
+    /** Collection ID to query */
     'c': string;
+    /** Primary key of the data item to read */
     'pk': string;
+    /** Name of field to read */
     'f': string;
 };
 export declare type GetDataItemFieldResult = SerializedFieldType;
 export declare type GetItemPageIdQuery = string;
 export declare type GetItemPageIdResult = string;
 export declare type GetReferenceKeyQuery = {
+    /** ID of the LucidElement to read a reference key from, or undefined to read from the LucidDocument */
     'id'?: string;
+    /** Reference key to get */
     'k': number | string;
 };
 export declare type GetReferenceKeyResult = SerializedReferenceKeyType;
 export declare type GetPropertyQuery = {
+    /** ID of the LucidElement to read a property from, or undefined to read from the LucidDocument */
     'id'?: string | undefined;
+    /** Name of the property to read */
     'p': string;
 };
 export declare type GetPropertyResult = JsonSerializable;
 export declare type GetRelativeLinePositionQuery = {
+    /** Block or line ID to check the connections on */
     'id': string;
+    /** Relative position in range of [0,1] along the line */
     'p': number;
 };
 export declare type GetRelativeLinePositionResult = Point;
 export declare type GetSelectionQuery = {
+    /** If set, additionally return all items inside selected groups */
     'd'?: boolean;
 };
 export declare type GetSelectionResult = string[];
 export declare type GetShapeDataQuery = {
+    /** ID of the element to query shape data from */
     'id'?: string | undefined;
+    /** Name of the shape data to read */
     'n': string;
 };
 export declare type GetShapeDataResult = SerializedFieldType | SerializedDataError;
 export declare type HideModalQuery = {
+    /** Name of the modal's action for receiving events, i.e. ShowModalQuery['n'] */
     'n': string;
 };
 export declare type HideModalResult = undefined;
+export declare type HidePanelQuery = {
+    /** Name of the panel's action for receiving events, i.e. RegisterPanelQuery['n'] */
+    'n': string;
+};
+export declare type HidePanelResult = undefined;
+export declare type HookCreateItemsQuery = {
+    /** Name of the action for receiving events. Will be called with an array of strings of all recently created item IDs. */
+    'n': string;
+};
+export declare type HookCreateItemsResult = undefined;
+export declare type HookSelectionQuery = {
+    /** Name of the action for receiving events. Will be called with an array of strings of all selected item IDs. */
+    'n': string;
+};
+export declare type HookSelectionResult = undefined;
+export declare type HookTextEditQuery = {
+    /** Name of the action for receiving these events */
+    'n': string;
+};
+export declare type HookTextEditResult = undefined;
 export declare type KillExtensionQuery = void;
 export declare type KillExtensionResult = undefined;
 export declare type ListChildrenQuery = {
+    /** Parent ID to search inside */
     'id': string;
+    /** "deep" - If true, get all children at any level of group nesting; otherwise only immediate children */
     'd'?: boolean;
 };
 export declare type ListChildrenResult = string[];
 export declare type ListCollectionsQuery = {
+    /** ID of the data source to list collections for */
     'id': string;
 };
 export declare type ListCollectionsResult = string[];
 export declare type ListDataItemsQuery = {
+    /** Collection ID to list items from */
     'id': string;
 };
 export declare type ListDataItemsResult = string[];
 export declare type ListCollectionFieldsQuery = {
+    /** Collection ID to query */
     'id': string;
 };
 export declare type ListCollectionFieldsResult = string[];
@@ -443,8 +642,10 @@ export declare type ListDataSourcesResult = string[];
 export declare type ListPagesQuery = void;
 export declare type ListPagesResult = string[];
 export declare type ListReferenceKeysQuery = {
+    /** ID of the element to list reference keys for, or undefined for the document */
     'id'?: string | undefined;
 };
+/** Reference key IDs */
 export declare type ListReferenceKeysResult = (string | number)[];
 export declare type ListPropertiesQuery = {
     'id'?: string | undefined;
@@ -452,6 +653,7 @@ export declare type ListPropertiesQuery = {
 export declare type ListPropertiesResult = string[];
 export declare type ListShapeDataQuery = {
     'id'?: string | undefined;
+    /** True to include inherited shape data from containing groups and/or page */
     'i'?: boolean | undefined;
 };
 export declare type ListShapeDataResult = string[];
@@ -460,31 +662,57 @@ export declare type ListTextAreasResult = string[];
 export declare type LoadBlockClassesQuery = string[];
 export declare type LoadBlockClassesResult = Promise<undefined>;
 export declare type OffsetItemsQuery = {
+    /** IDs of the items (blocks, lines, groups) to move */
     'ids': string[];
+    /** What kind of offset to perform */
     't': LinearOffsetType;
+    /** How far to offset */
     'o': Point;
 };
 export declare type OffsetItemsResult = undefined;
 export declare type PatchDataItemsQuery = {
+    /** ID of the data collection to patch */
     'id': string;
+    /** Data items to add to the collection */
     'a': Record<string, SerializedFieldType>[];
+    /** Data items to change field values on, keyed by primary key */
     'c': Record<string, Record<string, SerializedFieldType>>;
+    /** Primary keys of items to delete */
     'd': string[];
 };
 export declare type PatchDataItemsResult = undefined;
+export declare type RegisterPanelQuery = {
+    /** Name of the panel's action for receiving events; generated automatically by Panel base class */
+    'n': string;
+    /** Title to show on the panel */
+    't': string;
+    /** Where to display the panel */
+    'l': PanelLocation;
+    /** Named action that returns whether the button to open the panel should be visible */
+    'v'?: string;
+    /** Content to display in the panel; full HTML page preferred */
+    'c': string;
+    /** Icon URL, preferably a base64-encoded URL */
+    'i': string;
+};
+export declare type RegisterPanelResult = undefined;
 export declare type ReloadExtensionQuery = void;
 export declare type ReloadExtensionResult = undefined;
 export declare type SendOAuthRequestQuery = SendXHRQuery & {
+    /** OAuth provider name as specified in the package manifest */
     'p': string;
 };
 export declare type SendOAuthRequestResponse = SendXHRResponse;
 export declare type SendUIMessageQuery = {
+    /** Name of the UI component's action for receiving events, e.g. ShowModalQuery['n'] */
     'n': string;
+    /** Content of the message to send to the custom UI component */
     'd'?: JsonSerializable;
 };
 export declare type SendUIMessageResult = undefined;
 export declare type SendXHRQuery = {
     'url': string;
+    /** HTTP method, e.g. 'GET', 'FETCH', etc. Defaults to GET */
     'm'?: string;
     /**
      * The data to send with the request.
@@ -495,48 +723,90 @@ export declare type SendXHRQuery = {
      *   no 'Content-Type' header is specified, a 'text/plain; charset=utf-8' content type is sent.
      */
     'd'?: string;
+    /** Headers to send with the request */
     'h'?: {
         [key: string]: string | string[];
     };
+    /** Timeout in milliseconds, if specified */
     'ms'?: number;
 };
 export declare type RawSendXHRResponse = {
+    /** URL of the response after any redirects */
     'url': string;
+    /** Plain-text response body */
     't': string;
+    /** Status code of the response */
     's': number;
+    /** Headers sent with the response */
     'h': {
         [key: string]: string;
     };
+    /** true if the request timed out */
     'to'?: boolean;
 };
 export declare type SendXHRResponse = Promise<RawSendXHRResponse>;
+export declare function isRawSendXHRResponse(val: any): val is RawSendXHRResponse;
 export declare type SetCurrentPageQuery = string;
 export declare type SetCurrentPageResult = Promise<void>;
 export declare type SetPropertyQuery = {
+    /** ID of the element to change */
     'id'?: string | undefined;
+    /** Name of the property to change */
     'p': string;
+    /** New value of the property */
     'v'?: JsonSerializable;
 };
 export declare type SetPropertyResult = undefined;
 export declare type SetReferenceKeyQuery = {
+    /** ID of the element to set the reference key on */
     'id'?: string | undefined;
+    /** ID of the reference key to set */
     'k': string | number;
+    /** New reference key settings, or undefined to remove the reference key */
     'v'?: SerializedReferenceKeyType;
 };
 export declare type SetReferenceKeyResult = undefined;
 export declare type SetShapeDataQuery = {
+    /** ID of the element to set this shape data on */
     'id'?: string | undefined;
+    /** Name for the already-existing shape data to update */
     'n': string;
+    /** Value to set; use a string beginning with '=' for a formula */
     'v'?: SerializedFieldType;
 };
 export declare type SetShapeDataResult = undefined;
 export declare type ShowModalQuery = {
+    /** Name of the modal's action for receiving events; generated automatically by Modal base class */
     'n': string;
+    /** Title to show on the modal */
     't': string;
+    /** Desired modal width */
     'w': number;
+    /** Desired modal height */
     'h': number;
+    /** Content to display in the modal; full HTML page preferred */
     'c': string;
 };
 export declare type ShowModalResult = undefined;
+export declare type ShowPanelQuery = {
+    /** Name of the panel's action for receiving events, i.e. RegisterPanelQuery['n'] */
+    'n': string;
+};
+export declare type ShowPanelResult = undefined;
 export declare type SleepForTestCaseQuery = number;
 export declare type SleepForTestCaseResult = Promise<void>;
+export declare type UnhookCreateItemsQuery = {
+    /** Name of the action passed to HookCreateItems */
+    'n': string;
+};
+export declare type UnhookCreateItemsResult = undefined;
+export declare type UnhookSelectionQuery = {
+    /** Name of the action for receiving these events */
+    'n': string;
+};
+export declare type UnhookSelectionResult = undefined;
+export declare type UnhookTextEditQuery = {
+    /** Name of the action for receiving these events */
+    'n': string;
+};
+export declare type UnhookTextEditResult = undefined;

package/sdk/commandtypes.js

@@ -1,2 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRawSendXHRResponse = void 0;
+const checks_1 = require("./core/checks");
+function isRawSendXHRResponse(val) {
+    return (0, checks_1.isString)(val['url']) && (0, checks_1.isString)(val['t']) && (0, checks_1.isNumber)(val['s']) && (0, checks_1.isObject)(val['h']);
+}
+exports.isRawSendXHRResponse = isRawSendXHRResponse;

package/sdk/core/base64.d.ts

@@ -0,0 +1 @@
+export declare function decodeBase64(base64String: string): Uint8Array;

package/sdk/core/base64.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeBase64 = void 0;
+const alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
+//This gives a ~8x speedup vs. using alphabet.indexOf() in the main decode loop.
+const charCodeToEncodedInt = [];
+for (let i = 0; i < alphabet.length; i++) {
+    charCodeToEncodedInt[alphabet.charCodeAt(i)] = i;
+}
+function decodeBase64(base64String) {
+    //Filter out whitespace, etc
+    base64String = base64String.replace(/[^A-Za-z0-9\+\/\=]/g, '');
+    if (base64String.length % 4 !== 0) {
+        throw new Error('Invalid base64 input; length must be a multiple of 4');
+    }
+    //4 characters of input turns into 3 bytes of output
+    let bytes = (base64String.length / 4) * 3;
+    //But each trailing = (up to 2) is one fewer byte of output
+    if (base64String.endsWith('==')) {
+        bytes -= 2;
+    }
+    else if (base64String.endsWith('=')) {
+        bytes -= 1;
+    }
+    const output = new Uint8Array(bytes);
+    let inputIndex = 0;
+    for (let outputIndex = 0; outputIndex < bytes; outputIndex += 3) {
+        //Get the 4 numbers 0-63 encoded in the next 4 characters
+        const enc1 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc2 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc3 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        const enc4 = charCodeToEncodedInt[base64String.charCodeAt(inputIndex++)];
+        //Read 8 total bits into each of the output values. Skip one byte
+        //for each padding = at the end of the string
+        output[outputIndex] = (enc1 << 2) | (enc2 >> 4);
+        if (enc3 != 64) {
+            output[outputIndex + 1] = ((enc2 & 15) << 4) | (enc3 >> 2);
+        }
+        if (enc4 != 64) {
+            output[outputIndex + 2] = ((enc3 & 3) << 6) | enc4;
+        }
+    }
+    return output;
+}
+exports.decodeBase64 = decodeBase64;