@xylex-group/athena 2.7.0 → 2.8.2

package/dist/{model-form-ehfqLuG7.d.cts → model-form-_ugfOXao.d.cts}

@@ -1,4 +1,4 @@
-import { i as AthenaJsonValue, a as AthenaGatewayCallOptions, g as AthenaJsonObject, j as AthenaRpcCallOptions, W as AthenaGatewayEndpointPath, X as AthenaGatewayMethod, Y as AthenaConditionValue, Z as AthenaConditionArrayValue, R as RegistryDef, D as DatabaseDef, F as SchemaDef, J as AnyModelDef, x as ModelDef, C as ModelRelationMetadata, E as RowOf, o as BackendConfig, p as BackendType, e as AthenaGatewayErrorDetails, A as AthenaConditionCastType, _ as AthenaConditionOperator, b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, d as AthenaGatewayErrorCode, P as AthenaGatewayResponse, q as InsertOf, U as UpdateOf } from './types-BsyRW49r.cjs';
+import { j as AthenaModelTarget, H as RowOf, r as InsertOf, U as UpdateOf, i as AthenaJsonValue, a as AthenaGatewayCallOptions, g as AthenaJsonObject, k as AthenaRpcCallOptions, b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, V as AthenaFetchPayload, W as AthenaGatewayResponse, X as AthenaInsertPayload, Y as AthenaUpdatePayload, Q as AthenaDeletePayload, o as AthenaRpcPayload, Z as AthenaQueryPayload, _ as AthenaGatewayEndpointPath, $ as AthenaGatewayMethod, a0 as AthenaConditionValue, a1 as AthenaConditionArrayValue, R as RegistryDef, D as DatabaseDef, J as SchemaDef, N as AnyModelDef, C as ModelDef, G as ModelRelationMetadata, a2 as AthenaGatewayCondition, a3 as AthenaSortBy, l as AthenaRpcFilter, p as BackendConfig, q as BackendType, e as AthenaGatewayErrorDetails, A as AthenaConditionCastType, a4 as AthenaConditionOperator, d as AthenaGatewayErrorCode } from './types-g8G6J0xE.cjs';
 
 type AthenaAuthMethod = 'GET' | 'POST';
 type AthenaAuthCredentials = 'omit' | 'same-origin' | 'include';
@@ -1396,6 +1396,10 @@ declare class AthenaError extends Error {
  */
 declare function isOk<T>(result: AthenaResult<T>): boolean;
 /**
+ * @deprecated Prefer `result.error` on failed `AthenaResult` values and the
+ * structured fields already attached to thrown SDK errors. This helper is
+ * retained for compatibility with mixed unknown inputs.
+ *
  * Normalizes any Athena failure shape into a stable, typed error envelope.
  *
  * Accepts `AthenaResult`, `AthenaGatewayError`, native `Error`, or unknown values.
@@ -1466,26 +1470,66 @@ declare function assertInt(value: unknown, label?: string, options?: IntCoercion
  */
 declare function withRetry<T>(config: RetryConfig, fn: () => Promise<T>): Promise<T>;
 
+type Whitespace = ' ' | '\n' | '\r' | '\t';
+type TrimLeft<TValue extends string> = TValue extends `${Whitespace}${infer TRest}` ? TrimLeft<TRest> : TValue;
+type TrimRight<TValue extends string> = TValue extends `${infer TRest}${Whitespace}` ? TrimRight<TRest> : TValue;
+type Trim<TValue extends string> = TrimLeft<TrimRight<TValue>>;
+type KnownSelectColumnKey<Row> = Extract<keyof NonNullable<Row>, string>;
+type HasKnownSelectColumns<Row> = [KnownSelectColumnKey<Row>] extends [never] ? false : string extends KnownSelectColumnKey<Row> ? false : true;
+type HasComplexSelectTokenSyntax<TValue extends string> = TValue extends `${string}(${string}` ? true : TValue extends `${string})${string}` ? true : TValue extends `${string}.${string}` ? true : TValue extends `${string}"${string}` ? true : TValue extends `${string}'${string}` ? true : false;
+type ValidateAliasedBase<Row, TOriginal extends string, TBase extends string> = HasComplexSelectTokenSyntax<Trim<TBase>> extends true ? TOriginal : Trim<TBase> extends KnownSelectColumnKey<Row> ? TOriginal : never;
+type ValidateSelectToken<Row, TToken extends string> = Trim<TToken> extends infer TTrimmed extends string ? TTrimmed extends '' ? never : TTrimmed extends '*' ? TTrimmed : TTrimmed extends `${string}:${infer TBase}` ? ValidateAliasedBase<Row, TTrimmed, TBase> : TTrimmed extends `${infer TBase} as ${string}` ? ValidateAliasedBase<Row, TTrimmed, TBase> : TTrimmed extends `${infer TBase} AS ${string}` ? ValidateAliasedBase<Row, TTrimmed, TBase> : HasComplexSelectTokenSyntax<TTrimmed> extends true ? TTrimmed : TTrimmed extends KnownSelectColumnKey<Row> ? TTrimmed : never : never;
+type ValidateSelectList<Row, TValue extends string> = string extends TValue ? TValue : HasComplexSelectTokenSyntax<TValue> extends true ? TValue : TValue extends `${infer THead},${infer TTail}` ? ValidateSelectToken<Row, THead> extends never ? never : ValidateSelectList<Row, TTail> extends never ? never : TValue : ValidateSelectToken<Row, TValue> extends never ? never : TValue;
+type ValidateSelectArray<Row, TValue extends readonly string[]> = string extends TValue[number] ? TValue : TValue extends readonly [
+    infer THead extends string,
+    ...infer TTail extends readonly string[]
+] ? ValidateSelectToken<Row, THead> extends never ? never : ValidateSelectArray<Row, TTail> extends never ? never : TValue : TValue;
+type AthenaSelectInput = string | string[] | readonly string[];
+type AthenaValidatedSelectInput<Row, TValue extends AthenaSelectInput> = HasKnownSelectColumns<Row> extends true ? TValue extends string ? ValidateSelectList<Row, TValue> : TValue extends readonly string[] ? ValidateSelectArray<Row, TValue> : never : TValue;
+type AthenaTypecheckedColumnKey<Row, TEnabled extends boolean> = TEnabled extends true ? HasKnownSelectColumns<Row> extends true ? KnownSelectColumnKey<Row> : string : string;
+
 type AthenaRowShape$2 = Record<string, AthenaJsonValue | undefined>;
 type AthenaUpsertOptions<Update> = AthenaGatewayCallOptions & {
     updateBody?: Update;
     onConflict?: string | string[];
 };
-interface AthenaDbModule {
-    from<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, options?: AthenaFromOptions): TableQueryBuilder<Row, Insert, Update>;
-    select<Row = AthenaRowShape$2, SelectedRow = Row>(table: string, columns?: string | string[], options?: AthenaGatewayCallOptions): SelectChain<Row, SelectedRow>;
-    insert<Row = AthenaRowShape$2, Insert = Partial<Row>>(table: string, values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row>;
-    insert<Row = AthenaRowShape$2, Insert = Partial<Row>>(table: string, values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[]>;
-    upsert<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert, options?: AthenaUpsertOptions<Update>): MutationQuery<Row>;
-    upsert<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert[], options?: AthenaUpsertOptions<Update>): MutationQuery<Row[]>;
-    update<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row>;
+interface AthenaDbModule<TStrict extends boolean = false> {
+    from<TModel extends AthenaModelTarget>(model: TModel): TableQueryBuilder<RowOf<TModel>, InsertOf<TModel>, UpdateOf<TModel>, unknown, TStrict>;
+    from<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, options?: AthenaFromOptions): TableQueryBuilder<Row, Insert, Update, unknown, TStrict>;
+    select<Row = AthenaRowShape$2>(table: string, options?: AthenaGatewayCallOptions): SelectChain<Row, Row, TStrict>;
+    select(table: string, columns: AthenaSelectInput, options?: AthenaGatewayCallOptions): SelectChain<AthenaRowShape$2, AthenaRowShape$2, TStrict>;
+    insert<Row = AthenaRowShape$2, Insert = Partial<Row>>(table: string, values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row, Row, TStrict>;
+    insert<Row = AthenaRowShape$2, Insert = Partial<Row>>(table: string, values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[], Row, TStrict>;
+    upsert<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert, options?: AthenaUpsertOptions<Update>): MutationQuery<Row, Row, TStrict>;
+    upsert<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Insert[], options?: AthenaUpsertOptions<Update>): MutationQuery<Row[], Row, TStrict>;
+    update<Row = AthenaRowShape$2, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row, TStrict>;
     delete<Row = AthenaRowShape$2>(table: string, options?: AthenaGatewayCallOptions & {
         resourceId?: string;
-    }): MutationQuery<Row | null>;
-    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row>;
+    }): MutationQuery<Row | null, Row, TStrict>;
+    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row, TStrict>;
     query<Row = unknown>(query: string, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Row[]>>;
 }
 
+interface AthenaFindManyAstPayload$1 {
+    table_name: string;
+    select: Record<string, unknown>;
+    where?: Record<string, unknown>;
+    orderBy?: Record<string, unknown>;
+    limit?: number;
+}
+declare function verifyAthenaGatewayUrl(baseUrl: string, options?: AthenaGatewayConnectionOptions): Promise<AthenaGatewayConnectionResult>;
+interface AthenaGatewayClient {
+    baseUrl: string;
+    buildHeaders(options?: AthenaGatewayCallOptions): Record<string, string>;
+    verifyConnection(options?: AthenaGatewayConnectionOptions): Promise<AthenaGatewayConnectionResult>;
+    fetchGateway<T>(payload: AthenaFetchPayload | AthenaFindManyAstPayload$1, options?: AthenaGatewayCallOptions): Promise<AthenaGatewayResponse<T>>;
+    insertGateway<T>(payload: AthenaInsertPayload, options?: AthenaGatewayCallOptions): Promise<AthenaGatewayResponse<T>>;
+    updateGateway<T>(payload: AthenaUpdatePayload, options?: AthenaGatewayCallOptions): Promise<AthenaGatewayResponse<T>>;
+    deleteGateway<T>(payload: AthenaDeletePayload, options?: AthenaGatewayCallOptions): Promise<AthenaGatewayResponse<T>>;
+    rpcGateway<T>(payload: AthenaRpcPayload, options?: AthenaRpcCallOptions): Promise<AthenaGatewayResponse<T>>;
+    queryGateway<T>(payload: AthenaQueryPayload, options?: AthenaGatewayCallOptions): Promise<AthenaGatewayResponse<T>>;
+}
+
 type AthenaStorageTemplateValue = string | number | boolean | null | undefined;
 type AthenaStorageTemplateVars = Record<string, AthenaStorageTemplateValue>;
 type AthenaStorageEnv = Record<string, string | undefined>;
@@ -1532,7 +1576,7 @@ interface AthenaStorageUploadProgress {
     aggregatePercent: number;
 }
 type AthenaStorageUploadProgressHandler = (progress: AthenaStorageUploadProgress) => void;
-interface AthenaStorageFileUploadInput extends AthenaStorageUploadConstraints {
+interface AthenaStorageFileUploadInput extends AthenaStorageUploadConstraints, StorageServerSideEncryptionOptions {
     s3_id: string;
     bucket?: string;
     files: AthenaStorageUploadSource | ArrayLike<AthenaStorageUploadSource> | readonly AthenaStorageUploadSource[];
@@ -1706,6 +1750,21 @@ declare const storageSdkManifest: {
         readonly requestType: "SetStorageFileVisibilityRequest";
         readonly responseEnvelope: "athena";
         readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "postStorageFileVisibility";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/visibility";
+        readonly pathParams: readonly ["file_id"];
+        readonly requestType: "SetStorageFileVisibilityRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "setManyStorageFileVisibility";
+        readonly method: "POST";
+        readonly path: "/storage/files/visibility-many";
+        readonly requestType: "SetManyStorageFileVisibilityRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationManyResponse";
     }, {
         readonly name: "deleteStorageFolder";
         readonly method: "POST";
@@ -1720,6 +1779,425 @@ declare const storageSdkManifest: {
         readonly requestType: "MoveStorageFolderRequest";
         readonly responseEnvelope: "athena";
         readonly responseType: "StorageFolderMutationResponse";
+    }, {
+        readonly name: "searchStorageFiles";
+        readonly method: "POST";
+        readonly path: "/storage/files/search";
+        readonly requestType: "SearchStorageFilesRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageListFilesResponse";
+    }, {
+        readonly name: "confirmStorageUpload";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/confirm-upload";
+        readonly pathParams: readonly ["file_id"];
+        readonly requestType: "ConfirmStorageUploadRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "uploadStorageFileBinary";
+        readonly method: "PUT";
+        readonly path: "/storage/files/{file_id}/upload";
+        readonly pathParams: readonly ["file_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+        readonly binary: true;
+    }, {
+        readonly name: "copyStorageFile";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/copy";
+        readonly pathParams: readonly ["file_id"];
+        readonly requestType: "CopyStorageFileRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "deleteManyStorageFiles";
+        readonly method: "POST";
+        readonly path: "/storage/files/delete-many";
+        readonly requestType: "DeleteManyStorageFilesRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationManyResponse";
+    }, {
+        readonly name: "updateManyStorageFiles";
+        readonly method: "POST";
+        readonly path: "/storage/files/update-many";
+        readonly requestType: "UpdateManyStorageFilesRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationManyResponse";
+    }, {
+        readonly name: "restoreStorageFile";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/restore";
+        readonly pathParams: readonly ["file_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "purgeStorageFile";
+        readonly method: "DELETE";
+        readonly path: "/storage/files/{file_id}/purge";
+        readonly pathParams: readonly ["file_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "getStorageFilePublicUrl";
+        readonly method: "GET";
+        readonly path: "/storage/files/{file_id}/public-url";
+        readonly pathParams: readonly ["file_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageFileProxyUrl";
+        readonly method: "GET";
+        readonly path: "/storage/files/{file_id}/proxy-url";
+        readonly pathParams: readonly ["file_id"];
+        readonly queryParams: readonly ["purpose"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageFileVersions";
+        readonly method: "GET";
+        readonly path: "/storage/files/{file_id}/versions";
+        readonly pathParams: readonly ["file_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "restoreStorageFileVersion";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/versions/{version_id}/restore";
+        readonly pathParams: readonly ["file_id", "version_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageFileVersion";
+        readonly method: "DELETE";
+        readonly path: "/storage/files/{file_id}/versions/{version_id}";
+        readonly pathParams: readonly ["file_id", "version_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageFileRetention";
+        readonly method: "GET";
+        readonly path: "/storage/files/{file_id}/retention";
+        readonly pathParams: readonly ["file_id"];
+        readonly queryParams: readonly ["version_id"];
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "setStorageFileRetention";
+        readonly method: "POST";
+        readonly path: "/storage/files/{file_id}/retention";
+        readonly pathParams: readonly ["file_id"];
+        readonly requestType: "StorageFileRetentionRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageFolders";
+        readonly method: "POST";
+        readonly path: "/storage/folders/list";
+        readonly requestType: "ListStorageFoldersRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "treeStorageFolders";
+        readonly method: "POST";
+        readonly path: "/storage/folders/tree";
+        readonly requestType: "TreeStorageFoldersRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStoragePermissions";
+        readonly method: "POST";
+        readonly path: "/storage/permissions/list";
+        readonly requestType: "StoragePermissionListRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StoragePermissionListResponse";
+    }, {
+        readonly name: "grantStoragePermission";
+        readonly method: "POST";
+        readonly path: "/storage/permissions/grant";
+        readonly requestType: "StoragePermissionGrantRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "revokeStoragePermission";
+        readonly method: "POST";
+        readonly path: "/storage/permissions/revoke";
+        readonly requestType: "StoragePermissionRevokeRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "checkStoragePermission";
+        readonly method: "POST";
+        readonly path: "/storage/permissions/check";
+        readonly requestType: "StoragePermissionCheckRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StoragePermissionCheckResponse";
+    }, {
+        readonly name: "listStorageObjects";
+        readonly method: "POST";
+        readonly path: "/storage/objects";
+        readonly requestType: "StorageListObjectsRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "headStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/head";
+        readonly requestType: "StorageObjectRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "existsStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/exists";
+        readonly requestType: "StorageObjectRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "validateStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/validate";
+        readonly requestType: "StorageObjectValidateRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "updateStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/update";
+        readonly requestType: "StorageUpdateObjectRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "copyStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/copy";
+        readonly requestType: "StorageObjectCopyRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageObjectUrl";
+        readonly method: "POST";
+        readonly path: "/storage/objects/url";
+        readonly requestType: "StorageObjectRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageObjectPublicUrl";
+        readonly method: "POST";
+        readonly path: "/storage/objects/public-url";
+        readonly requestType: "StorageObjectPublicUrlRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageObject";
+        readonly method: "POST";
+        readonly path: "/storage/objects/delete";
+        readonly requestType: "StorageObjectRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "createStorageObjectUploadUrl";
+        readonly method: "POST";
+        readonly path: "/storage/objects/upload-url";
+        readonly requestType: "StoragePresignUploadRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "createStorageObjectPostPolicy";
+        readonly method: "POST";
+        readonly path: "/storage/objects/post-policy";
+        readonly requestType: "StorageSignedPostPolicyRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageObjectVersions";
+        readonly method: "POST";
+        readonly path: "/storage/objects/versions";
+        readonly requestType: "StorageObjectVersionListRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "restoreStorageObjectVersion";
+        readonly method: "POST";
+        readonly path: "/storage/objects/versions/restore";
+        readonly requestType: "StorageObjectVersionMutationRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageObjectVersion";
+        readonly method: "POST";
+        readonly path: "/storage/objects/versions/delete";
+        readonly requestType: "StorageObjectVersionMutationRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "createStorageObjectFolder";
+        readonly method: "POST";
+        readonly path: "/storage/objects/folder";
+        readonly requestType: "StorageObjectFolderCreateRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageObjectFolder";
+        readonly method: "POST";
+        readonly path: "/storage/objects/folder/delete";
+        readonly requestType: "StorageObjectFolderDeleteRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "renameStorageObjectFolder";
+        readonly method: "POST";
+        readonly path: "/storage/objects/folder/rename";
+        readonly requestType: "StorageObjectFolderRenameRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageBuckets";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/list";
+        readonly requestType: "Omit<StorageObjectBaseRequest, 'bucket'>";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "createStorageBucket";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/create";
+        readonly requestType: "StorageObjectBaseRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageBucket";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/delete";
+        readonly requestType: "StorageObjectBaseRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageBucketLifecycle";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/lifecycle";
+        readonly requestType: "StorageBucketLifecycleRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "setStorageBucketLifecycle";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/lifecycle/set";
+        readonly requestType: "StorageSetBucketLifecycleRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageBucketLifecycle";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/lifecycle/delete";
+        readonly requestType: "StorageBucketLifecycleRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageBucketPolicy";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/policy";
+        readonly requestType: "StorageBucketPolicyRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "setStorageBucketPolicy";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/policy/set";
+        readonly requestType: "StorageSetBucketPolicyRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageBucketPolicy";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/policy/delete";
+        readonly requestType: "StorageBucketPolicyRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageBucketPublicAccess";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/public-access";
+        readonly requestType: "StoragePublicAccessBlockRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "setStorageBucketPublicAccess";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/public-access/set";
+        readonly requestType: "StorageSetPublicAccessBlockRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageBucketPublicAccess";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/public-access/delete";
+        readonly requestType: "StoragePublicAccessBlockRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "getStorageBucketCors";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/cors";
+        readonly requestType: "StorageBucketCorsRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "setStorageBucketCors";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/cors/set";
+        readonly requestType: "StorageSetBucketCorsRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "deleteStorageBucketCors";
+        readonly method: "POST";
+        readonly path: "/storage/buckets/cors/delete";
+        readonly requestType: "StorageBucketCorsRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "createStorageMultipartUpload";
+        readonly method: "POST";
+        readonly path: "/storage/multipart/create";
+        readonly requestType: "StorageMultipartCreateRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "signStorageMultipartPart";
+        readonly method: "POST";
+        readonly path: "/storage/multipart/sign-part";
+        readonly requestType: "StorageMultipartSignPartRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "completeStorageMultipartUpload";
+        readonly method: "POST";
+        readonly path: "/storage/multipart/complete";
+        readonly requestType: "StorageMultipartCompleteRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageFileMutationResponse";
+    }, {
+        readonly name: "abortStorageMultipartUpload";
+        readonly method: "POST";
+        readonly path: "/storage/multipart/abort";
+        readonly requestType: "StorageMultipartAbortRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageMultipartParts";
+        readonly method: "POST";
+        readonly path: "/storage/multipart/list-parts";
+        readonly requestType: "StorageMultipartListPartsRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "Record<string, unknown>";
+    }, {
+        readonly name: "listStorageAuditEvents";
+        readonly method: "POST";
+        readonly path: "/storage/audit/list";
+        readonly requestType: "StorageAuditQueryRequest";
+        readonly responseEnvelope: "athena";
+        readonly responseType: "StorageAuditListResponse";
     }];
 };
 interface S3CatalogItem {
@@ -1783,12 +2261,20 @@ interface PresignedFileUrlResponse {
     storage_key: string;
     purpose: string;
     url: string;
+    headers?: Record<string, string>;
     expires_at: string;
     expires_at_epoch_seconds: number;
     expires_in: number;
     cache_hit: boolean;
     cache_layer: string;
 }
+interface StorageServerSideEncryptionOptions {
+    server_side_encryption?: 'AES256' | 'aws:kms' | 'aws:kms:dsse' | (string & {});
+    sse?: 'AES256' | 'aws:kms' | 'aws:kms:dsse' | (string & {});
+    ssekms_key_id?: string;
+    kms_key_id?: string;
+    bucket_key_enabled?: boolean;
+}
 interface CreateStorageCatalogRequest {
     name: string;
     endpoint: string;
@@ -1818,7 +2304,7 @@ interface UpdateStorageCatalogRequest {
     is_active?: boolean;
     metadata?: Record<string, unknown>;
 }
-interface CreateStorageUploadUrlRequest {
+interface CreateStorageUploadUrlRequest extends StorageServerSideEncryptionOptions {
     s3_id: string;
     bucket?: string;
     storage_key: string;
@@ -1845,15 +2331,42 @@ interface StorageBatchUploadUrlResponse {
 }
 interface ListStorageFilesRequest {
     s3_id: string;
-    prefix: string;
+    prefix?: string;
+    limit?: number;
+    offset?: number;
+    metadata?: Record<string, unknown>;
+    name?: string;
+    resource_id?: string;
+    mime_type?: string;
+    content_type?: string;
+    status?: string;
+    visibility?: 'private' | 'organization' | 'public' | (string & {});
+    bucket?: string;
+    key_prefix?: string;
 }
 interface StorageListFilesResponse {
     files: ManagedFileRecord[];
     count: number;
+    total?: number;
+    limit?: number;
+    offset?: number;
+    next_offset?: number | null;
+    has_more?: boolean;
 }
 interface UpdateStorageFileRequest {
-    storage_key: string;
+    storage_key?: string;
     bucket?: string;
+    name?: string;
+    file_name?: string;
+    original_name?: string;
+    resource_id?: string;
+    mime_type?: string;
+    content_type?: string;
+    size_bytes?: number;
+    checksum_sha256?: string;
+    visibility?: 'private' | 'organization' | 'public' | (string & {});
+    status?: string;
+    metadata?: Record<string, unknown>;
 }
 interface SetStorageFileVisibilityRequest {
     public?: boolean;
@@ -1927,21 +2440,44 @@ interface ConfirmStorageUploadRequest {
 interface SearchStorageFilesRequest {
     query?: string;
     limit?: number;
+    offset?: number;
+    s3_id?: string;
+    prefix?: string;
+    metadata?: Record<string, unknown>;
+    name?: string;
+    resource_id?: string;
+    mime_type?: string;
+    content_type?: string;
+    status?: string;
+    visibility?: 'private' | 'organization' | 'public' | (string & {});
+    bucket?: string;
+    key_prefix?: string;
 }
 interface DeleteManyStorageFilesRequest {
     file_ids: string[];
 }
 interface UpdateManyStorageFilesRequest {
     file_ids: string[];
-    storage_key: string;
+    storage_key?: string;
     bucket?: string;
+    name?: string;
+    file_name?: string;
+    original_name?: string;
+    resource_id?: string;
+    mime_type?: string;
+    content_type?: string;
+    size_bytes?: number;
+    checksum_sha256?: string;
+    visibility?: 'private' | 'organization' | 'public' | (string & {});
+    status?: string;
+    metadata?: Record<string, unknown>;
 }
 interface SetManyStorageFileVisibilityRequest {
     file_ids: string[];
     public?: boolean;
     visibility?: 'private' | 'organization' | 'public';
 }
-interface CopyStorageFileRequest {
+interface CopyStorageFileRequest extends StorageServerSideEncryptionOptions {
     storage_key: string;
     bucket?: string;
     file_name?: string;
@@ -1977,7 +2513,7 @@ interface StoragePermissionCheckRequest {
     file_id: string;
     permission: 'read' | 'write' | 'delete' | 'share' | 'owner';
 }
-interface StorageMultipartCreateRequest {
+interface StorageMultipartCreateRequest extends StorageServerSideEncryptionOptions {
     file_id: string;
     content_type?: string;
 }
@@ -2011,8 +2547,7 @@ interface StorageObjectFolderCreateRequest {
     bucket: string;
     prefix: string;
 }
-interface StorageObjectFolderDeleteRequest extends StorageObjectFolderCreateRequest {
-}
+type StorageObjectFolderDeleteRequest = StorageObjectFolderCreateRequest;
 interface StorageObjectFolderRenameRequest extends Omit<StorageObjectFolderCreateRequest, 'prefix'> {
     from_prefix: string;
     to_prefix: string;
@@ -2027,7 +2562,11 @@ interface StorageObjectBaseRequest {
 interface StorageObjectRequest extends StorageObjectBaseRequest {
     key: string;
 }
-interface StorageObjectCopyRequest extends StorageObjectBaseRequest {
+interface StorageObjectValidateRequest extends StorageObjectRequest {
+    checksum_sha256?: string;
+    etag?: string;
+}
+interface StorageObjectCopyRequest extends StorageObjectBaseRequest, StorageServerSideEncryptionOptions {
     source_key: string;
     destination_key: string;
     destination_bucket?: string;
@@ -2051,11 +2590,29 @@ interface StorageUpdateObjectRequest extends StorageObjectRequest {
     content_language?: string;
     metadata?: Record<string, string>;
 }
-interface StoragePresignUploadRequest extends StorageObjectRequest {
+interface StorageObjectVersionListRequest extends StorageObjectBaseRequest {
+    key?: string;
+    max_keys?: number;
+    key_marker?: string;
+    version_id_marker?: string;
+    delimiter?: string;
+}
+interface StorageObjectVersionMutationRequest extends StorageObjectRequest {
+    version_id: string;
+}
+interface StorageSignedPostPolicyRequest extends StorageObjectRequest, StorageServerSideEncryptionOptions {
     content_type?: string;
+    min_size?: number;
+    max_size?: number;
+    expires_in?: number;
+    public_base_url?: string;
+    force_path_style?: boolean;
+    success_action_status?: string;
 }
-interface StorageBucketCorsRequest extends StorageObjectBaseRequest {
+interface StoragePresignUploadRequest extends StorageObjectRequest, StorageServerSideEncryptionOptions {
+    content_type?: string;
 }
+type StorageBucketCorsRequest = StorageObjectBaseRequest;
 interface StorageBucketCorsRuleInput {
     allowed_origins: string[];
     allowed_methods: string[];
@@ -2066,6 +2623,41 @@ interface StorageBucketCorsRuleInput {
 interface StorageSetBucketCorsRequest extends StorageBucketCorsRequest {
     rules: StorageBucketCorsRuleInput[];
 }
+type StorageBucketLifecycleRequest = StorageObjectBaseRequest;
+interface StorageBucketLifecycleRuleInput {
+    id?: string;
+    prefix?: string;
+    status?: 'Enabled' | 'Disabled' | 'enabled' | 'disabled' | (string & {});
+    expiration_days?: number;
+    expired_object_delete_marker?: boolean;
+    noncurrent_version_expiration_days?: number;
+    abort_incomplete_multipart_upload_days?: number;
+}
+interface StorageSetBucketLifecycleRequest extends StorageBucketLifecycleRequest {
+    rules: StorageBucketLifecycleRuleInput[];
+}
+type StorageBucketPolicyRequest = StorageObjectBaseRequest;
+interface StorageSetBucketPolicyRequest extends StorageBucketPolicyRequest {
+    policy: Record<string, unknown> | string;
+}
+type StoragePublicAccessBlockRequest = StorageObjectBaseRequest;
+interface StorageSetPublicAccessBlockRequest extends StoragePublicAccessBlockRequest {
+    block_public_acls?: boolean;
+    ignore_public_acls?: boolean;
+    block_public_policy?: boolean;
+    restrict_public_buckets?: boolean;
+}
+interface StorageFileVersionPathRequest {
+    file_id: string;
+    version_id: string;
+}
+interface StorageFileRetentionRequest {
+    mode?: 'GOVERNANCE' | 'COMPLIANCE' | (string & {});
+    retain_until?: string;
+    retain_until_date?: string;
+    version_id?: string;
+    bypass_governance?: boolean;
+}
 interface StorageAuditQueryRequest {
     file_id?: string;
     limit?: number;
@@ -2184,7 +2776,7 @@ interface StorageUploadUrlResponseWithPut extends Omit<StorageUploadUrlResponse,
 interface StorageBatchUploadUrlResponseWithPut {
     files: StorageUploadUrlResponseWithPut[];
 }
-interface AthenaStorageFileUploadRequest {
+interface AthenaStorageFileUploadRequest extends StorageServerSideEncryptionOptions {
     s3_id?: string;
     s3Id?: string;
     bucket?: string;
@@ -2227,8 +2819,17 @@ interface AthenaStorageFileNamespace extends AthenaStorageFileModule {
     copy(fileId: string, input: CopyStorageFileRequest, options?: AthenaStorageCallOptions): Promise<StorageFileMutationResponse>;
     url(fileId: string, query?: GetStorageFileUrlQuery, options?: AthenaStorageCallOptions): Promise<PresignedFileUrlResponse>;
     publicUrl(fileId: string, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    proxyUrl(fileId: string, query?: GetStorageFileUrlQuery, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     proxy(fileId: string, query?: GetStorageFileUrlQuery, options?: AthenaStorageBinaryCallOptions): Promise<Response>;
+    versions(fileId: string, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    restoreVersion(fileId: string, versionId: string, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    deleteVersion(fileId: string, versionId: string, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    retention: {
+        get(fileId: string, query?: Pick<StorageFileRetentionRequest, 'version_id'>, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        set(fileId: string, input: StorageFileRetentionRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    };
     visibility: {
+        update(fileId: string, input: SetStorageFileVisibilityRequest, options?: AthenaStorageCallOptions): Promise<StorageFileMutationResponse>;
         set(fileId: string, input: SetStorageFileVisibilityRequest, options?: AthenaStorageCallOptions): Promise<StorageFileMutationResponse>;
         setMany(input: SetManyStorageFileVisibilityRequest, options?: AthenaStorageCallOptions): Promise<StorageFileMutationManyResponse>;
     };
@@ -2270,13 +2871,17 @@ interface AthenaStorageObjectNamespace {
     list(input: StorageListObjectsRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     head(input: StorageObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     exists(input: StorageObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
-    validate(input: StorageObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    validate(input: StorageObjectValidateRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     update(input: StorageUpdateObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     copy(input: StorageObjectCopyRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     url(input: StorageObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     publicUrl(input: StorageObjectPublicUrlRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     delete(input: StorageObjectRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     uploadUrl(input: StoragePresignUploadRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    versions(input: StorageObjectVersionListRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    restoreVersion(input: StorageObjectVersionMutationRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    deleteVersion(input: StorageObjectVersionMutationRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    postPolicy(input: StorageSignedPostPolicyRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     folder: AthenaStorageObjectFolderNamespace;
 }
 interface AthenaStorageBucketCorsNamespace {
@@ -2288,6 +2893,21 @@ interface AthenaStorageBucketNamespace {
     list(input: Omit<StorageObjectBaseRequest, 'bucket'>, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     create(input: StorageObjectBaseRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
     delete(input: StorageObjectBaseRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    lifecycle: {
+        get(input: StorageBucketLifecycleRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        set(input: StorageSetBucketLifecycleRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        delete(input: StorageBucketLifecycleRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    };
+    policy: {
+        get(input: StorageBucketPolicyRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        set(input: StorageSetBucketPolicyRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        delete(input: StorageBucketPolicyRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    };
+    publicAccess: {
+        get(input: StoragePublicAccessBlockRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        set(input: StorageSetPublicAccessBlockRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+        delete(input: StoragePublicAccessBlockRequest, options?: AthenaStorageCallOptions): Promise<Record<string, unknown>>;
+    };
     cors: AthenaStorageBucketCorsNamespace;
 }
 interface AthenaStorageMultipartNamespace {
@@ -2313,6 +2933,7 @@ interface AthenaStorageModule extends AthenaStorageBaseModule {
     delete: AthenaStorageFileModule['delete'];
 }
 declare function createAthenaStorageError(input: AthenaStorageErrorInput): AthenaStorageError;
+declare function createStorageModule(gateway: AthenaGatewayClient, runtimeOptions?: AthenaStorageClientConfig): AthenaStorageModule;
 
 type AthenaRowShape$1 = Record<string, AthenaJsonValue | undefined>;
 type FilterColumnKey$1<Row> = Extract<keyof NonNullable<Row>, string>;
@@ -2421,6 +3042,171 @@ type RelationSelectionResult<TContext, TSelect extends AthenaSelectShape> = {
 };
 type AthenaFindManyResult<Row, TSelect extends AthenaSelectShape, TContext = unknown> = Simplify<ScalarSelectionResult<Row, TSelect> & RelationSelectionResult<TContext, TSelect>>;
 
+type AthenaFindManyAstPayload<Row, TSelect extends AthenaSelectShape> = {
+    table_name: string;
+    select: TSelect;
+    where?: AthenaWhere<Row>;
+    orderBy?: AthenaOrderBy<Row>;
+    limit?: number;
+};
+
+interface AthenaTableBuilderStateAst {
+    conditions: AthenaGatewayCondition[];
+    limit?: number;
+    offset?: number;
+    order?: AthenaSortBy;
+    currentPage?: number;
+    pageSize?: number;
+    totalPages?: number;
+}
+interface AthenaRpcBuilderStateAst {
+    filters: AthenaRpcFilter[];
+    limit?: number;
+    offset?: number;
+    order?: {
+        column: string;
+        ascending?: boolean;
+    };
+}
+interface AthenaDebugAstBase<TKind extends string> {
+    version: 1;
+    kind: TKind;
+}
+type AthenaSelectDebugTransport = {
+    mode: 'compiled-fetch' | 'structured-fetch';
+    endpoint: '/gateway/fetch';
+    payload: AthenaFetchPayload;
+} | {
+    mode: 'typed-query';
+    endpoint: '/gateway/query';
+    payload: {
+        query: string;
+    };
+};
+interface AthenaSelectDebugAst extends AthenaDebugAstBase<'select'> {
+    tableName: string;
+    input: {
+        columns: string | string[];
+        state: AthenaTableBuilderStateAst;
+    };
+    transport: AthenaSelectDebugTransport;
+}
+type AthenaFindManyDebugTransport<Row = Record<string, unknown>, TSelect extends AthenaSelectShape = AthenaSelectShape> = {
+    mode: 'direct-ast-fetch';
+    endpoint: '/gateway/fetch';
+    payload: AthenaFindManyAstPayload<Row, TSelect>;
+} | {
+    mode: 'compiled-fetch' | 'structured-fetch';
+    endpoint: '/gateway/fetch';
+    payload: AthenaFetchPayload;
+} | {
+    mode: 'compiled-query';
+    endpoint: '/gateway/query';
+    payload: {
+        query: string;
+    };
+};
+interface AthenaFindManyDebugAst<Row = Record<string, unknown>, TSelect extends AthenaSelectShape = AthenaSelectShape> extends AthenaDebugAstBase<'findMany'> {
+    tableName: string;
+    input: {
+        select: AthenaValidatedSelectShape<TSelect>;
+        where?: AthenaWhere<Row>;
+        orderBy?: AthenaOrderBy<Row>;
+        limit?: number;
+    };
+    compiled: {
+        columns: string;
+        baseState: AthenaTableBuilderStateAst;
+        executionState: AthenaTableBuilderStateAst;
+    };
+    transport: AthenaFindManyDebugTransport<Row, TSelect>;
+}
+interface AthenaInsertDebugAst extends AthenaDebugAstBase<'insert'> {
+    tableName: string;
+    input: {
+        values: AthenaInsertPayload['insert_body'];
+        returning?: AthenaInsertPayload['columns'];
+        count?: AthenaInsertPayload['count'];
+        head?: boolean;
+        defaultToNull?: boolean;
+    };
+    transport: {
+        mode: 'insert';
+        endpoint: '/gateway/insert';
+        payload: AthenaInsertPayload;
+    };
+}
+interface AthenaUpsertDebugAst extends AthenaDebugAstBase<'upsert'> {
+    tableName: string;
+    input: {
+        values: AthenaInsertPayload['insert_body'];
+        updateBody?: AthenaInsertPayload['update_body'];
+        onConflict?: AthenaInsertPayload['on_conflict'];
+        returning?: AthenaInsertPayload['columns'];
+        count?: AthenaInsertPayload['count'];
+        head?: boolean;
+        defaultToNull?: boolean;
+    };
+    transport: {
+        mode: 'upsert';
+        endpoint: '/gateway/insert';
+        payload: AthenaInsertPayload;
+    };
+}
+interface AthenaUpdateDebugAst extends AthenaDebugAstBase<'update'> {
+    tableName: string;
+    input: {
+        values: AthenaUpdatePayload['set'];
+        state: AthenaTableBuilderStateAst;
+        returning?: AthenaUpdatePayload['columns'];
+    };
+    transport: {
+        mode: 'update';
+        endpoint: '/gateway/update';
+        payload: AthenaUpdatePayload;
+    };
+}
+interface AthenaDeleteDebugAst extends AthenaDebugAstBase<'delete'> {
+    tableName: string;
+    input: {
+        resourceId?: AthenaDeletePayload['resource_id'];
+        state: AthenaTableBuilderStateAst;
+        returning?: AthenaDeletePayload['columns'];
+    };
+    transport: {
+        mode: 'delete';
+        endpoint: '/gateway/delete';
+        payload: AthenaDeletePayload;
+    };
+}
+interface AthenaRpcDebugAst extends AthenaDebugAstBase<'rpc'> {
+    functionName: string;
+    input: {
+        args?: AthenaJsonObject;
+        select?: string | string[];
+        state: AthenaRpcBuilderStateAst;
+    };
+    transport: {
+        mode: 'rpc-post' | 'rpc-get';
+        endpoint: '/gateway/rpc' | `/rpc/${string}`;
+        payload: AthenaRpcPayload;
+    };
+}
+interface AthenaRawQueryDebugAst extends AthenaDebugAstBase<'query'> {
+    input: {
+        query: string;
+    };
+    transport: {
+        mode: 'raw-query';
+        endpoint: '/gateway/query';
+        payload: {
+            query: string;
+        };
+    };
+}
+type AthenaQueryDebugAst = AthenaSelectDebugAst | AthenaFindManyDebugAst | AthenaInsertDebugAst | AthenaUpsertDebugAst | AthenaUpdateDebugAst | AthenaDeleteDebugAst | AthenaRpcDebugAst | AthenaRawQueryDebugAst;
+declare function getAthenaDebugAst(value: unknown): AthenaQueryDebugAst | null;
+
 interface AthenaResult<T> {
     data: T | null;
     error: AthenaResultError | null;
@@ -2471,6 +3257,21 @@ interface AthenaClientExperimentalOptions {
      * Includes payload, synthesized SQL, full outcome, and best-effort callsite metadata.
      */
     traceQueries?: boolean | AthenaQueryTraceOptions;
+    /**
+     * Build and attach a normalized operation AST for runtime debugging.
+     *
+     * When enabled, successful Athena results expose a non-enumerable debug AST
+     * that can be read with `getAthenaDebugAst(...)`. If tracing is also enabled,
+     * the same AST is included on emitted trace events.
+     */
+    debugAst?: boolean;
+    /**
+     * Compile-time opt-in for validating simple `select(...)`, `order(...)`, and
+     * RPC filter column names against known row keys.
+     *
+     * This flag is type-only. It does not change runtime request behavior.
+     */
+    typecheckColumns?: boolean;
     /**
      * Send the original `findMany(...)` AST body for clean object-select reads.
      * This requires gateway support and falls back to legacy compiled transport
@@ -2510,6 +3311,7 @@ interface AthenaQueryTraceEvent {
     functionName?: string;
     sql: string;
     payload: unknown;
+    ast?: AthenaQueryDebugAst;
     options?: AthenaGatewayCallOptions | AthenaRpcCallOptions;
     callsite: AthenaQueryTraceCallsite | null;
     outcome?: {
@@ -2523,14 +3325,16 @@ interface AthenaQueryTraceEvent {
     thrownError?: unknown;
 }
 type MutationSingleResult<Result> = Result extends Array<infer Item> ? Item | null : Result | null;
+type MutationResultRow<Result> = Result extends Array<infer Item> ? Item : Result;
 type AthenaRowShape = Record<string, AthenaJsonValue | undefined>;
 type FilterColumnKey<Row> = Extract<keyof NonNullable<Row>, string>;
 type ResolvedFilterColumnKey<Row> = [FilterColumnKey<Row>] extends [never] ? string : FilterColumnKey<Row>;
-interface MutationQuery<Result> extends PromiseLike<AthenaResult<Result>> {
-    select(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
-    returning(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
-    single(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
-    maybeSingle(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
+type SelectColumnsFor<Row, TStrict extends boolean, TValue extends AthenaSelectInput> = TStrict extends true ? AthenaValidatedSelectInput<Row, TValue> : TValue;
+interface MutationQuery<Result, Row = MutationResultRow<Result>, TStrict extends boolean = false> extends PromiseLike<AthenaResult<Result>> {
+    select<const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
+    returning<const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Result>>;
+    single<const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
+    maybeSingle<const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<MutationSingleResult<Result>>>;
     then<TResult1 = AthenaResult<Result>, TResult2 = never>(onfulfilled?: ((value: AthenaResult<Result>) => TResult1 | PromiseLike<TResult1>) | undefined | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null): Promise<TResult1 | TResult2>;
     catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | undefined | null): Promise<AthenaResult<Result> | TResult>;
     finally(onfinally?: (() => void) | undefined | null): Promise<AthenaResult<Result>>;
@@ -2566,78 +3370,98 @@ interface FilterChain<Self, Row> {
     or(expression: string): Self;
 }
 /** Chain returned by select() - supports filters and single/maybeSingle before execution */
-interface SelectChain<Row, SelectedRow = Row> extends FilterChain<SelectChain<Row, SelectedRow>, Row>, PromiseLike<AthenaResult<SelectedRow[]>> {
-    single<T = SelectedRow>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
-    maybeSingle<T = SelectedRow>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+interface SelectChain<Row, SelectedRow = Row, TStrict extends boolean = false> extends FilterChain<SelectChain<Row, SelectedRow, TStrict>, Row>, PromiseLike<AthenaResult<SelectedRow[]>> {
+    single<T = SelectedRow, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = SelectedRow, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
 }
 /** Chain returned by update() - supports filters before execution, plus select/returning */
-interface UpdateChain<Row> extends FilterChain<UpdateChain<Row>, Row>, MutationQuery<Row[]> {
-}
-interface RpcFilterChain<Self> {
-    eq(column: string, value: AthenaConditionValue): Self;
-    neq(column: string, value: AthenaConditionValue): Self;
-    gt(column: string, value: AthenaConditionValue): Self;
-    gte(column: string, value: AthenaConditionValue): Self;
-    lt(column: string, value: AthenaConditionValue): Self;
-    lte(column: string, value: AthenaConditionValue): Self;
-    like(column: string, value: AthenaConditionValue): Self;
-    ilike(column: string, value: AthenaConditionValue): Self;
-    is(column: string, value: AthenaConditionValue): Self;
-    in(column: string, values: AthenaConditionArrayValue): Self;
+interface UpdateChain<Row, TStrict extends boolean = false> extends FilterChain<UpdateChain<Row, TStrict>, Row>, MutationQuery<Row[], Row, TStrict> {
+}
+interface RpcFilterChain<Self, Row, TStrict extends boolean = false> {
+    eq(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    neq(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    gt(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    gte(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    lt(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    lte(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    like(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    ilike(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    is(column: AthenaTypecheckedColumnKey<Row, TStrict>, value: AthenaConditionValue): Self;
+    in(column: AthenaTypecheckedColumnKey<Row, TStrict>, values: AthenaConditionArrayValue): Self;
 }
 interface RpcOrderOptions {
     ascending?: boolean;
 }
-interface RpcQueryBuilder<Row> extends RpcFilterChain<RpcQueryBuilder<Row>>, PromiseLike<AthenaResult<Row[]>> {
-    select(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<Row[]>>;
-    single<T = Row>(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
-    maybeSingle<T = Row>(columns?: string | string[], options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
-    order(column: string, options?: RpcOrderOptions): RpcQueryBuilder<Row>;
-    limit(count: number): RpcQueryBuilder<Row>;
-    offset(count: number): RpcQueryBuilder<Row>;
-    range(from: number, to: number): RpcQueryBuilder<Row>;
+interface RpcQueryBuilder<Row, TStrict extends boolean = false> extends RpcFilterChain<RpcQueryBuilder<Row, TStrict>, Row, TStrict>, PromiseLike<AthenaResult<Row[]>> {
+    select<const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaRpcCallOptions): Promise<AthenaResult<Row[]>>;
+    single<T = Row, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = Row, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaRpcCallOptions): Promise<AthenaResult<T | null>>;
+    order(column: AthenaTypecheckedColumnKey<Row, TStrict>, options?: RpcOrderOptions): RpcQueryBuilder<Row, TStrict>;
+    limit(count: number): RpcQueryBuilder<Row, TStrict>;
+    offset(count: number): RpcQueryBuilder<Row, TStrict>;
+    range(from: number, to: number): RpcQueryBuilder<Row, TStrict>;
 }
 interface AthenaFromOptions {
     schema?: string;
 }
-interface TableQueryBuilder<Row, Insert = Partial<Row>, Update = Partial<Insert>, TContext = unknown> extends FilterChain<TableQueryBuilder<Row, Insert, Update, TContext>, Row> {
-    select<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): SelectChain<Row, T>;
+interface TableQueryBuilder<Row, Insert = Partial<Row>, Update = Partial<Insert>, TContext = unknown, TStrict extends boolean = false> extends FilterChain<TableQueryBuilder<Row, Insert, Update, TContext, TStrict>, Row> {
+    select<T = Row, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): SelectChain<Row, T, TStrict>;
     findMany<const TSelect extends AthenaSelectShape>(options: AthenaFindManyOptions<Row, TSelect> & {
         select: AthenaValidatedSelectShape<TSelect>;
     }): Promise<AthenaResult<Array<AthenaFindManyResult<Row, TSelect, TContext>>>>;
-    insert(values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row>;
-    insert(values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[]>;
+    insert(values: Insert, options?: AthenaGatewayCallOptions): MutationQuery<Row, Row, TStrict>;
+    insert(values: Insert[], options?: AthenaGatewayCallOptions): MutationQuery<Row[], Row, TStrict>;
     upsert(values: Insert, options?: AthenaGatewayCallOptions & {
         updateBody?: Update;
         onConflict?: string | string[];
-    }): MutationQuery<Row>;
+    }): MutationQuery<Row, Row, TStrict>;
     upsert(values: Insert[], options?: AthenaGatewayCallOptions & {
         updateBody?: Update;
         onConflict?: string | string[];
-    }): MutationQuery<Row[]>;
-    update(values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row>;
+    }): MutationQuery<Row[], Row, TStrict>;
+    update(values: Update, options?: AthenaGatewayCallOptions): UpdateChain<Row, TStrict>;
     delete(options?: AthenaGatewayCallOptions & {
         resourceId?: string;
-    }): MutationQuery<Row | null>;
-    single<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
-    maybeSingle<T = Row>(columns?: string | string[], options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
-    reset(): TableQueryBuilder<Row, Insert, Update, TContext>;
-}
-interface AthenaSdkClient {
-    from<Row = AthenaRowShape, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, options?: AthenaFromOptions): TableQueryBuilder<Row, Insert, Update>;
-    db: AthenaDbModule;
-    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row>;
+    }): MutationQuery<Row | null, Row, TStrict>;
+    single<T = Row, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    maybeSingle<T = Row, const TColumns extends AthenaSelectInput = string>(columns?: SelectColumnsFor<Row, TStrict, TColumns>, options?: AthenaGatewayCallOptions): Promise<AthenaResult<T | null>>;
+    reset(): TableQueryBuilder<Row, Insert, Update, TContext, TStrict>;
+}
+interface AthenaSdkClient<TStrict extends boolean = false> {
+    from<TModel extends AthenaModelTarget>(model: TModel): TableQueryBuilder<RowOf<TModel>, InsertOf<TModel>, UpdateOf<TModel>, unknown, TStrict>;
+    from<Row = AthenaRowShape, Insert = Partial<Row>, Update = Partial<Insert>>(table: string, options?: AthenaFromOptions): TableQueryBuilder<Row, Insert, Update, unknown, TStrict>;
+    db: AthenaDbModule<TStrict>;
+    rpc<Row = unknown, Args extends AthenaJsonObject = AthenaJsonObject>(fn: string, args?: Args, options?: AthenaRpcCallOptions): RpcQueryBuilder<Row, TStrict>;
     query<Row = unknown>(query: string, options?: AthenaGatewayCallOptions): Promise<AthenaResult<Row[]>>;
     verifyConnection(options?: AthenaGatewayConnectionOptions): Promise<AthenaGatewayConnectionResult>;
 }
-interface AthenaSdkClientWithAuth extends AthenaSdkClient {
+interface AthenaSdkClientWithAuth<TStrict extends boolean = false> extends AthenaSdkClient<TStrict> {
     auth: AthenaAuthBindings;
 }
-interface AthenaSdkClientWithStorage extends AthenaSdkClientWithAuth {
+interface AthenaSdkClientWithStorage<TStrict extends boolean = false> extends AthenaSdkClientWithAuth<TStrict> {
     storage: AthenaStorageModule;
 }
-interface AthenaCreateClientOptions extends Pick<AthenaGatewayCallOptions, 'client' | 'headers' | 'backend'> {
-    auth?: AthenaAuthClientConfig;
+interface AthenaCreateClientServiceUrlConfig {
+    url?: string | null | undefined;
+}
+interface AthenaCreateClientAuthOptions extends Omit<AthenaAuthClientConfig, 'baseUrl' | 'apiKey' | 'bearerToken'> {
+    url?: string | null | undefined;
+    baseUrl?: string | null | undefined;
+    apiKey?: string | null | undefined;
+    bearerToken?: string | null | undefined;
+}
+interface AthenaCreateClientOptions {
+    client?: string | null | undefined;
+    headers?: Record<string, string>;
+    backend?: BackendConfig | BackendType;
+    db?: AthenaCreateClientServiceUrlConfig;
+    gateway?: AthenaCreateClientServiceUrlConfig;
+    auth?: AthenaCreateClientAuthOptions;
+    storage?: AthenaCreateClientServiceUrlConfig;
+    dbUrl?: string | null | undefined;
+    gatewayUrl?: string | null | undefined;
+    authUrl?: string | null | undefined;
+    storageUrl?: string | null | undefined;
     experimental?: AthenaClientExperimentalOptions;
 }
 interface AthenaCreateClientOptionsWithStorage extends AthenaCreateClientOptions {
@@ -2645,40 +3469,82 @@ interface AthenaCreateClientOptionsWithStorage extends AthenaCreateClientOptions
         athenaStorageBackend: true;
     };
 }
-interface AthenaClientBuilder<StorageEnabled extends boolean = false> {
-    /** Set the gateway base URL. */
-    url(url: string): AthenaClientBuilder<StorageEnabled>;
+interface AthenaCreateClientOptionsWithTypecheckedColumns extends AthenaCreateClientOptions {
+    experimental: AthenaClientExperimentalOptions & {
+        typecheckColumns: true;
+    };
+}
+interface AthenaCreateClientOptionsWithStorageAndTypecheckedColumns extends AthenaCreateClientOptions {
+    experimental: AthenaClientExperimentalOptions & {
+        athenaStorageBackend: true;
+        typecheckColumns: true;
+    };
+}
+interface AthenaCreateClientConfig extends AthenaCreateClientOptions {
+    url?: string | null | undefined;
+    key: string | null | undefined;
+}
+interface AthenaCreateClientConfigWithStorage extends AthenaCreateClientOptionsWithStorage {
+    url?: string | null | undefined;
+    key: string | null | undefined;
+}
+interface AthenaCreateClientConfigWithTypecheckedColumns extends AthenaCreateClientOptionsWithTypecheckedColumns {
+    url?: string | null | undefined;
+    key: string | null | undefined;
+}
+interface AthenaCreateClientConfigWithStorageAndTypecheckedColumns extends AthenaCreateClientOptionsWithStorageAndTypecheckedColumns {
+    url?: string | null | undefined;
+    key: string | null | undefined;
+}
+interface AthenaClientBuilder<StorageEnabled extends boolean = false, TStrict extends boolean = false> {
+    /** Set the public Athena base URL. */
+    url(url: string | null | undefined): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Set the API key used for all requests. */
-    key(apiKey: string): AthenaClientBuilder<StorageEnabled>;
+    key(apiKey: string | null | undefined): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Set the default backend routing strategy. */
-    backend(backend: BackendConfig | BackendType): AthenaClientBuilder<StorageEnabled>;
+    backend(backend: BackendConfig | BackendType): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Set the default Athena client routing key. */
-    client(clientName: string): AthenaClientBuilder<StorageEnabled>;
+    client(clientName: string | null | undefined): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Attach static headers to every request. */
-    headers(headers: Record<string, string>): AthenaClientBuilder<StorageEnabled>;
+    headers(headers: Record<string, string>): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Configure Athena Auth client behavior for `client.auth.*` methods. */
-    auth(config: AthenaAuthClientConfig): AthenaClientBuilder<StorageEnabled>;
-    /** Configure experimental client options and narrow the built client when storage is enabled. */
+    auth(config: AthenaCreateClientAuthOptions): AthenaClientBuilder<StorageEnabled, TStrict>;
+    /** Configure experimental client options and narrow the built client when storage or strict column checks are enabled. */
     experimental(options: AthenaClientExperimentalOptions & {
         athenaStorageBackend: true;
-    }): AthenaClientBuilder<true>;
-    experimental(options: AthenaClientExperimentalOptions): AthenaClientBuilder<StorageEnabled>;
+        typecheckColumns: true;
+    }): AthenaClientBuilder<true, true>;
+    experimental(options: AthenaClientExperimentalOptions & {
+        athenaStorageBackend: true;
+    }): AthenaClientBuilder<true, TStrict>;
+    experimental(options: AthenaClientExperimentalOptions & {
+        typecheckColumns: true;
+    }): AthenaClientBuilder<StorageEnabled, true>;
+    experimental(options: AthenaClientExperimentalOptions): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Apply createClient options and narrow the built client when storage is enabled. */
-    options(options: AthenaCreateClientOptionsWithStorage): AthenaClientBuilder<true>;
-    options(options: AthenaCreateClientOptions): AthenaClientBuilder<StorageEnabled>;
+    options(options: AthenaCreateClientOptionsWithStorageAndTypecheckedColumns): AthenaClientBuilder<true, true>;
+    options(options: AthenaCreateClientOptionsWithStorage): AthenaClientBuilder<true, TStrict>;
+    options(options: AthenaCreateClientOptionsWithTypecheckedColumns): AthenaClientBuilder<StorageEnabled, true>;
+    options(options: AthenaCreateClientOptions): AthenaClientBuilder<StorageEnabled, TStrict>;
     /** Build the immutable Athena SDK client. */
-    build(): StorageEnabled extends true ? AthenaSdkClientWithStorage : AthenaSdkClientWithAuth;
+    build(): StorageEnabled extends true ? AthenaSdkClientWithStorage<TStrict> : AthenaSdkClientWithAuth<TStrict>;
 }
 /** Canonical Athena client factory with builder-based configuration. */
 declare class AthenaClient {
     /** Create a fluent builder for a strongly-typed Athena SDK client. */
-    static builder(): AthenaClientBuilder<false>;
+    static builder(): AthenaClientBuilder<false, false>;
     /** Build a client from process environment variables. */
-    static fromEnvironment(): AthenaSdkClientWithAuth;
+    static fromEnvironment(): AthenaSdkClientWithAuth<false>;
 }
 /** Create client (convenience wrapper; use AthenaClient.builder() for full control) */
-declare function createClient(url: string, apiKey: string, options: AthenaCreateClientOptionsWithStorage): AthenaSdkClientWithStorage;
-declare function createClient(url: string, apiKey: string, options?: AthenaCreateClientOptions): AthenaSdkClientWithAuth;
+declare function createClient(config: AthenaCreateClientConfigWithStorageAndTypecheckedColumns): AthenaSdkClientWithStorage<true>;
+declare function createClient(config: AthenaCreateClientConfigWithStorage): AthenaSdkClientWithStorage<false>;
+declare function createClient(config: AthenaCreateClientConfigWithTypecheckedColumns): AthenaSdkClientWithAuth<true>;
+declare function createClient(config: AthenaCreateClientConfig): AthenaSdkClientWithAuth<false>;
+declare function createClient(url: string | null | undefined, apiKey: string | null | undefined, options: AthenaCreateClientOptionsWithStorageAndTypecheckedColumns): AthenaSdkClientWithStorage<true>;
+declare function createClient(url: string | null | undefined, apiKey: string | null | undefined, options: AthenaCreateClientOptionsWithStorage): AthenaSdkClientWithStorage<false>;
+declare function createClient(url: string | null | undefined, apiKey: string | null | undefined, options: AthenaCreateClientOptionsWithTypecheckedColumns): AthenaSdkClientWithAuth<true>;
+declare function createClient(url: string | null | undefined, apiKey: string | null | undefined, options?: AthenaCreateClientOptions): AthenaSdkClientWithAuth<false>;
 
 interface AthenaGatewayErrorInput {
     code: AthenaGatewayErrorCode;
@@ -2722,6 +3588,10 @@ type MapNullableToFormValue<TField, TMode extends ModelFormNullishMode> = null e
 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.
  */
@@ -2769,4 +3639,4 @@ interface ModelFormAdapter<TModel extends AnyModelDef> {
  */
 declare function createModelFormAdapter<TModel extends AnyModelDef>(model: TModel): ModelFormAdapter<TModel>;
 
-export { type AthenaClientExperimentalOptions as $, type AthenaAdminListUsersFilterOperator as A, type AthenaAuthQueryValue as B, type AthenaAuthReactEmailComponent as C, type AthenaAuthReactEmailConfig as D, type AthenaAuthReactEmailEventPhase as E, type AthenaAuthReactEmailProps as F, type AthenaAuthReactEmailRenderEvent as G, type AthenaAuthReactEmailRenderInput as H, type AthenaAuthReactEmailRenderOptions as I, type AthenaAuthRequestInput as J, type AthenaAuthResetPasswordBinding as K, type AthenaAuthResult as L, type AthenaAuthRevokeSessionRequest as M, type AthenaAuthSdkClient as N, type AthenaAuthSearchOperator as O, type AthenaAuthSession as P, type AthenaAuthSessionResponse as Q, type AthenaAuthSessionRevokeBinding as R, type AthenaAuthSignInResponse as S, type AthenaAuthSignOutResponse as T, type AthenaAuthSocialRedirectResponse as U, type AthenaAuthStatusResponse as V, type AthenaAuthUser as W, type AthenaChangeEmailRequest as X, type AthenaChangePasswordRequest as Y, AthenaClient as Z, type AthenaClientBuilder as _, type AthenaAdminListUsersQuery as a, type AthenaUnlinkAccountRequest as a$, type AthenaCreateClientOptions as a0, type AthenaCreateClientOptionsWithStorage as a1, type AthenaDbModule as a2, type AthenaDeleteUserCallbackRequest as a3, type AthenaDeleteUserRequest as a4, type AthenaDeleteUserResponse as a5, type AthenaEmailSignInRequest as a6, type AthenaEmailSignUpRequest as a7, type AthenaEnvelope as a8, AthenaError as a9, type AthenaSocialSignInRequest as aA, type AthenaStorageBinaryCallOptions as aB, type AthenaStorageCallOptions as aC, type AthenaStorageClientConfig as aD, type AthenaStorageEnv as aE, AthenaStorageError as aF, AthenaStorageErrorCode as aG, type AthenaStorageErrorDetails as aH, type AthenaStorageErrorHandler as aI, type AthenaStorageErrorInput as aJ, type AthenaStorageFileConfig as aK, type AthenaStorageFileDeleteInput as aL, type AthenaStorageFileDownloadInput as aM, type AthenaStorageFileListInput as aN, type AthenaStorageFileModule as aO, type AthenaStorageFileUploadInput as aP, type AthenaStorageFileUploadResult as aQ, type AthenaStorageModule as aR, type AthenaStoragePathContext as aS, type AthenaStoragePrefixPath as aT, type AthenaStorageTemplateValue as aU, type AthenaStorageTemplateVars as aV, type AthenaStorageUploadConstraints as aW, type AthenaStorageUploadProgress as aX, type AthenaStorageUploadProgressHandler as aY, type AthenaStorageUploadSource as aZ, type AthenaStorageUploadedFile as a_, AthenaErrorCategory as aa, AthenaErrorCode as ab, type AthenaErrorInput as ac, AthenaErrorKind as ad, type AthenaFindManyOptions as ae, type AthenaFindManyResult as af, type AthenaForgetPasswordRequest as ag, type AthenaFromOptions as ah, AthenaGatewayError as ai, type AthenaLinkSocialRequest as aj, type AthenaOAuthAccountTokenRequest as ak, type AthenaOAuthTokenBundle as al, type AthenaOperationContext as am, type AthenaOrderBy as an, type AthenaQueryTraceCallsite as ao, type AthenaQueryTraceEvent as ap, type AthenaQueryTraceOptions as aq, type AthenaRelationSelectNode as ar, type AthenaResetPasswordRequest as as, type AthenaResult as at, type AthenaResultError as au, type AthenaSdkClient as av, type AthenaSdkClientWithAuth as aw, type AthenaSdkClientWithStorage as ax, type AthenaSelectShape as ay, type AthenaSendVerificationEmailRequest as az, type AthenaAdminListUsersSearchOperator as b, type AthenaUpdateUserRequest as b0, type AthenaUsernameSignInRequest as b1, type AthenaVerifyEmailRequest as b2, type AthenaWhere as b3, type AthenaWhereBooleanOperand as b4, type AthenaWhereOperatorInput as b5, type CreateStorageCatalogRequest as b6, type CreateStorageUploadUrlRequest as b7, type CreateStorageUploadUrlsRequest as b8, type DeleteStorageFolderRequest as b9, type ToModelFormDefaultsOptions as bA, type ToModelPayloadOptions as bB, type UnwrapOneOptions as bC, type UnwrapOptions as bD, type UpdateStorageCatalogRequest as bE, type UpdateStorageFileRequest as bF, assertInt as bG, coerceInt as bH, createAthenaStorageError as bI, createClient as bJ, createModelFormAdapter as bK, isAthenaGatewayError as bL, isOk as bM, normalizeAthenaError as bN, parseBooleanFlag as bO, requireAffected as bP, requireSuccess as bQ, storageSdkManifest as bR, toModelFormDefaults as bS, toModelPayload as bT, unwrap as bU, unwrapOne as bV, unwrapRows as bW, withRetry as bX, type AthenaAuthFetchCompatibleInput as bY, type GetStorageFileUrlQuery as ba, type IntCoercionOptions as bb, type ListStorageFilesRequest as bc, type ManagedFileRecord as bd, type ModelFormAdapter as be, type ModelFormDefaults as bf, type ModelFormNullishMode as bg, type ModelFormValues as bh, type MoveStorageFolderRequest as bi, type NormalizedAthenaError as bj, type PresignedFileUrlResponse as bk, type RequireAffectedOptions as bl, type RetryBackoffStrategy as bm, type RetryConfig as bn, type RpcOrderOptions as bo, type RpcQueryBuilder as bp, type S3CatalogItem as bq, type S3CredentialListItem as br, type SetStorageFileVisibilityRequest as bs, type StorageBatchUploadUrlResponse as bt, type StorageFileAccessPurpose as bu, type StorageFileMutationResponse as bv, type StorageFolderMutationResponse as bw, type StorageListFilesResponse as bx, type StorageUploadUrlResponse as by, type TableQueryBuilder as bz, type AthenaAuthAdminUserSessionRevokeBinding as c, type AthenaAuthBindings as d, type AthenaAuthCallOptions as e, type AthenaAuthClientConfig as f, type AthenaAuthCredentials as g, type AthenaAuthEmailChangeResponse as h, type AthenaAuthEmailTemplateBuilder as i, type AthenaAuthEmailTemplateCreateFromDefinitionInput as j, type AthenaAuthEmailTemplateDefinition as k, type AthenaAuthEmailTemplateReactOverrides as l, type AthenaAuthEmailTemplateUpdateFromDefinitionInput as m, type AthenaAuthEndpointPath as n, type AthenaAuthErrorCode as o, type AthenaAuthErrorDetails as p, type AthenaAuthFilterOperator as q, type AthenaAuthGenericInput as r, type AthenaAuthGenericQueryInput as s, type AthenaAuthLinkedAccount as t, type AthenaAuthMethod as u, type AthenaAuthOrganization as v, type AthenaAuthOrganizationBindings as w, type AthenaAuthOrganizationInvitation as x, type AthenaAuthOrganizationMember as y, type AthenaAuthQueryPrimitive as z };
+export { type AthenaClientExperimentalOptions as $, type AthenaAdminListUsersFilterOperator as A, type AthenaAuthQueryValue as B, type AthenaAuthReactEmailComponent as C, type AthenaAuthReactEmailConfig as D, type AthenaAuthReactEmailEventPhase as E, type AthenaAuthReactEmailProps as F, type AthenaAuthReactEmailRenderEvent as G, type AthenaAuthReactEmailRenderInput as H, type AthenaAuthReactEmailRenderOptions as I, type AthenaAuthRequestInput as J, type AthenaAuthResetPasswordBinding as K, type AthenaAuthResult as L, type AthenaAuthRevokeSessionRequest as M, type AthenaAuthSdkClient as N, type AthenaAuthSearchOperator as O, type AthenaAuthSession as P, type AthenaAuthSessionResponse as Q, type AthenaAuthSessionRevokeBinding as R, type AthenaAuthSignInResponse as S, type AthenaAuthSignOutResponse as T, type AthenaAuthSocialRedirectResponse as U, type AthenaAuthStatusResponse as V, type AthenaAuthUser as W, type AthenaChangeEmailRequest as X, type AthenaChangePasswordRequest as Y, AthenaClient as Z, type AthenaClientBuilder as _, type AthenaAdminListUsersQuery as a, type AthenaStorageEnv as a$, type AthenaCreateClientAuthOptions as a0, type AthenaCreateClientConfig as a1, type AthenaCreateClientConfigWithStorage as a2, type AthenaCreateClientConfigWithStorageAndTypecheckedColumns as a3, type AthenaCreateClientConfigWithTypecheckedColumns as a4, type AthenaCreateClientOptions as a5, type AthenaCreateClientOptionsWithStorage as a6, type AthenaCreateClientOptionsWithStorageAndTypecheckedColumns as a7, type AthenaCreateClientOptionsWithTypecheckedColumns as a8, type AthenaCreateClientServiceUrlConfig as a9, type AthenaQueryTraceCallsite as aA, type AthenaQueryTraceEvent as aB, type AthenaQueryTraceOptions as aC, type AthenaRawQueryDebugAst as aD, type AthenaRelationSelectNode as aE, type AthenaResetPasswordRequest as aF, type AthenaResult as aG, type AthenaResultError as aH, type AthenaRpcBuilderStateAst as aI, type AthenaRpcDebugAst as aJ, type AthenaSdkClient as aK, type AthenaSdkClientWithAuth as aL, type AthenaSdkClientWithStorage as aM, type AthenaSelectDebugAst as aN, type AthenaSelectDebugTransport as aO, type AthenaSelectShape as aP, type AthenaSendVerificationEmailRequest as aQ, type AthenaSocialSignInRequest as aR, type AthenaStorageAuditNamespace as aS, type AthenaStorageBaseModule as aT, type AthenaStorageBinaryCallOptions as aU, type AthenaStorageBucketCorsNamespace as aV, type AthenaStorageBucketNamespace as aW, type AthenaStorageCallOptions as aX, type AthenaStorageCatalogNamespace as aY, type AthenaStorageClientConfig as aZ, type AthenaStorageCredentialsNamespace as a_, type AthenaDbModule as aa, type AthenaDeleteDebugAst as ab, type AthenaDeleteUserCallbackRequest as ac, type AthenaDeleteUserRequest as ad, type AthenaDeleteUserResponse as ae, type AthenaEmailSignInRequest as af, type AthenaEmailSignUpRequest as ag, type AthenaEnvelope as ah, AthenaError as ai, AthenaErrorCategory as aj, AthenaErrorCode as ak, type AthenaErrorInput as al, AthenaErrorKind as am, type AthenaFindManyDebugAst as an, type AthenaFindManyOptions as ao, type AthenaFindManyResult as ap, type AthenaForgetPasswordRequest as aq, type AthenaFromOptions as ar, AthenaGatewayError as as, type AthenaInsertDebugAst as at, type AthenaLinkSocialRequest as au, type AthenaOAuthAccountTokenRequest as av, type AthenaOAuthTokenBundle as aw, type AthenaOperationContext as ax, type AthenaOrderBy as ay, type AthenaQueryDebugAst as az, type AthenaAdminListUsersSearchOperator as b, type RequireAffectedOptions as b$, AthenaStorageError as b0, AthenaStorageErrorCode as b1, type AthenaStorageErrorDetails as b2, type AthenaStorageErrorHandler as b3, type AthenaStorageErrorInput as b4, type AthenaStorageFileConfig as b5, type AthenaStorageFileDeleteInput as b6, type AthenaStorageFileDownloadInput as b7, type AthenaStorageFileListInput as b8, type AthenaStorageFileModule as b9, type AthenaUpdateUserRequest as bA, type AthenaUpsertDebugAst as bB, type AthenaUsernameSignInRequest as bC, type AthenaVerifyEmailRequest as bD, type AthenaWhere as bE, type AthenaWhereBooleanOperand as bF, type AthenaWhereOperatorInput as bG, type ConfirmStorageUploadRequest as bH, type CopyStorageFileRequest as bI, type CreateStorageCatalogRequest as bJ, type CreateStorageUploadUrlRequest as bK, type CreateStorageUploadUrlsRequest as bL, type DeleteManyStorageFilesRequest as bM, type DeleteStorageFolderRequest as bN, type FormValuesOf as bO, type GetStorageFileUrlQuery as bP, type IntCoercionOptions as bQ, type ListStorageFilesRequest as bR, type ListStorageFoldersRequest as bS, type ManagedFileRecord as bT, type ModelFormAdapter as bU, type ModelFormDefaults as bV, type ModelFormNullishMode as bW, type ModelFormValues as bX, type MoveStorageFolderRequest as bY, type NormalizedAthenaError as bZ, type PresignedFileUrlResponse as b_, type AthenaStorageFileNamespace as ba, type AthenaStorageFileUploadInput as bb, type AthenaStorageFileUploadManyRequest as bc, type AthenaStorageFileUploadRequest as bd, type AthenaStorageFileUploadResult as be, type AthenaStorageFolderNamespace as bf, type AthenaStorageManagedUpload as bg, type AthenaStorageModule as bh, type AthenaStorageMultipartNamespace as bi, type AthenaStorageObjectFolderNamespace as bj, type AthenaStorageObjectNamespace as bk, type AthenaStoragePathContext as bl, type AthenaStoragePermissionNamespace as bm, type AthenaStoragePrefixPath as bn, type AthenaStoragePutBody as bo, type AthenaStoragePutOptions as bp, type AthenaStorageTemplateValue as bq, type AthenaStorageTemplateVars as br, type AthenaStorageUploadConstraints as bs, type AthenaStorageUploadProgress as bt, type AthenaStorageUploadProgressHandler as bu, type AthenaStorageUploadSource as bv, type AthenaStorageUploadedFile as bw, type AthenaTableBuilderStateAst as bx, type AthenaUnlinkAccountRequest as by, type AthenaUpdateDebugAst as bz, type AthenaAuthAdminUserSessionRevokeBinding as c, type ToModelPayloadOptions as c$, type RetryBackoffStrategy as c0, type RetryConfig as c1, type RpcOrderOptions as c2, type RpcQueryBuilder as c3, type S3CatalogItem as c4, type S3CredentialListItem as c5, type SearchStorageFilesRequest as c6, type SetManyStorageFileVisibilityRequest as c7, type SetStorageFileVisibilityRequest as c8, type StorageAuditEventRecord as c9, type StorageObjectFolderCreateRequest as cA, type StorageObjectFolderDeleteRequest as cB, type StorageObjectFolderRenameRequest as cC, type StorageObjectPublicUrlRequest as cD, type StorageObjectRequest as cE, type StorageObjectValidateRequest as cF, type StorageObjectVersionListRequest as cG, type StorageObjectVersionMutationRequest as cH, type StoragePermissionCheckRequest as cI, type StoragePermissionCheckResponse as cJ, type StoragePermissionGrantRequest as cK, type StoragePermissionListRequest as cL, type StoragePermissionListResponse as cM, type StoragePermissionRevokeRequest as cN, type StoragePresignUploadRequest as cO, type StoragePublicAccessBlockRequest as cP, type StorageServerSideEncryptionOptions as cQ, type StorageSetBucketCorsRequest as cR, type StorageSetBucketLifecycleRequest as cS, type StorageSetBucketPolicyRequest as cT, type StorageSetPublicAccessBlockRequest as cU, type StorageSignedPostPolicyRequest as cV, type StorageUpdateObjectRequest as cW, type StorageUploadUrlResponse as cX, type StorageUploadUrlResponseWithPut as cY, type TableQueryBuilder as cZ, type ToModelFormDefaultsOptions as c_, type StorageAuditListResponse as ca, type StorageAuditQueryRequest as cb, type StorageBatchUploadUrlResponse as cc, type StorageBatchUploadUrlResponseWithPut as cd, type StorageBucketCorsRequest as ce, type StorageBucketCorsRuleInput as cf, type StorageBucketLifecycleRequest as cg, type StorageBucketLifecycleRuleInput as ch, type StorageBucketPolicyRequest as ci, type StorageFileAccessPurpose as cj, type StorageFileMutationManyResponse as ck, type StorageFileMutationResponse as cl, type StorageFilePermissionRecord as cm, type StorageFileRetentionRequest as cn, type StorageFileVersionPathRequest as co, type StorageFolderMutationResponse as cp, type StorageListFilesResponse as cq, type StorageListObjectsRequest as cr, type StorageMultipartAbortRequest as cs, type StorageMultipartCompletePartInput as ct, type StorageMultipartCompleteRequest as cu, type StorageMultipartCreateRequest as cv, type StorageMultipartListPartsRequest as cw, type StorageMultipartSignPartRequest as cx, type StorageObjectBaseRequest as cy, type StorageObjectCopyRequest as cz, type AthenaAuthBindings as d, type TreeStorageFoldersRequest as d0, type UnwrapOneOptions as d1, type UnwrapOptions as d2, type UpdateManyStorageFilesRequest as d3, type UpdateStorageCatalogRequest as d4, type UpdateStorageFileRequest as d5, assertInt as d6, coerceInt as d7, createAthenaStorageError as d8, createClient as d9, createModelFormAdapter as da, createStorageModule as db, getAthenaDebugAst as dc, isAthenaGatewayError as dd, isOk as de, normalizeAthenaError as df, parseBooleanFlag as dg, requireAffected as dh, requireSuccess as di, storageSdkManifest as dj, toModelFormDefaults as dk, toModelPayload as dl, unwrap as dm, unwrapOne as dn, unwrapRows as dp, verifyAthenaGatewayUrl as dq, withRetry as dr, type AthenaAuthFetchCompatibleInput as ds, type AthenaAuthCallOptions as e, type AthenaAuthClientConfig as f, type AthenaAuthCredentials as g, type AthenaAuthEmailChangeResponse as h, type AthenaAuthEmailTemplateBuilder as i, type AthenaAuthEmailTemplateCreateFromDefinitionInput as j, type AthenaAuthEmailTemplateDefinition as k, type AthenaAuthEmailTemplateReactOverrides as l, type AthenaAuthEmailTemplateUpdateFromDefinitionInput as m, type AthenaAuthEndpointPath as n, type AthenaAuthErrorCode as o, type AthenaAuthErrorDetails as p, type AthenaAuthFilterOperator as q, type AthenaAuthGenericInput as r, type AthenaAuthGenericQueryInput as s, type AthenaAuthLinkedAccount as t, type AthenaAuthMethod as u, type AthenaAuthOrganization as v, type AthenaAuthOrganizationBindings as w, type AthenaAuthOrganizationInvitation as x, type AthenaAuthOrganizationMember as y, type AthenaAuthQueryPrimitive as z };