export class StrapkitConfigError extends Error {
  constructor(message: string);
  name: "StrapkitConfigError";
}

export class StrapkitRuntimeError extends Error {
  constructor(message: string, cause?: unknown);
  name: "StrapkitRuntimeError";
  cause?: unknown;
}

export interface StrapkitOptions {
  apiKey: string;
  moduleOpts?: Record<string, unknown>;
  terminal?: Terminal;
  baseUrl?: string;
}

interface Terminal {
  write(data: string): void;
  onData(callback: (data: string) => void): void;
  cols?: number;
  rows?: number;
}

export interface ExecOptions {
  env?: Record<string, string>;
  cwd?: string;
  stdin?: string;
  input?: string;
  args?: string[];
  onStdout?: (text: string) => void;
  onStderr?: (text: string) => void;
  terminal?: Terminal;
}

export interface ExecResult {
  stdout: string;
  stderr: string;
  exitCode: number;
}

export interface TreeEntry {
  name: string;
  path: string;
  type: "file" | "directory";
  children?: TreeEntry[];
}

export interface PortOpenInfo {
  addr: string;
}

export default class Strapkit {
  constructor(opts: StrapkitOptions);

  init(): Promise<object>;

  setApiKey(apiKey: string): void;

  onPortOpen(callback: (port: number, info: PortOpenInfo) => void): void;

  write(path: string, contents: string | Uint8Array): Promise<void>;
  writeMultiple(
    files: Record<string, { file: { contents: string | Uint8Array } }>,
  ): Promise<void>;

  read(path: string): Promise<string>;
  readdir(path?: string): Promise<string[]>;
  isDir(path: string): Promise<boolean>;
  readTree(dir?: string): Promise<TreeEntry[]>;

  mkdir(path: string): Promise<void>;
  rm(path: string): Promise<void>;

  snapshot(filter?: (path: string) => boolean): Promise<Record<string, string>>;

  cacheSave(path: string, key: string): Promise<void>;
  cacheRestore(path: string, key: string): Promise<boolean>;
  cacheHas(path: string, key: string): Promise<boolean>;
  cacheClear(path: string): Promise<void>;

  showPreview(port: number, frameId?: string): Promise<void>;

  shellExec(command: string): void;

  exec(script: string, opts?: ExecOptions): Promise<ExecResult>;
}