feat: Generate one file per route client

[razor-x]

Summary

The resource client classes were all serialized into src/SeamClient.php, producing a single 8950 line file. This generates each client into its own file under src/Routes instead, leaving src/SeamClient.php with just the SeamClient class at 155 lines.

The 42 client class bodies are byte identical to the ones previously emitted into src/SeamClient.php — this only changes where the generator writes them.

Changes

Codegen

• codegen/lib/layouts/route.ts (new) — builds the per-file context for one client class. Holds the method context builder moved out of seam-client.ts, plus getUseStatements, which derives each file's imports from what it actually references: the SeamClient, the resource classes its methods deserialize into, and, for ActionAttemptsClient only, the errors thrown by poll_until_ready. Child clients share their parent's namespace, so they need no import.
• codegen/layouts/route.hbs (new) — namespace, imports, then the existing client-class partial unchanged.
• codegen/lib/layouts/seam-client.ts, codegen/layouts/seam-client.hbs — dropped the {{#each clients}} loop and the resource imports; now emits use Seam\Routes\...Client; for the 20 top-level clients only.
• codegen/lib/routes.ts — writes src/Routes/{ClientName}Client.php per client.
• codegen/smith.ts — cleans ./src/Routes before each run.

Other

• .gitattributes — added src/Routes/*.php, and also src/SeamClient.php, which was generated but never marked.

Namespace

The classes are now under Seam\Routes rather than Seam, matching the Seam\Resources convention introduced in #454. That keeps them PSR-4 clean, so they are autoloaded by the existing Seam\ prefix mapping and composer.json needs no change.

They remain reachable exactly as before through the SeamClient properties, which is how they are used:

$seam = new Seam\SeamClient("YOUR_API_KEY");
$seam->acs->users->list();

Verification

• npm run typecheck, npm run lint, and the prettier check all pass.
• php -l on every file under src/ reports no syntax errors.
• Diffed all 42 client class blocks extracted from the previous src/SeamClient.php against the new files: zero differences.
• Reflection pass over all 42 classes: each autoloads from its expected file, every parameter, return, and property type resolves, and nested wiring ($seam->acs->users, $seam->thermostats->schedules) plus poll_until_ready work.
• phpunit errors on HttpErrorTest::testNonSeamError, but this is environmental rather than caused by this change — the sandbox proxy returns cURL error 56: CONNECT tunnel failed, response 403 where the test expects a DNS resolution failure. The identical failure reproduces on main with these changes stashed.

🤖 Generated with Claude Code

https://claude.ai/code/session_01MicfU2S3miuTWZtejb3w8w