@aalis/plugin-webui-server 0.14.1 → 0.15.0

package/dist/page-check.js

@@ -0,0 +1,369 @@
+// ============================================================
+// page-check.ts — 页面登记时的质量门槛
+//
+// 插件交来的页面声明在登记时整份核一遍，不过就不登记：content（声明式）与 frame（插件前端）恰好一个；不认识的字段一律
+// 拒收（旧写法的 refresh、danger、source 等在这里就被拦下）。
+// 声明式页面：一屏最多 MAX_SCREEN_COMPONENTS 个组件、最多 MAX_PAGE_TABS 个标签；标签页只在最外层，详情里的组件不再带
+// 详情；组件 id 在页面内唯一；引用的动作都存在，且行动作只放在表格行上与详情里、页面动作只放在最外层与标签里。核过的
+// 声明原样经 JSON 下发给界面，函数随序列化去掉。
+// 插件前端页面：只放在 plugin 或 session；frame 只认 module、entry、host，入口是 webui/ 里的 .html 相对路径，能力在词表
+// 里、不重复；数据源各有 data 与合法的输入字段表；动作不带 row；数据源名与动作名不超过消息里名字的长度上限。要读文件系统
+// 的几条（包根、webui/、入口文件）在 pages.ts。
+// ============================================================
+import { FRAME_HOST_CAPABILITIES, FRAME_NAME_MAX_LENGTH, MAX_PAGE_TABS, MAX_SCREEN_COMPONENTS, } from '@aalis/api-webui';
+const PLACEMENTS = new Set(['plugin', 'settings', 'session']);
+const CAPABILITIES = new Set(FRAME_HOST_CAPABILITIES);
+const EFFECTS = new Set(['read', 'write', 'destructive']);
+const CELL_KINDS = new Set([
+    'text',
+    'time',
+    'countdown',
+    'link',
+    'status',
+    'code',
+    'long-text',
+    'image',
+    'file',
+]);
+/** lucide 图标名：小写字母、数字与连字符。内联 SVG 一类的标记在这里就被拒 */
+const ICON_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** 插件前端的入口：webui/ 里以 .html 结尾的相对路径，按 / 分段，每段非空、不以点开头、不含反斜杠 */
+const ENTRY = /^(?:[^/\\.][^/\\]*\/)*[^/\\.][^/\\]*\.html$/;
+const COMMON_KEYS = ['type', 'label', 'description'];
+const COMPONENT_KEYS = {
+    table: [...COMMON_KEYS, 'id', 'rowKey', 'columns', 'empty', 'rowActions', 'detail', 'data'],
+    graph: [...COMMON_KEYS, 'id', 'empty', 'nodeKinds', 'edgeKinds', 'spacing', 'detail', 'data'],
+    info: [...COMMON_KEYS, 'id', 'data'],
+    markdown: [...COMMON_KEYS, 'id', 'data'],
+    actions: [...COMMON_KEYS, 'actions'],
+};
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isText = (value) => typeof value === 'string' && value.trim() !== '';
+/** 核一份页面声明：过了回分派用的索引，不过回全部问题（每条带位置） */
+export function checkPage(page) {
+    const problems = [];
+    const fail = (path, message) => {
+        problems.push(path ? `${path}：${message}` : message);
+    };
+    const strict = (value, allowed, path) => {
+        for (const key of Object.keys(value))
+            if (!allowed.includes(key))
+                fail(path ? `${path}.${key}` : key, '不认识的字段');
+    };
+    const optionalText = (value, path) => {
+        if (value !== undefined && typeof value !== 'string')
+            fail(path, '要是字符串');
+    };
+    /** 动作与数据源的输入：非空的字段表，每个字段带 type 与 label */
+    const inputFields = (value, path) => {
+        if (value === undefined)
+            return;
+        if (!isRecord(value) || Object.keys(value).length === 0)
+            return fail(path, '要是非空的字段表');
+        for (const [key, field] of Object.entries(value)) {
+            if (!isRecord(field) || !isText(field.type) || !isText(field.label)) {
+                fail(`${path}.${key}`, '要是带 type 与 label 的配置字段');
+            }
+        }
+    };
+    if (!isRecord(page))
+        return { ok: false, problems: ['页面声明不是对象'] };
+    strict(page, ['key', 'title', 'icon', 'placement', 'order', 'applies', 'content', 'frame', 'sources', 'actions'], '');
+    const isFrame = page.frame !== undefined;
+    if (isFrame === (page.content !== undefined)) {
+        fail('content', '与 frame 恰好写一个（声明式页面写 content，插件前端写 frame）');
+    }
+    if (!isText(page.key))
+        fail('key', '要是非空字符串');
+    if (!isText(page.title))
+        fail('title', '要是非空字符串');
+    if (page.icon !== undefined && !(typeof page.icon === 'string' && ICON_NAME.test(page.icon))) {
+        fail('icon', '只收 lucide 图标名（小写字母、数字与连字符）');
+    }
+    const placement = (page.placement ?? 'plugin');
+    if (!PLACEMENTS.has(placement))
+        fail('placement', '只有 plugin、settings、session');
+    else if (isFrame && placement === 'settings')
+        fail('placement', '插件前端只放在 plugin 或 session');
+    if (page.order !== undefined && !Number.isFinite(page.order))
+        fail('order', '要是有限的数');
+    if (page.applies !== undefined) {
+        if (typeof page.applies !== 'function')
+            fail('applies', '要是函数');
+        else if (placement !== 'session')
+            fail('applies', '只给会话面板（placement 为 session）');
+    }
+    const actions = new Map();
+    if (page.actions !== undefined && !isRecord(page.actions))
+        fail('actions', '要是对象');
+    for (const [name, action] of Object.entries(isRecord(page.actions) ? page.actions : {})) {
+        const path = `actions.${name}`;
+        if (!isRecord(action)) {
+            fail(path, '要是对象');
+            continue;
+        }
+        if (isFrame && name.length > FRAME_NAME_MAX_LENGTH) {
+            fail('actions', `插件前端的动作名最多 ${FRAME_NAME_MAX_LENGTH} 个字符（插件前端发不出更长的名字）`);
+        }
+        strict(action, ['label', 'effect', 'confirm', 'input', 'row', 'handler'], path);
+        if (!isText(action.label))
+            fail(`${path}.label`, '要是非空字符串');
+        if (!EFFECTS.has(action.effect))
+            fail(`${path}.effect`, '只有 read、write、destructive');
+        if (action.confirm !== undefined) {
+            if (action.effect !== 'destructive')
+                fail(`${path}.confirm`, '确认文案只给 destructive 的动作');
+            else if (!isText(action.confirm))
+                fail(`${path}.confirm`, '要是非空字符串');
+        }
+        inputFields(action.input, `${path}.input`);
+        if (action.row !== undefined) {
+            if (isFrame)
+                fail(`${path}.row`, '插件前端的动作不带 row，要指定对象就放进 input');
+            else if (typeof action.row !== 'boolean')
+                fail(`${path}.row`, '要是布尔值');
+        }
+        if (typeof action.handler !== 'function')
+            fail(`${path}.handler`, '要是函数');
+        actions.set(name, action);
+    }
+    if (isFrame) {
+        const frame = page.frame;
+        if (!isRecord(frame))
+            fail('frame', '要是对象');
+        else {
+            strict(frame, ['module', 'entry', 'host'], 'frame');
+            if (!isText(frame.module))
+                fail('frame.module', '要是非空字符串（写 import.meta.url）');
+            if (frame.entry !== undefined && !(typeof frame.entry === 'string' && ENTRY.test(frame.entry))) {
+                fail('frame.entry', '只许 webui/ 里以 .html 结尾的相对路径：不以 / 开头，各段非空、不以点开头，不含反斜杠');
+            }
+            const host = frame.host === undefined ? [] : frame.host;
+            if (!Array.isArray(host))
+                fail('frame.host', '要是数组');
+            else
+                for (const [i, capability] of host.entries()) {
+                    if (!CAPABILITIES.has(capability)) {
+                        fail(`frame.host[${i}]`, `不认识的能力 ${String(capability)}（只有 ${FRAME_HOST_CAPABILITIES.join('、')}）`);
+                    }
+                    else if (host.indexOf(capability) !== i)
+                        fail(`frame.host[${i}]`, `能力 ${capability} 重复`);
+                }
+        }
+        const sources = new Map();
+        if (page.sources !== undefined && !isRecord(page.sources))
+            fail('sources', '要是对象');
+        for (const [name, source] of Object.entries(isRecord(page.sources) ? page.sources : {})) {
+            const path = `sources.${name}`;
+            if (!isText(name)) {
+                fail('sources', '数据源的名字要非空');
+                continue;
+            }
+            if (name.length > FRAME_NAME_MAX_LENGTH) {
+                fail('sources', `数据源的名字最多 ${FRAME_NAME_MAX_LENGTH} 个字符（插件前端发不出更长的名字）`);
+                continue;
+            }
+            if (!isRecord(source)) {
+                fail(path, '要是对象');
+                continue;
+            }
+            strict(source, ['input', 'data'], path);
+            if (typeof source.data !== 'function')
+                fail(`${path}.data`, '要是函数');
+            inputFields(source.input, `${path}.input`);
+            sources.set(name, source);
+        }
+        if (problems.length > 0)
+            return { ok: false, problems };
+        const { module, entry = 'index.html', host = [] } = frame;
+        return { ok: true, page: { kind: 'frame', placement, actions, sources, frame: { module, entry, host } } };
+    }
+    if (page.sources !== undefined)
+        fail('sources', '只给插件前端（写了 frame 的页面）');
+    const sources = new Map();
+    const referenced = (name, path, row) => {
+        const action = typeof name === 'string' ? actions.get(name) : undefined;
+        if (!action)
+            fail(path, `引用的动作 ${String(name)} 没有声明`);
+        else if ((action.row === true) !== row) {
+            fail(path, row
+                ? `${name} 不是行动作（row: true），不能放在表格行上或详情里`
+                : `${name} 是行动作，只能放在表格行上或详情里`);
+        }
+    };
+    const kinds = (value, path) => {
+        if (value === undefined)
+            return;
+        if (!Array.isArray(value))
+            return fail(path, '要是数组');
+        const seen = new Set();
+        for (const [i, kind] of value.entries()) {
+            const at = `${path}[${i}]`;
+            if (!isRecord(kind)) {
+                fail(at, '要是对象');
+                continue;
+            }
+            strict(kind, ['kind', 'label', 'tone'], at);
+            if (!isText(kind.kind) || seen.has(kind.kind))
+                fail(`${at}.kind`, '要是不重复的非空字符串');
+            seen.add(kind.kind);
+            if (!isText(kind.label))
+                fail(`${at}.label`, '要是非空字符串');
+            if (!Number.isInteger(kind.tone) || kind.tone < 1 || kind.tone > 6) {
+                fail(`${at}.tone`, '只有 1 到 6');
+            }
+        }
+    };
+    const component = (value, path, inDetail) => {
+        if (!isRecord(value))
+            return fail(path, '组件要是对象');
+        const allowed = COMPONENT_KEYS[value.type];
+        if (!allowed)
+            return fail(`${path}.type`, `不认识的组件 ${String(value.type)}（只有 table、graph、info、markdown、actions）`);
+        strict(value, allowed, path);
+        optionalText(value.label, `${path}.label`);
+        optionalText(value.description, `${path}.description`);
+        if (value.type === 'actions') {
+            if (!Array.isArray(value.actions) || value.actions.length === 0)
+                return fail(`${path}.actions`, '要是非空数组');
+            for (const [i, name] of value.actions.entries())
+                referenced(name, `${path}.actions[${i}]`, inDetail);
+            return;
+        }
+        if (!isText(value.id))
+            fail(`${path}.id`, '要是非空字符串');
+        else if (sources.has(value.id))
+            fail(`${path}.id`, `组件 id ${value.id} 重复`);
+        else
+            sources.set(value.id, { component: value, inDetail });
+        if (typeof value.data !== 'function')
+            fail(`${path}.data`, '要是函数');
+        if (value.type === 'table') {
+            if (!isText(value.rowKey))
+                fail(`${path}.rowKey`, '要是非空字符串');
+            optionalText(value.empty, `${path}.empty`);
+            if (!Array.isArray(value.columns) || value.columns.length === 0)
+                fail(`${path}.columns`, '要是非空数组');
+            else {
+                const keys = new Set();
+                for (const [i, column] of value.columns.entries()) {
+                    const at = `${path}.columns[${i}]`;
+                    if (!isRecord(column)) {
+                        fail(at, '要是对象');
+                        continue;
+                    }
+                    strict(column, ['key', 'label', 'kind', 'primary'], at);
+                    if (!isText(column.key) || keys.has(column.key))
+                        fail(`${at}.key`, '要是不重复的非空字符串');
+                    keys.add(column.key);
+                    if (!isText(column.label))
+                        fail(`${at}.label`, '要是非空字符串');
+                    if (column.kind !== undefined && !CELL_KINDS.has(column.kind))
+                        fail(`${at}.kind`, '不认识的显示种类');
+                    if (column.primary !== undefined && typeof column.primary !== 'boolean')
+                        fail(`${at}.primary`, '要是布尔值');
+                }
+            }
+            if (value.rowActions !== undefined) {
+                if (!Array.isArray(value.rowActions))
+                    fail(`${path}.rowActions`, '要是数组');
+                else
+                    for (const [i, entry] of value.rowActions.entries()) {
+                        const at = `${path}.rowActions[${i}]`;
+                        if (!isRecord(entry)) {
+                            fail(at, '要是对象');
+                            continue;
+                        }
+                        strict(entry, ['action', 'visibleWhen'], at);
+                        referenced(entry.action, `${at}.action`, true);
+                        if (entry.visibleWhen !== undefined && !isText(entry.visibleWhen)) {
+                            fail(`${at}.visibleWhen`, '要是行字段名');
+                        }
+                    }
+            }
+        }
+        else if (value.type === 'graph') {
+            optionalText(value.empty, `${path}.empty`);
+            kinds(value.nodeKinds, `${path}.nodeKinds`);
+            kinds(value.edgeKinds, `${path}.edgeKinds`);
+            if (value.spacing !== undefined && !(Number.isFinite(value.spacing) && value.spacing > 0)) {
+                fail(`${path}.spacing`, '要是正数');
+            }
+        }
+        if (value.detail !== undefined) {
+            if (inDetail)
+                fail(`${path}.detail`, '详情里的组件不能再带详情');
+            else
+                screen(value.detail, `${path}.detail`, true);
+        }
+    };
+    const screen = (value, path, inDetail) => {
+        if (!Array.isArray(value) || value.length === 0)
+            return fail(path, '要是非空的组件数组');
+        if (value.length > MAX_SCREEN_COMPONENTS) {
+            fail(path, `一屏最多 ${MAX_SCREEN_COMPONENTS} 个组件，现在 ${value.length} 个`);
+        }
+        for (const [i, item] of value.entries())
+            component(item, `${path}[${i}]`, inDetail);
+    };
+    if (Array.isArray(page.content))
+        screen(page.content, 'content', false);
+    else if (isRecord(page.content) && Array.isArray(page.content.tabs)) {
+        strict(page.content, ['tabs'], 'content');
+        const tabs = page.content.tabs;
+        if (tabs.length === 0 || tabs.length > MAX_PAGE_TABS) {
+            fail('content.tabs', `要有 1 到 ${MAX_PAGE_TABS} 个标签，现在 ${tabs.length} 个`);
+        }
+        const keys = new Set();
+        for (const [i, tab] of tabs.entries()) {
+            const at = `content.tabs[${i}]`;
+            if (!isRecord(tab)) {
+                fail(at, '要是对象');
+                continue;
+            }
+            strict(tab, ['key', 'title', 'content'], at);
+            if (!isText(tab.key) || keys.has(tab.key))
+                fail(`${at}.key`, '要是不重复的非空字符串');
+            keys.add(tab.key);
+            if (!isText(tab.title))
+                fail(`${at}.title`, '要是非空字符串');
+            screen(tab.content, `${at}.content`, false);
+        }
+    }
+    else if (page.content !== undefined)
+        fail('content', '要是组件数组或 { tabs }');
+    return problems.length > 0
+        ? { ok: false, problems }
+        : { ok: true, page: { kind: 'declarative', placement, actions, sources } };
+}
+/**
+ * 核一条提示：open 指向的页面要是本实例已登记、位置为 plugin 或 settings 的页面。placementOf 按页面 key 取本实例页面的位置
+ */
+export function checkNotice(notice, placementOf) {
+    const problems = [];
+    const fail = (path, message) => problems.push(`${path}：${message}`);
+    if (!isRecord(notice))
+        return ['提示不是对象'];
+    for (const key of Object.keys(notice)) {
+        if (!['id', 'level', 'title', 'detail', 'open'].includes(key))
+            fail(key, '不认识的字段');
+    }
+    if (!isText(notice.id))
+        fail('id', '要是非空字符串');
+    if (notice.level !== 'action' && notice.level !== 'error')
+        fail('level', '只有 action、error');
+    if (!isText(notice.title))
+        fail('title', '要是非空字符串');
+    if (notice.detail !== undefined && typeof notice.detail !== 'string')
+        fail('detail', '要是字符串');
+    const open = notice.open;
+    if (open !== undefined && open !== 'config') {
+        const page = isRecord(open) && Object.keys(open).length === 1 ? open.page : undefined;
+        const placement = isText(page) ? placementOf(page) : undefined;
+        if (placement !== 'plugin' && placement !== 'settings') {
+            fail('open', '只收 config，或本插件已登记、位置为 plugin 或 settings 的页面 { page }');
+        }
+    }
+    return problems;
+}
+//# sourceMappingURL=page-check.js.map

package/dist/page-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-check.js","sourceRoot":"","sources":["../src/page-check.ts"],"names":[],"mappings":"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"}

package/dist/page-files.d.ts

@@ -0,0 +1,13 @@
+import { type StorageRootInfo } from '@aalis/api-storage';
+/** roots 现取存储服务的根表：签发时按地址的根名查它的种类 */
+export declare function createPageFiles(roots: () => StorageRootInfo[]): {
+    /** 签发句柄；不是存储地址、根不认识或在不签发的根里时回 undefined */
+    sign(uri: string, name: string): string | undefined;
+    /** 核验句柄：是本插件这次激活签发的，回存储地址与文件名，否则回 undefined */
+    resolve(handle: string): {
+        uri: string;
+        name: string;
+    } | undefined;
+};
+export type PageFiles = ReturnType<typeof createPageFiles>;
+//# sourceMappingURL=page-files.d.ts.map

package/dist/page-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-files.d.ts","sourceRoot":"","sources":["../src/page-files.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE9E,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,eAAe,EAAE;IAK1D,2CAA2C;cACjC,MAAM,QAAQ,MAAM,GAAG,MAAM,GAAG,SAAS;IAMnD,+CAA+C;oBAC/B,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;EAWrE;AAED,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/page-files.js

@@ -0,0 +1,39 @@
+// ============================================================
+// page-files.ts — 页面单元格里的文件句柄
+//
+// 文件单元格的值是存储地址，下发给界面之前换成本插件签发的句柄，界面凭句柄经 GET /api/page-file 下载，不开按存储地址任意读取的路由。
+// 句柄是「载荷.签名」两段 base64url：载荷是存储地址与文件名，签名是密钥对载荷的 HMAC-SHA256。用签名而不用服务端的表：
+// 页面重新取数多少次，内存都不随之增长。密钥每次激活随机生成，本插件重载后旧句柄失效，界面重新取数就拿到新的。
+// 签不签发与会话条目的句柄同一条规则（api-storage 的 canIssueFileHandle）。会话条目的句柄由会话服务签发、绑定会话；
+// 页面的文件不属于哪个会话，会话服务也可能没启用，所以由本插件另设签发器。
+// ============================================================
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { canIssueFileHandle } from '@aalis/api-storage';
+/** roots 现取存储服务的根表：签发时按地址的根名查它的种类 */
+export function createPageFiles(roots) {
+    const key = crypto.getRandomValues(new Uint8Array(32));
+    const signature = (payload) => createHmac('sha256', key).update(payload).digest();
+    return {
+        /** 签发句柄；不是存储地址、根不认识或在不签发的根里时回 undefined */
+        sign(uri, name) {
+            if (!canIssueFileHandle(roots(), uri))
+                return undefined;
+            const payload = Buffer.from(JSON.stringify([uri, name])).toString('base64url');
+            return `${payload}.${signature(payload).toString('base64url')}`;
+        },
+        /** 核验句柄：是本插件这次激活签发的，回存储地址与文件名，否则回 undefined */
+        resolve(handle) {
+            const parts = /^([\w-]+)\.([\w-]+)$/.exec(handle);
+            if (!parts)
+                return undefined;
+            const [, payload, given] = parts;
+            const expected = signature(payload);
+            const actual = Buffer.from(given, 'base64url');
+            if (actual.length !== expected.length || !timingSafeEqual(actual, expected))
+                return undefined;
+            const [uri, name] = JSON.parse(Buffer.from(payload, 'base64url').toString());
+            return { uri, name };
+        },
+    };
+}
+//# sourceMappingURL=page-files.js.map

package/dist/page-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-files.js","sourceRoot":"","sources":["../src/page-files.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8BAA8B;AAC9B,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,yDAAyD;AACzD,2EAA2E;AAC3E,uCAAuC;AACvC,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAwB,MAAM,oBAAoB,CAAC;AAE9E,qCAAqC;AACrC,MAAM,UAAU,eAAe,CAAC,KAA8B;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;IAE1F,OAAO;QACL,2CAA2C;QAC3C,IAAI,CAAC,GAAW,EAAE,IAAY;YAC5B,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC/E,OAAO,GAAG,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAClE,CAAC;QAED,+CAA+C;QAC/C,OAAO,CAAC,MAAc;YACpB,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7B,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;YACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC9F,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,EAAE,CAAqB,CAAC;YACjG,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/pages.d.ts

@@ -0,0 +1,60 @@
+import type { UserIdentity } from '@aalis/api-authority';
+import type { SessionManagerService } from '@aalis/api-session-manager';
+import type { ErrorResponse, FrameDataResponse, Notice, PageActionResponse, PageDataResponse, PageDefinition, PageRef, PageView, PanelPagesResponse, WebuiAdminEvent } from '@aalis/api-webui';
+import type { Logger, ServiceSelection } from '@aalis/core';
+/** invalidate 的合并窗口：同一实例、页面、组件与会话一秒内最多推一次，窗口里再来的并成窗口结束时的一次 */
+export declare const INVALIDATE_WINDOW_MS = 1000;
+/** 会话面板的 applies 最多等这么久，超时按不适用处理 */
+export declare const APPLIES_TIMEOUT_MS = 2000;
+interface PageRegistryDeps {
+    logger: Logger;
+    /** 推管理面事件 */
+    send(event: WebuiAdminEvent): void;
+    /** 会话管理：会话面板核会话存在、取会话种类 */
+    sessions: Pick<ServiceSelection<Pick<SessionManagerService, 'getSession'>>, 'present' | 'use'>;
+    /** 文件单元格的存储地址换成下载句柄；不能签发时回 undefined */
+    signFile(uri: string, name: string): string | undefined;
+}
+/** 回给路由的结果：状态码与回应，失败时回应是 ErrorResponse */
+export interface Reply<T> {
+    status: number;
+    body: T | ErrorResponse;
+}
+/** relative 按 realpath 落在 dir（本身是 realpath）之内时回它的 realpath；不存在或越界（含指向外面的符号链接）回 undefined */
+export declare function realWithin(dir: string, relative: string): string | undefined;
+export declare function createPageRegistry(deps: PageRegistryDeps): {
+    addPage(definition: PageDefinition, instance: string): () => void;
+    addNotice(notice: Notice, instance: string): () => void;
+    /** 登记着的提示，带所属实例 */
+    notices: () => {
+        id: string;
+        level: "action" | "error";
+        title: string;
+        detail?: string;
+        open?: "config" | {
+            page: string;
+        };
+        instance: string;
+    }[];
+    invalidate: (instance: string, pageKey: string, componentId?: string, sessionId?: string) => void;
+    /** 页面的位置；没登记的回 undefined */
+    placementOf: (ref: PageRef) => import("@aalis/api-webui").PagePlacement | undefined;
+    /** GET /api/pages：声明式页面的声明经 JSON 下发时函数随之去掉；插件前端页面按字段组装，不带模块、入口与数据源 */
+    views: () => PageView[];
+    /** 插件前端的 webui/ 目录：token 是这一次登记的；页面撤回或重新登记后旧的找不到 */
+    frameDir: (token: string) => string | undefined;
+    /** 这个会话适用的会话面板页面，按页面的先后 */
+    panelPages: (sessionId: unknown) => Promise<Reply<PanelPagesResponse>>;
+    /**
+     * 取一个组件的数据；query 只收 sessionId（会话面板）与 rowKey（详情里的组件）。插件前端页面的 componentId 是数据源名，
+     * query 只收 sessionId（会话面板）与 input（声明了输入的数据源）
+     */
+    data: (instance: string, pageKey: string, componentId: string, query: Record<string, unknown>, caller: UserIdentity) => Promise<Reply<PageDataResponse | FrameDataResponse>>;
+    /** 调一个动作；body 只收 sessionId（会话面板）、rowKey（行动作）与 input（声明了输入的动作） */
+    act: (instance: string, pageKey: string, name: string, body: unknown, caller: UserIdentity, from: string) => Promise<Reply<PageActionResponse>>;
+    /** 停用时清掉合并窗口的计时器 */
+    dispose(): void;
+};
+export type PageRegistry = ReturnType<typeof createPageRegistry>;
+export {};
+//# sourceMappingURL=pages.d.ts.map

package/dist/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../src/pages.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,KAAK,EAGV,aAAa,EAEb,iBAAiB,EAEjB,MAAM,EACN,kBAAkB,EAElB,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,QAAQ,EACR,kBAAkB,EAIlB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAW5D,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa;IACb,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IAC/F,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACzD;AAED,0CAA0C;AAC1C,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC;CACzB;AAsCD,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5E;AA2CD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB;wBA6NjC,cAAc,YAAY,MAAM,GAAG,MAAM,IAAI;sBA8B/C,MAAM,YAAY,MAAM,GAAG,MAAM,IAAI;IAmBvD,mBAAmB;;;;;;;;;;;2BAlGS,MAAM,WAAW,MAAM,gBAAgB,MAAM,cAAc,MAAM,KAAG,IAAI;IAuGpG,4BAA4B;uBACT,OAAO;IAE1B,sEAAsE;iBAC3D,QAAQ,EAAE;IAoBrB,oDAAoD;sBAClC,MAAM,KAAG,MAAM,GAAG,SAAS;IAG7C,2BAA2B;4BACH,OAAO,KAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAYpE;;;OAGG;qBAES,MAAM,WACP,MAAM,eACF,MAAM,SACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACtB,YAAY,KACnB,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,iBAAiB,CAAC,CAAC;IA6BvD,iEAAiE;oBAErD,MAAM,WACP,MAAM,QACT,MAAM,QACN,OAAO,UACL,YAAY,QACd,MAAM,KACX,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAyBrC,oBAAoB;eACT,IAAI;EAKlB;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC"}