@synopackageland/cli 0.8.0 → 0.9.0

package/templates/native-go-vue/frontend/src/delegate/i18n/save/zh-TW.json

@@ -1,42 +0,0 @@
-{
-  "title": "背景存檔",
-  "help": "登出後，App 仍可將完整檔案存入你選取的資料夾，直到你撤銷授權。既有檔案一律不會被取代。",
-  "selection": "允許此 App 在你登出後繼續儲存到這裡，直到你撤銷授權。",
-  "delegations": "我的目的地",
-  "operations": "我的存檔",
-  "empty": "目前沒有有效目的地。",
-  "noOperations": "目前沒有存檔工作。",
-  "revoke": "撤銷授權",
-  "choose": "選擇存檔目的地",
-  "needs": "管理員必須先核准背景存取，你才能選擇存檔目的地。",
-  "cancel": "取消存檔",
-  "refresh": "重新整理",
-  "disable": "停用背景存檔",
-  "enable": "啟用背景存檔",
-  "disableHelp": "停用會撤銷此 App 的所有目的地授權，並取消待完成的存檔。已儲存的檔案會保留。",
-  "disabled": "背景存檔已停用。管理員可重新啟用，之後你須重新選取目的地。",
-  "enabled": "背景存檔已啟用。",
-  "revoked": "授權已撤銷。已儲存的檔案會保留。",
-  "untilRevoked": "直到撤銷授權",
-  "queued": "等待中",
-  "copying": "存檔中",
-  "committed": "已儲存",
-  "canceled": "已取消",
-  "canceling": "取消中",
-  "interrupted": "已中斷",
-  "uncertain": "結果不明",
-  "uncertainHelp": "結果不明。請先檢查原工作與目的地，再決定後續操作。App 不會自動重新儲存。",
-  "interruptedHelp": "存檔已中斷。請檢查目的地；App 不會自動重試。",
-  "loading": "正在載入目的地與存檔…",
-  "denied": "存取遭拒。請檢查資料夾權限，再重新選取目的地。",
-  "session": "請重新登入 DSM，再重新整理。",
-  "conflict": "已存在同名檔案。請檢查目的地，並為新工作選擇另一個名稱。",
-  "space": "空間不足。請檢查目的地，再開始新工作。",
-  "error": "無法確認操作結果。請重新整理查詢目前結果，再決定後續操作。",
-  "scope": "已確認的儲存範圍",
-  "scopeNeeds": "管理員必須先在「管理員設定」確認安裝時的預選，你才能選擇目的地。",
-  "scopeMismatch": "安裝時的預選與已確認範圍不同。儲存會依已確認範圍執行：",
-  "reselect": "儲存範圍已更換，或授權已被撤銷。請重新選擇目的地。先前儲存的檔案會保留。",
-  "example": "儲存範例檔案",
-  "exampleHelp": "將小型範例檔案儲存到有效目的地。App 先在私有空間產生檔案，再以你自己的權限儲存。結果請在「我的存檔」查看。"
-}

package/templates/native-go-vue/frontend/src/delegate/i18n/zh-CN.json

@@ -1,47 +0,0 @@
-{
-  "title": "后台文件访问",
-  "help": "关闭 App 后下载仍会继续。每项任务只能在一小时内写入所选的文件夹，现有文件绝不会被替换。",
-  "setupTitle": "管理员设置",
-  "setupHelp": "批准一次，让 App 在用户离线时也能完成文件任务。",
-  "password": "DSM 密码",
-  "authorize": "批准后台文件访问",
-  "confirmShare": "确认共享文件夹",
-  "scopeNeeds": "共享文件夹尚待确认。请在下方选择共享文件夹，并输入 DSM 密码确认。",
-  "ready": "后台文件访问已就绪。",
-  "needs": "需要管理员批准后台文件访问。",
-  "blocked": "后台文件访问不可用，请管理员检查 App 设置。",
-  "details": "详情",
-  "refresh": "刷新",
-  "revoke": "撤销",
-  "cancel": "取消任务",
-  "noDelegations": "目前没有有效委托。",
-  "delegations": "我的委托",
-  "expires": "到期时间",
-  "downloads": "我的下载",
-  "noJobs": "目前没有下载任务。",
-  "url": "下载网址",
-  "name": "文件名",
-  "choose": "选择文件夹",
-  "submit": "下载到我的文件夹",
-  "destination": "目标文件夹",
-  "pending": "任务已取消。委托撤销尚未完成，App 将自动重试。",
-  "error": "操作未完成，请刷新后重试。若持续失败，请联系管理员。",
-  "setupError": "批准未完成，请重新输入 DSM 密码后重试，或检查 App 设置。",
-  "denied": "访问被拒绝，请检查文件夹权限后重试。",
-  "session": "请重新登录 DSM，然后刷新。",
-  "size": "下载上限为 64 MB、60 秒。",
-  "queued": "等待中",
-  "running": "下载中",
-  "succeeded": "已保存",
-  "failed": "失败",
-  "canceled": "已取消",
-  "interrupted": "已中断",
-  "homeScope": "各用户的 home 文件夹",
-  "scopeLabel": "后台保存范围",
-  "protectedScope": "已确认范围",
-  "preselection": "安装时的预选",
-  "preselectionHelp": "安装时的预选仅供参考。启用后台访问时，请用 DSM 密码确认此范围。",
-  "scopeMismatch": "安装时的预选与已确认范围不同。后台保存将按已确认范围执行。",
-  "scopeChangeHelp": "更改范围会撤销现有目标，并取消待完成的保存。用户必须重新选择目标。已保存的文件会保留。",
-  "confirmScope": "确认更改范围"
-}

package/templates/native-go-vue/frontend/src/delegate/i18n/zh-TW.json

@@ -1,47 +0,0 @@
-{
-  "title": "背景檔案存取",
-  "help": "關閉 App 後下載仍會繼續。每項工作只能在一小時內寫入所選的資料夾，既有檔案一律不會被取代。",
-  "setupTitle": "管理員設定",
-  "setupHelp": "核准一次，讓 App 在使用者離線時也能完成檔案工作。",
-  "password": "DSM 密碼",
-  "authorize": "核准背景檔案存取",
-  "confirmShare": "確認共用資料夾",
-  "scopeNeeds": "共用資料夾尚待確認。請在下方選擇共用資料夾，並輸入 DSM 密碼確認。",
-  "ready": "背景檔案存取已就緒。",
-  "needs": "需要管理員核准背景檔案存取。",
-  "blocked": "背景檔案存取無法使用，請管理員檢查 App 設定。",
-  "details": "詳情",
-  "refresh": "重新整理",
-  "revoke": "撤銷",
-  "cancel": "取消工作",
-  "noDelegations": "目前沒有有效委託。",
-  "delegations": "我的委託",
-  "expires": "到期時間",
-  "downloads": "我的下載",
-  "noJobs": "目前沒有下載工作。",
-  "url": "下載網址",
-  "name": "檔案名稱",
-  "choose": "選擇資料夾",
-  "submit": "下載到我的資料夾",
-  "destination": "目的資料夾",
-  "pending": "工作已取消。委託尚未撤銷完成，App 會自動重試。",
-  "error": "操作未完成，請重新整理後再試。若持續失敗，請聯絡管理員。",
-  "setupError": "核准未完成，請重新輸入 DSM 密碼再試，或檢查 App 設定。",
-  "denied": "存取遭拒，請檢查資料夾權限後再試。",
-  "session": "請重新登入 DSM，再重新整理。",
-  "size": "下載上限為 64 MB、60 秒。",
-  "queued": "等待中",
-  "running": "下載中",
-  "succeeded": "已儲存",
-  "failed": "失敗",
-  "canceled": "已取消",
-  "interrupted": "已中斷",
-  "homeScope": "各使用者的 home 資料夾",
-  "scopeLabel": "背景儲存範圍",
-  "protectedScope": "已確認範圍",
-  "preselection": "安裝時的預選",
-  "preselectionHelp": "安裝時的預選只供參考。啟用背景存取時，請以 DSM 密碼確認這個範圍。",
-  "scopeMismatch": "安裝時的預選與已確認範圍不同。背景儲存會依已確認範圍執行。",
-  "scopeChangeHelp": "更換範圍會撤銷既有目的地，並取消待完成的儲存。使用者必須重新選擇目的地。已儲存的檔案會保留。",
-  "confirmScope": "確認更換範圍"
-}

package/templates/native-go-vue/frontend/src/delegate/long-running.ts

@@ -1,57 +0,0 @@
-// Portable copies of the frozen W1 DTOs in src/runtime/delegate-contract.ts.
-// The generated frontend cannot import CLI source. Contract tests check parity.
-export interface SelectDestination {key:string;path:string}
-// The executor supplies selection; installation draft is display-only.
-export interface ScopeSelection {scope:string;root:string;generation:number}
-export interface DestinationState {
- key:string
- selection:ScopeSelection|null
- destination:DestinationGrant|null
- status:'active'|'missing'|'reselection-required'|'needs-scope-confirmation'|'disabled'
-}
-export interface DestinationGrant {
- id:string
- key:string
- path:string
- username:string
- lifetime:'until-revoked'
-}
-export type DelegateOperationState='queued'|'copying'|'committed'|'canceled'|'interrupted'|'uncertain'
-export interface OperationRef {delegation_id:string;job_id:string}
-export interface OperationResult {
- job_id:string
- state:DelegateOperationState
- receipt?:{path:string;size:number}
- code?:string
- reason?:string
-}
-export interface MoveFromStaging {
- delegation_id:string
- job_id:string
- staging:string
- name:string
- size:number
-}
-// Display metadata comes from App-owned jobs; only OperationResult is executor evidence.
-export interface SaveOperation extends OperationResult,OperationRef {name:string}
-// createBackgroundSaveFacade binds these methods to W2 and App-owned metadata.
-// No method accepts an owner/UID selector.
-export interface BackgroundSaveStatus {disabled:boolean;selection?:ScopeSelection|null;scopeMode?:string;preselection?:string;mismatch?:boolean}
-export interface DestinationSelection {
- key:string
- selectDestination(input:SelectDestination):Promise<DestinationGrant>
-}
-export interface BackgroundSaveFacade {
- destination(key:string):Promise<DestinationState>
- exportExample(input:{key:string;job_id:string}):Promise<OperationRef>
- selectDestination(input:SelectDestination):Promise<DestinationGrant>
- status():Promise<BackgroundSaveStatus>
- list():Promise<DestinationGrant[]>
- operations():Promise<SaveOperation[]>
- revoke(input:{delegation_id:string}):Promise<{revoked:true}>
- // Same-ref and idempotent. copying+CANCEL_REQUESTED is an accepted cancel, not
- // completion: poll operations() until canceled, or committed if publish won.
- cancel(input:OperationRef):Promise<OperationResult>
- disable():Promise<{disabled:true}>
- enable():Promise<{disabled:false}>
-}

package/templates/native-go-vue/frontend/src/delegate/save-copy.test.ts

@@ -1,12 +0,0 @@
-import {expect,test} from 'vitest'
-import {saveCopy,saveError} from './save-copy'
-test('formal executor refusals explain destination and identity recovery in every locale',()=>{
- for(const locale of ['en','zh-TW','zh-CN','ja','ko','de','fr','es','it']){
-  const copy=saveCopy(locale)
-  expect(saveError({code:'destination-exists'},copy)).toBe(copy.conflict)
-  expect(saveError({code:'DELEGATION_DENIED'},copy)).toBe(copy.denied)
-  expect(saveError({code:'IDENTITY_CHANGED'},copy)).toBe(copy.denied)
-  expect(saveError({code:'NO_SPACE'},copy)).toBe(copy.space)
-  expect(saveError({code:'EXECUTOR_TIMEOUT'},copy)).toBe(copy.error)
- }
-})

package/templates/native-go-vue/frontend/src/delegate/save-copy.ts

@@ -1,24 +0,0 @@
-// Background-save copy is separate from the legacy download copy in ./i18n.
-import {uiLocale} from '../nas/locale'
-import en from './i18n/save/en.json'
-import zhTW from './i18n/save/zh-TW.json'
-import zhCN from './i18n/save/zh-CN.json'
-import ja from './i18n/save/ja.json'
-import ko from './i18n/save/ko.json'
-import de from './i18n/save/de.json'
-import fr from './i18n/save/fr.json'
-import es from './i18n/save/es.json'
-import it from './i18n/save/it.json'
-const catalogs:Record<string,typeof en>={en,'zh-TW':zhTW,'zh-CN':zhCN,ja,ko,de,fr,es,it}
-export function saveCopy(locale='en'){return catalogs[uiLocale(locale)]!}
-export function saveError(error:unknown,copy=saveCopy()){
- const code=(error as {code?:string})?.code
- if(code==='disabled')return copy.disabled
- if(['EXECUTOR_UNAVAILABLE','needs-admin-approval','needs-scope-confirmation'].includes(code??''))return copy.needs
- if(['session_required','dsm_session_required','AUTH_DENIED'].includes(code??''))return copy.session
- if(['DENIED','DELEGATION_DENIED','IDENTITY_CHANGED','PERMISSION_DENIED','SCOPE_DENIED','APP_DENIED','INELIGIBLE','DESTINATION_CHANGED','denied','grant-revoked','identity-changed','permission-changed'].includes(code??''))return copy.denied
- if(['CONFLICT','conflict','file-exists','destination-exists'].includes(code??''))return copy.conflict
- if(['NO_SPACE','ENOSPC','no-space'].includes(code??''))return copy.space
- if(['uncertain','commit-uncertain'].includes(code??''))return copy.uncertainHelp
- return copy.error
-}

package/templates/native-go-vue/frontend/src/delegate/scoped-picker.test.ts

@@ -1,12 +0,0 @@
-import {expect,test,vi} from 'vitest'
-import {scopedPicker} from './scoped-picker'
-import type {NasProvider} from '../nas/contract'
-test('the picker exposes only the confirmed root and refuses traversal before contacting DSM',async()=>{
- const entry={name:'reports',path:'/reports',isDir:true},signal=new AbortController().signal
- const source={info:vi.fn(async()=>entry),shares:vi.fn(),list:vi.fn(async()=>({entries:[entry],offset:0,total:1})),createFolder:vi.fn(),dispose:vi.fn()} as NasProvider
- const picker=scopedPicker(source,'/reports')
- expect((await picker.shares(0,signal)).entries).toEqual([entry]);expect(source.shares).not.toHaveBeenCalled()
- for(const path of ['/reports2','/reports/../other','/other'])await expect(picker.list(path,{},signal)).rejects.toMatchObject({code:'SCOPE_DENIED'})
- expect(source.list).not.toHaveBeenCalled();await picker.list('/reports',{},signal);expect(source.list).toHaveBeenCalledOnce()
- picker.dispose();expect(source.dispose).not.toHaveBeenCalled()
-})

package/templates/native-go-vue/frontend/src/delegate/scoped-picker.ts

@@ -1,21 +0,0 @@
-import type {NasProvider} from '../nas/contract'
-/** A UX bound only; the executor independently enforces its protected scope. */
-export function scopedPicker(source:NasProvider,root:string):NasProvider{
- const check=(path:string)=>{
-  if(!root||!(path===root||path.startsWith(root+'/'))||path.includes('\\')||path.slice(1).split('/').some(p=>!p||p==='.'||p==='..'))throw {code:'SCOPE_DENIED'}
- }
- return {
-  async shares(offset,signal){
-   check(root)
-   if(offset!==0)return {entries:[],offset,total:1}
-   const entry=await source.info(root,signal)
-   if(entry.path!==root||!entry.isDir)throw {code:'SCOPE_DENIED'}
-   return {entries:[entry],offset:0,total:1}
-  },
-  async list(path,options,signal){check(path);const page=await source.list(path,options,signal);page.entries.forEach(e=>check(e.path));return page},
-  async info(path,signal){check(path);const entry=await source.info(path,signal);check(entry.path);return entry},
-  async createFolder(parent,name,signal){check(parent);check(parent+'/'+name);return source.createFolder(parent,name,signal)},
-  // The parent owns the shared session provider; closing a picker must not dispose it.
-  dispose(){},
- }
-}

package/templates/native-go-vue/frontend/src/files/FileBrowser.vue

@@ -1,131 +0,0 @@
-<script setup lang="ts">
-import {computed,onBeforeUnmount,onMounted,ref} from 'vue'
-import {Button,Callout,DataGrid,TreeView,FilePicker,type DataGridSort,type TreeNode} from '@synopackageland/ui'
-import {Folder,File} from '@lucide/vue'
-import type {NasEntry,NasProvider} from '../nas/contract'
-import {nasCopy,nasErrorCopy} from '../nas/locale'
-import {format} from '../nas/i18n'
-import {useNasRequest} from '../nas/use-request'
-const props=withDefaults(defineProps<{provider:NasProvider;locale:string;mode?:'folder'|'file';transfers?:boolean}>(),{mode:'file',transfers:false})
-const emit=defineEmits<{selected:[path:string|undefined]}>()
-const copy=computed(()=>nasCopy(props.locale))
-const request=useNasRequest(),{busy,error}=request
-const entries=ref<NasEntry[]>([]),roots=ref<TreeNode[]>([]),trail=ref<NasEntry[]>([]),chosen=ref<NasEntry>(),next=ref<number>()
-const expanded=ref<string[]>([]),treeSelection=ref<string>()
-const sort=ref<DataGridSort>({key:'name',direction:'asc'}),generation=ref(0)
-const uploads=ref<globalThis.File[]>([]),uploadDone=ref(false)
-let life=new AbortController()
-async function download(){
- const selected=chosen.value
- if(!selected||selected.isDir||!props.provider.download)return
- await request.run(async signal=>{await props.provider.info(selected.path,signal);props.provider.download!(selected.path);return true})
-}
-async function upload(){
- const parent=trail.value.at(-1)?.path,file=uploads.value[0]
- if(!parent||!file||!props.provider.upload)return
- uploadDone.value=false
- const done=await request.run(async signal=>{await props.provider.upload!(parent,file,signal);return true})
- if(done){uploads.value=[];await browse(trail.value);uploadDone.value=true}
-}
-
-const columns=computed(()=>[
- {key:'name',label:copy.value.nameColumn,sortable:true},
- {key:'kind',label:copy.value.kindColumn},
- {key:'bytes',label:copy.value.sizeColumn,align:'right' as const,sortable:true},
- {key:'selection',label:copy.value.selectAction},
-])
-function node(entry:NasEntry):TreeNode{return {id:entry.path,label:entry.name,icon:Folder,data:entry}}
-function select(entry?:NasEntry){chosen.value=entry;emit('selected',entry?.path)}
-function findTrail(nodes:TreeNode[],id:string,parents:NasEntry[]=[]):NasEntry[]|undefined{
- for(const n of nodes){const path=[...parents,n.data as NasEntry];if(n.id===id)return path;const found=findTrail(n.children??[],id,path);if(found)return found}
-}
-async function loadChildren(parent:TreeNode):Promise<TreeNode[]|undefined>{
- const version=generation.value,signal=life.signal
- try{
-  const children:TreeNode[]=[]
-  let offset:number|undefined=0
-  while(offset!==undefined){
-   const page=await props.provider.list(parent.id,{offset,sortBy:'name',sortDirection:'ASC'},signal)
-   if(signal.aborted||version!==generation.value)return undefined
-   children.push(...page.entries.filter(e=>e.isDir).map(node));offset=page.nextOffset
-  }
-  return children
- }catch(e){if(!signal.aborted&&version===generation.value){error.value=e;select()};return undefined}
-}
-async function browse(target:NasEntry[],more=false){
- if(busy.value)return
- select();entries.value=more?entries.value:[];next.value=more?next.value:undefined
- const offset=more?next.value??0:0,path=target.at(-1)?.path
- trail.value=target
- const page=await request.run(signal=>path
-  ?props.provider.list(path,{offset,sortBy:sort.value.key as 'name'|'size',sortDirection:sort.value.direction==='asc'?'ASC':'DESC'},signal)
-  :props.provider.shares(offset,signal))
- if(page){
-  entries.value=more?[...entries.value,...page.entries]:page.entries;next.value=page.nextOffset
-  if(!path)roots.value=entries.value.filter(e=>e.isDir).map(node)
- }
-}
-function open(entry:NasEntry){void browse([...trail.value,entry])}
-function sortChanged(value:DataGridSort|null){sort.value={key:value?.key==='bytes'?'size':'name',direction:value?.direction??'asc'};void browse(trail.value)}
-function refresh(){
- if(busy.value)return
- generation.value++;life.abort();life=new AbortController();roots.value=[];expanded.value=[];treeSelection.value=undefined
- void browse([])
-}
-onMounted(()=>void browse([]))
-onBeforeUnmount(()=>{generation.value++;life.abort()})
-</script>
-<template>
- <section class="file-browser" :aria-busy="busy" :aria-label="copy.title">
-  <p>{{ copy.ownPermissions }}</p>
-  <nav class="file-toolbar" :aria-label="copy.directoryKind">
-   <Button variant="secondary" :disabled="busy" @click="refresh">{{ copy.refresh }}</Button>
-   <Button v-if="trail.length" variant="secondary" :disabled="busy" @click="browse(trail.slice(0,-1))">{{ copy.back }}</Button>
-   <Button variant="secondary" :disabled="busy" @click="browse([])">{{ copy.roots }}</Button>
-   <Button v-for="(part,index) in trail" :key="part.path" variant="secondary" :disabled="busy" @click="browse(trail.slice(0,index+1))">{{ part.name }}</Button>
-  </nav>
-  <div v-if="transfers&&provider.upload&&trail.length" class="file-toolbar">
-   <FilePicker v-model="uploads" variant="compact" :disabled="busy" :max-files="1" :max-size="16*1024**3" :title="copy.upload" @rejected="error={code:'upload_size_required'}" />
-   <Button variant="primary" :disabled="busy||!uploads.length" @click="upload">{{ copy.upload }}</Button>
-  </div>
-  <p v-if="uploadDone" role="status">{{ copy.uploaded }}</p>
-  <Button v-if="transfers&&provider.download&&chosen&&!chosen.isDir&&!error" variant="secondary" :disabled="busy" @click="download">{{ copy.download }}</Button>
-  <Callout v-if="error" tone="danger"><span role="alert">{{ nasErrorCopy(error,copy) }}</span></Callout>
-  <p v-if="busy" role="status">{{ copy.loading }}</p>
-  <div class="file-columns">
-   <aside class="file-tree" :aria-label="copy.roots">
-    <TreeView v-if="roots.length" :key="generation" v-model="treeSelection" v-model:nodes="roots" v-model:expanded="expanded" :load-children="loadChildren" :expand-label="(n,expanded)=>format(expanded?copy.collapse:copy.expand,n.label)" @select="n=>browse(findTrail(roots,n.id)??[n.data as NasEntry])" />
-   </aside>
-   <div class="file-content">
-    <DataGrid v-if="!error" :columns="columns" :rows="entries.map(e=>({...e,kind:e.isDir?copy.directoryKind:copy.fileKind}))" row-key="path" :footer="false" :resizable="false" :local-sort="false" :local-pagination="false" :loading="busy" :loading-text="copy.loading" :sort="{key:sort.key==='size'?'bytes':sort.key,direction:sort.direction}" :labels="{empty:copy.emptyFolder}" @update:sort="sortChanged">
-     <template #cell-name="{row}">
-      <Button v-if="row.isDir" variant="secondary" :disabled="busy" :aria-label="format(copy.open,String(row.name))" @click="open(entries.find(e=>e.path===row.path)!)"><Folder :size="16" aria-hidden="true" />{{ row.name }}</Button>
-      <span v-else class="file-name"><File :size="16" aria-hidden="true" />{{ row.name }}</span>
-     </template>
-     <template #cell-bytes="{row}"><span class="file-bytes">{{ row.isDir?'—':row.bytes??'—' }}</span></template>
-     <template #cell-selection="{row}">
-      <Button v-if="mode==='folder'?row.isDir:!row.isDir" variant="secondary" :disabled="busy" :aria-pressed="chosen?.path===row.path" :aria-label="format(copy.select,String(row.name))" @click="select(entries.find(e=>e.path===row.path))">{{ copy.selectAction }}</Button>
-     </template>
-    </DataGrid>
-    <Button v-if="next!==undefined&&!error" variant="secondary" :disabled="busy" @click="browse(trail,true)">{{ copy.loadMore }}</Button>
-    <Button v-if="mode==='folder'&&trail.length&&!error" variant="secondary" :disabled="busy" @click="select(trail.at(-1))">{{ format(copy.select,trail.at(-1)!.name) }}</Button>
-   </div>
-  </div>
-  <p v-if="chosen&&!error" class="file-selection" role="status">{{ format(copy.selected,chosen.path) }}</p>
- </section>
-</template>
-<style scoped>
-.file-browser { min-width: 0; color: var(--ui-text); }
-.file-toolbar { display: flex; flex-wrap: wrap; gap: var(--ui-space-2, 8px); margin-block: var(--ui-space-3, 12px); }
-.file-columns { display: grid; grid-template-columns: minmax(140px, 1fr) minmax(0, 3fr); gap: var(--ui-space-3, 12px); }
-.file-tree { min-width: 0; max-height: 55vh; overflow: auto; border-inline-end: 1px solid var(--ui-border); }
-.file-content { min-width: 0; overflow: auto; }
-.file-name { display: inline-flex; align-items: center; gap: var(--ui-space-2, 8px); overflow-wrap: anywhere; }
-.file-bytes { font-variant-numeric: tabular-nums; }
-.file-selection { overflow-wrap: anywhere; }
-@media (max-width: 600px) {
- .file-columns { grid-template-columns: minmax(0, 1fr); }
- .file-content :deep(th:nth-child(2)), .file-content :deep(td:nth-child(2)), .file-content :deep(th:nth-child(3)), .file-content :deep(td:nth-child(3)) { display: none; }
- .file-tree { max-height: 180px; border-inline-end: 0; border-bottom: 1px solid var(--ui-border); }
-}
-</style>

package/templates/native-go-vue/frontend/src/files/FilesPage.vue

@@ -1,35 +0,0 @@
-<script setup lang="ts">
-import {onBeforeUnmount,onMounted,ref} from 'vue'
-import {Button,Callout,SettingsSection} from '@synopackageland/ui'
-import type {Context} from '../context'
-import FileBrowser from './FileBrowser.vue'
-import NasPicker from '../nas/NasPicker.vue'
-import {createNasProvider} from '../nas/provider'
-import {nasCopy,nasErrorCopy} from '../nas/locale'
-const props=defineProps<{ctx:Context}>()
-const error=ref<unknown>()
-const ready=ref(false),mode=ref<'folder'|'file'>('folder'),open=ref(false),selected=ref(''),generation=ref(0)
-const provider=createNasProvider(props.ctx)
-let disposed=false,unsubscribe:(()=>void)|undefined
-async function check(){
- if(disposed)return
- error.value=undefined
- ready.value=false;selected.value='';open.value=false;generation.value++
- try{await props.ctx.call('nas.session.status');if(!disposed)ready.value=true}catch(e){if(!disposed&&(e as {code?:string})?.code!=='unknown_method')error.value=e}
-}
-onMounted(()=>{unsubscribe=props.ctx.reopen(()=>void check());void check()})
-onBeforeUnmount(()=>{disposed=true;unsubscribe?.();provider.dispose()})
-</script>
-<template>
- <Callout v-if="error" tone="danger"><span role="alert">{{ nasErrorCopy(error,nasCopy(ctx.locale)) }}</span><Button variant="secondary" @click="check">{{ nasCopy(ctx.locale).refresh }}</Button></Callout>
- <SettingsSection v-if="ready" :title="nasCopy(ctx.locale).title" :collapsible="false">
-  <div class="files-actions"><Button variant="secondary" @click="mode='folder';open=true">{{ nasCopy(ctx.locale).choose }}</Button><Button variant="secondary" @click="mode='file';open=true">{{ nasCopy(ctx.locale).chooseFile }}</Button></div>
-  <p v-if="selected" class="files-path" role="status">{{ selected }}</p>
-  <FileBrowser :key="generation" :provider="provider" :locale="ctx.locale" transfers />
-  <NasPicker :provider="provider" :locale="ctx.locale" :mode="mode" v-model:open="open" @selected="selected=$event" />
- </SettingsSection>
-</template>
-<style scoped>
-.files-actions { display: flex; flex-wrap: wrap; gap: var(--ui-space-2, 8px); }
-.files-path { overflow-wrap: anywhere; }
-</style>

package/templates/native-go-vue/frontend/src/files/files.test.ts

@@ -1,100 +0,0 @@
-// @vitest-environment jsdom
-import {afterEach,expect,test,vi} from 'vitest'
-import {createApp,h,nextTick,ref} from 'vue'
-import {AppRoot} from '@synopackageland/ui'
-import FileBrowser from './FileBrowser.vue'
-import NasPicker from '../nas/NasPicker.vue'
-import {createNasProvider} from '../nas/provider'
-import {nasCopy} from '../nas/locale'
-
-async function settle(){for(let i=0;i<30;i++){await Promise.resolve();await nextTick()}await new Promise(r=>setTimeout(r,20))}
-const cleanup:Array<()=>void>=[]
-afterEach(()=>{cleanup.splice(0).forEach(fn=>fn())})
-const folder=(path:string)=>({path,name:path.split('/').at(-1)!,isdir:true})
-const file=(path:string)=>({path,name:path.split('/').at(-1)!,isdir:false,additional:{size:2}})
-function mount(component:any,call:any,extra:Record<string,unknown>={}){
- const root=document.createElement('div');document.body.append(root)
- const app=createApp({render:()=>h(AppRoot,{},()=>h(component,{provider:createNasProvider({call}),locale:'en',...extra}))})
- app.mount(root);cleanup.push(()=>{app.unmount();root.remove()});return root
-}
-function button(root:HTMLElement,label:string){const node=Array.from(root.querySelectorAll('button')).find(n=>n.textContent?.trim()===label||n.getAttribute('aria-label')===label);expect(node,label).toBeTruthy();return node!}
-function fixture(){
- return vi.fn(async(method:string,params:any)=>{
-  if(method==='nas.files.shares')return {shares:[folder('/homes'),folder('/shared')],offset:0,total:2}
-  if(method==='nas.files.list')return {files:params.path==='/homes'?[folder('/homes/sub'),file('/homes/a.txt')]:[],offset:params.offset??0,total:params.path==='/homes'?2:0}
-  throw {code:'unknown_method'}
- })
-}
-test('tree loads roots only and loads children on first expansion, including DSM-returned homes',async()=>{
- const call=fixture(),root=mount(FileBrowser,call);await settle()
- expect(call.mock.calls.map(([m])=>m)).toEqual(['nas.files.shares'])
- expect(root.textContent).toContain('homes')
- button(root,'Expand homes').click();await settle()
- expect(call.mock.calls.filter(([m])=>m==='nas.files.list')).toHaveLength(1)
- expect(root.textContent).toContain('sub')
- button(root,'Collapse homes').click();await settle();button(root,'Expand homes').click();await settle()
- expect(call.mock.calls.filter(([m])=>m==='nas.files.list')).toHaveLength(1)
-})
-test.each(['folder','file'] as const)('picker returns a DSM path in %s mode without creating grants',async(mode)=>{
- const call=fixture(),selected=vi.fn(),root=mount(NasPicker,call,{open:true,mode,onSelected:selected});await settle()
- button(root,'Open homes').click();await settle()
- if(mode==='file')button(root,'Select a.txt').click()
- else button(root,'Select homes').click()
- await settle();button(root,nasCopy('en').confirm).click();await settle()
- expect(selected).toHaveBeenCalledWith(mode==='file'?'/homes/a.txt':'/homes')
- expect(call.mock.calls.every(([m])=>!m.includes('grants'))).toBe(true)
-})
-test.each([407,408,'denied'])('permission error %s is visible and suppresses misleading empty state',async(code)=>{
- const call=vi.fn(async()=>{throw {code,message:'secret SID'}}),root=mount(FileBrowser,call);await settle()
- expect(root.querySelector('[role="alert"]')?.textContent).toContain(nasCopy('en').errorDenied)
- expect(root.textContent).not.toContain('secret SID')
- expect(root.textContent).not.toContain(nasCopy('en').emptyFolder)
- expect(button(root,nasCopy('en').refresh).disabled).toBe(false)
-})
-test('folder navigation clears selection when permissions are lost',async()=>{
- const call=fixture(),root=mount(FileBrowser,call,{mode:'file'});await settle()
- button(root,'Open homes').click();await settle();button(root,'Select a.txt').click();await settle()
- call.mockRejectedValue({code:'denied'});button(root,nasCopy('en').refresh).click();await settle()
- expect(root.querySelector('[role="alert"]')).toBeTruthy()
- expect(root.textContent).not.toContain('a.txt')
-})
-
-test('lazy tree follows full DSM page cursors even when a page contains only files',async()=>{
- const call=vi.fn(async(method:string,params:any)=>{
-  if(method==='nas.files.shares')return {shares:[folder('/team')],offset:0,total:1}
-  if(params.offset===0)return {files:[file('/team/a.txt')],offset:0,total:2}
-  return {files:[folder('/team/later')],offset:1,total:2}
- })
- const root=mount(FileBrowser,call);await settle();button(root,'Expand team').click();await settle()
- expect(call.mock.calls.filter(([m])=>m==='nas.files.list').map(([,p])=>p.offset)).toEqual([0,1])
- expect(root.textContent).toContain('later')
-})
-test('reopening picker clears the old path and reloads current DSM visibility',async()=>{
- const call=fixture(),open=ref(true),selected=vi.fn(),root=document.createElement('div');document.body.append(root)
- const provider=createNasProvider({call:call as any})
- const app=createApp({render:()=>h(AppRoot,{},()=>h(NasPicker,{provider,locale:'en',mode:'folder',open:open.value,onSelected:selected,'onUpdate:open':v=>{open.value=v}}))})
- app.mount(root);cleanup.push(()=>{app.unmount();root.remove()})
- await settle();button(root,'Select homes').click();await settle();button(root,nasCopy('en').confirm).click();await settle()
- expect(selected).toHaveBeenCalledWith('/homes')
- open.value=true;await settle()
- expect(button(root,nasCopy('en').confirm).disabled).toBe(true)
- expect(call.mock.calls.filter(([m])=>m==='nas.files.shares')).toHaveLength(2)
-})
-
-test('upload picker states the same 16 GB limit as the size error',async()=>{
- const call=fixture(),provider=createNasProvider({call:call as any})
- const root=mount(FileBrowser,call,{transfers:true,provider:{...provider,upload:vi.fn(),download:vi.fn(),info:vi.fn()}});await settle()
- button(root,'Open homes').click();await settle()
- expect(nasCopy('en').errorUploadSize).toContain('16 GB')
- expect(root.textContent).toContain('max 16 GB')
-})
-test('file browser downloads selected files and streams uploads to the current folder',async()=>{
- const call=fixture(),provider=createNasProvider({call:call as any}),upload=vi.fn(async()=>{}),download=vi.fn(),info=vi.fn(async()=>({name:'a.txt',path:'/homes/a.txt',isDir:false}))
- const root=mount(FileBrowser,call,{transfers:true,provider:{...provider,upload,download,info}});await settle()
- button(root,'Open homes').click();await settle();button(root,'Select a.txt').click();await settle()
- button(root,nasCopy('en').download).click();await settle();expect(info).toHaveBeenCalledWith('/homes/a.txt',expect.any(AbortSignal));expect(download).toHaveBeenCalledWith('/homes/a.txt')
- const picker=root.querySelector<HTMLInputElement>('input[type=file]')!;expect(picker).toBeTruthy()
- const file=new File(['payload'],'upload.txt');Object.defineProperty(picker,'files',{value:[file],configurable:true});picker.dispatchEvent(new Event('change',{bubbles:true}));await settle()
- button(root,nasCopy('en').upload).click();await settle()
- expect(upload).toHaveBeenCalledWith('/homes',file,expect.any(AbortSignal));expect(root.textContent).toContain(nasCopy('en').uploaded)
-})

package/templates/native-go-vue/frontend/src/files/provider.test.ts

@@ -1,48 +0,0 @@
-import {expect,test,vi} from 'vitest'
-import {createNasProvider} from '../nas/provider'
-import {nasCatalogs,nasCopy,nasErrorCopy} from '../nas/locale'
-const signal=()=>new AbortController().signal
-
-test('provider forwards pagination/sorting and preserves every DSM-returned path',async()=>{
- const call=vi.fn(async()=>({files:[{name:'outside homes',path:'/team/outside homes',isdir:false,additional:{size:12}}],offset:100,total:102}))
- const p=createNasProvider({call:call as any})
- const page=await p.list('/team',{offset:100,limit:1,sortBy:'size',sortDirection:'DESC'},signal())
- expect(call).toHaveBeenCalledWith('nas.files.list',{path:'/team',offset:100,limit:1,sortBy:'size',sortDirection:'DESC'})
- expect(page.entries[0]?.path).toBe('/team/outside homes');expect(page.nextOffset).toBe(101)
-})
-test.each([
- {},{files:[],offset:0,total:1},{files:[],offset:-1,total:0},
- {files:[{name:'x',path:'/x',isdir:true}],offset:0,total:0},
- {files:[{name:'x',path:'/x',isdir:'true'}],offset:0,total:1},
-])('malformed or stalled page fails visibly: %j',async(value)=>{
- const p=createNasProvider({call:vi.fn(async()=>value) as any})
- await expect(p.shares(0,signal())).rejects.toEqual({code:'unavailable'})
-})
-test('canceling or disposing observation rejects late results and stops subsequent calls',async()=>{
- let resolve!:(v:unknown)=>void
- const call=vi.fn(()=>new Promise(r=>{resolve=r})),p=createNasProvider({call:call as any}),abort=new AbortController()
- const pending=p.shares(0,abort.signal);abort.abort()
- await expect(pending).rejects.toEqual({code:'canceled'})
- resolve({shares:[],offset:0,total:0});p.dispose()
- await expect(p.shares(0,signal())).rejects.toEqual({code:'canceled'})
- expect(call).toHaveBeenCalledTimes(1)
-})
-test('lost mutation response stays uncertain and sensitive error details are discarded',async()=>{
- const p=createNasProvider({call:vi.fn(async()=>{throw {message:'SID=secret',code:'transport_error'}})})
- await expect(p.createFolder('/team','new',signal())).rejects.toEqual({code:'commit-uncertain'})
-})
-test('all supported locales share copy keys, aliases and explicit permission errors',()=>{
- const keys=Object.keys(nasCopy('en')).sort()
- for(const copy of Object.values(nasCatalogs)){
-  expect(Object.keys(copy).sort()).toEqual(keys)
-  expect(nasErrorCopy({code:'denied',message:'SID=secret'},copy)).toBe(copy.errorDenied)
- }
- expect(nasCopy('cht')).toBe(nasCopy('zh-TW'))
- expect(nasCopy('unknown')).toBe(nasCopy('en'))
-})
-
-test('App-only file errors retain a DSM-login recovery hint',async()=>{
- const p=createNasProvider({call:vi.fn(async()=>{throw {code:'dsm_session_required'}})})
- await expect(p.shares(0,signal())).rejects.toEqual({code:'dsm_session_required'})
- expect(nasErrorCopy({code:'dsm_session_required'},nasCopy('en'))).toContain('DSM')
-})

package/templates/native-go-vue/frontend/src/files/transfers.test.ts

@@ -1,27 +0,0 @@
-// @vitest-environment jsdom
-import {expect,test,vi,afterEach} from 'vitest'
-import {createFileTransfers} from './transfers'
-afterEach(()=>vi.unstubAllGlobals())
-test('upload passes the File itself with caller credentials and a header token',async()=>{
- const fetch=vi.fn(async()=>({json:async()=>({success:true,data:{uploaded:true}})}));vi.stubGlobal('fetch',fetch)
- const file=new File(['payload'],'\u5831\u544a.txt'),signal=new AbortController().signal
- await createFileTransfers({endpoint:'/cgi/api.cgi',token:()=> 'caller-token'}).upload('/home',file,signal)
- const [url,request]=fetch.mock.calls[0] as any
- expect(url).toContain('method=nas.files.upload');expect(url).toContain('parent=%2Fhome')
- expect(request.body).toBe(file);expect(request.signal).toBe(signal);expect(request.credentials).toBe('same-origin');expect(request.headers['X-SYNO-TOKEN']).toBe('caller-token')
-})
-test('native download sends the caller token in a POST body, never a URL',()=>{
- let action='',method='',token=''
- const submit=vi.spyOn(HTMLFormElement.prototype,'submit').mockImplementation(function(this:HTMLFormElement){action=this.action;method=this.method;token=(this.elements.namedItem('SynoToken') as HTMLInputElement).value})
- const transfers=createFileTransfers({endpoint:'/cgi/api.cgi',token:()=> 'secret'})
- transfers.download('/home/\u5831\u544a.txt')
- expect(action).toContain('method=nas.files.download');expect(action).not.toContain('secret');expect(method).toBe('post');expect(token).toBe('secret')
- expect(document.querySelector('form')).toBeNull();transfers.dispose();expect(document.querySelector('iframe')).toBeNull();submit.mockRestore()
-})
-test('lost upload response is uncertain and server DSM refusal stays actionable',async()=>{
- vi.stubGlobal('fetch',vi.fn(async()=>{throw Error('offline')}))
- const t=createFileTransfers({endpoint:'/cgi/api.cgi'}),file=new File(['a'],'a')
- await expect(t.upload('/home',file,new AbortController().signal)).rejects.toEqual({code:'commit-uncertain'})
- vi.stubGlobal('fetch',vi.fn(async()=>({json:async()=>({success:false,error:{code:'dsm_session_required'}})})))
- await expect(t.upload('/home',file,new AbortController().signal)).rejects.toEqual({code:'dsm_session_required'})
-})