cf-workers-query/src/lib/durable-object-deduper.d.ts

Automatically cache and revalidate data in Cloudflare Workers. Using the Cache API and Execution Context

import { DurableObject } from 'cloudflare:workers';

/**
 * Optional Durable Object for guaranteed single-flight query execution.
 *
 * Unlike the built-in best-effort Cache API deduplication, this provides
 * true atomic deduplication using Durable Object's single-threaded model.
 *
 * Usage:
 * 1. Add to your wrangler.toml:
 *    [[durable_objects.bindings]]
 *    name = "QUERY_DEDUPER"
 *    class_name = "QueryDeduper"
 *
 * 2. Import and export from your worker entry:
 *    export { QueryDeduper } from 'cf-workers-query/durable-object';
 *
 * 3. Use in your code:
 *    const id = env.QUERY_DEDUPER.idFromName(cacheKeyString);
 *    const stub = env.QUERY_DEDUPER.get(id);
 *    const response = await stub.dedupe(new Request('https://internal', {
 *      method: 'POST',
 *      body: JSON.stringify({ url: 'https://api.example.com/data' })
 *    }));
 */
declare class QueryDeduper extends DurableObject {
    private inflight;
    dedupe(request: Request): Promise<Response>;
    private executeQuery;
}

export { QueryDeduper };