@xylex-group/athena 3.1.0 → 3.5.1

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

@@ -1,6 +1,6 @@
-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 { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-CgCv5o6R.cjs';
+import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-B2RZPivM.cjs';
+import { ag as AthenaClient, ay as AthenaQueryDebugAst } from './v3-client-DP-qg82X.cjs';
+import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-D5dj1v5Z.cjs';
 
 interface AthenaGatewayErrorInput {
     code: AthenaGatewayErrorCode;
@@ -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-U8NVtfSA.d.ts}

@@ -1,6 +1,6 @@
-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 { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-B75PdABb.js';
+import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-B2RZPivM.js';
+import { ag as AthenaClient, ay as AthenaQueryDebugAst } from './v3-client-OAai_JNs.js';
+import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-S-bTMPiM.js';
 
 interface AthenaGatewayErrorInput {
     code: AthenaGatewayErrorCode;
@@ -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-CMWlJ1z3.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 { 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-D5dj1v5Z.cjs';
+import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-D0ykVVOs.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-DqBFwfhn.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-DP-qg82X.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-CZ-wPcf2.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 { 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-S-bTMPiM.js';
+import { E as ModelFormNullishMode, G as ModelFormValues } from './model-form-U8NVtfSA.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-BKklrX4J.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-OAai_JNs.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';