{"id":29228410,"url":"https://github.com/restatedev/sdk-typescript","last_synced_at":"2026-02-25T02:01:22.082Z","repository":{"id":207163580,"uuid":"607697713","full_name":"restatedev/sdk-typescript","owner":"restatedev","description":"Restate SDK for JavaScript/Typescript","archived":false,"fork":false,"pushed_at":"2026-02-19T22:31:08.000Z","size":14918,"stargazers_count":92,"open_issues_count":24,"forks_count":16,"subscribers_count":25,"default_branch":"main","last_synced_at":"2026-02-20T02:57:50.648Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/restatedev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2023-02-28T13:56:30.000Z","updated_at":"2026-02-19T22:26:53.000Z","dependencies_parsed_at":"2023-12-21T16:37:00.364Z","dependency_job_id":"e14e4695-3a35-441b-9389-6680ebac2cd7","html_url":"https://github.com/restatedev/sdk-typescript","commit_stats":null,"previous_names":["restatedev/sdk-typescript"],"tags_count":83,"template":false,"template_full_name":null,"purl":"pkg:github/restatedev/sdk-typescript","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/restatedev%2Fsdk-typescript","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/restatedev%2Fsdk-typescript/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/restatedev%2Fsdk-typescript/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/restatedev%2Fsdk-typescript/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/restatedev","download_url":"https://codeload.github.com/restatedev/sdk-typescript/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/restatedev%2Fsdk-typescript/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29806142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T22:43:48.403Z","status":"ssl_error","status_checked_at":"2026-02-24T22:43:18.536Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-03T10:10:51.076Z","updated_at":"2026-02-25T02:01:22.064Z","avatar_url":"https://github.com/restatedev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Documentation](https://img.shields.io/badge/doc-reference-blue)](https://docs.restate.dev)\n[![Examples](https://img.shields.io/badge/view-examples-blue)](https://github.com/restatedev/examples)\n[![NPM Version](https://img.shields.io/npm/v/%40restatedev%2Frestate-sdk)](https://www.npmjs.com/package/@restatedev/restate-sdk)\n[![Discord](https://img.shields.io/discord/1128210118216007792?logo=discord)](https://discord.gg/skW3AZ6uGd)\n[![Twitter](https://img.shields.io/twitter/follow/restatedev.svg?style=social\u0026label=Follow)](https://twitter.com/intent/follow?screen_name=restatedev)\n\n# Restate Typescript SDK\n\n[Restate](https://restate.dev/) is a system for easily building resilient applications using *distributed durable async/await*. This repository contains the Restate SDK for writing services in **Node.js / Typescript**.\n\nRestate applications are composed of *durably executed, stateful RPC handlers* that can run either\nas part of long-running processes, or as FaaS (AWS Lambda).\n\n```typescript\nimport * as restate from \"@restatedev/restate-sdk\";\n\nconst greeter = restate.service({\n    name: \"greeter\",\n    handlers: {\n        greet: async (ctx: restate.Context, name: string) =\u003e {\n            return `Hello ${name}!`;\n        },\n    },\n});\n\nrestate.serve({ services: [greeter], port: 9080 });\n```\n\n## Community\n\n* 🤗️ [Join our online community](https://discord.gg/skW3AZ6uGd) for help, sharing feedback and talking to the community.\n* 📖 [Check out our documentation](https://docs.restate.dev) to get quickly started!\n* 📣 [Follow us on Twitter](https://twitter.com/restatedev) for staying up to date.\n* 🙋 [Create a GitHub issue](https://github.com/restatedev/sdk-typescript/issues) for requesting a new feature or reporting a problem.\n* 🏠 [Visit our GitHub org](https://github.com/restatedev) for exploring other repositories.\n\n## Using the SDK\n\nPrerequisites:\n- [NodeJS](https://nodejs.org/en/) \u003e= v20.19 or [Bun](https://bun.sh/docs/installation) or [Deno](https://deno.land/#installation)\n- [npm CLI](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) \u003e= 9.6.7\n\nTo use this SDK, add the dependency to your project:\n```shell\nnpm install @restatedev/restate-sdk\n```\n\nFor brand-new projects, we recommend using the [Restate Node Template](https://github.com/restatedev/node-template-generator):\n```shell\nnpx -y @restatedev/create-app@latest\n```\n\nCheck the [Quickstart](https://docs.restate.dev/get_started/quickstart) for more info.\n\n## Versions\n\nThis library follows [Semantic Versioning](https://semver.org/).\n\nThe compatibility with Restate is described in the following table:\n\n| Restate Server\\sdk-typescript | \u003c= 1.4           | 1.5 - 1.6 | 1.7 - 1.8        | 1.9 - 1.10       |\n|-------------------------------|------------------|-----------|------------------|------------------|\n| \u003c= 1.2                        | ✅                | ❌         | ❌                | ❌                |\n| 1.3                           | ✅                | ✅         | ✅ \u003csup\u003e(1)\u003c/sup\u003e | ✅ \u003csup\u003e(2)\u003c/sup\u003e |\n| 1.4                           | ✅                | ✅         | ✅                | ✅ \u003csup\u003e(2)\u003c/sup\u003e |\n| 1.5                           | ⚠ \u003csup\u003e(3)\u003c/sup\u003e | ✅         | ✅                | ✅                |\n\n\u003csup\u003e(1)\u003c/sup\u003e **Note** the new `options` in service/object/workflow constructors, together with some of the new options in the `handler`s too, work only from Restate 1.4 onward. Check the in-code documentation for more details.\n\n\u003csup\u003e(2)\u003c/sup\u003e **Note** the new `options.retryPolicy` work only from Restate 1.5 onward. Check the in-code documentation for more details.\n\n\u003csup\u003e(3)\u003c/sup\u003e **Warning** SDK versions \u003c= 1.4 are deprecated, and cannot be registered anymore. Check the [Restate 1.5 release notes](https://github.com/restatedev/restate/releases/tag/v1.5.0) for more info.\n\n## Contributing\n\nWe’re excited if you join the Restate community and start contributing!\nWhether it is feature requests, bug reports, ideas \u0026 feedback or PRs, we appreciate any and all contributions.\nWe know that your time is precious and, therefore, deeply value any effort to contribute!\n\nFor more info about developing the SDK, check the [development guide](DEVELOPMENT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frestatedev%2Fsdk-typescript","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frestatedev%2Fsdk-typescript","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frestatedev%2Fsdk-typescript/lists"}