@pmate/cli 0.21.7 → 0.21.9

package/dist/index.d.ts

@@ -620,6 +620,18 @@ type AppCommandArgs = {
     toId?: string;
     baseUrl?: string;
     json: boolean;
+} | {
+    type: Command.App;
+    action: "icon";
+    id: string;
+    preset?: "android" | "ios";
+    width?: number;
+    height?: number;
+    format?: "png" | "webp" | "svg" | "ico";
+    output?: string;
+    outDir?: string;
+    baseUrl?: string;
+    json: boolean;
 };
 type ServiceCommandArgs = {
     type: Command.Service;

package/dist/index.js

@@ -9435,8 +9435,8 @@ __export(index_exports, {
   parseCommandArgs: () => parseCommandArgs
 });
 module.exports = __toCommonJS(index_exports);
-var import_node_fs19 = require("fs");
-var import_node_path24 = __toESM(require("path"));
+var import_node_fs20 = require("fs");
+var import_node_path25 = __toESM(require("path"));
 var import_chalk4 = __toESM(require("chalk"));
 
 // src/cli.ts
@@ -14585,9 +14585,9 @@ ${indent}\`\`\``;
   static richTextToPlain(richText) {
     return richText.map((item) => item.plain_text ?? item.text?.content ?? "").join("").trim();
   }
-  static async requestJson(path25, init) {
+  static async requestJson(path26, init) {
     const token = this.getToken();
-    const response = await fetch(`${this.baseUrl}${path25}`, {
+    const response = await fetch(`${this.baseUrl}${path26}`, {
       method: init.method,
       headers: {
         Authorization: `Bearer ${token}`,
@@ -16223,8 +16223,8 @@ function descriptorPathSegments(descriptor) {
   return ["chains", normalized.chain, "namespaces", normalized.ns, normalized.kind, normalized.name];
 }
 function buildPathUrl(baseUrl, pathSegments, query) {
-  const path25 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
-  const url = new URL(path25, baseUrl);
+  const path26 = `/${pathSegments.map((segment) => encodeURIComponent(segment)).join("/")}`;
+  const url = new URL(path26, baseUrl);
   if (query) {
     for (const [key, value] of Object.entries(query)) {
       url.searchParams.set(key, String(value));
@@ -17173,9 +17173,155 @@ var StoreCommandHandler = class {
 };
 
 // src/commands/AppCommandHandler.ts
+var import_node_fs17 = require("fs");
+var import_node_path22 = __toESM(require("path"));
+init_sessionStore();
+
+// src/appIcon.ts
 var import_node_fs16 = require("fs");
 var import_node_path21 = __toESM(require("path"));
-init_sessionStore();
+var import_sharp = __toESM(require("sharp"));
+init_namespacedRef();
+var ANDROID_ICON_SPECS = [
+  { width: 48, height: 48, name: "mdpi" },
+  { width: 72, height: 72, name: "hdpi" },
+  { width: 96, height: 96, name: "xhdpi" },
+  { width: 144, height: 144, name: "xxhdpi" },
+  { width: 192, height: 192, name: "xxxhdpi" },
+  { width: 512, height: 512, name: "play-store" }
+];
+var IOS_ICON_SPECS = [
+  { width: 120, height: 120, name: "iphone-notification-2x" },
+  { width: 152, height: 152, name: "ipad-app-2x" },
+  { width: 167, height: 167, name: "ipad-pro-app-2x" },
+  { width: 180, height: 180, name: "iphone-app-3x" },
+  { width: 1024, height: 1024, name: "app-store" }
+];
+var pngToIco = require("png-to-ico").default;
+function normalizeAppIcon(icon, cwd) {
+  if (typeof icon !== "string" || !icon.trim()) {
+    throw new Error("App icon must be a non-empty SVG string or .svg file path.");
+  }
+  const trimmed = icon.trim();
+  if (looksLikeSvgMarkup(trimmed)) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("data:")) {
+    return normalizeSvgDataUrl(trimmed);
+  }
+  if (/^https?:\/\//i.test(trimmed)) {
+    throw new Error("App icon must be SVG source, not a remote URL.");
+  }
+  const absolutePath = import_node_path21.default.resolve(cwd, trimmed);
+  if (!(0, import_node_fs16.existsSync)(absolutePath)) {
+    if (trimmed.toLowerCase().endsWith(".svg")) {
+      throw new Error(`App icon SVG file not found: ${absolutePath}`);
+    }
+    throw new Error("App icon must be inline SVG, an SVG data URL, or a .svg file path.");
+  }
+  if (import_node_path21.default.extname(absolutePath).toLowerCase() !== ".svg") {
+    throw new Error(`App icon file must use the .svg extension: ${absolutePath}`);
+  }
+  const svg = (0, import_node_fs16.readFileSync)(absolutePath, "utf8").trim();
+  if (!looksLikeSvgMarkup(svg)) {
+    throw new Error(`App icon file is not valid SVG: ${absolutePath}`);
+  }
+  return svg;
+}
+function prepareAppPayload(payload, cwd) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    throw new Error("App payload must be a JSON object.");
+  }
+  const normalized = { ...payload };
+  if (normalized.icon !== void 0) {
+    normalized.icon = normalizeAppIcon(normalized.icon, cwd);
+  }
+  return normalized;
+}
+function createAppIconExportPlans(input) {
+  const { namespace, objectId } = parseNamespacedRef(input.id, {
+    entityLabel: "app ref"
+  });
+  if (input.preset) {
+    const specs = input.preset === "android" ? ANDROID_ICON_SPECS : IOS_ICON_SPECS;
+    if (!input.outDir) {
+      throw new Error("App icon preset export requires --out-dir.");
+    }
+    const outDir = import_node_path21.default.resolve(input.cwd, input.outDir);
+    (0, import_node_fs16.mkdirSync)(outDir, { recursive: true });
+    return specs.map((spec) => ({
+      width: spec.width,
+      height: spec.height,
+      format: "png",
+      outputPath: import_node_path21.default.join(
+        outDir,
+        `${namespace}-${objectId}-${spec.name}-${spec.width}x${spec.height}.png`
+      )
+    }));
+  }
+  if (!input.width || !input.height) {
+    throw new Error("App icon export requires either a preset or an explicit size.");
+  }
+  const format = input.format || "png";
+  if (!input.output) {
+    throw new Error("Single-size app icon export requires --output.");
+  }
+  const resolvedOutput = import_node_path21.default.resolve(input.cwd, input.output);
+  (0, import_node_fs16.mkdirSync)(import_node_path21.default.dirname(resolvedOutput), { recursive: true });
+  return [
+    {
+      width: input.width,
+      height: input.height,
+      format,
+      outputPath: resolvedOutput
+    }
+  ];
+}
+async function exportAppIcon(svg, plans) {
+  for (const plan of plans) {
+    const bytes = await renderAppIcon(svg, plan.width, plan.height, plan.format);
+    (0, import_node_fs16.writeFileSync)(plan.outputPath, bytes);
+  }
+}
+async function renderAppIcon(svg, width, height, format) {
+  if (format === "svg") {
+    return Buffer.from(svg);
+  }
+  const pipeline = (0, import_sharp.default)(Buffer.from(svg)).resize(width, height, {
+    fit: "contain",
+    background: { r: 0, g: 0, b: 0, alpha: 0 }
+  });
+  if (format === "webp") {
+    return pipeline.webp().toBuffer();
+  }
+  if (format === "ico") {
+    const pngBuffer = await pipeline.png().toBuffer();
+    return pngToIco([pngBuffer]);
+  }
+  return pipeline.png().toBuffer();
+}
+function looksLikeSvgMarkup(value) {
+  return /<svg[\s>]/i.test(value);
+}
+function normalizeSvgDataUrl(value) {
+  const match = /^data:([^;,]+)?(?:;charset=[^;,]+)?(?:;(base64))?,(.*)$/i.exec(value);
+  if (!match) {
+    throw new Error("Invalid app icon data URL.");
+  }
+  const mimeType = (match[1] || "").toLowerCase();
+  if (mimeType !== "image/svg+xml") {
+    throw new Error(`App icon data URL must be image/svg+xml. Received: ${mimeType || "unknown"}`);
+  }
+  const payload = match[3] || "";
+  const decoded = match[2] ? Buffer.from(payload, "base64").toString("utf8") : decodeURIComponent(payload);
+  const svg = decoded.trim();
+  if (!looksLikeSvgMarkup(svg)) {
+    throw new Error("App icon data URL does not contain valid SVG markup.");
+  }
+  return svg;
+}
+
+// src/commands/AppCommandHandler.ts
 init_namespacedRef();
 var AppCommandHandler = class {
   async handle(args) {
@@ -17206,7 +17352,7 @@ var AppCommandHandler = class {
         return;
       }
       case "create": {
-        const payload = this.readJsonFile(args.filePath);
+        const payload = this.preparePayload(args.filePath);
         await this.requireNamespace(payload, baseUrl);
         const record = await this.request(
           baseUrl,
@@ -17220,7 +17366,7 @@ var AppCommandHandler = class {
         return;
       }
       case "update": {
-        const payload = this.readJsonFile(args.filePath);
+        const payload = this.preparePayload(args.filePath);
         const pathname = this.buildAppPath(args.id);
         const record = await this.request(
           baseUrl,
@@ -17233,6 +17379,39 @@ var AppCommandHandler = class {
         this.renderJson(record, args.json);
         return;
       }
+      case "icon": {
+        const record = await this.request(
+          baseUrl,
+          token,
+          "GET",
+          this.buildAppPath(args.id)
+        );
+        if (!record.icon) {
+          throw new Error(`App icon is missing for ${args.id}`);
+        }
+        const plans = createAppIconExportPlans({
+          id: args.id,
+          preset: args.preset,
+          width: args.width,
+          height: args.height,
+          format: args.format,
+          output: args.output,
+          outDir: args.outDir,
+          cwd: process.cwd()
+        });
+        await exportAppIcon(record.icon, plans);
+        ui.success(`Exported ${plans.length} icon file${plans.length > 1 ? "s" : ""} for ${args.id}`);
+        this.renderJson(
+          plans.map((plan) => ({
+            width: plan.width,
+            height: plan.height,
+            format: plan.format,
+            outputPath: plan.outputPath
+          })),
+          args.json
+        );
+        return;
+      }
       case "delete": {
         const pathname = this.buildAppPath(args.id);
         const record = await this.request(
@@ -17291,11 +17470,11 @@ var AppCommandHandler = class {
     }).token;
   }
   readJsonFile(filePath) {
-    const absolutePath = import_node_path21.default.resolve(process.cwd(), filePath);
-    if (!(0, import_node_fs16.existsSync)(absolutePath)) {
+    const absolutePath = this.resolveFilePath(filePath);
+    if (!(0, import_node_fs17.existsSync)(absolutePath)) {
       throw new Error(`JSON file not found: ${absolutePath}`);
     }
-    const raw = (0, import_node_fs16.readFileSync)(absolutePath, "utf8");
+    const raw = (0, import_node_fs17.readFileSync)(absolutePath, "utf8");
     try {
       return JSON.parse(raw);
     } catch (error) {
@@ -17303,6 +17482,13 @@ var AppCommandHandler = class {
       throw new Error(`Invalid JSON in ${absolutePath}: ${message}`);
     }
   }
+  preparePayload(filePath) {
+    const absolutePath = this.resolveFilePath(filePath);
+    return prepareAppPayload(this.readJsonFile(filePath), import_node_path22.default.dirname(absolutePath));
+  }
+  resolveFilePath(filePath) {
+    return import_node_path22.default.resolve(process.cwd(), filePath);
+  }
   async request(baseUrl, token, method, pathname, body) {
     const response = await fetch(`${baseUrl}${pathname}`, {
       method,
@@ -17375,15 +17561,15 @@ function readNamespaceFromPayload(payload) {
 }
 
 // src/commands/ServiceCommandHandler.ts
-var import_node_fs18 = require("fs");
+var import_node_fs19 = require("fs");
 var import_promises5 = require("fs/promises");
-var import_node_path23 = __toESM(require("path"));
+var import_node_path24 = __toESM(require("path"));
 var import_promises6 = require("readline/promises");
 
 // src/services/ServiceRuntimeRunner.ts
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var import_node_os8 = __toESM(require("os"));
-var import_node_path22 = __toESM(require("path"));
+var import_node_path23 = __toESM(require("path"));
 var import_node_child_process10 = require("child_process");
 var import_node_readline = require("readline");
 var import_chalk3 = __toESM(require("chalk"));
@@ -17496,14 +17682,14 @@ var ServiceRuntimeRunner = class {
   }
   resolveRepoRoot(service, cwd) {
     if (cwd) {
-      return import_node_path22.default.resolve(process.cwd(), cwd);
+      return import_node_path23.default.resolve(process.cwd(), cwd);
     }
     const repository = this.getDeploy(service).repository?.trim();
     if (repository) {
       const repoName = repository.replace(/\/+$/, "").split("/").pop()?.replace(/\.git$/i, "");
       if (repoName) {
-        const candidate = import_node_path22.default.join(import_node_os8.default.homedir(), "dev", "pmate", repoName);
-        if ((0, import_node_fs17.existsSync)(candidate)) {
+        const candidate = import_node_path23.default.join(import_node_os8.default.homedir(), "dev", "pmate", repoName);
+        if ((0, import_node_fs18.existsSync)(candidate)) {
           return candidate;
         }
       }
@@ -17516,12 +17702,12 @@ var ServiceRuntimeRunner = class {
     if (!dir) {
       throw new Error(`Missing deploy.dir for ${service.id}`);
     }
-    return import_node_path22.default.resolve(repoRoot, dir);
+    return import_node_path23.default.resolve(repoRoot, dir);
   }
   async deployVite(service, options) {
     const appDir = this.resolveLocalDir(service, options.cwd);
-    const packageJsonPath = import_node_path22.default.join(appDir, "package.json");
-    if (!(0, import_node_fs17.existsSync)(packageJsonPath)) {
+    const packageJsonPath = import_node_path23.default.join(appDir, "package.json");
+    if (!(0, import_node_fs18.existsSync)(packageJsonPath)) {
       throw new Error(`No package.json found at ${packageJsonPath}`);
     }
     const pkg2 = this.loadPackageJson(packageJsonPath);
@@ -17530,8 +17716,8 @@ var ServiceRuntimeRunner = class {
       throw new Error(`Missing package name in ${packageJsonPath}`);
     }
     await this.runCommand("pnpm", ["--filter", pkgName, "build"], this.resolveRepoRoot(service, options.cwd));
-    const distDir = import_node_path22.default.join(appDir, "dist");
-    if (!(0, import_node_fs17.existsSync)(distDir)) {
+    const distDir = import_node_path23.default.join(appDir, "dist");
+    if (!(0, import_node_fs18.existsSync)(distDir)) {
       throw new Error(`No dist directory found at ${distDir}`);
     }
     const bucketName = this.getDeploy(service).bucket?.trim();
@@ -17542,8 +17728,8 @@ var ServiceRuntimeRunner = class {
   }
   async deployStatic(service, options) {
     const appDir = this.resolveLocalDir(service, options.cwd);
-    const srcDir = import_node_path22.default.join(appDir, "src");
-    if (!(0, import_node_fs17.existsSync)(srcDir)) {
+    const srcDir = import_node_path23.default.join(appDir, "src");
+    if (!(0, import_node_fs18.existsSync)(srcDir)) {
       throw new Error(`No src directory found at ${srcDir}`);
     }
     const bucketName = this.getDeploy(service).bucket?.trim();
@@ -17661,7 +17847,7 @@ var ServiceRuntimeRunner = class {
       const serverAddress = await resolveServerAddress(server);
       const templateName = serviceType === "ws" ? "nginx.ws.template" : "nginx.rest.template";
       const templatePath = this.resolveTemplatePath(templateName);
-      const template = (0, import_node_fs17.readFileSync)(templatePath, "utf8");
+      const template = (0, import_node_fs18.readFileSync)(templatePath, "utf8");
       const host = `${subdomain}.${deploy.domain?.trim() || "pmate.chat"}`;
       const rendered = template.replace(/\$\{\{PORT\}\}/g, String(port)).replace(/\$\{\{HOSTS\}\}/g, host).replace(/\$\{\{HOST\}\}/g, host);
       const remotePath = `/etc/nginx/sites-enabled/${subdomain}.conf`;
@@ -17693,11 +17879,11 @@ var ServiceRuntimeRunner = class {
     }
     if (config.ensurePackageJson) {
       const appDir = this.resolveLocalDir(service, options.cwd);
-      const packageJsonPath = import_node_path22.default.join(appDir, "package.json");
-      if (!(0, import_node_fs17.existsSync)(packageJsonPath)) {
+      const packageJsonPath = import_node_path23.default.join(appDir, "package.json");
+      if (!(0, import_node_fs18.existsSync)(packageJsonPath)) {
         throw new Error(`Missing package.json at ${packageJsonPath}`);
       }
-      const pkgStat = (0, import_node_fs17.statSync)(packageJsonPath);
+      const pkgStat = (0, import_node_fs18.statSync)(packageJsonPath);
       if (!pkgStat.isFile()) {
         throw new Error(`package.json is not a file at ${packageJsonPath}`);
       }
@@ -18120,9 +18306,9 @@ var ServiceRuntimeRunner = class {
     return tokens;
   }
   readPathValue(source, pathExpr) {
-    const path25 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
+    const path26 = pathExpr.split(".").map((segment) => segment.trim()).filter(Boolean);
     let cursor = source;
-    for (const segment of path25) {
+    for (const segment of path26) {
       if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
         return void 0;
       }
@@ -18165,12 +18351,12 @@ var ServiceRuntimeRunner = class {
   }
   resolveTemplatePath(templateName) {
     const candidates = [
-      import_node_path22.default.join(__dirname, "..", "templates", templateName),
-      import_node_path22.default.join(__dirname, "..", "src", "templates", templateName),
-      import_node_path22.default.join(__dirname, "templates", templateName)
+      import_node_path23.default.join(__dirname, "..", "templates", templateName),
+      import_node_path23.default.join(__dirname, "..", "src", "templates", templateName),
+      import_node_path23.default.join(__dirname, "templates", templateName)
     ];
     for (const candidate of candidates) {
-      if ((0, import_node_fs17.existsSync)(candidate)) {
+      if ((0, import_node_fs18.existsSync)(candidate)) {
         return candidate;
       }
     }
@@ -18202,7 +18388,7 @@ var ServiceRuntimeRunner = class {
     });
   }
   loadPackageJson(packageJsonPath) {
-    const raw = (0, import_node_fs17.readFileSync)(packageJsonPath, "utf8");
+    const raw = (0, import_node_fs18.readFileSync)(packageJsonPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") {
       throw new Error(`Invalid package.json at ${packageJsonPath}`);
@@ -18211,7 +18397,7 @@ var ServiceRuntimeRunner = class {
   }
   writePackageJson(packageJsonPath, data) {
     const serialized = JSON.stringify(data, null, 2);
-    (0, import_node_fs17.writeFileSync)(packageJsonPath, `${serialized}
+    (0, import_node_fs18.writeFileSync)(packageJsonPath, `${serialized}
 `, "utf8");
   }
   runCommand(command, args, cwd) {
@@ -18551,7 +18737,7 @@ var ServiceCommandHandler = class {
             format: "dotenv"
           }
         );
-        const outputPath = import_node_path23.default.resolve(process.cwd(), args.output);
+        const outputPath = import_node_path24.default.resolve(process.cwd(), args.output);
         await (0, import_promises5.writeFile)(outputPath, payload.content, "utf8");
         ui.success(`Wrote env file for ${args.appId} to ${outputPath}`);
         this.renderJson({ ...payload, output: outputPath }, args.json);
@@ -18580,11 +18766,11 @@ var ServiceCommandHandler = class {
     return (baseUrl || process.env.PMATE_APPS_API_BASE_URL || "https://apps-api.pmate.chat").replace(/\/+$/, "");
   }
   readJsonFile(filePath) {
-    const absolutePath = import_node_path23.default.resolve(process.cwd(), filePath);
-    if (!(0, import_node_fs18.existsSync)(absolutePath)) {
+    const absolutePath = import_node_path24.default.resolve(process.cwd(), filePath);
+    if (!(0, import_node_fs19.existsSync)(absolutePath)) {
       throw new Error(`JSON file not found: ${absolutePath}`);
     }
-    const raw = (0, import_node_fs18.readFileSync)(absolutePath, "utf8");
+    const raw = (0, import_node_fs19.readFileSync)(absolutePath, "utf8");
     try {
       return JSON.parse(raw);
     } catch (error) {
@@ -19870,7 +20056,7 @@ function parseAppArgs(tokens) {
   const rawAction = rest.shift();
   const action = rawAction === "view" ? "view" : rawAction;
   if (!action) {
-    throw new Error("Missing app action. Use: app list|get|view|create|update|rename|move|delete");
+    throw new Error("Missing app action. Use: app list|get|view|create|update|rename|move|icon|delete");
   }
   let baseUrl;
   let json = false;
@@ -19949,6 +20135,108 @@ function parseAppArgs(tokens) {
     }
     return { type: "app" /* App */, action, id, baseUrl, json };
   }
+  if (action === "icon") {
+    const rawRef = rest.shift();
+    if (!rawRef || rawRef.startsWith("-")) {
+      throw new Error(
+        "Usage: app icon <ns:objectId> [--android|--ios|--size <w>x<h>|--<w>x<h>] [--format <png|webp|svg|ico>] [--output <path>] [--out-dir <path>] [--base-url <url>] [--json]"
+      );
+    }
+    const id = parseNamespacedRef(rawRef, {
+      entityLabel: "app ref"
+    }).fullId;
+    let preset;
+    let width;
+    let height;
+    let format;
+    let output;
+    let outDir;
+    while (rest.length > 0) {
+      const token = rest.shift();
+      const inlineSize = parseInlineSizeToken(token);
+      if (inlineSize) {
+        if (preset || width || height) {
+          throw new Error("App icon export mode already set. Use exactly one of --android, --ios, --size <w>x<h>, or --<w>x<h>.");
+        }
+        width = inlineSize.width;
+        height = inlineSize.height;
+        continue;
+      }
+      switch (token) {
+        case "--android":
+          if (preset || width || height) {
+            throw new Error("App icon export mode already set. Use exactly one of --android, --ios, --size <w>x<h>, or --<w>x<h>.");
+          }
+          preset = "android";
+          break;
+        case "--ios":
+          if (preset || width || height) {
+            throw new Error("App icon export mode already set. Use exactly one of --android, --ios, --size <w>x<h>, or --<w>x<h>.");
+          }
+          preset = "ios";
+          break;
+        case "--size": {
+          if (preset || width || height) {
+            throw new Error("App icon export mode already set. Use exactly one of --android, --ios, --size <w>x<h>, or --<w>x<h>.");
+          }
+          const size = parseSizeValue(requireValue5(rest, token));
+          width = size.width;
+          height = size.height;
+          break;
+        }
+        case "--format": {
+          const value = requireValue5(rest, token);
+          if (value !== "png" && value !== "webp" && value !== "svg" && value !== "ico") {
+            throw new Error(`Invalid app icon format "${value}". Use png, webp, svg, or ico.`);
+          }
+          format = value;
+          break;
+        }
+        case "--output":
+          output = requireValue5(rest, token);
+          break;
+        case "--out-dir":
+          outDir = requireValue5(rest, token);
+          break;
+        case "--base-url":
+          baseUrl = requireValue5(rest, token);
+          break;
+        case "--json":
+          json = true;
+          break;
+        default:
+          throw new Error(`Unknown app icon option: ${token}`);
+      }
+    }
+    if (!preset && (!width || !height)) {
+      throw new Error("Missing app icon export mode. Use one of --android, --ios, --size <w>x<h>, or --<w>x<h>.");
+    }
+    if (preset && output) {
+      throw new Error("App icon preset export writes multiple files. Use --out-dir instead of --output.");
+    }
+    if (preset && !outDir) {
+      throw new Error("App icon preset export requires --out-dir.");
+    }
+    if (!preset && outDir) {
+      throw new Error("Single-size app icon export writes one file. Use --output instead of --out-dir.");
+    }
+    if (!preset && !output) {
+      throw new Error("Single-size app icon export requires --output.");
+    }
+    return {
+      type: "app" /* App */,
+      action,
+      id,
+      preset,
+      width,
+      height,
+      format,
+      output,
+      outDir,
+      baseUrl,
+      json
+    };
+  }
   if (action === "create") {
     let filePath;
     while (rest.length > 0) {
@@ -20091,6 +20379,26 @@ function parseBareRenameId2(value, entityName) {
   }
   return normalized;
 }
+function parseSizeValue(value) {
+  const match = /^(\d+)x(\d+)$/i.exec(value.trim());
+  if (!match) {
+    throw new Error(`Invalid app icon size "${value}". Use <width>x<height>.`);
+  }
+  return {
+    width: Number(match[1]),
+    height: Number(match[2])
+  };
+}
+function parseInlineSizeToken(token) {
+  if (!token.startsWith("--")) {
+    return null;
+  }
+  const value = token.slice(2);
+  if (!/^\d+x\d+$/i.test(value)) {
+    return null;
+  }
+  return parseSizeValue(value);
+}
 
 // src/serviceCommandParser.ts
 init_namespacedRef();
@@ -20982,7 +21290,7 @@ function requireValue10(tokens, option) {
 
 // src/index.ts
 var pkg = JSON.parse(
-  (0, import_node_fs19.readFileSync)(import_node_path24.default.resolve(__dirname, "..", "package.json"), "utf8")
+  (0, import_node_fs20.readFileSync)(import_node_path25.default.resolve(__dirname, "..", "package.json"), "utf8")
 );
 var HELP_TEXT = [
   import_chalk4.default.bold(`pmate v${pkg.version}`),
@@ -21112,6 +21420,9 @@ var HELP_TEXT = [
   `  ${import_chalk4.default.gray("                  update <ns:objectId> --file <path> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  rename --from <id> --to <id> --ns <namespace> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  move --from <id> --ns <namespace> --to-ns <namespace> [--to <id>] [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  icon <ns:objectId> --android --out-dir <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  icon <ns:objectId> --ios --out-dir <path> [--base-url <url>] [--json]")}`,
+  `  ${import_chalk4.default.gray("                  icon <ns:objectId> (--size <w>x<h>|--<w>x<h>) --output <path> [--format <png|webp|svg|ico>] [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  delete <ns:objectId> [--base-url <url>] [--json]")}`,
   `  ${import_chalk4.default.gray("                  default base URL: https://apps-api.pmate.chat")}`,
   `  ${import_chalk4.default.cyan("service")}          Manage service registry entries via apps-api`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmate/cli",
-  "version": "0.21.7",
+  "version": "0.21.9",
   "description": "CLI utilities for the pMate project",
   "license": "MIT",
   "bin": {
@@ -46,7 +46,9 @@
     "jsqr": "^1.4.0",
     "openai": "^6.16.0",
     "playwright": "^1.58.2",
+    "png-to-ico": "^3.0.1",
     "pngjs": "^7.0.0",
+    "sharp": "^0.34.5",
     "tslib": "^2.8.1",
     "yaml": "^2.8.2"
   },
@@ -56,8 +58,8 @@
     "@types/node": "^25.0.3",
     "@types/pngjs": "^6.0.5",
     "rimraf": "^6.1.2",
-    "tsup": "^8.5.0",
     "ts-node": "^10.9.2",
+    "tsup": "^8.5.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.17"
   }