mcp-usage-control-cloudflare 1.0.0

package/dist/reconciliation-protocol.js

@@ -0,0 +1,97 @@
+const RESERVATION_ID_PATTERN = /^cf1\.[a-f0-9]{64}$/;
+const HASH_PATTERN = /^[a-f0-9]{64}$/;
+const LEASE_EXPIRED_REASON = 'lease_expired_after_execution_started';
+/**
+ * Read-only lookup used only for ambiguous reserve acknowledgement recovery.
+ * It does not reserve, release, renew, settle, or otherwise change quota state.
+ */
+export function lookupCloudflareReservation(storage, command, now = Date.now()) {
+    validateReservationId(command.reservationId);
+    const row = storage.sql
+        .exec(`SELECT id, state, reserved_units, expires_at, actual_units,
+              terminal_reason, tombstone_expires_at, budget_ids_json
+       FROM reservations WHERE id = ?`, command.reservationId)
+        .toArray()[0];
+    if (!row)
+        return { status: 'absent' };
+    const reservationId = String(row.id);
+    validateReservationId(reservationId);
+    const reservedUnits = integer(row.reserved_units, 'reservedUnits');
+    const budgetIds = parseBudgetIds(row.budget_ids_json);
+    const expiresAt = integer(row.expires_at, 'expiresAt');
+    if (row.state === 'pending' || row.state === 'liable') {
+        if (expiresAt <= now) {
+            return {
+                status: 'expired',
+                state: row.state,
+                reservationId,
+                reservedUnits,
+                expiredAt: expiresAt,
+                budgetIds,
+            };
+        }
+        return {
+            status: 'active',
+            state: row.state,
+            reservationId,
+            reservedUnits,
+            expiresAt,
+            budgetIds,
+        };
+    }
+    if (row.state !== 'settled')
+        throw new Error('Invalid stored reservation state');
+    if (row.terminal_reason === LEASE_EXPIRED_REASON) {
+        return {
+            status: 'expired',
+            state: 'liable',
+            reservationId,
+            reservedUnits,
+            expiredAt: expiresAt,
+            budgetIds,
+        };
+    }
+    const actualUnits = nullableInteger(row.actual_units, 'actualUnits');
+    const tombstoneExpiresAt = nullableInteger(row.tombstone_expires_at, 'tombstoneExpiresAt');
+    return {
+        status: 'settled',
+        reservationId,
+        reservedUnits,
+        actualUnits,
+        tombstoneExpiresAt,
+        budgetIds,
+    };
+}
+function validateReservationId(value) {
+    if (!RESERVATION_ID_PATTERN.test(value))
+        throw new RangeError('invalid reservationId');
+}
+function parseBudgetIds(raw) {
+    if (typeof raw !== 'string')
+        throw new Error('Invalid stored budget list');
+    let value;
+    try {
+        value = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('Invalid stored budget list');
+    }
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        !value.every(id => typeof id === 'string' && HASH_PATTERN.test(id))) {
+        throw new Error('Invalid stored budget list');
+    }
+    return value;
+}
+function integer(value, name) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value)) {
+        throw new Error(`Invalid stored ${name}`);
+    }
+    return value;
+}
+function nullableInteger(value, name) {
+    if (value === null)
+        throw new Error(`Invalid stored ${name}`);
+    return integer(value, name);
+}
+//# sourceMappingURL=reconciliation-protocol.js.map

package/dist/reconciliation-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-protocol.js","sourceRoot":"","sources":["../src/reconciliation-protocol.ts"],"names":[],"mappings":"AAEA,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AACrD,MAAM,YAAY,GAAG,gBAAgB,CAAC;AACtC,MAAM,oBAAoB,GAAG,uCAAuC,CAAC;AA4CrE;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA6B,EAC7B,OAAgC,EAChC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAEhB,qBAAqB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG;SACpB,IAAI,CACH;;sCAEgC,EAChC,OAAO,CAAC,aAAa,CACtB;SACA,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhB,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAEtC,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAEvD,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACtD,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACrB,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,aAAa;gBACb,aAAa;gBACb,SAAS,EAAE,SAAS;gBACpB,SAAS;aACV,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,aAAa;YACb,aAAa;YACb,SAAS;YACT,SAAS;SACV,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAEjF,IAAI,GAAG,CAAC,eAAe,KAAK,oBAAoB,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,QAAQ;YACf,aAAa;YACb,aAAa;YACb,SAAS,EAAE,SAAS;YACpB,SAAS;SACV,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACrE,MAAM,kBAAkB,GAAG,eAAe,CAAC,GAAG,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC;IAC3F,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,aAAa;QACb,aAAa;QACb,WAAW;QACX,kBAAkB;QAClB,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,cAAc,CAAC,GAAoB;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC3E,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EACnE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAsB,EAAE,IAAY;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,KAAsB,EAAE,IAAY;IAC3D,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;IAC9D,OAAO,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/reconciliation.d.ts

@@ -0,0 +1,19 @@
+import { type UsageOperationReconciliation, type UsageOperationReconciliationInput } from 'mcp-usage-control';
+import { type CloudflareUsageStoreGatewayOptions, type RemoteCloudflareUsageStoreOptions } from './index.js';
+export type RemoteCloudflareReconciliationOptions = Pick<RemoteCloudflareUsageStoreOptions, 'endpoint' | 'headers' | 'fetch' | 'timeoutMs'>;
+export type CloudflareReserveReconciliationInput = UsageOperationReconciliationInput;
+export type CloudflareReserveReconciliation = UsageOperationReconciliation;
+/**
+ * Drop-in gateway wrapper that preserves the normal usage-store protocol and
+ * adds one authenticated read-only `lookup` method for explicit reconciliation.
+ */
+export declare function createReconciliableCloudflareUsageStoreGateway(options: CloudflareUsageStoreGatewayOptions): (request: Request) => Promise<Response>;
+/**
+ * Reconciles one retained scalar logical operation. This function performs a
+ * single read-only lookup and never retries or creates a reservation. It is also
+ * the v0.8 generic entry point for ambiguous initial-reserve acknowledgement recovery.
+ */
+export declare function reconcileRemoteCloudflareOperation(options: RemoteCloudflareReconciliationOptions, input: UsageOperationReconciliationInput): Promise<UsageOperationReconciliation>;
+/** Backward-compatible v0.7 name for initial-reserve acknowledgement reconciliation. */
+export declare function reconcileRemoteCloudflareReserve(options: RemoteCloudflareReconciliationOptions, input: CloudflareReserveReconciliationInput): Promise<CloudflareReserveReconciliation>;
+//# sourceMappingURL=reconciliation.d.ts.map

package/dist/reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../src/reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACvC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,kCAAkC,EACvC,KAAK,iCAAiC,EACvC,MAAM,YAAY,CAAC;AAepB,MAAM,MAAM,qCAAqC,GAAG,IAAI,CACtD,iCAAiC,EACjC,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAC/C,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,iCAAiC,CAAC;AACrF,MAAM,MAAM,+BAA+B,GAAG,4BAA4B,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,8CAA8C,CAC5D,OAAO,EAAE,kCAAkC,IAgBd,SAAS,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAgDlE;AA+CD;;;;GAIG;AACH,wBAAsB,kCAAkC,CACtD,OAAO,EAAE,qCAAqC,EAC9C,KAAK,EAAE,iCAAiC,GACvC,OAAO,CAAC,4BAA4B,CAAC,CAgDvC;AAED,wFAAwF;AACxF,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,qCAAqC,EAC9C,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,+BAA+B,CAAC,CAE1C"}

package/dist/reconciliation.js

@@ -0,0 +1,402 @@
+import { UsageStateError, } from 'mcp-usage-control';
+import { CloudflareUsageTransportError, createCloudflareUsageStoreGateway, } from './index.js';
+const DEFAULT_PATH = '/v1/usage-store';
+const MAX_GATEWAY_BODY_BYTES = 65_536;
+const RESERVATION_ID_PATTERN = /^cf1\.[a-f0-9]{64}$/;
+const HASH_PATTERN = /^[a-f0-9]{64}$/;
+/**
+ * Drop-in gateway wrapper that preserves the normal usage-store protocol and
+ * adds one authenticated read-only `lookup` method for explicit reconciliation.
+ */
+export function createReconciliableCloudflareUsageStoreGateway(options) {
+    // Normal usage requests still delegate to the base gateway. Cache only a
+    // successful decision for the exact Request object so a side-effectful
+    // application authorizer is never executed twice for one request.
+    const preauthorized = new WeakSet();
+    const baseHandler = createCloudflareUsageStoreGateway({
+        ...options,
+        authorize(request) {
+            if (preauthorized.has(request))
+                return true;
+            return options.authorize(request);
+        },
+    });
+    const path = options.path ?? DEFAULT_PATH;
+    const domainName = options.domainName ?? 'default';
+    return async function handle(request) {
+        const url = new URL(request.url);
+        if (url.pathname !== path || request.method !== 'POST')
+            return baseHandler(request);
+        let authorized = false;
+        try {
+            authorized = (await options.authorize(request)) === true;
+        }
+        catch {
+            authorized = false;
+        }
+        if (!authorized)
+            return responseJson({ error: 'unauthorized' }, 401);
+        preauthorized.add(request);
+        const contentLength = Number(request.headers.get('content-length') ?? '0');
+        if (Number.isFinite(contentLength) && contentLength > MAX_GATEWAY_BODY_BYTES) {
+            return responseJson({ error: 'payload_too_large' }, 413);
+        }
+        const buffered = await readBoundedRequestText(request.clone(), MAX_GATEWAY_BODY_BYTES);
+        if (buffered.status === 'too_large') {
+            return responseJson({ error: 'payload_too_large' }, 413);
+        }
+        if (buffered.status === 'error') {
+            return responseJson({ error: 'invalid_request' }, 400);
+        }
+        let body;
+        try {
+            body = JSON.parse(buffered.text);
+        }
+        catch {
+            return responseJson({ error: 'invalid_request' }, 400);
+        }
+        if (!isLookupHttpRequest(body))
+            return baseHandler(request);
+        let stub;
+        try {
+            stub = resolveLookupStub(options.namespace, domainName);
+        }
+        catch {
+            return responseJson({ error: 'store_unavailable' }, 503);
+        }
+        try {
+            const result = await stub.lookup(body.input);
+            return responseJson({ version: 1, result }, 200);
+        }
+        catch {
+            return responseJson({ error: 'store_unavailable' }, 503);
+        }
+    };
+}
+async function readBoundedRequestText(request, maxBytes) {
+    if (!request.body)
+        return { status: 'ok', text: '' };
+    const reader = request.body.getReader();
+    const chunks = [];
+    let totalBytes = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (!value || value.byteLength === 0)
+                continue;
+            totalBytes += value.byteLength;
+            if (totalBytes > maxBytes) {
+                try {
+                    await reader.cancel();
+                }
+                catch {
+                    // Best-effort cancellation only; the response is already fail-closed.
+                }
+                return { status: 'too_large' };
+            }
+            chunks.push(value);
+        }
+    }
+    catch {
+        return { status: 'error' };
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const bytes = new Uint8Array(totalBytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return { status: 'ok', text: new TextDecoder().decode(bytes) };
+}
+/**
+ * Reconciles one retained scalar logical operation. This function performs a
+ * single read-only lookup and never retries or creates a reservation. It is also
+ * the v0.8 generic entry point for ambiguous initial-reserve acknowledgement recovery.
+ */
+export async function reconcileRemoteCloudflareOperation(options, input) {
+    const prepared = await prepareReconciliation(input);
+    const reply = await postLookup(options, prepared.reservationId);
+    if (reply.status === 'absent') {
+        return { status: 'absent', reservationId: prepared.reservationId };
+    }
+    verifyLookupIdentity(reply, prepared, input.units);
+    if (reply.status === 'active') {
+        return {
+            status: 'active',
+            state: reply.state,
+            reservation: {
+                id: prepared.reservationId,
+                operationId: input.request.operationId,
+                principalId: input.request.principal.id,
+                ...(input.request.principal.tenantId === undefined
+                    ? {}
+                    : { tenantId: input.request.principal.tenantId }),
+                ...(input.request.principal.plan === undefined
+                    ? {}
+                    : { plan: input.request.principal.plan }),
+                tool: input.request.tool,
+                budgetKeys: prepared.budgets.map(budget => budget.key),
+                reservedUnits: reply.reservedUnits,
+                expiresAt: reply.expiresAt,
+            },
+        };
+    }
+    if (reply.status === 'expired') {
+        return {
+            status: 'expired',
+            state: reply.state,
+            reservationId: prepared.reservationId,
+            expiredAt: reply.expiredAt,
+        };
+    }
+    return {
+        status: 'settled',
+        reservationId: prepared.reservationId,
+        reservedUnits: reply.reservedUnits,
+        actualUnits: reply.actualUnits,
+        tombstoneExpiresAt: reply.tombstoneExpiresAt,
+    };
+}
+/** Backward-compatible v0.7 name for initial-reserve acknowledgement reconciliation. */
+export async function reconcileRemoteCloudflareReserve(options, input) {
+    return reconcileRemoteCloudflareOperation(options, input);
+}
+async function prepareReconciliation(input) {
+    validateRequestIdentity(input.request);
+    assertNonNegativeInteger(input.units, 'units');
+    const budgets = canonicalizeBudgets(input.budgets);
+    const operationHash = await digest(JSON.stringify([
+        input.request.principal.tenantId ?? null,
+        input.request.principal.id,
+        input.request.tool,
+        input.request.operationId,
+    ]));
+    const budgetIds = await Promise.all(budgets.map(budget => digest(budget.key)));
+    return { reservationId: `cf1.${operationHash}`, budgets, budgetIds };
+}
+async function postLookup(options, reservationId) {
+    const endpoint = new URL(options.endpoint);
+    const isLocalHttp = endpoint.protocol === 'http:' &&
+        (endpoint.hostname === '127.0.0.1' || endpoint.hostname === 'localhost');
+    if (endpoint.protocol !== 'https:' && !isLocalHttp) {
+        throw new RangeError('Cloudflare usage store endpoint must use HTTPS (local HTTP is test-only)');
+    }
+    if (endpoint.username || endpoint.password) {
+        throw new RangeError('Cloudflare usage store endpoint must not embed credentials');
+    }
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    assertPositiveInteger(timeoutMs, 'timeoutMs');
+    assertPortableTimerDelay(timeoutMs, 'timeoutMs');
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        let resolvedHeaders;
+        try {
+            resolvedHeaders = await waitForAbort(resolveHeaders(options.headers), controller.signal);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CloudflareUsageTransportError('timeout');
+            throw error;
+        }
+        const headers = new Headers(resolvedHeaders);
+        headers.set('content-type', 'application/json');
+        headers.set('accept', 'application/json');
+        let response;
+        try {
+            response = await waitForAbort((options.fetch ?? fetch)(endpoint, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    version: 1,
+                    method: 'lookup',
+                    input: { reservationId },
+                }),
+                signal: controller.signal,
+            }), controller.signal);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CloudflareUsageTransportError('timeout');
+            if (error instanceof CloudflareUsageTransportError)
+                throw error;
+            throw new CloudflareUsageTransportError('network');
+        }
+        if (response.status === 401 || response.status === 403) {
+            throw new CloudflareUsageTransportError('unauthorized', response.status);
+        }
+        if (!response.ok)
+            throw new CloudflareUsageTransportError('remote', response.status);
+        let payload;
+        try {
+            payload = await waitForAbort(response.json(), controller.signal);
+        }
+        catch (error) {
+            if (controller.signal.aborted)
+                throw new CloudflareUsageTransportError('timeout');
+            if (error instanceof CloudflareUsageTransportError)
+                throw error;
+            throw new CloudflareUsageTransportError('protocol', response.status);
+        }
+        if (!isLookupHttpResponse(payload)) {
+            throw new CloudflareUsageTransportError('protocol', response.status);
+        }
+        return payload.result;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function verifyLookupIdentity(reply, prepared, units) {
+    if (reply.reservationId !== prepared.reservationId) {
+        throw new UsageStateError('Cloudflare reconciliation returned a different reservation');
+    }
+    if (reply.reservedUnits !== units) {
+        throw new UsageStateError('Cloudflare reconciliation reservedUnits did not match expected retained state');
+    }
+    if (reply.budgetIds.length !== prepared.budgetIds.length ||
+        reply.budgetIds.some((id, index) => id !== prepared.budgetIds[index])) {
+        throw new UsageStateError('Cloudflare reconciliation budgets did not match expected retained state');
+    }
+}
+function resolveLookupStub(namespace, domainName) {
+    const candidate = namespace.getByName
+        ? namespace.getByName(domainName)
+        : namespace.idFromName && namespace.get
+            ? namespace.get(namespace.idFromName(domainName))
+            : undefined;
+    if (!candidate)
+        throw new TypeError('Durable Object namespace is unavailable');
+    const lookup = candidate.lookup;
+    if (typeof lookup !== 'function') {
+        throw new TypeError('Durable Object does not expose reconciliation lookup');
+    }
+    return candidate;
+}
+function isLookupHttpRequest(value) {
+    return (isRecord(value) &&
+        value.version === 1 &&
+        value.method === 'lookup' &&
+        isRecord(value.input) &&
+        typeof value.input.reservationId === 'string' &&
+        RESERVATION_ID_PATTERN.test(value.input.reservationId));
+}
+function isLookupHttpResponse(value) {
+    return isRecord(value) && value.version === 1 && isLookupReply(value.result);
+}
+function isLookupReply(value) {
+    if (!isRecord(value) || typeof value.status !== 'string')
+        return false;
+    if (value.status === 'absent')
+        return true;
+    if (typeof value.reservationId !== 'string' ||
+        !RESERVATION_ID_PATTERN.test(value.reservationId) ||
+        !isNonNegativeInteger(value.reservedUnits) ||
+        !isHashArray(value.budgetIds)) {
+        return false;
+    }
+    if (value.status === 'active') {
+        return ((value.state === 'pending' || value.state === 'liable') &&
+            isNonNegativeInteger(value.expiresAt));
+    }
+    if (value.status === 'expired') {
+        return ((value.state === 'pending' || value.state === 'liable') &&
+            isNonNegativeInteger(value.expiredAt));
+    }
+    if (value.status === 'settled') {
+        return (isNonNegativeInteger(value.actualUnits) &&
+            isNonNegativeInteger(value.tombstoneExpiresAt));
+    }
+    return false;
+}
+function canonicalizeBudgets(budgets) {
+    if (budgets.length === 0)
+        throw new RangeError('budgets must contain at least one budget');
+    const normalized = budgets.map(budget => {
+        if (typeof budget.key !== 'string' || budget.key.length === 0) {
+            throw new RangeError('budget.key must be a non-empty string');
+        }
+        assertNonNegativeInteger(budget.limit, `budget.limit (${budget.key})`);
+        return { key: budget.key, limit: budget.limit };
+    });
+    normalized.sort((a, b) => a.key.localeCompare(b.key));
+    for (let index = 1; index < normalized.length; index += 1) {
+        if (normalized[index - 1].key === normalized[index].key) {
+            throw new RangeError(`duplicate budget key: ${normalized[index].key}`);
+        }
+    }
+    return normalized;
+}
+function validateRequestIdentity(request) {
+    if (!request.operationId)
+        throw new RangeError('operationId must be non-empty');
+    if (!request.principal.id)
+        throw new RangeError('principal.id must be non-empty');
+    if (!request.tool)
+        throw new RangeError('tool must be non-empty');
+}
+function assertNonNegativeInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new RangeError(`${name} must be a non-negative safe integer`);
+    }
+}
+function assertPortableTimerDelay(value, name) {
+    if (value > 2_147_483_647) {
+        throw new RangeError(`${name} must not exceed 2147483647ms`);
+    }
+}
+function assertPositiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive safe integer`);
+    }
+}
+function isNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isSafeInteger(value) && value >= 0;
+}
+function isHashArray(value) {
+    return Array.isArray(value) && value.length > 0 && value.every(id => typeof id === 'string' && HASH_PATTERN.test(id));
+}
+async function digest(value) {
+    const bytes = new TextEncoder().encode(value);
+    const hash = await crypto.subtle.digest('SHA-256', bytes);
+    return Array.from(new Uint8Array(hash), byte => byte.toString(16).padStart(2, '0')).join('');
+}
+async function resolveHeaders(headers) {
+    if (typeof headers === 'function')
+        return headers();
+    return headers;
+}
+function waitForAbort(promise, signal) {
+    if (signal.aborted)
+        return Promise.reject(new Error('operation aborted'));
+    return new Promise((resolve, reject) => {
+        const onAbort = () => {
+            cleanup();
+            reject(new Error('operation aborted'));
+        };
+        const cleanup = () => signal.removeEventListener('abort', onAbort);
+        signal.addEventListener('abort', onAbort, { once: true });
+        void promise.then(value => {
+            cleanup();
+            resolve(value);
+        }, error => {
+            cleanup();
+            reject(error);
+        });
+    });
+}
+function responseJson(body, status) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json; charset=utf-8' },
+    });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=reconciliation.js.map

package/dist/reconciliation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.js","sourceRoot":"","sources":["../src/reconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAKhB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,GAIlC,MAAM,YAAY,CAAC;AAMpB,MAAM,YAAY,GAAG,iBAAiB,CAAC;AACvC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AACtC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AACrD,MAAM,YAAY,GAAG,gBAAgB,CAAC;AActC;;;GAGG;AACH,MAAM,UAAU,8CAA8C,CAC5D,OAA2C;IAE3C,yEAAyE;IACzE,uEAAuE;IACvE,kEAAkE;IAClE,MAAM,aAAa,GAAG,IAAI,OAAO,EAAW,CAAC;IAC7C,MAAM,WAAW,GAAG,iCAAiC,CAAC;QACpD,GAAG,OAAO;QACV,SAAS,CAAC,OAAO;YACf,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;KACF,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,SAAS,CAAC;IAEnD,OAAO,KAAK,UAAU,MAAM,CAAC,OAAgB;QAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAEpF,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,KAAK,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,UAAU;YAAE,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,CAAC;QACrE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE3B,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,sBAAsB,EAAE,CAAC;YAC7E,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACvF,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACpC,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC;YAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAE5D,IAAI,IAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAOD,KAAK,UAAU,sBAAsB,CACnC,OAAgB,EAChB,QAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAErD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC;gBAAE,SAAS;YAC/C,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC;YAC/B,IAAI,UAAU,GAAG,QAAQ,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;gBACxB,CAAC;gBAAC,MAAM,CAAC;oBACP,sEAAsE;gBACxE,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACjC,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,OAA8C,EAC9C,KAAwC;IAExC,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEhE,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,aAAa,EAAE,CAAC;IACrE,CAAC;IAED,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEnD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,WAAW,EAAE;gBACX,EAAE,EAAE,QAAQ,CAAC,aAAa;gBAC1B,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW;gBACtC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;gBACvC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS;oBAChD,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACnD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS;oBAC5C,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBAC3C,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;gBACxB,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;gBACtD,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,OAA8C,EAC9C,KAA2C;IAE3C,OAAO,kCAAkC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC5D,CAAC;AAQD,KAAK,UAAU,qBAAqB,CAClC,KAA2C;IAE3C,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,wBAAwB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,MAAM,MAAM,CAChC,IAAI,CAAC,SAAS,CAAC;QACb,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,IAAI,IAAI;QACxC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAC1B,KAAK,CAAC,OAAO,CAAC,IAAI;QAClB,KAAK,CAAC,OAAO,CAAC,WAAW;KAC1B,CAAC,CACH,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/E,OAAO,EAAE,aAAa,EAAE,OAAO,aAAa,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,OAA8C,EAC9C,aAAqB;IAErB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,WAAW,GACf,QAAQ,CAAC,QAAQ,KAAK,OAAO;QAC7B,CAAC,QAAQ,CAAC,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,0EAA0E,CAAC,CAAC;IACnG,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,qBAAqB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC9C,wBAAwB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,IAAI,eAAwC,CAAC;QAC7C,IAAI,CAAC;YACH,eAAe,GAAG,MAAM,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,6BAA6B,CAAC,SAAS,CAAC,CAAC;YAClF,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAE1C,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,YAAY,CAC3B,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,QAAQ,EAAE;gBACjC,MAAM,EAAE,MAAM;gBACd,OAAO;gBACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,CAAC;oBACV,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,EAAE,aAAa,EAAE;iBACzB,CAAC;gBACF,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,EACF,UAAU,CAAC,MAAM,CAClB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,6BAA6B,CAAC,SAAS,CAAC,CAAC;YAClF,IAAI,KAAK,YAAY,6BAA6B;gBAAE,MAAM,KAAK,CAAC;YAChE,MAAM,IAAI,6BAA6B,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvD,MAAM,IAAI,6BAA6B,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,6BAA6B,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAErF,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,6BAA6B,CAAC,SAAS,CAAC,CAAC;YAClF,IAAI,KAAK,YAAY,6BAA6B;gBAAE,MAAM,KAAK,CAAC;YAChE,MAAM,IAAI,6BAA6B,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,6BAA6B,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAA2D,EAC3D,QAAgC,EAChC,KAAa;IAEb,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnD,MAAM,IAAI,eAAe,CAAC,4DAA4D,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,eAAe,CAAC,+EAA+E,CAAC,CAAC;IAC7G,CAAC;IACD,IACE,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,QAAQ,CAAC,SAAS,CAAC,MAAM;QACpD,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EACrE,CAAC;QACD,MAAM,IAAI,eAAe,CAAC,yEAAyE,CAAC,CAAC;IACvG,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,SAA2C,EAC3C,UAAkB;IAElB,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS;QACnC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,UAAU,CAAC;QACjC,CAAC,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,CAAC,GAAG;YACrC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAI,SAA6C,CAAC,MAAM,CAAC;IACrE,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,sDAAsD,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,SAAyD,CAAC;AACnE,CAAC;AAED,SAAS,mBAAmB,CAC1B,KAAc;IAEd,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,KAAK,CAAC,OAAO,KAAK,CAAC;QACnB,KAAK,CAAC,MAAM,KAAK,QAAQ;QACzB,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,OAAO,KAAK,CAAC,KAAK,CAAC,aAAa,KAAK,QAAQ;QAC7C,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAc;IAEd,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvE,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3C,IACE,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ;QACvC,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC;QACjD,CAAC,oBAAoB,CAAC,KAAK,CAAC,aAAa,CAAC;QAC1C,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,EAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CACL,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;YACvD,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CACtC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CACL,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC;YACvD,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CACtC,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CACL,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC;YACvC,oBAAoB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAC/C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA0B;IACrD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QACtC,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,UAAU,CAAC,uCAAuC,CAAC,CAAC;QAChE,CAAC;QACD,wBAAwB,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IACH,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,GAAG,KAAK,UAAU,CAAC,KAAK,CAAE,CAAC,GAAG,EAAE,CAAC;YAC1D,MAAM,IAAI,UAAU,CAAC,yBAAyB,UAAU,CAAC,KAAK,CAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAqB;IACpD,IAAI,CAAC,OAAO,CAAC,WAAW;QAAE,MAAM,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAC;IAChF,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;IAClF,IAAI,CAAC,OAAO,CAAC,IAAI;QAAE,MAAM,IAAI,UAAU,CAAC,wBAAwB,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa,EAAE,IAAY;IAC3D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAa,EAAE,IAAY;IAC3D,IAAI,KAAK,GAAG,aAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,+BAA+B,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,IAAY;IACxD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACxH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,KAAa;IACjC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/F,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,OAAyD;IAEzD,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,OAAO,OAAO,EAAE,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAI,OAAmB,EAAE,MAAmB;IAC/D,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC1E,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,OAAO,CAAC,IAAI,CACf,KAAK,CAAC,EAAE;YACN,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,KAAK,CAAC,EAAE;YACN,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,IAAa,EAAE,MAAc;IACjD,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,iCAAiC,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,12 @@
+import type { DurableObjectState } from 'cloudflare:workers';
+export declare const CLOUDFLARE_USAGE_SCHEMA_VERSION = 3;
+type DurableObjectStorage = DurableObjectState['storage'];
+/**
+ * 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 declare function initializeCloudflareUsageSchema(storage: DurableObjectStorage): void;
+export declare function readCloudflareUsageSchemaVersion(storage: DurableObjectStorage): number | undefined;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;AAE9E,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAWjD,KAAK,oBAAoB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;AA2D1D;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CA2CnF;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,SAAS,CAEpB"}