import type { CronJobDefinition } from "@rebasepro/types";
/**
 * Typed authoring helper for a cron job file. Identity at runtime —
 * a plain default-exported {@link CronJobDefinition} works identically;
 * this adds type inference and autocomplete.
 *
 * @see {@link defineFunction} for the equivalent custom-functions helper.
 *
 * @example
 * ```ts
 * import { defineCron } from "@rebasepro/server-core";
 *
 * export default defineCron({
 *     name: "Nightly cleanup",
 *     schedule: "0 3 * * *",
 *     async handler({ client, log }) {
 *         const { data: expired } = await client.data.sessions.find({
 *             where: { expired: ["==", true] },
 *         });
 *         for (const session of expired) {
 *             await client.data.sessions.delete(session.id);
 *         }
 *         log(`Deleted ${expired.length} expired sessions`);
 *     },
 * });
 * ```
 */
export declare function defineCron(definition: CronJobDefinition): CronJobDefinition;