@buenojs/bueno 0.8.9 → 0.8.11

package/dist/graphql/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * GraphQL Module for Bueno Framework
+ *
+ * Code-first GraphQL support with:
+ * - Decorator-based schema definition (@Resolver, @Query, @Mutation, @ObjectType, @Field, etc.)
+ * - Full DI integration (guards, interceptors work on resolvers)
+ * - Pluggable engine (built-in lightweight engine or graphql-js/Yoga via adapter)
+ * - Subscriptions via WebSocket (graphql-transport-ws protocol)
+ * - GraphiQL playground
+ * - Unified types: one class for both GraphQL and REST/OpenAPI (opt-in)
+ *
+ * @example
+ * ```typescript
+ * import { createApp } from '@buenojs/bueno';
+ * import {
+ *   GraphQLModule,
+ *   Resolver, Query, Mutation,
+ *   ObjectType, InputType, Field,
+ *   Args, GqlContext,
+ * } from '@buenojs/bueno/graphql';
+ *
+ * @ObjectType()
+ * class User {
+ *   @Field(() => String) id: string;
+ *   @Field(() => String) name: string;
+ * }
+ *
+ * @Resolver()
+ * class UserResolver {
+ *   @Query(() => [User])
+ *   users(): User[] { return []; }
+ * }
+ *
+ * const app = createApp(AppModule);
+ * GraphQLModule.setup(app, { resolvers: [UserResolver] });
+ * await app.listen(3000);
+ * ```
+ */
+export { GraphQLModule, GraphQLModuleInstance } from "./graphql-module";
+export { BuiltinGraphQLEngine } from "./built-in-engine";
+export { Resolver, ObjectType, InputType, Field, Query, Mutation, Subscription, Args, GqlContext, } from "./decorators";
+export { GraphQLID, GraphQLInt, GraphQLFloat } from "./types";
+export type { GraphQLEngine, GraphQLContext, GraphQLResult, GraphQLError, GraphQLModuleOptions, GraphQLConfig, TypeFn, FieldDecoratorOptions, FieldOptions, FieldMetadata, ResolverFieldMetadata, ParamMetadata, ResolvedField, ResolvedSchema, ResolverFieldsByType, Constructor, } from "./types";
+export { SchemaBuilder } from "./schema-builder";
+export { buildGraphQLContext } from "./context-builder";
+export { GraphQLForbiddenError } from "./execution-pipeline";
+export { SubscriptionHandler } from "./subscription-handler";
+//# sourceMappingURL=index.d.ts.map

package/dist/graphql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAIxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,UAAU,GACV,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI9D,YAAY,EACX,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,MAAM,EACN,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,WAAW,GACX,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,2CAA2C;AAE3C,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAExE,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,yCAAyC;AAEzC,OAAO,EACN,QAAQ,EACR,UAAU,EACV,SAAS,EACT,KAAK,EACL,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,UAAU,GACV,MAAM,cAAc,CAAC;AAEtB,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAuB9D,qCAAqC;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,sCAAsC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,uCAAuC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,4CAA4C;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/graphql/metadata.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GraphQL Metadata Storage
+ *
+ * Isolated metadata storage using WeakMap, following the same pattern
+ * as src/openapi/metadata.ts and src/modules/metadata.ts.
+ * Fully self-contained — no imports from openapi/ or modules/.
+ */
+import type { Constructor, FieldMetadata, ResolverFieldMetadata, ResolverClassMetadata, TypeClassMetadata, ParamMetadata } from "./types";
+export declare function setGqlClassMetadata(target: Constructor, key: string, value: unknown): void;
+export declare function getGqlClassMetadata<T>(target: Constructor, key: string): T | undefined;
+export declare function setGqlPrototypeMetadata(target: object, key: string, value: unknown): void;
+export declare function getGqlPrototypeMetadata<T>(target: object, key: string): T | undefined;
+export declare function setGqlPropertyMetadata(target: object, propertyKey: string | symbol, value: FieldMetadata): void;
+export declare function getGqlPropertyMetadata(target: object, propertyKey: string | symbol): FieldMetadata | undefined;
+export declare function getGqlPropertyKeys(target: object): string[];
+export declare function getAllGqlPropertyMetadata(target: object): FieldMetadata[];
+export declare const GQL_RESOLVER_KEY = "gql:resolver";
+export declare const GQL_OBJECTTYPE_KEY = "gql:objecttype";
+export declare const GQL_INPUTTYPE_KEY = "gql:inputtype";
+export declare const GQL_QUERIES_KEY = "gql:queries";
+export declare const GQL_MUTATIONS_KEY = "gql:mutations";
+export declare const GQL_SUBSCRIPTIONS_KEY = "gql:subscriptions";
+export declare const GQL_PARAMS_PREFIX = "gql:params:";
+export declare function getResolverMetadata(target: Constructor): ResolverClassMetadata | undefined;
+export declare function setResolverMetadata(target: Constructor, metadata: ResolverClassMetadata): void;
+export declare function getTypeMetadata(target: Constructor): TypeClassMetadata | undefined;
+export declare function setObjectTypeMetadata(target: Constructor, metadata: TypeClassMetadata): void;
+export declare function setInputTypeMetadata(target: Constructor, metadata: TypeClassMetadata): void;
+export declare function addQueryField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function addMutationField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function addSubscriptionField(prototype: object, field: ResolverFieldMetadata): void;
+export declare function getQueryFields(prototype: object): ResolverFieldMetadata[];
+export declare function getMutationFields(prototype: object): ResolverFieldMetadata[];
+export declare function getSubscriptionFields(prototype: object): ResolverFieldMetadata[];
+export declare function setParamMetadata(prototype: object, methodName: string, paramIndex: number, meta: ParamMetadata): void;
+export declare function getParamMetadata(prototype: object, methodName: string): ParamMetadata[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/graphql/metadata.d.ts.map

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

package/dist/graphql/metadata.js

@@ -0,0 +1,130 @@
+/**
+ * GraphQL Metadata Storage
+ *
+ * Isolated metadata storage using WeakMap, following the same pattern
+ * as src/openapi/metadata.ts and src/modules/metadata.ts.
+ * Fully self-contained — no imports from openapi/ or modules/.
+ */
+// ============= Class-Level Metadata =============
+// Stores @Resolver, @ObjectType, @InputType metadata keyed by class constructor
+const classMetadataStore = new WeakMap();
+export function setGqlClassMetadata(target, key, value) {
+    if (!classMetadataStore.has(target)) {
+        classMetadataStore.set(target, new Map());
+    }
+    classMetadataStore.get(target)?.set(key, value);
+}
+export function getGqlClassMetadata(target, key) {
+    return classMetadataStore.get(target)?.get(key);
+}
+// ============= Prototype-Level Metadata =============
+// Stores @Query, @Mutation, @Subscription, @Args metadata keyed by class prototype
+const prototypeMetadataStore = new WeakMap();
+export function setGqlPrototypeMetadata(target, key, value) {
+    if (!prototypeMetadataStore.has(target)) {
+        prototypeMetadataStore.set(target, new Map());
+    }
+    prototypeMetadataStore.get(target)?.set(key, value);
+}
+export function getGqlPrototypeMetadata(target, key) {
+    return prototypeMetadataStore.get(target)?.get(key);
+}
+// ============= Property-Level Metadata =============
+// Stores @Field metadata keyed by class prototype + property name
+const propertyMetadataStore = new WeakMap();
+export function setGqlPropertyMetadata(target, propertyKey, value) {
+    if (!propertyMetadataStore.has(target)) {
+        propertyMetadataStore.set(target, new Map());
+    }
+    const key = typeof propertyKey === "symbol" ? propertyKey.toString() : propertyKey;
+    propertyMetadataStore.get(target)?.set(key, value);
+}
+export function getGqlPropertyMetadata(target, propertyKey) {
+    const key = typeof propertyKey === "symbol" ? propertyKey.toString() : propertyKey;
+    return propertyMetadataStore.get(target)?.get(key);
+}
+export function getGqlPropertyKeys(target) {
+    const map = propertyMetadataStore.get(target);
+    if (!map)
+        return [];
+    return Array.from(map.keys());
+}
+export function getAllGqlPropertyMetadata(target) {
+    const map = propertyMetadataStore.get(target);
+    if (!map)
+        return [];
+    return Array.from(map.values());
+}
+// ============= Typed Helpers =============
+// Metadata keys
+export const GQL_RESOLVER_KEY = "gql:resolver";
+export const GQL_OBJECTTYPE_KEY = "gql:objecttype";
+export const GQL_INPUTTYPE_KEY = "gql:inputtype";
+export const GQL_QUERIES_KEY = "gql:queries";
+export const GQL_MUTATIONS_KEY = "gql:mutations";
+export const GQL_SUBSCRIPTIONS_KEY = "gql:subscriptions";
+export const GQL_PARAMS_PREFIX = "gql:params:";
+// ============= Resolver metadata helpers =============
+export function getResolverMetadata(target) {
+    return getGqlClassMetadata(target, GQL_RESOLVER_KEY);
+}
+export function setResolverMetadata(target, metadata) {
+    setGqlClassMetadata(target, GQL_RESOLVER_KEY, metadata);
+}
+// ============= Object/Input type metadata helpers =============
+export function getTypeMetadata(target) {
+    return (getGqlClassMetadata(target, GQL_OBJECTTYPE_KEY) ??
+        getGqlClassMetadata(target, GQL_INPUTTYPE_KEY));
+}
+export function setObjectTypeMetadata(target, metadata) {
+    setGqlClassMetadata(target, GQL_OBJECTTYPE_KEY, metadata);
+}
+export function setInputTypeMetadata(target, metadata) {
+    setGqlClassMetadata(target, GQL_INPUTTYPE_KEY, metadata);
+}
+// ============= Resolver field metadata helpers =============
+function getResolverFields(prototype, key) {
+    return getGqlPrototypeMetadata(prototype, key) ?? [];
+}
+function addResolverField(prototype, key, field) {
+    const existing = getResolverFields(prototype, key);
+    // Replace if methodName already exists (decorator applied multiple times)
+    const idx = existing.findIndex((f) => f.methodName === field.methodName);
+    if (idx >= 0) {
+        existing[idx] = field;
+    }
+    else {
+        existing.push(field);
+    }
+    setGqlPrototypeMetadata(prototype, key, existing);
+}
+export function addQueryField(prototype, field) {
+    addResolverField(prototype, GQL_QUERIES_KEY, field);
+}
+export function addMutationField(prototype, field) {
+    addResolverField(prototype, GQL_MUTATIONS_KEY, field);
+}
+export function addSubscriptionField(prototype, field) {
+    addResolverField(prototype, GQL_SUBSCRIPTIONS_KEY, field);
+}
+export function getQueryFields(prototype) {
+    return getResolverFields(prototype, GQL_QUERIES_KEY);
+}
+export function getMutationFields(prototype) {
+    return getResolverFields(prototype, GQL_MUTATIONS_KEY);
+}
+export function getSubscriptionFields(prototype) {
+    return getResolverFields(prototype, GQL_SUBSCRIPTIONS_KEY);
+}
+// ============= Parameter metadata helpers =============
+export function setParamMetadata(prototype, methodName, paramIndex, meta) {
+    const key = `${GQL_PARAMS_PREFIX}${methodName}`;
+    const existing = getGqlPrototypeMetadata(prototype, key) ?? [];
+    existing[paramIndex] = meta;
+    setGqlPrototypeMetadata(prototype, key, existing);
+}
+export function getParamMetadata(prototype, methodName) {
+    const key = `${GQL_PARAMS_PREFIX}${methodName}`;
+    return getGqlPrototypeMetadata(prototype, key) ?? [];
+}
+//# sourceMappingURL=metadata.js.map

package/dist/graphql/metadata.js.map

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

package/dist/graphql/schema-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Schema Builder
+ *
+ * Reads GraphQL decorator metadata from resolver and type classes,
+ * generates SDL (Schema Definition Language), and builds the internal
+ * ResolvedSchema used by the built-in engine.
+ */
+import type { Constructor, TypeFn, FieldMetadata, ResolvedSchema, ResolverFieldsByType } from "./types";
+/** Map JS constructors to GraphQL scalar names */
+export declare function typeFnToScalarName(typeFn: TypeFn): string | null;
+/** Convert a TypeFn to an SDL type string */
+export declare function typeFnToSDL(typeFn: TypeFn, nullable: boolean): string;
+export interface BuiltSchema {
+    sdl: string;
+    resolvedSchema: ResolvedSchema;
+    resolverFields: ResolverFieldsByType;
+    typeFields: Map<string, FieldMetadata[]>;
+}
+export declare class SchemaBuilder {
+    private resolverClasses;
+    private resolverInstances;
+    private typeClasses;
+    constructor(resolverClasses: Constructor[], resolverInstances: Map<Constructor, unknown>);
+    build(): BuiltSchema;
+    private toResolvedField;
+    private collectReturnType;
+    private collectNestedTypes;
+    private buildTypeFields;
+    private generateSDL;
+    private buildArgsSDL;
+}
+export declare function registerTypeClass(ctor: Constructor): void;
+export declare function getRegisteredTypeClasses(): Constructor[];
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/graphql/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,MAAM,EACN,aAAa,EAGb,cAAc,EACd,oBAAoB,EAIpB,MAAM,SAAS,CAAC;AAejB,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhE;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAkBrE;AAID,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,oBAAoB,CAAC;IACrC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CACzC;AAED,qBAAa,aAAa;IAKxB,OAAO,CAAC,eAAe;IAJxB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,WAAW,CAA+B;gBAGzC,eAAe,EAAE,WAAW,EAAE,EACtC,iBAAiB,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC;IAK7C,KAAK,IAAI,WAAW;IAoDpB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;IA6EnB,OAAO,CAAC,YAAY;CA6BpB;AAOD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEzD;AAED,wBAAgB,wBAAwB,IAAI,WAAW,EAAE,CAExD"}

package/dist/graphql/schema-builder.js

@@ -0,0 +1,251 @@
+/**
+ * Schema Builder
+ *
+ * Reads GraphQL decorator metadata from resolver and type classes,
+ * generates SDL (Schema Definition Language), and builds the internal
+ * ResolvedSchema used by the built-in engine.
+ */
+import { getTypeMetadata, getQueryFields, getMutationFields, getSubscriptionFields, getAllGqlPropertyMetadata, } from "./metadata";
+// ============= Scalar Helpers =============
+/** Map JS constructors to GraphQL scalar names */
+export function typeFnToScalarName(typeFn) {
+    const type = typeFn();
+    const resolved = Array.isArray(type) ? type[0] : type;
+    if (resolved === String)
+        return "String";
+    if (resolved === Number)
+        return "Float";
+    if (resolved === Boolean)
+        return "Boolean";
+    // Check sentinel classes by name (avoids import cycle)
+    const name = resolved.name;
+    if (name === "GraphQLID")
+        return "ID";
+    if (name === "GraphQLInt")
+        return "Int";
+    if (name === "GraphQLFloat")
+        return "Float";
+    return null;
+}
+/** Convert a TypeFn to an SDL type string */
+export function typeFnToSDL(typeFn, nullable) {
+    const type = typeFn();
+    const isArray = Array.isArray(type);
+    const inner = isArray ? type[0] : type;
+    let innerName;
+    const scalarName = typeFnToScalarName(() => inner);
+    if (scalarName) {
+        innerName = scalarName;
+    }
+    else {
+        // Use the class name for object / input types
+        innerName = inner.name;
+        // Strip any __type marker (for sentinel classes already handled above)
+    }
+    // Inner type is always non-null (items in list are non-null)
+    const innerSdl = isArray ? `[${innerName}!]` : innerName;
+    return nullable ? innerSdl : `${innerSdl}!`;
+}
+export class SchemaBuilder {
+    resolverClasses;
+    resolverInstances;
+    typeClasses = new Set();
+    constructor(resolverClasses, resolverInstances) {
+        this.resolverClasses = resolverClasses;
+        this.resolverInstances = resolverInstances;
+    }
+    build() {
+        // Collect query/mutation/subscription fields across all resolvers
+        const queries = new Map();
+        const mutations = new Map();
+        const subscriptions = new Map();
+        for (const ResolverClass of this.resolverClasses) {
+            const instance = this.resolverInstances.get(ResolverClass);
+            const qFields = getQueryFields(ResolverClass.prototype);
+            for (const f of qFields) {
+                queries.set(f.fieldName, this.toResolvedField(f, instance));
+                this.collectReturnType(f.typeFn);
+            }
+            const mFields = getMutationFields(ResolverClass.prototype);
+            for (const f of mFields) {
+                mutations.set(f.fieldName, this.toResolvedField(f, instance));
+                this.collectReturnType(f.typeFn);
+            }
+            const sFields = getSubscriptionFields(ResolverClass.prototype);
+            for (const f of sFields) {
+                subscriptions.set(f.fieldName, this.toResolvedField(f, instance));
+                this.collectReturnType(f.typeFn);
+            }
+        }
+        // Also collect types referenced from @Field decorators
+        this.collectNestedTypes();
+        // Build type field map
+        const typeFields = this.buildTypeFields();
+        // Generate SDL
+        const sdl = this.generateSDL(queries, mutations, subscriptions, typeFields);
+        const resolverFields = {
+            queries,
+            mutations,
+            subscriptions,
+        };
+        const resolvedSchema = {
+            queryFields: queries,
+            mutationFields: mutations,
+            subscriptionFields: subscriptions,
+        };
+        return { sdl, resolvedSchema, resolverFields, typeFields };
+    }
+    toResolvedField(field, instance) {
+        return {
+            resolverInstance: instance,
+            methodName: field.methodName,
+            paramMetadata: field.paramMetadata,
+            typeFn: field.typeFn,
+            nullable: field.nullable,
+        };
+    }
+    collectReturnType(typeFn) {
+        const type = typeFn();
+        const resolved = Array.isArray(type) ? type[0] : type;
+        if (typeof resolved === "function") {
+            const meta = getTypeMetadata(resolved);
+            if (meta) {
+                this.typeClasses.add(resolved);
+            }
+        }
+    }
+    collectNestedTypes() {
+        // Iterate type classes and collect nested types from @Field typeFns
+        let changed = true;
+        while (changed) {
+            changed = false;
+            for (const TypeClass of Array.from(this.typeClasses)) {
+                const fields = getAllGqlPropertyMetadata(TypeClass.prototype);
+                for (const field of fields) {
+                    const type = field.typeFn();
+                    const inner = Array.isArray(type) ? type[0] : type;
+                    if (typeof inner === "function") {
+                        const meta = getTypeMetadata(inner);
+                        if (meta && !this.typeClasses.has(inner)) {
+                            this.typeClasses.add(inner);
+                            changed = true;
+                        }
+                    }
+                }
+            }
+        }
+    }
+    buildTypeFields() {
+        const result = new Map();
+        for (const TypeClass of this.typeClasses) {
+            const meta = getTypeMetadata(TypeClass);
+            if (!meta)
+                continue;
+            const fields = getAllGqlPropertyMetadata(TypeClass.prototype);
+            result.set(meta.name, fields);
+        }
+        return result;
+    }
+    generateSDL(queries, mutations, subscriptions, typeFields) {
+        const lines = [];
+        // Object types and input types
+        for (const TypeClass of this.typeClasses) {
+            const meta = getTypeMetadata(TypeClass);
+            if (!meta)
+                continue;
+            const fields = getAllGqlPropertyMetadata(TypeClass.prototype);
+            if (fields.length === 0)
+                continue;
+            const keyword = meta.kind === "input" ? "input" : "type";
+            if (meta.description) {
+                lines.push(`"""${meta.description}"""`);
+            }
+            lines.push(`${keyword} ${meta.name} {`);
+            for (const f of fields) {
+                if (f.description) {
+                    lines.push(`  """${f.description}"""`);
+                }
+                const typeSdl = typeFnToSDL(f.typeFn, f.nullable);
+                let fieldLine = `  ${f.propertyKey}: ${typeSdl}`;
+                if (f.defaultValue !== undefined) {
+                    fieldLine += ` = ${JSON.stringify(f.defaultValue)}`;
+                }
+                lines.push(fieldLine);
+                if (f.deprecationReason) {
+                    lines[lines.length - 1] += ` @deprecated(reason: "${f.deprecationReason}")`;
+                }
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Query type
+        if (queries.size > 0) {
+            lines.push("type Query {");
+            for (const [fieldName, field] of queries) {
+                const args = this.buildArgsSDL(fieldName, queries);
+                const typeSdl = typeFnToSDL(field.typeFn, field.nullable);
+                lines.push(`  ${fieldName}${args}: ${typeSdl}`);
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Mutation type
+        if (mutations.size > 0) {
+            lines.push("type Mutation {");
+            for (const [fieldName, field] of mutations) {
+                const args = this.buildArgsSDL(fieldName, mutations);
+                const typeSdl = typeFnToSDL(field.typeFn, field.nullable);
+                lines.push(`  ${fieldName}${args}: ${typeSdl}`);
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        // Subscription type
+        if (subscriptions.size > 0) {
+            lines.push("type Subscription {");
+            for (const [fieldName, field] of subscriptions) {
+                const typeSdl = typeFnToSDL(field.typeFn, field.nullable);
+                lines.push(`  ${fieldName}: ${typeSdl}`);
+            }
+            lines.push("}");
+            lines.push("");
+        }
+        return lines.join("\n").trim();
+    }
+    buildArgsSDL(fieldName, fields) {
+        const field = fields.get(fieldName);
+        if (!field || field.paramMetadata.length === 0)
+            return "";
+        const args = [];
+        for (const param of field.paramMetadata) {
+            if (param.kind === "context")
+                continue;
+            if (param.kind === "args" && param.argName) {
+                // We don't know the type from paramMetadata alone for SDL args.
+                // For simple scalars this would need annotation — skip for now
+                // (built-in engine resolves by name from incoming args object)
+                continue;
+            }
+            if (param.kind === "argsObject" && param.inputTypeFn) {
+                const inputType = param.inputTypeFn();
+                const typeName = Array.isArray(inputType)
+                    ? inputType[0].name
+                    : inputType.name;
+                if (param.argName) {
+                    args.push(`${param.argName}: ${typeName}!`);
+                }
+            }
+        }
+        return args.length > 0 ? `(${args.join(", ")})` : "";
+    }
+}
+// ============= Registry of known @ObjectType / @InputType classes =============
+// Global registry populated by @ObjectType / @InputType at decoration time
+const registeredTypeClasses = new Set();
+export function registerTypeClass(ctor) {
+    registeredTypeClasses.add(ctor);
+}
+export function getRegisteredTypeClasses() {
+    return Array.from(registeredTypeClasses);
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/graphql/schema-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.js","sourceRoot":"","sources":["../../src/graphql/schema-builder.ts"],"names":[],"mappings":"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"}

package/dist/graphql/subscription-handler.d.ts

@@ -0,0 +1,47 @@
+/**
+ * GraphQL Subscription Handler
+ *
+ * Implements the graphql-transport-ws protocol over Bun's native WebSocket.
+ * Registered via app.setWebSocketHandler() so subscriptions run on the same
+ * port as the HTTP server — no separate port needed.
+ *
+ * Protocol spec: https://github.com/enisdenjo/graphql-ws/blob/master/PROTOCOL.md
+ *
+ * ## Usage
+ * Automatically configured by GraphQLModule.setup() when subscriptions: true.
+ * Requires an engine with supportsSubscriptions = true (e.g. GraphQLJsAdapter).
+ */
+import type { GraphQLEngine } from "./types";
+import type { Container } from "../container";
+import type { Guard, Interceptor } from "./execution-pipeline";
+interface WsData {
+    connectionId: string;
+}
+export declare class SubscriptionHandler {
+    private engine;
+    private engineSchema;
+    private graphqlPath;
+    private container;
+    private globalGuards;
+    private globalInterceptors;
+    private connections;
+    constructor(engine: GraphQLEngine, engineSchema: unknown, graphqlPath: string, container: Container, globalGuards: Guard[], globalInterceptors: Interceptor[]);
+    /**
+     * Returns a Bun WebSocketHandler to register on the server via app.setWebSocketHandler().
+     * Attaches an __upgradeHandler so Application.listen() can delegate WebSocket upgrades.
+     */
+    getWebSocketConfig(): Bun.WebSocketHandler<WsData> & {
+        __upgradeHandler: (req: Request, srv: Bun.Server) => Response | undefined;
+    };
+    /**
+     * Middleware-like upgrade handler.
+     * Call this from the app's fetch function for WebSocket upgrade requests.
+     * Returns a Response if not a GraphQL WS path, undefined if upgraded.
+     */
+    handleUpgrade(req: Request, server: Bun.Server): Response | undefined;
+    private handleMessage;
+    private handleSubscribe;
+    private send;
+}
+export {};
+//# sourceMappingURL=subscription-handler.d.ts.map

package/dist/graphql/subscription-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-handler.d.ts","sourceRoot":"","sources":["../../src/graphql/subscription-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAkC,MAAM,SAAS,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAoD/D,UAAU,MAAM;IACf,YAAY,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,mBAAmB;IAI9B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,kBAAkB;IAR3B,OAAO,CAAC,WAAW,CAAsC;gBAGhD,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,OAAO,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,KAAK,EAAE,EACrB,kBAAkB,EAAE,WAAW,EAAE;IAG1C;;;OAGG;IACH,kBAAkB,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG;QAAE,gBAAgB,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAA;KAAE;IA2ClI;;;;OAIG;IACH,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,SAAS;YAwBvD,aAAa;YA0Cb,eAAe;IAuE7B,OAAO,CAAC,IAAI;CAOZ"}