@coworkee/airworks 0.0.1032 → 0.0.1033

package/dist/apps/admin/mail.d.ts

@@ -16,5 +16,7 @@ export declare const recipientListsApp: (coworkee: Coworkee) => CoworkeeApp;
 /** The mails the app sent or queued; opened from a campaign it shows that campaign's mails. */
 export declare const mailLogApp: (coworkee: Coworkee) => CoworkeeApp;
 export declare const mailSettingsApp: (coworkee: Coworkee) => CoworkeeApp;
-export declare const mailApps: ((coworkee: Coworkee) => CoworkeeApp)[];
+/** The template editor of the web client where the BFF knows it, the plain editor here otherwise. */
+export declare const mailTemplateEditorApp: import("../../coworkee.ts").AppFactory;
+export declare const mailApps: import("../../coworkee.ts").AppFactory[];
 export {};

package/dist/apps/admin/mail.js

@@ -3,6 +3,7 @@ import { display, errorText, esc } from "../../dom.js";
 import { confirmDialog, formDialog, infoDialog } from "../../form.js";
 import { icons } from "../../icons.js";
 import { settingsPageApp } from "../settings.js";
+import { embedOr } from "../web.js";
 import { userLookup } from "./identity.js";
 const mail = '/api/v1/mail';
 const json = (method, body) => ({ method, body: body === undefined ? undefined : JSON.stringify(body) });
@@ -253,4 +254,8 @@ export const mailSettingsApp = settingsPageApp({
         },
     },
 });
-export const mailApps = [mailTemplatesApp, mailTemplateApp, mailCampaignsApp, recipientListsApp, mailLogApp, mailSettingsApp];
+/** The template editor of the web client where the BFF knows it, the plain editor here otherwise. */
+export const mailTemplateEditorApp = embedOr({
+    id: 'coworkee.admin.mail-templates', group: 'Communication', title: 'Mail templates', icon: icons.drafts, accent: '#00838f', path: '/admin/mail/templates', requiredPermissions: ['Mail.Templates.Manage'],
+}, mailTemplatesApp);
+export const mailApps = [mailTemplateEditorApp, mailTemplateApp, mailCampaignsApp, recipientListsApp, mailLogApp, mailSettingsApp];

package/dist/apps/admin/system.d.ts

@@ -11,4 +11,8 @@ export declare const auditApp: (coworkee: Coworkee) => CoworkeeApp;
 export declare const aiToolCallsApp: (coworkee: Coworkee) => CoworkeeApp;
 /** The API documentation (Swagger UI) of the app in a window. */
 export declare const apiDocsApp: (coworkee: Coworkee) => CoworkeeApp;
-export declare const systemApps: ((coworkee: Coworkee) => CoworkeeApp)[];
+/** Elsa Studio is a host of its own that other origins may not frame: the app only leads into a browser tab. No one holds the permission without Coworkee.Workflows.Elsa. */
+export declare const workflowDesignerApp: (coworkee: Coworkee) => CoworkeeApp;
+/** The theme editor of the web client where the BFF knows it, the JSON form here otherwise. */
+export declare const themeEditorApp: import("../../coworkee.ts").AppFactory;
+export declare const systemApps: import("../../coworkee.ts").AppFactory[];

package/dist/apps/admin/system.js

@@ -4,6 +4,7 @@ import { esc } from "../../dom.js";
 import { confirmDialog, formDialog, infoDialog } from "../../form.js";
 import { icons } from "../../icons.js";
 import { recordAppId } from "../record.js";
+import { embedOr } from "../web.js";
 const json = (method, body) => ({ method, body: body === undefined ? undefined : JSON.stringify(body) });
 const check = (value) => value ? '✓' : '';
 const paged = (page, pageSize, extra = {}) => new URLSearchParams({ Page: String(page), PageSize: String(pageSize), ...Object.fromEntries(Object.entries(extra).filter(([, value]) => value)) });
@@ -267,4 +268,16 @@ export const apiDocsApp = (coworkee) => ({
     id: 'coworkee.api-docs', group: 'Monitoring', title: coworkee.t('API documentation'), icon: icons.dataObject, accent: '#447d1c', width: 1000, height: 680,
     requiredPermissions: ['ApiDocs.View'], url: '/swagger/index.html',
 });
-export const systemApps = [languagesApp, translationsApp, themesApp, backupsApp, servicesApp, editionsApp, tenantsApp, auditApp, aiToolCallsApp, apiDocsApp];
+/** Elsa Studio is a host of its own that other origins may not frame: the app only leads into a browser tab. No one holds the permission without Coworkee.Workflows.Elsa. */
+export const workflowDesignerApp = (coworkee) => ({
+    id: 'coworkee.admin.workflow-designer', group: 'System', title: coworkee.t('Workflow designer'), icon: icons.build, accent: '#2e7d32', width: 420, height: 200,
+    requiredPermissions: ['Workflows.Elsa.Manage'],
+    render: ({ host }) => {
+        host.classList.add('cw-host');
+        // the BFF of this page forwards the call with the user's token; the api answers with a redirect to the designer
+        host.innerHTML = `<div class="cw-app"><p><a class="cw-primary" href="/api/v1/workflows/elsa/studio" target="_blank" rel="noopener">${esc(coworkee.t('Open in a new tab'))} &#x2197;</a></p></div>`;
+    },
+});
+/** The theme editor of the web client where the BFF knows it, the JSON form here otherwise. */
+export const themeEditorApp = embedOr({ id: 'coworkee.admin.themes', group: 'System', title: 'Themes', icon: 'icon-palette.png', accent: '#c2185b', path: '/admin/themes', requiredPermissions: ['Themes.Manage'] }, themesApp);
+export const systemApps = [languagesApp, translationsApp, themeEditorApp, workflowDesignerApp, backupsApp, servicesApp, editionsApp, tenantsApp, auditApp, aiToolCallsApp, apiDocsApp];

package/dist/apps/record.d.ts

@@ -1,8 +1,10 @@
 import type { Coworkee, CoworkeeApp } from '../coworkee.ts';
 export declare const recordAppId = "coworkee.record";
+/** The record's page in the web client, as the global search links it (its own page or the list searched for it); undefined without a web client or a search of the set. */
+export declare function recordPage(coworkee: Coworkee, set: string, id: string): Promise<string | undefined>;
 /** Approves or rejects an approval with an optional comment; false when the user cancelled. */
 export declare function decide(coworkee: Coworkee, id: string, approve: boolean): Promise<boolean>;
 /** Renders one record of an OData entity set: its fields, its history with undo and restore, its workflow with steps and approvals. */
 export declare function renderRecord(coworkee: Coworkee, host: HTMLElement, set: string, id: string, onTitle?: (title: string) => void): () => void;
-/** One record in a window, opened from the records, the search, the inbox and the audit log with the intent { set, id }. */
+/** One record in a window, opened from the records, the search, the inbox and the audit log with the intent { set, id }; "Open in the web app" leads to its page there. */
 export declare const recordApp: (coworkee: Coworkee) => CoworkeeApp;

package/dist/apps/record.js

@@ -1,11 +1,19 @@
-import { literal, odataPage } from '@coworkee/client';
+import { ApiError, literal, odataPage } from '@coworkee/client';
 import { display, errorText, esc, humanize, isNoise, recordTitle } from "../dom.js";
 import { formDialog } from "../form.js";
 import { icons } from "../icons.js";
+import { openWebPage } from "./web.js";
 export const recordAppId = 'coworkee.record';
 const json = (method, body) => ({ method, body: body === undefined ? undefined : JSON.stringify(body) });
 const quietly = (load) => load.catch(() => undefined);
 const guid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** The record's page in the web client, as the global search links it (its own page or the list searched for it); undefined without a web client or a search of the set. */
+export async function recordPage(coworkee, set, id) {
+    if (!coworkee.user.appUrl || !guid.test(id))
+        return undefined;
+    const { hits } = await coworkee.request(`/api/v1/search?${new URLSearchParams({ q: id, limit: '5' })}`);
+    return hits.find((hit) => hit.entitySet === set && hit.id?.toLowerCase() === id.toLowerCase())?.url ?? undefined;
+}
 /** The record's fields for people: simple values in the user's format, images as images. */
 function fieldsHtml(coworkee, row) {
     const { t, culture } = coworkee;
@@ -60,16 +68,31 @@ export async function decide(coworkee, id, approve) {
     void coworkee.refreshBadges();
     return true;
 }
-/** Shows what a restore changes and runs it once the user agrees; false when cancelled. */
+/** Shows what a restore changes and runs it once the user agrees; false when cancelled. A record changed in between is previewed again. */
 async function restore(coworkee, set, id, request) {
-    const { t } = coworkee;
     const base = `/api/v1/history/${encodeURIComponent(set)}/${id}`;
-    const preview = await coworkee.request(`${base}/preview`, json('POST', request));
+    for (let changedMeanwhile = false;; changedMeanwhile = true) {
+        const preview = await coworkee.request(`${base}/preview`, json('POST', request));
+        if (!await confirmRestore(coworkee, preview, changedMeanwhile))
+            return false;
+        try {
+            await coworkee.request(`${base}/restore`, json('POST', { ...request, version: preview.version }));
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof ApiError) || error.status !== 409)
+                throw error;
+        }
+    }
+}
+function confirmRestore(coworkee, preview, changedMeanwhile) {
+    const { t } = coworkee;
     const changed = preview.fields.some((field) => field.changedLater);
-    const ok = await new Promise((resolve) => {
+    return new Promise((resolve) => {
         const dialog = document.createElement('dialog');
         dialog.className = 'cw-app cw-dialog cw-wide';
         dialog.innerHTML = `<form method="dialog"><h2>${esc(t('Restore'))}</h2><div class="cw-dialog-body">
+      ${changedMeanwhile ? `<p class="cw-note" data-changed-meanwhile>${esc(t('The record changed in the meantime. Check the new preview.'))}</p>` : ''}
       ${preview.undeletes ? `<p class="cw-note">${esc(t('The deleted record comes back.'))}</p>` : ''}
       ${changed ? `<p class="cw-note">${esc(t('Some of these fields were changed after this entry. The restore replaces the newer values.'))}</p>` : ''}
       <table class="cw-table"><thead><tr><th>${esc(t('Field'))}</th><th>${esc(t('Now'))}</th><th>${esc(t('After the restore'))}</th></tr></thead><tbody>
@@ -80,25 +103,28 @@ async function restore(coworkee, set, id, request) {
         dialog.addEventListener('close', () => { dialog.remove(); resolve(dialog.returnValue === 'ok'); });
         dialog.showModal();
     });
-    if (ok)
-        await coworkee.request(`${base}/restore`, json('POST', request));
-    return ok;
 }
 /** Renders one record of an OData entity set: its fields, its history with undo and restore, its workflow with steps and approvals. */
 export function renderRecord(coworkee, host, set, id, onTitle) {
     const { t } = coworkee;
-    host.innerHTML = `<div class="cw-record"><nav class="cw-tabs" role="tablist"></nav><section class="cw-panel"><p class="cw-muted">${esc(t('MudDataGrid_Loading'))}</p></section></div>`;
+    host.innerHTML = `<div class="cw-record"><div class="cw-toolbar" hidden><nav class="cw-tabs" role="tablist"></nav><span class="cw-spacer"></span>
+    <button data-web hidden>${esc(t('Open in the web app'))} &#x2197;</button></div><section class="cw-panel"><p class="cw-muted">${esc(t('MudDataGrid_Loading'))}</p></section></div>`;
+    const toolbar = host.querySelector('.cw-toolbar');
     const tabs = host.querySelector('nav');
+    const web = host.querySelector('[data-web]');
     const panel = host.querySelector('.cw-panel');
     let current = 'Details';
     let row;
     let history;
     let workflow;
+    let page;
     const show = (tab = current) => {
         current = tab;
         const available = [['Details', row], ['History', history], ['Workflow', workflow]].filter(([, data]) => data).map(([name]) => name);
         tabs.innerHTML = available.map((name) => `<button role="tab" data-tab="${name}" aria-selected="${name === current}">${esc(t(name))}</button>`).join('');
         tabs.hidden = available.length < 2;
+        web.hidden = !page;
+        toolbar.hidden = tabs.hidden && web.hidden;
         panel.innerHTML = current === 'History' && history ? historyHtml(coworkee, history)
             : current === 'Workflow' && workflow ? workflowHtml(coworkee, workflow)
                 : row ? fieldsHtml(coworkee, row)
@@ -107,10 +133,11 @@ export function renderRecord(coworkee, host, set, id, onTitle) {
     const load = async () => {
         try {
             const filter = guid.test(id) ? `Id eq ${id}` : `Id eq ${literal(id)}`;
-            [row, history, workflow] = await Promise.all([
+            [row, history, workflow, page] = await Promise.all([
                 quietly(odataPage(set, { filter, top: 1 }).then((page) => page.items[0])),
                 quietly(coworkee.request(`/api/v1/history/${encodeURIComponent(set)}/${id}`)),
                 quietly(coworkee.request(`/api/v1/workflows/${encodeURIComponent(set)}/${id}`)),
+                page ? Promise.resolve(page) : quietly(recordPage(coworkee, set, id)),
             ]);
             if (row)
                 onTitle?.(recordTitle(row));
@@ -138,6 +165,8 @@ export function renderRecord(coworkee, host, set, id, onTitle) {
         const { tab, restore: entryId, mode, property, transition, decide: approval, approve } = target.dataset;
         if (tab)
             show(tab);
+        else if (target === web && page)
+            openWebPage(coworkee, page, row ? recordTitle(row) : undefined);
         else if (entryId)
             void run(() => restore(coworkee, set, id, { entryId, mode: mode, property: property ?? null }));
         else if (approval)
@@ -157,7 +186,7 @@ export function renderRecord(coworkee, host, set, id, onTitle) {
     // steps and decisions of others arrive live
     return coworkee.realtime.subscribe(`workflow:${set}:${id}`, () => void load());
 }
-/** One record in a window, opened from the records, the search, the inbox and the audit log with the intent { set, id }. */
+/** One record in a window, opened from the records, the search, the inbox and the audit log with the intent { set, id }; "Open in the web app" leads to its page there. */
 export const recordApp = (coworkee) => ({
     id: recordAppId, title: coworkee.t('Details'), icon: icons.table, accent: '#167d79', width: 720, height: 620, hidden: true, probe: '/odata',
     render: ({ host, intent, onIntent, setTitle, setState, onClose }) => {

package/dist/apps/web.d.ts

@@ -1,4 +1,4 @@
-import type { Coworkee, CoworkeeApp } from '../coworkee.ts';
+import type { AppFactory, Coworkee, CoworkeeApp } from '../coworkee.ts';
 export declare const webPageAppId = "coworkee.web-page";
 /** The address of a page of the app's web client in the embedded shell (no app bar, no menu); undefined while the BFF does not know the web client. */
 export declare function embedUrl(appUrl: string | null | undefined, path: string): string | undefined;
@@ -6,7 +6,8 @@ export declare function embedUrl(appUrl: string | null | undefined, path: string
  * A page of the web client as a desktop app, e.g. embedApp({ id: "shop.orders", title: "Sales orders", path: "/sales/orders" }):
  * the Blazor page with all its tools (facets, query builder, history) in a window instead of a rebuild. Left out while the BFF does not know the web client.
  */
-export declare const embedApp: (options: {
+export declare const embedApp: (options: EmbedOptions) => (coworkee: Coworkee) => CoworkeeApp[];
+export type EmbedOptions = {
     id: string;
     title: string;
     path: string;
@@ -16,7 +17,9 @@ export declare const embedApp: (options: {
     height?: number;
     requiredPermissions?: string[];
     group?: string;
-}) => (coworkee: Coworkee) => CoworkeeApp[];
+};
+/** The page of the web client (the full editor) while the BFF knows the web client, otherwise the lighter app built here. */
+export declare const embedOr: (options: EmbedOptions, fallback: AppFactory) => AppFactory;
 /** Any page of the web client in a window, opened with the intent { path, title }: links of notifications and approvals. */
 export declare const webPageApp: (coworkee: Coworkee) => CoworkeeApp[];
 /** Opens a page of the web client (a local path like /catalog/products) in a window, or in a browser tab without the embedded shell. */

package/dist/apps/web.js

@@ -25,6 +25,8 @@ export const embedApp = (options) => (coworkee) => coworkee.user.appUrl ? [{
         width: options.width ?? 1100, height: options.height ?? 700, requiredPermissions: options.requiredPermissions, group: options.group,
         render: ({ host }) => frame(coworkee, host, options.path, coworkee.t(options.title)),
     }] : [];
+/** The page of the web client (the full editor) while the BFF knows the web client, otherwise the lighter app built here. */
+export const embedOr = (options, fallback) => (coworkee) => coworkee.user.appUrl ? embedApp(options)(coworkee) : fallback(coworkee);
 /** Any page of the web client in a window, opened with the intent { path, title }: links of notifications and approvals. */
 export const webPageApp = (coworkee) => coworkee.user.appUrl ? [{
         id: webPageAppId, title: coworkee.title, icon: icons.web, accent: '#35496b', width: 1100, height: 700, hidden: true,

package/dist/index.d.ts

@@ -9,9 +9,9 @@ export { choices, crudApp, renderCrud, type CrudAction, type CrudColumn, type Cr
 export { columnsOf, nextOrder, renderEntityTable, type Column, type EntityTableOptions } from './table.ts';
 export { changes, groupsFor, isEnabled, valuesOf } from './settings-model.ts';
 export { dataApp, entityApp, openRecord, type EntityAppOptions } from './apps/data.ts';
-export { decide, recordApp, recordAppId, renderRecord } from './apps/record.ts';
+export { decide, recordApp, recordAppId, recordPage, renderRecord } from './apps/record.ts';
 export { inboxApp, inboxAppId } from './apps/inbox.ts';
-export { embedApp, embedUrl, openWebPage, webPageApp, webPageAppId } from './apps/web.ts';
+export { embedApp, embedOr, embedUrl, openWebPage, webPageApp, webPageAppId, type EmbedOptions } from './apps/web.ts';
 export { filePreviewApp, filePreviewAppId } from './apps/file-preview.ts';
 export { fileContentUrl, filesApp, uploadFile } from './apps/files.ts';
 export { renderProfile } from './apps/profile.ts';

package/dist/index.js

@@ -19,9 +19,9 @@ export { choices, crudApp, renderCrud } from "./crud.js";
 export { columnsOf, nextOrder, renderEntityTable } from "./table.js";
 export { changes, groupsFor, isEnabled, valuesOf } from "./settings-model.js";
 export { dataApp, entityApp, openRecord } from "./apps/data.js";
-export { decide, recordApp, recordAppId, renderRecord } from "./apps/record.js";
+export { decide, recordApp, recordAppId, recordPage, renderRecord } from "./apps/record.js";
 export { inboxApp, inboxAppId } from "./apps/inbox.js";
-export { embedApp, embedUrl, openWebPage, webPageApp, webPageAppId } from "./apps/web.js";
+export { embedApp, embedOr, embedUrl, openWebPage, webPageApp, webPageAppId } from "./apps/web.js";
 export { filePreviewApp, filePreviewAppId } from "./apps/file-preview.js";
 export { fileContentUrl, filesApp, uploadFile } from "./apps/files.js";
 export { renderProfile } from "./apps/profile.js";

package/dist/style.css

@@ -193,7 +193,7 @@ dialog.cw-dialog h2 { margin: 0 0 10px; font-size: 18px; }
 
 /* inbox */
 .cw-inbox { display: flex; flex-direction: column; }
-.cw-inbox .cw-toolbar .cw-tabs { margin: 0; border: 0; }
+.cw-inbox .cw-toolbar .cw-tabs, .cw-record .cw-toolbar .cw-tabs { margin: 0; border: 0; }
 .cw-inbox .cw-feed { flex: 1; overflow: auto; }
 .cw-inbox .cw-feed li { align-items: center; padding: 10px 4px; }
 .cw-decide { display: flex; gap: 6px; flex: none; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coworkee/airworks",
-  "version": "0.0.1032",
+  "version": "0.0.1033",
   "description": "AirWorks web desktop for Coworkee apps: sign-in through the app's BFF, theme, texts, realtime and apps for settings, files, data, chat, reports, the assistant and the administration",
   "license": "MIT",
   "homepage": "https://fgilde.github.io/CoworkeeLib/web/airworks/",
@@ -35,17 +35,18 @@
     "*.css"
   ],
   "scripts": {
+    "prebuild": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "tsc -p tsconfig.json && node -e \"for (const f of ['style.css','mudex-frame.html']) require('node:fs').copyFileSync('src/'+f,'dist/'+f)\"",
     "test": "node --test \"test/**/*.test.ts\""
   },
   "dependencies": {
-    "@coworkee/client": "0.0.1032"
+    "@coworkee/client": "0.0.1033"
   },
   "peerDependencies": {
     "@fgilde/airworks": ">=0.4.0"
   },
   "devDependencies": {
-    "@fgilde/airworks": "git+https://github.com/fgilde/AirWorks.git#d295c659dc4267a05f8d2a530fda5861fb5d8120",
+    "@fgilde/airworks": "git+https://github.com/fgilde/AirWorks.git#12e8507b22f11f99bba2c093fb81f617e751ff1f",
     "typescript": "^5.9.3"
   }
 }