@gqlkit-ts/cli 0.0.1 → 0.2.0

package/dist/shared/directive-definition-extractor.js

@@ -0,0 +1,399 @@
+/**
+ * Directive definition extractor.
+ *
+ * This module provides functions to extract directive definitions from
+ * TypeScript type aliases that use the Directive<Name, Args, Location> type.
+ */
+import ts from "typescript";
+import { METADATA_PROPERTIES } from "./constants.js";
+import { getActualMetadataType } from "./metadata-detector.js";
+import { getNonNullableTypes, isNullableUnion, isNullOrUndefined, } from "./typescript-utils.js";
+const DIRECTIVE_NAME_PROPERTY = METADATA_PROPERTIES.DIRECTIVE_NAME;
+const DIRECTIVE_ARGS_PROPERTY = METADATA_PROPERTIES.DIRECTIVE_ARGS;
+const DIRECTIVE_LOCATION_PROPERTY = METADATA_PROPERTIES.DIRECTIVE_LOCATION;
+/**
+ * Checks if a type is a Directive type (has $directiveName, $directiveArgs, $directiveLocation properties).
+ */
+function isDirectiveType(type) {
+    const nameProp = type.getProperty(DIRECTIVE_NAME_PROPERTY);
+    const argsProp = type.getProperty(DIRECTIVE_ARGS_PROPERTY);
+    return nameProp !== undefined && argsProp !== undefined;
+}
+/**
+ * Extracts the directive name from a Directive type.
+ */
+function extractDirectiveName(type, checker) {
+    const nameProp = type.getProperty(DIRECTIVE_NAME_PROPERTY);
+    if (!nameProp) {
+        return null;
+    }
+    const rawNameType = checker.getTypeOfSymbol(nameProp);
+    const nameType = getActualMetadataType(rawNameType);
+    if (!nameType || !nameType.isStringLiteral()) {
+        return null;
+    }
+    return nameType.value;
+}
+/**
+ * Extracts directive locations from a Directive type.
+ */
+function extractDirectiveLocations(type, checker) {
+    const locationProp = type.getProperty(DIRECTIVE_LOCATION_PROPERTY);
+    if (!locationProp) {
+        return ["FIELD_DEFINITION"];
+    }
+    const rawLocationType = checker.getTypeOfSymbol(locationProp);
+    const locations = [];
+    // Handle tuple types like ["FIELD_DEFINITION", "OBJECT"]
+    if (checker.isTupleType(rawLocationType)) {
+        const typeArgs = checker.getTypeArguments(rawLocationType);
+        for (const arg of typeArgs) {
+            if (arg.flags & ts.TypeFlags.Undefined) {
+                continue;
+            }
+            if (arg.isStringLiteral()) {
+                const value = arg.value;
+                if (isValidLocation(value)) {
+                    locations.push(value);
+                }
+            }
+        }
+        if (locations.length > 0) {
+            return locations;
+        }
+    }
+    // Handle array types
+    if (checker.isArrayType(rawLocationType)) {
+        const typeArgs = checker.getTypeArguments(rawLocationType);
+        if (typeArgs.length > 0 && typeArgs[0]) {
+            const elemType = typeArgs[0];
+            if (elemType.isUnion()) {
+                for (const member of elemType.types) {
+                    if (member.flags & ts.TypeFlags.Undefined) {
+                        continue;
+                    }
+                    if (member.isStringLiteral()) {
+                        const value = member.value;
+                        if (isValidLocation(value)) {
+                            locations.push(value);
+                        }
+                    }
+                }
+                if (locations.length > 0) {
+                    return locations;
+                }
+            }
+        }
+    }
+    // Handle union types like "OBJECT" | "FIELD_DEFINITION" | undefined
+    if (rawLocationType.isUnion()) {
+        for (const member of rawLocationType.types) {
+            if (member.flags & ts.TypeFlags.Undefined) {
+                continue;
+            }
+            if (member.isStringLiteral()) {
+                const value = member.value;
+                if (isValidLocation(value)) {
+                    locations.push(value);
+                }
+            }
+        }
+    }
+    else if (rawLocationType.isStringLiteral()) {
+        const value = rawLocationType.value;
+        if (isValidLocation(value)) {
+            locations.push(value);
+        }
+    }
+    else {
+        // Try to unwrap optional type (T | undefined where T is a single type)
+        const locationType = getActualMetadataType(rawLocationType);
+        if (locationType?.isStringLiteral()) {
+            const value = locationType.value;
+            if (isValidLocation(value)) {
+                locations.push(value);
+            }
+        }
+    }
+    return locations.length > 0 ? locations : ["FIELD_DEFINITION"];
+}
+const VALID_LOCATIONS = new Set([
+    "SCHEMA",
+    "SCALAR",
+    "OBJECT",
+    "FIELD_DEFINITION",
+    "ARGUMENT_DEFINITION",
+    "INTERFACE",
+    "UNION",
+    "ENUM",
+    "ENUM_VALUE",
+    "INPUT_OBJECT",
+    "INPUT_FIELD_DEFINITION",
+]);
+function isValidLocation(value) {
+    return VALID_LOCATIONS.has(value);
+}
+/**
+ * Converts a TypeScript type to a GraphQL field type.
+ */
+function convertToGraphQLType(type, checker) {
+    // Handle type parameters by getting their constraint
+    if (type.flags & ts.TypeFlags.TypeParameter) {
+        const constraint = checker.getBaseConstraintOfType(type);
+        if (constraint) {
+            return convertToGraphQLType(constraint, checker);
+        }
+    }
+    // Check for type alias (e.g., Role = "USER" | "ADMIN")
+    if (type.aliasSymbol) {
+        const aliasName = type.aliasSymbol.getName();
+        if (aliasName && aliasName !== "__type") {
+            return {
+                typeName: aliasName,
+                nullable: false,
+                list: false,
+                listItemNullable: null,
+            };
+        }
+    }
+    if (type.flags & ts.TypeFlags.String ||
+        type.flags & ts.TypeFlags.StringLiteral) {
+        return {
+            typeName: "String",
+            nullable: false,
+            list: false,
+            listItemNullable: null,
+        };
+    }
+    if (type.flags & ts.TypeFlags.Number ||
+        type.flags & ts.TypeFlags.NumberLiteral) {
+        return {
+            typeName: "Float",
+            nullable: false,
+            list: false,
+            listItemNullable: null,
+        };
+    }
+    if (type.flags & ts.TypeFlags.Boolean ||
+        type.flags & ts.TypeFlags.BooleanLiteral) {
+        return {
+            typeName: "Boolean",
+            nullable: false,
+            list: false,
+            listItemNullable: null,
+        };
+    }
+    if (type.isUnion()) {
+        const nonNullTypes = getNonNullableTypes(type);
+        const nullable = isNullableUnion(type);
+        if (nonNullTypes.length === 1 && nonNullTypes[0]) {
+            const innerType = convertToGraphQLType(nonNullTypes[0], checker);
+            if (innerType) {
+                return { ...innerType, nullable };
+            }
+        }
+        if (nonNullTypes.length > 0 &&
+            nonNullTypes.every((t) => t.isStringLiteral())) {
+            return {
+                typeName: "String",
+                nullable,
+                list: false,
+                listItemNullable: null,
+            };
+        }
+    }
+    if (checker.isArrayType(type) || checker.isTupleType(type)) {
+        const typeArgs = checker.getTypeArguments(type);
+        if (typeArgs.length > 0 && typeArgs[0]) {
+            let elementType = typeArgs[0];
+            if (checker.isTupleType(type) && typeArgs.length > 1) {
+                const nonNullTypes = typeArgs.filter((t) => !isNullOrUndefined(t));
+                if (nonNullTypes.length > 0 && nonNullTypes[0]) {
+                    elementType = nonNullTypes[0];
+                }
+            }
+            // Check if element type is a type alias (e.g., Role = "USER" | "ADMIN")
+            if (elementType.aliasSymbol) {
+                const aliasName = elementType.aliasSymbol.getName();
+                if (aliasName && aliasName !== "__type") {
+                    return {
+                        typeName: aliasName,
+                        nullable: false,
+                        list: true,
+                        listItemNullable: false,
+                    };
+                }
+            }
+            if (elementType.isUnion()) {
+                const nonNullMembers = getNonNullableTypes(elementType);
+                if (nonNullMembers.length > 0 &&
+                    nonNullMembers.every((t) => t.isStringLiteral())) {
+                    return {
+                        typeName: "String",
+                        nullable: false,
+                        list: true,
+                        listItemNullable: false,
+                    };
+                }
+                const hasNull = isNullableUnion(elementType);
+                if (nonNullMembers.length === 1 && nonNullMembers[0]) {
+                    const innerType = convertToGraphQLType(nonNullMembers[0], checker);
+                    if (innerType && !innerType.list) {
+                        return {
+                            typeName: innerType.typeName,
+                            nullable: false,
+                            list: true,
+                            listItemNullable: hasNull,
+                        };
+                    }
+                }
+            }
+            const innerType = convertToGraphQLType(elementType, checker);
+            if (innerType && !innerType.list) {
+                return {
+                    typeName: innerType.typeName,
+                    nullable: false,
+                    list: true,
+                    listItemNullable: innerType.nullable,
+                };
+            }
+        }
+        return {
+            typeName: "String",
+            nullable: false,
+            list: true,
+            listItemNullable: false,
+        };
+    }
+    if (type.symbol) {
+        const symbolName = type.symbol.getName();
+        if (symbolName !== "__type" && symbolName !== "") {
+            return {
+                typeName: symbolName,
+                nullable: false,
+                list: false,
+                listItemNullable: null,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Extracts directive argument definitions from a Directive type.
+ */
+function extractDirectiveArgs(type, checker, sourceFile, line) {
+    const argsProp = type.getProperty(DIRECTIVE_ARGS_PROPERTY);
+    if (!argsProp) {
+        return { args: [], errors: [] };
+    }
+    const rawArgsType = checker.getTypeOfSymbol(argsProp);
+    let argsType = getActualMetadataType(rawArgsType);
+    if (!argsType) {
+        return { args: [], errors: [] };
+    }
+    // If argsType is a type parameter, get its constraint
+    if (argsType.flags & ts.TypeFlags.TypeParameter) {
+        const constraint = checker.getBaseConstraintOfType(argsType);
+        if (constraint) {
+            argsType = constraint;
+        }
+    }
+    const args = [];
+    const errors = [];
+    const properties = argsType.getProperties();
+    for (const prop of properties) {
+        const propName = prop.getName();
+        const propType = checker.getTypeOfSymbol(prop);
+        const graphqlType = convertToGraphQLType(propType, checker);
+        if (graphqlType) {
+            args.push({
+                name: propName,
+                type: graphqlType,
+                description: null,
+            });
+        }
+        else {
+            errors.push({
+                code: "UNRESOLVABLE_ARG_TYPE",
+                message: `Cannot resolve argument type for '${propName}'`,
+                sourceFile,
+                line,
+            });
+        }
+    }
+    return { args, errors };
+}
+/**
+ * Extracts directive definitions from a TypeScript program.
+ *
+ * This function analyzes exported type aliases to find those that use
+ * the Directive<Name, Args, Location> type and extracts directive definitions.
+ *
+ * @param program - The TypeScript program
+ * @param sourceFiles - The source files to analyze
+ * @returns Extraction result with definitions and errors
+ */
+export function extractDirectiveDefinitions(program, sourceFiles) {
+    const checker = program.getTypeChecker();
+    const definitions = [];
+    const errors = [];
+    for (const filePath of sourceFiles) {
+        const sourceFile = program.getSourceFile(filePath);
+        if (!sourceFile) {
+            continue;
+        }
+        ts.forEachChild(sourceFile, (node) => {
+            if (!ts.isTypeAliasDeclaration(node)) {
+                return;
+            }
+            const modifiers = ts.getCombinedModifierFlags(node);
+            const isExported = (modifiers & ts.ModifierFlags.Export) !== 0;
+            if (!isExported) {
+                return;
+            }
+            const symbol = checker.getSymbolAtLocation(node.name);
+            if (!symbol) {
+                return;
+            }
+            const type = checker.getDeclaredTypeOfSymbol(symbol);
+            if (!isDirectiveType(type)) {
+                return;
+            }
+            const directiveName = extractDirectiveName(type, checker);
+            if (!directiveName) {
+                return;
+            }
+            const typeAliasName = node.name.getText(sourceFile);
+            const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+            const locations = extractDirectiveLocations(type, checker);
+            const argsResult = extractDirectiveArgs(type, checker, filePath, line + 1);
+            const description = extractDescription(node, checker);
+            definitions.push({
+                name: directiveName,
+                typeAliasName,
+                args: argsResult.args,
+                locations,
+                sourceFile: filePath,
+                line: line + 1,
+                description,
+            });
+            errors.push(...argsResult.errors);
+        });
+    }
+    return { definitions, errors };
+}
+/**
+ * Extracts description from TSDoc comments.
+ */
+function extractDescription(node, checker) {
+    const symbol = checker.getSymbolAtLocation(node.name);
+    if (!symbol) {
+        return null;
+    }
+    const documentation = symbol.getDocumentationComment(checker);
+    if (documentation.length === 0) {
+        return null;
+    }
+    return documentation.map((d) => d.text).join("\n");
+}
+//# sourceMappingURL=directive-definition-extractor.js.map

package/dist/shared/directive-definition-extractor.js.map

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

package/dist/shared/directive-detector.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Directive metadata detector.
+ *
+ * This module provides functions to detect directive metadata embedded
+ * in TypeScript intersection types using the $gqlkitFieldMeta or $gqlkitTypeMeta properties.
+ */
+import ts from "typescript";
+/**
+ * Represents a single directive argument value.
+ */
+export type DirectiveArgumentValue = {
+    readonly kind: "string";
+    readonly value: string;
+} | {
+    readonly kind: "number";
+    readonly value: number;
+} | {
+    readonly kind: "boolean";
+    readonly value: boolean;
+} | {
+    readonly kind: "null";
+    readonly value: null;
+} | {
+    readonly kind: "enum";
+    readonly value: string;
+} | {
+    readonly kind: "list";
+    readonly values: ReadonlyArray<DirectiveArgumentValue>;
+} | {
+    readonly kind: "object";
+    readonly fields: ReadonlyArray<DirectiveArgument>;
+};
+/**
+ * Represents a directive argument (name-value pair).
+ */
+export interface DirectiveArgument {
+    readonly name: string;
+    readonly value: DirectiveArgumentValue;
+}
+/**
+ * Represents a detected directive with its name and arguments.
+ */
+export interface DirectiveInfo {
+    readonly name: string;
+    readonly args: ReadonlyArray<DirectiveArgument>;
+}
+/**
+ * Error codes for directive detection.
+ */
+export type DirectiveDetectionErrorCode = "EMPTY_DIRECTIVE_NAME" | "UNRESOLVABLE_ARGUMENT";
+/**
+ * Error information for directive detection.
+ */
+export interface DirectiveDetectionError {
+    readonly code: DirectiveDetectionErrorCode;
+    readonly message: string;
+}
+/**
+ * Result of directive detection.
+ */
+export interface DirectiveDetectionResult {
+    readonly directives: ReadonlyArray<DirectiveInfo>;
+    readonly errors: ReadonlyArray<DirectiveDetectionError>;
+}
+/**
+ * Resolves a directive argument value from a TypeScript type.
+ */
+export declare function resolveArgumentValue(type: ts.Type, checker: ts.TypeChecker): DirectiveArgumentValue | null;
+/**
+ * Detects directive metadata from a TypeScript type.
+ *
+ * This function analyzes TypeScript types to detect directive metadata:
+ * - Intersection types with " $gqlkitFieldMeta" or " $gqlkitTypeMeta" property indicate directives
+ * - Each directive has a name and optional arguments
+ * - Arguments are resolved from TypeScript literal types
+ *
+ * @param type - The TypeScript type to analyze
+ * @param checker - The TypeScript type checker
+ * @returns Detection result with directives and any errors
+ */
+export declare function detectDirectiveMetadata(type: ts.Type, checker: ts.TypeChecker): DirectiveDetectionResult;
+/**
+ * Extracts directives from a tuple or array type.
+ * Use this to extract directives from a type like [AuthDirective, CacheDirective].
+ */
+export declare function extractDirectivesFromType(directivesType: ts.Type, checker: ts.TypeChecker): DirectiveDetectionResult;
+/**
+ * Checks if a type is wrapped with GqlField or GqlObject.
+ */
+export declare function hasDirectiveMetadata(type: ts.Type): boolean;
+/**
+ * Unwraps a GqlField or GqlObject type and returns the base type.
+ * For GqlField<T, Meta> which is T & { " $gqlkitFieldMeta"?: ...; " $gqlkitOriginalType"?: T },
+ * this extracts and returns T from the $gqlkitOriginalType property.
+ *
+ * The $gqlkitOriginalType property preserves nullability information that would otherwise
+ * be lost due to TypeScript's union type normalization.
+ *
+ * If the type is not wrapped with GqlField or GqlObject, returns the original type.
+ */
+export declare function unwrapDirectiveType(type: ts.Type, checker: ts.TypeChecker): ts.Type;
+//# sourceMappingURL=directive-detector.d.ts.map

package/dist/shared/directive-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directive-detector.d.ts","sourceRoot":"","sources":["../../src/shared/directive-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAoB5B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CACxD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACnD,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,sBAAsB,GACtB,uBAAuB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;CACzD;AASD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,sBAAsB,GAAG,IAAI,CA+F/B;AAwFD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,wBAAwB,CA+B1B;AA4BD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,EAAE,CAAC,IAAI,EACvB,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,wBAAwB,CA8C1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,OAAO,CAqC3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,EAAE,CAAC,IAAI,CA2FT"}