@xylex-group/athena 2.0.0 → 2.1.2

package/dist/client-dpAp-NZK.d.cts

@@ -0,0 +1,435 @@
+import { g as AthenaJsonValue, a as AthenaGatewayCallOptions, e as AthenaJsonObject, h as AthenaRpcCallOptions, m as BackendConfig, n as BackendType, G as AthenaConditionValue, A as AthenaConditionCastType, H as AthenaConditionArrayValue, J as AthenaConditionOperator, c as AthenaGatewayErrorDetails, C as SchemaDef, K as AnyModelDef, D as DatabaseDef, w as ModelMetadata, v as ModelDef, R as RegistryDef, F as TenantKeyMap, T as TenantContext, z as RowOf, M as ModelAt, o as InsertOf, U as UpdateOf, S as SchemaIntrospectionProvider, p as IntrospectionColumn } from './types-BaBzjwXr.cjs';
+import { a as AthenaAuthBindings, c as AthenaAuthClientConfig, w as AthenaAuthSdkClient } from './model-form-Cy-zaO0u.cjs';
+import { j as GeneratorSchemaSelection, b as GeneratorProviderConfig } from './types-CpqL-pZx.cjs';
+
+type AthenaRowShape$1 = Record<string, AthenaJsonValue | undefined>;
+type AthenaUpsertOptions<Update> = AthenaGatewayCallOptions & {
+    updateBody?: Update;
+    onConflict?: string | string[];
+};
+interface AthenaDbModule {
+    from<Row = AthenaRowShape$1, Insert = Partial<Row>, Update = Partial<Insert>>(table: string): TableQueryBuilder<Row, Insert, Update>;
+    select<Row = AthenaRowShape$1, SelectedRow = Row>(table: string, columns?: string | string[], options?: AthenaGatewayCallOptions): SelectChain<Row, SelectedRow>;
+    insert<Row = AthenaRowShape$1, Insert = Partial<Row>>(table: string, values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row>;
+    insert<Row = AthenaRowShape$1, Insert = Partial<Row>>(table: string, values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[]>;
+    upsert<Row = AthenaRowShape$1, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert, options?: AthenaUpsertOptions<Update>): MutationQuery<Row>;
+    upsert<Row = AthenaRowShape$1, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert[], options?: AthenaUpsertOptions<Update>): MutationQuery<Row[]>;
+    update<Row = AthenaRowShape$1, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row>;
+    delete<Row = AthenaRowShape$1>(table: string, options?: AthenaGatewayCallOptions & {
+        resourceId?: string;
+    }): MutationQuery<Row | null>;
+    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row>;
+    query<Row = unknown>(query: string, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Row[]>>;
+}
+
+interface AthenaResult<T> {
+    data: T | null;
+    error: string | null;
+    errorDetails?: AthenaGatewayErrorDetails | null;
+    status: number;
+    count?: number | null;
+    raw: unknown;
+}
+interface AthenaClientExperimentalOptions {
+    /**
+     * Pre-compute and attach normalized error metadata to failed AthenaResult values.
+     * Keeps AthenaResult shape intact and enables context-aware normalizeAthenaError(result) usage.
+     */
+    enableErrorNormalization?: boolean;
+}
+type MutationSingleResult<Result> = Result extends Array<infer Item> ? Item | null : Result | null;
+type AthenaRowShape = Record<string, AthenaJsonValue | undefined>;
+type FilterColumnKey<Row> = Extract<keyof NonNullable<Row>, string>;
+type ResolvedFilterColumnKey<Row> = [FilterColumnKey<Row>] extends [never] ? string : FilterColumnKey<Row>;
+interface MutationQuery<Result> extends PromiseLike<AthenaResult<Result>> {
+    select(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
+    returning(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
+    single(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
+    maybeSingle(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
+    then<TResult1 = AthenaResult<Result>, TResult2 = never>(onfulfilled?: ((value: AthenaResult<Result>) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | undefined | null): Promise<AthenaResult<Result> | TResult>;
+    finally(onfinally?: (() => void) | undefined | null): Promise<AthenaResult<Result>>;
+}
+interface OrderOptions {
+    ascending?: boolean;
+}
+/** Shared filter chain - supports eq, limit, etc. in any order relative to select/update */
+interface FilterChain<Self, Row> {
+    eq(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    eqCast(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue, cast: AthenaConditionCastType): Self;
+    eqUuid(column: ResolvedFilterColumnKey<Row>, value: string): Self;
+    match(filters: Partial<Record<ResolvedFilterColumnKey<Row>, AthenaConditionValue>>): Self;
+    range(from: number, to: number): Self;
+    limit(count: number): Self;
+    offset(count: number): Self;
+    currentPage(value: number): Self;
+    pageSize(value: number): Self;
+    totalPages(value: number): Self;
+    order(column: ResolvedFilterColumnKey<Row>, options?: OrderOptions): Self;
+    gt(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    gte(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    lt(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    lte(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    neq(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    like(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    ilike(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    is(column: ResolvedFilterColumnKey<Row>, value: AthenaConditionValue): Self;
+    in(column: ResolvedFilterColumnKey<Row>, values: AthenaConditionArrayValue): Self;
+    contains(column: ResolvedFilterColumnKey<Row>, values: AthenaConditionArrayValue): Self;
+    containedBy(column: ResolvedFilterColumnKey<Row>, values: AthenaConditionArrayValue): Self;
+    not(columnOrExpression: ResolvedFilterColumnKey<Row> | string, operator?: AthenaConditionOperator, value?: AthenaConditionValue): Self;
+    or(expression: string): Self;
+}
+/** Chain returned by select() - supports filters and single/maybeSingle before execution */
+interface SelectChain<Row, SelectedRow = Row> extends FilterChain<SelectChain<Row, SelectedRow>, Row>, PromiseLike<AthenaResult<SelectedRow[]>> {
+    single<T = SelectedRow>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = SelectedRow>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+}
+/** Chain returned by update() - supports filters before execution, plus select/returning */
+interface UpdateChain<Row> extends FilterChain<UpdateChain<Row>, Row>, MutationQuery<Row[]> {
+}
+interface RpcFilterChain<Self> {
+    eq(column: string, value: AthenaConditionValue): Self;
+    neq(column: string, value: AthenaConditionValue): Self;
+    gt(column: string, value: AthenaConditionValue): Self;
+    gte(column: string, value: AthenaConditionValue): Self;
+    lt(column: string, value: AthenaConditionValue): Self;
+    lte(column: string, value: AthenaConditionValue): Self;
+    like(column: string, value: AthenaConditionValue): Self;
+    ilike(column: string, value: AthenaConditionValue): Self;
+    is(column: string, value: AthenaConditionValue): Self;
+    in(column: string, values: AthenaConditionArrayValue): Self;
+}
+interface RpcOrderOptions {
+    ascending?: boolean;
+}
+interface RpcQueryBuilder<Row> extends RpcFilterChain<RpcQueryBuilder<Row>>, PromiseLike<AthenaResult<Row[]>> {
+    select(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<Row[]>>;
+    single<T = Row>(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = Row>(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
+    order(column: string, options?: RpcOrderOptions): RpcQueryBuilder<Row>;
+    limit(count: number): RpcQueryBuilder<Row>;
+    offset(count: number): RpcQueryBuilder<Row>;
+    range(from: number, to: number): RpcQueryBuilder<Row>;
+}
+interface TableQueryBuilder<Row, Insert = Partial<Row>, Update = Partial<Insert>> extends FilterChain<TableQueryBuilder<Row, Insert, Update>, Row> {
+    select<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): SelectChain<Row, T>;
+    insert(values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row>;
+    insert(values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[]>;
+    upsert(values: Insert, options?: AthenaGatewayCallOptions & {
+        updateBody?: Update;
+        onConflict?: string | string[];
+    }): MutationQuery<Row>;
+    upsert(values: Insert[], options?: AthenaGatewayCallOptions & {
+        updateBody?: Update;
+        onConflict?: string | string[];
+    }): MutationQuery<Row[]>;
+    update(values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row>;
+    delete(options?: AthenaGatewayCallOptions & {
+        resourceId?: string;
+    }): MutationQuery<Row | null>;
+    single<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    reset(): TableQueryBuilder<Row, Insert, Update>;
+}
+interface AthenaSdkClient {
+    from<Row = AthenaRowShape, Insert = Partial<Row>, Update = Partial<Insert>>(table: string): TableQueryBuilder<Row, Insert, Update>;
+    db: AthenaDbModule;
+    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row>;
+    query<Row = unknown>(query: string, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Row[]>>;
+}
+interface AthenaSdkClientWithAuth extends AthenaSdkClient {
+    auth: AthenaAuthBindings;
+}
+interface AthenaClientBuilder {
+    /** Set the gateway base URL. */
+    url(url: string): AthenaClientBuilder;
+    /** Set the API key used for all requests. */
+    key(apiKey: string): AthenaClientBuilder;
+    /** Set the default backend routing strategy. */
+    backend(backend: BackendConfig | BackendType): AthenaClientBuilder;
+    /** Set the default Athena client routing key. */
+    client(clientName: string): AthenaClientBuilder;
+    /** Attach static headers to every request. */
+    headers(headers: Record<string, string>): AthenaClientBuilder;
+    /** Enable or disable health tracking metadata. */
+    healthTracking(enabled: boolean): AthenaClientBuilder;
+    /** Build the immutable Athena SDK client. */
+    build(): AthenaSdkClientWithAuth;
+}
+/** Canonical Athena client factory with builder-based configuration. */
+declare class AthenaClient {
+    /** Create a fluent builder for a strongly-typed Athena SDK client. */
+    static builder(): AthenaClientBuilder;
+    /** Build a client from process environment variables. */
+    static fromEnvironment(): AthenaSdkClientWithAuth;
+}
+interface AthenaCreateClientOptions extends Pick<AthenaGatewayCallOptions, 'client' | 'headers' | 'backend'> {
+    auth?: AthenaAuthClientConfig;
+    experimental?: AthenaClientExperimentalOptions;
+}
+/** Create client (convenience wrapper; use AthenaClient.builder() for full control) */
+declare function createClient(url: string, apiKey: string, options?: AthenaCreateClientOptions): AthenaSdkClientWithAuth;
+
+type AthenaErrorKind = 'unique_violation' | 'not_found' | 'validation' | 'auth' | 'rate_limit' | 'transient' | 'unknown';
+declare const AthenaErrorKind: {
+    readonly UniqueViolation: "unique_violation";
+    readonly NotFound: "not_found";
+    readonly Validation: "validation";
+    readonly Auth: "auth";
+    readonly RateLimit: "rate_limit";
+    readonly Transient: "transient";
+    readonly Unknown: "unknown";
+};
+type AthenaErrorCode = 'UNIQUE_VIOLATION' | 'NOT_FOUND' | 'VALIDATION_FAILED' | 'AUTH_UNAUTHORIZED' | 'AUTH_FORBIDDEN' | 'RATE_LIMITED' | 'NETWORK_UNAVAILABLE' | 'TRANSIENT_FAILURE' | 'HTTP_FAILURE' | 'UNKNOWN';
+declare const AthenaErrorCode: {
+    readonly UniqueViolation: "UNIQUE_VIOLATION";
+    readonly NotFound: "NOT_FOUND";
+    readonly ValidationFailed: "VALIDATION_FAILED";
+    readonly AuthUnauthorized: "AUTH_UNAUTHORIZED";
+    readonly AuthForbidden: "AUTH_FORBIDDEN";
+    readonly RateLimited: "RATE_LIMITED";
+    readonly NetworkUnavailable: "NETWORK_UNAVAILABLE";
+    readonly TransientFailure: "TRANSIENT_FAILURE";
+    readonly HttpFailure: "HTTP_FAILURE";
+    readonly Unknown: "UNKNOWN";
+};
+type AthenaErrorCategory = 'transport' | 'client' | 'server' | 'database' | 'unknown';
+declare const AthenaErrorCategory: {
+    readonly Transport: "transport";
+    readonly Client: "client";
+    readonly Server: "server";
+    readonly Database: "database";
+    readonly Unknown: "unknown";
+};
+interface AthenaOperationContext {
+    table?: string;
+    operation?: string;
+    identity?: string | Record<string, unknown>;
+}
+interface NormalizedAthenaError {
+    kind: AthenaErrorKind;
+    code: AthenaErrorCode;
+    category: AthenaErrorCategory;
+    retryable: boolean;
+    status?: number;
+    constraint?: string;
+    table?: string;
+    operation?: string;
+    message: string;
+    raw: unknown;
+}
+interface AthenaErrorInput {
+    code: AthenaErrorCode;
+    kind: AthenaErrorKind;
+    category: AthenaErrorCategory;
+    message: string;
+    status?: number;
+    retryable?: boolean;
+    requestId?: string;
+    context?: AthenaOperationContext;
+    raw?: unknown;
+}
+interface UnwrapOptions {
+    allowNull?: boolean;
+    context?: AthenaOperationContext;
+}
+interface UnwrapOneOptions extends UnwrapOptions {
+    requireExactlyOne?: boolean;
+}
+interface IntCoercionOptions {
+    strictBigInt?: boolean;
+    min?: number;
+    max?: number;
+}
+type RetryBackoffStrategy = 'linear' | 'exponential' | ((attempt: number, error: unknown) => number);
+interface RetryConfig {
+    retries: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    backoff?: RetryBackoffStrategy;
+    jitter?: boolean | number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean | Promise<boolean>;
+}
+interface RequireAffectedOptions {
+    min?: number;
+}
+/**
+ * Parses a string-based boolean flag with a deterministic fallback.
+ *
+ * Accepts common truthy/falsey token variants used by env vars and CLI flags.
+ */
+declare function parseBooleanFlag(rawValue: string | undefined, fallback: boolean): boolean;
+declare class AthenaError extends Error {
+    readonly code: AthenaErrorCode;
+    readonly kind: AthenaErrorKind;
+    readonly category: AthenaErrorCategory;
+    readonly status?: number;
+    readonly retryable: boolean;
+    readonly requestId?: string;
+    readonly context?: AthenaOperationContext;
+    readonly raw?: unknown;
+    constructor(input: AthenaErrorInput);
+}
+/**
+ * Returns `true` when a result is successful (`2xx` status and no `error`).
+ */
+declare function isOk<T>(result: AthenaResult<T>): boolean;
+/**
+ * Normalizes any Athena failure shape into a stable, typed error envelope.
+ *
+ * Accepts `AthenaResult`, `AthenaGatewayError`, native `Error`, or unknown values.
+ * Optional `context` can override inferred table/operation metadata for clearer diagnostics.
+ */
+declare function normalizeAthenaError(resultOrError: unknown, context?: AthenaOperationContext): NormalizedAthenaError;
+/**
+ * Unwraps a successful result into a row array.
+ *
+ * - Throws on failed results.
+ * - Converts `null` data to an empty array.
+ * - Wraps scalar data in a single-element array.
+ */
+declare function unwrapRows<T>(result: AthenaResult<T[] | T | null>, options?: UnwrapOptions): T[];
+/**
+ * Unwraps successful result data from `AthenaResult<T | null>`.
+ *
+ * By default, `null` data throws. Pass `{ allowNull: true }` to permit nullable payloads.
+ */
+declare function unwrap<T>(result: AthenaResult<T | null>, options: UnwrapOptions & {
+    allowNull: true;
+}): T | null;
+declare function unwrap<T>(result: AthenaResult<T | null>, options?: UnwrapOptions): T;
+/**
+ * Unwraps the first row from a successful result that may contain arrays/scalars/null.
+ *
+ * - Throws on failed results.
+ * - Throws when no row exists unless `allowNull: true` is provided.
+ * - Optionally enforces exact cardinality via `requireExactlyOne`.
+ */
+declare function unwrapOne<T>(result: AthenaResult<T[] | T | null>, options: UnwrapOneOptions & {
+    allowNull: true;
+}): T | null;
+declare function unwrapOne<T>(result: AthenaResult<T[] | T | null>, options?: UnwrapOneOptions): T;
+/**
+ * Asserts that an Athena result is successful.
+ *
+ * Returns the original result for fluent composition and throws `AthenaGatewayError` on failure.
+ */
+declare function requireSuccess<T>(result: AthenaResult<T>, context?: AthenaOperationContext): AthenaResult<T>;
+/**
+ * Enforces mutation postconditions based on `result.count`.
+ *
+ * - Validates success first.
+ * - Requires a non-null count in the response.
+ * - Validates `count >= min` (default: `1`).
+ *
+ * Useful for guaranteeing that critical writes actually affected rows.
+ */
+declare function requireAffected<T>(result: AthenaResult<T>, options?: RequireAffectedOptions, context?: AthenaOperationContext): number;
+/**
+ * Safely coerces `unknown` values into finite integers.
+ *
+ * Returns `null` when coercion fails or bounds/strict bigint checks are violated.
+ */
+declare function coerceInt(value: unknown, options?: IntCoercionOptions): number | null;
+/**
+ * Strict integer assertion wrapper around `coerceInt`.
+ *
+ * Throws a `TypeError` with the provided label when coercion fails.
+ */
+declare function assertInt(value: unknown, label?: string, options?: IntCoercionOptions): number;
+/**
+ * Retries an async operation with configurable backoff and retry policy.
+ *
+ * `retries` represents additional attempts after the first failure.
+ * By default, transient and rate-limit errors are retried.
+ */
+declare function withRetry<T>(config: RetryConfig, fn: () => Promise<T>): Promise<T>;
+
+/**
+ * Immutable identifier object with consistent SQL rendering.
+ */
+interface SqlIdentifier {
+    readonly segments: string[];
+    toSql(): string;
+    toString(): string;
+}
+/**
+ * Creates a quoted identifier object from segment or dotted inputs.
+ */
+declare function identifier(...segments: string[]): SqlIdentifier;
+
+/**
+ * Declares a model contract with explicit metadata and typed row/insert/update shapes.
+ */
+declare function defineModel<Row, Insert = Partial<Row>, Update = Partial<Insert>, Meta extends ModelMetadata<Row> = ModelMetadata<Row>>(input: {
+    meta: Meta;
+}): ModelDef<Row, Insert, Update, Meta>;
+/**
+ * Declares a schema-level model map.
+ */
+declare function defineSchema<Models extends Record<string, AnyModelDef>>(models: Models): SchemaDef<Models>;
+/**
+ * Declares a database-level schema map.
+ */
+declare function defineDatabase<Schemas extends Record<string, SchemaDef<Record<string, AnyModelDef>>>>(schemas: Schemas): DatabaseDef<Schemas>;
+/**
+ * Declares a top-level multi-database registry.
+ */
+declare function defineRegistry<Databases extends Record<string, DatabaseDef<Record<string, SchemaDef<Record<string, AnyModelDef>>>>>>(databases: Databases): RegistryDef<Databases>;
+
+type RegistryConstraint = RegistryDef<Record<string, DatabaseDef<Record<string, SchemaDef<Record<string, AnyModelDef>>>>>>;
+/**
+ * Options for creating typed Athena clients.
+ */
+interface TypedClientOptions<TMap extends TenantKeyMap = TenantKeyMap> extends Pick<AthenaGatewayCallOptions, 'backend' | 'client' | 'headers'> {
+    tenantKeyMap?: TMap;
+    tenantContext?: TenantContext<TMap>;
+}
+/**
+ * Typed Athena client with registry-driven model resolution and tenant-context propagation.
+ */
+interface TypedAthenaClient<TRegistry extends RegistryConstraint, TTenantMap extends TenantKeyMap = Record<never, string>> extends AthenaSdkClient {
+    readonly registry: TRegistry;
+    readonly tenantKeyMap: Readonly<TTenantMap>;
+    readonly tenantContext: TenantContext<TTenantMap>;
+    withTenantContext(context: TenantContext<TTenantMap>): TypedAthenaClient<TRegistry, TTenantMap>;
+    fromModel<TDatabase extends keyof TRegistry & string, TSchema extends keyof TRegistry[TDatabase]['schemas'] & string, TModel extends keyof TRegistry[TDatabase]['schemas'][TSchema]['models'] & string>(database: TDatabase, schema: TSchema, model: TModel): TableQueryBuilder<RowOf<ModelAt<TRegistry, TDatabase, TSchema, TModel>>, InsertOf<ModelAt<TRegistry, TDatabase, TSchema, TModel>>, UpdateOf<ModelAt<TRegistry, TDatabase, TSchema, TModel>>>;
+}
+/**
+ * Creates a typed client bound to a registry contract and optional tenant header mapping.
+ */
+declare function createTypedClient<TRegistry extends RegistryConstraint, TTenantMap extends TenantKeyMap = Record<never, string>>(registry: TRegistry, url: string, apiKey: string, options?: TypedClientOptions<TTenantMap>): TypedAthenaClient<TRegistry, TTenantMap>;
+
+/**
+ * Constructor options for the PostgreSQL introspection provider.
+ */
+interface PostgresIntrospectionProviderOptions {
+    connectionString: string;
+    database?: string;
+    schemas?: readonly string[];
+}
+/**
+ * Creates a PostgreSQL-backed schema introspection provider.
+ */
+declare function createPostgresIntrospectionProvider(options: PostgresIntrospectionProviderOptions): SchemaIntrospectionProvider;
+
+declare function resolvePostgresColumnType(column: IntrospectionColumn): string;
+
+declare const DEFAULT_POSTGRES_SCHEMAS: readonly ["public"];
+/**
+ * Normalizes schema selection from config or env-backed strings into a stable,
+ * deduplicated list. Empty selections fall back to PostgreSQL's public schema.
+ */
+declare function normalizeSchemaSelection(input: GeneratorSchemaSelection | undefined): string[];
+/**
+ * Resolves the effective schema list for provider-backed generator runs.
+ */
+declare function resolveProviderSchemas(providerConfig: GeneratorProviderConfig): string[];
+
+/**
+ * @deprecated Prefer `createClient(...).auth` from `@xylex-group/athena`.
+ */
+declare function createAuthClient(config?: AthenaAuthClientConfig): AthenaAuthSdkClient;
+
+export { AthenaClient as A, defineModel as B, defineRegistry as C, DEFAULT_POSTGRES_SCHEMAS as D, defineSchema as E, identifier as F, isOk as G, normalizeAthenaError as H, type IntCoercionOptions as I, normalizeSchemaSelection as J, parseBooleanFlag as K, requireAffected as L, requireSuccess as M, type NormalizedAthenaError as N, resolvePostgresColumnType as O, type PostgresIntrospectionProviderOptions as P, resolveProviderSchemas as Q, type RequireAffectedOptions as R, unwrap as S, type TableQueryBuilder as T, type UnwrapOneOptions as U, unwrapOne as V, unwrapRows as W, withRetry as X, type AthenaClientExperimentalOptions as a, type AthenaCreateClientOptions as b, type AthenaDbModule as c, AthenaError as d, AthenaErrorCategory as e, AthenaErrorCode as f, type AthenaErrorInput as g, AthenaErrorKind as h, type AthenaOperationContext as i, type AthenaResult as j, type AthenaSdkClient as k, type AthenaSdkClientWithAuth as l, type RetryBackoffStrategy as m, type RetryConfig as n, type RpcOrderOptions as o, type RpcQueryBuilder as p, type TypedAthenaClient as q, type TypedClientOptions as r, type UnwrapOptions as s, assertInt as t, coerceInt as u, createAuthClient as v, createClient as w, createPostgresIntrospectionProvider as x, createTypedClient as y, defineDatabase as z };