export interface BlobRef {
    /** `"sha256:" + lowercase-hex SHA-256` of the blob bytes (§5.9.1). */
    readonly blobId: string;
    /** Non-negative uncompressed size within the i64 safe-integer contract. */
    readonly byteLength: number;
    /** Advisory MIME type; never parsed or trusted by the server. */
    readonly mediaType?: string;
    /** Advisory display filename. */
    readonly name?: string;
}
/**
 * Parse and validate a raw `blob_ref` string against the §5.9.1 shape. A
 * failure is a row-codec decode error (`sync.invalid_request`), the same
 * class as the tag-5 json parse failure — so codec and §11 rendering can
 * never disagree.
 */
export declare function parseBlobRef(raw: string): BlobRef;
/** Serialize a BlobRef to its canonical string form (§5.9.1 key order). */
export declare function serializeBlobRef(ref: BlobRef): string;
/** True iff `raw` is a valid canonical BlobRef document (no throw). */
export declare function isBlobRef(raw: string): boolean;