zero-swift 0.1.0 → 0.1.1

package/README.md

@@ -6,6 +6,7 @@ truth, and this tool generates what the Swift client needs from them.
 
 ```sh
 npm install --save-dev zero-swift
+npx zero-swift --help
 ```
 
 It needs Node 22.18 or later, which loads TypeScript files directly. It also

package/dist/bin.js

@@ -567,13 +567,38 @@ function aliasName(type) {
 }
 
 // src/cli.ts
+var usage = `Usage:
+  zero-swift codegen [--schema schema.ts] [--out Schema.swift]
+                     [--config zero-swift.json] [--check]
+  zero-swift drift record [--samples drift-samples.ts]
+                          [--out drift-vectors.json] [--check]
+
+codegen generates Swift from the app's TypeScript schema. Options override
+zero-swift.json, which is read when present.
+drift record runs the app's TS queries and mutators on samples and records
+what they did, for the Swift drift test.
+--check fails when the output is out of date instead of writing it.
+
+Docs: https://github.com/wevm/zero/tree/main/packages/zero-swift-cli
+`;
+var UsageError = class extends Error {
+};
+function mustExist(path, message) {
+  if (!existsSync(path)) {
+    throw new UsageError(message);
+  }
+}
 async function codegenFile(config, cwd) {
   const schemaPath = resolve2(cwd, config.schema ?? "schema.ts");
+  mustExist(
+    schemaPath,
+    `Schema ${relative(cwd, schemaPath)} doesn't exist. Pass --schema, or set "schema" in zero-swift.json.`
+  );
   const exportName = config.export ?? "schema";
   const module = await import(pathToFileURL(schemaPath).href);
   const schema = module[exportName];
   if (!schema || typeof schema !== "object" || !("tables" in schema)) {
-    throw new Error(
+    throw new UsageError(
       `${schemaPath} does not export a schema as "${exportName}"`
     );
   }
@@ -586,24 +611,41 @@ async function codegenFile(config, cwd) {
   );
 }
 async function main(argv) {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    allowPositionals: true,
-    options: {
-      schema: { type: "string" },
-      out: { type: "string" },
-      config: { type: "string" },
-      samples: { type: "string" },
-      check: { type: "boolean" }
-    }
-  });
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: argv,
+      allowPositionals: true,
+      options: {
+        schema: { type: "string" },
+        out: { type: "string" },
+        config: { type: "string" },
+        samples: { type: "string" },
+        check: { type: "boolean" },
+        help: { type: "boolean", short: "h" }
+      }
+    });
+  } catch (e) {
+    process.stderr.write(`${e.message}
+
+${usage}`);
+    return 2;
+  }
+  const { values, positionals } = parsed;
   const [command = "codegen", subcommand] = positionals;
+  if (values.help || command === "help") {
+    process.stdout.write(usage);
+    return 0;
+  }
   const cwd = process.cwd();
   if (command === "drift" && subcommand === "record") {
-    const { recordDriftFile } = await import("./drift-S756Q2ZA.js");
-    const vectors = await recordDriftFile(
-      resolve2(cwd, values.samples ?? "drift-samples.ts")
+    const samples = resolve2(cwd, values.samples ?? "drift-samples.ts");
+    mustExist(
+      samples,
+      `Samples file ${relative(cwd, samples)} doesn't exist. Pass --samples.`
     );
+    const { recordDriftFile } = await import("./drift-S756Q2ZA.js");
+    const vectors = await recordDriftFile(samples);
     return writeOutput(
       resolve2(cwd, values.out ?? "drift-vectors.json"),
       vectors,
@@ -612,11 +654,17 @@ async function main(argv) {
     );
   }
   if (command !== "codegen") {
-    process.stderr.write(`Unknown command "${positionals.join(" ")}"
-`);
+    process.stderr.write(
+      `Unknown command "${positionals.join(" ")}"
+
+${usage}`
+    );
     return 2;
   }
   const configPath = values.config ?? (existsSync(resolve2(cwd, "zero-swift.json")) ? "zero-swift.json" : void 0);
+  if (configPath) {
+    mustExist(resolve2(cwd, configPath), `Config ${configPath} doesn't exist.`);
+  }
   const fileConfig = configPath ? JSON.parse(readFileSync(resolve2(cwd, configPath), "utf8")) : {};
   const config = {
     ...fileConfig,
@@ -646,4 +694,13 @@ function writeOutput(output, contents, check, cwd) {
 }
 
 // src/bin.ts
-process.exitCode = await main(process.argv.slice(2));
+try {
+  process.exitCode = await main(process.argv.slice(2));
+} catch (e) {
+  if (!(e instanceof UsageError)) {
+    throw e;
+  }
+  process.stderr.write(`zero-swift: ${e.message}
+`);
+  process.exitCode = 1;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zero-swift",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Generates the Swift row types and schema of a Zero app for the Zero Swift client.",
   "license": "Apache-2.0",
   "repository": {
@@ -19,14 +19,14 @@
     "typescript": "6.0.3"
   },
   "devDependencies": {
-    "@types/node": "^22.10.5",
+    "@types/node": "^22.19.19",
     "esbuild": "0.28.2",
-    "oxfmt": "^0.65.0",
+    "oxfmt": "^0.74.0",
     "vitest": "^5.0.0",
-    "zero-schema": "0.0.0",
     "@rocicorp/zero": "1.12.0",
-    "zql": "0.0.0",
-    "zero-types": "0.0.0"
+    "zero-schema": "0.0.0",
+    "zero-types": "0.0.0",
+    "zql": "0.0.0"
   },
   "peerDependencies": {
     "@rocicorp/zero": ">=1.11.0"