import { Rule, registerRule, createValidationError } from '@speakeasy-api/openapi-linter-types';
import type { Context, DocumentInfo, RuleConfig, ValidationError } from '@speakeasy-api/openapi-linter-types';

class RequireOperationSummary extends Rule {
  id(): string { return 'custom-require-operation-summary'; }
  category(): string { return 'style'; }
  description(): string { return 'All operations must have a summary.'; }
  summary(): string { return 'Operations must have summary'; }

  run(ctx: Context, docInfo: DocumentInfo, config: RuleConfig): ValidationError[] {
    const errors: ValidationError[] = [];

    for (const opNode of docInfo.index.operations) {
      const op = opNode.node;
      if (!op.getSummary()) {
        errors.push(createValidationError(
          config.getSeverity(this.defaultSeverity()),
          this.id(),
          `Operation "${op.getOperationID() || 'unnamed'}" is missing a summary`,
          op.getRootNode()
        ));
      }
    }

    return errors;
  }
}

registerRule(new RequireOperationSummary());

run(ctx: Context, docInfo: DocumentInfo, config: RuleConfig): ValidationError[] {
  // Access the document root
  const doc = docInfo.document;
  const info = doc.getInfo();

  // Access file location
  const location = docInfo.location;

  // Use the pre-computed index for efficient iteration
  const index = docInfo.index;

  // All operations in the document
  for (const opNode of index.operations) {
    const operation = opNode.node;
    const path = opNode.locations.path;
    const method = opNode.locations.method;
  }

  // All component schemas
  for (const schemaNode of index.componentSchemas) {
    const schema = schemaNode.node;
    const name = schemaNode.locations.name;
  }

  // All inline schemas
  for (const schemaNode of index.inlineSchemas) { ... }

  // All parameters (inline + component)
  for (const paramNode of index.parameters) { ... }

  // All request bodies
  for (const reqBodyNode of index.requestBodies) { ... }

  // All responses
  for (const responseNode of index.responses) { ... }

  // All headers
  for (const headerNode of index.headers) { ... }

  // All security schemes
  for (const secSchemeNode of index.securitySchemes) { ... }

  // ... and many more collections
}

import { createValidationError } from '@speakeasy-api/openapi-linter-types';

// Basic error
errors.push(createValidationError(
  'warning',                    // severity: 'error' | 'warning' | 'hint'
  'custom-my-rule',            // rule ID
  'Description of the issue',  // message
  node.getRootNode()           // YAML node for location
));

// Using config severity (respects user overrides)
errors.push(createValidationError(
  config.getSeverity(this.defaultSeverity()),
  this.id(),
  'Description of the issue',
  node.getRootNode()
));

console.log('Processing:', op.getOperationID());
console.warn('Missing recommended field');
console.error('Invalid configuration');