release: v2.3.0

[MrRefactoring]

Cuts v2.3.0.

What ships

Action is a union discriminated on type. Twenty-nine action types carry their own data shape, so action.data.text on a commentCard is a string and reading a field that type does not have is a compile error rather than undefined at runtime. This is a compile break in a minor release; ActionUnknown is exported as an escape hatch. The CHANGELOG opens with it.

fields on six endpoints asked for a whole object. getBoardActions, getCardActions, getListActions, getMemberActions and getOrganizationActions typed it as Action; getBoardLabels typed it as Label. Trello's spec points those parameters at the object schema instead of at the matching ActionFields and LabelFields enums. All six now take the shape the other thirty-five fields parameters already had: string | string[], widened with the documented names so autocomplete offers them.

The published API reference builds again. It did not before: every parameter and model type was expanded inline on the endpoint pages, docs/api reached 22 MB with no links in it, and VitePress ran out of an 8 GB heap after roughly fifteen minutes.

Why the docs needed a patch

type X = z.infer<typeof XSchema> resolves through a conditional type. TypeScript keeps no aliasSymbol on the result, so checker.typeToTypeNode serializes the structure instead of the name, and typedoc inlines it. Declaration emit does not have this problem, in TypeScript 6.0.3 or 7.0.2; only typeToTypeNode loses the alias.

typedoc already holds the annotation the author wrote, in maybeNode, and uses it only for mapped types. patches/typedoc@0.28.20.patch reads it and converts it as a reference. typedoc-plugin-zod then fills the pages those references point at with the fields and JSDoc the schemas carry.

The patch is not upstreamable as written: it breaks typedoc's handling of the @inline tag, transient symbols and default exports, none of which this project uses. An issue with a zod-free reproduction goes upstream separately. Scope of the patch here is the docs build; it is a devDependencies patch and reaches nothing that is published to npm.

Measured

	before	after
docs/api	22 MB	9.0 MB
docs:build	out of memory at 8 GB	passes, peak 2.4 GB

pnpm run build, pnpm run lint and pnpm vitest run (181 tests) are green.

Not in this release

feat/schema-mismatch and its breaking changes, the 3.0.0 number, and the migration page.

What the review changed

Four findings came out of the review of this branch; all four are in.

Open enums lost their own suggestions. Eighty parameter schemas and one model carried a plain z.string() next to the openEnum in the same union. It accepted nothing the open enum did not already accept, and in the type a bare string swallowed the literal names beside it — so fields: '…', filter: '…' and pos: '…' offered nothing, and only the array form still suggested anything. Fixed at the source and resynced; nothing that compiled before stops compiling.

One consequence worth naming: with the z.string() branch gone, TokenPermission.idModel is a closed z.enum(['*']) under TRELLO_STRICT_SCHEMAS. Normal mode is unchanged and consumers are unaffected — but the audit run will now speak up if a token carries a concrete id, which is what the audit is for.

The docs patch was one pnpm update from falling off. patches/typedoc@0.28.20.patch is keyed to that exact version while the manifest allowed any 0.28.x; typedoc is pinned now. The Docs workflow also watches patches/ and pnpm-workspace.yaml, so a reissued patch rebuilds the reference rather than leaving Pages on whatever last touched src/.

The comma join was untested. An array in searchParams reaches the wire as one comma-separated value through String(value) — the form this release newly advertises for six endpoints — and nothing held it in place. Two tests in buildUrl.test.ts do.

Still open, deliberately: docs:build runs only on push to master, so the reference build is not gated on a PR. It builds locally after these changes — docs/api at 9.0 MB — but adding a PR gate is a separate decision about CI time.