@shiqianjiang/ceru-plugin-cli 0.2.6 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -0
- package/assets/core-contracts.js +1 -1
- package/assets/index.html +94 -94
- package/assets/playground.js +59 -11
- package/assets/sandbox.js +21 -21
- package/dist/dev.js +7 -13
- package/dist/storage.d.ts +12 -0
- package/dist/storage.js +65 -0
- package/package.json +71 -71
- package/schemas/config.schema.json +131 -0
- package/templates/connected-library/js/package.json +22 -22
- package/templates/connected-library/ts/package.json +22 -22
- package/templates/guest-adapter/js/package.json +22 -22
- package/templates/guest-adapter/ts/package.json +22 -22
- package/templates/importer/js/package.json +22 -22
- package/templates/importer/ts/package.json +22 -22
- package/templates/react/js/package.json +26 -26
- package/templates/react/ts/package.json +26 -26
- package/templates/snapshot.json +1 -1
- package/templates/source/js/package.json +22 -22
- package/templates/source/ts/package.json +22 -22
- package/templates/vue/js/package.json +23 -23
- package/templates/vue/ts/package.json +23 -23
- package/templates/vue-tsx/js/package.json +23 -23
- package/templates/vue-tsx/ts/package.json +23 -23
- package/templates/web-dist/js/package.json +22 -22
- package/templates/web-dist/ts/package.json +22 -22
- package/templates/web-surface/js/ceru.plugin.json +31 -2
- package/templates/web-surface/js/package.json +22 -22
- package/templates/web-surface/js/src/index.js +7 -0
- package/templates/web-surface/ts/ceru.plugin.json +31 -2
- package/templates/web-surface/ts/package.json +22 -22
- package/templates/web-surface/ts/src/index.ts +7 -0
package/README.md
CHANGED
|
@@ -12,6 +12,12 @@ npm run build
|
|
|
12
12
|
|
|
13
13
|
Dev 启动独立 Electron 工作台,实际执行插件并支持 TS 源码断点、日志、搜索/解析、页面预览、权限模拟和宿主资源。VS Code 配置由脚手架生成。
|
|
14
14
|
|
|
15
|
+
0.3.1 的播放解析结果可返回 `requestHeaders`。适用于要求 `Referer`、`Origin`、`User-Agent` 或认证头的临时媒体 URL;这些值由 Host 按完整 URL 注入,不应写入页面状态、日志或分享数据。
|
|
16
|
+
|
|
17
|
+
0.3.0 的 `web-surface` 模板包含通用页面生命周期示例。`modules.surfaces[]` 可声明 `title`、`presentation: { kind: 'drawer', placement: 'right', size: 480 }` 和 `lifecycle: { openAction: 'page.open', closeAction: 'page.close' }`。生命周期动作须在 `contributes.commands` 声明;打开完成后执行 openAction,关闭时取消页面请求并执行 closeAction。扫码、轮询、账号表单和校验全部写在插件工程中,Vue/React 也打包进最终单文件。
|
|
18
|
+
|
|
19
|
+
预览的“关闭页面”可验证清理逻辑。`ctx.ui.setState(id, state)` 只发送给对应页面;`ctx.subscribe` 接收最新状态。开发存储保存在工程 `.ceru-dev/storage/`,重启保留且不打入产物;修改 `manifest.id` 会使用独立存储。生产宿主提供自己的隔离存储和通用播放器服务,开发无需启动澜音。
|
|
20
|
+
|
|
15
21
|
```text
|
|
16
22
|
ceru-plugin list-templates
|
|
17
23
|
ceru-plugin build --out dist/plugin.js
|
package/assets/core-contracts.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
var
|
|
1
|
+
var n=e=>!!e&&typeof e=="object"&&!Array.isArray(e),o=(e,r=4096)=>typeof e=="string"&&e.length<=r,a=e=>Number.isFinite(e)&&Number(e)>=0;function c(e){if(!n(e)||!["pluginId","providerId","kind","id"].every(r=>o(e[r],2048)&&e[r].length>0))throw new Error("Invalid resource reference");if(e.data!==void 0){if(!n(e.data))throw new Error("Invalid resource private data");let r;try{r=JSON.stringify(e.data)}catch{throw new Error("Resource private data must be JSON")}if(new TextEncoder().encode(r).byteLength>64*1024)throw new Error("Resource private data exceeds 64 KiB")}}function p(e){if(!n(e)||!Array.isArray(e.items)||e.items.length>1e4)throw new Error("Invalid content page");if(e.nextCursor!=null&&(!o(e.nextCursor,2048)||!e.nextCursor.length))throw new Error("Invalid pagination cursor");for(let r of e.items){if(!n(r)||!o(r.title)||!Array.isArray(r.capabilities)||!r.capabilities.every(t=>o(t,128)))throw new Error("Invalid content item");if(c(r.ref),r.ref.kind==="track"){if(!n(r.metadata)||!Array.isArray(r.metadata.artists)||!r.metadata.artists.every(t=>o(t)))throw new Error("Track metadata must contain artists");if(r.metadata.durationMs!==void 0&&!a(r.metadata.durationMs))throw new Error("Invalid track duration")}if(r.ref.kind==="playlist"&&r.playlist!==void 0){if(!n(r.playlist))throw new Error("Invalid playlist metadata");if(r.playlist.trackCount!==void 0&&(!Number.isInteger(r.playlist.trackCount)||r.playlist.trackCount<0))throw new Error("Invalid playlist track count")}if(r.ref.kind==="chart"&&r.chart!==void 0&&!n(r.chart))throw new Error("Invalid chart metadata")}}function f(e){if(!n(e)||typeof e.ok!="boolean")throw new Error("Invalid resolve result");if(e.ok){if(!o(e.url,8192))throw new Error("Invalid playback URL");let r=new URL(e.url);if(!["http:","https:"].includes(r.protocol))throw new Error("Invalid playback protocol");if(e.expiresAt!==void 0&&!a(e.expiresAt))throw new Error("Invalid playback expiry");if(e.requestHeaders!==void 0){if(!n(e.requestHeaders)||Object.keys(e.requestHeaders).length>32)throw new Error("Invalid playback request headers");for(let[t,s]of Object.entries(e.requestHeaders))if(!/^[!#$%&'*+.^_`|~0-9A-Za-z-]{1,128}$/.test(t)||/^(host|connection|content-length|transfer-encoding|proxy-.*|upgrade)$/i.test(t)||typeof s!="string"||s.length>8192||/[\r\n]/.test(s))throw new Error("Invalid playback request header")}return}if(!n(e.error)||!o(e.error.code,128)||!o(e.error.message,65536))throw new Error("Invalid music fault")}function m(e){if(!n(e)||e.format!=="crlyric"||e.version!==1||!Number.isFinite(e.offsetMs)||!Array.isArray(e.lines)||e.lines.length>2e4)throw new Error("Invalid lyrics document");if(c(e.track),e.track.kind!=="track")throw new Error("Lyrics must reference a track");let r=-1;for(let t of e.lines){if(!n(t)||!a(t.startTimeMs)||t.startTimeMs<r||!o(t.text,65536))throw new Error("Invalid lyric line");if(r=t.startTimeMs,t.endTimeMs!==void 0&&(!a(t.endTimeMs)||t.endTimeMs<t.startTimeMs))throw new Error("Invalid lyric line end");for(let s of["translation","romanization"])if(t[s]!==void 0&&!o(t[s],65536))throw new Error("Invalid lyric translation");if(t.words!==void 0){if(!Array.isArray(t.words)||t.words.length>1e4)throw new Error("Invalid lyric words");let s=t.startTimeMs;for(let i of t.words){if(!n(i)||!a(i.startTimeMs)||!a(i.endTimeMs)||i.endTimeMs<i.startTimeMs||i.startTimeMs<s||!o(i.text,65536))throw new Error("Invalid lyric word");s=i.startTimeMs}}}if(e.plainText!==void 0&&!o(e.plainText,1048576))throw new Error("Invalid plain lyrics")}var l={network:{title:"\u8BBF\u95EE\u516C\u7F51\u670D\u52A1",permissions:["network.request","network.socket"]},localNetwork:{title:"\u8BBF\u95EE\u5C40\u57DF\u7F51\u4E0E\u672C\u673A\u670D\u52A1",permissions:["network.private","network.discovery"]},account:{title:"\u8BFB\u53D6\u767B\u5F55\u72B6\u6001\u4E0E\u57FA\u672C\u8D26\u53F7\u8D44\u6599",permissions:["account.profile"]},libraryRead:{title:"\u8BFB\u53D6\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.read"]},libraryManage:{title:"\u521B\u5EFA\u548C\u4FEE\u6539\u6B4C\u5355\u4E0E\u6536\u85CF",permissions:["library.write"]},libraryDelete:{title:"\u5220\u9664\u6B4C\u5355\u4E0E\u6B4C\u66F2\u8BB0\u5F55",permissions:["library.delete"]},playbackRead:{title:"\u8BFB\u53D6\u64AD\u653E\u72B6\u6001\u548C\u961F\u5217",permissions:["player.read"]},playbackControl:{title:"\u63A7\u5236\u64AD\u653E\u548C\u64AD\u653E\u961F\u5217",permissions:["player.control","playback.fallback.hold"]},downloads:{title:"\u7BA1\u7406\u4E0B\u8F7D\u4EFB\u52A1",permissions:["downloads.create","downloads.manage"]},files:{title:"\u4F7F\u7528\u7528\u6237\u9009\u5B9A\u7684\u6587\u4EF6",permissions:["files.read","files.write"]},localMusic:{title:"\u7D22\u5F15\u672C\u5730\u97F3\u4E50\u548C\u7F16\u8F91\u6807\u7B7E",permissions:["localMusic.read","localMusic.write"]},clipboardRead:{title:"\u8BFB\u53D6\u526A\u8D34\u677F",permissions:["clipboard.read"]},clipboardWrite:{title:"\u5199\u5165\u526A\u8D34\u677F",permissions:["clipboard.write"]},notifications:{title:"\u53D1\u9001\u7CFB\u7EDF\u901A\u77E5",permissions:["notifications.system"]},external:{title:"\u5728\u7CFB\u7EDF\u6D4F\u89C8\u5668\u6253\u5F00\u94FE\u63A5",permissions:["external.open"]},settingsRead:{title:"\u8BFB\u53D6\u8F6F\u4EF6\u504F\u597D",permissions:["settings.read"]},settingsWrite:{title:"\u4FEE\u6539\u8F6F\u4EF6\u504F\u597D",permissions:["settings.write"]},window:{title:"\u63A7\u5236\u8F6F\u4EF6\u7A97\u53E3",permissions:["window.control"]},hotkeys:{title:"\u6CE8\u518C\u5168\u5C40\u5FEB\u6377\u952E",permissions:["hotkeys.register"]},sharing:{title:"\u53D1\u5E03\u548C\u64A4\u9500\u5206\u4EAB",permissions:["sharing.publish","sharing.revoke"]},roomsRead:{title:"\u8BFB\u53D6\u4E00\u8D77\u542C\u623F\u95F4\u72B6\u6001",permissions:["rooms.read"]},roomsControl:{title:"\u52A0\u5165\u623F\u95F4\u548C\u63A7\u5236\u4E00\u8D77\u542C",permissions:["rooms.control"]},ai:{title:"\u4F7F\u7528\u8F6F\u4EF6 AI \u670D\u52A1",permissions:["ai.use"]},devices:{title:"\u63A7\u5236\u97F3\u9891\u8BBE\u5907\u4E0E\u6295\u653E",permissions:["devices.control"]},uiAppearance:{title:"\u4FEE\u6539\u8F6F\u4EF6\u5168\u5C40\u5916\u89C2",permissions:["ui.styles.global"]},background:{title:"\u540E\u53F0\u4EFB\u52A1",permissions:["background.run"]},credentials:{title:"\u4F7F\u7528\u672C\u63D2\u4EF6\u5DF2\u4FDD\u5B58\u7684\u8FDE\u63A5\u51ED\u636E",permissions:["credentials.use"]},credentialExport:{title:"\u8BFB\u53D6\u672C\u63D2\u4EF6\u8FDE\u63A5\u51ED\u636E\u660E\u6587",permissions:["credentials.read"]},guestPlugins:{title:"\u5B89\u88C5\u548C\u8FD0\u884C\u517C\u5BB9\u5B50\u63D2\u4EF6",permissions:["guests.manage","guests.run"]},services:{title:"\u8C03\u7528\u5176\u4ED6\u63D2\u4EF6\u63D0\u4F9B\u7684\u670D\u52A1",permissions:["services.consume"]}};function w(e){return Object.keys(l).find(r=>l[r].permissions.includes(e))}var d=class{constructor(r,t,s){this.surface=r;this.dispatch=s;this.actions=new Set(t.contributes?.commands?.map(i=>i.action));for(let i of Object.values(r.lifecycle??{}))if(!this.actions.has(i))throw new Error("Unknown surface lifecycle action: "+i)}surface;dispatch;closed=!1;opened=!1;opening;closing;pending=new Set;actions;open(){return this.closed?Promise.reject(new Error("Surface is closed")):(this.opened||(this.opened=!0,this.opening=this.surface.lifecycle?.openAction?this.invoke(this.surface.lifecycle.openAction,{}):Promise.resolve()),this.opening)}async invoke(r,t={}){if(this.closed)throw new Error("Surface is closed");if(!this.actions.has(r))throw new Error("Undeclared surface action: "+r);if(this.pending.size>=32||JSON.stringify(t).length>128*1024)throw new Error("Surface request exceeds limit");let s=new AbortController;this.pending.add(s);try{let i=await this.dispatch(r,t,s.signal);if(this.closed)throw new Error("Surface is closed");return i}finally{this.pending.delete(s)}}close(){if(this.closing)return this.closing;this.closed=!0;for(let t of this.pending)t.abort();this.pending.clear();let r=this.surface.lifecycle?.closeAction;return this.closing=Promise.resolve().then(async()=>{r&&await this.dispatch(r,{})}),this.closing}};export{l as PERMISSION_GROUPS,d as SurfaceSession,p as assertContentPage,m as assertLyricsDocument,f as assertResolveResult,c as assertResourceRef,w as permissionGroup};
|
package/assets/index.html
CHANGED
|
@@ -1,94 +1,94 @@
|
|
|
1
|
-
<!doctype html>
|
|
2
|
-
<html lang="zh-CN">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="utf-8" />
|
|
5
|
-
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
6
|
-
<title>Ceru Plugin Dev</title>
|
|
7
|
-
<link rel="stylesheet" href="/style.css" />
|
|
8
|
-
</head>
|
|
9
|
-
<body>
|
|
10
|
-
<header>
|
|
11
|
-
<div>
|
|
12
|
-
<span class="badge">CERU / DEV HOST</span>
|
|
13
|
-
<h1 id="plugin-name">插件调试工作台</h1>
|
|
14
|
-
<p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
|
|
15
|
-
</div>
|
|
16
|
-
<div class="header-actions">
|
|
17
|
-
<span id="status" class="status">启动中</span><button id="restart">重新运行</button
|
|
18
|
-
><button id="stop">停止</button>
|
|
19
|
-
</div>
|
|
20
|
-
</header>
|
|
21
|
-
<div id="build-error" class="error hidden"></div>
|
|
22
|
-
<main>
|
|
23
|
-
<aside>
|
|
24
|
-
<section>
|
|
25
|
-
<h2>能力注册</h2>
|
|
26
|
-
<div id="registrations"></div>
|
|
27
|
-
</section>
|
|
28
|
-
<section>
|
|
29
|
-
<h2>界面与兼容模块</h2>
|
|
30
|
-
<div id="views"></div>
|
|
31
|
-
</section>
|
|
32
|
-
<section>
|
|
33
|
-
<h2>运行时配置</h2>
|
|
34
|
-
<p class="hint">仅保存在当前开发会话中。</p>
|
|
35
|
-
<textarea id="config" spellcheck="false">{}</textarea
|
|
36
|
-
><button id="apply-config">应用配置并重载</button>
|
|
37
|
-
</section>
|
|
38
|
-
<section>
|
|
39
|
-
<h2>权限模拟</h2>
|
|
40
|
-
<div id="permissions"></div>
|
|
41
|
-
</section>
|
|
42
|
-
</aside>
|
|
43
|
-
<article>
|
|
44
|
-
<section>
|
|
45
|
-
<h2>搜索与解析</h2>
|
|
46
|
-
<div class="row">
|
|
47
|
-
<select id="provider" disabled aria-label="搜索来源"></select
|
|
48
|
-
><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
|
|
49
|
-
调用搜索</button
|
|
50
|
-
><button id="cancel" disabled>取消调用</button>
|
|
51
|
-
</div>
|
|
52
|
-
<p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
|
|
53
|
-
<div id="results" class="results">
|
|
54
|
-
<div class="empty">插件启动后可以调用已注册的搜索方法。</div>
|
|
55
|
-
</div>
|
|
56
|
-
<pre id="result-detail"></pre>
|
|
57
|
-
</section>
|
|
58
|
-
<section>
|
|
59
|
-
<h2>界面预览</h2>
|
|
60
|
-
<div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
|
|
61
|
-
</section>
|
|
62
|
-
<section>
|
|
63
|
-
<h2>宿主资源</h2>
|
|
64
|
-
<p class="hint">
|
|
65
|
-
平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
|
|
66
|
-
</p>
|
|
67
|
-
<div id="icons" class="icons"></div>
|
|
68
|
-
<div id="static-assets" class="static-assets"></div>
|
|
69
|
-
<p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
|
|
70
|
-
</section>
|
|
71
|
-
</article>
|
|
72
|
-
<section class="log-column">
|
|
73
|
-
<div class="row">
|
|
74
|
-
<h2>运行日志</h2>
|
|
75
|
-
<button id="clear-log">清空</button>
|
|
76
|
-
</div>
|
|
77
|
-
<p class="hint">
|
|
78
|
-
使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
|
|
79
|
-
源码。日志已对常见敏感字段脱敏。
|
|
80
|
-
</p>
|
|
81
|
-
<div id="logs"></div>
|
|
82
|
-
</section>
|
|
83
|
-
</main>
|
|
84
|
-
<div id="runners" class="hidden"></div>
|
|
85
|
-
<footer>
|
|
86
|
-
这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
|
|
87
|
-
安装及完整音乐业务仍由正式 Host 实现。
|
|
88
|
-
</footer>
|
|
89
|
-
<script nonce="{{NONCE}}">
|
|
90
|
-
window.CERU_DEV_TOKEN={{TOKEN}};
|
|
91
|
-
</script>
|
|
92
|
-
<script type="module" src="/playground.js"></script>
|
|
93
|
-
</body>
|
|
94
|
-
</html>
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="zh-CN">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
6
|
+
<title>Ceru Plugin Dev</title>
|
|
7
|
+
<link rel="stylesheet" href="/style.css" />
|
|
8
|
+
</head>
|
|
9
|
+
<body>
|
|
10
|
+
<header>
|
|
11
|
+
<div>
|
|
12
|
+
<span class="badge">CERU / DEV HOST</span>
|
|
13
|
+
<h1 id="plugin-name">插件调试工作台</h1>
|
|
14
|
+
<p id="plugin-meta">TypeScript · 单文件构建 · 隔离运行</p>
|
|
15
|
+
</div>
|
|
16
|
+
<div class="header-actions">
|
|
17
|
+
<span id="status" class="status">启动中</span><button id="restart">重新运行</button
|
|
18
|
+
><button id="stop">停止</button>
|
|
19
|
+
</div>
|
|
20
|
+
</header>
|
|
21
|
+
<div id="build-error" class="error hidden"></div>
|
|
22
|
+
<main>
|
|
23
|
+
<aside>
|
|
24
|
+
<section>
|
|
25
|
+
<h2>能力注册</h2>
|
|
26
|
+
<div id="registrations"></div>
|
|
27
|
+
</section>
|
|
28
|
+
<section>
|
|
29
|
+
<h2>界面与兼容模块</h2>
|
|
30
|
+
<div id="views"></div>
|
|
31
|
+
</section>
|
|
32
|
+
<section>
|
|
33
|
+
<h2>运行时配置</h2>
|
|
34
|
+
<p class="hint">仅保存在当前开发会话中。</p>
|
|
35
|
+
<textarea id="config" spellcheck="false">{}</textarea
|
|
36
|
+
><button id="apply-config">应用配置并重载</button>
|
|
37
|
+
</section>
|
|
38
|
+
<section>
|
|
39
|
+
<h2>权限模拟</h2>
|
|
40
|
+
<div id="permissions"></div>
|
|
41
|
+
</section>
|
|
42
|
+
</aside>
|
|
43
|
+
<article>
|
|
44
|
+
<section>
|
|
45
|
+
<h2>搜索与解析</h2>
|
|
46
|
+
<div class="row">
|
|
47
|
+
<select id="provider" disabled aria-label="搜索来源"></select
|
|
48
|
+
><input id="query" placeholder="输入关键词" disabled /><button id="search" class="primary" disabled>
|
|
49
|
+
调用搜索</button
|
|
50
|
+
><button id="cancel" disabled>取消调用</button>
|
|
51
|
+
</div>
|
|
52
|
+
<p id="search-status" class="hint" role="status" aria-live="polite">正在读取插件能力…</p>
|
|
53
|
+
<div id="results" class="results">
|
|
54
|
+
<div class="empty">插件启动后可以调用已注册的搜索方法。</div>
|
|
55
|
+
</div>
|
|
56
|
+
<pre id="result-detail"></pre>
|
|
57
|
+
</section>
|
|
58
|
+
<section>
|
|
59
|
+
<div class="row"><h2>界面预览</h2><button id="close-view">关闭页面</button></div>
|
|
60
|
+
<div id="preview" class="preview"><div class="empty">选择左侧的页面。</div></div>
|
|
61
|
+
</section>
|
|
62
|
+
<section>
|
|
63
|
+
<h2>宿主资源</h2>
|
|
64
|
+
<p class="hint">
|
|
65
|
+
平台图标可直接写入 Manifest:<code>icon: { kind: 'host', name: 'platform.tx' }</code>
|
|
66
|
+
</p>
|
|
67
|
+
<div id="icons" class="icons"></div>
|
|
68
|
+
<div id="static-assets" class="static-assets"></div>
|
|
69
|
+
<p class="hint">工具:<code>ctx.utils.lodash</code> · 64 个带类型提示的常用方法</p>
|
|
70
|
+
</section>
|
|
71
|
+
</article>
|
|
72
|
+
<section class="log-column">
|
|
73
|
+
<div class="row">
|
|
74
|
+
<h2>运行日志</h2>
|
|
75
|
+
<button id="clear-log">清空</button>
|
|
76
|
+
</div>
|
|
77
|
+
<p class="hint">
|
|
78
|
+
使用 VS Code 的 “Attach to Ceru plugin” 或 Electron DevTools 调试 TS
|
|
79
|
+
源码。日志已对常见敏感字段脱敏。
|
|
80
|
+
</p>
|
|
81
|
+
<div id="logs"></div>
|
|
82
|
+
</section>
|
|
83
|
+
</main>
|
|
84
|
+
<div id="runners" class="hidden"></div>
|
|
85
|
+
<footer>
|
|
86
|
+
这是开发 Host。实际运行逻辑与界面;网络默认拒绝。生产安装授权、凭据保险箱、Guest
|
|
87
|
+
安装及完整音乐业务仍由正式 Host 实现。
|
|
88
|
+
</footer>
|
|
89
|
+
<script nonce="{{NONCE}}">
|
|
90
|
+
window.CERU_DEV_TOKEN={{TOKEN}};
|
|
91
|
+
</script>
|
|
92
|
+
<script type="module" src="/playground.js"></script>
|
|
93
|
+
</body>
|
|
94
|
+
</html>
|
package/assets/playground.js
CHANGED
|
@@ -4,6 +4,7 @@ import {
|
|
|
4
4
|
assertResolveResult,
|
|
5
5
|
PERMISSION_GROUPS,
|
|
6
6
|
permissionGroup,
|
|
7
|
+
SurfaceSession,
|
|
7
8
|
} from './core-contracts.js'
|
|
8
9
|
const $ = (id) => document.getElementById(id)
|
|
9
10
|
let state,
|
|
@@ -12,6 +13,8 @@ let state,
|
|
|
12
13
|
stopped = false,
|
|
13
14
|
viewId = null,
|
|
14
15
|
currentInvocation
|
|
16
|
+
let viewSession
|
|
17
|
+
let viewTransition = Promise.resolve()
|
|
15
18
|
const frames = new Map(),
|
|
16
19
|
calls = new Map(),
|
|
17
20
|
registrations = new Map(),
|
|
@@ -51,9 +54,11 @@ function post(frame, type, data) {
|
|
|
51
54
|
frame.element.contentWindow?.postMessage({ type, data, generation: frame.generation }, '*')
|
|
52
55
|
}
|
|
53
56
|
function removeFrames() {
|
|
57
|
+
void viewSession?.close().catch(error => log('error', error.message))
|
|
58
|
+
viewSession = undefined
|
|
54
59
|
void api('rpc', { method: 'sockets.closeAll' }).catch(() => {})
|
|
55
60
|
document.getElementById('host-playlist-import')?.remove()
|
|
56
|
-
for (const frame of frames.values()) frame.element.remove()
|
|
61
|
+
for (const frame of frames.values()) { post(frame, 'dispose'); frame.element.remove() }
|
|
57
62
|
frames.clear()
|
|
58
63
|
registrations.clear()
|
|
59
64
|
for (const call of calls.values()) {
|
|
@@ -61,6 +66,7 @@ function removeFrames() {
|
|
|
61
66
|
call.reject(new Error('Plugin reloaded or stopped'))
|
|
62
67
|
}
|
|
63
68
|
calls.clear()
|
|
69
|
+
surfaceStates.clear()
|
|
64
70
|
currentInvocation = null
|
|
65
71
|
$('results').replaceChildren()
|
|
66
72
|
$('result-detail').textContent = ''
|
|
@@ -89,7 +95,7 @@ function start() {
|
|
|
89
95
|
$('status').textContent = '加载中'
|
|
90
96
|
if (state.manifest.modules.logic) mount(state.manifest.modules.logic.entry, 'logic', $('runners'))
|
|
91
97
|
else $('status').textContent = '无后台入口'
|
|
92
|
-
|
|
98
|
+
// Views open only after logic activation, when their actions have registered.
|
|
93
99
|
updateSearchControls()
|
|
94
100
|
}
|
|
95
101
|
function hasProtocol(providerId, protocol) {
|
|
@@ -183,14 +189,24 @@ function drawRegistrations() {
|
|
|
183
189
|
$('registrations').textContent = stopped ? '插件已停止' : '等待后台模块注册命令或能力'
|
|
184
190
|
updateSearchControls()
|
|
185
191
|
}
|
|
186
|
-
function invoke(frame, kind, target, method, args) {
|
|
192
|
+
function invoke(frame, kind, target, method, args, signal) {
|
|
187
193
|
const id = 'call-' + ++sequence
|
|
188
194
|
currentInvocation = { frame, id }
|
|
189
195
|
log('info', { call: kind === 'action' ? target : target + '.' + method })
|
|
190
196
|
return new Promise((resolve, reject) => {
|
|
197
|
+
const cancel = () => {
|
|
198
|
+
const call = calls.get(id)
|
|
199
|
+
if (!call) return
|
|
200
|
+
clearTimeout(call.timer)
|
|
201
|
+
calls.delete(id)
|
|
202
|
+
post(frame, 'cancel', { id })
|
|
203
|
+
reject(new Error('Surface invocation cancelled'))
|
|
204
|
+
}
|
|
205
|
+
signal?.addEventListener('abort', cancel, { once: true })
|
|
191
206
|
calls.set(id, {
|
|
192
207
|
frame,
|
|
193
208
|
resolve: (value) => {
|
|
209
|
+
signal?.removeEventListener('abort', cancel)
|
|
194
210
|
try {
|
|
195
211
|
if (
|
|
196
212
|
kind === 'playlist-importer' ||
|
|
@@ -203,14 +219,16 @@ function invoke(frame, kind, target, method, args) {
|
|
|
203
219
|
resolve(value)
|
|
204
220
|
} catch (error) { reject(error) }
|
|
205
221
|
},
|
|
206
|
-
reject,
|
|
222
|
+
reject: error => { signal?.removeEventListener('abort', cancel); reject(error) },
|
|
207
223
|
timer: setTimeout(() => {
|
|
208
224
|
calls.delete(id)
|
|
209
225
|
updateSearchControls()
|
|
210
226
|
post(frame, 'cancel', { id })
|
|
227
|
+
signal?.removeEventListener('abort', cancel)
|
|
211
228
|
reject(new Error('Invocation timed out'))
|
|
212
229
|
}, 20000),
|
|
213
230
|
})
|
|
231
|
+
if (signal?.aborted) { cancel(); return }
|
|
214
232
|
updateSearchControls()
|
|
215
233
|
post(frame, 'invoke', { id, kind, target, method, args })
|
|
216
234
|
})
|
|
@@ -227,10 +245,10 @@ function showResult(value) {
|
|
|
227
245
|
}
|
|
228
246
|
return value
|
|
229
247
|
}
|
|
230
|
-
function runAction(action, input) {
|
|
248
|
+
function runAction(action, input = {}, signal) {
|
|
231
249
|
const item = registrations.get('action:' + action)
|
|
232
250
|
if (!item) return Promise.reject(new Error('Action is not registered: ' + action))
|
|
233
|
-
return invoke(item.frame, 'action', action, '', [input])
|
|
251
|
+
return invoke(item.frame, 'action', action, '', [input], signal)
|
|
234
252
|
}
|
|
235
253
|
|
|
236
254
|
// A single Host-owned preview for all importers. Plugins contribute data callbacks only.
|
|
@@ -324,6 +342,26 @@ function renderSchema(node, values, container) {
|
|
|
324
342
|
container.append(text)
|
|
325
343
|
}
|
|
326
344
|
function showView(id, mountInfo = { kind: 'page' }) {
|
|
345
|
+
viewTransition = viewTransition.catch(() => {}).then(async () => {
|
|
346
|
+
await closeView()
|
|
347
|
+
if (stopped) return
|
|
348
|
+
mountView(id, mountInfo)
|
|
349
|
+
})
|
|
350
|
+
return viewTransition.catch(error => log('error', error.message))
|
|
351
|
+
}
|
|
352
|
+
async function closeView() {
|
|
353
|
+
const previous = viewSession
|
|
354
|
+
viewSession = undefined
|
|
355
|
+
viewId = null
|
|
356
|
+
for (const [key, frame] of frames) if (frame.kind !== 'logic') {
|
|
357
|
+
post(frame, 'dispose')
|
|
358
|
+
frame.element.remove()
|
|
359
|
+
frames.delete(key)
|
|
360
|
+
}
|
|
361
|
+
$('preview').replaceChildren()
|
|
362
|
+
await previous?.close()
|
|
363
|
+
}
|
|
364
|
+
function mountView(id, mountInfo) {
|
|
327
365
|
viewId = id
|
|
328
366
|
for (const [key, frame] of frames)
|
|
329
367
|
if (frame.kind !== 'logic') {
|
|
@@ -332,7 +370,12 @@ function showView(id, mountInfo = { kind: 'page' }) {
|
|
|
332
370
|
}
|
|
333
371
|
$('preview').replaceChildren()
|
|
334
372
|
const view = state.manifest.modules.surfaces?.find((v) => v.id === id)
|
|
335
|
-
if (view?.kind === 'web')
|
|
373
|
+
if (view?.kind === 'web') {
|
|
374
|
+
viewSession = new SurfaceSession(view, state.manifest, runAction)
|
|
375
|
+
const frame = mount(view.entry, 'web', $('preview'), mountInfo)
|
|
376
|
+
frame.surfaceId = id
|
|
377
|
+
frame.session = viewSession
|
|
378
|
+
}
|
|
336
379
|
else if (view?.kind === 'schema')
|
|
337
380
|
renderSchema(
|
|
338
381
|
state.resources[view.entry]?.value?.root,
|
|
@@ -478,7 +521,7 @@ window.addEventListener('message', async (event) => {
|
|
|
478
521
|
post(frame, 'init', {
|
|
479
522
|
generation: frame.generation,
|
|
480
523
|
kind: frame.kind,
|
|
481
|
-
manifest: state.manifest,
|
|
524
|
+
manifest: frame.kind === 'web' ? { ...state.manifest, config: {} } : state.manifest,
|
|
482
525
|
catalog: state.catalog,
|
|
483
526
|
resources: state.resources,
|
|
484
527
|
mount: frame.mountInfo,
|
|
@@ -493,6 +536,10 @@ window.addEventListener('message', async (event) => {
|
|
|
493
536
|
$('status').textContent = '运行中'
|
|
494
537
|
log('info', frame.moduleId + ' activated')
|
|
495
538
|
drawRegistrations()
|
|
539
|
+
if (frame.kind === 'web') {
|
|
540
|
+
post(frame, 'state', surfaceStates.get(frame.surfaceId) ?? {})
|
|
541
|
+
void frame.session.open().catch(error => log('error', error.message))
|
|
542
|
+
} else if (frame.kind === 'logic' && viewId) void showView(viewId)
|
|
496
543
|
}
|
|
497
544
|
if (message.type === 'failed') {
|
|
498
545
|
frame.failed = true
|
|
@@ -506,7 +553,7 @@ window.addEventListener('message', async (event) => {
|
|
|
506
553
|
}
|
|
507
554
|
if (message.type === 'log') log(data.level, data.values)
|
|
508
555
|
if (message.type === 'notify') log(data.level, data.message)
|
|
509
|
-
if (message.type === 'open-view') showView(data.surfaceId)
|
|
556
|
+
if (message.type === 'open-view' && frame.kind === 'logic') void showView(data.surfaceId)
|
|
510
557
|
if (message.type === 'register') {
|
|
511
558
|
if (frame.kind !== 'logic') return
|
|
512
559
|
const valid =
|
|
@@ -527,7 +574,7 @@ window.addEventListener('message', async (event) => {
|
|
|
527
574
|
}
|
|
528
575
|
if (message.type === 'state' && frame.kind === 'logic') {
|
|
529
576
|
surfaceStates.set(data.surfaceId, data.state)
|
|
530
|
-
for (const view of frames.values()) if (view.kind === 'web') post(view, 'state', data.state)
|
|
577
|
+
for (const view of frames.values()) if (view.kind === 'web' && view.surfaceId === data.surfaceId) post(view, 'state', data.state)
|
|
531
578
|
if (
|
|
532
579
|
viewId === data.surfaceId &&
|
|
533
580
|
state.manifest.modules.surfaces?.find((v) => v.id === viewId)?.kind === 'schema'
|
|
@@ -547,7 +594,7 @@ window.addEventListener('message', async (event) => {
|
|
|
547
594
|
try {
|
|
548
595
|
let value
|
|
549
596
|
if (data.method === 'surface.invoke' && frame.kind === 'web')
|
|
550
|
-
value =
|
|
597
|
+
value = await frame.session.invoke(data.data.action, data.data.input ?? {})
|
|
551
598
|
else if (frame.kind !== 'logic')
|
|
552
599
|
throw new Error('This Surface/Guest cannot call a logic Host API directly')
|
|
553
600
|
else if (data.method === 'permissions.requestGroup') {
|
|
@@ -670,6 +717,7 @@ $('stop').onclick = () => {
|
|
|
670
717
|
$('status').textContent = '已停止'
|
|
671
718
|
}
|
|
672
719
|
$('clear-log').onclick = () => $('logs').replaceChildren()
|
|
720
|
+
$('close-view').onclick = () => { void closeView().catch(error => log('error', error.message)) }
|
|
673
721
|
$('apply-config').onclick = async () => {
|
|
674
722
|
try {
|
|
675
723
|
await api('config', JSON.parse($('config').value))
|