import { type EnsureStyleArtifactBuildInput, type FileDetail, type FileListResult, type GetFileOptions, type ListFilesOptions, type ProjectStyleArtifactResolution, type ResolveStyleArtifactInput, type UpsertStyleArtifactInput, VeryfrontAPIOperations } from "./operations.js";
import { type VeryfrontAPIConfig } from "./types.js";
import type { DependencyArtifactBuildResultBody, DependencyArtifactContentType } from "../../../release-assets/dependency-artifact-contracts.js";
/**
 * File context for API operations.
 * - branch: Draft/working copy from a specific branch
 * - environment: Deployed content from an environment (production, preview, staging)
 * - release: Specific release version
 */
export type FileContext = {
    type: "branch";
    name: string;
} | {
    type: "environment";
    name: string;
} | {
    type: "release";
    version: string;
};
export declare class VeryfrontApiClient {
    private config;
    private operations;
    private requestToken?;
    private requestProjectSlug?;
    private requestContext?;
    private requestBranch?;
    private initialized;
    private initializingPromise?;
    /** Cached project data from initialization - avoids redundant API calls */
    private cachedProjectData?;
    constructor(config: VeryfrontAPIConfig);
    isProxyMode(): boolean;
    setRequestToken(token: string): void;
    clearRequestToken(): void;
    setProjectSlug(slug: string): void;
    getProjectSlug(): string | undefined;
    /** Throws a structured error when no project slug is configured, instead of passing `undefined` to API calls. */
    private requireProjectSlug;
    clearProjectSlug(): void;
    setContext(context: FileContext): void;
    getContext(): FileContext;
    clearContext(): void;
    getToken(): string;
    isInitialized(): boolean;
    setRequestBranch(branch: string | null): void;
    getRequestBranch(): string | null | undefined;
    clearRequestBranch(): void;
    initialize(): Promise<void>;
    private doInitialize;
    reset(): void;
    getProjectId(): string;
    /**
     * Get the cached project data from initialization.
     * Returns undefined if not yet initialized or if projectId was provided in config.
     * Use this instead of calling getProject() to avoid redundant API calls.
     */
    getCachedProject(): Awaited<ReturnType<VeryfrontAPIOperations["getProject"]>> | undefined;
    listProjects(): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string>;
        name: import("../../../internal-agents/schema.js").Schema<string>;
        slug: import("../../../internal-agents/schema.js").Schema<string>;
        description: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        created_at: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        updated_at: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        provider: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        provider_id: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        layout: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        layout_id: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        config: import("../../../internal-agents/schema.js").Schema<string | Record<string, unknown> | undefined>;
    }>[]>;
    getProject(projectRef?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string>;
        name: import("../../../internal-agents/schema.js").Schema<string>;
        slug: import("../../../internal-agents/schema.js").Schema<string>;
        description: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        created_at: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        updated_at: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        provider: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        provider_id: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        layout: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        layout_id: import("../../../internal-agents/schema.js").Schema<string | null | undefined>;
        config: import("../../../internal-agents/schema.js").Schema<string | Record<string, unknown> | undefined>;
    }>>;
    listFiles(options?: ListFilesOptions): Promise<FileListResult>;
    listAllFiles(options?: Omit<ListFilesOptions, "cursor">): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        version_id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        path: import("../../../internal-agents/schema.js").Schema<string>;
        content: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        size: import("../../../internal-agents/schema.js").Schema<number>;
        type: import("../../../internal-agents/schema.js").Schema<"function" | "file" | "page" | "component">;
        updated_at: import("../../../internal-agents/schema.js").Schema<string>;
    }>[]>;
    getFile(pathOrId: string, options?: {
        expectedMissing?: boolean;
    }): Promise<FileDetail>;
    getFileContent(pathOrId: string): Promise<string>;
    getFileContentBytesWithinLimit(pathOrId: string, maximumBytes: number, options?: GetFileOptions): Promise<Uint8Array>;
    getOptionalFileContent(pathOrId: string): Promise<string>;
    listBranchFiles(branchName?: string, options?: ListFilesOptions): Promise<FileListResult>;
    getBranchFile(branchName: string, pathOrId: string): Promise<FileDetail>;
    listEnvironmentFiles(environmentName?: string, options?: ListFilesOptions): Promise<FileListResult>;
    listAllEnvironmentFiles(environmentName?: string, options?: Omit<ListFilesOptions, "cursor">): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        version_id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        path: import("../../../internal-agents/schema.js").Schema<string>;
        content: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        size: import("../../../internal-agents/schema.js").Schema<number>;
        type: import("../../../internal-agents/schema.js").Schema<"function" | "file" | "page" | "component">;
        updated_at: import("../../../internal-agents/schema.js").Schema<string>;
    }>[]>;
    getEnvironmentFile(environmentName: string, pathOrId: string): Promise<FileDetail>;
    listReleaseFiles(version?: string, options?: ListFilesOptions): Promise<FileListResult>;
    listAllReleaseFiles(version?: string, options?: Omit<ListFilesOptions, "cursor">): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        version_id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        path: import("../../../internal-agents/schema.js").Schema<string>;
        content: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        size: import("../../../internal-agents/schema.js").Schema<number>;
        type: import("../../../internal-agents/schema.js").Schema<"function" | "file" | "page" | "component">;
        updated_at: import("../../../internal-agents/schema.js").Schema<string>;
    }>[]>;
    getReleaseFile(version: string, pathOrId: string): Promise<FileDetail>;
    lookupProjectByDomain(domain: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        project_id: import("../../../internal-agents/schema.js").Schema<string>;
        project_slug: import("../../../internal-agents/schema.js").Schema<string>;
        project_name: import("../../../internal-agents/schema.js").Schema<string>;
        environment: import("../../../internal-agents/schema.js").Schema<import("../../../extensions/schema/schema-validator.js").InferShape<{
            id: import("../../../internal-agents/schema.js").Schema<string>;
            name: import("../../../internal-agents/schema.js").Schema<string>;
        }> | null>;
        release_id: import("../../../internal-agents/schema.js").Schema<string | null>;
    }> | null>;
    resolveStyleArtifact(input: ResolveStyleArtifactInput, projectRef?: string): Promise<ProjectStyleArtifactResolution>;
    ensureStyleArtifactBuild(input: EnsureStyleArtifactBuildInput, projectRef?: string): Promise<ProjectStyleArtifactResolution>;
    upsertStyleArtifact(input: UpsertStyleArtifactInput, projectRef?: string): Promise<ProjectStyleArtifactResolution>;
    uploadDependencyArtifactAsset(artifactId: string, attemptCount: number, contentHash: string, contentType: DependencyArtifactContentType, bytes: Uint8Array<ArrayBuffer>): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        stored: import("../../../internal-agents/schema.js").Schema<true>;
        existed: import("../../../internal-agents/schema.js").Schema<boolean>;
    }>>;
    reportDependencyArtifactBuildResult(artifactId: string, attemptCount: number, result: DependencyArtifactBuildResultBody): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        accepted: import("../../../internal-agents/schema.js").Schema<true>;
        state: import("../../../internal-agents/schema.js").Schema<"failed" | "ready">;
    }>>;
    beginReleaseAssetManifestBuild(version: string, projectRef?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string>;
        manifest_version: import("../../../internal-agents/schema.js").Schema<number>;
        state: import("../../../internal-agents/schema.js").Schema<"failed" | "partial" | "ready" | "building" | "queued" | "superseded">;
    }>>;
    uploadReleaseAsset(version: string, contentHash: string, contentType: string, bytes: Uint8Array, projectRef?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        stored: import("../../../internal-agents/schema.js").Schema<boolean>;
        existed: import("../../../internal-agents/schema.js").Schema<boolean>;
    }>>;
    putReleaseAssetManifest(version: string, manifest: unknown, projectRef?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        state: import("../../../internal-agents/schema.js").Schema<"failed" | "partial" | "ready" | "building" | "queued" | "superseded">;
        manifest_version: import("../../../internal-agents/schema.js").Schema<number | undefined>;
    }>>;
    reportReleaseAssetManifestState(version: string, state: "partial" | "failed", error?: string, projectRef?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        state: import("../../../internal-agents/schema.js").Schema<"failed" | "partial" | "ready" | "building" | "queued" | "superseded">;
        manifest_version: import("../../../internal-agents/schema.js").Schema<number | undefined>;
    }>>;
    getReleaseAssetManifest(version: string, projectRef?: string, signal?: AbortSignal): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        state: import("../../../internal-agents/schema.js").Schema<"failed" | "partial" | "ready" | "building" | "queued" | "superseded">;
        manifest_version: import("../../../internal-agents/schema.js").Schema<number>;
        manifest: import("../../../internal-agents/schema.js").Schema<Record<string, unknown> | null>;
    }>>;
    getFileById(entityId: string): Promise<{
        path: string;
        content: string;
    } | null>;
    searchFiles(pattern: string): Promise<{
        id?: string;
        path: string;
    }[]>;
    /**
     * Search for files matching a pattern and return them with content.
     * Useful for batch-loading files without knowing exact extensions.
     *
     * Example: searchFilesWithContent("components/Button.*") returns all files
     * like Button.tsx, Button.ts, Button.jsx etc. with their content.
     *
     * @param pattern - Glob pattern to match files (e.g., "path/file.*" or "pages/_error.*")
     * @returns Array of files with path and content
     */
    searchFilesWithContent(pattern: string): Promise<Array<{
        path: string;
        content: string;
    }>>;
    private listFilesByContext;
    /**
     * Resolve a file path without extension by searching for all possible extensions.
     * Returns the first match based on extension priority.
     *
     * @param basePath - Path without extension (e.g., "components/Button")
     * @param extensionPriority - Preferred extension order (default: .tsx, .ts, .jsx, .js, .mdx, .md)
     * @returns The resolved file with content, or null if not found
     */
    resolveFileWithExtension(basePath: string, extensionPriority?: string[]): Promise<{
        path: string;
        content: string;
    } | null>;
    listPublishedFiles(_projectId?: string, releaseId?: string, environmentName?: string): Promise<import("../../../extensions/schema/schema-validator.js").InferShape<{
        id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        version_id: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        path: import("../../../internal-agents/schema.js").Schema<string>;
        content: import("../../../internal-agents/schema.js").Schema<string | undefined>;
        size: import("../../../internal-agents/schema.js").Schema<number>;
        type: import("../../../internal-agents/schema.js").Schema<"function" | "file" | "page" | "component">;
        updated_at: import("../../../internal-agents/schema.js").Schema<string>;
    }>[]>;
    getPublishedFileContent(path: string, releaseId?: string, environmentName?: string): Promise<string>;
    getPublishedFileContentBytesWithinLimit(path: string, maximumBytes: number, releaseId?: string, environmentName?: string, options?: GetFileOptions): Promise<Uint8Array>;
}
//# sourceMappingURL=client.d.ts.map