@zenstackhq/cli 3.0.0-beta.22 → 3.0.0-beta.24

package/dist/index.js

@@ -1,5 +1,11 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -7,33 +13,11 @@ var __export = (target, all) => {
 
 // src/index.ts
 import { ZModelLanguageMetaData } from "@zenstackhq/language";
-import colors7 from "colors";
+import colors8 from "colors";
 import { Command, CommanderError, Option } from "commander";
 
-// src/actions/db.ts
-import fs2 from "fs";
-
-// src/utils/exec-utils.ts
-import { execSync as _exec } from "child_process";
-function execSync(cmd, options) {
-  const { env: env2, ...restOptions } = options ?? {};
-  const mergedEnv = env2 ? {
-    ...process.env,
-    ...env2
-  } : void 0;
-  _exec(cmd, {
-    encoding: "utf-8",
-    stdio: options?.stdio ?? "inherit",
-    env: mergedEnv,
-    ...restOptions
-  });
-}
-__name(execSync, "execSync");
-function execPackage(cmd, options) {
-  const packageManager = process?.versions?.["bun"] ? "bunx" : "npx";
-  execSync(`${packageManager} ${cmd}`, options);
-}
-__name(execPackage, "execPackage");
+// src/actions/check.ts
+import colors2 from "colors";
 
 // src/actions/action-utils.ts
 import { loadDocument } from "@zenstackhq/language";
@@ -63,14 +47,22 @@ function getSchemaFile(file) {
     if (!fs.existsSync(pkgJsonConfig.schema)) {
       throw new CliError(`Schema file not found: ${pkgJsonConfig.schema}`);
     }
-    return pkgJsonConfig.schema;
+    if (fs.statSync(pkgJsonConfig.schema).isDirectory()) {
+      const schemaPath = path.join(pkgJsonConfig.schema, "schema.zmodel");
+      if (!fs.existsSync(schemaPath)) {
+        throw new CliError(`Schema file not found: ${schemaPath}`);
+      }
+      return schemaPath;
+    } else {
+      return pkgJsonConfig.schema;
+    }
   }
-  if (fs.existsSync("./zenstack/schema.zmodel")) {
-    return "./zenstack/schema.zmodel";
-  } else if (fs.existsSync("./schema.zmodel")) {
+  if (fs.existsSync("./schema.zmodel")) {
     return "./schema.zmodel";
+  } else if (fs.existsSync("./zenstack/schema.zmodel")) {
+    return "./zenstack/schema.zmodel";
   } else {
-    throw new CliError('Schema file not found in default locations ("./zenstack/schema.zmodel" or "./schema.zmodel").');
+    throw new CliError('Schema file not found in default locations ("./schema.zmodel" or "./zenstack/schema.zmodel").');
   }
 }
 __name(getSchemaFile, "getSchemaFile");
@@ -153,28 +145,84 @@ function findUp(names, cwd = process.cwd(), multiple = false, result = []) {
 }
 __name(findUp, "findUp");
 
+// src/actions/check.ts
+async function run(options) {
+  const schemaFile = getSchemaFile(options.schema);
+  try {
+    await loadSchemaDocument(schemaFile);
+    console.log(colors2.green("\u2713 Schema validation completed successfully."));
+  } catch (error) {
+    console.error(colors2.red("\u2717 Schema validation failed."));
+    throw error;
+  }
+}
+__name(run, "run");
+
+// src/actions/db.ts
+import fs2 from "fs";
+
+// src/utils/exec-utils.ts
+import { execSync as _exec } from "child_process";
+import { fileURLToPath } from "url";
+function execSync(cmd, options) {
+  const { env: env2, ...restOptions } = options ?? {};
+  const mergedEnv = env2 ? {
+    ...process.env,
+    ...env2
+  } : void 0;
+  _exec(cmd, {
+    encoding: "utf-8",
+    stdio: options?.stdio ?? "inherit",
+    env: mergedEnv,
+    ...restOptions
+  });
+}
+__name(execSync, "execSync");
+function execPackage(cmd, options) {
+  const packageManager = process?.versions?.["bun"] ? "bunx" : "npx";
+  execSync(`${packageManager} ${cmd}`, options);
+}
+__name(execPackage, "execPackage");
+function execPrisma(args, options) {
+  let prismaPath;
+  try {
+    if (typeof import.meta.resolve === "function") {
+      prismaPath = fileURLToPath(import.meta.resolve("prisma/build/index.js"));
+    } else {
+      prismaPath = __require.resolve("prisma/build/index.js");
+    }
+  } catch {
+  }
+  if (!prismaPath) {
+    execPackage(`prisma ${args}`, options);
+    return;
+  }
+  execSync(`node ${prismaPath} ${args}`, options);
+}
+__name(execPrisma, "execPrisma");
+
 // src/actions/db.ts
-async function run(command, options) {
+async function run2(command, options) {
   switch (command) {
     case "push":
       await runPush(options);
       break;
   }
 }
-__name(run, "run");
+__name(run2, "run");
 async function runPush(options) {
   const schemaFile = getSchemaFile(options.schema);
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile);
   try {
     const cmd = [
-      "prisma db push",
+      "db push",
       ` --schema "${prismaSchemaFile}"`,
       options.acceptDataLoss ? " --accept-data-loss" : "",
       options.forceReset ? " --force-reset" : "",
       " --skip-generate"
     ].join("");
     try {
-      await execPackage(cmd);
+      execPrisma(cmd);
     } catch (err) {
       handleSubProcessError(err);
     }
@@ -186,11 +234,29 @@ async function runPush(options) {
 }
 __name(runPush, "runPush");
 
+// src/actions/format.ts
+import { formatDocument } from "@zenstackhq/language";
+import colors3 from "colors";
+import fs3 from "fs";
+async function run3(options) {
+  const schemaFile = getSchemaFile(options.schema);
+  let formattedContent;
+  try {
+    formattedContent = await formatDocument(fs3.readFileSync(schemaFile, "utf-8"));
+  } catch (error) {
+    console.error(colors3.red("\u2717 Schema formatting failed."));
+    throw error;
+  }
+  fs3.writeFileSync(schemaFile, formattedContent, "utf-8");
+  console.log(colors3.green("\u2713 Schema formatting completed successfully."));
+}
+__name(run3, "run");
+
 // src/actions/generate.ts
 import { invariant } from "@zenstackhq/common-helpers";
 import { isPlugin } from "@zenstackhq/language/ast";
 import { getLiteral, getLiteralArray } from "@zenstackhq/language/utils";
-import colors2 from "colors";
+import colors4 from "colors";
 import path4 from "path";
 import ora from "ora";
 
@@ -203,7 +269,7 @@ __export(plugins_exports, {
 
 // src/plugins/prisma.ts
 import { PrismaSchemaGenerator as PrismaSchemaGenerator2 } from "@zenstackhq/sdk";
-import fs3 from "fs";
+import fs4 from "fs";
 import path2 from "path";
 var plugin = {
   name: "Prisma Schema Generator",
@@ -212,21 +278,21 @@ var plugin = {
     let outFile = path2.join(defaultOutputPath, "schema.prisma");
     if (typeof pluginOptions["output"] === "string") {
       outFile = path2.resolve(defaultOutputPath, pluginOptions["output"]);
-      if (!fs3.existsSync(path2.dirname(outFile))) {
-        fs3.mkdirSync(path2.dirname(outFile), {
+      if (!fs4.existsSync(path2.dirname(outFile))) {
+        fs4.mkdirSync(path2.dirname(outFile), {
           recursive: true
         });
       }
     }
     const prismaSchema = await new PrismaSchemaGenerator2(model).generate();
-    fs3.writeFileSync(outFile, prismaSchema);
+    fs4.writeFileSync(outFile, prismaSchema);
   }
 };
 var prisma_default = plugin;
 
 // src/plugins/typescript.ts
 import { TsSchemaGenerator } from "@zenstackhq/sdk";
-import fs4 from "fs";
+import fs5 from "fs";
 import path3 from "path";
 var plugin2 = {
   name: "TypeScript Schema Generator",
@@ -235,32 +301,37 @@ var plugin2 = {
     let outDir = defaultOutputPath;
     if (typeof pluginOptions["output"] === "string") {
       outDir = path3.resolve(defaultOutputPath, pluginOptions["output"]);
-      if (!fs4.existsSync(outDir)) {
-        fs4.mkdirSync(outDir, {
+      if (!fs5.existsSync(outDir)) {
+        fs5.mkdirSync(outDir, {
           recursive: true
         });
       }
     }
     const lite = pluginOptions["lite"] === true;
     const liteOnly = pluginOptions["liteOnly"] === true;
+    const importWithFileExtension = pluginOptions["importWithFileExtension"];
+    if (importWithFileExtension && typeof importWithFileExtension !== "string") {
+      throw new Error('The "importWithFileExtension" option must be a string if specified.');
+    }
     await new TsSchemaGenerator().generate(model, {
       outDir,
       lite,
-      liteOnly
+      liteOnly,
+      importWithFileExtension
     });
   }
 };
 var typescript_default = plugin2;
 
 // src/actions/generate.ts
-async function run2(options) {
+async function run4(options) {
   const start = Date.now();
   const schemaFile = getSchemaFile(options.schema);
   const model = await loadSchemaDocument(schemaFile);
   const outputPath = getOutputPath(options, schemaFile);
   await runPlugins(schemaFile, model, outputPath, options);
   if (!options.silent) {
-    console.log(colors2.green(`Generation completed successfully in ${Date.now() - start}ms.
+    console.log(colors4.green(`Generation completed successfully in ${Date.now() - start}ms.
 `));
     console.log(`You can now create a ZenStack client with it.
 
@@ -276,7 +347,7 @@ const client = new ZenStackClient(schema, {
 Check documentation: https://zenstack.dev/docs/3.x`);
   }
 }
-__name(run2, "run");
+__name(run4, "run");
 function getOutputPath(options, schemaFile) {
   if (options.output) {
     return options.output;
@@ -311,9 +382,18 @@ async function runPlugins(schemaFile, model, outputPath, options) {
       }
     }
     if (cliPlugin) {
+      const pluginOptions = getPluginOptions(plugin3);
+      if (provider === "@core/typescript") {
+        if (pluginOptions["lite"] === void 0) {
+          pluginOptions["lite"] = options.lite;
+        }
+        if (pluginOptions["liteOnly"] === void 0) {
+          pluginOptions["liteOnly"] = options.liteOnly;
+        }
+      }
       processedPlugins.push({
         cliPlugin,
-        pluginOptions: getPluginOptions(plugin3)
+        pluginOptions
       });
     }
   }
@@ -380,9 +460,9 @@ function getPluginOptions(plugin3) {
 __name(getPluginOptions, "getPluginOptions");
 
 // src/actions/info.ts
-import colors3 from "colors";
+import colors5 from "colors";
 import path5 from "path";
-async function run3(projectPath) {
+async function run5(projectPath) {
   const packages = await getZenStackPackages(projectPath);
   if (!packages) {
     console.error("Unable to locate package.json. Are you in a valid project directory?");
@@ -394,13 +474,13 @@ async function run3(projectPath) {
     if (version2) {
       versions.add(version2);
     }
-    console.log(`    ${colors3.green(pkg.padEnd(20))}	${version2}`);
+    console.log(`    ${colors5.green(pkg.padEnd(20))}	${version2}`);
   }
   if (versions.size > 1) {
-    console.warn(colors3.yellow("WARNING: Multiple versions of Zenstack packages detected. This may cause issues."));
+    console.warn(colors5.yellow("WARNING: Multiple versions of Zenstack packages detected. This may cause issues."));
   }
 }
-__name(run3, "run");
+__name(run5, "run");
 async function getZenStackPackages(projectPath) {
   let pkgJson;
   const resolvedPath = path5.resolve(projectPath);
@@ -443,8 +523,8 @@ async function getZenStackPackages(projectPath) {
 __name(getZenStackPackages, "getZenStackPackages");
 
 // src/actions/init.ts
-import colors4 from "colors";
-import fs5 from "fs";
+import colors6 from "colors";
+import fs6 from "fs";
 import path6 from "path";
 import ora2 from "ora";
 import { detect, resolveCommand } from "package-manager-detector";
@@ -479,7 +559,7 @@ model Post {
 `;
 
 // src/actions/init.ts
-async function run4(projectPath) {
+async function run6(projectPath) {
   const packages = [
     {
       name: "@zenstackhq/cli@next",
@@ -497,7 +577,7 @@ async function run4(projectPath) {
       name: "npm"
     };
   }
-  console.log(colors4.gray(`Using package manager: ${pm.agent}`));
+  console.log(colors6.gray(`Using package manager: ${pm.agent}`));
   for (const pkg of packages) {
     const resolved = resolveCommand(pm.agent, "install", [
       pkg.name,
@@ -520,24 +600,24 @@ async function run4(projectPath) {
     }
   }
   const generationFolder = "zenstack";
-  if (!fs5.existsSync(path6.join(projectPath, generationFolder))) {
-    fs5.mkdirSync(path6.join(projectPath, generationFolder));
+  if (!fs6.existsSync(path6.join(projectPath, generationFolder))) {
+    fs6.mkdirSync(path6.join(projectPath, generationFolder));
   }
-  if (!fs5.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
-    fs5.writeFileSync(path6.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
+  if (!fs6.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
+    fs6.writeFileSync(path6.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
   } else {
-    console.log(colors4.yellow("Schema file already exists. Skipping generation of sample."));
+    console.log(colors6.yellow("Schema file already exists. Skipping generation of sample."));
   }
-  console.log(colors4.green("ZenStack project initialized successfully!"));
-  console.log(colors4.gray(`See "${generationFolder}/schema.zmodel" for your database schema.`));
-  console.log(colors4.gray("Run `zenstack generate` to compile the the schema into a TypeScript file."));
+  console.log(colors6.green("ZenStack project initialized successfully!"));
+  console.log(colors6.gray(`See "${generationFolder}/schema.zmodel" for your database schema.`));
+  console.log(colors6.gray("Run `zenstack generate` to compile the the schema into a TypeScript file."));
 }
-__name(run4, "run");
+__name(run6, "run");
 
 // src/actions/migrate.ts
-import fs6 from "fs";
+import fs7 from "fs";
 import path7 from "path";
-async function run5(command, options) {
+async function run7(command, options) {
   const schemaFile = getSchemaFile(options.schema);
   const prismaSchemaDir = options.migrations ? path7.dirname(options.migrations) : void 0;
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile, prismaSchemaDir);
@@ -560,73 +640,73 @@ async function run5(command, options) {
         break;
     }
   } finally {
-    if (fs6.existsSync(prismaSchemaFile)) {
-      fs6.unlinkSync(prismaSchemaFile);
+    if (fs7.existsSync(prismaSchemaFile)) {
+      fs7.unlinkSync(prismaSchemaFile);
     }
   }
 }
-__name(run5, "run");
-async function runDev(prismaSchemaFile, options) {
+__name(run7, "run");
+function runDev(prismaSchemaFile, options) {
   try {
     const cmd = [
-      "prisma migrate dev",
+      "migrate dev",
       ` --schema "${prismaSchemaFile}"`,
       " --skip-generate",
-      options.name ? ` --name ${options.name}` : "",
+      options.name ? ` --name "${options.name}"` : "",
       options.createOnly ? " --create-only" : ""
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
 }
 __name(runDev, "runDev");
-async function runReset(prismaSchemaFile, options) {
+function runReset(prismaSchemaFile, options) {
   try {
     const cmd = [
-      "prisma migrate reset",
+      "migrate reset",
       ` --schema "${prismaSchemaFile}"`,
       " --skip-generate",
       options.force ? " --force" : ""
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
 }
 __name(runReset, "runReset");
-async function runDeploy(prismaSchemaFile, _options) {
+function runDeploy(prismaSchemaFile, _options) {
   try {
     const cmd = [
-      "prisma migrate deploy",
+      "migrate deploy",
       ` --schema "${prismaSchemaFile}"`
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
 }
 __name(runDeploy, "runDeploy");
-async function runStatus(prismaSchemaFile, _options) {
+function runStatus(prismaSchemaFile, _options) {
   try {
-    await execPackage(`prisma migrate status --schema "${prismaSchemaFile}"`);
+    execPrisma(`migrate status --schema "${prismaSchemaFile}"`);
   } catch (err) {
     handleSubProcessError2(err);
   }
 }
 __name(runStatus, "runStatus");
-async function runResolve(prismaSchemaFile, options) {
+function runResolve(prismaSchemaFile, options) {
   if (!options.applied && !options.rolledBack) {
     throw new CliError("Either --applied or --rolled-back option must be provided");
   }
   try {
     const cmd = [
-      "prisma migrate resolve",
+      "migrate resolve",
       ` --schema "${prismaSchemaFile}"`,
-      options.applied ? ` --applied ${options.applied}` : "",
-      options.rolledBack ? ` --rolled-back ${options.rolledBack}` : ""
+      options.applied ? ` --applied "${options.applied}"` : "",
+      options.rolledBack ? ` --rolled-back "${options.rolledBack}"` : ""
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
@@ -641,24 +721,10 @@ function handleSubProcessError2(err) {
 }
 __name(handleSubProcessError2, "handleSubProcessError");
 
-// src/actions/check.ts
-import colors5 from "colors";
-async function run6(options) {
-  const schemaFile = getSchemaFile(options.schema);
-  try {
-    await loadSchemaDocument(schemaFile);
-    console.log(colors5.green("\u2713 Schema validation completed successfully."));
-  } catch (error) {
-    console.error(colors5.red("\u2717 Schema validation failed."));
-    throw error;
-  }
-}
-__name(run6, "run");
-
 // src/telemetry.ts
 import { init } from "mixpanel";
 import { randomUUID as randomUUID2 } from "crypto";
-import fs11 from "fs";
+import fs12 from "fs";
 import * as os2 from "os";
 
 // src/constants.ts
@@ -669,14 +735,14 @@ import { env } from "process";
 var isInCi = env["CI"] !== "0" && env["CI"] !== "false" && ("CI" in env || "CONTINUOUS_INTEGRATION" in env || Object.keys(env).some((key) => key.startsWith("CI_")));
 
 // src/utils/is-container.ts
-import fs8 from "fs";
+import fs9 from "fs";
 
 // src/utils/is-docker.ts
-import fs7 from "fs";
+import fs8 from "fs";
 var isDockerCached;
 function hasDockerEnv() {
   try {
-    fs7.statSync("/.dockerenv");
+    fs8.statSync("/.dockerenv");
     return true;
   } catch {
     return false;
@@ -685,7 +751,7 @@ function hasDockerEnv() {
 __name(hasDockerEnv, "hasDockerEnv");
 function hasDockerCGroup() {
   try {
-    return fs7.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+    return fs8.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
   } catch {
     return false;
   }
@@ -703,7 +769,7 @@ __name(isDocker, "isDocker");
 var cachedResult;
 var hasContainerEnv = /* @__PURE__ */ __name(() => {
   try {
-    fs8.statSync("/run/.containerenv");
+    fs9.statSync("/run/.containerenv");
     return true;
   } catch {
     return false;
@@ -720,7 +786,7 @@ __name(isInContainer, "isInContainer");
 // src/utils/is-wsl.ts
 import process2 from "process";
 import os from "os";
-import fs9 from "fs";
+import fs10 from "fs";
 var isWsl = /* @__PURE__ */ __name(() => {
   if (process2.platform !== "linux") {
     return false;
@@ -729,7 +795,7 @@ var isWsl = /* @__PURE__ */ __name(() => {
     return true;
   }
   try {
-    return fs9.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return fs10.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
@@ -793,17 +859,17 @@ function getMachineId() {
 __name(getMachineId, "getMachineId");
 
 // src/utils/version-utils.ts
-import colors6 from "colors";
-import fs10 from "fs";
+import colors7 from "colors";
+import fs11 from "fs";
 import path8 from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import semver from "semver";
 var CHECK_VERSION_TIMEOUT = 2e3;
 var VERSION_CHECK_TAG = "next";
 function getVersion() {
   try {
-    const _dirname = typeof __dirname !== "undefined" ? __dirname : path8.dirname(fileURLToPath(import.meta.url));
-    return JSON.parse(fs10.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
+    const _dirname = typeof __dirname !== "undefined" ? __dirname : path8.dirname(fileURLToPath2(import.meta.url));
+    return JSON.parse(fs11.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
   } catch {
     return void 0;
   }
@@ -818,7 +884,7 @@ async function checkNewVersion() {
     return;
   }
   if (latestVersion && currVersion && semver.gt(latestVersion, currVersion)) {
-    console.log(`A newer version ${colors6.cyan(latestVersion)} is available.`);
+    console.log(`A newer version ${colors7.cyan(latestVersion)} is available.`);
   }
 }
 __name(checkNewVersion, "checkNewVersion");
@@ -933,7 +999,7 @@ var Telemetry = class {
     try {
       const packageJsonPath = import.meta.resolve("prisma/package.json");
       const packageJsonUrl = new URL(packageJsonPath);
-      const packageJson = JSON.parse(fs11.readFileSync(packageJsonUrl, "utf8"));
+      const packageJson = JSON.parse(fs12.readFileSync(packageJsonUrl, "utf8"));
       return packageJson.version;
     } catch {
       return void 0;
@@ -944,45 +1010,49 @@ var telemetry = new Telemetry();
 
 // src/index.ts
 var generateAction = /* @__PURE__ */ __name(async (options) => {
-  await telemetry.trackCommand("generate", () => run2(options));
+  await telemetry.trackCommand("generate", () => run4(options));
 }, "generateAction");
 var migrateAction = /* @__PURE__ */ __name(async (subCommand, options) => {
-  await telemetry.trackCommand(`migrate ${subCommand}`, () => run5(subCommand, options));
+  await telemetry.trackCommand(`migrate ${subCommand}`, () => run7(subCommand, options));
 }, "migrateAction");
 var dbAction = /* @__PURE__ */ __name(async (subCommand, options) => {
-  await telemetry.trackCommand(`db ${subCommand}`, () => run(subCommand, options));
+  await telemetry.trackCommand(`db ${subCommand}`, () => run2(subCommand, options));
 }, "dbAction");
 var infoAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await telemetry.trackCommand("info", () => run3(projectPath));
+  await telemetry.trackCommand("info", () => run5(projectPath));
 }, "infoAction");
 var initAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await telemetry.trackCommand("init", () => run4(projectPath));
+  await telemetry.trackCommand("init", () => run6(projectPath));
 }, "initAction");
 var checkAction = /* @__PURE__ */ __name(async (options) => {
-  await telemetry.trackCommand("check", () => run6(options));
+  await telemetry.trackCommand("check", () => run(options));
 }, "checkAction");
+var formatAction = /* @__PURE__ */ __name(async (options) => {
+  await telemetry.trackCommand("format", () => run3(options));
+}, "formatAction");
 function createProgram() {
-  const program = new Command("zen");
-  program.version(getVersion(), "-v --version", "display CLI version");
+  const program = new Command("zen").alias("zenstack").helpOption("-h, --help", "Show this help message").version(getVersion(), "-v --version", "Show CLI version");
   const schemaExtensions = ZModelLanguageMetaData.fileExtensions.join(", ");
-  program.description(`${colors7.bold.blue("\u03B6")} ZenStack is the data layer for modern TypeScript apps.
+  program.description(`${colors8.bold.blue("\u03B6")} ZenStack is the data layer for modern TypeScript apps.
 
 Documentation: https://zenstack.dev/docs/3.x`).showHelpAfterError().showSuggestionAfterError();
   const schemaOption = new Option("--schema <file>", `schema file (with extension ${schemaExtensions}). Defaults to "zenstack/schema.zmodel" unless specified in package.json.`);
   const noVersionCheckOption = new Option("--no-version-check", "do not check for new version");
-  program.command("generate").description("Run code generation plugins.").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-o, --output <path>", "default output directory for code generation")).addOption(new Option("--lite", "also generate a lite version of schema without attributes").default(false)).addOption(new Option("--lite-only", "only generate lite version of schema without attributes").default(false)).addOption(new Option("--silent", "suppress all output except errors").default(false)).action(generateAction);
+  program.command("generate").description("Run code generation plugins").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-o, --output <path>", "default output directory for code generation")).addOption(new Option("--lite", "also generate a lite version of schema without attributes").default(false)).addOption(new Option("--lite-only", "only generate lite version of schema without attributes").default(false)).addOption(new Option("--silent", "suppress all output except errors").default(false)).action(generateAction);
   const migrateCommand = program.command("migrate").description("Run database schema migration related tasks.");
   const migrationsOption = new Option("--migrations <path>", 'path that contains the "migrations" directory');
-  migrateCommand.command("dev").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-n, --name <name>", "migration name")).addOption(new Option("--create-only", "only create migration, do not apply")).addOption(migrationsOption).description("Create a migration from changes in schema and apply it to the database.").action((options) => migrateAction("dev", options));
-  migrateCommand.command("reset").addOption(schemaOption).addOption(new Option("--force", "skip the confirmation prompt")).addOption(migrationsOption).addOption(noVersionCheckOption).description("Reset your database and apply all migrations, all data will be lost.").action((options) => migrateAction("reset", options));
-  migrateCommand.command("deploy").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Deploy your pending migrations to your production/staging database.").action((options) => migrateAction("deploy", options));
-  migrateCommand.command("status").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Check the status of your database migrations.").action((options) => migrateAction("status", options));
-  migrateCommand.command("resolve").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).addOption(new Option("--applied <migration>", "record a specific migration as applied")).addOption(new Option("--rolled-back <migration>", "record a specific migration as rolled back")).description("Resolve issues with database migrations in deployment databases.").action((options) => migrateAction("resolve", options));
-  const dbCommand = program.command("db").description("Manage your database schema during development.");
-  dbCommand.command("push").description("Push the state from your schema to your database.").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("--accept-data-loss", "ignore data loss warnings")).addOption(new Option("--force-reset", "force a reset of the database before push")).action((options) => dbAction("push", options));
-  program.command("info").description("Get information of installed ZenStack packages.").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(infoAction);
-  program.command("init").description("Initialize an existing project for ZenStack.").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(initAction);
-  program.command("check").description("Check a ZModel schema for syntax or semantic errors.").addOption(schemaOption).addOption(noVersionCheckOption).action(checkAction);
+  migrateCommand.command("dev").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("-n, --name <name>", "migration name")).addOption(new Option("--create-only", "only create migration, do not apply")).addOption(migrationsOption).description("Create a migration from changes in schema and apply it to the database").action((options) => migrateAction("dev", options));
+  migrateCommand.command("reset").addOption(schemaOption).addOption(new Option("--force", "skip the confirmation prompt")).addOption(migrationsOption).addOption(noVersionCheckOption).description("Reset your database and apply all migrations, all data will be lost").action((options) => migrateAction("reset", options));
+  migrateCommand.command("deploy").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Deploy your pending migrations to your production/staging database").action((options) => migrateAction("deploy", options));
+  migrateCommand.command("status").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).description("Check the status of your database migrations").action((options) => migrateAction("status", options));
+  migrateCommand.command("resolve").addOption(schemaOption).addOption(noVersionCheckOption).addOption(migrationsOption).addOption(new Option("--applied <migration>", "record a specific migration as applied")).addOption(new Option("--rolled-back <migration>", "record a specific migration as rolled back")).description("Resolve issues with database migrations in deployment databases").action((options) => migrateAction("resolve", options));
+  const dbCommand = program.command("db").description("Manage your database schema during development");
+  dbCommand.command("push").description("Push the state from your schema to your database").addOption(schemaOption).addOption(noVersionCheckOption).addOption(new Option("--accept-data-loss", "ignore data loss warnings")).addOption(new Option("--force-reset", "force a reset of the database before push")).action((options) => dbAction("push", options));
+  program.command("info").description("Get information of installed ZenStack packages").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(infoAction);
+  program.command("init").description("Initialize an existing project for ZenStack").argument("[path]", "project path", ".").addOption(noVersionCheckOption).action(initAction);
+  program.command("check").description("Check a ZModel schema for syntax or semantic errors").addOption(schemaOption).addOption(noVersionCheckOption).action(checkAction);
+  program.command("format").description("Format a ZModel schema file").addOption(schemaOption).addOption(noVersionCheckOption).action(formatAction);
+  program.addHelpCommand("help [command]", "Display help for a command");
   program.hook("preAction", async (_thisCommand, actionCommand) => {
     if (actionCommand.getOptionValue("versionCheck") !== false) {
       await checkNewVersion();
@@ -1003,10 +1073,10 @@ async function main() {
     if (e instanceof CommanderError) {
       exitCode = e.exitCode;
     } else if (e instanceof CliError) {
-      console.error(colors7.red(e.message));
+      console.error(colors8.red(e.message));
       exitCode = 1;
     } else {
-      console.error(colors7.red(`Unhandled error: ${e}`));
+      console.error(colors8.red(`Unhandled error: ${e}`));
       exitCode = 1;
     }
   }