# temporalio/sdk-typescript · Reposen Release & Migration Intelligence

> Enforces strict peer dependencies, fixes export maps, and updates Nexus handlers. Audit imports. Migration: High.

## Metadata
- **Repository URL**: https://github.com/temporalio/sdk-typescript
- **Primary Package**: `@temporalio/client` (NPM)
- **Categories**: `ECOSYSTEM`, `BACKEND`
- **Latest Version**: `v1.25.0`
- **Semantic Status**: `BREAKING`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/temporalio/sdk-typescript/releases.atom

## The Human Context (Plain-English Pitch)
Temporal is a developer platform and durable execution engine that lets engineering teams build highly reliable distributed applications without wrestling with low-level state management, retries, or timers. This TypeScript SDK release introduces strict package subpath export boundaries, elevates protobuf requirements to explicit peer dependencies, and adds robust Nexus and external storage capabilities.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Enforces strict peer dependencies, fixes export maps, and updates Nexus handlers. Audit imports. Migration: High.

## Breaking Changes & Required Actions
- [BREAKING] Undocumented package subpaths not covered by export maps no longer resolve.
- [BREAKING] SDK and contrib packages now require `protobufjs` and `long` as peer dependencies.
- [BREAKING] Nexus Workflow Updates now require `waitForStage` to be explicitly set to `ACCEPTED`.
- Enforced explicit package export maps, breaking undocumented subpath imports across `@temporalio/*` packages.
- Declared `protobufjs` (`^8.7.1`) and `long` (`^5.3.2`) as explicit peer dependencies across SDK and contrib packages.
- Workers now refuse to execute workflow bundles compiled with mismatched SDK versions to prevent nondeterminism issues.
- Added experimental cooperative concurrency limits and payload caching support for external storage drivers.

## Migration Snippet
```ts
npm install protobufjs@^8.7.1 long@^5.3.2
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **Node.js >=22.12.0** [`PARTIAL`]: Google ADK wrappers and certain sandbox features require Node.js 22.12.0 or 23.8+.
- **TypeScript ^5.0** [`COMPATIBLE`]: Fully compatible with modern TypeScript configurations and strict type inference.

## Zero-Noise Release Timeline
- **v1.25.0** (2026-10-27) [BREAKING]: Enforces strict peer dependencies, fixes export maps, and updates Nexus handlers. Audit imports. Migration: High.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is temporalio/sdk-typescript v1.25.0 safe to upgrade in production?
temporalio/sdk-typescript v1.25.0 is classified as BREAKING (MAJOR release). Enforces strict peer dependencies, fixes export maps, and updates Nexus handlers. Audit imports. Migration: High.

### What breaking changes or compatibility risks exist in temporalio/sdk-typescript v1.25.0?
Undocumented package subpaths not covered by export maps no longer resolve. SDK and contrib packages now require `protobufjs` and `long` as peer dependencies. Nexus Workflow Updates now require `waitForStage` to be explicitly set to `ACCEPTED`.

### What is the bundle size impact of @temporalio/client v1.25.0?
Measured bundle size telemetry is currently unavailable for @temporalio/client v1.25.0; verify build output locally before deploying.

### How do I upgrade @temporalio/client to v1.25.0?
Upgrade @temporalio/client to v1.25.0 by running "npm install @temporalio/client@1.25.0" and applying the migration steps: npm install protobufjs@^8.7.1 long@^5.3.2
