valkyrjaio / sindri-ts / 27894146899

100%

push

github

[Sindri] Add a runnable CLI for data generation (#29)

# Description

Adds a working CLI entrypoint to Sindri so it can be run as a standalone
binary for data generation, mirroring PHP's `vendor/bin/sindri` and
Java's runnable jar.

Node refuses to strip types from `node_modules`, so the existing
ecosystem (including the app's own `bin/cli.ts`) doesn't run outside
Vitest. The CLI is therefore a self-contained esbuild bundle with
`valkyrja` inlined, which works because Sindri only file-reads the
target app via `ts-morph` — it never imports it. CJS (`.cjs`) is used
because an ESM bundle fails on `ts-morph`'s dynamic `require('fs')`.

---

## Types of Changes

- [x] Improvement _(non-breaking change which improves code)_
- [ ] Bug fix _(non-breaking change which fixes an issue)_
- [x] New feature _(non-breaking change which adds functionality)_
- [ ] Deprecation _(breaking change which removes functionality)_
- [ ] Breaking change _(fix or feature that would cause existing
functionality to change)_
- [ ] Documentation improvement

---

## Changes

- **`bin/sindri.ts`** — new CLI entrypoint; parses `generate <config>`
from `argv`, builds a `Cli` route carrying the config path, and runs
`GenerateDataFromConfigCommand`
- **`package.json`** — added `bin → dist/bin/sindri.cjs`; added `build`
(esbuild bundle) and `prepublishOnly` scripts; added `esbuild` as a dev
dependency
- **`tsconfig.json`** — added `bin/**/*` to `includes` so the entrypoint
is type-checked

> `dist/` stays gitignored and is built on publish. The `bin` is outside
the `src/**` coverage scope, consistent with other repos' entrypoints.

693 of 693 branches covered (100.0%)

Branch coverage included in aggregate %.

1128 of 1128 relevant lines covered (100.0%)

10.72 hits per line