@unwanted/matrix-sdk-mini 34.12.0-1

package/lib/http-api/index.js

@@ -0,0 +1,180 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { FetchHttpApi } from "./fetch.js";
+import { MediaPrefix } from "./prefix.js";
+import { defer, removeElement } from "../utils.js";
+import * as callbacks from "../realtime-callbacks.js";
+import { Method } from "./method.js";
+import { ConnectionError } from "./errors.js";
+import { parseErrorResponse } from "./utils.js";
+export * from "./interface.js";
+export * from "./prefix.js";
+export * from "./errors.js";
+export * from "./method.js";
+export * from "./utils.js";
+export class MatrixHttpApi extends FetchHttpApi {
+  constructor() {
+    super(...arguments);
+    _defineProperty(this, "uploads", []);
+  }
+  /**
+   * Upload content to the homeserver
+   *
+   * @param file - The object to upload. On a browser, something that
+   *   can be sent to XMLHttpRequest.send (typically a File).  Under node.js,
+   *   a Buffer, String or ReadStream.
+   *
+   * @param opts - options object
+   *
+   * @returns Promise which resolves to response object, as
+   *    determined by this.opts.onlyData, opts.rawResponse, and
+   *    opts.onlyContentUri.  Rejects with an error (usually a MatrixError).
+   */
+  uploadContent(file) {
+    var _opts$includeFilename, _opts$abortController, _opts$type, _opts$name;
+    var opts = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    var includeFilename = (_opts$includeFilename = opts.includeFilename) !== null && _opts$includeFilename !== void 0 ? _opts$includeFilename : true;
+    var abortController = (_opts$abortController = opts.abortController) !== null && _opts$abortController !== void 0 ? _opts$abortController : new AbortController();
+
+    // If the file doesn't have a mime type, use a default since the HS errors if we don't supply one.
+    var contentType = ((_opts$type = opts.type) !== null && _opts$type !== void 0 ? _opts$type : file.type) || "application/octet-stream";
+    var fileName = (_opts$name = opts.name) !== null && _opts$name !== void 0 ? _opts$name : file.name;
+    var upload = {
+      loaded: 0,
+      total: 0,
+      abortController
+    };
+    var deferred = defer();
+    if (globalThis.XMLHttpRequest) {
+      var xhr = new globalThis.XMLHttpRequest();
+      var timeoutFn = function timeoutFn() {
+        xhr.abort();
+        deferred.reject(new Error("Timeout"));
+      };
+
+      // set an initial timeout of 30s; we'll advance it each time we get a progress notification
+      var timeoutTimer = callbacks.setTimeout(timeoutFn, 30000);
+      xhr.onreadystatechange = function () {
+        switch (xhr.readyState) {
+          case globalThis.XMLHttpRequest.DONE:
+            callbacks.clearTimeout(timeoutTimer);
+            try {
+              if (xhr.status === 0) {
+                throw new DOMException(xhr.statusText, "AbortError"); // mimic fetch API
+              }
+              if (!xhr.responseText) {
+                throw new Error("No response body.");
+              }
+              if (xhr.status >= 400) {
+                deferred.reject(parseErrorResponse(xhr, xhr.responseText));
+              } else {
+                deferred.resolve(JSON.parse(xhr.responseText));
+              }
+            } catch (err) {
+              if (err.name === "AbortError") {
+                deferred.reject(err);
+                return;
+              }
+              deferred.reject(new ConnectionError("request failed", err));
+            }
+            break;
+        }
+      };
+      xhr.upload.onprogress = ev => {
+        var _opts$progressHandler;
+        callbacks.clearTimeout(timeoutTimer);
+        upload.loaded = ev.loaded;
+        upload.total = ev.total;
+        timeoutTimer = callbacks.setTimeout(timeoutFn, 30000);
+        (_opts$progressHandler = opts.progressHandler) === null || _opts$progressHandler === void 0 || _opts$progressHandler.call(opts, {
+          loaded: ev.loaded,
+          total: ev.total
+        });
+      };
+      var url = this.getUrl("/upload", undefined, MediaPrefix.V3);
+      if (includeFilename && fileName) {
+        url.searchParams.set("filename", encodeURIComponent(fileName));
+      }
+      if (!this.opts.useAuthorizationHeader && this.opts.accessToken) {
+        url.searchParams.set("access_token", encodeURIComponent(this.opts.accessToken));
+      }
+      xhr.open(Method.Post, url.href);
+      if (this.opts.useAuthorizationHeader && this.opts.accessToken) {
+        xhr.setRequestHeader("Authorization", "Bearer " + this.opts.accessToken);
+      }
+      xhr.setRequestHeader("Content-Type", contentType);
+      xhr.send(file);
+      abortController.signal.addEventListener("abort", () => {
+        xhr.abort();
+      });
+    } else {
+      var queryParams = {};
+      if (includeFilename && fileName) {
+        queryParams.filename = fileName;
+      }
+      var headers = {
+        "Content-Type": contentType
+      };
+      this.authedRequest(Method.Post, "/upload", queryParams, file, {
+        prefix: MediaPrefix.V3,
+        headers,
+        abortSignal: abortController.signal
+      }).then(response => {
+        return this.opts.onlyData ? response : response.json();
+      }).then(deferred.resolve, deferred.reject);
+    }
+
+    // remove the upload from the list on completion
+    upload.promise = deferred.promise.finally(() => {
+      removeElement(this.uploads, elem => elem === upload);
+    });
+    abortController.signal.addEventListener("abort", () => {
+      removeElement(this.uploads, elem => elem === upload);
+      deferred.reject(new DOMException("Aborted", "AbortError"));
+    });
+    this.uploads.push(upload);
+    return upload.promise;
+  }
+  cancelUpload(promise) {
+    var upload = this.uploads.find(u => u.promise === promise);
+    if (upload) {
+      upload.abortController.abort();
+      return true;
+    }
+    return false;
+  }
+  getCurrentUploads() {
+    return this.uploads;
+  }
+
+  /**
+   * Get the content repository url with query parameters.
+   * @returns An object with a 'base', 'path' and 'params' for base URL,
+   *          path and query parameters respectively.
+   */
+  getContentUri() {
+    return {
+      base: this.opts.baseUrl,
+      path: MediaPrefix.V3 + "/upload",
+      params: {
+        access_token: this.opts.accessToken
+      }
+    };
+  }
+}
+//# sourceMappingURL=index.js.map

package/lib/http-api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["FetchHttpApi","MediaPrefix","defer","removeElement","callbacks","Method","ConnectionError","parseErrorResponse","MatrixHttpApi","constructor","arguments","_defineProperty","uploadContent","file","_opts$includeFilename","_opts$abortController","_opts$type","_opts$name","opts","length","undefined","includeFilename","abortController","AbortController","contentType","type","fileName","name","upload","loaded","total","deferred","globalThis","XMLHttpRequest","xhr","timeoutFn","abort","reject","Error","timeoutTimer","setTimeout","onreadystatechange","readyState","DONE","clearTimeout","status","DOMException","statusText","responseText","resolve","JSON","parse","err","onprogress","ev","_opts$progressHandler","progressHandler","call","url","getUrl","V3","searchParams","set","encodeURIComponent","useAuthorizationHeader","accessToken","open","Post","href","setRequestHeader","send","signal","addEventListener","queryParams","filename","headers","authedRequest","prefix","abortSignal","then","response","onlyData","json","promise","finally","uploads","elem","push","cancelUpload","find","u","getCurrentUploads","getContentUri","base","baseUrl","path","params","access_token"],"sources":["../../src/http-api/index.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { FetchHttpApi } from \"./fetch.ts\";\nimport { FileType, IContentUri, IHttpOpts, Upload, UploadOpts, UploadResponse } from \"./interface.ts\";\nimport { MediaPrefix } from \"./prefix.ts\";\nimport { defer, QueryDict, removeElement } from \"../utils.ts\";\nimport * as callbacks from \"../realtime-callbacks.ts\";\nimport { Method } from \"./method.ts\";\nimport { ConnectionError } from \"./errors.ts\";\nimport { parseErrorResponse } from \"./utils.ts\";\n\nexport * from \"./interface.ts\";\nexport * from \"./prefix.ts\";\nexport * from \"./errors.ts\";\nexport * from \"./method.ts\";\nexport * from \"./utils.ts\";\n\nexport class MatrixHttpApi<O extends IHttpOpts> extends FetchHttpApi<O> {\n    private uploads: Upload[] = [];\n\n    /**\n     * Upload content to the homeserver\n     *\n     * @param file - The object to upload. On a browser, something that\n     *   can be sent to XMLHttpRequest.send (typically a File).  Under node.js,\n     *   a Buffer, String or ReadStream.\n     *\n     * @param opts - options object\n     *\n     * @returns Promise which resolves to response object, as\n     *    determined by this.opts.onlyData, opts.rawResponse, and\n     *    opts.onlyContentUri.  Rejects with an error (usually a MatrixError).\n     */\n    public uploadContent(file: FileType, opts: UploadOpts = {}): Promise<UploadResponse> {\n        const includeFilename = opts.includeFilename ?? true;\n        const abortController = opts.abortController ?? new AbortController();\n\n        // If the file doesn't have a mime type, use a default since the HS errors if we don't supply one.\n        const contentType = (opts.type ?? (file as File).type) || \"application/octet-stream\";\n        const fileName = opts.name ?? (file as File).name;\n\n        const upload = {\n            loaded: 0,\n            total: 0,\n            abortController,\n        } as Upload;\n        const deferred = defer<UploadResponse>();\n\n        if (globalThis.XMLHttpRequest) {\n            const xhr = new globalThis.XMLHttpRequest();\n\n            const timeoutFn = function (): void {\n                xhr.abort();\n                deferred.reject(new Error(\"Timeout\"));\n            };\n\n            // set an initial timeout of 30s; we'll advance it each time we get a progress notification\n            let timeoutTimer = callbacks.setTimeout(timeoutFn, 30000);\n\n            xhr.onreadystatechange = function (): void {\n                switch (xhr.readyState) {\n                    case globalThis.XMLHttpRequest.DONE:\n                        callbacks.clearTimeout(timeoutTimer);\n                        try {\n                            if (xhr.status === 0) {\n                                throw new DOMException(xhr.statusText, \"AbortError\"); // mimic fetch API\n                            }\n                            if (!xhr.responseText) {\n                                throw new Error(\"No response body.\");\n                            }\n\n                            if (xhr.status >= 400) {\n                                deferred.reject(parseErrorResponse(xhr, xhr.responseText));\n                            } else {\n                                deferred.resolve(JSON.parse(xhr.responseText));\n                            }\n                        } catch (err) {\n                            if ((<Error>err).name === \"AbortError\") {\n                                deferred.reject(err);\n                                return;\n                            }\n                            deferred.reject(new ConnectionError(\"request failed\", <Error>err));\n                        }\n                        break;\n                }\n            };\n\n            xhr.upload.onprogress = (ev: ProgressEvent): void => {\n                callbacks.clearTimeout(timeoutTimer);\n                upload.loaded = ev.loaded;\n                upload.total = ev.total;\n                timeoutTimer = callbacks.setTimeout(timeoutFn, 30000);\n                opts.progressHandler?.({\n                    loaded: ev.loaded,\n                    total: ev.total,\n                });\n            };\n\n            const url = this.getUrl(\"/upload\", undefined, MediaPrefix.V3);\n\n            if (includeFilename && fileName) {\n                url.searchParams.set(\"filename\", encodeURIComponent(fileName));\n            }\n\n            if (!this.opts.useAuthorizationHeader && this.opts.accessToken) {\n                url.searchParams.set(\"access_token\", encodeURIComponent(this.opts.accessToken));\n            }\n\n            xhr.open(Method.Post, url.href);\n            if (this.opts.useAuthorizationHeader && this.opts.accessToken) {\n                xhr.setRequestHeader(\"Authorization\", \"Bearer \" + this.opts.accessToken);\n            }\n            xhr.setRequestHeader(\"Content-Type\", contentType);\n            xhr.send(file);\n\n            abortController.signal.addEventListener(\"abort\", () => {\n                xhr.abort();\n            });\n        } else {\n            const queryParams: QueryDict = {};\n            if (includeFilename && fileName) {\n                queryParams.filename = fileName;\n            }\n\n            const headers: Record<string, string> = { \"Content-Type\": contentType };\n\n            this.authedRequest<UploadResponse>(Method.Post, \"/upload\", queryParams, file, {\n                prefix: MediaPrefix.V3,\n                headers,\n                abortSignal: abortController.signal,\n            })\n                .then((response) => {\n                    return this.opts.onlyData ? <UploadResponse>response : response.json();\n                })\n                .then(deferred.resolve, deferred.reject);\n        }\n\n        // remove the upload from the list on completion\n        upload.promise = deferred.promise.finally(() => {\n            removeElement(this.uploads, (elem) => elem === upload);\n        });\n        abortController.signal.addEventListener(\"abort\", () => {\n            removeElement(this.uploads, (elem) => elem === upload);\n            deferred.reject(new DOMException(\"Aborted\", \"AbortError\"));\n        });\n        this.uploads.push(upload);\n        return upload.promise;\n    }\n\n    public cancelUpload(promise: Promise<UploadResponse>): boolean {\n        const upload = this.uploads.find((u) => u.promise === promise);\n        if (upload) {\n            upload.abortController.abort();\n            return true;\n        }\n        return false;\n    }\n\n    public getCurrentUploads(): Upload[] {\n        return this.uploads;\n    }\n\n    /**\n     * Get the content repository url with query parameters.\n     * @returns An object with a 'base', 'path' and 'params' for base URL,\n     *          path and query parameters respectively.\n     */\n    public getContentUri(): IContentUri {\n        return {\n            base: this.opts.baseUrl,\n            path: MediaPrefix.V3 + \"/upload\",\n            params: {\n                access_token: this.opts.accessToken!,\n            },\n        };\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/http-api/interface.d.ts

@@ -0,0 +1,142 @@
+import { MatrixError } from "./errors.ts";
+import { Logger } from "../logger.ts";
+export type Body = Record<string, any> | BodyInit;
+/**
+ * @experimental
+ * Unencrypted access and (optional) refresh token
+ */
+export type AccessTokens = {
+    accessToken: string;
+    refreshToken?: string;
+};
+/**
+ * @experimental
+ * Function that performs token refresh using the given refreshToken.
+ * Returns a promise that resolves to the refreshed access and (optional) refresh tokens.
+ *
+ * Can be passed to HttpApi instance as {@link IHttpOpts.tokenRefreshFunction} during client creation {@link ICreateClientOpts}
+ */
+export type TokenRefreshFunction = (refreshToken: string) => Promise<AccessTokens>;
+export interface IHttpOpts {
+    fetchFn?: typeof globalThis.fetch;
+    baseUrl: string;
+    idBaseUrl?: string;
+    prefix: string;
+    extraParams?: Record<string, string>;
+    accessToken?: string;
+    /**
+     * Used in conjunction with tokenRefreshFunction to attempt token refresh
+     */
+    refreshToken?: string;
+    /**
+     * Function to attempt token refresh when a possibly expired token is encountered
+     * Optional, only called when a refreshToken is present
+     */
+    tokenRefreshFunction?: TokenRefreshFunction;
+    useAuthorizationHeader?: boolean;
+    onlyData?: boolean;
+    localTimeoutMs?: number;
+    /** Optional logger instance. If provided, requests and responses will be logged. */
+    logger?: Logger;
+}
+export interface IRequestOpts extends Pick<RequestInit, "priority"> {
+    /**
+     * The alternative base url to use.
+     * If not specified, uses this.opts.baseUrl
+     */
+    baseUrl?: string;
+    /**
+     * The full prefix to use e.g.
+     * "/_matrix/client/v2_alpha". If not specified, uses this.opts.prefix.
+     */
+    prefix?: string;
+    /**
+     * map of additional request headers
+     */
+    headers?: Record<string, string>;
+    abortSignal?: AbortSignal;
+    /**
+     * The maximum amount of time to wait before
+     * timing out the request. If not specified, there is no timeout.
+     */
+    localTimeoutMs?: number;
+    keepAlive?: boolean;
+    json?: boolean;
+    inhibitLogoutEmit?: boolean;
+}
+export interface IContentUri {
+    base: string;
+    path: string;
+    params: {
+        access_token: string;
+    };
+}
+export declare enum HttpApiEvent {
+    SessionLoggedOut = "Session.logged_out",
+    NoConsent = "no_consent"
+}
+export type HttpApiEventHandlerMap = {
+    /**
+     * Fires whenever the login session the JS SDK is using is no
+     * longer valid and the user must log in again.
+     * NB. This only fires when action is required from the user, not
+     * when then login session can be renewed by using a refresh token.
+     * @example
+     * ```
+     * matrixClient.on("Session.logged_out", function(errorObj){
+     *   // show the login screen
+     * });
+     * ```
+     */
+    [HttpApiEvent.SessionLoggedOut]: (err: MatrixError) => void;
+    /**
+     * Fires when the JS SDK receives a M_CONSENT_NOT_GIVEN error in response
+     * to a HTTP request.
+     * @example
+     * ```
+     * matrixClient.on("no_consent", function(message, contentUri) {
+     *     console.info(message + ' Go to ' + contentUri);
+     * });
+     * ```
+     */
+    [HttpApiEvent.NoConsent]: (message: string, consentUri: string) => void;
+};
+export interface UploadProgress {
+    loaded: number;
+    total: number;
+}
+export interface UploadOpts {
+    /**
+     * Name to give the file on the server. Defaults to <tt>file.name</tt>.
+     */
+    name?: string;
+    /**
+     * Content-type for the upload. Defaults to
+     *   <tt>file.type</tt>, or <tt>applicaton/octet-stream</tt>.
+     */
+    type?: string;
+    /**
+     * if false will not send the filename,
+     *   e.g for encrypted file uploads where filename leaks are undesirable.
+     *   Defaults to true.
+     */
+    includeFilename?: boolean;
+    /**
+     * Optional. Called when a chunk of
+     *    data has been uploaded, with an object containing the fields `loaded`
+     *    (number of bytes transferred) and `total` (total size, if known).
+     */
+    progressHandler?(progress: UploadProgress): void;
+    abortController?: AbortController;
+}
+export interface Upload {
+    loaded: number;
+    total: number;
+    promise: Promise<UploadResponse>;
+    abortController: AbortController;
+}
+export interface UploadResponse {
+    content_uri: string;
+}
+export type FileType = XMLHttpRequestBodyInit;
+//# sourceMappingURL=interface.d.ts.map

package/lib/http-api/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/http-api/interface.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AACF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AACnF,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAElC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC/D;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IAKf,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAEJ,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;CACL;AAED,oBAAY,YAAY;IACpB,gBAAgB,uBAAuB;IACvC,SAAS,eAAe;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAAG;IACjC;;;;;;;;;;;OAWG;IACH,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IAC5D;;;;;;;;;OASG;IACH,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E,CAAC;AAEF,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACjD,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC;AAED,MAAM,WAAW,MAAM;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAE3B,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,QAAQ,GAAG,sBAAsB,CAAC"}

package/lib/http-api/interface.js

@@ -0,0 +1,35 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+/**
+ * @experimental
+ * Unencrypted access and (optional) refresh token
+ */
+
+/**
+ * @experimental
+ * Function that performs token refresh using the given refreshToken.
+ * Returns a promise that resolves to the refreshed access and (optional) refresh tokens.
+ *
+ * Can be passed to HttpApi instance as {@link IHttpOpts.tokenRefreshFunction} during client creation {@link ICreateClientOpts}
+ */
+
+export var HttpApiEvent = /*#__PURE__*/function (HttpApiEvent) {
+  HttpApiEvent["SessionLoggedOut"] = "Session.logged_out";
+  HttpApiEvent["NoConsent"] = "no_consent";
+  return HttpApiEvent;
+}({});
+//# sourceMappingURL=interface.js.map

package/lib/http-api/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","names":["HttpApiEvent"],"sources":["../../src/http-api/interface.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { MatrixError } from \"./errors.ts\";\nimport { Logger } from \"../logger.ts\";\n\nexport type Body = Record<string, any> | BodyInit;\n\n/**\n * @experimental\n * Unencrypted access and (optional) refresh token\n */\nexport type AccessTokens = {\n    accessToken: string;\n    refreshToken?: string;\n};\n/**\n * @experimental\n * Function that performs token refresh using the given refreshToken.\n * Returns a promise that resolves to the refreshed access and (optional) refresh tokens.\n *\n * Can be passed to HttpApi instance as {@link IHttpOpts.tokenRefreshFunction} during client creation {@link ICreateClientOpts}\n */\nexport type TokenRefreshFunction = (refreshToken: string) => Promise<AccessTokens>;\nexport interface IHttpOpts {\n    fetchFn?: typeof globalThis.fetch;\n\n    baseUrl: string;\n    idBaseUrl?: string;\n    prefix: string;\n    extraParams?: Record<string, string>;\n\n    accessToken?: string;\n    /**\n     * Used in conjunction with tokenRefreshFunction to attempt token refresh\n     */\n    refreshToken?: string;\n    /**\n     * Function to attempt token refresh when a possibly expired token is encountered\n     * Optional, only called when a refreshToken is present\n     */\n    tokenRefreshFunction?: TokenRefreshFunction;\n    useAuthorizationHeader?: boolean; // defaults to true\n\n    onlyData?: boolean;\n    localTimeoutMs?: number;\n\n    /** Optional logger instance. If provided, requests and responses will be logged. */\n    logger?: Logger;\n}\n\nexport interface IRequestOpts extends Pick<RequestInit, \"priority\"> {\n    /**\n     * The alternative base url to use.\n     * If not specified, uses this.opts.baseUrl\n     */\n    baseUrl?: string;\n    /**\n     * The full prefix to use e.g.\n     * \"/_matrix/client/v2_alpha\". If not specified, uses this.opts.prefix.\n     */\n    prefix?: string;\n    /**\n     * map of additional request headers\n     */\n    headers?: Record<string, string>;\n    abortSignal?: AbortSignal;\n    /**\n     * The maximum amount of time to wait before\n     * timing out the request. If not specified, there is no timeout.\n     */\n    localTimeoutMs?: number;\n    keepAlive?: boolean; // defaults to false\n    json?: boolean; // defaults to true\n\n    // Set to true to prevent the request function from emitting a Session.logged_out event.\n    // This is intended for use on endpoints where M_UNKNOWN_TOKEN is a valid/notable error response,\n    // such as with token refreshes.\n    inhibitLogoutEmit?: boolean;\n}\n\nexport interface IContentUri {\n    base: string;\n    path: string;\n    params: {\n        // eslint-disable-next-line camelcase\n        access_token: string;\n    };\n}\n\nexport enum HttpApiEvent {\n    SessionLoggedOut = \"Session.logged_out\",\n    NoConsent = \"no_consent\",\n}\n\nexport type HttpApiEventHandlerMap = {\n    /**\n     * Fires whenever the login session the JS SDK is using is no\n     * longer valid and the user must log in again.\n     * NB. This only fires when action is required from the user, not\n     * when then login session can be renewed by using a refresh token.\n     * @example\n     * ```\n     * matrixClient.on(\"Session.logged_out\", function(errorObj){\n     *   // show the login screen\n     * });\n     * ```\n     */\n    [HttpApiEvent.SessionLoggedOut]: (err: MatrixError) => void;\n    /**\n     * Fires when the JS SDK receives a M_CONSENT_NOT_GIVEN error in response\n     * to a HTTP request.\n     * @example\n     * ```\n     * matrixClient.on(\"no_consent\", function(message, contentUri) {\n     *     console.info(message + ' Go to ' + contentUri);\n     * });\n     * ```\n     */\n    [HttpApiEvent.NoConsent]: (message: string, consentUri: string) => void;\n};\n\nexport interface UploadProgress {\n    loaded: number;\n    total: number;\n}\n\nexport interface UploadOpts {\n    /**\n     * Name to give the file on the server. Defaults to <tt>file.name</tt>.\n     */\n    name?: string;\n    /**\n     * Content-type for the upload. Defaults to\n     *   <tt>file.type</tt>, or <tt>applicaton/octet-stream</tt>.\n     */\n    type?: string;\n    /**\n     * if false will not send the filename,\n     *   e.g for encrypted file uploads where filename leaks are undesirable.\n     *   Defaults to true.\n     */\n    includeFilename?: boolean;\n    /**\n     * Optional. Called when a chunk of\n     *    data has been uploaded, with an object containing the fields `loaded`\n     *    (number of bytes transferred) and `total` (total size, if known).\n     */\n    progressHandler?(progress: UploadProgress): void;\n    abortController?: AbortController;\n}\n\nexport interface Upload {\n    loaded: number;\n    total: number;\n    promise: Promise<UploadResponse>;\n    abortController: AbortController;\n}\n\nexport interface UploadResponse {\n    // eslint-disable-next-line camelcase\n    content_uri: string;\n}\n\nexport type FileType = XMLHttpRequestBodyInit;\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;;AAoEA,WAAYA,YAAY,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA","ignoreList":[]}

package/lib/http-api/method.d.ts

@@ -0,0 +1,10 @@
+export declare enum Method {
+    Get = "GET",
+    Put = "PUT",
+    Post = "POST",
+    Delete = "DELETE",
+    Options = "OPTIONS",
+    Head = "HEAD",
+    Patch = "PATCH"
+}
+//# sourceMappingURL=method.d.ts.map

package/lib/http-api/method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.d.ts","sourceRoot":"","sources":["../../src/http-api/method.ts"],"names":[],"mappings":"AAgBA,oBAAY,MAAM;IACd,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;CAClB"}

package/lib/http-api/method.js

@@ -0,0 +1,27 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+export var Method = /*#__PURE__*/function (Method) {
+  Method["Get"] = "GET";
+  Method["Put"] = "PUT";
+  Method["Post"] = "POST";
+  Method["Delete"] = "DELETE";
+  Method["Options"] = "OPTIONS";
+  Method["Head"] = "HEAD";
+  Method["Patch"] = "PATCH";
+  return Method;
+}({});
+//# sourceMappingURL=method.js.map

package/lib/http-api/method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"method.js","names":["Method"],"sources":["../../src/http-api/method.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nexport enum Method {\n    Get = \"GET\",\n    Put = \"PUT\",\n    Post = \"POST\",\n    Delete = \"DELETE\",\n    Options = \"OPTIONS\",\n    Head = \"HEAD\",\n    Patch = \"PATCH\",\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,WAAYA,MAAM,0BAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAAA,OAANA,MAAM;AAAA","ignoreList":[]}

package/lib/http-api/prefix.d.ts

@@ -0,0 +1,31 @@
+export declare enum ClientPrefix {
+    /**
+     * A constant representing the URI path for Client-Server API endpoints versioned at v1.
+     */
+    V1 = "/_matrix/client/v1",
+    /**
+     * A constant representing the URI path for Client-Server API endpoints versioned at v3.
+     */
+    V3 = "/_matrix/client/v3",
+    /**
+     * A constant representing the URI path for as-yet unspecified Client-Server HTTP APIs.
+     */
+    Unstable = "/_matrix/client/unstable"
+}
+export declare enum IdentityPrefix {
+    /**
+     * URI path for the v2 identity API
+     */
+    V2 = "/_matrix/identity/v2"
+}
+export declare enum MediaPrefix {
+    /**
+     * A constant representing the URI path for Client-Server API Media endpoints versioned at v1.
+     */
+    V1 = "/_matrix/media/v1",
+    /**
+     * A constant representing the URI path for Client-Server API Media endpoints versioned at v3.
+     */
+    V3 = "/_matrix/media/v3"
+}
+//# sourceMappingURL=prefix.d.ts.map

package/lib/http-api/prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix.d.ts","sourceRoot":"","sources":["../../src/http-api/prefix.ts"],"names":[],"mappings":"AAgBA,oBAAY,YAAY;IACpB;;OAEG;IACH,EAAE,uBAAuB;IACzB;;OAEG;IACH,EAAE,uBAAuB;IACzB;;OAEG;IACH,QAAQ,6BAA6B;CACxC;AAED,oBAAY,cAAc;IACtB;;OAEG;IACH,EAAE,yBAAyB;CAC9B;AAED,oBAAY,WAAW;IACnB;;OAEG;IACH,EAAE,sBAAsB;IACxB;;OAEG;IACH,EAAE,sBAAsB;CAC3B"}

package/lib/http-api/prefix.js

@@ -0,0 +1,32 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+export var ClientPrefix = /*#__PURE__*/function (ClientPrefix) {
+  ClientPrefix["V1"] = "/_matrix/client/v1";
+  ClientPrefix["V3"] = "/_matrix/client/v3";
+  ClientPrefix["Unstable"] = "/_matrix/client/unstable";
+  return ClientPrefix;
+}({});
+export var IdentityPrefix = /*#__PURE__*/function (IdentityPrefix) {
+  IdentityPrefix["V2"] = "/_matrix/identity/v2";
+  return IdentityPrefix;
+}({});
+export var MediaPrefix = /*#__PURE__*/function (MediaPrefix) {
+  MediaPrefix["V1"] = "/_matrix/media/v1";
+  MediaPrefix["V3"] = "/_matrix/media/v3";
+  return MediaPrefix;
+}({});
+//# sourceMappingURL=prefix.js.map

package/lib/http-api/prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefix.js","names":["ClientPrefix","IdentityPrefix","MediaPrefix"],"sources":["../../src/http-api/prefix.ts"],"sourcesContent":["/*\nCopyright 2022 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nexport enum ClientPrefix {\n    /**\n     * A constant representing the URI path for Client-Server API endpoints versioned at v1.\n     */\n    V1 = \"/_matrix/client/v1\",\n    /**\n     * A constant representing the URI path for Client-Server API endpoints versioned at v3.\n     */\n    V3 = \"/_matrix/client/v3\",\n    /**\n     * A constant representing the URI path for as-yet unspecified Client-Server HTTP APIs.\n     */\n    Unstable = \"/_matrix/client/unstable\",\n}\n\nexport enum IdentityPrefix {\n    /**\n     * URI path for the v2 identity API\n     */\n    V2 = \"/_matrix/identity/v2\",\n}\n\nexport enum MediaPrefix {\n    /**\n     * A constant representing the URI path for Client-Server API Media endpoints versioned at v1.\n     */\n    V1 = \"/_matrix/media/v1\",\n    /**\n     * A constant representing the URI path for Client-Server API Media endpoints versioned at v3.\n     */\n    V3 = \"/_matrix/media/v3\",\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,WAAYA,YAAY,0BAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAZA,YAAY;EAAA,OAAZA,YAAY;AAAA;AAexB,WAAYC,cAAc,0BAAdA,cAAc;EAAdA,cAAc;EAAA,OAAdA,cAAc;AAAA;AAO1B,WAAYC,WAAW,0BAAXA,WAAW;EAAXA,WAAW;EAAXA,WAAW;EAAA,OAAXA,WAAW;AAAA","ignoreList":[]}

package/lib/http-api/utils.d.ts

@@ -0,0 +1,37 @@
+export declare function timeoutSignal(ms: number): AbortSignal;
+export declare function anySignal(signals: AbortSignal[]): {
+    signal: AbortSignal;
+    cleanup(): void;
+};
+/**
+ * Attempt to turn an HTTP error response into a Javascript Error.
+ *
+ * If it is a JSON response, we will parse it into a MatrixError. Otherwise
+ * we return a generic Error.
+ *
+ * @param response - response object
+ * @param body - raw body of the response
+ * @returns
+ */
+export declare function parseErrorResponse(response: XMLHttpRequest | Response, body?: string): Error;
+/**
+ * Retries a network operation run in a callback.
+ * @param maxAttempts - maximum attempts to try
+ * @param callback - callback that returns a promise of the network operation. If rejected with ConnectionError, it will be retried by calling the callback again.
+ * @returns the result of the network operation
+ * @throws {@link ConnectionError} If after maxAttempts the callback still throws ConnectionError
+ */
+export declare function retryNetworkOperation<T>(maxAttempts: number, callback: () => Promise<T>): Promise<T>;
+/**
+ * Calculate the backoff time for a request retry attempt.
+ * This produces wait times of 2, 4, 8, and 16 seconds (30s total) after which we give up. If the
+ * failure was due to a rate limited request, the time specified in the error is returned.
+ *
+ * Returns -1 if the error is not retryable, or if we reach the maximum number of attempts.
+ *
+ * @param err - The error thrown by the http call
+ * @param attempts - The number of attempts made so far, including the one that just failed.
+ * @param retryConnectionError - Whether to retry on {@link ConnectionError} (CORS, connection is down, etc.)
+ */
+export declare function calculateRetryBackoff(err: any, attempts: number, retryConnectionError: boolean): number;
+//# sourceMappingURL=utils.d.ts.map

package/lib/http-api/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/http-api/utils.ts"],"names":[],"mappings":"AAuBA,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAOrD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG;IAC/C,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACnB,CA0BA;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAiC5F;AA0BD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAqB1G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAG,MAAM,CA0BvG"}