pgkiln 0.82.0 → 0.84.0

package/src/builder/top-sql.ts

@@ -3,6 +3,7 @@ import { owner } from '../db.ts';
 import { html, raw } from '../html.ts';
 import { icon } from '../icons.ts';
 import { appHeader, back, BASE, csrf, developer, flash, region, send, shell, type Req } from './ui.ts';
+import { tr, type BuilderTranslate } from './i18n.ts';
 
 // App Builder → Activity → Top SQL: the statements the application's
 // database role ran, from pg_stat_statements (APEX: Top SQL in the
@@ -27,12 +28,14 @@ export async function statementsState(): Promise<{ ok: true } | { ok: false; rea
 }
 
 /** Why the statistics can't be shown, and how to turn them on. */
-export function statementsNote(reason: 'not_installed' | 'not_loaded' | 'error', message?: string) {
+export function statementsNote(tx: BuilderTranslate, reason: 'not_installed' | 'not_loaded' | 'error', message?: string) {
+  const ext = html`<code>pg_stat_statements</code>`;
+  const setting = html`<code>shared_preload_libraries = 'pg_stat_statements'</code>`;
   return html`<div class="alert alert-error" role="alert">${reason === 'not_installed'
-    ? html`The <code>pg_stat_statements</code> extension isn't installed in this database. To turn it on: set <code>shared_preload_libraries = 'pg_stat_statements'</code> (postgresql.conf, or <code>alter system set shared_preload_libraries = 'pg_stat_statements'</code>), restart PostgreSQL, then as a superuser: <code>create extension pg_stat_statements;</code>`
+    ? tx.rich('topsql.not_installed', { ext, setting, alter: html`<code>alter system set shared_preload_libraries = 'pg_stat_statements'</code>`, create: html`<code>create extension pg_stat_statements;</code>` })
     : reason === 'not_loaded'
-      ? html`The server doesn't load <code>pg_stat_statements</code> yet. Set <code>shared_preload_libraries = 'pg_stat_statements'</code> (the development <code>docker-compose.yml</code> does) and restart PostgreSQL.`
-      : html`The statistics could not be read: ${message ?? ''}`}</div>`;
+      ? tx.rich('topsql.not_loaded', { ext, setting, compose: html`<code>docker-compose.yml</code>` })
+      : tx('topsql.read_error', { message: message ?? '' })}</div>`;
 }
 
 /** The role's statements, slowest in total first (or by mean time, calls or rows). */
@@ -66,28 +69,29 @@ export async function topSqlRoutes(app: FastifyInstance) {
     if (!s) return;
     const a = await appOf(req.params.id);
     if (!a) return reply.code(404).send('Not found');
+    const tx = tr(s);
     const sort = SORTS[req.query.sort ?? ''] ? req.query.sort! : 'total';
     const top = await topSql(a.db_role, sort);
     const sortLink = (key: string, label: string) =>
       html`<a href="${BASE}/apps/${a.id}/top-sql?sort=${key}"${sort === key ? raw(' aria-current="true"') : ''}>${label}</a>`;
     const body = top.ok
       ? top.rows.length
-        ? html`<div class="seg u-mb1">Sort by ${sortLink('total', 'total time')} ${sortLink('mean', 'time per call')} ${sortLink('calls', 'calls')} ${sortLink('rows', 'rows')}</div>
-            <div class="table-wrap"><table class="report report-reflow top-sql"><thead><tr><th class="num">Calls</th><th class="num">Total ms</th><th class="num">Mean ms</th><th class="num">Rows</th><th class="num">Share</th><th>Statement</th></tr></thead>
+        ? html`<div class="seg u-mb1">${tx.rich('topsql.sort_by', { total: sortLink('total', tx('topsql.sort.total')), mean: sortLink('mean', tx('topsql.sort.mean')), calls: sortLink('calls', tx('topsql.sort.calls')), rows: sortLink('rows', tx('topsql.sort.rows')) })}</div>
+            <div class="table-wrap"><table class="report report-reflow top-sql"><thead><tr><th class="num">${tx('sm.col.calls')}</th><th class="num">${tx('sm.col.total_ms')}</th><th class="num">${tx('sm.col.mean_ms')}</th><th class="num">${tx('sm.col.rows')}</th><th class="num">${tx('topsql.share')}</th><th>${tx('sm.col.statement')}</th></tr></thead>
             <tbody>${top.rows.map((r) => html`<tr>
-              <td class="num" data-label="Calls">${r.calls}</td><td class="num" data-label="Total ms">${r.total_ms}</td><td class="num" data-label="Mean ms">${r.mean_ms}</td>
-              <td class="num" data-label="Rows">${r.rows}</td><td class="num" data-label="Share">${r.share ?? 0}%</td>
-              <td data-label="Statement"><code class="sql-text">${r.query}</code></td></tr>`)}</tbody></table></div>
+              <td class="num" data-label="${tx('sm.col.calls')}">${r.calls}</td><td class="num" data-label="${tx('sm.col.total_ms')}">${r.total_ms}</td><td class="num" data-label="${tx('sm.col.mean_ms')}">${r.mean_ms}</td>
+              <td class="num" data-label="${tx('sm.col.rows')}">${r.rows}</td><td class="num" data-label="${tx('topsql.share')}">${r.share ?? 0}%</td>
+              <td data-label="${tx('sm.col.statement')}"><code class="sql-text">${r.query}</code></td></tr>`)}</tbody></table></div>
             <form method="post" action="${BASE}/apps/${a.id}/top-sql/reset" class="u-mt1">${csrf(s)}
-              <button class="btn" data-confirm="Clear the statistics of role ${a.db_role}?">${icon('history')} Reset the statistics</button></form>`
-        : html`<p class="muted">No statements recorded for <code>${a.db_role}</code> yet. Use the application, then come back.</p>`
+              <button class="btn" data-confirm="${tx('topsql.reset_confirm', { role: a.db_role })}">${icon('history')} ${tx('topsql.reset')}</button></form>`
+        : html`<p class="muted">${tx.rich('topsql.none_yet', { role: html`<code>${a.db_role}</code>` })}</p>`
       : top.reason === 'no_role'
-        ? html`<div class="alert alert-error" role="alert">This application runs as the owner role, so its statements can't be told apart. Give it a database role in Settings.</div>`
-        : statementsNote(top.reason, top.message);
+        ? html`<div class="alert alert-error" role="alert">${tx('topsql.no_role')}</div>`
+        : statementsNote(tx, top.reason, top.message);
     const main = html`${appHeader(a, 'activity', s)}
-      ${region('Top SQL', html`<p class="muted u-mt0">Statements run as the role <code>${a.db_role ?? '(owner)'}</code> since the statistics were last reset, from <code>pg_stat_statements</code>. Literals and binds show as <code>$1</code>, <code>$2</code>…; applications that share a role share this list. <a href="${BASE}/apps/${a.id}/activity">Back to Activity</a></p>
+      ${region(tx('sql.tool.topsql'), html`<p class="muted u-mt0">${tx.rich('topsql.intro', { role: html`<code>${a.db_role ?? tx('topsql.owner')}</code>`, ext: html`<code>pg_stat_statements</code>`, p1: html`<code>$1</code>`, p2: html`<code>$2</code>` })} <a href="${BASE}/apps/${a.id}/activity">${tx('topsql.back_activity')}</a></p>
         ${body}`)}`;
-    return send(reply, s, shell(s, `Top SQL · ${a.name}`, [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Activity', `${BASE}/apps/${a.id}/activity`], ['Top SQL']], main));
+    return send(reply, s, shell(s, `${tx('sql.tool.topsql')} · ${a.name}`, [[tx('rail.app_builder'), BASE], [a.name, `${BASE}/apps/${a.id}`], [tx('topsql.activity'), `${BASE}/apps/${a.id}/activity`], [tx('sql.tool.topsql')]], main));
   });
 
   app.post(`${BASE}/apps/:id/top-sql/reset`, async (req: Req, reply) => {
@@ -96,9 +100,9 @@ export async function topSqlRoutes(app: FastifyInstance) {
     const a = await appOf(req.params.id);
     if (!a) return reply.code(404).send('Not found');
     try {
-      if (!a.db_role) throw new Error('The application has no database role.');
+      if (!a.db_role) throw new Error(tr(s)('topsql.no_db_role'));
       await owner.query(`select pg_stat_statements_reset((select oid from pg_roles where rolname = $1), (select oid from pg_database where datname = current_database()), 0)`, [a.db_role]);
-      flash(s, 'Statistics reset.');
+      flash(s, tr(s)('topsql.reset_done'));
     } catch (e) {
       flash(s, (e as Error).message, 'error');
     }

package/src/builder/unload.ts

@@ -22,6 +22,7 @@ import {
 } from '../unload.ts';
 import { BASE, csrf, developer, region, send, shell, workshopTabs, type Body, type Req } from './ui.ts';
 import { sessionSchema, workshopDb } from './workspaces.ts';
+import { tr, type BuilderTranslate } from './i18n.ts';
 
 // SQL Workshop → Unload Data (APEX: Data Workshop → Unload Data): a table or
 // view (chosen columns, an optional WHERE and ORDER BY) or a query, to CSV,
@@ -88,86 +89,89 @@ const list = (v: unknown) => (Array.isArray(v) ? v : v === undefined || v === nu
 export async function unloadRoutes(app: FastifyInstance) {
   const page = (s: Session, reply: FastifyReply, main: Raw, code = 200) => {
     reply.code(code);
-    return send(reply, s, shell(s, 'Unload Data', [['SQL Workshop', `${BASE}/sql`], ['Unload Data']], html`<h1 class="u-mb1">SQL Workshop</h1>${workshopTabs('unload', s)}${main}`, 'sql'));
+    const tx = tr(s);
+    return send(reply, s, shell(s, tx('sql.tool.unload'), [[tx('rail.sql_workshop'), `${BASE}/sql`], [tx('sql.tool.unload')]], html`<h1 class="u-mb1">${tx('rail.sql_workshop')}</h1>${workshopTabs('unload', s)}${main}`, 'sql'));
   };
 
-  const formatFields = (b: Body) => {
+  const formatFields = (tx: BuilderTranslate, b: Body) => {
     const fmt = (UNLOAD_FORMATS as string[]).includes(b.format ?? '') ? b.format : 'csv';
     const posted = b.format !== undefined; // unticked checkboxes post nothing
     const on = (name: string) => (!posted || b[name] === '1' ? raw(' checked') : '');
     const opt = (map: Record<string, string>, field: string, labels: Record<string, string>) =>
       Object.keys(map).map((k) => html`<option value="${k}"${(b[field] ?? Object.keys(map)[0]) === k ? raw(' selected') : ''}>${labels[k]}</option>`);
     return html`
-      <fieldset class="prop-group u-mt125"><legend>Format</legend>
-        <div class="unload-formats" role="radiogroup" aria-label="Format">${UNLOAD_FORMATS.map(
-          (f) => html`<label class="check"><input type="radio" name="format" value="${f}"${fmt === f ? raw(' checked') : ''}> ${{ csv: 'CSV', json: 'JSON', xlsx: 'Excel (.xlsx)', xml: 'XML', sql: 'SQL inserts' }[f]}</label>`,
+      <fieldset class="prop-group u-mt125"><legend>${tx('cl.format')}</legend>
+        <div class="unload-formats" role="radiogroup" aria-label="${tx('cl.format')}">${UNLOAD_FORMATS.map(
+          (f) => html`<label class="check"><input type="radio" name="format" value="${f}"${fmt === f ? raw(' checked') : ''}> ${{ csv: 'CSV', json: 'JSON', xlsx: tx('ul.fmt.xlsx'), xml: 'XML', sql: tx('ul.fmt.sql') }[f]}</label>`,
         )}</div>
       </fieldset>
       <fieldset class="prop-group"><legend>CSV</legend><div class="form-grid">
-        <div class="field"><label class="label" for="f_delimiter">Separator</label>
-          <select id="f_delimiter" name="delimiter">${opt(CSV_DELIMITERS, 'delimiter', { comma: 'Comma ,', semicolon: 'Semicolon ;', tab: 'Tab', pipe: 'Pipe |' })}</select></div>
-        <div class="field"><label class="label" for="f_enclosure">Enclosed by</label>
-          <select id="f_enclosure" name="enclosure">${opt(CSV_ENCLOSURES, 'enclosure', { double: 'Double quote "', single: "Single quote '" })}</select>
-          <small class="help">Only values that contain the separator, the enclosure or a line break are enclosed.</small></div>
+        <div class="field"><label class="label" for="f_delimiter">${tx('ul.separator')}</label>
+          <select id="f_delimiter" name="delimiter">${opt(CSV_DELIMITERS, 'delimiter', { comma: tx('ul.sep.comma'), semicolon: tx('ul.sep.semicolon'), tab: tx('ul.sep.tab'), pipe: tx('ul.sep.pipe') })}</select></div>
+        <div class="field"><label class="label" for="f_enclosure">${tx('ul.enclosed')}</label>
+          <select id="f_enclosure" name="enclosure">${opt(CSV_ENCLOSURES, 'enclosure', { double: tx('ul.enc.double'), single: tx('ul.enc.single') })}</select>
+          <small class="help">${tx('ul.enclosed_help')}</small></div>
         <div class="field"><span class="label" aria-hidden="true"></span>
-          <label class="check"><input type="checkbox" name="header" value="1"${on('header')}> First row: column names</label>
-          <label class="check"><input type="checkbox" name="bom" value="1"${on('bom')}> UTF-8 byte order mark (for Excel)</label></div>
+          <label class="check"><input type="checkbox" name="header" value="1"${on('header')}> ${tx('ul.header')}</label>
+          <label class="check"><input type="checkbox" name="bom" value="1"${on('bom')}> ${tx('ul.bom')}</label></div>
       </div></fieldset>
       <fieldset class="prop-group"><legend>XML</legend><div class="form-grid">
-        <div class="field"><label class="label" for="f_root_tag">Root element</label><input id="f_root_tag" name="root_tag" value="${b.root_tag ?? DEFAULT_UNLOAD.rootTag}" maxlength="64"></div>
-        <div class="field"><label class="label" for="f_row_tag">Row element</label><input id="f_row_tag" name="row_tag" value="${b.row_tag ?? DEFAULT_UNLOAD.rowTag}" maxlength="64">
-          <small class="help">One child element per column; empty (null) values are left out.</small></div>
+        <div class="field"><label class="label" for="f_root_tag">${tx('ul.root')}</label><input id="f_root_tag" name="root_tag" value="${b.root_tag ?? DEFAULT_UNLOAD.rootTag}" maxlength="64"></div>
+        <div class="field"><label class="label" for="f_row_tag">${tx('ul.row')}</label><input id="f_row_tag" name="row_tag" value="${b.row_tag ?? DEFAULT_UNLOAD.rowTag}" maxlength="64">
+          <small class="help">${tx('ul.row_help')}</small></div>
       </div></fieldset>`;
   };
 
-  const sourceTabs = (active: 'table' | 'query') =>
-    html`<nav class="ide-tabs u-mb1" aria-label="Unload from">
-      <a class="ide-tab" href="${BASE}/sql/unload"${active === 'table' ? raw(' aria-current="page"') : ''}>${icon('table')}<span>Table or view</span></a>
-      <a class="ide-tab" href="${BASE}/sql/unload?source=query"${active === 'query' ? raw(' aria-current="page"') : ''}>${icon('code')}<span>Query</span></a></nav>`;
+  const sourceTabs = (tx: BuilderTranslate, active: 'table' | 'query') =>
+    html`<nav class="ide-tabs u-mb1" aria-label="${tx('ul.from')}">
+      <a class="ide-tab" href="${BASE}/sql/unload"${active === 'table' ? raw(' aria-current="page"') : ''}>${icon('table')}<span>${tx('ul.table_or_view')}</span></a>
+      <a class="ide-tab" href="${BASE}/sql/unload?source=query"${active === 'query' ? raw(' aria-current="page"') : ''}>${icon('code')}<span>${tx('sm.col.query')}</span></a></nav>`;
 
-  const intro = html`<p class="muted">Download the rows of a table, a view or a query as CSV, JSON, Excel or XML (up to ${DOWNLOAD_MAX_ROWS.toLocaleString('en')} rows).
-    Runs as the builder's owner connection (an isolated workspace's developer login for its developers) in a read-only transaction. To load a file into a table, use <a href="${BASE}/sql/load">Load Data</a>.</p>`;
+  const introOf = (tx: BuilderTranslate) => html`<p class="muted">${tx('ul.intro', { n: DOWNLOAD_MAX_ROWS.toLocaleString('en') })}
+    ${tx.rich('ul.intro2', { load: html`<a href="${BASE}/sql/load">${tx('sql.tool.load')}</a>` })}</p>`;
 
   const form = async (s: Session, b: Body, error?: string) => {
+    const tx = tr(s);
+    const intro = introOf(tx);
     const alert = error ? html`<div class="alert alert-error" role="alert">${error}</div>` : '';
     if (b.source === 'query')
-      return html`${intro}${sourceTabs('query')}${region(
-        'Unload a query',
+      return html`${intro}${sourceTabs(tx, 'query')}${region(
+        tx('ul.unload_query'),
         html`${alert}<form method="post" action="${BASE}/sql/unload">${csrf(s)}<input type="hidden" name="source" value="query">
-          <div class="field"><label class="label" for="f_query">Query</label>
+          <div class="field"><label class="label" for="f_query">${tx('sm.col.query')}</label>
             <textarea id="f_query" name="query" class="code sql-editor" rows="10" spellcheck="false" data-code="plpgsql" required>${b.query ?? ''}</textarea>
-            <small class="help">One SELECT (or WITH … SELECT) statement.</small></div>
-          ${formatFields(b)}
-          <div class="buttons"><button class="btn btn-hot">${icon('download')} Download</button></div></form>`,
+            <small class="help">${tx('ul.one_select')}</small></div>
+          ${formatFields(tx, b)}
+          <div class="buttons"><button class="btn btn-hot">${icon('download')} ${tx('scr.download')}</button></div></form>`,
       )}`;
     const rels = await relations();
     const rel = rels.find((r) => r.qname === b.table);
     let schema = '';
     const chooser = html`<form method="get" action="${BASE}/sql/unload" class="unload-pick">
-        <label class="sr-only" for="f_table">Table or view</label>
-        <select id="f_table" name="table" required><option value="">- choose a table or view -</option>${rels.map((r) => {
+        <label class="sr-only" for="f_table">${tx('ul.table_or_view')}</label>
+        <select id="f_table" name="table" required><option value="">${tx('ul.choose_table')}</option>${rels.map((r) => {
           const group = r.schema !== schema ? html`${schema ? raw('</optgroup>') : ''}<optgroup label="${(schema = r.schema)}">` : '';
-          return html`${group}<option value="${r.qname}"${r === rel ? raw(' selected') : ''}>${r.name}${r.kind === 'view' ? ' (view)' : ''}</option>`;
+          return html`${group}<option value="${r.qname}"${r === rel ? raw(' selected') : ''}>${r.name}${r.kind === 'view' ? ` ${tx('ul.view')}` : ''}</option>`;
         })}${schema ? raw('</optgroup>') : ''}</select>
-        <button class="btn">Choose</button></form>`;
-    if (!rel) return html`${intro}${sourceTabs('table')}${region('Unload a table or view', html`${alert}${chooser}`)}`;
+        <button class="btn">${tx('ul.choose')}</button></form>`;
+    if (!rel) return html`${intro}${sourceTabs(tx, 'table')}${region(tx('ul.unload_table'), html`${alert}${chooser}`)}`;
     const cols = await columns(rel.qname);
     const chosen = new Set(b.format !== undefined ? list(b.columns) : cols.map((c) => c.name));
-    return html`${intro}${sourceTabs('table')}${region(
-      `Unload ${rel.qname}`,
+    return html`${intro}${sourceTabs(tx, 'table')}${region(
+      tx('ul.unload_of', { name: rel.qname }),
       html`${alert}${chooser}
         <form method="post" action="${BASE}/sql/unload" class="u-mt1">${csrf(s)}<input type="hidden" name="source" value="table"><input type="hidden" name="table" value="${rel.qname}">
-          <fieldset class="prop-group"><legend>Columns</legend><div class="qb-pick">${cols.map(
+          <fieldset class="prop-group"><legend>${tx('ul.columns')}</legend><div class="qb-pick">${cols.map(
             (c) => html`<label class="check"><input type="checkbox" name="columns" value="${c.name}"${chosen.has(c.name) ? raw(' checked') : ''}> ${c.name} <span class="muted small">${c.type}</span></label>`,
           )}</div></fieldset>
           <div class="form-grid">
-            <div class="field"><label class="label" for="f_where">Where</label><input id="f_where" name="where" value="${b.where ?? ''}" placeholder="e.g. deptno = 10" class="code" spellcheck="false">
-              <small class="help">Optional: a condition, without the word WHERE.</small></div>
-            <div class="field"><label class="label" for="f_order">Order by</label><input id="f_order" name="order" value="${b.order ?? ''}" placeholder="e.g. 1, created desc" class="code" spellcheck="false">
-              <small class="help">Optional: columns, without the words ORDER BY.</small></div>
+            <div class="field"><label class="label" for="f_where">${tx('ul.where')}</label><input id="f_where" name="where" value="${b.where ?? ''}" placeholder="${tx('ul.eg', { x: 'deptno = 10' })}" class="code" spellcheck="false">
+              <small class="help">${tx('ul.where_help')}</small></div>
+            <div class="field"><label class="label" for="f_order">${tx('ul.order')}</label><input id="f_order" name="order" value="${b.order ?? ''}" placeholder="${tx('ul.eg', { x: '1, created desc' })}" class="code" spellcheck="false">
+              <small class="help">${tx('ul.order_help')}</small></div>
           </div>
-          ${formatFields(b)}
-          <div class="buttons"><button class="btn btn-hot">${icon('download')} Download</button></div></form>`,
+          ${formatFields(tx, b)}
+          <div class="buttons"><button class="btn btn-hot">${icon('download')} ${tx('scr.download')}</button></div></form>`,
     )}`;
   };
 
@@ -192,10 +196,10 @@ export async function unloadRoutes(app: FastifyInstance) {
         name = 'query';
       } else {
         const rel = (await relations()).find((r) => r.qname === b.table);
-        if (!rel) return refuse('Choose a table or view.');
+        if (!rel) return refuse(tr(s)('ul.err.table'));
         const known = new Set((await columns(rel.qname)).map((c) => c.name));
         const cols = list(b.columns).filter((c) => known.has(c));
-        if (!cols.length) return refuse('Choose at least one column.');
+        if (!cols.length) return refuse(tr(s)('ul.err.column'));
         const where = (b.where ?? '').trim();
         const order = (b.order ?? '').trim();
         // the WHERE and ORDER BY text is the developer's SQL: the whole statement must still be one SELECT
@@ -226,7 +230,7 @@ export async function unloadRoutes(app: FastifyInstance) {
     } catch (e) {
       await c.query('rollback').catch(() => {});
       c.release(true);
-      return refuse(`The query failed: ${(e as Error).message}`);
+      return refuse(tr(s)('ul.err.failed', { error: (e as Error).message }));
     }
     await logActivity({ username: s.username, event: 'sql_unload', ip: clientIp(req), detail: `${opts.format}: ${sql.length > 1900 ? `${sql.slice(0, 1900)}…` : sql}` });
     const out = new PassThrough();

package/src/builder/worksheet.ts

@@ -121,9 +121,9 @@ async function navigatorTree(db: Awaited<ReturnType<typeof workshopDb>>, schema:
   return html`<ul class="ws-tree" id="ws-tree">${objects.map((o) => {
     const list = cols.get(o.ref);
     const obLink = `${BASE}/sql/objects?${new URLSearchParams(o.type === 'policy' ? { schema, k: 'table', o: o.ref, tab: 'rls' } : { schema, k: o.type, o: o.ref })}`;
-    if (!list) return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}"><a href="${obLink}" title="${label(o.type)}">${icon(iconOf(o.type))}<span>${o.name}</span></a>${objectMenu(schema, o)}</li>`;
+    if (!list) return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}"><a href="${obLink}" title="${label(o.type)}">${icon(iconOf(o.type))}<span>${o.name}</span></a>${objectMenu(schema, o, tx)}</li>`;
     const st = objectStatements(schema, o.name, list, o.type);
-    return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}">${objectMenu(schema, o)}<details>
+    return html`<li class="ws-obj" data-name="${o.name.toLowerCase()}">${objectMenu(schema, o, tx)}<details>
       <summary draggable="true" data-ws-sql="${st.select}" title="${tx('ws.nav.drag', { type: tx.lang === 'en' ? label(o.type).replace(/s$/, '') : label(o.type) })}">${icon(iconOf(o.type))}<span>${o.name}</span>${o.rls ? html`<span class="tag">RLS</span>` : ''}</summary>
       <ul class="ws-cols">${list.map((c) => html`<li title="${c.type}${c.notnull ? ' not null' : ''}">${c.pk ? icon('key') : icon('minus')}<span>${c.name}</span><small class="muted">${c.type}</small></li>`)}</ul>
       <div class="ws-obj-actions">
@@ -525,7 +525,7 @@ async function worksheet(req: Req, reply: FastifyReply) {
     else {
       const d = drawChart('', lastQuery.columns, lastQuery.data ?? [], spec);
       chartCss = d.css;
-      chartPane = html`${chartControls(lastQuery.columns, spec)}
+      chartPane = html`${chartControls(lastQuery.columns, spec, 'ch', tx)}
         <div class="ch-actions"><button class="btn btn-sm" name="mode" value="chart">${icon('refresh')} ${tx('ws.chart.again')}</button>
           <input type="hidden" name="chart_sql" value="${lastQuery.sql}">
           <label class="sr-only" for="ws-chart-name">${tx('ws.chart.name')}</label><input id="ws-chart-name" name="chart_name" placeholder="${tx('ws.chart.name')}" maxlength="120">

package/src/cli/replace.ts

@@ -78,6 +78,8 @@ export const KEPT = ['app_access', 'api_client', 'session', 'sso_pending', 'save
   'rest_object',
   // (121) the log of AI tool calls (the agents and tools themselves travel in meta.app)
   'ai_tool_call',
+  // (154) users' in-app notifications
+  'notification',
   // (122) Team Development issues of the workspace, linked to the application (workspace data: the workspace export)
   'team_issue',
   // (123) the log of running workflow instances migrated to a newer version (runtime data, like the instances)

package/src/cron-schedule.ts

@@ -231,12 +231,12 @@ const pad = (n: number) => String(n).padStart(2, '0');
 const sorted = (s: Set<number>) => [...s].sort((a, b) => a - b);
 const isAll = (s: Set<number>, min: number, max: number) => s.size === max - min + 1;
 /** a list of numbers with runs as ranges: 1-5, 7 */
-function compact(values: number[], name: (n: number) => string = String) {
+function compact(values: number[], name: (n: number) => string = String, t: CronWords = EN_WORDS) {
   const out: string[] = [];
   for (let i = 0; i < values.length; i++) {
     let j = i;
     while (j + 1 < values.length && values[j + 1] === values[j] + 1) j++;
-    out.push(j - i >= 2 ? `${name(values[i])} to ${name(values[j])}` : j > i ? `${name(values[i])}, ${name(values[j])}` : name(values[i]));
+    out.push(j - i >= 2 ? fillWords(t('cron.range'), { from: name(values[i]), to: name(values[j]) }) : j > i ? `${name(values[i])}, ${name(values[j])}` : name(values[i]));
     i = j;
   }
   return out.join(', ');
@@ -250,33 +250,63 @@ function stepOf(s: Set<number>, min: number, max: number) {
 }
 
 /** The schedule in words ("At 02:00, every day"). */
-export function describeSchedule(s: Schedule): string {
-  if (s.kind === 'reboot') return 'When the database server starts';
-  if (s.kind === 'seconds') return s.seconds === 1 ? 'Every second' : `Every ${s.seconds} seconds`;
+/**
+ * (sprint 162, CD-8) The phrases of a schedule in words, by key: English here; the builder passes its translator
+ * (the same keys, cron.*, in src/builder/i18n/*.ts) and the language for the day and month names.
+ */
+export const EN_WORDS_TEXT: Record<string, string> = {
+  'cron.reboot': 'When the database server starts', 'cron.every_second': 'Every second', 'cron.every_seconds': 'Every {n} seconds',
+  'cron.every_minute': 'Every minute', 'cron.every_minutes': 'Every {n} minutes', 'cron.every_hour': 'Every hour',
+  'cron.minute_of_hour': 'At minute {m} of every hour', 'cron.minutes_of_hour': 'At minutes {list} of every hour', 'cron.at': 'At {times}',
+  'cron.at_minute': 'At minute {m}', 'cron.at_minutes': 'At minutes {list}', 'cron.of_every_hours': '{mins} of every {n} hours',
+  'cron.past_hours': '{mins} past hours {list}', 'cron.day_and_last': 'on day {list} and the last day of the month',
+  'cron.last_day': 'on the last day of the month', 'cron.day_of_month': 'on day {list} of the month', 'cron.weekdays': 'on weekdays',
+  'cron.on_days': 'on {list}', 'cron.a_days': 'a {list}', 'cron.either': '{dom} or {dow}', 'cron.if': '{dom} if it is {dow}',
+  'cron.every_day': 'every day', 'cron.in_months': 'in {list}', 'cron.range': '{from} to {to}',
+};
+export type CronWords = (key: string) => string;
+const EN_WORDS: CronWords = (k) => EN_WORDS_TEXT[k] ?? k;
+const fillWords = (text: string, p: Record<string, string | number>) => text.replace(/\{(\w+)\}/g, (m, k: string) => (k in p ? String(p[k]) : m));
+
+/** Day (0 = Sunday) and month (1 = January) names in a language (English: as before). */
+const dayName = (lang: string, d: number) => (lang === 'en' ? DAY_NAMES[d] : new Intl.DateTimeFormat(lang, { weekday: 'long', timeZone: 'UTC' }).format(new Date(Date.UTC(2023, 0, 1 + d))));
+const monthName = (lang: string, m: number) => (lang === 'en' ? MONTH_NAMES[m - 1] : new Intl.DateTimeFormat(lang, { month: 'long', timeZone: 'UTC' }).format(new Date(Date.UTC(2023, m - 1, 1))));
+
+export function describeSchedule(s: Schedule, t: CronWords = EN_WORDS, lang = 'en'): string {
+  const w = (key: string, p: Record<string, string | number> = {}) => fillWords(t(key), p);
+  const list = (v: number[], name?: (n: number) => string) => compact(v, name, t);
+  if (s.kind === 'reboot') return w('cron.reboot');
+  if (s.kind === 'seconds') return s.seconds === 1 ? w('cron.every_second') : w('cron.every_seconds', { n: s.seconds });
   const minutes = sorted(s.minutes);
   const hours = sorted(s.hours);
   let time: string;
-  if (isAll(s.minutes, 0, 59) && isAll(s.hours, 0, 23)) time = 'Every minute';
-  else if (isAll(s.hours, 0, 23)) {
+  // whether the time already says how often (then no "every day")
+  let often = false;
+  if (isAll(s.minutes, 0, 59) && isAll(s.hours, 0, 23)) {
+    time = w('cron.every_minute');
+    often = true;
+  } else if (isAll(s.hours, 0, 23)) {
     const step = stepOf(s.minutes, 0, 59);
-    time = step ? `Every ${step} minutes` : minutes.length === 1 ? (minutes[0] === 0 ? 'Every hour' : `At minute ${minutes[0]} of every hour`) : `At minutes ${compact(minutes)} of every hour`;
-  } else if (hours.length * minutes.length <= 6) time = `At ${hours.flatMap((h) => minutes.map((m) => `${pad(h)}:${pad(m)}`)).join(', ')}`;
+    often = true;
+    time = step ? w('cron.every_minutes', { n: step }) : minutes.length === 1 ? (minutes[0] === 0 ? w('cron.every_hour') : w('cron.minute_of_hour', { m: minutes[0] })) : w('cron.minutes_of_hour', { list: list(minutes) });
+  } else if (hours.length * minutes.length <= 6) time = w('cron.at', { times: hours.flatMap((h) => minutes.map((m) => `${pad(h)}:${pad(m)}`)).join(', ') });
   else {
     const step = stepOf(s.hours, 0, 23);
-    const mins = isAll(s.minutes, 0, 59) ? 'Every minute' : minutes.length === 1 ? `At minute ${minutes[0]}` : `At minutes ${compact(minutes)}`;
-    time = `${mins} ${step ? `of every ${step} hours` : `past hours ${compact(hours)}`}`;
+    const mins = isAll(s.minutes, 0, 59) ? w('cron.every_minute') : minutes.length === 1 ? w('cron.at_minute', { m: minutes[0] }) : w('cron.at_minutes', { list: list(minutes) });
+    time = step ? w('cron.of_every_hours', { mins, n: step }) : w('cron.past_hours', { mins, list: list(hours) });
   }
   const parts = [time];
   const domAll = isAll(s.days, 1, 31) && !s.lastDay;
   const dowAll = isAll(s.weekdays, 0, 6);
-  const dom = s.lastDay ? (s.days.size ? `on day ${compact(sorted(s.days))} and the last day of the month` : 'on the last day of the month') : `on day ${compact(sorted(s.days))} of the month`;
+  const dom = s.lastDay ? (s.days.size ? w('cron.day_and_last', { list: list(sorted(s.days)) }) : w('cron.last_day')) : w('cron.day_of_month', { list: list(sorted(s.days)) });
   const weekdays = sorted(s.weekdays);
-  const dow = weekdays.join() === '1,2,3,4,5' ? 'on weekdays' : `on ${compact(weekdays, (d) => DAY_NAMES[d])}`;
-  if (s.either) parts.push(`${dom} or ${dow}`);
-  else if (!domAll && !dowAll) parts.push(`${dom} if it is ${dow.replace(/^on /, 'a ')}`);
+  const days = list(weekdays, (d) => dayName(lang, d));
+  const dow = weekdays.join() === '1,2,3,4,5' ? w('cron.weekdays') : w('cron.on_days', { list: days });
+  if (s.either) parts.push(w('cron.either', { dom, dow }));
+  else if (!domAll && !dowAll) parts.push(w('cron.if', { dom, dow: weekdays.join() === '1,2,3,4,5' ? w('cron.weekdays') : w('cron.a_days', { list: days }) }));
   else if (!domAll) parts.push(dom);
   else if (!dowAll) parts.push(dow);
-  else if (time !== 'Every minute' && !/^Every \d+ minutes$|hour$/.test(time)) parts.push('every day');
-  if (!isAll(s.months, 1, 12)) parts.push(`in ${compact(sorted(s.months), (m) => MONTH_NAMES[m - 1])}`);
+  else if (!often) parts.push(w('cron.every_day'));
+  if (!isAll(s.months, 1, 12)) parts.push(w('cron.in_months', { list: list(sorted(s.months), (m) => monthName(lang, m)) }));
   return parts.join(', ');
 }

package/src/i18n/ar.ts

@@ -310,6 +310,15 @@ export const ar: Record<MessageKey, string> = {
   'account.devices_help': "المتصفحات التي اخترت فيها «إبقائي مسجّلًا»: {count}.",
   'account.forget_devices': "تسجيل الخروج من كل الأجهزة",
   'account.devices_forgotten': "تم تسجيل الخروج من كل الأجهزة.",
+  'notify.title': "الإشعارات",
+  'notify.none': "لا توجد إشعارات.",
+  'notify.mark_all_read': "تعليم الكل كمقروء",
+  'notify.all': "كل الإشعارات",
+  'notify.marked': "تم تعليم الإشعارات كمقروءة.",
+  'notify.gone': "هذا الإشعار لم يعد موجودًا.",
+  'notify.bell_one': "الإشعارات: 1 غير مقروء",
+  'notify.bell_n': "الإشعارات: {n} غير مقروءة",
+  'notify.unread_one': "غير مقروء",
   'push.title': "الإشعارات",
   'push.help': "تلقَّ إشعارات هذا التطبيق على هذا الجهاز، حتى عندما يكون التطبيق مغلقًا.",
   'push.devices': "الأجهزة التي تتلقى الإشعارات: {n}.",

package/src/i18n/cs.ts

@@ -310,6 +310,15 @@ export const cs: Record<MessageKey, string> = {
   'account.devices_help': "Prohlížeče, ve kterých jste zvolili „Zůstat přihlášen“: {count}.",
   'account.forget_devices': "Odhlásit na všech zařízeních",
   'account.devices_forgotten': "Odhlášeno na všech zařízeních.",
+  'notify.title': "Oznámení",
+  'notify.none': "Žádná oznámení.",
+  'notify.mark_all_read': "Označit vše jako přečtené",
+  'notify.all': "Všechna oznámení",
+  'notify.marked': "Oznámení označena jako přečtená.",
+  'notify.gone': "Toto oznámení už neexistuje.",
+  'notify.bell_one': "Oznámení: 1 nepřečtené",
+  'notify.bell_n': "Oznámení: nepřečtených {n}",
+  'notify.unread_one': "Nepřečtené",
   'push.title': "Oznámení",
   'push.help': "Dostávejte oznámení z této aplikace na tomto zařízení, i když je aplikace zavřená.",
   'push.devices': "Zařízení s oznámeními: {n}.",

package/src/i18n/da.ts

@@ -310,6 +310,15 @@ export const da: Record<MessageKey, string> = {
   'account.devices_help': "Browsere, hvor du valgte “Hold mig logget ind”: {count}.",
   'account.forget_devices': "Log ud på alle enheder",
   'account.devices_forgotten': "Logget ud på alle enheder.",
+  'notify.title': "Notifikationer",
+  'notify.none': "Ingen notifikationer.",
+  'notify.mark_all_read': "Markér alle som læst",
+  'notify.all': "Alle notifikationer",
+  'notify.marked': "Notifikationerne er markeret som læst.",
+  'notify.gone': "Denne notifikation findes ikke længere.",
+  'notify.bell_one': "Notifikationer: 1 ulæst",
+  'notify.bell_n': "Notifikationer: {n} ulæste",
+  'notify.unread_one': "Ulæst",
   'push.title': "Notifikationer",
   'push.help': "Få notifikationer fra denne app på denne enhed, også når appen er lukket.",
   'push.devices': "Enheder med notifikationer: {n}.",

package/src/i18n/de.ts

@@ -310,6 +310,15 @@ export const de: Record<MessageKey, string> = {
   'account.devices_help': 'Browser, in denen Sie „Angemeldet bleiben“ gewählt haben: {count}.',
   'account.forget_devices': 'Auf allen Geräten abmelden',
   'account.devices_forgotten': 'Auf allen Geräten abgemeldet.',
+  'notify.title': "Benachrichtigungen",
+  'notify.none': "Keine Benachrichtigungen.",
+  'notify.mark_all_read': "Alle als gelesen markieren",
+  'notify.all': "Alle Benachrichtigungen",
+  'notify.marked': "Benachrichtigungen als gelesen markiert.",
+  'notify.gone': "Diese Benachrichtigung gibt es nicht mehr.",
+  'notify.bell_one': "Benachrichtigungen: 1 ungelesen",
+  'notify.bell_n': "Benachrichtigungen: {n} ungelesen",
+  'notify.unread_one': "Ungelesen",
   'push.title': "Benachrichtigungen",
   'push.help': "Erhalten Sie Benachrichtigungen dieser App auf diesem Gerät, auch wenn die App geschlossen ist.",
   'push.devices': "Geräte mit Benachrichtigungen: {n}.",

package/src/i18n/el.ts

@@ -310,6 +310,15 @@ export const el: Record<MessageKey, string> = {
   'account.devices_help': "Προγράμματα περιήγησης όπου επιλέξατε «Να παραμείνω συνδεδεμένος»: {count}.",
   'account.forget_devices': "Αποσύνδεση από όλες τις συσκευές",
   'account.devices_forgotten': "Έγινε αποσύνδεση από όλες τις συσκευές.",
+  'notify.title': "Ειδοποιήσεις",
+  'notify.none': "Δεν υπάρχουν ειδοποιήσεις.",
+  'notify.mark_all_read': "Σήμανση όλων ως αναγνωσμένων",
+  'notify.all': "Όλες οι ειδοποιήσεις",
+  'notify.marked': "Οι ειδοποιήσεις σημάνθηκαν ως αναγνωσμένες.",
+  'notify.gone': "Αυτή η ειδοποίηση δεν υπάρχει πια.",
+  'notify.bell_one': "Ειδοποιήσεις: 1 μη αναγνωσμένη",
+  'notify.bell_n': "Ειδοποιήσεις: {n} μη αναγνωσμένες",
+  'notify.unread_one': "Μη αναγνωσμένη",
   'push.title': "Ειδοποιήσεις",
   'push.help': "Λάβετε ειδοποιήσεις από αυτήν την εφαρμογή σε αυτήν τη συσκευή, ακόμη και όταν η εφαρμογή είναι κλειστή.",
   'push.devices': "Συσκευές με ειδοποιήσεις: {n}.",

package/src/i18n/es.ts

@@ -310,6 +310,15 @@ export const es: Record<MessageKey, string> = {
   'account.devices_help': 'Navegadores en los que eligió "Mantener la sesión iniciada": {count}.',
   'account.forget_devices': 'Cerrar sesión en todos los dispositivos',
   'account.devices_forgotten': 'Sesión cerrada en todos los dispositivos.',
+  'notify.title': "Notificaciones",
+  'notify.none': "No hay notificaciones.",
+  'notify.mark_all_read': "Marcar todas como leídas",
+  'notify.all': "Todas las notificaciones",
+  'notify.marked': "Notificaciones marcadas como leídas.",
+  'notify.gone': "Esta notificación ya no existe.",
+  'notify.bell_one': "Notificaciones: 1 sin leer",
+  'notify.bell_n': "Notificaciones: {n} sin leer",
+  'notify.unread_one': "Sin leer",
   'push.title': "Notificaciones",
   'push.help': "Reciba notificaciones de esta aplicación en este dispositivo, también cuando la aplicación está cerrada.",
   'push.devices': "Dispositivos con notificaciones: {n}.",

package/src/i18n/fi.ts

@@ -310,6 +310,15 @@ export const fi: Record<MessageKey, string> = {
   'account.devices_help': "Selaimet, joissa valitsit ”Pidä minut kirjautuneena”: {count}.",
   'account.forget_devices': "Kirjaudu ulos kaikilla laitteilla",
   'account.devices_forgotten': "Kirjauduttu ulos kaikilla laitteilla.",
+  'notify.title': "Ilmoitukset",
+  'notify.none': "Ei ilmoituksia.",
+  'notify.mark_all_read': "Merkitse kaikki luetuiksi",
+  'notify.all': "Kaikki ilmoitukset",
+  'notify.marked': "Ilmoitukset merkittiin luetuiksi.",
+  'notify.gone': "Tätä ilmoitusta ei enää ole.",
+  'notify.bell_one': "Ilmoitukset: 1 lukematon",
+  'notify.bell_n': "Ilmoitukset: {n} lukematonta",
+  'notify.unread_one': "Lukematon",
   'push.title': "Ilmoitukset",
   'push.help': "Saa tämän sovelluksen ilmoitukset tälle laitteelle, myös kun sovellus on suljettu.",
   'push.devices': "Laitteet, joilla on ilmoitukset: {n}.",

package/src/i18n/fr.ts

@@ -310,6 +310,15 @@ export const fr: Record<MessageKey, string> = {
   'account.devices_help': 'Navigateurs où vous avez choisi « Rester connecté » : {count}.',
   'account.forget_devices': 'Se déconnecter sur tous les appareils',
   'account.devices_forgotten': 'Déconnecté sur tous les appareils.',
+  'notify.title': "Notifications",
+  'notify.none': "Aucune notification.",
+  'notify.mark_all_read': "Tout marquer comme lu",
+  'notify.all': "Toutes les notifications",
+  'notify.marked': "Notifications marquées comme lues.",
+  'notify.gone': "Cette notification n'existe plus.",
+  'notify.bell_one': "Notifications : 1 non lue",
+  'notify.bell_n': "Notifications : {n} non lues",
+  'notify.unread_one': "Non lue",
   'push.title': "Notifications",
   'push.help': "Recevez les notifications de cette application sur cet appareil, même lorsqu'elle est fermée.",
   'push.devices': "Appareils avec notifications : {n}.",

package/src/i18n/he.ts

@@ -310,6 +310,15 @@ export const he: Record<MessageKey, string> = {
   'account.devices_help': "דפדפנים שבהם בחרתם \"להשאיר אותי מחובר\": {count}.",
   'account.forget_devices': "יציאה מכל המכשירים",
   'account.devices_forgotten': "בוצעה יציאה מכל המכשירים.",
+  'notify.title': "התראות",
+  'notify.none': "אין התראות.",
+  'notify.mark_all_read': "סימון הכול כנקרא",
+  'notify.all': "כל ההתראות",
+  'notify.marked': "ההתראות סומנו כנקראו.",
+  'notify.gone': "ההתראה הזו כבר לא קיימת.",
+  'notify.bell_one': "התראות: 1 שלא נקראה",
+  'notify.bell_n': "התראות: {n} שלא נקראו",
+  'notify.unread_one': "לא נקראה",
   'push.title': "התראות",
   'push.help': "קבלו התראות מהאפליקציה הזו במכשיר הזה, גם כשהאפליקציה סגורה.",
   'push.devices': "מכשירים עם התראות: {n}.",

package/src/i18n/it.ts

@@ -310,6 +310,15 @@ export const it: Record<MessageKey, string> = {
   'account.devices_help': "Browser in cui hai scelto “Mantieni l'accesso”: {count}.",
   'account.forget_devices': "Esci da tutti i dispositivi",
   'account.devices_forgotten': "Uscita effettuata da tutti i dispositivi.",
+  'notify.title': "Notifiche",
+  'notify.none': "Nessuna notifica.",
+  'notify.mark_all_read': "Segna tutte come lette",
+  'notify.all': "Tutte le notifiche",
+  'notify.marked': "Notifiche segnate come lette.",
+  'notify.gone': "Questa notifica non esiste più.",
+  'notify.bell_one': "Notifiche: 1 da leggere",
+  'notify.bell_n': "Notifiche: {n} da leggere",
+  'notify.unread_one': "Da leggere",
   'push.title': "Notifiche",
   'push.help': "Ricevi le notifiche di questa app su questo dispositivo, anche quando l'app è chiusa.",
   'push.devices': "Dispositivi con notifiche: {n}.",

package/src/i18n/ja.ts

@@ -310,6 +310,15 @@ export const ja: Record<MessageKey, string> = {
   'account.devices_help': "「サインインしたままにする」を選んだブラウザー: {count}。",
   'account.forget_devices': "すべてのデバイスでサインアウト",
   'account.devices_forgotten': "すべてのデバイスでサインアウトしました。",
+  'notify.title': "通知",
+  'notify.none': "通知はありません。",
+  'notify.mark_all_read': "すべて既読にする",
+  'notify.all': "すべての通知",
+  'notify.marked': "通知を既読にしました。",
+  'notify.gone': "この通知はもう存在しません。",
+  'notify.bell_one': "通知: 未読 1 件",
+  'notify.bell_n': "通知: 未読 {n} 件",
+  'notify.unread_one': "未読",
   'push.title': "通知",
   'push.help': "アプリを閉じているときも、このデバイスでこのアプリの通知を受け取ります。",
   'push.devices': "通知を受け取るデバイス: {n}。",