@synopackageland/sdk 0.31.3 → 0.31.5

package/README.md

@@ -7,7 +7,7 @@ App's `backend/go.mod`.
 | Import | Contents |
 |---|---|
 | `@synopackageland/sdk` | Headless: `Context` and the other types, `createBackgroundSaveFacade`, `createNasProvider`, `scopedPicker`, `createPortalAccess`, copy catalogs (`uiLocale`, `saveCopy`, …). Never imports Vue. |
-| `@synopackageland/sdk/vue` | Everything above plus the components (`AppShell`, `PageActions`, `PageInfo`, `FilesPage`, `NasPicker`, `LoginPage`, `PortalSettings`, `BackgroundPanel`, `ExecutorSettings`, `ExecutorApproval`, `ExecutorNotice`, `DelegatePanel`, `BackgroundSavePanel`, `BackgroundSaveSettings`, `AuthorizationGate`, `AuthorizationSettings`) and composables (`createSession`, `useExecutorSetup`, `ExecutorSetupKey`, `useAuthorization`). |
+| `@synopackageland/sdk/vue` | Everything above plus the components (`AppShell`, `PageActions`, `PageInfo`, `FilesPage`, `NasPicker`, `LoginPage`, `PortalSettings`, `BackgroundPanel`, `ExecutorSettings`, `ExecutorApproval`, `ExecutorNotice`, `UiUpdateNotice`, `DelegatePanel`, `BackgroundSavePanel`, `BackgroundSaveSettings`, `AuthorizationGate`, `AuthorizationSettings`) and composables (`createSession`, `useExecutorSetup`, `ExecutorSetupKey`, `useAuthorization`). |
 | `@synopackageland/sdk/vue/style.css` | The component stylesheet. Import it once next to `@synopackageland/ui`'s theme in the App entry. |
 | `@synopackageland/sdk/native` | For a native product with its own pinned root tasks: `ROOT_RUNTIME` (`createRootAccess`) and `AUTHORIZATION_RUNTIME` (`createAuthorizationAccess`), plain ES5 source the product renders into its own DSM window; `AuthorizationGate` shows the result. Generated Apps use the executor instead. Never imports Vue. |
 | `@synopackageland/sdk/i18n/<capability>/<locale>.json` | Copy in `en`, `zh-TW`, `zh-CN`, `ja`, `ko`, `de`, `fr`, `es`, `it`. |
@@ -462,6 +462,18 @@ whose routes for the approval's reads (`delegate.status`, `bg.browse`)
 differ provides its adapter there, and the dialog reads as its settings
 page does.
 
+A full page, or a window DSM left open, keeps running the UI it loaded across
+a package upgrade until the page reloads (CLI 0.33.2+ windows opened after
+the upgrade load the new UI themselves). The CLI's DSM window (CLI 0.33.2+) gives `ctx.uiUpdate`: its `check()` reads the package's `ui/config`
+without the browser cache and answers whether the installed build replaced
+the window this page loaded. `AppShell` given that `ctx` shows
+`UiUpdateNotice` above every page once it answers yes: one line, Updated.
+Reload the page, with a **Reload** button, and nothing held back. It checks on
+mount, when the window reopens and when the page is shown again (at most once
+a minute). A failed check, or a window without `uiUpdate`, shows nothing. An
+App without `AppShell` places `<UiUpdateNotice :ctx="ctx" :locale="ctx.locale" />`
+above its pages.
+
 The backend's `executor.status` and `executor.control` are the SDK's: a Go
 App registers `delegate.ExecutorRoutes`, and the bridge runtime serves them
 with `capabilities.root`.
@@ -605,3 +617,10 @@ Browser permission results never authorize backend writes or grants.
 
 See [DSM session transport and App migration](../docs/dsm-session-transport.md).
 Do not add root/executor access to browser-only Apps such as OpenList.
+
+### DSM service ports
+
+`readDsmPorts(ctx)` returns localized PortInfo definitions on demand in the
+current administrator's DSM session. Start it after rendering the App. Refusal,
+missing session and timeout return `[]`; use package-account `dsmservices`
+reading on the backend independently. See [service ports](../docs/dsm-service-ports.md).

package/dist/i18n/shell/de.json

@@ -7,5 +7,7 @@
   "deniedMessage": "Ihr DSM-Konto darf diese App nicht verwenden. Bitten Sie einen Administrator, sie in den DSM-Anwendungsberechtigungen freizugeben.",
   "notes": "Hinweise",
   "notesCount": "Hinweise ({count})",
-  "loading": "Wird geladen…"
+  "loading": "Wird geladen…",
+  "uiUpdated": "Aktualisiert. Laden Sie die Seite neu",
+  "uiReload": "Neu laden"
 }

package/dist/i18n/shell/en.json

@@ -7,5 +7,7 @@
   "deniedMessage": "Your DSM account is not allowed to use this app. Ask an administrator to allow it in DSM Application Privileges.",
   "notes": "Notes",
   "notesCount": "Notes ({count})",
-  "loading": "Loading…"
+  "loading": "Loading…",
+  "uiUpdated": "Updated. Reload the page",
+  "uiReload": "Reload"
 }

package/dist/i18n/shell/es.json

@@ -7,5 +7,7 @@
   "deniedMessage": "Su cuenta de DSM no tiene permiso para usar esta aplicación. Pida a un administrador que la permita en los privilegios de aplicaciones de DSM.",
   "notes": "Notas",
   "notesCount": "Notas ({count})",
-  "loading": "Cargando…"
+  "loading": "Cargando…",
+  "uiUpdated": "Actualizado. Vuelva a cargar la página",
+  "uiReload": "Volver a cargar"
 }

package/dist/i18n/shell/fr.json

@@ -7,5 +7,7 @@
   "deniedMessage": "Votre compte DSM n’est pas autorisé à utiliser cette application. Demandez à un administrateur de l’autoriser dans les privilèges d’application de DSM.",
   "notes": "Remarques",
   "notesCount": "Remarques ({count})",
-  "loading": "Chargement…"
+  "loading": "Chargement…",
+  "uiUpdated": "Mis à jour. Rechargez la page",
+  "uiReload": "Recharger"
 }

package/dist/i18n/shell/it.json

@@ -7,5 +7,7 @@
   "deniedMessage": "L’account DSM non è autorizzato a usare questa app. Chiedere a un amministratore di consentirlo nei privilegi delle applicazioni DSM.",
   "notes": "Note",
   "notesCount": "Note ({count})",
-  "loading": "Caricamento…"
+  "loading": "Caricamento…",
+  "uiUpdated": "Aggiornato. Ricarica la pagina",
+  "uiReload": "Ricarica"
 }

package/dist/i18n/shell/ja.json

@@ -7,5 +7,7 @@
   "deniedMessage": "この DSM アカウントにはこのアプリを使用する権限がありません。DSM のアプリケーション権限で許可するよう管理者に依頼してください。",
   "notes": "注記",
   "notesCount": "注記（{count}）",
-  "loading": "読み込み中…"
+  "loading": "読み込み中…",
+  "uiUpdated": "更新されました。ページを再読み込みしてください",
+  "uiReload": "再読み込み"
 }

package/dist/i18n/shell/ko.json

@@ -7,5 +7,7 @@
   "deniedMessage": "이 DSM 계정에는 이 앱을 사용할 권한이 없습니다. 관리자에게 DSM 응용 프로그램 권한에서 허용하도록 요청하십시오.",
   "notes": "참고",
   "notesCount": "참고 ({count})",
-  "loading": "불러오는 중…"
+  "loading": "불러오는 중…",
+  "uiUpdated": "업데이트되었습니다. 페이지를 새로 고치십시오",
+  "uiReload": "새로 고침"
 }

package/dist/i18n/shell/zh-CN.json

@@ -7,5 +7,7 @@
   "deniedMessage": "你的 DSM 账号无权使用此应用程序。请管理员在 DSM 的应用程序权限中开放给你。",
   "notes": "附注",
   "notesCount": "附注（{count}）",
-  "loading": "正在加载…"
+  "loading": "正在加载…",
+  "uiUpdated": "已更新，请刷新页面",
+  "uiReload": "刷新"
 }

package/dist/i18n/shell/zh-TW.json

@@ -7,5 +7,7 @@
   "deniedMessage": "你的 DSM 帳號無權使用此應用程式。請管理員在 DSM 的應用程式權限中開放給你。",
   "notes": "附註",
   "notesCount": "附註（{count}）",
-  "loading": "載入中…"
+  "loading": "載入中…",
+  "uiUpdated": "已更新，請重新整理頁面",
+  "uiReload": "重新整理"
 }