smartproxy/ts/http/port80/acme-interfaces.ts

/**
 * Type definitions for SmartAcme interfaces used by ChallengeResponder
 * These reflect the actual SmartAcme API based on the documentation
 */
import * as plugins from '../../plugins.js';

/**
 * Structure for SmartAcme certificate result
 */
export interface ISmartAcmeCert {
  id?: string;
  domainName: string;
  created?: number | Date | string;
  privateKey: string;
  publicKey: string;
  csr?: string;
  validUntil: number | Date | string;
}

/**
 * Structure for SmartAcme options
 */
export interface ISmartAcmeOptions {
  accountEmail: string;
  certManager: ICertManager;
  environment: 'production' | 'integration';
  challengeHandlers: IChallengeHandler<any>[];
  challengePriority?: string[];
  retryOptions?: {
    retries?: number;
    factor?: number;
    minTimeoutMs?: number;
    maxTimeoutMs?: number;
  };
}

/**
 * Interface for certificate manager
 */
export interface ICertManager {
  init(): Promise<void>;
  get(domainName: string): Promise<ISmartAcmeCert | null>;
  put(cert: ISmartAcmeCert): Promise<ISmartAcmeCert>;
  delete(domainName: string): Promise<void>;
  close?(): Promise<void>;
}

/**
 * Interface for challenge handler
 */
export interface IChallengeHandler<T> {
  getSupportedTypes(): string[];
  prepare(ch: T): Promise<void>;
  verify?(ch: T): Promise<void>;
  cleanup(ch: T): Promise<void>;
  checkWetherDomainIsSupported(domain: string): Promise<boolean>;
}

/**
 * HTTP-01 challenge type
 */
export interface IHttp01Challenge {
  type: string; // 'http-01'
  token: string;
  keyAuthorization: string;
  webPath: string;
}

/**
 * HTTP-01 Memory Handler Interface
 */
export interface IHttp01MemoryHandler extends IChallengeHandler<IHttp01Challenge> {
  handleRequest(req: plugins.http.IncomingMessage, res: plugins.http.ServerResponse, next?: () => void): void;
}

/**
 * SmartAcme main class interface
 */
export interface ISmartAcme {
  start(): Promise<void>;
  stop(): Promise<void>;
  getCertificateForDomain(domain: string): Promise<ISmartAcmeCert>;
  on?(event: string, listener: (data: any) => void): void;
  eventEmitter?: plugins.EventEmitter;
}