@synopackageland/sdk 0.10.3 → 0.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/sdk",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Frontend SDK for DSM packages built with synopkgland: headless client and Vue components",
   "license": "MIT",
   "homepage": "https://github.com/synopackageland/syno-pkg-land-sdk/tree/main/ts#readme",
@@ -57,7 +57,7 @@
   },
   "devDependencies": {
     "@lucide/vue": "1.48.0",
-    "@synopackageland/ui": "0.9.5",
+    "@synopackageland/ui": "0.9.6",
     "@types/node": "24.19.2",
     "@vitejs/plugin-vue": "6.0.9",
     "jsdom": "27.4.0",

package/spec/protocol/v1/README.md

@@ -103,6 +103,19 @@ browser waits 2 seconds past the request (`timeouts.json` holds the values).
   as `EXECUTOR_PROTOCOL`, and an unreachable socket as
   `EXECUTOR_UNAVAILABLE`. Codes of kind `client` are never sent by the
   executor.
+- A client that knows the package's lifecycle mailbox (`<data
+  dir>/executor/control`) answers an unreachable socket with `APP_STOPPED`
+  when its last request is `stop`; within 10 seconds of a `start` it waits
+  for the socket and ends with `APP_STARTING`. Neither sends a byte, so the
+  caller MAY repeat the request.
+- Such a client answers `EXECUTOR_UNAVAILABLE` only for a package that runs
+  and was not started in the last 10 seconds, yet whose executor does not
+  listen: it is not approved, awaits approval after an upgrade, or failed.
+  `retryable` says that nothing was sent, not that waiting helps: a browser
+  client repeats `APP_STOPPED`, `APP_STARTING` and `EXECUTOR_STARTING` on its
+  own, but shows `EXECUTOR_UNAVAILABLE` as the approval state at once, since
+  only an administrator's approval (which also restarts the executor) changes
+  it.
 
 ## Status
 

package/spec/protocol/v1/errors.json

@@ -474,6 +474,22 @@
       "en": "The client could not connect to the executor socket.",
       "zh-TW": "用戶端無法連到 executor socket。"
     },
+    {
+      "code": "APP_STOPPED",
+      "kind": "client",
+      "retryable": true,
+      "httpStatus": 503,
+      "en": "The package is stopped: its lifecycle mailbox asks the executor to stop. The client sent nothing.",
+      "zh-TW": "套件已停止：生命週期信箱要求 executor 停止。用戶端沒有送出任何內容。"
+    },
+    {
+      "code": "APP_STARTING",
+      "kind": "client",
+      "retryable": true,
+      "httpStatus": 503,
+      "en": "The package was just started and its executor is not listening yet. The client sent nothing.",
+      "zh-TW": "套件剛啟動，executor 尚未開始接聽。用戶端沒有送出任何內容。"
+    },
     {
       "code": "EXECUTOR_TIMEOUT",
       "kind": "client",