@textrp/briij-js-sdk 41.0.0

package/lib/content-helpers.js

@@ -0,0 +1,262 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+Copyright 2018 - 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 { MsgType } from "./@types/event.js";
+import { M_TEXT, REFERENCE_RELATION } from "./@types/extensible_events.js";
+import { isProvided } from "./extensible_events_v1/utilities.js";
+import { M_ASSET, LocationAssetType, M_LOCATION, M_TIMESTAMP } from "./@types/location.js";
+import { M_TOPIC } from "./@types/topic.js";
+/**
+ * Generates the content for a HTML Message event
+ * @param body - the plaintext body of the message
+ * @param htmlBody - the HTML representation of the message
+ * @returns
+ */
+export function makeHtmlMessage(body, htmlBody) {
+  return {
+    msgtype: MsgType.Text,
+    format: "org.matrix.custom.html",
+    body: body,
+    formatted_body: htmlBody
+  };
+}
+
+/**
+ * Generates the content for a HTML Notice event
+ * @param body - the plaintext body of the notice
+ * @param htmlBody - the HTML representation of the notice
+ * @returns
+ */
+export function makeHtmlNotice(body, htmlBody) {
+  return {
+    msgtype: MsgType.Notice,
+    format: "org.matrix.custom.html",
+    body: body,
+    formatted_body: htmlBody
+  };
+}
+
+/**
+ * Generates the content for a HTML Emote event
+ * @param body - the plaintext body of the emote
+ * @param htmlBody - the HTML representation of the emote
+ * @returns
+ */
+export function makeHtmlEmote(body, htmlBody) {
+  return {
+    msgtype: MsgType.Emote,
+    format: "org.matrix.custom.html",
+    body: body,
+    formatted_body: htmlBody
+  };
+}
+
+/**
+ * Generates the content for a Plaintext Message event
+ * @param body - the plaintext body of the emote
+ * @returns
+ */
+export function makeTextMessage(body) {
+  return {
+    msgtype: MsgType.Text,
+    body: body
+  };
+}
+
+/**
+ * Generates the content for a Plaintext Notice event
+ * @param body - the plaintext body of the notice
+ * @returns
+ */
+export function makeNotice(body) {
+  return {
+    msgtype: MsgType.Notice,
+    body: body
+  };
+}
+
+/**
+ * Generates the content for a Plaintext Emote event
+ * @param body - the plaintext body of the emote
+ * @returns
+ */
+export function makeEmoteMessage(body) {
+  return {
+    msgtype: MsgType.Emote,
+    body: body
+  };
+}
+
+/** Location content helpers */
+
+export var getTextForLocationEvent = (uri, assetType, timestamp, description) => {
+  var date = "at ".concat(new Date(timestamp).toISOString());
+  var assetName = assetType === LocationAssetType.Self ? "User" : undefined;
+  var quotedDescription = description ? "\"".concat(description, "\"") : undefined;
+  return [assetName, "Location", quotedDescription, uri, date].filter(Boolean).join(" ");
+};
+
+/**
+ * Generates the content for a Location event
+ * @param uri - a geo:// uri for the location
+ * @param timestamp - the timestamp when the location was correct (milliseconds since the UNIX epoch)
+ * @param description - the (optional) label for this location on the map
+ * @param assetType - the (optional) asset type of this location e.g. "m.self"
+ * @param text - optional. A text for the location
+ */
+export var makeLocationContent = (text, uri, timestamp, description, assetType) => {
+  var defaultedText = text !== null && text !== void 0 ? text : getTextForLocationEvent(uri, assetType || LocationAssetType.Self, timestamp, description);
+  var timestampEvent = timestamp ? {
+    [M_TIMESTAMP.name]: timestamp
+  } : {};
+  return _objectSpread({
+    msgtype: MsgType.Location,
+    body: defaultedText,
+    geo_uri: uri,
+    [M_LOCATION.name]: {
+      description,
+      uri
+    },
+    [M_ASSET.name]: {
+      type: assetType || LocationAssetType.Self
+    },
+    [M_TEXT.name]: defaultedText
+  }, timestampEvent);
+};
+
+/**
+ * Parse location event content and transform to
+ * a backwards compatible modern m.location event format
+ */
+export var parseLocationEvent = wireEventContent => {
+  var _location$uri, _asset$type;
+  var location = M_LOCATION.findIn(wireEventContent);
+  var asset = M_ASSET.findIn(wireEventContent);
+  var timestamp = M_TIMESTAMP.findIn(wireEventContent);
+  var text = M_TEXT.findIn(wireEventContent);
+  var geoUri = (_location$uri = location === null || location === void 0 ? void 0 : location.uri) !== null && _location$uri !== void 0 ? _location$uri : wireEventContent === null || wireEventContent === void 0 ? void 0 : wireEventContent.geo_uri;
+  var description = location === null || location === void 0 ? void 0 : location.description;
+  var assetType = (_asset$type = asset === null || asset === void 0 ? void 0 : asset.type) !== null && _asset$type !== void 0 ? _asset$type : LocationAssetType.Self;
+  var fallbackText = text !== null && text !== void 0 ? text : wireEventContent.body;
+  return makeLocationContent(fallbackText, geoUri, timestamp !== null && timestamp !== void 0 ? timestamp : undefined, description, assetType);
+};
+
+/**
+ * Topic event helpers
+ */
+
+export var makeTopicContent = (topic, htmlTopic) => {
+  var renderings = [];
+  // Put HTML first because clients will render the first type in
+  // the array that they understand
+  if (isProvided(htmlTopic)) {
+    renderings.push({
+      body: htmlTopic,
+      mimetype: "text/html"
+    });
+  }
+  if (isProvided(topic)) {
+    renderings.push({
+      body: topic,
+      mimetype: "text/plain"
+    });
+  }
+  return {
+    topic,
+    [M_TOPIC.name]: {
+      "m.text": renderings
+    }
+  };
+};
+export var parseTopicContent = content => {
+  var _ref, _mtopic$find$body, _mtopic$find, _mtopic$find2;
+  var mtopicParent = M_TOPIC.findIn(content);
+  var mtopic = Array.isArray(mtopicParent) ? mtopicParent : mtopicParent === null || mtopicParent === void 0 ? void 0 : mtopicParent["m.text"];
+  // TODO remove support for the old malformed m.topic arrays after a few releases (only allow array in m.text)
+  //      https://github.com/matrix-org/matrix-js-sdk/pull/4984#pullrequestreview-3174251065
+  //const mtopic = M_TOPIC.findIn<MTopicContent>(content)?.["m.text"];
+  if (!Array.isArray(mtopic)) {
+    var _content$topic;
+    return {
+      text: (_content$topic = content.topic) !== null && _content$topic !== void 0 ? _content$topic : undefined
+    };
+  }
+  var text = (_ref = (_mtopic$find$body = mtopic === null || mtopic === void 0 || (_mtopic$find = mtopic.find(r => !isProvided(r.mimetype) || r.mimetype === "text/plain")) === null || _mtopic$find === void 0 ? void 0 : _mtopic$find.body) !== null && _mtopic$find$body !== void 0 ? _mtopic$find$body : content.topic) !== null && _ref !== void 0 ? _ref : undefined;
+  var html = mtopic === null || mtopic === void 0 || (_mtopic$find2 = mtopic.find(r => r.mimetype === "text/html")) === null || _mtopic$find2 === void 0 ? void 0 : _mtopic$find2.body;
+  return {
+    text,
+    html
+  };
+};
+
+/**
+ * Beacon event helpers
+ */
+
+export var makeBeaconInfoContent = (timeout, isLive, description, assetType, timestamp) => ({
+  description,
+  timeout,
+  live: isLive,
+  [M_TIMESTAMP.name]: timestamp || Date.now(),
+  [M_ASSET.name]: {
+    type: assetType !== null && assetType !== void 0 ? assetType : LocationAssetType.Self
+  }
+});
+/**
+ * Flatten beacon info event content
+ */
+export var parseBeaconInfoContent = content => {
+  var _M_TIMESTAMP$findIn;
+  var {
+    description,
+    timeout,
+    live
+  } = content;
+  var timestamp = (_M_TIMESTAMP$findIn = M_TIMESTAMP.findIn(content)) !== null && _M_TIMESTAMP$findIn !== void 0 ? _M_TIMESTAMP$findIn : undefined;
+  var asset = M_ASSET.findIn(content);
+  return {
+    description,
+    timeout,
+    live,
+    assetType: asset === null || asset === void 0 ? void 0 : asset.type,
+    timestamp
+  };
+};
+export var makeBeaconContent = (uri, timestamp, beaconInfoEventId, description) => ({
+  [M_LOCATION.name]: {
+    description,
+    uri
+  },
+  [M_TIMESTAMP.name]: timestamp,
+  "m.relates_to": {
+    rel_type: REFERENCE_RELATION.name,
+    event_id: beaconInfoEventId
+  }
+});
+export var parseBeaconContent = content => {
+  var _M_TIMESTAMP$findIn2;
+  var location = M_LOCATION.findIn(content);
+  var timestamp = (_M_TIMESTAMP$findIn2 = M_TIMESTAMP.findIn(content)) !== null && _M_TIMESTAMP$findIn2 !== void 0 ? _M_TIMESTAMP$findIn2 : undefined;
+  return {
+    description: location === null || location === void 0 ? void 0 : location.description,
+    uri: location === null || location === void 0 ? void 0 : location.uri,
+    timestamp
+  };
+};
+//# sourceMappingURL=content-helpers.js.map

package/lib/content-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-helpers.js","names":["MsgType","M_TEXT","REFERENCE_RELATION","isProvided","M_ASSET","LocationAssetType","M_LOCATION","M_TIMESTAMP","M_TOPIC","makeHtmlMessage","body","htmlBody","msgtype","Text","format","formatted_body","makeHtmlNotice","Notice","makeHtmlEmote","Emote","makeTextMessage","makeNotice","makeEmoteMessage","getTextForLocationEvent","uri","assetType","timestamp","description","date","concat","Date","toISOString","assetName","Self","undefined","quotedDescription","filter","Boolean","join","makeLocationContent","text","defaultedText","timestampEvent","name","_objectSpread","Location","geo_uri","type","parseLocationEvent","wireEventContent","_location$uri","_asset$type","location","findIn","asset","geoUri","fallbackText","makeTopicContent","topic","htmlTopic","renderings","push","mimetype","parseTopicContent","content","_ref","_mtopic$find$body","_mtopic$find","_mtopic$find2","mtopicParent","mtopic","Array","isArray","_content$topic","find","r","html","makeBeaconInfoContent","timeout","isLive","live","now","parseBeaconInfoContent","_M_TIMESTAMP$findIn","makeBeaconContent","beaconInfoEventId","rel_type","event_id","parseBeaconContent","_M_TIMESTAMP$findIn2"],"sources":["../src/content-helpers.ts"],"sourcesContent":["/*\r\nCopyright 2018 - 2022 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\nimport { type MBeaconEventContent, type MBeaconInfoContent, type MBeaconInfoEventContent } from \"./@types/beacon.ts\";\r\nimport { MsgType } from \"./@types/event.ts\";\r\nimport { type IMessageRendering, M_TEXT, REFERENCE_RELATION } from \"./@types/extensible_events.ts\";\r\nimport { isProvided } from \"./extensible_events_v1/utilities.ts\";\r\nimport {\r\n    M_ASSET,\r\n    LocationAssetType,\r\n    M_LOCATION,\r\n    M_TIMESTAMP,\r\n    type LocationEventWireContent,\r\n    type MLocationEventContent,\r\n    type MLocationContent,\r\n    type MAssetContent,\r\n    type LegacyLocationEventContent,\r\n} from \"./@types/location.ts\";\r\nimport { type MRoomTopicEventContent, type MTopicContent, M_TOPIC, type MTopicEvent } from \"./@types/topic.ts\";\r\nimport { type RoomMessageEventContent } from \"./@types/events.ts\";\r\n\r\n/**\r\n * Generates the content for a HTML Message event\r\n * @param body - the plaintext body of the message\r\n * @param htmlBody - the HTML representation of the message\r\n * @returns\r\n */\r\nexport function makeHtmlMessage(body: string, htmlBody: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Text,\r\n        format: \"org.matrix.custom.html\",\r\n        body: body,\r\n        formatted_body: htmlBody,\r\n    };\r\n}\r\n\r\n/**\r\n * Generates the content for a HTML Notice event\r\n * @param body - the plaintext body of the notice\r\n * @param htmlBody - the HTML representation of the notice\r\n * @returns\r\n */\r\nexport function makeHtmlNotice(body: string, htmlBody: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Notice,\r\n        format: \"org.matrix.custom.html\",\r\n        body: body,\r\n        formatted_body: htmlBody,\r\n    };\r\n}\r\n\r\n/**\r\n * Generates the content for a HTML Emote event\r\n * @param body - the plaintext body of the emote\r\n * @param htmlBody - the HTML representation of the emote\r\n * @returns\r\n */\r\nexport function makeHtmlEmote(body: string, htmlBody: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Emote,\r\n        format: \"org.matrix.custom.html\",\r\n        body: body,\r\n        formatted_body: htmlBody,\r\n    };\r\n}\r\n\r\n/**\r\n * Generates the content for a Plaintext Message event\r\n * @param body - the plaintext body of the emote\r\n * @returns\r\n */\r\nexport function makeTextMessage(body: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Text,\r\n        body: body,\r\n    };\r\n}\r\n\r\n/**\r\n * Generates the content for a Plaintext Notice event\r\n * @param body - the plaintext body of the notice\r\n * @returns\r\n */\r\nexport function makeNotice(body: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Notice,\r\n        body: body,\r\n    };\r\n}\r\n\r\n/**\r\n * Generates the content for a Plaintext Emote event\r\n * @param body - the plaintext body of the emote\r\n * @returns\r\n */\r\nexport function makeEmoteMessage(body: string): RoomMessageEventContent {\r\n    return {\r\n        msgtype: MsgType.Emote,\r\n        body: body,\r\n    };\r\n}\r\n\r\n/** Location content helpers */\r\n\r\nexport const getTextForLocationEvent = (\r\n    uri: string | undefined,\r\n    assetType: LocationAssetType,\r\n    timestamp?: number,\r\n    description?: string | null,\r\n): string => {\r\n    const date = `at ${new Date(timestamp!).toISOString()}`;\r\n    const assetName = assetType === LocationAssetType.Self ? \"User\" : undefined;\r\n    const quotedDescription = description ? `\"${description}\"` : undefined;\r\n\r\n    return [assetName, \"Location\", quotedDescription, uri, date].filter(Boolean).join(\" \");\r\n};\r\n\r\n/**\r\n * Generates the content for a Location event\r\n * @param uri - a geo:// uri for the location\r\n * @param timestamp - the timestamp when the location was correct (milliseconds since the UNIX epoch)\r\n * @param description - the (optional) label for this location on the map\r\n * @param assetType - the (optional) asset type of this location e.g. \"m.self\"\r\n * @param text - optional. A text for the location\r\n */\r\nexport const makeLocationContent = (\r\n    // this is first but optional\r\n    // to avoid a breaking change\r\n    text?: string,\r\n    uri?: string,\r\n    timestamp?: number,\r\n    description?: string | null,\r\n    assetType?: LocationAssetType,\r\n): LegacyLocationEventContent & MLocationEventContent => {\r\n    const defaultedText =\r\n        text ?? getTextForLocationEvent(uri, assetType || LocationAssetType.Self, timestamp, description);\r\n    const timestampEvent = timestamp ? { [M_TIMESTAMP.name]: timestamp } : {};\r\n    return {\r\n        msgtype: MsgType.Location,\r\n        body: defaultedText,\r\n        geo_uri: uri,\r\n        [M_LOCATION.name]: {\r\n            description,\r\n            uri,\r\n        },\r\n        [M_ASSET.name]: {\r\n            type: assetType || LocationAssetType.Self,\r\n        },\r\n        [M_TEXT.name]: defaultedText,\r\n        ...timestampEvent,\r\n    } as LegacyLocationEventContent & MLocationEventContent;\r\n};\r\n\r\n/**\r\n * Parse location event content and transform to\r\n * a backwards compatible modern m.location event format\r\n */\r\nexport const parseLocationEvent = (wireEventContent: LocationEventWireContent): MLocationEventContent => {\r\n    const location = M_LOCATION.findIn<MLocationContent>(wireEventContent);\r\n    const asset = M_ASSET.findIn<MAssetContent>(wireEventContent);\r\n    const timestamp = M_TIMESTAMP.findIn<number>(wireEventContent);\r\n    const text = M_TEXT.findIn<string>(wireEventContent);\r\n\r\n    const geoUri = location?.uri ?? wireEventContent?.geo_uri;\r\n    const description = location?.description;\r\n    const assetType = asset?.type ?? LocationAssetType.Self;\r\n    const fallbackText = text ?? wireEventContent.body;\r\n\r\n    return makeLocationContent(fallbackText, geoUri, timestamp ?? undefined, description, assetType);\r\n};\r\n\r\n/**\r\n * Topic event helpers\r\n */\r\nexport type MakeTopicContent = (topic: string | null | undefined, htmlTopic?: string) => MRoomTopicEventContent;\r\n\r\nexport const makeTopicContent: MakeTopicContent = (topic, htmlTopic) => {\r\n    const renderings = [];\r\n    // Put HTML first because clients will render the first type in\r\n    // the array that they understand\r\n    if (isProvided(htmlTopic)) {\r\n        renderings.push({ body: htmlTopic, mimetype: \"text/html\" });\r\n    }\r\n    if (isProvided(topic)) {\r\n        renderings.push({ body: topic, mimetype: \"text/plain\" });\r\n    }\r\n    return { topic, [M_TOPIC.name]: { \"m.text\": renderings } };\r\n};\r\n\r\nexport type TopicState = {\r\n    text?: string;\r\n    html?: string;\r\n};\r\n\r\nexport const parseTopicContent = (content: MRoomTopicEventContent): TopicState => {\r\n    const mtopicParent = M_TOPIC.findIn<MTopicContent | IMessageRendering[]>(content as MTopicEvent);\r\n    const mtopic = Array.isArray(mtopicParent) ? mtopicParent : mtopicParent?.[\"m.text\"];\r\n    // TODO remove support for the old malformed m.topic arrays after a few releases (only allow array in m.text)\r\n    //      https://github.com/matrix-org/matrix-js-sdk/pull/4984#pullrequestreview-3174251065\r\n    //const mtopic = M_TOPIC.findIn<MTopicContent>(content)?.[\"m.text\"];\r\n    if (!Array.isArray(mtopic)) {\r\n        return { text: content.topic ?? undefined };\r\n    }\r\n    const text =\r\n        mtopic?.find((r) => !isProvided(r.mimetype) || r.mimetype === \"text/plain\")?.body ?? content.topic ?? undefined;\r\n    const html = mtopic?.find((r) => r.mimetype === \"text/html\")?.body;\r\n    return { text, html };\r\n};\r\n\r\n/**\r\n * Beacon event helpers\r\n */\r\nexport type MakeBeaconInfoContent = (\r\n    timeout: number,\r\n    isLive?: boolean,\r\n    description?: string,\r\n    assetType?: LocationAssetType,\r\n    timestamp?: number,\r\n) => MBeaconInfoEventContent;\r\n\r\nexport const makeBeaconInfoContent: MakeBeaconInfoContent = (timeout, isLive, description, assetType, timestamp) => ({\r\n    description,\r\n    timeout,\r\n    live: isLive,\r\n    [M_TIMESTAMP.name]: timestamp || Date.now(),\r\n    [M_ASSET.name]: {\r\n        type: assetType ?? LocationAssetType.Self,\r\n    },\r\n});\r\n\r\nexport type BeaconInfoState = MBeaconInfoContent & {\r\n    assetType?: LocationAssetType;\r\n    timestamp?: number;\r\n};\r\n/**\r\n * Flatten beacon info event content\r\n */\r\nexport const parseBeaconInfoContent = (content: MBeaconInfoEventContent): BeaconInfoState => {\r\n    const { description, timeout, live } = content;\r\n    const timestamp = M_TIMESTAMP.findIn<number>(content) ?? undefined;\r\n    const asset = M_ASSET.findIn<MAssetContent>(content);\r\n\r\n    return {\r\n        description,\r\n        timeout,\r\n        live,\r\n        assetType: asset?.type,\r\n        timestamp,\r\n    };\r\n};\r\n\r\nexport type MakeBeaconContent = (\r\n    uri: string,\r\n    timestamp: number,\r\n    beaconInfoEventId: string,\r\n    description?: string,\r\n) => MBeaconEventContent;\r\n\r\nexport const makeBeaconContent: MakeBeaconContent = (uri, timestamp, beaconInfoEventId, description) => ({\r\n    [M_LOCATION.name]: {\r\n        description,\r\n        uri,\r\n    },\r\n    [M_TIMESTAMP.name]: timestamp,\r\n    \"m.relates_to\": {\r\n        rel_type: REFERENCE_RELATION.name,\r\n        event_id: beaconInfoEventId,\r\n    },\r\n});\r\n\r\nexport type BeaconLocationState = Omit<MLocationContent, \"uri\"> & {\r\n    uri?: string; // override from MLocationContent to allow optionals\r\n    timestamp?: number;\r\n};\r\n\r\nexport const parseBeaconContent = (content: MBeaconEventContent): BeaconLocationState => {\r\n    const location = M_LOCATION.findIn<MLocationContent>(content);\r\n    const timestamp = M_TIMESTAMP.findIn<number>(content) ?? undefined;\r\n\r\n    return {\r\n        description: location?.description,\r\n        uri: location?.uri,\r\n        timestamp,\r\n    };\r\n};\r\n"],"mappings":"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","ignoreList":[]}

package/lib/content-repo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Get the HTTP URL for an MXC URI.
+ * @param baseUrl - The base homeserver url which has a content repo.
+ * @param mxc - The mxc:// URI.
+ * @param width - The desired width of the thumbnail.
+ * @param height - The desired height of the thumbnail.
+ * @param resizeMethod - The thumbnail resize method to use, either
+ * "crop" or "scale".
+ * @param allowDirectLinks - If true, return any non-mxc URLs
+ * directly. Fetching such URLs will leak information about the user to
+ * anyone they share a room with. If false, will return the emptry string
+ * for such URLs.
+ * @param allowRedirects - If true, the caller supports the URL being 307 or
+ * 308 redirected to another resource upon request. If false, redirects
+ * are not expected. Implied `true` when `useAuthentication` is `true`.
+ * @param useAuthentication - If true, the caller supports authenticated
+ * media and wants an authentication-required URL. Note that server support
+ * for authenticated media will *not* be checked - it is the caller's responsibility
+ * to do so before calling this function. Note also that `useAuthentication`
+ * implies `allowRedirects`. Defaults to false (unauthenticated endpoints).
+ * @param animated - Whether the desired thumbnail should be animated.
+ * @returns The complete URL to the content, may be an empty string if the provided mxc is not valid.
+ */
+export declare function getHttpUriForMxc(baseUrl: string, mxc?: string, width?: number, height?: number, resizeMethod?: string, allowDirectLinks?: boolean, allowRedirects?: boolean, useAuthentication?: boolean, animated?: boolean): string;
+//# sourceMappingURL=content-repo.d.ts.map

package/lib/content-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-repo.d.ts","sourceRoot":"","sources":["../src/content-repo.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,UAAQ,EACxB,cAAc,CAAC,EAAE,OAAO,EACxB,iBAAiB,CAAC,EAAE,OAAO,EAC3B,QAAQ,CAAC,EAAE,OAAO,GACnB,MAAM,CAuDR"}

package/lib/content-repo.js

@@ -0,0 +1,109 @@
+/*
+Copyright 2015 - 2024 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.
+*/
+
+// Validation based on https://spec.matrix.org/v1.12/appendices/#server-name
+// We do not use the validation described in https://spec.matrix.org/v1.12/client-server-api/#security-considerations-5
+// as it'd wrongly make all MXCs invalid due to not allowing `[].:` in server names.
+var serverNameRegex = /^(?:(?:\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})|(?:\[[\dA-Fa-f:.]{2,45}])|(?:[A-Za-z\d\-.]{1,255}))(?::\d{1,5})?$/;
+function validateServerName(serverName) {
+  var matches = serverNameRegex.exec(serverName);
+  return (matches === null || matches === void 0 ? void 0 : matches[0]) === serverName;
+}
+
+// Validation based on https://spec.matrix.org/v1.12/client-server-api/#security-considerations-5
+var mediaIdRegex = /^[\w-]+$/;
+function validateMediaId(mediaId) {
+  var matches = mediaIdRegex.exec(mediaId);
+  return (matches === null || matches === void 0 ? void 0 : matches[0]) === mediaId;
+}
+
+/**
+ * Get the HTTP URL for an MXC URI.
+ * @param baseUrl - The base homeserver url which has a content repo.
+ * @param mxc - The mxc:// URI.
+ * @param width - The desired width of the thumbnail.
+ * @param height - The desired height of the thumbnail.
+ * @param resizeMethod - The thumbnail resize method to use, either
+ * "crop" or "scale".
+ * @param allowDirectLinks - If true, return any non-mxc URLs
+ * directly. Fetching such URLs will leak information about the user to
+ * anyone they share a room with. If false, will return the emptry string
+ * for such URLs.
+ * @param allowRedirects - If true, the caller supports the URL being 307 or
+ * 308 redirected to another resource upon request. If false, redirects
+ * are not expected. Implied `true` when `useAuthentication` is `true`.
+ * @param useAuthentication - If true, the caller supports authenticated
+ * media and wants an authentication-required URL. Note that server support
+ * for authenticated media will *not* be checked - it is the caller's responsibility
+ * to do so before calling this function. Note also that `useAuthentication`
+ * implies `allowRedirects`. Defaults to false (unauthenticated endpoints).
+ * @param animated - Whether the desired thumbnail should be animated.
+ * @returns The complete URL to the content, may be an empty string if the provided mxc is not valid.
+ */
+export function getHttpUriForMxc(baseUrl, mxc, width, height, resizeMethod) {
+  var allowDirectLinks = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : false;
+  var allowRedirects = arguments.length > 6 ? arguments[6] : undefined;
+  var useAuthentication = arguments.length > 7 ? arguments[7] : undefined;
+  var animated = arguments.length > 8 ? arguments[8] : undefined;
+  if (typeof mxc !== "string" || !mxc) {
+    return "";
+  }
+  if (!mxc.startsWith("mxc://")) {
+    if (allowDirectLinks) {
+      return mxc;
+    } else {
+      return "";
+    }
+  }
+  var [serverName, mediaId, ...rest] = mxc.slice(6).split("/");
+  if (rest.length > 0 || !validateServerName(serverName) || !validateMediaId(mediaId)) {
+    return "";
+  }
+  if (useAuthentication) {
+    allowRedirects = true; // per docs (MSC3916 always expects redirects)
+
+    // Dev note: MSC3916 removes `allow_redirect` entirely, but
+    // for explicitness we set it here. This makes it slightly more obvious to
+    // callers, hopefully.
+  }
+  var prefix;
+  var isThumbnailRequest = !!width || !!height || !!resizeMethod;
+  var verb = isThumbnailRequest ? "thumbnail" : "download";
+  if (useAuthentication) {
+    prefix = "/_matrix/client/v1/media/".concat(verb);
+  } else {
+    prefix = "/_matrix/media/v3/".concat(verb);
+  }
+  var url = new URL("".concat(prefix, "/").concat(serverName, "/").concat(mediaId), baseUrl);
+  if (width) {
+    url.searchParams.set("width", Math.round(width).toString());
+  }
+  if (height) {
+    url.searchParams.set("height", Math.round(height).toString());
+  }
+  if (resizeMethod) {
+    url.searchParams.set("method", resizeMethod);
+  }
+  if (animated !== undefined) {
+    url.searchParams.set("animated", String(animated));
+  }
+  if (typeof allowRedirects === "boolean") {
+    // We add this after, so we don't convert everything to a thumbnail request.
+    url.searchParams.set("allow_redirect", JSON.stringify(allowRedirects));
+  }
+  return url.href;
+}
+//# sourceMappingURL=content-repo.js.map

package/lib/content-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-repo.js","names":["serverNameRegex","validateServerName","serverName","matches","exec","mediaIdRegex","validateMediaId","mediaId","getHttpUriForMxc","baseUrl","mxc","width","height","resizeMethod","allowDirectLinks","arguments","length","undefined","allowRedirects","useAuthentication","animated","startsWith","rest","slice","split","prefix","isThumbnailRequest","verb","concat","url","URL","searchParams","set","Math","round","toString","String","JSON","stringify","href"],"sources":["../src/content-repo.ts"],"sourcesContent":["/*\r\nCopyright 2015 - 2024 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\n// Validation based on https://spec.matrix.org/v1.12/appendices/#server-name\r\n// We do not use the validation described in https://spec.matrix.org/v1.12/client-server-api/#security-considerations-5\r\n// as it'd wrongly make all MXCs invalid due to not allowing `[].:` in server names.\r\nconst serverNameRegex =\r\n    /^(?:(?:\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})|(?:\\[[\\dA-Fa-f:.]{2,45}])|(?:[A-Za-z\\d\\-.]{1,255}))(?::\\d{1,5})?$/;\r\nfunction validateServerName(serverName: string): boolean {\r\n    const matches = serverNameRegex.exec(serverName);\r\n    return matches?.[0] === serverName;\r\n}\r\n\r\n// Validation based on https://spec.matrix.org/v1.12/client-server-api/#security-considerations-5\r\nconst mediaIdRegex = /^[\\w-]+$/;\r\nfunction validateMediaId(mediaId: string): boolean {\r\n    const matches = mediaIdRegex.exec(mediaId);\r\n    return matches?.[0] === mediaId;\r\n}\r\n\r\n/**\r\n * Get the HTTP URL for an MXC URI.\r\n * @param baseUrl - The base homeserver url which has a content repo.\r\n * @param mxc - The mxc:// URI.\r\n * @param width - The desired width of the thumbnail.\r\n * @param height - The desired height of the thumbnail.\r\n * @param resizeMethod - The thumbnail resize method to use, either\r\n * \"crop\" or \"scale\".\r\n * @param allowDirectLinks - If true, return any non-mxc URLs\r\n * directly. Fetching such URLs will leak information about the user to\r\n * anyone they share a room with. If false, will return the emptry string\r\n * for such URLs.\r\n * @param allowRedirects - If true, the caller supports the URL being 307 or\r\n * 308 redirected to another resource upon request. If false, redirects\r\n * are not expected. Implied `true` when `useAuthentication` is `true`.\r\n * @param useAuthentication - If true, the caller supports authenticated\r\n * media and wants an authentication-required URL. Note that server support\r\n * for authenticated media will *not* be checked - it is the caller's responsibility\r\n * to do so before calling this function. Note also that `useAuthentication`\r\n * implies `allowRedirects`. Defaults to false (unauthenticated endpoints).\r\n * @param animated - Whether the desired thumbnail should be animated.\r\n * @returns The complete URL to the content, may be an empty string if the provided mxc is not valid.\r\n */\r\nexport function getHttpUriForMxc(\r\n    baseUrl: string,\r\n    mxc?: string,\r\n    width?: number,\r\n    height?: number,\r\n    resizeMethod?: string,\r\n    allowDirectLinks = false,\r\n    allowRedirects?: boolean,\r\n    useAuthentication?: boolean,\r\n    animated?: boolean,\r\n): string {\r\n    if (typeof mxc !== \"string\" || !mxc) {\r\n        return \"\";\r\n    }\r\n    if (!mxc.startsWith(\"mxc://\")) {\r\n        if (allowDirectLinks) {\r\n            return mxc;\r\n        } else {\r\n            return \"\";\r\n        }\r\n    }\r\n\r\n    const [serverName, mediaId, ...rest] = mxc.slice(6).split(\"/\");\r\n    if (rest.length > 0 || !validateServerName(serverName) || !validateMediaId(mediaId)) {\r\n        return \"\";\r\n    }\r\n\r\n    if (useAuthentication) {\r\n        allowRedirects = true; // per docs (MSC3916 always expects redirects)\r\n\r\n        // Dev note: MSC3916 removes `allow_redirect` entirely, but\r\n        // for explicitness we set it here. This makes it slightly more obvious to\r\n        // callers, hopefully.\r\n    }\r\n\r\n    let prefix: string;\r\n    const isThumbnailRequest = !!width || !!height || !!resizeMethod;\r\n    const verb = isThumbnailRequest ? \"thumbnail\" : \"download\";\r\n    if (useAuthentication) {\r\n        prefix = `/_matrix/client/v1/media/${verb}`;\r\n    } else {\r\n        prefix = `/_matrix/media/v3/${verb}`;\r\n    }\r\n\r\n    const url = new URL(`${prefix}/${serverName}/${mediaId}`, baseUrl);\r\n\r\n    if (width) {\r\n        url.searchParams.set(\"width\", Math.round(width).toString());\r\n    }\r\n    if (height) {\r\n        url.searchParams.set(\"height\", Math.round(height).toString());\r\n    }\r\n    if (resizeMethod) {\r\n        url.searchParams.set(\"method\", resizeMethod);\r\n    }\r\n    if (animated !== undefined) {\r\n        url.searchParams.set(\"animated\", String(animated));\r\n    }\r\n\r\n    if (typeof allowRedirects === \"boolean\") {\r\n        // We add this after, so we don't convert everything to a thumbnail request.\r\n        url.searchParams.set(\"allow_redirect\", JSON.stringify(allowRedirects));\r\n    }\r\n\r\n    return url.href;\r\n}\r\n"],"mappings":"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","ignoreList":[]}