> There is Brayden's elegant Alarm class but it's not documented, and by default requires your DO ex

There is Brayden's elegant Alarm class but it's not documented, and by default requires your DO extend the Actor base class unless you duplicate what that base class does manually.

You actually don't need the Actor base class. I am a fan of toolkits personally, so we tried ~~most~~ some of the functionality in the

actors

actors

package to make it available on its own, only depending on the

ctx.storage

ctx.storage

of SQLite Durable Objects.

See example in https://github.com/cloudflare/actors/blob/e910e86ac1567fe58e389d1938afbdf1e53750ff/examples/durable-objects/src/index.ts#L21

export class MyDurableObject extends DurableObject<Env> {
    storage: Storage;
    alarms: Alarms<this>;
    
    constructor(ctx: DurableObjectState, env: Env) {
        super(ctx, env)
        this.storage = new Storage(ctx.storage);
        this.alarms = new Alarms(ctx, this);
    }
    ...
}

export class MyDurableObject extends DurableObject<Env> {
    storage: Storage;
    alarms: Alarms<this>;
    
    constructor(ctx: DurableObjectState, env: Env) {
        super(ctx, env)
        this.storage = new Storage(ctx.storage);
        this.alarms = new Alarms(ctx, this);
    }
    ...
}

Same goes for the SQL Schema migrations, you can use them without the Actor base class, and retry utilities too.

Llambrospetrou > There is Brayden's elegant Alarm class but it's not documented, and by default...

lambrospetrouOP•11/2/25, 5:10 PM

And yes, we need to document the whole package better. It's coming.

NNeed_Not too bad there is no way to set multiple alarms. I want an alarm for additional w...

Larry•11/2/25, 6:05 PM

Here are the docs. This is the one that shows you the same thing that Lambros just did, namely how to do without extending Actor, but it has API usage docs also: https://lumenize.com/docs/actors/alarms/plain-usage

This is the same thing but using the Actor class: https://lumenize.com/docs/actors/alarms/basic-usage

Larry•11/2/25, 6:54 PM

Apologies for the doc-test format. I realize the testing foo sorta gets in the way of the key stuff. It's just the quickest way for me to write docs that I know are correct. I'll come back with more concise ones some time later.

Larry•11/3/25, 5:28 AM

BTW, this was a fun exercise. I learned more about Actors and how it implements Alarms. I also learned that testing alarms is less than ideal in

cloudflare:test

cloudflare:test

runDurableObjectAlarm

runDurableObjectAlarm

, so I spent the rest of the day adding alarm testing support to @lumenize/testing, which requires no manual triggering of alarms. I switched the docs linked above over to using it so there is about half the boilerplate that there was before.

plgingras88•11/3/25, 11:52 AM

Unsure if this kind of topic is welcome here, but have you heard about Rivet, which presents itself like the "open source durable object" with many more features and platform agnostic ? Imagine durable object but no lock-in, no worker limitation (128Mb ram, V8 isolate, etc.), but with other features like local sync first, workflows, background jobs, rate limiting. This is not a 1:1 comparison, both have their own pros and cons, but this can be hosted anywhere, from personnal VPS to Cloudflare workers/do too. I believe (and mostly hope) this is the kind of new project that makes CF less unique and will trigger their fire team to work on missing features.

https://www.rivet.dev/

Rivet

Rivet - Build and scale stateful workloads

Rivet is a library for long-lived processes with durable state, realtime, and scalability. Easily self-hostable and works with your infrastructure.

Pplgingras88 Unsure if this kind of topic is welcome here, but have you heard about Rivet, wh...

lambrospetrouOP•11/3/25, 12:42 PM

Have you tried it, though? What worked better for you vs CF DOs, or worse?

Llambrospetrou Have you tried it, though? What worked better for you vs CF DOs, or worse?

plgingras88•11/3/25, 1:24 PM

I haven't yet, I just started to follow the project few weeks ago. This surely is on my bucket list whenever I get a chance. They also provide a cloud hosted solution, this may be a simple start to play with it, while I do not know anything about the cloud providers and architecture behind (e.g. : is this local disk like DOs, etc).

plgingras88•11/3/25, 1:26 PM

What I find interesting, out of the lock-in, is that I am not restreined to a middle-man worker and I could host actors on a dedicated servers with tons of CPU and RAM, where worker blocks me at 128Mb and reserves the right to share 2 instances on the same behind the scene.

Pplgingras88 What I find interesting, out of the lock-in, is that I am not restreined to a mi...

lambrospetrouOP•11/3/25, 1:27 PM

Self-hosting is a different game though.

plgingras88•11/3/25, 1:28 PM

Of course, but they also offer a cloud solution or even using CloudFlare and Durable objects under the hood. At the end of the day, the portability is yours to chose.

plgingras88•11/3/25, 1:29 PM

My point is, in all respect, if what they promise is right and they succeed the way they are rushing right now, Cloudflare durable objects may become the blackberry of their iphone.

Pplgingras88 My point is, in all respect, if what they promise is right and they succeed the ...

João Castro•11/3/25, 2:18 PM

Its very rare that you see competition taking over in a sweep like it happened there, and this does not look like a paradigm shift, just some welcome competition in the space

Pplgingras88 Of course, but they also offer a cloud solution or even using CloudFlare and Dur...

Larry•11/3/25, 2:35 PM

using CloudFlare and Durable objects under the hood

The notion of "write once deploy anywhere" is appealing but it's extremely challenging from many dimensions (performance, DX, etc.). Think of it as a tradeoff between portability and avoiding leaky abstractions. This would be super-leaky and it would always lag DO features.

History is littered with these sort of things that sound great at first but get in the way more than help: The Serverless Framework, SDN (software-defined network), ORMs to a degree, Xamarin (although it pivoted and became .NET 2.x+), AWS Event Bridge, Azure Event Grid, etc.

I was a consultant for a huge project at Intuit to define their own least common denominator programming language that would compile down to Java or .NET. It took years and while they were trying to make it work well, they didn't release any new products and few new features because everyone was ordered to use this new programming language and it was always a few months from being ready. In the end, they gave up but they never got back those 2-3 years of wasted effort and near zero feature velocity.

That tamed my desire for portability, and I'm much happier because of it.

João Castro•11/3/25, 2:44 PM

Also choosing a product goes beyond one specific feature. Trust for example (both in terms of cybersecurity and longevity of the product/company) can play a big role. One of the biggest reasons I like Cloudflare as a platform is because of the direction that it goes towards and the team behind it rather than one specific thing that I like or dislike, because I think this is more likely to provide consistent value over time

João Castro•11/3/25, 2:48 PM

Its very easy to make something better in a single dimension, but designing it to be great as a whole package is very hard

JJoão Castro Also choosing a product goes beyond one specific feature. Trust for example (bot...

Larry•11/3/25, 2:50 PM

I love the way you think

plgingras88•11/3/25, 3:27 PM

Absolutely — I agree with much of what’s been said. Cloudflare DOs bring strong advantages, such as automatic geo-routing to the nearest instance, security, infra, and more. Rivet, on the other hand, gives you the flexibility to stay within that ecosystem or branch out to other platforms to overcome limitations like tight resource caps or vendor lock-in.

What really stands out is Rivet’s clean API and documentation. It’s impressive, offering several capabilities Cloudflare doesn’t (at least not yet). Rivet won’t replace DOs anytime soon, but projects like this are healthy for the ecosystem. Brayden built Outerbase and it pushed the industry forward, to everyone’s benefit. While I don’t expect Rivet to follow the exact same trajectory, I do think it sends a strong message that should motivate the DO team to address current constraints and refine their trade-offs.

plgingras88•11/3/25, 3:37 PM

Also, i see Rivet like Better-auth. This kind of project can be surprising despite being handled by few people. Great new projects take lessons from existing solutions and get the best out of them without dragging their debts.

Burrito•11/3/25, 4:09 PM

Idk about the trust tbh. With Cloudflare, it seems like you are just one failed payment away from having your account locked and getting stuck in support limbo.

ALECKS•11/3/25, 5:20 PM

How are people managing external DB connections in DO's... specifically, I'm really struggling to find a clean pattern of when/where to close db connections (for ex to Postgres)
Initially I thought I'd just get away with connecting at the start of a request/rpc, and disconnecting at the end. But this can get pretty messy (if there are a lot of early returns / throws, your code gets peppered with disconnect calls. Sure you can wrap in a parent fn, but still feels ugly).
Ideally I could use a pool, keep it open to serve multiple (possibly concurrent) requests, but I have no idea when to close it. This is where an eviction/hibernation hook would come in handy.

Anyone have any good patterns here?

AALECKS How are people managing external DB connections in DO's... specifically, I'm rea...

Hard@Work•11/3/25, 5:24 PM

I would use Hyperdrive

Cloudflare Docs

Hyperdrive

Hyperdrive is a service that accelerates queries you make to existing databases, making it faster to access your data from across the globe from Cloudflare Workers, irrespective of your users' location.

HHard@Work I would use [Hyperdrive](https://developers.cloudflare.com/hyperdrive)

ALECKS•11/3/25, 5:25 PM

I am, but I don't see how this solves my issue. as far as my code is concerned, HD just gives me a connectionString. I still need to have the pg driver connect/disconnect, no?

ALECKS•11/3/25, 5:25 PM

unless you're saying with HD, I don't need to explicityly disconnect, which would be something.

AALECKS unless you're saying with HD, I don't need to explicityly disconnect, which woul...

Hard@Work•11/3/25, 5:26 PM

Yeah, since the connection is within the runtime, IIRC the connection is just terminated automatically, and the pool doesn't disconnect

Hard@Work•11/3/25, 5:26 PM

Not sure if I worded that right, sec

Hard@Work•11/3/25, 5:27 PM

Basically, with Hyperdrive, you don't need to disconnect manually, since you are connected to the Hyperdrive pool, not directly to your Database.

ALECKS•11/3/25, 5:28 PM

Yes I understand the actual db is not involved here, I'm specifically talking about the connection from worker/do to Hyperdrive.

ALECKS•11/3/25, 5:28 PM

Are there docs anywhere that say you don't need to disconnect a db driver from Hyperdrive?

AALECKS Are there docs anywhere that say you don't need to disconnect a db driver from H...

Hard@Work•11/3/25, 5:31 PM

Maybe try in #hyperdrive

redsquare•11/3/25, 6:59 PM

I am getting a 500 when trying to use the data studio, the same sql works fine when I run it inside the DO "SELECT * FROM sqlite_master"

KKam I have some durable objects that run an alarm on a minute by minute cadence. I h...

Larry•11/3/25, 7:50 PM

Re set it in the constructor. That will get called next time it's accessed after the deploy.

Justin Schroeder•11/3/25, 8:21 PM

I want to publish an npm package for use in cloudflare projects that includes a pre-written durable object. End users would install the package, add a couple lines to their

wrangler.jsonc

wrangler.jsonc

(unless there is a magic way to not do this step) — and viola they have this particular durable object working.

I have 2 questions:

This import
```
import { DurableObject } from "cloudflare:workers";
```
```
import { DurableObject } from "cloudflare:workers";
```
assumes
```
cloudflare:workers
```
```
cloudflare:workers
```
can be resolved, but of course that is only importable with a build tool like vite. Should I bundle cloudflare:workers as an internal dependency? What would the CF team recommend?
How does the
```
class_name
```
```
class_name
```
property of wrangler's config work? Can it resolve a class that is in a dependency?

KKam Thanks Larry, I had considered something along those lines. Wouldn't that requir...

Larry•11/3/25, 8:24 PM

True. I hadn't thought of that. What if you set the new alarm at the beginning of your handler for the current alarm instead of at the end?

JJustin Schroeder I want to publish an npm package for use in cloudflare projects that includes a ...

Kevin•11/3/25, 8:38 PM

cloudflare:workers

cloudflare:workers

comes from

worker-configuration.d.ts

worker-configuration.d.ts

file that gets generated from config using

npx wrangler types

npx wrangler types

. Durable object is just a typescript class that you import to your project and add to your wrangler config.

Justin Schroeder•11/3/25, 8:40 PM

thats where typescript gets it, but it has a concrete implementation too doesnt it?

Kevin•11/3/25, 8:44 PM

I don't know the details about the runtime but since class_name must be the name of the class I guess thats how they know it.

JJustin Schroeder I want to publish an npm package for use in cloudflare projects that includes a ...

Hard@Work•11/3/25, 8:46 PM

You should mark it as an external dependency. Treat it like imports to

node:

node:

-prefixed packages

HHard@Work You should mark it as an external dependency. Treat it like imports to `node:`-p...

Justin Schroeder•11/3/25, 8:49 PM

Thanks, will do. As for the

class_name

class_name

property in the config, how does that resolve to the actual class? Seems a bit magical — would love to understand that part more.

JJustin Schroeder Thanks, will do. As for the `class_name` property in the config, how does that r...

Hard@Work•11/3/25, 8:53 PM

It's the name of the export in the Worker's

main

main

file. So for example, if your package exports a DO named

SuperDO

SuperDO

, it would look something like this:

// src/index.ts, or whatever their main file is
export { SuperDO } from "justin_utils"; // class_name: SuperDO
export { SuperDO as MyMadeUpDOClassName } from "justin_utils"; // class_name: MyMadeUpDOClassName

// src/index.ts, or whatever their main file is
export { SuperDO } from "justin_utils"; // class_name: SuperDO
export { SuperDO as MyMadeUpDOClassName } from "justin_utils"; // class_name: MyMadeUpDOClassName

Justin Schroeder•11/3/25, 9:26 PM

ok excellent. thank you for that clarification

Justin Schroeder•11/3/25, 9:27 PM

Last question (for now

) is there any way to "extend" a

wrangler.jsonc

wrangler.jsonc

from some base — sort of like a

tsconfig.json

tsconfig.json

JJustin Schroeder Last question (for now 😂) is there any way to "extend" a `wrangler.jsonc` from ...

Hard@Work•11/3/25, 9:32 PM

No, there is not

1984 Ford Laser•11/3/25, 11:00 PM

I just got the following warning in a Worker that creates a bunch of DO stubs in quick succession (and doesn't explicitly dispose of them). My understanding from reading the docs was that the disposal is technically optional as the runtime will do its best to dispose of them when necessary. Is there a certain limit I'm hitting where I need to start explicitly disposing?

An RPC stub was not disposed properly. You must call dispose() on all stubs in order to let the other side know that you are no longer using them. You cannot rely on the garbage collector for this because it may take arbitrarily long before actually collecting unreachable objects. As a shortcut, calling dispose() on the result of an RPC call disposes all stubs within it.

An RPC stub was not disposed properly. You must call dispose() on all stubs in order to let the other side know that you are no longer using them. You cannot rely on the garbage collector for this because it may take arbitrarily long before actually collecting unreachable objects. As a shortcut, calling dispose() on the result of an RPC call disposes all stubs within it.

11984 Ford Laser I just got the following warning in a Worker that creates a bunch of DO stubs in...

Larry•11/3/25, 11:48 PM

If you use

using

using

, the local resource is disposed but not the remote one. This is worrisome because it keeps the remote in wall clock billing mode. I don't think it matters, but I'm curious, are you doing DO to DO or are you using RpcTarget on the caller side?

LLarry If you use `using`, the local resource is disposed but not the remote one. This ...

1984 Ford Laser•11/3/25, 11:52 PM

It's RpcTarget but I definitely don't use

using

using

. Lemme add that in and see how I go

1984 Ford Laser•11/3/25, 11:53 PM

In this specific case it's only a single RPC call too so it doesn't even need to be a full stub necessarily. My VsCode autocomplete just does its own thing

HHard@Work You should mark it as an external dependency. Treat it like imports to `node:`-p...

Larry•11/3/25, 11:53 PM

I don't do this and it still seems to work. Where are you saying to specify this and how? I've never done it for a node:* dependency either, but my plain node packages go back to before they had node:*, I think.