Skip to content

Commit aad315b

Browse files
committed
fix: standardize TypeScript to ^5.9.3 across all packages
Closes #600 - Root, backend, and sdk were pinned to ^6.0.3 (a pre-release/nightly build not published as a stable npm release), causing toolchain instability across packages that share types. - Align all five packages to ^5.9.3 (current stable). - Add docs/TYPESCRIPT_POLICY.md documenting the canonical version, rationale, and upgrade procedure.
1 parent 2f9a534 commit aad315b

5 files changed

Lines changed: 45 additions & 119 deletions

File tree

backend/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,6 +95,6 @@
9595
"supertest": "^7.2.2",
9696
"ts-jest": "^29.4.9",
9797
"ts-node-dev": "^2.0.0",
98-
"typescript": "^6.0.3"
98+
"typescript": "^5.9.3"
9999
}
100100
}

docs/TYPESCRIPT_POLICY.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# TypeScript Version Policy
2+
3+
## Canonical Version
4+
5+
All packages in this monorepo pin to **TypeScript `^5.9.3`**.
6+
7+
| Package | Version |
8+
|-----------|-----------|
9+
| root | `^5.9.3` |
10+
| backend | `^5.9.3` |
11+
| client | `^5.9.3` |
12+
| sdk | `^5.9.3` |
13+
| shared | `^5.9.3` |
14+
15+
## Rationale
16+
17+
- TypeScript 5.x is the current stable major version.
18+
- `^6.0.3` referenced a pre-release / nightly build that does not exist on the public npm registry as a stable release, causing toolchain instability (issue #600).
19+
- A single version eliminates version-skew bugs between packages that share types via `@syncro/shared`.
20+
21+
## Upgrade Policy
22+
23+
1. Upgrades are evaluated when a new TypeScript **stable** minor or major is released.
24+
2. All packages are updated together in a single PR.
25+
3. The PR must include a passing typecheck across every package (`npm run typecheck --workspaces`).
26+
4. Deviations (e.g. a package temporarily pinned to an older patch) must be documented here with a justification and a target remediation date.
27+
28+
## Current Deviations
29+
30+
None.

0 commit comments

Comments
 (0)