pgkiln 0.83.0 → 0.85.0

package/src/builder/websources.ts

@@ -11,6 +11,7 @@ import { buildRequest, call, clearResponseCache, clearTokens, credentialProblems
 import type { ComponentSpec } from './components.ts';
 import { back, BASE, csrf, developer, flash, type Req } from './ui.ts';
 import { resolveSource } from '../remote-servers.ts';
+import { scopedTx as tx } from './i18n.ts';
 
 // Shared Components → Web credentials and REST data sources: their property
 // specs, the secrets' status (never a secret), "Test" for a source (its
@@ -139,9 +140,9 @@ export async function designSql(appId: number, r: { source: string | null; rest_
 export const needsSecret = (row: { type: string; grant_type?: string | null }) => row.type !== 'oauth2' || (row.grant_type ?? 'client_credentials') === 'client_credentials';
 
 const CLEARABLE: Record<string, { column: string; label: string }> = {
-  secret: { column: 'secret_enc', label: 'the secret' },
-  password: { column: 'password_enc', label: 'the password' },
-  refresh: { column: 'refresh_token_enc', label: 'the refresh token' },
+  secret: { column: 'secret_enc', get label() { return tx('wsrc.the_secret'); } },
+  password: { column: 'password_enc', get label() { return tx('wsrc.the_password'); } },
+  refresh: { column: 'refresh_token_enc', get label() { return tx('wsrc.the_refresh_token'); } },
 };
 
 export function credentialExtras(
@@ -150,20 +151,20 @@ export function credentialExtras(
   s: Session,
 ) {
   const clear = (what: string) =>
-    html`<form method="post" action="${BASE}/apps/${appId}/web-credentials/${row.id}/clear" class="u-inline">${csrf(s)}<input type="hidden" name="what" value="${what}"><button class="btn" data-confirm="Remove ${CLEARABLE[what].label}?">Remove ${CLEARABLE[what].label}</button></form>`;
+    html`<form method="post" action="${BASE}/apps/${appId}/web-credentials/${row.id}/clear" class="u-inline">${csrf(s)}<input type="hidden" name="what" value="${what}"><button class="btn" data-confirm="${tx('wsrc.remove_confirm', { what: CLEARABLE[what].label })}">${tx('wsrc.remove', { what: CLEARABLE[what].label })}</button></form>`;
   const oauth = row.type === 'oauth2';
   const grant = row.grant_type ?? 'client_credentials';
-  return html`<fieldset class="prop-group u-mt125"><legend>Secrets</legend>
+  return html`<fieldset class="prop-group u-mt125"><legend>${tx('wsrc.secrets')}</legend>
     <p>${row.secret_enc
-      ? html`<b>A secret is stored</b> (encrypted). It is never shown; type a new one above to replace it.`
-      : needsSecret(row) ? html`<b>No secret yet.</b> Requests with this credential fail until one is entered.` : html`No client secret (a public client).`}</p>
-    ${oauth && grant === 'password' ? html`<p>${row.password_enc ? html`<b>A password is stored</b> (encrypted).` : html`<b>No password yet.</b> The password flow fails until one is entered.`}</p>` : ''}
+      ? tx.rich('wsrc.secret_stored', { stored: html`<b>${tx('wsrc.a_secret_is_stored')}</b>` })
+      : needsSecret(row) ? tx.rich('wsrc.secret_missing', { none: html`<b>${tx('wsrc.no_secret_yet')}</b>` }) : tx('wsrc.no_client_secret')}</p>
+    ${oauth && grant === 'password' ? html`<p>${row.password_enc ? tx.rich('wsrc.password_stored', { stored: html`<b>${tx('wsrc.a_password_is_stored')}</b>` }) : tx.rich('wsrc.password_missing', { none: html`<b>${tx('wsrc.no_password_yet')}</b>` })}</p>` : ''}
     ${oauth
       ? html`<p>${row.refresh_token_enc
-          ? html`<b>A refresh token is stored</b> (encrypted)${row.token_refreshed_at ? html`, received ${new Date(row.token_refreshed_at).toISOString().slice(0, 16).replace('T', ' ')} UTC` : ''}. pgkiln uses it to renew the access token and keeps the newer one the service sends.`
-          : grant === 'refresh_token' ? html`<b>No refresh token yet.</b> Enter one above.` : html`No refresh token yet (kept when the token endpoint sends one).`}</p>`
+          ? (row.token_refreshed_at ? tx.rich('wsrc.refresh_stored_at', { stored: html`<b>${tx('wsrc.a_refresh_token_is_stored')}</b>`, at: new Date(row.token_refreshed_at).toISOString().slice(0, 16).replace('T', ' ') }) : tx.rich('wsrc.refresh_stored', { stored: html`<b>${tx('wsrc.a_refresh_token_is_stored')}</b>` }))
+          : grant === 'refresh_token' ? tx.rich('wsrc.refresh_missing', { none: html`<b>${tx('wsrc.no_refresh_token_yet')}</b>` }) : tx('wsrc.no_refresh')}</p>`
       : ''}
-    ${secretKeyConfigured() ? '' : html`<div class="alert alert-error" role="alert">The server has no <code>PGKILN_SECRET_KEY</code>: secrets can't be saved or used until it is set (at least 32 characters).</div>`}
+    ${secretKeyConfigured() ? '' : html`<div class="alert alert-error" role="alert">${tx.code('wsrc.no_secret_key')}</div>`}
     <div class="buttons">${row.secret_enc ? clear('secret') : ''}${row.password_enc ? clear('password') : ''}${row.refresh_token_enc ? clear('refresh') : ''}</div>
   </fieldset>`;
 }
@@ -185,8 +186,8 @@ const when = (d: Date | string | null) => (d ? new Date(d).toISOString().slice(0
 
 /** A source's synchronisation: next run, Synchronise now, the last runs. */
 async function syncExtras(appId: number, row: RestSource & Record<string, any>, s: Session) {
-  if (!row.sync_table) return html`<fieldset class="prop-group u-mt125"><legend>Synchronisation</legend>
-    <p class="muted">Set a local table above to copy this source's rows into a table (on demand, from SQL or on a schedule).</p></fieldset>`;
+  if (!row.sync_table) return html`<fieldset class="prop-group u-mt125"><legend>${tx('wsrc.synchronisation')}</legend>
+    <p class="muted">${tx('wsrc.set_a_local_table_above')}</p></fieldset>`;
   let next = 'not scheduled';
   if (row.sync_enabled && row.sync_schedule)
     try {
@@ -194,26 +195,26 @@ async function syncExtras(appId: number, row: RestSource & Record<string, any>,
     } catch (e) {
       next = `never: ${(e as Error).message}`;
     }
-  const scheduler = process.env.AUTOMATIONS === 'off' ? html` <b>(the scheduler is off on this server: AUTOMATIONS=off)</b>` : '';
+  const scheduler = process.env.AUTOMATIONS === 'off' ? html` <b>${tx('wsrc.the_scheduler_is_off_on')}</b>` : '';
   const log = await syncLog(row.id);
-  return html`<fieldset class="prop-group u-mt125"><legend>Synchronisation</legend>
-    <p>Into <code>${row.sync_table}</code> (${row.sync_mode}${row.sync_mode === 'merge' && row.sync_delete ? ', deleting missing rows' : ''}). Next run: <b>${next}</b>${scheduler}</p>
-    <p class="muted">From application code: <code>select meta.request_rest_sync('${row.name}')</code> queues a run for the server's next scheduler pass.</p>
-    <form method="post" action="${BASE}/apps/${appId}/rest-sources/${row.id}/sync">${csrf(s)}<button class="btn">${icon('play')} Synchronise now</button></form>
+  return html`<fieldset class="prop-group u-mt125"><legend>${tx('wsrc.synchronisation')}</legend>
+    <p>${tx.rich('wsrc.sync_into', { table: html`<code>${row.sync_table}</code>`, mode: `${row.sync_mode}${row.sync_mode === 'merge' && row.sync_delete ? `, ${tx('wsrc.deleting_missing')}` : ''}`, next: html`<b>${next}</b>` })}${scheduler}</p>
+    <p class="muted">${tx.rich('wsrc.sync_from_code', { call: html`<code>select meta.request_rest_sync('${row.name}')</code>` })}</p>
+    <form method="post" action="${BASE}/apps/${appId}/rest-sources/${row.id}/sync">${csrf(s)}<button class="btn">${icon('play')} ${tx('wsrc.synchronise_now')}</button></form>
     ${log.length
-      ? html`<div class="table-wrap u-mt075"><table class="report report-reflow"><thead><tr><th>Requested</th><th>Took</th><th>By</th><th>Status</th><th class="num">Rows</th><th class="num">Inserted</th><th class="num">Updated</th><th class="num">Deleted</th><th>Message</th></tr></thead><tbody>
+      ? html`<div class="table-wrap u-mt075"><table class="report report-reflow"><thead><tr><th>${tx('wsrc.requested')}</th><th>${tx('wsrc.took')}</th><th>${tx('wsrc.by')}</th><th>${tx('wsrc.status')}</th><th class="num">${tx('wsrc.rows')}</th><th class="num">${tx('wsrc.inserted')}</th><th class="num">${tx('wsrc.updated')}</th><th class="num">${tx('wsrc.deleted')}</th><th>${tx('wsrc.message')}</th></tr></thead><tbody>
           ${log.map((l) => html`<tr>
-            <td data-label="Requested">${when(l.requested_at)}</td>
-            <td data-label="Took">${l.finished_at && l.started_at ? `${((new Date(l.finished_at).getTime() - new Date(l.started_at).getTime()) / 1000).toFixed(1)} s` : '…'}</td>
-            <td data-label="By">${l.trigger}${l.requested_by ? html` <span class="muted">(${l.requested_by})</span>` : ''}</td>
-            <td data-label="Status"><span class="tag${SYNC_TAG[l.status] ?? ''}">${l.status}</span></td>
-            <td class="num" data-label="Rows">${l.rows_fetched ?? ''}</td>
-            <td class="num" data-label="Inserted">${l.inserted ?? ''}</td>
-            <td class="num" data-label="Updated">${l.updated ?? ''}</td>
-            <td class="num" data-label="Deleted">${l.deleted ?? ''}</td>
-            <td data-label="Message">${l.message ?? ''}</td></tr>`)}
+            <td data-label="${tx('wsrc.requested')}">${when(l.requested_at)}</td>
+            <td data-label="${tx('wsrc.took')}">${l.finished_at && l.started_at ? `${((new Date(l.finished_at).getTime() - new Date(l.started_at).getTime()) / 1000).toFixed(1)} s` : '…'}</td>
+            <td data-label="${tx('wsrc.by')}">${l.trigger}${l.requested_by ? html` <span class="muted">(${l.requested_by})</span>` : ''}</td>
+            <td data-label="${tx('wsrc.status')}"><span class="tag${SYNC_TAG[l.status] ?? ''}">${l.status}</span></td>
+            <td class="num" data-label="${tx('wsrc.rows')}">${l.rows_fetched ?? ''}</td>
+            <td class="num" data-label="${tx('wsrc.inserted')}">${l.inserted ?? ''}</td>
+            <td class="num" data-label="${tx('wsrc.updated')}">${l.updated ?? ''}</td>
+            <td class="num" data-label="${tx('wsrc.deleted')}">${l.deleted ?? ''}</td>
+            <td data-label="${tx('wsrc.message')}">${l.message ?? ''}</td></tr>`)}
         </tbody></table></div>`
-      : html`<p class="muted">No runs yet.</p>`}
+      : html`<p class="muted">${tx('wsrc.no_runs_yet')}</p>`}
   </fieldset>`;
 }
 
@@ -231,13 +232,13 @@ function testExtras(appId: number, row: RestSource, s: Session) {
   }
   delete s.state[RESULT];
   const params = Array.isArray(row.params) ? row.params : [];
-  return html`<fieldset class="prop-group u-mt125"><legend>Test</legend>
+  return html`<fieldset class="prop-group u-mt125"><legend>${tx('wsrc.test')}</legend>
     <form method="post" action="${BASE}/apps/${appId}/rest-sources/${row.id}/test">${csrf(s)}
       ${params.length
         ? html`<div class="form-grid">${params.map((p) => html`<div class="field"><label class="label" for="rt_${p.name}">${p.name} <span class="muted">(${p.in})</span></label>
             <input id="rt_${p.name}" name="p_${p.name}" value="${p.default && !p.default.includes('&') ? p.default : ''}"></div>`)}</div>`
         : ''}
-      <div class="buttons"><button class="btn">Test</button></div>
+      <div class="buttons"><button class="btn">${tx('wsrc.test')}</button></div>
     </form>
     ${result
       ? html`<div class="alert ${result.ok ? 'alert-success' : 'alert-error'}" role="status">${result.message}</div>
@@ -247,11 +248,11 @@ function testExtras(appId: number, row: RestSource, s: Session) {
           : ''}
         ${result.suggested
           ? html`<form method="post" action="${BASE}/apps/${appId}/rest-sources/${row.id}/columns" class="u-mt1">${csrf(s)}
-              <label class="label" for="rt_cols">Suggested columns</label>
+              <label class="label" for="rt_cols">${tx('wsrc.suggested_columns')}</label>
               <textarea id="rt_cols" name="columns" class="code" rows="4" spellcheck="false">${result.suggested}</textarea>
-              <div class="buttons"><button class="btn">Use these columns</button></div></form>`
+              <div class="buttons"><button class="btn">${tx('wsrc.use_these_columns')}</button></div></form>`
           : ''}
-        ${result.excerpt ? html`<details class="u-mt1"><summary>Response</summary><pre class="source">${result.excerpt}</pre></details>` : ''}`
+        ${result.excerpt ? html`<details class="u-mt1"><summary>${tx('wsrc.response')}</summary><pre class="source">${result.excerpt}</pre></details>` : ''}`
       : ''}
   </fieldset>`;
 }
@@ -266,7 +267,7 @@ export async function webSourceRoutes(app: FastifyInstance) {
     // the column comes from the fixed list above, never from the request
     const r = await owner.query(`update meta.web_credential set ${what.column} = null${what.column === 'refresh_token_enc' ? ', token_refreshed_at = null' : ''} where id = $1 and app_id = $2`, [req.params.cid, req.params.id]);
     clearTokens(Number(req.params.cid));
-    flash(s, r.rowCount ? `${what.label[0].toUpperCase()}${what.label.slice(1)} was removed.` : 'Not found.', r.rowCount ? 'ok' : 'error');
+    flash(s, r.rowCount ? `${what.label[0].toUpperCase()}${what.label.slice(1)} was removed.` : tx('wsrc.not_found'), r.rowCount ? 'ok' : 'error');
     return back(reply, s, `${BASE}/apps/${req.params.id}/shared?c=web_credential-${req.params.cid}`);
   });
 
@@ -288,8 +289,8 @@ export async function webSourceRoutes(app: FastifyInstance) {
       const res = await call({ ...r, appId: src.app_id, what: `REST data source ${src.name} (builder test)`, credential, timeoutMs: src.timeout_s * 1000 });
       const text = res.body.toString('utf8');
       result.excerpt = text.length > 3000 ? `${text.slice(0, 3000)}…` : text;
-      if (res.status < 200 || res.status > 299) throw new Error(`The web service answered ${res.status}.`);
-      const body = parseJson(res, 'The source');
+      if (res.status < 200 || res.status > 299) throw new Error(tx('wsrc.answered', { status: res.status }));
+      const body = parseJson(res, tx('wsrc.the_source'));
       const { columns, rows, truncated } = toRows(body, { ...src, max_rows: Math.min(src.max_rows, 1000) });
       const selected = select(body, src.row_selector);
       const items = selected.length === 1 && Array.isArray(selected[0]) ? selected[0] : selected;
@@ -317,8 +318,8 @@ export async function webSourceRoutes(app: FastifyInstance) {
     if (!src) return reply.code(404).send('Not found');
     const r = await runSync(src.id, 'manual', { by: s.username ?? undefined });
     if (r.status === 'ok')
-      flash(s, `Synchronised ${r.rows} row(s): ${r.inserted} inserted, ${r.updated} updated, ${r.deleted} deleted.${r.message ? ` ${r.message}` : ''}`);
-    else flash(s, r.message ?? 'The synchronisation failed.', 'error');
+      flash(s, `${tx('wsrc.synced', { rows: r.rows, inserted: r.inserted, updated: r.updated, deleted: r.deleted })}${r.message ? ` ${r.message}` : ''}`);
+    else flash(s, r.message ?? tx('wsrc.the_synchronisation_failed'), 'error');
     return back(reply, s, `${BASE}/apps/${req.params.id}/shared?c=rest_source-${src.id}`);
   });
 
@@ -330,10 +331,10 @@ export async function webSourceRoutes(app: FastifyInstance) {
       const problems = sourceProblems({ url: 'https://x', params: [], columns: cols });
       if (problems.length) throw new Error(problems.join(' '));
       const r = await owner.query('update meta.rest_source set columns = $3 where id = $1 and app_id = $2', [req.params.sid, req.params.id, JSON.stringify(cols)]);
-      if (!r.rowCount) throw new Error('Not found.');
-      flash(s, 'Columns saved.');
+      if (!r.rowCount) throw new Error(tx('wsrc.not_found'));
+      flash(s, tx('wsrc.columns_saved'));
     } catch (e) {
-      flash(s, e instanceof SyntaxError ? 'The columns are not valid JSON.' : (e as Error).message, 'error');
+      flash(s, e instanceof SyntaxError ? tx('wsrc.the_columns_are_not_valid') : (e as Error).message, 'error');
     }
     return back(reply, s, `${BASE}/apps/${req.params.id}/shared?c=rest_source-${req.params.sid}`);
   });