@cloudhal/cli 0.0.0-stage → 0.1.0

package/dist/src/cloudflare/config.d.ts

@@ -0,0 +1,1082 @@
+import { type SearchDeployment } from "./search.js";
+export declare const COMPATIBILITY_DATE = "2026-10-01";
+/**
+ * The admin Worker's one cron trigger (RFC-0008 §8.2): the scheduler's minute tick. It replaces the
+ * hourly `17 * * * *` in the same slot; the hourly jobs run behind watermarks on it.
+ */
+export declare const MINUTE_CRON = "* * * * *";
+/** What drives the scheduler on Cloudflare: the cron trigger, or the Durable Object alarm. */
+export type SchedulerTicker = "cron" | "alarm";
+/**
+ * The Workers plan a tick is sized for (RFC-0008 §8.2, `CLOUDHAL_TICK_BUDGET`): `free` — 40
+ * statements and one release a tick — or `paid` — 900 statements and up to 50 releases.
+ */
+export type WorkersPlan = "free" | "paid";
+/** What the generated admin config needs for schedules (RFC-0008 §8.2, §11.6). */
+export interface SchedulesDeployment {
+    /** `false` writes `CLOUDHAL_AUTOMATIONS=off`: automations stop; releases and gates go on. */
+    readonly automations: boolean;
+    /** The tick budget (`CLOUDHAL_TICK_BUDGET`). */
+    readonly plan: WorkersPlan;
+}
+/** A deployment that says nothing: automations on, the Workers Free budget (the safe one). */
+export declare const DEFAULT_SCHEDULES_DEPLOYMENT: SchedulesDeployment;
+/** The scheduler's Durable Object (RFC-0008 §8.3): binding, class and its migration tag. */
+export declare const SCHEDULER_CLOCK_BINDING = "SCHEDULER_CLOCK";
+export declare const SCHEDULER_CLOCK_CLASS = "SchedulerClock";
+export declare const SCHEDULER_CLOCK_MIGRATION = "v1";
+/** Build rooms (RFC-0020 §6): one Durable Object per page for Studio's Build view. */
+export declare const BUILD_ROOMS_BINDING = "BUILD_ROOMS";
+export declare const BUILD_ROOMS_CLASS = "BuildRoom";
+export declare const BUILD_ROOMS_MIGRATION = "v2";
+/** What the generated configs need for reader comments (RFC-0007 §15.3–15.4). */
+export interface CommentsDeployment {
+    /** `cloudhal.json` `comments.available` (default true); `false` sets `CLOUDHAL_COMMENTS_AVAILABLE=false`. */
+    readonly available: boolean;
+    /** The submissions' Rate Limiting binding (`comments.rateLimit`, §6.5). */
+    readonly rateLimit?: {
+        readonly namespaceId: string;
+        readonly limit: number;
+    };
+}
+/** The comment submissions' Rate Limiting binding name (RFC-0007 §6.5). */
+export declare const COMMENTS_RATE_LIMIT_BINDING = "COMMENTS_RL";
+/** Submissions per client per 60 s per Cloudflare location, unless cloudhal.json says otherwise. */
+export declare const DEFAULT_COMMENTS_RATE_LIMIT = 10;
+/** What the generated configs need for site analytics (RFC-0006 §8, §11). */
+export interface AnalyticsDeployment {
+    /** `<deployment>_events` (`datasetName`). */
+    readonly dataset: string;
+    /** `CLOUDHAL_ANALYTICS_DEFAULTS`: cloudhal.json's per-site defaults. */
+    readonly defaults: Readonly<Record<string, unknown>>;
+    /** Uncached live queries per UTC day (admin Worker). */
+    readonly budget: number;
+    /** Extra hostnames the site answers on (custom domains), `CLOUDHAL_SITE_HOSTS`. */
+    readonly siteHosts?: readonly string[];
+    /** The Workers Rate Limiting binding for the beacon (`analytics.rateLimit`, §5.5). */
+    readonly rateLimit?: {
+        readonly namespaceId: string;
+        readonly limit: number;
+    };
+}
+/** The beacon's Rate Limiting binding name (RFC-0006 §5.5). */
+export declare const ANALYTICS_RATE_LIMIT_BINDING = "ANALYTICS_RL";
+/** Beacons per client per 60 s across isolates, unless cloudhal.json says otherwise. */
+export declare const DEFAULT_BEACON_RATE_LIMIT = 120;
+/**
+ * A `namespace_id` for the deployment's beacon limiter: a positive integer derived from the dataset
+ * name (FNV-1a, 9 digits, offset so it never collides with small hand-picked ids), stable across
+ * deploys and different between deployments of one account. cloudhal.json can pin another.
+ */
+export declare function rateLimitNamespaceId(dataset: string, kind?: "beacon" | "comments"): string;
+export interface DeploymentNames {
+    /** Base name, e.g. `newsroom` → Workers `newsroom-site` / `newsroom-admin`. */
+    readonly name: string;
+    readonly databaseName?: string;
+    readonly databaseId?: string;
+    readonly bucketName?: string;
+    /**
+     * RFC-0034 §4: the site Worker's name when it is not `<name>-site` — a site Worker attached to
+     * another installation (`<installation>-site-<slug>`), which shares that installation's D1, R2
+     * and dataset names through `name`.
+     */
+    readonly siteName?: string;
+    /** RFC-0029 §3: the AI Search instance and bucket both Workers bind; absent = FTS5 alone. */
+    readonly search?: SearchDeployment;
+}
+export declare function workerNames(n: DeploymentNames): {
+    site: string;
+    admin: string;
+    database: string;
+    bucket: string;
+    searchBucket?: string;
+};
+/** The site Worker's config, written to the project root (`wrangler.jsonc`) before `astro build`. */
+export declare function siteWorkerConfig(n: DeploymentNames & {
+    siteId: string;
+    /**
+     * RFC-0034 §4: the sites a multi-site Worker serves, chosen by hostname
+     * (`CLOUDHAL_SITE_IDS`); without it the Worker serves `siteId` on every host.
+     */
+    siteIds?: readonly string[];
+    domain?: string;
+    /** RFC-0034 §5: every other site's hostnames, one Custom Domain route each. */
+    domains?: readonly string[];
+    analytics?: AnalyticsDeployment;
+    comments?: CommentsDeployment;
+    /** Extra hostnames the site answers on (custom domains): analytics and comments check them. */
+    siteHosts?: readonly string[];
+    /** Logs sampling and opt-in traces (default: every log, no traces). */
+    observability?: ObservabilityDeployment;
+}): {
+    ai_search: {
+        binding: string;
+        instance_name: string;
+    }[];
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes: {
+        pattern: string;
+        custom_domain: boolean;
+    }[];
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    analytics_engine_datasets?: {
+        binding: string;
+        dataset: string;
+    }[];
+    ratelimits?: {
+        name: string;
+        namespace_id: string;
+        simple: {
+            limit: number;
+            period: number;
+        };
+    }[];
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    };
+    cache: {
+        enabled: boolean;
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search: {
+        binding: string;
+        instance_name: string;
+    }[];
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes?: never;
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    analytics_engine_datasets?: {
+        binding: string;
+        dataset: string;
+    }[];
+    ratelimits?: {
+        name: string;
+        namespace_id: string;
+        simple: {
+            limit: number;
+            period: number;
+        };
+    }[];
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    };
+    cache: {
+        enabled: boolean;
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search?: never;
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes: {
+        pattern: string;
+        custom_domain: boolean;
+    }[];
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    analytics_engine_datasets?: {
+        binding: string;
+        dataset: string;
+    }[];
+    ratelimits?: {
+        name: string;
+        namespace_id: string;
+        simple: {
+            limit: number;
+            period: number;
+        };
+    }[];
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    };
+    cache: {
+        enabled: boolean;
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search?: never;
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes?: never;
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    analytics_engine_datasets?: {
+        binding: string;
+        dataset: string;
+    }[];
+    ratelimits?: {
+        name: string;
+        namespace_id: string;
+        simple: {
+            limit: number;
+            period: number;
+        };
+    }[];
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_SITE_HOSTS?: string;
+    };
+    cache: {
+        enabled: boolean;
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+};
+/** What the generated configs need for Workers Logs and Traces (`cloudhal.json` `observability`). */
+export interface ObservabilityDeployment {
+    /** Share of requests whose logs are kept (1 = all). */
+    readonly logs: number;
+    /** Share of requests traced; `false` = no traces. */
+    readonly traces: number | false;
+}
+/** Every log, no traces: what a deployment that says nothing gets. */
+export declare const DEFAULT_OBSERVABILITY: ObservabilityDeployment;
+/**
+ * The `observability` block of both Workers (https://developers.cloudflare.com/workers/observability/
+ * logs/workers-logs/, …/traces/). Query strings are redacted from logs and traces: preview links
+ * carry their signed token there (`?cloudhal-preview=…`), and logs are readable by every account
+ * member with Workers access.
+ */
+export declare function observabilitySettings(o?: ObservabilityDeployment): {
+    enabled: boolean;
+    head_sampling_rate?: number;
+    redact_query_string: boolean;
+    traces?: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+    };
+};
+/** The admin Worker's Email Service binding (RFC-0011). */
+export declare const MAIL_BINDING = "EMAIL";
+/** What the generated admin config needs for email delivery (RFC-0011). */
+export interface MailDeployment {
+    readonly from: string;
+    readonly fromName?: string;
+}
+/** The admin Worker's config (API + auth + MCP + Studio assets). */
+export declare function adminWorkerConfig(n: DeploymentNames & {
+    studioDir: string;
+    main: string;
+    /** The site the site Worker serves (`CLOUDHAL_SITE_ID`). */
+    siteId?: string;
+    /** RFC-0034 §4: the sites a multi-site site Worker serves (`CLOUDHAL_SITE_IDS`). */
+    siteIds?: readonly string[];
+    /** RFC-0034 §4: site Workers attached to this installation, bound as `SITE_1`, `SITE_2`, … */
+    siteWorkers?: readonly {
+        readonly name: string;
+        readonly siteIds: readonly string[];
+    }[];
+    domain?: string;
+    analytics?: AnalyticsDeployment;
+    comments?: CommentsDeployment;
+    /** The scheduler's ticker (default `cron`; `alarm` when Cloudflare refused the trigger). */
+    scheduler?: SchedulerTicker;
+    /** The tick budget and the automations switch (default: `free`, automations on). */
+    schedules?: SchedulesDeployment;
+    /** Email delivery: a `send_email` binding locked to this one sender (RFC-0011). */
+    mail?: MailDeployment;
+    /** In-editor AI (RFC-0016): the Workers AI binding. */
+    ai?: boolean;
+    /** Browser Rendering for `render_page` (RFC-0021 §4; `cloudhal deploy` binds it by default). */
+    browser?: boolean;
+    /** Logs sampling and opt-in traces (default: every log, no traces). */
+    observability?: ObservabilityDeployment;
+    /** Smart Placement: run next to D1 rather than next to the person (default: off). */
+    placement?: "smart";
+}): {
+    ai_search: {
+        binding: string;
+        instance_name: string;
+    }[];
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes: {
+        pattern: string;
+        custom_domain: boolean;
+    }[];
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    services: {
+        binding: string;
+        service: string;
+    }[];
+    analytics?: {
+        binding: string;
+    };
+    send_email?: {
+        name: string;
+        allowed_sender_addresses: string[];
+    }[];
+    ai?: {
+        binding: string;
+    };
+    browser?: {
+        binding: string;
+    };
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    };
+    durable_objects: {
+        bindings: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations: {
+        tag: string;
+        new_sqlite_classes: string[];
+    }[];
+    triggers: {
+        crons: string[];
+    };
+    placement?: {
+        mode: string;
+    };
+    assets: {
+        directory: string;
+        binding: string;
+        not_found_handling: string;
+        run_worker_first: string[];
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search: {
+        binding: string;
+        instance_name: string;
+    }[];
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes?: never;
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    services: {
+        binding: string;
+        service: string;
+    }[];
+    analytics?: {
+        binding: string;
+    };
+    send_email?: {
+        name: string;
+        allowed_sender_addresses: string[];
+    }[];
+    ai?: {
+        binding: string;
+    };
+    browser?: {
+        binding: string;
+    };
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    };
+    durable_objects: {
+        bindings: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations: {
+        tag: string;
+        new_sqlite_classes: string[];
+    }[];
+    triggers: {
+        crons: string[];
+    };
+    placement?: {
+        mode: string;
+    };
+    assets: {
+        directory: string;
+        binding: string;
+        not_found_handling: string;
+        run_worker_first: string[];
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search?: never;
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes: {
+        pattern: string;
+        custom_domain: boolean;
+    }[];
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    services: {
+        binding: string;
+        service: string;
+    }[];
+    analytics?: {
+        binding: string;
+    };
+    send_email?: {
+        name: string;
+        allowed_sender_addresses: string[];
+    }[];
+    ai?: {
+        binding: string;
+    };
+    browser?: {
+        binding: string;
+    };
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    };
+    durable_objects: {
+        bindings: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations: {
+        tag: string;
+        new_sqlite_classes: string[];
+    }[];
+    triggers: {
+        crons: string[];
+    };
+    placement?: {
+        mode: string;
+    };
+    assets: {
+        directory: string;
+        binding: string;
+        not_found_handling: string;
+        run_worker_first: string[];
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+} | {
+    ai_search?: never;
+    d1_databases: {
+        binding: string;
+        database_name: string;
+        database_id?: string;
+    }[];
+    r2_buckets: {
+        binding: string;
+        bucket_name: string;
+    }[];
+    routes?: never;
+    $schema: string;
+    name: string;
+    main: string;
+    compatibility_date: string;
+    compatibility_flags: string[];
+    services: {
+        binding: string;
+        service: string;
+    }[];
+    analytics?: {
+        binding: string;
+    };
+    send_email?: {
+        name: string;
+        allowed_sender_addresses: string[];
+    }[];
+    ai?: {
+        binding: string;
+    };
+    browser?: {
+        binding: string;
+    };
+    vars: {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_IDS: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_SITE_ID: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER: string;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT: string;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    } | {
+        CLOUDHAL_SEARCH_PROVIDER?: never;
+        CLOUDHAL_SEARCH_MONTHLY_LIMIT?: never;
+        CLOUDHAL_SITE_ROUTES?: string;
+        CLOUDHAL_ANALYTICS_DATASET?: string;
+        CLOUDHAL_ANALYTICS_BUDGET?: string;
+        CLOUDHAL_ANALYTICS_DEFAULTS?: string;
+        CLOUDHAL_COMMENTS_AVAILABLE?: string;
+        CLOUDHAL_SCHEDULER: SchedulerTicker;
+        CLOUDHAL_TICK_BUDGET: WorkersPlan;
+        CLOUDHAL_AUTOMATIONS: string;
+        CLOUDHAL_MAIL_FROM?: string;
+        CLOUDHAL_MAIL_FROM_NAME?: string;
+    };
+    durable_objects: {
+        bindings: {
+            name: string;
+            class_name: string;
+        }[];
+    };
+    migrations: {
+        tag: string;
+        new_sqlite_classes: string[];
+    }[];
+    triggers: {
+        crons: string[];
+    };
+    placement?: {
+        mode: string;
+    };
+    assets: {
+        directory: string;
+        binding: string;
+        not_found_handling: string;
+        run_worker_first: string[];
+    };
+    observability: {
+        enabled: boolean;
+        head_sampling_rate?: number;
+        redact_query_string: boolean;
+        traces?: {
+            enabled: boolean;
+            head_sampling_rate?: number;
+        };
+    };
+};
+/** Writes a config as JSONC (plain JSON with a header comment). */
+export declare function writeWranglerConfig(file: string, config: object, header: string): Promise<void>;
+/**
+ * The vars of an existing generated config (`{}` when there is none): what the last deploy set,
+ * e.g. the legacy `CLOUDHAL_*_CRON=off` of a deployment without a cron slot (RFC-0008 §16).
+ */
+export declare function readExistingVars(file: string): Promise<Record<string, string>>;
+/** Reads ids wrangler wrote back into an existing config, so regenerating keeps them. */
+export declare function readExistingIds(file: string): Promise<{
+    databaseId?: string;
+}>;
+export declare const SITE_CONFIG_FILE = "wrangler.jsonc";
+export declare const siteConfigPath: (projectDir: string) => string;