astroidjs 0.12.1 → 0.14.0

package/dist/queues/messages.d.ts

@@ -14,7 +14,7 @@ export declare const ASTROID_DEFAULT_CRON = "0 * * * *";
 export declare function astroidCron(config: AstroidConfig): string | null;
 /**
  * Daily, at an off-peak-ish minute. The health scan crawls the site's own pages,
- * so it is deliberately NOT on the hourly catalog cron — hourly would be a
+ * so it is deliberately NOT on the hourly catalog cron—hourly would be a
  * self-inflicted crawl 24× a day to recompute counts that move slowly.
  */
 export declare const ASTROID_HEALTH_CRON = "17 4 * * *";
@@ -31,7 +31,7 @@ export declare const ASTROID_HEALTH_CRON = "17 4 * * *";
 export declare function astroidCrons(config: AstroidConfig): string[];
 /** Binding name for the project's queue producer. */
 export declare const ASTROID_QUEUE_BINDING = "COMMERCE_QUEUE";
-/** Queue names derived from the project key — the main queue and its DLQ. */
+/** Queue names derived from the project key—the main queue and its DLQ. */
 export declare function astroidQueueNames(config: AstroidConfig): {
     queue: string;
     dlq: string;
@@ -44,9 +44,9 @@ export declare function astroidQueueNames(config: AstroidConfig): {
  */
 export interface WebhookMessage {
     kind: "webhook";
-    /** Which integration sent it — `"square"`, `"stripe"`, `"fourthwall"`. */
+    /** Which integration sent it—`"square"`, `"stripe"`, `"fourthwall"`. */
     provider: string;
-    /** The provider's event type, e.g. `"catalog.version.updated"`. */
+    /** The provider's event type, for example, `"catalog.version.updated"`. */
     type: string;
     payload: unknown;
 }

package/dist/queues/messages.js

@@ -25,7 +25,7 @@ export function astroidCron(config) {
 }
 /**
  * Daily, at an off-peak-ish minute. The health scan crawls the site's own pages,
- * so it is deliberately NOT on the hourly catalog cron — hourly would be a
+ * so it is deliberately NOT on the hourly catalog cron—hourly would be a
  * self-inflicted crawl 24× a day to recompute counts that move slowly.
  */
 export const ASTROID_HEALTH_CRON = "17 4 * * *";
@@ -52,7 +52,7 @@ export function astroidCrons(config) {
 }
 /** Binding name for the project's queue producer. */
 export const ASTROID_QUEUE_BINDING = "COMMERCE_QUEUE";
-/** Queue names derived from the project key — the main queue and its DLQ. */
+/** Queue names derived from the project key—the main queue and its DLQ. */
 export function astroidQueueNames(config) {
     return { queue: `${config.key}-commerce`, dlq: `${config.key}-commerce-dlq` };
 }

package/dist/queues/scaffold.d.ts

@@ -11,7 +11,7 @@ import type { AstroidConfig, CommerceProvider } from "../config.js";
  */
 export declare function generateAstroidEnvBindings(config: AstroidConfig): string;
 /**
- * `src/queue.ts` — the consumer seam the generated worker imports.
+ * `src/queue.ts`—the consumer seam the generated worker imports.
  *
  * `astroidQueueHandler` already owns the dispatch every site wrote (periodic
  * refresh, catalog-affecting webhook, no-op for everything else); what's left
@@ -20,14 +20,14 @@ export declare function generateAstroidEnvBindings(config: AstroidConfig): strin
  */
 export declare function generateAstroidQueueSeam(config: AstroidConfig): string;
 /**
- * The provider webhook receiver — `src/pages/api/webhooks/<provider>.ts`.
+ * The provider webhook receiver—`src/pages/api/webhooks/<provider>.ts`.
  *
  * Thin on purpose: `handleWebhook` owns the ordering (verify the raw body before
  * parsing) and the status-code contract (which codes ask the provider to retry
  * and which tell it to stop). What's here is the provider's own header and
  * verifier, plus the secret read.
  *
- * Returns null when the project has no commerce provider — nothing to receive.
+ * Returns null when the project has no commerce provider—nothing to receive.
  */
 export declare function generateAstroidWebhookRoute(config: AstroidConfig, forProvider?: CommerceProvider): string | null;
 /**
@@ -35,7 +35,7 @@ export declare function generateAstroidWebhookRoute(config: AstroidConfig, forPr
  *
  * Plural because roles are: a site running Stripe for invoicing beside
  * Fourthwall for the storefront receives from both, each with its own signing
- * secret and header. One route per provider, not per role — a provider filling
+ * secret and header. One route per provider, not per role—a provider filling
  * two roles still has one endpoint and one secret.
  */
 export declare function generateAstroidWebhookRoutes(config: AstroidConfig): {

package/dist/queues/scaffold.js

@@ -3,7 +3,7 @@
 // The two SCAFFOLD-ONCE files the queue pipeline needs: the consumer seam
 // (`src/queue.ts`) and the provider webhook receiver.
 //
-// Deliberately not part of the regenerated trio. Both exist to be edited — the
+// Deliberately not part of the regenerated trio. Both exist to be edited—the
 // consumer is where a project says what a catalog refresh actually does, and the
 // webhook route is where it narrows which events it cares about. Regenerating
 // over them would erase exactly the work they're for. The same boundary
@@ -15,7 +15,7 @@ import { ASTROID_QUEUE_BINDING } from "./messages.js";
 /**
  * Per-provider webhook facts: the header, the verifier, and how it's called.
  *
- * The signing-secret NAME is deliberately not here — it's one field of a
+ * The signing-secret NAME is deliberately not here—it's one field of a
  * provider's secret set, which `commerce/secrets.ts` owns so the wrangler
  * generator, the status report, and this scaffold all read the same list.
  */
@@ -36,7 +36,7 @@ const PROVIDERS = {
         // Stripe's header carries a timestamp; the verifier rejects replays outside
         // its tolerance, so it needs the current time.
         call: 'verifyStripeSignature(raw, headers.get(HEADER) ?? "", secret, Math.floor(Date.now() / 1000))',
-        note: "Stripe's signature is timestamped — the verifier rejects replays outside a 5-minute tolerance.",
+        note: "Stripe's signature is timestamped—the verifier rejects replays outside a 5-minute tolerance.",
     },
     fourthwall: {
         module: "louise-toolkit/commerce/fourthwall",
@@ -61,12 +61,12 @@ export function generateAstroidEnvBindings(config) {
     if (providers.length === 0)
         return "";
     return [
-        "  /** Queue producer — verified webhooks + the cron re-sync (src/queue.ts). */",
+        "  /** Queue producer—verified webhooks + the cron re-sync (src/queue.ts). */",
         '  COMMERCE_QUEUE: Queue<import("astroidjs").AstroidQueueMessage>;',
         // One secret SET per provider: a site running Stripe for invoicing and
         // Fourthwall for the storefront talks to both, credentialed and signed
         // independently. Every one is optional, because every one is allowed to be
-        // absent — that's what leaves the module dormant rather than broken.
+        // absent—that's what leaves the module dormant rather than broken.
         ...providers.flatMap((provider) => [
             `  /** ${provider} API credentials. Absent or still holding the`,
             "   *  DUMMY_REPLACE_ME sentinel reads as unconfigured, which leaves commerce",
@@ -80,7 +80,7 @@ export function generateAstroidEnvBindings(config) {
     ].join("\n");
 }
 /**
- * `src/queue.ts` — the consumer seam the generated worker imports.
+ * `src/queue.ts`—the consumer seam the generated worker imports.
  *
  * `astroidQueueHandler` already owns the dispatch every site wrote (periodic
  * refresh, catalog-affecting webhook, no-op for everything else); what's left
@@ -88,7 +88,7 @@ export function generateAstroidEnvBindings(config) {
  * a generated constant.
  */
 export function generateAstroidQueueSeam(config) {
-    // The STOREFRONT provider — it's the one with a catalog to re-sync. An
+    // The STOREFRONT provider—it's the one with a catalog to re-sync. An
     // invoicing-only provider has nothing for this hook to do.
     const provider = astroidCommerceRoles(config.commerce).storefront;
     const table = astroidCatalogMirror(config).table;
@@ -97,15 +97,15 @@ export function generateAstroidQueueSeam(config) {
     // in rather than leaving it to be discovered on a busy day (#294).
     const multiProvider = astroidCommerceProviders(config.commerce).length > 1;
     return [
-        "// The queue consumer — what each message actually does.",
+        "// The queue consumer—what each message actually does.",
         "//",
         "// Scaffolded once; yours to edit. `astroidQueueHandler` owns the dispatch",
         "// (a periodic refresh and any catalog-affecting webhook trigger a re-sync;",
         "// everything else acks as a no-op), so what's left here is what a refresh",
         "// MEANS for this project.",
         "//",
-        "// Throwing marks the message for retry. That's usually right — a failed",
-        "// refresh means the site is serving stale data — and Cloudflare routes it to",
+        "// Throwing marks the message for retry. That's usually right—a failed",
+        "// refresh means the site is serving stale data—and Cloudflare routes it to",
         "// the DLQ once it exceeds max_retries (wrangler.jsonc).",
         'import { astroidQueueHandler, type AstroidQueueMessage } from "astroidjs";',
         "",
@@ -118,7 +118,7 @@ export function generateAstroidQueueSeam(config) {
             ? [
                 `    // This project runs more than one commerce provider, and the catalog is`,
                 `    // ${provider}'s. Scoping the refresh keeps the OTHER provider's webhooks from`,
-                `    // triggering it — Square alone emits an inventory event on every sale, which`,
+                `    // triggering it—Square alone emits an inventory event on every sale, which`,
                 `    // unscoped would re-sync ${provider} once per transaction.`,
                 `    catalogProvider: ${JSON.stringify(provider)},`,
             ]
@@ -143,7 +143,7 @@ export function generateAstroidQueueSeam(config) {
                 "      // takes `retry: { attempts: 3 }`, backing off on 429/5xx inside every",
                 "      // verb. It is off by default because a checkout route has a customer",
                 "      // watching a spinner, and there a fast failure beats a slow one. Here",
-                "      // the opposite holds — a catalog push that gives up halfway is worse.",
+                "      // the opposite holds—a catalog push that gives up halfway is worse.",
             ]
             : [
                 "      // Nobody is watching this run, so ask for backoff on 429/5xx wherever",
@@ -158,7 +158,7 @@ export function generateAstroidQueueSeam(config) {
         "      // letting that escape is correct: an uncaught throw here marks the",
         "      // message for retry. Swallow it and the queue acks, the cron acks too,",
         "      // and the site serves a frozen catalog with nothing in `wrangler tail`.",
-        "      // Partial failures don't throw — that's what `r.failed` above is for.",
+        "      // Partial failures don't throw—that's what `r.failed` above is for.",
         "      void env;",
         "    },",
         "  })(message);",
@@ -169,14 +169,14 @@ export function generateAstroidQueueSeam(config) {
         .join("\n");
 }
 /**
- * The provider webhook receiver — `src/pages/api/webhooks/<provider>.ts`.
+ * The provider webhook receiver—`src/pages/api/webhooks/<provider>.ts`.
  *
  * Thin on purpose: `handleWebhook` owns the ordering (verify the raw body before
  * parsing) and the status-code contract (which codes ask the provider to retry
  * and which tell it to stop). What's here is the provider's own header and
  * verifier, plus the secret read.
  *
- * Returns null when the project has no commerce provider — nothing to receive.
+ * Returns null when the project has no commerce provider—nothing to receive.
  */
 export function generateAstroidWebhookRoute(config, forProvider) {
     const provider = forProvider ?? astroidCommerceProviders(config.commerce)[0];
@@ -194,7 +194,7 @@ export function generateAstroidWebhookRoute(config, forProvider) {
         `// ${p.note}`,
         "//",
         "// Unprovisioned (the secret is absent or still the placeholder) answers 503,",
-        "// which keeps the provider retrying — so events delivered before you set the",
+        "// which keeps the provider retrying—so events delivered before you set the",
         "// secret land afterwards instead of being lost.",
         'import type { APIRoute } from "astro";',
         'import { handleWebhook, readModuleSecret } from "astroidjs";',
@@ -222,7 +222,7 @@ export function generateAstroidWebhookRoute(config, forProvider) {
  *
  * Plural because roles are: a site running Stripe for invoicing beside
  * Fourthwall for the storefront receives from both, each with its own signing
- * secret and header. One route per provider, not per role — a provider filling
+ * secret and header. One route per provider, not per role—a provider filling
  * two roles still has one endpoint and one secret.
  */
 export function generateAstroidWebhookRoutes(config) {

package/dist/queues/webhook.d.ts

@@ -1,6 +1,6 @@
 import type { AstroidQueueMessage } from "./messages.js";
 /**
- * The queue producer surface used here — structural, so a real `Queue<T>`
+ * The queue producer surface used here—structural, so a real `Queue<T>`
  * binding satisfies it without astroid depending on the Workers types.
  *
  * `Promise<unknown>` rather than `Promise<void>`: Cloudflare's `Queue.send`
@@ -15,18 +15,18 @@ export interface WebhookVerifyInput {
     raw: string;
     headers: Headers;
     url: URL;
-    /** The signing secret — already checked to be real by the caller. */
+    /** The signing secret—already checked to be real by the caller. */
     secret: string;
 }
 export interface WebhookRouteOptions {
-    /** Which integration this endpoint serves — carried into the message. */
+    /** Which integration this endpoint serves—carried into the message. */
     provider: string;
     /**
      * The signing secret, or `null` when unprovisioned. Read it with
      * `readModuleSecret` so a placeholder counts as absent.
      */
     secret: string | null;
-    /** Signature check over the raw body — e.g. `verifySquareSignature`. */
+    /** Signature check over the raw body—for example, `verifySquareSignature`. */
     verify: (input: WebhookVerifyInput) => boolean | Promise<boolean>;
     /** The queue binding, or null/undefined when Queues aren't provisioned. */
     queue?: QueueProducer | null;
@@ -38,7 +38,7 @@ export interface WebhookRouteOptions {
     eventType?: (payload: unknown) => string;
     /**
      * Decide whether an event is worth queueing at all. Returning false acks the
-     * delivery without enqueuing — the provider is satisfied and the consumer
+     * delivery without enqueuing—the provider is satisfied and the consumer
      * isn't woken for an event nothing acts on.
      */
     accept?: (type: string, payload: unknown) => boolean;

package/dist/queues/webhook.js

@@ -4,7 +4,7 @@
 //
 // All three sites wrote this route the same way, and the ordering is the part
 // worth encoding. **Verify the HMAC over the raw body before parsing anything.**
-// Not for style — parsing first means an unauthenticated caller can reach the
+// Not for style—parsing first means an unauthenticated caller can reach the
 // JSON parser and everything downstream of it, and re-serializing a parsed body
 // to check the signature is how signature checks quietly stop checking anything.
 // So the raw text is read once, verified, and only then parsed.
@@ -58,7 +58,7 @@ export async function handleWebhook(request, url, options) {
         payload = JSON.parse(raw);
     }
     catch {
-        // Also terminal — a body that isn't JSON now won't become JSON later.
+        // Also terminal—a body that isn't JSON now won't become JSON later.
         return text("Invalid JSON", 400);
     }
     const type = (options.eventType ?? defaultEventType)(payload);
@@ -76,6 +76,6 @@ export async function handleWebhook(request, url, options) {
         return text("Queue unavailable", 503);
     }
     // 202, not 200: the work hasn't happened yet, it's been accepted. That's the
-    // entire point of enqueuing — the response returns before the consumer runs.
+    // entire point of enqueuing—the response returns before the consumer runs.
     return text("Accepted", 202);
 }

package/dist/realtime/scaffold.d.ts

@@ -10,12 +10,12 @@ export declare const ASTROID_REALTIME_MIGRATION_TAG = "v1";
 /** Is the realtime module switched on for this project? */
 export declare function usesRealtime(config: AstroidConfig): boolean;
 /**
- * `src/edit-session.ts` — the site-owned Durable Object subclass.
+ * `src/edit-session.ts`—the site-owned Durable Object subclass.
  *
  * Scaffold-once: `persist` is where a project decides what a flush means, and
  * the lock/field sets are tuning. What Astroid fixes is the delegation shape,
  * because getting it wrong fails in ways that look like anything but a bug in
- * this file — a missing `webSocketClose` leaks presence forever, a non-lazy
+ * this file—a missing `webSocketClose` leaks presence forever, a non-lazy
  * session breaks after the first hibernation wake.
  *
  * Returns null when the project has no realtime module.
@@ -23,8 +23,8 @@ export declare function usesRealtime(config: AstroidConfig): boolean;
 export declare function generateAstroidEditSession(config: AstroidConfig): string | null;
 /**
  * The `CloudflareEnv` member the realtime module adds, as a block
- * `create-astroid` substitutes into `src/env.d.ts`. Empty without the module —
- * a project that types a binding its wrangler.jsonc never creates is making a
+ * `create-astroid` substitutes into `src/env.d.ts`. Empty without the module—a
+ * project that types a binding its wrangler.jsonc never creates is making a
  * promise it doesn't keep.
  */
 export declare function generateAstroidRealtimeEnv(config: AstroidConfig): string;

package/dist/realtime/scaffold.js

@@ -5,7 +5,7 @@
 //
 // The package description has claimed "multi-editor sites" since 0.1.0, and this
 // is the half that makes it true for two people on the SAME page. (The other
-// axis — multi-EDITOR, i.e. an org of accounts — was always real.) Without it
+// axis—multi-EDITOR, that is, an org of accounts—was always real.) Without it
 // two editors on one page clobber each other; the server-side draft merge
 // narrows the window but there is no live channel, no presence, and no signal
 // that someone else is in the same field.
@@ -13,15 +13,15 @@
 // What Astroid generates and what it deliberately does NOT:
 //
 //   - The DO SUBCLASS is scaffold-once (`src/edit-session.ts`), because it must
-//     import `cloudflare:workers` — a runtime-only specifier the toolkit can't
-//     carry — and because its `persist` is the seam a project tunes. Louise
+//     import `cloudflare:workers`—a runtime-only specifier the toolkit can't
+//     carry—and because its `persist` is the seam a project tunes. Louise
 //     ships the session LOGIC it delegates to; this is the boilerplate around it.
 //   - The wrangler `durable_objects` binding + `migrations` block, which is the
 //     part nobody gets right from memory: a DO class needs a migration tag, and
 //     a SQLite-backed one needs `new_sqlite_classes` rather than `new_classes`.
 //   - The `realtimeRoute` upgrade endpoint, in the generated worker.
 //
-// Persistence goes through `applySaveDraft` — the SAME path the fetch auto-save
+// Persistence goes through `applySaveDraft`—the SAME path the fetch auto-save
 // uses. One write path, per the ADR: the DO is a new front end to it, not a
 // parallel store, so drafts, version history, publish, and read-your-writes all
 // stay intact.
@@ -38,12 +38,12 @@ export function usesRealtime(config) {
     return (config.modules ?? []).includes("realtime");
 }
 /**
- * `src/edit-session.ts` — the site-owned Durable Object subclass.
+ * `src/edit-session.ts`—the site-owned Durable Object subclass.
  *
  * Scaffold-once: `persist` is where a project decides what a flush means, and
  * the lock/field sets are tuning. What Astroid fixes is the delegation shape,
  * because getting it wrong fails in ways that look like anything but a bug in
- * this file — a missing `webSocketClose` leaks presence forever, a non-lazy
+ * this file—a missing `webSocketClose` leaks presence forever, a non-lazy
  * session breaks after the first hibernation wake.
  *
  * Returns null when the project has no realtime module.
@@ -54,7 +54,7 @@ export function generateAstroidEditSession(config) {
     return [
         "// The per-page live editing session Durable Object (ADR 0002 / #71).",
         "//",
-        "// Scaffolded once and yours to edit — `persist` in particular. What should NOT",
+        "// Scaffolded once and yours to edit—`persist` in particular. What should NOT",
         "// change is the delegation: every handler forwards to the session object, and",
         "// the session is built LAZILY. A Durable Object is re-instantiated after a",
         "// hibernation wake, so a session captured in a field initializer would be",
@@ -91,7 +91,7 @@ export function generateAstroidEditSession(config) {
         "        // Guard the collection: only `pages` is realtime, and a stray target",
         "        // must never write into the wrong table.",
         '        if (target.slug !== "pages") return;',
-        "        // The SAME merge-over-pending-draft path the fetch auto-save uses —",
+        "        // The SAME merge-over-pending-draft path the fetch auto-save uses—",
         "        // one write path, so drafts/history/publish semantics are identical.",
         "        //",
         "        // No `bufferKv` here on purpose: the DO's alarm IS the coalescer for",
@@ -105,8 +105,8 @@ export function generateAstroidEditSession(config) {
         "          snapshot,",
         "        );",
         "        // A THROW (D1 down) propagates so the alarm keeps the snapshot dirty",
-        "        // and retries. An `ok: false` is terminal — a deleted row, an invalid",
-        "        // draft — which a retry can't fix, so let the alarm clear it, but say",
+        "        // and retries. An `ok: false` is terminal—a deleted row, an invalid",
+        "        // draft—which a retry can't fix, so let the alarm clear it, but say",
         "        // so rather than dropping it silently.",
         "        if (!result.ok) {",
         "          console.warn(",
@@ -143,8 +143,8 @@ export function generateAstroidEditSession(config) {
 }
 /**
  * The `CloudflareEnv` member the realtime module adds, as a block
- * `create-astroid` substitutes into `src/env.d.ts`. Empty without the module —
- * a project that types a binding its wrangler.jsonc never creates is making a
+ * `create-astroid` substitutes into `src/env.d.ts`. Empty without the module—a
+ * project that types a binding its wrangler.jsonc never creates is making a
  * promise it doesn't keep.
  */
 export function generateAstroidRealtimeEnv(config) {

package/dist/schema/collections.d.ts

@@ -2,18 +2,18 @@ import { type CollectionConfig, type ContentConfig } from "louise-toolkit/conten
 import type { AstroidConfig } from "../config.js";
 /**
  * Return a copy of a `pages` write payload with its `sections` rich-text fields
- * sanitized against the project media base — a no-op when the write carries no
+ * sanitized against the project media base—a no-op when the write carries no
  * `sections`. Pure; leaves every other field (and a partial PATCH's absent ones)
  * untouched.
  *
  * Exported because two write paths need it: the collection's `beforeChange` hook
- * below, AND the raw `pagesRoute` (which does not run collection hooks — see
+ * below, AND the raw `pagesRoute` (which does not run collection hooks—see
  * {@link astroidPagesWriteHooks}).
  */
 export declare function sanitizeAstroidPageSections(config: AstroidConfig, data: Record<string, unknown>): Record<string, unknown>;
 /**
  * Validate the (already-sanitized) `sections` of a `pages` write against the
- * catalog, throwing `LouiseValidationError` — an unknown `_type`, a field of the
+ * catalog, throwing `LouiseValidationError`—an unknown `_type`, a field of the
  * wrong shape, or a setting outside its declared options is rejected with a 422
  * carrying the per-field violations. A no-op when the write carries no
  * `sections`, so a partial PATCH of other fields isn't spuriously validated.
@@ -23,7 +23,7 @@ export declare function assertAstroidPageSections(config: AstroidConfig, data: R
  * The write-time hooks the raw `pagesRoute` (louise-toolkit/editor) needs to
  * enforce the same section contract as the draft path.
  *
- * `pagesRoute` writes straight to the table and — unlike `versionsRoute` — takes
+ * `pagesRoute` writes straight to the table and—unlike `versionsRoute`—takes
  * no collection config, so it never runs the `beforeChange` hook below. Left
  * bare (as it was), a direct `POST` / `PATCH /api/louise/pages/:id` persists an
  * unknown section `_type`, a setting outside its options, or unsanitized section
@@ -37,18 +37,49 @@ export declare function assertAstroidPageSections(config: AstroidConfig, data: R
  *
  *   pagesRoute({ table: pages, resolveEditor, fields, ...astroidPagesWriteHooks(config) })
  */
-export declare function astroidPagesWriteHooks(config: AstroidConfig): {
+/** The write context `pagesRoute` passes to a transform or validator. */
+export interface AstroidPagesWriteContext {
+    operation: "create" | "update";
+}
+/**
+ * A site's own `pagesRoute` hooks, exported as `pagesHooks` from the
+ * scaffold-once `src/pages-hooks.ts` when `pages.hooks` is on.
+ */
+export interface AstroidPagesHooks {
+    /**
+     * Clean a page write before Astroid's section sanitize and validate run, for
+     * example to normalize the slug, clamp a title, or fill a new page's defaults.
+     * It gets only the allowlisted fields of the write.
+     */
+    transform?: (data: Record<string, unknown>, ctx: AstroidPagesWriteContext) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /**
+     * Reject a write, after both transforms and before Astroid's own section
+     * validation. Throw a `LouiseValidationError` for a 422 with per-field
+     * violations, for example when a required field is empty.
+     */
+    validate?: (data: Record<string, unknown>, ctx: AstroidPagesWriteContext) => void | Promise<void>;
+    /** Slugs to refuse on top of {@link ASTROID_RESERVED_SLUGS}, such as a path
+     *  a site's own file route serves. */
+    reservedSlugs?: Iterable<string>;
+}
+/**
+ * Slugs no page may take, on any site. Each one is a path Astro, Cloudflare,
+ * or Astroid serves before the catch-all page route, so a page saved under it
+ * would be unreachable, and nothing would say why. `pagesRoute` refuses them
+ * with a 422 instead.
+ */
+export declare const ASTROID_RESERVED_SLUGS: readonly string[];
+export declare function astroidPagesWriteHooks(config: AstroidConfig, site?: AstroidPagesHooks): {
     sanitize: (html: string) => string;
-    transform: (data: Record<string, unknown>) => Record<string, unknown>;
-    validate: (data: Record<string, unknown>, ctx: {
-        operation: "create" | "update";
-    }) => Promise<void>;
+    transform: (data: Record<string, unknown>, ctx: AstroidPagesWriteContext) => Promise<Record<string, unknown>>;
+    validate: (data: Record<string, unknown>, ctx: AstroidPagesWriteContext) => Promise<void>;
+    reservedSlugs: string[];
 };
 export declare function astroidPagesCollection(config: AstroidConfig): CollectionConfig;
 /**
  * The Louise `ContentConfig` for an Astroid project. Today: the `pages`
- * collection. Archetype- and module-specific collections (e.g. a portfolio
- * `gallery`) layer in here as they land — this is the single place that maps
+ * collection. Archetype- and module-specific collections (for example, a portfolio
+ * `gallery`) layer in here as they land—this is the single place that maps
  * brand config down to Louise content.
  */
 export declare function astroidContentConfig(config: AstroidConfig): ContentConfig;