@xylex-group/athena 3.1.0 → 3.3.0

package/dist/{model-form-BhWWsA-7.d.cts → model-form-3Gr8rkdT.d.cts}

@@ -1,5 +1,5 @@
 import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-Bltx6iL6.cjs';
-import { ag as AthenaClient, av as AthenaQueryDebugAst } from './v3-client-CWfZHcKL.cjs';
+import { ag as AthenaClient, av as AthenaQueryDebugAst } from './v3-client-G1SLeHRa.cjs';
 import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-CgCv5o6R.cjs';
 
 interface AthenaGatewayErrorInput {
@@ -75,6 +75,12 @@ interface AthenaReadQueryDefinition {
     columns: readonly AthenaReadQueryColumn[];
     countColumn: string;
     filters?: readonly AthenaReadQueryFilter[];
+    /**
+     * Optional max total rows to expose from the result set.
+     * Caps reported `totalItems` and shortens the last page under that window.
+     * Does **not** replace `pageSize` for per-request page sizing — those fight
+     * when both are applied as SQL LIMIT.
+     */
     limit?: number;
     mode?: AthenaReadQueryMode;
     /** Single order or multi-column order list. */
@@ -179,6 +185,22 @@ declare const applyAthenaTableSelectLimit: typeof applyAthenaReadQuerySelectLimi
 declare function clampAthenaReadQueryTotalItems(totalItems: number, limit: number | undefined): number;
 /** @deprecated Prefer {@link clampAthenaReadQueryTotalItems}. */
 declare const clampAthenaTableTotalItems: typeof clampAthenaReadQueryTotalItems;
+/**
+ * Resolves the page window for a paged read under an optional total-row cap.
+ *
+ * - `pageSize` owns the per-request fetch size.
+ * - `query.limit` (when set) is a max total window, not a second LIMIT that
+ *   overrides pageSize (which previously made the two controls fight).
+ */
+declare function resolveAthenaReadQueryPageFetch({ page, pageSize, limit, }: {
+    page: number;
+    pageSize: number;
+    limit?: number;
+}): {
+    page: number;
+    pageSize: number;
+    shouldFetch: boolean;
+};
 /**
  * Execute a portable {@link AthenaReadQueryDefinition} against a v3 Athena client.
  *
@@ -256,4 +278,4 @@ interface ModelFormAdapter<TModel extends AnyModelDef> {
  */
 declare function createModelFormAdapter<TModel extends AnyModelDef>(model: TModel): ModelFormAdapter<TModel>;
 
-export { executeAthenaReadQuery as $, AthenaGatewayError as A, type AthenaTableQueryMode as B, type AthenaTableRelationRef as C, type ModelFormDefaults as D, type ModelFormNullishMode as E, type FormValuesOf as F, type ModelFormValues as G, type ToModelPayloadOptions as H, applyAthenaReadQueryFilters as I, applyAthenaReadQuerySelectLimit as J, applyAthenaReadQuerySelectOrder as K, applyAthenaTableFilters as L, type ModelFormAdapter as M, applyAthenaTableSelectLimit as N, applyAthenaTableSelectOrder as O, buildAthenaReadQueryFindManyOrderBy as P, buildAthenaReadQueryFindManySelect as Q, buildAthenaReadQueryFindManyWhere as R, buildAthenaReadQuerySelectString as S, type ToModelFormDefaultsOptions as T, buildAthenaTableFindManyOrderBy as U, buildAthenaTableFindManySelect as V, buildAthenaTableFindManyWhere as W, buildAthenaTableSelectString as X, clampAthenaReadQueryTotalItems as Y, clampAthenaTableTotalItems as Z, createModelFormAdapter as _, type AthenaReadQueryClient as a, executeAthenaTableQuery as a0, flattenAthenaReadQueryRows as a1, flattenAthenaRows as a2, isAthenaGatewayError as a3, normalizeAthenaReadQueryOrderBy as a4, normalizeAthenaTableOrderBy as a5, toModelFormDefaults as a6, toModelPayload as a7, type AthenaReadQueryColumn as b, type AthenaReadQueryDefinition as c, type AthenaReadQueryExecutionInput as d, type AthenaReadQueryExecutionResult as e, type AthenaReadQueryFilter as f, type AthenaReadQueryFilterOperator as g, type AthenaReadQueryFilterValue as h, type AthenaReadQueryFlatRow as i, type AthenaReadQueryMode as j, type AthenaReadQueryOrder as k, type AthenaReadQueryOrderByInput as l, type AthenaReadQueryOrderDirection as m, type AthenaReadQueryRelationRef as n, type AthenaTableFilter as o, type AthenaTableFilterOperator as p, type AthenaTableFilterValue as q, type AthenaTableFlatRow as r, type AthenaTableOrder as s, type AthenaTableOrderByInput as t, type AthenaTableOrderDirection as u, type AthenaTableQueryClient as v, type AthenaTableQueryColumn as w, type AthenaTableQueryDefinition as x, type AthenaTableQueryExecutionInput as y, type AthenaTableQueryExecutionResult as z };
+export { executeAthenaReadQuery as $, AthenaGatewayError as A, type AthenaTableQueryMode as B, type AthenaTableRelationRef as C, type ModelFormDefaults as D, type ModelFormNullishMode as E, type FormValuesOf as F, type ModelFormValues as G, type ToModelPayloadOptions as H, applyAthenaReadQueryFilters as I, applyAthenaReadQuerySelectLimit as J, applyAthenaReadQuerySelectOrder as K, applyAthenaTableFilters as L, type ModelFormAdapter as M, applyAthenaTableSelectLimit as N, applyAthenaTableSelectOrder as O, buildAthenaReadQueryFindManyOrderBy as P, buildAthenaReadQueryFindManySelect as Q, buildAthenaReadQueryFindManyWhere as R, buildAthenaReadQuerySelectString as S, type ToModelFormDefaultsOptions as T, buildAthenaTableFindManyOrderBy as U, buildAthenaTableFindManySelect as V, buildAthenaTableFindManyWhere as W, buildAthenaTableSelectString as X, clampAthenaReadQueryTotalItems as Y, clampAthenaTableTotalItems as Z, createModelFormAdapter as _, type AthenaReadQueryClient as a, executeAthenaTableQuery as a0, flattenAthenaReadQueryRows as a1, flattenAthenaRows as a2, isAthenaGatewayError as a3, normalizeAthenaReadQueryOrderBy as a4, normalizeAthenaTableOrderBy as a5, resolveAthenaReadQueryPageFetch as a6, toModelFormDefaults as a7, toModelPayload as a8, type AthenaReadQueryColumn as b, type AthenaReadQueryDefinition as c, type AthenaReadQueryExecutionInput as d, type AthenaReadQueryExecutionResult as e, type AthenaReadQueryFilter as f, type AthenaReadQueryFilterOperator as g, type AthenaReadQueryFilterValue as h, type AthenaReadQueryFlatRow as i, type AthenaReadQueryMode as j, type AthenaReadQueryOrder as k, type AthenaReadQueryOrderByInput as l, type AthenaReadQueryOrderDirection as m, type AthenaReadQueryRelationRef as n, type AthenaTableFilter as o, type AthenaTableFilterOperator as p, type AthenaTableFilterValue as q, type AthenaTableFlatRow as r, type AthenaTableOrder as s, type AthenaTableOrderByInput as t, type AthenaTableOrderDirection as u, type AthenaTableQueryClient as v, type AthenaTableQueryColumn as w, type AthenaTableQueryDefinition as x, type AthenaTableQueryExecutionInput as y, type AthenaTableQueryExecutionResult as z };

package/dist/{model-form-BbdzJ9Uh.d.ts → model-form-CotpEL7z.d.ts}

@@ -1,5 +1,5 @@
 import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-Bltx6iL6.js';
-import { ag as AthenaClient, av as AthenaQueryDebugAst } from './v3-client-DZp2NEhK.js';
+import { ag as AthenaClient, av as AthenaQueryDebugAst } from './v3-client-ao8BWQ8v.js';
 import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-B75PdABb.js';
 
 interface AthenaGatewayErrorInput {
@@ -75,6 +75,12 @@ interface AthenaReadQueryDefinition {
     columns: readonly AthenaReadQueryColumn[];
     countColumn: string;
     filters?: readonly AthenaReadQueryFilter[];
+    /**
+     * Optional max total rows to expose from the result set.
+     * Caps reported `totalItems` and shortens the last page under that window.
+     * Does **not** replace `pageSize` for per-request page sizing — those fight
+     * when both are applied as SQL LIMIT.
+     */
     limit?: number;
     mode?: AthenaReadQueryMode;
     /** Single order or multi-column order list. */
@@ -179,6 +185,22 @@ declare const applyAthenaTableSelectLimit: typeof applyAthenaReadQuerySelectLimi
 declare function clampAthenaReadQueryTotalItems(totalItems: number, limit: number | undefined): number;
 /** @deprecated Prefer {@link clampAthenaReadQueryTotalItems}. */
 declare const clampAthenaTableTotalItems: typeof clampAthenaReadQueryTotalItems;
+/**
+ * Resolves the page window for a paged read under an optional total-row cap.
+ *
+ * - `pageSize` owns the per-request fetch size.
+ * - `query.limit` (when set) is a max total window, not a second LIMIT that
+ *   overrides pageSize (which previously made the two controls fight).
+ */
+declare function resolveAthenaReadQueryPageFetch({ page, pageSize, limit, }: {
+    page: number;
+    pageSize: number;
+    limit?: number;
+}): {
+    page: number;
+    pageSize: number;
+    shouldFetch: boolean;
+};
 /**
  * Execute a portable {@link AthenaReadQueryDefinition} against a v3 Athena client.
  *
@@ -256,4 +278,4 @@ interface ModelFormAdapter<TModel extends AnyModelDef> {
  */
 declare function createModelFormAdapter<TModel extends AnyModelDef>(model: TModel): ModelFormAdapter<TModel>;
 
-export { executeAthenaReadQuery as $, AthenaGatewayError as A, type AthenaTableQueryMode as B, type AthenaTableRelationRef as C, type ModelFormDefaults as D, type ModelFormNullishMode as E, type FormValuesOf as F, type ModelFormValues as G, type ToModelPayloadOptions as H, applyAthenaReadQueryFilters as I, applyAthenaReadQuerySelectLimit as J, applyAthenaReadQuerySelectOrder as K, applyAthenaTableFilters as L, type ModelFormAdapter as M, applyAthenaTableSelectLimit as N, applyAthenaTableSelectOrder as O, buildAthenaReadQueryFindManyOrderBy as P, buildAthenaReadQueryFindManySelect as Q, buildAthenaReadQueryFindManyWhere as R, buildAthenaReadQuerySelectString as S, type ToModelFormDefaultsOptions as T, buildAthenaTableFindManyOrderBy as U, buildAthenaTableFindManySelect as V, buildAthenaTableFindManyWhere as W, buildAthenaTableSelectString as X, clampAthenaReadQueryTotalItems as Y, clampAthenaTableTotalItems as Z, createModelFormAdapter as _, type AthenaReadQueryClient as a, executeAthenaTableQuery as a0, flattenAthenaReadQueryRows as a1, flattenAthenaRows as a2, isAthenaGatewayError as a3, normalizeAthenaReadQueryOrderBy as a4, normalizeAthenaTableOrderBy as a5, toModelFormDefaults as a6, toModelPayload as a7, type AthenaReadQueryColumn as b, type AthenaReadQueryDefinition as c, type AthenaReadQueryExecutionInput as d, type AthenaReadQueryExecutionResult as e, type AthenaReadQueryFilter as f, type AthenaReadQueryFilterOperator as g, type AthenaReadQueryFilterValue as h, type AthenaReadQueryFlatRow as i, type AthenaReadQueryMode as j, type AthenaReadQueryOrder as k, type AthenaReadQueryOrderByInput as l, type AthenaReadQueryOrderDirection as m, type AthenaReadQueryRelationRef as n, type AthenaTableFilter as o, type AthenaTableFilterOperator as p, type AthenaTableFilterValue as q, type AthenaTableFlatRow as r, type AthenaTableOrder as s, type AthenaTableOrderByInput as t, type AthenaTableOrderDirection as u, type AthenaTableQueryClient as v, type AthenaTableQueryColumn as w, type AthenaTableQueryDefinition as x, type AthenaTableQueryExecutionInput as y, type AthenaTableQueryExecutionResult as z };
+export { executeAthenaReadQuery as $, AthenaGatewayError as A, type AthenaTableQueryMode as B, type AthenaTableRelationRef as C, type ModelFormDefaults as D, type ModelFormNullishMode as E, type FormValuesOf as F, type ModelFormValues as G, type ToModelPayloadOptions as H, applyAthenaReadQueryFilters as I, applyAthenaReadQuerySelectLimit as J, applyAthenaReadQuerySelectOrder as K, applyAthenaTableFilters as L, type ModelFormAdapter as M, applyAthenaTableSelectLimit as N, applyAthenaTableSelectOrder as O, buildAthenaReadQueryFindManyOrderBy as P, buildAthenaReadQueryFindManySelect as Q, buildAthenaReadQueryFindManyWhere as R, buildAthenaReadQuerySelectString as S, type ToModelFormDefaultsOptions as T, buildAthenaTableFindManyOrderBy as U, buildAthenaTableFindManySelect as V, buildAthenaTableFindManyWhere as W, buildAthenaTableSelectString as X, clampAthenaReadQueryTotalItems as Y, clampAthenaTableTotalItems as Z, createModelFormAdapter as _, type AthenaReadQueryClient as a, executeAthenaTableQuery as a0, flattenAthenaReadQueryRows as a1, flattenAthenaRows as a2, isAthenaGatewayError as a3, normalizeAthenaReadQueryOrderBy as a4, normalizeAthenaTableOrderBy as a5, resolveAthenaReadQueryPageFetch as a6, toModelFormDefaults as a7, toModelPayload as a8, type AthenaReadQueryColumn as b, type AthenaReadQueryDefinition as c, type AthenaReadQueryExecutionInput as d, type AthenaReadQueryExecutionResult as e, type AthenaReadQueryFilter as f, type AthenaReadQueryFilterOperator as g, type AthenaReadQueryFilterValue as h, type AthenaReadQueryFlatRow as i, type AthenaReadQueryMode as j, type AthenaReadQueryOrder as k, type AthenaReadQueryOrderByInput as l, type AthenaReadQueryOrderDirection as m, type AthenaReadQueryRelationRef as n, type AthenaTableFilter as o, type AthenaTableFilterOperator as p, type AthenaTableFilterValue as q, type AthenaTableFlatRow as r, type AthenaTableOrder as s, type AthenaTableOrderByInput as t, type AthenaTableOrderDirection as u, type AthenaTableQueryClient as v, type AthenaTableQueryColumn as w, type AthenaTableQueryDefinition as x, type AthenaTableQueryExecutionInput as y, type AthenaTableQueryExecutionResult as z };

package/dist/{module-xFd7_Igv.d.cts → module-CQmOaDzP.d.cts}

@@ -1,10 +1,10 @@
 import { o as SchemaDef, s as AnyModelDef, D as DatabaseDef, k as ModelMetadata, j as ModelDef, R as RegistryDef, h as ModelColumnKind, S as SchemaIntrospectionProvider, b as IntrospectionColumn, I as IntrospectionSnapshot } from './types-CgCv5o6R.cjs';
-import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-BhWWsA-7.cjs';
+import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-3Gr8rkdT.cjs';
 import { ZodType } from 'zod';
-import { o as GeneratorSchemaSelection, b as GeneratorProviderConfig, r as NormalizedGeneratorFilterConfig, p as GeneratorTableSelection } from './types-1ztXDgPa.cjs';
+import { o as GeneratorSchemaSelection, b as GeneratorProviderConfig, r as NormalizedGeneratorFilterConfig, p as GeneratorTableSelection } from './types-D-Am7YSd.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-CFL9xbFR.cjs';
-import { aQ as AuthSocialProvider, a4 as AthenaAuthReactEmailProps, a1 as AthenaAuthReactEmailComponent, a6 as AthenaAuthReactEmailRenderInput, L as AthenaAuthEmailTemplateDefinition, J as AthenaAuthEmailTemplateBuilder, a7 as AthenaAuthReactEmailRenderOptions, a5 as AthenaAuthReactEmailRenderEvent, a2 as AthenaAuthReactEmailConfig } from './types-AOY-GLu8.cjs';
-import { r as AthenaChatMessageCreatedResponse, q as AthenaChatMessage, F as AthenaChatRoomCreatedResponse, E as AthenaChatRoom } from './v3-client-CWfZHcKL.cjs';
+import { aQ as AuthSocialProvider, a4 as AthenaAuthReactEmailProps, a1 as AthenaAuthReactEmailComponent, a6 as AthenaAuthReactEmailRenderInput, L as AthenaAuthEmailTemplateDefinition, J as AthenaAuthEmailTemplateBuilder, a7 as AthenaAuthReactEmailRenderOptions, a5 as AthenaAuthReactEmailRenderEvent, a2 as AthenaAuthReactEmailConfig } from './types-BVKpQmfY.cjs';
+import { r as AthenaChatMessageCreatedResponse, q as AthenaChatMessage, F as AthenaChatRoomCreatedResponse, E as AthenaChatRoom } from './v3-client-G1SLeHRa.cjs';
 
 type AthenaService = 'db' | 'auth' | 'chat' | 'storage' | 'billing';
 type AthenaConfigurationErrorCode = 'ATHENA_NO_SERVICE_CONFIGURED' | 'ATHENA_SERVICE_NOT_CONFIGURED' | 'ATHENA_API_KEY_REQUIRED' | 'ATHENA_INVALID_URL' | 'ATHENA_NEXT_SERVER_RUNTIME_REQUIRED';

package/dist/{module-DKkJKOuJ.d.ts → module-CWkUTcUc.d.ts}

@@ -1,10 +1,10 @@
 import { o as SchemaDef, s as AnyModelDef, D as DatabaseDef, k as ModelMetadata, j as ModelDef, R as RegistryDef, h as ModelColumnKind, S as SchemaIntrospectionProvider, b as IntrospectionColumn, I as IntrospectionSnapshot } from './types-B75PdABb.js';
-import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-BbdzJ9Uh.js';
+import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-CotpEL7z.js';
 import { ZodType } from 'zod';
-import { o as GeneratorSchemaSelection, b as GeneratorProviderConfig, r as NormalizedGeneratorFilterConfig, p as GeneratorTableSelection } from './types-CccOiXPo.js';
+import { o as GeneratorSchemaSelection, b as GeneratorProviderConfig, r as NormalizedGeneratorFilterConfig, p as GeneratorTableSelection } from './types-BDX8zS7w.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-UKJpunc6.js';
-import { aQ as AuthSocialProvider, a4 as AthenaAuthReactEmailProps, a1 as AthenaAuthReactEmailComponent, a6 as AthenaAuthReactEmailRenderInput, L as AthenaAuthEmailTemplateDefinition, J as AthenaAuthEmailTemplateBuilder, a7 as AthenaAuthReactEmailRenderOptions, a5 as AthenaAuthReactEmailRenderEvent, a2 as AthenaAuthReactEmailConfig } from './types-AOY-GLu8.js';
-import { r as AthenaChatMessageCreatedResponse, q as AthenaChatMessage, F as AthenaChatRoomCreatedResponse, E as AthenaChatRoom } from './v3-client-DZp2NEhK.js';
+import { aQ as AuthSocialProvider, a4 as AthenaAuthReactEmailProps, a1 as AthenaAuthReactEmailComponent, a6 as AthenaAuthReactEmailRenderInput, L as AthenaAuthEmailTemplateDefinition, J as AthenaAuthEmailTemplateBuilder, a7 as AthenaAuthReactEmailRenderOptions, a5 as AthenaAuthReactEmailRenderEvent, a2 as AthenaAuthReactEmailConfig } from './types-BVKpQmfY.js';
+import { r as AthenaChatMessageCreatedResponse, q as AthenaChatMessage, F as AthenaChatRoomCreatedResponse, E as AthenaChatRoom } from './v3-client-ao8BWQ8v.js';
 
 type AthenaService = 'db' | 'auth' | 'chat' | 'storage' | 'billing';
 type AthenaConfigurationErrorCode = 'ATHENA_NO_SERVICE_CONFIGURED' | 'ATHENA_SERVICE_NOT_CONFIGURED' | 'ATHENA_API_KEY_REQUIRED' | 'ATHENA_INVALID_URL' | 'ATHENA_NEXT_SERVER_RUNTIME_REQUIRED';

package/dist/next/client.cjs

@@ -1784,7 +1784,7 @@ function buildAthenaGatewayUrl(baseUrl, path) {
 
 // package.json
 var package_default = {
-  version: "3.1.0"
+  version: "3.3.0"
 };
 
 // src/sdk-version.ts
@@ -3870,6 +3870,14 @@ function createAuthModule(config = {}, runtimeOptions = {}) {
     changeEmailVerify: (input, options) => getWithQuery("/change-email/verify", input, options),
     deleteUserVerify: (input, options) => getWithQuery("/delete-user/verify", input, options),
     changePassword: (input, options) => postGeneric("/change-password", input, options),
+    // Better Auth UI flat method aliases (also nested under session/account/social/user).
+    listSessions: (input, options) => getGeneric("/list-sessions", input, options),
+    revokeSession: sessionRevokeBinding,
+    revokeOtherSessions,
+    listAccounts: (input, options) => getGeneric("/list-accounts", input, options),
+    unlinkAccount: (input, options) => postGeneric("/unlink-account", input, options),
+    linkSocial: (input, options) => postGeneric("/link-social", input, options),
+    updateUser: (input, options) => postGeneric("/update-user", input, options),
     user: {
       update: (input, options) => postGeneric("/update-user", input, options),
       delete: (input, options) => postGeneric("/delete-user", input, options),
@@ -9532,6 +9540,82 @@ function mergeAthenaRequestContexts(base, override) {
   };
 }
 
+// src/diagnostics.ts
+function readProcessEnv2() {
+  try {
+    return globalThis.process?.env ?? {};
+  } catch {
+    return {};
+  }
+}
+function isTruthyEnv(value) {
+  if (!value) return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized === "1" || normalized === "true" || normalized === "yes" || normalized === "on";
+}
+function isQuietAthenaDiagnosticsEnvironment(env = readProcessEnv2()) {
+  const nodeEnv = env.NODE_ENV?.trim().toLowerCase();
+  if (nodeEnv === "production") {
+    return true;
+  }
+  if (isTruthyEnv(env.OPENNEXT_BUILD)) {
+    return true;
+  }
+  const nextPhase = env.NEXT_PHASE?.trim();
+  if (nextPhase === "phase-production-build") {
+    return true;
+  }
+  if (isTruthyEnv(env.CI) && nodeEnv !== "test") {
+    if (nodeEnv === "production" || isTruthyEnv(env.OPENNEXT_BUILD)) {
+      return true;
+    }
+  }
+  return false;
+}
+function resolveBooleanFlag(explicit, mode, quiet) {
+  if (typeof explicit === "boolean") {
+    return explicit;
+  }
+  if (mode === true) {
+    return true;
+  }
+  if (mode === false) {
+    return false;
+  }
+  if (mode === "auto") {
+    return false;
+  }
+  return false;
+}
+function resolveAthenaClientDiagnostics(input) {
+  const env = input.env ?? readProcessEnv2();
+  const quiet = isQuietAthenaDiagnosticsEnvironment(env);
+  const mode = input.diagnostics;
+  const effectiveMode = mode === "auto" && quiet ? false : mode;
+  const debugAst = resolveBooleanFlag(input.debugAst, effectiveMode);
+  const findManyAst = resolveBooleanFlag(input.findManyAst, effectiveMode);
+  let traceQueries;
+  if (input.traceQueries !== void 0) {
+    if (typeof input.traceQueries === "boolean") {
+      traceQueries = input.traceQueries;
+    } else if (effectiveMode === false || mode === "auto" && quiet) {
+      const enabled = input.traceQueries.enabled;
+      traceQueries = typeof enabled === "boolean" ? enabled ? input.traceQueries : false : false;
+    } else {
+      traceQueries = input.traceQueries;
+    }
+  } else if (effectiveMode === true) {
+    traceQueries = true;
+  } else {
+    traceQueries = false;
+  }
+  return {
+    debugAst,
+    findManyAst,
+    traceQueries
+  };
+}
+
 // src/v3-client.ts
 var ENV_URL_KEYS = ["ATHENA_URL", "NEXT_PUBLIC_ATHENA_URL"];
 var ENV_DB_URL_KEYS = ["ATHENA_DB_URL", "ATHENA_GATEWAY_URL", "NEXT_PUBLIC_ATHENA_DB_API_URL"];
@@ -9540,7 +9624,13 @@ var ENV_CHAT_URL_KEYS = ["ATHENA_CHAT_URL", "NEXT_PUBLIC_ATHENA_CHAT_URL"];
 var ENV_CHAT_WS_URL_KEYS = ["ATHENA_CHAT_WS_URL", "NEXT_PUBLIC_ATHENA_CHAT_WS_URL"];
 var ENV_STORAGE_URL_KEYS = ["ATHENA_STORAGE_URL", "NEXT_PUBLIC_ATHENA_STORAGE_URL"];
 var ENV_KEY_KEYS = ["ATHENA_API_KEY", "NEXT_PUBLIC_ATHENA_API_KEY", "ATHENA_GATEWAY_API_KEY", "X_API_KEY"];
-var ENV_CLIENT_KEYS = ["ATHENA_CLIENT", "NEXT_PUBLIC_ATHENA_CLIENT"];
+var ENV_CLIENT_KEYS = [
+  "ATHENA_CLIENT",
+  "ATHENA_GATEWAY_CLIENT",
+  "ATHENA_GENERATOR_CLIENT",
+  "NEXT_PUBLIC_ATHENA_CLIENT",
+  "NEXT_PUBLIC_ATHENA_GATEWAY_CLIENT"
+];
 var MISSING_DB_SENTINEL = "https://athena.invalid/db";
 function readFirstEnv(env, keys) {
   for (const key of keys) {
@@ -9615,6 +9705,13 @@ function createInternalConfig(core) {
   const { config, urls } = core;
   const { url: _authUrl, ...authOptions } = config.auth ?? {};
   const { url: _storageUrl, directUpload, ...storageOptions } = config.storage ?? {};
+  const diagnostics = resolveAthenaClientDiagnostics({
+    diagnostics: config.diagnostics,
+    debugAst: config.debugAst,
+    findManyAst: config.findManyAst,
+    traceQueries: config.traceQueries,
+    env: config.env
+  });
   return {
     baseUrl: urls.db ?? MISSING_DB_SENTINEL,
     apiKey: core.key,
@@ -9631,9 +9728,9 @@ function createInternalConfig(core) {
     models: config.models,
     behavior: {
       retryReads: config.retryReads,
-      traceQueries: config.traceQueries,
-      debugAst: config.debugAst,
-      findManyAst: config.findManyAst
+      traceQueries: diagnostics.traceQueries,
+      debugAst: diagnostics.debugAst,
+      findManyAst: diagnostics.findManyAst
     },
     storage: {
       ...storageOptions,
@@ -9707,11 +9804,30 @@ function createClientView(core, viewContext) {
       return resolved.verifyConnection(options);
     },
     withContext(context) {
+      warnIfEmptyRequestContext(context);
       return createClientView(core, mergeAthenaRequestContexts(viewContext, context));
     }
   };
   return Object.freeze(client);
 }
+function isEmptyAthenaRequestContext(context) {
+  if (!context) return true;
+  const hasHeaders = context.headers != null && Object.keys(context.headers).length > 0;
+  return context.userId == null && context.organizationId == null && !normalizeOptionalContextString(context.cookie) && !normalizeOptionalContextString(context.bearerToken) && !normalizeOptionalContextString(context.sessionToken) && !context.forceNoCache && !hasHeaders;
+}
+function normalizeOptionalContextString(value) {
+  const trimmed = value?.trim();
+  return trimmed || void 0;
+}
+function warnIfEmptyRequestContext(context) {
+  if (!isEmptyAthenaRequestContext(context)) return;
+  if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") {
+    return;
+  }
+  console.warn(
+    "[athena] withContext({}) has no userId, organizationId, cookie, bearerToken, sessionToken, headers, or forceNoCache. Gateway scope headers will not change. Pass identity fields, or use createAthenaServerClient({ session, scope })."
+  );
+}
 function createClient(config) {
   return createClientView(resolveCore(config));
 }
@@ -10004,7 +10120,7 @@ function stripAthenaAuthPath(pathname) {
   }
   return normalizedPath;
 }
-function readProcessEnv2() {
+function readProcessEnv3() {
   try {
     const maybeProcess = globalThis.process;
     return maybeProcess?.env;
@@ -10041,7 +10157,7 @@ function resolveConfiguredAthenaAuthUpstreamUrl(rawUpstreamUrl) {
   if (rawUpstreamUrl) {
     return readAthenaAuthUpstreamUrlFromEnv(rawUpstreamUrl);
   }
-  const processEnv = readProcessEnv2();
+  const processEnv = readProcessEnv3();
   return processEnv ? readAthenaAuthUpstreamUrlFromEnv(processEnv) : void 0;
 }
 function normalizeAthenaAuthBaseUrl(urlOrPath) {