/**
 * Attachment add operation
 */
import type { ILibrary, IdentifierType } from "../../../core/library-interface.js";
/**
 * Options for addAttachment operation
 */
export interface AddAttachmentOptions {
    /** Reference identifier (id or uuid) */
    identifier: string;
    /** Path to the file to attach */
    filePath: string;
    /** Role for the attachment */
    role: string;
    /** Human-readable label (optional) */
    label?: string;
    /** Move file instead of copy */
    move?: boolean;
    /** Force overwrite existing file */
    force?: boolean;
    /** Identifier type */
    idType?: IdentifierType;
    /** Base directory for attachments */
    attachmentsDirectory: string;
}
/**
 * Result of addAttachment operation
 */
export interface AddAttachmentResult {
    success: boolean;
    filename?: string;
    directory?: string;
    overwritten?: boolean;
    existingFile?: string;
    requiresConfirmation?: boolean;
    error?: string;
}
/**
 * Add an attachment to a reference
 */
export declare function addAttachment(library: ILibrary, options: AddAttachmentOptions): Promise<AddAttachmentResult>;
//# sourceMappingURL=add.d.ts.map