@synopackageland/cli 0.5.0 → 0.6.0

package/templates/native-go-vue/frontend/src/nas/i18n/files/es.json

@@ -0,0 +1,41 @@
+{
+  "title": "Carpetas NAS — File Station",
+  "ownPermissions": "Las operaciones usan tu sesión DSM y tus permisos actuales de File Station.",
+  "choose": "Elegir carpeta",
+  "confirm": "Confirmar selección",
+  "refresh": "Actualizar carpetas",
+  "loading": "Cargando…",
+  "emptyFolder": "Esta carpeta está vacía.",
+  "roots": "Carpetas",
+  "back": "Atrás",
+  "select": "Seleccionar {name}",
+  "open": "Abrir {name}",
+  "selected": "Seleccionado: {name}",
+  "cancel": "Cancelar",
+  "close": "Cerrar",
+  "loadMore": "Cargar más",
+  "errorSession": "La sesión DSM caducó. Inicia sesión en DSM y actualiza las carpetas.",
+  "errorDenied": "No tiene permiso para acceder a este archivo o carpeta. Elija otra carpeta.",
+  "errorNotFound": "El archivo o la carpeta ya no existe. Actualiza la lista.",
+  "errorConflict": "Ya existe un archivo o carpeta con ese nombre. Usa otro nombre.",
+  "errorUncertain": "La operación puede haber terminado. Actualiza las selecciones o el destino y comprueba el resultado antes de enviarla de nuevo.",
+  "errorInvalid": "Carpeta, nombre o solicitud inválidos. Revisa los datos.",
+  "errorUnavailable": "File Station no está disponible o falta el adaptador de sesión. Actualiza más tarde.",
+  "errorCanceled": "Solicitud cancelada. Actualiza antes de continuar.",
+  "errorTimeout": "La solicitud agotó el tiempo. Actualiza la lista antes de continuar.",
+  "metadata": "Metadatos",
+  "fileKind": "Archivo",
+  "directoryKind": "Carpeta",
+  "nameColumn": "Nombre",
+  "kindColumn": "Tipo",
+  "sizeColumn": "Bytes",
+  "selectAction": "Seleccionar",
+  "chooseFile": "Elegir archivo",
+  "expand": "Expandir {name}",
+  "collapse": "Contraer {name}",
+  "upload": "Subir",
+  "download": "Descargar",
+  "uploaded": "Archivo subido.",
+  "errorDSM": "Inicie sesión en DSM con este nombre de host para acceder a los archivos NAS. El inicio de sesión en la App por sí solo no permite usar File Station.",
+  "errorUploadSize": "Seleccione un archivo de hasta 16 GiB."
+}

package/templates/native-go-vue/frontend/src/nas/i18n/files/fr.json

@@ -0,0 +1,41 @@
+{
+  "title": "Dossiers NAS — File Station",
+  "ownPermissions": "Les opérations utilisent votre session DSM et vos droits File Station actuels.",
+  "choose": "Choisir un dossier",
+  "confirm": "Confirmer la sélection",
+  "refresh": "Actualiser les dossiers",
+  "loading": "Chargement…",
+  "emptyFolder": "Ce dossier est vide.",
+  "roots": "Dossiers",
+  "back": "Retour",
+  "select": "Sélectionner {name}",
+  "open": "Ouvrir {name}",
+  "selected": "Sélection : {name}",
+  "cancel": "Annuler",
+  "close": "Fermer",
+  "loadMore": "Charger plus",
+  "errorSession": "Votre session DSM a expiré. Reconnectez-vous à DSM puis actualisez les dossiers.",
+  "errorDenied": "Vous n’avez pas l’autorisation d’accéder à ce fichier ou dossier. Choisissez un autre dossier.",
+  "errorNotFound": "Le fichier ou dossier n’existe plus. Actualisez la liste.",
+  "errorConflict": "Ce nom existe déjà. Choisissez un autre nom.",
+  "errorUncertain": "L’opération a peut-être abouti. Actualisez les sélections ou la destination et vérifiez le résultat avant de soumettre à nouveau.",
+  "errorInvalid": "Dossier, nom de fichier ou requête invalide. Vérifiez la saisie.",
+  "errorUnavailable": "File Station est indisponible ou l’adaptateur de session manque. Actualisez plus tard.",
+  "errorCanceled": "Requête annulée. Actualisez avant de continuer.",
+  "errorTimeout": "Délai dépassé. Actualisez la liste avant de continuer.",
+  "metadata": "Métadonnées",
+  "fileKind": "Fichier",
+  "directoryKind": "Dossier",
+  "nameColumn": "Nom",
+  "kindColumn": "Type",
+  "sizeColumn": "Octets",
+  "selectAction": "Sélectionner",
+  "chooseFile": "Choisir un fichier",
+  "expand": "Développer {name}",
+  "collapse": "Réduire {name}",
+  "upload": "Téléverser",
+  "download": "Télécharger",
+  "uploaded": "Fichier téléversé.",
+  "errorDSM": "Connectez-vous à DSM sur ce nom d’hôte pour accéder aux fichiers NAS. La connexion à l’App seule ne permet pas d’utiliser File Station.",
+  "errorUploadSize": "Choisissez un fichier de 16 GiB maximum."
+}

package/templates/native-go-vue/frontend/src/nas/i18n/files/it.json

@@ -0,0 +1,41 @@
+{
+  "title": "Cartelle NAS — File Station",
+  "ownPermissions": "Le operazioni usano la tua sessione DSM e i permessi File Station attuali.",
+  "choose": "Scegli cartella",
+  "confirm": "Conferma selezione",
+  "refresh": "Aggiorna cartelle",
+  "loading": "Caricamento…",
+  "emptyFolder": "Questa cartella è vuota.",
+  "roots": "Cartelle",
+  "back": "Indietro",
+  "select": "Seleziona {name}",
+  "open": "Apri {name}",
+  "selected": "Selezionato: {name}",
+  "cancel": "Annulla",
+  "close": "Chiudi",
+  "loadMore": "Carica altro",
+  "errorSession": "Sessione DSM scaduta. Accedi di nuovo a DSM e aggiorna le cartelle.",
+  "errorDenied": "Non hai il permesso di accedere a questo file o cartella. Scegli un’altra cartella.",
+  "errorNotFound": "Il file o la cartella non esiste più. Aggiorna l’elenco.",
+  "errorConflict": "Esiste già un file o una cartella con questo nome. Scegli un altro nome.",
+  "errorUncertain": "L’operazione potrebbe essere completata. Aggiorna selezioni o destinazione e controlla il risultato prima di inviarla di nuovo.",
+  "errorInvalid": "Cartella, nome o richiesta non validi. Controlla i dati.",
+  "errorUnavailable": "File Station non disponibile o adattatore di sessione mancante. Aggiorna più tardi.",
+  "errorCanceled": "Richiesta annullata. Aggiorna prima di continuare.",
+  "errorTimeout": "Tempo scaduto. Aggiorna l’elenco prima di continuare.",
+  "metadata": "Metadati",
+  "fileKind": "File",
+  "directoryKind": "Cartella",
+  "nameColumn": "Nome",
+  "kindColumn": "Tipo",
+  "sizeColumn": "Byte",
+  "selectAction": "Seleziona",
+  "chooseFile": "Scegli file",
+  "expand": "Espandi {name}",
+  "collapse": "Comprimi {name}",
+  "upload": "Carica",
+  "download": "Scarica",
+  "uploaded": "File caricato.",
+  "errorDSM": "Accedi a DSM con questo nome host per accedere ai file NAS. Il solo accesso all’App non consente di usare File Station.",
+  "errorUploadSize": "Seleziona un file fino a 16 GiB."
+}

package/templates/native-go-vue/frontend/src/nas/i18n/files/ja.json

@@ -0,0 +1,41 @@
+{
+  "title": "NAS フォルダー — File Station",
+  "ownPermissions": "自分の DSM セッションと現在の File Station 権限で操作します。",
+  "choose": "フォルダーを選択",
+  "confirm": "選択を確定",
+  "refresh": "フォルダーを更新",
+  "loading": "読み込み中…",
+  "emptyFolder": "空のフォルダーです。",
+  "roots": "フォルダー",
+  "back": "戻る",
+  "select": "{name} を選択",
+  "open": "{name} を開く",
+  "selected": "選択済み：{name}",
+  "cancel": "キャンセル",
+  "close": "閉じる",
+  "loadMore": "さらに読み込む",
+  "errorSession": "DSM セッションが期限切れです。DSM に再ログインし、フォルダーを更新してください。",
+  "errorDenied": "このファイルまたはフォルダにアクセスする権限がありません。別のフォルダを選択してください。",
+  "errorNotFound": "ファイルまたはフォルダーがありません。一覧を更新してください。",
+  "errorConflict": "同名のファイルまたはフォルダーがあります。別の名前を指定してください。",
+  "errorUncertain": "操作が完了した可能性があります。再送信する前に選択または保存先を更新し、結果を確認してください。",
+  "errorInvalid": "フォルダー、ファイル名またはリクエストが無効です。入力を確認してください。",
+  "errorUnavailable": "File Station が利用できないか、このパッケージにセッション adapter がありません。後で更新してください。",
+  "errorCanceled": "リクエストをキャンセルしました。更新してから続けてください。",
+  "errorTimeout": "リクエストがタイムアウトしました。一覧を更新してください。",
+  "metadata": "情報",
+  "fileKind": "ファイル",
+  "directoryKind": "フォルダー",
+  "nameColumn": "名前",
+  "kindColumn": "種類",
+  "sizeColumn": "バイト",
+  "selectAction": "選択",
+  "chooseFile": "ファイルを選択",
+  "expand": "{name} を展開",
+  "collapse": "{name} を折りたたむ",
+  "upload": "アップロード",
+  "download": "ダウンロード",
+  "uploaded": "ファイルをアップロードしました。",
+  "errorDSM": "NAS ファイルを利用するには同じホスト名で DSM にサインインしてください。App のログインだけでは File Station を利用できません。",
+  "errorUploadSize": "16 GiB 以下のファイルを 1 個選択してください。"
+}

package/templates/native-go-vue/frontend/src/nas/i18n/files/ko.json

@@ -0,0 +1,41 @@
+{
+  "title": "NAS 폴더 — File Station",
+  "ownPermissions": "자신의 DSM 세션과 현재 File Station 권한으로 작업합니다.",
+  "choose": "폴더 선택",
+  "confirm": "선택 확인",
+  "refresh": "폴더 새로 고침",
+  "loading": "불러오는 중…",
+  "emptyFolder": "빈 폴더입니다.",
+  "roots": "폴더",
+  "back": "뒤로",
+  "select": "{name} 선택",
+  "open": "{name} 열기",
+  "selected": "선택됨: {name}",
+  "cancel": "취소",
+  "close": "닫기",
+  "loadMore": "더 불러오기",
+  "errorSession": "DSM 세션이 만료되었습니다. DSM에 다시 로그인한 후 폴더를 새로 고치세요.",
+  "errorDenied": "이 파일 또는 폴더에 접근할 권한이 없습니다. 다른 폴더를 선택하세요.",
+  "errorNotFound": "파일 또는 폴더가 없습니다. 목록을 새로 고치세요.",
+  "errorConflict": "같은 이름의 파일 또는 폴더가 있습니다. 다른 이름을 사용하세요.",
+  "errorUncertain": "작업이 완료되었을 수 있습니다. 다시 제출하기 전에 선택 또는 대상 폴더를 새로 고쳐 결과를 확인하세요.",
+  "errorInvalid": "폴더, 파일 이름 또는 요청이 잘못되었습니다. 입력을 확인하세요.",
+  "errorUnavailable": "File Station을 사용할 수 없거나 패키지에 세션 adapter가 없습니다. 나중에 새로 고치세요.",
+  "errorCanceled": "요청이 취소되었습니다. 새로 고친 후 계속하세요.",
+  "errorTimeout": "요청 시간이 초과되었습니다. 목록을 새로 고치세요.",
+  "metadata": "정보",
+  "fileKind": "파일",
+  "directoryKind": "폴더",
+  "nameColumn": "이름",
+  "kindColumn": "유형",
+  "sizeColumn": "바이트",
+  "selectAction": "선택",
+  "chooseFile": "파일 선택",
+  "expand": "{name} 펼치기",
+  "collapse": "{name} 접기",
+  "upload": "업로드",
+  "download": "다운로드",
+  "uploaded": "파일을 업로드했습니다.",
+  "errorDSM": "NAS 파일에 접근하려면 같은 호스트 이름에서 DSM에 로그인하세요. App 로그인만으로는 File Station을 사용할 수 없습니다.",
+  "errorUploadSize": "16 GiB 이하의 파일 하나를 선택하세요."
+}

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

@@ -0,0 +1,41 @@
+{
+  "title": "NAS 文件夹 — File Station",
+  "ownPermissions": "操作使用你自己的 DSM 会话与 File Station 实时权限。",
+  "choose": "选择文件夹",
+  "confirm": "确认选择",
+  "refresh": "刷新文件夹",
+  "loading": "正在加载…",
+  "emptyFolder": "此文件夹为空。",
+  "roots": "文件夹",
+  "back": "返回",
+  "select": "选择 {name}",
+  "open": "打开 {name}",
+  "selected": "已选择：{name}",
+  "cancel": "取消",
+  "close": "关闭",
+  "loadMore": "加载更多",
+  "errorSession": "DSM 会话已失效。请重新登录 DSM，再刷新文件夹。",
+  "errorDenied": "没有权限访问此文件或文件夹。请选择其他文件夹。",
+  "errorNotFound": "文件或文件夹已不存在。请刷新列表。",
+  "errorConflict": "已有同名文件或文件夹。请使用其他名称。",
+  "errorUncertain": "操作可能已完成。请刷新选择或目标文件夹并确认结果，再决定是否重新提交。",
+  "errorInvalid": "文件夹、文件名或请求无效。请检查输入后重试。",
+  "errorUnavailable": "File Station 不可用，或此套件未提供会话 adapter。请稍后刷新。",
+  "errorCanceled": "请求已取消。请刷新后继续。",
+  "errorTimeout": "请求超时。请刷新列表后继续。",
+  "metadata": "信息",
+  "fileKind": "文件",
+  "directoryKind": "文件夹",
+  "nameColumn": "名称",
+  "kindColumn": "类型",
+  "sizeColumn": "字节",
+  "selectAction": "选择",
+  "chooseFile": "选择文件",
+  "expand": "展开 {name}",
+  "collapse": "收起 {name}",
+  "upload": "上传",
+  "download": "下载",
+  "uploaded": "文件已上传。",
+  "errorDSM": "请在同一主机名登录 DSM，以访问 NAS 文件。只有 App 登录无法使用 File Station。",
+  "errorUploadSize": "请选择一个不超过 16 GiB 的文件。"
+}

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

@@ -0,0 +1,41 @@
+{
+  "title": "NAS 資料夾 — File Station",
+  "ownPermissions": "操作使用你自己的 DSM 工作階段與 File Station 即時權限。",
+  "choose": "選擇資料夾",
+  "confirm": "確認選取",
+  "refresh": "重新整理資料夾",
+  "loading": "載入中…",
+  "emptyFolder": "此資料夾是空的。",
+  "roots": "資料夾",
+  "back": "返回",
+  "select": "選取 {name}",
+  "open": "開啟 {name}",
+  "selected": "已選取：{name}",
+  "cancel": "取消",
+  "close": "關閉",
+  "loadMore": "載入更多",
+  "errorSession": "DSM 工作階段已失效。請重新登入 DSM，再重新整理資料夾。",
+  "errorDenied": "沒有權限存取此檔案或資料夾。請選擇其他資料夾。",
+  "errorNotFound": "檔案或資料夾已不存在。請重新整理清單。",
+  "errorConflict": "已有同名檔案或資料夾。請使用其他名稱。",
+  "errorUncertain": "操作可能已完成。請重新整理選取或目的資料夾並確認結果，再決定是否重新送出。",
+  "errorInvalid": "資料夾、檔名或請求無效。請檢查輸入後重試。",
+  "errorUnavailable": "File Station 無法使用，或此套件未提供工作階段 adapter。請稍後重新整理。",
+  "errorCanceled": "請求已取消。請重新整理後繼續。",
+  "errorTimeout": "請求逾時。請重新整理清單後繼續。",
+  "metadata": "資訊",
+  "fileKind": "檔案",
+  "directoryKind": "資料夾",
+  "nameColumn": "名稱",
+  "kindColumn": "類型",
+  "sizeColumn": "位元組",
+  "selectAction": "選取",
+  "chooseFile": "選擇檔案",
+  "expand": "展開 {name}",
+  "collapse": "收合 {name}",
+  "upload": "上傳",
+  "download": "下載",
+  "uploaded": "檔案已上傳。",
+  "errorDSM": "請在同一主機名稱登入 DSM，以存取 NAS 檔案。只有 App 登入無法使用 File Station。",
+  "errorUploadSize": "請選擇一個不超過 16 GiB 的檔案。"
+}

package/templates/native-go-vue/frontend/src/nas/i18n.ts

@@ -1,38 +1,2 @@
-import en from './i18n/en.json'
-import zhTW from './i18n/zh-TW.json'
-import zhCN from './i18n/zh-CN.json'
-import ja from './i18n/ja.json'
-import ko from './i18n/ko.json'
-import de from './i18n/de.json'
-import fr from './i18n/fr.json'
-import es from './i18n/es.json'
-import it from './i18n/it.json'
-import type {ReadAction, SafeCode} from './provider'
-
-export type NasCopy = typeof en
-export const catalogs: Record<string, NasCopy> = {en,'zh-TW':zhTW,'zh-CN':zhCN,ja,ko,de,fr,es,it}
-const aliases:Record<string,string>={enu:'en',cht:'zh-TW',chs:'zh-CN',jpn:'ja',krn:'ko',ger:'de',fre:'fr',spn:'es',ita:'it'}
-export function nasCopy(locale:string):NasCopy {
- const normalized=locale.replaceAll('_','-')
- return catalogs[aliases[normalized] ?? normalized] ?? catalogs[normalized.split('-')[0]!] ?? en
-}
-export function format(copy:string,name:string) {return copy.replace('{name}',name)}
-export function actionCopy(actions:readonly ReadAction[],copy:NasCopy) {
- const labels:Record<ReadAction,string>={'nas.files.list':copy.actionList,'nas.files.stat':copy.actionStat,'nas.files.read':copy.actionRead}
- return actions.map(action=>labels[action] ?? copy.errorInternal).join(' · ')
-}
-export function errorCopy(error:unknown, copy:NasCopy):string {
- const code=(error as {code?:SafeCode})?.code
- if(code==='unknown_method') return copy.errorUnknownMethod
- if(code==='session_required') return copy.errorSession
- if(code==='auth_unavailable') return copy.errorAuthentication
- if(code==='unavailable') return copy.errorNativeProof
- if(code==='unsupported') return copy.errorUnsupported
- if(code==='denied') return copy.errorDenied
- if(code==='expired') return copy.errorExpired
- if(['stale','replay','suspended','revoked','fenced'].includes(code ?? '')) return copy.errorStale
- if(['incompatible','cleanup-required'].includes(code ?? '')) return copy.errorUnavailable
- if(code==='busy' || code==='limit-exceeded') return copy.errorBusy
- if(code==='canceled') return copy.errorCanceled
- return copy.errorInternal // Never render a native message, path or arbitrary code.
-}
+/** Substitute the single display value in localized picker copy. */
+export function format(template:string,value:string|number):string{return template.replace('{name}',String(value))}

package/templates/native-go-vue/frontend/src/nas/locale.ts

@@ -0,0 +1,24 @@
+import type {UiLocale} from '@synopackageland/ui'
+import en from './i18n/files/en.json'
+import zhTW from './i18n/files/zh-TW.json'
+import zhCN from './i18n/files/zh-CN.json'
+import ja from './i18n/files/ja.json'
+import ko from './i18n/files/ko.json'
+import de from './i18n/files/de.json'
+import fr from './i18n/files/fr.json'
+import es from './i18n/files/es.json'
+import it from './i18n/files/it.json'
+export type NasCopy=typeof en
+export const nasCatalogs:Record<string,NasCopy>={en,'zh-TW':zhTW,'zh-CN':zhCN,ja,ko,de,fr,es,it}
+const aliases:Record<string,string>={enu:'en',cht:'zh-TW',chs:'zh-CN',jpn:'ja',krn:'ko',ger:'de',fre:'fr',spn:'es',ita:'it'}
+/** The built-in UI locale (shared by these catalogs and the UI's own text) for a DSM or BCP-47 language tag. */
+export function uiLocale(locale:string):UiLocale{
+ const normalized=locale.replaceAll('_','-')
+ return ([aliases[normalized]??normalized,normalized.split('-')[0]!].find(key=>key in nasCatalogs)??'en') as UiLocale
+}
+export function nasCopy(locale:string):NasCopy{return nasCatalogs[uiLocale(locale)]!}
+export function nasErrorCopy(error:unknown,copy:NasCopy):string{
+ const code=(error as {code?:string})?.code
+ const keys:Record<string,keyof NasCopy>={session_required:'errorSession',dsm_session_required:'errorDSM',upload_size_required:'errorUploadSize',denied:'errorDenied',not_found:'errorNotFound',conflict:'errorConflict','commit-uncertain':'errorUncertain','invalid-request':'errorInvalid',canceled:'errorCanceled',timeout:'errorTimeout'}
+ return copy[keys[code??'']??'errorUnavailable']
+}

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

@@ -1,59 +1,50 @@
-import type {InjectionKey} from 'vue'
+import {createFileTransfers} from '../files/transfers'
+import type {Context} from '../context'
+import type {NasEntry,NasPage,NasProvider} from './contract'
 
-// S0 protocol-2 display projections, not root Grant/Intent authority records.
-// IDs index provider-owned mappings. No paths, credentials, UID or role claims
-// travel in picker/consent arguments. S1 discovery metadata is not a grant.
-export type ScopeKind = 'app-shared' | 'user-personal'
-export const readActions = ['nas.files.list', 'nas.files.stat', 'nas.files.read'] as const
-export type ReadAction = typeof readActions[number]
-export type SafeCode = 'unknown_method' | 'session_required' | 'auth_unavailable' | 'invalid-request' | 'incompatible' | 'unsupported' | 'replay' | 'stale' | 'expired' | 'denied' | 'unavailable' | 'suspended' | 'revoked' | 'fenced' | 'busy' | 'limit-exceeded' | 'canceled' | 'timeout' | 'partial' | 'commit-uncertain' | 'cleanup-required' | 'internal'
-export interface SafeError {code: SafeCode; operationId?: string}
-export interface DiscoveryAnchor {
- ref: string
- displayName: string
- kind: ScopeKind
- owner: {kind: 'local'; subjectRef: string; instanceRef: string}
- localFilesystem: boolean
+function refuse(code='unavailable'):never{throw {code}}
+function record(v:unknown):Record<string,unknown>{if(!v||typeof v!=='object'||Array.isArray(v))refuse();return v as Record<string,unknown>}
+const integer=(v:unknown):v is number=>typeof v==='number'&&Number.isSafeInteger(v)&&v>=0
+function entry(value:unknown):NasEntry{
+ const v=record(value),additional=record(v.additional??{})
+ if(typeof v.name!=='string'||typeof v.path!=='string'||typeof v.isdir!=='boolean'||(additional.size!==undefined&&!integer(additional.size)))refuse()
+ // Display DSM's response without guessing permissions from path prefixes.
+ return {name:v.name,path:v.path,isDir:v.isdir,...(additional.size===undefined?{}:{bytes:additional.size as number})}
 }
-export interface PickerContext {contextId: string; scopeKind: ScopeKind; expiresAt: number}
-export interface FolderEntry {nodeId: string; displayName: string; targetKind: 'directory'; selectable: boolean}
-export interface FolderPage {entries: FolderEntry[]; nextCursor?: string}
-export interface ConsentSummary {
- appName: string
- scopeKind: ScopeKind
- displayName: string
- targetKind: 'directory'
- actions: readonly ReadAction[]
- persistent: true
+function page(value:unknown,offset:number,limit:number):NasPage{
+ const v=record(value),raw=v.shares??v.files
+ if(!Array.isArray(raw)||raw.length>limit||!integer(v.total)||v.offset!==offset||offset+raw.length>v.total)refuse()
+ const entries=raw.map(entry),next=offset+entries.length
+ if(next<v.total&&!entries.length)refuse()
+ return {entries,total:v.total,offset,...(next<v.total?{nextOffset:next}:{})}
 }
-export interface PreparedIntent {intentId: string; summaryDigest: string; expiresAt: number; summary: ConsentSummary}
-export interface GrantHandle {
- grantId: string
- revision: number
- scopeKind: ScopeKind
- displayName: string
- targetKind: 'directory'
- actions: readonly ReadAction[]
+export function createNasProvider(ctx:Pick<Context,'call'|'files'>):NasProvider{
+ let disposed=false
+ const life=new AbortController()
+ const transfers=ctx.files?createFileTransfers(ctx.files):undefined
+ async function request(method:string,params:Record<string,unknown>,signal:AbortSignal,mutation=false):Promise<unknown>{
+  if(disposed||signal.aborted)refuse('canceled')
+  let cleanup=()=>{}
+  const stop=new Promise<never>((_,reject)=>{
+   const abort=()=>reject({code:mutation?'commit-uncertain':'canceled'})
+   const timer=setTimeout(()=>reject({code:mutation?'commit-uncertain':'timeout'}),22000)
+   signal.addEventListener('abort',abort,{once:true});life.signal.addEventListener('abort',abort,{once:true})
+   cleanup=()=>{clearTimeout(timer);signal.removeEventListener('abort',abort);life.signal.removeEventListener('abort',abort)}
+  })
+  try{return await Promise.race([ctx.call(method,params),stop])}
+  catch(e){
+   const code=(e as {code?:unknown})?.code
+   if([407,408,'407','408','denied'].includes(code as string|number))refuse('denied')
+   const allowed=['session_required','dsm_session_required','auth_unavailable','denied','not_found','conflict','invalid-request','unavailable','unknown_method','unsupported','commit-uncertain','canceled','timeout']
+   refuse(typeof code==='string'&&allowed.includes(code)?code:mutation?'commit-uncertain':'unavailable')
+  }finally{cleanup()}
+ }
+ return {
+  ...(transfers?{upload:transfers.upload,download:transfers.download}:{}),
+  async shares(offset,signal){return page(await request('nas.files.shares',{offset},signal),offset,100)},
+  async list(path,options,signal){const offset=options.offset??0,limit=options.limit??100;return page(await request('nas.files.list',{path,...options,offset,limit},signal),offset,limit)},
+  async info(path,signal){return entry(await request('nas.files.info',{path},signal))},
+  async createFolder(parent,name,signal){const v=record(await request('nas.files.create_folder',{parent,name},signal,true));if(v.created!==true)refuse('commit-uncertain')},
+  dispose(){disposed=true;life.abort();transfers?.dispose()},
+ }
 }
-export interface GrantView extends GrantHandle {
- effectiveState: 'active' | 'suspended' | 'revoked'
- createdAt: number
- canRevoke: boolean
- // S0 R/Q receipt: undefined means Q has not been observed, never assume true.
- drained?: boolean
- cleanupRequired?: boolean
-}
-export interface GrantList {items: GrantView[]; canManageShared: boolean}
-export interface RevokeResult {grantId: string; grantRevision: number; revoked: boolean; drained: boolean}
-export interface NasProvider {
- readonly mode: 'mock' | 'connected'
- begin(kind: ScopeKind, signal: AbortSignal): Promise<PickerContext>
- list(contextId: string, nodeId: string | undefined, cursor: string | undefined, signal: AbortSignal): Promise<FolderPage>
- prepare(candidateId: string, signal: AbortSignal): Promise<PreparedIntent>
- confirm(intentId: string, summaryDigest: string, signal: AbortSignal): Promise<GrantHandle>
- cancel(contextId: string): Promise<void>
- grants(signal: AbortSignal): Promise<GrantView[]>
- settings(signal: AbortSignal): Promise<GrantList>
- revoke(grantId: string, revision: number, signal: AbortSignal): Promise<RevokeResult>
-}
-export const NasProviderKey: InjectionKey<NasProvider> = Symbol('nas-provider')

package/templates/native-go-vue/frontend/src/nas/use-request.ts

@@ -1,26 +1,17 @@
-import {onBeforeUnmount, ref} from 'vue'
+import {onBeforeUnmount,ref} from 'vue'
 
-// One admission at a time per component, bounded metadata requests, and no late
-// responses after close/unmount. An abort is not a server rollback/Q receipt.
-export function useNasRequest() {
- const busy=ref(false), error=ref<unknown>()
- let generation=0, disposed=false, controller:AbortController|undefined
- function cancel() {generation++;controller?.abort();controller=undefined;busy.value=false;error.value=undefined}
- async function run<T>(operation:(signal:AbortSignal,current:()=>boolean)=>Promise<T>):Promise<T|undefined> {
-  if(busy.value || disposed) return
-  const version=++generation, active=new AbortController();controller=active;busy.value=true;error.value=undefined
-  const current=()=>!disposed && generation===version
-  let timer:ReturnType<typeof setTimeout>|undefined
-  let onAbort:()=>void=()=>{}
-  try {
-   const stop=new Promise<never>((_,reject)=> {
-    onAbort=()=>reject({code:'canceled'});active.signal.addEventListener('abort',onAbort,{once:true})
-    timer=setTimeout(()=>{reject({code:'timeout'});active.abort()},5000)
-   })
-   const value=await Promise.race([operation(active.signal,current),stop])
-   return current()?value:undefined
-  } catch(e) {if(current()) error.value=e;return undefined}
-  finally {clearTimeout(timer);active.signal.removeEventListener('abort',onAbort);if(current()){busy.value=false;controller=undefined}}
+// The provider owns the 22 s bound (backend handlers are bounded to 20 s).
+// Local cancellation suppresses late display updates, never promises rollback.
+export function useNasRequest(){
+ const busy=ref(false),error=ref<unknown>()
+ let disposed=false,generation=0,active:AbortController|undefined
+ function cancel(){generation++;active?.abort();active=undefined;busy.value=false;error.value=undefined}
+ async function run<T>(fn:(signal:AbortSignal)=>Promise<T>):Promise<T|undefined>{
+  if(disposed||busy.value)return
+  const version=++generation,controller=new AbortController();active=controller;busy.value=true;error.value=undefined
+  try{const value=await fn(controller.signal);return !disposed&&version===generation?value:undefined}
+  catch(e){if(!disposed&&version===generation)error.value=e;return undefined}
+  finally{if(!disposed&&version===generation){busy.value=false;active=undefined}}
  }
  onBeforeUnmount(()=>{disposed=true;cancel()})
  return {busy,error,run,cancel}

package/templates/native-go-vue/frontend/src/shell/AppShell.vue

@@ -4,7 +4,7 @@
 // running while the user moves between them.
 import {computed, type Component} from 'vue'
 import {AppLayout, AppSidebar, PageContent, PageHeader, type AppSidebarGroup} from '@synopackageland/ui'
-import {FolderOpen, Info, KeyRound, ListChecks, MousePointerClick, NotebookPen, Shield, Timer} from '@lucide/vue'
+import {Info, Timer} from '@lucide/vue'
 import {shellCopy} from './i18n'
 import type {ShellPage} from './pages'
 
@@ -16,7 +16,7 @@ const props = defineProps<{
 }>()
 const emit = defineEmits<{'update:modelValue': [value: ShellPage]}>()
 const copy = computed(() => shellCopy(props.locale))
-const icons: Record<ShellPage, Component> = {status:Info,sample:NotebookPen,nas:FolderOpen,interactive:MousePointerClick,background:Timer,admin:ListChecks,identity:KeyRound,folders:Shield}
+const icons: Record<ShellPage, Component> = {status:Info,background:Timer}
 const groups = computed<AppSidebarGroup[]>(() => [{
   items: props.pages.map(page => ({key:page,label:copy.value[page],icon:icons[page]})),
 }])
@@ -24,7 +24,7 @@ const title = computed(() => copy.value[props.modelValue] ?? copy.value.status)
 </script>
 
 <template>
-  <AppLayout class="app-shell" min-height="0">
+  <AppLayout class="app-shell" min-height="0" wide-layout="window">
     <template #sidebar>
       <AppSidebar :model-value="modelValue" :groups="groups" @update:model-value="emit('update:modelValue', $event as ShellPage)" />
     </template>

package/templates/native-go-vue/frontend/src/shell/i18n/de.json

@@ -1,10 +1,4 @@
 {
   "status": "Status",
-  "sample": "Meine Beispieldaten",
-  "nas": "NAS-Ordnerzugriff",
-  "interactive": "Interaktive Aufträge",
-  "background": "Hintergrundaufträge",
-  "admin": "Auftragsverwaltung",
-  "identity": "Optionale App-Identität",
-  "folders": "Ordnerauswahl"
+  "background": "Hintergrundaufträge"
 }

package/templates/native-go-vue/frontend/src/shell/i18n/en.json

@@ -1,10 +1,4 @@
 {
   "status": "Status",
-  "sample": "My sample data",
-  "nas": "NAS folder access",
-  "interactive": "Interactive jobs",
-  "background": "Background jobs",
-  "admin": "Job management",
-  "identity": "Optional app identity",
-  "folders": "Folder selections"
+  "background": "Background jobs"
 }

package/templates/native-go-vue/frontend/src/shell/i18n/es.json

@@ -1,10 +1,4 @@
 {
   "status": "Estado",
-  "sample": "Mis datos de ejemplo",
-  "nas": "Acceso a carpetas NAS",
-  "interactive": "Tareas interactivas",
-  "background": "Tareas en segundo plano",
-  "admin": "Gestión de tareas",
-  "identity": "Identidad de aplicación opcional",
-  "folders": "Selección de carpetas"
+  "background": "Tareas en segundo plano"
 }

package/templates/native-go-vue/frontend/src/shell/i18n/fr.json

@@ -1,10 +1,4 @@
 {
   "status": "État",
-  "sample": "Mes données d'exemple",
-  "nas": "Accès aux dossiers NAS",
-  "interactive": "Tâches interactives",
-  "background": "Tâches en arrière-plan",
-  "admin": "Gestion des tâches",
-  "identity": "Identité d'application facultative",
-  "folders": "Sélection de dossiers"
+  "background": "Tâches en arrière-plan"
 }

package/templates/native-go-vue/frontend/src/shell/i18n/it.json

@@ -1,10 +1,4 @@
 {
   "status": "Stato",
-  "sample": "I miei dati di esempio",
-  "nas": "Accesso alle cartelle NAS",
-  "interactive": "Attività interattive",
-  "background": "Attività in background",
-  "admin": "Gestione attività",
-  "identity": "Identità app opzionale",
-  "folders": "Selezione cartelle"
+  "background": "Attività in background"
 }

package/templates/native-go-vue/frontend/src/shell/i18n/ja.json

@@ -1,10 +1,4 @@
 {
   "status": "ステータス",
-  "sample": "サンプルデータ",
-  "nas": "NAS フォルダーアクセス",
-  "interactive": "インタラクティブジョブ",
-  "background": "バックグラウンドジョブ",
-  "admin": "ジョブ管理",
-  "identity": "任意のアプリ ID",
-  "folders": "フォルダーの選択"
+  "background": "バックグラウンドジョブ"
 }