typescript-cli-tsgen

Mental model for the contentstack-cli-tsgen OCLIF plugin and tsgen command.

npx skills add https://github.com/contentstack/contentstack-cli-tsgen --skill typescript-cli-tsgen

TypeScript CLI tsgen skill

Plugin for csdx: implements TypeScriptCodeGeneratorCommand in src/commands/tsgen.ts.
Generation is delegated to @contentstack/types-generator (npm, GitHub)—version ^3.9.3 in package.json. Do not assume a local clone; use npm and published source only.

Concern	Where
New flags, output path, `csdx` UX, `printFormattedError`	This repo (`src/commands/`, `src/lib/`)
Schema mapping, Delivery SDK calls, GraphQL introspection	`@contentstack/types-generator`

src/lib/helper.ts: sanitizePath, printFormattedError (FormattedError, error_code switch).
src/types/index.ts: StackConnectionConfig and related CLI types.

Commands compile to lib/commands; prepack refreshes oclif.manifest.json and README.

Extends Command from @contentstack/cli-command (src/commands/tsgen.ts).
Flags include token-alias (-a, required), output (-o), prefix, doc, branch, include-system-fields, include-editable-tags, include-referenced-entry, api-type (rest | graphql), namespace (GraphQL).
Resolve token via this.getToken(flags["token-alias"]); warn if token.type !== "delivery" (management token can break Delivery/GraphQL flows).
Build StackConnectionConfig: apiKey, token, region, environment, branch, host as in existing code.
api-type === "graphql" → graphqlTS(...) with delivery token; REST → generateTS with tokenType: "delivery"; write output with fs.writeFileSync to the resolved path.
Use printFormattedError from src/lib/helper.ts for consistent CLI messaging.