@xylex-group/athena 2.6.0 → 2.7.0

package/dist/{pipeline-Ce3pTw5h.d.ts → pipeline-BUsR9XlO.d.ts}

@@ -1,4 +1,4 @@
-import { R as RunGeneratorOptions, l as RunGeneratorResult } from './types-DapchQY5.js';
+import { R as RunGeneratorOptions, l as RunGeneratorResult } from './types-t_TVqnmp.js';
 
 /**
  * End-to-end generator execution: load config, introspect, render, and optionally write files.

package/dist/{pipeline-D1ZYeoH7.d.cts → pipeline-BfCWSRYl.d.cts}

@@ -1,4 +1,4 @@
-import { R as RunGeneratorOptions, l as RunGeneratorResult } from './types-CUuo4NDi.cjs';
+import { R as RunGeneratorOptions, l as RunGeneratorResult } from './types-BSIsyss1.cjs';
 
 /**
  * End-to-end generator execution: load config, introspect, render, and optionally write files.

package/dist/react-email-BQzmXBDE.d.cts

@@ -0,0 +1,304 @@
+import { b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, F as SchemaDef, J as AnyModelDef, D as DatabaseDef, y as ModelMetadata, x as ModelDef, R as RegistryDef, H as TenantKeyMap, T as TenantContext, E as RowOf, M as ModelAt, q as InsertOf, U as UpdateOf, a as AthenaGatewayCallOptions, S as SchemaIntrospectionProvider, r as IntrospectionColumn } from './types-BsyRW49r.cjs';
+import { av as AthenaSdkClient, bz as TableQueryBuilder, f as AthenaAuthClientConfig, N as AthenaAuthSdkClient, F as AthenaAuthReactEmailProps, C as AthenaAuthReactEmailComponent, H as AthenaAuthReactEmailRenderInput, k as AthenaAuthEmailTemplateDefinition, i as AthenaAuthEmailTemplateBuilder, I as AthenaAuthReactEmailRenderOptions, G as AthenaAuthReactEmailRenderEvent, D as AthenaAuthReactEmailConfig } from './model-form-ehfqLuG7.cjs';
+import { j as GeneratorSchemaSelection, b as GeneratorProviderConfig } from './types-BSIsyss1.cjs';
+import { A as AthenaCookiesOptions, a as AthenaSessionPair, b as AthenaCookieOptions, c as AthenaAuthCookies, g as getCookieCache, d as getSessionCookie, e as AthenaCookieContextRuntime } from './index-CVcQCGyG.cjs';
+
+declare function verifyAthenaGatewayUrl(baseUrl: string, options?: AthenaGatewayConnectionOptions): Promise<AthenaGatewayConnectionResult>;
+
+interface NormalizeAthenaGatewayBaseUrlOptions {
+    defaultBaseUrl?: string;
+    label?: string;
+}
+declare function normalizeAthenaGatewayBaseUrl(input: string | null | undefined, options?: NormalizeAthenaGatewayBaseUrlOptions): string;
+
+/**
+ * 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>>, {
+        registry: TRegistry;
+        database: TDatabase;
+        schema: TSchema;
+        model: 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;
+
+interface GeneratorEnvBaseOptions<T> {
+    default?: T;
+    optional?: boolean;
+}
+type GeneratorEnvStringOptions = GeneratorEnvBaseOptions<string>;
+type GeneratorEnvBooleanOptions = GeneratorEnvBaseOptions<boolean>;
+interface GeneratorEnvListOptions extends GeneratorEnvBaseOptions<readonly string[]> {
+    separator?: string;
+}
+type GeneratorEnvJsonOptions<T> = GeneratorEnvBaseOptions<T>;
+type GeneratorEnvOneOfOptions<T extends string> = GeneratorEnvBaseOptions<T>;
+type GeneratorEnvHelper = {
+    (key: string, options?: GeneratorEnvStringOptions): string;
+    (key: string, options: GeneratorEnvStringOptions & {
+        optional: true;
+    }): string | undefined;
+    boolean(key: string, options?: GeneratorEnvBooleanOptions): boolean;
+    boolean(key: string, options: GeneratorEnvBooleanOptions & {
+        optional: true;
+    }): boolean | undefined;
+    list(key: string, options?: GeneratorEnvListOptions): string[];
+    list(key: string, options: GeneratorEnvListOptions & {
+        optional: true;
+    }): string[] | undefined;
+    json<T>(key: string, options?: GeneratorEnvJsonOptions<T>): T;
+    json<T>(key: string, options: GeneratorEnvJsonOptions<T> & {
+        optional: true;
+    }): T | undefined;
+    oneOf<const T extends string>(key: string, allowedValues: readonly T[], options?: GeneratorEnvOneOfOptions<T>): T;
+    oneOf<const T extends string>(key: string, allowedValues: readonly T[], options: GeneratorEnvOneOfOptions<T> & {
+        optional: true;
+    }): T | undefined;
+};
+/**
+ * Typed env reader for generator configs. This keeps `athena.config.*` files
+ * declarative while preserving exact field types for booleans, lists, unions,
+ * and JSON-backed objects.
+ */
+declare const generatorEnv: GeneratorEnvHelper;
+
+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;
+
+type AthenaMaybePromise<T> = T | Promise<T>;
+type AthenaAuthServerCookieOptions = Pick<AthenaCookiesOptions, 'session' | 'advanced'>;
+declare const ATHENA_AUTH_BASE_ERROR_CODES: {
+    readonly HANDLER_NOT_CONFIGURED: "HANDLER_NOT_CONFIGURED";
+    readonly INVALID_BASE_URL: "INVALID_BASE_URL";
+    readonly UNTRUSTED_HOST: "UNTRUSTED_HOST";
+};
+interface AthenaAuthSocialProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    scope?: string[];
+    [key: string]: unknown;
+}
+interface AthenaAuthPluginContext {
+    path?: string;
+    headers?: Headers;
+    context: {
+        returned?: unknown;
+        responseHeaders?: Headers;
+        setSession?: AthenaSessionPair | null;
+        clearSession?: boolean;
+        dontRememberMe?: boolean;
+        cookieOverrides?: Partial<AthenaCookieOptions>;
+        [key: string]: unknown;
+    };
+}
+interface AthenaAuthPluginHandlerContext extends AthenaAuthPluginContext {
+    auth: AthenaAuthServer;
+}
+interface AthenaAuthPlugin {
+    id: string;
+    version: string;
+    $ERROR_CODES?: Record<string, string>;
+    hooks?: {
+        after?: Array<{
+            matcher: (ctx: AthenaAuthPluginContext) => boolean;
+            handler: (ctx: AthenaAuthPluginHandlerContext) => Promise<void> | void;
+        }>;
+    };
+}
+interface AthenaAuthCookieRuntimeInput {
+    headers?: Headers;
+    responseHeaders?: Headers;
+    cookies?: AthenaAuthCookies;
+    getCookie?: (name: string) => string | null | undefined;
+    setCookie?: (name: string, value: string, attributes: AthenaCookieOptions) => void;
+    logger?: AthenaCookieContextRuntime['logger'];
+    setSignedCookie?: AthenaCookieContextRuntime['setSignedCookie'];
+    getSignedCookie?: AthenaCookieContextRuntime['getSignedCookie'];
+    setNewSession?: AthenaCookieContextRuntime['context']['setNewSession'];
+}
+interface AthenaAuthServerRuntimeOptions {
+    baseURL?: string;
+    basePath: string;
+    secret: string;
+    cookies: AthenaAuthServerCookieOptions;
+}
+type AthenaAuthDatabaseFactory<TDatabase = unknown> = (options: AthenaAuthServerRuntimeOptions) => TDatabase;
+type AthenaAuthBaseURLConfig = AthenaCookiesOptions['baseURL'];
+type AthenaAuthTrustedOrigins = string[] | ((request?: Request) => AthenaMaybePromise<string[]>);
+type AthenaAuthTrustedProviders = string[] | ((request?: Request) => AthenaMaybePromise<string[]>);
+interface AthenaAuthHandlerResult {
+    response?: Response;
+    returned?: unknown;
+    setSession?: AthenaSessionPair | null;
+    clearSession?: boolean;
+    dontRememberMe?: boolean;
+    cookieOverrides?: Partial<AthenaCookieOptions>;
+}
+interface AthenaAuthServerConfig<TDatabase = unknown> extends AthenaAuthServerCookieOptions {
+    baseURL?: AthenaAuthBaseURLConfig;
+    basePath?: string;
+    secret: string;
+    database: TDatabase | AthenaAuthDatabaseFactory<TDatabase>;
+    socialProviders?: Record<string, AthenaAuthSocialProviderConfig>;
+    trustedOrigins?: AthenaAuthTrustedOrigins;
+    trustedProviders?: AthenaAuthTrustedProviders;
+    api?: Record<string, unknown>;
+    errorCodes?: Record<string, string>;
+    handler?: (ctx: AthenaAuthRequestContext) => AthenaMaybePromise<Response | AthenaAuthHandlerResult>;
+    plugins?: AthenaAuthPlugin[];
+}
+type ResolveAthenaAuthDatabase<TConfig extends AthenaAuthServerConfig> = TConfig['database'] extends (...args: never[]) => infer TResult ? TResult : TConfig['database'];
+interface AthenaAuthRequestContext<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    auth: AthenaAuthServer<TConfig>;
+    request: Request;
+    url: URL;
+    path: string;
+    basePath: string;
+    baseURL: string;
+    origin: string;
+    headers: Headers;
+    cookies: AthenaAuthCookies;
+    trustedOrigins: string[];
+    trustedProviders: string[];
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+}
+interface AthenaAuthContext<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    auth: AthenaAuthServer<TConfig>;
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    basePath: string;
+    baseURL?: string;
+    origin?: string;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+    plugins: AthenaAuthPlugin[];
+    cookies: AthenaAuthCookies;
+    trustedOrigins: string[];
+    trustedProviders: string[];
+}
+interface AthenaAuthServerApi<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    applyResponseCookies: AthenaAuthServer<TConfig>['applyResponseCookies'];
+    clearSession: AthenaAuthServer<TConfig>['clearSession'];
+    createCookieContext: AthenaAuthServer<TConfig>['createCookieContext'];
+    getCookieCache: typeof getCookieCache;
+    getSessionCookie: typeof getSessionCookie;
+    resolveRequestContext: AthenaAuthServer<TConfig>['resolveRequestContext'];
+    runAfterHooks: AthenaAuthServer<TConfig>['runAfterHooks'];
+    setSession: AthenaAuthServer<TConfig>['setSession'];
+}
+interface AthenaAuthServer<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    config: TConfig;
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+    plugins: AthenaAuthPlugin[];
+    cookies: AthenaAuthCookies;
+    api: AthenaAuthServerApi<TConfig> & Record<string, unknown>;
+    $context: Promise<AthenaAuthContext<TConfig>>;
+    $ERROR_CODES: Record<string, string>;
+    createCookieContext: (input?: AthenaAuthCookieRuntimeInput) => AthenaCookieContextRuntime;
+    setSession: (input: AthenaAuthCookieRuntimeInput | undefined, session: AthenaSessionPair, dontRememberMe?: boolean, overrides?: Partial<AthenaCookieOptions>) => Promise<void>;
+    clearSession: (input?: AthenaAuthCookieRuntimeInput, skipDontRememberMe?: boolean) => void;
+    applyResponseCookies: (ctx: AthenaAuthPluginContext) => Promise<Headers>;
+    runAfterHooks: (ctx: AthenaAuthPluginContext) => Promise<AthenaAuthPluginContext>;
+    resolveRequestContext: (request: Request) => Promise<AthenaAuthRequestContext<TConfig>>;
+    handler: (request: Request) => Promise<Response>;
+}
+declare function defineAthenaAuthConfig<TConfig extends AthenaAuthServerConfig>(config: TConfig): TConfig;
+declare function athenaAuth<TConfig extends AthenaAuthServerConfig>(config: TConfig): AthenaAuthServer<TConfig>;
+
+interface AthenaAuthRenderedReactEmail {
+    html: string;
+    text?: string;
+}
+interface AthenaAuthReactEmailRuntimeOptions {
+    route?: string;
+    defaults?: AthenaAuthReactEmailRenderOptions;
+    observe?: (event: AthenaAuthReactEmailRenderEvent) => void;
+}
+declare function createAuthReactEmailInput<TProps extends AthenaAuthReactEmailProps = AthenaAuthReactEmailProps>(component: AthenaAuthReactEmailComponent<TProps>, props: TProps, overrides?: Omit<AthenaAuthReactEmailRenderInput, 'component' | 'props' | 'element'>): AthenaAuthReactEmailRenderInput;
+declare function defineAuthEmailTemplate<TProps extends AthenaAuthReactEmailProps = AthenaAuthReactEmailProps>(definition: AthenaAuthEmailTemplateDefinition<TProps>): AthenaAuthEmailTemplateBuilder<TProps>;
+declare function renderAthenaReactEmail(input: AthenaAuthReactEmailRenderInput, options?: AthenaAuthReactEmailRuntimeOptions | AthenaAuthReactEmailConfig): Promise<AthenaAuthRenderedReactEmail>;
+
+export { ATHENA_AUTH_BASE_ERROR_CODES as A, defineAthenaAuthConfig as B, defineAuthEmailTemplate as C, DEFAULT_POSTGRES_SCHEMAS as D, defineDatabase as E, defineModel as F, type GeneratorEnvBooleanOptions as G, defineRegistry as H, defineSchema as I, generatorEnv as J, identifier as K, normalizeAthenaGatewayBaseUrl as L, normalizeSchemaSelection as M, renderAthenaReactEmail as N, resolvePostgresColumnType as O, type PostgresIntrospectionProviderOptions as P, resolveProviderSchemas as Q, verifyAthenaGatewayUrl as R, type TypedAthenaClient as T, type AthenaAuthBaseURLConfig as a, type AthenaAuthContext as b, type AthenaAuthCookieRuntimeInput as c, type AthenaAuthDatabaseFactory as d, type AthenaAuthHandlerResult as e, type AthenaAuthPlugin as f, type AthenaAuthPluginContext as g, type AthenaAuthPluginHandlerContext as h, type AthenaAuthRequestContext as i, type AthenaAuthServer as j, type AthenaAuthServerApi as k, type AthenaAuthServerConfig as l, type AthenaAuthServerRuntimeOptions as m, type AthenaAuthSocialProviderConfig as n, type AthenaAuthTrustedOrigins as o, type AthenaAuthTrustedProviders as p, type GeneratorEnvJsonOptions as q, type GeneratorEnvListOptions as r, type GeneratorEnvOneOfOptions as s, type GeneratorEnvStringOptions as t, type TypedClientOptions as u, athenaAuth as v, createAuthClient as w, createAuthReactEmailInput as x, createPostgresIntrospectionProvider as y, createTypedClient as z };

package/dist/react-email-BrVRp80B.d.ts

@@ -0,0 +1,304 @@
+import { b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, F as SchemaDef, J as AnyModelDef, D as DatabaseDef, y as ModelMetadata, x as ModelDef, R as RegistryDef, H as TenantKeyMap, T as TenantContext, E as RowOf, M as ModelAt, q as InsertOf, U as UpdateOf, a as AthenaGatewayCallOptions, S as SchemaIntrospectionProvider, r as IntrospectionColumn } from './types-BsyRW49r.js';
+import { av as AthenaSdkClient, bz as TableQueryBuilder, f as AthenaAuthClientConfig, N as AthenaAuthSdkClient, F as AthenaAuthReactEmailProps, C as AthenaAuthReactEmailComponent, H as AthenaAuthReactEmailRenderInput, k as AthenaAuthEmailTemplateDefinition, i as AthenaAuthEmailTemplateBuilder, I as AthenaAuthReactEmailRenderOptions, G as AthenaAuthReactEmailRenderEvent, D as AthenaAuthReactEmailConfig } from './model-form-AKYrgede.js';
+import { j as GeneratorSchemaSelection, b as GeneratorProviderConfig } from './types-t_TVqnmp.js';
+import { A as AthenaCookiesOptions, a as AthenaSessionPair, b as AthenaCookieOptions, c as AthenaAuthCookies, g as getCookieCache, d as getSessionCookie, e as AthenaCookieContextRuntime } from './index-CVcQCGyG.js';
+
+declare function verifyAthenaGatewayUrl(baseUrl: string, options?: AthenaGatewayConnectionOptions): Promise<AthenaGatewayConnectionResult>;
+
+interface NormalizeAthenaGatewayBaseUrlOptions {
+    defaultBaseUrl?: string;
+    label?: string;
+}
+declare function normalizeAthenaGatewayBaseUrl(input: string | null | undefined, options?: NormalizeAthenaGatewayBaseUrlOptions): string;
+
+/**
+ * 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>>, {
+        registry: TRegistry;
+        database: TDatabase;
+        schema: TSchema;
+        model: 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;
+
+interface GeneratorEnvBaseOptions<T> {
+    default?: T;
+    optional?: boolean;
+}
+type GeneratorEnvStringOptions = GeneratorEnvBaseOptions<string>;
+type GeneratorEnvBooleanOptions = GeneratorEnvBaseOptions<boolean>;
+interface GeneratorEnvListOptions extends GeneratorEnvBaseOptions<readonly string[]> {
+    separator?: string;
+}
+type GeneratorEnvJsonOptions<T> = GeneratorEnvBaseOptions<T>;
+type GeneratorEnvOneOfOptions<T extends string> = GeneratorEnvBaseOptions<T>;
+type GeneratorEnvHelper = {
+    (key: string, options?: GeneratorEnvStringOptions): string;
+    (key: string, options: GeneratorEnvStringOptions & {
+        optional: true;
+    }): string | undefined;
+    boolean(key: string, options?: GeneratorEnvBooleanOptions): boolean;
+    boolean(key: string, options: GeneratorEnvBooleanOptions & {
+        optional: true;
+    }): boolean | undefined;
+    list(key: string, options?: GeneratorEnvListOptions): string[];
+    list(key: string, options: GeneratorEnvListOptions & {
+        optional: true;
+    }): string[] | undefined;
+    json<T>(key: string, options?: GeneratorEnvJsonOptions<T>): T;
+    json<T>(key: string, options: GeneratorEnvJsonOptions<T> & {
+        optional: true;
+    }): T | undefined;
+    oneOf<const T extends string>(key: string, allowedValues: readonly T[], options?: GeneratorEnvOneOfOptions<T>): T;
+    oneOf<const T extends string>(key: string, allowedValues: readonly T[], options: GeneratorEnvOneOfOptions<T> & {
+        optional: true;
+    }): T | undefined;
+};
+/**
+ * Typed env reader for generator configs. This keeps `athena.config.*` files
+ * declarative while preserving exact field types for booleans, lists, unions,
+ * and JSON-backed objects.
+ */
+declare const generatorEnv: GeneratorEnvHelper;
+
+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;
+
+type AthenaMaybePromise<T> = T | Promise<T>;
+type AthenaAuthServerCookieOptions = Pick<AthenaCookiesOptions, 'session' | 'advanced'>;
+declare const ATHENA_AUTH_BASE_ERROR_CODES: {
+    readonly HANDLER_NOT_CONFIGURED: "HANDLER_NOT_CONFIGURED";
+    readonly INVALID_BASE_URL: "INVALID_BASE_URL";
+    readonly UNTRUSTED_HOST: "UNTRUSTED_HOST";
+};
+interface AthenaAuthSocialProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    scope?: string[];
+    [key: string]: unknown;
+}
+interface AthenaAuthPluginContext {
+    path?: string;
+    headers?: Headers;
+    context: {
+        returned?: unknown;
+        responseHeaders?: Headers;
+        setSession?: AthenaSessionPair | null;
+        clearSession?: boolean;
+        dontRememberMe?: boolean;
+        cookieOverrides?: Partial<AthenaCookieOptions>;
+        [key: string]: unknown;
+    };
+}
+interface AthenaAuthPluginHandlerContext extends AthenaAuthPluginContext {
+    auth: AthenaAuthServer;
+}
+interface AthenaAuthPlugin {
+    id: string;
+    version: string;
+    $ERROR_CODES?: Record<string, string>;
+    hooks?: {
+        after?: Array<{
+            matcher: (ctx: AthenaAuthPluginContext) => boolean;
+            handler: (ctx: AthenaAuthPluginHandlerContext) => Promise<void> | void;
+        }>;
+    };
+}
+interface AthenaAuthCookieRuntimeInput {
+    headers?: Headers;
+    responseHeaders?: Headers;
+    cookies?: AthenaAuthCookies;
+    getCookie?: (name: string) => string | null | undefined;
+    setCookie?: (name: string, value: string, attributes: AthenaCookieOptions) => void;
+    logger?: AthenaCookieContextRuntime['logger'];
+    setSignedCookie?: AthenaCookieContextRuntime['setSignedCookie'];
+    getSignedCookie?: AthenaCookieContextRuntime['getSignedCookie'];
+    setNewSession?: AthenaCookieContextRuntime['context']['setNewSession'];
+}
+interface AthenaAuthServerRuntimeOptions {
+    baseURL?: string;
+    basePath: string;
+    secret: string;
+    cookies: AthenaAuthServerCookieOptions;
+}
+type AthenaAuthDatabaseFactory<TDatabase = unknown> = (options: AthenaAuthServerRuntimeOptions) => TDatabase;
+type AthenaAuthBaseURLConfig = AthenaCookiesOptions['baseURL'];
+type AthenaAuthTrustedOrigins = string[] | ((request?: Request) => AthenaMaybePromise<string[]>);
+type AthenaAuthTrustedProviders = string[] | ((request?: Request) => AthenaMaybePromise<string[]>);
+interface AthenaAuthHandlerResult {
+    response?: Response;
+    returned?: unknown;
+    setSession?: AthenaSessionPair | null;
+    clearSession?: boolean;
+    dontRememberMe?: boolean;
+    cookieOverrides?: Partial<AthenaCookieOptions>;
+}
+interface AthenaAuthServerConfig<TDatabase = unknown> extends AthenaAuthServerCookieOptions {
+    baseURL?: AthenaAuthBaseURLConfig;
+    basePath?: string;
+    secret: string;
+    database: TDatabase | AthenaAuthDatabaseFactory<TDatabase>;
+    socialProviders?: Record<string, AthenaAuthSocialProviderConfig>;
+    trustedOrigins?: AthenaAuthTrustedOrigins;
+    trustedProviders?: AthenaAuthTrustedProviders;
+    api?: Record<string, unknown>;
+    errorCodes?: Record<string, string>;
+    handler?: (ctx: AthenaAuthRequestContext) => AthenaMaybePromise<Response | AthenaAuthHandlerResult>;
+    plugins?: AthenaAuthPlugin[];
+}
+type ResolveAthenaAuthDatabase<TConfig extends AthenaAuthServerConfig> = TConfig['database'] extends (...args: never[]) => infer TResult ? TResult : TConfig['database'];
+interface AthenaAuthRequestContext<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    auth: AthenaAuthServer<TConfig>;
+    request: Request;
+    url: URL;
+    path: string;
+    basePath: string;
+    baseURL: string;
+    origin: string;
+    headers: Headers;
+    cookies: AthenaAuthCookies;
+    trustedOrigins: string[];
+    trustedProviders: string[];
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+}
+interface AthenaAuthContext<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    auth: AthenaAuthServer<TConfig>;
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    basePath: string;
+    baseURL?: string;
+    origin?: string;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+    plugins: AthenaAuthPlugin[];
+    cookies: AthenaAuthCookies;
+    trustedOrigins: string[];
+    trustedProviders: string[];
+}
+interface AthenaAuthServerApi<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    applyResponseCookies: AthenaAuthServer<TConfig>['applyResponseCookies'];
+    clearSession: AthenaAuthServer<TConfig>['clearSession'];
+    createCookieContext: AthenaAuthServer<TConfig>['createCookieContext'];
+    getCookieCache: typeof getCookieCache;
+    getSessionCookie: typeof getSessionCookie;
+    resolveRequestContext: AthenaAuthServer<TConfig>['resolveRequestContext'];
+    runAfterHooks: AthenaAuthServer<TConfig>['runAfterHooks'];
+    setSession: AthenaAuthServer<TConfig>['setSession'];
+}
+interface AthenaAuthServer<TConfig extends AthenaAuthServerConfig = AthenaAuthServerConfig> {
+    config: TConfig;
+    options: TConfig;
+    runtime: AthenaAuthServerRuntimeOptions;
+    database: ResolveAthenaAuthDatabase<TConfig>;
+    socialProviders: NonNullable<TConfig['socialProviders']>;
+    plugins: AthenaAuthPlugin[];
+    cookies: AthenaAuthCookies;
+    api: AthenaAuthServerApi<TConfig> & Record<string, unknown>;
+    $context: Promise<AthenaAuthContext<TConfig>>;
+    $ERROR_CODES: Record<string, string>;
+    createCookieContext: (input?: AthenaAuthCookieRuntimeInput) => AthenaCookieContextRuntime;
+    setSession: (input: AthenaAuthCookieRuntimeInput | undefined, session: AthenaSessionPair, dontRememberMe?: boolean, overrides?: Partial<AthenaCookieOptions>) => Promise<void>;
+    clearSession: (input?: AthenaAuthCookieRuntimeInput, skipDontRememberMe?: boolean) => void;
+    applyResponseCookies: (ctx: AthenaAuthPluginContext) => Promise<Headers>;
+    runAfterHooks: (ctx: AthenaAuthPluginContext) => Promise<AthenaAuthPluginContext>;
+    resolveRequestContext: (request: Request) => Promise<AthenaAuthRequestContext<TConfig>>;
+    handler: (request: Request) => Promise<Response>;
+}
+declare function defineAthenaAuthConfig<TConfig extends AthenaAuthServerConfig>(config: TConfig): TConfig;
+declare function athenaAuth<TConfig extends AthenaAuthServerConfig>(config: TConfig): AthenaAuthServer<TConfig>;
+
+interface AthenaAuthRenderedReactEmail {
+    html: string;
+    text?: string;
+}
+interface AthenaAuthReactEmailRuntimeOptions {
+    route?: string;
+    defaults?: AthenaAuthReactEmailRenderOptions;
+    observe?: (event: AthenaAuthReactEmailRenderEvent) => void;
+}
+declare function createAuthReactEmailInput<TProps extends AthenaAuthReactEmailProps = AthenaAuthReactEmailProps>(component: AthenaAuthReactEmailComponent<TProps>, props: TProps, overrides?: Omit<AthenaAuthReactEmailRenderInput, 'component' | 'props' | 'element'>): AthenaAuthReactEmailRenderInput;
+declare function defineAuthEmailTemplate<TProps extends AthenaAuthReactEmailProps = AthenaAuthReactEmailProps>(definition: AthenaAuthEmailTemplateDefinition<TProps>): AthenaAuthEmailTemplateBuilder<TProps>;
+declare function renderAthenaReactEmail(input: AthenaAuthReactEmailRenderInput, options?: AthenaAuthReactEmailRuntimeOptions | AthenaAuthReactEmailConfig): Promise<AthenaAuthRenderedReactEmail>;
+
+export { ATHENA_AUTH_BASE_ERROR_CODES as A, defineAthenaAuthConfig as B, defineAuthEmailTemplate as C, DEFAULT_POSTGRES_SCHEMAS as D, defineDatabase as E, defineModel as F, type GeneratorEnvBooleanOptions as G, defineRegistry as H, defineSchema as I, generatorEnv as J, identifier as K, normalizeAthenaGatewayBaseUrl as L, normalizeSchemaSelection as M, renderAthenaReactEmail as N, resolvePostgresColumnType as O, type PostgresIntrospectionProviderOptions as P, resolveProviderSchemas as Q, verifyAthenaGatewayUrl as R, type TypedAthenaClient as T, type AthenaAuthBaseURLConfig as a, type AthenaAuthContext as b, type AthenaAuthCookieRuntimeInput as c, type AthenaAuthDatabaseFactory as d, type AthenaAuthHandlerResult as e, type AthenaAuthPlugin as f, type AthenaAuthPluginContext as g, type AthenaAuthPluginHandlerContext as h, type AthenaAuthRequestContext as i, type AthenaAuthServer as j, type AthenaAuthServerApi as k, type AthenaAuthServerConfig as l, type AthenaAuthServerRuntimeOptions as m, type AthenaAuthSocialProviderConfig as n, type AthenaAuthTrustedOrigins as o, type AthenaAuthTrustedProviders as p, type GeneratorEnvJsonOptions as q, type GeneratorEnvListOptions as r, type GeneratorEnvOneOfOptions as s, type GeneratorEnvStringOptions as t, type TypedClientOptions as u, athenaAuth as v, createAuthClient as w, createAuthReactEmailInput as x, createPostgresIntrospectionProvider as y, createTypedClient as z };