/**
 * Encode string to URL-safe base64 (base64url)
 * - Replaces + with -
 * - Replaces / with _
 * - Removes padding (=)
 *
 * @param str - String to encode
 * @returns URL-safe base64 encoded string
 */
export declare function encodeBase64Url(str: string): string;
/**
 * Decode URL-safe base64 (base64url) to string
 *
 * @param base64url - URL-safe base64 encoded string
 * @returns Decoded string
 */
export declare function decodeBase64Url(base64url: string): string;
/**
 * Normalize source URL by removing query string and fragment
 * Only normalizes HTTP(S) URLs. Other sources (e.g., "clipboard://...") are returned as-is
 *
 * @param source - Source identifier (URL or custom ID)
 * @returns Normalized source
 */
export declare function normalizeSource(source: string): string;
/**
 * Content format type for ingest_data
 */
export type ContentFormat = 'text' | 'html' | 'markdown';
/**
 * Get file extension from content format
 *
 * All formats return .md for consistency.
 * This allows generating unique path from source without knowing original format,
 * which is essential for delete_file with source parameter.
 *
 * @param _format - Content format (ignored, always returns 'md')
 * @returns File extension (without dot) - always 'md'
 */
export declare function formatToExtension(_format: ContentFormat): string;
/**
 * Get raw-data directory path
 *
 * @param dbPath - LanceDB database path
 * @returns Raw-data directory path
 */
export declare function getRawDataDir(dbPath: string): string;
/**
 * Generate raw-data file path from source and format
 * Path format: {dbPath}/raw-data/{base64url(normalizedSource)}.{ext}
 *
 * @param dbPath - LanceDB database path
 * @param source - Source identifier (URL or custom ID)
 * @param format - Content format
 * @returns Generated file path
 */
export declare function generateRawDataPath(dbPath: string, source: string, format: ContentFormat): string;
/**
 * Save content to raw-data directory
 * Creates directory if it doesn't exist
 *
 * @param dbPath - LanceDB database path
 * @param source - Source identifier (URL or custom ID)
 * @param content - Content to save
 * @param format - Content format
 * @returns Saved file path
 */
export declare function saveRawData(dbPath: string, source: string, content: string, format: ContentFormat): Promise<string>;
/**
 * Display-only heuristic. NOT a security boundary — use
 * {@link isPathInRawDataDir} when the result gates filesystem access.
 */
export declare function looksLikeRawDataPath(filePath: string): boolean;
/**
 * Lexical containment in `<dbPath>/raw-data/`. Safe for cleanup gates
 * (`unlink` does not follow symlinks). Use {@link isPathInRawDataDir}
 * when the result controls `readFile`.
 */
export declare function isPathInRawDataDirLexical(filePath: string, dbPath: string): boolean;
/**
 * Lexical containment plus `realpath` so a symlink under raw-data
 * pointing outside cannot route a read through the raw-data fast-path.
 * Fail-closed on `realpath` errors.
 */
export declare function isPathInRawDataDir(filePath: string, dbPath: string): Promise<boolean>;
/**
 * Extract original source from raw-data file path
 * Returns null if not a raw-data path
 *
 * @param filePath - Raw-data file path
 * @returns Original source or null
 */
export declare function extractSourceFromPath(filePath: string): string | null;
/**
 * Metadata stored alongside each raw-data .md file as a .meta.json sidecar
 */
export interface RawDataMeta {
    title: string | null;
    source: string;
    format: ContentFormat;
}
/**
 * Generate the .meta.json sidecar path for a given .md file path
 * Replaces the trailing `.md` extension with `.meta.json`
 *
 * @param mdPath - Path to the .md raw-data file
 * @returns Path to the corresponding .meta.json file
 */
export declare function generateMetaJsonPath(mdPath: string): string;
/**
 * Save metadata as a JSON sidecar file alongside a raw-data .md file
 *
 * @param mdPath - Path to the .md raw-data file
 * @param meta - Metadata to persist
 */
export declare function saveMetaJson(mdPath: string, meta: RawDataMeta): Promise<void>;
/**
 * Load metadata from a .meta.json sidecar file
 * Returns null when the sidecar file does not exist (ENOENT).
 * All other read errors are re-thrown (fail-fast).
 *
 * @param mdPath - Path to the .md raw-data file
 * @returns Parsed metadata or null if file does not exist
 */
export declare function loadMetaJson(mdPath: string): Promise<RawDataMeta | null>;
/**
 * True when a filesystem error means the target path does not exist.
 */
export declare function isEnoent(error: unknown): boolean;
/**
 * Pre-unlink existence of the on-disk raw-data artifacts for a target .md
 * path: the raw-data file itself and its .meta.json sidecar.
 */
export interface RawDataArtifactExistence {
    rawDataExisted: boolean;
    metaExisted: boolean;
}
/**
 * Report which raw-data artifacts exist for a target path. Single source for
 * the delete `existed` signal so the MCP server and CLI delete paths cannot
 * drift. Call BEFORE unlinking — it reports pre-unlink state.
 *
 * @param targetPath - Raw-data .md file path
 */
export declare function checkRawDataArtifacts(targetPath: string): Promise<RawDataArtifactExistence>;
//# sourceMappingURL=raw-data-utils.d.ts.map