@cosmneo/onion-lasagna 0.3.0 → 0.4.0

package/dist/{chunk-XWKHOLIP.js → chunk-4HMXTGHK.js}

@@ -1,6 +1,6 @@
 import {
   mapErrorToEventResult
-} from "./chunk-4BVOLXDJ.js";
+} from "./chunk-4YBAV6LZ.js";
 import {
   collectEventHandlers,
   generateHandlerId,
@@ -188,4 +188,4 @@ export {
   isSimpleEventHandlerConfig,
   eventRoutes
 };
-//# sourceMappingURL=chunk-XWKHOLIP.js.map
+//# sourceMappingURL=chunk-4HMXTGHK.js.map

package/dist/chunk-4RFWJ5XZ.js

@@ -0,0 +1,192 @@
+import {
+  collectFields,
+  generateFieldId,
+  isSchemaDefinition
+} from "./chunk-BG2FY27M.js";
+
+// src/presentation/graphql/sdl/generate.ts
+function generateGraphQLSDL(schema, config) {
+  const fields = isSchemaDefinition(schema) ? schema.fields : schema;
+  const collectedFields = collectFields(fields);
+  const includeDescriptions = config?.includeDescriptions ?? true;
+  const includeDeprecations = config?.includeDeprecations ?? true;
+  const queries = [];
+  const mutations = [];
+  const subscriptions = [];
+  for (const { key, field } of collectedFields) {
+    const fieldId = generateFieldId(key);
+    if (field.operation === "query") {
+      queries.push({ fieldId, field });
+    } else if (field.operation === "mutation") {
+      mutations.push({ fieldId, field });
+    } else if (field.operation === "subscription") {
+      subscriptions.push({ fieldId, field });
+    }
+  }
+  const namedTypes = /* @__PURE__ */ new Map();
+  const lines = [];
+  if (config?.preamble) {
+    lines.push(config.preamble);
+    lines.push("");
+  }
+  if (queries.length > 0) {
+    lines.push("type Query {");
+    for (const { fieldId, field } of queries) {
+      const fieldLine = buildFieldLine(
+        fieldId,
+        field,
+        namedTypes,
+        includeDescriptions,
+        includeDeprecations
+      );
+      lines.push(fieldLine);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  if (mutations.length > 0) {
+    lines.push("type Mutation {");
+    for (const { fieldId, field } of mutations) {
+      const fieldLine = buildFieldLine(
+        fieldId,
+        field,
+        namedTypes,
+        includeDescriptions,
+        includeDeprecations
+      );
+      lines.push(fieldLine);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  if (subscriptions.length > 0) {
+    lines.push("type Subscription {");
+    for (const { fieldId, field } of subscriptions) {
+      const fieldLine = buildFieldLine(
+        fieldId,
+        field,
+        namedTypes,
+        includeDescriptions,
+        includeDeprecations
+      );
+      lines.push(fieldLine);
+    }
+    lines.push("}");
+    lines.push("");
+  }
+  for (const [, typeBody] of namedTypes) {
+    lines.push(typeBody);
+    lines.push("");
+  }
+  return lines.join("\n").trimEnd() + "\n";
+}
+function buildFieldLine(fieldId, field, namedTypes, includeDescriptions, includeDeprecations) {
+  const parts = [];
+  if (includeDescriptions && field.docs.description) {
+    const escaped = field.docs.description.replace(/"""/g, '\\"""');
+    parts.push(`  """${escaped}"""`);
+  }
+  const inputTypeName = field.input ? `${capitalize(fieldId)}Input` : void 0;
+  const outputTypeName = field.output ? `${capitalize(fieldId)}Output` : void 0;
+  if (field.input && inputTypeName) {
+    const jsonSchema = field.input.toJsonSchema();
+    namedTypes.set(inputTypeName, buildInputType(inputTypeName, jsonSchema));
+  }
+  if (field.output && outputTypeName) {
+    const jsonSchema = field.output.toJsonSchema();
+    namedTypes.set(outputTypeName, buildOutputType(outputTypeName, jsonSchema));
+  }
+  let signature = `  ${fieldId}`;
+  if (inputTypeName) {
+    signature += `(input: ${inputTypeName}!)`;
+  }
+  signature += ": ";
+  signature += outputTypeName ?? "JSON";
+  if (includeDeprecations && field.docs.deprecated) {
+    const reason = field.docs.deprecationReason;
+    signature += reason ? ` @deprecated(reason: "${escapeSDLString(reason)}")` : " @deprecated";
+  }
+  if (parts.length > 0) {
+    return parts.join("\n") + "\n" + signature;
+  }
+  return signature;
+}
+function buildInputType(typeName, jsonSchema) {
+  const lines = [`input ${typeName} {`];
+  if (jsonSchema.properties && typeof jsonSchema.properties === "object") {
+    const required = new Set(
+      Array.isArray(jsonSchema.required) ? jsonSchema.required : []
+    );
+    for (const [propName, propSchema] of Object.entries(
+      jsonSchema.properties
+    )) {
+      const graphqlType = jsonSchemaToGraphQLType(propSchema);
+      const isRequired = required.has(propName);
+      lines.push(`  ${propName}: ${graphqlType}${isRequired ? "!" : ""}`);
+    }
+  }
+  lines.push("}");
+  return lines.join("\n");
+}
+function buildOutputType(typeName, jsonSchema) {
+  const lines = [`type ${typeName} {`];
+  if (jsonSchema.properties && typeof jsonSchema.properties === "object") {
+    const required = new Set(
+      Array.isArray(jsonSchema.required) ? jsonSchema.required : []
+    );
+    for (const [propName, propSchema] of Object.entries(
+      jsonSchema.properties
+    )) {
+      const graphqlType = jsonSchemaToGraphQLType(propSchema);
+      const isRequired = required.has(propName);
+      lines.push(`  ${propName}: ${graphqlType}${isRequired ? "!" : ""}`);
+    }
+  }
+  lines.push("}");
+  return lines.join("\n");
+}
+function jsonSchemaToGraphQLType(schema) {
+  if (!schema || typeof schema !== "object") return "JSON";
+  if (schema.enum && Array.isArray(schema.enum)) {
+    return "String";
+  }
+  const type = schema.type;
+  switch (type) {
+    case "string":
+      return "String";
+    case "integer":
+      return "Int";
+    case "number":
+      return "Float";
+    case "boolean":
+      return "Boolean";
+    case "array": {
+      const items = schema.items;
+      if (items) {
+        return `[${jsonSchemaToGraphQLType(items)}]`;
+      }
+      return "[JSON]";
+    }
+    case "object":
+      return "JSON";
+    default:
+      if (schema.oneOf || schema.anyOf || schema.allOf) {
+        return "JSON";
+      }
+      if (schema.properties) {
+        return "JSON";
+      }
+      return "JSON";
+  }
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function escapeSDLString(str) {
+  return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+}
+
+export {
+  generateGraphQLSDL
+};
+//# sourceMappingURL=chunk-4RFWJ5XZ.js.map

package/dist/chunk-4RFWJ5XZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/graphql/sdl/generate.ts"],"sourcesContent":["/**\n * @fileoverview GraphQL SDL generation from schema definitions.\n *\n * The `generateGraphQLSDL` function creates a complete GraphQL Schema\n * Definition Language string from a schema definition.\n *\n * Input/output schemas are converted to JSON Schema via `toJsonSchema()`,\n * then mapped to GraphQL type definitions.\n *\n * @module graphql/sdl/generate\n */\n\nimport type { SchemaAdapter, JsonSchema } from '../../http/schema/types';\nimport type {\n  GraphQLSchemaConfig,\n  GraphQLSchemaDefinition,\n  GraphQLFieldDefinition,\n} from '../field/types';\nimport { isSchemaDefinition, collectFields } from '../field/types';\nimport { generateFieldId } from '../field/utils';\nimport type { GraphQLSDLConfig } from './types';\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Generates a GraphQL SDL string from a schema definition.\n *\n * Walks the schema structure, extracts JSON schemas from all field\n * definitions, and builds a complete SDL with Query, Mutation, and\n * type definitions.\n *\n * @param schema - Schema definition or schema config\n * @param config - Optional SDL generation configuration\n * @returns Complete GraphQL SDL string\n *\n * @example Basic usage\n * ```typescript\n * import { generateGraphQLSDL } from '@cosmneo/onion-lasagna/graphql/sdl';\n *\n * const sdl = generateGraphQLSDL(projectSchema, {\n *   preamble: 'scalar DateTime',\n * });\n *\n * console.log(sdl);\n * // type Query {\n * //   projectsGet(input: ProjectsGetInput!): ProjectsGetOutput\n * //   projectsList: ProjectsListOutput\n * // }\n * // ...\n * ```\n */\nexport function generateGraphQLSDL<T extends GraphQLSchemaConfig>(\n  schema: T | GraphQLSchemaDefinition<T>,\n  config?: GraphQLSDLConfig,\n): string {\n  const fields = isSchemaDefinition(schema) ? schema.fields : schema;\n  const collectedFields = collectFields(fields);\n\n  const includeDescriptions = config?.includeDescriptions ?? true;\n  const includeDeprecations = config?.includeDeprecations ?? true;\n\n  // Partition fields by operation type\n  const queries: { fieldId: string; field: GraphQLFieldDefinition }[] = [];\n  const mutations: { fieldId: string; field: GraphQLFieldDefinition }[] = [];\n  const subscriptions: { fieldId: string; field: GraphQLFieldDefinition }[] = [];\n\n  for (const { key, field } of collectedFields) {\n    const fieldId = generateFieldId(key);\n    if (field.operation === 'query') {\n      queries.push({ fieldId, field });\n    } else if (field.operation === 'mutation') {\n      mutations.push({ fieldId, field });\n    } else if (field.operation === 'subscription') {\n      subscriptions.push({ fieldId, field });\n    }\n  }\n\n  // Collect all named types that need to be emitted\n  const namedTypes: Map<string, string> = new Map();\n  const lines: string[] = [];\n\n  // Preamble\n  if (config?.preamble) {\n    lines.push(config.preamble);\n    lines.push('');\n  }\n\n  // Build Query type\n  if (queries.length > 0) {\n    lines.push('type Query {');\n    for (const { fieldId, field } of queries) {\n      const fieldLine = buildFieldLine(\n        fieldId,\n        field,\n        namedTypes,\n        includeDescriptions,\n        includeDeprecations,\n      );\n      lines.push(fieldLine);\n    }\n    lines.push('}');\n    lines.push('');\n  }\n\n  // Build Mutation type\n  if (mutations.length > 0) {\n    lines.push('type Mutation {');\n    for (const { fieldId, field } of mutations) {\n      const fieldLine = buildFieldLine(\n        fieldId,\n        field,\n        namedTypes,\n        includeDescriptions,\n        includeDeprecations,\n      );\n      lines.push(fieldLine);\n    }\n    lines.push('}');\n    lines.push('');\n  }\n\n  // Build Subscription type\n  if (subscriptions.length > 0) {\n    lines.push('type Subscription {');\n    for (const { fieldId, field } of subscriptions) {\n      const fieldLine = buildFieldLine(\n        fieldId,\n        field,\n        namedTypes,\n        includeDescriptions,\n        includeDeprecations,\n      );\n      lines.push(fieldLine);\n    }\n    lines.push('}');\n    lines.push('');\n  }\n\n  // Emit named types (inputs and outputs)\n  for (const [, typeBody] of namedTypes) {\n    lines.push(typeBody);\n    lines.push('');\n  }\n\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\n/**\n * Builds a single field line for a root type (Query/Mutation/Subscription).\n */\nfunction buildFieldLine(\n  fieldId: string,\n  field: GraphQLFieldDefinition,\n  namedTypes: Map<string, string>,\n  includeDescriptions: boolean,\n  includeDeprecations: boolean,\n): string {\n  const parts: string[] = [];\n\n  // Description as SDL doc string (escaped to prevent triple-quote injection)\n  if (includeDescriptions && field.docs.description) {\n    const escaped = field.docs.description.replace(/\"\"\"/g, '\\\\\"\"\"');\n    parts.push(`  \"\"\"${escaped}\"\"\"`);\n  }\n\n  // Build args and return type\n  const inputTypeName = field.input ? `${capitalize(fieldId)}Input` : undefined;\n  const outputTypeName = field.output ? `${capitalize(fieldId)}Output` : undefined;\n\n  // Register named input type\n  if (field.input && inputTypeName) {\n    const jsonSchema = (field.input as SchemaAdapter).toJsonSchema();\n    namedTypes.set(inputTypeName, buildInputType(inputTypeName, jsonSchema));\n  }\n\n  // Register named output type\n  if (field.output && outputTypeName) {\n    const jsonSchema = (field.output as SchemaAdapter).toJsonSchema();\n    namedTypes.set(outputTypeName, buildOutputType(outputTypeName, jsonSchema));\n  }\n\n  // Build field signature\n  let signature = `  ${fieldId}`;\n\n  if (inputTypeName) {\n    signature += `(input: ${inputTypeName}!)`;\n  }\n\n  signature += ': ';\n  signature += outputTypeName ?? 'JSON';\n\n  // Deprecation directive\n  if (includeDeprecations && field.docs.deprecated) {\n    const reason = field.docs.deprecationReason;\n    signature += reason ? ` @deprecated(reason: \"${escapeSDLString(reason)}\")` : ' @deprecated';\n  }\n\n  if (parts.length > 0) {\n    return parts.join('\\n') + '\\n' + signature;\n  }\n  return signature;\n}\n\n/**\n * Builds a GraphQL input type from a JSON schema.\n */\nfunction buildInputType(typeName: string, jsonSchema: JsonSchema): string {\n  const lines: string[] = [`input ${typeName} {`];\n\n  if (jsonSchema.properties && typeof jsonSchema.properties === 'object') {\n    const required = new Set(\n      Array.isArray(jsonSchema.required) ? (jsonSchema.required as string[]) : [],\n    );\n\n    for (const [propName, propSchema] of Object.entries(\n      jsonSchema.properties as Record<string, JsonSchema>,\n    )) {\n      const graphqlType = jsonSchemaToGraphQLType(propSchema);\n      const isRequired = required.has(propName);\n      lines.push(`  ${propName}: ${graphqlType}${isRequired ? '!' : ''}`);\n    }\n  }\n\n  lines.push('}');\n  return lines.join('\\n');\n}\n\n/**\n * Builds a GraphQL output type from a JSON schema.\n */\nfunction buildOutputType(typeName: string, jsonSchema: JsonSchema): string {\n  const lines: string[] = [`type ${typeName} {`];\n\n  if (jsonSchema.properties && typeof jsonSchema.properties === 'object') {\n    const required = new Set(\n      Array.isArray(jsonSchema.required) ? (jsonSchema.required as string[]) : [],\n    );\n\n    for (const [propName, propSchema] of Object.entries(\n      jsonSchema.properties as Record<string, JsonSchema>,\n    )) {\n      const graphqlType = jsonSchemaToGraphQLType(propSchema);\n      const isRequired = required.has(propName);\n      lines.push(`  ${propName}: ${graphqlType}${isRequired ? '!' : ''}`);\n    }\n  }\n\n  lines.push('}');\n  return lines.join('\\n');\n}\n\n/**\n * Converts a JSON schema to a GraphQL type string.\n */\nfunction jsonSchemaToGraphQLType(schema: JsonSchema): string {\n  if (!schema || typeof schema !== 'object') return 'JSON';\n\n  // Handle enum\n  if (schema.enum && Array.isArray(schema.enum)) {\n    return 'String';\n  }\n\n  // Handle type\n  const type = schema.type as string | undefined;\n\n  switch (type) {\n    case 'string':\n      return 'String';\n    case 'integer':\n      return 'Int';\n    case 'number':\n      return 'Float';\n    case 'boolean':\n      return 'Boolean';\n    case 'array': {\n      const items = schema.items as JsonSchema | undefined;\n      if (items) {\n        return `[${jsonSchemaToGraphQLType(items)}]`;\n      }\n      return '[JSON]';\n    }\n    case 'object':\n      return 'JSON';\n    default:\n      // Handle oneOf, anyOf, allOf — fallback to JSON\n      if (schema.oneOf || schema.anyOf || schema.allOf) {\n        return 'JSON';\n      }\n      // Object without explicit type but has properties\n      if (schema.properties) {\n        return 'JSON';\n      }\n      return 'JSON';\n  }\n}\n\n/**\n * Capitalizes the first letter of a string.\n */\nfunction capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1);\n}\n\n/**\n * Escapes a string for use in SDL quoted string literals.\n * Handles backslashes, quotes, newlines, and triple-quote injection.\n */\nfunction escapeSDLString(str: string): string {\n  return str\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-4BVOLXDJ.js → chunk-4YBAV6LZ.js}

@@ -1,6 +1,6 @@
 import {
   isErrorType
-} from "./chunk-H5TNDC5U.js";
+} from "./chunk-HNEAH6OZ.js";
 
 // src/presentation/events/shared/error-mapping.ts
 var DLQ_ERROR_TYPES = [
@@ -51,4 +51,4 @@ function mapErrorToEventResult(error) {
 export {
   mapErrorToEventResult
 };
-//# sourceMappingURL=chunk-4BVOLXDJ.js.map
+//# sourceMappingURL=chunk-4YBAV6LZ.js.map

package/dist/chunk-ANLXZHUS.js

@@ -0,0 +1,230 @@
+import {
+  collectFields,
+  generateFieldId,
+  isSchemaDefinition
+} from "./chunk-BG2FY27M.js";
+import {
+  UnauthorizedError
+} from "./chunk-T7S574XQ.js";
+import {
+  ObjectValidationError
+} from "./chunk-3BY5RBF2.js";
+
+// src/presentation/graphql/server/types.ts
+function isSimpleGraphQLHandlerConfig(config) {
+  return "handler" in config && typeof config.handler === "function";
+}
+
+// src/presentation/graphql/server/create-graphql-routes.ts
+function createGraphQLRoutesInternal(schema, handlers, options) {
+  const config = isSchemaDefinition(schema) ? schema.fields : schema;
+  const collectedFields = collectFields(config);
+  const result = [];
+  const resolvedOptions = {
+    ...options,
+    validateInput: options?.validateInput ?? true,
+    validateOutput: options?.validateOutput ?? true,
+    allowPartial: options?.allowPartial ?? false
+  };
+  for (const { key, field } of collectedFields) {
+    const handlerConfig = handlers[key];
+    if (!handlerConfig) {
+      if (resolvedOptions.allowPartial) {
+        continue;
+      }
+      throw new Error(
+        `Missing handler for field "${key}". All fields must have a handler configuration.`
+      );
+    }
+    result.push(createFieldHandler(key, field, handlerConfig, resolvedOptions));
+  }
+  return result;
+}
+function createFieldHandler(key, field, config, options) {
+  const middleware = config.middleware ?? [];
+  const globalMiddleware = options?.middleware ?? [];
+  const allMiddleware = [...globalMiddleware, ...middleware];
+  const shouldValidateInput = options.validateInput ?? true;
+  const shouldValidateOutput = options.validateOutput ?? true;
+  return {
+    key,
+    operation: field.operation,
+    metadata: {
+      fieldId: generateFieldId(key),
+      description: field.docs.description,
+      tags: field.docs.tags,
+      deprecated: field.docs.deprecated,
+      deprecationReason: field.docs.deprecationReason
+    },
+    handler: async (rawArgs, rawContext) => {
+      const context = options?.createContext ? options.createContext(rawContext) : rawContext ?? { requestId: generateRequestId() };
+      let validatedContext = context;
+      if (field.context) {
+        const contextResult = validateContextData(field, context);
+        if (!contextResult.success) {
+          throw new UnauthorizedError({
+            message: "Authentication required"
+          });
+        }
+        validatedContext = contextResult.data;
+      }
+      let validatedInput = rawArgs;
+      if (shouldValidateInput && field.input) {
+        const inputResult = validateInputData(field, rawArgs);
+        if (!inputResult.success) {
+          const errors = inputResult.errors ?? [];
+          throw new ObjectValidationError({
+            message: "Input validation failed",
+            validationErrors: errors.map((e) => ({
+              field: e.path.join("."),
+              message: e.message
+            }))
+          });
+        }
+        validatedInput = inputResult.data;
+      }
+      const validatedArgs = {
+        input: validatedInput,
+        raw: rawArgs
+      };
+      const executePipeline = async () => {
+        if (isSimpleGraphQLHandlerConfig(config)) {
+          return config.handler(
+            validatedArgs,
+            validatedContext
+          );
+        } else {
+          const { argsMapper, useCase, responseMapper } = config;
+          const input = argsMapper(
+            validatedArgs,
+            validatedContext
+          );
+          const output = await useCase.execute(input);
+          return responseMapper(output);
+        }
+      };
+      let result;
+      if (allMiddleware.length === 0) {
+        result = await executePipeline();
+      } else {
+        let index = 0;
+        let called = false;
+        const next = async () => {
+          if (index >= allMiddleware.length) {
+            if (called) throw new Error("next() called after pipeline already executed");
+            called = true;
+            return executePipeline();
+          }
+          const currentIndex = index++;
+          const mw = allMiddleware[currentIndex];
+          return mw(rawArgs, context, next);
+        };
+        result = await next();
+      }
+      if (shouldValidateOutput && field.output) {
+        const outputResult = validateOutputData(field, result);
+        if (!outputResult.success) {
+          const details = outputResult.errors?.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+          throw new ObjectValidationError({
+            message: `Output validation failed for field "${key}": ${details}`,
+            validationErrors: (outputResult.errors ?? []).map((e) => ({
+              field: e.path.join("."),
+              message: e.message
+            }))
+          });
+        }
+      }
+      return result;
+    }
+  };
+}
+function validateInputData(field, args) {
+  const schema = field.input;
+  if (!schema) return { success: true, data: args };
+  const result = schema.validate(args);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  const errors = result.issues.map((issue) => ({
+    ...issue,
+    path: ["input", ...issue.path]
+  }));
+  return { success: false, errors };
+}
+function validateOutputData(field, data) {
+  const schema = field.output;
+  if (!schema) return { success: true, data };
+  const result = schema.validate(data);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  const errors = result.issues.map((issue) => ({
+    ...issue,
+    path: ["output", ...issue.path]
+  }));
+  return { success: false, errors };
+}
+function validateContextData(field, context) {
+  const schema = field.context;
+  if (!schema) return { success: true, data: context };
+  const result = schema.validate(context);
+  if (result.success) {
+    return { success: true, data: result.data };
+  }
+  const errors = result.issues.map((issue) => ({
+    ...issue,
+    path: ["context", ...issue.path]
+  }));
+  return { success: false, errors };
+}
+function generateRequestId() {
+  return `gql_${crypto.randomUUID()}`;
+}
+
+// src/presentation/graphql/server/graphql-routes-builder.ts
+var GraphQLRoutesBuilderImpl = class _GraphQLRoutesBuilderImpl {
+  schema;
+  handlers;
+  constructor(schema, handlers) {
+    this.schema = schema;
+    this.handlers = handlers ?? /* @__PURE__ */ new Map();
+  }
+  handle(key, handlerOrConfig) {
+    const config = typeof handlerOrConfig === "function" ? { handler: handlerOrConfig } : handlerOrConfig;
+    const newHandlers = new Map(this.handlers);
+    newHandlers.set(key, config);
+    return new _GraphQLRoutesBuilderImpl(
+      this.schema,
+      newHandlers
+    );
+  }
+  handleWithUseCase(key, config) {
+    const newHandlers = new Map(this.handlers);
+    newHandlers.set(
+      key,
+      config
+    );
+    return new _GraphQLRoutesBuilderImpl(
+      this.schema,
+      newHandlers
+    );
+  }
+  build(options) {
+    return createGraphQLRoutesInternal(this.schema, Object.fromEntries(this.handlers), options);
+  }
+  buildPartial(options) {
+    return createGraphQLRoutesInternal(this.schema, Object.fromEntries(this.handlers), {
+      ...options,
+      allowPartial: true
+    });
+  }
+};
+function graphqlRoutes(schema) {
+  return new GraphQLRoutesBuilderImpl(schema);
+}
+
+export {
+  isSimpleGraphQLHandlerConfig,
+  graphqlRoutes
+};
+//# sourceMappingURL=chunk-ANLXZHUS.js.map

package/dist/chunk-ANLXZHUS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/graphql/server/types.ts","../src/presentation/graphql/server/create-graphql-routes.ts","../src/presentation/graphql/server/graphql-routes-builder.ts"],"sourcesContent":["/**\n * @fileoverview Server types for the GraphQL field system.\n *\n * @module graphql/server/types\n */\n\nimport type { GraphQLFieldDefinition, GraphQLOperationType } from '../field/types';\n\n// Re-export UseCasePort from HTTP — same interface, no duplication\nexport type { UseCasePort } from '../../http/server/types';\n\n// ============================================================================\n// Validated Args\n// ============================================================================\n\n/**\n * Validated arguments with typed data.\n * This is what handlers receive after input validation passes.\n */\nexport interface ValidatedArgs<TField extends GraphQLFieldDefinition> {\n  /** Validated input arguments. */\n  readonly input: TField['_types']['input'];\n\n  /** Raw unvalidated arguments for advanced use cases. */\n  readonly raw: unknown;\n}\n\n/**\n * Typed GraphQL context based on field definition.\n * If the field defines a context schema, this will be the validated type.\n * Otherwise, it falls back to the generic GraphQLHandlerContext.\n */\nexport type TypedGraphQLContext<TField extends GraphQLFieldDefinition> =\n  TField['_types']['context'] extends undefined\n    ? GraphQLHandlerContext\n    : TField['_types']['context'];\n\n// ============================================================================\n// Handler Context\n// ============================================================================\n\n/**\n * Context passed to GraphQL handlers.\n * Can be extended with custom context via graphqlRoutes options.\n */\nexport interface GraphQLHandlerContext {\n  /** Request ID for tracing. */\n  readonly requestId?: string;\n\n  /** Additional context data. */\n  readonly [key: string]: unknown;\n}\n\n// ============================================================================\n// Handler Types\n// ============================================================================\n\n/**\n * Handler configuration using the use case pattern.\n *\n * @typeParam TField - The field definition type\n * @typeParam TInput - Use case input type\n * @typeParam TOutput - Use case output type\n */\nexport interface GraphQLHandlerConfig<\n  TField extends GraphQLFieldDefinition,\n  TInput = void,\n  TOutput = void,\n> {\n  /**\n   * Maps the validated args to use case input.\n   * Both `args` and `ctx` are fully typed based on field schemas.\n   */\n  readonly argsMapper: (args: ValidatedArgs<TField>, ctx: TypedGraphQLContext<TField>) => TInput;\n\n  /** The use case to execute. */\n  readonly useCase: { execute(input?: TInput): Promise<TOutput> };\n\n  /**\n   * Maps the use case output to the GraphQL response.\n   */\n  readonly responseMapper: (output: TOutput) => TField['_types']['output'];\n\n  /** Middleware to run before the handler. */\n  readonly middleware?: readonly GraphQLMiddlewareFunction[];\n}\n\n/**\n * Simple handler function that directly returns the output.\n * Use this for query and mutation fields.\n */\nexport type SimpleGraphQLHandlerFn<TField extends GraphQLFieldDefinition> = (\n  args: ValidatedArgs<TField>,\n  ctx: TypedGraphQLContext<TField>,\n) => Promise<TField['_types']['output']> | TField['_types']['output'];\n\n/**\n * Subscription handler function that returns an async iterable.\n * Each yielded value is sent to the subscriber.\n */\nexport type SimpleGraphQLSubscriptionFn<TField extends GraphQLFieldDefinition> = (\n  args: ValidatedArgs<TField>,\n  ctx: TypedGraphQLContext<TField>,\n) => AsyncIterable<TField['_types']['output']>;\n\n/**\n * Configuration for a simple handler (no use case).\n */\nexport interface SimpleGraphQLHandlerConfig<TField extends GraphQLFieldDefinition> {\n  readonly handler: SimpleGraphQLHandlerFn<TField>;\n  readonly middleware?: readonly GraphQLMiddlewareFunction[];\n}\n\n/**\n * Union of all handler config types.\n * Used internally to store handlers in the builder.\n */\nexport type AnyGraphQLHandlerConfig<\n  TField extends GraphQLFieldDefinition,\n  TInput = unknown,\n  TOutput = unknown,\n> = GraphQLHandlerConfig<TField, TInput, TOutput> | SimpleGraphQLHandlerConfig<TField>;\n\n/**\n * Type guard to check if config is a simple GraphQL handler.\n */\nexport function isSimpleGraphQLHandlerConfig(\n  config: AnyGraphQLHandlerConfig<GraphQLFieldDefinition, unknown, unknown>,\n): config is SimpleGraphQLHandlerConfig<GraphQLFieldDefinition> {\n  return 'handler' in config && typeof config.handler === 'function';\n}\n\n/**\n * GraphQL middleware function type.\n */\nexport type GraphQLMiddlewareFunction = (\n  args: unknown,\n  context: GraphQLHandlerContext,\n  next: () => Promise<unknown>,\n) => Promise<unknown>;\n\n// ============================================================================\n// Server Configuration\n// ============================================================================\n\n/**\n * Options for creating GraphQL routes.\n */\nexport interface CreateGraphQLRoutesOptions {\n  /** Global middleware to run before all handlers. */\n  readonly middleware?: readonly GraphQLMiddlewareFunction[];\n\n  /**\n   * Whether to validate incoming args against field schemas.\n   * When enabled, invalid args throw ObjectValidationError.\n   * @default true\n   */\n  readonly validateInput?: boolean;\n\n  /**\n   * Whether to validate outgoing results against field schemas.\n   * When enabled, invalid results log a warning.\n   * @default true\n   */\n  readonly validateOutput?: boolean;\n\n  /**\n   * Context factory to create handler context.\n   */\n  readonly createContext?: (rawContext: unknown) => GraphQLHandlerContext;\n\n  /**\n   * Allow partial handler configuration (not all fields need handlers).\n   * When true, missing handlers are silently skipped.\n   * When false (default), missing handlers throw an error.\n   * @default false\n   * @internal Used by builder pattern's buildPartial()\n   */\n  readonly allowPartial?: boolean;\n}\n\n// ============================================================================\n// Unified GraphQL Field (for framework adapters)\n// ============================================================================\n\n/**\n * GraphQL field input compatible with framework adapters.\n * This is the output of graphqlRoutes().build().\n */\nexport interface UnifiedGraphQLField {\n  /** Schema key path (e.g., 'users.get'). */\n  readonly key: string;\n\n  /** GraphQL operation type. */\n  readonly operation: GraphQLOperationType;\n\n  /** Handler function. */\n  readonly handler: (args: unknown, context: unknown) => Promise<unknown>;\n\n  /** Field metadata for documentation. */\n  readonly metadata: {\n    readonly fieldId?: string;\n    readonly description?: string;\n    readonly tags?: readonly string[];\n    readonly deprecated?: boolean;\n    readonly deprecationReason?: string;\n  };\n}\n","/**\n * @fileoverview Internal implementation for creating GraphQL routes with auto-validation.\n *\n * Generates GraphQL field handlers from a schema definition.\n * Each handler automatically validates incoming args and outgoing results\n * against the field's schemas.\n *\n * @module graphql/server/create-graphql-routes\n * @internal\n */\n\nimport type { SchemaAdapter, ValidationIssue } from '../../http/schema/types';\nimport type {\n  GraphQLSchemaConfig,\n  GraphQLSchemaDefinition,\n  GraphQLFieldDefinition,\n} from '../field/types';\nimport { isSchemaDefinition, collectFields } from '../field/types';\nimport { generateFieldId } from '../field/utils';\nimport { mapErrorToGraphQLError } from '../shared/error-mapping';\nimport type {\n  AnyGraphQLHandlerConfig,\n  CreateGraphQLRoutesOptions,\n  GraphQLHandlerContext,\n  UnifiedGraphQLField,\n  ValidatedArgs,\n} from './types';\nimport { isSimpleGraphQLHandlerConfig } from './types';\nimport { ObjectValidationError } from '../../../global/exceptions/object-validation.error';\nimport { UnauthorizedError } from '../../../app/exceptions/unauthorized.error';\n\n/**\n * Internal implementation for creating GraphQL routes.\n * Used by the builder pattern (graphqlRoutes).\n *\n * @internal\n */\nexport function createGraphQLRoutesInternal<T extends GraphQLSchemaConfig>(\n  schema: T | GraphQLSchemaDefinition<T>,\n  handlers: Record<string, AnyGraphQLHandlerConfig<GraphQLFieldDefinition, unknown, unknown>>,\n  options?: CreateGraphQLRoutesOptions,\n): UnifiedGraphQLField[] {\n  const config = isSchemaDefinition(schema) ? schema.fields : schema;\n  const collectedFields = collectFields(config);\n\n  const result: UnifiedGraphQLField[] = [];\n\n  const resolvedOptions: CreateGraphQLRoutesOptions = {\n    ...options,\n    validateInput: options?.validateInput ?? true,\n    validateOutput: options?.validateOutput ?? true,\n    allowPartial: options?.allowPartial ?? false,\n  };\n\n  for (const { key, field } of collectedFields) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const handlerConfig = handlers[key] as\n      | AnyGraphQLHandlerConfig<GraphQLFieldDefinition, any, any>\n      | undefined;\n\n    if (!handlerConfig) {\n      if (resolvedOptions.allowPartial) {\n        continue;\n      }\n      throw new Error(\n        `Missing handler for field \"${key}\". All fields must have a handler configuration.`,\n      );\n    }\n\n    result.push(createFieldHandler(key, field, handlerConfig, resolvedOptions));\n  }\n\n  return result;\n}\n\n/**\n * Creates a single field handler with validation and error mapping.\n */\nfunction createFieldHandler(\n  key: string,\n  field: GraphQLFieldDefinition,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  config: AnyGraphQLHandlerConfig<GraphQLFieldDefinition, any, any>,\n  options: CreateGraphQLRoutesOptions,\n): UnifiedGraphQLField {\n  const middleware = config.middleware ?? [];\n  const globalMiddleware = options?.middleware ?? [];\n  const allMiddleware = [...globalMiddleware, ...middleware];\n  const shouldValidateInput = options.validateInput ?? true;\n  const shouldValidateOutput = options.validateOutput ?? true;\n\n  return {\n    key,\n    operation: field.operation,\n    metadata: {\n      fieldId: generateFieldId(key),\n      description: field.docs.description,\n      tags: field.docs.tags as string[],\n      deprecated: field.docs.deprecated,\n      deprecationReason: field.docs.deprecationReason,\n    },\n    handler: async (rawArgs: unknown, rawContext: unknown): Promise<unknown> => {\n      // Create context\n      const context: GraphQLHandlerContext = options?.createContext\n        ? options.createContext(rawContext)\n        : ((rawContext as GraphQLHandlerContext) ?? { requestId: generateRequestId() });\n\n      // Validate context (if schema defined)\n      // Context validation failures → UnauthorizedError (401 semantics).\n      // Error message is generic to prevent leaking context schema details\n      // (field names, types, constraints) to unauthenticated clients.\n      let validatedContext: unknown = context;\n      if (field.context) {\n        const contextResult = validateContextData(field, context);\n        if (!contextResult.success) {\n          throw new UnauthorizedError({\n            message: 'Authentication required',\n          });\n        }\n        validatedContext = contextResult.data;\n      }\n\n      // Validate input args (if enabled and schema defined)\n      let validatedInput: unknown = rawArgs;\n      if (shouldValidateInput && field.input) {\n        const inputResult = validateInputData(field, rawArgs);\n        if (!inputResult.success) {\n          const errors = inputResult.errors ?? [];\n          throw new ObjectValidationError({\n            message: 'Input validation failed',\n            validationErrors: errors.map((e) => ({\n              field: e.path.join('.'),\n              message: e.message,\n            })),\n          });\n        }\n        validatedInput = inputResult.data;\n      }\n\n      const validatedArgs: ValidatedArgsInternal = {\n        input: validatedInput,\n        raw: rawArgs,\n      };\n\n      // Execute the pipeline\n      const executePipeline = async (): Promise<unknown> => {\n        if (isSimpleGraphQLHandlerConfig(config)) {\n          return config.handler(\n            validatedArgs as unknown as ValidatedArgs<GraphQLFieldDefinition>,\n            validatedContext as GraphQLHandlerContext,\n          );\n        } else {\n          const { argsMapper, useCase, responseMapper } = config;\n\n          const input = argsMapper(\n            validatedArgs as unknown as ValidatedArgs<GraphQLFieldDefinition>,\n            validatedContext as GraphQLHandlerContext,\n          );\n\n          const output = await useCase.execute(input);\n\n          return responseMapper(output);\n        }\n      };\n\n      let result: unknown;\n\n      if (allMiddleware.length === 0) {\n        result = await executePipeline();\n      } else {\n        // Build middleware chain with re-entrancy guard\n        let index = 0;\n        let called = false;\n        const next = async (): Promise<unknown> => {\n          if (index >= allMiddleware.length) {\n            if (called) throw new Error('next() called after pipeline already executed');\n            called = true;\n            return executePipeline();\n          }\n          const currentIndex = index++;\n          // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- index bounds checked above\n          const mw = allMiddleware[currentIndex]!;\n          return mw(rawArgs, context, next);\n        };\n\n        result = await next();\n      }\n\n      // Validate output (if enabled and schema defined)\n      if (shouldValidateOutput && field.output) {\n        const outputResult = validateOutputData(field, result);\n        if (!outputResult.success) {\n          const details = outputResult.errors\n            ?.map((e) => `${e.path.join('.')}: ${e.message}`)\n            .join('; ');\n          throw new ObjectValidationError({\n            message: `Output validation failed for field \"${key}\": ${details}`,\n            validationErrors: (outputResult.errors ?? []).map((e) => ({\n              field: e.path.join('.'),\n              message: e.message,\n            })),\n          });\n        }\n      }\n\n      return result;\n    },\n  };\n}\n\n// ============================================================================\n// Validation Helpers\n// ============================================================================\n\ninterface ValidationResultInternal {\n  success: boolean;\n  errors?: ValidationIssue[];\n  data?: unknown;\n}\n\n/**\n * Validates input args against the field's input schema.\n */\nfunction validateInputData(field: GraphQLFieldDefinition, args: unknown): ValidationResultInternal {\n  const schema = field.input as SchemaAdapter | undefined;\n  if (!schema) return { success: true, data: args };\n\n  const result = schema.validate(args);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n\n  const errors = result.issues.map((issue) => ({\n    ...issue,\n    path: ['input', ...issue.path],\n  }));\n\n  return { success: false, errors };\n}\n\n/**\n * Validates output data against the field's output schema.\n */\nfunction validateOutputData(\n  field: GraphQLFieldDefinition,\n  data: unknown,\n): ValidationResultInternal {\n  const schema = field.output as SchemaAdapter | undefined;\n  if (!schema) return { success: true, data };\n\n  const result = schema.validate(data);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n\n  const errors = result.issues.map((issue) => ({\n    ...issue,\n    path: ['output', ...issue.path],\n  }));\n\n  return { success: false, errors };\n}\n\n/**\n * Validates context data against the field's context schema.\n */\nfunction validateContextData(\n  field: GraphQLFieldDefinition,\n  context: GraphQLHandlerContext,\n): ValidationResultInternal {\n  const schema = field.context as SchemaAdapter | undefined;\n  if (!schema) return { success: true, data: context };\n\n  const result = schema.validate(context);\n  if (result.success) {\n    return { success: true, data: result.data };\n  }\n\n  const errors = result.issues.map((issue) => ({\n    ...issue,\n    path: ['context', ...issue.path],\n  }));\n\n  return { success: false, errors };\n}\n\n/**\n * Internal validated args type with unknown fields.\n * Used inside createFieldHandler where specific types are erased.\n */\ninterface ValidatedArgsInternal {\n  readonly input: unknown;\n  readonly raw: unknown;\n}\n\n/**\n * Generates a unique request ID.\n */\nfunction generateRequestId(): string {\n  return `gql_${crypto.randomUUID()}`;\n}\n","/**\n * @fileoverview Builder pattern for creating type-safe GraphQL routes.\n *\n * The `graphqlRoutes` function returns a builder that provides 100% type inference\n * for all handler parameters — no manual type annotations required.\n *\n * @module graphql/server/graphql-routes-builder\n */\n\nimport type {\n  GraphQLSchemaConfig,\n  GraphQLSchemaDefinition,\n  GetField,\n  SchemaKeys,\n  GraphQLFieldDefinition,\n} from '../field/types';\nimport type {\n  AnyGraphQLHandlerConfig,\n  CreateGraphQLRoutesOptions,\n  GraphQLHandlerConfig,\n  GraphQLMiddlewareFunction,\n  SimpleGraphQLHandlerConfig,\n  SimpleGraphQLHandlerFn,\n  TypedGraphQLContext,\n  UnifiedGraphQLField,\n  ValidatedArgs,\n} from './types';\nimport { createGraphQLRoutesInternal } from './create-graphql-routes';\n\n// ============================================================================\n// Builder Types\n// ============================================================================\n\n/**\n * Error type displayed when attempting to build() with missing handlers.\n * The `___missingFields` property shows which fields are missing.\n */\nexport interface MissingHandlersError<TMissing extends string> {\n  /**\n   * This error indicates that not all GraphQL fields have handlers.\n   * Use buildPartial() to build with only the defined handlers,\n   * or add handlers for the missing fields.\n   */\n  (options?: never): never;\n  /** Fields that are missing handlers. */\n  readonly ___missingFields: TMissing;\n}\n\n/**\n * Handler configuration for the builder pattern.\n */\nexport interface BuilderGraphQLHandlerConfig<\n  TField extends GraphQLFieldDefinition,\n  TInput,\n  TOutput,\n> {\n  /**\n   * Maps the validated args to use case input.\n   * Both `args` and `ctx` are fully typed based on field schemas.\n   */\n  readonly argsMapper: (args: ValidatedArgs<TField>, ctx: TypedGraphQLContext<TField>) => TInput;\n\n  /** The use case to execute. */\n  readonly useCase: { execute(input?: TInput): Promise<TOutput> };\n\n  /**\n   * Maps the use case output to the GraphQL response.\n   */\n  readonly responseMapper: (output: TOutput) => TField['_types']['output'];\n\n  /** Middleware to run before the handler. */\n  readonly middleware?: readonly GraphQLMiddlewareFunction[];\n}\n\n/**\n * Builder interface for creating type-safe GraphQL routes.\n *\n * Each `.handle()` call captures the specific field type and provides\n * full type inference for argsMapper, useCase, and responseMapper.\n *\n * @typeParam T - The schema configuration type\n * @typeParam THandled - Union of field keys that have handlers (accumulates)\n *\n * @example\n * ```typescript\n * const fields = graphqlRoutes(projectSchema)\n *   .handleWithUseCase('projects.create', {\n *     argsMapper: (args, ctx) => ({\n *       name: args.input.name,\n *       createdBy: ctx.userId,\n *     }),\n *     useCase: createProjectUseCase,\n *     responseMapper: (output) => ({ projectId: output.projectId }),\n *   })\n *   .handle('projects.list', async (args) => {\n *     return allProjects;\n *   })\n *   .build();\n * ```\n */\nexport interface GraphQLRoutesBuilder<\n  T extends GraphQLSchemaConfig,\n  THandled extends string = never,\n> {\n  /**\n   * Register a simple handler for a field.\n   * The handler receives validated args and context, returns output directly.\n   */\n  handle<K extends Exclude<SchemaKeys<T>, THandled>>(\n    key: K,\n    handlerOrConfig:\n      | SimpleGraphQLHandlerFn<GetField<T, K>>\n      | SimpleGraphQLHandlerConfig<GetField<T, K>>,\n  ): GraphQLRoutesBuilder<T, THandled | K>;\n\n  /**\n   * Register a handler using the use case pattern.\n   * Follows: argsMapper → useCase.execute() → responseMapper\n   */\n  handleWithUseCase<K extends Exclude<SchemaKeys<T>, THandled>, TInput, TOutput>(\n    key: K,\n    config: BuilderGraphQLHandlerConfig<GetField<T, K>, TInput, TOutput>,\n  ): GraphQLRoutesBuilder<T, THandled | K>;\n\n  /**\n   * Build the fields array for framework adapter registration.\n   *\n   * This method is only available when ALL fields have handlers.\n   * If some fields are missing handlers, use `buildPartial()` instead.\n   */\n  build: [Exclude<SchemaKeys<T>, THandled>] extends [never]\n    ? (options?: CreateGraphQLRoutesOptions) => UnifiedGraphQLField[]\n    : MissingHandlersError<Exclude<SchemaKeys<T>, THandled>>;\n\n  /**\n   * Build fields for only the defined handlers.\n   * No compile-time enforcement of completeness.\n   */\n  buildPartial(options?: CreateGraphQLRoutesOptions): UnifiedGraphQLField[];\n}\n\n// ============================================================================\n// Builder Implementation\n// ============================================================================\n\n/**\n * Internal builder implementation.\n *\n * Uses an immutable pattern where each handle() call returns a new\n * builder instance with the updated handlers map.\n */\nclass GraphQLRoutesBuilderImpl<T extends GraphQLSchemaConfig, THandled extends string = never> {\n  private readonly schema: T | GraphQLSchemaDefinition<T>;\n  private readonly handlers: Map<\n    string,\n    AnyGraphQLHandlerConfig<GraphQLFieldDefinition, unknown, unknown>\n  >;\n\n  constructor(\n    schema: T | GraphQLSchemaDefinition<T>,\n    handlers?: Map<string, AnyGraphQLHandlerConfig<GraphQLFieldDefinition, unknown, unknown>>,\n  ) {\n    this.schema = schema;\n    this.handlers = handlers ?? new Map();\n  }\n\n  handle<K extends Exclude<SchemaKeys<T>, THandled>>(\n    key: K,\n    handlerOrConfig:\n      | SimpleGraphQLHandlerFn<GetField<T, K>>\n      | SimpleGraphQLHandlerConfig<GetField<T, K>>,\n  ): GraphQLRoutesBuilder<T, THandled | K> {\n    // Cast through unknown is safe: type erasure in the builder requires this cast\n    // The type system tracks the specific field types through the interface\n    const config: SimpleGraphQLHandlerConfig<GraphQLFieldDefinition> =\n      typeof handlerOrConfig === 'function'\n        ? { handler: handlerOrConfig as unknown as SimpleGraphQLHandlerFn<GraphQLFieldDefinition> }\n        : (handlerOrConfig as unknown as SimpleGraphQLHandlerConfig<GraphQLFieldDefinition>);\n\n    const newHandlers = new Map(this.handlers);\n    newHandlers.set(key as string, config);\n\n    return new GraphQLRoutesBuilderImpl<T, THandled | K>(\n      this.schema,\n      newHandlers,\n    ) as unknown as GraphQLRoutesBuilder<T, THandled | K>;\n  }\n\n  handleWithUseCase<K extends Exclude<SchemaKeys<T>, THandled>, TInput, TOutput>(\n    key: K,\n    config: BuilderGraphQLHandlerConfig<GetField<T, K>, TInput, TOutput>,\n  ): GraphQLRoutesBuilder<T, THandled | K> {\n    const newHandlers = new Map(this.handlers);\n    // Cast through unknown is safe: the type system tracks THandled | K through the interface\n    newHandlers.set(\n      key as string,\n      config as unknown as GraphQLHandlerConfig<GraphQLFieldDefinition, unknown, unknown>,\n    );\n\n    return new GraphQLRoutesBuilderImpl<T, THandled | K>(\n      this.schema,\n      newHandlers,\n    ) as unknown as GraphQLRoutesBuilder<T, THandled | K>;\n  }\n\n  build(options?: CreateGraphQLRoutesOptions): UnifiedGraphQLField[] {\n    return createGraphQLRoutesInternal(this.schema, Object.fromEntries(this.handlers), options);\n  }\n\n  buildPartial(options?: CreateGraphQLRoutesOptions): UnifiedGraphQLField[] {\n    return createGraphQLRoutesInternal(this.schema, Object.fromEntries(this.handlers), {\n      ...options,\n      allowPartial: true,\n    });\n  }\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Creates a type-safe GraphQL routes builder for a schema.\n *\n * The builder pattern provides 100% type inference for all handler parameters:\n * - `args.input` is typed from the field's input schema\n * - `ctx` is typed from the field's context schema (or GraphQLHandlerContext)\n * - `output` in responseMapper is typed from the use case\n *\n * @param schema - GraphQL schema definition or schema config\n * @returns Builder for registering handlers\n *\n * @example Basic usage\n * ```typescript\n * import { graphqlRoutes } from '@cosmneo/onion-lasagna/graphql/server';\n * import { projectSchema } from './schema';\n *\n * const fields = graphqlRoutes(projectSchema)\n *   .handleWithUseCase('projects.create', {\n *     argsMapper: (args, ctx) => ({\n *       name: args.input.name,\n *       createdBy: ctx.userId,\n *     }),\n *     useCase: createProjectUseCase,\n *     responseMapper: (output) => ({ projectId: output.projectId }),\n *   })\n *   .handle('projects.list', async () => allProjects)\n *   .build();\n * ```\n */\nexport function graphqlRoutes<T extends GraphQLSchemaConfig>(\n  schema: T | GraphQLSchemaDefinition<T>,\n): GraphQLRoutesBuilder<T, never> {\n  return new GraphQLRoutesBuilderImpl(schema) as unknown as GraphQLRoutesBuilder<T, never>;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-BG2FY27M.js

@@ -0,0 +1,36 @@
+// src/presentation/graphql/field/types/schema-definition.type.ts
+function isFieldDefinition(value) {
+  return typeof value === "object" && value !== null && "_isGraphQLField" in value && value._isGraphQLField === true;
+}
+function isSchemaDefinition(value) {
+  return typeof value === "object" && value !== null && "_isGraphQLSchema" in value && value._isGraphQLSchema === true;
+}
+function collectFields(config, basePath = "") {
+  const fields = [];
+  for (const [key, value] of Object.entries(config)) {
+    const fullKey = basePath ? `${basePath}.${key}` : key;
+    if (isFieldDefinition(value)) {
+      fields.push({ key: fullKey, field: value });
+    } else if (isSchemaDefinition(value)) {
+      fields.push(...collectFields(value.fields, fullKey));
+    } else if (typeof value === "object" && value !== null) {
+      fields.push(...collectFields(value, fullKey));
+    }
+  }
+  return fields;
+}
+
+// src/presentation/graphql/field/utils.ts
+function generateFieldId(key) {
+  return key.split(".").map(
+    (segment, index) => index === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1)
+  ).join("");
+}
+
+export {
+  isFieldDefinition,
+  isSchemaDefinition,
+  collectFields,
+  generateFieldId
+};
+//# sourceMappingURL=chunk-BG2FY27M.js.map

package/dist/chunk-BG2FY27M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/presentation/graphql/field/types/schema-definition.type.ts","../src/presentation/graphql/field/utils.ts"],"sourcesContent":["/**\n * @fileoverview GraphQL schema definition types for grouping fields.\n *\n * Mirrors the HTTP router definition pattern with hierarchical grouping,\n * dotted-key access, and deep merge support.\n *\n * @module graphql/field/types/schema-definition\n */\n\nimport type { GraphQLFieldDefinition, GraphQLOperationType } from './field-definition.type';\nimport type { SchemaAdapter } from '../../../http/schema/types';\n\n// ============================================================================\n// Schema Types\n// ============================================================================\n\n/**\n * A schema entry can be a field definition, a nested config, or a schema definition.\n */\nexport type GraphQLSchemaEntry =\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  | GraphQLFieldDefinition<GraphQLOperationType, any, any, any>\n  | GraphQLSchemaConfig\n  | GraphQLSchemaDefinition;\n\n/**\n * Configuration for a GraphQL schema (group of fields).\n */\nexport interface GraphQLSchemaConfig {\n  readonly [key: string]: GraphQLSchemaEntry;\n}\n\n/**\n * Schema-level defaults applied to all child fields.\n */\nexport interface GraphQLSchemaDefaults {\n  /** Default tags for all fields. Merged with field-specific tags. */\n  readonly tags?: readonly string[];\n\n  /** Default context schema. Applied to fields that don't define their own. */\n  readonly context?: SchemaAdapter;\n}\n\n/**\n * A fully defined GraphQL schema.\n */\nexport interface GraphQLSchemaDefinition<T extends GraphQLSchemaConfig = GraphQLSchemaConfig> {\n  /** The fields and nested groups in this schema. */\n  readonly fields: T;\n\n  /** Default values applied to all child fields. */\n  readonly defaults?: GraphQLSchemaDefaults;\n\n  /**\n   * Marker to identify this as a GraphQL schema definition.\n   * @internal\n   */\n  readonly _isGraphQLSchema: true;\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/**\n * Checks if a value is a GraphQLFieldDefinition.\n */\nexport function isFieldDefinition(value: unknown): value is GraphQLFieldDefinition {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_isGraphQLField' in value &&\n    (value as GraphQLFieldDefinition)._isGraphQLField === true\n  );\n}\n\n/**\n * Checks if a value is a GraphQLSchemaDefinition.\n */\nexport function isSchemaDefinition(value: unknown): value is GraphQLSchemaDefinition {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_isGraphQLSchema' in value &&\n    (value as GraphQLSchemaDefinition)._isGraphQLSchema === true\n  );\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\n/**\n * Flattens a schema into a map of dotted keys to field definitions.\n */\nexport type FlattenSchema<\n  T extends GraphQLSchemaConfig,\n  Prefix extends string = '',\n> = T extends GraphQLSchemaConfig\n  ? {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      [K in keyof T]: T[K] extends GraphQLFieldDefinition<any, any, any, any>\n        ? { [P in `${Prefix}${K & string}`]: T[K] }\n        : T[K] extends GraphQLSchemaConfig\n          ? FlattenSchema<T[K], `${Prefix}${K & string}.`>\n          : never;\n    }[keyof T] extends infer U\n    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      U extends Record<string, GraphQLFieldDefinition<any, any, any, any>>\n      ? U\n      : never\n    : never\n  : never;\n\n/**\n * Gets all field keys from a schema.\n */\nexport type SchemaKeys<\n  T extends GraphQLSchemaConfig,\n  Prefix extends string = '',\n> = T extends GraphQLSchemaConfig\n  ? {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      [K in keyof T]: T[K] extends GraphQLFieldDefinition<any, any, any, any>\n        ? `${Prefix}${K & string}`\n        : T[K] extends GraphQLSchemaConfig\n          ? SchemaKeys<T[K], `${Prefix}${K & string}.`>\n          : never;\n    }[keyof T]\n  : never;\n\n/**\n * Gets a field by its dotted key path.\n */\nexport type GetField<\n  T extends GraphQLSchemaConfig,\n  K extends string,\n> = K extends `${infer Head}.${infer Tail}`\n  ? Head extends keyof T\n    ? T[Head] extends GraphQLSchemaConfig\n      ? GetField<T[Head], Tail>\n      : never\n    : never\n  : K extends keyof T\n    ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      T[K] extends GraphQLFieldDefinition<any, any, any, any>\n      ? T[K]\n      : never\n    : never;\n\n// ============================================================================\n// Deep Merge Types\n// ============================================================================\n\n/**\n * Deep-merges two schema configs at the type level.\n */\nexport type DeepMergeSchemas<A extends GraphQLSchemaConfig, B extends GraphQLSchemaConfig> = {\n  readonly [K in keyof A | keyof B]: K extends keyof A\n    ? K extends keyof B\n      ? A[K] extends GraphQLSchemaConfig\n        ? B[K] extends GraphQLSchemaConfig\n          ? DeepMergeSchemas<A[K], B[K]>\n          : B[K]\n        : B[K]\n      : A[K]\n    : K extends keyof B\n      ? B[K]\n      : never;\n};\n\n/**\n * Recursively deep-merges N schema configs left-to-right.\n */\nexport type DeepMergeSchemasAll<T extends readonly GraphQLSchemaConfig[]> = T extends readonly [\n  infer Only extends GraphQLSchemaConfig,\n]\n  ? Only\n  : T extends readonly [\n        infer First extends GraphQLSchemaConfig,\n        infer Second extends GraphQLSchemaConfig,\n        ...infer Rest extends readonly GraphQLSchemaConfig[],\n      ]\n    ? DeepMergeSchemasAll<[DeepMergeSchemas<First, Second>, ...Rest]>\n    : GraphQLSchemaConfig;\n\n// ============================================================================\n// Runtime Utilities\n// ============================================================================\n\n/**\n * Collects all fields from a schema into a flat array.\n */\nexport function collectFields(\n  config: GraphQLSchemaConfig,\n  basePath = '',\n): { key: string; field: GraphQLFieldDefinition }[] {\n  const fields: { key: string; field: GraphQLFieldDefinition }[] = [];\n\n  for (const [key, value] of Object.entries(config)) {\n    const fullKey = basePath ? `${basePath}.${key}` : key;\n\n    if (isFieldDefinition(value)) {\n      fields.push({ key: fullKey, field: value });\n    } else if (isSchemaDefinition(value)) {\n      fields.push(...collectFields(value.fields, fullKey));\n    } else if (typeof value === 'object' && value !== null) {\n      fields.push(...collectFields(value as GraphQLSchemaConfig, fullKey));\n    }\n  }\n\n  return fields;\n}\n","/**\n * @fileoverview GraphQL field utility functions.\n *\n * @module graphql/field/utils\n */\n\n/**\n * Generates a field ID from a schema key path.\n *\n * This is the **single source of truth** for the naming convention used across:\n * - SDL generation (`type Query { usersGet(...) }`)\n * - Yoga resolver map keys\n * - Client query string field names\n *\n * Converts dotted key paths to camelCase:\n * - `\"users.get\"` → `\"usersGet\"`\n * - `\"projects.members.list\"` → `\"projectsMembersList\"`\n * - `\"getUser\"` → `\"getUser\"` (single segment unchanged)\n *\n * @param key - The dotted schema key path\n * @returns A camelCase field ID string\n */\nexport function generateFieldId(key: string): string {\n  return key\n    .split('.')\n    .map((segment, index) =>\n      index === 0 ? segment : segment.charAt(0).toUpperCase() + segment.slice(1),\n    )\n    .join('');\n}\n"],"mappings":";AAmEO,SAAS,kBAAkB,OAAiD;AACjF,SACE,OAAO,UAAU,YACjB,UAAU,QACV,qBAAqB,SACpB,MAAiC,oBAAoB;AAE1D;AAKO,SAAS,mBAAmB,OAAkD;AACnF,SACE,OAAO,UAAU,YACjB,UAAU,QACV,sBAAsB,SACrB,MAAkC,qBAAqB;AAE5D;AA2GO,SAAS,cACd,QACA,WAAW,IACuC;AAClD,QAAM,SAA2D,CAAC;AAElE,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,UAAM,UAAU,WAAW,GAAG,QAAQ,IAAI,GAAG,KAAK;AAElD,QAAI,kBAAkB,KAAK,GAAG;AAC5B,aAAO,KAAK,EAAE,KAAK,SAAS,OAAO,MAAM,CAAC;AAAA,IAC5C,WAAW,mBAAmB,KAAK,GAAG;AACpC,aAAO,KAAK,GAAG,cAAc,MAAM,QAAQ,OAAO,CAAC;AAAA,IACrD,WAAW,OAAO,UAAU,YAAY,UAAU,MAAM;AACtD,aAAO,KAAK,GAAG,cAAc,OAA8B,OAAO,CAAC;AAAA,IACrE;AAAA,EACF;AAEA,SAAO;AACT;;;AC9LO,SAAS,gBAAgB,KAAqB;AACnD,SAAO,IACJ,MAAM,GAAG,EACT;AAAA,IAAI,CAAC,SAAS,UACb,UAAU,IAAI,UAAU,QAAQ,OAAO,CAAC,EAAE,YAAY,IAAI,QAAQ,MAAM,CAAC;AAAA,EAC3E,EACC,KAAK,EAAE;AACZ;","names":[]}

package/dist/chunk-FEY2GSVT.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-FEY2GSVT.js.map

package/dist/chunk-FEY2GSVT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}