matrix-public-archive/shared/lib/url-creator.js

102 lines
2.7 KiB
JavaScript

'use strict';
const urlJoin = require('url-join');
const assert = require('matrix-public-archive-shared/lib/assert');
function qsToUrlPiece(qs) {
if (qs.toString()) {
return `?${qs.toString()}`;
} else {
return '';
}
}
class URLCreator {
constructor(basePath) {
this._basePath = basePath;
}
permalinkForRoom(roomIdOrAlias) {
// We don't `encodeURIComponent(...)` because the URL looks nicer without encoded things
return `https://matrix.to/#/${roomIdOrAlias}`;
}
roomDirectoryUrl({ searchTerm, homeserver, paginationToken } = {}) {
let qs = new URLSearchParams();
if (searchTerm) {
qs.append('search', searchTerm);
}
if (homeserver) {
qs.append('homeserver', homeserver);
}
if (paginationToken) {
qs.append('page', paginationToken);
}
return `${this._basePath}${qsToUrlPiece(qs)}`;
}
_getArchiveUrlPathForRoomIdOrAlias(roomIdOrAlias) {
let urlPath;
// We don't `encodeURIComponent(...)` because the URL looks nicer without encoded things
if (roomIdOrAlias.startsWith('#')) {
urlPath = `/r/${roomIdOrAlias.replace(/^#/, '')}`;
} else if (roomIdOrAlias.startsWith('!')) {
urlPath = `/roomid/${roomIdOrAlias.replace(/^!/, '')}`;
} else {
throw new Error(
'URLCreator._getArchiveUrlPathForRoomIdOrAlias(...): roomIdOrAlias should start with # (alias) or ! (room ID)'
);
}
return urlPath;
}
archiveUrlForRoom(roomIdOrAlias, { viaServers = [] } = {}) {
assert(roomIdOrAlias);
let qs = new URLSearchParams();
[].concat(viaServers).forEach((viaServer) => {
qs.append('via', viaServer);
});
const urlPath = this._getArchiveUrlPathForRoomIdOrAlias(roomIdOrAlias);
return `${urlJoin(this._basePath, `${urlPath}`)}${qsToUrlPiece(qs)}`;
}
archiveUrlForDate(roomIdOrAlias, date, { viaServers = [] } = {}) {
assert(roomIdOrAlias);
assert(date);
let qs = new URLSearchParams();
[].concat(viaServers).forEach((viaServer) => {
qs.append('via', viaServer);
});
const urlPath = this._getArchiveUrlPathForRoomIdOrAlias(roomIdOrAlias);
// Gives the date in YYYY/mm/dd format.
// date.toISOString() -> 2022-02-16T23:20:04.709Z
const urlDate = date.toISOString().split('T')[0].replaceAll('-', '/');
return `${urlJoin(this._basePath, `${urlPath}/date/${urlDate}`)}${qsToUrlPiece(qs)}`;
}
archiveJumpUrlForRoom(roomIdOrAlias, { ts, dir }) {
assert(roomIdOrAlias);
assert(ts);
assert(dir);
let qs = new URLSearchParams();
qs.append('ts', ts);
qs.append('dir', dir);
const urlPath = this._getArchiveUrlPathForRoomIdOrAlias(roomIdOrAlias);
return `${urlJoin(this._basePath, `${urlPath}/jump`)}${qsToUrlPiece(qs)}`;
}
}
module.exports = URLCreator;