@dsh-plus/notify-email 0.1.22 → 0.1.23

package/lib/client.js

@@ -168,7 +168,10 @@ window.__ModuleLoader__.load({
 			confirm: "Confirm",
 			cancel: "Cancel"
 		};
-		/** own 覆盖同键合并（返回新对象，入参不可变）。 */
+		/**
+		* own 覆盖同键合并（返回新对象，入参不可变）。
+		* 返回类型保留两侧键集合，调用方据此派生 DictKey。
+		*/
 		function mergeDict(base, own) {
 			return {
 				...base,

package/lib/index.d.ts

@@ -148,7 +148,7 @@ declare class NotifyEmailService extends Service {
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-notify-email";
-declare const inject: readonly ["agents", "tools", "credentials"];
+declare const inject: readonly ['agents', 'tools', 'credentials'];
 declare function apply(ctx: Context, config: NotifyEmailConfig): void;
 //#endregion
 export { Config, type DecisionCall, type EmailNotice, NotifyEmailService, type NotifyTrigger, type TurnEndInfo, apply, inject, name };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/notify-email",
-  "version": "0.1.22",
+  "version": "0.1.23",
   "description": "dsh-plus service+ui plugin: 任务结束/等待决策/出错时向指定邮箱发送邮件通知",
   "type": "module",
   "main": "lib/index.js",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "nodemailer": "9.0.6",
-    "@dsh-plus/shared": "0.1.15"
+    "@dsh-plus/shared": "0.1.16"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/src/client/card.tsx

@@ -22,9 +22,10 @@ import {
 import { type ReactElement, useEffect, useMemo, useState, useSyncExternalStore } from 'react'
 import { SETTINGS_NS } from '../ns.ts'
 import { sendTest } from './api.ts'
+import type { Translate } from './i18n.ts'
 
 export interface CardProps {
-  t(key: string): string
+  t: Translate
   scope: Scope
   api: NamespaceSettingsApi
 }

package/src/client/client.ts

@@ -19,39 +19,19 @@ import {
   createNamespaceApi,
   createSettingsScope,
   injectCardStyle,
-  type SettingsRemoteFace,
+  type PluginClientContext,
 } from '@dsh-plus/shared/client'
 import { SETTINGS_NS } from '../ns.ts'
 import { NotifyEmailCard } from './card.tsx'
-import { en, NS, zh } from './i18n.ts'
+import { type DictKey, 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', 'remote', 'remote.settings'] as const
 
-interface SlotsLike {
-  inject(key: string, callback: () => unknown): unknown
-  register(options: Record<string, unknown>, component: unknown): () => void
-}
-
-interface LocaleLike {
-  register(ns: string, dict: { zh: Record<string, string>; en: Record<string, string> }): () => void
-  bind(ns: string): (key: string) => string
-}
-
-interface RemoteLike {
-  settings: SettingsRemoteFace
-  $on(event: string, listener: (payload?: unknown) => void): () => void
-}
-
-interface ClientContext {
-  slots: SlotsLike
-  locale: LocaleLike
-  get(key: 'remote'): RemoteLike
-  on(event: string, listener: () => void): () => void
-  effect(execute: () => () => void, label?: string): unknown
-}
+/** 宿主窄面收编在 @dsh-plus/shared/client；TKey 传入本包 DictKey 使键名受检。 */
+type ClientContext = PluginClientContext<DictKey>
 
 export function apply(ctx: Context): void {
   const c = ctx as unknown as ClientContext

package/src/client/i18n.ts

@@ -43,7 +43,7 @@ const ownZh = {
   testDryRun: '已按 dry-run 记录日志（未真实发送）。',
   testFailed: '测试发送失败：',
   incomplete: 'SMTP 配置不完整（服务器/发件地址/收件人必填）。',
-}
+} as const
 
 const ownEn = {
   title: 'Email notifications',
@@ -81,7 +81,13 @@ const ownEn = {
   testDryRun: 'Logged in dry-run mode (not sent).',
   testFailed: 'Test send failed: ',
   incomplete: 'SMTP config incomplete (host/from/recipients required).',
-}
+} as const
 
-export const zh: Record<string, string> = mergeDict(commonZh, ownZh)
-export const en: Record<string, string> = mergeDict(commonEn, ownEn)
+export type DictKey = keyof typeof commonZh | keyof typeof ownZh
+
+/** 卡片/面板共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
+export type Translate = (key: DictKey) => string
+
+// 标注为 Record<DictKey, string>：en 缺任一键即编译期报错（中英强制对齐）。
+export const zh: Record<DictKey, string> = mergeDict(commonZh, ownZh)
+export const en: Record<DictKey, string> = mergeDict(commonEn, ownEn)

package/src/mailer.ts

@@ -83,8 +83,10 @@ export class Mailer {
   private readonly resolveConfig: () => NotifyEmailConfig
   private readonly logger: MailLogger
   private readonly transport: Transport
-  private readonly audit?: AuditSink
-  private readonly credentials?: CredentialsSeamLike
+  // 构造期无条件赋值，故为「必需但可为 undefined」：exactOptionalPropertyTypes
+  // 下可选属性不允许显式赋 undefined。
+  private readonly audit: AuditSink | undefined
+  private readonly credentials: CredentialsSeamLike | undefined
 
   constructor(
     resolveConfig: () => NotifyEmailConfig,

package/src/watchers/turn-end.ts

@@ -18,8 +18,11 @@ import type { NotifyEmailService } from '../service.ts'
 const NOTIFY_KINDS = new Set(['completed', 'error', 'aborted'])
 
 interface SessionWatch {
-  lastDelivery?: string
-  timer?: ReturnType<typeof setTimeout>
+  // 显式并上 undefined：这些字段会被反复赋 undefined 以清空状态
+  // （如 `watch.timer = undefined` 取消定时器），exactOptionalPropertyTypes
+  // 下可选属性不允许该写法。
+  lastDelivery?: string | undefined
+  timer?: ReturnType<typeof setTimeout> | undefined
   readonly notified: Set<string>
 }