Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
SQLSchemaMigration
✓ import { SQLSchemaMigration } from 'durable-utils/sql-migrations'
✗ import { SQLSchemaMigration } from 'durable-utils'
Exported from subpath 'durable-utils/sql-migrations', not package root.
SQLSchemaMigrations
✓ import { SQLSchemaMigrations } from 'durable-utils/sql-migrations'
✗ const { SQLSchemaMigrations } = require('durable-utils/sql-migrations')
Package is ESM-only; CommonJS require not supported.
StaticShardedDO
✓ import { StaticShardedDO } from 'durable-utils/sharded-do'
✗ import { StaticShardedDO } from 'durable-utils'
Exported from 'durable-utils/sharded-do', not package root.
retry
✓ import { retry } from 'durable-utils/retry'
✗ import { retry } from 'durable-utils'
Retry utilities in subpath 'durable-utils/retry'.
Shows how to define SQL migrations and use SQLSchemaMigrations in a Durable Object.
import { SQLSchemaMigration, SQLSchemaMigrations } from 'durable-utils/sql-migrations';
const migrations: SQLSchemaMigration[] = [
{ idMonotonicInc: 1, description: 'init', sql: 'CREATE TABLE IF NOT EXISTS users (id TEXT PRIMARY KEY, name TEXT);' },
{ idMonotonicInc: 2, description: 'add email', sql: 'ALTER TABLE users ADD email TEXT;' },
];
export class MyDO extends DurableObject {
private sql: SqlStorage;
private migrator: SQLSchemaMigrations;
constructor(ctx: DurableObjectState, env: Env) {
super(ctx, env);
this.sql = ctx.storage.sql;
this.migrator = new SQLSchemaMigrations({ doStorage: ctx.storage, migrations });
}
async handleRequest() {
await this.migrator.runAll();
return this.sql.exec('SELECT * FROM users;').toArray();
}
}
Errors
Common errors & fixes
Cannot find module 'durable-utils' or its corresponding type declarations.
Importing from package root instead of subpath.
fixUse specific subpath imports, e.g., 'durable-utils/sql-migrations'.
ERR_REQUIRE_ESM: require() of ES Module ... not supported.
Package is ESM-only, CommonJS require not supported.
fixUse dynamic import() or convert project to ESM, e.g., "type": "module" in package.json.
Audit
Dependencies
No dependency data recorded yet.