/**
 * Base class for factory route modules.
 *
 * Route modules build Mastra `apiRoutes` from injected dependencies instead of
 * reaching into host globals. The host server (e.g. `mastracode/web`) supplies
 * the auth seam and storage domain handles at construction time, so the routes
 * stay portable and testable with fakes.
 */
import type { ApiRoute } from '@mastra/core/server';
import type { Context } from 'hono';
/**
 * The auth surface factory routes need, implemented by the host server.
 *
 * Local (no-auth) deployments implement this with a stub where `enabled()`
 * returns `false` and `tenant()` returns `undefined` — routes then take their
 * single-user local paths.
 */
export interface RouteAuth {
    /** Whether an auth provider is active (tenant mode). */
    enabled(): boolean;
    /**
     * Resolve (and cache) the signed-in user for the request, if any. Must be
     * called before `tenant()` so the request context is populated.
     */
    ensureUser(c: Context): Promise<unknown>;
    /** Tenant identity for the request, when signed in. */
    tenant(c: Context): {
        orgId?: string;
        userId: string;
    } | undefined;
    /** Fail-closed check that the caller administers the given organization. */
    isOrganizationAdmin(c: Context, organizationId: string): Promise<boolean>;
}
/** Dependencies shared by every factory route module. */
export interface RouteDependencies {
    auth: RouteAuth;
}
/**
 * A route module: constructed once at boot with its dependencies, then asked
 * for the `ApiRoute[]` it serves.
 */
export declare abstract class Route<TDeps extends RouteDependencies = RouteDependencies> {
    protected readonly deps: TDeps;
    constructor(deps: TDeps);
    /** Build the Mastra `apiRoutes` served by this module. */
    abstract routes(): ApiRoute[];
}
//# sourceMappingURL=route.d.ts.map