Skip to content

Commit 6a83071

Browse files
committed
address comments
1 parent 44e5466 commit 6a83071

File tree

1 file changed

+11
-6
lines changed

1 file changed

+11
-6
lines changed

src/content/changelog/durable-objects/2025-06-25-actors-package-alpha.mdx

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,24 @@
11
---
2-
title: @cloudflare/actors library: SDK for Durable Objects in alpha
2+
title: @cloudflare/actors library: SDK for Durable Objects in beta
33
description: @cloudflare/actors library with Durable Objects helpers and patterns.
44
products:
55
- durable-objects
66
- workers
77
date: 2025-06-25T06:00:00Z
88
---
9+
The new [@cloudflare/actors](https://www.npmjs.com/package/@cloudflare/actors) library is now in beta!
910

10-
[@cloudflare/actors](https://www.npmjs.com/package/@cloudflare/actors) package is in alpha and provides a SDK for Durable Objects, in addition to Durable Objects [Workers API](https://developers.cloudflare.com/durable-objects/api/base/). "Actors" originates from the [actor programming model](/durable-objects/what-are-durable-objects/#actor-programming-model), which is a close analogy for Durable Objects.
11+
The `@cloudflare/actors` library is a new SDK for Durable Objects, and provides a powerful set of abstractions for building real-time, interactive, and multiplayer applications on top of Durable Objects even easier. With beta uasge and feedback, `@cloudflare/actors` will become the recommended way to build on Durable Objects and draws upon Cloudflare's experience building products/features on Durable Objects.
1112

12-
For alpha, `/actors` library includes:
13+
The name "actors" originates from the [actor programming model](/durable-objects/what-are-durable-objects/#actor-programming-model), which closely ties to how Durable Objects are modelled.
1314

14-
* Storage helpers for using embeddeded, per-object SQLite storage, including SQL schema migrations and query template literals
15+
The `@cloudflare/actors` library includes:
16+
17+
* Storage helpers for querying embeddeded, per-object SQLite storage
18+
* Storage helpers for managing SQL schema migrations
1519
* Alarm helpers for scheduling multiple alarms provided a date, delay in seconds, or cron expression
1620
* `Actor` class for using Durable Objects with a defined pattern
21+
* Durable Objects [Workers API](https://developers.cloudflare.com/durable-objects/api/base/) is always available for your application as needed
1722

1823
Storage and alarm helper methods can be combined with [any Javascript class](https://github.com/cloudflare/actors?tab=readme-ov-file#storage--alarms-with-durableobject-class) that defines your Durable Object, i.e, ones that extend `DurableObject` including the `Actor` class.
1924

@@ -44,7 +49,7 @@ export class ChatRoom extends DurableObject<Env> {
4449
}
4550
```
4651

47-
`/actors` library introduces the `Actor` class pattern. `Actor` lets you access Durable Objects without writing the Worker that communicates with your Durable Object (the Worker is created for you). By default, requests are routed to a Durable Object named "default".
52+
`@cloudflare/actors` library introduces the `Actor` class pattern. `Actor` lets you access Durable Objects without writing the Worker that communicates with your Durable Object (the Worker is created for you). By default, requests are routed to a Durable Object named "default".
4853

4954
```js
5055
export class MyActor extends Actor<Env> {
@@ -73,4 +78,4 @@ export class MyActor extends Actor<Env> {
7378
export default handler(MyActor);
7479
```
7580
76-
For more examples, check out the library [README](https://github.com/cloudflare/actors?tab=readme-ov-file#getting-started). `/actors` library is a place for more helpers and built-in patterns, e.g. retry handling and websocket helpers, to reduce development overhead for common Durable Objects functionality. Please share feedback and what more you would like to see on our [Discord channel](https://discord.com/channels/595317990191398933/773219443911819284).
81+
For more examples, check out the library [README](https://github.com/cloudflare/actors?tab=readme-ov-file#getting-started). `@cloudflare/actors` library is a place for more helpers and built-in patterns, like retry handling and Websocket-based applications, to reduce development overhead for common Durable Objects functionality. Please share feedback and what more you would like to see on our [Discord channel](https://discord.com/channels/595317990191398933/773219443911819284).

0 commit comments

Comments
 (0)