@nielspeter/eess-ts 0.1.0

package/dist/graphql/schema-conditions.js

@@ -0,0 +1,119 @@
+/**
+ * Assert that a type has all listed fields.
+ *
+ * When applied to a type-level SchemaElement, checks that the object type
+ * defines all the named fields. When applied to a field-level element,
+ * checks the parent type.
+ *
+ * @param names - Field names that must exist on the type
+ */
+export function haveFields(...names) {
+    return {
+        description: 'have fields ' + names.map((n) => `"${n}"`).join(', '),
+        evaluate(elements, context) {
+            const violations = [];
+            for (const element of elements) {
+                const fields = element.objectType.getFields();
+                const fieldNames = Object.keys(fields);
+                for (const name of names) {
+                    if (!fieldNames.includes(name)) {
+                        violations.push({
+                            rule: context.rule,
+                            ruleId: context.ruleId,
+                            element: element.typeName,
+                            file: element.filePath ?? '<schema>',
+                            line: 1,
+                            message: `Type "${element.typeName}" is missing field "${name}"`,
+                            because: context.because,
+                            suggestion: context.suggestion,
+                            docs: context.docs,
+                        });
+                    }
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Assert that a field accepts all listed arguments.
+ *
+ * Only applies to field-level SchemaElements. Type-level elements are skipped.
+ *
+ * @param names - Argument names that must exist on the field
+ */
+export function acceptArgs(...names) {
+    return {
+        description: 'accept args ' + names.map((n) => `"${n}"`).join(', '),
+        evaluate(elements, context) {
+            const violations = [];
+            for (const element of elements) {
+                if (!element.field)
+                    continue;
+                const argNames = element.field.args.map((a) => a.name);
+                for (const name of names) {
+                    if (!argNames.includes(name)) {
+                        violations.push({
+                            rule: context.rule,
+                            ruleId: context.ruleId,
+                            element: `${element.typeName}.${element.fieldName ?? element.field.name}`,
+                            file: element.filePath ?? '<schema>',
+                            line: 1,
+                            message: `Field "${element.typeName}.${element.fieldName ?? element.field.name}" is missing argument "${name}"`,
+                            because: context.because,
+                            suggestion: context.suggestion,
+                            docs: context.docs,
+                        });
+                    }
+                }
+            }
+            return violations;
+        },
+    };
+}
+/**
+ * Assert that each schema field has a matching resolver export.
+ *
+ * Cross-references schema fields with TypeScript resolver files.
+ * A field "users" on type "Query" is matched if any resolver file exports
+ * a function/variable named "users" or contains a property assignment "Query.users".
+ *
+ * @param resolverFileTexts - Map of file paths to their source text (for matching)
+ */
+export function haveMatchingResolver(resolverFileTexts) {
+    return {
+        description: 'have matching resolver',
+        evaluate(elements, context) {
+            const violations = [];
+            const allText = [...resolverFileTexts.values()].join('\n');
+            for (const element of elements) {
+                if (!element.field)
+                    continue;
+                const fieldName = element.fieldName ?? element.field.name;
+                // Check if any resolver file references this field name
+                // Look for: export function fieldName, export const fieldName,
+                // or TypeName.fieldName patterns
+                const patterns = [
+                    new RegExp(`\\b${fieldName}\\b`),
+                    new RegExp(`${element.typeName}\\.${fieldName}`),
+                ];
+                const hasResolver = patterns.some((p) => p.test(allText));
+                if (!hasResolver) {
+                    violations.push({
+                        rule: context.rule,
+                        ruleId: context.ruleId,
+                        element: `${element.typeName}.${fieldName}`,
+                        file: element.filePath ?? '<schema>',
+                        line: 1,
+                        message: `Field "${element.typeName}.${fieldName}" has no matching resolver`,
+                        because: context.because,
+                        suggestion: context.suggestion,
+                        docs: context.docs,
+                    });
+                }
+            }
+            return violations;
+        },
+    };
+}
+//# sourceMappingURL=schema-conditions.js.map

package/dist/graphql/schema-conditions.js.map

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

package/dist/graphql/schema-loader.d.ts

@@ -0,0 +1,75 @@
+/**
+ * A parsed GraphQL schema with per-file document tracking.
+ *
+ * The schema is the merged result of all matched .graphql files.
+ * Documents preserve per-file source information for violation reporting.
+ */
+export interface LoadedSchema {
+    /** The merged GraphQL schema object (from `graphql` package's buildSchema) */
+    readonly schema: GraphQLSchemaLike;
+    /** Per-file parsed documents with source location info */
+    readonly documents: ReadonlyArray<{
+        readonly filePath: string;
+        readonly sdl: string;
+    }>;
+}
+/**
+ * Minimal interface for the parts of GraphQLSchema we use.
+ * Avoids importing graphql types at the module level (optional peer dep).
+ */
+export interface GraphQLSchemaLike {
+    getQueryType(): GraphQLObjectTypeLike | undefined | null;
+    getMutationType(): GraphQLObjectTypeLike | undefined | null;
+    getTypeMap(): Record<string, GraphQLTypeLike>;
+}
+/**
+ * Minimal interface for GraphQL object types.
+ */
+export interface GraphQLObjectTypeLike {
+    readonly name: string;
+    getFields(): Record<string, GraphQLFieldLike>;
+}
+/**
+ * Minimal interface for GraphQL fields.
+ */
+export interface GraphQLFieldLike {
+    readonly name: string;
+    readonly type: GraphQLTypeLike;
+    readonly args: ReadonlyArray<GraphQLArgumentLike>;
+}
+/**
+ * Minimal interface for GraphQL arguments.
+ */
+export interface GraphQLArgumentLike {
+    readonly name: string;
+    readonly type: GraphQLTypeLike;
+}
+/**
+ * Minimal interface for GraphQL types.
+ */
+export interface GraphQLTypeLike {
+    readonly toString: () => string;
+}
+/**
+ * Load and parse .graphql files matching a glob pattern relative to a root directory.
+ *
+ * @param rootDir - The root directory to resolve the glob against
+ * @param glob - Glob pattern for .graphql files (e.g. 'schema/*.graphql')
+ * @returns A LoadedSchema with the merged schema and per-file documents
+ * @throws If no .graphql files are found or if SDL is invalid
+ */
+export declare function loadSchemaFromGlob(rootDir: string, glob: string): LoadedSchema;
+/**
+ * Load a schema from a raw SDL string.
+ *
+ * @param sdl - GraphQL Schema Definition Language string
+ * @param sourcePath - Optional file path for error reporting
+ * @returns A LoadedSchema
+ */
+export declare function loadSchemaFromSDL(sdl: string, sourcePath?: string): LoadedSchema;
+/**
+ * Check whether the graphql package is available.
+ * Used by the runtime guard in the barrel export.
+ */
+export declare function isGraphQLAvailable(): boolean;
+//# sourceMappingURL=schema-loader.d.ts.map

package/dist/graphql/schema-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-loader.d.ts","sourceRoot":"","sources":["../../src/graphql/schema-loader.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KACrB,CAAC,CAAA;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,IAAI,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAAA;IACxD,eAAe,IAAI,qBAAqB,GAAG,SAAS,GAAG,IAAI,CAAA;IAC3D,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAA;CAChC;AAkCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAsB9E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAGhF;AAgDD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAQ5C"}

package/dist/graphql/schema-loader.js

@@ -0,0 +1,113 @@
+import { createRequire } from 'node:module';
+import fs from 'node:fs';
+import path from 'node:path';
+import picomatch from 'picomatch';
+// Cached reference to the graphql package
+let cachedGraphQL;
+/**
+ * Load the graphql package synchronously. Throws a clear error if not installed.
+ *
+ * Uses createRequire for synchronous loading since schema loading is synchronous.
+ */
+function requireGraphQL() {
+    if (cachedGraphQL)
+        return cachedGraphQL;
+    try {
+        const esmRequire = createRequire(import.meta.url);
+        // eess-exclude eess/adr005-no-type-assertions: runtime require() of the optional 'graphql' peer dependency; its module shape is not statically known at this JS-interop boundary
+        cachedGraphQL = esmRequire('graphql');
+        return cachedGraphQL;
+    }
+    catch (err) {
+        throw new Error('[eess/graphql] The "graphql" package is required but not installed.\n' +
+            'Install it with: npm install graphql', { cause: err });
+    }
+}
+/**
+ * Load and parse .graphql files matching a glob pattern relative to a root directory.
+ *
+ * @param rootDir - The root directory to resolve the glob against
+ * @param glob - Glob pattern for .graphql files (e.g. 'schema/*.graphql')
+ * @returns A LoadedSchema with the merged schema and per-file documents
+ * @throws If no .graphql files are found or if SDL is invalid
+ */
+export function loadSchemaFromGlob(rootDir, glob) {
+    const resolvedRoot = path.resolve(rootDir);
+    const matcher = picomatch(glob);
+    // Find all .graphql files matching the glob
+    const graphqlFiles = findGraphqlFiles(resolvedRoot, matcher);
+    if (graphqlFiles.length === 0) {
+        throw new Error(`[eess/graphql] No .graphql files found matching "${glob}" in ${resolvedRoot}`);
+    }
+    // Read all files and collect SDL
+    const documents = [];
+    const sdlParts = [];
+    for (const filePath of graphqlFiles) {
+        const sdl = fs.readFileSync(filePath, 'utf-8');
+        documents.push({ filePath, sdl });
+        sdlParts.push(sdl);
+    }
+    return buildLoadedSchema(sdlParts.join('\n'), documents);
+}
+/**
+ * Load a schema from a raw SDL string.
+ *
+ * @param sdl - GraphQL Schema Definition Language string
+ * @param sourcePath - Optional file path for error reporting
+ * @returns A LoadedSchema
+ */
+export function loadSchemaFromSDL(sdl, sourcePath) {
+    const documents = [{ filePath: sourcePath ?? '<inline>', sdl }];
+    return buildLoadedSchema(sdl, documents);
+}
+/**
+ * Build a LoadedSchema from concatenated SDL and per-file document list.
+ */
+function buildLoadedSchema(sdl, documents) {
+    const gql = requireGraphQL();
+    const schema = gql.buildSchema(sdl);
+    return { schema, documents };
+}
+/**
+ * Recursively find .graphql files in a directory that match the given predicate.
+ */
+function findGraphqlFiles(dir, matcher, rootDir) {
+    const root = rootDir ?? dir;
+    const results = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        void err; // unreadable dir — deliberately skipped
+        return results;
+    }
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...findGraphqlFiles(fullPath, matcher, root));
+        }
+        else if (entry.name.endsWith('.graphql')) {
+            const relativePath = path.relative(root, fullPath);
+            if (matcher(relativePath)) {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results.sort((a, b) => (a < b ? -1 : a > b ? 1 : 0));
+}
+/**
+ * Check whether the graphql package is available.
+ * Used by the runtime guard in the barrel export.
+ */
+export function isGraphQLAvailable() {
+    try {
+        requireGraphQL();
+        return true;
+    }
+    catch (err) {
+        void err; // probe: "not available" IS the answer
+        return false;
+    }
+}
+//# sourceMappingURL=schema-loader.js.map

package/dist/graphql/schema-loader.js.map

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

package/dist/graphql/schema-predicates.d.ts

@@ -0,0 +1,42 @@
+import type { Predicate } from '@nielspeter/eess';
+import type { GraphQLFieldLike, GraphQLObjectTypeLike } from './schema-loader.js';
+/**
+ * A schema element that predicates and conditions operate on.
+ *
+ * Represents either an object type or a field within a type.
+ */
+export interface SchemaElement {
+    /** The type this element belongs to (or is) */
+    readonly typeName: string;
+    /** The field name (undefined if the element is a type itself) */
+    readonly fieldName?: string;
+    /** The GraphQL object type */
+    readonly objectType: GraphQLObjectTypeLike;
+    /** The GraphQL field (present when element is a field) */
+    readonly field?: GraphQLFieldLike;
+    /** Source file path (for violation reporting) */
+    readonly filePath?: string;
+}
+/**
+ * Filter to only Query root type fields.
+ */
+export declare function queries(): Predicate<SchemaElement>;
+/**
+ * Filter to only Mutation root type fields.
+ */
+export declare function mutations(): Predicate<SchemaElement>;
+/**
+ * Filter to object types whose name matches the given pattern.
+ *
+ * @param pattern - Regex or exact string to match type names
+ */
+export declare function typesNamed(pattern: RegExp | string): Predicate<SchemaElement>;
+/**
+ * Filter to fields whose return type is a list of the given type.
+ *
+ * Matches GraphQL return types like `[User]`, `[User!]`, `[User!]!`.
+ *
+ * @param typeName - The inner type name (exact string or regex)
+ */
+export declare function returnListOf(typeName: string | RegExp): Predicate<SchemaElement>;
+//# sourceMappingURL=schema-predicates.d.ts.map

package/dist/graphql/schema-predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-predicates.d.ts","sourceRoot":"","sources":["../../src/graphql/schema-predicates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAEjF;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAA;IAC1C,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,SAAS,CAAC,aAAa,CAAC,CAOlD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAAC,aAAa,CAAC,CAOpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAgB7E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,aAAa,CAAC,CAkBhF"}

package/dist/graphql/schema-predicates.js

@@ -0,0 +1,74 @@
+/**
+ * Filter to only Query root type fields.
+ */
+export function queries() {
+    return {
+        description: 'are queries',
+        test(element) {
+            return element.typeName === 'Query' && element.field !== undefined;
+        },
+    };
+}
+/**
+ * Filter to only Mutation root type fields.
+ */
+export function mutations() {
+    return {
+        description: 'are mutations',
+        test(element) {
+            return element.typeName === 'Mutation' && element.field !== undefined;
+        },
+    };
+}
+/**
+ * Filter to object types whose name matches the given pattern.
+ *
+ * @param pattern - Regex or exact string to match type names
+ */
+export function typesNamed(pattern) {
+    const desc = typeof pattern === 'string' ? `"${pattern}"` : String(pattern);
+    if (typeof pattern === 'string') {
+        return {
+            description: `types named ${desc}`,
+            test(element) {
+                return element.field === undefined && element.typeName === pattern;
+            },
+        };
+    }
+    return {
+        description: `types named ${desc}`,
+        test(element) {
+            return element.field === undefined && pattern.test(element.typeName);
+        },
+    };
+}
+/**
+ * Filter to fields whose return type is a list of the given type.
+ *
+ * Matches GraphQL return types like `[User]`, `[User!]`, `[User!]!`.
+ *
+ * @param typeName - The inner type name (exact string or regex)
+ */
+export function returnListOf(typeName) {
+    const desc = typeof typeName === 'string' ? `"${typeName}"` : String(typeName);
+    return {
+        description: `return list of ${desc}`,
+        test(element) {
+            if (!element.field)
+                return false;
+            const typeStr = element.field.type.toString();
+            // Match [TypeName], [TypeName!], [TypeName!]!, [TypeName]!
+            const listMatch = /^\[(.+?)!?\]!?$/.exec(typeStr);
+            if (!listMatch)
+                return false;
+            const innerType = listMatch[1];
+            if (innerType === undefined)
+                return false;
+            if (typeof typeName === 'string') {
+                return innerType === typeName;
+            }
+            return typeName.test(innerType);
+        },
+    };
+}
+//# sourceMappingURL=schema-predicates.js.map

package/dist/graphql/schema-predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-predicates.js","sourceRoot":"","sources":["../../src/graphql/schema-predicates.ts"],"names":[],"mappings":"AAqBA;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO;QACL,WAAW,EAAE,aAAa;QAC1B,IAAI,CAAC,OAAsB;YACzB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAA;QACpE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,WAAW,EAAE,eAAe;QAC5B,IAAI,CAAC,OAAsB;YACzB,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAA;QACvE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAwB;IACjD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3E,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,WAAW,EAAE,eAAe,IAAI,EAAE;YAClC,IAAI,CAAC,OAAsB;gBACzB,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAA;YACpE,CAAC;SACF,CAAA;IACH,CAAC;IACD,OAAO;QACL,WAAW,EAAE,eAAe,IAAI,EAAE;QAClC,IAAI,CAAC,OAAsB;YACzB,OAAO,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACtE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC9E,OAAO;QACL,WAAW,EAAE,kBAAkB,IAAI,EAAE;QACrC,IAAI,CAAC,OAAsB;YACzB,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,OAAO,KAAK,CAAA;YAChC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC7C,2DAA2D;YAC3D,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACjD,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAA;YAC5B,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;YAC9B,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAA;YACzC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,SAAS,KAAK,QAAQ,CAAA;YAC/B,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/graphql/schema-rule-builder.d.ts

@@ -0,0 +1,74 @@
+import type { ArchViolation } from '../core/violation.js';
+import { TerminalBuilder } from '@nielspeter/eess';
+import type { LoadedSchema } from './schema-loader.js';
+/**
+ * Fluent rule builder for GraphQL schema architecture rules.
+ *
+ * Operates on SchemaElements extracted from .graphql files.
+ * Follows the same builder pattern as SliceRuleBuilder (standalone, not extending RuleBuilder).
+ *
+ * @example
+ * ```typescript
+ * schema(p, 'src/schema/*.graphql')
+ *   .typesNamed(/Collection$/)
+ *   .should()
+ *   .haveFields('total', 'skip', 'limit', 'items')
+ *   .check()
+ * ```
+ */
+export declare class SchemaRuleBuilder extends TerminalBuilder {
+    private readonly loaded;
+    private readonly _predicates;
+    private readonly _conditions;
+    constructor(loaded: LoadedSchema);
+    /**
+     * Filter to only Query root type fields.
+     */
+    queries(): this;
+    /**
+     * Filter to only Mutation root type fields.
+     */
+    mutations(): this;
+    /**
+     * Filter to object types matching the given name pattern.
+     */
+    typesNamed(pattern: RegExp | string): this;
+    /**
+     * Filter to fields returning a list of the given type.
+     */
+    returnListOf(typeName: string | RegExp): this;
+    /**
+     * Begin the predicate phase. Purely a readability marker.
+     */
+    that(): this;
+    /**
+     * Add another predicate (AND).
+     */
+    and(): this;
+    /**
+     * Begin the condition phase.
+     */
+    should(): this;
+    /**
+     * Add another condition (AND).
+     */
+    andShould(): this;
+    /**
+     * Assert that types have all listed fields.
+     */
+    haveFields(...names: string[]): this;
+    /**
+     * Assert that fields accept all listed arguments.
+     */
+    acceptArgs(...names: string[]): this;
+    /**
+     * Assert that schema fields have matching resolver implementations.
+     *
+     * @param resolverFileTexts - Map of file paths to source text
+     */
+    haveMatchingResolver(resolverFileTexts: ReadonlyMap<string, string>): this;
+    protected collectViolations(): ArchViolation[];
+    private getElements;
+    private buildRuleDescription;
+}
+//# sourceMappingURL=schema-rule-builder.d.ts.map

package/dist/graphql/schema-rule-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-rule-builder.d.ts","sourceRoot":"","sources":["../../src/graphql/schema-rule-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAA0C,MAAM,oBAAoB,CAAA;AA2B9F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iBAAkB,SAAQ,eAAe;IAIxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAEhC,MAAM,EAAE,YAAY;IAMjD;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,SAAS,IAAI,IAAI;IAKjB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK1C;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO7C;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,GAAG,IAAI,IAAI;IAIX;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;OAEG;IACH,SAAS,IAAI,IAAI;IAMjB;;OAEG;IACH,UAAU,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKpC;;OAEG;IACH,UAAU,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAKpC;;;;OAIG;IACH,oBAAoB,CAAC,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAO1E,SAAS,CAAC,iBAAiB,IAAI,aAAa,EAAE;IAmC9C,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,oBAAoB;CAQ7B"}