@xylex-group/athena 3.0.3 → 3.3.0

package/dist/{v3-client-CWfZHcKL.d.cts → v3-client-G1SLeHRa.d.cts}

@@ -1,4 +1,4 @@
-import { F as AthenaAuthClientConfig, D as AthenaAuthBindings } from './types-AOY-GLu8.cjs';
+import { F as AthenaAuthClientConfig, D as AthenaAuthBindings } from './types-BVKpQmfY.cjs';
 import { e as AthenaGatewayErrorDetails, a as AthenaGatewayCallOptions, b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, x as AthenaFetchPayload, s as AthenaGatewayResponse, y as AthenaInsertPayload, z as AthenaUpdatePayload, w as AthenaDeletePayload, n as AthenaRpcPayload, j as AthenaRpcCallOptions, C as AthenaQueryPayload, i as AthenaJsonValue, g as AthenaJsonObject, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, D as AthenaGatewayBaseOptions, E as AthenaConditionValue, F as AthenaConditionArrayValue, G as AthenaGatewayCondition, H as AthenaSortBy, k as AthenaRpcFilter, A as AthenaConditionCastType, I as AthenaConditionOperator, o as BackendConfig, p as BackendType } from './types-Bltx6iL6.cjs';
 import { A as AthenaModelTarget, n as RowOf, a as InsertOf, U as UpdateOf, u as AthenaClientTableName, t as AthenaClientModelForTableName, R as RegistryDef, D as DatabaseDef, o as SchemaDef, s as AnyModelDef, j as ModelDef, m as ModelRelationMetadata, r as AthenaClientModelsInput } from './types-CgCv5o6R.cjs';
 import { a as AthenaBillingClientConfig, c as AthenaBillingModule } from './module-C_ab-MM1.cjs';
@@ -2663,6 +2663,12 @@ type AthenaQueryDebugAst = AthenaSelectDebugAst | AthenaFindManyDebugAst | Athen
 declare function getAthenaDebugAst(value: unknown): AthenaQueryDebugAst | null;
 
 interface AthenaQueryTraceOptions {
+    /**
+     * When false, tracing is off even if diagnostics mode would enable it.
+     * When true, tracing stays on even in quiet (`diagnostics: 'auto'`) environments.
+     * When omitted, quiet environments disable object-form trace options.
+     */
+    enabled?: boolean;
     /**
      * Custom sink for trace events. Defaults to console.info.
      */
@@ -2808,6 +2814,15 @@ interface TableQueryBuilder<Row, Insert = Partial<Row>, Update = Partial<Insert>
     reset(): TableQueryBuilder<Row, Insert, Update, TContext>;
 }
 
+/**
+ * Resolve query diagnostics flags for {@link createClient}.
+ *
+ * Prefer `diagnostics: 'auto'` in Next/OpenNext apps so production builds stay
+ * quiet without app-local OPENNEXT_BUILD branching.
+ */
+
+type AthenaDiagnosticsMode = boolean | 'auto';
+
 type MaybePromise<T> = T | Promise<T>;
 type ResolvedModels<TModels> = TModels extends AthenaClientModelsInput ? TModels : never;
 
@@ -2842,6 +2857,7 @@ interface AthenaBillingConfig extends Omit<AthenaBillingClientConfig, 'baseUrl'
     /** Optional override; defaults to the unified/root or db Athena URL. */
     url?: string | null;
 }
+
 interface AthenaClientConfig<TModels extends AthenaClientModelsInput | undefined = undefined> {
     url?: string | null;
     key?: string | null;
@@ -2857,6 +2873,12 @@ interface AthenaClientConfig<TModels extends AthenaClientModelsInput | undefined
     storage?: AthenaStorageConfig;
     billing?: AthenaBillingConfig;
     retryReads?: boolean;
+    /**
+     * Query diagnostics mode. Prefer `'auto'` in Next/OpenNext apps so production
+     * builds stay quiet without app-local OPENNEXT_BUILD branching.
+     * Per-flag `debugAst` / `findManyAst` / `traceQueries` always win when set.
+     */
+    diagnostics?: AthenaDiagnosticsMode;
     traceQueries?: boolean | AthenaQueryTraceOptions;
     debugAst?: boolean;
     findManyAst?: boolean;

package/dist/{v3-client-DZp2NEhK.d.ts → v3-client-ao8BWQ8v.d.ts}

@@ -1,4 +1,4 @@
-import { F as AthenaAuthClientConfig, D as AthenaAuthBindings } from './types-AOY-GLu8.js';
+import { F as AthenaAuthClientConfig, D as AthenaAuthBindings } from './types-BVKpQmfY.js';
 import { e as AthenaGatewayErrorDetails, a as AthenaGatewayCallOptions, b as AthenaGatewayConnectionOptions, c as AthenaGatewayConnectionResult, x as AthenaFetchPayload, s as AthenaGatewayResponse, y as AthenaInsertPayload, z as AthenaUpdatePayload, w as AthenaDeletePayload, n as AthenaRpcPayload, j as AthenaRpcCallOptions, C as AthenaQueryPayload, i as AthenaJsonValue, g as AthenaJsonObject, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, D as AthenaGatewayBaseOptions, E as AthenaConditionValue, F as AthenaConditionArrayValue, G as AthenaGatewayCondition, H as AthenaSortBy, k as AthenaRpcFilter, A as AthenaConditionCastType, I as AthenaConditionOperator, o as BackendConfig, p as BackendType } from './types-Bltx6iL6.js';
 import { A as AthenaModelTarget, n as RowOf, a as InsertOf, U as UpdateOf, u as AthenaClientTableName, t as AthenaClientModelForTableName, R as RegistryDef, D as DatabaseDef, o as SchemaDef, s as AnyModelDef, j as ModelDef, m as ModelRelationMetadata, r as AthenaClientModelsInput } from './types-B75PdABb.js';
 import { a as AthenaBillingClientConfig, c as AthenaBillingModule } from './module-C_ab-MM1.js';
@@ -2663,6 +2663,12 @@ type AthenaQueryDebugAst = AthenaSelectDebugAst | AthenaFindManyDebugAst | Athen
 declare function getAthenaDebugAst(value: unknown): AthenaQueryDebugAst | null;
 
 interface AthenaQueryTraceOptions {
+    /**
+     * When false, tracing is off even if diagnostics mode would enable it.
+     * When true, tracing stays on even in quiet (`diagnostics: 'auto'`) environments.
+     * When omitted, quiet environments disable object-form trace options.
+     */
+    enabled?: boolean;
     /**
      * Custom sink for trace events. Defaults to console.info.
      */
@@ -2808,6 +2814,15 @@ interface TableQueryBuilder<Row, Insert = Partial<Row>, Update = Partial<Insert>
     reset(): TableQueryBuilder<Row, Insert, Update, TContext>;
 }
 
+/**
+ * Resolve query diagnostics flags for {@link createClient}.
+ *
+ * Prefer `diagnostics: 'auto'` in Next/OpenNext apps so production builds stay
+ * quiet without app-local OPENNEXT_BUILD branching.
+ */
+
+type AthenaDiagnosticsMode = boolean | 'auto';
+
 type MaybePromise<T> = T | Promise<T>;
 type ResolvedModels<TModels> = TModels extends AthenaClientModelsInput ? TModels : never;
 
@@ -2842,6 +2857,7 @@ interface AthenaBillingConfig extends Omit<AthenaBillingClientConfig, 'baseUrl'
     /** Optional override; defaults to the unified/root or db Athena URL. */
     url?: string | null;
 }
+
 interface AthenaClientConfig<TModels extends AthenaClientModelsInput | undefined = undefined> {
     url?: string | null;
     key?: string | null;
@@ -2857,6 +2873,12 @@ interface AthenaClientConfig<TModels extends AthenaClientModelsInput | undefined
     storage?: AthenaStorageConfig;
     billing?: AthenaBillingConfig;
     retryReads?: boolean;
+    /**
+     * Query diagnostics mode. Prefer `'auto'` in Next/OpenNext apps so production
+     * builds stay quiet without app-local OPENNEXT_BUILD branching.
+     * Per-flag `debugAst` / `findManyAst` / `traceQueries` always win when set.
+     */
+    diagnostics?: AthenaDiagnosticsMode;
     traceQueries?: boolean | AthenaQueryTraceOptions;
     debugAst?: boolean;
     findManyAst?: boolean;

package/package.json

@@ -16,6 +16,7 @@
   },
   "description": "Athena JS SDK",
   "devDependencies": {
+    "@biomejs/biome": "^2.5.4",
     "@react-email/components": "^1.0.12",
     "@react-email/render": "^2.0.8",
     "@types/blessed": "^0.1.25",
@@ -33,7 +34,8 @@
     "react-test-renderer": "^18.3.1",
     "tsup": "^8.5.1",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "ultracite": "^7.9.4"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -75,6 +77,12 @@
       "require": "./dist/cookies.cjs",
       "types": "./dist/cookies.d.ts"
     },
+    "./env": {
+      "default": "./dist/env.js",
+      "import": "./dist/env.js",
+      "require": "./dist/env.cjs",
+      "types": "./dist/env.d.ts"
+    },
     "./next/client": {
       "default": "./dist/next/client.js",
       "import": "./dist/next/client.js",
@@ -157,6 +165,7 @@
   },
   "scripts": {
     "build": "tsup",
+    "check": "ultracite check",
     "check:all": "pnpm lint && pnpm typecheck && pnpm test && pnpm build",
     "dev": "tsup --watch",
     "docs:methods": "node scripts/generate-sdk-method-reference.mjs",
@@ -169,6 +178,8 @@
     "example:postgres-connection": "cd examples/postgres-connection && bun run start",
     "example:recurring-invoice": "cd examples/recurring-invoice && bun run start",
     "example:retry-patterns": "cd examples/retry-patterns && bun run start",
+    "fix": "ultracite fix",
+    "format": "ultracite fix",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint:fix": "pnpm lint -- --fix",
     "prepublishOnly": "pnpm typecheck && pnpm build",
@@ -198,6 +209,9 @@
       "cookies": [
         "dist/cookies.d.ts"
       ],
+      "env": [
+        "dist/env.d.ts"
+      ],
       "next/client": [
         "dist/next/client.d.ts"
       ],
@@ -218,5 +232,5 @@
       ]
     }
   },
-  "version": "3.0.3"
+  "version": "3.3.0"
 }

package/dist/model-form-Dh0sisdL.d.ts

@@ -1,97 +0,0 @@
-import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-Bltx6iL6.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;
-
-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 { AthenaGatewayError as A, type FormValuesOf as F, type ModelFormAdapter as M, type ToModelFormDefaultsOptions as T, type ModelFormDefaults as a, type ModelFormNullishMode as b, type ModelFormValues as c, type ToModelPayloadOptions as d, createModelFormAdapter as e, toModelPayload as f, isAthenaGatewayError as i, toModelFormDefaults as t };

package/dist/model-form-oOAJUVd4.d.cts

@@ -1,97 +0,0 @@
-import { d as AthenaGatewayErrorCode, q as AthenaGatewayEndpointPath, r as AthenaGatewayMethod, e as AthenaGatewayErrorDetails, s as AthenaGatewayResponse } from './types-Bltx6iL6.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;
-
-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 { AthenaGatewayError as A, type FormValuesOf as F, type ModelFormAdapter as M, type ToModelFormDefaultsOptions as T, type ModelFormDefaults as a, type ModelFormNullishMode as b, type ModelFormValues as c, type ToModelPayloadOptions as d, createModelFormAdapter as e, toModelPayload as f, isAthenaGatewayError as i, toModelFormDefaults as t };

package/dist/pipeline-CIzV9f7b.d.cts

@@ -1,8 +0,0 @@
-import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-DFr2cL1N.cjs';
-
-/**
- * End-to-end generator execution: load config, introspect, render, and optionally write files.
- */
-declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
-
-export { runSchemaGenerator as r };

package/dist/pipeline-DNlc8Ayn.d.ts

@@ -1,8 +0,0 @@
-import { R as RunGeneratorOptions, d as RunGeneratorResult } from './types-D6tZ9aoq.js';
-
-/**
- * End-to-end generator execution: load config, introspect, render, and optionally write files.
- */
-declare function runSchemaGenerator(options?: RunGeneratorOptions): Promise<RunGeneratorResult>;
-
-export { runSchemaGenerator as r };