Interface ISpecStore

src/core/interfaces/ISpecService.ts:110–135

 * Interface for persisting OpenAPI specifications
 */
export interface ISpecStore {
  /**
   * Scan a directory and persist found specifications
   */
  scanAndSave(folderPath: string): Promise<void>;

  /**
   * Persist the catalog of specifications
   */
  saveSpecCatalog(catalog: SpecCatalogEntry[]): Promise<void>;

  /**
   * Load the catalog of specifications
   */
  loadSpecCatalog(): Promise<SpecCatalogEntry[]>;

  /**
   * Persist a single specification
   */
  saveSpec(spec: OpenAPIV3.Document, specId: string): Promise<void>;

  /**
   * Load a single specification by ID
   */
  loadSpec(specId: string): Promise<OpenAPIV3.Document>;
}

/**
 * Interface for exploring and querying OpenAPI specifications