dsh-auth-remote 0.1.8 → 0.1.10
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/CHANGELOG.md +19 -1
- package/CHANGELOG.zh-CN.md +19 -1
- package/CONTRIBUTING.md +1 -1
- package/CONTRIBUTING.zh-CN.md +1 -1
- package/README.md +35 -13
- package/README.zh-CN.md +35 -13
- package/cordis.patch.yml +2 -1
- package/dist/cli.js +125 -30
- package/dist/cli.js.map +2 -2
- package/dist/client.js +3196 -441
- package/dist/client.js.map +4 -4
- package/dist/index.js +472 -42
- package/dist/index.js.map +3 -3
- package/dist/login.css +2 -8
- package/dist/login.css.map +2 -2
- package/dist/login.js +114 -26
- package/dist/login.js.map +2 -2
- package/dist/types/adapters/dsh/account-callback.d.ts +15 -0
- package/dist/types/adapters/dsh/account-callback.d.ts.map +1 -0
- package/dist/types/adapters/dsh/browser-capability.d.ts +1 -1
- package/dist/types/adapters/dsh/browser-capability.d.ts.map +1 -1
- package/dist/types/adapters/dsh/hmr-context.d.ts +10 -0
- package/dist/types/adapters/dsh/hmr-context.d.ts.map +1 -0
- package/dist/types/adapters/dsh/webserver.d.ts +3 -0
- package/dist/types/adapters/dsh/webserver.d.ts.map +1 -1
- package/dist/types/auth/service.d.ts +2 -0
- package/dist/types/auth/service.d.ts.map +1 -1
- package/dist/types/auth/sessions.d.ts +2 -0
- package/dist/types/auth/sessions.d.ts.map +1 -1
- package/dist/types/config.d.ts +9 -3
- package/dist/types/config.d.ts.map +1 -1
- package/dist/types/http/account-login.d.ts +45 -0
- package/dist/types/http/account-login.d.ts.map +1 -0
- package/dist/types/http/routes.d.ts +16 -1
- package/dist/types/http/routes.d.ts.map +1 -1
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/shared/account-login.d.ts +22 -0
- package/dist/types/shared/account-login.d.ts.map +1 -0
- package/dist/types/shared/auth-contract.d.ts +2 -0
- package/dist/types/shared/auth-contract.d.ts.map +1 -1
- package/dist/types/shared/i18n.d.ts +112 -24
- package/dist/types/shared/i18n.d.ts.map +1 -1
- package/dist/types/shared/locales/en.d.ts +56 -12
- package/dist/types/shared/locales/en.d.ts.map +1 -1
- package/dist/types/shared/locales/zh.d.ts +56 -12
- package/dist/types/shared/locales/zh.d.ts.map +1 -1
- package/docs/deployment.md +24 -17
- package/docs/deployment.zh-CN.md +24 -17
- package/docs/development.md +29 -7
- package/docs/development.zh-CN.md +29 -7
- package/docs/legacy-compatibility.md +192 -117
- package/docs/legacy-compatibility.zh-CN.md +192 -0
- package/docs/releasing.md +6 -6
- package/docs/releasing.zh-CN.md +6 -6
- package/docs/reverse-proxy.md +2 -2
- package/docs/reverse-proxy.zh-CN.md +2 -2
- package/examples/web-profile-auth-remote.patch.yml +4 -2
- package/package.json +31 -13
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
[English](development.md)
|
|
4
4
|
|
|
5
|
-
开发和完整测试需要 Linux(profile 锁依赖 `/proc`)、Node.js 24+、pnpm 12.5.1,以及 DSH `0.2.1-alpha.
|
|
5
|
+
开发和完整测试需要 Linux(profile 锁依赖 `/proc`)、Node.js 24+、pnpm 12.5.1,以及 DSH `0.2.1-alpha.5`。浏览器测试使用 Playwright 管理的 Chromium 和 Node HTTP/HTTPS 转发器。
|
|
6
6
|
|
|
7
|
-
兼容声明或适配变更前,先阅读 [Legacy 兼容维护清单](legacy-compatibility.md)。共同复核运行时准入、测试目标、CI
|
|
7
|
+
兼容声明或适配变更前,先阅读 [Legacy 兼容维护清单](legacy-compatibility.zh-CN.md)。共同复核运行时准入、测试目标、CI 和用户声明;适用版本退出支持集合时同次清理专属运行时代码及测试。旧插件配置按自身迁移策略退役,保留共享安全逻辑,并用完整版本号与精确版本证据同步更新中英文清单及两个维度的矩阵。
|
|
8
8
|
|
|
9
9
|
## 准备和检查源码检出
|
|
10
10
|
|
|
@@ -16,7 +16,7 @@ pnpm pack:local
|
|
|
16
16
|
pnpm smoke
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
`pnpm check` 依次执行类型、格式、构建、包/部署/文档检查,以及单元、集成、CLI 和浏览器测试。`pnpm pack:local` 在静态检查后写出 `artifacts/dsh-auth-remote-0.1.
|
|
19
|
+
`pnpm check` 依次执行类型、格式、构建、包/部署/文档检查,以及单元、集成、CLI 和浏览器测试。`pnpm pack:local` 在静态检查后写出 `artifacts/dsh-auth-remote-0.1.10.tgz`,不会发布。`pnpm smoke` 将包安装到隔离 DSH_HOME,短暂启动固定版本的 DSH,验证就绪、匿名重定向/拒绝和在线 CLI 状态,然后停止。
|
|
20
20
|
|
|
21
21
|
## 使用隔离开发 profile
|
|
22
22
|
|
|
@@ -31,22 +31,24 @@ pnpm dev:start
|
|
|
31
31
|
直接查看状态时显式使用同一隔离 home:
|
|
32
32
|
|
|
33
33
|
```sh
|
|
34
|
-
DSH_HOME="$PWD/.dev/dsh-home" "$PWD/.dev/runtime-0.2.1-alpha.
|
|
34
|
+
DSH_HOME="$PWD/.dev/dsh-home" "$PWD/.dev/runtime-0.2.1-alpha.5/node_modules/.bin/dsh" plugin --profile web exec dsh-auth-remote status --json
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
开发 home 可能含测试账号数据,须保持私有,不要提交或复制到部署 profile。
|
|
38
38
|
|
|
39
39
|
## 测试边界
|
|
40
40
|
|
|
41
|
-
`pnpm test:unit` 覆盖认证状态机、TOTP、备用码、来源策略、翻译、存储持久性和锁恢复。`pnpm test:integration` 使用真实 HTTP/WebSocket socket 验证原生就绪、Cookie、来源判定与撤销。`pnpm test:cli` 构建真实压缩包,并用隔离 profile/Unix socket 验证交互与非交互命令。`pnpm test:browser` 用临时 profile 启动所选的 DSH
|
|
41
|
+
`pnpm test:unit` 覆盖认证状态机、TOTP、备用码、来源策略、翻译、存储持久性和锁恢复。`pnpm test:integration` 使用真实 HTTP/WebSocket socket 验证原生就绪、Cookie、来源判定与撤销。`pnpm test:cli` 构建真实压缩包,并用隔离 profile/Unix socket 验证交互与非交互命令。`pnpm test:browser` 用临时 profile 启动所选的 DSH 版本,验证登录、安全与登录页、原生设置、工作区、上传/预览、SSE、WebSocket 和 HTTPS 转发链。
|
|
42
42
|
|
|
43
|
-
浏览器网络链路使用 Node HTTP/HTTPS 转发器。`tests/fixtures/tls/` 下的专用自签证书与私钥仅为测试夹具,不进入安装包,也不是部署凭证。聊天使用本地模型替身;不执行真实第三方授权或付费模型请求。默认浏览器为 Playwright Chromium;`DSH_TEST_BROWSER` 可选择本地浏览器程序,`DSH_TEST_BIN` 仅在报告所选精确版本(默认 `0.2.1-alpha.
|
|
43
|
+
浏览器网络链路使用 Node HTTP/HTTPS 转发器。`tests/fixtures/tls/` 下的专用自签证书与私钥仅为测试夹具,不进入安装包,也不是部署凭证。聊天使用本地模型替身;不执行真实第三方授权或付费模型请求。默认浏览器为 Playwright Chromium;`DSH_TEST_BROWSER` 可选择本地浏览器程序,`DSH_TEST_BIN` 仅在报告所选精确版本(默认 `0.2.1-alpha.5`)时可替换 DSH 二进制。
|
|
44
44
|
|
|
45
45
|
DSH 测试运行时位于 `.cache/test-runtime/<version>`,与源码依赖分别固定。宿主服务和 React 不打入客户端 bundle。[部署指南](deployment.zh-CN.md)说明 profile 与备份规则。
|
|
46
46
|
|
|
47
|
+
隔离验证安装使用 pnpm 的文件复制模式,避免不同 profile 共享包文件的硬链接元数据变化触发 DSH 客户端热重载。
|
|
48
|
+
|
|
47
49
|
## 跨版本验证
|
|
48
50
|
|
|
49
|
-
默认测试 DSH `0.2.1-alpha.
|
|
51
|
+
默认测试 DSH `0.2.1-alpha.5`;`DSH_TEST_VERSION` 可选择 `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2`、`0.2.1-alpha.3`、`0.2.1-alpha.4` 或 `0.2.1-alpha.5`,测试运行时分别位于 `.cache/test-runtime/<version>`,开发运行时位于 `.dev/runtime-<version>`。`DSH_TEST_BIN` 必须报告所选的精确版本。CI 对九版分别运行 CLI、安装冒烟和浏览器测试。开发类型和集成测试使用锁定的 DSH `0.2.1-alpha.5` 包。源码检出目录的测试指南(`tests/README.zh-CN.md`)说明真实 Loader/模型地址核对,以及原生 IPv6/TLS 正向或不支持能力的断言;原生测试传输不可用时失败,不跳过。
|
|
50
52
|
|
|
51
53
|
```sh
|
|
52
54
|
DSH_TEST_VERSION=0.1.7-rc.1 pnpm test:cli
|
|
@@ -59,8 +61,28 @@ DSH_TEST_VERSION=0.2.0-rc.2 pnpm test:cli
|
|
|
59
61
|
DSH_TEST_VERSION=0.2.0-rc.2 pnpm test:browser
|
|
60
62
|
DSH_TEST_VERSION=0.2.1-alpha.1 pnpm test:cli
|
|
61
63
|
DSH_TEST_VERSION=0.2.1-alpha.1 pnpm test:browser
|
|
64
|
+
DSH_TEST_VERSION=0.2.1-alpha.2 pnpm test:cli
|
|
65
|
+
DSH_TEST_VERSION=0.2.1-alpha.2 pnpm test:browser
|
|
66
|
+
DSH_TEST_VERSION=0.2.1-alpha.3 pnpm test:cli
|
|
67
|
+
DSH_TEST_VERSION=0.2.1-alpha.3 pnpm test:browser
|
|
68
|
+
DSH_TEST_VERSION=0.2.1-alpha.4 pnpm test:cli
|
|
69
|
+
DSH_TEST_VERSION=0.2.1-alpha.4 pnpm test:browser
|
|
62
70
|
pnpm test:cli
|
|
63
71
|
pnpm test:browser
|
|
64
72
|
```
|
|
65
73
|
|
|
66
74
|
浏览器测试把浅色/深色、桌面/窄屏截图保存在 `.cache/ui-review/<version>`,供人工检查。安全页的 CSS 在插件生效时注入、销毁时移除,所有选择器只作用于插件页面,并直接引用宿主 `--dsw-*` 主题变量。独立登录页使用 dsh 0.2.0-rc.1 的主题变量子集并跟随系统配色,不读取登录前不可用的宿主设置。
|
|
75
|
+
|
|
76
|
+
官方账号专项测试使用本地平台替身与真实 DSH `0.2.1-alpha.5` 账号提供者,验证兑换保留原始 redirect URI 和 PKCE verifier,以及错误 state/URL/会话、重复提交、取消、过期和重试。浏览器覆盖账号菜单与引导中的先说明弹窗、回环导航失败后粘贴确认、弹窗拦截、动态语言与浅深色响应式布局。这些测试不会建立真实官方账号授权。
|
|
77
|
+
|
|
78
|
+
账号核心测试从锁定的开发依赖加载精确版本提供者,无需预先存在 CLI 运行时缓存;浏览器测试仍使用隔离 DSH profile 中实际安装的提供者。
|
|
79
|
+
|
|
80
|
+
此临时适配按 `>=0.2.1-alpha.3`(包含预发布)加必要能力与动态配置准入;完整手动功能回归覆盖 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5`。DSH `0.1.7-rc.1`、`0.1.7-rc.2`、`0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-alpha.1`、`0.2.1-alpha.2` 验证基础认证、完整安全与登录交互、动态配置持久化及手动能力不可用反馈。未来准入不构成已验证声明。支持范围或共享宿主适配变更须以同一最终 tgz 完整运行九版 CLI、浏览器及 smoke;循环内直接运行测试文件和 smoke:packed,不能调用会重新打包的 test:cli/test:browser/smoke,并在每版后校验 SHA-256。公网回调证据、迁移及退役条件见兼容维护清单的 `DSH-ACCOUNT-001`。
|
|
81
|
+
|
|
82
|
+
`live-config.spec.ts` 仅观察真实 Loader 的配置引用/fiber、认证/存储实例、锁、监听器及 SSE/WebSocket 连续性,核对实际依赖链并重启验证 profile override;不伪造服务。安全弹窗回归覆盖取消/错误、焦点/键盘、默认及强制 TOTP、一次性备用码复制与会话撤销后跳转保持。任务文档、测试凭证、profile、截图及生成目录不得进入 npm 包。
|
|
83
|
+
|
|
84
|
+
`account-login.spec.ts` 还在每个声明版本验证真实原生配置 HMR:修改普通字段 `sessionHours` 重建监听器,之后独立 Settings 写入必须等待已有原生事务,而真正嵌套仍被拒绝。在 `0.2.1-alpha.3`、`0.2.1-alpha.4`、`0.2.1-alpha.5` 额外修改隔离安装的插件代码,验证原生模块替换后可以重新开启手动登录。测试专用事务探针调用真实 HMR,不替代服务且不进入 npm 包。监听器上下文的最小适配见 `DSH-HMR-001`。
|
|
85
|
+
|
|
86
|
+
账号配置绑定通过原生 describe 镜像的 `ensure()` API 恢复首次读取失败;已有镜像中的命名空间恢复使用明确注入的 `remote.settings` 传输,并将已接纳值回填到同一镜像。偏好加载期间点击登录会等待共享读取,再按最新接纳的 true/false 值选择入口;加载中不等同于关闭。浏览器回归覆盖首次读取失败、命名空间暂缺,以及两种路由选择的延迟读取。
|
|
87
|
+
|
|
88
|
+
`browser/host-release.spec.ts` 在 `0.2.1-alpha.4`、`0.2.1-alpha.5` 运行:前者准备真实 `0.2.1-alpha.3`,后者准备真实 `0.2.1-alpha.4`。每项均在同一临时 profile/端口切换宿主,保留页面并检查原生版本刷新提示;刷新后核对认证、原会话与已保存配置,再恢复起始版本。`0.2.1-alpha.3` 目的宿主没有 release 元数据,显示未解析;`0.2.1-alpha.4` 目的宿主须显示真实版本。不伪造上游源码、版本或依赖图元数据。
|