@vaif/migrate

Codemod CLI to migrate codebases from the legacy @vaiftech/client SDK to the official @vaif/client SDK.

Usage

# Migrate the current directory
npx @vaif/migrate

# Migrate a specific directory
npx @vaif/migrate ./src

# Preview changes without writing files
npx @vaif/migrate --dry-run ./src

What it does

Walks all .ts, .tsx, .js, .jsx, .mjs, and .cjs files (excluding node_modules, dist, build) and rewrites import specifiers:

| Before | After | Notes | | --------------------------------------- | ---------------------------------- | --- | | @vaiftech/client | @vaif/client | Core SDK | | @vaiftech/client/realtime | @vaif/client/realtime | Subpath | | @vaiftech/client/storage | @vaif/client/storage | Subpath | | @vaiftech/client/storage/browser | @vaif/client/storage/browser | Subpath | | @vaiftech/client/storage/resume | @vaif/client/storage/resume | Subpath | | @vaiftech/cli | @vaif/cli | Tooling | | @vaiftech/react | @vaif/react | Hooks | | @vaiftech/mcp | @vaif/mcp | MCP server | | @vaiftech/auth | @vaif/auth | ⚠️ Manual review — auth surface moved into @vaif/client | | @vaiftech/sdk-expo | @vaif/client | ⚠️ Manual review — universal @vaif/client works in Expo natively; remove createExpoClient bootstrap |

Both ES import declarations AND CommonJS require(...) / dynamic import(...) calls are rewritten. All import forms (named, default, type-only, namespace, side-effect) are preserved. Unrelated imports and unmapped subpaths are left untouched.

Migrations marked ⚠️ are auto-applied to keep your build green, but flagged in the CLI output so you can manually verify the symbol-level migration (auth and Expo bootstrap shapes don't perfectly map 1:1).

Caveats

• This codemod only rewrites import specifiers. Method-name and signature differences between the legacy @vaiftech/[email protected] and @vaif/[email protected] SDKs still require manual review.
• See the full migration guide for API differences: migration-from-vaiftech-client.md.
• Always run with --dry-run first and commit clean before running the codemod for real.

License

MIT