@xylex-group/athena 3.0.0 → 3.0.3

package/dist/{types-jClgDy1J.d.ts → types-B75PdABb.d.ts}

@@ -249,4 +249,4 @@ interface SchemaIntrospectionProvider {
     inspect(options?: IntrospectionInspectOptions): Promise<IntrospectionSnapshot>;
 }
 
-export type { AthenaModelTarget as A, DatabaseDef as D, IntrospectionSnapshot as I, ModelAt as M, RegistryDef as R, SchemaIntrospectionProvider as S, TenantContext as T, UpdateOf as U, InsertOf as a, IntrospectionColumn as b, IntrospectionInspectOptions as c, IntrospectionRelation as d, IntrospectionSchema as e, IntrospectionTable as f, IntrospectionTypeKind as g, ModelColumnKind as h, ModelColumnMetadata as i, ModelDef as j, ModelMetadata as k, ModelRelationKind as l, ModelRelationMetadata as m, RowOf as n, SchemaDef as o, TenantContextValue as p, TenantKeyMap as q, AnyModelDef as r, AthenaClientModelForTableName as s, AthenaClientModelsInput as t, AthenaClientTableName as u };
+export type { AthenaModelTarget as A, DatabaseDef as D, IntrospectionSnapshot as I, ModelAt as M, RegistryDef as R, SchemaIntrospectionProvider as S, TenantContext as T, UpdateOf as U, InsertOf as a, IntrospectionColumn as b, IntrospectionInspectOptions as c, IntrospectionRelation as d, IntrospectionSchema as e, IntrospectionTable as f, IntrospectionTypeKind as g, ModelColumnKind as h, ModelColumnMetadata as i, ModelDef as j, ModelMetadata as k, ModelRelationKind as l, ModelRelationMetadata as m, RowOf as n, SchemaDef as o, TenantContextValue as p, TenantKeyMap as q, AthenaClientModelsInput as r, AnyModelDef as s, AthenaClientModelForTableName as t, AthenaClientTableName as u };

package/dist/{types-kO_Ut5wU.d.cts → types-CgCv5o6R.d.cts}

@@ -249,4 +249,4 @@ interface SchemaIntrospectionProvider {
     inspect(options?: IntrospectionInspectOptions): Promise<IntrospectionSnapshot>;
 }
 
-export type { AthenaModelTarget as A, DatabaseDef as D, IntrospectionSnapshot as I, ModelAt as M, RegistryDef as R, SchemaIntrospectionProvider as S, TenantContext as T, UpdateOf as U, InsertOf as a, IntrospectionColumn as b, IntrospectionInspectOptions as c, IntrospectionRelation as d, IntrospectionSchema as e, IntrospectionTable as f, IntrospectionTypeKind as g, ModelColumnKind as h, ModelColumnMetadata as i, ModelDef as j, ModelMetadata as k, ModelRelationKind as l, ModelRelationMetadata as m, RowOf as n, SchemaDef as o, TenantContextValue as p, TenantKeyMap as q, AnyModelDef as r, AthenaClientModelForTableName as s, AthenaClientModelsInput as t, AthenaClientTableName as u };
+export type { AthenaModelTarget as A, DatabaseDef as D, IntrospectionSnapshot as I, ModelAt as M, RegistryDef as R, SchemaIntrospectionProvider as S, TenantContext as T, UpdateOf as U, InsertOf as a, IntrospectionColumn as b, IntrospectionInspectOptions as c, IntrospectionRelation as d, IntrospectionSchema as e, IntrospectionTable as f, IntrospectionTypeKind as g, ModelColumnKind as h, ModelColumnMetadata as i, ModelDef as j, ModelMetadata as k, ModelRelationKind as l, ModelRelationMetadata as m, RowOf as n, SchemaDef as o, TenantContextValue as p, TenantKeyMap as q, AthenaClientModelsInput as r, AnyModelDef as s, AthenaClientModelForTableName as t, AthenaClientTableName as u };

package/dist/{types-CK7cBQbC.d.ts → types-D6tZ9aoq.d.ts}

@@ -1,5 +1,5 @@
 import { p as BackendType } from './types-Bltx6iL6.js';
-import { I as IntrospectionSnapshot, S as SchemaIntrospectionProvider } from './types-jClgDy1J.js';
+import { I as IntrospectionSnapshot, S as SchemaIntrospectionProvider } from './types-B75PdABb.js';
 
 /**
  * Supported case transformations for generated symbols and path token variants.
@@ -54,6 +54,21 @@ interface GeneratorOutputTargets {
 }
 type GeneratorOutputPreset = 'legacy' | 'athena-direct';
 type GeneratorOutputFormat = 'define-model' | 'table-builder';
+/**
+ * How existing database/registry artifacts are handled on regenerate.
+ *
+ * - `merge` (default): additive smart merge — append missing imports/keys, preserve custom code
+ * - `skip`: never rewrite existing files (legacy protect behavior)
+ * - `overwrite`: always replace with pure generated content
+ */
+type GeneratorArtifactWritePolicy = 'merge' | 'skip' | 'overwrite';
+/**
+ * Per-kind write policy for protected generator artifacts.
+ */
+interface GeneratorArtifactWriteConfig {
+    database?: GeneratorArtifactWritePolicy;
+    registry?: GeneratorArtifactWritePolicy;
+}
 /**
  * Output configuration including dynamic placeholder aliases.
  */
@@ -62,6 +77,7 @@ interface GeneratorOutputConfig {
     preset?: GeneratorOutputPreset;
     targets?: Partial<GeneratorOutputTargets>;
     placeholderMap?: Record<string, string>;
+    artifactWrite?: GeneratorArtifactWriteConfig;
 }
 /**
  * Normalized output configuration with defaults applied.
@@ -71,6 +87,10 @@ interface NormalizedGeneratorOutputConfig {
     preset: GeneratorOutputPreset;
     targets: GeneratorOutputTargets;
     placeholderMap: Record<string, string>;
+    artifactWrite: {
+        database: GeneratorArtifactWritePolicy;
+        registry: GeneratorArtifactWritePolicy;
+    };
 }
 /**
  * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
@@ -215,13 +235,26 @@ interface RunGeneratorResult extends GeneratedArtifacts {
     configPath: string;
     config: NormalizedAthenaGeneratorConfig;
     writtenFiles: string[];
+    writtenDetails: WrittenGeneratedArtifact[];
     skippedFiles: SkippedGeneratedArtifact[];
 }
-type SkippedGeneratedArtifactReason = 'protected-existing-file';
+type SkippedGeneratedArtifactReason = 'protected-existing-file' | 'merge-conflict' | 'merge-lint-failed' | 'merge-unparseable' | 'already-current';
+type WrittenGeneratedArtifactReason = 'created' | 'overwritten' | 'merged';
 interface SkippedGeneratedArtifact {
     kind: GeneratorArtifactKind;
     path: string;
     reason: SkippedGeneratedArtifactReason;
+    detail?: string;
+    preservedCustom?: string[];
+    conflicts?: string[];
+    lintErrors?: string[];
+}
+interface WrittenGeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    reason: WrittenGeneratedArtifactReason;
+    added?: string[];
+    preservedCustom?: string[];
 }
 
 export type { AthenaGeneratorConfig as A, GeneratedArtifacts as G, LoadGeneratorConfigOptions as L, NormalizedAthenaGeneratorConfig as N, RunGeneratorOptions as R, SkippedGeneratedArtifact as S, LoadedGeneratorConfig as a, GeneratorProviderConfig as b, GeneratorExperimentalFlags as c, RunGeneratorResult as d, GeneratedArtifact as e, GeneratorArtifactKind as f, GeneratorFeatureFlags as g, GeneratorFilterConfig as h, GeneratorInternalConfig as i, GeneratorNamingConfig as j, GeneratorOutputConfig as k, GeneratorOutputFormat as l, GeneratorOutputPreset as m, GeneratorOutputTargets as n, GeneratorSchemaSelection as o, GeneratorTableSelection as p, NamingStyle as q, NormalizedGeneratorFilterConfig as r, NormalizedGeneratorOutputConfig as s, SkippedGeneratedArtifactReason as t };

package/dist/{types-Z3-rsiM3.d.cts → types-DFr2cL1N.d.cts}

@@ -1,5 +1,5 @@
 import { p as BackendType } from './types-Bltx6iL6.cjs';
-import { I as IntrospectionSnapshot, S as SchemaIntrospectionProvider } from './types-kO_Ut5wU.cjs';
+import { I as IntrospectionSnapshot, S as SchemaIntrospectionProvider } from './types-CgCv5o6R.cjs';
 
 /**
  * Supported case transformations for generated symbols and path token variants.
@@ -54,6 +54,21 @@ interface GeneratorOutputTargets {
 }
 type GeneratorOutputPreset = 'legacy' | 'athena-direct';
 type GeneratorOutputFormat = 'define-model' | 'table-builder';
+/**
+ * How existing database/registry artifacts are handled on regenerate.
+ *
+ * - `merge` (default): additive smart merge — append missing imports/keys, preserve custom code
+ * - `skip`: never rewrite existing files (legacy protect behavior)
+ * - `overwrite`: always replace with pure generated content
+ */
+type GeneratorArtifactWritePolicy = 'merge' | 'skip' | 'overwrite';
+/**
+ * Per-kind write policy for protected generator artifacts.
+ */
+interface GeneratorArtifactWriteConfig {
+    database?: GeneratorArtifactWritePolicy;
+    registry?: GeneratorArtifactWritePolicy;
+}
 /**
  * Output configuration including dynamic placeholder aliases.
  */
@@ -62,6 +77,7 @@ interface GeneratorOutputConfig {
     preset?: GeneratorOutputPreset;
     targets?: Partial<GeneratorOutputTargets>;
     placeholderMap?: Record<string, string>;
+    artifactWrite?: GeneratorArtifactWriteConfig;
 }
 /**
  * Normalized output configuration with defaults applied.
@@ -71,6 +87,10 @@ interface NormalizedGeneratorOutputConfig {
     preset: GeneratorOutputPreset;
     targets: GeneratorOutputTargets;
     placeholderMap: Record<string, string>;
+    artifactWrite: {
+        database: GeneratorArtifactWritePolicy;
+        registry: GeneratorArtifactWritePolicy;
+    };
 }
 /**
  * Schemas selected for PostgreSQL introspection. Strings may be comma-separated
@@ -215,13 +235,26 @@ interface RunGeneratorResult extends GeneratedArtifacts {
     configPath: string;
     config: NormalizedAthenaGeneratorConfig;
     writtenFiles: string[];
+    writtenDetails: WrittenGeneratedArtifact[];
     skippedFiles: SkippedGeneratedArtifact[];
 }
-type SkippedGeneratedArtifactReason = 'protected-existing-file';
+type SkippedGeneratedArtifactReason = 'protected-existing-file' | 'merge-conflict' | 'merge-lint-failed' | 'merge-unparseable' | 'already-current';
+type WrittenGeneratedArtifactReason = 'created' | 'overwritten' | 'merged';
 interface SkippedGeneratedArtifact {
     kind: GeneratorArtifactKind;
     path: string;
     reason: SkippedGeneratedArtifactReason;
+    detail?: string;
+    preservedCustom?: string[];
+    conflicts?: string[];
+    lintErrors?: string[];
+}
+interface WrittenGeneratedArtifact {
+    kind: GeneratorArtifactKind;
+    path: string;
+    reason: WrittenGeneratedArtifactReason;
+    added?: string[];
+    preservedCustom?: string[];
 }
 
 export type { AthenaGeneratorConfig as A, GeneratedArtifacts as G, LoadGeneratorConfigOptions as L, NormalizedAthenaGeneratorConfig as N, RunGeneratorOptions as R, SkippedGeneratedArtifact as S, LoadedGeneratorConfig as a, GeneratorProviderConfig as b, GeneratorExperimentalFlags as c, RunGeneratorResult as d, GeneratedArtifact as e, GeneratorArtifactKind as f, GeneratorFeatureFlags as g, GeneratorFilterConfig as h, GeneratorInternalConfig as i, GeneratorNamingConfig as j, GeneratorOutputConfig as k, GeneratorOutputFormat as l, GeneratorOutputPreset as m, GeneratorOutputTargets as n, GeneratorSchemaSelection as o, GeneratorTableSelection as p, NamingStyle as q, NormalizedGeneratorFilterConfig as r, NormalizedGeneratorOutputConfig as s, SkippedGeneratedArtifactReason as t };

package/dist/utils.d.cts

@@ -1,154 +1,16 @@
-import { E as EnvLike } from './athena-auth-url-oLux_57a.cjs';
-export { A as ATHENA_AUTH_COOKIE_PREFIXES, o as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, p as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, q as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, t as ATHENA_AUTH_GET_SESSION_PATH, a as ATHENA_AUTH_PATH, b as ATHENA_AUTH_UPSTREAM_ENV_KEYS, c as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, u as ATHENA_AUTH_VERIFY_EMAIL_PATH, v as ATHENA_SESSION_DATA_HEADER, w as AUTHENTICATED_REDIRECT_MODE_SET, x as AUTHENTICATED_REDIRECT_VIEW_SET, d as AUTH_DEFAULT_VIEW, y as AUTH_MODE_REDIRECTS, z as AUTH_MODE_SET, e as AUTH_ROUTES, B as AUTH_SESSION_PATH, F as AUTH_TWO_FACTOR_SEGMENT, f as AUTH_VIEW_BY_SEGMENT, G as AthenaAuthClientBaseUrlOptions, H as AthenaAuthUpstreamEnv, I as AthenaAuthUpstreamEnvKey, J as AuthMode, K as AuthModeRedirects, L as AuthRoutes, g as AuthView, C as ClearAuthCookiesOptions, D as DEFAULT_ATHENA_AUTH_ORIGIN, M as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, N as DEFAULT_AUTH_COOKIE_PREFIXES, O as DISABLE_COOKIE_CACHE_QUERY_PARAM, P as DISABLE_COOKIE_CACHE_QUERY_VALUE, Q as LOCAL_DEV_ORIGIN, S as SESSION_DATA_HEADER, h as clearAuthCookies, R as createAuthModeRedirects, T as createAuthRoutes, U as createFreshSessionLookupUrl, i as isAbsoluteUrl, V as isAuthMode, n as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, r as resolveAthenaAuthClientBaseUrl, j as resolveAthenaAuthRequestUrl, k as resolveAthenaAuthUpstreamUrl, X as resolveAuthModeRedirect, l as resolveAuthViewFromSegment, m as resolveEmailVerificationCallbackUrl, Y as shouldRedirectAuthenticatedAuthMode, s as shouldRedirectAuthenticatedAuthView } from './athena-auth-url-oLux_57a.cjs';
+export { A as ATHENA_AUTH_COOKIE_PREFIXES, a as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, b as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, c as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, d as ATHENA_AUTH_GET_SESSION_PATH, e as ATHENA_AUTH_PATH, f as ATHENA_AUTH_UPSTREAM_ENV_KEYS, g as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, h as ATHENA_AUTH_VERIFY_EMAIL_PATH, i as ATHENA_SESSION_DATA_HEADER, j as AUTHENTICATED_REDIRECT_MODE_SET, k as AUTHENTICATED_REDIRECT_VIEW_SET, l as AUTH_DEFAULT_VIEW, m as AUTH_MODE_REDIRECTS, n as AUTH_MODE_SET, o as AUTH_ROUTES, p as AUTH_SESSION_PATH, q as AUTH_TWO_FACTOR_SEGMENT, r as AUTH_VIEW_BY_SEGMENT, s as AthenaAuthClientBaseUrlOptions, t as AthenaAuthUpstreamEnv, u as AthenaAuthUpstreamEnvKey, v as AthenaRequestHeaderOverrideFields, w as AthenaRequestHeaderProfile, x as AuthMode, y as AuthModeRedirects, z as AuthRoutes, B as AuthView, C as BuildAthenaRequestHeadersInput, D as ClearAuthCookiesOptions, E as DEFAULT_ATHENA_AUTH_ORIGIN, F as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, ac as DEFAULT_AUTH_COOKIE_PREFIXES, G as DISABLE_COOKIE_CACHE_QUERY_PARAM, H as DISABLE_COOKIE_CACHE_QUERY_VALUE, I as EnvLike, L as LOCAL_DEV_ORIGIN, a4 as ResolvedRequestHeaderOverrides, S as SESSION_DATA_HEADER, a5 as applyAthenaApiKeyHeaders, a6 as applyAthenaAuthContextHeaders, a7 as applyAthenaPgUriHeaders, ad as asBoolean, ae as asBooleanOrNull, af as asIdentifier, J as asNonEmptyString, ag as asNumber, ah as asRecord, K as asString, ai as asStringArray, M as buildAthenaGatewayHeaders, N as buildAthenaRequestHeaders, a8 as buildServiceRequestHeaders, O as clearAuthCookies, P as createAuthModeRedirects, Q as createAuthRoutes, R as createFreshSessionLookupUrl, aj as firstString, a9 as hasHeaderIgnoreCase, T as isAbsoluteUrl, U as isAuthMode, V as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, X as readTrimmedString, Y as resolveAthenaAuthClientBaseUrl, Z as resolveAthenaAuthRequestUrl, _ as resolveAthenaAuthUpstreamUrl, $ as resolveAuthModeRedirect, a0 as resolveAuthViewFromSegment, a1 as resolveEmailVerificationCallbackUrl, aa as resolveHeaderValue, ab as resolveRequestHeaderOverrides, a2 as shouldRedirectAuthenticatedAuthMode, a3 as shouldRedirectAuthenticatedAuthView } from './athena-request-headers-DujFFyMU.cjs';
+export { G as GetOriginFromHeadersOptions, g as getOriginFromHeaders, i as isDynamicServerUsageError, p as proxyRequestHeaders, r as readEnv, a as requireEnv } from './proxy-request-headers-DGxdoyA0.cjs';
 export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from './session-cookie-detection-BqOp9mO6.cjs';
-import { t as BackendOption } from './types-Bltx6iL6.cjs';
+import './types-Bltx6iL6.cjs';
 
 declare function slugify(input: string): string;
 
 declare function trimTrailingSlashes(value: string): string;
 
-declare function asString(value: unknown): string | null;
-declare function asBoolean(value: unknown): boolean;
-declare function asBooleanOrNull(value: unknown): boolean | null;
-declare function asRecord(value: unknown): Record<string, unknown> | null;
-declare function asIdentifier(value: unknown): string | null;
-declare function firstString(record: Record<string, unknown> | null | undefined, keys: readonly string[]): string | null;
-declare function readTrimmedString(value: unknown): string | null;
-/**
- * Trim a string value; return `undefined` when not a non-empty string.
- *
- * Unlike {@link asString}, does not coerce numbers/bigints.
- * Unlike {@link readTrimmedString}, returns `undefined` instead of `null`
- * (handy for optional fields and `??` defaults).
- */
-declare function asNonEmptyString(value: unknown): string | undefined;
-declare function asNumber(value: unknown): number | null;
-declare function asStringArray(value: unknown): string[];
-
 declare function parseBooleanFlag(rawValue: string | undefined, fallback: boolean): boolean;
 
-/**
- * Read the first non-empty trimmed environment variable from a name list.
- *
- * @param names - Candidate env keys in priority order
- * @param env - Optional env map (defaults to `process.env`)
- * @returns Trimmed value of the first key that is set and non-empty
- * @throws {Error} When none of the keys yield a non-empty value
- *
- * @example
- * ```ts
- * import { requireEnv } from "@xylex-group/athena/utils"
- *
- * const authUrl = requireEnv([
- *   "ATHENA_AUTH_UPSTREAM_URL",
- *   "ATHENA_AUTH_URL",
- *   "NEXT_PUBLIC_ATHENA_AUTH_URL",
- * ])
- * ```
- */
-declare function requireEnv(names: readonly string[], env?: EnvLike): string;
-/**
- * Like {@link requireEnv}, but returns `undefined` instead of throwing when
- * none of the keys are set.
- */
-declare function readEnv(names: readonly string[], env?: EnvLike): string | undefined;
-
 declare function isLocalHostname(hostname: string): boolean;
 
-/**
- * Request header / Next.js helpers used by middleware and RSC session loaders.
- * Framework-agnostic (no Next imports).
- */
-/**
- * True when Next.js threw because the route used dynamic APIs during static
- * generation (`DYNAMIC_SERVER_USAGE` digest or matching message).
- *
- * Catch and rethrow (or handle) so Next can mark the route dynamic.
- */
-declare function isDynamicServerUsageError(error: unknown): boolean;
-interface GetOriginFromHeadersOptions {
-    /**
-     * When `x-forwarded-proto` / scheme is missing, use `http` if true else `https`.
-     * Typical: `process.env.NODE_ENV !== "production"`.
-     */
-    preferHttpWhenMissingProto?: boolean;
-}
-/**
- * Reconstruct public origin from request headers (Origin, or Host + proto).
- *
- * Prefers `Origin`, then `x-forwarded-host` / `host` with
- * `x-forwarded-proto` (first value when comma-separated).
- */
-declare function getOriginFromHeaders(headersList: {
-    get: (name: string) => string | null;
-}, options?: GetOriginFromHeadersOptions): string | null;
-
-declare function proxyRequestHeaders(request: Request): Headers;
-
-type AthenaRequestHeaderProfile = 'gateway' | 'auth' | 'chat' | 'storage' | 'minimal';
-interface BuildAthenaRequestHeadersInput {
-    profile: AthenaRequestHeaderProfile;
-    sdkHeaderValue: string;
-    apiKey?: string | null;
-    client?: string | null;
-    userId?: string | null;
-    organizationId?: string | null;
-    backend?: BackendOption;
-    publishEvent?: string | null;
-    stripNulls?: boolean;
-    bearerToken?: string | null;
-    cookie?: string | null;
-    sessionToken?: string | null;
-    pgUri?: string | null;
-    jdbcUrl?: string | null;
-    forceNoCache?: boolean;
-    configHeaders?: Record<string, string>;
-    callHeaders?: Record<string, string>;
-    contentType?: string | null;
-    accept?: string | null;
-}
-/** Shared config/call fields consumed by gateway, chat, auth, and `client.request(...)`. */
-interface AthenaRequestHeaderOverrideFields {
-    apiKey?: string | null;
-    client?: string | null;
-    userId?: string | null;
-    organizationId?: string | null;
-    backend?: BackendOption;
-    publishEvent?: string | null;
-    stripNulls?: boolean;
-    bearerToken?: string | null;
-    cookie?: string | null;
-    sessionToken?: string | null;
-    pgUri?: string | null;
-    jdbcUrl?: string | null;
-    forceNoCache?: boolean;
-    headers?: Record<string, string>;
-}
-type ResolvedRequestHeaderOverrides = Omit<BuildAthenaRequestHeadersInput, 'profile' | 'sdkHeaderValue' | 'contentType' | 'accept'>;
-declare function hasHeaderIgnoreCase(headers: Record<string, string>, targetKey: string): boolean;
-declare function resolveHeaderValue(headers: Record<string, string>, candidates: readonly string[]): string | undefined;
-declare function resolveRequestHeaderOverrides(config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, defaults?: Pick<AthenaRequestHeaderOverrideFields, 'client' | 'stripNulls'>): ResolvedRequestHeaderOverrides;
-declare function buildServiceRequestHeaders(profile: Exclude<AthenaRequestHeaderProfile, 'minimal'>, sdkHeaderValue: string, config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, extras?: Pick<BuildAthenaRequestHeadersInput, 'contentType' | 'accept'> & {
-    client?: string | null;
-    stripNulls?: boolean;
-}): Record<string, string>;
-declare function applyAthenaApiKeyHeaders(headers: Record<string, string>, apiKey?: string | null): void;
-declare function applyAthenaAuthContextHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'bearerToken' | 'cookie' | 'sessionToken' | 'profile' | 'configHeaders' | 'callHeaders'>): void;
-declare function applyAthenaPgUriHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'pgUri' | 'jdbcUrl' | 'configHeaders' | 'callHeaders'>): void;
-/**
- * Minimal gateway/data request headers used by many apps before they adopt
- * the full {@link buildAthenaRequestHeaders} profile model.
- *
- * Additive convenience — does not replace client-built headers. Prefer
- * `createClient({ client, key })` so the SDK sets these on every call.
- */
-declare function buildAthenaGatewayHeaders(input: {
-    clientName?: string | null;
-    gatewayKey?: string | null;
-    headers?: Record<string, string | null | undefined>;
-}): Record<string, string>;
-declare function buildAthenaRequestHeaders(input: BuildAthenaRequestHeadersInput): Record<string, string>;
-
 /**
  * Wraps a string in a PostgreSQL dollar-quoted literal.
  *
@@ -180,4 +42,4 @@ declare function sqlJsonbLiteral(value: unknown): string;
  */
 declare function sqlBigInt(value: bigint | number): string;
 
-export { type AthenaRequestHeaderOverrideFields, type AthenaRequestHeaderProfile, type BuildAthenaRequestHeadersInput, EnvLike, type GetOriginFromHeadersOptions, type ResolvedRequestHeaderOverrides, applyAthenaApiKeyHeaders, applyAthenaAuthContextHeaders, applyAthenaPgUriHeaders, asBoolean, asBooleanOrNull, asIdentifier, asNonEmptyString, asNumber, asRecord, asString, asStringArray, buildAthenaGatewayHeaders, buildAthenaRequestHeaders, buildServiceRequestHeaders, escapeLikePatternValue, firstString, getOriginFromHeaders, hasHeaderIgnoreCase, isDynamicServerUsageError, isLocalHostname, parseBooleanFlag, proxyRequestHeaders, quoteSqlStringLiteral, readEnv, readTrimmedString, requireEnv, resolveHeaderValue, resolveRequestHeaderOverrides, slugify, sqlBigInt, sqlJsonbLiteral, sqlNullableText, sqlText, trimTrailingSlashes };
+export { escapeLikePatternValue, isLocalHostname, parseBooleanFlag, quoteSqlStringLiteral, slugify, sqlBigInt, sqlJsonbLiteral, sqlNullableText, sqlText, trimTrailingSlashes };

package/dist/utils.d.ts

@@ -1,154 +1,16 @@
-import { E as EnvLike } from './athena-auth-url-oLux_57a.js';
-export { A as ATHENA_AUTH_COOKIE_PREFIXES, o as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, p as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, q as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, t as ATHENA_AUTH_GET_SESSION_PATH, a as ATHENA_AUTH_PATH, b as ATHENA_AUTH_UPSTREAM_ENV_KEYS, c as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, u as ATHENA_AUTH_VERIFY_EMAIL_PATH, v as ATHENA_SESSION_DATA_HEADER, w as AUTHENTICATED_REDIRECT_MODE_SET, x as AUTHENTICATED_REDIRECT_VIEW_SET, d as AUTH_DEFAULT_VIEW, y as AUTH_MODE_REDIRECTS, z as AUTH_MODE_SET, e as AUTH_ROUTES, B as AUTH_SESSION_PATH, F as AUTH_TWO_FACTOR_SEGMENT, f as AUTH_VIEW_BY_SEGMENT, G as AthenaAuthClientBaseUrlOptions, H as AthenaAuthUpstreamEnv, I as AthenaAuthUpstreamEnvKey, J as AuthMode, K as AuthModeRedirects, L as AuthRoutes, g as AuthView, C as ClearAuthCookiesOptions, D as DEFAULT_ATHENA_AUTH_ORIGIN, M as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, N as DEFAULT_AUTH_COOKIE_PREFIXES, O as DISABLE_COOKIE_CACHE_QUERY_PARAM, P as DISABLE_COOKIE_CACHE_QUERY_VALUE, Q as LOCAL_DEV_ORIGIN, S as SESSION_DATA_HEADER, h as clearAuthCookies, R as createAuthModeRedirects, T as createAuthRoutes, U as createFreshSessionLookupUrl, i as isAbsoluteUrl, V as isAuthMode, n as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, r as resolveAthenaAuthClientBaseUrl, j as resolveAthenaAuthRequestUrl, k as resolveAthenaAuthUpstreamUrl, X as resolveAuthModeRedirect, l as resolveAuthViewFromSegment, m as resolveEmailVerificationCallbackUrl, Y as shouldRedirectAuthenticatedAuthMode, s as shouldRedirectAuthenticatedAuthView } from './athena-auth-url-oLux_57a.js';
+export { A as ATHENA_AUTH_COOKIE_PREFIXES, a as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_PARAM, b as ATHENA_AUTH_DISABLE_COOKIE_CACHE_QUERY_VALUE, c as ATHENA_AUTH_GET_SESSION_ABSOLUTE_PATH, d as ATHENA_AUTH_GET_SESSION_PATH, e as ATHENA_AUTH_PATH, f as ATHENA_AUTH_UPSTREAM_ENV_KEYS, g as ATHENA_AUTH_UPSTREAM_URL_ENV_NAMES, h as ATHENA_AUTH_VERIFY_EMAIL_PATH, i as ATHENA_SESSION_DATA_HEADER, j as AUTHENTICATED_REDIRECT_MODE_SET, k as AUTHENTICATED_REDIRECT_VIEW_SET, l as AUTH_DEFAULT_VIEW, m as AUTH_MODE_REDIRECTS, n as AUTH_MODE_SET, o as AUTH_ROUTES, p as AUTH_SESSION_PATH, q as AUTH_TWO_FACTOR_SEGMENT, r as AUTH_VIEW_BY_SEGMENT, s as AthenaAuthClientBaseUrlOptions, t as AthenaAuthUpstreamEnv, u as AthenaAuthUpstreamEnvKey, v as AthenaRequestHeaderOverrideFields, w as AthenaRequestHeaderProfile, x as AuthMode, y as AuthModeRedirects, z as AuthRoutes, B as AuthView, C as BuildAthenaRequestHeadersInput, D as ClearAuthCookiesOptions, E as DEFAULT_ATHENA_AUTH_ORIGIN, F as DEFAULT_ATHENA_AUTH_UPSTREAM_URL, ac as DEFAULT_AUTH_COOKIE_PREFIXES, G as DISABLE_COOKIE_CACHE_QUERY_PARAM, H as DISABLE_COOKIE_CACHE_QUERY_VALUE, I as EnvLike, L as LOCAL_DEV_ORIGIN, a4 as ResolvedRequestHeaderOverrides, S as SESSION_DATA_HEADER, a5 as applyAthenaApiKeyHeaders, a6 as applyAthenaAuthContextHeaders, a7 as applyAthenaPgUriHeaders, ad as asBoolean, ae as asBooleanOrNull, af as asIdentifier, J as asNonEmptyString, ag as asNumber, ah as asRecord, K as asString, ai as asStringArray, M as buildAthenaGatewayHeaders, N as buildAthenaRequestHeaders, a8 as buildServiceRequestHeaders, O as clearAuthCookies, P as createAuthModeRedirects, Q as createAuthRoutes, R as createFreshSessionLookupUrl, aj as firstString, a9 as hasHeaderIgnoreCase, T as isAbsoluteUrl, U as isAuthMode, V as normalizeAthenaAuthBaseUrl, W as readAthenaAuthUpstreamUrlFromEnv, X as readTrimmedString, Y as resolveAthenaAuthClientBaseUrl, Z as resolveAthenaAuthRequestUrl, _ as resolveAthenaAuthUpstreamUrl, $ as resolveAuthModeRedirect, a0 as resolveAuthViewFromSegment, a1 as resolveEmailVerificationCallbackUrl, aa as resolveHeaderValue, ab as resolveRequestHeaderOverrides, a2 as shouldRedirectAuthenticatedAuthMode, a3 as shouldRedirectAuthenticatedAuthView } from './athena-request-headers-C7Jy-c_D.js';
+export { G as GetOriginFromHeadersOptions, g as getOriginFromHeaders, i as isDynamicServerUsageError, p as proxyRequestHeaders, r as readEnv, a as requireEnv } from './proxy-request-headers-m4D2Tduy.js';
 export { S as SESSION_COOKIE_PATTERNS, h as hasAuthSessionCookie } from './session-cookie-detection-BqOp9mO6.js';
-import { t as BackendOption } from './types-Bltx6iL6.js';
+import './types-Bltx6iL6.js';
 
 declare function slugify(input: string): string;
 
 declare function trimTrailingSlashes(value: string): string;
 
-declare function asString(value: unknown): string | null;
-declare function asBoolean(value: unknown): boolean;
-declare function asBooleanOrNull(value: unknown): boolean | null;
-declare function asRecord(value: unknown): Record<string, unknown> | null;
-declare function asIdentifier(value: unknown): string | null;
-declare function firstString(record: Record<string, unknown> | null | undefined, keys: readonly string[]): string | null;
-declare function readTrimmedString(value: unknown): string | null;
-/**
- * Trim a string value; return `undefined` when not a non-empty string.
- *
- * Unlike {@link asString}, does not coerce numbers/bigints.
- * Unlike {@link readTrimmedString}, returns `undefined` instead of `null`
- * (handy for optional fields and `??` defaults).
- */
-declare function asNonEmptyString(value: unknown): string | undefined;
-declare function asNumber(value: unknown): number | null;
-declare function asStringArray(value: unknown): string[];
-
 declare function parseBooleanFlag(rawValue: string | undefined, fallback: boolean): boolean;
 
-/**
- * Read the first non-empty trimmed environment variable from a name list.
- *
- * @param names - Candidate env keys in priority order
- * @param env - Optional env map (defaults to `process.env`)
- * @returns Trimmed value of the first key that is set and non-empty
- * @throws {Error} When none of the keys yield a non-empty value
- *
- * @example
- * ```ts
- * import { requireEnv } from "@xylex-group/athena/utils"
- *
- * const authUrl = requireEnv([
- *   "ATHENA_AUTH_UPSTREAM_URL",
- *   "ATHENA_AUTH_URL",
- *   "NEXT_PUBLIC_ATHENA_AUTH_URL",
- * ])
- * ```
- */
-declare function requireEnv(names: readonly string[], env?: EnvLike): string;
-/**
- * Like {@link requireEnv}, but returns `undefined` instead of throwing when
- * none of the keys are set.
- */
-declare function readEnv(names: readonly string[], env?: EnvLike): string | undefined;
-
 declare function isLocalHostname(hostname: string): boolean;
 
-/**
- * Request header / Next.js helpers used by middleware and RSC session loaders.
- * Framework-agnostic (no Next imports).
- */
-/**
- * True when Next.js threw because the route used dynamic APIs during static
- * generation (`DYNAMIC_SERVER_USAGE` digest or matching message).
- *
- * Catch and rethrow (or handle) so Next can mark the route dynamic.
- */
-declare function isDynamicServerUsageError(error: unknown): boolean;
-interface GetOriginFromHeadersOptions {
-    /**
-     * When `x-forwarded-proto` / scheme is missing, use `http` if true else `https`.
-     * Typical: `process.env.NODE_ENV !== "production"`.
-     */
-    preferHttpWhenMissingProto?: boolean;
-}
-/**
- * Reconstruct public origin from request headers (Origin, or Host + proto).
- *
- * Prefers `Origin`, then `x-forwarded-host` / `host` with
- * `x-forwarded-proto` (first value when comma-separated).
- */
-declare function getOriginFromHeaders(headersList: {
-    get: (name: string) => string | null;
-}, options?: GetOriginFromHeadersOptions): string | null;
-
-declare function proxyRequestHeaders(request: Request): Headers;
-
-type AthenaRequestHeaderProfile = 'gateway' | 'auth' | 'chat' | 'storage' | 'minimal';
-interface BuildAthenaRequestHeadersInput {
-    profile: AthenaRequestHeaderProfile;
-    sdkHeaderValue: string;
-    apiKey?: string | null;
-    client?: string | null;
-    userId?: string | null;
-    organizationId?: string | null;
-    backend?: BackendOption;
-    publishEvent?: string | null;
-    stripNulls?: boolean;
-    bearerToken?: string | null;
-    cookie?: string | null;
-    sessionToken?: string | null;
-    pgUri?: string | null;
-    jdbcUrl?: string | null;
-    forceNoCache?: boolean;
-    configHeaders?: Record<string, string>;
-    callHeaders?: Record<string, string>;
-    contentType?: string | null;
-    accept?: string | null;
-}
-/** Shared config/call fields consumed by gateway, chat, auth, and `client.request(...)`. */
-interface AthenaRequestHeaderOverrideFields {
-    apiKey?: string | null;
-    client?: string | null;
-    userId?: string | null;
-    organizationId?: string | null;
-    backend?: BackendOption;
-    publishEvent?: string | null;
-    stripNulls?: boolean;
-    bearerToken?: string | null;
-    cookie?: string | null;
-    sessionToken?: string | null;
-    pgUri?: string | null;
-    jdbcUrl?: string | null;
-    forceNoCache?: boolean;
-    headers?: Record<string, string>;
-}
-type ResolvedRequestHeaderOverrides = Omit<BuildAthenaRequestHeadersInput, 'profile' | 'sdkHeaderValue' | 'contentType' | 'accept'>;
-declare function hasHeaderIgnoreCase(headers: Record<string, string>, targetKey: string): boolean;
-declare function resolveHeaderValue(headers: Record<string, string>, candidates: readonly string[]): string | undefined;
-declare function resolveRequestHeaderOverrides(config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, defaults?: Pick<AthenaRequestHeaderOverrideFields, 'client' | 'stripNulls'>): ResolvedRequestHeaderOverrides;
-declare function buildServiceRequestHeaders(profile: Exclude<AthenaRequestHeaderProfile, 'minimal'>, sdkHeaderValue: string, config: AthenaRequestHeaderOverrideFields, options?: AthenaRequestHeaderOverrideFields, extras?: Pick<BuildAthenaRequestHeadersInput, 'contentType' | 'accept'> & {
-    client?: string | null;
-    stripNulls?: boolean;
-}): Record<string, string>;
-declare function applyAthenaApiKeyHeaders(headers: Record<string, string>, apiKey?: string | null): void;
-declare function applyAthenaAuthContextHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'bearerToken' | 'cookie' | 'sessionToken' | 'profile' | 'configHeaders' | 'callHeaders'>): void;
-declare function applyAthenaPgUriHeaders(headers: Record<string, string>, input: Pick<BuildAthenaRequestHeadersInput, 'pgUri' | 'jdbcUrl' | 'configHeaders' | 'callHeaders'>): void;
-/**
- * Minimal gateway/data request headers used by many apps before they adopt
- * the full {@link buildAthenaRequestHeaders} profile model.
- *
- * Additive convenience — does not replace client-built headers. Prefer
- * `createClient({ client, key })` so the SDK sets these on every call.
- */
-declare function buildAthenaGatewayHeaders(input: {
-    clientName?: string | null;
-    gatewayKey?: string | null;
-    headers?: Record<string, string | null | undefined>;
-}): Record<string, string>;
-declare function buildAthenaRequestHeaders(input: BuildAthenaRequestHeadersInput): Record<string, string>;
-
 /**
  * Wraps a string in a PostgreSQL dollar-quoted literal.
  *
@@ -180,4 +42,4 @@ declare function sqlJsonbLiteral(value: unknown): string;
  */
 declare function sqlBigInt(value: bigint | number): string;
 
-export { type AthenaRequestHeaderOverrideFields, type AthenaRequestHeaderProfile, type BuildAthenaRequestHeadersInput, EnvLike, type GetOriginFromHeadersOptions, type ResolvedRequestHeaderOverrides, applyAthenaApiKeyHeaders, applyAthenaAuthContextHeaders, applyAthenaPgUriHeaders, asBoolean, asBooleanOrNull, asIdentifier, asNonEmptyString, asNumber, asRecord, asString, asStringArray, buildAthenaGatewayHeaders, buildAthenaRequestHeaders, buildServiceRequestHeaders, escapeLikePatternValue, firstString, getOriginFromHeaders, hasHeaderIgnoreCase, isDynamicServerUsageError, isLocalHostname, parseBooleanFlag, proxyRequestHeaders, quoteSqlStringLiteral, readEnv, readTrimmedString, requireEnv, resolveHeaderValue, resolveRequestHeaderOverrides, slugify, sqlBigInt, sqlJsonbLiteral, sqlNullableText, sqlText, trimTrailingSlashes };
+export { escapeLikePatternValue, isLocalHostname, parseBooleanFlag, quoteSqlStringLiteral, slugify, sqlBigInt, sqlJsonbLiteral, sqlNullableText, sqlText, trimTrailingSlashes };