/// <reference path="./global.d.ts" />
//#region src/http.d.ts
interface ArkstackMiddlewareConfig<TMiddleware> {
  global: TMiddleware[];
  before: TMiddleware[];
  after: TMiddleware[];
}
//#endregion
//#region src/kits.d.ts
/**
 * The ArkstackKitDriver class defines the contract for a driver
 * that can be used with the ArkstackKitContract.
 */
declare abstract class ArkstackKitDriver<TApp, TMiddleware> {
  abstract readonly name: string;
  abstract createApp(): TApp;
  abstract mountPublicAssets(app: TApp, publicPath: string): PromiseOrValue<void>;
  abstract bindRouter(app: TApp): PromiseOrValue<void>;
  abstract applyMiddleware(app: TApp, middleware: ArkstackMiddlewareConfig<TMiddleware>): PromiseOrValue<void>;
  abstract applyMiddleware(app: TApp, middleware: TMiddleware): PromiseOrValue<void>;
  registerErrorHandler(_app: TApp): PromiseOrValue<void>;
  abstract start(app: TApp, port: number): PromiseOrValue<void>;
}
/**
 * The ArkstackKitContract class defines the contract for an
 * application that uses the ArkstackKitDriver.
 */
declare abstract class ArkstackKitContract<TApp, TMiddleware> {
  abstract app: TApp;
  abstract driver: ArkstackKitDriver<TApp, TMiddleware>;
  abstract middleware: ArkstackMiddlewareConfig<TMiddleware>;
  abstract boot(port: number): Promise<void>;
  abstract shutdown(): Promise<void>;
}
//#endregion
//#region src/routing.d.ts
interface ArkstackRouteListOptions {
  path?: string;
}
interface ArkstackRouterContract<TApp, TRoutes = unknown> {
  bind(app: TApp): PromiseOrValue<unknown>;
  list(options?: ArkstackRouteListOptions, app?: TApp): PromiseOrValue<TRoutes>;
}
//#endregion
//#region src/Arkstack.d.ts
type PromiseOrValue<T> = T | Promise<T>;
type ENV = 'development' | 'production' | 'stagging' | 'testing';
type RootDirChangeListener = (dir: string, previousDir: string) => void;
declare abstract class Arkstack<TApp, TRoutes = unknown, THandler = unknown> {
  static app: unknown;
  private static appRootDir;
  protected app: TApp;
  protected driver: ArkstackKitDriver<TApp, THandler>;
  abstract getRouter(): ArkstackRouterContract<TApp, TRoutes>;
  /**
   * Boots the application by mounting public assets, binding the
   * router, applying middleware, and starting the server.
   *
   * @param port      The numeric port to run the server on
   * @param defer     Set to true to skip server startup
   */
  abstract boot(port: number, defer?: boolean): Promise<void>;
  /**
   * Gets the driver application instance.
   *
   * @returns
   */
  getAppInstance(): TApp;
  /**
   * Gets the static driver application instance.
   *
   * @returns
   */
  static getAppInstance<TApp = unknown>(): TApp;
  /**
   * Gets the ArkstackKitDriver instance used by the application.
   *
   * @returns
   */
  getDriver(): ArkstackKitDriver<TApp, THandler>;
  /**
   * Boostrap the app and start up the server
   *
   * @param defaultPort   start the server with this port if neither PORT nor APP_PORT env variable is set
   * @param defer         Set to true to skip server startup
   */
  startup(defaultPort?: number, defer?: boolean): Promise<void>;
  /**
   * Shuts down the application by disconnecting from the database and exiting the process.
   */
  shutdown(): Promise<void>;
  /**
   * Get the current app root directory
   *
   * @alias getRootDir()
   * @returns
   */
  static rootDir(): string;
  /**
   * Get the current app root directory
   *
   * @alias getRootDir()
   * @returns
   */
  rootDir(): string;
  /**
   * Get the current app root directory
   *
   * @returns
   */
  static getRootDir(): string;
  /**
   * Set the current app root directory
   *
   * @param dir   The prefered app root directory
   * @returns
   */
  setRootDir(dir: string): void;
  /**
   * Set the current app root directory
   *
   * @param dir   The prefered app root directory
   * @returns
   */
  static setRootDir(dir: string): void;
}
//#endregion
export { Arkstack, ArkstackKitContract, ArkstackKitDriver, ArkstackMiddlewareConfig, ArkstackRouteListOptions, ArkstackRouterContract, ENV, PromiseOrValue, RootDirChangeListener };