@nextclaw/app-runtime 0.13.2 → 0.13.3

package/README.md

@@ -1,239 +1,37 @@
 # NextClaw App Runtime
 
-`@nextclaw/app-runtime` 是一个独立的微应用 runtime/CLI 包。
+`@nextclaw/app-runtime` is the independently published runtime package that powers NextClaw Mini Apps. It owns artifact validation, package formats, local package state, and the runtime contracts used by the NextClaw host.
 
-当前相对完善 MVP 提供下面这些能力：
+## Install Mini Apps
 
-- `napp create <app-dir>`：生成一个最小可跑的微应用骨架
-- `napp inspect <app-dir>`：校验应用目录与 manifest
-- `napp doctor`：检查本机 NApp/WASI HTTP 开发运行环境
-- `napp build <app-dir> --install`：安装模板依赖并构建 TS/WASI HTTP 后端
-- `napp run <app-dir|app-id>`：启动本地宿主，支持目录运行和已安装应用运行
-- `napp dev <app-dir>`：当前等价于 `run`
-- `napp pack <app-dir>`：把应用目录打成 `.napp` 分发包；独立应用默认使用轻量 `source`，组合包默认使用安全的 `bundle`
-- `napp validate-publish <app-dir>`：本地做发布前校验并输出体积/包内容 warning
-- `napp publish <app-dir>`：把应用目录发布到官方 apps registry；独立应用默认使用 `source`，组合包默认使用 `bundle`
-- `napp install <app-dir|bundle.napp|app-id[@version]>`：从本地或 registry 安装应用
-- `napp update <app-id>`：更新已安装应用
-- `napp uninstall <app-id>`：卸载已安装应用，默认保留受管实例数据；增加 `--purge-data` 才会同时删除
-- `napp list`：列出已安装应用
-- `napp info <app-id>`：查看已安装应用详情
-- `napp registry [get|set|reset]`：查看或切换 registry
-- `napp permissions <app-id>`：查看应用权限状态
-- `napp grant <app-id> --document scope=/path`：写入目录授权
-- `napp revoke <app-id> --document scope`：撤销目录授权
-
-## 安装
-
-```bash
-npm install -g @nextclaw/app-runtime
-```
-
-安装后可用：
-
-```bash
-napp --help
-napp --version
-```
-
-当前版本先聚焦“独立可运行的微应用宿主 + 可分发、可安装、可更新、可授权的 CLI/runtime 闭环”。普通用户入口推荐通过 NextClaw 的 `nextclaw-app-runtime` skill 编排这些命令。
-
-## 应用目录
-
-```text
-manifest.json
-main/
-  app.wasm
-  package.json     # ts-http / ts-http-lite 模板存在
-  src/             # ts-http / ts-http-lite 模板存在
-ui/
-  index.html
-assets/
-```
-
-## 当前 MVP 范围
-
-- `main` 执行形态：`wasm` 或 `wasi-http-component`
-- UI 装载：本地静态服务
-- 宿主桥接：`/__napp/*`
-- WASI HTTP 业务 API：`/api/*`
-- 权限词汇：`documentAccess`、`allowedDomains`、`storage`、`capabilities`
-- 当前 Wasm 执行底座：Node 原生 `WebAssembly` 与 Wasmtime `serve`
-- 分发包形态：`.napp`（底层为 zip，支持 `source` / `bundle` 双模式）
-- 安装目录：`~/.nextclaw/apps/packages/<app-id>/<version>/`
-- 受管实例目录：`~/.nextclaw/apps/instances/<app-id>/default/`
-- 受管实例分类：`data/`、`config/`、`state/`、`cache/`、`tmp/`、`logs/`，并由 `metadata.json` 记录稳定身份
-- 旧用户数据目录：`~/.nextclaw/apps/data/<app-id>/`（首次使用时原子迁移到受管实例）
-- 本地 registry：`~/.nextclaw/apps/registry.json`
-- 本地 config：`~/.nextclaw/apps/config.json`
-- 默认 registry：`https://apps-registry.nextclaw.io/api/v1/apps/registry/`
-
-## 当前 MVP 工作流
-
-开发者工作流：
+Use the NextClaw CLI for every user or AI-facing Mini App action:
 
 ```bash
-napp doctor
-napp create ./my-first-napp --template ts-http
-napp build ./my-first-napp --install
-napp inspect ./my-first-napp
-napp validate-publish ./my-first-napp
-napp run ./my-first-napp --data ./my-first-napp/.napp/data
-napp pack ./my-first-napp
-napp publish ./my-first-napp
+nextclaw app install <app-id|local-app-directory|bundle.napp>
+nextclaw app list
+nextclaw app info <app-id>
+nextclaw app enable <app-id>
+nextclaw app disable <app-id>
+nextclaw app update <app-id>
+nextclaw app rollback <app-id> --version <version>
+nextclaw app uninstall <app-id> --confirm <app-id>
 ```
 
-体积优先工作流：
+The install source may be an App Marketplace identifier, a local app directory, or a local `.napp` bundle. The host records an operation receipt; use `nextclaw app operations --json` to inspect its progress and result.
 
-```bash
-napp doctor
-napp create ./my-small-napp --template ts-http-lite
-napp build ./my-small-napp --install
-napp validate-publish ./my-small-napp
-napp run ./my-small-napp --data ./my-small-napp/.napp/data
-```
-
-本地安装工作流：
-
-```bash
-napp install ./my-first-napp
-napp list
-napp info nextclaw.my-first-napp
-napp run nextclaw.my-first-napp
-```
-
-registry 安装与更新工作流：
-
-```bash
-napp registry set https://registry.example.com/
-napp install nextclaw.hello-notes
-napp permissions nextclaw.hello-notes
-napp grant nextclaw.hello-notes --document notes=/absolute/path/to/notes
-napp run nextclaw.hello-notes
-napp update nextclaw.hello-notes
-```
+## For Runtime Integrators
 
-卸载与权限回收：
+The package remains independently published so the NextClaw host and build tooling can consume its stable runtime contracts. Its package and registry implementation are not a second public product surface. Use the `nextclaw app` CLI and the NextClaw documentation for supported operations.
 
-```bash
-napp revoke nextclaw.my-first-napp --document notes
-napp uninstall nextclaw.my-first-napp
-napp uninstall nextclaw.my-first-napp --purge-data
-```
+## Package Formats
 
-不带 `--purge-data` 时只卸载应用代码和注册记录，受管实例会保留，以便重装后继续使用。带上该选项后，卸载事务才会同时移除该 App 的默认实例。宿主只管理上述实例目录；通过文档授权访问的外部文件或目录不属于 App 实例，卸载和清理数据都不会删除它们。
+Mini Apps use a `.napp` container. A package may be distributed as either:
 
-运行中的 NextClaw 还提供统一的数据清单和残留数据清理入口：
+- `source`: source, UI assets, and manifest are materialized locally at install time.
+- `bundle`: a ready-to-run `main/app.wasm` is included for deterministic or offline delivery.
 
-```bash
-nextclaw app data list --json
-nextclaw app data delete <data-id> --confirm <app-id> --json
-```
+Both variants carry a manifest and checksums. The runtime installs package code separately from each managed App instance, so uninstalling a package can retain the instance data unless the caller explicitly requests data removal.
 
-`data-id` 必须取自最新的 `list` 结果；删除命令只接受已经卸载或已经从 workspace 移除的 `retained` 实例，并要求 `--confirm` 与目标 App id 完全一致。开发 Service App 时，可以显式重置隔离的开发实例：
+## Registry Metadata
 
-```bash
-nextclaw app dev <service-app-dir> --reset-data --confirm <app-id> --json
-```
-
-## 示例
-
-```bash
-napp create ./my-first-napp
-napp inspect ./my-first-napp
-napp pack ./my-first-napp
-napp install ./my-first-napp
-napp list
-napp info nextclaw.my-first-napp
-napp permissions nextclaw.my-first-napp
-napp run nextclaw.my-first-napp
-```
-
-模板选择建议：
-
-- `ts-http`：默认推荐，开发体验优先，适合大多数普通前后端小应用
-- `ts-http-lite`：体积优先，继续走官方 WASI HTTP 路线，但不使用默认 Hono 路由层
-
-已有示例应用：
-
-```bash
-napp inspect ./apps/examples/hello-notes
-napp pack ./apps/examples/hello-notes
-napp publish ./apps/examples/hello-notes
-napp install ./apps/examples/hello-notes
-napp grant nextclaw.hello-notes --document notes=/absolute/path/to/notes
-napp run ./apps/examples/hello-notes --document notes=/absolute/path/to/notes
-```
-
-registry 示例：
-
-```bash
-napp registry get
-napp registry set https://registry.example.com/
-napp install nextclaw.hello-notes
-napp update nextclaw.hello-notes
-```
-
-官方 apps 入口：
-
-- Web：`https://apps.nextclaw.io`
-- Registry/API：`https://apps-registry.nextclaw.io`
-
-## Bundle 结构
-
-`.napp` bundle 的最小结构如下：
-
-```text
-manifest.json
-main/
-ui/
-assets/
-.napp/
-  bundle.json
-  checksums.json
-```
-
-## 分发模式
-
-`.napp` 仍然是统一容器，但现在支持两种分发模式：
-
-- `source`：默认模式。包里主要是用户源码、UI、资源和 manifest；安装时本地物化成运行态，适合轻量分发。
-- `bundle`：显式模式。包里直接带运行态 `main/app.wasm`，适合高级用户、确定性发布或离线场景。
-
-命令示例：
-
-```bash
-napp validate-publish ./my-first-napp --mode source
-napp pack ./my-first-napp --mode source
-napp publish ./my-first-napp --mode source
-napp pack ./my-first-napp --mode bundle
-```
-
-## Registry Metadata 结构
-
-registry 按 npm 风格使用一个 base URL，再按 app id 拉取 metadata 文档。metadata 的最小结构如下：
-
-```json
-{
-  "name": "nextclaw.hello-notes",
-  "description": "Registry-hosted Hello Notes",
-  "dist-tags": {
-    "latest": "0.2.0"
-  },
-  "versions": {
-    "0.2.0": {
-      "name": "nextclaw.hello-notes",
-      "version": "0.2.0",
-      "publisher": {
-        "id": "nextclaw",
-        "name": "NextClaw Official"
-      },
-      "dist": {
-        "kind": "source",
-        "bundle": "./-/hello-notes-0.2.0.napp",
-        "sha256": "<sha256>"
-      }
-    }
-  }
-}
-```
+The registry stores package metadata, versions, publisher identity, distribution location, and integrity data. It does not store a per-App install command: clients derive the single supported command from the app identifier.

package/dist/controllers/publish.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish.controller.d.ts","names":[],"sources":["../../src/controllers/publish.controller.ts"],"mappings":";;;cAEa,cAAA;EAAA,iBAEQ,cAAA;cAAA,cAAA,GAAgB,iBAAA;EAGnC,GAAA,GAAa,MAAA;IACX,YAAA;IACA,YAAA;IACA,UAAA;IACA,KAAA;IACA,IAAA;IACA,IAAA;IACA,KAAA,GAAQ,IAAA;EAAA,MACN,OAAA;AAAA"}
+{"version":3,"file":"publish.controller.d.ts","names":[],"sources":["../../src/controllers/publish.controller.ts"],"mappings":";;;cAGa,cAAA;EAAA,iBAEQ,cAAA;cAAA,cAAA,GAAgB,iBAAA;EAGnC,GAAA,GAAa,MAAA;IACX,YAAA;IACA,YAAA;IACA,UAAA;IACA,KAAA;IACA,IAAA;IACA,IAAA;IACA,KAAA,GAAQ,IAAA;EAAA,MACN,OAAA;AAAA"}

package/dist/controllers/publish.controller.js

@@ -1,4 +1,5 @@
 import { AppPublishService } from "../services/app-publish.service.js";
+import { formatNextClawAppInstallCommand } from "@nextclaw/shared";
 //#region src/controllers/publish.controller.ts
 var PublishCommand = class {
 	constructor(publishService = new AppPublishService()) {
@@ -30,7 +31,7 @@ var PublishCommand = class {
 		write(`${result.created ? "Published" : "Updated"} ${result.item.name} (${result.item.appId}) ${result.item.latestVersion}\n`);
 		write(`Distribution: ${result.distribution.path} (${result.distribution.mode})\n`);
 		if (result.item.webUrl) write(`Details: ${result.item.webUrl}\n`);
-		write(`Install: ${result.item.install.command}\n`);
+		write(`Install: ${formatNextClawAppInstallCommand(result.item.install.spec)}\n`);
 	};
 };
 //#endregion

package/dist/controllers/publish.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"publish.controller.js","names":[],"sources":["../../src/controllers/publish.controller.ts"],"sourcesContent":["import { AppPublishService } from \"#app-runtime/services/app-publish.service.js\";\n\nexport class PublishCommand {\n  constructor(\n    private readonly publishService: AppPublishService = new AppPublishService(),\n  ) {}\n\n  run = async (params: {\n    appDirectory: string;\n    metadataPath?: string;\n    apiBaseUrl?: string;\n    token?: string;\n    mode?: \"source\" | \"bundle\";\n    json: boolean;\n    write: (text: string) => void;\n  }): Promise<void> => {\n    const { appDirectory, metadataPath, apiBaseUrl, token, mode, json, write } = params;\n    const result = await this.publishService.publish({\n      appDirectory,\n      metadataPath,\n      apiBaseUrl,\n      token,\n      mode,\n    });\n    if (json) {\n      write(`${JSON.stringify({ ok: true, publish: result }, null, 2)}\\n`);\n      return;\n    }\n    if (result.item.publishStatus === \"pending\") {\n      write(\n        `Submitted ${result.item.name} (${result.item.appId}) ${result.item.latestVersion} for review.\\n`,\n      );\n      write(\"Status: pending\\n\");\n      write(\"The app will appear in the App Marketplace after approval.\\n\");\n      write(\"Manage submissions: https://platform.nextclaw.io/apps\\n\");\n      return;\n    }\n    write(\n      `${result.created ? \"Published\" : \"Updated\"} ${result.item.name} (${result.item.appId}) ${result.item.latestVersion}\\n`,\n    );\n    write(`Distribution: ${result.distribution.path} (${result.distribution.mode})\\n`);\n    if (result.item.webUrl) {\n      write(`Details: ${result.item.webUrl}\\n`);\n    }\n    write(`Install: ${result.item.install.command}\\n`);\n  };\n}\n"],"mappings":";;AAEA,IAAa,iBAAb,MAA4B;CAC1B,YACE,iBAAqD,IAAI,mBAAmB,EAC5E;AADiB,OAAA,iBAAA;;CAGnB,MAAM,OAAO,WAQQ;EACnB,MAAM,EAAE,cAAc,cAAc,YAAY,OAAO,MAAM,MAAM,UAAU;EAC7E,MAAM,SAAS,MAAM,KAAK,eAAe,QAAQ;GAC/C;GACA;GACA;GACA;GACA;GACD,CAAC;AACF,MAAI,MAAM;AACR,SAAM,GAAG,KAAK,UAAU;IAAE,IAAI;IAAM,SAAS;IAAQ,EAAE,MAAM,EAAE,CAAC,IAAI;AACpE;;AAEF,MAAI,OAAO,KAAK,kBAAkB,WAAW;AAC3C,SACE,aAAa,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,cAAc,gBACnF;AACD,SAAM,oBAAoB;AAC1B,SAAM,+DAA+D;AACrE,SAAM,0DAA0D;AAChE;;AAEF,QACE,GAAG,OAAO,UAAU,cAAc,UAAU,GAAG,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,cAAc,IACrH;AACD,QAAM,iBAAiB,OAAO,aAAa,KAAK,IAAI,OAAO,aAAa,KAAK,KAAK;AAClF,MAAI,OAAO,KAAK,OACd,OAAM,YAAY,OAAO,KAAK,OAAO,IAAI;AAE3C,QAAM,YAAY,OAAO,KAAK,QAAQ,QAAQ,IAAI"}
+{"version":3,"file":"publish.controller.js","names":[],"sources":["../../src/controllers/publish.controller.ts"],"sourcesContent":["import { AppPublishService } from \"#app-runtime/services/app-publish.service.js\";\nimport { formatNextClawAppInstallCommand } from \"@nextclaw/shared\";\n\nexport class PublishCommand {\n  constructor(\n    private readonly publishService: AppPublishService = new AppPublishService(),\n  ) {}\n\n  run = async (params: {\n    appDirectory: string;\n    metadataPath?: string;\n    apiBaseUrl?: string;\n    token?: string;\n    mode?: \"source\" | \"bundle\";\n    json: boolean;\n    write: (text: string) => void;\n  }): Promise<void> => {\n    const { appDirectory, metadataPath, apiBaseUrl, token, mode, json, write } = params;\n    const result = await this.publishService.publish({\n      appDirectory,\n      metadataPath,\n      apiBaseUrl,\n      token,\n      mode,\n    });\n    if (json) {\n      write(`${JSON.stringify({ ok: true, publish: result }, null, 2)}\\n`);\n      return;\n    }\n    if (result.item.publishStatus === \"pending\") {\n      write(\n        `Submitted ${result.item.name} (${result.item.appId}) ${result.item.latestVersion} for review.\\n`,\n      );\n      write(\"Status: pending\\n\");\n      write(\"The app will appear in the App Marketplace after approval.\\n\");\n      write(\"Manage submissions: https://platform.nextclaw.io/apps\\n\");\n      return;\n    }\n    write(\n      `${result.created ? \"Published\" : \"Updated\"} ${result.item.name} (${result.item.appId}) ${result.item.latestVersion}\\n`,\n    );\n    write(`Distribution: ${result.distribution.path} (${result.distribution.mode})\\n`);\n    if (result.item.webUrl) {\n      write(`Details: ${result.item.webUrl}\\n`);\n    }\n    write(`Install: ${formatNextClawAppInstallCommand(result.item.install.spec)}\\n`);\n  };\n}\n"],"mappings":";;;AAGA,IAAa,iBAAb,MAA4B;CAC1B,YACE,iBAAqD,IAAI,mBAAmB,EAC5E;AADiB,OAAA,iBAAA;;CAGnB,MAAM,OAAO,WAQQ;EACnB,MAAM,EAAE,cAAc,cAAc,YAAY,OAAO,MAAM,MAAM,UAAU;EAC7E,MAAM,SAAS,MAAM,KAAK,eAAe,QAAQ;GAC/C;GACA;GACA;GACA;GACA;GACD,CAAC;AACF,MAAI,MAAM;AACR,SAAM,GAAG,KAAK,UAAU;IAAE,IAAI;IAAM,SAAS;IAAQ,EAAE,MAAM,EAAE,CAAC,IAAI;AACpE;;AAEF,MAAI,OAAO,KAAK,kBAAkB,WAAW;AAC3C,SACE,aAAa,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,cAAc,gBACnF;AACD,SAAM,oBAAoB;AAC1B,SAAM,+DAA+D;AACrE,SAAM,0DAA0D;AAChE;;AAEF,QACE,GAAG,OAAO,UAAU,cAAc,UAAU,GAAG,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,cAAc,IACrH;AACD,QAAM,iBAAiB,OAAO,aAAa,KAAK,IAAI,OAAO,aAAa,KAAK,KAAK;AAClF,MAAI,OAAO,KAAK,OACd,OAAM,YAAY,OAAO,KAAK,OAAO,IAAI;AAE3C,QAAM,YAAY,gCAAgC,OAAO,KAAK,QAAQ,KAAK,CAAC,IAAI"}

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.13.2";
+var version = "0.13.3";
 //#endregion
 export { version };
 

package/dist/types/app-publish.types.d.ts

@@ -76,7 +76,6 @@ type AppPublishResult = {
     install: {
       kind: "registry";
       spec: string;
-      command: string;
       registry: string;
     };
   };

package/dist/types/app-publish.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-publish.types.d.ts","names":[],"sources":["../../src/types/app-publish.types.ts"],"mappings":";;;;;cAQa,gCAAA;AAAA,KAGD,qBAAA;EACV,KAAA;EACA,WAAA;AAAA;AAAA,KAGU,sBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA,EAAa,MAAA;EACb,WAAA;EACA,eAAA,GAAkB,MAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA,GAAY,YAAA;EACZ,OAAA,GAAU,qBAAA;AAAA;AAAA,KAGA,cAAA;EACV,IAAA;EACA,aAAA;AAAA;AAAA,KAGU,kBAAA;EACV,MAAA,EAAQ,iBAAA;EACR,YAAA;EACA,YAAA;EACA,SAAA;AAAA;AAAA,KAGG,qBAAA;EACH,IAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,OAAA;EACA,WAAA,EAAa,MAAA;EACb,WAAA;EACA,eAAA,GAAkB,MAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA,EAAW,YAAA;EACX,OAAA,GAAU,qBAAA;EACV,gBAAA,EAAkB,mBAAA;EAClB,QAAA,EAAU,WAAA;EACV,WAAA,EAAa,cAAA;EACb,KAAA,EAAO,cAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA;EAE1B,YAAA;EACA,YAAA;EACA,SAAA;AAAA;EAGA,YAAA;EACA,YAAA;EACA,SAAA,EAAW,kBAAA;AAAA;AAAA,KAIL,gBAAA;EACV,OAAA;EACA,IAAA;IACE,IAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,aAAA;IACA,IAAA;IACA,aAAA;IACA,MAAA;IACA,OAAA;MACE,IAAA;MACA,IAAA;MACA,OAAA;MACA,QAAA;IAAA;EAAA;EAGJ,YAAA;IACE,IAAA;IACA,MAAA;IACA,IAAA,EAAM,mBAAA;IACN,SAAA,GAAY,KAAA;MACV,MAAA,EAAQ,iBAAA;MACR,IAAA;MACA,MAAA;MACA,SAAA;IAAA;EAAA;EAGJ,SAAA;AAAA"}
+{"version":3,"file":"app-publish.types.d.ts","names":[],"sources":["../../src/types/app-publish.types.ts"],"mappings":";;;;;cAQa,gCAAA;AAAA,KAGD,qBAAA;EACV,KAAA;EACA,WAAA;AAAA;AAAA,KAGU,sBAAA;EACV,IAAA;EACA,OAAA;EACA,WAAA,EAAa,MAAA;EACb,WAAA;EACA,eAAA,GAAkB,MAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA,GAAY,YAAA;EACZ,OAAA,GAAU,qBAAA;AAAA;AAAA,KAGA,cAAA;EACV,IAAA;EACA,aAAA;AAAA;AAAA,KAGU,kBAAA;EACV,MAAA,EAAQ,iBAAA;EACR,YAAA;EACA,YAAA;EACA,SAAA;AAAA;AAAA,KAGG,qBAAA;EACH,IAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,OAAA;EACA,WAAA,EAAa,MAAA;EACb,WAAA;EACA,eAAA,GAAkB,MAAA;EAClB,MAAA;EACA,IAAA;EACA,UAAA;EACA,QAAA;EACA,QAAA;EACA,SAAA,EAAW,YAAA;EACX,OAAA,GAAU,qBAAA;EACV,gBAAA,EAAkB,mBAAA;EAClB,QAAA,EAAU,WAAA;EACV,WAAA,EAAa,cAAA;EACb,KAAA,EAAO,cAAA;AAAA;AAAA,KAGG,iBAAA,GAAoB,qBAAA;EAE1B,YAAA;EACA,YAAA;EACA,SAAA;AAAA;EAGA,YAAA;EACA,YAAA;EACA,SAAA,EAAW,kBAAA;AAAA;AAAA,KAIL,gBAAA;EACV,OAAA;EACA,IAAA;IACE,IAAA;IACA,KAAA;IACA,UAAA;IACA,OAAA;IACA,aAAA;IACA,IAAA;IACA,aAAA;IACA,MAAA;IACA,OAAA;MACE,IAAA;MACA,IAAA;MACA,QAAA;IAAA;EAAA;EAGJ,YAAA;IACE,IAAA;IACA,MAAA;IACA,IAAA,EAAM,mBAAA;IACN,SAAA,GAAY,KAAA;MACV,MAAA,EAAQ,iBAAA;MACR,IAAA;MACA,MAAA;MACA,SAAA;IAAA;EAAA;EAGJ,SAAA;AAAA"}

package/dist/types/app-publish.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-publish.types.js","names":[],"sources":["../../src/types/app-publish.types.ts"],"sourcesContent":["import type { AppDistributionMode } from \"#app-runtime/types/app-bundle.types.js\";\nimport type {\n  AppArtifactTarget,\n  AppManifest,\n  AppPermissions,\n} from \"#app-runtime/types/app-manifest.types.js\";\nimport type { AppPublisher } from \"#app-runtime/types/app-remote-registry.types.js\";\n\nexport const DEFAULT_APP_MARKETPLACE_API_BASE =\n  \"https://apps-registry.nextclaw.io\";\n\nexport type AppMarketplaceVisuals = {\n  cover: string;\n  accentColor: string;\n};\n\nexport type AppMarketplaceMetadata = {\n  slug: string;\n  summary: string;\n  summaryI18n: Record<string, string>;\n  description?: string;\n  descriptionI18n?: Record<string, string>;\n  author: string;\n  tags: string[];\n  sourceRepo?: string;\n  homepage?: string;\n  featured?: boolean;\n  publisher?: AppPublisher;\n  visuals?: AppMarketplaceVisuals;\n};\n\nexport type AppPublishFile = {\n  path: string;\n  contentBase64: string;\n};\n\nexport type AppPublishArtifact = {\n  target: AppArtifactTarget;\n  bundleBase64: string;\n  bundleSha256: string;\n  sizeBytes: number;\n};\n\ntype AppPublishPayloadBase = {\n  slug: string;\n  appId: string;\n  name: string;\n  version: string;\n  summary: string;\n  summaryI18n: Record<string, string>;\n  description?: string;\n  descriptionI18n?: Record<string, string>;\n  author: string;\n  tags: string[];\n  sourceRepo?: string;\n  homepage?: string;\n  featured: boolean;\n  publisher: AppPublisher;\n  visuals?: AppMarketplaceVisuals;\n  distributionMode: AppDistributionMode;\n  manifest: AppManifest;\n  permissions: AppPermissions;\n  files: AppPublishFile[];\n};\n\nexport type AppPublishPayload = AppPublishPayloadBase & (\n  | {\n      bundleBase64: string;\n      bundleSha256: string;\n      artifacts?: never;\n    }\n  | {\n      bundleBase64?: never;\n      bundleSha256?: never;\n      artifacts: AppPublishArtifact[];\n    }\n);\n\nexport type AppPublishResult = {\n  created: boolean;\n  item: {\n    slug: string;\n    appId: string;\n    ownerScope: string;\n    appName: string;\n    publishStatus: \"pending\" | \"published\";\n    name: string;\n    latestVersion: string;\n    webUrl?: string;\n    install: {\n      kind: \"registry\";\n      spec: string;\n      command: string;\n      registry: string;\n    };\n  };\n  distribution: {\n    path?: string;\n    sha256?: string;\n    mode: AppDistributionMode;\n    artifacts?: Array<{\n      target: AppArtifactTarget;\n      path?: string;\n      sha256: string;\n      sizeBytes: number;\n    }>;\n  };\n  fileCount: number;\n};\n"],"mappings":";AAQA,MAAa,mCACX"}
+{"version":3,"file":"app-publish.types.js","names":[],"sources":["../../src/types/app-publish.types.ts"],"sourcesContent":["import type { AppDistributionMode } from \"#app-runtime/types/app-bundle.types.js\";\nimport type {\n  AppArtifactTarget,\n  AppManifest,\n  AppPermissions,\n} from \"#app-runtime/types/app-manifest.types.js\";\nimport type { AppPublisher } from \"#app-runtime/types/app-remote-registry.types.js\";\n\nexport const DEFAULT_APP_MARKETPLACE_API_BASE =\n  \"https://apps-registry.nextclaw.io\";\n\nexport type AppMarketplaceVisuals = {\n  cover: string;\n  accentColor: string;\n};\n\nexport type AppMarketplaceMetadata = {\n  slug: string;\n  summary: string;\n  summaryI18n: Record<string, string>;\n  description?: string;\n  descriptionI18n?: Record<string, string>;\n  author: string;\n  tags: string[];\n  sourceRepo?: string;\n  homepage?: string;\n  featured?: boolean;\n  publisher?: AppPublisher;\n  visuals?: AppMarketplaceVisuals;\n};\n\nexport type AppPublishFile = {\n  path: string;\n  contentBase64: string;\n};\n\nexport type AppPublishArtifact = {\n  target: AppArtifactTarget;\n  bundleBase64: string;\n  bundleSha256: string;\n  sizeBytes: number;\n};\n\ntype AppPublishPayloadBase = {\n  slug: string;\n  appId: string;\n  name: string;\n  version: string;\n  summary: string;\n  summaryI18n: Record<string, string>;\n  description?: string;\n  descriptionI18n?: Record<string, string>;\n  author: string;\n  tags: string[];\n  sourceRepo?: string;\n  homepage?: string;\n  featured: boolean;\n  publisher: AppPublisher;\n  visuals?: AppMarketplaceVisuals;\n  distributionMode: AppDistributionMode;\n  manifest: AppManifest;\n  permissions: AppPermissions;\n  files: AppPublishFile[];\n};\n\nexport type AppPublishPayload = AppPublishPayloadBase & (\n  | {\n      bundleBase64: string;\n      bundleSha256: string;\n      artifacts?: never;\n    }\n  | {\n      bundleBase64?: never;\n      bundleSha256?: never;\n      artifacts: AppPublishArtifact[];\n    }\n);\n\nexport type AppPublishResult = {\n  created: boolean;\n  item: {\n    slug: string;\n    appId: string;\n    ownerScope: string;\n    appName: string;\n    publishStatus: \"pending\" | \"published\";\n    name: string;\n    latestVersion: string;\n    webUrl?: string;\n    install: {\n      kind: \"registry\";\n      spec: string;\n      registry: string;\n    };\n  };\n  distribution: {\n    path?: string;\n    sha256?: string;\n    mode: AppDistributionMode;\n    artifacts?: Array<{\n      target: AppArtifactTarget;\n      path?: string;\n      sha256: string;\n      sizeBytes: number;\n    }>;\n  };\n  fileCount: number;\n};\n"],"mappings":";AAQA,MAAa,mCACX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/app-runtime",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "private": false,
   "description": "Standalone micro app runtime and CLI for NextClaw apps.",
   "type": "module",
@@ -56,7 +56,8 @@
     "README.md"
   ],
   "dependencies": {
-    "fflate": "^0.8.2"
+    "fflate": "^0.8.2",
+    "@nextclaw/shared": "0.4.29"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",