@xylex-group/athena 3.0.3 → 3.3.0

package/dist/model-form-3Gr8rkdT.d.cts

@@ -0,0 +1,281 @@
+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-G1SLeHRa.cjs';
+import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-CgCv5o6R.cjs';
+
+interface AthenaGatewayErrorInput {
+    code: AthenaGatewayErrorCode;
+    message: string;
+    status?: number;
+    endpoint?: AthenaGatewayEndpointPath;
+    method?: AthenaGatewayMethod;
+    requestId?: string;
+    hint?: string;
+    cause?: string;
+}
+/**
+ * Canonical error for gateway failures.
+ * Holds request context and machine-readable classification.
+ */
+declare class AthenaGatewayError extends Error {
+    readonly code: AthenaGatewayErrorCode;
+    readonly status: number;
+    readonly endpoint?: AthenaGatewayEndpointPath;
+    readonly method?: AthenaGatewayMethod;
+    readonly requestId?: string;
+    readonly hint?: string;
+    readonly causeDetail?: string;
+    constructor(input: AthenaGatewayErrorInput);
+    toDetails(): AthenaGatewayErrorDetails;
+    static fromResponse<T>(response: AthenaGatewayResponse<T>, fallback: Omit<AthenaGatewayErrorInput, 'code' | 'message' | 'status'>): AthenaGatewayError;
+}
+declare function isAthenaGatewayError(error: unknown): error is AthenaGatewayError;
+
+/**
+ * Portable Athena read-query definition and executor.
+ *
+ * Runs findMany / select page queries against `createClient(...).db` with
+ * expression columns, display aliases, filters, order, and total-count handling.
+ * UI hooks (pagination, dataProxy, TanStack) live in consumer packages such as
+ * athena-auth-ui — this module is the SDK contract only.
+ */
+
+type AthenaReadQueryMode = 'findMany' | 'select';
+type AthenaReadQueryFilterOperator = 'eq' | 'gt' | 'gte' | 'ilike' | 'in' | 'is' | 'like' | 'lt' | 'lte' | 'neq';
+type AthenaReadQueryOrderDirection = 'asc' | 'desc';
+interface AthenaReadQueryRelationRef {
+    name: string;
+    schema?: string;
+    table: string;
+}
+/**
+ * One projected field: `column` is the Athena select expression (or base column),
+ * `key` is the flat-row alias after execution.
+ */
+interface AthenaReadQueryColumn {
+    column: string;
+    key: string;
+    label?: string;
+    relation?: AthenaReadQueryRelationRef;
+}
+type AthenaReadQueryFilterValue = boolean | number | null | readonly (boolean | number | string | null)[] | string;
+interface AthenaReadQueryFilter {
+    column: string;
+    operator?: AthenaReadQueryFilterOperator;
+    value: AthenaReadQueryFilterValue;
+}
+interface AthenaReadQueryOrder {
+    column: string;
+    direction?: AthenaReadQueryOrderDirection;
+}
+type AthenaReadQueryOrderByInput = AthenaReadQueryOrder | readonly AthenaReadQueryOrder[];
+/**
+ * Portable read definition shared by SDK callers, app data proxies, and UI hooks.
+ */
+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. */
+    orderBy?: AthenaReadQueryOrderByInput;
+    rowKey?: string;
+    schema?: string;
+    table: string;
+}
+declare function normalizeAthenaReadQueryOrderBy(orderBy: AthenaReadQueryOrderByInput | undefined): AthenaReadQueryOrder[];
+type AthenaReadQueryFlatRow = Record<string, unknown> & {
+    __rowKey: string;
+};
+/** Minimal client shape: any `createClient(...)` result (or scoped view) with `.db`. */
+interface AthenaReadQueryClient {
+    readonly db: AthenaClient['db'] | object;
+}
+interface AthenaReadQueryExecutionInput {
+    client: AthenaReadQueryClient;
+    page: number;
+    pageSize: number;
+    query: AthenaReadQueryDefinition;
+}
+interface AthenaReadQueryExecutionResult {
+    debugAst?: AthenaQueryDebugAst;
+    rows: AthenaReadQueryFlatRow[];
+    totalItems: number;
+}
+/** @deprecated Prefer {@link AthenaReadQueryMode}. */
+type AthenaTableQueryMode = AthenaReadQueryMode;
+/** @deprecated Prefer {@link AthenaReadQueryFilterOperator}. */
+type AthenaTableFilterOperator = AthenaReadQueryFilterOperator;
+/** @deprecated Prefer {@link AthenaReadQueryOrderDirection}. */
+type AthenaTableOrderDirection = AthenaReadQueryOrderDirection;
+/** @deprecated Prefer {@link AthenaReadQueryRelationRef}. */
+type AthenaTableRelationRef = AthenaReadQueryRelationRef;
+/** @deprecated Prefer {@link AthenaReadQueryColumn}. */
+type AthenaTableQueryColumn = AthenaReadQueryColumn;
+/** @deprecated Prefer {@link AthenaReadQueryFilterValue}. */
+type AthenaTableFilterValue = AthenaReadQueryFilterValue;
+/** @deprecated Prefer {@link AthenaReadQueryFilter}. */
+type AthenaTableFilter = AthenaReadQueryFilter;
+/** @deprecated Prefer {@link AthenaReadQueryOrder}. */
+type AthenaTableOrder = AthenaReadQueryOrder;
+/** @deprecated Prefer {@link AthenaReadQueryOrderByInput}. */
+type AthenaTableOrderByInput = AthenaReadQueryOrderByInput;
+/** @deprecated Prefer {@link AthenaReadQueryDefinition}. */
+type AthenaTableQueryDefinition = AthenaReadQueryDefinition;
+/** @deprecated Prefer {@link AthenaReadQueryFlatRow}. */
+type AthenaTableFlatRow = AthenaReadQueryFlatRow;
+/** @deprecated Prefer {@link AthenaReadQueryClient}. */
+type AthenaTableQueryClient = AthenaReadQueryClient;
+/** @deprecated Prefer {@link AthenaReadQueryExecutionInput}. */
+type AthenaTableQueryExecutionInput = AthenaReadQueryExecutionInput;
+/** @deprecated Prefer {@link AthenaReadQueryExecutionResult}. */
+type AthenaTableQueryExecutionResult = AthenaReadQueryExecutionResult;
+interface AthenaSelectRelationNode {
+    schema?: string;
+    select: AthenaSelectShape;
+}
+type AthenaSelectShape = Record<string, true | AthenaSelectRelationNode>;
+declare function flattenAthenaReadQueryRows(rows: readonly unknown[], columns: readonly AthenaReadQueryColumn[], preferredKey: string | undefined): AthenaReadQueryFlatRow[];
+/** @deprecated Prefer {@link flattenAthenaReadQueryRows}. */
+declare const flattenAthenaRows: typeof flattenAthenaReadQueryRows;
+declare function buildAthenaReadQuerySelectString(columns: readonly AthenaReadQueryColumn[]): string;
+/** @deprecated Prefer {@link buildAthenaReadQuerySelectString}. */
+declare const buildAthenaTableSelectString: typeof buildAthenaReadQuerySelectString;
+declare function buildAthenaReadQueryFindManySelect(columns: readonly AthenaReadQueryColumn[]): AthenaSelectShape;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManySelect}. */
+declare const buildAthenaTableFindManySelect: typeof buildAthenaReadQueryFindManySelect;
+declare function buildAthenaReadQueryFindManyWhere(filters: readonly AthenaReadQueryFilter[] | undefined): Record<string, object | AthenaReadQueryFilterValue> | undefined;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManyWhere}. */
+declare const buildAthenaTableFindManyWhere: typeof buildAthenaReadQueryFindManyWhere;
+/**
+ * Builds findMany `orderBy` in the Athena SDK object shape.
+ * Single-order keeps the legacy `{ column, ascending }` form for back-compat.
+ */
+declare function buildAthenaReadQueryFindManyOrderBy(orderBy: AthenaReadQueryOrderByInput | undefined): Record<string, 'asc' | 'desc' | {
+    ascending: boolean;
+}> | {
+    ascending: boolean;
+    column: string;
+} | undefined;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManyOrderBy}. */
+declare const buildAthenaTableFindManyOrderBy: typeof buildAthenaReadQueryFindManyOrderBy;
+/** @deprecated Prefer {@link normalizeAthenaReadQueryOrderBy}. */
+declare const normalizeAthenaTableOrderBy: typeof normalizeAthenaReadQueryOrderBy;
+declare function applyAthenaReadQueryFilters<T extends object>(queryBuilder: T, filters: readonly AthenaReadQueryFilter[] | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQueryFilters}. */
+declare const applyAthenaTableFilters: typeof applyAthenaReadQueryFilters;
+declare function applyAthenaReadQuerySelectOrder<T extends {
+    order: (column: string, options: {
+        ascending: boolean;
+    }) => T;
+}>(queryBuilder: T, orderBy: AthenaReadQueryOrderByInput | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQuerySelectOrder}. */
+declare const applyAthenaTableSelectOrder: typeof applyAthenaReadQuerySelectOrder;
+declare function applyAthenaReadQuerySelectLimit<T extends {
+    limit: (value: number) => T;
+}>(queryBuilder: T, limit: number | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQuerySelectLimit}. */
+declare const applyAthenaTableSelectLimit: typeof applyAthenaReadQuerySelectLimit;
+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.
+ *
+ * Pass `createClient({ url, key })` or a `withContext` / session-scoped view.
+ * Does not construct clients and does not perform HTTP proxy routing.
+ */
+declare function executeAthenaReadQuery({ client, page, pageSize, query, }: AthenaReadQueryExecutionInput): Promise<AthenaReadQueryExecutionResult>;
+/**
+ * @deprecated Prefer {@link executeAthenaReadQuery}. Same implementation.
+ */
+declare const executeAthenaTableQuery: typeof executeAthenaReadQuery;
+
+type ModelFormNullishMode = 'empty-string' | 'undefined' | 'null';
+type NullishValueByMode = {
+    'empty-string': '';
+    undefined: undefined;
+    null: null;
+};
+type MapNullableToFormValue<TField, TMode extends ModelFormNullishMode> = null extends TField ? Exclude<TField, null> | NullishValueByMode[TMode] : TField;
+/**
+ * Form value shape derived from a model insert payload.
+ * Nullable fields are remapped to the selected nullish representation.
+ */
+type ModelFormValues<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = {
+    [K in keyof InsertOf<TModel>]: MapNullableToFormValue<InsertOf<TModel>[K], TMode>;
+};
+/**
+ * Alias for deriving form value types from any model contract.
+ */
+type FormValuesOf<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = ModelFormValues<TModel, TMode>;
+/**
+ * Default value shape for form initialization.
+ */
+type ModelFormDefaults<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = Partial<ModelFormValues<TModel, TMode>>;
+interface ToModelFormDefaultsOptions<TMode extends ModelFormNullishMode = 'empty-string'> {
+    /**
+     * Controls how nullable model values are represented in form defaults.
+     * - `empty-string` (default): `null -> ""`
+     * - `undefined`: `null -> undefined`
+     * - `null`: keeps `null`
+     */
+    nullishMode?: TMode;
+}
+interface ToModelPayloadOptions {
+    /**
+     * Converts `""` into `null` for nullable model fields.
+     * Defaults to `true`.
+     */
+    emptyStringAsNull?: boolean;
+    /**
+     * Omits `undefined` keys from the outgoing payload.
+     * Defaults to `true`.
+     */
+    stripUndefined?: boolean;
+}
+/**
+ * Normalizes model data into form-safe defaults using model nullability metadata.
+ */
+declare function toModelFormDefaults<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'>(model: TModel, values?: Partial<RowOf<TModel>> | Partial<InsertOf<TModel>> | null, options?: ToModelFormDefaultsOptions<TMode>): ModelFormDefaults<TModel, TMode>;
+/**
+ * Normalizes form values back into model-compatible insert/update payloads.
+ */
+declare function toModelPayload<TModel extends AnyModelDef>(model: TModel, formValues: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<InsertOf<TModel>>;
+/**
+ * Runtime form adapter bound to a model contract.
+ */
+interface ModelFormAdapter<TModel extends AnyModelDef> {
+    model: TModel;
+    toDefaults<TMode extends ModelFormNullishMode = 'empty-string'>(values?: Partial<RowOf<TModel>> | Partial<InsertOf<TModel>> | null, options?: ToModelFormDefaultsOptions<TMode>): ModelFormDefaults<TModel, TMode>;
+    toInsert(values: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<InsertOf<TModel>>;
+    toUpdate(values: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<UpdateOf<TModel>>;
+}
+/**
+ * Creates a small model-aware adapter for form defaults and payload normalization.
+ */
+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, 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-CotpEL7z.d.ts

@@ -0,0 +1,281 @@
+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-ao8BWQ8v.js';
+import { s as AnyModelDef, a as InsertOf, n as RowOf, U as UpdateOf } from './types-B75PdABb.js';
+
+interface AthenaGatewayErrorInput {
+    code: AthenaGatewayErrorCode;
+    message: string;
+    status?: number;
+    endpoint?: AthenaGatewayEndpointPath;
+    method?: AthenaGatewayMethod;
+    requestId?: string;
+    hint?: string;
+    cause?: string;
+}
+/**
+ * Canonical error for gateway failures.
+ * Holds request context and machine-readable classification.
+ */
+declare class AthenaGatewayError extends Error {
+    readonly code: AthenaGatewayErrorCode;
+    readonly status: number;
+    readonly endpoint?: AthenaGatewayEndpointPath;
+    readonly method?: AthenaGatewayMethod;
+    readonly requestId?: string;
+    readonly hint?: string;
+    readonly causeDetail?: string;
+    constructor(input: AthenaGatewayErrorInput);
+    toDetails(): AthenaGatewayErrorDetails;
+    static fromResponse<T>(response: AthenaGatewayResponse<T>, fallback: Omit<AthenaGatewayErrorInput, 'code' | 'message' | 'status'>): AthenaGatewayError;
+}
+declare function isAthenaGatewayError(error: unknown): error is AthenaGatewayError;
+
+/**
+ * Portable Athena read-query definition and executor.
+ *
+ * Runs findMany / select page queries against `createClient(...).db` with
+ * expression columns, display aliases, filters, order, and total-count handling.
+ * UI hooks (pagination, dataProxy, TanStack) live in consumer packages such as
+ * athena-auth-ui — this module is the SDK contract only.
+ */
+
+type AthenaReadQueryMode = 'findMany' | 'select';
+type AthenaReadQueryFilterOperator = 'eq' | 'gt' | 'gte' | 'ilike' | 'in' | 'is' | 'like' | 'lt' | 'lte' | 'neq';
+type AthenaReadQueryOrderDirection = 'asc' | 'desc';
+interface AthenaReadQueryRelationRef {
+    name: string;
+    schema?: string;
+    table: string;
+}
+/**
+ * One projected field: `column` is the Athena select expression (or base column),
+ * `key` is the flat-row alias after execution.
+ */
+interface AthenaReadQueryColumn {
+    column: string;
+    key: string;
+    label?: string;
+    relation?: AthenaReadQueryRelationRef;
+}
+type AthenaReadQueryFilterValue = boolean | number | null | readonly (boolean | number | string | null)[] | string;
+interface AthenaReadQueryFilter {
+    column: string;
+    operator?: AthenaReadQueryFilterOperator;
+    value: AthenaReadQueryFilterValue;
+}
+interface AthenaReadQueryOrder {
+    column: string;
+    direction?: AthenaReadQueryOrderDirection;
+}
+type AthenaReadQueryOrderByInput = AthenaReadQueryOrder | readonly AthenaReadQueryOrder[];
+/**
+ * Portable read definition shared by SDK callers, app data proxies, and UI hooks.
+ */
+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. */
+    orderBy?: AthenaReadQueryOrderByInput;
+    rowKey?: string;
+    schema?: string;
+    table: string;
+}
+declare function normalizeAthenaReadQueryOrderBy(orderBy: AthenaReadQueryOrderByInput | undefined): AthenaReadQueryOrder[];
+type AthenaReadQueryFlatRow = Record<string, unknown> & {
+    __rowKey: string;
+};
+/** Minimal client shape: any `createClient(...)` result (or scoped view) with `.db`. */
+interface AthenaReadQueryClient {
+    readonly db: AthenaClient['db'] | object;
+}
+interface AthenaReadQueryExecutionInput {
+    client: AthenaReadQueryClient;
+    page: number;
+    pageSize: number;
+    query: AthenaReadQueryDefinition;
+}
+interface AthenaReadQueryExecutionResult {
+    debugAst?: AthenaQueryDebugAst;
+    rows: AthenaReadQueryFlatRow[];
+    totalItems: number;
+}
+/** @deprecated Prefer {@link AthenaReadQueryMode}. */
+type AthenaTableQueryMode = AthenaReadQueryMode;
+/** @deprecated Prefer {@link AthenaReadQueryFilterOperator}. */
+type AthenaTableFilterOperator = AthenaReadQueryFilterOperator;
+/** @deprecated Prefer {@link AthenaReadQueryOrderDirection}. */
+type AthenaTableOrderDirection = AthenaReadQueryOrderDirection;
+/** @deprecated Prefer {@link AthenaReadQueryRelationRef}. */
+type AthenaTableRelationRef = AthenaReadQueryRelationRef;
+/** @deprecated Prefer {@link AthenaReadQueryColumn}. */
+type AthenaTableQueryColumn = AthenaReadQueryColumn;
+/** @deprecated Prefer {@link AthenaReadQueryFilterValue}. */
+type AthenaTableFilterValue = AthenaReadQueryFilterValue;
+/** @deprecated Prefer {@link AthenaReadQueryFilter}. */
+type AthenaTableFilter = AthenaReadQueryFilter;
+/** @deprecated Prefer {@link AthenaReadQueryOrder}. */
+type AthenaTableOrder = AthenaReadQueryOrder;
+/** @deprecated Prefer {@link AthenaReadQueryOrderByInput}. */
+type AthenaTableOrderByInput = AthenaReadQueryOrderByInput;
+/** @deprecated Prefer {@link AthenaReadQueryDefinition}. */
+type AthenaTableQueryDefinition = AthenaReadQueryDefinition;
+/** @deprecated Prefer {@link AthenaReadQueryFlatRow}. */
+type AthenaTableFlatRow = AthenaReadQueryFlatRow;
+/** @deprecated Prefer {@link AthenaReadQueryClient}. */
+type AthenaTableQueryClient = AthenaReadQueryClient;
+/** @deprecated Prefer {@link AthenaReadQueryExecutionInput}. */
+type AthenaTableQueryExecutionInput = AthenaReadQueryExecutionInput;
+/** @deprecated Prefer {@link AthenaReadQueryExecutionResult}. */
+type AthenaTableQueryExecutionResult = AthenaReadQueryExecutionResult;
+interface AthenaSelectRelationNode {
+    schema?: string;
+    select: AthenaSelectShape;
+}
+type AthenaSelectShape = Record<string, true | AthenaSelectRelationNode>;
+declare function flattenAthenaReadQueryRows(rows: readonly unknown[], columns: readonly AthenaReadQueryColumn[], preferredKey: string | undefined): AthenaReadQueryFlatRow[];
+/** @deprecated Prefer {@link flattenAthenaReadQueryRows}. */
+declare const flattenAthenaRows: typeof flattenAthenaReadQueryRows;
+declare function buildAthenaReadQuerySelectString(columns: readonly AthenaReadQueryColumn[]): string;
+/** @deprecated Prefer {@link buildAthenaReadQuerySelectString}. */
+declare const buildAthenaTableSelectString: typeof buildAthenaReadQuerySelectString;
+declare function buildAthenaReadQueryFindManySelect(columns: readonly AthenaReadQueryColumn[]): AthenaSelectShape;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManySelect}. */
+declare const buildAthenaTableFindManySelect: typeof buildAthenaReadQueryFindManySelect;
+declare function buildAthenaReadQueryFindManyWhere(filters: readonly AthenaReadQueryFilter[] | undefined): Record<string, object | AthenaReadQueryFilterValue> | undefined;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManyWhere}. */
+declare const buildAthenaTableFindManyWhere: typeof buildAthenaReadQueryFindManyWhere;
+/**
+ * Builds findMany `orderBy` in the Athena SDK object shape.
+ * Single-order keeps the legacy `{ column, ascending }` form for back-compat.
+ */
+declare function buildAthenaReadQueryFindManyOrderBy(orderBy: AthenaReadQueryOrderByInput | undefined): Record<string, 'asc' | 'desc' | {
+    ascending: boolean;
+}> | {
+    ascending: boolean;
+    column: string;
+} | undefined;
+/** @deprecated Prefer {@link buildAthenaReadQueryFindManyOrderBy}. */
+declare const buildAthenaTableFindManyOrderBy: typeof buildAthenaReadQueryFindManyOrderBy;
+/** @deprecated Prefer {@link normalizeAthenaReadQueryOrderBy}. */
+declare const normalizeAthenaTableOrderBy: typeof normalizeAthenaReadQueryOrderBy;
+declare function applyAthenaReadQueryFilters<T extends object>(queryBuilder: T, filters: readonly AthenaReadQueryFilter[] | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQueryFilters}. */
+declare const applyAthenaTableFilters: typeof applyAthenaReadQueryFilters;
+declare function applyAthenaReadQuerySelectOrder<T extends {
+    order: (column: string, options: {
+        ascending: boolean;
+    }) => T;
+}>(queryBuilder: T, orderBy: AthenaReadQueryOrderByInput | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQuerySelectOrder}. */
+declare const applyAthenaTableSelectOrder: typeof applyAthenaReadQuerySelectOrder;
+declare function applyAthenaReadQuerySelectLimit<T extends {
+    limit: (value: number) => T;
+}>(queryBuilder: T, limit: number | undefined): T;
+/** @deprecated Prefer {@link applyAthenaReadQuerySelectLimit}. */
+declare const applyAthenaTableSelectLimit: typeof applyAthenaReadQuerySelectLimit;
+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.
+ *
+ * Pass `createClient({ url, key })` or a `withContext` / session-scoped view.
+ * Does not construct clients and does not perform HTTP proxy routing.
+ */
+declare function executeAthenaReadQuery({ client, page, pageSize, query, }: AthenaReadQueryExecutionInput): Promise<AthenaReadQueryExecutionResult>;
+/**
+ * @deprecated Prefer {@link executeAthenaReadQuery}. Same implementation.
+ */
+declare const executeAthenaTableQuery: typeof executeAthenaReadQuery;
+
+type ModelFormNullishMode = 'empty-string' | 'undefined' | 'null';
+type NullishValueByMode = {
+    'empty-string': '';
+    undefined: undefined;
+    null: null;
+};
+type MapNullableToFormValue<TField, TMode extends ModelFormNullishMode> = null extends TField ? Exclude<TField, null> | NullishValueByMode[TMode] : TField;
+/**
+ * Form value shape derived from a model insert payload.
+ * Nullable fields are remapped to the selected nullish representation.
+ */
+type ModelFormValues<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = {
+    [K in keyof InsertOf<TModel>]: MapNullableToFormValue<InsertOf<TModel>[K], TMode>;
+};
+/**
+ * Alias for deriving form value types from any model contract.
+ */
+type FormValuesOf<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = ModelFormValues<TModel, TMode>;
+/**
+ * Default value shape for form initialization.
+ */
+type ModelFormDefaults<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'> = Partial<ModelFormValues<TModel, TMode>>;
+interface ToModelFormDefaultsOptions<TMode extends ModelFormNullishMode = 'empty-string'> {
+    /**
+     * Controls how nullable model values are represented in form defaults.
+     * - `empty-string` (default): `null -> ""`
+     * - `undefined`: `null -> undefined`
+     * - `null`: keeps `null`
+     */
+    nullishMode?: TMode;
+}
+interface ToModelPayloadOptions {
+    /**
+     * Converts `""` into `null` for nullable model fields.
+     * Defaults to `true`.
+     */
+    emptyStringAsNull?: boolean;
+    /**
+     * Omits `undefined` keys from the outgoing payload.
+     * Defaults to `true`.
+     */
+    stripUndefined?: boolean;
+}
+/**
+ * Normalizes model data into form-safe defaults using model nullability metadata.
+ */
+declare function toModelFormDefaults<TModel extends AnyModelDef, TMode extends ModelFormNullishMode = 'empty-string'>(model: TModel, values?: Partial<RowOf<TModel>> | Partial<InsertOf<TModel>> | null, options?: ToModelFormDefaultsOptions<TMode>): ModelFormDefaults<TModel, TMode>;
+/**
+ * Normalizes form values back into model-compatible insert/update payloads.
+ */
+declare function toModelPayload<TModel extends AnyModelDef>(model: TModel, formValues: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<InsertOf<TModel>>;
+/**
+ * Runtime form adapter bound to a model contract.
+ */
+interface ModelFormAdapter<TModel extends AnyModelDef> {
+    model: TModel;
+    toDefaults<TMode extends ModelFormNullishMode = 'empty-string'>(values?: Partial<RowOf<TModel>> | Partial<InsertOf<TModel>> | null, options?: ToModelFormDefaultsOptions<TMode>): ModelFormDefaults<TModel, TMode>;
+    toInsert(values: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<InsertOf<TModel>>;
+    toUpdate(values: Partial<ModelFormValues<TModel, 'empty-string' | 'undefined' | 'null'>>, options?: ToModelPayloadOptions): Partial<UpdateOf<TModel>>;
+}
+/**
+ * Creates a small model-aware adapter for form defaults and payload normalization.
+ */
+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, 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-CPG3ULxQ.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 { b as ModelFormNullishMode, c as ModelFormValues } from './model-form-oOAJUVd4.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-DFr2cL1N.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-BruTcxe0.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 { b as ModelFormNullishMode, c as ModelFormValues } from './model-form-Dh0sisdL.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-D6tZ9aoq.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';