@graphoria/server 0.1.5 → 0.2.0

package/dist/src/config/types/cron.d.ts

@@ -35,37 +35,131 @@ export type CronTickCallback<TVariables = Record<string, unknown>> = (options: {
  * This allows TypeScript to infer the variables type
  */
 export declare const createTypedCronJobZod: <TVariables extends DefaultVariables>() => z.ZodObject<{
+    /**
+     * Unique name/identifier for the cron job
+     */
     name: z.ZodString;
+    /**
+     * Cron pattern or ISO 8601 date string
+     * Examples:
+     * - "0 0 * * *" (daily at midnight)
+     * - "*\/5 * * * *" (every 5 minutes)
+     * - "2024-01-23T00:00:00" (specific date/time)
+     */
     pattern: z.ZodString;
+    /**
+     * Optional GraphQL query to execute when the cron job runs
+     * If not provided, you must use the gqlQuery function in onTick callback
+     */
     query: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional variables to pass to the GraphQL query
+     */
     variables: z.ZodOptional<z.ZodCustom<TVariables, TVariables>>;
+    /**
+     * Optional timezone (e.g., "America/New_York", "Europe/Stockholm")
+     */
     timezone: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether the job should be paused from start
+     */
     paused: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Maximum number of times the job should run
+     */
     maxRuns: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Minimum number of seconds between triggers
+     */
     interval: z.ZodOptional<z.ZodNumber>;
+    /**
+     * ISO 8601 formatted datetime to start the job
+     */
     startAt: z.ZodOptional<z.ZodString>;
+    /**
+     * ISO 8601 formatted datetime to stop the job
+     */
     stopAt: z.ZodOptional<z.ZodString>;
+    /**
+     * Enable over-run protection (blocks new triggers while old one is in progress)
+     */
     protect: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether to catch errors silently or handle them
+     */
     catchErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Context to pass along with the cron job (for logging, etc.)
+     */
     context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Callback executed on each tick
+     */
     onTick: z.ZodOptional<z.ZodCustom<CronTickCallback<TVariables>, CronTickCallback<TVariables>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export declare const TypedCronJobZod: z.ZodObject<{
+    /**
+     * Unique name/identifier for the cron job
+     */
     name: z.ZodString;
+    /**
+     * Cron pattern or ISO 8601 date string
+     * Examples:
+     * - "0 0 * * *" (daily at midnight)
+     * - "*\/5 * * * *" (every 5 minutes)
+     * - "2024-01-23T00:00:00" (specific date/time)
+     */
     pattern: z.ZodString;
+    /**
+     * Optional GraphQL query to execute when the cron job runs
+     * If not provided, you must use the gqlQuery function in onTick callback
+     */
     query: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional variables to pass to the GraphQL query
+     */
     variables: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+    /**
+     * Optional timezone (e.g., "America/New_York", "Europe/Stockholm")
+     */
     timezone: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether the job should be paused from start
+     */
     paused: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Maximum number of times the job should run
+     */
     maxRuns: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Minimum number of seconds between triggers
+     */
     interval: z.ZodOptional<z.ZodNumber>;
+    /**
+     * ISO 8601 formatted datetime to start the job
+     */
     startAt: z.ZodOptional<z.ZodString>;
+    /**
+     * ISO 8601 formatted datetime to stop the job
+     */
     stopAt: z.ZodOptional<z.ZodString>;
+    /**
+     * Enable over-run protection (blocks new triggers while old one is in progress)
+     */
     protect: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * Whether to catch errors silently or handle them
+     */
     catchErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /**
+     * Context to pass along with the cron job (for logging, etc.)
+     */
     context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Callback executed on each tick
+     */
     onTick: z.ZodOptional<z.ZodCustom<CronTickCallback<Record<string, unknown>>, CronTickCallback<Record<string, unknown>>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type CronJobType = z.input<typeof TypedCronJobZod>;
 /**
  * Typed cron job definition

package/dist/src/config/types/cron.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../../src/config/types/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,sBAAsB,wCAAoC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,GAAG,gBAAgB,IAAI;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACnE,OAAO,EAAE;IACP,QAAQ,EAAE,CAAC,OAAO,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,OAAO,KACV,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,EACD,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,EAChC,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,SAAS,gBAAgB;;;;;;;;;;;;;;;iBA4ErE,CAAC;AAEL,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;iBAA0B,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,UAAU,GAAG,gBAAgB,IAAI,IAAI,CAC5D,WAAW,EACX,WAAW,GAAG,QAAQ,CACvB,GAAG;IACF,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,GAAG,gBAAgB,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../../src/config/types/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,sBAAsB,wCAAoC,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,GAAG,gBAAgB,IAAI;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACnE,OAAO,EAAE;IACP,QAAQ,EAAE,CAAC,OAAO,GAAG,OAAO,EAC1B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,CAAC,EAAE,OAAO,KACV,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC,EACD,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,EAChC,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,KAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,SAAS,gBAAgB;IAErE;;OAEG;;IAGH;;;;;;OAMG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;kBAEH,CAAC;AAEL,eAAO,MAAM,eAAe;IA5ExB;;OAEG;;IAGH;;;;;;OAMG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;kBAI+C,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,UAAU,GAAG,gBAAgB,IAAI,IAAI,CAC5D,WAAW,EACX,WAAW,GAAG,QAAQ,CACvB,GAAG;IACF,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,GAAG,gBAAgB,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC"}

package/dist/src/config/types/db.d.ts

@@ -11,8 +11,11 @@ export declare const RELATIONSHIP_CONDITION_OPERATORS: readonly ["eq", "neq", "g
  * A `value` is required for every operator except `is_null` / `is_not_null`.
  */
 export declare const RelationshipConditionZod: z.ZodObject<{
+    /** Column on the declaring (source) table */
     source: z.ZodOptional<z.ZodString>;
+    /** Column on the referenced (target) table */
     target: z.ZodOptional<z.ZodString>;
+    /** Comparison operator (default `eq`) */
     operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
         eq: "eq";
         neq: "neq";
@@ -24,8 +27,9 @@ export declare const RelationshipConditionZod: z.ZodObject<{
         is_null: "is_null";
         is_not_null: "is_not_null";
     }>>>;
+    /** Literal compared against the column (omit for `is_null` / `is_not_null`) */
     value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type RelationshipCondition = z.input<typeof RelationshipConditionZod>;
 export declare const TableRelationshipZod: z.ZodObject<{
     schema: z.ZodString;
@@ -33,10 +37,14 @@ export declare const TableRelationshipZod: z.ZodObject<{
     columns: z.ZodArray<z.ZodObject<{
         source: z.ZodString;
         target: z.ZodString;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
+    /** Static-value predicates ANDed into the JOIN condition */
     conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Column on the declaring (source) table */
         source: z.ZodOptional<z.ZodString>;
+        /** Column on the referenced (target) table */
         target: z.ZodOptional<z.ZodString>;
+        /** Comparison operator (default `eq`) */
         operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
             eq: "eq";
             neq: "neq";
@@ -48,9 +56,10 @@ export declare const TableRelationshipZod: z.ZodObject<{
             is_null: "is_null";
             is_not_null: "is_not_null";
         }>>>;
+        /** Literal compared against the column (omit for `is_null` / `is_not_null`) */
         value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
 export type TableRelationship = z.input<typeof TableRelationshipZod>;
 export declare const TableSchemaConfigZod: z.ZodObject<{
     columns: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -62,17 +71,21 @@ export declare const TableSchemaConfigZod: z.ZodObject<{
         function: z.ZodOptional<z.ZodString>;
         params: z.ZodOptional<z.ZodArray<z.ZodString>>;
         expression: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>>;
+    }, z.core.$strict>>>>;
     relationships: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
         schema: z.ZodString;
         name: z.ZodString;
         columns: z.ZodArray<z.ZodObject<{
             source: z.ZodString;
             target: z.ZodString;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
+        /** Static-value predicates ANDed into the JOIN condition */
         conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            /** Column on the declaring (source) table */
             source: z.ZodOptional<z.ZodString>;
+            /** Column on the referenced (target) table */
             target: z.ZodOptional<z.ZodString>;
+            /** Comparison operator (default `eq`) */
             operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 eq: "eq";
                 neq: "neq";
@@ -84,12 +97,15 @@ export declare const TableSchemaConfigZod: z.ZodObject<{
                 is_null: "is_null";
                 is_not_null: "is_not_null";
             }>>>;
+            /** Literal compared against the column (omit for `is_null` / `is_not_null`) */
             value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>>>;
+    /** Overrides the table description from the database */
     description: z.ZodOptional<z.ZodString>;
+    /** Overrides column descriptions from the database, keyed by column name */
     columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type TableSchemaConfig = z.input<typeof TableSchemaConfigZod>;
 export declare const DatabaseSchemaConfigZod: z.ZodObject<{
     database: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -102,17 +118,21 @@ export declare const DatabaseSchemaConfigZod: z.ZodObject<{
             function: z.ZodOptional<z.ZodString>;
             params: z.ZodOptional<z.ZodArray<z.ZodString>>;
             expression: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>>;
+        }, z.core.$strict>>>>;
         relationships: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
             schema: z.ZodString;
             name: z.ZodString;
             columns: z.ZodArray<z.ZodObject<{
                 source: z.ZodString;
                 target: z.ZodString;
-            }, z.core.$strip>>;
+            }, z.core.$strict>>;
+            /** Static-value predicates ANDed into the JOIN condition */
             conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                /** Column on the declaring (source) table */
                 source: z.ZodOptional<z.ZodString>;
+                /** Column on the referenced (target) table */
                 target: z.ZodOptional<z.ZodString>;
+                /** Comparison operator (default `eq`) */
                 operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                     eq: "eq";
                     neq: "neq";
@@ -124,46 +144,66 @@ export declare const DatabaseSchemaConfigZod: z.ZodObject<{
                     is_null: "is_null";
                     is_not_null: "is_not_null";
                 }>>>;
+                /** Literal compared against the column (omit for `is_null` / `is_not_null`) */
                 value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>>>;
+        /** Overrides the table description from the database */
         description: z.ZodOptional<z.ZodString>;
+        /** Overrides column descriptions from the database, keyed by column name */
         columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-    }, z.core.$strip>>>>>>>;
+    }, z.core.$strict>>>>>>>;
     excludedTables: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type DatabaseSchemaConfig = z.input<typeof DatabaseSchemaConfigZod>;
 /**
  * Connection pool and transport options for PostgreSQL and MySQL (Bun SQL).
  * All timeout values are in seconds.
  */
 export declare const BunSQLConnectionOptionsZod: z.ZodObject<{
+    /** Maximum number of connections in the pool */
     max: z.ZodDefault<z.ZodNumber>;
+    /** Maximum time in seconds a connection can be idle before being closed */
     idleTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Maximum time in seconds to wait when establishing a connection */
     connectionTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Maximum lifetime in seconds of a connection */
     maxLifetime: z.ZodDefault<z.ZodNumber>;
+    /** Whether to use TLS/SSL for the connection */
     tls: z.ZodDefault<z.ZodBoolean>;
+    /** Automatic creation of prepared statements (default: true) */
     prepare: z.ZodDefault<z.ZodBoolean>;
+    /** Return values outside i32 range as BigInts instead of strings (default: false) */
     bigint: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type BunSQLConnectionOptions = z.input<typeof BunSQLConnectionOptionsZod>;
 /**
  * Connection pool and transport options for MSSQL.
  * All timeout values are in seconds (converted to milliseconds internally).
  */
 export declare const MSSQLConnectionOptionsZod: z.ZodObject<{
+    /** Connection pool options */
     pool: z.ZodDefault<z.ZodObject<{
+        /** Maximum number of connections in the pool */
         max: z.ZodDefault<z.ZodNumber>;
+        /** Minimum number of connections in the pool */
         min: z.ZodDefault<z.ZodNumber>;
+        /** Maximum time in seconds a connection can be idle before being closed */
         idleTimeout: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
+    /** Maximum time in seconds to wait when establishing a connection */
     connectionTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Maximum time in seconds to wait for a request to complete */
     requestTimeout: z.ZodDefault<z.ZodNumber>;
+    /** Whether to encrypt the connection */
     encrypt: z.ZodDefault<z.ZodBoolean>;
+    /** Whether to trust the server certificate without validation */
     trustServerCertificate: z.ZodDefault<z.ZodBoolean>;
+    /** Whether to use Windows Authentication (trusted connection) */
     trustedConnection: z.ZodDefault<z.ZodBoolean>;
+    /** Whether to automatically parse JSON responses */
     parseJSON: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 export type MSSQLConnectionOptions = z.input<typeof MSSQLConnectionOptionsZod>;
 /**
  * Maps database type to the corresponding native connection type.
@@ -186,19 +226,27 @@ export type OnConnectHandler<T extends DatabaseType = DatabaseType> = (connectio
  */
 export type ConnectionOptionsForType<T extends DatabaseType> = T extends "pg" | "mysql" ? BunSQLConnectionOptions : T extends "mssql" ? MSSQLConnectionOptions : never;
 export declare const DatabaseConnectionZod: z.ZodObject<{
+    /** Unique name for the database connection */
     name: z.ZodString;
+    /** Whether the database is enabled */
     enabled: z.ZodBoolean;
+    /** Database type */
     type: z.ZodUnion<readonly [z.ZodLiteral<"mssql">, z.ZodLiteral<"pg">, z.ZodLiteral<"mysql">]>;
+    /** Connection configuration */
     connection: z.ZodObject<{
         host: z.ZodString;
         port: z.ZodNumber;
         user: z.ZodString;
         password: z.ZodString;
         database: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strict>;
+    /** Field naming pattern (default: "{schema}_{name}") */
     fieldNaming: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Factory function to create custom database repository */
     repository: z.ZodOptional<z.ZodCustom<CustomRepositoryFactory<DatabaseType>, CustomRepositoryFactory<DatabaseType>>>;
+    /** Handler run once at startup against the connected database */
     onConnect: z.ZodOptional<z.ZodCustom<OnConnectHandler<DatabaseType>, OnConnectHandler<DatabaseType>>>;
+    /** Schema configuration (virtual columns, relationships, excluded tables) */
     schema: z.ZodOptional<z.ZodObject<{
         database: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodCatch<z.ZodDefault<z.ZodOptional<z.ZodObject<{
             columns: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -210,17 +258,21 @@ export declare const DatabaseConnectionZod: z.ZodObject<{
                 function: z.ZodOptional<z.ZodString>;
                 params: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 expression: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>>;
+            }, z.core.$strict>>>>;
             relationships: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
                 schema: z.ZodString;
                 name: z.ZodString;
                 columns: z.ZodArray<z.ZodObject<{
                     source: z.ZodString;
                     target: z.ZodString;
-                }, z.core.$strip>>;
+                }, z.core.$strict>>;
+                /** Static-value predicates ANDed into the JOIN condition */
                 conditions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    /** Column on the declaring (source) table */
                     source: z.ZodOptional<z.ZodString>;
+                    /** Column on the referenced (target) table */
                     target: z.ZodOptional<z.ZodString>;
+                    /** Comparison operator (default `eq`) */
                     operator: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                         eq: "eq";
                         neq: "neq";
@@ -232,36 +284,57 @@ export declare const DatabaseConnectionZod: z.ZodObject<{
                         is_null: "is_null";
                         is_not_null: "is_not_null";
                     }>>>;
+                    /** Literal compared against the column (omit for `is_null` / `is_not_null`) */
                     value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>>>;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>>>;
+            /** Overrides the table description from the database */
             description: z.ZodOptional<z.ZodString>;
+            /** Overrides column descriptions from the database, keyed by column name */
             columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-        }, z.core.$strip>>>>>>>;
+        }, z.core.$strict>>>>>>>;
         excludedTables: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
+    /** Optional connection pool and transport options */
     connectionOptions: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        /** Maximum number of connections in the pool */
         max: z.ZodDefault<z.ZodNumber>;
+        /** Maximum time in seconds a connection can be idle before being closed */
         idleTimeout: z.ZodDefault<z.ZodNumber>;
+        /** Maximum time in seconds to wait when establishing a connection */
         connectionTimeout: z.ZodDefault<z.ZodNumber>;
+        /** Maximum lifetime in seconds of a connection */
         maxLifetime: z.ZodDefault<z.ZodNumber>;
+        /** Whether to use TLS/SSL for the connection */
         tls: z.ZodDefault<z.ZodBoolean>;
+        /** Automatic creation of prepared statements (default: true) */
         prepare: z.ZodDefault<z.ZodBoolean>;
+        /** Return values outside i32 range as BigInts instead of strings (default: false) */
         bigint: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>, z.ZodObject<{
+    }, z.core.$strict>, z.ZodObject<{
+        /** Connection pool options */
         pool: z.ZodDefault<z.ZodObject<{
+            /** Maximum number of connections in the pool */
             max: z.ZodDefault<z.ZodNumber>;
+            /** Minimum number of connections in the pool */
             min: z.ZodDefault<z.ZodNumber>;
+            /** Maximum time in seconds a connection can be idle before being closed */
             idleTimeout: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>;
+        }, z.core.$strict>>;
+        /** Maximum time in seconds to wait when establishing a connection */
         connectionTimeout: z.ZodDefault<z.ZodNumber>;
+        /** Maximum time in seconds to wait for a request to complete */
         requestTimeout: z.ZodDefault<z.ZodNumber>;
+        /** Whether to encrypt the connection */
         encrypt: z.ZodDefault<z.ZodBoolean>;
+        /** Whether to trust the server certificate without validation */
         trustServerCertificate: z.ZodDefault<z.ZodBoolean>;
+        /** Whether to use Windows Authentication (trusted connection) */
         trustedConnection: z.ZodDefault<z.ZodBoolean>;
+        /** Whether to automatically parse JSON responses */
         parseJSON: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>]>>;
-}, z.core.$strip>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
 /**
  * Database connection shape (derived from the Zod schema).
  */

package/dist/src/config/types/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../src/config/types/db.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../src/config/types/db.ts"],"names":[],"mappings":"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"}

package/dist/src/config/types/index.d.ts

@@ -1,6 +1,6 @@
 export type { VirtualColumnType, VirtualColumnFunctionFn, VirtualColumnExpressionFn, CreateYAndNToBooleanMSSQLFn, CreateOneToBooleanMSSQLFn, } from "./virtual-columns";
 export { virtualColumnFunction, virtualColumnExpression, createYAndNToBooleanMSSQL, createOneToBooleanMSSQL, VirtualColumnZod, } from "./virtual-columns";
-export type { DefaultInput, OperationRestConfig, OperationGraphQLConfig, OperationCacheConfig, BeforeRequestContext, AfterRequestContext, GqlQueryResult, OperationOptions, OperationInitHook, OperationBeforeRequestHook, OperationAfterRequestHook, OperationHandler, BaseOperation, QueryOperation, HandlerOperation, TypedOperation, Operation, Operations, } from "./operation";
+export type { DefaultInput, AnyQueryDocument, QueryResultOf, OperationRestConfig, OperationGraphQLConfig, OperationCacheConfig, BeforeRequestContext, AfterRequestContext, GqlQueryResult, OperationOptions, OperationInitHook, OperationBeforeRequestHook, OperationAfterRequestHook, OperationHandler, BaseOperation, QueryOperation, HandlerOperation, TypedOperation, Operation, Operations, } from "./operation";
 export { OperationRestConfigZod, OperationGraphQLConfigZod, OperationCacheConfigZod, OperationZod, OperationsZod, } from "./operation";
 export type { CronTickCallback, CronJobConfig } from "./cron";
 export type { AIConfig, MCPConfig } from "./ai";

package/dist/src/config/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/config/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAG9D,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAGhD,YAAY,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAG3F,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,MAAM,CAAC;AAEd,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,MAAM,CAAC;AAEd,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/config/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAG9D,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAGhD,YAAY,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAG3F,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,QAAQ,CAAC;AAGhB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,MAAM,CAAC;AAEd,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,MAAM,CAAC;AAEd,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/config/types/operation.d.ts

@@ -3,6 +3,22 @@ import { z } from "zod";
  * Default input type when no schema is provided
  */
 export type DefaultInput = Record<string, unknown>;
+/**
+ * A gql.tada / `TypedDocumentNode` query document. Every GraphQL AST node has a
+ * `kind`, which distinguishes a document from a plain string query; documents
+ * additionally carry their result type on the `__apiType` phantom property.
+ */
+export type AnyQueryDocument = {
+    readonly kind: string;
+};
+/**
+ * Extracts a query document's result type (the GraphQL `data` payload) from its
+ * gql.tada / TypedDocumentNode `__apiType` phantom. A plain string query (or a
+ * document without embedded types) resolves to `unknown`.
+ */
+export type QueryResultOf<TQuery> = TQuery extends string ? unknown : TQuery extends {
+    __apiType?: (variables: any) => infer TResult;
+} ? TResult : unknown;
 /**
  * Zod schema for REST configuration
  */
@@ -18,14 +34,14 @@ export declare const OperationRestConfigZod: z.ZodObject<{
     pathParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
     queryParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
     body: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /**
  * Zod schema for GraphQL configuration
  */
 export declare const OperationGraphQLConfigZod: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     name: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /**
  * Zod schema for cache configuration
  */
@@ -37,7 +53,7 @@ export declare const OperationCacheConfigZod: z.ZodObject<{
     updateAgeOnGet: z.ZodOptional<z.ZodBoolean>;
     updateAgeOnHas: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     ttlAutopurge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /**
  * REST exposure configuration for an operation
  */
@@ -60,7 +76,7 @@ export declare const OperationZod: z.ZodObject<{
         init: z.ZodOptional<z.ZodCustom<OperationInitHook<any>, OperationInitHook<any>>>;
         beforeRequest: z.ZodOptional<z.ZodCustom<OperationBeforeRequestHook<any, any, any>, OperationBeforeRequestHook<any, any, any>>>;
         afterRequest: z.ZodOptional<z.ZodCustom<OperationAfterRequestHook<any>, OperationAfterRequestHook<any>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     rest: z.ZodOptional<z.ZodObject<{
         path: z.ZodString;
         method: z.ZodDefault<z.ZodEnum<{
@@ -73,11 +89,11 @@ export declare const OperationZod: z.ZodObject<{
         pathParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         queryParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         body: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     graphql: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         name: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
     cache: z.ZodOptional<z.ZodObject<{
         max: z.ZodOptional<z.ZodNumber>;
         maxSize: z.ZodOptional<z.ZodNumber>;
@@ -86,8 +102,8 @@ export declare const OperationZod: z.ZodObject<{
         updateAgeOnGet: z.ZodOptional<z.ZodBoolean>;
         updateAgeOnHas: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         ttlAutopurge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
 export type Operation = z.input<typeof OperationZod>;
 export declare const OperationsZod: z.ZodRecord<z.ZodString, z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
@@ -99,7 +115,7 @@ export declare const OperationsZod: z.ZodRecord<z.ZodString, z.ZodObject<{
         init: z.ZodOptional<z.ZodCustom<OperationInitHook<any>, OperationInitHook<any>>>;
         beforeRequest: z.ZodOptional<z.ZodCustom<OperationBeforeRequestHook<any, any, any>, OperationBeforeRequestHook<any, any, any>>>;
         afterRequest: z.ZodOptional<z.ZodCustom<OperationAfterRequestHook<any>, OperationAfterRequestHook<any>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     rest: z.ZodOptional<z.ZodObject<{
         path: z.ZodString;
         method: z.ZodDefault<z.ZodEnum<{
@@ -112,11 +128,11 @@ export declare const OperationsZod: z.ZodRecord<z.ZodString, z.ZodObject<{
         pathParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         queryParams: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
         body: z.ZodOptional<z.ZodCustom<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>>;
     graphql: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         name: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
+    }, z.core.$strict>>>;
     cache: z.ZodOptional<z.ZodObject<{
         max: z.ZodOptional<z.ZodNumber>;
         maxSize: z.ZodOptional<z.ZodNumber>;
@@ -125,17 +141,28 @@ export declare const OperationsZod: z.ZodRecord<z.ZodString, z.ZodObject<{
         updateAgeOnGet: z.ZodOptional<z.ZodBoolean>;
         updateAgeOnHas: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         ttlAutopurge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
 export type Operations = z.input<typeof OperationsZod>;
 /**
- * Context passed to beforeRequest hook
+ * Context passed to beforeRequest hook.
+ *
+ * `input` is the merged view of every REST parameter source. `pathParams`,
+ * `queryParams`, and `body` expose each source separately (parsed with its own
+ * schema), or `undefined` when that source has no schema configured.
  */
-export type BeforeRequestContext<TInput = DefaultInput> = {
+export type BeforeRequestContext<TInput = DefaultInput, TPathParams = unknown, TQueryParams = unknown, TBody = unknown> = {
     input: TInput;
+    pathParams?: TPathParams;
+    queryParams?: TQueryParams;
+    body?: TBody;
 };
 /**
- * Context passed to afterRequest hook
+ * Context passed to the afterRequest hook.
+ *
+ * `output` is the operation's output payload — for query-based operations the
+ * unwrapped GraphQL `data` (the hook's return replaces `data` in the response
+ * envelope); for handler-based operations the value the handler returned.
  */
 export type AfterRequestContext<TOutput = unknown> = {
     output: TOutput;
@@ -171,7 +198,12 @@ export type OperationInitHook<TInitData = unknown> = (options: OperationOptions)
  */
 export type OperationBeforeRequestHook<TInput = DefaultInput, TInitData = unknown, TVariables = Record<string, unknown>> = (context: BeforeRequestContext<TInput>, initData: TInitData | undefined) => TVariables | Promise<TVariables>;
 /**
- * AfterRequest hook - transforms output after execution
+ * AfterRequest hook — transforms the output after a successful query/handler.
+ *
+ * Receives the output payload and returns the (possibly transformed) payload.
+ * Runs on success only; throw to turn a successful response into an error. For
+ * cached query operations it runs on the cache miss and the transformed result
+ * is cached, so cache hits reuse it without re-invoking the hook.
  */
 export type OperationAfterRequestHook<TOutput = unknown> = (context: AfterRequestContext<TOutput>) => TOutput | Promise<TOutput>;
 /**