schemashift-cli 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
-# schemashift
+# schemashift-cli
 
-TypeScript schema migration CLI. Convert between Zod, Yup, Joi, io-ts, and Valibot.
+TypeScript schema migration CLI. Convert between Zod, Yup, Joi, io-ts, and Valibot with AST-based transformations.
 
 ## Install
 
@@ -8,19 +8,201 @@ TypeScript schema migration CLI. Convert between Zod, Yup, Joi, io-ts, and Valib
 npm install -g schemashift-cli
 ```
 
-## Usage
+## Commands
+
+### `init`
+
+Create a `.schemashiftrc.json` configuration file.
 
 ```bash
-# Analyze schemas
-schemashift analyze ./src
+schemashift init [--force]
+```
+
+### `analyze`
+
+Analyze schemas in your project without modifying files.
+
+```bash
+schemashift analyze <path> [options]
+```
+
+| Option | Description | Tier |
+|--------|-------------|------|
+| `--json` | Output as JSON | Free |
+| `-v, --verbose` | Show detailed file paths | Free |
+| `--detailed` | Full stats with complexity scoring | Individual+ |
+| `--readiness <path>` | Migration readiness report, e.g. `yup->zod` | Individual+ |
+| `--complexity` | Per-schema complexity scores | Individual+ |
+
+### `migrate`
+
+Transform schemas from one library to another.
+
+```bash
+schemashift migrate <path> [options]
+```
+
+**Required (single-step):**
+
+| Option | Description |
+|--------|-------------|
+| `-f, --from <library>` | Source library (`yup`, `joi`, `io-ts`, `zod-v3`, `zod`) |
+| `-t, --to <library>` | Target library (`zod`, `v4`, `valibot`) |
+
+**Or (chain migration):**
+
+| Option | Description | Tier |
+|--------|-------------|------|
+| `--chain <path>` | Multi-step, e.g. `yup->zod->valibot` | Pro+ |
+
+**Options:**
+
+| Option | Description | Tier |
+|--------|-------------|------|
+| `-d, --dry-run` | Preview changes with diff output | Free |
+| `-v, --verbose` | Show warnings and detailed info | Free |
+| `-c, --config <path>` | Path to config file | Free |
+| `--report <format>` | Generate report (`json`, `html`, `csv`) | Individual+ |
+| `--report-output <path>` | Custom report output path | Individual+ |
+| `--git-branch` | Create a git branch for changes | Individual+ |
+| `--git-commit` | Auto-commit changes | Individual+ |
+| `--no-backup` | Skip backup creation | Free |
+| `--yes` | Skip confirmation prompt | Free |
+| `--ci` | CI mode (non-interactive, exit 1 on failure) | Pro+ |
+| `--cross-file` | Resolve cross-file schema dependencies | Pro+ |
+| `--compat-check` | Run compatibility check before migration | Pro+ |
+| `--fail-on-warnings` | Exit 1 if any warnings | Team |
+| `--max-risk-score <n>` | Exit 1 if any file exceeds risk score | Team |
+
+### `watch`
+
+Watch files and transform on save.
+
+```bash
+schemashift watch <path> -f <library> -t <library> [-c <config>]
+```
+
+**Tier:** Pro+
+
+### `rollback`
+
+Restore files from a backup.
+
+```bash
+schemashift rollback [backupId]
+```
+
+| Option | Description |
+|--------|-------------|
+| `-l, --list` | List available backups |
+| `--clean` | Remove old backups (keeps last 5) |
+
+### `license`
+
+Manage your license.
+
+```bash
+schemashift license [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `-a, --activate <key>` | Activate a license key |
+| `-d, --deactivate` | Deactivate current license |
+| `-s, --status` | Show license status |
+
+### `compat`
+
+Check schema library compatibility before migration.
+
+```bash
+schemashift compat <path> [--json]
+```
+
+Detects installed library versions, reports version-specific issues, and identifies ecosystem dependencies (drizzle-zod, tRPC, etc.) affected by your migration.
+
+**Tier:** Pro+
+
+### `governance`
+
+Run schema governance checks.
+
+```bash
+schemashift governance <path> [--json] [-c <config>]
+```
+
+Enforces naming conventions, complexity limits, required validations, and more. Configure rules in `.schemashiftrc.json`.
+
+**Tier:** Team
+
+### `pricing`
 
-# Migrate Yup to Zod
-schemashift migrate ./src --from yup --to zod
+Display pricing information.
 
-# Preview first (recommended)
+```bash
+schemashift pricing
+```
+
+## Configuration
+
+Create `.schemashiftrc.json` with `schemashift init`:
+
+```json
+{
+  "include": ["src/**/*.ts", "src/**/*.tsx"],
+  "exclude": ["**/node_modules/**", "**/dist/**", "**/*.d.ts"],
+  "git": {
+    "enabled": false,
+    "createBranch": true,
+    "branchPrefix": "schemashift/",
+    "autoCommit": false
+  },
+  "backup": { "enabled": true, "dir": ".schemashift-backup" },
+  "customRules": [],
+  "suppressWarnings": [],
+  "governance": {
+    "rules": {
+      "naming-convention": { "pattern": ".*Schema$" },
+      "max-complexity": { "threshold": 80 },
+      "no-any": {},
+      "required-validations": {}
+    }
+  },
+  "plugins": ["./my-plugin.js"]
+}
+```
+
+## Examples
+
+```bash
+# Quick analysis
+schemashift analyze ./src
+
+# Preview Yup→Zod migration
 schemashift migrate ./src --from yup --to zod --dry-run
+
+# Full migration with HTML report
+schemashift migrate ./src --from yup --to zod --report html
+
+# Zod v3→v4 upgrade with compatibility check
+schemashift migrate ./src --from zod-v3 --to v4 --compat-check
+
+# Chain migration: Yup→Zod→Valibot
+schemashift migrate ./src --chain yup->zod->valibot
+
+# CI mode
+schemashift migrate ./src --from yup --to zod --ci --report json
+
+# Rollback last migration
+schemashift rollback
 ```
 
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `SCHEMASHIFT_LICENSE_KEY` | License key for CI/CD (avoids interactive activation) |
+
 ## Links
 
 - [Documentation](https://schemashift.qwady.app/docs)

package/dist/chunk-N2ZLW7EG.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// ../../node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename, getDirname, __dirname, __filename;
+var init_esm_shims = __esm({
+  "../../node_modules/tsup/assets/esm_shims.js"() {
+    "use strict";
+    getFilename = () => fileURLToPath(import.meta.url);
+    getDirname = () => path.dirname(getFilename());
+    __dirname = /* @__PURE__ */ getDirname();
+    __filename = /* @__PURE__ */ getFilename();
+  }
+});
+
+export {
+  __require,
+  __commonJS,
+  __export,
+  __dirname,
+  __filename,
+  init_esm_shims
+};