@gqlkit-ts/cli 0.0.1 → 0.1.0

package/dist/shared/directive-detector.js

@@ -0,0 +1,422 @@
+/**
+ * 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";
+import { METADATA_PROPERTIES, RUNTIME_TYPE_NAMES } from "./constants.js";
+import { getActualMetadataType } from "./metadata-detector.js";
+const FIELD_META_PROPERTY = METADATA_PROPERTIES.FIELD_META;
+const TYPE_META_PROPERTY = METADATA_PROPERTIES.TYPE_META;
+const DIRECTIVE_NAME_PROPERTY = METADATA_PROPERTIES.DIRECTIVE_NAME;
+const DIRECTIVE_ARGS_PROPERTY = METADATA_PROPERTIES.DIRECTIVE_ARGS;
+const ORIGINAL_TYPE_PROPERTY = METADATA_PROPERTIES.ORIGINAL_TYPE;
+/**
+ * Gets the metadata property from a type, checking both field and type meta properties.
+ */
+function getMetaProperty(type) {
+    return (type.getProperty(FIELD_META_PROPERTY) ??
+        type.getProperty(TYPE_META_PROPERTY));
+}
+function createEmptyResult() {
+    return {
+        directives: [],
+        errors: [],
+    };
+}
+/**
+ * Resolves a directive argument value from a TypeScript type.
+ */
+export function resolveArgumentValue(type, checker) {
+    if (type.flags & ts.TypeFlags.Null) {
+        return { kind: "null", value: null };
+    }
+    if (type.isStringLiteral()) {
+        // Check enum pattern: starts with uppercase and contains only uppercase letters, digits, and underscores
+        if (/^[A-Z][A-Z0-9_]*$/.test(type.value)) {
+            return { kind: "enum", value: type.value };
+        }
+        return { kind: "string", value: type.value };
+    }
+    if (type.isNumberLiteral()) {
+        return { kind: "number", value: type.value };
+    }
+    if (type.flags & ts.TypeFlags.BooleanLiteral) {
+        const intrinsicName = type
+            .intrinsicName;
+        if (intrinsicName === "true") {
+            return { kind: "boolean", value: true };
+        }
+        if (intrinsicName === "false") {
+            return { kind: "boolean", value: false };
+        }
+    }
+    if (checker.isTupleType(type)) {
+        const typeArgs = checker.getTypeArguments(type);
+        const values = [];
+        for (const arg of typeArgs) {
+            const resolved = resolveArgumentValue(arg, checker);
+            if (resolved) {
+                values.push(resolved);
+            }
+        }
+        return { kind: "list", values };
+    }
+    if (checker.isArrayType(type)) {
+        const typeArgs = checker.getTypeArguments(type);
+        if (typeArgs.length > 0 && typeArgs[0]) {
+            const elemType = typeArgs[0];
+            if (elemType.isUnion()) {
+                const values = [];
+                for (const member of elemType.types) {
+                    const resolved = resolveArgumentValue(member, checker);
+                    if (resolved) {
+                        values.push(resolved);
+                    }
+                }
+                return { kind: "list", values };
+            }
+        }
+    }
+    const properties = type.getProperties();
+    if (properties.length > 0) {
+        const isMetadataProperty = properties.some((p) => p.getName().startsWith(" $") ||
+            p.getName() === DIRECTIVE_NAME_PROPERTY ||
+            p.getName() === DIRECTIVE_ARGS_PROPERTY);
+        if (!isMetadataProperty) {
+            const fields = [];
+            for (const prop of properties) {
+                const propType = checker.getTypeOfSymbol(prop);
+                const resolved = resolveArgumentValue(propType, checker);
+                if (resolved) {
+                    fields.push({ name: prop.getName(), value: resolved });
+                }
+            }
+            if (fields.length > 0) {
+                return { kind: "object", fields };
+            }
+        }
+    }
+    const symbol = type.getSymbol();
+    if (symbol) {
+        const name = symbol.getName();
+        if (name !== "__type" &&
+            name !== "Array" &&
+            !name.includes("<") &&
+            /^[A-Z][A-Z0-9_]*$/.test(name)) {
+            return { kind: "enum", value: name };
+        }
+    }
+    return null;
+}
+/**
+ * Extracts directive arguments from a type.
+ */
+function extractDirectiveArgs(argsType, checker, directiveName) {
+    const args = [];
+    const errors = [];
+    const properties = argsType.getProperties();
+    for (const prop of properties) {
+        const propName = prop.getName();
+        const propType = checker.getTypeOfSymbol(prop);
+        const resolved = resolveArgumentValue(propType, checker);
+        if (resolved) {
+            args.push({ name: propName, value: resolved });
+        }
+        else {
+            errors.push({
+                code: "UNRESOLVABLE_ARGUMENT",
+                message: `Cannot resolve argument '${propName}' for directive '@${directiveName}'`,
+            });
+        }
+    }
+    return { args, errors };
+}
+/**
+ * Extracts a single directive from a type.
+ */
+function extractDirectiveFromType(type, checker) {
+    const nameProp = type.getProperty(DIRECTIVE_NAME_PROPERTY);
+    if (!nameProp) {
+        return { directive: null, errors: [] };
+    }
+    const rawNameType = checker.getTypeOfSymbol(nameProp);
+    const nameType = getActualMetadataType(rawNameType);
+    if (!nameType || !nameType.isStringLiteral()) {
+        return { directive: null, errors: [] };
+    }
+    const directiveName = nameType.value;
+    if (directiveName === "") {
+        return {
+            directive: null,
+            errors: [
+                {
+                    code: "EMPTY_DIRECTIVE_NAME",
+                    message: "Directive name cannot be empty",
+                },
+            ],
+        };
+    }
+    const argsProp = type.getProperty(DIRECTIVE_ARGS_PROPERTY);
+    let args = [];
+    let argErrors = [];
+    if (argsProp) {
+        const rawArgsType = checker.getTypeOfSymbol(argsProp);
+        const argsType = getActualMetadataType(rawArgsType);
+        if (argsType) {
+            const argsResult = extractDirectiveArgs(argsType, checker, directiveName);
+            args = argsResult.args;
+            argErrors = argsResult.errors;
+        }
+    }
+    return {
+        directive: { name: directiveName, args },
+        errors: argErrors,
+    };
+}
+/**
+ * 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 function detectDirectiveMetadata(type, checker) {
+    const metaProp = getMetaProperty(type);
+    if (!metaProp) {
+        if (type.isIntersection()) {
+            for (const member of type.types) {
+                const memberProp = getMetaProperty(member);
+                if (memberProp) {
+                    return detectDirectiveMetadataFromProperty(memberProp, checker);
+                }
+            }
+        }
+        // Handle union types: (T & Directive) | null
+        if (type.isUnion()) {
+            for (const member of type.types) {
+                // Skip null/undefined members
+                if (member.flags & ts.TypeFlags.Null ||
+                    member.flags & ts.TypeFlags.Undefined) {
+                    continue;
+                }
+                const result = detectDirectiveMetadata(member, checker);
+                if (result.directives.length > 0) {
+                    return result;
+                }
+            }
+        }
+        return createEmptyResult();
+    }
+    return detectDirectiveMetadataFromProperty(metaProp, checker);
+}
+function detectDirectiveMetadataFromProperty(directivesProp, checker) {
+    const rawDirectivesType = checker.getTypeOfSymbol(directivesProp);
+    const directivesType = getActualMetadataType(rawDirectivesType);
+    if (!directivesType) {
+        return createEmptyResult();
+    }
+    // New structure: { directives: Ds }
+    // Check if the type has a "directives" property
+    const directivesArrayProp = directivesType.getProperty("directives");
+    if (directivesArrayProp) {
+        const rawDirectivesArrayType = checker.getTypeOfSymbol(directivesArrayProp);
+        const directivesArrayType = getActualMetadataType(rawDirectivesArrayType);
+        if (directivesArrayType) {
+            return extractDirectivesFromType(directivesArrayType, checker);
+        }
+    }
+    // Fallback: Old structure - direct array/tuple form (for backward compatibility)
+    return extractDirectivesFromType(directivesType, checker);
+}
+/**
+ * Extracts directives from a tuple or array type.
+ * Use this to extract directives from a type like [AuthDirective, CacheDirective].
+ */
+export function extractDirectivesFromType(directivesType, checker) {
+    const directives = [];
+    const errors = [];
+    if (checker.isTupleType(directivesType)) {
+        const typeArgs = checker.getTypeArguments(directivesType);
+        for (const arg of typeArgs) {
+            const result = extractDirectiveFromType(arg, checker);
+            if (result.directive) {
+                directives.push(result.directive);
+            }
+            errors.push(...result.errors);
+        }
+    }
+    else if (checker.isArrayType(directivesType)) {
+        const typeArgs = checker.getTypeArguments(directivesType);
+        if (typeArgs.length > 0 && typeArgs[0]) {
+            const elemType = typeArgs[0];
+            if (elemType.isUnion()) {
+                for (const member of elemType.types) {
+                    const result = extractDirectiveFromType(member, checker);
+                    if (result.directive) {
+                        directives.push(result.directive);
+                    }
+                    errors.push(...result.errors);
+                }
+            }
+            else {
+                const result = extractDirectiveFromType(elemType, checker);
+                if (result.directive) {
+                    directives.push(result.directive);
+                }
+                errors.push(...result.errors);
+            }
+        }
+    }
+    else {
+        const result = extractDirectiveFromType(directivesType, checker);
+        if (result.directive) {
+            directives.push(result.directive);
+        }
+        errors.push(...result.errors);
+    }
+    return { directives, errors };
+}
+/**
+ * Checks if a type is wrapped with GqlField or GqlObject.
+ */
+export function hasDirectiveMetadata(type) {
+    const metaProp = getMetaProperty(type);
+    if (metaProp) {
+        return true;
+    }
+    // Also check for the original type property (GqlField marker)
+    const originalTypeProp = type.getProperty(ORIGINAL_TYPE_PROPERTY);
+    if (originalTypeProp) {
+        return true;
+    }
+    if (type.isIntersection()) {
+        for (const member of type.types) {
+            const prop = getMetaProperty(member);
+            if (prop) {
+                return true;
+            }
+            // Also check for original type property in intersection members
+            const origProp = member.getProperty(ORIGINAL_TYPE_PROPERTY);
+            if (origProp) {
+                return true;
+            }
+        }
+    }
+    // Handle union types: (T & Meta) | null is normalized by TypeScript
+    // to (T & Meta) | null, so we need to check each member recursively
+    if (type.isUnion()) {
+        for (const member of type.types) {
+            if (hasDirectiveMetadata(member)) {
+                return true;
+            }
+        }
+    }
+    // Check for GqlField/GqlObject type alias by examining the alias symbol
+    if (type.aliasSymbol) {
+        const aliasName = type.aliasSymbol.getName();
+        if (aliasName === RUNTIME_TYPE_NAMES.GQL_FIELD ||
+            aliasName === RUNTIME_TYPE_NAMES.GQL_OBJECT) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 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 function unwrapDirectiveType(type, checker) {
+    // 1. Check aliasTypeArguments first (most reliable)
+    //    Get T directly from GqlField<T, Meta> or GqlObject<T, Meta>
+    //    This works when the type alias hasn't been expanded by TypeScript
+    if (type.aliasTypeArguments && type.aliasTypeArguments.length > 0) {
+        const aliasSymbolName = type.aliasSymbol?.getName() ?? "";
+        if (aliasSymbolName === RUNTIME_TYPE_NAMES.GQL_FIELD ||
+            aliasSymbolName === RUNTIME_TYPE_NAMES.GQL_OBJECT) {
+            return type.aliasTypeArguments[0];
+        }
+    }
+    // 2. Check intersection members' aliasTypeArguments
+    //    When TypeScript expands the type alias to an intersection,
+    //    one of the intersection members might still have aliasTypeArguments
+    if (type.isIntersection()) {
+        for (const member of type.types) {
+            if (member.aliasTypeArguments && member.aliasTypeArguments.length > 0) {
+                const memberAliasSymbolName = member.aliasSymbol?.getName() ?? "";
+                if (memberAliasSymbolName === RUNTIME_TYPE_NAMES.GQL_FIELD ||
+                    memberAliasSymbolName === RUNTIME_TYPE_NAMES.GQL_OBJECT) {
+                    return member.aliasTypeArguments[0];
+                }
+            }
+        }
+    }
+    // 3. Fall back to $gqlkitOriginalType property
+    // This property preserves the original type information including array types.
+    // The type's symbol name may be __type (internal TypeScript symbol), but that's
+    // handled by the caller using checker.typeToString() for correct type name resolution.
+    const originalTypeProp = type.getProperty(ORIGINAL_TYPE_PROPERTY);
+    if (originalTypeProp) {
+        const rawOriginalType = checker.getTypeOfSymbol(originalTypeProp);
+        const originalType = getActualMetadataType(rawOriginalType);
+        if (originalType) {
+            return originalType;
+        }
+    }
+    // Check intersection members for $gqlkitOriginalType
+    if (type.isIntersection()) {
+        for (const member of type.types) {
+            const originalProp = member.getProperty(ORIGINAL_TYPE_PROPERTY);
+            if (originalProp) {
+                const rawOriginalType = checker.getTypeOfSymbol(originalProp);
+                const originalType = getActualMetadataType(rawOriginalType);
+                if (originalType) {
+                    return originalType;
+                }
+            }
+        }
+        // Fallback: filter out metadata members
+        const nonDirectiveMembers = [];
+        for (const member of type.types) {
+            const metaProp = getMetaProperty(member);
+            const originalTypeProp = member.getProperty(ORIGINAL_TYPE_PROPERTY);
+            if (!metaProp && !originalTypeProp) {
+                nonDirectiveMembers.push(member);
+            }
+        }
+        if (nonDirectiveMembers.length === 1 && nonDirectiveMembers[0]) {
+            return nonDirectiveMembers[0];
+        }
+    }
+    // Handle union types: (T & Meta) | null
+    // We extract the base type from the non-null member and return it.
+    // Nullability is handled separately in the type-extractor.
+    if (type.isUnion()) {
+        for (const member of type.types) {
+            // Skip null/undefined members
+            if (member.flags & ts.TypeFlags.Null ||
+                member.flags & ts.TypeFlags.Undefined) {
+                continue;
+            }
+            // Recursively unwrap if this member has metadata
+            const unwrapped = unwrapDirectiveType(member, checker);
+            if (unwrapped !== member) {
+                return unwrapped;
+            }
+        }
+    }
+    return type;
+}
+//# sourceMappingURL=directive-detector.js.map

package/dist/shared/directive-detector.js.map

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

package/dist/shared/file-scanner.d.ts

@@ -0,0 +1,25 @@
+import type { Diagnostic } from "../type-extractor/types/index.js";
+export interface ScanResult {
+    readonly files: ReadonlyArray<string>;
+    readonly errors: ReadonlyArray<Diagnostic>;
+}
+export interface ScanOptions {
+    /**
+     * Glob patterns to exclude files.
+     * Patterns are matched against file paths relative to the scan directory.
+     */
+    readonly excludeGlobs?: ReadonlyArray<string>;
+    /**
+     * File paths to exclude (for generated files).
+     * Each path is individually excluded from scanning.
+     */
+    readonly excludePaths?: ReadonlyArray<string>;
+    /**
+     * Simple suffix patterns to exclude (existing behavior).
+     * @deprecated Use excludeGlobs instead
+     */
+    readonly excludePatterns?: ReadonlyArray<string>;
+}
+export declare function isTypeScriptSourceFile(fileName: string): boolean;
+export declare function scanDirectory(directory: string, options?: ScanOptions): Promise<ScanResult>;
+//# sourceMappingURL=file-scanner.d.ts.map

package/dist/shared/file-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/shared/file-scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClD;AAKD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKhE;AA6ED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAgDrB"}

package/dist/shared/file-scanner.js

@@ -0,0 +1,99 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, matchesGlob, relative, resolve } from "node:path";
+const TS_SOURCE_EXTENSIONS = [".ts", ".cts", ".mts"];
+const TS_DEFINITION_SUFFIXES = [".d.ts", ".d.cts", ".d.mts"];
+export function isTypeScriptSourceFile(fileName) {
+    if (TS_DEFINITION_SUFFIXES.some((suffix) => fileName.endsWith(suffix))) {
+        return false;
+    }
+    return TS_SOURCE_EXTENSIONS.some((ext) => fileName.endsWith(ext));
+}
+function matchesSuffixPattern(fileName, pattern) {
+    return fileName.endsWith(pattern);
+}
+function shouldExcludeBySuffix(fileName, excludePatterns) {
+    return excludePatterns.some((pattern) => matchesSuffixPattern(fileName, pattern));
+}
+function shouldExcludeByGlobs(filePath, rootDir, excludeGlobs) {
+    if (excludeGlobs.length === 0) {
+        return false;
+    }
+    const relativePath = relative(rootDir, filePath);
+    return excludeGlobs.some((pattern) => matchesGlob(relativePath, pattern));
+}
+function shouldExcludeByPaths(filePath, excludePaths) {
+    return excludePaths.some((excludePath) => filePath === excludePath);
+}
+async function collectFiles(directory, files, context) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(directory, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules") {
+                continue;
+            }
+            await collectFiles(fullPath, files, context);
+        }
+        else if (entry.isFile()) {
+            if (!isTypeScriptSourceFile(entry.name)) {
+                continue;
+            }
+            if (shouldExcludeBySuffix(entry.name, context.excludePatterns)) {
+                continue;
+            }
+            if (shouldExcludeByGlobs(fullPath, context.rootDir, context.excludeGlobs)) {
+                continue;
+            }
+            if (shouldExcludeByPaths(fullPath, context.excludePaths)) {
+                continue;
+            }
+            files.push(fullPath);
+        }
+    }
+}
+export async function scanDirectory(directory, options = {}) {
+    const absolutePath = resolve(directory);
+    try {
+        const stats = await stat(absolutePath);
+        if (!stats.isDirectory()) {
+            return {
+                files: [],
+                errors: [
+                    {
+                        code: "DIRECTORY_NOT_FOUND",
+                        message: `Path is not a directory: ${absolutePath}`,
+                        severity: "error",
+                        location: null,
+                    },
+                ],
+            };
+        }
+    }
+    catch {
+        return {
+            files: [],
+            errors: [
+                {
+                    code: "DIRECTORY_NOT_FOUND",
+                    message: `Directory not found: ${absolutePath}`,
+                    severity: "error",
+                    location: null,
+                },
+            ],
+        };
+    }
+    const context = {
+        rootDir: absolutePath,
+        excludePatterns: options.excludePatterns ?? [],
+        excludeGlobs: options.excludeGlobs ?? [],
+        excludePaths: options.excludePaths ?? [],
+    };
+    const files = [];
+    await collectFiles(absolutePath, files, context);
+    files.sort();
+    return {
+        files,
+        errors: [],
+    };
+}
+//# sourceMappingURL=file-scanner.js.map

package/dist/shared/file-scanner.js.map

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

package/dist/shared/file-scanner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-scanner.test.d.ts.map

package/dist/shared/file-scanner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-scanner.test.d.ts","sourceRoot":"","sources":["../../src/shared/file-scanner.test.ts"],"names":[],"mappings":""}