@cosmneo/onion-lasagna 0.3.0 → 0.4.0

package/dist/graphql/sdl/index.cjs

@@ -0,0 +1,241 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/presentation/graphql/sdl/index.ts
+var sdl_exports = {};
+__export(sdl_exports, {
+  generateGraphQLSDL: () => generateGraphQLSDL
+});
+module.exports = __toCommonJS(sdl_exports);
+
+// 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("");
+}
+
+// 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");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  generateGraphQLSDL
+});
+//# sourceMappingURL=index.cjs.map

package/dist/graphql/sdl/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/presentation/graphql/sdl/index.ts","../../../src/presentation/graphql/field/types/schema-definition.type.ts","../../../src/presentation/graphql/field/utils.ts","../../../src/presentation/graphql/sdl/generate.ts"],"sourcesContent":["/**\n * @fileoverview GraphQL SDL generation module exports.\n *\n * @module graphql/sdl\n *\n * @example Generate SDL\n * ```typescript\n * import { generateGraphQLSDL } from '@cosmneo/onion-lasagna/graphql/sdl';\n *\n * const sdl = generateGraphQLSDL(schema);\n * ```\n */\n\nexport { generateGraphQLSDL } from './generate';\nexport type { GraphQLSDLConfig } from './types';\n","/**\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","/**\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/graphql/sdl/index.d.cts

@@ -0,0 +1,77 @@
+import { d as GraphQLSchemaConfig, f as GraphQLSchemaDefinition } from '../../schema-definition.type-C9PntBVc.cjs';
+import '../../http/schema/types.cjs';
+
+/**
+ * @fileoverview Types for GraphQL SDL generation.
+ *
+ * @module graphql/sdl/types
+ */
+/**
+ * Configuration for SDL generation.
+ */
+interface GraphQLSDLConfig {
+    /**
+     * Additional SDL to prepend (e.g., custom scalars, directives).
+     *
+     * @example
+     * ```typescript
+     * generateGraphQLSDL(schema, {
+     *   preamble: 'scalar DateTime\nscalar UUID',
+     * })
+     * ```
+     */
+    readonly preamble?: string;
+    /**
+     * Whether to include descriptions as SDL doc strings.
+     * @default true
+     */
+    readonly includeDescriptions?: boolean;
+    /**
+     * Whether to include @deprecated directives.
+     * @default true
+     */
+    readonly includeDeprecations?: boolean;
+}
+
+/**
+ * @fileoverview GraphQL SDL generation from schema definitions.
+ *
+ * The `generateGraphQLSDL` function creates a complete GraphQL Schema
+ * Definition Language string from a schema definition.
+ *
+ * Input/output schemas are converted to JSON Schema via `toJsonSchema()`,
+ * then mapped to GraphQL type definitions.
+ *
+ * @module graphql/sdl/generate
+ */
+
+/**
+ * Generates a GraphQL SDL string from a schema definition.
+ *
+ * Walks the schema structure, extracts JSON schemas from all field
+ * definitions, and builds a complete SDL with Query, Mutation, and
+ * type definitions.
+ *
+ * @param schema - Schema definition or schema config
+ * @param config - Optional SDL generation configuration
+ * @returns Complete GraphQL SDL string
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { generateGraphQLSDL } from '@cosmneo/onion-lasagna/graphql/sdl';
+ *
+ * const sdl = generateGraphQLSDL(projectSchema, {
+ *   preamble: 'scalar DateTime',
+ * });
+ *
+ * console.log(sdl);
+ * // type Query {
+ * //   projectsGet(input: ProjectsGetInput!): ProjectsGetOutput
+ * //   projectsList: ProjectsListOutput
+ * // }
+ * // ...
+ * ```
+ */
+declare function generateGraphQLSDL<T extends GraphQLSchemaConfig>(schema: T | GraphQLSchemaDefinition<T>, config?: GraphQLSDLConfig): string;
+
+export { type GraphQLSDLConfig, generateGraphQLSDL };

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

@@ -0,0 +1,77 @@
+import { d as GraphQLSchemaConfig, f as GraphQLSchemaDefinition } from '../../schema-definition.type-CuhQLDr0.js';
+import '../../http/schema/types.js';
+
+/**
+ * @fileoverview Types for GraphQL SDL generation.
+ *
+ * @module graphql/sdl/types
+ */
+/**
+ * Configuration for SDL generation.
+ */
+interface GraphQLSDLConfig {
+    /**
+     * Additional SDL to prepend (e.g., custom scalars, directives).
+     *
+     * @example
+     * ```typescript
+     * generateGraphQLSDL(schema, {
+     *   preamble: 'scalar DateTime\nscalar UUID',
+     * })
+     * ```
+     */
+    readonly preamble?: string;
+    /**
+     * Whether to include descriptions as SDL doc strings.
+     * @default true
+     */
+    readonly includeDescriptions?: boolean;
+    /**
+     * Whether to include @deprecated directives.
+     * @default true
+     */
+    readonly includeDeprecations?: boolean;
+}
+
+/**
+ * @fileoverview GraphQL SDL generation from schema definitions.
+ *
+ * The `generateGraphQLSDL` function creates a complete GraphQL Schema
+ * Definition Language string from a schema definition.
+ *
+ * Input/output schemas are converted to JSON Schema via `toJsonSchema()`,
+ * then mapped to GraphQL type definitions.
+ *
+ * @module graphql/sdl/generate
+ */
+
+/**
+ * Generates a GraphQL SDL string from a schema definition.
+ *
+ * Walks the schema structure, extracts JSON schemas from all field
+ * definitions, and builds a complete SDL with Query, Mutation, and
+ * type definitions.
+ *
+ * @param schema - Schema definition or schema config
+ * @param config - Optional SDL generation configuration
+ * @returns Complete GraphQL SDL string
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { generateGraphQLSDL } from '@cosmneo/onion-lasagna/graphql/sdl';
+ *
+ * const sdl = generateGraphQLSDL(projectSchema, {
+ *   preamble: 'scalar DateTime',
+ * });
+ *
+ * console.log(sdl);
+ * // type Query {
+ * //   projectsGet(input: ProjectsGetInput!): ProjectsGetOutput
+ * //   projectsList: ProjectsListOutput
+ * // }
+ * // ...
+ * ```
+ */
+declare function generateGraphQLSDL<T extends GraphQLSchemaConfig>(schema: T | GraphQLSchemaDefinition<T>, config?: GraphQLSDLConfig): string;
+
+export { type GraphQLSDLConfig, generateGraphQLSDL };

package/dist/graphql/sdl/index.js

@@ -0,0 +1,8 @@
+import {
+  generateGraphQLSDL
+} from "../../chunk-4RFWJ5XZ.js";
+import "../../chunk-BG2FY27M.js";
+export {
+  generateGraphQLSDL
+};
+//# sourceMappingURL=index.js.map

package/dist/graphql/sdl/index.js.map

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