import type { FaultCode } from '../core/fault-code.ts';
import type { ErasedOperation, OperationKind, TransportAvailability } from '../server/operation-catalog.ts';
import type { ParamSource, ResponseShape } from '../server/rest-binding.ts';
export type CatalogRestBindingSnapshot = {
    readonly method: string;
    readonly path: string;
    readonly inputSources: Readonly<Record<string, ParamSource>>;
    readonly success: ResponseShape;
};
export type CatalogAccessSnapshot = {
    readonly kind: 'public';
} | {
    readonly kind: 'authenticated';
} | {
    readonly kind: 'optionalAuth';
    readonly scopes: ReadonlyArray<string>;
} | {
    readonly kind: 'scoped';
    readonly scopes: ReadonlyArray<string>;
} | {
    readonly kind: 'scopedAlternatives';
    readonly alternatives: ReadonlyArray<ReadonlyArray<string>>;
};
export type CatalogOperationSnapshot = {
    readonly name: string;
    readonly kind: OperationKind;
    readonly summary: string;
    /** Optional longer-form prose; present only for the interactive subset. */
    readonly description?: string;
    readonly tags: ReadonlyArray<string>;
    readonly destructive: boolean;
    readonly access: CatalogAccessSnapshot;
    readonly parameterizedAccess?: {
        readonly discriminator: string;
        readonly defaultValue?: string;
        readonly variants: ReadonlyArray<{
            readonly value: string;
            readonly access: CatalogAccessSnapshot;
        }>;
    };
    readonly transports: TransportAvailability;
    readonly producibleFaults: ReadonlyArray<FaultCode>;
    readonly inputSchema: Record<string, unknown>;
    readonly outputSchema: Record<string, unknown>;
    readonly eventSchema?: Record<string, unknown>;
    /** Declarative REST route metadata for generated client transports. */
    readonly rest?: CatalogRestBindingSnapshot;
};
export type CatalogSnapshot = {
    readonly generatedBy: 'weft catalog snapshot';
    readonly version: 1;
    readonly operations: ReadonlyArray<CatalogOperationSnapshot>;
};
export declare function createCatalogSnapshot(sourceOperations?: ReadonlyArray<ErasedOperation>): CatalogSnapshot;
export declare function stringifyCatalogSnapshot(snapshot: CatalogSnapshot): string;