mcp-usage-control-cloudflare 1.0.0

package/dist/schema.js

@@ -0,0 +1,265 @@
+export const CLOUDFLARE_USAGE_SCHEMA_VERSION = 3;
+const SCHEMA_TABLE = 'usage_control_schema';
+const BUDGETS_TABLE = 'budgets';
+const RESERVATIONS_TABLE = 'reservations';
+const RESERVATION_GROWTH_TABLE = 'reservation_growth';
+const RESERVATION_VECTORS_TABLE = 'reservation_vectors';
+const ACTIVE_EXPIRY_INDEX = 'reservations_active_expiry';
+const TOMBSTONE_EXPIRY_INDEX = 'reservations_tombstone_expiry';
+const BUDGET_COLUMNS = [
+    { name: 'id', type: 'TEXT', notNull: false, primaryKey: 1 },
+    { name: 'used', type: 'INTEGER', notNull: true, primaryKey: 0 },
+];
+const RESERVATION_COLUMNS = [
+    { name: 'id', type: 'TEXT', notNull: false, primaryKey: 1 },
+    { name: 'state', type: 'TEXT', notNull: true, primaryKey: 0 },
+    { name: 'reserved_units', type: 'INTEGER', notNull: true, primaryKey: 0 },
+    { name: 'expires_at', type: 'INTEGER', notNull: true, primaryKey: 0 },
+    { name: 'actual_units', type: 'INTEGER', notNull: false, primaryKey: 0 },
+    { name: 'outcome_hash', type: 'TEXT', notNull: false, primaryKey: 0 },
+    { name: 'terminal_reason', type: 'TEXT', notNull: false, primaryKey: 0 },
+    { name: 'tombstone_expires_at', type: 'INTEGER', notNull: false, primaryKey: 0 },
+    { name: 'budget_ids_json', type: 'TEXT', notNull: true, primaryKey: 0 },
+];
+const RESERVATION_GROWTH_COLUMNS = [
+    { name: 'reservation_id', type: 'TEXT', notNull: false, primaryKey: 1 },
+    { name: 'growth_cursor', type: 'TEXT', notNull: true, primaryKey: 0 },
+    { name: 'last_growth_json', type: 'TEXT', notNull: false, primaryKey: 0 },
+];
+const RESERVATION_VECTOR_COLUMNS = [
+    { name: 'reservation_id', type: 'TEXT', notNull: false, primaryKey: 1 },
+    { name: 'dimensions_json', type: 'TEXT', notNull: true, primaryKey: 0 },
+    { name: 'actual_dimensions_json', type: 'TEXT', notNull: false, primaryKey: 0 },
+    { name: 'last_vector_growth_json', type: 'TEXT', notNull: false, primaryKey: 0 },
+];
+/**
+ * Initializes or validates the Cloudflare SQLite schema as one synchronous
+ * transaction. The first versioned release adopts the exact pre-versioning
+ * schema as v1 without rewriting accounting rows.
+ */
+export function initializeCloudflareUsageSchema(storage) {
+    storage.transactionSync(() => {
+        createSchemaTable(storage);
+        const version = readSchemaVersion(storage);
+        if (version === undefined) {
+            adoptOrCreateV1(storage);
+            migrateV1ToV2(storage);
+            migrateV2ToV3(storage);
+            storage.sql.exec(`INSERT INTO ${SCHEMA_TABLE} (id, version) VALUES (1, ?)`, CLOUDFLARE_USAGE_SCHEMA_VERSION);
+            validateV3(storage);
+            return;
+        }
+        if (version > CLOUDFLARE_USAGE_SCHEMA_VERSION) {
+            throw new Error(`Unsupported Cloudflare usage schema version ${version}; ` +
+                `runtime supports up to ${CLOUDFLARE_USAGE_SCHEMA_VERSION}`);
+        }
+        if (version === 1) {
+            validateV1(storage, { allowMissingIndexes: false });
+            migrateV1ToV2(storage);
+            migrateV2ToV3(storage);
+            storage.sql.exec(`UPDATE ${SCHEMA_TABLE} SET version = ? WHERE id = 1`, 3);
+            validateV3(storage);
+            return;
+        }
+        if (version === 2) {
+            validateV2(storage);
+            migrateV2ToV3(storage);
+            storage.sql.exec(`UPDATE ${SCHEMA_TABLE} SET version = ? WHERE id = 1`, 3);
+            validateV3(storage);
+            return;
+        }
+        validateV3(storage);
+    });
+}
+export function readCloudflareUsageSchemaVersion(storage) {
+    return readSchemaVersion(storage);
+}
+function createSchemaTable(storage) {
+    storage.sql.exec(`
+    CREATE TABLE IF NOT EXISTS ${SCHEMA_TABLE} (
+      id INTEGER PRIMARY KEY CHECK (id = 1),
+      version INTEGER NOT NULL CHECK (version >= 1)
+    );
+  `);
+}
+function readSchemaVersion(storage) {
+    const rows = storage.sql
+        .exec(`SELECT id, version FROM ${SCHEMA_TABLE}`)
+        .toArray();
+    if (rows.length === 0)
+        return undefined;
+    if (rows.length !== 1)
+        throw new Error('Invalid Cloudflare usage schema metadata');
+    const row = rows[0];
+    if (!row || integer(row.id, 'schema id') !== 1) {
+        throw new Error('Invalid Cloudflare usage schema metadata');
+    }
+    const version = integer(row.version, 'schema version');
+    if (version < 1)
+        throw new Error('Invalid Cloudflare usage schema version');
+    return version;
+}
+function adoptOrCreateV1(storage) {
+    const objects = applicationTables(storage);
+    const hasBudgets = objects.has(BUDGETS_TABLE);
+    const hasReservations = objects.has(RESERVATIONS_TABLE);
+    if (!hasBudgets && !hasReservations) {
+        createV1Tables(storage);
+        createV1Indexes(storage);
+        validateV1(storage, { allowMissingIndexes: false });
+        return;
+    }
+    if (!hasBudgets || !hasReservations) {
+        throw new Error('Incompatible unversioned Cloudflare usage schema: expected both budgets and reservations tables');
+    }
+    // This is the exact schema shipped before explicit versioning. Validate it
+    // before adding the v1 marker so unknown/partial layouts never get adopted.
+    validateV1(storage, { allowMissingIndexes: true });
+    createV1Indexes(storage);
+    validateV1(storage, { allowMissingIndexes: false });
+}
+function createV1Tables(storage) {
+    storage.sql.exec(`
+    CREATE TABLE ${BUDGETS_TABLE} (
+      id TEXT PRIMARY KEY,
+      used INTEGER NOT NULL CHECK (used >= 0)
+    );
+  `);
+    storage.sql.exec(`
+    CREATE TABLE ${RESERVATIONS_TABLE} (
+      id TEXT PRIMARY KEY,
+      state TEXT NOT NULL CHECK (state IN ('pending', 'liable', 'settled')),
+      reserved_units INTEGER NOT NULL CHECK (reserved_units >= 0),
+      expires_at INTEGER NOT NULL,
+      actual_units INTEGER,
+      outcome_hash TEXT,
+      terminal_reason TEXT,
+      tombstone_expires_at INTEGER,
+      budget_ids_json TEXT NOT NULL
+    );
+  `);
+}
+function createV1Indexes(storage) {
+    storage.sql.exec(`CREATE INDEX IF NOT EXISTS ${ACTIVE_EXPIRY_INDEX}
+     ON ${RESERVATIONS_TABLE}(state, expires_at)`);
+    storage.sql.exec(`CREATE INDEX IF NOT EXISTS ${TOMBSTONE_EXPIRY_INDEX}
+     ON ${RESERVATIONS_TABLE}(state, tombstone_expires_at)`);
+}
+function migrateV1ToV2(storage) {
+    storage.sql.exec(`
+    CREATE TABLE IF NOT EXISTS ${RESERVATION_GROWTH_TABLE} (
+      reservation_id TEXT PRIMARY KEY,
+      growth_cursor TEXT NOT NULL,
+      last_growth_json TEXT
+    );
+  `);
+}
+function validateV2(storage) {
+    validateV1(storage, { allowMissingIndexes: false });
+    const objects = applicationTables(storage);
+    if (!objects.has(RESERVATION_GROWTH_TABLE)) {
+        throw new Error('Cloudflare usage schema v2 is missing reservation_growth');
+    }
+    validateColumns(storage, RESERVATION_GROWTH_TABLE, RESERVATION_GROWTH_COLUMNS);
+}
+function migrateV2ToV3(storage) {
+    storage.sql.exec(`
+    CREATE TABLE IF NOT EXISTS ${RESERVATION_VECTORS_TABLE} (
+      reservation_id TEXT PRIMARY KEY,
+      dimensions_json TEXT NOT NULL,
+      actual_dimensions_json TEXT,
+      last_vector_growth_json TEXT
+    );
+  `);
+}
+function validateV3(storage) {
+    validateV2(storage);
+    const objects = applicationTables(storage);
+    if (!objects.has(RESERVATION_VECTORS_TABLE)) {
+        throw new Error('Cloudflare usage schema v3 is missing reservation_vectors');
+    }
+    validateColumns(storage, RESERVATION_VECTORS_TABLE, RESERVATION_VECTOR_COLUMNS);
+}
+function validateV1(storage, options) {
+    const objects = applicationTables(storage);
+    if (!objects.has(BUDGETS_TABLE) || !objects.has(RESERVATIONS_TABLE)) {
+        throw new Error('Cloudflare usage schema v1 is missing required tables');
+    }
+    validateColumns(storage, BUDGETS_TABLE, BUDGET_COLUMNS);
+    validateColumns(storage, RESERVATIONS_TABLE, RESERVATION_COLUMNS);
+    const budgetsSql = objectSql(objects, BUDGETS_TABLE);
+    requireSqlFragment(budgetsSql, 'check(used>=0)', BUDGETS_TABLE);
+    const reservationsSql = objectSql(objects, RESERVATIONS_TABLE);
+    requireSqlFragment(reservationsSql, "check(statein('pending','liable','settled'))", RESERVATIONS_TABLE);
+    requireSqlFragment(reservationsSql, 'check(reserved_units>=0)', RESERVATIONS_TABLE);
+    validateIndex(storage, ACTIVE_EXPIRY_INDEX, 'onreservations(state,expires_at)', options.allowMissingIndexes);
+    validateIndex(storage, TOMBSTONE_EXPIRY_INDEX, 'onreservations(state,tombstone_expires_at)', options.allowMissingIndexes);
+}
+function applicationTables(storage) {
+    const rows = storage.sql
+        .exec(`SELECT name, type, sql FROM sqlite_master
+       WHERE type = 'table' AND name IN (?, ?, ?, ?)`, BUDGETS_TABLE, RESERVATIONS_TABLE, RESERVATION_GROWTH_TABLE, RESERVATION_VECTORS_TABLE)
+        .toArray();
+    return new Map(rows.map(row => [String(row.name), row]));
+}
+function validateColumns(storage, tableName, expected) {
+    const rows = storage.sql
+        .exec(`PRAGMA table_info(${tableName})`)
+        .toArray();
+    if (rows.length !== expected.length) {
+        throw new Error(`Incompatible Cloudflare usage schema for ${tableName}: column count differs`);
+    }
+    for (let index = 0; index < expected.length; index += 1) {
+        const row = rows[index];
+        const column = expected[index];
+        if (!row || !column)
+            throw new Error(`Invalid schema metadata for ${tableName}`);
+        const name = String(row.name);
+        const type = String(row.type).toUpperCase();
+        const notNull = integer(row.notnull, `${tableName}.${name}.notnull`) === 1;
+        const primaryKey = integer(row.pk, `${tableName}.${name}.pk`);
+        if (name !== column.name ||
+            type !== column.type ||
+            notNull !== column.notNull ||
+            primaryKey !== column.primaryKey) {
+            throw new Error(`Incompatible Cloudflare usage schema for ${tableName}.${column.name}`);
+        }
+    }
+}
+function validateIndex(storage, name, requiredSqlFragment, allowMissing) {
+    const rows = storage.sql
+        .exec(`SELECT name, type, sql FROM sqlite_master WHERE type = 'index' AND name = ?`, name)
+        .toArray();
+    if (rows.length === 0) {
+        if (allowMissing)
+            return;
+        throw new Error(`Cloudflare usage schema v1 is missing index ${name}`);
+    }
+    if (rows.length !== 1)
+        throw new Error(`Invalid Cloudflare usage index metadata: ${name}`);
+    const sql = rows[0]?.sql;
+    if (typeof sql !== 'string' || !compactSql(sql).includes(requiredSqlFragment)) {
+        throw new Error(`Incompatible Cloudflare usage index ${name}`);
+    }
+}
+function objectSql(objects, name) {
+    const sql = objects.get(name)?.sql;
+    if (typeof sql !== 'string')
+        throw new Error(`Missing SQL definition for ${name}`);
+    return compactSql(sql);
+}
+function requireSqlFragment(sql, fragment, objectName) {
+    if (!sql.includes(fragment)) {
+        throw new Error(`Incompatible Cloudflare usage schema constraint for ${objectName}`);
+    }
+}
+function compactSql(sql) {
+    return sql.toLowerCase().replace(/\s+/g, '');
+}
+function integer(value, name) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
+        throw new Error(`Invalid ${name}`);
+    }
+    return value;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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"}

package/dist/versioned-worker.d.ts

@@ -0,0 +1,17 @@
+import type { DurableObjectState } from 'cloudflare:workers';
+import { type CloudflarePruneBudgetsCommand, type CloudflarePruneBudgetsReply } from './maintenance-protocol.js';
+import { type CloudflareLookupCommand, type CloudflareLookupReply } from './reconciliation-protocol.js';
+import { UsageControlDurableObject as BaseUsageControlDurableObject } from './worker.js';
+/**
+ * Public Durable Object entry point with explicit SQLite schema validation.
+ * Schema initialization runs before the legacy v1 constructor so incompatible
+ * or newer databases fail closed before any compatibility DDL can run.
+ */
+export declare class UsageControlDurableObject extends BaseUsageControlDurableObject {
+    constructor(ctx: DurableObjectState, env: unknown);
+    /** Read-only lookup for explicit lost-reserve-ACK reconciliation. */
+    lookup(command: CloudflareLookupCommand): Promise<CloudflareLookupReply>;
+    /** Explicit bounded historical budget maintenance; never infers window age. */
+    pruneBudgets(command: CloudflarePruneBudgetsCommand): Promise<CloudflarePruneBudgetsReply>;
+}
+//# sourceMappingURL=versioned-worker.d.ts.map

package/dist/versioned-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-worker.d.ts","sourceRoot":"","sources":["../src/versioned-worker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,yBAAyB,IAAI,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEzF;;;;GAIG;AACH,qBAAa,yBAA0B,SAAQ,6BAA6B;gBAC9D,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO;IAKjD,qEAAqE;IAC/D,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI9E,+EAA+E;IACzE,YAAY,CAChB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,2BAA2B,CAAC;CAGxC"}

package/dist/versioned-worker.js

@@ -0,0 +1,24 @@
+import { pruneCloudflareBudgets, } from './maintenance-protocol.js';
+import { lookupCloudflareReservation, } from './reconciliation-protocol.js';
+import { initializeCloudflareUsageSchema } from './schema.js';
+import { UsageControlDurableObject as BaseUsageControlDurableObject } from './worker.js';
+/**
+ * Public Durable Object entry point with explicit SQLite schema validation.
+ * Schema initialization runs before the legacy v1 constructor so incompatible
+ * or newer databases fail closed before any compatibility DDL can run.
+ */
+export class UsageControlDurableObject extends BaseUsageControlDurableObject {
+    constructor(ctx, env) {
+        initializeCloudflareUsageSchema(ctx.storage);
+        super(ctx, env);
+    }
+    /** Read-only lookup for explicit lost-reserve-ACK reconciliation. */
+    async lookup(command) {
+        return lookupCloudflareReservation(this.ctx.storage, command);
+    }
+    /** Explicit bounded historical budget maintenance; never infers window age. */
+    async pruneBudgets(command) {
+        return pruneCloudflareBudgets(this.ctx.storage, command);
+    }
+}
+//# sourceMappingURL=versioned-worker.js.map

package/dist/versioned-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioned-worker.js","sourceRoot":"","sources":["../src/versioned-worker.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,GAGvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,2BAA2B,GAG5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,yBAAyB,IAAI,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAEzF;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,6BAA6B;IAC1E,YAAY,GAAuB,EAAE,GAAY;QAC/C,+BAA+B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7C,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,MAAM,CAAC,OAAgC;QAC3C,OAAO,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,YAAY,CAChB,OAAsC;QAEtC,OAAO,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/worker.d.ts

@@ -0,0 +1,27 @@
+import { DurableObject, type DurableObjectState } from 'cloudflare:workers';
+import type { CloudflareGrowCommand, CloudflareGrowReply, CloudflareMarkLiableCommand, CloudflareRenewCommand, CloudflareReserveCommand, CloudflareReserveReply, CloudflareSettlementReply, CloudflareSettleCommand, CloudflareVectorGrowCommand, CloudflareVectorGrowReply, CloudflareVectorReserveCommand, CloudflareVectorReserveReply, CloudflareVectorSettleCommand, CloudflareVectorSettlementReply, CloudflareStoreEnvelope } from './index.js';
+/**
+ * SQLite-backed Durable Object implementing one atomic usage-control domain.
+ * Export this class from a Worker and declare it with storage = "sqlite".
+ */
+export declare class UsageControlDurableObject extends DurableObject<unknown> {
+    constructor(ctx: DurableObjectState, env: unknown);
+    reserve(command: CloudflareReserveCommand): Promise<CloudflareStoreEnvelope<CloudflareReserveReply>>;
+    reserveVector(command: CloudflareVectorReserveCommand): Promise<CloudflareStoreEnvelope<CloudflareVectorReserveReply>>;
+    grow(command: CloudflareGrowCommand): Promise<CloudflareStoreEnvelope<CloudflareGrowReply>>;
+    growVector(command: CloudflareVectorGrowCommand): Promise<CloudflareStoreEnvelope<CloudflareVectorGrowReply>>;
+    markLiable(command: CloudflareMarkLiableCommand): Promise<CloudflareStoreEnvelope<{
+        expiresAt: number;
+    }>>;
+    renew(command: CloudflareRenewCommand): Promise<CloudflareStoreEnvelope<{
+        expiresAt: number;
+    }>>;
+    settle(command: CloudflareSettleCommand): Promise<CloudflareStoreEnvelope<CloudflareSettlementReply>>;
+    settleVector(command: CloudflareVectorSettleCommand): Promise<CloudflareStoreEnvelope<CloudflareVectorSettlementReply>>;
+    private ensureSchema;
+    private readVectorRow;
+    private recoverExpiredBatch;
+    private recoverSpecific;
+    private recoverRow;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAEV,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAG3B,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EAEvB,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,4BAA4B,EAC5B,6BAA6B,EAC7B,+BAA+B,EAC/B,uBAAuB,EAExB,MAAM,YAAY,CAAC;AA0EpB;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,aAAa,CAAC,OAAO,CAAC;gBACvD,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO;IAK3C,OAAO,CACX,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,CAAC;IA2FrD,aAAa,CACjB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,4BAA4B,CAAC,CAAC;IA4G3D,IAAI,CACR,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;IA4HlD,UAAU,CACd,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC,yBAAyB,CAAC,CAAC;IA6JxD,UAAU,CACd,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,uBAAuB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAkCpD,KAAK,CACT,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,uBAAuB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiCpD,MAAM,CACV,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,yBAAyB,CAAC,CAAC;IAuFxD,YAAY,CAChB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,+BAA+B,CAAC,CAAC;IA6FpE,OAAO,CAAC,YAAY;IA6CpB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,mBAAmB;IA4F3B,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,UAAU;CAoGnB"}