@dsh-plus/notify-email 0.1.2 → 0.1.4

package/lib/client.js

@@ -176,7 +176,7 @@ function NotifyEmailCard(props) {
 	}, [value, draft]);
 	(0, react.useEffect)(() => {
 		let alive = true;
-		api.describe().then((response) => {
+		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);
@@ -610,9 +610,78 @@ const name = "dsh-plus-notify-email";
 const inject = [
 	"slots",
 	"locale",
-	"settingsScope",
-	"connection"
+	"connection",
+	"remote"
 ];
+/**
+* api 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
+* 读：describe 取命名空间视图（脱敏 value/revision + 顶层 writable）；
+* 刷新：remote `settings/document-updated`（按命名空间过滤）与
+* `connection/reset`；generation 防旧读覆盖新发布。任何页面 origin
+* （loopback 或 tailnet 信任域名）下行为一致。
+*/
+function createApiScope(api, ns, c) {
+	let state = {
+		status: "loading",
+		value: void 0,
+		revision: void 0,
+		writable: false
+	};
+	const listeners = /* @__PURE__ */ new Set();
+	let generation = 0;
+	const publish = (next) => {
+		state = next;
+		for (const listener of [...listeners]) listener();
+	};
+	const load = async () => {
+		const gen = ++generation;
+		let response;
+		try {
+			response = await api.describe({});
+		} 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) {
+			publish({
+				status: "unavailable",
+				value: void 0,
+				revision: void 0,
+				writable
+			});
+			return;
+		}
+		publish({
+			status: "ready",
+			value: view.value,
+			revision: view.revision,
+			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", () => {
+		load();
+	})];
+	c.effect(() => () => {
+		for (const dispose of disposers) dispose();
+	}, "notify-email: settings scope");
+	load();
+	return {
+		getSnapshot: () => state,
+		subscribe: (listener) => {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		},
+		load
+	};
+}
 function apply(ctx) {
 	const c = ctx;
 	const tag = injectStyle();
@@ -623,8 +692,8 @@ function apply(ctx) {
 		zh,
 		en
 	}), "notify-email: locale");
-	const scope = c.settingsScope.bind({ namespace: SETTINGS_NS });
 	const api = c.get("connection").api.settings;
+	const scope = createApiScope(api, SETTINGS_NS, c);
 	c.slots.inject("settings.plugin.item", () => c.slots.register({
 		name: "settings.plugin.item",
 		key: SETTINGS_NS,

package/lib/index.d.ts

@@ -138,6 +138,14 @@ declare class NotifyEmailService extends Service {
     ok: boolean;
     detail: string;
   }>;
+  /** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+  sendNotice(notice: {
+    subject: string;
+    text: string;
+  }): Promise<{
+    ok: boolean;
+    detail: string;
+  }>;
   private dispatch;
 }
 //#endregion

package/lib/index.js

@@ -452,6 +452,10 @@ var NotifyEmailService = class extends Service {
 			text: "这是一封来自 dsh notify-email 插件的测试邮件。"
 		}, true);
 	}
+	/** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+	async sendNotice(notice) {
+		return this.mailer.send(notice);
+	}
 	async dispatch(kind, payload, produce) {
 		for (const trigger of [...this.triggers]) {
 			let notice;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/notify-email",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "dsh-plus service+ui plugin: 任务结束/等待决策/出错时向指定邮箱发送邮件通知",
   "type": "module",
   "main": "lib/index.js",
@@ -26,7 +26,7 @@
         "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-ui-settings"
+        "@deepseek-ai/dsh-api-remotes"
       ],
       "platform": "web"
     }

package/src/client/card.tsx

@@ -130,7 +130,7 @@ export function NotifyEmailCard(props: CardProps): ReactElement | null {
   // passConfigured 探测：scope 快照不含 secrets，经 describe 的 secrets 列表判断。
   useEffect(() => {
     let alive = true
-    api.describe()
+    api.describe({})
       .then((response) => {
         if (!alive || !response.result.ok) return
         const view = response.result.value?.namespaces.find((ns) => ns.ns === SETTINGS_NS)

package/src/client/client.ts

@@ -3,15 +3,16 @@
  * 构建产物为 window.__ModuleLoader__.load({id, factory}) 形式的 CJS factory
  * （包装见 tsdown.config.ts）；样式沿用官方 data-plugin-css 约定，HMR 据此卸载。
  *
- * 类型说明：浏览器半只用到 slots/locale/settingsScope/connection 的很窄一面，
+ * 类型说明：浏览器半只用到 slots/locale/connection/remote 的很窄一面，
  * 此处以最小本地接口声明（见 ./scope.ts），避免为构建期类型引入整条官方
  * client 依赖树；运行时契约以官方 dsh-client-ui-settings-plugins 的
- * settings.plugin.item 插槽与 dsh-client-ui-settings 的 settingsScope 服务为准。
+ * settings.plugin.item 插槽与 dsh-client-connection 的 settings RPC 面为准。
  * rc7 起该插槽为 keyed 槽位：key 必须是卡片编辑的 settings 命名空间
  * （即服务端 settingsNamespace() 注册的同一字面量，见 ../ns.ts），
  * 官方配置页按此 key 与 Host 已注册命名空间配对分发。
- * 配置读写经官方 settingsScope 传输（rc7 起第三方命名空间对 settings RPC
- * 全量开放）；自定义端点仅剩「发送测试邮件」（api.ts）。
+ * 配置读写经官方 settings RPC 直连（rc7 起第三方命名空间全量开放；
+ * 不复用 settingsScope 服务——非 loopback 页面下它无数据，见 scope.ts）；
+ * 自定义端点仅剩「发送测试邮件」（api.ts）。
  * @module @dsh-plus/notify-email/client
  */
 import type { Context } from '@deepseek-ai/cordis'
@@ -19,13 +20,13 @@ import type { Context } from '@deepseek-ai/cordis'
 import { SETTINGS_NS } from '../ns.ts'
 import { NotifyEmailCard } from './card.tsx'
 import { en, NS, zh } from './i18n.ts'
-import type { Scope, SettingsApi } from './scope.ts'
+import type { Scope, ScopeSnapshot, SettingsApi } from './scope.ts'
 import { injectStyle } from './styles.ts'
 
 export const name = 'dsh-plus-notify-email'
 
 /** 浏览器半需要的 cordis 服务 key（loader 据此注入；package.json 的 dsh.client.inject 管包加载顺序）。 */
-export const inject = ['slots', 'locale', 'settingsScope', 'connection'] as const
+export const inject = ['slots', 'locale', 'connection', 'remote'] as const
 
 interface SlotsLike {
   inject(key: string, callback: () => unknown): unknown
@@ -37,22 +38,84 @@ interface LocaleLike {
   bind(ns: string): (key: string) => string
 }
 
-interface SettingsScopeServiceLike {
-  bind(spec: { namespace: string }): Scope
+interface RemoteLike {
+  $on(event: string, listener: (payload?: unknown) => void): () => void
 }
 
 interface ConnectionLike {
-  settings: SettingsApi
+  api: { settings: SettingsApi }
 }
 
 interface ClientContext {
   slots: SlotsLike
   locale: LocaleLike
-  settingsScope: SettingsScopeServiceLike
   get(key: 'connection'): ConnectionLike
+  get(key: 'remote'): RemoteLike
+  on(event: string, listener: () => void): () => void
   effect(execute: () => () => void, label?: string): unknown
 }
 
+/**
+ * api 直连实现的命名空间 scope（官方配置页 tab 同款模式）。
+ * 读：describe 取命名空间视图（脱敏 value/revision + 顶层 writable）；
+ * 刷新：remote `settings/document-updated`（按命名空间过滤）与
+ * `connection/reset`；generation 防旧读覆盖新发布。任何页面 origin
+ * （loopback 或 tailnet 信任域名）下行为一致。
+ */
+function createApiScope(api: SettingsApi, ns: string, c: ClientContext): Scope {
+  let state: ScopeSnapshot = { status: 'loading', value: undefined, revision: undefined, writable: false }
+  const listeners = new Set<() => void>()
+  let generation = 0
+  const publish = (next: ScopeSnapshot): void => {
+    state = next
+    for (const listener of [...listeners]) listener()
+  }
+  const load = async (): Promise<void> => {
+    const gen = ++generation
+    let response
+    try {
+      response = await api.describe({})
+    } 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 === undefined) {
+      publish({ status: 'unavailable', value: undefined, revision: undefined, writable })
+      return
+    }
+    publish({ status: 'ready', value: view.value, revision: view.revision, writable })
+  }
+  const refresh = (namespace?: unknown): void => {
+    if (namespace !== undefined && namespace !== ns) return
+    void load()
+  }
+  const disposers = [
+    c.get('remote').$on('settings/document-updated', refresh),
+    c.on('connection/reset', () => {
+      void load()
+    }),
+  ]
+  c.effect(
+    () => () => {
+      for (const dispose of disposers) dispose()
+    },
+    'notify-email: settings scope',
+  )
+  void load()
+  return {
+    getSnapshot: () => state,
+    subscribe: (listener: () => void) => {
+      listeners.add(listener)
+      return () => {
+        listeners.delete(listener)
+      }
+    },
+    load,
+  }
+}
+
 export function apply(ctx: Context): void {
   const c = ctx as unknown as ClientContext
   const tag = injectStyle()
@@ -66,8 +129,8 @@ export function apply(ctx: Context): void {
     () => c.locale.register(NS, { zh, en }),
     'notify-email: locale',
   )
-  const scope = c.settingsScope.bind({ namespace: SETTINGS_NS })
   const api = c.get('connection').api.settings
+  const scope = createApiScope(api, SETTINGS_NS, c)
   c.slots.inject('settings.plugin.item', () =>
     c.slots.register(
       {

package/src/client/scope.ts

@@ -1,9 +1,13 @@
 /**
  * 浏览器半 settingsScope/connection 的最小本地接口声明。
  * 只声明本插件用到的窄面，避免为构建期类型引入整条官方 client 依赖树；
- * 运行时契约以官方 dsh-client-ui-settings 的 settingsScope 服务与
- * dsh-client-connection 的 settings RPC 面为准（rc7：白名单已移除，
- * 任何已注册命名空间均可 describe/update/replace）。
+ * 运行时契约以官方 dsh-client-connection 的 settings RPC 面为准
+ * （rc7：白名单已移除，任何已注册命名空间均可 describe/update/replace）。
+ *
+ * 实现说明：本插件不复用 settingsScope 服务的 bind()——它在非 loopback
+ * 页面（如经 tailnet 域名访问）下走 memory 模式、永远无数据；这里按官方
+ * 配置页 tab 的同款模式用 `api.settings` 直连实现 Scope（describe 读 +
+ * remote `settings/document-updated` / `connection/reset` 刷新，见 client.ts）。
  * @module notify-email/client/scope
  */
 
@@ -18,7 +22,7 @@ export interface ScopeSnapshot {
   writable: boolean
 }
 
-/** settingsScope.bind({namespace}) 返回的控制器面。 */
+/** settingsScope.bind({namespace}) 返回的控制器面（本插件由 api 直连实现）。 */
 export interface Scope {
   getSnapshot(): ScopeSnapshot
   subscribe(listener: () => void): () => void
@@ -27,7 +31,7 @@ export interface Scope {
 
 /** connection api.settings 的 RPC 面（本插件用到的三个方法）。 */
 export interface SettingsApi {
-  describe(): Promise<{ result: { ok: boolean; value?: { namespaces: Array<{ ns: string; secrets: Array<{ path: string[]; set: boolean }> }> }; error?: { message?: string } } }>
+  describe(payload?: Record<string, never>): Promise<{ result: { ok: boolean; value?: { writable: boolean; namespaces: Array<{ ns: string; value: unknown; revision: number; secrets: Array<{ path: string[]; set: boolean }> }> }; error?: { message?: string } } }>
   update(request: { ns: string; patch: Record<string, unknown>; expectedRevision?: number }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
   replace(request: { ns: string; section: Record<string, unknown>; expectedRevision?: number }): Promise<{ result: { ok: boolean; error?: { message?: string } } }>
 }

package/src/service.ts

@@ -94,6 +94,11 @@ export class NotifyEmailService extends Service {
     )
   }
 
+  /** 通用直发接口（如 lifeboat 故障告警）：走正常 enabled/完整性门禁。 */
+  async sendNotice(notice: { subject: string; text: string }): Promise<{ ok: boolean; detail: string }> {
+    return this.mailer.send(notice)
+  }
+
   private async dispatch<T>(
     kind: string,
     payload: T,