@dsh-plus/access-gate 0.3.12 → 0.3.13

package/lib/client.js

@@ -42,7 +42,7 @@ window.__ModuleLoader__.load({
 							className: `${p}-pending`,
 							children: props.dirtyLabel
 						}) : null,
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, { className: `${p}-chevron${props.open ? ` ${p}-chevronOpen` : ""}` })
 					]
 				}), props.open ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: `${p}-body`,
@@ -379,8 +379,8 @@ ${extra}
 		* 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
 		* 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
 		* 本文件保留业务字段（白名单 textarea/诊断面板）与保存逻辑。
-		* 配置读写走官方 settingsScope 传输：value 为 schema 解析后的视图，
-		* 保存经 settings.update 深合并。
+		* 配置读写经共享层 ctx.remote.settings 直连（0.1.7 起 settingsScope 已由
+		* configForms 取代）：value 为 schema 解析后的视图，保存经 settings.update 深合并。
 		* 卡片顶部「当前页面诊断」读 /dsh-plus/gate/status（本页放行原因/客户端 IP/
 		* 官方 cookie 状态）。
 		*

package/lib/index.d.ts

@@ -1,18 +1,22 @@
 import { Context, Service } from "@deepseek-ai/cordis";
+import { UnwrapVolatile } from "@dsh-plus/shared";
 import z from "@deepseek-ai/schemastery";
 //#region src/config.d.ts
-declare const Config: z<Schemastery.ObjectS<{
-  enabled: z<boolean, boolean>;
-  allowedIps: z<string[], string[]>;
-  trustForwardedFor: z<boolean, boolean>;
-  autoLoginTrustedIps: z<boolean, boolean>;
-}>, Schemastery.ObjectT<{
-  enabled: z<boolean, boolean>;
-  allowedIps: z<string[], string[]>;
-  trustForwardedFor: z<boolean, boolean>;
-  autoLoginTrustedIps: z<boolean, boolean>;
-}>>;
-type AccessGateConfig = Schemastery.TypeT<typeof Config>;
+declare const Config: z<Schemastery.ObjectS<NoInfer<{
+  enabled: z<boolean, boolean, "volatile-defined">;
+  allowedIps: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+  trustForwardedFor: z<boolean, boolean, "volatile-defined">;
+  autoLoginTrustedIps: z<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+  enabled: z<boolean, boolean, "volatile-defined">;
+  allowedIps: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+  trustForwardedFor: z<boolean, boolean, "volatile-defined">;
+  autoLoginTrustedIps: z<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+type AccessGateConfigFields = Schemastery.TypeT<typeof Config>;
+/** 平面配置形态（服务与判定面的消费形态，由活动引用解包得到）。 */
+type AccessGateConfig = UnwrapVolatile<AccessGateConfigFields>;
 //#endregion
 //#region src/index.d.ts
 declare const name = "dsh-plus-access-gate";
@@ -22,12 +26,12 @@ declare module '@deepseek-ai/cordis' {
     accessGate: AccessGateService;
   }
 }
-/** 围栏服务：持有当前配置读取器（settings 用户层热更新经 setSource 注入）。 */
+/** 围栏服务：持有当前配置读取器（0.1.7 起为 volatile 活动引用的平面解包，读即最新）。 */
 declare class AccessGateService extends Service {
   private current;
   /** 官方 browser-auth 签名密钥（惰性读取缓存；读取失败 = null，autoLogin fail-safe 降级）。 */
   private signingSecret;
-  constructor(ctx: Context, config: AccessGateConfig);
+  constructor(ctx: Context, config: AccessGateConfig | AccessGateConfigFields);
   /** 当前生效配置（诊断用）。 */
   policy(): AccessGateConfig;
   /** 官方签名密钥（惰性缓存；失败返回 null 并记录，autoLogin 降级 fail-safe）。 */
@@ -37,6 +41,6 @@ declare class AccessGateService extends Service {
     warn(message: string): void;
   }): boolean;
 }
-declare function apply(ctx: Context, config: AccessGateConfig): void;
+declare function apply(ctx: Context, config: AccessGateConfig | AccessGateConfigFields): void;
 //#endregion
 export { AccessGateService, Config, apply, inject, name };

package/lib/index.js

@@ -1,10 +1,10 @@
 import { Service } from "@deepseek-ai/cordis";
 import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
+import { unwrapVolatile } from "@dsh-plus/shared";
 import z from "@deepseek-ai/schemastery";
 import { createHash, createHmac } from "node:crypto";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
-//#endregion
 //#region src/config.ts
 /**
 * 配置单一事实源：cordis 行级 Config（组合默认值，dev/prod patch 层可覆盖）
@@ -18,13 +18,11 @@ import { join } from "node:path";
 * schemastery 透传忽略，不阻断加载（已实测验证）。
 * @module access-gate/config
 */
-/** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
-const SETTINGS_NS = "dsh-plus-access-gate";
 const Config = z.object({
-	enabled: z.boolean().description("访问围栏总开关（false = 一切放行，等价插件缺席）").default(false),
-	allowedIps: z.array(z.string()).description("附加 IP 围栏：非空时仅白名单条目（精确 IP 或 CIDR，IPv4/IPv6 皆可）可通行与登录；空 = 不限制来源 IP（仅官方登录保护）").default([]),
-	trustForwardedFor: z.boolean().description("是否信任 x-forwarded-for 还原真实客户端 IP（仅当入口代理强制覆盖该头时开启；tailscale serve 满足）").default(true),
-	autoLoginTrustedIps: z.boolean().description("IP 信任自动登录：来源命中 allowedIps 白名单且未认证时，服务端自动签发官方登录 cookie（免启动 token，仅对白名单来源生效）；默认关闭，需显式开启").default(false)
+	enabled: z.boolean().description("访问围栏总开关（false = 一切放行，等价插件缺席）").default(false).volatile(),
+	allowedIps: z.array(z.string()).description("附加 IP 围栏：非空时仅白名单条目（精确 IP 或 CIDR，IPv4/IPv6 皆可）可通行与登录；空 = 不限制来源 IP（仅官方登录保护）").default([]).volatile(),
+	trustForwardedFor: z.boolean().description("是否信任 x-forwarded-for 还原真实客户端 IP（仅当入口代理强制覆盖该头时开启；tailscale serve 满足）").default(true).volatile(),
+	autoLoginTrustedIps: z.boolean().description("IP 信任自动登录：来源命中 allowedIps 白名单且未认证时，服务端自动签发官方登录 cookie（免启动 token，仅对白名单来源生效）；默认关闭，需显式开启").default(false).volatile()
 });
 //#endregion
 //#region src/cookie.ts
@@ -741,22 +739,14 @@ function assertGateStructure(server) {
 //#region src/index.ts
 const name = "dsh-plus-access-gate";
 const inject = ["webServer", "connection"];
-/** 围栏服务：持有当前配置读取器（settings 用户层热更新经 setSource 注入）。 */
+/** 围栏服务：持有当前配置读取器（0.1.7 起为 volatile 活动引用的平面解包，读即最新）。 */
 var AccessGateService = class extends Service {
 	current;
 	/** 官方 browser-auth 签名密钥（惰性读取缓存；读取失败 = null，autoLogin fail-safe 降级）。 */
 	signingSecret;
 	constructor(ctx, config) {
 		super(ctx, "accessGate");
-		this.current = () => config;
-		ctx.inject(["settings"], (settingsCtx) => {
-			settingsCtx.settings.installSection(ctx, SETTINGS_NS, Config, config, {
-				setSource: (source) => {
-					this.current = source;
-				},
-				onChange: () => {}
-			});
-		});
+		this.current = () => unwrapVolatile(config);
 		const logger = ctx.logger("access-gate");
 		const officialAuth = (req) => ctx.connection.requestRejection({ headers: req.headers }) === void 0;
 		const secretOf = () => this.readSigningSecret(logger);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plus/access-gate",
-  "version": "0.3.12",
+  "version": "0.3.13",
   "description": "dsh-plus service+ui plugin: dsh web 全量访问围栏——与官方 browser-auth 合并：官方 cookie 为唯一凭据，可选 IP 附加围栏，未认证导航渲染 token 输入页（PWA 可恢复），loopback 管理通道",
   "type": "module",
   "main": "lib/index.js",
@@ -31,21 +31,21 @@
     }
   },
   "dependencies": {
-    "@dsh-plus/shared": "0.1.21"
+    "@dsh-plus/shared": "0.1.22"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "3.18.2",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/react": "~18.3.31",
     "react": "^18.2.0"
   },

package/src/client/card.tsx

@@ -3,8 +3,8 @@
  * 与 0.1.6-alpha.2 插件页 plugins.row.config / plugins.bundle.config，view 分发 summary/page）。
  * 外壳与基础控件走 @dsh-plus/shared/client 套件（CardChrome/TextField/CheckRow），
  * 本文件保留业务字段（白名单 textarea/诊断面板）与保存逻辑。
- * 配置读写走官方 settingsScope 传输：value 为 schema 解析后的视图，
- * 保存经 settings.update 深合并。
+ * 配置读写经共享层 ctx.remote.settings 直连（0.1.7 起 settingsScope 已由
+ * configForms 取代）：value 为 schema 解析后的视图，保存经 settings.update 深合并。
  * 卡片顶部「当前页面诊断」读 /dsh-plus/gate/status（本页放行原因/客户端 IP/
  * 官方 cookie 状态）。
  *

package/src/client/client.ts

@@ -8,7 +8,7 @@
  * 类型说明：浏览器半只用到 slots/locale/remote 的很窄一面，
  * scope 与基础控件走 @dsh-plus/shared/client 套件（收编自本插件原实现）。
  * 配置读写经 ctx.remote.settings 直连（0.1.2-alpha.1 起 connection.api.settings
- * 已移除；不复用 settingsScope 服务——非 loopback 页面下它固定 memory 模式无数据）。
+ * 已移除；0.1.7 起 settingsScope 服务亦删除——configForms 取代，自始直连）。
  * 卡片 key/rowId 约定见 @dsh-plus/shared/client/config-slots。
  * @module @dsh-plus/access-gate/client
  */

package/src/config.ts

@@ -11,38 +11,49 @@
  * @module access-gate/config
  */
 import z from '@deepseek-ai/schemastery'
+import type { UnwrapVolatile } from '@dsh-plus/shared'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
 /** settings 命名空间（字面量即合法命名空间，0.1.2-alpha.2 起编译期校验；webui 配置卡片与插件运行期读取同一份）。 */
 export const SETTINGS_NS = NS_LITERAL
 
+// 0.1.7：全部字段 `.volatile()`——loader 解析为活动引用（用户层 override 并入
+// 行级 config，GUI 写入原位提交热生效），同时使本条目进入 settings describe
+// 视图（配置卡片可读写）；缺 volatile 标记的条目会被 describe 跳过。
 export const Config = z.object({
   enabled: z
     .boolean()
     .description('访问围栏总开关（false = 一切放行，等价插件缺席）')
-    .default(false),
+    .default(false)
+    .volatile(),
   allowedIps: z
     .array(z.string())
     .description(
       '附加 IP 围栏：非空时仅白名单条目（精确 IP 或 CIDR，IPv4/IPv6 皆可）可通行与登录；空 = 不限制来源 IP（仅官方登录保护）',
     )
-    .default([]),
+    .default([])
+    .volatile(),
   trustForwardedFor: z
     .boolean()
     .description(
       '是否信任 x-forwarded-for 还原真实客户端 IP（仅当入口代理强制覆盖该头时开启；tailscale serve 满足）',
     )
-    .default(true),
+    .default(true)
+    .volatile(),
   autoLoginTrustedIps: z
     .boolean()
     .description(
       'IP 信任自动登录：来源命中 allowedIps 白名单且未认证时，服务端自动签发官方登录 cookie（免启动 token，仅对白名单来源生效）；默认关闭，需显式开启',
     )
-    .default(false),
+    .default(false)
+    .volatile(),
 })
 
-export type AccessGateConfig = Schemastery.TypeT<typeof Config>
+/** 活动字段形态（0.1.7 loader 解析产物：volatile 字段为活动引用）。 */
+export type AccessGateConfigFields = Schemastery.TypeT<typeof Config>
+/** 平面配置形态（服务与判定面的消费形态，由活动引用解包得到）。 */
+export type AccessGateConfig = UnwrapVolatile<AccessGateConfigFields>
 
 /** 判定所需的最小配置视图（测试与决策函数共用窄面）。 */
 export interface GatePolicy {

package/src/index.ts

@@ -32,8 +32,9 @@ import { type Context, Service } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-client-connection'
 import { dshHomePath } from '@deepseek-ai/dsh-home-paths'
 import type {} from '@deepseek-ai/dsh-settings'
+import { unwrapVolatile } from '@dsh-plus/shared'
 
-import { type AccessGateConfig, Config, SETTINGS_NS } from './config.ts'
+import { type AccessGateConfig, type AccessGateConfigFields, Config } from './config.ts'
 import {
   credentialsPath,
   mintAutoLoginCookie,
@@ -55,25 +56,17 @@ declare module '@deepseek-ai/cordis' {
   }
 }
 
-/** 围栏服务：持有当前配置读取器（settings 用户层热更新经 setSource 注入）。 */
+/** 围栏服务：持有当前配置读取器（0.1.7 起为 volatile 活动引用的平面解包，读即最新）。 */
 export class AccessGateService extends Service {
   private current: () => AccessGateConfig
   /** 官方 browser-auth 签名密钥（惰性读取缓存；读取失败 = null，autoLogin fail-safe 降级）。 */
   private signingSecret: Buffer | null | undefined
 
-  constructor(ctx: Context, config: AccessGateConfig) {
+  constructor(ctx: Context, config: AccessGateConfig | AccessGateConfigFields) {
     super(ctx, 'accessGate')
-    this.current = () => config
-    // 官方 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: () => {},
-      })
-    })
+    // 0.1.7 替代 0.1.6 installSection/setSource：loader 解析层已把用户层
+    // override 并入行级 config 并以活动引用原位提交，current() 现取即热。
+    this.current = () => unwrapVolatile(config)
     const logger = ctx.logger('access-gate')
 
     // 官方凭据校验委托：undefined = 已通过（含官方 Host 信任围栏）。
@@ -142,6 +135,6 @@ export class AccessGateService extends Service {
   }
 }
 
-export function apply(ctx: Context, config: AccessGateConfig): void {
+export function apply(ctx: Context, config: AccessGateConfig | AccessGateConfigFields): void {
   ctx.plugin(AccessGateService, config)
 }