/**
 * Link-set naming helpers, declaration types, and errors — the tiny,
 * always-loadable slice of the links feature (#553).
 *
 * Split out of `link-set.ts` so the kernel floor (reserved-name guard in
 * `vault.collection()`, the lazy `vault.links()` handle) and the ref/link
 * enforcement facade can bind these few lines WITHOUT statically pulling
 * the `LinkSet` storage engine; that class now loads via dynamic import
 * on first link I/O. `link-set.ts` re-exports everything here, so import
 * paths and class identities are unchanged for existing consumers.
 */
import { NoydbError } from '../../kernel/errors.js';
export declare const LINK_COLLECTION_PREFIX = "_links_";
/** Storage collection name for a logical link set. */
export declare function linkCollectionName(name: string): string;
/** True for any reserved link-collection name. */
export declare function isLinkCollectionName(name: string): boolean;
/** What happens to a link's rows when one of its endpoint records is deleted. */
export type LinkOnDelete = 'cascade' | 'strict' | 'warn';
/**
 * Declaration for a link set, passed to `vault.link(name, spec)`. `a` and
 * `b` are the endpoint collection names (slot-typed). `onDelete` governs
 * what happens to link rows when an endpoint record is deleted:
 * `'cascade'` (default) removes the touching link rows, `'strict'` blocks
 * the endpoint delete while links exist, `'warn'` leaves orphan rows
 * (surfaced by `vault.checkIntegrity()`).
 */
export interface LinkSpec {
    readonly a: string;
    readonly b: string;
    readonly onDelete?: LinkOnDelete;
}
/** One link tuple as returned by `of()` / `list()`. */
export interface LinkRow {
    readonly a: string;
    readonly b: string;
    readonly meta?: Record<string, unknown>;
}
/**
 * Compose the row key for an ordered `(a, b)` pair. Each id is
 * URI-encoded and joined with `|` — encodeURIComponent escapes `|`, so the
 * key is unambiguous regardless of id contents.
 */
export declare function linkRowKey(aId: string, bId: string): string;
/** Public handle returned by `vault.links(name)`. */
export interface LinkSetHandle {
    /** Create (or overwrite the metadata of) the link `(aId, bId)`. Validates both endpoints exist. */
    connect(aId: string, bId: string, meta?: Record<string, unknown>): Promise<void>;
    /** Remove the link `(aId, bId)`. Idempotent — a no-op if it doesn't exist. */
    disconnect(aId: string, bId: string): Promise<void>;
    /** Whether the link `(aId, bId)` exists. */
    has(aId: string, bId: string): Promise<boolean>;
    /** All links touching `id` on EITHER endpoint. */
    of(id: string): Promise<LinkRow[]>;
    /** All links in the set. */
    list(): Promise<LinkRow[]>;
}
/** Thrown when a `strict` link blocks deletion of an endpoint that still has links. */
export declare class LinkIntegrityError extends NoydbError {
    readonly link: string;
    readonly endpoint: string;
    readonly id: string;
    readonly count: number;
    constructor(link: string, endpoint: string, id: string, count: number);
}