sealos-cli 1.1.2 → 1.1.3

package/README.md

@@ -117,6 +117,7 @@ sealos-cli logout
 
 ```bash
 # Deploy from the catalog
+sealos-cli template deploy rybbit
 sealos-cli template deploy perplexica --name my-app --set OPENAI_API_KEY=xxx
 
 # Validate raw template YAML without creating resources
@@ -202,6 +203,8 @@ sealos-cli database restart my-db
 sealos-cli database backup my-db --name manual-backup
 sealos-cli database backups my-db
 sealos-cli database restore my-db --from manual-backup --name restored-db
+sealos-cli database expose my-db
+sealos-cli database unexpose my-db
 sealos-cli database enable-public my-db
 sealos-cli database disable-public my-db
 sealos-cli database log-files <pod-name> --db-type postgresql --log-type runtimeLog

package/dist/bin/cli.cjs

@@ -5535,6 +5535,40 @@ function normalizeDatabaseType(type) {
   return resolved;
 }
 __name(normalizeDatabaseType, "normalizeDatabaseType");
+function getDatabaseConnectScheme(type) {
+  const databaseType = normalizeDatabaseType(type);
+  const schemes = {
+    postgresql: "postgresql",
+    mongodb: "mongodb",
+    "apecloud-mysql": "mysql",
+    mysql: "mysql",
+    redis: "redis",
+    kafka: "kafka",
+    qdrant: "qdrant",
+    nebula: "nebula",
+    weaviate: "weaviate",
+    milvus: "milvus",
+    pulsar: "pulsar",
+    clickhouse: "clickhouse"
+  };
+  return schemes[databaseType];
+}
+__name(getDatabaseConnectScheme, "getDatabaseConnectScheme");
+function buildConsolePublicConnection(options) {
+  if (!options.domain || !options.nodePort) return null;
+  const scheme = getDatabaseConnectScheme(options.dbType);
+  const port = String(options.nodePort);
+  if (scheme === "kafka" || scheme === "milvus") {
+    return `${options.domain}:${port}`;
+  }
+  if (!options.username || !options.password) return null;
+  let connection = `${scheme}://${options.username}:${options.password}@${options.domain}:${port}`;
+  if (scheme === "mongodb" || scheme === "postgresql") {
+    connection += "/?directConnection=true";
+  }
+  return connection;
+}
+__name(buildConsolePublicConnection, "buildConsolePublicConnection");
 function normalizeLogDbType(type) {
   const normalized = normalizeDatabaseType(type);
   if (!SUPPORTED_LOG_DB_TYPES.includes(normalized)) {
@@ -5703,6 +5737,86 @@ function printConnectionDetail(connection) {
   outputTable(rows);
 }
 __name(printConnectionDetail, "printConnectionDetail");
+function buildPublicAccessResult(action, name, connection) {
+  return {
+    success: true,
+    action,
+    resource: "database",
+    name,
+    status: action === "enable-public" ? "enabled" : "disabled",
+    publicConnection: connection?.publicConnection ?? null,
+    connection: connection ?? null
+  };
+}
+__name(buildPublicAccessResult, "buildPublicAccessResult");
+function getDatabaseProviderHost() {
+  const override = process.env.SEALOS_DATABASE_HOST?.trim();
+  if (override) {
+    return override.replace(/\/+$/, "");
+  }
+  let authRegion;
+  try {
+    authRegion = loadAuth().region;
+  } catch {
+    authRegion = void 0;
+  }
+  return resolveDbproviderHost(process.env.SEALOS_REGION || authRegion || DEFAULT_SEALOS_REGION);
+}
+__name(getDatabaseProviderHost, "getDatabaseProviderHost");
+async function getLegacyApiData(path, headers) {
+  const url = new URL(path, getDatabaseProviderHost());
+  const response = await fetch(url, {
+    headers: {
+      Authorization: headers.Authorization
+    }
+  });
+  const body = await response.json();
+  if (!response.ok || body.code !== 200) {
+    throw new Error(body.message || `Request failed: ${url.pathname}`);
+  }
+  return body.data;
+}
+__name(getLegacyApiData, "getLegacyApiData");
+async function fetchConsoleConnectionDetails(name, dbType, fallbackConnection, headers) {
+  const [secret, service, config] = await Promise.all([
+    getLegacyApiData(`/api/getSecretByName?dbName=${encodeURIComponent(name)}&dbType=${encodeURIComponent(dbType)}&mock=false`, headers),
+    getLegacyApiData(`/api/getServiceByName?name=${encodeURIComponent(`${name}-export`)}`, headers).catch(() => null),
+    getLegacyApiData("/api/platform/getClientAppConfig", headers).catch(() => null)
+  ]);
+  const nodePort = service?.spec?.ports?.find((port) => port.nodePort)?.nodePort;
+  const publicConnection = buildConsolePublicConnection({
+    dbType,
+    username: secret.username,
+    password: secret.password,
+    domain: config?.domain,
+    nodePort
+  }) ?? fallbackConnection?.publicConnection ?? null;
+  return {
+    privateConnection: {
+      endpoint: `${secret.host}:${secret.port}`,
+      host: secret.host,
+      port: secret.port,
+      username: secret.username,
+      password: secret.password,
+      connectionString: secret.connection
+    },
+    publicConnection
+  };
+}
+__name(fetchConsoleConnectionDetails, "fetchConsoleConnectionDetails");
+async function loadDatabaseConnectionDetails(name, headers) {
+  const client = createDatabaseClient();
+  const { data, error: error2, response } = await client.GET("/databases/{databaseName}", {
+    headers,
+    params: {
+      path: { databaseName: name }
+    }
+  });
+  if (error2) throw mapApiError(response.status, error2);
+  if (!data.type) return data.connection ?? null;
+  return await fetchConsoleConnectionDetails(name, data.type, data.connection, headers);
+}
+__name(loadDatabaseConnectionDetails, "loadDatabaseConnectionDetails");
 function createDatabaseCommand() {
   const dbCmd = new import_commander7.Command("database").alias("db").description("Manage databases");
   dbCmd.command("list").description("List databases").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Loading databases..." }, async (ctx, options) => {
@@ -5832,20 +5946,13 @@ function createDatabaseCommand() {
     printDatabaseDetail(data);
   }));
   dbCmd.command("connection <name>").description("Show database connection details").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Loading connection details..." }, async (ctx, name, options) => {
-    const client = createDatabaseClient();
-    const { data, error: error2, response } = await client.GET("/databases/{databaseName}", {
-      headers: ctx.auth,
-      params: {
-        path: { databaseName: name }
-      }
-    });
-    if (error2) throw mapApiError(response.status, error2);
+    const connection = await loadDatabaseConnectionDetails(name, ctx.auth);
     ctx.spinner.stop();
     if (options.output === "json") {
-      outputJson(data.connection ?? null);
+      outputJson(connection);
       return;
     }
-    printConnectionDetail(data.connection);
+    printConnectionDetail(connection);
   }));
   dbCmd.command("update <name>").description("Update database resources").option("--cpu <cpu>", "CPU cores per replica").option("--memory <memory>", "Memory in GB per replica").option("--storage <storage>", "Storage in GB per replica").option("--replicas <replicas>", "Replica count").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({
     spinnerText: "Updating database..."
@@ -6082,7 +6189,7 @@ function createDatabaseCommand() {
     }
     ctx.spinner.succeed(`Restore requested from backup "${options.from}"`);
   }));
-  dbCmd.command("enable-public <name>").description("Enable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Enabling public access..." }, async (ctx, name, options) => {
+  dbCmd.command("enable-public <name>").alias("expose").description("Enable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Enabling public access..." }, async (ctx, name, options) => {
     const client = createDatabaseClient();
     const { error: error2, response } = await client.POST("/databases/{databaseName}/enable-public", {
       headers: ctx.auth,
@@ -6091,20 +6198,16 @@ function createDatabaseCommand() {
       }
     });
     if (error2) throw mapApiError(response.status, error2);
+    const connection = await loadDatabaseConnectionDetails(name, ctx.auth);
     if (options.output === "json") {
       ctx.spinner.stop();
-      outputJson({
-        success: true,
-        action: "enable-public",
-        resource: "database",
-        name,
-        status: "enabled"
-      });
+      outputJson(buildPublicAccessResult("enable-public", name, connection));
       return;
     }
     ctx.spinner.succeed(`Public access enabled for "${name}"`);
+    printConnectionDetail(connection);
   }));
-  dbCmd.command("disable-public <name>").description("Disable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Disabling public access..." }, async (ctx, name, options) => {
+  dbCmd.command("disable-public <name>").alias("unexpose").description("Disable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Disabling public access..." }, async (ctx, name, options) => {
     const client = createDatabaseClient();
     const { error: error2, response } = await client.POST("/databases/{databaseName}/disable-public", {
       headers: ctx.auth,
@@ -6115,13 +6218,7 @@ function createDatabaseCommand() {
     if (error2) throw mapApiError(response.status, error2);
     if (options.output === "json") {
       ctx.spinner.stop();
-      outputJson({
-        success: true,
-        action: "disable-public",
-        resource: "database",
-        name,
-        status: "disabled"
-      });
+      outputJson(buildPublicAccessResult("disable-public", name));
       return;
     }
     ctx.spinner.succeed(`Public access disabled for "${name}"`);
@@ -6207,6 +6304,22 @@ page=${data.data.metadata.page} total=${data.data.metadata.total} hasMore=${Stri
     }
     outputTable(rows);
   }));
+  dbCmd.command("* [args...]", { hidden: true }).option("-o, --output <format>", "Output format (json|table)", "json").allowUnknownOption().action(async (args, options) => {
+    const [name, operation, ...rest] = args;
+    const aliases = {
+      connection: "connection",
+      connect: "connection",
+      "enable-public": "enable-public",
+      expose: "expose",
+      "disable-public": "disable-public",
+      unexpose: "unexpose"
+    };
+    const command = operation ? aliases[operation] : void 0;
+    if (!name || !command) {
+      throw new Error('Unknown database command. Use "sealos-cli database --help" to list supported commands.');
+    }
+    await dbCmd.parseAsync([command, name, ...rest, "--output", options.output], { from: "user" });
+  });
   return dbCmd;
 }
 __name(createDatabaseCommand, "createDatabaseCommand");
@@ -6253,17 +6366,15 @@ async function resolveYaml(options, spinner2) {
 }
 __name(resolveYaml, "resolveYaml");
 function resolveTemplateDeployMode(template, options, stdinIsTTY = process.stdin.isTTY) {
-  const isRaw = !!(options.file || options.yaml || !stdinIsTTY);
-  if (template && isRaw) {
-    throw new Error("Cannot specify both a template name and --file/--yaml/stdin. Use one or the other.");
+  const hasExplicitRawInput = !!(options.file || options.yaml);
+  const isRaw = hasExplicitRawInput || !template && !stdinIsTTY;
+  if (template && hasExplicitRawInput) {
+    throw new Error("Cannot specify both a template name and --file/--yaml. Use one or the other.");
   }
   if (!template && !isRaw) {
     throw new Error("Provide a template name or use --file/--yaml/stdin to supply raw YAML.");
   }
   if (template) {
-    if (!options.name) {
-      throw new Error("--name is required when deploying from the template catalog.");
-    }
     if (options.dryRun) {
       throw new Error("--dry-run is only supported for raw template deploys (--file, --yaml, or stdin).");
     }
@@ -6274,7 +6385,7 @@ function resolveTemplateDeployMode(template, options, stdinIsTTY = process.stdin
 __name(resolveTemplateDeployMode, "resolveTemplateDeployMode");
 function buildCatalogTemplateDeployBody(template, options) {
   const body = {
-    name: options.name,
+    name: options.name ?? template,
     template
   };
   if (options.set.length > 0) {
@@ -6484,9 +6595,10 @@ function createTemplateCommand() {
     }
     ctx.spinner.succeed(`Instance "${instance}" deleted`);
   }));
-  tplCmd.command("deploy [template]").description("Deploy a template (from catalog or raw YAML)").option("--name <name>", "Instance name (required when deploying from catalog)").option("--file <path>", "Path to template YAML file").option("--yaml <yaml>", "Template YAML string").option("--set <KEY=VALUE...>", "Set template arguments", (val, prev) => [...prev, val], []).option("--dry-run", "Validate raw template YAML without creating resources").option("-o, --output <format>", "Output format (json|table)", "json").addHelpText("after", `
+  tplCmd.command("deploy [template]").description("Deploy a template (from catalog or raw YAML)").option("--name <name>", "Instance name (defaults to the catalog template name)").option("--file <path>", "Path to template YAML file").option("--yaml <yaml>", "Template YAML string").option("--set <KEY=VALUE...>", "Set template arguments", (val, prev) => [...prev, val], []).option("--dry-run", "Validate raw template YAML without creating resources").option("-o, --output <format>", "Output format (json|table)", "json").addHelpText("after", `
 Examples:
   Catalog:
+    sealos-cli template deploy rybbit
     sealos-cli template deploy perplexica --name my-app --set OPENAI_API_KEY=xxx
 
   Raw:
@@ -6496,8 +6608,12 @@ kind: Template
 ...'
     cat template.yaml | sealos-cli template deploy --dry-run
 `).action(async (template, options) => {
-    const mode = resolveTemplateDeployMode(template, options);
-    await deployTemplate(template, options, mode);
+    try {
+      const mode = resolveTemplateDeployMode(template, options);
+      await deployTemplate(template, options, mode);
+    } catch (error2) {
+      handleError(error2);
+    }
   });
   return tplCmd;
 }
@@ -6506,7 +6622,7 @@ __name(createTemplateCommand, "createTemplateCommand");
 // package.json
 var package_default = {
   name: "sealos-cli",
-  version: "1.1.2",
+  version: "1.1.3",
   description: "Official CLI tool for Sealos Cloud - Manage auth, workspaces, devboxes, databases, and templates",
   types: "dist/main.d.ts",
   type: "module",

package/dist/bin/cli.mjs

@@ -5513,6 +5513,40 @@ function normalizeDatabaseType(type) {
   return resolved;
 }
 __name(normalizeDatabaseType, "normalizeDatabaseType");
+function getDatabaseConnectScheme(type) {
+  const databaseType = normalizeDatabaseType(type);
+  const schemes = {
+    postgresql: "postgresql",
+    mongodb: "mongodb",
+    "apecloud-mysql": "mysql",
+    mysql: "mysql",
+    redis: "redis",
+    kafka: "kafka",
+    qdrant: "qdrant",
+    nebula: "nebula",
+    weaviate: "weaviate",
+    milvus: "milvus",
+    pulsar: "pulsar",
+    clickhouse: "clickhouse"
+  };
+  return schemes[databaseType];
+}
+__name(getDatabaseConnectScheme, "getDatabaseConnectScheme");
+function buildConsolePublicConnection(options) {
+  if (!options.domain || !options.nodePort) return null;
+  const scheme = getDatabaseConnectScheme(options.dbType);
+  const port = String(options.nodePort);
+  if (scheme === "kafka" || scheme === "milvus") {
+    return `${options.domain}:${port}`;
+  }
+  if (!options.username || !options.password) return null;
+  let connection = `${scheme}://${options.username}:${options.password}@${options.domain}:${port}`;
+  if (scheme === "mongodb" || scheme === "postgresql") {
+    connection += "/?directConnection=true";
+  }
+  return connection;
+}
+__name(buildConsolePublicConnection, "buildConsolePublicConnection");
 function normalizeLogDbType(type) {
   const normalized = normalizeDatabaseType(type);
   if (!SUPPORTED_LOG_DB_TYPES.includes(normalized)) {
@@ -5681,6 +5715,86 @@ function printConnectionDetail(connection) {
   outputTable(rows);
 }
 __name(printConnectionDetail, "printConnectionDetail");
+function buildPublicAccessResult(action, name, connection) {
+  return {
+    success: true,
+    action,
+    resource: "database",
+    name,
+    status: action === "enable-public" ? "enabled" : "disabled",
+    publicConnection: connection?.publicConnection ?? null,
+    connection: connection ?? null
+  };
+}
+__name(buildPublicAccessResult, "buildPublicAccessResult");
+function getDatabaseProviderHost() {
+  const override = process.env.SEALOS_DATABASE_HOST?.trim();
+  if (override) {
+    return override.replace(/\/+$/, "");
+  }
+  let authRegion;
+  try {
+    authRegion = loadAuth().region;
+  } catch {
+    authRegion = void 0;
+  }
+  return resolveDbproviderHost(process.env.SEALOS_REGION || authRegion || DEFAULT_SEALOS_REGION);
+}
+__name(getDatabaseProviderHost, "getDatabaseProviderHost");
+async function getLegacyApiData(path, headers) {
+  const url = new URL(path, getDatabaseProviderHost());
+  const response = await fetch(url, {
+    headers: {
+      Authorization: headers.Authorization
+    }
+  });
+  const body = await response.json();
+  if (!response.ok || body.code !== 200) {
+    throw new Error(body.message || `Request failed: ${url.pathname}`);
+  }
+  return body.data;
+}
+__name(getLegacyApiData, "getLegacyApiData");
+async function fetchConsoleConnectionDetails(name, dbType, fallbackConnection, headers) {
+  const [secret, service, config] = await Promise.all([
+    getLegacyApiData(`/api/getSecretByName?dbName=${encodeURIComponent(name)}&dbType=${encodeURIComponent(dbType)}&mock=false`, headers),
+    getLegacyApiData(`/api/getServiceByName?name=${encodeURIComponent(`${name}-export`)}`, headers).catch(() => null),
+    getLegacyApiData("/api/platform/getClientAppConfig", headers).catch(() => null)
+  ]);
+  const nodePort = service?.spec?.ports?.find((port) => port.nodePort)?.nodePort;
+  const publicConnection = buildConsolePublicConnection({
+    dbType,
+    username: secret.username,
+    password: secret.password,
+    domain: config?.domain,
+    nodePort
+  }) ?? fallbackConnection?.publicConnection ?? null;
+  return {
+    privateConnection: {
+      endpoint: `${secret.host}:${secret.port}`,
+      host: secret.host,
+      port: secret.port,
+      username: secret.username,
+      password: secret.password,
+      connectionString: secret.connection
+    },
+    publicConnection
+  };
+}
+__name(fetchConsoleConnectionDetails, "fetchConsoleConnectionDetails");
+async function loadDatabaseConnectionDetails(name, headers) {
+  const client = createDatabaseClient();
+  const { data, error: error2, response } = await client.GET("/databases/{databaseName}", {
+    headers,
+    params: {
+      path: { databaseName: name }
+    }
+  });
+  if (error2) throw mapApiError(response.status, error2);
+  if (!data.type) return data.connection ?? null;
+  return await fetchConsoleConnectionDetails(name, data.type, data.connection, headers);
+}
+__name(loadDatabaseConnectionDetails, "loadDatabaseConnectionDetails");
 function createDatabaseCommand() {
   const dbCmd = new Command7("database").alias("db").description("Manage databases");
   dbCmd.command("list").description("List databases").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Loading databases..." }, async (ctx, options) => {
@@ -5810,20 +5924,13 @@ function createDatabaseCommand() {
     printDatabaseDetail(data);
   }));
   dbCmd.command("connection <name>").description("Show database connection details").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Loading connection details..." }, async (ctx, name, options) => {
-    const client = createDatabaseClient();
-    const { data, error: error2, response } = await client.GET("/databases/{databaseName}", {
-      headers: ctx.auth,
-      params: {
-        path: { databaseName: name }
-      }
-    });
-    if (error2) throw mapApiError(response.status, error2);
+    const connection = await loadDatabaseConnectionDetails(name, ctx.auth);
     ctx.spinner.stop();
     if (options.output === "json") {
-      outputJson(data.connection ?? null);
+      outputJson(connection);
       return;
     }
-    printConnectionDetail(data.connection);
+    printConnectionDetail(connection);
   }));
   dbCmd.command("update <name>").description("Update database resources").option("--cpu <cpu>", "CPU cores per replica").option("--memory <memory>", "Memory in GB per replica").option("--storage <storage>", "Storage in GB per replica").option("--replicas <replicas>", "Replica count").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({
     spinnerText: "Updating database..."
@@ -6060,7 +6167,7 @@ function createDatabaseCommand() {
     }
     ctx.spinner.succeed(`Restore requested from backup "${options.from}"`);
   }));
-  dbCmd.command("enable-public <name>").description("Enable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Enabling public access..." }, async (ctx, name, options) => {
+  dbCmd.command("enable-public <name>").alias("expose").description("Enable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Enabling public access..." }, async (ctx, name, options) => {
     const client = createDatabaseClient();
     const { error: error2, response } = await client.POST("/databases/{databaseName}/enable-public", {
       headers: ctx.auth,
@@ -6069,20 +6176,16 @@ function createDatabaseCommand() {
       }
     });
     if (error2) throw mapApiError(response.status, error2);
+    const connection = await loadDatabaseConnectionDetails(name, ctx.auth);
     if (options.output === "json") {
       ctx.spinner.stop();
-      outputJson({
-        success: true,
-        action: "enable-public",
-        resource: "database",
-        name,
-        status: "enabled"
-      });
+      outputJson(buildPublicAccessResult("enable-public", name, connection));
       return;
     }
     ctx.spinner.succeed(`Public access enabled for "${name}"`);
+    printConnectionDetail(connection);
   }));
-  dbCmd.command("disable-public <name>").description("Disable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Disabling public access..." }, async (ctx, name, options) => {
+  dbCmd.command("disable-public <name>").alias("unexpose").description("Disable public access for a database").option("-o, --output <format>", "Output format (json|table)", "json").action(withAuth({ spinnerText: "Disabling public access..." }, async (ctx, name, options) => {
     const client = createDatabaseClient();
     const { error: error2, response } = await client.POST("/databases/{databaseName}/disable-public", {
       headers: ctx.auth,
@@ -6093,13 +6196,7 @@ function createDatabaseCommand() {
     if (error2) throw mapApiError(response.status, error2);
     if (options.output === "json") {
       ctx.spinner.stop();
-      outputJson({
-        success: true,
-        action: "disable-public",
-        resource: "database",
-        name,
-        status: "disabled"
-      });
+      outputJson(buildPublicAccessResult("disable-public", name));
       return;
     }
     ctx.spinner.succeed(`Public access disabled for "${name}"`);
@@ -6185,6 +6282,22 @@ page=${data.data.metadata.page} total=${data.data.metadata.total} hasMore=${Stri
     }
     outputTable(rows);
   }));
+  dbCmd.command("* [args...]", { hidden: true }).option("-o, --output <format>", "Output format (json|table)", "json").allowUnknownOption().action(async (args, options) => {
+    const [name, operation, ...rest] = args;
+    const aliases = {
+      connection: "connection",
+      connect: "connection",
+      "enable-public": "enable-public",
+      expose: "expose",
+      "disable-public": "disable-public",
+      unexpose: "unexpose"
+    };
+    const command = operation ? aliases[operation] : void 0;
+    if (!name || !command) {
+      throw new Error('Unknown database command. Use "sealos-cli database --help" to list supported commands.');
+    }
+    await dbCmd.parseAsync([command, name, ...rest, "--output", options.output], { from: "user" });
+  });
   return dbCmd;
 }
 __name(createDatabaseCommand, "createDatabaseCommand");
@@ -6231,17 +6344,15 @@ async function resolveYaml(options, spinner2) {
 }
 __name(resolveYaml, "resolveYaml");
 function resolveTemplateDeployMode(template, options, stdinIsTTY = process.stdin.isTTY) {
-  const isRaw = !!(options.file || options.yaml || !stdinIsTTY);
-  if (template && isRaw) {
-    throw new Error("Cannot specify both a template name and --file/--yaml/stdin. Use one or the other.");
+  const hasExplicitRawInput = !!(options.file || options.yaml);
+  const isRaw = hasExplicitRawInput || !template && !stdinIsTTY;
+  if (template && hasExplicitRawInput) {
+    throw new Error("Cannot specify both a template name and --file/--yaml. Use one or the other.");
   }
   if (!template && !isRaw) {
     throw new Error("Provide a template name or use --file/--yaml/stdin to supply raw YAML.");
   }
   if (template) {
-    if (!options.name) {
-      throw new Error("--name is required when deploying from the template catalog.");
-    }
     if (options.dryRun) {
       throw new Error("--dry-run is only supported for raw template deploys (--file, --yaml, or stdin).");
     }
@@ -6252,7 +6363,7 @@ function resolveTemplateDeployMode(template, options, stdinIsTTY = process.stdin
 __name(resolveTemplateDeployMode, "resolveTemplateDeployMode");
 function buildCatalogTemplateDeployBody(template, options) {
   const body = {
-    name: options.name,
+    name: options.name ?? template,
     template
   };
   if (options.set.length > 0) {
@@ -6462,9 +6573,10 @@ function createTemplateCommand() {
     }
     ctx.spinner.succeed(`Instance "${instance}" deleted`);
   }));
-  tplCmd.command("deploy [template]").description("Deploy a template (from catalog or raw YAML)").option("--name <name>", "Instance name (required when deploying from catalog)").option("--file <path>", "Path to template YAML file").option("--yaml <yaml>", "Template YAML string").option("--set <KEY=VALUE...>", "Set template arguments", (val, prev) => [...prev, val], []).option("--dry-run", "Validate raw template YAML without creating resources").option("-o, --output <format>", "Output format (json|table)", "json").addHelpText("after", `
+  tplCmd.command("deploy [template]").description("Deploy a template (from catalog or raw YAML)").option("--name <name>", "Instance name (defaults to the catalog template name)").option("--file <path>", "Path to template YAML file").option("--yaml <yaml>", "Template YAML string").option("--set <KEY=VALUE...>", "Set template arguments", (val, prev) => [...prev, val], []).option("--dry-run", "Validate raw template YAML without creating resources").option("-o, --output <format>", "Output format (json|table)", "json").addHelpText("after", `
 Examples:
   Catalog:
+    sealos-cli template deploy rybbit
     sealos-cli template deploy perplexica --name my-app --set OPENAI_API_KEY=xxx
 
   Raw:
@@ -6474,8 +6586,12 @@ kind: Template
 ...'
     cat template.yaml | sealos-cli template deploy --dry-run
 `).action(async (template, options) => {
-    const mode = resolveTemplateDeployMode(template, options);
-    await deployTemplate(template, options, mode);
+    try {
+      const mode = resolveTemplateDeployMode(template, options);
+      await deployTemplate(template, options, mode);
+    } catch (error2) {
+      handleError(error2);
+    }
   });
   return tplCmd;
 }
@@ -6484,7 +6600,7 @@ __name(createTemplateCommand, "createTemplateCommand");
 // package.json
 var package_default = {
   name: "sealos-cli",
-  version: "1.1.2",
+  version: "1.1.3",
   description: "Official CLI tool for Sealos Cloud - Manage auth, workspaces, devboxes, databases, and templates",
   types: "dist/main.d.ts",
   type: "module",