import type { AnyCustomObjectDefinition, FieldNames, FieldValue, LookupReference } from "./types.mjs";
declare const STANDARD_RQL_FIELD_NAMES: readonly ["id", "name", "created_at", "updated_at", "system_updated_at", "external_id", "owner_role", "created_by", "last_modified_by"];
type StandardRqlFieldValueByName = {
    id: string;
    name: string;
    created_at: string | null;
    updated_at: string | null;
    system_updated_at: string | null;
    external_id: string | null;
    owner_role: LookupReference<'Employee'> | null;
    created_by: LookupReference<'Employee'> | null;
    last_modified_by: LookupReference<'Employee'> | null;
};
/**
 * Standard field-name strings exposed by the typed RQL helper.
 *
 * @typeParam TDefinition - Object definition whose standard fields should be exposed.
 */
export type StandardRqlFieldName<TDefinition extends AnyCustomObjectDefinition> = (typeof STANDARD_RQL_FIELD_NAMES)[number];
/**
 * Field-name strings accepted by the typed RQL helper.
 *
 * @typeParam TDefinition - Object definition whose field-name union should be exposed.
 */
export type RqlFieldName<TDefinition extends AnyCustomObjectDefinition> = StandardRqlFieldName<TDefinition> | FieldNames<TDefinition>;
/**
 * Field token used by the RQL helper to preserve type information across string compilation.
 *
 * @typeParam TValue - Runtime value type stored in the field.
 * @typeParam TApiName - Wire-level field api name used when rendering RQL.
 */
export interface RqlFieldToken<TValue = unknown, TApiName extends string = string> {
    readonly kind: 'rql-field-token';
    readonly apiName: TApiName;
    readonly logicalName: string;
    readonly __valueType__?: TValue;
}
/**
 * Opaque RQL fragment that can be interpolated into {@link CustomObjectRqlHelpers.rql}.
 */
export interface RqlFragment {
    readonly kind: 'rql-fragment';
    readonly text: string;
}
/**
 * Scope object whose properties autocomplete to the standard and custom fields available on one object definition.
 *
 * @typeParam TDefinition - Object definition whose field tokens should be exposed.
 */
export type RqlFieldScope<TDefinition extends AnyCustomObjectDefinition> = {
    readonly [K in StandardRqlFieldName<TDefinition>]: RqlFieldToken<StandardRqlFieldValueByName[K], K>;
} & {
    readonly [K in FieldNames<TDefinition>]: RqlFieldToken<FieldValue<TDefinition['fields'][K]>, TDefinition['fields'][K] extends {
        apiName: infer TApiName extends string;
    } ? TApiName : string>;
};
/**
 * Input that the RQL helper knows how to encode as a literal value.
 */
export type RqlValue = string | number | boolean | null | LookupReference<string> | readonly RqlValue[];
/**
 * Runtime surface returned by {@link createRqlHelpers}.
 *
 * @typeParam TDefinition - Object definition whose field tokens should be exposed.
 */
export interface CustomObjectRqlHelpers<TDefinition extends AnyCustomObjectDefinition> {
    /** Object-scoped field tokens used for IntelliSense-friendly property access. */
    readonly fields: RqlFieldScope<TDefinition>;
    /** Converts a field-name string into a typed field token. */
    field<TFieldName extends RqlFieldName<TDefinition>>(fieldName: TFieldName): RqlFieldScope<TDefinition>[TFieldName];
    /** Renders a tagged template into a backend-ready RQL string. */
    rql(strings: TemplateStringsArray, ...values: readonly RqlInterpolation[]): string;
    /** Renders a fragment built by helper functions into a string. */
    render(fragment: RqlFragment): string;
    /** Wraps a raw RQL snippet as a fragment. Use sparingly. */
    raw(text: string): RqlFragment;
    /** Builds an equality comparison fragment. */
    eq<TValue>(field: RqlFieldToken<TValue>, value: RqlComparableValue<TValue> | null): RqlFragment;
    /** Builds an inequality comparison fragment. */
    ne<TValue>(field: RqlFieldToken<TValue>, value: RqlComparableValue<TValue> | null): RqlFragment;
    /** Builds a less-than comparison fragment. */
    lt<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
    /** Builds a less-than-or-equal comparison fragment. */
    lte<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
    /** Builds a greater-than comparison fragment. */
    gt<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
    /** Builds a greater-than-or-equal comparison fragment. */
    gte<TValue extends string | number>(field: RqlFieldToken<TValue>, value: TValue): RqlFragment;
    /** Builds an `IN` comparison fragment. */
    in<TValue>(field: RqlFieldToken<TValue>, values: readonly RqlComparableValue<TValue>[]): RqlFragment;
    /** Builds a `NOT_IN` comparison fragment. */
    notIn<TValue>(field: RqlFieldToken<TValue>, values: readonly RqlComparableValue<TValue>[]): RqlFragment;
    /** Builds an `IS NULL`-style equality fragment. */
    isNull<TValue>(field: RqlFieldToken<TValue>): RqlFragment;
    /** Builds an `IS NOT NULL`-style inequality fragment. */
    isNotNull<TValue>(field: RqlFieldToken<TValue>): RqlFragment;
    /** Builds a parenthesized `AND` fragment. */
    and(...fragments: readonly RqlFragment[]): RqlFragment;
    /** Builds a parenthesized `OR` fragment. */
    or(...fragments: readonly RqlFragment[]): RqlFragment;
    /** Builds a parenthesized `NOT` fragment. */
    not(fragment: RqlFragment): RqlFragment;
}
/** Allowed comparison inputs for one field token. */
export type RqlComparableValue<TValue> = TValue extends LookupReference<string> ? TValue | string : TValue;
/** Interpolation values accepted by the tagged-template compiler. */
export type RqlInterpolation = RqlFieldToken | RqlFragment | RqlValue;
/**
 * Creates a typed RQL helper surface for one custom-object definition.
 *
 * The helper keeps authoring close to raw RQL by combining a tagged-template
 * compiler with IntelliSense-friendly field tokens. Callers write normal RQL in
 * string segments and interpolate typed field references or JavaScript literal
 * values where they want compiler assistance.
 *
 * @param definition - Typed object definition whose field tokens should be exposed.
 * @returns Typed RQL helper surface bound to the supplied object definition.
 * @typeParam TDefinition - Object definition whose field tokens should be exposed.
 */
export declare function createRqlHelpers<TDefinition extends AnyCustomObjectDefinition>(definition: TDefinition): CustomObjectRqlHelpers<TDefinition>;
export {};
//# sourceMappingURL=rql.d.mts.map