import { MeshInstance } from 'meshql-core';
import { Hono } from 'hono';

/**
 * Hono routes for MeshQL HTTP endpoints.
 *
 * @module
 *
 * @example
 * ```ts
 * import { Hono } from "hono";
 * import { createMesh } from "meshql-core";
 * import { meshHonoRoutes } from "meshql-http/hono";
 *
 * const app = new Hono();
 * app.route("/", meshHonoRoutes(createMesh({ entities: {} })));
 * ```
 */

/** Options for {@link meshHonoRoutes}. */
interface MeshHonoOptions {
    basePath?: string;
    /** Max multipart upload size in bytes. Default 25 MiB. */
    maxUploadBytes?: number;
}
/** Create Hono routes that serve MeshQL endpoints. */
declare function meshHonoRoutes(mesh: MeshInstance, options?: MeshHonoOptions): Hono;

export { type MeshHonoOptions, meshHonoRoutes };