@scalix-world/sdk 1.5.0 → 1.6.0

package/dist/cjs/generated/types.gen.d.ts

@@ -49,6 +49,29 @@ export type AddPeerBody = {
 export type AiStat = {
     tokens_used: number;
 };
+/**
+ * Body of `POST /api/v1/anomalies` — the caller supplies the activity
+ * window; the endpoint classifies it (the old description claimed it
+ * "analyzes recent activity" on its own). Mirrors `anomaly::DatabaseMetrics`.
+ */
+export type AnomalyDetectionRequest = {
+    /**
+     * Observed queries per second.
+     */
+    query_rate: number;
+    /**
+     * Observed error rate (0.0–1.0).
+     */
+    error_rate: number;
+    /**
+     * Observed average response time in milliseconds.
+     */
+    avg_response_time_ms: number;
+    /**
+     * Observed open connection count.
+     */
+    connection_count: number;
+};
 export type AuditAction = 'data_access' | 'data_modify' | 'data_delete' | 'auth_login' | 'auth_fail' | 'config_change' | 'api_key_create' | 'api_key_revoke' | 'api_key_rotate' | 'member_add' | 'member_remove' | 'compliance_export' | 'compliance_erasure';
 export type AuditEntry = {
     id: string;
@@ -90,6 +113,58 @@ export type BandwidthStat = {
 export type BatchSqlRequest = {
     queries: Array<SqlRequest>;
 };
+/**
+ * A billing plan as the pricing page and console BillingPage render it.
+ */
+export type BillingPlan = {
+    /**
+     * Plan id ("free", "starter", "pro", …).
+     */
+    id: string;
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * URL slug.
+     */
+    slug: string;
+    /**
+     * Base monthly price, in cents (USD).
+     */
+    price_cents: number;
+    /**
+     * Annual-billing price, in cents (USD); null when the plan has no
+     * annual price.
+     */
+    annual_price_cents?: number | null;
+    /**
+     * Maximum team seats included.
+     */
+    max_team_seats: number;
+    /**
+     * Maximum projects included.
+     */
+    max_projects: number;
+    /**
+     * Support tier ("community", "standard", "priority").
+     */
+    support_tier: string;
+    /**
+     * SLA percentage.
+     */
+    sla_pct: number;
+    /**
+     * Feature list shown on the pricing page.
+     */
+    features: Array<string>;
+};
+/**
+ * The plan list response.
+ */
+export type BillingPlanList = {
+    plans: Array<BillingPlan>;
+};
 /**
  * Connection endpoint of the branch's compute worker.
  */
@@ -213,6 +288,16 @@ export type BuildCreateRequest = {
 export type BulkImportBody = {
     variables: Array<SetEnvBody>;
 };
+/**
+ * In-place plan change request.
+ */
+export type ChangePlanRequest = {
+    /**
+     * Target plan id. The console sends `price_id` — accepted as an
+     * alias.
+     */
+    new_plan: string;
+};
 /**
  * One completion choice: index, message, finish reason.
  */
@@ -298,10 +383,80 @@ export type ChatMessage = {
     role: string;
     content: string;
 };
+/**
+ * Hosted checkout request (upgrade / first paid plan).
+ */
+export type CheckoutRequest = {
+    /**
+     * Plan id to check out. The console sends `price_id` — accepted as
+     * an alias.
+     */
+    plan: string;
+    /**
+     * URL to return to after a successful payment.
+     */
+    success_url: string;
+    /**
+     * URL to return to when the customer cancels.
+     */
+    cancel_url: string;
+    /**
+     * Customer country code (tax calculation).
+     */
+    country_code?: string | null;
+    /**
+     * Tenant id; defaults to the caller's authenticated org.
+     */
+    tenant_id?: string | null;
+    /**
+     * Customer email for the provider customer record.
+     */
+    email?: string | null;
+    /**
+     * Billing interval: "month" (default) or "year"/"annual".
+     */
+    interval?: string | null;
+};
+/**
+ * A hosted checkout session.
+ */
+export type CheckoutSession = {
+    /**
+     * Provider session id.
+     */
+    session_id: string;
+    /**
+     * Hosted payment page URL.
+     */
+    url: string;
+    /**
+     * Payment provider that owns the session.
+     */
+    provider: string;
+    /**
+     * Razorpay only: the public key id the console needs to open
+     * Checkout.js as an in-page modal.
+     */
+    razorpay_key_id?: string | null;
+};
 export type ComplianceCheck = {
     name: string;
     passed: boolean;
     details: string;
+    /**
+     * How the pass was established — FAKE-05 (2026-10-31).
+     *
+     * "measured"  — derived from a live signal this endpoint can read
+     * (a configured key, an env flag, a real probe).
+     * "structural"— compiled in and always true; no runtime signal exists
+     * to verify it, so the pass is an assertion, not a check.
+     *
+     * Before this field existed, both kinds rendered as the same green tick,
+     * so a compliance score of 100% could not be distinguished from a set of
+     * unexamined literals. Additive and optional for consumers: existing
+     * readers ignore unknown fields.
+     */
+    basis: string;
 };
 export type ComplianceStatus = {
     checks: Array<ComplianceCheck>;
@@ -341,13 +496,21 @@ export type ComputerCreateRequest = {
      * Guest image. `ubuntu24` is the only image available today.
      */
     image?: string | null;
-    resources?: null | ComputerResources;
+    resources?: ComputerResources | null;
     /**
      * OpenSSH public keys authorised for `root`, one per array entry, max 32.
      * Optional — `exec` and the browser terminal work without one. Send the
      * public half only (the `.pub` file); a private key is rejected.
      */
     ssh_keys?: Array<string> | null;
+    /**
+     * Optional canonical region id (from `GET /v1/regions`) constraining host
+     * placement. The orchestrator's `CreateComputerSchema` accepts it on both
+     * the POST create and the by-name get-or-create; a Computer is host-bound
+     * for life, so the region only applies at first create. There is no
+     * `region_pinned` on this contract.
+     */
+    region?: string | null;
 };
 /**
  * Request body for running a command inside a Computer.
@@ -393,6 +556,11 @@ export type ComputerFileRead = {
  * One file to write into a Computer.
  */
 export type ComputerFileWrite = {
+    /**
+     * ABSOLUTE path inside the guest — relative paths are rejected with 400
+     * (an older guest build silently wrote them against the VM's CWD and
+     * reported success; audit 2026-10-21).
+     */
     path: string;
     /**
      * Base64-encoded contents.
@@ -525,6 +693,49 @@ export type CreateDatabaseResponse = {
      */
     pg_version: string;
 };
+/**
+ * Create a subscription. `config` is REQUIRED and its shape depends on
+ * `sub_type` (the contract previously said bare `object`). Mirrors
+ * `eventbus::api::CreateSubscriptionRequest`.
+ */
+export type CreateEventSubscriptionRequest = {
+    /**
+     * `webhook` or `function`.
+     */
+    sub_type: EventSubscriptionType;
+    /**
+     * webhook: `{"url": "<public https url>"}` required (SSRF-validated at
+     * create and re-pinned at delivery), optional `"secret"` → HMAC header
+     * `x-scalix-signature`, optional `"headers"` (string map).
+     * function: `{"function_id": "<id>"}` required.
+     */
+    config: {
+        [key: string]: unknown;
+    };
+    /**
+     * Optional event-payload filter.
+     */
+    filter?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Per-delivery retry budget.
+     */
+    max_retries?: number;
+};
+/**
+ * Create a topic. There is NO `display_name` field (the audit's 500 was a
+ * duplicate `name` — now a 409 ALREADY_EXISTS). Mirrors platform-services
+ * `eventbus::api::CreateTopicRequest`.
+ */
+export type CreateEventTopicRequest = {
+    /**
+     * Topic name — unique per project; also usable as the `{id}` selector on
+     * topic sub-paths.
+     */
+    name: string;
+    description?: string | null;
+};
 export type CreateGdprRequest = {
     subject_email: string;
     request_type: GdprRequestType;
@@ -543,6 +754,13 @@ export type CreateIntegrationBody = {
     auto_build?: boolean | null;
     auto_deploy?: boolean | null;
     service_id?: string | null;
+    /**
+     * Function deploy target: every later build PUTs the fresh image onto
+     * this function (drains its warm pool + re-warms the new revision).
+     * Mutually exclusive with `service_id` — one repo deploys one thing, and
+     * the tenant chooses which.
+     */
+    function_id?: string | null;
     preview_enabled?: boolean | null;
     preview_ttl_hours?: number | null;
 };
@@ -559,7 +777,7 @@ export type CreateLbRequest = {
     name: string;
     strategy?: Strategy;
     backends?: Array<AddBackendRequest>;
-    health_check?: null | HealthCheckConfig;
+    health_check?: HealthCheckConfig | null;
 };
 export type CreateRuleRequest = {
     name: string;
@@ -584,6 +802,59 @@ export type CreateVpcBody = {
      */
     cidr: string;
 };
+/**
+ * What a cron schedule executes.
+ */
+export type CronActionType = 'function' | 'webhook';
+/**
+ * Create a scheduled job. `action_type` + `action_config` are a PAIR — the
+ * config keys are validated per type (audit 2026-10-21: this body was a
+ * bare `object` in the contract and the shipped CLI posted the wrong key,
+ * so every CLI create 400'd). Mirrors platform-services
+ * `cron::api::CreateScheduleRequest`.
+ */
+export type CronScheduleCreateRequest = {
+    name: string;
+    description?: string | null;
+    /**
+     * Five-field cron expression (minute hour day month weekday). The key is
+     * `cron_expression` — NOT `expression`.
+     */
+    cron_expression: string;
+    /**
+     * IANA timezone for the schedule; defaults to UTC when omitted.
+     */
+    timezone?: string | null;
+    /**
+     * Only `function` and `webhook`.
+     */
+    action_type: CronActionType;
+    /**
+     * Per-type config. `function`: `{"function_id": "<id>"}` (required) — the
+     * function is invoked with the fixed payload `{"trigger":"cron",
+     * "project_id":…}`. `webhook`: `{"url": "<public https url>"}` (required,
+     * SSRF-validated at create and pinned per delivery) plus optional
+     * `"secret"` (HMAC header `x-scalix-signature: sha256=<hex>`) and
+     * `"headers"` (string map). Webhook deliveries are ALWAYS POST; a
+     * `method` key is ignored.
+     */
+    action_config: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Update a scheduled job. The action pair is immutable — delete and recreate
+ * to change what runs. Mirrors `cron::api::UpdateScheduleRequest`.
+ */
+export type CronScheduleUpdateRequest = {
+    name?: string | null;
+    description?: string | null;
+    cron_expression?: string | null;
+    /**
+     * Pause (false) / resume (true).
+     */
+    enabled?: boolean | null;
+};
 /**
  * Customer-defined user-agent rule. Takes precedence over the built-in
  * crawler database so customers can police bots we don't know about yet —
@@ -662,6 +933,27 @@ export type DatabaseJson = {
      */
     deleted_at?: string | null;
 };
+export type DatacenterEntry = {
+    name: string;
+    provider: string;
+    location?: string | null;
+    status: string;
+    /**
+     * REG-ARCH-02 (migration 050): ISO country, residency vocabularies this
+     * DC satisfies, provider aliases, and the regional ingress facts.
+     */
+    country_code?: string | null;
+    jurisdictions?: Array<string>;
+    aliases?: Array<string>;
+    ingress_ip?: string | null;
+    ingress_domain?: string | null;
+    /**
+     * REG-ARCH-02 follow-up (migration 052): the services this DC provides
+     * (`compute`, `database`, `storage`) — a compute edge omits the stateful
+     * ones; empty until the row is populated.
+     */
+    capabilities?: Array<string>;
+};
 export type DdosStats = {
     global_rps: number;
     tracked_ips: number;
@@ -852,6 +1144,10 @@ export type ErrorResponse = {
      */
     field?: string | null;
 };
+/**
+ * Delivery kind for an event subscription.
+ */
+export type EventSubscriptionType = 'webhook' | 'function';
 /**
  * Deploy a serverless function.
  */
@@ -879,6 +1175,36 @@ export type FunctionsStat = {
     invocations: number;
 };
 export type GdprRequestType = 'export' | 'erasure' | 'rectification' | 'access';
+/**
+ * A tenant-authored glitch rule creation request (doc-only mirror of the
+ * router's `CreateGlitchRuleBody`).
+ */
+export type GlitchRuleCreate = {
+    /**
+     * `ignore` (never a glitch for my app) or `track` (record under my label).
+     */
+    action: string;
+    /**
+     * Required for `track`: the tenant's own category name (becomes the group key, 1-64 chars).
+     */
+    label?: string | null;
+    /**
+     * Optional: the tenant's own remediation note shown with the group (max 280 chars).
+     */
+    hint?: string | null;
+    /**
+     * HTTP status codes this rule matches (100-599, 1-32 codes).
+     */
+    match_statuses: Array<number>;
+    /**
+     * Optional path prefix the rule is scoped to (must start with `/`, max 256 chars).
+     */
+    path_prefix?: string | null;
+    /**
+     * Optional exact host the rule is scoped to (bare hostname, max 253 chars).
+     */
+    host?: string | null;
+};
 export type HealthCheckConfig = {
     interval_secs: number;
     timeout_secs: number;
@@ -911,6 +1237,7 @@ export type IntegrationJson = {
     auto_deploy: boolean;
     status: string;
     service_id?: string | null;
+    function_id?: string | null;
     preview_enabled: boolean;
     preview_ttl_hours: number;
     created_at: string;
@@ -1097,6 +1424,23 @@ export type MeResponse = {
     tools: Array<string>;
     limits: MeLimits;
 };
+export type NodeSummary = {
+    active: number;
+    cpu_cores: number;
+    memory_gb: number;
+};
+/**
+ * Body of `POST /api/v1/optimize` — the advisory analyzes the GIVEN
+ * statement (the old description claimed it "analyzes the tenant's
+ * database"; `sql` is required and unknown fields are rejected). Mirrors
+ * server.rs `OptimizeBody`.
+ */
+export type OptimizeQueryRequest = {
+    /**
+     * The SQL statement to analyze for index/rewrite advice.
+     */
+    sql: string;
+};
 /**
  * Response for `POST /v1/domains/{id}/ssl`.
  */
@@ -1112,6 +1456,38 @@ export type RecordConsentRequest = {
     consent_type: string;
     granted: boolean;
 };
+export type RegionCatalog = {
+    regions: Array<RegionEntry>;
+};
+export type RegionEntry = {
+    /**
+     * Canonical region id (`eu-central-1`) — the value orgs/projects store
+     * and placement matches on.
+     */
+    region: string;
+    /**
+     * Derived: `active` (has active DCs AND active nodes), `coming-soon`
+     * (registered DCs, no active nodes yet), `maintenance` (no active DC).
+     */
+    status: string;
+    datacenters: Array<DatacenterEntry>;
+    nodes: NodeSummary;
+    /**
+     * REG-ARCH-02: registry-sourced metadata rollups (distinct, sorted,
+     * from the region's datacenter rows — never fabricated in code).
+     * Empty until the DC rows carry the columns (migration 050).
+     */
+    country_codes?: Array<string>;
+    jurisdictions?: Array<string>;
+    ingress_domains?: Array<string>;
+    /**
+     * Union of the region's datacenter `capabilities` (migration 052):
+     * `compute`, `database`, `storage`. Registry facts only — empty (omitted)
+     * until the DC rows carry the column's values, so UIs fall back to
+     * neutral copy instead of inventing a tier.
+     */
+    capabilities?: Array<string>;
+};
 export type RequestStatus = 'pending' | 'in_progress' | 'completed' | 'rejected';
 /**
  * A Scalix Run service to deploy.
@@ -1383,6 +1759,24 @@ export type SignUpRequest = {
     } | null;
     captcha_token?: string | null;
 };
+/**
+ * Spending cap configuration.
+ */
+export type SpendingCapRequest = {
+    /**
+     * Monthly spend cap, in cents.
+     */
+    monthly_cap_cents: number;
+    /**
+     * Alert threshold as a percentage of the cap (e.g. 80 = alert at
+     * 80%).
+     */
+    alert_threshold_pct?: number | null;
+    /**
+     * Hard-limit the org when the cap is reached (vs alert only).
+     */
+    hard_limit?: boolean | null;
+};
 /**
  * One column of a SQL result set.
  */
@@ -1435,6 +1829,13 @@ export type SqlRequest = {
     params?: {
         [key: string]: unknown;
     } | null;
+    /**
+     * Branch timeline to run the query against, as returned by
+     * `scalix_db_branch_create` (optionally in its `db_<timeline>` connection-string
+     * form). Omit for the project's primary. A timeline that is not a branch of
+     * this project is rejected — it never falls back to the primary (F17).
+     */
+    timeline_id?: string | null;
 };
 /**
  * Result set returned by a SQL query. Matches the wire shape produced by
@@ -1491,6 +1892,47 @@ export type StorageStat = {
     gb_used: number;
 };
 export type Strategy = 'round_robin' | 'least_connections' | 'weighted_round_robin' | 'ip_hash';
+/**
+ * Tax-info update (GST/VAT registration details).
+ */
+export type TaxInfoRequest = {
+    /**
+     * Tax type ("gst", "vat", …).
+     */
+    tax_type: string;
+    /**
+     * Tax identification number.
+     */
+    tax_id: string;
+    /**
+     * ISO country code.
+     */
+    country_code: string;
+    /**
+     * Registered business name.
+     */
+    business_name?: string | null;
+    /**
+     * State/province code.
+     */
+    state_code?: string | null;
+    /**
+     * VAT number (EU).
+     */
+    vat_id?: string | null;
+    /**
+     * Reverse-charge applies (B2B intra-EU).
+     */
+    reverse_charge?: boolean;
+    /**
+     * Export LUT applies (India exports).
+     */
+    export_lut?: boolean;
+    /**
+     * The org is tax-exempt.
+     */
+    exempt?: boolean;
+};
 /**
  * A short-lived GitHub installation access token.
  */
@@ -1512,6 +1954,17 @@ export type UpdateIntegrationBody = {
     auto_build?: boolean | null;
     auto_deploy?: boolean | null;
     service_id?: string | null;
+    /**
+     * Tri-state like the functions crate's `cron_expression`: absent = keep
+     * the current link, null = clear it (the console's "None" option), and a
+     * string = set it. A plain Option cannot tell "clear" from "not sent",
+     * which made an un-picked function target impossible to remove.
+     * serde's derive alone is not enough: with a plain
+     * `Option<Option<String>>`, JSON `null` also deserializes to `None`
+     * (reads as "absent"), so the custom deserializer below lifts a present
+     * field — null included — into the outer Some.
+     */
+    function_id?: string | null;
     preview_enabled?: boolean | null;
     preview_ttl_hours?: number | null;
     status?: string | null;
@@ -1555,12 +2008,13 @@ export type UserInfo = {
     last_login_at?: string | null;
 };
 /**
- * A single vector entry for upsert.
+ * One entry inside a `VectorUpsertRequest` batch — no `collection` (the
+ * wrapper carries it) and `metadata` optional on this path.
  */
-export type VectorEntry = {
+export type VectorBatchEntry = {
     id: string;
     /**
-     * The embedding values.
+     * Embedding values — length must equal the collection's dimensions.
      */
     embedding: Array<number>;
     metadata?: {
@@ -1568,18 +2022,71 @@ export type VectorEntry = {
     } | null;
 };
 /**
- * A nearest-neighbour vector search.
+ * Create a vector collection — the real body (previously undocumented).
+ * Mirrors `vector::CreateCollectionRequest`.
+ */
+export type VectorCollectionCreateRequest = {
+    /**
+     * Collection name — unique per tenant.
+     */
+    name: string;
+    /**
+     * Embedding dimensionality; every entry must match exactly.
+     */
+    dimensions: number;
+    /**
+     * Similarity metric.
+     */
+    distance_metric: VectorDistanceMetric;
+};
+/**
+ * Distance metric for a collection (lowercase on the wire; `dot` also
+ * accepts the `inner_product` spelling). Mirrors `vector::DistanceMetric`.
+ */
+export type VectorDistanceMetric = 'cosine' | 'euclidean' | 'dot';
+/**
+ * ONE vector entry — the flat body of `POST /vectors/upsert` (all four
+ * fields required, unknown fields rejected). Mirrors `crate::vector::
+ * VectorEntry`, the enforcing struct. The `{collection, entries[]}` wrapper
+ * is `VectorUpsertRequest`, which ONLY `/vectors/batch/upsert` accepts — the
+ * audit's documented-body-422 came from this exact mix-up.
+ */
+export type VectorEntry = {
+    /**
+     * Stable entry id within the collection.
+     */
+    id: string;
+    /**
+     * Collection name — collections are keyed by NAME (there is no
+     * collection_id anywhere in the API).
+     */
+    collection: string;
+    /**
+     * Embedding values — length must equal the collection's dimensions.
+     */
+    embedding: Array<number>;
+    /**
+     * Metadata stored alongside the vector. Required — send `{}` for none.
+     */
+    metadata: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * A nearest-neighbour vector search. Mirrors `vector::VectorSearchRequest`
+ * (unknown fields rejected).
  */
 export type VectorSearchRequest = {
     collection: string;
     /**
-     * The query embedding.
+     * The query embedding — length must equal the collection's dimensions.
      */
     query_vector: Array<number>;
     /**
-     * Number of nearest neighbours to return.
+     * Number of nearest neighbours to return. REQUIRED — there is no server
+     * default (the contract previously marked it optional; omitting it 422s).
      */
-    top_k?: number | null;
+    top_k: number;
     /**
      * Optional metadata filter.
      */
@@ -1588,11 +2095,12 @@ export type VectorSearchRequest = {
     } | null;
 };
 /**
- * Upsert a batch of vectors into a collection.
+ * Batch upsert body — `POST /vectors/batch/upsert` ONLY (one multi-row
+ * write; returns the upserted count with 201).
  */
 export type VectorUpsertRequest = {
     collection: string;
-    entries: Array<VectorEntry>;
+    entries: Array<VectorBatchEntry>;
 };
 /**
  * Response for `POST /v1/domains/{id}/verify`.
@@ -1722,12 +2230,66 @@ export type WafStatsResponse = {
     ddos: DdosStats;
 };
 /**
- * Register a webhook endpoint for a set of event types.
+ * Register a webhook endpoint (POST). Unknown fields are rejected; `active`
+ * is PUT-only. `secret` is optional — auto-generated (32-byte hex) when
+ * omitted and returned ONCE in the 201 body. Deliveries carry
+ * `X-Webhook-Signature` (hex HMAC-SHA256 of the raw body) and
+ * `X-Webhook-Event`; the endpoint auto-disables after 10 consecutive
+ * delivery failures.
  */
-export type WebhookRequest = {
+export type WebhookCreateRequest = {
+    /**
+     * Public http/https delivery URL (SSRF-guarded at registration and at
+     * every delivery).
+     */
     url: string;
-    events: Array<string>;
+    /**
+     * Event types to deliver — case-sensitive PascalCase.
+     */
+    events: Array<WebhookEventName>;
+    /**
+     * Optional HMAC signing secret; auto-generated and shown once if omitted.
+     */
+    secret?: string | null;
+};
+/**
+ * The webhook `events` element — case-sensitive wire names accepted by
+ * `CreateWebhookRequest` (the audit found this enum existed nowhere in the
+ * contract while the error sanitizer withheld serde's variant list).
+ */
+export type WebhookEventName = 'Insert' | 'Update' | 'Delete' | 'SchemaChange' | 'TokenCreated' | 'TokenRevoked' | 'SandboxCreated' | 'SandboxDestroyed' | 'ApiKeyExpiringSoon' | 'ApprovalRequired' | 'ApprovalGranted' | 'ApprovalRejected';
+/**
+ * Fire a test delivery at a registered webhook (POST `.../webhooks/{id}/test`).
+ * BOTH fields are required and unknown fields are rejected — mirrors the
+ * gateway's runtime `TestWebhookBody` (`deny_unknown_fields`). The re-audit
+ * 2026-10-23 got 415 on every guessed body because this operation published
+ * no requestBody at all. The response reports how many webhooks were
+ * triggered (`{"triggered_webhooks": n}`); delivery outcome lands in the
+ * webhook's deliveries list, not in this response.
+ */
+export type WebhookTestRequest = {
+    /**
+     * Event to deliver — same case-sensitive enum as registration `events`.
+     */
+    event: WebhookEventName;
+    /**
+     * JSON body delivered to the endpoint as the event payload.
+     */
+    payload: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Update a registered webhook (PUT). Every field is optional — supplied
+ * fields replace; this is the only surface that accepts `active`.
+ */
+export type WebhookUpdateRequest = {
+    url?: string | null;
+    events?: Array<WebhookEventName> | null;
     secret?: string | null;
+    /**
+     * Pause (false) / resume (true) deliveries.
+     */
     active?: boolean | null;
 };
 export type GenerateSpeechData = {
@@ -3218,17 +3780,16 @@ export type ListCronSchedulesResponses = {
     200: unknown;
 };
 export type CreateCronScheduleData = {
-    /**
-     * Create-schedule request
-     */
-    body: {
-        [key: string]: unknown;
-    };
+    body: CronScheduleCreateRequest;
     path?: never;
     query?: never;
     url: '/v1/cron/schedules';
 };
 export type CreateCronScheduleErrors = {
+    /**
+     * Invalid body (e.g. `expression` instead of `cron_expression`, or action_type outside function/webhook)
+     */
+    400: ErrorResponse;
     /**
      * Missing or invalid API key
      */
@@ -3302,12 +3863,7 @@ export type GetCronScheduleResponses = {
     200: unknown;
 };
 export type UpdateCronScheduleData = {
-    /**
-     * Update-schedule request
-     */
-    body: {
-        [key: string]: unknown;
-    };
+    body: CronScheduleUpdateRequest;
     path: {
         /**
          * Schedule id
@@ -3490,9 +4046,9 @@ export type DeleteDatabaseErrors = {
 export type DeleteDatabaseError = DeleteDatabaseErrors[keyof DeleteDatabaseErrors];
 export type DeleteDatabaseResponses = {
     /**
-     * Database scheduled for deletion
+     * Database scheduled for deletion (async teardown; the row enters its recovery grace window)
      */
-    200: unknown;
+    202: unknown;
 };
 export type GetDatabaseData = {
     body?: never;
@@ -3859,7 +4415,7 @@ export type ListEventTopicsResponses = {
     200: unknown;
 };
 export type CreateEventTopicData = {
-    body?: never;
+    body: CreateEventTopicRequest;
     path?: never;
     query?: never;
     url: '/v1/events/topics';
@@ -3869,6 +4425,10 @@ export type CreateEventTopicErrors = {
      * Missing or invalid API key
      */
     401: ErrorResponse;
+    /**
+     * A topic with this name already exists in the project (ALREADY_EXISTS)
+     */
+    409: ErrorResponse;
     /**
      * Internal error
      */
@@ -4027,12 +4587,7 @@ export type ListTopicSubscriptionsResponses = {
     200: unknown;
 };
 export type CreateEventSubscriptionData = {
-    /**
-     * Subscription request
-     */
-    body: {
-        [key: string]: unknown;
-    };
+    body: CreateEventSubscriptionRequest;
     path: {
         /**
          * Topic id or name
@@ -4393,6 +4948,26 @@ export type KvSetResponses = {
      */
     200: unknown;
 };
+export type ListRegionsData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/regions';
+};
+export type ListRegionsErrors = {
+    /**
+     * Internal error
+     */
+    500: ErrorResponse;
+};
+export type ListRegionsError = ListRegionsErrors[keyof ListRegionsErrors];
+export type ListRegionsResponses = {
+    /**
+     * The live region catalog
+     */
+    200: RegionCatalog;
+};
+export type ListRegionsResponse = ListRegionsResponses[keyof ListRegionsResponses];
 export type SandboxListData = {
     body?: never;
     path?: never;
@@ -4884,7 +5459,7 @@ export type GetKeysUsageErrors = {
 export type GetKeysUsageError = GetKeysUsageErrors[keyof GetKeysUsageErrors];
 export type GetKeysUsageResponses = {
     /**
-     * Per-API-key request counts for the current month
+     * The organization's API keys with IAM-tracked metadata (id, name, prefix, last_used_at). Per-key request counts are NOT tracked — metering is keyed by org/project; see /v1/usage/{id} for usage totals.
      */
     200: KeysUsageResponse;
 };