import { type Firestore } from 'firebase-admin/firestore';
import { type Account, type AccountInput, type CheckAndConsumeInput, type CheckAndConsumeResult, type Consumption, type Entitlement, type EntitlementGrant, type EntitlementStore, type Iso8601, type ListEntitlementsFilter, type Payment, type PaymentInput, type PaymentStatus, type Receipt } from 'stipend-mcp';
export interface FirestoreStoreOptions {
    /** Initialised Firestore client (Admin SDK). */
    readonly firestore: Firestore;
    /**
     * Prefix prepended to every collection name. Useful in tests so that
     * concurrent runs against the same emulator don't see each other's data.
     * Defaults to no prefix.
     */
    readonly collectionPrefix?: string;
    /** Override clock for deterministic tests. Defaults to `nowIso()`. */
    readonly now?: () => Iso8601;
    /**
     * Optional async hook invoked once at the start of every
     * `checkAndConsume` transaction attempt, before any read happens. Tests
     * inject this to exercise interleavings; production callers should not
     * supply it. Because Firestore retries the transaction body on write
     * contention, the hook can fire more than once for the same logical call.
     */
    readonly beforeAtomicSection?: () => Promise<void> | void;
}
/**
 * Firestore-backed `EntitlementStore`.
 *
 * Atomicity of `checkAndConsume` is provided by a single `runTransaction`
 * callback. The consumption document's ID is the tool-call idempotency
 * key, which mirrors the SQL `UNIQUE (tool_call_idempotency_key)` from
 * TDD §2.5 — collision on the second writer is what defends against
 * double-spend on replays.
 *
 * Monetary amounts are stored as JSON numbers; see the package README for
 * the rationale and the implied ceiling.
 */
export declare class FirestoreStore implements EntitlementStore {
    private readonly db;
    private readonly prefix;
    private readonly now;
    private readonly beforeAtomicSection;
    constructor(options: FirestoreStoreOptions);
    private col;
    private accountRef;
    private entitlementRef;
    private paymentRef;
    private paymentByKeyRef;
    private receiptRef;
    private consumptionRef;
    upsertAccount(input: AccountInput): Promise<Account>;
    getAccount(accountId: string): Promise<Account | null>;
    getAccountByAgentId(agentId: string): Promise<Account | null>;
    listEntitlements(accountId: string, filter?: ListEntitlementsFilter): Promise<readonly Entitlement[]>;
    getEntitlement(id: string): Promise<Entitlement | null>;
    grant(grant: EntitlementGrant): Promise<Entitlement>;
    revoke(entitlementId: string): Promise<void>;
    expire(entitlementId: string): Promise<void>;
    checkAndConsume(input: CheckAndConsumeInput): Promise<CheckAndConsumeResult>;
    private doCheckAndConsume;
    findConsumption(idempotencyKey: string): Promise<Consumption | null>;
    listConsumptions(accountId: string, since?: string): Promise<readonly Consumption[]>;
    createPayment(input: PaymentInput): Promise<Payment>;
    updatePaymentStatus(paymentId: string, status: PaymentStatus, fields?: {
        providerIntentId?: string;
        providerRef?: string;
    }): Promise<Payment>;
    getPayment(paymentId: string): Promise<Payment | null>;
    findPaymentByIdempotencyKey(key: string): Promise<Payment | null>;
    findPaymentByProviderIntentId(providerIntentId: string): Promise<Payment | null>;
    saveReceipt(receipt: Receipt): Promise<Receipt>;
    getReceipt(id: string): Promise<Receipt | null>;
}
//# sourceMappingURL=firestore-store.d.ts.map