@gqlbase/plugins 0.0.6 → 0.0.7

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.d.ts

@@ -0,0 +1,55 @@
+import { ITransformerContext, TransformerPluginBase } from "@gqlbase/core";
+import { DefinitionNode, InterfaceNode, ObjectNode } from "@gqlbase/core/definition";
+/**
+ * Normalizes interface implementation by other interfaces and objects, makeing sure that all fields defined in an interface are implemented by its implementors, and that interfaces can implement other interfaces:
+ *
+ * - When an object or interface implements another interface, it must implement all fields defined in the implemented interface.
+ * - "Transitively implemented interfaces (interfaces implemented by the interface that is being implemented) must also be defined on an implementing type or interface."
+ *
+ * @see https://spec.graphql.org/September2025/#sec-Interfaces
+ *
+ * @example
+ * ```graphql
+ * # Before
+ * interface Node {
+ *   id: ID!
+ * }
+ *
+ * interface Timestamped {
+ *   createdAt: DateTime!
+ *   updatedAt: DateTime!
+ * }
+ *
+ * interface User implements Node & Timestamped {
+ *   id: ID!
+ *   name: String!
+ * }
+ *
+ * # After
+ * interface Node {
+ *   id: ID!
+ * }
+ *
+ * interface Timestamped {
+ *   createdAt: DateTime!
+ *   updatedAt: DateTime!
+ * }
+ *
+ * interface User implements Node & Timestamped {
+ *   id: ID!
+ *   name: String!
+ *   createdAt: DateTime! # added by the plugin
+ *   updatedAt: DateTime! # added by the plugin
+ * }
+ * ```
+ */
+export declare class InterfaceUtilsPlugin extends TransformerPluginBase {
+    constructor(context: ITransformerContext);
+    private _getValidInterface;
+    private _normalizeTransitiveInterfaces;
+    private _normalizeInterfaceFields;
+    match(definition: DefinitionNode): definition is InterfaceNode | ObjectNode;
+    normalize(node: InterfaceNode | ObjectNode): void;
+}
+export declare const interfaceUtilsPlugin: (options?: unknown) => import("@gqlbase/core").IPluginFactory;
+//# sourceMappingURL=InterfaceUtilsPlugin.d.ts.map

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceUtilsPlugin.d.ts","sourceRoot":"","sources":["../../../src/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EACL,cAAc,EAEd,aAAa,EAEb,UAAU,EACX,MAAM,0BAA0B,CAAC;AAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,qBAAa,oBAAqB,SAAQ,qBAAqB;gBACjD,OAAO,EAAE,mBAAmB;IAIxC,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,8BAA8B;IAgBtC,OAAO,CAAC,yBAAyB;IAwB1B,KAAK,CAAC,UAAU,EAAE,cAAc;IAIhC,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,UAAU;CAQlD;AAED,eAAO,MAAM,oBAAoB,+DAA4C,CAAC"}

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.js

@@ -0,0 +1,100 @@
+import { createPluginFactory, TransformerPluginBase } from "@gqlbase/core";
+import { FieldNode, InterfaceNode, NamedTypeNode, ObjectNode, } from "@gqlbase/core/definition";
+import { hasInterfaces } from "./InterfaceUtilsPlugin.utils.js";
+import { TransformerPluginExecutionError } from "@gqlbase/shared/errors";
+/**
+ * Normalizes interface implementation by other interfaces and objects, makeing sure that all fields defined in an interface are implemented by its implementors, and that interfaces can implement other interfaces:
+ *
+ * - When an object or interface implements another interface, it must implement all fields defined in the implemented interface.
+ * - "Transitively implemented interfaces (interfaces implemented by the interface that is being implemented) must also be defined on an implementing type or interface."
+ *
+ * @see https://spec.graphql.org/September2025/#sec-Interfaces
+ *
+ * @example
+ * ```graphql
+ * # Before
+ * interface Node {
+ *   id: ID!
+ * }
+ *
+ * interface Timestamped {
+ *   createdAt: DateTime!
+ *   updatedAt: DateTime!
+ * }
+ *
+ * interface User implements Node & Timestamped {
+ *   id: ID!
+ *   name: String!
+ * }
+ *
+ * # After
+ * interface Node {
+ *   id: ID!
+ * }
+ *
+ * interface Timestamped {
+ *   createdAt: DateTime!
+ *   updatedAt: DateTime!
+ * }
+ *
+ * interface User implements Node & Timestamped {
+ *   id: ID!
+ *   name: String!
+ *   createdAt: DateTime! # added by the plugin
+ *   updatedAt: DateTime! # added by the plugin
+ * }
+ * ```
+ */
+export class InterfaceUtilsPlugin extends TransformerPluginBase {
+    constructor(context) {
+        super("InterfaceUtilsPlugin", context);
+    }
+    _getValidInterface(name) {
+        const iface = this.context.document.getNodeOrThrow(name);
+        if (!(iface instanceof InterfaceNode)) {
+            throw new TransformerPluginExecutionError(this.name, `Node ${name} is not an interface but is implemented by ${name}`);
+        }
+        return iface;
+    }
+    _normalizeTransitiveInterfaces(node) {
+        for (const ifaceName of node.getInterfaces()) {
+            const iface = this._getValidInterface(ifaceName.getTypeName());
+            if (!hasInterfaces(iface)) {
+                continue;
+            }
+            for (const transitiveIfaceName of iface.getInterfaces()) {
+                if (!node.hasInterface(transitiveIfaceName.getTypeName())) {
+                    node.addInterface(transitiveIfaceName);
+                }
+            }
+        }
+    }
+    _normalizeInterfaceFields(node) {
+        for (const ifaceName of node.getInterfaces()) {
+            const iface = this._getValidInterface(ifaceName.getTypeName());
+            for (const field of iface.getFields()) {
+                if (node.hasField(field.name)) {
+                    const nodeField = node.getField(field.name);
+                    if (nodeField?.type.getTypeName() !== field.type.getTypeName()) {
+                        this.context.logger.warn(`Field ${field.name} on ${node.name} has type ${nodeField?.type.getTypeName()} but should be ${field.type.getTypeName()} as defined in interface ${iface.name}`);
+                        nodeField?.setType(NamedTypeNode.create(field.type.getTypeName()));
+                    }
+                    continue;
+                }
+                node.addField(FieldNode.fromDefinition(field.serialize()));
+            }
+        }
+    }
+    match(definition) {
+        return definition instanceof InterfaceNode || definition instanceof ObjectNode;
+    }
+    normalize(node) {
+        if (!hasInterfaces(node)) {
+            return;
+        }
+        this._normalizeTransitiveInterfaces(node);
+        this._normalizeInterfaceFields(node);
+    }
+}
+export const interfaceUtilsPlugin = createPluginFactory(InterfaceUtilsPlugin);
+//# sourceMappingURL=InterfaceUtilsPlugin.js.map

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.js.map

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

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.d.ts

@@ -0,0 +1,3 @@
+import { InterfaceNode, ObjectNode } from "@gqlbase/core/definition";
+export declare const hasInterfaces: (node: ObjectNode | InterfaceNode) => boolean;
+//# sourceMappingURL=InterfaceUtilsPlugin.utils.d.ts.map

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceUtilsPlugin.utils.d.ts","sourceRoot":"","sources":["../../../src/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAErE,eAAO,MAAM,aAAa,GAAI,MAAM,UAAU,GAAG,aAAa,KAAG,OAEhE,CAAC"}

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.js

@@ -0,0 +1,4 @@
+export const hasInterfaces = (node) => {
+    return Array.isArray(node.interfaces) && node.interfaces.length > 0;
+};
+//# sourceMappingURL=InterfaceUtilsPlugin.utils.js.map

package/dist/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceUtilsPlugin.utils.js","sourceRoot":"","sources":["../../../src/base/InterfaceUtilsPlugin/InterfaceUtilsPlugin.utils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAgC,EAAW,EAAE;IACzE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AACtE,CAAC,CAAC"}

package/dist/base/InterfaceUtilsPlugin/index.d.ts

@@ -0,0 +1,3 @@
+export { InterfaceUtilsPlugin, interfaceUtilsPlugin } from "./InterfaceUtilsPlugin.js";
+export { hasInterfaces } from "./InterfaceUtilsPlugin.utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/base/InterfaceUtilsPlugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/InterfaceUtilsPlugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/base/InterfaceUtilsPlugin/index.js

@@ -0,0 +1,3 @@
+export { InterfaceUtilsPlugin, interfaceUtilsPlugin } from "./InterfaceUtilsPlugin.js";
+export { hasInterfaces } from "./InterfaceUtilsPlugin.utils.js";
+//# sourceMappingURL=index.js.map

package/dist/base/InterfaceUtilsPlugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/InterfaceUtilsPlugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.d.ts

@@ -1,11 +1,13 @@
 import { ITransformerContext, TransformerPluginBase } from "@gqlbase/core";
 import { DefinitionNode } from "@gqlbase/core/definition";
+import { ModelTypesGeneratorPluginOptions } from "./ModelTypesGeneratorPlugin.utils.js";
 /**
  * This plugin generates TypeScript types for all objects defined in the schema.
  */
 export declare class ModelTypesGeneratorPlugin extends TransformerPluginBase {
     private nodes;
-    constructor(context: ITransformerContext);
+    private options;
+    constructor(context: ITransformerContext, options?: ModelTypesGeneratorPluginOptions);
     private _getContent;
     private _createTypeNameIdentifier;
     private _createValueTypeReference;
@@ -17,7 +19,11 @@ export declare class ModelTypesGeneratorPlugin extends TransformerPluginBase {
     before(): void;
     match(definition: DefinitionNode): boolean;
     generate(definition: DefinitionNode): void;
-    output(): {};
+    output(): {
+        modelTypes: string;
+    } | {
+        modelTypes?: undefined;
+    };
 }
-export declare const modelTypesGeneratorPlugin: (options?: unknown) => import("@gqlbase/core").IPluginFactory;
+export declare const modelTypesGeneratorPlugin: (options?: ModelTypesGeneratorPluginOptions | undefined) => import("@gqlbase/core").IPluginFactory;
 //# sourceMappingURL=ModelTypesGeneratorPlugin.d.ts.map

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelTypesGeneratorPlugin.d.ts","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGhG,OAAO,EACL,cAAc,EAQf,MAAM,0BAA0B,CAAC;AAWlC;;GAEG;AAEH,qBAAa,yBAA0B,SAAQ,qBAAqB;IAClE,OAAO,CAAC,KAAK,CAAiB;gBAElB,OAAO,EAAE,mBAAmB;IAIxC,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,yBAAyB;IAkCjC,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,gBAAgB;IAsBjB,MAAM;IAkBN,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO;IAQ1C,QAAQ,CAAC,UAAU,EAAE,cAAc;IAkBnC,MAAM;CAMd;AAED,eAAO,MAAM,yBAAyB,+DAAiD,CAAC"}
+{"version":3,"file":"ModelTypesGeneratorPlugin.d.ts","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGhG,OAAO,EACL,cAAc,EASf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAIL,gCAAgC,EACjC,MAAM,sCAAsC,CAAC;AAO9C;;GAEG;AAEH,qBAAa,yBAA0B,SAAQ,qBAAqB;IAClE,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAA6C;gBAEhD,OAAO,EAAE,mBAAmB,EAAE,OAAO,GAAE,gCAAqC;IAMxF,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,yBAAyB;IAkCjC,OAAO,CAAC,yBAAyB;IAuBjC,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,gBAAgB;IAsBjB,MAAM;IAkBN,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO;IAQ1C,QAAQ,CAAC,UAAU,EAAE,cAAc;IAkBnC,MAAM;;;;;CASd;AAED,eAAO,MAAM,yBAAyB,oGAAiD,CAAC"}

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.js

@@ -3,21 +3,24 @@ import { createPluginFactory, TransformerPluginBase } from "@gqlbase/core";
 import { writeOutputFile } from "@gqlbase/shared/files";
 import { createFileHeaders } from "@gqlbase/shared/codegen";
 import { EnumNode, InterfaceNode, ListTypeNode, NonNullTypeNode, ObjectNode, UnionNode, } from "@gqlbase/core/definition";
-import { getBuildinScalarTypeKeyword, isNonNullableField, isOperationNode, } from "./ModelTypesGeneratorPlugin.utils.js";
+import { getBuildinScalarTypeKeyword, isOperationNode, mergeOptions, } from "./ModelTypesGeneratorPlugin.utils.js";
 import { isEnum, isObjectLike, isScalar } from "../ModelPlugin/ModelPlugin.utils.js";
 import { isRelationField } from "../RelationsPlugin/RelationsPlugin.utils.js";
 import { isBuildInScalar } from "@gqlbase/shared/definition";
 import { getTypeHint, isInternal } from "@gqlbase/core/plugins";
+import { isSemanticNullable } from "../RfcFeaturesPlugin/RfcFeaturesPlugin.utils.js";
 /**
  * This plugin generates TypeScript types for all objects defined in the schema.
  */
 export class ModelTypesGeneratorPlugin extends TransformerPluginBase {
     nodes = [];
-    constructor(context) {
+    options;
+    constructor(context, options = {}) {
         super("ModelTypesGeneratorPlugin", context);
+        this.options = mergeOptions(options);
     }
     _getContent() {
-        const file = ts.createSourceFile("models.typegen.ts", 
+        const file = ts.createSourceFile(this.options.fileName, 
         /*sourceText*/ "", ts.ScriptTarget.Latest, 
         /*setParentNodes*/ false, ts.ScriptKind.TS);
         const printer = ts.createPrinter({
@@ -53,15 +56,21 @@ export class ModelTypesGeneratorPlugin extends TransformerPluginBase {
         }
         return ts.factory.createIdentifier(typeName);
     }
-    _createValueTypeReference(fieldType) {
+    _createValueTypeReference(field, fieldType, level = 0) {
         if (fieldType instanceof NonNullTypeNode) {
-            return this._createValueTypeReference(fieldType.type);
+            return this._createValueTypeReference(field, fieldType.type, level);
         }
         if (fieldType instanceof ListTypeNode) {
-            const elementType = this._createValueTypeReference(fieldType.type);
-            return ts.factory.createArrayTypeNode(elementType);
+            const elementType = this._createValueTypeReference(field, fieldType.type, level + 1);
+            const arrayType = ts.factory.createArrayTypeNode(elementType);
+            return isSemanticNullable(field, level)
+                ? ts.factory.createTypeReferenceNode("Maybe", [arrayType])
+                : arrayType;
         }
-        return ts.factory.createTypeReferenceNode(this._createTypeNameIdentifier(fieldType.name));
+        const baseType = ts.factory.createTypeReferenceNode(this._createTypeNameIdentifier(fieldType.name));
+        return isSemanticNullable(field, level)
+            ? ts.factory.createTypeReferenceNode("Maybe", [baseType])
+            : baseType;
     }
     _createFieldMembers(definition) {
         const members = [];
@@ -69,13 +78,12 @@ export class ModelTypesGeneratorPlugin extends TransformerPluginBase {
             if (isRelationField(field)) {
                 continue;
             }
-            const questionToken = isNonNullableField(field)
-                ? undefined
-                : ts.factory.createToken(ts.SyntaxKind.QuestionToken);
-            const typeNode = isNonNullableField(field)
-                ? this._createValueTypeReference(field.type)
-                : ts.factory.createTypeReferenceNode("Maybe", [this._createValueTypeReference(field.type)]);
+            const questionToken = isSemanticNullable(field)
+                ? ts.factory.createToken(ts.SyntaxKind.QuestionToken)
+                : undefined;
+            const typeNode = this._createValueTypeReference(field, field.type);
             const propertySignature = ts.factory.createPropertySignature([ts.factory.createModifier(ts.SyntaxKind.ReadonlyKeyword)], ts.factory.createIdentifier(field.name), questionToken, typeNode);
+            // TODO: consider adding JSDoc comments with field descriptions and deprecation notices
             // ts.addSyntheticLeadingComment(
             //   propertySignature,
             //   ts.SyntaxKind.MultiLineCommentTrivia,
@@ -153,8 +161,10 @@ export class ModelTypesGeneratorPlugin extends TransformerPluginBase {
     }
     output() {
         const content = this._getContent();
-        writeOutputFile(this.context.outputDirectory, "models.typegen.ts", content);
-        return {};
+        if (this.options.emitFile) {
+            writeOutputFile(this.context.outputDirectory, this.options.fileName, content);
+        }
+        return this.options.emitOutput ? { modelTypes: content } : {};
     }
 }
 export const modelTypesGeneratorPlugin = createPluginFactory(ModelTypesGeneratorPlugin);

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModelTypesGeneratorPlugin.js","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ModelTypesGeneratorPlugin.js","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAuB,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAEL,QAAQ,EAER,aAAa,EACb,YAAY,EACZ,eAAe,EACf,UAAU,EAEV,SAAS,GACV,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,eAAe,EACf,YAAY,GAEb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAErF;;GAEG;AAEH,MAAM,OAAO,yBAA0B,SAAQ,qBAAqB;IAC1D,KAAK,GAAc,EAAE,CAAC;IACtB,OAAO,CAA6C;IAE5D,YAAY,OAA4B,EAAE,UAA4C,EAAE;QACtF,KAAK,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAEO,WAAW;QACjB,MAAM,IAAI,GAAG,EAAE,CAAC,gBAAgB,CAC9B,IAAI,CAAC,OAAO,CAAC,QAAQ;QACrB,cAAc,CAAC,EAAE,EACjB,EAAE,CAAC,YAAY,CAAC,MAAM;QACtB,kBAAkB,CAAC,KAAK,EACxB,EAAE,CAAC,UAAU,CAAC,EAAE,CACjB,CAAC;QAEF,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC;YAC/B,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,sBAAsB;YAC9C,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAClG,CAAC;IAEO,yBAAyB,CAAC,QAAgB;QAChD,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,2BAA2B,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAE/D,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YAElC,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,IAAI;oBACP,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,KAAK,QAAQ;oBACX,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,KAAK,QAAQ;oBACX,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,KAAK,SAAS;oBACZ,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;gBAChD,KAAK,QAAQ;oBACX,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;gBAChE,KAAK,SAAS,CAAC;gBACf,OAAO,CAAC,CAAC,CAAC;oBACR,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CACtB,gCAAgC,OAAO,CAAC,IAAI,0BAA0B,CACvE,CAAC;oBACF,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,yBAAyB,CAAC,KAAgB,EAAE,SAAmB,EAAE,KAAK,GAAG,CAAC;QAChF,IAAI,SAAS,YAAY,eAAe,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,SAAS,YAAY,YAAY,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YACrF,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;YAE9D,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC;gBACrC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC1D,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,uBAAuB,CACjD,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC,IAAI,CAAC,CAC/C,CAAC;QAEF,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC;YACrC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;YACzD,CAAC,CAAC,QAAQ,CAAC;IACf,CAAC;IAEO,mBAAmB,CAAC,UAAsC;QAChE,MAAM,OAAO,GAAqB,EAAE,CAAC;QAErC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YAC5C,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC;gBAC7C,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;gBACrD,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnE,MAAM,iBAAiB,GAAG,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAC1D,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,EAC1D,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,EACvC,aAAa,EACb,QAAQ,CACT,CAAC;YAEF,uFAAuF;YACvF,iCAAiC;YACjC,uBAAuB;YACvB,0CAA0C;YAC1C,8BAA8B;YAC9B,gCAAgC;YAChC,KAAK;YAEL,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,iBAAiB,CAAC,UAAsB;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B;QACtD,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACtE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,kBAAkB,CAAC,SAAS,EAC5B,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAC1C,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAEO,oBAAoB,CAAC,UAAyB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAErD,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B;QACzD,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACtE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,kBAAkB,CAAC,SAAS;QAC5B,mBAAmB,CAAC,SAAS,EAC7B,OAAO,CACR,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IAEO,eAAe,CAAC,UAAoB;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CACtB,aAAa,UAAU,CAAC,IAAI,sDAAsD,CACnF,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC9C,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAC7E,CAAC;QAEF,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B;QACpD,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACtE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,kBAAkB,CAAC,SAAS,EAC5B,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,CACxC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAEO,gBAAgB,CAAC,UAAqB;QAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CACtB,cAAc,UAAU,CAAC,IAAI,4DAA4D,CAC1F,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACzC,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAC3E,CAAC;QAEF,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B;QACrD,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACtE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,kBAAkB,CAAC,SAAS,EAC5B,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,CACrC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAEM,MAAM;QACX,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QAEpC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAE1B,IAAI,CAAC,KAAK,CAAC,IAAI,CACb,EAAE,CAAC,OAAO,CAAC,0BAA0B;QACnC,aAAa,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,EACtE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,EACpC,CAAC,EAAE,CAAC,OAAO,CAAC,8BAA8B,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,EAC3D,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;YAC7B,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC,GAAG,CAAC;YACvC,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;SAC1D,CAAC,CACH,CACF,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,UAA0B;QACrC,OAAO,CACL,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;YAChD,CAAC,eAAe,CAAC,UAAU,CAAC;YAC5B,CAAC,UAAU,CAAC,UAAU,CAAC,CACxB,CAAC;IACJ,CAAC;IAEM,QAAQ,CAAC,UAA0B;QACxC,IAAI,UAAU,YAAY,aAAa,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,UAAU,YAAY,UAAU,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,UAAU,YAAY,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,UAAU,YAAY,QAAQ,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEM,MAAM;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;CACF;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,mBAAmB,CAAC,yBAAyB,CAAC,CAAC"}

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.d.ts

@@ -1,12 +1,22 @@
-import { DefinitionNode, FieldNode, InputValueNode } from "@gqlbase/core/definition";
+import { DefinitionNode } from "@gqlbase/core/definition";
+export interface ModelTypesGeneratorPluginOptions {
+    /** If true, the plugin will not emit any files.
+     * @default true
+     */
+    emitFile?: boolean;
+    /**
+     * The output file name for the generated types.
+     * @default "models.typegen.ts"
+     */
+    fileName?: string;
+    /**
+     * Whether to include the generated types in the output object.
+     * @default false
+     */
+    emitOutput?: boolean;
+}
+export declare const DEFAULT_OPTIONS: Required<ModelTypesGeneratorPluginOptions>;
+export declare const mergeOptions: (options?: ModelTypesGeneratorPluginOptions) => Required<ModelTypesGeneratorPluginOptions>;
 export declare const isOperationNode: (node: DefinitionNode) => boolean;
-/**
- *
- * @param field Field node to check for non-nullability
- * @returns True if the field is non-nullable, false otherwise
- *
- * TODO: check for semantic nullability based on directives.
- */
-export declare const isNonNullableField: (field: FieldNode | InputValueNode) => boolean;
 export declare const getBuildinScalarTypeKeyword: (typeName: string) => string;
 //# sourceMappingURL=ModelTypesGeneratorPlugin.utils.d.ts.map

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelTypesGeneratorPlugin.utils.d.ts","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,SAAS,EACT,cAAc,EAEf,MAAM,0BAA0B,CAAC;AAIlC,eAAO,MAAM,eAAe,GAAI,MAAM,cAAc,YAEnD,CAAC;AAEF;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB,GAAI,OAAO,SAAS,GAAG,cAAc,YAEnE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,MAa9D,CAAC"}
+{"version":3,"file":"ModelTypesGeneratorPlugin.utils.d.ts","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,gCAAgC,CAI7D,CAAC;AAEX,eAAO,MAAM,YAAY,GACvB,UAAU,gCAAgC,KACzC,QAAQ,CAAC,gCAAgC,CAK3C,CAAC;AAIF,eAAO,MAAM,eAAe,GAAI,MAAM,cAAc,YAEnD,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,MAa9D,CAAC"}

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.js

@@ -1,18 +1,18 @@
-import { NonNullTypeNode, } from "@gqlbase/core/definition";
+export const DEFAULT_OPTIONS = {
+    emitFile: true,
+    fileName: "models.typegen.ts",
+    emitOutput: false,
+};
+export const mergeOptions = (options) => {
+    return {
+        ...DEFAULT_OPTIONS,
+        ...options,
+    };
+};
 const OPERATION_NODE_NAME = ["Query", "Mutation", "Subscription"];
 export const isOperationNode = (node) => {
     return OPERATION_NODE_NAME.includes(node.name);
 };
-/**
- *
- * @param field Field node to check for non-nullability
- * @returns True if the field is non-nullable, false otherwise
- *
- * TODO: check for semantic nullability based on directives.
- */
-export const isNonNullableField = (field) => {
-    return field.type instanceof NonNullTypeNode;
-};
 export const getBuildinScalarTypeKeyword = (typeName) => {
     switch (typeName) {
         case "ID":

package/dist/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModelTypesGeneratorPlugin.utils.js","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAoB,EAAE,EAAE;IACtD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAA4C,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAiC,EAAE,EAAE;IACtE,OAAO,KAAK,CAAC,IAAI,YAAY,eAAe,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAgB,EAAU,EAAE;IACtE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,KAAK,CAAC;QACX,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB;YACE,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"ModelTypesGeneratorPlugin.utils.js","sourceRoot":"","sources":["../../../src/base/ModelTypesGeneratorPlugin/ModelTypesGeneratorPlugin.utils.ts"],"names":[],"mappings":"AAqBA,MAAM,CAAC,MAAM,eAAe,GAA+C;IACzE,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,KAAK;CACT,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA0C,EACE,EAAE;IAC9C,OAAO;QACL,GAAG,eAAe;QAClB,GAAG,OAAO;KACX,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAU,CAAC;AAE3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAoB,EAAE,EAAE;IACtD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAA4C,CAAC,CAAC;AACzF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAgB,EAAU,EAAE;IACtE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,IAAI,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,KAAK,CAAC;QACX,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB;YACE,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC,CAAC"}

package/dist/base/RelationsPlugin/RelationsPlugin.d.ts

@@ -2,12 +2,20 @@ import { ITransformerContext, ITransformerPlugin } from "@gqlbase/core";
 import { DefinitionNode, InterfaceNode, ObjectNode } from "@gqlbase/core/definition";
 import { RelationPluginOptions } from "./RelationsPlugin.utils.js";
 /**
- *  This plugin is responsible for adding the `@hasOne` and `@hasMany` directives to the schema, which can be used to define relationships between types. It also adds the necessary fields and arguments to the schema to support these directives.
+ * This plugin is responsible for adding the `@hasOne` and `@hasMany` directives to the schema, which can be used to define relationships between types.
  *
- * @example
+ * It also adds the necessary fields and arguments to the schema to support these directives.
  *
+ * @definition
  * ```graphql
+ * directive `@hasOne(key: String)` on FIELD_DEFINITION
+ *
+ * directive `@hasMany(key: String)` on FIELD_DEFINITION
+ *
+ * ```
  *
+ * @example
+ * ```graphql
  * # Before
  * type User {
  *   id: ID!
@@ -25,24 +33,21 @@ import { RelationPluginOptions } from "./RelationsPlugin.utils.js";
  * type User {
  *   id: ID!
  *   name: String!
- *   posts: [Post]
+ *   posts: [Post] # formatted by the plugin
  * }
  *
  * type Post {
  *   id: ID!
  *   title: String!
- *   authorId: ID
+ *   authorId: ID # added by the plugin
  *   author: User
  * }
  * ```
- *
- * In the above example, the `User` type has a `posts` field that is decorated with the `@hasMany` directive, indicating that a user can have many posts. The plugin will automatically add the necessary fields and arguments to support this relationship in the schema.
- *
  */
 export declare class RelationsPlugin implements ITransformerPlugin {
     readonly name = "RelationsPlugin";
     readonly context: ITransformerContext;
-    private readonly _useConnections;
+    private readonly options;
     constructor(context: ITransformerContext, options?: RelationPluginOptions);
     private _getRelationshipTarget;
     private _getFieldRelation;

package/dist/base/RelationsPlugin/RelationsPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelationsPlugin.d.ts","sourceRoot":"","sources":["../../../src/base/RelationsPlugin/RelationsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,cAAc,EAId,aAAa,EAGb,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAQL,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;gBAGxC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,qBAAiD;IAM5D,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,sBAAsB;IAiBvB,IAAI;IAkBJ,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO;IAW1C,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAiC9D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAoB9C,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAY5D,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,cAAc,yFAAuC,CAAC"}
+{"version":3,"file":"RelationsPlugin.d.ts","sourceRoot":"","sources":["../../../src/base/RelationsPlugin/RelationsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EACL,cAAc,EAId,aAAa,EAGb,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EASL,qBAAqB,EAEtB,MAAM,4BAA4B,CAAC;AAGpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,OAAO,EAAE,mBAAmB,EAAE,OAAO,GAAE,qBAA0B;IAO7E,OAAO,CAAC,sBAAsB;IAgB9B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,sBAAsB;IAiBvB,IAAI;IAkBJ,KAAK,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO;IAW1C,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAiC9D,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAoB9C,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI;IAY5D,KAAK,IAAI,IAAI;CAKd;AAED,eAAO,MAAM,cAAc,yFAAuC,CAAC"}

package/dist/base/RelationsPlugin/RelationsPlugin.js

@@ -1,16 +1,24 @@
 import { createPluginFactory } from "@gqlbase/core";
 import { DirectiveDefinitionNode, FieldNode, InputValueNode, InterfaceNode, ListTypeNode, NamedTypeNode, ObjectNode, UnionNode, } from "@gqlbase/core/definition";
 import { TransformerPluginExecutionError } from "@gqlbase/shared/errors";
-import { camelCase, pascalCase } from "@gqlbase/shared/format";
-import { isConnectionNode, isManyRelationship, isOneRelationship, isRelationField, isValidRelationTarget, RelationDirective, } from "./RelationsPlugin.utils.js";
+import { pascalCase } from "@gqlbase/shared/format";
+import { isPaginationConnection, isManyRelationship, isOneRelationship, isRelationField, isValidRelationTarget, parseFieldRelation, RelationDirective, } from "./RelationsPlugin.utils.js";
 import { isListTypeNode } from "../ModelPlugin/ModelPlugin.utils.js";
 /**
- *  This plugin is responsible for adding the `@hasOne` and `@hasMany` directives to the schema, which can be used to define relationships between types. It also adds the necessary fields and arguments to the schema to support these directives.
+ * This plugin is responsible for adding the `@hasOne` and `@hasMany` directives to the schema, which can be used to define relationships between types.
  *
- * @example
+ * It also adds the necessary fields and arguments to the schema to support these directives.
  *
+ * @definition
  * ```graphql
+ * directive `@hasOne(key: String)` on FIELD_DEFINITION
+ *
+ * directive `@hasMany(key: String)` on FIELD_DEFINITION
+ *
+ * ```
  *
+ * @example
+ * ```graphql
  * # Before
  * type User {
  *   id: ID!
@@ -28,64 +36,40 @@ import { isListTypeNode } from "../ModelPlugin/ModelPlugin.utils.js";
  * type User {
  *   id: ID!
  *   name: String!
- *   posts: [Post]
+ *   posts: [Post] # formatted by the plugin
  * }
  *
  * type Post {
  *   id: ID!
  *   title: String!
- *   authorId: ID
+ *   authorId: ID # added by the plugin
  *   author: User
  * }
  * ```
- *
- * In the above example, the `User` type has a `posts` field that is decorated with the `@hasMany` directive, indicating that a user can have many posts. The plugin will automatically add the necessary fields and arguments to support this relationship in the schema.
- *
  */
 export class RelationsPlugin {
     name = "RelationsPlugin";
     context;
-    _useConnections;
-    constructor(context, options = { useConnections: false }) {
+    options;
+    constructor(context, options = {}) {
         this.context = context;
-        this._useConnections = options.useConnections ?? false;
+        this.options = {
+            usePaginationTypes: options.usePaginationTypes ?? false,
+        };
     }
-    _getRelationshipTarget(field) {
-        const fieldType = this.context.document.getNode(field.type.getTypeName());
-        if (isRelationField(field)) {
-            return fieldType;
+    _getRelationshipTarget(object, field) {
+        const target = this.context.document.getNode(field.type.getTypeName());
+        if (!target || !isValidRelationTarget(target)) {
+            throw new TransformerPluginExecutionError(this.name, `Type ${target?.name ?? "unknwon type"} is not a valid relationship target for ${object.name}.${field.name}`);
         }
-        return undefined;
+        return target;
     }
     _getFieldRelation(object, field) {
-        const target = this._getRelationshipTarget(field);
-        if (!target)
+        if (!isRelationField(field)) {
             return null;
-        if (!isValidRelationTarget(target)) {
-            throw new TransformerPluginExecutionError(this.name, `Type ${target.name} is not a valid relationship target for ${object.name}.${field.name}`);
-        }
-        let directive = field.getDirective(RelationDirective.HAS_ONE);
-        if (directive) {
-            if (field.hasDirective(RelationDirective.HAS_MANY)) {
-                throw new TransformerPluginExecutionError(this.name, `Multiple relationship directives detected for ${object.name}.${field.name}`);
-            }
-            const args = directive.getArgumentsJSON();
-            return {
-                type: "oneToOne",
-                target: target,
-                key: args.key ?? camelCase(field.name, "id"),
-            };
-        }
-        directive = field.getDirective(RelationDirective.HAS_MANY);
-        if (directive) {
-            const args = directive.getArgumentsJSON();
-            return {
-                type: "oneToMany",
-                target: target,
-                key: args.key ?? camelCase(object.name, "id"),
-            };
         }
-        throw new TransformerPluginExecutionError(this.name, `Could not find connection directive: ${field.name}`);
+        const target = this._getRelationshipTarget(object, field);
+        return parseFieldRelation(object, field, target);
     }
     _setRelationKey(node, key) {
         if (!node.hasField(key)) {
@@ -102,7 +86,7 @@ export class RelationsPlugin {
     }
     _createFieldConnection(field, target) {
         this._setConnectionArguments(field);
-        if (isConnectionNode(target)) {
+        if (isPaginationConnection(target)) {
             return target;
         }
         const connectionTypeName = pascalCase(target.name, "Connection");
@@ -119,7 +103,7 @@ export class RelationsPlugin {
         if (definition instanceof InterfaceNode || definition instanceof ObjectNode) {
             if (definition.name === "Mutation")
                 return false;
-            if (isConnectionNode(definition))
+            if (isPaginationConnection(definition))
                 return false;
             if (!definition.fields?.length)
                 return false;
@@ -158,7 +142,7 @@ export class RelationsPlugin {
             if (!relation || relation.type === "oneToOne") {
                 continue;
             }
-            if (this._useConnections) {
+            if (this.options.usePaginationTypes) {
                 const connection = this._createFieldConnection(field, relation.target);
                 field.setType(NamedTypeNode.create(connection.name));
                 continue;