38 lines
1.2 KiB
TypeScript
38 lines
1.2 KiB
TypeScript
/**
|
|
* Says where an image pasted into a text lives, and how to find it again in
|
|
* the text. The editor uploads the image and writes a link to it into the
|
|
* Markdown; the server binds the attachments a saved text links to that text,
|
|
* and `Markdown` gives a private one the viewer's media token.
|
|
*
|
|
* @module
|
|
*/
|
|
|
|
import { UUID_RE } from "./validation.ts";
|
|
|
|
/**
|
|
* Returned by `POST /api/attachments` to the text editor, which inserts the
|
|
* image into the body as a link to {@link attachmentPath}.
|
|
*/
|
|
export interface AttachmentResponse {
|
|
id: string;
|
|
}
|
|
|
|
/** Returns the API path of attachment `id`, to which the API's base is added. */
|
|
export function attachmentPath(id: string): string {
|
|
return `/api/attachments/${id}`;
|
|
}
|
|
|
|
const ID = UUID_RE.source.slice(1, -1);
|
|
const ATTACHMENT_LINK_RE = new RegExp(`/api/attachments/(${ID})`, "g");
|
|
const ATTACHMENT_URL_RE = new RegExp(`/api/attachments/${ID}$`);
|
|
|
|
/** Returns the ids of the attachments `text` links to, in order. */
|
|
export function attachmentIdsIn(text: string): string[] {
|
|
return [...text.matchAll(ATTACHMENT_LINK_RE)].map((m) => m[1]);
|
|
}
|
|
|
|
/** Checks whether `url` is an attachment's, with no query yet. */
|
|
export function isAttachmentUrl(url: string): boolean {
|
|
return ATTACHMENT_URL_RE.test(url);
|
|
}
|