@zenstackhq/cli 3.0.0-alpha.9 → 3.0.0-beta.10

package/dist/index.js

@@ -1,10 +1,14 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 
 // src/index.ts
 import { ZModelLanguageMetaData } from "@zenstackhq/language";
-import colors5 from "colors";
-import { Command, Option } from "commander";
+import colors7 from "colors";
+import { Command, CommanderError, Option } from "commander";
 
 // src/actions/db.ts
 import fs2 from "fs";
@@ -12,10 +16,10 @@ import fs2 from "fs";
 // src/utils/exec-utils.ts
 import { execSync as _exec } from "child_process";
 function execSync(cmd, options) {
-  const { env, ...restOptions } = options ?? {};
-  const mergedEnv = env ? {
+  const { env: env2, ...restOptions } = options ?? {};
+  const mergedEnv = env2 ? {
     ...process.env,
-    ...env
+    ...env2
   } : void 0;
   _exec(cmd, {
     encoding: "utf-8",
@@ -33,6 +37,7 @@ __name(execPackage, "execPackage");
 
 // src/actions/action-utils.ts
 import { loadDocument } from "@zenstackhq/language";
+import { isDataSource } from "@zenstackhq/language/ast";
 import { PrismaSchemaGenerator } from "@zenstackhq/sdk";
 import colors from "colors";
 import fs from "fs";
@@ -53,6 +58,13 @@ function getSchemaFile(file) {
     }
     return file;
   }
+  const pkgJsonConfig = getPkgJsonConfig(process.cwd());
+  if (pkgJsonConfig.schema) {
+    if (!fs.existsSync(pkgJsonConfig.schema)) {
+      throw new CliError(`Schema file not found: ${pkgJsonConfig.schema}`);
+    }
+    return pkgJsonConfig.schema;
+  }
   if (fs.existsSync("./zenstack/schema.zmodel")) {
     return "./zenstack/schema.zmodel";
   } else if (fs.existsSync("./schema.zmodel")) {
@@ -65,12 +77,14 @@ __name(getSchemaFile, "getSchemaFile");
 async function loadSchemaDocument(schemaFile) {
   const loadResult = await loadDocument(schemaFile);
   if (!loadResult.success) {
-    console.error(colors.red("Error loading schema:"));
     loadResult.errors.forEach((err) => {
       console.error(colors.red(err));
     });
-    throw new CliError("Failed to load schema");
+    throw new CliError("Schema contains errors. See above for details.");
   }
+  loadResult.warnings.forEach((warn) => {
+    console.warn(colors.yellow(warn));
+  });
   return loadResult.model;
 }
 __name(loadSchemaDocument, "loadSchemaDocument");
@@ -82,14 +96,62 @@ function handleSubProcessError(err) {
   }
 }
 __name(handleSubProcessError, "handleSubProcessError");
-async function generateTempPrismaSchema(zmodelPath) {
+async function generateTempPrismaSchema(zmodelPath, folder) {
   const model = await loadSchemaDocument(zmodelPath);
+  if (!model.declarations.some(isDataSource)) {
+    throw new CliError("Schema must define a datasource");
+  }
   const prismaSchema = await new PrismaSchemaGenerator(model).generate();
-  const prismaSchemaFile = path.resolve(path.dirname(zmodelPath), "~schema.prisma");
+  if (!folder) {
+    folder = path.dirname(zmodelPath);
+  }
+  const prismaSchemaFile = path.resolve(folder, "~schema.prisma");
   fs.writeFileSync(prismaSchemaFile, prismaSchema);
   return prismaSchemaFile;
 }
 __name(generateTempPrismaSchema, "generateTempPrismaSchema");
+function getPkgJsonConfig(startPath) {
+  const result = {
+    schema: void 0,
+    output: void 0
+  };
+  const pkgJsonFile = findUp([
+    "package.json"
+  ], startPath, false);
+  if (!pkgJsonFile) {
+    return result;
+  }
+  let pkgJson = void 0;
+  try {
+    pkgJson = JSON.parse(fs.readFileSync(pkgJsonFile, "utf8"));
+  } catch {
+    return result;
+  }
+  if (pkgJson.zenstack && typeof pkgJson.zenstack === "object") {
+    result.schema = pkgJson.zenstack.schema && path.resolve(path.dirname(pkgJsonFile), pkgJson.zenstack.schema);
+    result.output = pkgJson.zenstack.output && path.resolve(path.dirname(pkgJsonFile), pkgJson.zenstack.output);
+  }
+  return result;
+}
+__name(getPkgJsonConfig, "getPkgJsonConfig");
+function findUp(names, cwd = process.cwd(), multiple = false, result = []) {
+  if (!names.some((name) => !!name)) {
+    return void 0;
+  }
+  const target = names.find((name) => fs.existsSync(path.join(cwd, name)));
+  if (multiple === false && target) {
+    return path.join(cwd, target);
+  }
+  if (target) {
+    result.push(path.join(cwd, target));
+  }
+  const up = path.resolve(cwd, "..");
+  if (up === cwd) {
+    return multiple && result.length > 0 ? result : void 0;
+  }
+  return findUp(names, up, multiple, result);
+}
+__name(findUp, "findUp");
 
 // src/actions/db.ts
 async function run(command, options) {
@@ -104,11 +166,15 @@ async function runPush(options) {
   const schemaFile = getSchemaFile(options.schema);
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile);
   try {
-    const cmd = `prisma db push --schema "${prismaSchemaFile}"${options.acceptDataLoss ? " --accept-data-loss" : ""}${options.forceReset ? " --force-reset" : ""} --skip-generate`;
+    const cmd = [
+      "prisma db push",
+      ` --schema "${prismaSchemaFile}"`,
+      options.acceptDataLoss ? " --accept-data-loss" : "",
+      options.forceReset ? " --force-reset" : "",
+      " --skip-generate"
+    ].join("");
     try {
-      await execPackage(cmd, {
-        stdio: "inherit"
-      });
+      await execPackage(cmd);
     } catch (err) {
       handleSubProcessError(err);
     }
@@ -123,30 +189,73 @@ __name(runPush, "runPush");
 // src/actions/generate.ts
 import { invariant } from "@zenstackhq/common-helpers";
 import { isPlugin } from "@zenstackhq/language/ast";
-import { PrismaSchemaGenerator as PrismaSchemaGenerator2, TsSchemaGenerator } from "@zenstackhq/sdk";
+import { getLiteral, getLiteralArray } from "@zenstackhq/language/utils";
 import colors2 from "colors";
+import path4 from "path";
+import ora from "ora";
+
+// src/plugins/index.ts
+var plugins_exports = {};
+__export(plugins_exports, {
+  prisma: () => prisma_default,
+  typescript: () => typescript_default
+});
+
+// src/plugins/prisma.ts
+import { PrismaSchemaGenerator as PrismaSchemaGenerator2 } from "@zenstackhq/sdk";
 import fs3 from "fs";
 import path2 from "path";
-async function run2(options) {
-  const schemaFile = getSchemaFile(options.schema);
-  const model = await loadSchemaDocument(schemaFile);
-  const outputPath = options.output ?? path2.dirname(schemaFile);
-  const tsSchemaFile = path2.join(outputPath, "schema.ts");
-  await new TsSchemaGenerator().generate(schemaFile, [], tsSchemaFile);
-  await runPlugins(model, outputPath, tsSchemaFile);
-  if (options.savePrismaSchema) {
+var plugin = {
+  name: "Prisma Schema Generator",
+  statusText: "Generating Prisma schema",
+  async generate({ model, defaultOutputPath, pluginOptions }) {
+    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), {
+          recursive: true
+        });
+      }
+    }
     const prismaSchema = await new PrismaSchemaGenerator2(model).generate();
-    let prismaSchemaFile = path2.join(outputPath, "schema.prisma");
-    if (typeof options.savePrismaSchema === "string") {
-      prismaSchemaFile = path2.resolve(outputPath, options.savePrismaSchema);
-      fs3.mkdirSync(path2.dirname(prismaSchemaFile), {
-        recursive: true
-      });
+    fs3.writeFileSync(outFile, prismaSchema);
+  }
+};
+var prisma_default = plugin;
+
+// src/plugins/typescript.ts
+import { TsSchemaGenerator } from "@zenstackhq/sdk";
+import fs4 from "fs";
+import path3 from "path";
+var plugin2 = {
+  name: "TypeScript Schema Generator",
+  statusText: "Generating TypeScript schema",
+  async generate({ model, defaultOutputPath, pluginOptions }) {
+    let outDir = defaultOutputPath;
+    if (typeof pluginOptions["output"] === "string") {
+      outDir = path3.resolve(defaultOutputPath, pluginOptions["output"]);
+      if (!fs4.existsSync(outDir)) {
+        fs4.mkdirSync(outDir, {
+          recursive: true
+        });
+      }
     }
-    fs3.writeFileSync(prismaSchemaFile, prismaSchema);
+    await new TsSchemaGenerator().generate(model, outDir);
   }
+};
+var typescript_default = plugin2;
+
+// src/actions/generate.ts
+async function run2(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."));
+    console.log(colors2.green(`Generation completed successfully in ${Date.now() - start}ms.
+`));
     console.log(`You can now create a ZenStack client with it.
 
 \`\`\`ts
@@ -154,37 +263,113 @@ import { ZenStackClient } from '@zenstackhq/runtime';
 import { schema } from '${outputPath}/schema';
 
 const client = new ZenStackClient(schema, {
-    dialectConfig: { ... }
+    dialect: { ... }
 });
 \`\`\`
-`);
+
+Check documentation: https://zenstack.dev/docs/3.x`);
   }
 }
 __name(run2, "run");
-async function runPlugins(model, outputPath, tsSchemaFile) {
+function getOutputPath(options, schemaFile) {
+  if (options.output) {
+    return options.output;
+  }
+  const pkgJsonConfig = getPkgJsonConfig(process.cwd());
+  if (pkgJsonConfig.output) {
+    return pkgJsonConfig.output;
+  } else {
+    return path4.dirname(schemaFile);
+  }
+}
+__name(getOutputPath, "getOutputPath");
+async function runPlugins(schemaFile, model, outputPath, options) {
   const plugins = model.declarations.filter(isPlugin);
-  for (const plugin of plugins) {
-    const providerField = plugin.fields.find((f) => f.name === "provider");
-    invariant(providerField, `Plugin ${plugin.name} does not have a provider field`);
-    const provider = providerField.value.value;
-    let useProvider = provider;
-    if (useProvider.startsWith("@core/")) {
-      useProvider = `@zenstackhq/runtime/plugins/${useProvider.slice(6)}`;
+  const processedPlugins = [];
+  for (const plugin3 of plugins) {
+    const provider = getPluginProvider(plugin3);
+    let cliPlugin;
+    if (provider.startsWith("@core/")) {
+      cliPlugin = plugins_exports[provider.slice("@core/".length)];
+      if (!cliPlugin) {
+        throw new CliError(`Unknown core plugin: ${provider}`);
+      }
+    } else {
+      let moduleSpec = provider;
+      if (moduleSpec.startsWith(".")) {
+        moduleSpec = path4.resolve(path4.dirname(schemaFile), moduleSpec);
+      }
+      try {
+        cliPlugin = (await import(moduleSpec)).default;
+      } catch {
+      }
+    }
+    if (cliPlugin) {
+      processedPlugins.push({
+        cliPlugin,
+        pluginOptions: getPluginOptions(plugin3)
+      });
+    }
+  }
+  const defaultPlugins = [
+    typescript_default
+  ].reverse();
+  defaultPlugins.forEach((d) => {
+    if (!processedPlugins.some((p) => p.cliPlugin === d)) {
+      processedPlugins.push({
+        cliPlugin: d,
+        pluginOptions: {}
+      });
+    }
+  });
+  for (const { cliPlugin, pluginOptions } of processedPlugins) {
+    invariant(typeof cliPlugin.generate === "function", `Plugin ${cliPlugin.name} does not have a generate function`);
+    let spinner;
+    if (!options.silent) {
+      spinner = ora(cliPlugin.statusText ?? `Running plugin ${cliPlugin.name}`).start();
+    }
+    try {
+      await cliPlugin.generate({
+        schemaFile,
+        model,
+        defaultOutputPath: outputPath,
+        pluginOptions
+      });
+      spinner?.succeed();
+    } catch (err) {
+      spinner?.fail();
+      console.error(err);
     }
-    const generator = (await import(useProvider)).default;
-    console.log("Running generator:", provider);
-    await generator({
-      model,
-      outputPath,
-      tsSchemaFile
-    });
   }
 }
 __name(runPlugins, "runPlugins");
+function getPluginProvider(plugin3) {
+  const providerField = plugin3.fields.find((f) => f.name === "provider");
+  invariant(providerField, `Plugin ${plugin3.name} does not have a provider field`);
+  const provider = providerField.value.value;
+  return provider;
+}
+__name(getPluginProvider, "getPluginProvider");
+function getPluginOptions(plugin3) {
+  const result = {};
+  for (const field of plugin3.fields) {
+    if (field.name === "provider") {
+      continue;
+    }
+    const value = getLiteral(field.value) ?? getLiteralArray(field.value);
+    if (value === void 0) {
+      console.warn(`Plugin "${plugin3.name}" option "${field.name}" has unsupported value, skipping`);
+      continue;
+    }
+    result[field.name] = value;
+  }
+  return result;
+}
+__name(getPluginOptions, "getPluginOptions");
 
 // src/actions/info.ts
 import colors3 from "colors";
-import path3 from "path";
+import path5 from "path";
 async function run3(projectPath) {
   const packages = await getZenStackPackages(projectPath);
   if (!packages) {
@@ -193,11 +378,11 @@ async function run3(projectPath) {
   }
   console.log("Installed ZenStack Packages:");
   const versions = /* @__PURE__ */ new Set();
-  for (const { pkg, version } of packages) {
-    if (version) {
-      versions.add(version);
+  for (const { pkg, version: version2 } of packages) {
+    if (version2) {
+      versions.add(version2);
     }
-    console.log(`    ${colors3.green(pkg.padEnd(20))}	${version}`);
+    console.log(`    ${colors3.green(pkg.padEnd(20))}	${version2}`);
   }
   if (versions.size > 1) {
     console.warn(colors3.yellow("WARNING: Multiple versions of Zenstack packages detected. This may cause issues."));
@@ -206,9 +391,9 @@ async function run3(projectPath) {
 __name(run3, "run");
 async function getZenStackPackages(projectPath) {
   let pkgJson;
-  const resolvedPath = path3.resolve(projectPath);
+  const resolvedPath = path5.resolve(projectPath);
   try {
-    pkgJson = (await import(path3.join(resolvedPath, "package.json"), {
+    pkgJson = (await import(path5.join(resolvedPath, "package.json"), {
       with: {
         type: "json"
       }
@@ -227,6 +412,9 @@ async function getZenStackPackages(projectPath) {
           type: "json"
         }
       })).default;
+      if (depPkgJson.private) {
+        return void 0;
+      }
       return {
         pkg,
         version: depPkgJson.version
@@ -238,15 +426,15 @@ async function getZenStackPackages(projectPath) {
       };
     }
   }));
-  return result;
+  return result.filter((p) => !!p);
 }
 __name(getZenStackPackages, "getZenStackPackages");
 
 // src/actions/init.ts
 import colors4 from "colors";
-import fs4 from "fs";
-import path4 from "path";
-import ora from "ora";
+import fs5 from "fs";
+import path6 from "path";
+import ora2 from "ora";
 import { detect, resolveCommand } from "package-manager-detector";
 
 // src/actions/templates.ts
@@ -308,7 +496,7 @@ async function run4(projectPath) {
     if (!resolved) {
       throw new CliError(`Unable to determine how to install package "${pkg.name}". Please install it manually.`);
     }
-    const spinner = ora(`Installing "${pkg.name}"`).start();
+    const spinner = ora2(`Installing "${pkg.name}"`).start();
     try {
       execSync(`${resolved.command} ${resolved.args.join(" ")}`, {
         cwd: projectPath
@@ -320,11 +508,11 @@ async function run4(projectPath) {
     }
   }
   const generationFolder = "zenstack";
-  if (!fs4.existsSync(path4.join(projectPath, generationFolder))) {
-    fs4.mkdirSync(path4.join(projectPath, generationFolder));
+  if (!fs5.existsSync(path6.join(projectPath, generationFolder))) {
+    fs5.mkdirSync(path6.join(projectPath, generationFolder));
   }
-  if (!fs4.existsSync(path4.join(projectPath, generationFolder, "schema.zmodel"))) {
-    fs4.writeFileSync(path4.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
+  if (!fs5.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
+    fs5.writeFileSync(path6.join(projectPath, generationFolder, "schema.zmodel"), STARTER_ZMODEL);
   } else {
     console.log(colors4.yellow("Schema file already exists. Skipping generation of sample."));
   }
@@ -335,10 +523,12 @@ async function run4(projectPath) {
 __name(run4, "run");
 
 // src/actions/migrate.ts
-import fs5 from "fs";
+import fs6 from "fs";
+import path7 from "path";
 async function run5(command, options) {
   const schemaFile = getSchemaFile(options.schema);
-  const prismaSchemaFile = await generateTempPrismaSchema(schemaFile);
+  const prismaSchemaDir = options.migrations ? path7.dirname(options.migrations) : void 0;
+  const prismaSchemaFile = await generateTempPrismaSchema(schemaFile, prismaSchemaDir);
   try {
     switch (command) {
       case "dev":
@@ -353,19 +543,27 @@ async function run5(command, options) {
       case "status":
         await runStatus(prismaSchemaFile, options);
         break;
+      case "resolve":
+        await runResolve(prismaSchemaFile, options);
+        break;
     }
   } finally {
-    if (fs5.existsSync(prismaSchemaFile)) {
-      fs5.unlinkSync(prismaSchemaFile);
+    if (fs6.existsSync(prismaSchemaFile)) {
+      fs6.unlinkSync(prismaSchemaFile);
     }
   }
 }
 __name(run5, "run");
 async function runDev(prismaSchemaFile, options) {
   try {
-    await execPackage(`prisma migrate dev --schema "${prismaSchemaFile}" --skip-generate${options.name ? ` --name ${options.name}` : ""}${options.createOnly ? " --create-only" : ""}`, {
-      stdio: "inherit"
-    });
+    const cmd = [
+      "prisma migrate dev",
+      ` --schema "${prismaSchemaFile}"`,
+      " --skip-generate",
+      options.name ? ` --name ${options.name}` : "",
+      options.createOnly ? " --create-only" : ""
+    ].join("");
+    await execPackage(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
@@ -373,9 +571,13 @@ async function runDev(prismaSchemaFile, options) {
 __name(runDev, "runDev");
 async function runReset(prismaSchemaFile, options) {
   try {
-    await execPackage(`prisma migrate reset --schema "${prismaSchemaFile}"${options.force ? " --force" : ""}`, {
-      stdio: "inherit"
-    });
+    const cmd = [
+      "prisma migrate reset",
+      ` --schema "${prismaSchemaFile}"`,
+      " --skip-generate",
+      options.force ? " --force" : ""
+    ].join("");
+    await execPackage(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
@@ -383,9 +585,11 @@ async function runReset(prismaSchemaFile, options) {
 __name(runReset, "runReset");
 async function runDeploy(prismaSchemaFile, _options) {
   try {
-    await execPackage(`prisma migrate deploy --schema "${prismaSchemaFile}"`, {
-      stdio: "inherit"
-    });
+    const cmd = [
+      "prisma migrate deploy",
+      ` --schema "${prismaSchemaFile}"`
+    ].join("");
+    await execPackage(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
@@ -393,14 +597,29 @@ async function runDeploy(prismaSchemaFile, _options) {
 __name(runDeploy, "runDeploy");
 async function runStatus(prismaSchemaFile, _options) {
   try {
-    await execPackage(`prisma migrate status --schema "${prismaSchemaFile}"`, {
-      stdio: "inherit"
-    });
+    await execPackage(`prisma migrate status --schema "${prismaSchemaFile}"`);
   } catch (err) {
     handleSubProcessError2(err);
   }
 }
 __name(runStatus, "runStatus");
+async 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",
+      ` --schema "${prismaSchemaFile}"`,
+      options.applied ? ` --applied ${options.applied}` : "",
+      options.rolledBack ? ` --rolled-back ${options.rolledBack}` : ""
+    ].join("");
+    await execPackage(cmd);
+  } catch (err) {
+    handleSubProcessError2(err);
+  }
+}
+__name(runResolve, "runResolve");
 function handleSubProcessError2(err) {
   if (err instanceof Error && "status" in err && typeof err.status === "number") {
     process.exit(err.status);
@@ -410,60 +629,383 @@ 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 * as os2 from "os";
+
+// src/constants.ts
+var TELEMETRY_TRACKING_TOKEN = "74944eb779d7d3b4ce185be843fde9fc";
+
+// src/utils/is-ci.ts
+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";
+
+// src/utils/is-docker.ts
+import fs7 from "fs";
+var isDockerCached;
+function hasDockerEnv() {
+  try {
+    fs7.statSync("/.dockerenv");
+    return true;
+  } catch {
+    return false;
+  }
+}
+__name(hasDockerEnv, "hasDockerEnv");
+function hasDockerCGroup() {
+  try {
+    return fs7.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+  } catch {
+    return false;
+  }
+}
+__name(hasDockerCGroup, "hasDockerCGroup");
+function isDocker() {
+  if (isDockerCached === void 0) {
+    isDockerCached = hasDockerEnv() || hasDockerCGroup();
+  }
+  return isDockerCached;
+}
+__name(isDocker, "isDocker");
+
+// src/utils/is-container.ts
+var cachedResult;
+var hasContainerEnv = /* @__PURE__ */ __name(() => {
+  try {
+    fs8.statSync("/run/.containerenv");
+    return true;
+  } catch {
+    return false;
+  }
+}, "hasContainerEnv");
+function isInContainer() {
+  if (cachedResult === void 0) {
+    cachedResult = hasContainerEnv() || isDocker();
+  }
+  return cachedResult;
+}
+__name(isInContainer, "isInContainer");
+
+// src/utils/is-wsl.ts
+import process2 from "process";
+import os from "os";
+import fs9 from "fs";
+var isWsl = /* @__PURE__ */ __name(() => {
+  if (process2.platform !== "linux") {
+    return false;
+  }
+  if (os.release().toLowerCase().includes("microsoft")) {
+    return true;
+  }
+  try {
+    return fs9.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+  } catch {
+    return false;
+  }
+}, "isWsl");
+
+// src/utils/machine-id-utils.ts
+import { execSync as execSync2 } from "child_process";
+import { createHash, randomUUID } from "crypto";
+var { platform } = process;
+var win32RegBinPath = {
+  native: "%windir%\\System32",
+  mixed: "%windir%\\sysnative\\cmd.exe /c %windir%\\System32"
+};
+var guid = {
+  darwin: "ioreg -rd1 -c IOPlatformExpertDevice",
+  win32: `${win32RegBinPath[isWindowsProcessMixedOrNativeArchitecture()]}\\REG.exe QUERY HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography /v MachineGuid`,
+  linux: "( cat /var/lib/dbus/machine-id /etc/machine-id 2> /dev/null || hostname 2> /dev/null) | head -n 1 || :",
+  freebsd: "kenv -q smbios.system.uuid || sysctl -n kern.hostuuid"
+};
+function isWindowsProcessMixedOrNativeArchitecture() {
+  if (process.arch === "ia32" && process.env.hasOwnProperty("PROCESSOR_ARCHITEW6432")) {
+    return "mixed";
+  }
+  return "native";
+}
+__name(isWindowsProcessMixedOrNativeArchitecture, "isWindowsProcessMixedOrNativeArchitecture");
+function hash(guid2) {
+  return createHash("sha256").update(guid2).digest("hex");
+}
+__name(hash, "hash");
+function expose(result) {
+  switch (platform) {
+    case "darwin":
+      return result.split("IOPlatformUUID")[1]?.split("\n")[0]?.replace(/=|\s+|"/gi, "").toLowerCase();
+    case "win32":
+      return result.toString().split("REG_SZ")[1]?.replace(/\r+|\n+|\s+/gi, "").toLowerCase();
+    case "linux":
+      return result.toString().replace(/\r+|\n+|\s+/gi, "").toLowerCase();
+    case "freebsd":
+      return result.toString().replace(/\r+|\n+|\s+/gi, "").toLowerCase();
+    default:
+      throw new Error(`Unsupported platform: ${process.platform}`);
+  }
+}
+__name(expose, "expose");
+function getMachineId() {
+  if (!(platform in guid)) {
+    return randomUUID();
+  }
+  try {
+    const value = execSync2(guid[platform]);
+    const id = expose(value.toString());
+    if (!id) {
+      return randomUUID();
+    }
+    return hash(id);
+  } catch {
+    return randomUUID();
+  }
+}
+__name(getMachineId, "getMachineId");
+
 // src/utils/version-utils.ts
-import fs6 from "fs";
-import path5 from "path";
+import colors6 from "colors";
+import fs10 from "fs";
+import path8 from "path";
 import { fileURLToPath } 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 : path5.dirname(fileURLToPath(import.meta.url));
-    return JSON.parse(fs6.readFileSync(path5.join(_dirname, "../package.json"), "utf8")).version;
+    const _dirname = typeof __dirname !== "undefined" ? __dirname : path8.dirname(fileURLToPath(import.meta.url));
+    return JSON.parse(fs10.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
   } catch {
     return void 0;
   }
 }
 __name(getVersion, "getVersion");
+async function checkNewVersion() {
+  const currVersion = getVersion();
+  let latestVersion;
+  try {
+    latestVersion = await getLatestVersion();
+  } catch {
+    return;
+  }
+  if (latestVersion && currVersion && semver.gt(latestVersion, currVersion)) {
+    console.log(`A newer version ${colors6.cyan(latestVersion)} is available.`);
+  }
+}
+__name(checkNewVersion, "checkNewVersion");
+async function getLatestVersion() {
+  const fetchResult = await fetch(`https://registry.npmjs.org/@zenstackhq/cli/${VERSION_CHECK_TAG}`, {
+    headers: {
+      accept: "application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*"
+    },
+    signal: AbortSignal.timeout(CHECK_VERSION_TIMEOUT)
+  });
+  if (fetchResult.ok) {
+    const data = await fetchResult.json();
+    const latestVersion = data?.version;
+    if (typeof latestVersion === "string" && semver.valid(latestVersion)) {
+      return latestVersion;
+    }
+  }
+  throw new Error("invalid npm registry response");
+}
+__name(getLatestVersion, "getLatestVersion");
+
+// src/telemetry.ts
+var Telemetry = class {
+  static {
+    __name(this, "Telemetry");
+  }
+  mixpanel;
+  hostId = getMachineId();
+  sessionid = randomUUID2();
+  _os_type = os2.type();
+  _os_release = os2.release();
+  _os_arch = os2.arch();
+  _os_version = os2.version();
+  _os_platform = os2.platform();
+  version = getVersion();
+  prismaVersion = this.getPrismaVersion();
+  isDocker = isDocker();
+  isWsl = isWsl();
+  isContainer = isInContainer();
+  isCi = isInCi;
+  constructor() {
+    if (process.env["DO_NOT_TRACK"] !== "1" && TELEMETRY_TRACKING_TOKEN) {
+      this.mixpanel = init(TELEMETRY_TRACKING_TOKEN, {
+        geolocate: true
+      });
+    }
+  }
+  get isTracking() {
+    return !!this.mixpanel;
+  }
+  track(event, properties = {}) {
+    if (this.mixpanel) {
+      const payload = {
+        distinct_id: this.hostId,
+        session: this.sessionid,
+        time: /* @__PURE__ */ new Date(),
+        $os: this._os_type,
+        osType: this._os_type,
+        osRelease: this._os_release,
+        osPlatform: this._os_platform,
+        osArch: this._os_arch,
+        osVersion: this._os_version,
+        nodeVersion: process.version,
+        version: this.version,
+        prismaVersion: this.prismaVersion,
+        isDocker: this.isDocker,
+        isWsl: this.isWsl,
+        isContainer: this.isContainer,
+        isCi: this.isCi,
+        ...properties
+      };
+      this.mixpanel.track(event, payload);
+    }
+  }
+  trackError(err) {
+    this.track("cli:error", {
+      message: err.message,
+      stack: err.stack
+    });
+  }
+  async trackSpan(startEvent, completeEvent, errorEvent, properties, action) {
+    this.track(startEvent, properties);
+    const start = Date.now();
+    let success = true;
+    try {
+      return await action();
+    } catch (err) {
+      this.track(errorEvent, {
+        message: err.message,
+        stack: err.stack,
+        ...properties
+      });
+      success = false;
+      throw err;
+    } finally {
+      this.track(completeEvent, {
+        duration: Date.now() - start,
+        success,
+        ...properties
+      });
+    }
+  }
+  async trackCommand(command, action) {
+    await this.trackSpan("cli:command:start", "cli:command:complete", "cli:command:error", {
+      command
+    }, action);
+  }
+  async trackCli(action) {
+    await this.trackSpan("cli:start", "cli:complete", "cli:error", {}, action);
+  }
+  getPrismaVersion() {
+    try {
+      const packageJsonPath = import.meta.resolve("prisma/package.json");
+      const packageJsonUrl = new URL(packageJsonPath);
+      const packageJson = JSON.parse(fs11.readFileSync(packageJsonUrl, "utf8"));
+      return packageJson.version;
+    } catch {
+      return void 0;
+    }
+  }
+};
+var telemetry = new Telemetry();
 
 // src/index.ts
 var generateAction = /* @__PURE__ */ __name(async (options) => {
-  await run2(options);
+  await telemetry.trackCommand("generate", () => run2(options));
 }, "generateAction");
-var migrateAction = /* @__PURE__ */ __name(async (command, options) => {
-  await run5(command, options);
+var migrateAction = /* @__PURE__ */ __name(async (subCommand, options) => {
+  await telemetry.trackCommand(`migrate ${subCommand}`, () => run5(subCommand, options));
 }, "migrateAction");
-var dbAction = /* @__PURE__ */ __name(async (command, options) => {
-  await run(command, options);
+var dbAction = /* @__PURE__ */ __name(async (subCommand, options) => {
+  await telemetry.trackCommand(`db ${subCommand}`, () => run(subCommand, options));
 }, "dbAction");
 var infoAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await run3(projectPath);
+  await telemetry.trackCommand("info", () => run3(projectPath));
 }, "infoAction");
 var initAction = /* @__PURE__ */ __name(async (projectPath) => {
-  await run4(projectPath);
+  await telemetry.trackCommand("init", () => run4(projectPath));
 }, "initAction");
+var checkAction = /* @__PURE__ */ __name(async (options) => {
+  await telemetry.trackCommand("check", () => run6(options));
+}, "checkAction");
 function createProgram() {
-  const program2 = new Command("zenstack");
-  program2.version(getVersion(), "-v --version", "display CLI version");
+  const program = new Command("zen");
+  program.version(getVersion(), "-v --version", "display CLI version");
   const schemaExtensions = ZModelLanguageMetaData.fileExtensions.join(", ");
-  program2.description(`${colors5.bold.blue("\u03B6")} ZenStack is a Prisma power pack for building full-stack apps.
-
-Documentation: https://zenstack.dev.`).showHelpAfterError().showSuggestionAfterError();
-  const schemaOption = new Option("--schema <file>", `schema file (with extension ${schemaExtensions}). Defaults to "schema.zmodel" unless specified in package.json.`);
-  program2.command("generate").description("Run code generation.").addOption(schemaOption).addOption(new Option("--silent", "do not print any output")).addOption(new Option("--save-prisma-schema [path]", "save a Prisma schema file, by default into the output directory")).addOption(new Option("-o, --output <path>", "default output directory for core plugins")).action(generateAction);
-  const migrateCommand = program2.command("migrate").description("Update the database schema with migrations.");
-  migrateCommand.command("dev").addOption(schemaOption).addOption(new Option("-n, --name <name>", "migration name")).addOption(new Option("--create-only", "only create migration, do not apply")).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")).description("Reset your database and apply all migrations, all data will be lost.").action((options) => migrateAction("reset", options));
-  migrateCommand.command("deploy").addOption(schemaOption).description("Deploy your pending migrations to your production/staging database.").action((options) => migrateAction("deploy", options));
-  migrateCommand.command("status").addOption(schemaOption).description("check the status of your database migrations.").action((options) => migrateAction("status", options));
-  const dbCommand = program2.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(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));
-  program2.command("info").description("Get information of installed ZenStack and related packages.").argument("[path]", "project path", ".").action(infoAction);
-  program2.command("init").description("Initialize an existing project for ZenStack.").argument("[path]", "project path", ".").action(initAction);
-  return program2;
+  program.description(`${colors7.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("--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);
+  program.hook("preAction", async (_thisCommand, actionCommand) => {
+    if (actionCommand.getOptionValue("versionCheck") !== false) {
+      await checkNewVersion();
+    }
+  });
+  return program;
 }
 __name(createProgram, "createProgram");
-var program = createProgram();
-program.parse(process.argv);
-export {
-  createProgram
-};
+async function main() {
+  let exitCode = 0;
+  const program = createProgram();
+  program.exitOverride();
+  try {
+    await telemetry.trackCli(async () => {
+      await program.parseAsync();
+    });
+  } catch (e) {
+    if (e instanceof CommanderError) {
+      exitCode = e.exitCode;
+    } else if (e instanceof CliError) {
+      console.error(colors7.red(e.message));
+      exitCode = 1;
+    } else {
+      console.error(colors7.red(`Unhandled error: ${e}`));
+      exitCode = 1;
+    }
+  }
+  if (telemetry.isTracking) {
+    setTimeout(() => {
+      process.exit(exitCode);
+    }, 200);
+  } else {
+    process.exit(exitCode);
+  }
+}
+__name(main, "main");
+main();
 //# sourceMappingURL=index.js.map