TypeScript SDK changelog

2026-04-10

TypeScript SDK v1.12.0

New Features

Hooks and OpenTelemetry

A new hooks system lets you intercept handler execution and ctx.run() closures at the endpoint, service, or handler level.Use it to integrate with your favourite observability libraries:

const myHookProvider: HooksProvider = (ctx) => ({
  interceptor: {
    handler: async (next) => {
      console.log(`before ${ctx.request.target}`);
      try {
        await next();
      } finally {
        console.log(`after ${ctx.request.target}`);
      }
    },
    run: async (name, next) => {
      console.log(`  run "${name}" executing`);
      await next();
    },
  },
});

// Then in the service configuration:

const myService = restate.service({
    name: "MyService",
    handlers: { ... },
    options: {
        hooks: [myHookProvider],
    },
});

Together with the hooks interface, the new @restatedev/restate-sdk-opentelemetry package provides a ready-made OpenTelemetry integration.It automatically propagates trace context from Restate and creates spans with standard Restate attributes (restate.invocation.id, restate.invocation.target):

import {openTelemetryHook} from "@restatedev/restate-sdk-opentelemetry";
import {trace} from "@opentelemetry/api";

const greeter = restate.service({
    name: "Greeter",
    options: {
        // Set up the openTelemetryHook
        hooks: [openTelemetryHook({tracer: trace.getTracer("greeter-service")})],
    },
    handlers: {
        greet: async (ctx: Context, name: string) => {
            // Add an event using trace.getActiveSpan().addEvent()
            trace.getActiveSpan()?.addEvent("my.event", {name});

            // ctx.runs get automatically their span, child of the handler attempt span.
            const greeting = await ctx.run("compute-greet", async () => {
                // You can get the ctx.run span here for downstream propagation
                const span = trace.getActiveSpan();
                return `Hello ${name}!`
            });

            return greeting;
        },
    },
});

For more complete examples, check out:

OpenTelemetry integration example: https://github.com/restatedev/examples/tree/main/typescript/integrations/opentelemetry

HTTP/1.1 Handler for Node.js

restate.createEndpointHandler() now returns a handler that works with both HTTP/2 and HTTP/1.1. It auto-detects the HTTP version per request:

import * as http from "node:http";

const restateSDKHandler = restate.createEndpointHandler({ services: [myService] });
const server = http.createServer(restateSDKHandler);
server.listen(9080);

`RestatePromise` improvements

New factory methods to create already-completed Restate promises, mirroring Promise.resolve/Promise.reject:

RestatePromise.resolve(myValue);
RestatePromise.reject(new restate.TerminalError("Access denied"));

We also expose isRestatePromise to reliably detect whether a promise is a RestatePromise.

Testcontainer options

alwaysReplay and disableRetries options added to the Restate testcontainer, to simplify testing edge cases in your code.Check RestateContainer documentation for more details.

Experimental APIs

We’re releasing two new experimental APIs:

Explicit cancellation, to manually handle Restate’s cancellation, instead of relying on RestatePromise failing with CancelledError when cancellation is received.
Signals, a way for invocations to communicate between each other.

For more info on these features, refer to the ContextInternal documentation. The API of these features is experimental and might change in future releases.

Improvements and bug fixes

Awakeable.reject() now accepts a TerminalError, propagating error message, code, and metadata.
Added asTerminalError and default serde handler option. These take precedence over the already existing service/endpoint level configuration.
RestatePromise combinators now correctly handle empty input arrays (#611).
Request.id is now an InvocationId.
Added Request.target to get the full invocation target.
Removed deprecated SendOpts (use SendOptions).
Removed deprecated *millis fields in retry policy.

SDKs

Services

Restate Cloud

Self-hosted Restate

References

​New Features

​Hooks and OpenTelemetry

​HTTP/1.1 Handler for Node.js

​RestatePromise improvements

​Testcontainer options

​Experimental APIs

​Improvements and bug fixes

​What’s Changed

​What’s Changed

​New Contributors

​What’s Changed

​What’s Changed

​What’s Changed

​What’s Changed

​What’s Changed

​StandardSchema support

​What’s Changed

​What’s Changed

​New Contributors

​What’s Changed

​New Contributors

​Zod v4

​Invocation retry policy

​AWS Lambda compression

​Changes to ctx.rand

​Full changelog

​What’s Changed

​What’s Changed

​What’s Changed

​New Contributors

​What’s Changed

​Changelog

​Renamed CombineablePromise to RestatePromise

​What’s Changed

​What’s Changed

​New features

​Notable changes

​Full changelog

​New features

​What’s Changed

​Workflow API

​Shared handlers for Virtual Objects

​What’s Changed

​What’s Changed

​New Contributors

​What’s Changed

​What’s Changed

​New Contributors

​What’s Changed

​Breaking changes

New Features

Hooks and OpenTelemetry

HTTP/1.1 Handler for Node.js

`RestatePromise` improvements

Testcontainer options

Experimental APIs

Improvements and bug fixes

What’s Changed

What’s Changed

New Contributors

What’s Changed

What’s Changed

What’s Changed

What’s Changed

What’s Changed

StandardSchema support

What’s Changed

What’s Changed

New Contributors

What’s Changed

New Contributors

Zod v4

Invocation retry policy

AWS Lambda compression

Changes to `ctx.rand`

Full changelog

What’s Changed

What’s Changed

What’s Changed

New Contributors

What’s Changed

Changelog

Renamed `CombineablePromise` to `RestatePromise`

What’s Changed

What’s Changed

New features

Notable changes

Full changelog

New features

What’s Changed

Workflow API

Shared handlers for Virtual Objects

What’s Changed

What’s Changed

New Contributors

What’s Changed

What’s Changed

New Contributors

What’s Changed

Breaking changes