@dsh-plus/notify-email 0.1.11 → 0.1.13

package/lib/client.js

@@ -196,14 +196,15 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region ../shared/src/client/scope.ts
 		/**
-		* api 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
+		* remote.settings 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
 		* 读：describe 取命名空间视图（脱敏 value/revision + 顶层 writable）；
 		* 刷新：remote `settings/document-updated`（按命名空间过滤）与
 		* `connection/reset`；generation 防旧读覆盖新发布。任何页面 origin
 		* （loopback 或 tailnet 信任域名）下行为一致。
 		* effect 归属调用方 fiber（label 需含插件名以便诊断）。
 		*/
-		function createApiScope(api, ns, c, label) {
+		function createSettingsScope(c, ns, label) {
+			const remote = c.get("remote");
 			let state = {
 				status: "loading",
 				value: void 0,
@@ -218,36 +219,37 @@ window.__ModuleLoader__.load({
 			};
 			const load = async () => {
 				const gen = ++generation;
-				let response;
+				let view;
 				try {
-					response = await api.describe({});
+					const response = await remote.settings.describe();
+					if (!response.ok) return;
+					view = response.value;
 				} catch {
 					return;
 				}
-				if (gen !== generation || !response.result.ok) return;
-				const writable = response.result.value?.writable ?? false;
-				const view = response.result.value?.namespaces.find((candidate) => candidate.ns === ns);
-				if (view === void 0) {
+				if (gen !== generation) return;
+				const namespace = view.namespaces.find((candidate) => candidate.ns === ns);
+				if (namespace === void 0) {
 					publish({
 						status: "unavailable",
 						value: void 0,
 						revision: void 0,
-						writable
+						writable: view.writable
 					});
 					return;
 				}
 				publish({
 					status: "ready",
-					value: view.value,
-					revision: view.revision,
-					writable
+					value: namespace.value,
+					revision: namespace.revision,
+					writable: view.writable
 				});
 			};
 			const refresh = (namespace) => {
 				if (namespace !== void 0 && namespace !== ns) return;
 				load();
 			};
-			const disposers = [c.get("remote").$on("settings/document-updated", refresh), c.on("connection/reset", () => {
+			const disposers = [remote.$on("settings/document-updated", refresh), c.on("connection/reset", () => {
 				load();
 			})];
 			c.effect(() => () => {
@@ -265,6 +267,20 @@ window.__ModuleLoader__.load({
 				load
 			};
 		}
+		/** 以 remote.settings 构造命名空间绑定的 api 面。 */
+		function createNamespaceApi(remote, ns) {
+			return {
+				update: async (patch, expectedRevision) => {
+					const response = await remote.update(ns, patch, expectedRevision);
+					if (!response.ok) throw new Error(response.error.message ?? "settings update failed");
+				},
+				describe: async () => {
+					const response = await remote.describe();
+					if (!response.ok) throw new Error(response.error.message ?? "settings describe failed");
+					return response.value;
+				}
+			};
+		}
 		//#endregion
 		//#region ../shared/src/client/styles.ts
 		/**
@@ -369,9 +385,10 @@ ${extra}
 		//#region src/ns.ts
 		/**
 		* settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
-		* 服务端经 settingsNamespace() 品牌化后使用（config.ts），浏览器半将其作为
-		* settings.plugin.item keyed 槽位的 key —— 同一字面量两处共用，防止漂移。
-		* 契约：dsh rc7 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
+		* 服务端直接以字面量注册（0.1.2-alpha.2 起编译期校验命名空间语法，见
+		* config.ts），浏览器半将其作为 settings.plugin.item keyed 槽位的 key ——
+		* 同一字面量两处共用，防止漂移。
+		* 契约：该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
 		* 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
 		* @module notify-email/ns
 		*/
@@ -397,7 +414,8 @@ ${extra}
 		* 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
 		* 本文件只保留业务字段与保存/测试逻辑。交互对齐官方卡片：折叠/展开、
 		* staged draft、未保存标记、保存/放弃；另加「发送测试邮件」。
-		* 配置读写走官方 settingsScope 传输：value 为 schema 解析后的脱敏视图
+		* 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
+		* 已移除）：value 为 schema 解析后的脱敏视图
 		* （smtp.pass 不出现，passConfigured 由 describe 的 secrets 探测），
 		* 保存经 settings.update 深合并（空 pass 剔除 = 保持不变）。
 		* @module notify-email/client/card
@@ -462,10 +480,10 @@ ${extra}
 			}, [value, draft]);
 			(0, react.useEffect)(() => {
 				let alive = true;
-				api.describe({}).then((response) => {
-					if (!alive || !response.result.ok) return;
-					const view = response.result.value?.namespaces.find((ns) => ns.ns === SETTINGS_NS);
-					setPassConfigured(view?.secrets.some((secret) => secret.path.join(".") === "smtp.pass" && secret.set) ?? false);
+				api.describe().then((view) => {
+					if (!alive) return;
+					const ns = view.namespaces.find((candidate) => candidate.ns === SETTINGS_NS);
+					setPassConfigured(ns?.secrets.some((secret) => secret.path.join(".") === "smtp.pass" && secret.set) ?? false);
 				}).catch(() => {});
 				return () => {
 					alive = false;
@@ -498,12 +516,7 @@ ${extra}
 				const patch = toPatch(draft);
 				if (patch["smtp"]["pass"] === "") delete patch["smtp"]["pass"];
 				const revision = scope.getSnapshot().revision;
-				api.update({
-					ns: SETTINGS_NS,
-					patch,
-					...revision !== void 0 ? { expectedRevision: revision } : {}
-				}).then(async (response) => {
-					if (!response.result.ok) throw new Error(response.result.error?.message ?? t("saveFailed"));
+				api.update(patch, revision).then(async () => {
 					await scope.load();
 					const next = scope.getSnapshot().value;
 					if (next !== void 0) setDraft(draftFromValue(next));
@@ -793,8 +806,8 @@ ${extra}
 		const inject = [
 			"slots",
 			"locale",
-			"connection",
-			"remote"
+			"remote",
+			"remote.settings"
 		];
 		function apply(ctx) {
 			const c = ctx;
@@ -806,8 +819,8 @@ ${extra}
 				zh,
 				en
 			}), "notify-email: locale");
-			const api = c.get("connection").api.settings;
-			const scope = createApiScope(api, SETTINGS_NS, c, "notify-email: settings scope");
+			const scope = createSettingsScope(c, SETTINGS_NS, "notify-email: settings scope");
+			const api = createNamespaceApi(c.get("remote").settings, SETTINGS_NS);
 			c.slots.inject("settings.plugin.item", () => c.slots.register({
 				name: "settings.plugin.item",
 				key: SETTINGS_NS,

package/lib/index.js

@@ -1,4 +1,3 @@
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 import { Context, Service } from "@deepseek-ai/cordis";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
@@ -13,8 +12,8 @@ import nodemailer from "nodemailer";
 * 共用同一 schemastery schema。SMTP 密码标记 secret 角色，任何读取通道不得回传。
 * @module notify-email/config
 */
-/** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-const SETTINGS_NS = settingsNamespace("dsh-plus-notify-email");
+/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
+const SETTINGS_NS = "dsh-plus-notify-email";
 const SmtpSchema = z.object({
 	host: z.string().description("SMTP 服务器主机名").default(""),
 	port: z.natural().max(65535).description("SMTP 端口").default(465),
@@ -409,7 +408,7 @@ function installTurnEndWatcher(ctx, service, resolveConfig) {
 //#region src/service.ts
 /**
 * NotifyEmailService：通知编排中枢。
-* - 配置：installSettingsSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
+* - 配置：settings.installSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
 *   无 settings provider 时退化为 cordis 行级 config。
 * - 触发器：registerTrigger 是第三方插件的扩展接口；内置官方适配器同路径注册。
 * - 投递：首个非空 EmailNotice 经 Mailer 发送；单个触发器抛错不影响其余。
@@ -423,11 +422,13 @@ var NotifyEmailService = class extends Service {
 	constructor(ctx, config) {
 		super(ctx, "notifyEmail");
 		this.current = () => config;
-		installSettingsSection(ctx, SETTINGS_NS, Config, config, {
-			setSource: (source) => {
-				this.current = source;
-			},
-			onChange: () => {}
+		ctx.inject(["settings"], (settingsCtx) => {
+			settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
+				setSource: (source) => {
+					this.current = source;
+				},
+				onChange: () => {}
+			});
 		});
 		const logger = ctx.logger("notify-email");
 		const audit = createJsonlAuditSink(dshHomePath("logs", "notify-email.jsonl"), (message) => logger.warn(`audit write failed: ${message}`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/notify-email",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "dsh-plus service+ui plugin: 任务结束/等待决策/出错时向指定邮箱发送邮件通知",
   "type": "module",
   "main": "lib/index.js",
@@ -23,36 +23,35 @@
   "dsh": {
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-api-remotes"
       ],
       "platform": "web"
     }
   },
   "dependencies": {
-    "nodemailer": "9.0.5",
-    "@dsh-plus/shared": "0.1.5"
+    "nodemailer": "9.0.6",
+    "@dsh-plus/shared": "0.1.7"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-home-paths": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
-    "@deepseek-ai/schemastery": "3.18.1",
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-session": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
+    "@deepseek-ai/dsh-tools": "0.1.2-alpha.2",
+    "@deepseek-ai/schemastery": "3.18.2",
     "@types/nodemailer": "8.0.1",
-    "@types/react": "~18.3.1",
+    "@types/react": "~18.3.31",
     "react": "^18.2.0"
   },
   "publishConfig": {

package/src/client/api.ts

@@ -1,6 +1,6 @@
 /**
- * 自定义端点通道：仅剩「发送测试邮件」（配置读写已迁移到官方 settingsScope
- * 传输，见 scope.ts 与 card.tsx）。
+ * 自定义端点通道：仅剩「发送测试邮件」（配置读写经 ctx.remote.settings
+ * 直连，见 shared/client scope.ts 与 card.tsx）。
  * @module notify-email/client/api
  */
 

package/src/client/card.tsx

@@ -3,7 +3,8 @@
  * 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
  * 本文件只保留业务字段与保存/测试逻辑。交互对齐官方卡片：折叠/展开、
  * staged draft、未保存标记、保存/放弃；另加「发送测试邮件」。
- * 配置读写走官方 settingsScope 传输：value 为 schema 解析后的脱敏视图
+ * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
+ * 已移除）：value 为 schema 解析后的脱敏视图
  * （smtp.pass 不出现，passConfigured 由 describe 的 secrets 探测），
  * 保存经 settings.update 深合并（空 pass 剔除 = 保持不变）。
  * @module notify-email/client/card
@@ -14,8 +15,8 @@ import {
   type CardStatusState,
   CheckRow,
   IDLE_STATUS,
+  type NamespaceSettingsApi,
   type Scope,
-  type SettingsApi,
   TextField,
 } from '@dsh-plus/shared/client'
 import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
@@ -25,7 +26,7 @@ import { sendTest } from './api.ts'
 export interface CardProps {
   t(key: string): string
   scope: Scope
-  api: SettingsApi
+  api: NamespaceSettingsApi
 }
 
 /** settings 命名空间的脱敏解析值（smtp.pass 被脱敏剥除）。 */
@@ -136,12 +137,12 @@ export function NotifyEmailCard(props: CardProps): ReactElement | null {
   useEffect(() => {
     let alive = true
     api
-      .describe({})
-      .then((response) => {
-        if (!alive || !response.result.ok) return
-        const view = response.result.value?.namespaces.find((ns) => ns.ns === SETTINGS_NS)
+      .describe()
+      .then((view) => {
+        if (!alive) return
+        const ns = view.namespaces.find((candidate) => candidate.ns === SETTINGS_NS)
         setPassConfigured(
-          view?.secrets.some((secret) => secret.path.join('.') === 'smtp.pass' && secret.set) ??
+          ns?.secrets.some((secret) => secret.path.join('.') === 'smtp.pass' && secret.set) ??
             false,
         )
       })
@@ -190,15 +191,8 @@ export function NotifyEmailCard(props: CardProps): ReactElement | null {
     }
     const revision = scope.getSnapshot().revision
     api
-      .update({
-        ns: SETTINGS_NS,
-        patch,
-        ...(revision !== undefined ? { expectedRevision: revision } : {}),
-      })
-      .then(async (response) => {
-        if (!response.result.ok) {
-          throw new Error(response.result.error?.message ?? t('saveFailed'))
-        }
+      .update(patch, revision)
+      .then(async () => {
         await scope.load()
         const next = scope.getSnapshot().value as ConfigValue | undefined
         if (next !== undefined) setDraft(draftFromValue(next))

package/src/client/client.ts

@@ -3,18 +3,24 @@
  * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
  * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
  *
- * 类型说明：浏览器半只用到 slots/locale/connection/remote 的很窄一面，
+ * 类型说明：浏览器半只用到 slots/locale/remote 的很窄一面，
  * scope 与基础控件走 @dsh-plus/shared/client 套件（收编自本插件原实现）。
- * rc7 起该插槽为 keyed 槽位：key 必须是卡片编辑的 settings 命名空间
- * （即服务端 settingsNamespace() 注册的同一字面量，见 ../ns.ts），
+ * 该插槽为 keyed 槽位（0.1.2-alpha.2 复核不变）：key 必须是卡片编辑的 settings
+ * 命名空间（即服务端注册的同一字面量，见 ../ns.ts），
  * 官方配置页按此 key 与 Host 已注册命名空间配对分发。
- * 配置读写经官方 settings RPC 直连（rc7 起第三方命名空间全量开放；
- * 不复用 settingsScope 服务——非 loopback 页面下它无数据）；
+ * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
+ * 已移除；不复用 settingsScope 服务——非 loopback 页面下它固定 memory 模式无数据）；
  * 自定义端点仅剩「发送测试邮件」（api.ts）。
  * @module @dsh-plus/notify-email/client
  */
 import type { Context } from '@deepseek-ai/cordis'
-import { cardCss, createApiScope, injectCardStyle } from '@dsh-plus/shared/client'
+import {
+  cardCss,
+  createNamespaceApi,
+  createSettingsScope,
+  injectCardStyle,
+  type SettingsRemoteFace,
+} from '@dsh-plus/shared/client'
 import { SETTINGS_NS } from '../ns.ts'
 import { NotifyEmailCard } from './card.tsx'
 import { en, NS, zh } from './i18n.ts'
@@ -22,7 +28,7 @@ import { en, NS, zh } from './i18n.ts'
 export const name = 'dsh-plus-notify-email'
 
 /** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
-export const inject = ['slots', 'locale', 'connection', 'remote'] as const
+export const inject = ['slots', 'locale', 'remote', 'remote.settings'] as const
 
 interface SlotsLike {
   inject(key: string, callback: () => unknown): unknown
@@ -35,17 +41,13 @@ interface LocaleLike {
 }
 
 interface RemoteLike {
+  settings: SettingsRemoteFace
   $on(event: string, listener: (payload?: unknown) => void): () => void
 }
 
-interface ConnectionLike {
-  api: { settings: Parameters<typeof createApiScope>[0] }
-}
-
 interface ClientContext {
   slots: SlotsLike
   locale: LocaleLike
-  get(key: 'connection'): ConnectionLike
   get(key: 'remote'): RemoteLike
   on(event: string, listener: () => void): () => void
   effect(execute: () => () => void, label?: string): unknown
@@ -61,8 +63,8 @@ export function apply(ctx: Context): void {
     'notify-email: style',
   )
   c.effect(() => c.locale.register(NS, { zh, en }), 'notify-email: locale')
-  const api = c.get('connection').api.settings
-  const scope = createApiScope(api, SETTINGS_NS, c, 'notify-email: settings scope')
+  const scope = createSettingsScope(c, SETTINGS_NS, 'notify-email: settings scope')
+  const api = createNamespaceApi(c.get('remote').settings, SETTINGS_NS)
   c.slots.inject('settings.plugin.item', () =>
     c.slots.register(
       {

package/src/config-api.ts

@@ -1,6 +1,6 @@
 /**
- * 自定义端点 HTTP 通道：配置读写已迁移到官方 settings RPC（rc7 起第三方
- * 命名空间全量开放），这里只保留官方传输没有的「发送测试邮件」端点。
+ * 自定义端点 HTTP 通道：配置读写走官方 settings 命名空间（0.1.2-alpha.1 起
+ * 第三方命名空间全量开放），这里只保留官方传输没有的「发送测试邮件」端点。
  * 仅监听 dsh web 同源（webserver 默认 127.0.0.1），与 GUI 其余面同等暴露面。
  * @module notify-email/config-api
  */

package/src/config.ts

@@ -5,13 +5,12 @@
  * @module notify-email/config
  */
 
-import { settingsNamespace } from '@deepseek-ai/dsh-settings'
 import z from '@deepseek-ai/schemastery'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
-/** settings 命名空间；webui 配置卡片与插件运行期读取同一份（字面量见 ./ns.ts）。 */
-export const SETTINGS_NS = settingsNamespace(NS_LITERAL)
+/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
+export const SETTINGS_NS = NS_LITERAL
 
 const SmtpSchema = z.object({
   host: z.string().description('SMTP 服务器主机名').default(''),

package/src/ns.ts

@@ -1,8 +1,9 @@
 /**
  * settings 命名空间字面量（纯常量，零依赖，浏览器半可安全引入）。
- * 服务端经 settingsNamespace() 品牌化后使用（config.ts），浏览器半将其作为
- * settings.plugin.item keyed 槽位的 key —— 同一字面量两处共用，防止漂移。
- * 契约：dsh rc7 起该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
+ * 服务端直接以字面量注册（0.1.2-alpha.2 起编译期校验命名空间语法，见
+ * config.ts），浏览器半将其作为 settings.plugin.item keyed 槽位的 key ——
+ * 同一字面量两处共用，防止漂移。
+ * 契约：该槽位按「卡片编辑的 settings 命名空间」作 key 分发，
  * 官方配置页只渲染 key 命中 Host 已注册命名空间的卡片。
  * @module notify-email/ns
  */

package/src/service.ts

@@ -1,6 +1,6 @@
 /**
  * NotifyEmailService：通知编排中枢。
- * - 配置：installSettingsSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
+ * - 配置：settings.installSection 接入 settings 用户层（$DSH_HOME/settings.yaml，热生效），
  *   无 settings provider 时退化为 cordis 行级 config。
  * - 触发器：registerTrigger 是第三方插件的扩展接口；内置官方适配器同路径注册。
  * - 投递：首个非空 EmailNotice 经 Mailer 发送；单个触发器抛错不影响其余。
@@ -8,7 +8,7 @@
  */
 import { Context, Service } from '@deepseek-ai/cordis'
 import { dshHomePath } from '@deepseek-ai/dsh-home-paths'
-import { installSettingsSection } from '@deepseek-ai/dsh-settings'
+import type {} from '@deepseek-ai/dsh-settings'
 import { createJsonlAuditSink } from './audit.ts'
 import { Config, type NotifyEmailConfig, SETTINGS_NS } from './config.ts'
 import { registerTestApi } from './config-api.ts'
@@ -34,11 +34,15 @@ export class NotifyEmailService extends Service {
   constructor(ctx: Context, config: NotifyEmailConfig) {
     super(ctx, 'notifyEmail')
     this.current = () => config
-    installSettingsSection(ctx, SETTINGS_NS, Config, config, {
-      setSource: (source) => {
-        this.current = source
-      },
-      onChange: () => {},
+    // 官方 installSection 范式（0.1.2-alpha.2）：settings 在时以行级 config 为
+    // base 注册用户层，缺席/detach 时回落行级 config。
+    ctx.inject(['settings'], (settingsCtx) => {
+      settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
+        setSource: (source) => {
+          this.current = source
+        },
+        onChange: () => {},
+      })
     })
     const logger = ctx.logger('notify-email')
     const audit = createJsonlAuditSink(dshHomePath('logs', 'notify-email.jsonl'), (message) =>