@synopackageland/cli 0.5.3 → 0.6.1

package/templates/native-go-jobs/frontend/src/background/i18n/ja.json

@@ -0,0 +1,75 @@
+{
+  "title": "バックグラウンドジョブ",
+  "help": "選択したファイルをパッケージにコピーし、パッケージアカウントで SHA-256 を計算します。サインアウト後も処理は継続します。コピーと結果はパッケージが保存し、元ファイルの権限変更では回収されません。再度サインインすると自分の結果を確認できます。",
+  "worker": "ワーカー",
+  "workerRunning": "ワーカーは {user} として実行中です",
+  "workerStopped": "ワーカーは停止しています",
+  "chooseFile": "ファイルを選択",
+  "chosen": "選択したファイル: {path}",
+  "pickerTitle": "インポートするファイルを選択",
+  "pickerConsent": "選択したファイルは現在の DSM サインインで一度だけ読み取られ、バックグラウンドジョブに渡されます。権限は保存されません。",
+  "submit": "インポートして送信",
+  "refresh": "更新",
+  "cancel": "キャンセル",
+  "result": "結果",
+  "download": "結果をダウンロード",
+  "noJobs": "ジョブはまだありません",
+  "state_queued": "待機中",
+  "state_running": "実行中",
+  "state_succeeded": "成功",
+  "state_failed": "失敗",
+  "state_canceled": "キャンセル済み",
+  "state_interrupted": "中断",
+  "limits": "1 ファイル最大 {size} KiB、キュー {queue} 件、1 ジョブ {seconds} 秒。",
+  "errors": {
+    "jobs_busy": "処理が混み合っています。しばらくしてから再試行してください。",
+    "failed": "要求を完了できませんでした。更新して再試行してください。",
+    "limit-exceeded": "ファイルが上限を超えています。",
+    "queue-full": "キューがいっぱいです。",
+    "quota-exceeded": "バックグラウンド用の容量がいっぱいです。",
+    "conflict": "ジョブの状態が変わりました。更新してください。",
+    "not_found": "見つかりません。",
+    "denied": "アクセスが拒否されました。",
+    "session_required": "DSM セッションの有効期限が切れました。再度サインインしてください。",
+    "owner-queue-full": "保留中ジョブの上限です。完了を待つか、ジョブをキャンセルしてください。",
+    "owner-quota-exceeded": "保存領域の上限です。管理者に古いジョブの消去を依頼してください。",
+    "identity_unavailable": "DSM ユーザーの UID を確認できません。再度サインインするか、管理者に連絡してください。",
+    "schedule-full": "スケジュールは最大 8 件です。削除してください。",
+    "input-unavailable": "非公開コピーがないか変更されています。再度インポートしてください。",
+    "unsupported": "バックグラウンドジョブを利用できません。更新して再試行してください。"
+  },
+  "ownerScope": "自分のジョブのみ表示、キャンセル、ダウンロードできます。",
+  "adminScope": "管理者はすべてのユーザーのジョブを表示、キャンセルできます。",
+  "ownerLimits": "ユーザーごとの上限：保留中 {jobs} 件、入力と予約済み結果の保存領域 {size} KiB。",
+  "owner": "所有者：{user}（UID {uid}）",
+  "purgeOwner": "所有者のジョブを消去",
+  "purgeConfirm": "{user}（UID {uid}）の全ジョブを消去しますか？実行中のジョブはキャンセルして終了を待ち、保存済み結果は削除します。",
+  "confirmPurge": "消去を確認",
+  "keepJobs": "ジョブを保持",
+  "schedulesTitle": "スケジュール",
+  "scheduleHelp": "パッケージユーザーとして固定の非公開コピーを毎時、毎日、毎週再計算します。最大 8 件。逃した実行は記録のみで再実行しません。",
+  "scheduleCopy": "このコピーを定期実行",
+  "scheduleSource": "非公開コピー：{name}",
+  "interval": "繰り返し間隔",
+  "hourly": "毎時",
+  "daily": "毎日",
+  "weekly": "毎週",
+  "scheduleConsent": "固定コピーを保存し、パッケージユーザーとして再計算することに同意します。新しい元ファイルや個人 ACL は読みません。",
+  "createSchedule": "スケジュールを作成",
+  "noSchedules": "スケジュールはありません",
+  "scheduleOn": "有効",
+  "scheduleOff": "無効",
+  "nextRun": "次回実行：{time}",
+  "missedRuns": "逃した実行：{count} 回",
+  "disableSchedule": "スケジュールを無効化",
+  "deleteSchedule": "スケジュールを削除",
+  "deleteScheduleConsent": "{name} のスケジュールを削除しますか？待機中のジョブは取り消され、実行中のジョブは停止処理を行います。完了した結果は残ります。",
+  "confirmDeleteSchedule": "削除を確認",
+  "enableSchedule": "スケジュールを有効化",
+  "enableScheduleConsent": "現在のワーカーリビジョンで {name} のスケジュールを有効にしますか？固定コピーの再計算に同意します。過去の実行は再生しません。",
+  "confirmEnableSchedule": "有効化を確認",
+  "revisionChanged": "ワーカーのリビジョンが変更されました。管理者が確認して明示的に有効にしてください。",
+  "scheduledJob": "定期実行",
+  "unknownTime": "不明",
+  "unsupported": "バックグラウンドジョブを利用できません。更新して再試行してください。"
+}

package/templates/native-go-jobs/frontend/src/background/i18n/ko.json

@@ -0,0 +1,75 @@
+{
+  "title": "백그라운드 작업",
+  "help": "선택한 파일 하나를 패키지에 복사하고 패키지 계정으로 SHA-256을 계산합니다. 로그아웃 후에도 작업은 계속됩니다. 복사본과 결과는 패키지가 보관하며 원본 권한 변경으로 회수되지 않습니다. 다시 로그인하여 자신의 결과를 확인하세요.",
+  "worker": "워커",
+  "workerRunning": "워커가 {user} 계정으로 실행 중",
+  "workerStopped": "워커가 실행 중이 아닙니다",
+  "chooseFile": "파일 선택",
+  "chosen": "선택한 파일: {path}",
+  "pickerTitle": "가져올 파일 선택",
+  "pickerConsent": "선택한 파일은 현재 DSM 로그인으로 한 번만 읽어 백그라운드 작업에 전달됩니다. 권한은 저장되지 않습니다.",
+  "submit": "가져오기 및 제출",
+  "refresh": "새로 고침",
+  "cancel": "취소",
+  "result": "결과",
+  "download": "결과 다운로드",
+  "noJobs": "작업이 없습니다",
+  "state_queued": "대기 중",
+  "state_running": "실행 중",
+  "state_succeeded": "성공",
+  "state_failed": "실패",
+  "state_canceled": "취소됨",
+  "state_interrupted": "중단됨",
+  "limits": "파일당 최대 {size} KiB, 대기 {queue}개, 작업당 {seconds}초.",
+  "errors": {
+    "jobs_busy": "처리 중입니다. 잠시 후 다시 시도해 주세요.",
+    "failed": "요청을 완료할 수 없습니다. 새로 고친 후 다시 시도하세요.",
+    "limit-exceeded": "파일이 한도를 초과했습니다.",
+    "queue-full": "대기열이 가득 찼습니다.",
+    "quota-exceeded": "백그라운드 저장 공간이 가득 찼습니다.",
+    "conflict": "작업 상태가 변경되었습니다. 새로 고치세요.",
+    "not_found": "찾을 수 없습니다.",
+    "denied": "액세스가 거부되었습니다.",
+    "session_required": "DSM 세션이 만료되었습니다. 다시 로그인하세요.",
+    "owner-queue-full": "대기 작업 한도에 도달했습니다. 완료를 기다리거나 작업 하나를 취소하세요.",
+    "owner-quota-exceeded": "저장 공간 한도에 도달했습니다. 관리자에게 이전 작업 삭제를 요청하세요.",
+    "identity_unavailable": "DSM 사용자 UID를 확인할 수 없습니다. 다시 로그인하거나 관리자에게 문의하세요.",
+    "schedule-full": "일정은 최대 8개입니다. 일정을 삭제하세요.",
+    "input-unavailable": "비공개 사본이 없거나 변경되었습니다. 다시 가져오세요.",
+    "unsupported": "백그라운드 작업을 사용할 수 없습니다. 새로 고친 후 다시 시도하세요."
+  },
+  "ownerScope": "자신의 작업만 보고 취소하고 다운로드할 수 있습니다.",
+  "adminScope": "관리자는 모든 사용자의 작업을 보고 취소할 수 있습니다.",
+  "ownerLimits": "사용자당 한도: 대기 중인 작업 {jobs}개, 입력 및 결과 예약 저장 공간 {size} KiB.",
+  "owner": "소유자: {user} (UID {uid})",
+  "purgeOwner": "소유자의 작업 지우기",
+  "purgeConfirm": "{user} (UID {uid})의 모든 작업을 지울까요? 실행 중인 작업은 취소 후 종료를 기다리며 저장된 결과는 삭제됩니다.",
+  "confirmPurge": "지우기 확인",
+  "keepJobs": "작업 유지",
+  "schedulesTitle": "일정",
+  "scheduleHelp": "패키지 사용자로 고정된 비공개 사본을 매시간, 매일 또는 매주 다시 계산합니다. 최대 8개 일정. 놓친 실행은 기록만 하며 다시 실행하지 않습니다.",
+  "scheduleCopy": "이 사본 예약",
+  "scheduleSource": "비공개 사본: {name}",
+  "interval": "반복 간격",
+  "hourly": "매시간",
+  "daily": "매일",
+  "weekly": "매주",
+  "scheduleConsent": "고정된 사본을 보관하고 패키지 사용자로 다시 계산하는 데 동의합니다. 새 원본 파일이나 개인 ACL은 읽지 않습니다.",
+  "createSchedule": "일정 만들기",
+  "noSchedules": "일정 없음",
+  "scheduleOn": "활성화됨",
+  "scheduleOff": "비활성화됨",
+  "nextRun": "다음 실행: {time}",
+  "missedRuns": "놓친 실행: {count}회",
+  "disableSchedule": "일정 비활성화",
+  "deleteSchedule": "일정 삭제",
+  "deleteScheduleConsent": "{name}의 일정을 삭제할까요? 대기 작업은 취소되고 실행 중인 작업은 중지 후 정리됩니다. 완료된 결과는 유지됩니다.",
+  "confirmDeleteSchedule": "삭제 확인",
+  "enableSchedule": "일정 활성화",
+  "enableScheduleConsent": "현재 작업자 리비전으로 {name}의 일정을 활성화할까요? 고정된 사본의 재계산에 동의합니다. 과거 실행은 반복하지 않습니다.",
+  "confirmEnableSchedule": "활성화 확인",
+  "revisionChanged": "작업자 리비전이 변경되었습니다. 관리자가 검토하고 명시적으로 활성화해야 합니다.",
+  "scheduledJob": "예약 실행",
+  "unknownTime": "알 수 없음",
+  "unsupported": "백그라운드 작업을 사용할 수 없습니다. 새로 고친 후 다시 시도하세요."
+}

package/templates/native-go-jobs/frontend/src/background/i18n/zh-CN.json

@@ -0,0 +1,75 @@
+{
+  "title": "后台任务",
+  "help": "将选择的一个文件复制到套件内，由套件账号计算 SHA-256。退出登录后任务仍会继续。副本与结果由套件保存，源权限变化不会收回；再次登录即可查看自己的结果。",
+  "worker": "Worker",
+  "workerRunning": "Worker 正以 {user} 运行",
+  "workerStopped": "Worker 未运行",
+  "chooseFile": "选择文件",
+  "chosen": "已选择的文件：{path}",
+  "pickerTitle": "选择要导入的文件",
+  "pickerConsent": "所选文件会使用你当前的 DSM 登录读取一次并交给后台任务，不会保存授权。",
+  "submit": "导入并提交",
+  "refresh": "刷新",
+  "cancel": "取消",
+  "result": "结果",
+  "download": "下载结果",
+  "noJobs": "暂无任务",
+  "state_queued": "排队中",
+  "state_running": "运行中",
+  "state_succeeded": "成功",
+  "state_failed": "失败",
+  "state_canceled": "已取消",
+  "state_interrupted": "已中断",
+  "limits": "每个文件最多 {size} KiB、队列 {queue} 个任务、每个任务 {seconds} 秒。",
+  "errors": {
+    "jobs_busy": "忙碌中，请稍后重试",
+    "failed": "无法完成请求。请刷新后重试。",
+    "limit-exceeded": "文件超过上限。",
+    "queue-full": "队列已满。",
+    "quota-exceeded": "后台存储空间已满。",
+    "conflict": "任务状态已变更，请刷新。",
+    "not_found": "未找到。",
+    "denied": "访问被拒绝。",
+    "session_required": "DSM 会话已过期，请重新登录。",
+    "owner-queue-full": "你的待处理任务已达上限。请等待完成或取消一个任务。",
+    "owner-quota-exceeded": "你的后台存储已达上限。请管理员清除旧任务。",
+    "identity_unavailable": "无法确认你的 DSM 用户 UID。请重新登录或联系管理员。",
+    "schedule-full": "已达 8 个计划上限。请删除计划。",
+    "input-unavailable": "私有副本不存在或已更改。请重新导入。",
+    "unsupported": "后台任务无法使用，请刷新后重试。"
+  },
+  "ownerScope": "你只能查看、取消及下载自己的任务。",
+  "adminScope": "管理员可查看及取消所有用户的任务。",
+  "ownerLimits": "每人上限：{jobs} 个待处理任务、{size} KiB 输入与预留结果存储。",
+  "owner": "所有者：{user}（UID {uid}）",
+  "purgeOwner": "清除所有者的任务",
+  "purgeConfirm": "清除 {user}（UID {uid}）的所有任务？运行中的任务会取消并等待结束；已保存的结果会移除。",
+  "confirmPurge": "确认清除",
+  "keepJobs": "保留任务",
+  "schedulesTitle": "计划",
+  "scheduleHelp": "由套件账户每小时、每日或每周重新计算固定私有副本。最多 8 个计划；错过的执行仅记录，不补跑。",
+  "scheduleCopy": "计划重跑副本",
+  "scheduleSource": "私有副本：{name}",
+  "interval": "重复间隔",
+  "hourly": "每小时",
+  "daily": "每日",
+  "weekly": "每周",
+  "scheduleConsent": "我同意保留此固定副本，并由套件账户重新计算。不读取新来源文件或个人 ACL。",
+  "createSchedule": "创建计划",
+  "noSchedules": "暂无计划",
+  "scheduleOn": "已启用",
+  "scheduleOff": "已停用",
+  "nextRun": "下次执行：{time}",
+  "missedRuns": "错过执行：{count} 次",
+  "disableSchedule": "停用计划",
+  "deleteSchedule": "删除计划",
+  "deleteScheduleConsent": "删除 {name} 的计划？排队任务将取消，运行中的任务将停止并完成收尾。已完成结果保留。",
+  "confirmDeleteSchedule": "确认删除",
+  "enableSchedule": "启用计划",
+  "enableScheduleConsent": "使用当前 worker revision 启用 {name} 的计划？我同意重新计算此固定副本。不重播过去的执行。",
+  "confirmEnableSchedule": "确认启用",
+  "revisionChanged": "Worker revision 已更改。管理员须检查并明确启用此计划。",
+  "scheduledJob": "计划执行",
+  "unknownTime": "未知",
+  "unsupported": "后台任务无法使用，请刷新后重试。"
+}

package/templates/native-go-jobs/frontend/src/background/i18n/zh-TW.json

@@ -0,0 +1,75 @@
+{
+  "title": "背景工作",
+  "help": "將選取的一個檔案複製到套件內，由套件帳號計算 SHA-256。登出後工作仍會繼續。副本與結果由套件保存，來源權限變動不會收回；再次登入即可查看自己的結果。",
+  "worker": "Worker",
+  "workerRunning": "Worker 正以 {user} 執行",
+  "workerStopped": "Worker 未執行",
+  "chooseFile": "選擇檔案",
+  "chosen": "已選擇的檔案：{path}",
+  "pickerTitle": "選擇要匯入的檔案",
+  "pickerConsent": "選取的檔案會用你目前的 DSM 登入讀取一次並交給背景工作，不會保存授權。",
+  "submit": "匯入並送出",
+  "refresh": "重新整理",
+  "cancel": "取消",
+  "result": "結果",
+  "download": "下載結果",
+  "noJobs": "尚無工作",
+  "state_queued": "排隊中",
+  "state_running": "執行中",
+  "state_succeeded": "成功",
+  "state_failed": "失敗",
+  "state_canceled": "已取消",
+  "state_interrupted": "已中斷",
+  "limits": "每個檔案最多 {size} KiB、佇列 {queue} 個工作、每個工作 {seconds} 秒。",
+  "errors": {
+    "jobs_busy": "忙碌中，請稍後重試",
+    "failed": "無法完成要求。請重新整理後再試。",
+    "limit-exceeded": "檔案超過上限。",
+    "queue-full": "佇列已滿。",
+    "quota-exceeded": "背景儲存空間已滿。",
+    "conflict": "工作狀態已變更，請重新整理。",
+    "not_found": "找不到。",
+    "denied": "存取被拒絕。",
+    "session_required": "DSM 工作階段已過期，請重新登入。",
+    "owner-queue-full": "你的待處理工作已達上限。請等待完成或取消一個工作。",
+    "owner-quota-exceeded": "你的背景儲存已達上限。請管理員清除舊工作。",
+    "identity_unavailable": "無法確認你的 DSM 使用者 UID。請重新登入或洽管理員。",
+    "schedule-full": "已達 8 個排程上限。請刪除排程。",
+    "input-unavailable": "私有副本不存在或已變更。請重新匯入。",
+    "unsupported": "背景工作無法使用，請重新整理後再試。"
+  },
+  "ownerScope": "你只能檢視、取消及下載自己的工作。",
+  "adminScope": "管理員可檢視及取消所有使用者的工作。",
+  "ownerLimits": "每人上限：{jobs} 個待處理工作、{size} KiB 輸入與預留結果儲存。",
+  "owner": "擁有者：{user}（UID {uid}）",
+  "purgeOwner": "清除擁有者的工作",
+  "purgeConfirm": "清除 {user}（UID {uid}）的所有工作？執行中的工作會取消並等待結束；已儲存的結果會移除。",
+  "confirmPurge": "確認清除",
+  "keepJobs": "保留工作",
+  "schedulesTitle": "排程",
+  "scheduleHelp": "由套件帳號每小時、每日或每週重算固定私有副本。最多 8 個排程；錯過的執行只記錄，不補跑。",
+  "scheduleCopy": "排程重跑副本",
+  "scheduleSource": "私有副本：{name}",
+  "interval": "重複間隔",
+  "hourly": "每小時",
+  "daily": "每日",
+  "weekly": "每週",
+  "scheduleConsent": "我同意保留此固定副本，並由套件帳號重算。不讀取新來源檔案或個人 ACL。",
+  "createSchedule": "建立排程",
+  "noSchedules": "尚無排程",
+  "scheduleOn": "已啟用",
+  "scheduleOff": "已停用",
+  "nextRun": "下次執行：{time}",
+  "missedRuns": "錯過執行：{count} 次",
+  "disableSchedule": "停用排程",
+  "deleteSchedule": "刪除排程",
+  "deleteScheduleConsent": "刪除 {name} 的排程？排隊工作會取消，執行中工作會停止並完成收尾。已完成結果保留。",
+  "confirmDeleteSchedule": "確認刪除",
+  "enableSchedule": "啟用排程",
+  "enableScheduleConsent": "使用目前 worker revision 啟用 {name} 的排程？我同意重算此固定副本。不重播過去的執行。",
+  "confirmEnableSchedule": "確認啟用",
+  "revisionChanged": "Worker revision 已變更。管理員須審閱並明確啟用此排程。",
+  "scheduledJob": "排程執行",
+  "unknownTime": "未知",
+  "unsupported": "背景工作無法使用，請重新整理後再試。"
+}

package/templates/native-go-jobs/frontend/src/background/picker-provider.ts

@@ -0,0 +1,12 @@
+import type {Context} from '../context'
+import {createNasProvider} from '../nas/provider'
+import type {NasProvider} from '../nas/contract'
+
+// Jobs without files use the same session-only metadata picker. No grant is stored.
+export function createBackgroundPickerProvider(ctx:Pick<Context,'call'>):NasProvider{
+ return createNasProvider({call:<T>(method:string,params?:Record<string,unknown>)=>{
+  if(method==='nas.files.shares')return ctx.call<T>('bg.browse',{offset:params?.offset})
+  if(method==='nas.files.list')return ctx.call<T>('bg.browse',{folder:params?.path,offset:params?.offset})
+  return ctx.call<T>(method,params)
+ }})
+}

package/templates/native-go-jobs/frontend/src/background/request-key.ts

@@ -0,0 +1,5 @@
+// getRandomValues works on DSM HTTP as well as HTTPS. These keys deduplicate
+// requests; they do not authenticate a caller or authorize a background job.
+export function requestKey(): string {
+ return Array.from(crypto.getRandomValues(new Uint8Array(16)),byte=>byte.toString(16).padStart(2,'0')).join('')
+}

package/templates/native-go-jobs/frontend/test/background.test.ts

@@ -0,0 +1,208 @@
+// @vitest-environment jsdom
+import {readFileSync} from 'node:fs'
+import {join} from 'node:path'
+import {test,expect,beforeEach,afterEach,vi} from 'vitest'
+import {createApp,h,nextTick} from 'vue'
+import {AppRoot} from '@synopackageland/ui'
+import BackgroundPanel from '../src/background/BackgroundPanel.vue'
+import {backgroundCatalogs,backgroundCopy} from '../src/background/i18n'
+import {nasCopy} from '../src/nas/locale'
+// DSM HTTP exposes getRandomValues, but not the secure-context randomUUID API.
+beforeEach(()=>vi.stubGlobal('crypto',{getRandomValues:globalThis.crypto.getRandomValues.bind(globalThis.crypto)}))
+afterEach(()=>vi.unstubAllGlobals())
+// The UI Select is a Reka combobox: drive it by keyboard (the UI README helper), which also proves it is keyboard operable.
+// Attrs such as data-schedule-interval land on the focusable combobox itself.
+async function choose(root:HTMLElement,marker:string,label:string){
+ const trigger=root.querySelector<HTMLElement>(`[${marker}][role=combobox]`)!;expect(trigger,marker).toBeTruthy()
+ expect(trigger.id,marker).toBeTruthy();expect(root.querySelector(`label[for="${trigger.id}"]`),marker).toBeTruthy()
+ trigger.dispatchEvent(new KeyboardEvent('keydown',{key:'ArrowDown',bubbles:true,cancelable:true}));await settle()
+ const option=[...document.querySelectorAll<HTMLElement>('[role=option]')].find(o=>o.textContent?.trim()===label)
+ if(!option||option.getAttribute('aria-disabled')==='true')throw new Error(`No enabled option: ${label}`)
+ option.focus();option.dispatchEvent(new KeyboardEvent('keydown',{key:'Enter',bubbles:true,cancelable:true}));await settle()
+ expect(trigger.textContent).toContain(label)
+}
+async function settle(){for(let i=0;i<20;i++){await Promise.resolve();await nextTick()}}
+type Call=(method:string,params?:Record<string,unknown>)=>Promise<any>
+function mount(call:Call,locale='en'){
+ const root=document.createElement('div');document.body.append(root)
+ const app=createApp({render:()=>h(AppRoot,{},()=>h(BackgroundPanel,{ctx:{call,locale}}))})
+ app.config.idPrefix=`bg-${Math.random()}`;app.mount(root)
+ return {root,close(){app.unmount();root.remove()}}
+}
+const click=(root:HTMLElement,text:string)=>{const b=[...root.querySelectorAll('button')].find(b=>b.textContent?.trim()===text)!;expect(b).toBeTruthy();b.click()}
+const status=()=>({supported:true,admin:true,revision:1,queued:0,running:0,worker:{username:'SynoPkg',alive:true},limits:{maxInputBytes:524288,maxQueued:16,maxOwnerPending:2,maxOwnerBytes:1048576,maxTotalBytes:16777216,jobTimeoutSeconds:60}})
+
+test('non-administrators see unsupported and no action',async()=>{
+ const f=mount(async()=>{throw {code:'unsupported'}});await settle()
+ expect(f.root.textContent).toContain(backgroundCopy('en').unsupported);expect(f.root.querySelector('button')).toBeNull();f.close()
+})
+const browse=(args?:Record<string,unknown>)=>args?.folder
+ ?{files:[{name:'fixture.bin',path:`${args.folder}/fixture.bin`,isdir:false,additional:{size:3}}],total:1,offset:0}
+ :{shares:[{name:'share',path:'/share',isdir:true}],total:1,offset:0}
+test('pick a file, submit, cancel and result use only bg.* routes',async()=>{
+ const calls:Array<[string,Record<string,unknown>|undefined]>=[];let jobs:any[]=[]
+ const f=mount(async(m,p)=>{
+  calls.push([m,p])
+  switch(m){
+   case 'bg.status':return status()
+   case 'bg.jobs.list':return {jobs}
+   case 'bg.browse':return browse(p)
+   case 'bg.jobs.submit':jobs=[{id:'j1',name:'fixture.bin',state:'queued'}];return {job:jobs[0],duplicate:false}
+   case 'bg.jobs.cancel':jobs=[{...jobs[0],state:'canceled'}];return {job:jobs[0]}
+   case 'bg.jobs.result':return {result:{sha256:'x'}}
+  }
+ });await settle()
+ const copy=backgroundCopy('en'),pick=nasCopy('en')
+ expect(f.root.querySelector('[data-bg-folder]')).toBeNull();expect(f.root.querySelector('[data-bg-file]')).toBeNull()
+ const submitButton=()=>[...f.root.querySelectorAll('button')].find(b=>b.textContent?.trim()===copy.submit)!
+ expect(submitButton().disabled).toBe(true)
+ click(f.root,copy.chooseFile);await settle()
+ click(f.root,'share');await settle()
+ click(f.root,pick.selectAction);await settle();click(f.root,pick.confirm);await settle()
+ expect(f.root.textContent).toContain('/share/fixture.bin')
+ expect(submitButton().disabled).toBe(false)
+ click(f.root,copy.submit);await settle()
+ const submit=calls.find(c=>c[0]==='bg.jobs.submit')![1]!
+ expect(submit.folder).toBe('/share');expect(submit.relative).toBe('fixture.bin');expect(submit.key).toMatch(/^[a-f0-9]{32}$/)
+ expect(f.root.querySelector('[data-job-state=queued]')).not.toBeNull()
+ click(f.root,copy.cancel);await settle()
+ expect(f.root.querySelector('[data-job-state=canceled]')).not.toBeNull()
+ expect(calls.filter(c=>c[0]==='bg.browse').length).toBeGreaterThan(0)
+ expect(calls.every(c=>/^bg\./.test(c[0]))).toBe(true)
+ f.close()
+})
+test('a denied listing shows a localized error and cannot submit',async()=>{
+ const f=mount(async(m)=>{
+  if(m==='bg.status')return status()
+  if(m==='bg.jobs.list')return {jobs:[]}
+  if(m==='bg.browse')throw {code:'denied',message:'Cookie=CANARY'}
+ });await settle()
+ click(f.root,backgroundCopy('en').chooseFile);await settle()
+ expect(f.root.textContent).toContain(nasCopy('en').errorDenied);expect(f.root.textContent).not.toContain('CANARY')
+ expect([...f.root.querySelectorAll('button')].find(b=>b.textContent?.trim()===backgroundCopy('en').submit)!.disabled).toBe(true)
+ f.close()
+})
+test('nine locales have identical keys and placeholders',()=>{
+ const en=backgroundCatalogs.en,flat=(o:any,p=''):Record<string,string>=>Object.fromEntries(Object.entries(o).flatMap(([k,v])=>typeof v==='string'?[[p+k,v]]:Object.entries(flat(v,`${p}${k}.`))))
+ const base=flat(en)
+ expect(Object.keys(backgroundCatalogs).sort()).toEqual(['de','en','es','fr','it','ja','ko','zh-CN','zh-TW'])
+ for(const catalog of Object.values(backgroundCatalogs)){
+  const map=flat(catalog);expect(Object.keys(map).sort()).toEqual(Object.keys(base).sort())
+  for(const [k,v] of Object.entries(map)){expect(v.length).toBeGreaterThan(0);expect(v.match(/\{\w+\}/g)??[]).toEqual(base[k].match(/\{\w+\}/g)??[])}
+ }
+})
+
+test('a null job list from the worker renders as no jobs',async()=>{
+ const f=mount(async m=>m==='bg.status'?status():m==='bg.jobs.list'?{jobs:null}:{});await settle()
+ expect(f.root.textContent).toContain(backgroundCopy('en').noJobs);f.close()
+})
+
+test('the picker dialog explains the one-time read',async()=>{
+ for(const locale of Object.keys(backgroundCatalogs)){
+  const f=mount(async(m,p)=>m==='bg.status'?status():m==='bg.jobs.list'?{jobs:[]}:browse(p),locale);await settle()
+  const copy=backgroundCopy(locale)
+  click(f.root,copy.chooseFile);await settle()
+  const dialog=f.root.querySelector('[role=dialog]')!.textContent!
+  expect(dialog).toContain(copy.pickerConsent)
+  f.close()
+ }
+})
+
+test('ordinary owner can submit but has no administrator controls',async()=>{
+ const calls:string[]=[]
+ const f=mount(async(m,p)=>{calls.push(m);if(m==='bg.status')return {...status(),admin:false};if(m==='bg.jobs.list')return {jobs:[{id:'owned',name:'owned.bin',state:'queued',submitter:{user:'bob',uid:'1025'}}]};if(m==='bg.browse')return browse(p);return {}});await settle()
+ const c=backgroundCopy('en')
+ expect(f.root.textContent).toContain(c.ownerScope)
+ expect(f.root.textContent).not.toContain(c.purgeOwner)
+ expect([...f.root.querySelectorAll('button')].some(b=>b.textContent?.trim()===c.chooseFile)).toBe(true)
+ click(f.root,c.cancel);await settle();expect(calls).toContain('bg.jobs.cancel');f.close()
+})
+test('admin exact owner purge requires explicit confirmation',async()=>{
+ const calls:Array<[string,Record<string,unknown>|undefined]>=[]
+ const f=mount(async(m,p)=>{calls.push([m,p]);if(m==='bg.status')return {...status(),admin:true};if(m==='bg.jobs.list')return {jobs:[{id:'one',name:'a',state:'succeeded',submitter:{user:'bob',uid:'1025'}}]};return {}});await settle()
+ const c=backgroundCopy('en')
+ click(f.root,c.purgeOwner);await settle();expect(calls.some(([m])=>m==='bg.jobs.purge')).toBe(false)
+ click(f.root,c.confirmPurge);await settle()
+ expect(calls.find(([m])=>m==='bg.jobs.purge')?.[1]).toEqual({owner:{user:'bob',uid:'1025'}});f.close()
+})
+test('malformed status cannot render action controls or crash the panel',async()=>{
+ const f=mount(async()=>({state:'not-enabled'}));await settle()
+ expect(f.root.textContent).toContain(backgroundCopy('en').errors.failed)
+ expect(f.root.querySelector('button')).toBeNull();f.close()
+})
+
+test('schedule creation requires copy consent; owner controls disable and delete exact schedule',async()=>{
+ const calls:Array<[string,Record<string,unknown>|undefined]>=[];let schedules:any[]=[]
+ const f=mount(async(m,p)=>{calls.push([m,p]);switch(m){
+ case 'bg.status':return {...status(),owner:{user:'bob',uid:'1025'},admin:false}
+ case 'bg.jobs.list':return {jobs:[{id:'import',name:'copy.bin',state:'succeeded',copyRetained:true,submitter:{user:'bob',uid:'1025'}}]}
+ case 'bg.schedules.list':return {schedules}
+ case 'bg.schedules.create':schedules=[{id:'schedule',name:'copy.bin',owner:{user:'bob',uid:'1025'},enabled:true,intervalSeconds:3600,nextAt:'2026-10-05T01:00:00Z',missed:0,workerRevision:1}];return {schedule:schedules[0]}
+ case 'bg.schedules.disable':schedules=[{...schedules[0],enabled:false}];return {schedule:schedules[0]}
+ case 'bg.schedules.delete':schedules=[];return {deleted:true}
+ default:return {}
+ }});await settle();const c=backgroundCopy('en')
+ click(f.root,c.scheduleCopy);await settle()
+ expect(calls.some(([m])=>m==='bg.schedules.create')).toBe(false)
+ const create=[...f.root.querySelectorAll('button')].find(b=>b.textContent?.trim()===c.createSchedule)!
+ expect(create.disabled).toBe(true)
+ await choose(f.root,'data-schedule-interval',c.weekly)
+ const consent=f.root.querySelector<HTMLElement>('[data-schedule-consent] [role=checkbox], [role=checkbox][data-schedule-consent]')!;consent.click();await settle()
+ click(f.root,c.createSchedule);await settle()
+ expect(calls.find(([m])=>m==='bg.schedules.create')?.[1]).toMatchObject({jobId:'import',intervalSeconds:604800,consent:true})
+ expect(calls.find(([m])=>m==='bg.schedules.create')?.[1]?.key).toMatch(/^[a-f0-9]{32}$/)
+ expect(f.root.querySelector('[data-schedule-id=schedule]')?.textContent).toContain(c.nextRun.replace('{time}','').trim().split(':')[0])
+ click(f.root,c.disableSchedule);await settle();expect(calls.find(([m])=>m==='bg.schedules.disable')?.[1]).toEqual({id:'schedule'})
+ click(f.root,c.deleteSchedule);await settle();expect(calls.some(([m])=>m==='bg.schedules.delete')).toBe(false)
+ click(f.root,c.confirmDeleteSchedule);await settle();expect(calls.find(([m])=>m==='bg.schedules.delete')?.[1]).toEqual({id:'schedule'});f.close()
+})
+
+test('administrator sees the exact selected copy before enabling a schedule',async()=>{
+ const calls:Array<[string,Record<string,unknown>|undefined]>=[]
+ const name='private-'.padEnd(128,'x')
+ const f=mount(async(m,p)=>{calls.push([m,p]);if(m==='bg.status')return status();if(m==='bg.jobs.list')return {jobs:[]};if(m==='bg.schedules.list')return {schedules:[{id:'disabled',name,owner:{user:'normal1',uid:'1025'},enabled:false,nextAt:'2026-10-05T01:00:00Z',missed:0}]};return {}});await settle()
+ const c=backgroundCopy('en');click(f.root,c.enableSchedule);await settle()
+ const expected=c.enableScheduleConsent.replace('{name}',name)
+ expect(expected).toContain(name);expect(f.root.textContent).toContain(expected)
+ expect(calls.some(([m])=>m==='bg.schedules.enable')).toBe(false)
+ click(f.root,c.confirmEnableSchedule);await settle()
+ expect(calls.find(([m])=>m==='bg.schedules.enable')?.[1]).toEqual({id:'disabled',consent:true});f.close()
+})
+
+// Same rule as the base template (test/native-controls.test.ts): UI components only, and the
+// UI's own Form auto layout and FormItem id binding instead of per-app workarounds.
+test('the background panel uses only UI components and the UI form binding',()=>{
+ const template=readFileSync(join(__dirname,'../src/background/BackgroundPanel.vue'),'utf8').replace(/<script[\s\S]*?<\/script>/g,'').replace(/<style[\s\S]*?<\/style>/g,'')
+ expect(template.match(/<(?:a|input|select|textarea|label)[\s>/]/g)).toBeNull()
+ expect(template).not.toMatch(/direction="vertical"|field\.controlId|role="group"/)
+})
+
+test('fresh ordinary user can pick and submit without administrator switches',async()=>{
+ const calls:string[]=[]
+ const f=mount(async(m,p)=>{calls.push(m);if(m==='bg.status')return {...status(),admin:false}
+ if(m==='bg.browse')return browse(p);if(m==='bg.jobs.list')return {jobs:[]};return {schedules:[]}});await settle()
+ click(f.root,backgroundCopy('en').chooseFile);await settle()
+ expect(calls).toContain('bg.browse')
+ expect(calls).not.toContain('bg.mode.set');expect(calls).not.toContain('bg.users.set');f.close()
+})
+
+test('jobs_busy renders a retry message in all nine locales and permits retry',async()=>{
+ for(const locale of Object.keys(backgroundCatalogs)){
+  let attempts=0
+  const f=mount(async(m)=>{
+   if(m==='bg.status')return status()
+   if(m==='bg.jobs.list'){
+    if(attempts++===0)throw {code:'jobs_busy',message:'CANARY'}
+    return {jobs:[]}
+   }
+   return {schedules:[]}
+  },locale);await settle()
+  const copy=backgroundCopy(locale)
+  expect(copy.errors.jobs_busy).toBeTruthy()
+  expect(copy.errors.jobs_busy).not.toBe(copy.errors.failed)
+  expect(f.root.querySelector('[role=alert]')?.textContent).toBe(copy.errors.jobs_busy)
+  expect(f.root.textContent).not.toContain('CANARY')
+  click(f.root,copy.refresh);await settle();expect(attempts).toBe(2)
+  f.close()
+ }
+})