@zenstackhq/cli 3.0.0-beta.9 → 3.1.0

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 colors9 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");
@@ -113,7 +105,8 @@ __name(generateTempPrismaSchema, "generateTempPrismaSchema");
 function getPkgJsonConfig(startPath) {
   const result = {
     schema: void 0,
-    output: void 0
+    output: void 0,
+    seed: void 0
   };
   const pkgJsonFile = findUp([
     "package.json"
@@ -128,8 +121,9 @@ function getPkgJsonConfig(startPath) {
     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);
+    result.schema = pkgJson.zenstack.schema && typeof pkgJson.zenstack.schema === "string" ? path.resolve(path.dirname(pkgJsonFile), pkgJson.zenstack.schema) : void 0;
+    result.output = pkgJson.zenstack.output && typeof pkgJson.zenstack.output === "string" ? path.resolve(path.dirname(pkgJsonFile), pkgJson.zenstack.output) : void 0;
+    result.seed = typeof pkgJson.zenstack.seed === "string" && pkgJson.zenstack.seed ? pkgJson.zenstack.seed : void 0;
   }
   return result;
 }
@@ -152,29 +146,101 @@ function findUp(names, cwd = process.cwd(), multiple = false, result = []) {
   return findUp(names, up, multiple, result);
 }
 __name(findUp, "findUp");
+async function requireDataSourceUrl(schemaFile) {
+  const zmodel = await loadSchemaDocument(schemaFile);
+  const dataSource = zmodel.declarations.find(isDataSource);
+  if (!dataSource?.fields.some((f) => f.name === "url")) {
+    throw new CliError(`The schema's "datasource" must have a "url" field to use this command.`);
+  }
+}
+__name(requireDataSourceUrl, "requireDataSourceUrl");
+
+// 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 {
+  }
+  const _options = {
+    ...options,
+    env: {
+      ...options?.env,
+      PRISMA_HIDE_UPDATE_MESSAGE: "1"
+    }
+  };
+  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);
+  await requireDataSourceUrl(schemaFile);
   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,12 +252,33 @@ 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 { createJiti } from "jiti";
+import fs6 from "fs";
 import path4 from "path";
+import { pathToFileURL } from "url";
 import ora from "ora";
 
 // src/plugins/index.ts
@@ -203,7 +290,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 +299,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,42 +322,53 @@ 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
         });
       }
     }
-    await new TsSchemaGenerator().generate(model, outDir);
+    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,
+      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.
 
 \`\`\`ts
-import { ZenStackClient } from '@zenstackhq/runtime';
-import { schema } from '${outputPath}/schema';
+import { ZenStackClient } from '@zenstackhq/orm';
+import { schema } from '${path4.relative(".", outputPath)}/schema';
 
 const client = new ZenStackClient(schema, {
     dialect: { ... }
 });
 \`\`\`
 
-Check documentation: https://zenstack.dev/docs/3.x`);
+Check documentation: https://zenstack.dev/docs/`);
   }
 }
-__name(run2, "run");
+__name(run4, "run");
 function getOutputPath(options, schemaFile) {
   if (options.output) {
     return options.output;
@@ -295,29 +393,38 @@ async function runPlugins(schemaFile, model, outputPath, options) {
         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 (error) {
-        throw new CliError(`Failed to load plugin ${provider}: ${error}`);
+      cliPlugin = await loadPluginModule(provider, path4.dirname(schemaFile));
+    }
+    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
+      });
     }
-    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: {}
+    {
+      plugin: typescript_default,
+      options: {
+        lite: options.lite,
+        liteOnly: options.liteOnly
+      }
+    }
+  ];
+  defaultPlugins.forEach(({ plugin: plugin3, options: options2 }) => {
+    if (!processedPlugins.some((p) => p.cliPlugin === plugin3)) {
+      processedPlugins.unshift({
+        cliPlugin: plugin3,
+        pluginOptions: options2
       });
     }
   });
@@ -365,11 +472,70 @@ function getPluginOptions(plugin3) {
   return result;
 }
 __name(getPluginOptions, "getPluginOptions");
+async function loadPluginModule(provider, basePath) {
+  let moduleSpec = provider;
+  if (moduleSpec.startsWith(".")) {
+    moduleSpec = path4.resolve(basePath, moduleSpec);
+  }
+  const importAsEsm = /* @__PURE__ */ __name(async (spec) => {
+    try {
+      const result = (await import(spec)).default;
+      return result;
+    } catch (err) {
+      throw new CliError(`Failed to load plugin module from ${spec}: ${err.message}`);
+    }
+  }, "importAsEsm");
+  const jiti = createJiti(pathToFileURL(basePath).toString());
+  const importAsTs = /* @__PURE__ */ __name(async (spec) => {
+    try {
+      const result = await jiti.import(spec, {
+        default: true
+      });
+      return result;
+    } catch (err) {
+      throw new CliError(`Failed to load plugin module from ${spec}: ${err.message}`);
+    }
+  }, "importAsTs");
+  const esmSuffixes = [
+    ".js",
+    ".mjs"
+  ];
+  const tsSuffixes = [
+    ".ts",
+    ".mts"
+  ];
+  if (fs6.existsSync(moduleSpec) && fs6.statSync(moduleSpec).isFile()) {
+    if (esmSuffixes.some((suffix) => moduleSpec.endsWith(suffix))) {
+      return await importAsEsm(pathToFileURL(moduleSpec).toString());
+    }
+    if (tsSuffixes.some((suffix) => moduleSpec.endsWith(suffix))) {
+      return await importAsTs(moduleSpec);
+    }
+  }
+  for (const suffix of esmSuffixes) {
+    const indexPath = path4.join(moduleSpec, `index${suffix}`);
+    if (fs6.existsSync(indexPath)) {
+      return await importAsEsm(pathToFileURL(indexPath).toString());
+    }
+  }
+  for (const suffix of tsSuffixes) {
+    const indexPath = path4.join(moduleSpec, `index${suffix}`);
+    if (fs6.existsSync(indexPath)) {
+      return await importAsTs(indexPath);
+    }
+  }
+  try {
+    return (await import(moduleSpec)).default;
+  } catch {
+    return void 0;
+  }
+}
+__name(loadPluginModule, "loadPluginModule");
 
 // 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?");
@@ -381,13 +547,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);
@@ -430,8 +596,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 fs7 from "fs";
 import path6 from "path";
 import ora2 from "ora";
 import { detect, resolveCommand } from "package-manager-detector";
@@ -460,20 +626,20 @@ model Post {
     title     String   @length(1, 256)
     content   String
     published Boolean  @default(false)
-    author    User     @relation(fields: [authorId], references: [id])
+    author    User     @relation(fields: [authorId], references: [id], onDelete: Cascade)
     authorId  String
 }
 `;
 
 // src/actions/init.ts
-async function run4(projectPath) {
+async function run6(projectPath) {
   const packages = [
     {
-      name: "@zenstackhq/cli@next",
+      name: "@zenstackhq/cli@latest",
       dev: true
     },
     {
-      name: "@zenstackhq/runtime@next",
+      name: "@zenstackhq/orm@latest",
       dev: false
     }
   ];
@@ -484,12 +650,12 @@ 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", [
+    const resolved = resolveCommand(pm.agent, "add", [
       pkg.name,
       ...pkg.dev ? [
-        pm.agent === "yarn" ? "--dev" : "--save-dev"
+        pm.agent.startsWith("yarn") || pm.agent === "bun" ? "--dev" : "--save-dev"
       ] : []
     ]);
     if (!resolved) {
@@ -507,25 +673,55 @@ async function run4(projectPath) {
     }
   }
   const generationFolder = "zenstack";
-  if (!fs5.existsSync(path6.join(projectPath, generationFolder))) {
-    fs5.mkdirSync(path6.join(projectPath, generationFolder));
+  if (!fs7.existsSync(path6.join(projectPath, generationFolder))) {
+    fs7.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 (!fs7.existsSync(path6.join(projectPath, generationFolder, "schema.zmodel"))) {
+    fs7.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 fs8 from "fs";
 import path7 from "path";
-async function run5(command, options) {
+
+// src/actions/seed.ts
+import colors7 from "colors";
+import { execaCommand } from "execa";
+async function run7(options, args) {
+  const pkgJsonConfig = getPkgJsonConfig(process.cwd());
+  if (!pkgJsonConfig.seed) {
+    if (!options.noWarnings) {
+      console.warn(colors7.yellow("No seed script defined in package.json. Skipping seeding."));
+    }
+    return;
+  }
+  const command = `${pkgJsonConfig.seed}${args.length > 0 ? " " + args.join(" ") : ""}`;
+  if (options.printStatus) {
+    console.log(colors7.gray(`Running seed script "${command}"...`));
+  }
+  try {
+    await execaCommand(command, {
+      stdout: "inherit",
+      stderr: "inherit"
+    });
+  } catch (err) {
+    console.error(colors7.red(err instanceof Error ? err.message : String(err)));
+    throw new CliError("Failed to seed the database. Please check the error message above for details.");
+  }
+}
+__name(run7, "run");
+
+// src/actions/migrate.ts
+async function run8(command, options) {
   const schemaFile = getSchemaFile(options.schema);
+  await requireDataSourceUrl(schemaFile);
   const prismaSchemaDir = options.migrations ? path7.dirname(options.migrations) : void 0;
   const prismaSchemaFile = await generateTempPrismaSchema(schemaFile, prismaSchemaDir);
   try {
@@ -547,22 +743,23 @@ async function run5(command, options) {
         break;
     }
   } finally {
-    if (fs6.existsSync(prismaSchemaFile)) {
-      fs6.unlinkSync(prismaSchemaFile);
+    if (fs8.existsSync(prismaSchemaFile)) {
+      fs8.unlinkSync(prismaSchemaFile);
     }
   }
 }
-__name(run5, "run");
-async function runDev(prismaSchemaFile, options) {
+__name(run8, "run");
+function runDev(prismaSchemaFile, options) {
   try {
     const cmd = [
-      "prisma migrate dev",
+      "migrate dev",
       ` --schema "${prismaSchemaFile}"`,
       " --skip-generate",
-      options.name ? ` --name ${options.name}` : "",
+      " --skip-seed",
+      options.name ? ` --name "${options.name}"` : "",
       options.createOnly ? " --create-only" : ""
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
@@ -571,48 +768,56 @@ __name(runDev, "runDev");
 async function runReset(prismaSchemaFile, options) {
   try {
     const cmd = [
-      "prisma migrate reset",
+      "migrate reset",
       ` --schema "${prismaSchemaFile}"`,
+      " --skip-generate",
+      " --skip-seed",
       options.force ? " --force" : ""
     ].join("");
-    await execPackage(cmd);
+    execPrisma(cmd);
   } catch (err) {
     handleSubProcessError2(err);
   }
+  if (!options.skipSeed) {
+    await run7({
+      noWarnings: true,
+      printStatus: true
+    }, []);
+  }
 }
 __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);
   }
@@ -627,24 +832,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 fs13 from "fs";
 import * as os2 from "os";
 
 // src/constants.ts
@@ -655,14 +846,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 fs10 from "fs";
 
 // src/utils/is-docker.ts
-import fs7 from "fs";
+import fs9 from "fs";
 var isDockerCached;
 function hasDockerEnv() {
   try {
-    fs7.statSync("/.dockerenv");
+    fs9.statSync("/.dockerenv");
     return true;
   } catch {
     return false;
@@ -671,7 +862,7 @@ function hasDockerEnv() {
 __name(hasDockerEnv, "hasDockerEnv");
 function hasDockerCGroup() {
   try {
-    return fs7.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+    return fs9.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
   } catch {
     return false;
   }
@@ -689,7 +880,7 @@ __name(isDocker, "isDocker");
 var cachedResult;
 var hasContainerEnv = /* @__PURE__ */ __name(() => {
   try {
-    fs8.statSync("/run/.containerenv");
+    fs10.statSync("/run/.containerenv");
     return true;
   } catch {
     return false;
@@ -706,7 +897,7 @@ __name(isInContainer, "isInContainer");
 // src/utils/is-wsl.ts
 import process2 from "process";
 import os from "os";
-import fs9 from "fs";
+import fs11 from "fs";
 var isWsl = /* @__PURE__ */ __name(() => {
   if (process2.platform !== "linux") {
     return false;
@@ -715,7 +906,7 @@ var isWsl = /* @__PURE__ */ __name(() => {
     return true;
   }
   try {
-    return fs9.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
+    return fs11.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft");
   } catch {
     return false;
   }
@@ -779,17 +970,17 @@ function getMachineId() {
 __name(getMachineId, "getMachineId");
 
 // src/utils/version-utils.ts
-import colors6 from "colors";
-import fs10 from "fs";
+import colors8 from "colors";
+import fs12 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(fs12.readFileSync(path8.join(_dirname, "../package.json"), "utf8")).version;
   } catch {
     return void 0;
   }
@@ -804,7 +995,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 ${colors8.cyan(latestVersion)} is available.`);
   }
 }
 __name(checkNewVersion, "checkNewVersion");
@@ -919,7 +1110,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(fs13.readFileSync(packageJsonUrl, "utf8"));
       return packageJson.version;
     } catch {
       return void 0;
@@ -930,45 +1121,62 @@ 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}`, () => run8(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");
+var seedAction = /* @__PURE__ */ __name(async (options, args) => {
+  await telemetry.trackCommand("db seed", () => run7(options, args));
+}, "seedAction");
 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(`${colors9.bold.blue("\u03B6")} ZenStack is the modern data layer for TypeScript apps.
 
-Documentation: https://zenstack.dev/docs/3.x`).showHelpAfterError().showSuggestionAfterError();
+Documentation: https://zenstack.dev/docs`).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);
+  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(new Option("--skip-seed", "skip seeding the database after reset")).addOption(noVersionCheckOption).description("Reset your database and apply all migrations, all data will be lost").addHelpText("after", "\nIf there is a seed script defined in package.json, it will be run after the reset. Use --skip-seed to skip it.").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));
+  dbCommand.command("seed").description("Seed the database").allowExcessArguments(true).addHelpText("after", `
+Seed script is configured under the "zenstack.seed" field in package.json.
+E.g.:
+{
+    "zenstack": {
+        "seed": "ts-node ./zenstack/seed.ts"
+    }
+}
+
+Arguments following -- are passed to the seed script. E.g.: "zen db seed -- --users 10"`).addOption(noVersionCheckOption).action((options, command) => seedAction(options, command.args));
+  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();
@@ -989,10 +1197,10 @@ async function main() {
     if (e instanceof CommanderError) {
       exitCode = e.exitCode;
     } else if (e instanceof CliError) {
-      console.error(colors7.red(e.message));
+      console.error(colors9.red(e.message));
       exitCode = 1;
     } else {
-      console.error(colors7.red(`Unhandled error: ${e}`));
+      console.error(colors9.red(`Unhandled error: ${e}`));
       exitCode = 1;
     }
   }