@wundergraph/protographic 0.15.6 → 0.16.1

package/dist/src/selection-set-validation-visitor.d.ts

@@ -0,0 +1,112 @@
+import { DocumentNode, GraphQLObjectType } from 'graphql';
+import { ValidationResult } from './sdl-validation-visitor.js';
+/**
+ * Validates selection sets within @requires directive field sets.
+ *
+ * This visitor traverses a parsed field set document and enforces constraints
+ * specific to @requires directives:
+ * - Abstract types (interfaces, unions) are not allowed
+ * - Inline fragments are not allowed
+ *
+ * @example
+ * ```typescript
+ * const doc = parse('{ address { street city } }');
+ * const visitor = new SelectionSetValidationVisitor(doc, ProductType);
+ * visitor.visit();
+ * const result = visitor.getValidationResult();
+ * if (result.errors.length > 0) {
+ *   console.error('Validation failed:', result.errors);
+ * }
+ * ```
+ */
+export declare class SelectionSetValidationVisitor {
+    private currentType;
+    private ancestors;
+    private readonly operationDocument;
+    private validationResult;
+    /**
+     * Creates a new SelectionSetValidationVisitor.
+     *
+     * @param operationDocument - The parsed GraphQL document representing the field set
+     * @param objectType - The root GraphQL object type to validate against
+     */
+    constructor(operationDocument: DocumentNode, objectType: GraphQLObjectType);
+    /**
+     * Executes the validation by traversing the operation document.
+     * After calling this method, use `getValidationResult()` to retrieve any errors or warnings.
+     */
+    visit(): void;
+    /**
+     * Returns the validation result containing any errors and warnings found during traversal.
+     *
+     * @returns The validation result with errors and warnings arrays
+     */
+    getValidationResult(): ValidationResult;
+    /**
+     * Creates the AST visitor configuration for traversing the document.
+     *
+     * @returns An ASTVisitor object with handlers for Field and SelectionSet nodes
+     */
+    private createASTVisitor;
+    /**
+     * Handles entering a field node during traversal.
+     * Validates that the field's type is not an abstract type (interface or union).
+     *
+     * @param ctx - The visit context containing the field node and its ancestors
+     * @returns BREAK if validation fails to stop traversal, undefined otherwise
+     */
+    private onEnterField;
+    /**
+     * Unwraps a GraphQL type to get its underlying named type.
+     * Strips NonNull and List wrappers to get the base type.
+     *
+     * @param type - The GraphQL type to unwrap
+     * @returns The underlying named type
+     */
+    private getUnderlyingType;
+    /**
+     * Retrieves the field definition for a field node from the current type.
+     * If the field is not found, a validation error is recorded and null is returned.
+     *
+     * @param node - The field node to look up
+     * @returns The GraphQL field definition, or null if not found
+     */
+    private getFieldDefinition;
+    /**
+     * Handles entering a selection set node during traversal.
+     * Validates that inline fragments are not used and updates the current type
+     * context when descending into nested object types.
+     *
+     * @param ctx - The visit context containing the selection set node and its parent
+     * @returns BREAK if validation fails to stop traversal, undefined otherwise
+     */
+    private onEnterSelectionSet;
+    /**
+     * Handles leaving a selection set node during traversal.
+     * Restores the previous type context when ascending back up the tree.
+     *
+     * @param ctx - The visit context containing the selection set node and its parent
+     */
+    private onLeaveSelectionSet;
+    /**
+     * Type guard to check if a node is an InlineFragmentNode.
+     *
+     * @param node - The AST node or array of nodes to check
+     * @returns True if the node is an InlineFragmentNode
+     */
+    private isInlineFragment;
+    /**
+     * Type guard to check if a node is a FieldNode.
+     *
+     * @param node - The AST node or array of nodes to check
+     * @returns True if the node is a FieldNode
+     */
+    private isFieldNode;
+    /**
+     * Checks if a named type is an abstract type (interface or union).
+     *
+     * @param node - The GraphQL named type to check
+     * @returns True if the type is an interface or union type
+     */
+    private isAbstractType;
+}

package/dist/src/selection-set-validation-visitor.js

@@ -0,0 +1,199 @@
+import { BREAK, isInterfaceType, isNamedType, isObjectType, isUnionType, Kind, visit, } from 'graphql';
+/**
+ * Validates selection sets within @requires directive field sets.
+ *
+ * This visitor traverses a parsed field set document and enforces constraints
+ * specific to @requires directives:
+ * - Abstract types (interfaces, unions) are not allowed
+ * - Inline fragments are not allowed
+ *
+ * @example
+ * ```typescript
+ * const doc = parse('{ address { street city } }');
+ * const visitor = new SelectionSetValidationVisitor(doc, ProductType);
+ * visitor.visit();
+ * const result = visitor.getValidationResult();
+ * if (result.errors.length > 0) {
+ *   console.error('Validation failed:', result.errors);
+ * }
+ * ```
+ */
+export class SelectionSetValidationVisitor {
+    /**
+     * Creates a new SelectionSetValidationVisitor.
+     *
+     * @param operationDocument - The parsed GraphQL document representing the field set
+     * @param objectType - The root GraphQL object type to validate against
+     */
+    constructor(operationDocument, objectType) {
+        this.ancestors = [];
+        this.validationResult = {
+            errors: [],
+            warnings: [],
+        };
+        this.operationDocument = operationDocument;
+        this.currentType = objectType;
+    }
+    /**
+     * Executes the validation by traversing the operation document.
+     * After calling this method, use `getValidationResult()` to retrieve any errors or warnings.
+     */
+    visit() {
+        visit(this.operationDocument, this.createASTVisitor());
+    }
+    /**
+     * Returns the validation result containing any errors and warnings found during traversal.
+     *
+     * @returns The validation result with errors and warnings arrays
+     */
+    getValidationResult() {
+        return this.validationResult;
+    }
+    /**
+     * Creates the AST visitor configuration for traversing the document.
+     *
+     * @returns An ASTVisitor object with handlers for Field and SelectionSet nodes
+     */
+    createASTVisitor() {
+        return {
+            Field: {
+                enter: (node, key, parent, path, ancestors) => {
+                    return this.onEnterField({ node, key, parent, path, ancestors });
+                },
+            },
+            SelectionSet: {
+                enter: (node, key, parent, path, ancestors) => {
+                    return this.onEnterSelectionSet({ node, key, parent, path, ancestors });
+                },
+                leave: (node, key, parent, path, ancestors) => {
+                    this.onLeaveSelectionSet({ node, key, parent, path, ancestors });
+                },
+            },
+        };
+    }
+    /**
+     * Handles entering a field node during traversal.
+     * Validates that the field's type is not an abstract type (interface or union).
+     *
+     * @param ctx - The visit context containing the field node and its ancestors
+     * @returns BREAK if validation fails to stop traversal, undefined otherwise
+     */
+    onEnterField(ctx) {
+        const fieldDefinition = this.getFieldDefinition(ctx.node);
+        if (!fieldDefinition) {
+            return false;
+        }
+        const namedType = this.getUnderlyingType(fieldDefinition.type);
+        if (this.isAbstractType(namedType)) {
+            this.validationResult.errors.push(`Abstract types are not allowed in requires directives. Found ${namedType.name} in ${this.currentType.name}.${ctx.node.name.value}`);
+            return BREAK;
+        }
+    }
+    /**
+     * Unwraps a GraphQL type to get its underlying named type.
+     * Strips NonNull and List wrappers to get the base type.
+     *
+     * @param type - The GraphQL type to unwrap
+     * @returns The underlying named type
+     */
+    getUnderlyingType(type) {
+        while (!isNamedType(type)) {
+            type = type.ofType;
+        }
+        return type;
+    }
+    /**
+     * Retrieves the field definition for a field node from the current type.
+     * If the field is not found, a validation error is recorded and null is returned.
+     *
+     * @param node - The field node to look up
+     * @returns The GraphQL field definition, or null if not found
+     */
+    getFieldDefinition(node) {
+        const fieldDef = this.currentType.getFields()[node.name.value];
+        if (!fieldDef) {
+            this.validationResult.errors.push(`Field '${node.name.value}' not found on type '${this.currentType.name}'`);
+            return null;
+        }
+        return fieldDef;
+    }
+    /**
+     * Handles entering a selection set node during traversal.
+     * Validates that inline fragments are not used and updates the current type
+     * context when descending into nested object types.
+     *
+     * @param ctx - The visit context containing the selection set node and its parent
+     * @returns BREAK if validation fails to stop traversal, undefined otherwise
+     */
+    onEnterSelectionSet(ctx) {
+        if (!ctx.parent) {
+            return;
+        }
+        if (this.isInlineFragment(ctx.parent)) {
+            this.validationResult.errors.push('Inline fragments are not allowed in requires directives');
+            return BREAK;
+        }
+        if (!this.isFieldNode(ctx.parent)) {
+            return;
+        }
+        const fieldDefinition = this.getFieldDefinition(ctx.parent);
+        if (!fieldDefinition) {
+            return;
+        }
+        const namedType = this.getUnderlyingType(fieldDefinition.type);
+        if (isObjectType(namedType)) {
+            this.ancestors.push(this.currentType);
+            this.currentType = namedType;
+        }
+    }
+    /**
+     * Handles leaving a selection set node during traversal.
+     * Restores the previous type context when ascending back up the tree.
+     *
+     * @param ctx - The visit context containing the selection set node and its parent
+     */
+    onLeaveSelectionSet(ctx) {
+        var _a;
+        if (!ctx.parent) {
+            return;
+        }
+        if (!this.isFieldNode(ctx.parent)) {
+            return;
+        }
+        this.currentType = (_a = this.ancestors.pop()) !== null && _a !== void 0 ? _a : this.currentType;
+    }
+    /**
+     * Type guard to check if a node is an InlineFragmentNode.
+     *
+     * @param node - The AST node or array of nodes to check
+     * @returns True if the node is an InlineFragmentNode
+     */
+    isInlineFragment(node) {
+        if (Array.isArray(node)) {
+            return false;
+        }
+        return node.kind === Kind.INLINE_FRAGMENT;
+    }
+    /**
+     * Type guard to check if a node is a FieldNode.
+     *
+     * @param node - The AST node or array of nodes to check
+     * @returns True if the node is a FieldNode
+     */
+    isFieldNode(node) {
+        if (Array.isArray(node)) {
+            return false;
+        }
+        return node.kind === Kind.FIELD;
+    }
+    /**
+     * Checks if a named type is an abstract type (interface or union).
+     *
+     * @param node - The GraphQL named type to check
+     * @returns True if the type is an interface or union type
+     */
+    isAbstractType(node) {
+        return isInterfaceType(node) || isUnionType(node);
+    }
+}
+//# sourceMappingURL=selection-set-validation-visitor.js.map

package/dist/src/selection-set-validation-visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-set-validation-visitor.js","sourceRoot":"","sources":["../../src/selection-set-validation-visitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EAQL,eAAe,EACf,WAAW,EACX,YAAY,EACZ,WAAW,EACX,IAAI,EAEJ,KAAK,GACN,MAAM,SAAS,CAAC;AAIjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,6BAA6B;IAUxC;;;;;OAKG;IACH,YAAY,iBAA+B,EAAE,UAA6B;QAdlE,cAAS,GAAwB,EAAE,CAAC;QAGpC,qBAAgB,GAAqB;YAC3C,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACb,CAAC;QASA,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAC3C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,KAAK;QACV,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;;;OAIG;IACI,mBAAmB;QACxB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACK,gBAAgB;QACtB,OAAO;YACL,KAAK,EAAE;gBACL,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;oBAC5C,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBACnE,CAAC;aACF;YACD,YAAY,EAAE;gBACZ,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;oBAC5C,OAAO,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;oBAC5C,IAAI,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;gBACnE,CAAC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,GAA4B;QAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAC/B,gEAAgE,SAAS,CAAC,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CACpI,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,iBAAiB,CAAC,IAAiB;QACzC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACK,kBAAkB,CAAC,IAAe;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,wBAAwB,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;YAC7G,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;OAOG;IACK,mBAAmB,CAAC,GAAmC;QAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;YAC7F,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,mBAAmB,CAAC,GAAmC;;QAC7D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,MAAA,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,mCAAI,IAAI,CAAC,WAAW,CAAC;IAC9D,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,IAAkC;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAQ,IAAgB,CAAC,IAAI,KAAK,IAAI,CAAC,eAAe,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,IAAsC;QACxD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAQ,IAAgB,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,IAAsB;QAC3C,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/src/string-constants.d.ts

@@ -1,3 +1,7 @@
+export declare const KEY_DIRECTIVE_NAME = "key";
+export declare const EXTERNAL_DIRECTIVE_NAME = "external";
+export declare const REQUIRES_DIRECTIVE_NAME = "requires";
+export declare const FIELDS = "fields";
 export declare const CONNECT_FIELD_RESOLVER = "connect__fieldResolver";
 export declare const CONTEXT = "context";
 export declare const FIELD_ARGS = "field_args";

package/dist/src/string-constants.js

@@ -1,3 +1,7 @@
+export const KEY_DIRECTIVE_NAME = 'key';
+export const EXTERNAL_DIRECTIVE_NAME = 'external';
+export const REQUIRES_DIRECTIVE_NAME = 'requires';
+export const FIELDS = 'fields';
 export const CONNECT_FIELD_RESOLVER = 'connect__fieldResolver';
 export const CONTEXT = 'context';
 export const FIELD_ARGS = 'field_args';

package/dist/src/string-constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"string-constants.js","sourceRoot":"","sources":["../../src/string-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"string-constants.js","sourceRoot":"","sources":["../../src/string-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAClD,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAC/D,MAAM,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC"}

package/dist/src/types.d.ts

@@ -1,4 +1,26 @@
+import { ASTNode, GraphQLNamedType } from 'graphql';
 import protobuf from 'protobufjs';
+export type VisitContext<T extends ASTNode> = {
+    node: T;
+    key: string | number | undefined;
+    parent: ASTNode | ReadonlyArray<ASTNode> | undefined;
+    path: ReadonlyArray<string | number>;
+    ancestors: ReadonlyArray<ASTNode | ReadonlyArray<ASTNode>>;
+};
+/**
+ * Maps GraphQL scalar types to Protocol Buffer types
+ *
+ * GraphQL has a smaller set of primitive types compared to Protocol Buffers.
+ * This mapping ensures consistent representation between the two type systems.
+ */
+export declare const SCALAR_TYPE_MAP: Record<string, string>;
+/**
+ * Maps GraphQL scalar types to Protocol Buffer wrapper types for nullable fields
+ *
+ * These wrapper types allow distinguishing between unset fields and zero values
+ * in Protocol Buffers, which is important for GraphQL nullable semantics.
+ */
+export declare const SCALAR_WRAPPER_TYPE_MAP: Record<string, string>;
 /**
  * Protocol Buffer idempotency levels for RPC methods
  * @see https://protobuf.dev/reference/protobuf/google.protobuf/#idempotency-level
@@ -10,3 +32,83 @@ export type IdempotencyLevel = 'NO_SIDE_EFFECTS' | 'DEFAULT';
 export interface MethodWithIdempotency extends protobuf.Method {
     idempotencyLevel?: IdempotencyLevel;
 }
+/**
+ * Represents a gRPC method definition
+ *
+ * example: rpc GetUser(GetUserRequest) returns (GetUserResponse) {}
+ */
+export type RPCMethod = {
+    name: string;
+    request: string;
+    response: string;
+    description?: string | null;
+};
+/**
+ * Represents a field in a proto message
+ */
+export interface ProtoMessageField {
+    fieldName: string;
+    typeName: string;
+    fieldNumber: number;
+    isRepeated?: boolean;
+    description?: string;
+    graphqlName?: string;
+    /**
+     * The composite type of the field. When building a proto message
+     * this is used to create the composite type messages as nested messages.
+     */
+    compositeType?: CompositeMessageDefinition;
+}
+/**
+ * Represents a proto message
+ */
+export interface ProtoMessage {
+    messageName: string;
+    reservedNumbers?: string;
+    description?: string;
+    fields: ProtoMessageField[];
+    /**
+     * Nested messages within this message (if any)
+     * Example: message User {
+     *  message Address {
+     *    string street = 1;
+     *    string city = 2;
+     *    string state = 3;
+     *    string zip = 4;
+     *  }
+     *  Address address = 1;
+     */
+    nestedMessages?: ProtoMessage[];
+}
+export interface ListWrapper {
+    baseType: GraphQLNamedType;
+    nestingLevel: number;
+}
+/**
+ * Data structure for formatting message fields
+ */
+export type ProtoFieldType = {
+    typeName: string;
+    isWrapper: boolean;
+    isRepeated: boolean;
+    listWrapper?: ListWrapper;
+};
+export declare enum CompositeMessageKind {
+    INTERFACE = 0,
+    UNION = 1
+}
+export type CompositeMessageDefinition = InterfaceMessageDefinition | UnionMessageDefinition;
+export type InterfaceMessageDefinition = {
+    kind: CompositeMessageKind.INTERFACE;
+    description?: string;
+    typeName: string;
+    implementingTypes: string[];
+};
+export type UnionMessageDefinition = {
+    kind: CompositeMessageKind.UNION;
+    description?: string;
+    typeName: string;
+    memberTypes: string[];
+};
+export declare function isInterfaceMessageDefinition(message: CompositeMessageDefinition): message is InterfaceMessageDefinition;
+export declare function isUnionMessageDefinition(message: CompositeMessageDefinition): message is UnionMessageDefinition;

package/dist/src/types.js

@@ -1,2 +1,38 @@
-export {};
+/**
+ * Maps GraphQL scalar types to Protocol Buffer types
+ *
+ * GraphQL has a smaller set of primitive types compared to Protocol Buffers.
+ * This mapping ensures consistent representation between the two type systems.
+ */
+export const SCALAR_TYPE_MAP = {
+    ID: 'string', // GraphQL IDs map to Proto strings
+    String: 'string', // Direct mapping
+    Int: 'int32', // GraphQL Int is 32-bit signed
+    Float: 'double', // Using double for GraphQL Float gives better precision
+    Boolean: 'bool', // Direct mapping
+};
+/**
+ * Maps GraphQL scalar types to Protocol Buffer wrapper types for nullable fields
+ *
+ * These wrapper types allow distinguishing between unset fields and zero values
+ * in Protocol Buffers, which is important for GraphQL nullable semantics.
+ */
+export const SCALAR_WRAPPER_TYPE_MAP = {
+    ID: 'google.protobuf.StringValue',
+    String: 'google.protobuf.StringValue',
+    Int: 'google.protobuf.Int32Value',
+    Float: 'google.protobuf.DoubleValue',
+    Boolean: 'google.protobuf.BoolValue',
+};
+export var CompositeMessageKind;
+(function (CompositeMessageKind) {
+    CompositeMessageKind[CompositeMessageKind["INTERFACE"] = 0] = "INTERFACE";
+    CompositeMessageKind[CompositeMessageKind["UNION"] = 1] = "UNION";
+})(CompositeMessageKind || (CompositeMessageKind = {}));
+export function isInterfaceMessageDefinition(message) {
+    return message.kind === CompositeMessageKind.INTERFACE;
+}
+export function isUnionMessageDefinition(message) {
+    return message.kind === CompositeMessageKind.UNION;
+}
 //# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,EAAE,EAAE,QAAQ,EAAE,mCAAmC;IACjD,MAAM,EAAE,QAAQ,EAAE,iBAAiB;IACnC,GAAG,EAAE,OAAO,EAAE,+BAA+B;IAC7C,KAAK,EAAE,QAAQ,EAAE,wDAAwD;IACzE,OAAO,EAAE,MAAM,EAAE,iBAAiB;CACnC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,EAAE,EAAE,6BAA6B;IACjC,MAAM,EAAE,6BAA6B;IACrC,GAAG,EAAE,4BAA4B;IACjC,KAAK,EAAE,6BAA6B;IACpC,OAAO,EAAE,2BAA2B;CACrC,CAAC;AAoFF,MAAM,CAAN,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,yEAAS,CAAA;IACT,iEAAK,CAAA;AACP,CAAC,EAHW,oBAAoB,KAApB,oBAAoB,QAG/B;AAkBD,MAAM,UAAU,4BAA4B,CAC1C,OAAmC;IAEnC,OAAO,OAAO,CAAC,IAAI,KAAK,oBAAoB,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAmC;IAC1E,OAAO,OAAO,CAAC,IAAI,KAAK,oBAAoB,CAAC,KAAK,CAAC;AACrD,CAAC"}