@teeny.dev/durable

Overview

@teeny.dev/durable is a library designed to simplify the management of Durable Objects in Cloudflare Workers. It provides utilities for creating typed storage and alarm management within Durable Objects.

Installation

To install the package, use npm:

``sh
npm install @teeny.dev/durable
`

Usage

$3

The createTypedStorage function allows you to create a typed storage interface for your Durable Object.

`ts
import {createTypedStorage} from '@teeny.dev/durable'
import {z} from 'zod'

const MetaSchema = z.object({
feedUrl: z.string(),
})
const BlogSchema = z.object({
title: z.string(),
description: z.string(),
id: z.string(),
})

class FeedStorage extends DurableObject {
storage

constructor(state: DurableObjectState, env: Env) {
super(state, env)
this.storage = createTypedStorage(state.storage, {
meta: MetaSchema,
blog: BlogSchema,
})
}

// Usage:
createBlogPost(title: string, description: string) {
const id = crypto.randomUUID()
await this.storage.blog.put(id, {title, description, id})
}
}
`

$3

The createAlarmManager function helps you manage alarms within your Durable Object.

`ts
import {createAlarmManager} from '@teeny.dev/durable'
import {z} from 'zod'

const AlarmSchema = z.object({url: z.string()})
class FeedStorage extends DurableObject {
alarm: AlarmManager

constructor(state: DurableObjectState, env: Env) {
super(state, env)
this.alarm = createAlarmManager({
storage: state.storage,
payloadParser: AlarmSchema,
async handler(ctx) {},
})
}

// Usage:
createFeedSubscription(feedUrl: string) {
await this.alarm.scheduleEvery(24 60 60 * 1000, {url: feedUrl})
}
}
`

$3

The prepareSqlite utility allows you to manage SQL migrations and add typing to statements within your Durable Object.

`ts
import {prepareSqlite} from '@teeny.dev/durable'

class FeedStorage extends DurableObject {
sql
constructor(ctx: DurableObjectState, env: Env) {
super(ctx, env)
this.sql = prepareSqlite(inst.ctx, {
migrations: {
['001_initalize']: [
'CREATE TABLE pasta (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT)',
'INSERT INTO pasta (name, key) VALUES ("spaghetti"), ("fettuccine")',
],
['002_add_tastyness']: {
description: 'Add tastyness column and insert more recommendations',
commands: [
'ALTER TABLE pasta ADD tastyness INTEGER NOT NULL DEFAULT -1',
'INSERT INTO pasta (name, tastyness) VALUES ("angel hair", 7)',
],
},
},
statements: {
getAllPasta: 'SELECT * FROM pasta',
getPastaCount: stmt<{'count()': number}>('SELECT count() FROM pasta'),
getPastaByNameAndTastyness: stmt<
{name: string; tastyness: number},
[number, string]
>('SELECT * FROM pasta WHERE tastyness = ? AND name = ?'),
},
})
}

findPasta(args: {name: string; tastyness: number}) {
return this.sql.getPastaByNameAndTastyness(args.tastyness, args.name)
}
}
`

Internal

$3

This package uses Vitest for testing. You can run the tests using the following commands:

`sh
npm run test:types
npm run test:vitest
`

$3

- gen:wrangler: Generate Wrangler types.
- build: Build the project using tsup.
- test:types: Run TypeScript type checks.
- test:vitest: Run tests using Vitest.
- test: Run both type checks and tests.
- release`: Release the package using release-it.

$3