@graphoria/server 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../../src/config/types/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;EAO5B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,kEAA0D,CAAC;AAE1F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMjE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;kBA4C1B,CAAC;AAEL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM/D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAuBtB,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

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

@@ -0,0 +1,61 @@
+import type { SQL } from "bun";
+import type { ConnectionPool } from "mssql";
+import { z } from "zod";
+import type { AIConfig } from "./ai";
+import type { AuthConfig } from "./auth";
+import type { CronJobConfig } from "./cron";
+import type { AnyDatabaseConfig } from "./db";
+import type { TypedOperation } from "./operation";
+import type { QueueConfig } from "./queue";
+import type { RemoteRESTConfig } from "./remote-rest";
+import type { RemoteSchemaConfig } from "./remote-schema";
+/**
+ * Union of supported database connection types
+ */
+export type DatabaseConnectionInstance = SQL | ConnectionPool;
+/**
+ * Token strategy for authentication
+ * - "jwt": JSON Web Tokens (default)
+ * - "paseto_local": PASETO v4.local (symmetric encryption)
+ * - "paseto_public": PASETO v4.public (public-key signatures)
+ */
+export declare const TokenStrategyZod: z.ZodEnum<{
+    jwt: "jwt";
+    paseto_local: "paseto_local";
+    paseto_public: "paseto_public";
+}>;
+export type TokenStrategy = z.input<typeof TokenStrategyZod>;
+/**
+ * Full configuration input type for Graphoria
+ */
+export type ConfigurationInput = {
+    /** Project name */
+    name: string;
+    /** Project version */
+    version: string;
+    /**
+     * Token strategy: "jwt" (default), "paseto_local", or "paseto_public"
+     *
+     * When using PASETO, set the corresponding environment variables:
+     * - paseto_local: PASETO_LOCAL_KEY (k4.local.xxx format)
+     * - paseto_public: PASETO_SECRET_KEY (k4.secret.xxx) + PASETO_PUBLIC_KEY (k4.public.xxx)
+     */
+    tokenStrategy?: TokenStrategy;
+    /** Database connections */
+    databases?: AnyDatabaseConfig[];
+    /** Message queues (RabbitMQ, Kafka) */
+    queues?: QueueConfig[];
+    /** Cron jobs */
+    cron?: CronJobConfig[];
+    /** Operations - unified handlers for REST + GraphQL */
+    operations?: Record<string, TypedOperation<any, any, any, any>>;
+    /** Authentication configuration */
+    auth?: AuthConfig;
+    /** Remote GraphQL schemas to merge into the API */
+    remoteSchemas?: RemoteSchemaConfig[];
+    /** Remote REST APIs (OpenAPI) to proxy under /rest */
+    remoteREST?: RemoteRESTConfig[];
+    /** AI agent (admin-only NL → database Q&A) + MCP server. Off by default. */
+    ai?: AIConfig;
+};
+//# sourceMappingURL=configuration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../../../src/config/types/configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,GAAG,GAAG,cAAc,CAAC;AAM9D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;EAAmD,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,2BAA2B;IAC3B,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,gBAAgB;IAChB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,uDAAuD;IAEvD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAChE,mCAAmC;IACnC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACrC,sDAAsD;IACtD,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAChC,4EAA4E;IAC5E,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf,CAAC"}

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

@@ -0,0 +1,81 @@
+import { z } from "zod";
+/**
+ * Default variables type
+ */
+export declare const DefaultVariablesSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type DefaultVariables = z.infer<typeof DefaultVariablesSchema>;
+/**
+ * Context passed to the tick callback
+ */
+export type TickContext<TVariables = DefaultVariables> = {
+    name: string;
+    pattern: string;
+    variables: TVariables;
+    executionCount: number;
+    nextRun: Date | null;
+    previousRun: Date | null;
+};
+/**
+ * Cron job tick callback
+ */
+export type CronTickCallback<TVariables = Record<string, unknown>> = (options: {
+    gqlQuery: <TReturn = unknown>(query: string, params?: Record<string, unknown>, req?: unknown) => Promise<{
+        data: TReturn;
+        errors?: unknown[];
+    }>;
+    databases: unknown;
+    queues: unknown;
+    repository: Record<string, unknown>;
+}, context: TickContext<TVariables>, response?: {
+    data: unknown;
+    errors?: unknown[];
+}) => Promise<void> | void;
+/**
+ * Generic Zod schema factory for typed cron jobs
+ * This allows TypeScript to infer the variables type
+ */
+export declare const createTypedCronJobZod: <TVariables extends DefaultVariables>() => z.ZodObject<{
+    name: z.ZodString;
+    pattern: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodCustom<TVariables, TVariables>>;
+    timezone: z.ZodOptional<z.ZodString>;
+    paused: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxRuns: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodNumber>;
+    startAt: z.ZodOptional<z.ZodString>;
+    stopAt: z.ZodOptional<z.ZodString>;
+    protect: z.ZodOptional<z.ZodBoolean>;
+    catchErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    onTick: z.ZodOptional<z.ZodCustom<CronTickCallback<TVariables>, CronTickCallback<TVariables>>>;
+}, z.core.$strip>;
+export declare const TypedCronJobZod: z.ZodObject<{
+    name: z.ZodString;
+    pattern: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    variables: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+    timezone: z.ZodOptional<z.ZodString>;
+    paused: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    maxRuns: z.ZodOptional<z.ZodNumber>;
+    interval: z.ZodOptional<z.ZodNumber>;
+    startAt: z.ZodOptional<z.ZodString>;
+    stopAt: z.ZodOptional<z.ZodString>;
+    protect: z.ZodOptional<z.ZodBoolean>;
+    catchErrors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    onTick: z.ZodOptional<z.ZodCustom<CronTickCallback<Record<string, unknown>>, CronTickCallback<Record<string, unknown>>>>;
+}, z.core.$strip>;
+export type CronJobType = z.input<typeof TypedCronJobZod>;
+/**
+ * Typed cron job definition
+ */
+export type TypedCronJob<TVariables = DefaultVariables> = Omit<CronJobType, "variables" | "onTick"> & {
+    variables?: TVariables;
+    onTick?: CronTickCallback<TVariables>;
+};
+/**
+ * Cron job configuration (alias of TypedCronJob, kept for the public config surface)
+ */
+export type CronJobConfig<TVariables = DefaultVariables> = TypedCronJob<TVariables>;
+//# sourceMappingURL=cron.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,210 @@
+import { z } from "zod";
+import type { SQL } from "bun";
+import type { ConnectionPool } from "mssql";
+export type DatabaseType = "mssql" | "pg" | "mysql";
+export declare const TableRelationshipZod: z.ZodObject<{
+    schema: z.ZodString;
+    name: z.ZodString;
+    columns: z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TableRelationship = z.input<typeof TableRelationshipZod>;
+export declare const TableSchemaConfigZod: z.ZodObject<{
+    columns: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        dataType: z.ZodString;
+        isNullable: z.ZodBoolean;
+        description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        virtual: z.ZodOptional<z.ZodBoolean>;
+        function: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        expression: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
+    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.$strip>>>>;
+    description: z.ZodOptional<z.ZodString>;
+    columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+}, z.core.$strip>;
+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<{
+        columns: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            dataType: z.ZodString;
+            isNullable: z.ZodBoolean;
+            description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            virtual: z.ZodOptional<z.ZodBoolean>;
+            function: z.ZodOptional<z.ZodString>;
+            params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            expression: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        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.$strip>>>>;
+        description: z.ZodOptional<z.ZodString>;
+        columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strip>>>>>>>;
+    excludedTables: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+}, z.core.$strip>;
+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<{
+    max: z.ZodDefault<z.ZodNumber>;
+    idleTimeout: z.ZodDefault<z.ZodNumber>;
+    connectionTimeout: z.ZodDefault<z.ZodNumber>;
+    maxLifetime: z.ZodDefault<z.ZodNumber>;
+    tls: z.ZodDefault<z.ZodBoolean>;
+    prepare: z.ZodDefault<z.ZodBoolean>;
+    bigint: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+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<{
+    pool: z.ZodDefault<z.ZodObject<{
+        max: z.ZodDefault<z.ZodNumber>;
+        min: z.ZodDefault<z.ZodNumber>;
+        idleTimeout: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+    connectionTimeout: z.ZodDefault<z.ZodNumber>;
+    requestTimeout: z.ZodDefault<z.ZodNumber>;
+    encrypt: z.ZodDefault<z.ZodBoolean>;
+    trustServerCertificate: z.ZodDefault<z.ZodBoolean>;
+    trustedConnection: z.ZodDefault<z.ZodBoolean>;
+    parseJSON: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type MSSQLConnectionOptions = z.input<typeof MSSQLConnectionOptionsZod>;
+/**
+ * Maps database type to the corresponding native connection type.
+ * SQL for Bun/PostgreSQL/MySQL, ConnectionPool for MSSQL.
+ */
+export type DatabaseConnectionForType<T extends DatabaseType> = T extends "pg" | "mysql" ? SQL : T extends "mssql" ? ConnectionPool : never;
+/**
+ * Custom repository factory function type.
+ * Accepts the native connection typed per engine.
+ */
+export type CustomRepositoryFactory<T extends DatabaseType = DatabaseType> = (connection: DatabaseConnectionForType<T>) => unknown;
+/**
+ * Handler invoked once at startup after the database connection is established.
+ * Receives the live connection (typed per engine) and the database config.
+ * Throwing aborts server boot.
+ */
+export type OnConnectHandler<T extends DatabaseType = DatabaseType> = (connection: DatabaseConnectionForType<T>, db: DatabaseConfig<T>) => void | Promise<void>;
+/**
+ * Maps database type to the corresponding connection options type.
+ */
+export type ConnectionOptionsForType<T extends DatabaseType> = T extends "pg" | "mysql" ? BunSQLConnectionOptions : T extends "mssql" ? MSSQLConnectionOptions : never;
+export declare const DatabaseConnectionZod: z.ZodObject<{
+    name: z.ZodString;
+    enabled: z.ZodBoolean;
+    type: z.ZodUnion<readonly [z.ZodLiteral<"mssql">, z.ZodLiteral<"pg">, z.ZodLiteral<"mysql">]>;
+    connection: z.ZodObject<{
+        host: z.ZodString;
+        port: z.ZodNumber;
+        user: z.ZodString;
+        password: z.ZodString;
+        database: z.ZodString;
+    }, z.core.$strip>;
+    fieldNaming: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    repository: z.ZodOptional<z.ZodCustom<CustomRepositoryFactory<DatabaseType>, CustomRepositoryFactory<DatabaseType>>>;
+    onConnect: z.ZodOptional<z.ZodCustom<OnConnectHandler<DatabaseType>, OnConnectHandler<DatabaseType>>>;
+    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<{
+                name: z.ZodString;
+                dataType: z.ZodString;
+                isNullable: z.ZodBoolean;
+                description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+                virtual: z.ZodOptional<z.ZodBoolean>;
+                function: z.ZodOptional<z.ZodString>;
+                params: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                expression: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>>;
+            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.$strip>>>>;
+            description: z.ZodOptional<z.ZodString>;
+            columnDescriptions: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        }, z.core.$strip>>>>>>>;
+        excludedTables: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    }, z.core.$strip>>;
+    connectionOptions: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        max: z.ZodDefault<z.ZodNumber>;
+        idleTimeout: z.ZodDefault<z.ZodNumber>;
+        connectionTimeout: z.ZodDefault<z.ZodNumber>;
+        maxLifetime: z.ZodDefault<z.ZodNumber>;
+        tls: z.ZodDefault<z.ZodBoolean>;
+        prepare: z.ZodDefault<z.ZodBoolean>;
+        bigint: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        pool: z.ZodDefault<z.ZodObject<{
+            max: z.ZodDefault<z.ZodNumber>;
+            min: z.ZodDefault<z.ZodNumber>;
+            idleTimeout: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>>;
+        connectionTimeout: z.ZodDefault<z.ZodNumber>;
+        requestTimeout: z.ZodDefault<z.ZodNumber>;
+        encrypt: z.ZodDefault<z.ZodBoolean>;
+        trustServerCertificate: z.ZodDefault<z.ZodBoolean>;
+        trustedConnection: z.ZodDefault<z.ZodBoolean>;
+        parseJSON: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+/**
+ * Database connection shape (derived from the Zod schema).
+ */
+export type DatabaseConnection = z.input<typeof DatabaseConnectionZod>["connection"];
+/**
+ * Database configuration with engine-type narrowing.
+ */
+export type DatabaseConfig<T extends DatabaseType = DatabaseType> = {
+    /** Unique name for the database connection */
+    name: string;
+    /** Whether the database is enabled */
+    enabled: boolean;
+    /** Database type */
+    type: T;
+    /** Connection configuration */
+    connection: DatabaseConnection;
+    /** Field naming pattern (default: "{schema}_{name}") */
+    fieldNaming?: string;
+    /** Factory function to create custom database repository */
+    repository?: CustomRepositoryFactory<T>;
+    /** Handler run once at startup against the connected database */
+    onConnect?: OnConnectHandler<T>;
+    /** Schema configuration (virtual columns, relationships, excluded tables) */
+    schema?: DatabaseSchemaConfig;
+    /** Optional connection pool and transport options */
+    connectionOptions?: ConnectionOptionsForType<T>;
+};
+/**
+ * Discriminated union of all database configs — allows proper type narrowing
+ * for repository function parameter based on the database type field.
+ */
+export type AnyDatabaseConfig = {
+    [K in DatabaseType]: DatabaseConfig<K>;
+}[DatabaseType];
+//# sourceMappingURL=db.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,17 @@
+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 { OperationRestConfigZod, OperationGraphQLConfigZod, OperationCacheConfigZod, OperationZod, OperationsZod, } from "./operation";
+export type { CronTickCallback, CronJobConfig } from "./cron";
+export type { AIConfig, MCPConfig } from "./ai";
+export type { RemoteSchemaConfig, RemoteSchemaIntrospectionConfig } from "./remote-schema";
+export type { RemoteRESTConfig } from "./remote-rest";
+export type { ReconnectConfig, PublisherConfig, SubscriberConfig, TopicConfig, CacheContext, SubscriberHandler, RabbitMQConnection, KafkaConnection, QueueConfig, } from "./queue";
+export { ReconnectConfigZod, PublisherConfigZod, SubscriberConfigZod, TopicConfigZod, BaseQueueConfigZod, RabbitMQConnectionZod, KafkaConnectionZod, } from "./queue";
+export type { DirectionUnion, OrderByClause, FilterCondition, TablePermission, RolePermission, AuthConfig, } from "./auth";
+export { DirectionUnionZod, OrderByClauseZod, FilterConditionZod, TablePermissionZod, RolePermissionZod, AuthConfigZod, } from "./auth";
+export type { DatabaseType, DatabaseConnection, TableRelationship, TableSchemaConfig, DatabaseSchemaConfig, CustomRepositoryFactory, DatabaseConfig, OnConnectHandler, BunSQLConnectionOptions, MSSQLConnectionOptions, ConnectionOptionsForType, AnyDatabaseConfig, } from "./db";
+export { TableRelationshipZod, TableSchemaConfigZod, DatabaseSchemaConfigZod, BunSQLConnectionOptionsZod, MSSQLConnectionOptionsZod, DatabaseConnectionZod, } from "./db";
+export type { ConfigurationInput, TokenStrategy } from "./configuration";
+export { TokenStrategyZod } from "./configuration";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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,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

@@ -0,0 +1,226 @@
+import { z } from "zod";
+/**
+ * Default input type when no schema is provided
+ */
+export type DefaultInput = Record<string, unknown>;
+/**
+ * Zod schema for REST configuration
+ */
+export declare const OperationRestConfigZod: z.ZodObject<{
+    path: z.ZodString;
+    method: z.ZodDefault<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+    }>>;
+    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>;
+/**
+ * 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>;
+/**
+ * Zod schema for cache configuration
+ */
+export declare const OperationCacheConfigZod: z.ZodObject<{
+    max: z.ZodOptional<z.ZodNumber>;
+    maxSize: z.ZodOptional<z.ZodNumber>;
+    ttl: z.ZodOptional<z.ZodNumber>;
+    allowStale: z.ZodOptional<z.ZodBoolean>;
+    updateAgeOnGet: z.ZodOptional<z.ZodBoolean>;
+    updateAgeOnHas: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    ttlAutopurge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * REST exposure configuration for an operation
+ */
+export type OperationRestConfig = z.input<typeof OperationRestConfigZod>;
+/**
+ * GraphQL exposure configuration for an operation
+ */
+export type OperationGraphQLConfig = z.input<typeof OperationGraphQLConfigZod>;
+/**
+ * Cache configuration for an operation
+ */
+export type OperationCacheConfig = z.input<typeof OperationCacheConfigZod>;
+export declare const OperationZod: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    handler: z.ZodOptional<z.ZodCustom<OperationHandler<any, any, any>, OperationHandler<any, any, any>>>;
+    input: z.ZodOptional<z.ZodCustom<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    output: z.ZodOptional<z.ZodCustom<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    hooks: z.ZodOptional<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>>;
+    rest: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>>;
+        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>>;
+    graphql: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    cache: z.ZodOptional<z.ZodObject<{
+        max: z.ZodOptional<z.ZodNumber>;
+        maxSize: z.ZodOptional<z.ZodNumber>;
+        ttl: z.ZodOptional<z.ZodNumber>;
+        allowStale: z.ZodOptional<z.ZodBoolean>;
+        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>;
+export type Operation = z.input<typeof OperationZod>;
+export declare const OperationsZod: z.ZodRecord<z.ZodString, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    handler: z.ZodOptional<z.ZodCustom<OperationHandler<any, any, any>, OperationHandler<any, any, any>>>;
+    input: z.ZodOptional<z.ZodCustom<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    output: z.ZodOptional<z.ZodCustom<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    hooks: z.ZodOptional<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>>;
+    rest: z.ZodOptional<z.ZodObject<{
+        path: z.ZodString;
+        method: z.ZodDefault<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+        }>>;
+        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>>;
+    graphql: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    cache: z.ZodOptional<z.ZodObject<{
+        max: z.ZodOptional<z.ZodNumber>;
+        maxSize: z.ZodOptional<z.ZodNumber>;
+        ttl: z.ZodOptional<z.ZodNumber>;
+        allowStale: z.ZodOptional<z.ZodBoolean>;
+        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>>;
+export type Operations = z.input<typeof OperationsZod>;
+/**
+ * Context passed to beforeRequest hook
+ */
+export type BeforeRequestContext<TInput = DefaultInput> = {
+    input: TInput;
+};
+/**
+ * Context passed to afterRequest hook
+ */
+export type AfterRequestContext<TOutput = unknown> = {
+    output: TOutput;
+};
+/**
+ * Result type for GraphQL queries
+ */
+export type GqlQueryResult<TReturn = unknown> = {
+    data: TReturn;
+    errors?: unknown[];
+};
+/**
+ * Base options passed to operation handlers and hooks.
+ * This is a simplified type for configuration purposes.
+ * At runtime, @graphoria/server provides a fully-typed version with BunRequest support.
+ */
+export type OperationOptions<TRepository = unknown> = {
+    gqlQuery: <TReturn = unknown>(query: string, params?: Record<string, unknown>, req?: any) => Promise<GqlQueryResult<TReturn>>;
+    databases: any;
+    queues: any;
+    /**
+     * Custom repositories keyed by database name (`repository[dbName]`).
+     * `TRepository` is that whole map — e.g. `{ main: MainRepo }`.
+     */
+    repository: TRepository;
+};
+/**
+ * Init hook - runs once at startup, can return cached data
+ */
+export type OperationInitHook<TInitData = unknown> = (options: OperationOptions) => TInitData | Promise<TInitData>;
+/**
+ * BeforeRequest hook - transforms input before execution
+ */
+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
+ */
+export type OperationAfterRequestHook<TOutput = unknown> = (context: AfterRequestContext<TOutput>) => TOutput | Promise<TOutput>;
+/**
+ * Custom handler function for operations with custom logic
+ */
+export type OperationHandler<TInput = DefaultInput, TOutput = unknown, TRepository = unknown> = (options: OperationOptions<TRepository>, input: TInput) => TOutput | Promise<TOutput>;
+/**
+ * Base operation properties shared by all operation types
+ */
+export type BaseOperation<TInput, TOutput, TInitData> = {
+    /** Description for documentation */
+    description?: string;
+    /** Input schema (Zod) - defines what the operation accepts */
+    input?: z.ZodType<TInput>;
+    /** Output schema (Zod) - defines what the operation returns (for OpenAPI) */
+    output?: z.ZodType<TOutput>;
+    /** Hooks for initialization and request transformation */
+    hooks?: {
+        init?: OperationInitHook<TInitData>;
+        beforeRequest?: OperationBeforeRequestHook<TInput, TInitData>;
+        afterRequest?: OperationAfterRequestHook<TOutput>;
+    };
+    /** REST exposure configuration */
+    rest?: OperationRestConfig;
+    /** GraphQL exposure configuration (enabled by default) */
+    graphql?: OperationGraphQLConfig;
+    /** Cache configuration */
+    cache?: OperationCacheConfig;
+};
+/**
+ * Query-based operation - executes a GraphQL query
+ */
+export type QueryOperation<TInput = DefaultInput, TOutput = unknown, TInitData = unknown> = BaseOperation<TInput, TOutput, TInitData> & {
+    /** GraphQL query to execute */
+    query: string;
+    /** Custom handler is not allowed with query */
+    handler?: never;
+};
+/**
+ * Handler-based operation - executes custom logic
+ */
+export type HandlerOperation<TInput = DefaultInput, TOutput = unknown, TInitData = unknown, TRepository = unknown> = BaseOperation<TInput, TOutput, TInitData> & {
+    /** Query is not allowed with handler */
+    query?: never;
+    /** Custom handler function */
+    handler: OperationHandler<TInput, TOutput, TRepository>;
+};
+/**
+ * Union type for typed operations - must have either query OR handler
+ */
+export type TypedOperation<TInput = DefaultInput, TOutput = unknown, TInitData = unknown, TRepository = unknown> = QueryOperation<TInput, TOutput, TInitData> | HandlerOperation<TInput, TOutput, TInitData, TRepository>;
+//# sourceMappingURL=operation.d.ts.map

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

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