fix: add AST extraction to serving type generator and move types to shared/

[pkosiec]

Summary

Move generated appkit-types/ from client/src/ to shared/ so both client and server can consume the generated types. Add AST-based endpoint discovery, server-side type-checking, and fix the serving plugin to work correctly with generated types.

What changed

• Generated types → shared/: Output moved from client/src/appkit-types/ to shared/appkit-types/. Tsconfigs updated. Old files cleaned up automatically on first regeneration.
• AST endpoint discovery: The serving type generator now parses server/index.ts to extract serving({ endpoints: {...} }) config — no manual config needed in vite.config.ts.
• Server type-checking in template: build:server previously only ran tsdown (transpile-only, no type-checking), while the client already ran tsc -b before vite build. Added noEmit: true to tsconfig.server.json so tsc -b can type-check without emitting files — tsdown handles all JS output and only reads the tsconfig for path aliases and module resolution, ignoring emit options. Both sides are now symmetric: type-check (tsc -b) → bundle (tsdown/vite).
• ServingFactory adapts to endpoint count: Single endpoint → alias optional. Multiple endpoints → alias required for disambiguation.
• Unnamed serving mode registers both URL patterns: /api/serving/invoke (legacy) and /api/serving/default/invoke (type-generated clients) both work.
• Auto-migration for existing apps: When type generation runs on an existing app with old-style configs, it automatically patches project files (see migration details below).

Auto-migration for existing apps

Existing apps scaffolded from older templates have config files that still reference the old client/src/appkit-types/ location. The type generator now automatically patches these on the next run:

File	What changes	Detection
tsconfig.client.json	Adds "shared/appkit-types" to include	Checks if already present
tsconfig.server.json	Removes outDir/declaration/declarationMap/sourceMap, adds noEmit: true	Checks if outDir exists
package.json	Updates build:server and typecheck scripts to use tsc -b	Exact-match on old script values

Characteristics:

• Idempotent — each sub-migration checks current file state, skips if already migrated
• Runs once per session — dedup flag prevents double execution when both analytics and serving generators fire
• Best-effort — missing files or parse failures are silently skipped
• Opt-out — set "appkit": { "autoMigrate": false } in package.json to disable

Note: JSONC comments in tsconfig files (/* Emit */, // comment) are stripped during migration since JSON.parse requires strict JSON. This only affects the one-time migration write-back.

Demo

Rough, but shows that everything works as it should. I also deployed those apps - no issues.

ms-demo-raw.mp4

(btw the second schema should be unresolved as that endpoint doesn't expose OpenAPI)

Type generation migration:

migration.mp4