dsh-config-manager 0.1.17 → 0.1.18

package/lib/client.d.ts

@@ -412,6 +412,33 @@ interface SyncPullPayload extends SyncPushPayload {
   strategy?: 'merge' | 'replace' | 'skipExisting';
   snapshotId?: string;
 }
+/** POST /sync/github/start 响应：UI 展示用（device_code 只存宿主，绝不回传） */
+interface GithubDeviceFlowStartResponse {
+  /** 随机 flowId：后续 poll/cancel 凭它引用宿主侧登记的 device_code */
+  flowId: string;
+  /** 一次性用户码（用户在 GitHub 授权页输入） */
+  userCode: string;
+  /** GitHub 授权页 URL（用户浏览器打开） */
+  verificationUri: string;
+  /** 设备码过期秒数 */
+  expiresIn: number;
+  /** GitHub 建议轮询间隔秒数 */
+  interval: number;
+}
+/** POST /sync/github/poll 响应状态 */
+type GithubPollStatus = 'pending' | 'success' | 'denied' | 'expired' | 'error';
+/** POST /sync/github/poll 响应：成功时 token 已由 Host 写入 DSH credentials（值永不回传） */
+interface GithubPollResponse {
+  status: GithubPollStatus;
+  /** pending：下次轮询前应等待的毫秒数 */
+  pollDelayMs?: number;
+  /** 终止态错误码（GitHub error code） */
+  errorCode?: string;
+  /** 终止态可展示消息（来自 GitHub error_description / 宿主文案，不含秘密） */
+  message?: string;
+  /** success 时恒 true（凭据已配置）；便于 UI 直接刷新状态 */
+  credentialConfigured?: boolean;
+}
 /** 远程同步浏览器半数据入口（备份与迁移页第 4 个 tab 的注入业务面） */
 declare class SyncApi {
   /** 读取同步状态（配置 / 凭据 / 上次同步时间 / 分区数） */
@@ -420,6 +447,14 @@ declare class SyncApi {
   push(payload: SyncPushPayload): Promise<SyncPushReport>;
   /** 拉取差异预览：拉取远端最新快照 → 只读分析（绝不执行导入） */
   pull(payload: SyncPullPayload): Promise<SyncPullReport>;
+  /** GitHub OAuth device flow：发起登录，返回一次性用户码 + 授权页 URL + flowId */
+  githubStart(): Promise<GithubDeviceFlowStartResponse>;
+  /** GitHub OAuth device flow：凭 flowId 轮询授权结果（成功时 token 已由 Host 写入 credentials） */
+  githubPoll(flowId: string): Promise<GithubPollResponse>;
+  /** GitHub OAuth device flow：取消（丢弃宿主侧登记，零副作用） */
+  githubCancel(flowId: string): Promise<{
+    ok: boolean;
+  }>;
 }
 //#endregion
 //#region src/client/client-types.d.ts
@@ -476,6 +511,8 @@ declare const zh$1: {
   readonly 'import.select.title': "选择备份文件";
   readonly 'import.select.hint': "选择本机导出的 dsh-config-*.zip 备份文件开始导入。分析阶段只读，不会修改任何配置。";
   readonly 'import.select.browse': "选择 ZIP 文件";
+  readonly 'import.select.reselect': "重新选择";
+  readonly 'import.select.cancel': "取消选择";
   readonly 'import.select.file': "已选择：{name}";
   readonly 'import.analyzing': "正在分析备份…";
   readonly 'import.compatibility.title': "兼容性";
@@ -568,6 +605,14 @@ declare const zh: {
   readonly 'config.tokenSaved': "凭据已配置";
   readonly 'config.gitBin': "git 可执行文件（可选）";
   readonly 'config.gitBinHint': "缺省使用 PATH 中的 git。";
+  readonly 'github.title': "GitHub 登录";
+  readonly 'github.description': "通过 GitHub OAuth 设备码流程授权：无需手动输入 token，在浏览器中确认授权后，token 自动写入 DSH credentials。";
+  readonly 'github.login': "使用 GitHub 登录";
+  readonly 'github.retry': "重新登录";
+  readonly 'github.cancel': "取消";
+  readonly 'github.userCode': "一次性授权代码";
+  readonly 'github.openAuth': "打开 GitHub 授权页面";
+  readonly 'github.clientIdHint': "需要插件配置 githubClientId（GitHub OAuth App 的 client_id）才能使用 GitHub 登录。";
   readonly 'status.title': "同步状态";
   readonly 'status.never': "从未同步";
   readonly 'action.push': "推送到远端";