@wundergraph/protographic 0.11.0 → 0.12.1

package/README.md

@@ -4,18 +4,21 @@ A tool for converting GraphQL Schema Definition Language (SDL) to Protocol Buffe
 
 ## Overview
 
-Protographic bridges GraphQL and Protocol Buffers (protobuf) ecosystems through two core functions:
+Protographic bridges GraphQL and Protocol Buffers (protobuf) ecosystems through three core functions:
 
 1. **GraphQL SDL to Protocol Buffer (Proto) Compiler**: Transforms GraphQL schemas into Proto3 format, allowing developers to write gRPC services using GraphQL SDL and integrate them seamlessly into the Cosmo Router as standard subgraphs. This is used at build-time.
 
-2. **GraphQL SDL to Mapping Compiler**: Creates mapping definitions that maintain the semantic relationships between GraphQL types while adapting them to Protocol Buffer's structural model. This is used by the Cosmo Router at runtime.
+2. **GraphQL Operations to Protocol Buffer Compiler** ⚠️ **ALPHA**: Converts GraphQL operations (queries, mutations, subscriptions) into Proto3 service definitions with corresponding request/response messages. This enables operation-first development where you define your API through GraphQL operations rather than schema types.
+
+3. **GraphQL SDL to Mapping Compiler**: Creates mapping definitions that maintain the semantic relationships between GraphQL types while adapting them to Protocol Buffer's structural model. This is used by the Cosmo Router at runtime.
 
 ## Key Features
 
 - Precise conversion of GraphQL types to Protocol Buffer messages
+- **Operations-to-Proto** (alpha): Generate proto services directly from GraphQL operations
 - Consistent naming conventions across GraphQL and Proto definitions
 - Streamlined mapping of GraphQL operations to RPC methods
-- Robust handling of complex GraphQL features (unions, interfaces, directives)
+- Handles GraphQL features including unions, interfaces, directives, and fragments
 - First-class support for Federation entity mapping
 - Deterministic field ordering with proto.lock.json for backward compatibility
 - Use of Protocol Buffer wrappers for nullable fields to distinguish between semantic nulls and zero values
@@ -114,6 +117,34 @@ The lock data records the order of:
 
 New fields are always added at the end, maintaining backward compatibility with existing proto messages.
 
+### Converting GraphQL Operations to Protocol Buffer ⚠️ ALPHA
+
+> **Note**: This feature is currently in alpha. The API may change in future releases.
+
+Protographic can generate proto services directly from GraphQL operations, enabling an operation-first development approach. For detailed documentation, see [OPERATIONS_TO_PROTO.md](OPERATIONS_TO_PROTO.md).
+
+Quick example:
+
+```typescript
+import { compileOperationsToProto } from '@wundergraph/protographic';
+
+const operation = `
+query GetUser($userId: ID!) {
+  user(id: $userId) {
+    id
+    name
+    email
+  }
+}
+`;
+
+const result = compileOperationsToProto(operation, schema, {
+  serviceName: 'UserService',
+  packageName: 'user.v1',
+  prefixOperationType: true
+});
+```
+
 ### Generating Mapping Definitions
 
 ```typescript

package/dist/src/index.d.ts

@@ -42,7 +42,22 @@ export * from './sdl-to-mapping-visitor.js';
 export { GraphQLToProtoTextVisitor } from './sdl-to-proto-visitor.js';
 export { ProtoLockManager } from './proto-lock.js';
 export { SDLValidationVisitor } from './sdl-validation-visitor.js';
+export { compileOperationsToProto } from './operation-to-proto.js';
+export type { OperationsToProtoOptions, CompileOperationsToProtoResult } from './operation-to-proto.js';
+export { mapGraphQLTypeToProto, getProtoTypeName, isGraphQLScalarType, requiresWrapperType, getRequiredImports, } from './operations/type-mapper.js';
+export type { ProtoTypeInfo, TypeMapperOptions } from './operations/type-mapper.js';
+export { createFieldNumberManager } from './operations/field-numbering.js';
+export type { FieldNumberManager } from './operations/field-numbering.js';
+export { buildMessageFromSelectionSet, buildFieldDefinition, buildNestedMessage, } from './operations/message-builder.js';
+export type { MessageBuilderOptions } from './operations/message-builder.js';
+export { buildRequestMessage, buildInputObjectMessage, buildEnumType } from './operations/request-builder.js';
+export type { RequestBuilderOptions } from './operations/request-builder.js';
+export { rootToProtoText, serviceToProtoText, messageToProtoText, enumToProtoText, formatField, } from './operations/proto-text-generator.js';
+export type { ProtoTextOptions } from './operations/proto-text-generator.js';
+export type { IdempotencyLevel, MethodWithIdempotency } from './types.js';
 export type { GraphQLToProtoTextVisitorOptions, ProtoOption } from './sdl-to-proto-visitor.js';
+export type { ProtoOptions } from './proto-options.js';
 export type { ProtoLock } from './proto-lock.js';
 export type { ValidationResult } from './sdl-validation-visitor.js';
 export { GRPCMapping, OperationMapping, EntityMapping, TypeFieldMapping, FieldMapping, ArgumentMapping, EnumMapping, EnumValueMapping, OperationType, } from '@wundergraph/cosmo-connect/dist/node/v1/node_pb';
+export { default as protobuf } from 'protobufjs';

package/dist/src/index.js

@@ -62,5 +62,15 @@ export * from './sdl-to-mapping-visitor.js';
 export { GraphQLToProtoTextVisitor } from './sdl-to-proto-visitor.js';
 export { ProtoLockManager } from './proto-lock.js';
 export { SDLValidationVisitor } from './sdl-validation-visitor.js';
+// Export operation-to-proto functionality
+export { compileOperationsToProto } from './operation-to-proto.js';
+// Export operation modules
+export { mapGraphQLTypeToProto, getProtoTypeName, isGraphQLScalarType, requiresWrapperType, getRequiredImports, } from './operations/type-mapper.js';
+export { createFieldNumberManager } from './operations/field-numbering.js';
+export { buildMessageFromSelectionSet, buildFieldDefinition, buildNestedMessage, } from './operations/message-builder.js';
+export { buildRequestMessage, buildInputObjectMessage, buildEnumType } from './operations/request-builder.js';
+export { rootToProtoText, serviceToProtoText, messageToProtoText, enumToProtoText, formatField, } from './operations/proto-text-generator.js';
 export { GRPCMapping, OperationMapping, EntityMapping, TypeFieldMapping, FieldMapping, ArgumentMapping, EnumMapping, EnumValueMapping, OperationType, } from '@wundergraph/cosmo-connect/dist/node/v1/node_pb';
+// Export protobufjs for AST manipulation
+export { default as protobuf } from 'protobufjs';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,oBAAoB,EAAyB,MAAM,6BAA6B,CAAC;AAE1F;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmC,EACnC,cAAsB,gBAAgB;IAEtC,6CAA6C;IAC7C,MAAM,MAAM,GACV,OAAO,WAAW,KAAK,QAAQ;QAC7B,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE;YACvB,WAAW,EAAE,IAAI,EAAE,oCAAoC;YACvD,cAAc,EAAE,IAAI,EAAE,sBAAsB;SAC7C,CAAC;QACJ,CAAC,CAAC,WAAW,CAAC;IAElB,6BAA6B;IAC7B,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/D,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAcD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmC,EACnC,OAA0C;IAE1C,6CAA6C;IAC7C,MAAM,MAAM,GACV,OAAO,WAAW,KAAK,QAAQ;QAC7B,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE;YACvB,WAAW,EAAE,IAAI,EAAE,oCAAoC;YACvD,cAAc,EAAE,IAAI,EAAE,sBAAsB;SAC7C,CAAC;QACJ,CAAC,CAAC,WAAW,CAAC;IAElB,yDAAyD;IACzD,MAAM,OAAO,GAAG,IAAI,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAE9B,8BAA8B;IAC9B,MAAM,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAEzD,wDAAwD;IACxD,OAAO;QACL,KAAK;QACL,QAAQ,EAAE,iBAAiB;KAC5B,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAKnE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,iDAAiD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/operation-to-proto.d.ts

@@ -0,0 +1,48 @@
+import protobuf from 'protobufjs';
+import { DocumentNode, GraphQLSchema } from 'graphql';
+import { ProtoLock } from './proto-lock.js';
+import { IdempotencyLevel } from './types.js';
+/**
+ * Options for converting operations to proto
+ */
+export interface OperationsToProtoOptions {
+    serviceName?: string;
+    packageName?: string;
+    goPackage?: string;
+    javaPackage?: string;
+    javaOuterClassname?: string;
+    javaMultipleFiles?: boolean;
+    csharpNamespace?: string;
+    rubyPackage?: string;
+    phpNamespace?: string;
+    phpMetadataNamespace?: string;
+    objcClassPrefix?: string;
+    swiftPrefix?: string;
+    includeComments?: boolean;
+    queryIdempotency?: IdempotencyLevel;
+    /** Lock data from previous compilation for field number stability */
+    lockData?: ProtoLock;
+    /** Custom scalar type mappings (scalar name -> proto type) */
+    customScalarMappings?: Record<string, string>;
+    /** Maximum recursion depth to prevent stack overflow (default: 50) */
+    maxDepth?: number;
+    /** Prefix RPC method names with operation type (e.g., QueryGetUser, MutationCreateUser) */
+    prefixOperationType?: boolean;
+}
+/**
+ * Result of compiling operations to proto
+ */
+export interface CompileOperationsToProtoResult {
+    proto: string;
+    root: protobuf.Root;
+    /** Lock data for field number stability across compilations */
+    lockData: ProtoLock;
+}
+/**
+ * Compiles a collection of GraphQL operations to protocol buffer definition
+ * @param operationSource - GraphQL operations as a string or DocumentNode
+ * @param schemaOrSDL - GraphQL schema or SDL string
+ * @param options - Configuration options for the compilation
+ * @returns Proto text and protobufjs root object
+ */
+export declare function compileOperationsToProto(operationSource: string | DocumentNode, schemaOrSDL: GraphQLSchema | string, options?: OperationsToProtoOptions): CompileOperationsToProtoResult;

package/dist/src/operation-to-proto.js

@@ -0,0 +1,378 @@
+import protobuf from 'protobufjs';
+import { buildSchema, OperationTypeNode, parse, TypeInfo, visit, visitWithTypeInfo, getNamedType, isInputObjectType, isEnumType, Kind, validate, specifiedRules, KnownDirectivesRule, } from 'graphql';
+import { createFieldNumberManager } from './operations/field-numbering.js';
+import { buildMessageFromSelectionSet } from './operations/message-builder.js';
+import { buildRequestMessage, buildInputObjectMessage, buildEnumType } from './operations/request-builder.js';
+import { rootToProtoText } from './operations/proto-text-generator.js';
+import { mapGraphQLTypeToProto } from './operations/type-mapper.js';
+import { createRequestMessageName, createResponseMessageName, } from './naming-conventions.js';
+import { upperFirst, camelCase } from 'lodash-es';
+import { ProtoLockManager } from './proto-lock.js';
+/**
+ * Compiles a collection of GraphQL operations to protocol buffer definition
+ * @param operationSource - GraphQL operations as a string or DocumentNode
+ * @param schemaOrSDL - GraphQL schema or SDL string
+ * @param options - Configuration options for the compilation
+ * @returns Proto text and protobufjs root object
+ */
+export function compileOperationsToProto(operationSource, schemaOrSDL, options) {
+    const document = typeof operationSource === 'string' ? parse(operationSource) : operationSource;
+    // Validate that only a single named operation is present
+    const namedOperations = document.definitions.filter((def) => def.kind === 'OperationDefinition' && def.name);
+    if (namedOperations.length === 0) {
+        throw new Error('No named operations found in document. ' + 'At least one named operation is required for proto compilation.');
+    }
+    if (namedOperations.length > 1) {
+        const operationNames = namedOperations.map((op) => op.name.value).join(', ');
+        throw new Error(`Multiple operations found in document: ${operationNames}. ` +
+            'Only a single named operation per document is supported for proto reversibility. ' +
+            'Please compile each operation separately.');
+    }
+    const schema = typeof schemaOrSDL === 'string'
+        ? buildSchema(schemaOrSDL, {
+            assumeValid: true,
+            assumeValidSDL: true,
+        })
+        : schemaOrSDL;
+    // Validate the GraphQL operation document against the schema
+    // This catches invalid operations including circular fragment references (NoFragmentCyclesRule)
+    // Filter out KnownDirectivesRule to allow unknown directives (e.g., @wg_openapi_operation)
+    // since directives may be used by dev tools and don't affect proto generation
+    const validationRules = specifiedRules.filter((rule) => rule !== KnownDirectivesRule);
+    const validationErrors = validate(schema, document, validationRules);
+    if (validationErrors.length > 0) {
+        const errorMessages = validationErrors.map((error) => error.message).join('\n');
+        throw new Error(`Invalid GraphQL operation:\n${errorMessages}`);
+    }
+    const visitor = new OperationsToProtoVisitor(document, schema, options);
+    const root = visitor.visit();
+    const proto = visitor.toProtoText(root);
+    // Get the updated lock data for field number stability
+    const lockData = visitor.getLockData();
+    return { proto, root, lockData };
+}
+/**
+ * Visitor that converts GraphQL operations to protocol buffer definition using protobufjs ast
+ */
+class OperationsToProtoVisitor {
+    constructor(document, schema, options) {
+        var _a, _b;
+        // For tracking / avoiding duplicate messages and enums
+        this.createdMessages = new Set();
+        this.createdEnums = new Set();
+        // Track generated nested list wrapper messages
+        this.nestedListWrappers = new Map();
+        // Fragment definitions map
+        this.fragments = new Map();
+        this.document = document;
+        this.schema = schema;
+        this.serviceName = (options === null || options === void 0 ? void 0 : options.serviceName) || 'DefaultService';
+        this.packageName = (options === null || options === void 0 ? void 0 : options.packageName) || 'service.v1';
+        this.goPackage = options === null || options === void 0 ? void 0 : options.goPackage;
+        this.javaPackage = options === null || options === void 0 ? void 0 : options.javaPackage;
+        this.javaOuterClassname = options === null || options === void 0 ? void 0 : options.javaOuterClassname;
+        this.javaMultipleFiles = options === null || options === void 0 ? void 0 : options.javaMultipleFiles;
+        this.csharpNamespace = options === null || options === void 0 ? void 0 : options.csharpNamespace;
+        this.rubyPackage = options === null || options === void 0 ? void 0 : options.rubyPackage;
+        this.phpNamespace = options === null || options === void 0 ? void 0 : options.phpNamespace;
+        this.phpMetadataNamespace = options === null || options === void 0 ? void 0 : options.phpMetadataNamespace;
+        this.objcClassPrefix = options === null || options === void 0 ? void 0 : options.objcClassPrefix;
+        this.swiftPrefix = options === null || options === void 0 ? void 0 : options.swiftPrefix;
+        this.includeComments = (_a = options === null || options === void 0 ? void 0 : options.includeComments) !== null && _a !== void 0 ? _a : true;
+        this.queryIdempotency = options === null || options === void 0 ? void 0 : options.queryIdempotency;
+        this.customScalarMappings = options === null || options === void 0 ? void 0 : options.customScalarMappings;
+        this.maxDepth = options === null || options === void 0 ? void 0 : options.maxDepth;
+        this.prefixOperationType = (_b = options === null || options === void 0 ? void 0 : options.prefixOperationType) !== null && _b !== void 0 ? _b : false;
+        // Initialize lock manager with previous lock data if provided
+        this.lockManager = new ProtoLockManager(options === null || options === void 0 ? void 0 : options.lockData);
+        // Create field number manager with lock manager integration
+        this.fieldNumberManager = createFieldNumberManager(this.lockManager);
+        this.root = new protobuf.Root();
+        // Collect all fragment definitions from the document
+        this.collectFragments();
+    }
+    /**
+     * Collects all fragment definitions from the document
+     */
+    collectFragments() {
+        for (const definition of this.document.definitions) {
+            if (definition.kind === 'FragmentDefinition') {
+                this.fragments.set(definition.name.value, definition);
+            }
+        }
+    }
+    visit() {
+        const service = new protobuf.Service(this.serviceName);
+        const typeInfo = new TypeInfo(this.schema);
+        // Visit each operation definition
+        visit(this.document, visitWithTypeInfo(typeInfo, {
+            OperationDefinition: (node) => {
+                this.processOperation(node, service, typeInfo);
+                // Don't traverse deeper - we handle selection sets manually
+                return false;
+            },
+        }));
+        // Add all wrapper messages to root before adding service
+        for (const wrapperMessage of this.nestedListWrappers.values()) {
+            if (!this.createdMessages.has(wrapperMessage.name)) {
+                this.root.add(wrapperMessage);
+                this.createdMessages.add(wrapperMessage.name);
+            }
+        }
+        this.root.add(service);
+        return this.root;
+    }
+    processOperation(node, service, typeInfo) {
+        var _a;
+        // 1. Extract operation name
+        const operationName = (_a = node.name) === null || _a === void 0 ? void 0 : _a.value;
+        if (!operationName) {
+            // Skip anonymous operations
+            return;
+        }
+        // 2. Validate no root-level field aliases (breaks reversibility)
+        if (node.selectionSet) {
+            for (const selection of node.selectionSet.selections) {
+                if (selection.kind === 'Field' && selection.alias) {
+                    throw new Error(`Root-level field alias "${selection.alias.value}: ${selection.name.value}" is not supported. ` +
+                        'Field aliases at the root level break proto-to-GraphQL reversibility. ' +
+                        'Please remove the alias or use it only on nested fields.');
+                }
+            }
+        }
+        // 3. Create method name from operation name, optionally prefixed with operation type
+        let methodName = upperFirst(camelCase(operationName));
+        // Add operation type prefix if requested
+        if (this.prefixOperationType) {
+            const operationTypePrefix = upperFirst(node.operation.toLowerCase());
+            methodName = `${operationTypePrefix}${methodName}`;
+        }
+        // 4. Create request message from variables
+        const requestMessageName = createRequestMessageName(methodName);
+        const requestMessage = buildRequestMessage(requestMessageName, node.variableDefinitions || [], this.schema, {
+            includeComments: this.includeComments,
+            fieldNumberManager: this.fieldNumberManager,
+            schema: this.schema,
+            customScalarMappings: this.customScalarMappings,
+            ensureNestedListWrapper: this.createNestedListWrapperCallback.bind(this),
+        });
+        // Add request message to root
+        if (!this.createdMessages.has(requestMessageName)) {
+            this.root.add(requestMessage);
+            this.createdMessages.add(requestMessageName);
+        }
+        // 3.5. Process any input object types referenced in variables
+        if (node.variableDefinitions) {
+            for (const varDef of node.variableDefinitions) {
+                this.processInputObjectTypes(varDef.type);
+            }
+        }
+        // 6. Create response message from selection set
+        const responseMessageName = createResponseMessageName(methodName);
+        if (node.selectionSet) {
+            const rootType = this.getRootType(node.operation);
+            const responseMessage = buildMessageFromSelectionSet(responseMessageName, node.selectionSet, rootType, typeInfo, {
+                includeComments: this.includeComments,
+                root: this.root,
+                fieldNumberManager: this.fieldNumberManager,
+                fragments: this.fragments,
+                schema: this.schema,
+                createdEnums: this.createdEnums,
+                customScalarMappings: this.customScalarMappings,
+                maxDepth: this.maxDepth,
+                ensureNestedListWrapper: this.createNestedListWrapperCallback.bind(this),
+            });
+            // Add response message to root
+            if (!this.createdMessages.has(responseMessageName)) {
+                this.root.add(responseMessage);
+                this.createdMessages.add(responseMessageName);
+            }
+        }
+        // 7. Add method to service
+        const method = new protobuf.Method(methodName, 'rpc', requestMessageName, responseMessageName);
+        // Mark subscriptions as server streaming
+        if (node.operation === OperationTypeNode.SUBSCRIPTION) {
+            method.responseStream = true;
+        }
+        // Mark Query operations with idempotency level if specified
+        if (this.queryIdempotency && node.operation === OperationTypeNode.QUERY) {
+            const methodWithIdempotency = method;
+            methodWithIdempotency.idempotencyLevel = this.queryIdempotency;
+        }
+        service.add(method);
+    }
+    /**
+     * Convert protobufjs Root to proto text format
+     */
+    toProtoText(root) {
+        return rootToProtoText(root, {
+            packageName: this.packageName,
+            goPackage: this.goPackage,
+            javaPackage: this.javaPackage,
+            javaOuterClassname: this.javaOuterClassname,
+            javaMultipleFiles: this.javaMultipleFiles,
+            csharpNamespace: this.csharpNamespace,
+            rubyPackage: this.rubyPackage,
+            phpNamespace: this.phpNamespace,
+            phpMetadataNamespace: this.phpMetadataNamespace,
+            objcClassPrefix: this.objcClassPrefix,
+            swiftPrefix: this.swiftPrefix,
+            includeComments: this.includeComments,
+        });
+    }
+    /**
+     * Process input object types and enums referenced in a type node
+     */
+    processInputObjectTypes(typeNode) {
+        // Handle NonNullType and ListType wrappers
+        if (typeNode.kind === 'NonNullType' || typeNode.kind === 'ListType') {
+            this.processInputObjectTypes(typeNode.type);
+            return;
+        }
+        // Handle NamedType
+        if (typeNode.kind === 'NamedType') {
+            const typeName = typeNode.name.value;
+            const type = this.schema.getType(typeName);
+            if (type && isInputObjectType(type)) {
+                // Create message for this input object if not already created
+                if (!this.createdMessages.has(typeName)) {
+                    const inputMessage = buildInputObjectMessage(type, {
+                        includeComments: this.includeComments,
+                        fieldNumberManager: this.fieldNumberManager,
+                        customScalarMappings: this.customScalarMappings,
+                        ensureNestedListWrapper: this.createNestedListWrapperCallback.bind(this),
+                    });
+                    this.root.add(inputMessage);
+                    this.createdMessages.add(typeName);
+                    // Recursively process nested input objects and enums
+                    const fields = type.getFields();
+                    for (const field of Object.values(fields)) {
+                        const fieldType = getNamedType(field.type);
+                        if (isInputObjectType(fieldType)) {
+                            const namedTypeNode = {
+                                kind: Kind.NAMED_TYPE,
+                                name: { kind: Kind.NAME, value: fieldType.name },
+                            };
+                            this.processInputObjectTypes(namedTypeNode);
+                        }
+                        else if (isEnumType(fieldType)) {
+                            this.processEnumType(fieldType);
+                        }
+                    }
+                }
+            }
+            else if (type && isEnumType(type)) {
+                // Create enum type if not already created
+                this.processEnumType(type);
+            }
+        }
+    }
+    /**
+     * Process and add an enum type to the proto root
+     */
+    processEnumType(enumType) {
+        const typeName = enumType.name;
+        if (!this.createdEnums.has(typeName)) {
+            const protoEnum = buildEnumType(enumType, {
+                includeComments: this.includeComments,
+            });
+            this.root.add(protoEnum);
+            this.createdEnums.add(typeName);
+        }
+    }
+    /**
+     * Helper: Get root operation type
+     */
+    getRootType(operationType) {
+        switch (operationType) {
+            case OperationTypeNode.QUERY:
+                return this.schema.getQueryType();
+            case OperationTypeNode.MUTATION:
+                return this.schema.getMutationType();
+            case OperationTypeNode.SUBSCRIPTION:
+                return this.schema.getSubscriptionType();
+        }
+    }
+    /**
+     * Get the current lock data for field number stability
+     */
+    getLockData() {
+        return this.lockManager.getLockData();
+    }
+    /**
+     * Creates wrapper messages for nested GraphQL lists
+     * Similar to sdl-to-proto-visitor.ts createNestedListWrapper
+     *
+     * @param level - The nesting level (1 for simple wrapper, >1 for nested structures)
+     * @param baseTypeName - The base type name being wrapped (e.g., "String", "User")
+     * @returns The generated wrapper message
+     */
+    createNestedListWrapper(level, baseTypeName) {
+        const wrapperName = `${'ListOf'.repeat(level)}${baseTypeName}`;
+        // Return existing wrapper if already created
+        if (this.nestedListWrappers.has(wrapperName)) {
+            return this.nestedListWrappers.get(wrapperName);
+        }
+        // Create the wrapper message
+        const wrapperMessage = new protobuf.Type(wrapperName);
+        // Create nested List message
+        const listMessage = new protobuf.Type('List');
+        // Determine the inner type name
+        let innerTypeName;
+        if (level > 1) {
+            // For nested lists, reference the previous level wrapper
+            innerTypeName = `${'ListOf'.repeat(level - 1)}${baseTypeName}`;
+            // Ensure the inner wrapper exists
+            if (!this.nestedListWrappers.has(innerTypeName)) {
+                this.createNestedListWrapper(level - 1, baseTypeName);
+            }
+        }
+        else {
+            // For level 1, use the base type directly
+            innerTypeName = baseTypeName;
+        }
+        // Add repeated items field to List message
+        const itemsField = new protobuf.Field('items', 1, innerTypeName);
+        itemsField.repeated = true;
+        listMessage.add(itemsField);
+        // Add List message to wrapper
+        wrapperMessage.add(listMessage);
+        // Add list field to wrapper message
+        const listField = new protobuf.Field('list', 1, 'List');
+        wrapperMessage.add(listField);
+        // Store the wrapper
+        this.nestedListWrappers.set(wrapperName, wrapperMessage);
+        return wrapperMessage;
+    }
+    /**
+     * Callback for builders to create nested list wrappers
+     * This method is called by request-builder and message-builder when they encounter
+     * a GraphQL type that requires a nested list wrapper
+     *
+     * @param graphqlType - The GraphQL type that needs a wrapper
+     * @returns The wrapper message name
+     */
+    createNestedListWrapperCallback(graphqlType) {
+        const typeInfo = mapGraphQLTypeToProto(graphqlType, {
+            customScalarMappings: this.customScalarMappings,
+        });
+        if (!typeInfo.requiresNestedWrapper) {
+            // This shouldn't happen, but return the type name as fallback
+            return typeInfo.typeName;
+        }
+        // Create the wrapper message
+        const wrapperName = typeInfo.typeName;
+        const nestingLevel = typeInfo.nestingLevel || 1;
+        // Extract base type name from wrapper name
+        // e.g., "ListOfListOfString" -> "String"
+        const baseTypeName = wrapperName.replace(/^(ListOf)+/, '');
+        // Ensure all wrapper levels are created
+        if (!this.nestedListWrappers.has(wrapperName) && !this.createdMessages.has(wrapperName)) {
+            for (let i = 1; i <= nestingLevel; i++) {
+                this.createNestedListWrapper(i, baseTypeName);
+            }
+        }
+        return wrapperName;
+    }
+}
+//# sourceMappingURL=operation-to-proto.js.map

package/dist/src/operation-to-proto.js.map

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

package/dist/src/operations/field-numbering.d.ts

@@ -0,0 +1,73 @@
+import { ProtoLockManager } from '../proto-lock.js';
+/**
+ * Field numbering manager for Protocol Buffer messages
+ *
+ * This module handles the assignment and tracking of field numbers
+ * across multiple proto messages to ensure uniqueness within each message.
+ * Integrates with ProtoLockManager for field number stability across compilations.
+ */
+/**
+ * Manages field number assignment for a collection of messages
+ */
+export interface FieldNumberManager {
+    /**
+     * Gets the next available field number for a given message
+     * @param messageName - The name of the message
+     * @returns The next available field number
+     */
+    getNextFieldNumber(messageName: string): number;
+    /**
+     * Assigns a specific field number to a field in a message
+     * @param messageName - The name of the message
+     * @param fieldName - The name of the field
+     * @param fieldNumber - The field number to assign
+     */
+    assignFieldNumber(messageName: string, fieldName: string, fieldNumber: number): void;
+    /**
+     * Gets the field number for a specific field if it exists
+     * @param messageName - The name of the message
+     * @param fieldName - The name of the field
+     * @returns The field number or undefined if not assigned
+     */
+    getFieldNumber(messageName: string, fieldName: string): number | undefined;
+    /**
+     * Resets field numbering for a specific message
+     * @param messageName - The name of the message to reset
+     */
+    resetMessage(messageName: string): void;
+    /**
+     * Resets all field numbering
+     */
+    resetAll(): void;
+    /**
+     * Gets all field mappings for a message
+     * @param messageName - The name of the message
+     * @returns Record of field names to field numbers
+     */
+    getMessageFields(messageName: string): Record<string, number>;
+    /**
+     * Reconciles field order for a message using lock data
+     * @param messageName - The name of the message
+     * @param fieldNames - The field names to reconcile
+     * @returns Ordered array of field names
+     */
+    reconcileFieldOrder(messageName: string, fieldNames: string[]): string[];
+    /**
+     * Gets the lock manager if available
+     */
+    getLockManager(): ProtoLockManager | undefined;
+}
+/**
+ * Creates a new field number manager instance
+ *
+ * @param lockManager - Optional ProtoLockManager for field number stability
+ * @returns A new field number manager
+ */
+export declare function createFieldNumberManager(lockManager?: ProtoLockManager): FieldNumberManager;
+/**
+ * Assigns field numbers to a message from lock data
+ * @param messageName - The name of the message
+ * @param fieldNames - The field names to assign numbers to
+ * @param fieldNumberManager - The field number manager to use
+ */
+export declare function assignFieldNumbersFromLockData(messageName: string, fieldNames: string[], fieldNumberManager?: FieldNumberManager): void;