/**
 * Intentionally contract-only placeholders for legacy capabilities that do not
 * have a usable .NET student API. No implementation is exported, so production
 * code cannot accidentally report a mock success.
 */
export interface SchoolPlanningClient {
  createReport(input: unknown): Promise<unknown>;
  getReport(reportId: string): Promise<unknown>;
}

export interface QqOAuthClient {
  begin(returnUrl: string): Promise<{ authorizationUrl: string }>;
  complete(code: string, state: string): Promise<void>;
}

export interface StudentActivationCodeClient {
  inspect(code: string): Promise<unknown>;
  redeem(code: string): Promise<unknown>;
}

export interface CodeRunnerClient {
  execute(input: { language: string; source: string; stdin?: string }): Promise<unknown>;
}

export interface FutureFeatureClients {
  schoolPlanning: SchoolPlanningClient;
  qqOAuth: QqOAuthClient;
  studentActivationCode: StudentActivationCodeClient;
  codeRunner: CodeRunnerClient;
}