pi-roundtable-web 0.25.0 → 0.26.0

package/src/host/rooms-service.ts

@@ -0,0 +1,414 @@
+import type { ChannelKey, Logger } from "pi-roundtable";
+import { PluginError } from "pi-roundtable";
+import type { ServerFrame } from "../api-types.ts";
+import { MAX_MESSAGE_CHARS } from "../api-types.ts";
+import { type FileDir, isFileId, safeName } from "../app/files.ts";
+import type { RoomLog } from "../app/room-log.ts";
+import { viewerOfSocket } from "../app/socket.ts";
+import type { AppSocket, Sockets } from "../app/sockets.ts";
+import { imageTypeOf } from "../app/uploads.ts";
+import type {
+	HostCard,
+	HostRoomKind,
+	HostRooms,
+	WebAppRegistry,
+} from "../web-app.ts";
+import type { HostAccess } from "./access.ts";
+import type { HostCardLog } from "./cards.ts";
+import { checkCard } from "./forms.ts";
+import { cardView, checkPicture, type FoundRoom } from "./room-views.ts";
+
+/** The most files one post carries. */
+const MAX_POST_FILES = 20;
+const AUTHOR_KINDS = new Set(["external", "member", "assistant", "notice"]);
+const DAY_MS = 86_400_000;
+
+export interface HostRoomsOptions {
+	registry: Pick<WebAppRegistry, "hostKindOf" | "kinds">;
+	sockets: Pick<Sockets, "each" | "deliver" | "reaches">;
+	log: Pick<RoomLog, "appendOnce" | "edit" | "remove" | "byReference" | "get">;
+	cards: Pick<HostCardLog, "create" | "update" | "get">;
+	/** The stored files, where `saveFile` keeps what a host saves. */
+	files: FileDir;
+	access: Pick<HostAccess, "forget" | "of">;
+	/** The most bytes of one saved file. */
+	maxFileBytes: number;
+	/** The same-origin URL of a room, and of one of its messages. */
+	roomUrl(room: ChannelKey, message?: number): string;
+	/** Which kinds a person's last list showed, so the list's changes reach only them. */
+	listed: ListedKinds;
+	now?: () => number;
+	logger: Logger;
+}
+
+/** What each person's latest `list` of each kind answered: whether it was defined for them. */
+export class ListedKinds {
+	readonly #by = new Map<string, Set<string>>();
+
+	set(principalId: string, kind: string, defined: boolean): void {
+		const kinds = this.#by.get(principalId) ?? new Set<string>();
+		if (defined) kinds.add(kind);
+		else kinds.delete(kind);
+		this.#by.set(principalId, kinds);
+	}
+
+	has(principalId: string, kind: string): boolean {
+		return this.#by.get(principalId)?.has(kind) ?? false;
+	}
+}
+
+/** Collects a file's bytes, refusing more than `max`. */
+async function bytesOf(
+	source: Uint8Array | ReadableStream,
+	max: number,
+): Promise<Uint8Array> {
+	if (source instanceof Uint8Array) {
+		if (source.byteLength > max)
+			throw new PluginError(`web app: a saved file is at most ${max} bytes`);
+		return source;
+	}
+	const chunks: Uint8Array[] = [];
+	let size = 0;
+	const reader = source.getReader();
+	for (;;) {
+		const { done, value } = await reader.read();
+		if (done) break;
+		const chunk = value as Uint8Array;
+		size += chunk.byteLength;
+		if (size > max) {
+			await reader.cancel();
+			throw new PluginError(`web app: a saved file is at most ${max} bytes`);
+		}
+		chunks.push(chunk);
+	}
+	const whole = new Uint8Array(size);
+	let at = 0;
+	for (const chunk of chunks) {
+		whole.set(chunk, at);
+		at += chunk.byteLength;
+	}
+	return whole;
+}
+
+/**
+ * What the app's stored file keeps as the type of a host's file: an image type only when the bytes
+ * are that image (the page shows those inline), anything else the host declared as given.
+ */
+export function keptType(declared: string, bytes: Uint8Array): string {
+	const image = imageTypeOf(bytes.subarray(0, 16));
+	if (image) return image;
+	return declared.startsWith("image/") ? "application/octet-stream" : declared;
+}
+
+/** The PNG, JPEG or WebP the bytes are, if they are one: the images host Markdown may show. */
+export function markdownImageType(bytes: Uint8Array): string | undefined {
+	const type = imageTypeOf(bytes.subarray(0, 16));
+	return type === "image/gif" ? undefined : type;
+}
+
+/**
+ * What a host writes into its rooms (`WebApp.rooms`): messages, their edits and removals, cards,
+ * and the files they carry. Everything the host passes is checked here, because it comes from
+ * a plugin, not from a person; what is stored is then shown, at once, to the sockets that follow
+ * the room and may read it now.
+ */
+export class HostRoomsService implements HostRooms {
+	readonly #options: HostRoomsOptions;
+	/** One delivery at a time per room, so frames of quick changes arrive in the order they were made. */
+	readonly #chains = new Map<string, Promise<void>>();
+
+	constructor(options: HostRoomsOptions) {
+		this.#options = options;
+	}
+
+	#now(): number {
+		return (this.#options.now ?? Date.now)();
+	}
+
+	#found(room: string): FoundRoom {
+		const found = this.#options.registry.hostKindOf(room);
+		if (!found)
+			throw new PluginError(
+				`web app: ${JSON.stringify(room)} is not a room of a registered kind`,
+			);
+		return found;
+	}
+
+	/** When a file saved in a room of this kind goes, counted from `from`; undefined when the kind keeps files. */
+	expiryOf(kind: HostRoomKind, from: number): number | undefined {
+		return kind.retention ? from + kind.retention.fileDays * DAY_MS : undefined;
+	}
+
+	// ── Messages ──
+
+	async post(
+		room: ChannelKey,
+		m: Parameters<HostRooms["post"]>[1],
+	): Promise<{ id: number }> {
+		const { kind } = this.#found(room);
+		const { author } = m;
+		if (!AUTHOR_KINDS.has(author.kind))
+			throw new PluginError(
+				"web app: a message's author is external, member, assistant or notice",
+			);
+		if (
+			typeof author.name !== "string" ||
+			author.name.trim() === "" ||
+			author.name.length > 120
+		)
+			throw new PluginError(
+				"web app: an author needs a name of at most 120 characters",
+			);
+		if (
+			author.label !== undefined &&
+			(typeof author.label !== "string" || author.label.length > 40)
+		)
+			throw new PluginError(
+				"web app: an author's label is at most 40 characters",
+			);
+		const picture = author.picture ? checkPicture(author.picture) : undefined;
+		const text = m.text ?? "";
+		if (typeof text !== "string" || text.length > MAX_MESSAGE_CHARS)
+			throw new PluginError(
+				`web app: a message's text is at most ${MAX_MESSAGE_CHARS} characters`,
+			);
+		const ids = m.files ?? [];
+		if (ids.length > MAX_POST_FILES || new Set(ids).size !== ids.length)
+			throw new PluginError(
+				`web app: a message carries at most ${MAX_POST_FILES} different files`,
+			);
+		if (text === "" && ids.length === 0)
+			throw new PluginError("web app: a message needs text or a file");
+		if (
+			m.reference !== undefined &&
+			(typeof m.reference !== "string" ||
+				m.reference === "" ||
+				m.reference.length > 300)
+		)
+			throw new PluginError("web app: a reference is 1 to 300 characters");
+		const files = ids.map((id) => {
+			const meta = this.#options.files.meta(id);
+			if (
+				!isFileId(id) ||
+				!meta ||
+				this.#options.files.binding(id)?.room !== room
+			)
+				throw new PluginError(
+					`web app: file ${id} was not saved in ${room}; save it with rooms.saveFile for this room`,
+				);
+			return meta;
+		});
+		const now = this.#now();
+		const at =
+			m.at && !Number.isNaN(m.at.getTime())
+				? new Date(Math.min(m.at.getTime(), now))
+				: undefined;
+		const stored = await this.#options.log.appendOnce({
+			room,
+			// A person's words are `owner` lines, the assistant's an `agent`'s, a notice a `system` line.
+			kind:
+				author.kind === "assistant"
+					? "agent"
+					: author.kind === "notice"
+						? "system"
+						: "owner",
+			...(author.principalId ? { principalId: author.principalId } : {}),
+			author: author.name.trim(),
+			text,
+			files,
+			authorKind: author.kind,
+			...(author.label ? { authorLabel: author.label } : {}),
+			...(picture ? { picture } : {}),
+			...(m.reference ? { reference: m.reference } : {}),
+			...(at ? { at } : {}),
+		});
+		if (!stored.created) return { id: stored.message.id };
+		// A file lives as long as the kind keeps files, counted from when the message was written.
+		if (at)
+			for (const file of files)
+				this.#options.files.bind(file.id, {
+					room,
+					...(this.expiryOf(kind, at.getTime()) === undefined
+						? {}
+						: { expiresAt: this.expiryOf(kind, at.getTime()) as number }),
+				});
+		this.#deliver(room, {
+			type: "host_message",
+			room,
+			message: stored.message,
+		});
+		this.#listChanged(kind.kind);
+		return { id: stored.message.id };
+	}
+
+	async edit(room: ChannelKey, id: number, text: string): Promise<void> {
+		this.#found(room);
+		if (typeof text !== "string" || text.length > MAX_MESSAGE_CHARS)
+			throw new PluginError(
+				`web app: a message's text is at most ${MAX_MESSAGE_CHARS} characters`,
+			);
+		const message = await this.#options.log.edit(room, id, text, true);
+		if (!message)
+			throw new PluginError(`web app: ${room} has no message ${id}`);
+		this.#deliver(room, { type: "host_edited", room, message });
+	}
+
+	async remove(room: ChannelKey, id: number): Promise<void> {
+		const { kind } = this.#found(room);
+		const row = await this.#options.log.remove(room, id);
+		if (!row) return;
+		for (const file of row.files)
+			if (this.#options.files.binding(file.id)?.room === room)
+				this.#options.files.remove(file.id);
+		this.#deliver(room, { type: "host_removed", room, id });
+		this.#listChanged(kind.kind);
+	}
+
+	byReference(
+		room: ChannelKey,
+		reference: string,
+	): Promise<number | undefined> {
+		this.#found(room);
+		return this.#options.log.byReference(room, reference);
+	}
+
+	// ── Cards ──
+
+	async card(room: ChannelKey, card: HostCard): Promise<{ id: string }> {
+		this.#found(room);
+		checkCard(card);
+		const stored = await this.#options.cards.create(room, card);
+		this.#showCard(room, stored.id);
+		return { id: stored.id };
+	}
+
+	async updateCard(
+		room: ChannelKey,
+		id: string,
+		card: HostCard,
+	): Promise<void> {
+		this.#found(room);
+		checkCard(card);
+		const stored = await this.#options.cards.update(room, id, card);
+		if (!stored) throw new PluginError(`web app: ${room} has no card ${id}`);
+		this.#showCard(room, id);
+	}
+
+	/** Shows a card to the room's readers, each its own buttons. */
+	#showCard(room: ChannelKey, id: string): void {
+		const found = this.#found(room);
+		this.#chain(room, async () => {
+			const stored = await this.#options.cards.get(room, id);
+			if (!stored) return;
+			const targets: AppSocket[] = [];
+			this.#options.sockets.each(
+				(connection) => this.#options.sockets.reaches(connection, { room }),
+				(connection) => targets.push(connection),
+			);
+			for (const connection of targets) {
+				const viewer = viewerOfSocket(connection);
+				const access = await this.#options.access.of(viewer, room);
+				if (!access) continue;
+				this.#options.sockets.deliver(
+					{
+						type: "host_card",
+						room,
+						card: cardView(viewer, found, access, stored),
+					},
+					{ connection, audience: { room } },
+				);
+			}
+		});
+	}
+
+	// ── Files ──
+
+	async saveFile(
+		room: ChannelKey,
+		file: { name: string; type: string; bytes: Uint8Array | ReadableStream },
+	): Promise<string> {
+		const { kind } = this.#found(room);
+		if (typeof file.type !== "string" || file.type === "")
+			throw new PluginError("web app: a saved file needs a type");
+		const bytes = await bytesOf(file.bytes, this.#options.maxFileBytes);
+		if (bytes.byteLength === 0)
+			throw new PluginError("web app: a saved file is not empty");
+		const expiresAt = this.expiryOf(kind, this.#now());
+		return this.#options.files.put(
+			safeName(file.name),
+			keptType(file.type, bytes),
+			bytes,
+			undefined,
+			{ room, ...(expiresAt === undefined ? {} : { expiresAt }) },
+		).id;
+	}
+
+	// ── What changed ──
+
+	link(room: ChannelKey, message?: number): string {
+		this.#found(room);
+		if (message !== undefined && !Number.isSafeInteger(message))
+			throw new PluginError("web app: a message number is a whole number");
+		return this.#options.roomUrl(room, message);
+	}
+
+	changed(room?: ChannelKey): void {
+		if (room === undefined) {
+			for (const kind of this.#options.registry.kinds())
+				this.#listChanged(kind.kind);
+			this.#options.access.forget({}).catch(() => undefined);
+			return;
+		}
+		const { kind } = this.#found(room);
+		// The followers are asked again first, so only those who still read the room are told to look again.
+		this.#chain(room, async () => {
+			await this.#options.access.forget({ room });
+			this.#deliver(room, { type: "room_changed", room }, false);
+		});
+		this.#listChanged(kind.kind);
+	}
+
+	accessChanged(principalId?: string): void {
+		this.#options.access
+			.forget(principalId === undefined ? {} : { principalId })
+			.catch(() => undefined);
+		// Their lists may differ now.
+		for (const kind of this.#options.registry.kinds())
+			this.#listChanged(kind.kind);
+	}
+
+	/** Tells those whose list of a kind was defined that it may differ; the frame holds nothing. */
+	#listChanged(kind: string): void {
+		const { sockets, listed } = this.#options;
+		sockets.each(
+			(connection) => listed.has(connection.principal.id, kind),
+			(connection) =>
+				sockets.deliver({ type: "list_changed", kind }, { connection }),
+		);
+	}
+
+	/** Puts a frame of a room on the sockets that follow it and may read it now, in order after earlier ones. */
+	#deliver(room: string, frame: ServerFrame, queued = true): void {
+		const send = async () => {
+			this.#options.sockets.deliver(frame, { room });
+		};
+		if (queued) this.#chain(room, send);
+		else send().catch(() => undefined);
+	}
+
+	#chain(room: string, step: () => Promise<void>): void {
+		const previous = this.#chains.get(room) ?? Promise.resolve();
+		const next = previous
+			.then(step)
+			.catch((error: unknown) =>
+				this.#options.logger.warn(
+					{ room, err: error },
+					"a host room frame was not delivered",
+				),
+			);
+		this.#chains.set(room, next);
+		void next.then(() => {
+			if (this.#chains.get(room) === next) this.#chains.delete(room);
+		});
+	}
+}

package/src/host/stored-json.ts

@@ -0,0 +1,13 @@
+/**
+ * A jsonb value as the driver returned it: already an object, or the text of one when the
+ * driver left it as text. Anything else the database holds here is a stored value gone wrong,
+ * which is named instead of surfacing as a bare parse error.
+ */
+export function storedJson<T>(value: T | string, what: string): T {
+	if (typeof value !== "string") return value;
+	try {
+		return JSON.parse(value) as T;
+	} catch {
+		throw new Error(`the stored ${what} is not valid JSON`);
+	}
+}

package/src/host/views.ts

@@ -0,0 +1,103 @@
+// What the host-room and page API answers, shared by the server (`src/host/`) and the page (`web/`).
+// Times are ISO strings. A key is `<surface>:<kind>.<id>`.
+
+import type {
+	FormSpecView,
+	HostActionView,
+	HostCardView,
+	PictureRef,
+	ReadMarkView,
+	RoomMessage,
+} from "../api-types.ts";
+
+/** One room of a kind, as the list shows it. */
+export interface HostRoomSummaryView {
+	id: string;
+	key: string;
+	title: string;
+	subtitle?: string;
+	picture?: PictureRef;
+	/** ISO time of the newest message. */
+	lastAt?: string;
+	attention?: boolean;
+	/** Messages past the viewer's read cursor; absent when none. */
+	unread?: number;
+}
+
+/** `GET api/host/<kind>`: the rooms of one kind this viewer may open. */
+export interface HostListView {
+	kind: string;
+	label: string;
+	rooms: HostRoomSummaryView[];
+	cursor?: string;
+}
+
+/** The header of one room: facts about it, what the viewer may do, and a banner. */
+export interface HostHeaderView {
+	title: string;
+	fields: { label: string; value: string; link?: string }[];
+	actions: HostActionView[];
+	banner?: { tone: "warn" | "risk"; text: string };
+}
+
+/** `GET api/host/<kind>/<id>`: a room as it opens. */
+export interface HostRoomView {
+	room: string;
+	kind: string;
+	id: string;
+	/** What this viewer may do in the room. */
+	access: { send: ("note" | "turn")[]; act: boolean };
+	header: HostHeaderView;
+	/** The newest messages, oldest first. */
+	messages: RoomMessage[];
+	more: boolean;
+	cards: HostCardView[];
+	/** The other readers' cursors; the viewer's own is `cursor`. */
+	reads: ReadMarkView[];
+	/** The viewer's own read cursor before they opened the room; absent when they never read it. */
+	cursor?: number;
+}
+
+/** `GET api/host/<kind>/<id>/messages`: a page of older messages. */
+export interface HostMessagesView {
+	messages: RoomMessage[];
+	more: boolean;
+	reads: ReadMarkView[];
+}
+
+/** What the page shows of a section of a host page. */
+export type PageSectionView =
+	| { kind: "markdown"; text: string }
+	| {
+			kind: "list";
+			title?: string;
+			rows: {
+				title: string;
+				subtitle?: string;
+				open?: string;
+				attention?: boolean;
+				actions?: HostActionView[];
+			}[];
+	  }
+	| { kind: "form"; form: FormSpecView; action: string }
+	| {
+			kind: "card";
+			card: Omit<HostCardView, "id" | "room" | "at" | "updatedAt">;
+	  };
+
+/** `GET api/pages/<id>`. */
+export interface HostPageView {
+	id: string;
+	title: string;
+	sections: PageSectionView[];
+}
+
+/** Where the page takes a person after an action: a room (and a message in it), or a page with a query. */
+export type OpenView =
+	| { room: string; message?: number }
+	| { page: string; query?: Record<string, string> };
+
+/** What an action answers, for a button, a form or a page's action. */
+export type HostActionResult =
+	| { ok: true; notice?: string; open?: OpenView; url?: string }
+	| { ok: false; error: string; field?: string };

package/src/i18n/zh-tw.ts

@@ -266,6 +266,9 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 	// 進度
 	"{name} is working…": "{name}正在處理…",
 	"Show the whole stream": "顯示完整串流",
+	"{count} earlier tool": "前面還有 {count} 個工具",
+	"{count} earlier tools": "前面還有 {count} 個工具",
+	"Show fewer tools": "收合工具",
 
 	// 聊天室選單
 	"A thread has no settings.": "討論串沒有設定。",
@@ -1021,4 +1024,133 @@ export const ZH_TW: Readonly<Record<string, string>> = {
 		"baseHash 必須是讀取技能時的雜湊值。",
 	"This skill changed while you were editing it.":
 		"這個技能在你編輯時被更動了。",
+	// 成員、登入與設定關卡
+	Profile: "個人資料",
+	Owner: "擁有者",
+	Admin: "管理員",
+	Member: "成員",
+	"Finish setting up": "完成設定",
+	"Finish setting up first.": "請先完成設定。",
+	"These steps come first. The rest of the app opens when they are done.":
+		"請先完成這些步驟，完成後才能使用其餘功能。",
+	"Push is not available to you.": "你不能使用推播通知。",
+	"You are signed out.": "你已登出。",
+	"This account is not allowed to use this app.":
+		"這個帳號不能使用此應用程式。",
+	"Sign-in did not complete.": "登入沒有完成。",
+	// 主機的聊天室、頁面、卡片與已讀
+	"Host room": "主機聊天室",
+	"No rooms yet.": "還沒有聊天室。",
+	"No messages yet.": "還沒有訊息。",
+	"Nothing here.": "這裡沒有內容。",
+	"Show more": "顯示更多",
+	"Search {name}": "搜尋{name}",
+	"Search…": "搜尋…",
+	"Needs attention": "需要處理",
+	"This page is not available.": "這個頁面無法使用。",
+	"You can read this room but not write in it.":
+		"你可以閱讀這個聊天室，但不能在其中發言。",
+	"Send as": "傳送方式",
+	"Ask the agent": "請夥伴處理",
+	"Earlier cards ({count})": "先前的卡片（{count}）",
+	Replaced: "已被取代",
+	Image: "圖片",
+	edited: "已編輯",
+	"{count} file was removed": "已移除 {count} 個檔案",
+	"{count} files were removed": "已移除 {count} 個檔案",
+	"{count} unread message": "{count} 則未讀訊息",
+	"{count} unread messages": "{count} 則未讀訊息",
+	"New messages": "新訊息",
+	"Seen by {count}": "已讀 {count}",
+	"More settings": "更多設定",
+	// 主機聊天室與頁面：伺服器的拒絕訊息
+	"There is no such room.": "沒有這個聊天室。",
+	"There is no such page.": "沒有這個頁面。",
+	"input must be an object.": "input 必須是物件。",
+	"input holds text or lists of text.": "input 只能放文字或文字清單。",
+	"action must be text.": "action 必須是文字。",
+	"card must be text.": "card 必須是文字。",
+	"This is not yours to do.": "這個操作不是你可以做的。",
+	"The page's query is too long.": "頁面的查詢參數太長。",
+	"This action takes no form.": "這個操作沒有表單。",
+	"The form has no such field.": "表單沒有這個欄位。",
+	"This field is required.": "這個欄位必填。",
+	"Choose from the list.": "請從清單中選擇。",
+	"This field takes one value.": "這個欄位只能填一個值。",
+	"This field is too long.": "這個欄位的內容太長。",
+	"Give a web address.": "請填入網址。",
+	"The action could not be done.": "無法執行這個操作。",
+	// 通知、設定步驟與帳號連結
+	Notices: "通知",
+	"Notices, {count} waiting": "通知，{count} 則待處理",
+	"Turn on notifications": "開啟通知",
+	"Link your {name} account": "連結你的 {name} 帳號",
+	"Prove which account is yours, so the app knows who you are there.":
+		"證明哪個帳號是你的，讓應用程式知道你在那裡是誰。",
+	"So that you hear when something needs you, even when the app is closed.":
+		"這樣即使應用程式關著，有事找你時你也聽得到。",
+	Urgent: "緊急",
+	Handled: "已處理",
+	"Nothing needs you.": "目前沒有需要你處理的事。",
+	Linked: "已連結",
+	Required: "必填",
+	Recommended: "建議",
+	"The server's configuration links this account.":
+		"這個帳號由伺服器設定連結，無法在這裡移除。",
+	Unlink: "解除連結",
+	"Unlink {name}?": "要解除連結 {name} 嗎？",
+	"The app will no longer know this account is yours. You can link it again later.":
+		"應用程式將不再知道這個帳號是你的。之後可以再連結。",
+	"Your code": "你的驗證碼",
+	"The code works until {time}.": "驗證碼的有效時間到 {time}。",
+	"A code is waiting to be used.": "有一組驗證碼等著被使用。",
+	"{name} used the code. Confirm that this is you.":
+		"{name} 使用了驗證碼。請確認那是你。",
+	"I did it": "我完成了",
+	"Link {name} first.": "請先連結 {name}。",
+	Link: "連結",
+	"In your quiet hours a normal notice waits in the bell instead of ringing your phone. An urgent one still rings.":
+		"勿擾時段內，一般通知只會留在通知鈴裡，不會響手機；緊急通知照常響。",
+	From: "從",
+	To: "到",
+	"Turn off quiet hours": "關閉勿擾時段",
+	"A test notification is on its way.": "測試通知已送出。",
+	"Send a test notification": "傳送測試通知",
+	"Shown as": "顯示為",
+	"The name and picture of this account are what others see in the app.":
+		"別人在應用程式裡看到的，是這個帳號的名稱與頭像。",
+	Automatic: "自動",
+	"Your accounts": "你的帳號",
+	"Put the app on your phone": "把應用程式放到手機上",
+	"On iPhone and iPad, open this page in Safari, tap Share, then Add to Home Screen, and open the app from there.":
+		"在 iPhone 與 iPad 上，用 Safari 開啟此頁，點「分享」，再點「加入主畫面」，之後從主畫面開啟。",
+	"On a phone, add it to the home screen from the browser's menu so notifications reach you when it is closed.":
+		"在手機上，請從瀏覽器選單加入主畫面，這樣應用程式關著時也收得到通知。",
+	"Allow notifications": "允許通知",
+	"This browser cannot get push notifications.": "這個瀏覽器無法接收推播通知。",
+	"Allowed on this device.": "這台裝置已允許。",
+	"Send a test": "傳送測試",
+	"It arrived. Notifications work on this device.":
+		"收到了。這台裝置的通知可以正常運作。",
+	"Waiting for it…": "等待通知中…",
+	"It has not arrived. Check that notifications are allowed for this app, then send another.":
+		"還沒收到。請確認這個應用程式已允許通知，再傳送一次。",
+	Skip: "略過",
+	"{count} device(s) will get notifications.": "{count} 台裝置會收到通知。",
+	Skipped: "已略過",
+	"There is nothing left to set up.": "沒有需要再設定的項目。",
+	"There is no such notice to handle.": "沒有這則可處理的通知。",
+	"This account has no device that gets push yet. Turn it on first.":
+		"這個帳號還沒有接收推播的裝置，請先開啟推播。",
+	"A receipt needs a tag and received or opened.":
+		"回報需要標籤，以及「已收到」或「已開啟」。",
+	"There is no such notification.": "沒有這則通知。",
+	"Send quiet: {start, end, timeZone} or null.":
+		"請傳入 quiet：{start, end, timeZone}，或 null。",
+	"Send provider: the account's provider, or null for the default.":
+		"請傳入 provider（帳號的提供者），或 null 使用預設。",
+	"There is no picture.": "沒有頭像。",
+	"Send request: the id the code came with.":
+		"請傳入 request：驗證碼附帶的代號。",
+	"That step cannot be waived.": "這個步驟不能略過。",
 };