@wundergraph/protographic 0.1.0

package/dist/src/sdl-to-mapping-visitor.js.map

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

package/dist/src/sdl-to-proto-visitor.d.ts

@@ -0,0 +1,278 @@
+import { GraphQLSchema } from 'graphql';
+import { ProtoLock } from './proto-lock.js';
+/**
+ * Options for GraphQLToProtoTextVisitor
+ */
+export interface GraphQLToProtoTextVisitorOptions {
+    serviceName?: string;
+    packageName?: string;
+    goPackage?: string;
+    lockData?: ProtoLock;
+    /** Whether to include descriptions/comments from GraphQL schema */
+    includeComments?: boolean;
+}
+/**
+ * Visitor that converts GraphQL SDL to Protocol Buffer text definition
+ *
+ * This visitor traverses a GraphQL schema and generates a Protocol Buffer
+ * service and message definitions. It handles:
+ *
+ * 1. GraphQL scalars, objects, interfaces, unions, and enums
+ * 2. Federation entity types with @key directives
+ * 3. Query and Mutation operations as RPC methods
+ * 4. Field and argument mappings with proper naming conventions
+ * 5. Comments/descriptions from GraphQL types and fields
+ *
+ * The visitor uses a queue-based approach to resolve dependencies between
+ * types and ensure all referenced types are processed.
+ */
+export declare class GraphQLToProtoTextVisitor {
+    /** The GraphQL schema being converted */
+    private readonly schema;
+    /** The name of the Protocol Buffer service */
+    private readonly serviceName;
+    /** The lock manager for deterministic ordering */
+    private readonly lockManager;
+    /** Generated proto lock data */
+    private generatedLockData;
+    /** Accumulates the Protocol Buffer definition text */
+    private protoText;
+    /** Current indentation level for formatted output */
+    private indent;
+    /** Whether to include descriptions/comments from GraphQL schema */
+    private includeComments;
+    /** Tracks types that have already been processed to avoid duplication */
+    private processedTypes;
+    /** Queue of types that need to be converted to Proto messages */
+    private messageQueue;
+    /** Track generated nested list wrapper messages */
+    private nestedListWrappers;
+    /**
+     * Map of message names to their field numbers for tracking deleted fields
+     * This maintains field numbers even when fields are removed from the schema
+     */
+    private fieldNumbersMap;
+    /**
+     * Creates a new visitor to convert a GraphQL schema to Protocol Buffers
+     *
+     * @param schema - The GraphQL schema to convert
+     * @param options - Configuration options for the visitor
+     */
+    constructor(schema: GraphQLSchema, options?: GraphQLToProtoTextVisitorOptions);
+    /**
+     * Initialize the field numbers map from the lock data to preserve field numbers
+     * even when fields are removed and later re-added
+     */
+    private initializeFieldNumbersMap;
+    /**
+     * Track removed fields for a given message type between schema updates.
+     * This ensures that when fields are removed within a single operation,
+     * their numbers are properly reserved.
+     *
+     * @param typeName - The message type name
+     * @param originalFieldNames - Original field names from the lock data
+     * @param currentFieldNames - Current field names from the schema
+     */
+    private trackRemovedFields;
+    /**
+     * Track removed enum values for a given enum type.
+     *
+     * @param enumName - The enum type name
+     * @param originalValueNames - Original enum value names from the lock data
+     * @param currentValueNames - Current enum value names from the schema
+     */
+    private trackRemovedEnumValues;
+    /**
+     * Get the proper field number for a field in a message, respecting the lock.
+     * This preserves field numbers for fields that were removed and later re-added.
+     */
+    private getFieldNumber;
+    /**
+     * Get the next available field number for a message, taking care to avoid
+     * collisions with existing field numbers, including for fields that were
+     * removed from the schema but may be re-added in the future.
+     */
+    private getNextAvailableFieldNumber;
+    /**
+     * Visit the GraphQL schema to generate Proto buffer definition
+     *
+     * @returns The complete Protocol Buffer definition as a string
+     */
+    visit(): string;
+    /**
+     * Collects RPC methods for entity types (types with @key directive)
+     *
+     * This method identifies entity types and creates lookup RPC methods
+     * for them without generating the request/response messages yet.
+     *
+     * @returns Object containing RPC methods and message definitions
+     */
+    private collectEntityRpcMethods;
+    /**
+     * Collects RPC methods for query operations
+     *
+     * @returns Object containing RPC methods and message definitions
+     */
+    private collectQueryRpcMethods;
+    /**
+     * Collects RPC methods for mutation operations
+     *
+     * @returns Object containing RPC methods and message definitions
+     */
+    private collectMutationRpcMethods;
+    /**
+     * Shared method to collect RPC methods for query or mutation operations
+     */
+    private collectOperationRpcMethods;
+    /**
+     * Queue a type for processing if not already processed
+     */
+    private queueTypeForProcessing;
+    /**
+     * Queue a field's return type for processing if it's a complex type
+     */
+    private queueFieldTypeForProcessing;
+    /**
+     * Create an RPC method definition with optional comment
+     *
+     * @param methodName - The name of the RPC method
+     * @param requestName - The request message name
+     * @param responseName - The response message name
+     * @param description - Optional description for the method
+     * @returns The RPC method definition with or without comment
+     */
+    private createRpcMethod;
+    /**
+     * Creates a request message for entity lookup without adding to protoText
+     */
+    private createKeyRequestMessage;
+    /**
+     * Creates a response message for entity lookup without adding to protoText
+     */
+    private createKeyResponseMessage;
+    /**
+     * Creates a request message for a query/mutation field
+     */
+    private createFieldRequestMessage;
+    /**
+     * Creates a response message for a query/mutation field
+     */
+    private createFieldResponseMessage;
+    /**
+     * Extract key fields from a directive
+     *
+     * The @key directive specifies which fields form the entity's primary key.
+     * We extract these for creating appropriate lookup methods.
+     *
+     * @param directive - The @key directive from the GraphQL AST
+     * @returns Array of field names that form the key
+     */
+    private getKeyFieldsFromDirective;
+    /**
+     * Queue all types from the schema that need processing
+     */
+    private queueAllSchemaTypes;
+    /**
+     * Process all queued complex types for message generation
+     *
+     * This is a key method that processes the message queue to generate
+     * Protocol Buffer messages for all complex types. The queue approach ensures:
+     *
+     * 1. All referenced types are eventually processed
+     * 2. Types are only processed once (avoids duplication)
+     * 3. Circular references are handled properly
+     * 4. Dependencies between types are resolved correctly
+     */
+    private processMessageQueue;
+    /**
+     * Process a GraphQL object type to a Proto message
+     *
+     * Converts a GraphQL object type to a Protocol Buffer message with
+     * fields corresponding to the GraphQL object fields.
+     *
+     * @param type - The GraphQL object type
+     */
+    private processObjectType;
+    /**
+     * Process a GraphQL input object type to a Proto message
+     *
+     * Converts a GraphQL input object type to a Protocol Buffer message
+     * with fields corresponding to the GraphQL input object fields.
+     *
+     * @param type - The GraphQL input object type
+     */
+    private processInputObjectType;
+    /**
+     * Process a GraphQL interface type
+     *
+     * In Protocol Buffers, we handle interfaces using the 'oneof' feature
+     * with all implementing types as options. This allows for polymorphic
+     * behavior similar to GraphQL interfaces.
+     *
+     * @param type - The GraphQL interface type
+     */
+    private processInterfaceType;
+    /**
+     * Process a GraphQL union type
+     *
+     * Similar to interfaces, we handle GraphQL unions using Protocol Buffer's
+     * 'oneof' feature with all member types as options.
+     *
+     * @param type - The GraphQL union type
+     */
+    private processUnionType;
+    /**
+     * Process a GraphQL enum type to a Proto enum
+     *
+     * Converts a GraphQL enum to a Protocol Buffer enum. Note that Proto3
+     * requires the first enum value to be zero, so we add an UNSPECIFIED value.
+     *
+     * @param type - The GraphQL enum type
+     */
+    private processEnumType;
+    /**
+     * Map GraphQL type to Protocol Buffer type
+     *
+     * Determines the appropriate Protocol Buffer type for a given GraphQL type,
+     * handling all GraphQL type wrappers (NonNull, List) correctly.
+     *
+     * @param graphqlType - The GraphQL type to convert
+     * @returns The corresponding Protocol Buffer type name
+     */
+    private getProtoTypeFromGraphQL;
+    /**
+     * Create a nested list wrapper message for the given base type
+     */
+    private createNestedListWrapper;
+    /**
+     * Get indentation based on the current level
+     *
+     * Helper method to maintain consistent indentation in the output.
+     *
+     * @returns String with spaces for the current indentation level
+     */
+    private getIndent;
+    /**
+     * Get the generated lock data after visiting
+     *
+     * @returns The generated ProtoLock data, or null if visit() hasn't been called
+     */
+    getGeneratedLockData(): ProtoLock | null;
+    /**
+     * Format reserved numbers for Proto syntax
+     *
+     * Formats a list of reserved field numbers for inclusion in a Proto message.
+     * This handles both individual numbers and ranges.
+     *
+     * @param numbers - The field numbers to be reserved
+     * @returns A formatted string for the reserved statement
+     */
+    private formatReservedNumbers;
+    /**
+     * Convert a GraphQL description to Protocol Buffer comment
+     * @param description - The GraphQL description text
+     * @param indentLevel - The level of indentation for the comment (in number of 2-space blocks)
+     * @returns Array of comment lines with proper indentation
+     */
+    private formatComment;
+}