import { TableBuilder } from './table-builder';
import { FieldRef } from '../query/conditions';
/**
 * Navigation configuration
 */
export interface NavigationConfig<TSourceTable extends TableBuilder<any> = TableBuilder<any>, TTargetTable extends TableBuilder<any> = TableBuilder<any>> {
    /**
     * Array of foreign key fields from the source table
     * Example: [users.id] when defining a collection on users table
     */
    foreignKeys: FieldRef<any, any>[];
    /**
     * Array of matching fields from the target table
     * Example: [posts.userId] when defining posts collection
     */
    matches: FieldRef<any, any>[];
    /**
     * Determines if the join is mandatory (INNER JOIN) or optional (LEFT JOIN)
     * Default: false (LEFT JOIN)
     */
    isMandatory?: boolean;
}
/**
 * Navigation property marker - represents a collection navigation property (one-to-many)
 * Represents a collection of related entities in a navigation property
 */
export declare class DbNavigationCollection<TTarget extends TableBuilder<any> = TableBuilder<any>> {
    /** @internal */
    readonly targetTableBuilder: TTarget;
    /** @internal */
    readonly config: NavigationConfig<any, TTarget>;
    /** @internal */
    readonly __targetTable: TTarget;
    /** @internal */
    readonly __navigationType: "collection";
    constructor(
    /** @internal */
    targetTableBuilder: TTarget, 
    /** @internal */
    config: NavigationConfig<any, TTarget>);
    /**
     * Get the target table name
     */
    get targetTable(): string;
    /**
     * Get foreign key column names (literals prefixed with __LIT:)
     */
    get foreignKeyColumns(): string[];
    /**
     * Get matching column names (literals prefixed with __LIT:)
     */
    get matchColumns(): string[];
    /**
     * Whether this navigation requires a mandatory join
     */
    get isMandatory(): boolean;
}
/**
 * Navigation property marker for single reference (one-to-one or many-to-one)
 */
export declare class DbNavigation<TTarget extends TableBuilder<any> = TableBuilder<any>> {
    /** @internal */
    readonly builder: () => {
        targetTable: TTarget;
        config: NavigationConfig<any, TTarget>;
    };
    /** @internal */
    readonly __targetTable: TTarget;
    /** @internal */
    readonly __navigationType: "navigation";
    /** @internal */
    targetTableBuilder: TTarget;
    /** @internal */
    config: NavigationConfig<any, TTarget>;
    constructor(
    /** @internal */
    builder: () => {
        targetTable: TTarget;
        config: NavigationConfig<any, TTarget>;
    });
    private ensureNavigation;
    /**
     * Get the target table name
     */
    getTargetTable(): string;
    /**
     * Get foreign key column names (literals prefixed with __LIT:)
     */
    getForeignKeyColumns(): string[];
    /**
     * Get matching column names (literals prefixed with __LIT:)
     */
    getMatchColumns(): string[];
    /**
     * Whether this navigation requires a mandatory join
     */
    getIsMandatory(): boolean;
}
/**
 * Helper to create a collection navigation property (one-to-many)
 *
 * @example
 * ```typescript
 * const users = table('users', {
 *   id: serial('id').primaryKey(),
 *   posts: navigationCollection(posts, {
 *     foreignKeys: [users.id],
 *     matches: [posts.userId],
 *     isMandatory: false
 *   })
 * });
 * ```
 */
export declare function navigationCollection<TTarget extends TableBuilder<any>>(targetTable: TTarget, config: NavigationConfig<any, TTarget>): DbNavigationCollection<TTarget>;
/**
 * Helper to create a single navigation property (one-to-one or many-to-one)
 *
 * @example
 * ```typescript
 * const orders = table('orders', {
 *   id: serial('id').primaryKey(),
 *   userId: integer('user_id').notNull(),
 *   user: navigation(users, {
 *     foreignKeys: [orders.userId],
 *     matches: [users.id],
 *     isMandatory: true
 *   })
 * });
 * ```
 */
export declare function navigation<TTarget extends TableBuilder<any>>(builder: () => {
    targetTable: TTarget;
    config: NavigationConfig<any, TTarget>;
}): DbNavigation<TTarget>;
/**
 * @deprecated Use navigationCollection instead
 */
export declare class DbCollection<TTarget extends TableBuilder<any> = TableBuilder<any>> {
    /** @internal */
    readonly targetTable: string;
    /** @internal */
    readonly foreignKey: string;
    /** @internal */
    readonly __targetTable: TTarget;
    /** @internal */
    readonly __navigationType: "collection";
    constructor(
    /** @internal */
    targetTable: string, 
    /** @internal */
    foreignKey: string);
}
/**
 * @deprecated Use navigation instead
 */
export declare class DbReference<TTarget extends TableBuilder<any> = TableBuilder<any>> {
    /** @internal */
    readonly targetTable: string;
    /** @internal */
    readonly foreignKey: string;
    /** @internal */
    readonly references: string;
    /** @internal */
    readonly __targetTable: TTarget;
    /** @internal */
    readonly __navigationType: "reference";
    constructor(
    /** @internal */
    targetTable: string, 
    /** @internal */
    foreignKey: string, 
    /** @internal */
    references?: string);
}
/**
 * @deprecated Use navigationCollection instead
 */
export declare function collection<TTarget extends TableBuilder<any> = TableBuilder<any>>(targetTable: string, foreignKey: string): DbCollection<TTarget>;
/**
 * @deprecated Use navigation instead
 */
export declare function reference<TTarget extends TableBuilder<any> = TableBuilder<any>>(targetTable: string, foreignKey: string, references?: string): DbReference<TTarget>;
/**
 * Type guard to check if a property is a navigation property
 */
export declare function isNavigationProperty(value: any): value is DbNavigationCollection<any> | DbNavigation<any> | DbCollection<any> | DbReference<any>;
/**
 * Type guard for collection navigation (both old and new)
 */
export declare function isCollection(value: any): value is DbNavigationCollection<any> | DbCollection<any>;
/**
 * Type guard for reference navigation (both old and new)
 */
export declare function isReference(value: any): value is DbNavigation<any> | DbReference<any>;
/**
 * Type guard for new navigation collection
 */
export declare function isNavigationCollection(value: any): value is DbNavigationCollection<any>;
/**
 * Type guard for new single navigation
 */
export declare function isNavigation(value: any): value is DbNavigation<any>;
/**
 * Extract navigation properties from a schema definition
 */
export type NavigationProperties<T> = {
    [K in keyof T]: T[K] extends DbNavigationCollection<any> | DbNavigation<any> | DbCollection<any> | DbReference<any> ? K : never;
}[keyof T];
/**
 * Extract regular column properties from a schema definition
 */
export type ColumnProperties<T> = {
    [K in keyof T]: T[K] extends DbNavigationCollection<any> | DbNavigation<any> | DbCollection<any> | DbReference<any> ? never : K;
}[keyof T];
//# sourceMappingURL=navigation.d.ts.map