import { type AssetProps, type CollectionProp, type ContentTypeProps, type EntryProps } from 'contentful-management';
import type { SpaceConfig } from '../config/types.js';
export interface UploadResult {
    sys: {
        id: string;
    };
}
/**
 * A restricted CMA client that deliberately does NOT expose publish, unpublish,
 * archive, or delete methods on entries. Only safe read/write draft operations
 * are exposed.
 *
 * Safety is enforced at both the Contentful Role level (no publish permissions on
 * the token) and here at the application level (no publish methods on this interface).
 *
 * Under contentful-management v12+, this is backed by the plain client (scoped with
 * space/environment defaults). Entry and collection types are plain props
 * (`EntryProps`, `CollectionProp`, …), not legacy entity instances.
 */
export interface SafeEnvironment {
    getEntry(entryId: string): Promise<EntryProps>;
    getEntries(query: Record<string, unknown>): Promise<CollectionProp<EntryProps>>;
    createEntry(contentTypeId: string, fields: Record<string, Record<string, unknown>>): Promise<EntryProps>;
    getAsset(assetId: string): Promise<AssetProps>;
    getAssets(query?: Record<string, unknown>): Promise<CollectionProp<AssetProps>>;
    getContentType(contentTypeId: string): Promise<ContentTypeProps>;
    getContentTypes(): Promise<CollectionProp<ContentTypeProps>>;
    /** Saves entry fields as draft (plain `entry.update`). */
    saveDraft(entry: EntryProps): Promise<EntryProps>;
    /** Deletes a draft entry (never published). */
    deleteEntry(entryId: string): Promise<void>;
    /** Uploads a raw file binary to Contentful's upload API. Returns the upload ID. */
    uploadFile(fileBuffer: Buffer, mimeType: string): Promise<UploadResult>;
    /** Creates a new asset entry referencing an upload ID. */
    createAsset(fields: {
        title: string;
        description: string;
        fileName: string;
        contentType: string;
        uploadId: string;
        locale: string;
    }): Promise<AssetProps>;
    /** Triggers CDN processing for an uploaded asset file on a specific locale. */
    processAsset(asset: AssetProps, locale: string): Promise<AssetProps>;
    /** Saves asset field changes as draft (does not publish). */
    updateAsset(asset: AssetProps): Promise<AssetProps>;
    /** Publishes an asset. Only use for asset metadata updates (description/alt text), not content. */
    publishAsset(asset: AssetProps): Promise<AssetProps>;
}
/**
 * Creates a safe CMA environment wrapper for the given space config.
 * The returned object only exposes methods that cannot publish or delete.
 */
export declare function createSafeEnvironment(space: SpaceConfig): Promise<SafeEnvironment>;
//# sourceMappingURL=client.d.ts.map