astroidjs 0.12.1 → 0.13.0

package/dist/project/generate.d.ts

@@ -1,12 +1,12 @@
 import type { AstroidConfig } from "../config.js";
 /** A generated file: a project-root-relative POSIX path + its full contents. */
 export interface GeneratedFile {
-    /** Path relative to the project root, POSIX-separated (e.g. `"src/worker.ts"`). */
+    /** Path relative to the project root, POSIX-separated (for example, `"src/worker.ts"`). */
     path: string;
     contents: string;
 }
 /**
- * The regenerated trio — the files that are a pure function of the Astroid config
+ * The regenerated trio—the files that are a pure function of the Astroid config
  * and carry a "do not hand-edit" banner. `astroid generate` writes exactly these,
  * and `astroid doctor` regenerates them in-memory to diff against disk. Scaffold-
  * once files (wrangler.jsonc, astro.config, auth.ts) are NOT here by design.
@@ -22,7 +22,7 @@ export declare function generateAstroidProject(config: AstroidConfig): Generated
  * names come from {@link commerceSecretNames}, the same declaration the runtime
  * gate and the generated `env.d.ts` read.
  *
- * Empty string when the project enables no module that needs credentials — the
+ * Empty string when the project enables no module that needs credentials—the
  * core secrets (session, Turnstile, mail) are already in the template file, with
  * their own prose.
  */
@@ -31,7 +31,7 @@ export declare function generateAstroidSecretsEnv(config: AstroidConfig): string
  * Generate a floor `wrangler.jsonc` from the config: the Worker name + editable
  * bindings a baseline Louise site needs (D1, R2 media, the rate-limit + autosave
  * KV, Cloudflare Images), custom-domain routes from `hosts`, and the `vars` the
- * media route + editor read. Binding ids are placeholders — real ids are filled by
+ * media route + editor read. Binding ids are placeholders—real ids are filled by
  * `wrangler … create` (or, later, `astroid deploy`); `astroid doctor` flags any
  * still-unresolved placeholder.
  *

package/dist/project/generate.js

@@ -1,18 +1,18 @@
 // Copyright (c) 2026 BowenLabs. Astroid is MIT licensed.
 //
-// Project generation — the config → files layer the `astroid` CLI writes.
+// Project generation—the config → files layer the `astroid` CLI writes.
 //
 // Two tiers of generated file, deliberately kept apart:
 //
-//   1. The REGENERATED trio (`generateAstroidProject`) — `src/schema.ts`,
+//   1. The REGENERATED trio (`generateAstroidProject`)—`src/schema.ts`,
 //      `src/worker.ts`, `src/middleware.ts`. Pure functions of the config, marked
 //      "do not hand-edit". `astroid generate` (and `dev`/`build`) rewrite these on
 //      every run, and `astroid doctor` diffs them to catch drift.
 //
-//   2. The SCAFFOLD-ONCE files (`generateAstroidWrangler`, …) — `wrangler.jsonc`
+//   2. The SCAFFOLD-ONCE files (`generateAstroidWrangler`, …)—`wrangler.jsonc`
 //      and friends. `create-astroid` writes them once; the developer then owns
 //      them (fills real binding ids, secrets, account). `astroid generate` must
-//      NEVER clobber them, or it would wipe provisioned ids — so they live in a
+//      NEVER clobber them, or it would wipe provisioned ids—so they live in a
 //      separate function the regenerate path doesn't call.
 import { ASTROID_VITALS_BINDING, astroidVitalsDataset } from "../analytics/index.js";
 import { astroidCheckoutVars } from "../commerce/checkout-scaffold.js";
@@ -25,7 +25,7 @@ import { tenancyZone } from "../tenancy/index.js";
 import { generateAstroidSchema } from "../schema/generate.js";
 import { generateAstroidMiddleware, generateAstroidWorker } from "../worker/generate.js";
 /**
- * The regenerated trio — the files that are a pure function of the Astroid config
+ * The regenerated trio—the files that are a pure function of the Astroid config
  * and carry a "do not hand-edit" banner. `astroid generate` writes exactly these,
  * and `astroid doctor` regenerates them in-memory to diff against disk. Scaffold-
  * once files (wrangler.jsonc, astro.config, auth.ts) are NOT here by design.
@@ -47,7 +47,7 @@ export function generateAstroidProject(config) {
  * names come from {@link commerceSecretNames}, the same declaration the runtime
  * gate and the generated `env.d.ts` read.
  *
- * Empty string when the project enables no module that needs credentials — the
+ * Empty string when the project enables no module that needs credentials—the
  * core secrets (session, Turnstile, mail) are already in the template file, with
  * their own prose.
  */
@@ -75,14 +75,14 @@ export function generateAstroidSecretsEnv(config) {
     return lines.join("\n");
 }
 // Pinned compatibility date for the emitted Worker. A literal (Astroid's
-// generators are pure — no `Date.now()`), bumped deliberately when the runtime
+// generators are pure—no `Date.now()`), bumped deliberately when the runtime
 // baseline moves; matches the reference site's wrangler.jsonc.
 const COMPATIBILITY_DATE = "2026-06-20";
 /**
  * Generate a floor `wrangler.jsonc` from the config: the Worker name + editable
  * bindings a baseline Louise site needs (D1, R2 media, the rate-limit + autosave
  * KV, Cloudflare Images), custom-domain routes from `hosts`, and the `vars` the
- * media route + editor read. Binding ids are placeholders — real ids are filled by
+ * media route + editor read. Binding ids are placeholders—real ids are filled by
  * `wrangler … create` (or, later, `astroid deploy`); `astroid doctor` flags any
  * still-unresolved placeholder.
  *
@@ -120,7 +120,7 @@ export function generateAstroidWrangler(config) {
             p(`    { "pattern": ${JSON.stringify(host)}, "custom_domain": true },`);
         }
         if (tenancy) {
-            // A wildcard is a ZONE route, never a custom domain — Cloudflare rejects
+            // A wildcard is a ZONE route, never a custom domain—Cloudflare rejects
             // `custom_domain: true` on a pattern containing `*`, which is precisely
             // why `hosts` cannot express this.
             p("    // Wildcard tenant hosts (`tenancy.hostPattern`). A zone route, NOT a");
@@ -137,7 +137,7 @@ export function generateAstroidWrangler(config) {
     }
     if (usesRealtime(config)) {
         // The per-page live editing session (ADR 0002). Two halves, and BOTH are
-        // required — a binding with no migration is a deploy error, and the class
+        // required—a binding with no migration is a deploy error, and the class
         // must also be exported from the worker entry (the generated src/worker.ts
         // re-exports it) or wrangler can't resolve `class_name`.
         p("  // Durable Object: the per-page live editing session (realtime module).");
@@ -154,7 +154,7 @@ export function generateAstroidWrangler(config) {
     }
     // Crons. ONE `scheduled` handler receives all of them and tells them apart by
     // `controller.cron`, so this list and the handler's dispatch must agree
-    // exactly — both come from `astroidCrons`, which is why it exists.
+    // exactly—both come from `astroidCrons`, which is why it exists.
     //
     // Daily: the site-health scan (broken links, missing alt text, SEO gaps).
     // Hourly (commerce only): the catalog re-sync safety net, so a missed or DLQ'd
@@ -217,8 +217,8 @@ export function generateAstroidWrangler(config) {
     // Email Sending. NOT optional decoration: `src/env.d.ts` declares EMAIL as a
     // required member, and Better Auth's magic-link path console-logs the link in
     // dev but calls `env.EMAIL.send(...)` unconditionally in production. Without
-    // this binding that call is a TypeError on a binding that was never created —
-    // so sign-in was impossible on every DEPLOYED site, while every local build
+    // this binding that call is a TypeError on a binding that was never created—so
+    // sign-in was impossible on every DEPLOYED site, while every local build
     // and every CI scaffold passed. Nothing in this repo runs a deployed scaffold,
     // which is why it survived.
     p("  // Cloudflare Email Sending — magic-link sign-in + inquiry notifications.");
@@ -242,7 +242,7 @@ export function generateAstroidWrangler(config) {
     p("    // undo — this feature was reverted twice for exactly that.");
     p('    "ASTROID_EDGE_CACHE": "false",');
     for (const v of astroidCheckoutVars(config)) {
-        // Public, not secret — the app id ships to the browser to mount the card
+        // Public, not secret—the app id ships to the browser to mount the card
         // field, and the environment is a choice. Keeping them out of the secret
         // roster also keeps them out of the dormancy gate, which asks whether we can
         // safely CALL Square, not whether a card field can render.
@@ -251,7 +251,7 @@ export function generateAstroidWrangler(config) {
     p("  },");
     // Secrets are NOT vars: they belong in .dev.vars locally and in `wrangler
     // secret put` / Secrets Store when deployed. Listing the names here is
-    // deliberate — this is the file someone opens when provisioning, and the list
+    // deliberate—this is the file someone opens when provisioning, and the list
     // is generated from the same declaration the runtime dormancy gate reads.
     const secretNames = commerceSecretNames(config.commerce);
     if (secretNames.length > 0) {

package/dist/project/index.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2026 BowenLabs. Astroid is MIT licensed.
 //
-// Project generation — config → the files the `astroid` CLI writes (the
+// Project generation—config → the files the `astroid` CLI writes (the
 // regenerated schema/worker/middleware trio + the scaffold-once wrangler.jsonc).
 export * from "./generate.js";
 export * from "./actions.js";

package/dist/project/scaffold.d.ts

@@ -4,7 +4,7 @@ import type { AstroidConfig } from "../config.js";
  *
  * `apply` is the whole contract. `"skip"` (the default) leaves an existing file
  * alone. `"append-once"` is for the files a project accumulates into rather than
- * owns outright — `public/_headers` gets a stanza per module, and a second
+ * owns outright—`public/_headers` gets a stanza per module, and a second
  * module must not erase the first one's.
  */
 export interface ScaffoldFile {
@@ -23,7 +23,7 @@ export interface ScaffoldFile {
  * Every scaffold-once file this config implies.
  *
  * Ordered by module so a `generate` that writes several prints them in a stable
- * sequence. Returns `[]` for a plain marketing site with no modules — the
+ * sequence. Returns `[]` for a plain marketing site with no modules—the
  * baseline floor is entirely the regenerated trio plus the static template.
  */
 export declare function generateAstroidScaffoldFiles(config: AstroidConfig): ScaffoldFile[];

package/dist/project/scaffold.js

@@ -9,8 +9,8 @@
 //   src/worker.ts      → import { handleQueueMessage } from "./queue.js"
 //   src/middleware.ts  → import { resolvePortalUser } from "./portal-auth.js"
 //
-// The files behind those imports were written in exactly one place —
-// `create-astroid`'s CLI — and nothing else could produce them. So turning a
+// The files behind those imports were written in exactly one
+// place—`create-astroid`'s CLI—and nothing else could produce them. So turning a
 // module on AFTER scaffold, by editing the one typed config the framework is
 // built around, regenerated a trio importing files that did not exist. `astroid
 // doctor` reported "healthy" and the project failed in Vite.
@@ -41,7 +41,7 @@ import { generateAstroidQueueSeam, generateAstroidWebhookRoutes } from "../queue
  * Every scaffold-once file this config implies.
  *
  * Ordered by module so a `generate` that writes several prints them in a stable
- * sequence. Returns `[]` for a plain marketing site with no modules — the
+ * sequence. Returns `[]` for a plain marketing site with no modules—the
  * baseline floor is entirely the regenerated trio plus the static template.
  */
 export function generateAstroidScaffoldFiles(config) {
@@ -56,7 +56,7 @@ export function generateAstroidScaffoldFiles(config) {
         files.push({ path: "migrations/0003_catalog.sql", contents: catalogSql });
     // --- the CWV beacon -------------------------------------------------------
     // A static file under public/, so it is same-origin and covered by
-    // `script-src 'self'` — an inline script carrying generated content could not
+    // `script-src 'self'`—an inline script carrying generated content could not
     // be hashed into the CSP and would be blocked.
     const beacon = generateAstroidVitalsBeacon(config, cwvBeaconScript());
     files.push({ path: beacon.path, contents: beacon.contents });
@@ -96,7 +96,7 @@ export function generateAstroidScaffoldFiles(config) {
     // is why `astroid generate` must never rewrite them.
     if (astroidUsesQueues(config)) {
         files.push({ path: "src/queue.ts", contents: generateAstroidQueueSeam(config) });
-        // One receiver per provider — a site can run two (invoicing + storefront).
+        // One receiver per provider—a site can run two (invoicing + storefront).
         for (const route of generateAstroidWebhookRoutes(config)) {
             files.push({ path: route.path, contents: route.contents });
         }
@@ -107,14 +107,14 @@ export function generateAstroidScaffoldFiles(config) {
     if (gallery)
         files.push({ path: "src/pages/work.astro", contents: gallery });
     // --- pwa: the service worker, manifest, and its headers -------------------
-    // Static files under public/, not generated source — a service worker is not
+    // Static files under public/, not generated source—a service worker is not
     // bundled, and `_headers` is shared with whatever else writes to it.
     const sw = generateServiceWorker(config);
     if (sw) {
         // `emitDir` puts them where the BROWSER will ask for them. A PWA on its own
         // subdomain that rewrites to a path prefix (studio.example.com/ → /studio/)
-        // fetches /sw.js at its own origin root, which rewrites to /studio/sw.js —
-        // so a worker emitted at the public root is a 404 nothing explains.
+        // fetches /sw.js at its own origin root, which rewrites to /studio/sw.js—so
+        // a worker emitted at the public root is a 404 nothing explains.
         const pwaDir = resolvePwa(config).emitDir;
         const publicBase = pwaDir ? `public/${pwaDir}` : "public";
         files.push({ path: `${publicBase}/sw.js`, contents: sw });
@@ -125,7 +125,7 @@ export function generateAstroidScaffoldFiles(config) {
         const headers = generatePwaHeaders(config);
         if (headers) {
             files.push({
-                // `_headers` stays at the public root wherever the worker lives — it is
+                // `_headers` stays at the public root wherever the worker lives—it is
                 // one file for the whole site, and Cloudflare only reads it there.
                 path: "public/_headers",
                 contents: headers,
@@ -154,7 +154,7 @@ export function generateAstroidScaffoldFiles(config) {
         files.push({ path: "src/edit-session.ts", contents: editSession });
     // --- tenancy: what a subdomain maps to ------------------------------------
     // Astroid owns the wildcard route and the middleware wiring; this file owns
-    // every decision — the lookup, its caching, and what an unknown host means.
+    // every decision—the lookup, its caching, and what an unknown host means.
     const tenancy = generateAstroidTenancy(config);
     if (tenancy)
         files.push({ path: "src/tenancy.ts", contents: tenancy });
@@ -167,7 +167,7 @@ export function generateAstroidScaffoldFiles(config) {
         const route = generateAstroidPortalAuthRoute(config);
         // Always non-null alongside portalAuth (same `astroidPortal` gate), but the
         // types don't know that and a silent drop here is a portal that cannot
-        // authenticate — so assert it rather than `?.`-ing it away.
+        // authenticate—so assert it rather than `?.`-ing it away.
         //
         // The route file lives at the mount path, because Astro routing is
         // file-path-based: a portal mounted at `/api/shop-auth` needs its catch-all

package/dist/pwa/generate.d.ts

@@ -21,38 +21,38 @@ export interface PwaConfig {
     /** Extra paths to precache alongside the scope root. */
     shell?: string[];
     /**
-     * A prerendered page to serve when a navigation fails offline, e.g.
+     * A prerendered page to serve when a navigation fails offline, for example,
      * `"/offline"`.
      *
-     * Without it the fallback is the scope root — the *dynamic* app shell, which
+     * Without it the fallback is the scope root—the *dynamic* app shell, which
      * is exactly the wrong thing to precache when the app is auth-gated: that
      * response carries `Cache-Control: no-store`, so either nothing is cached and
      * the fallback is empty, or a signed-in shell is stored and later served to
      * whoever opens the app next.
      *
      * Point it at a page with no session-specific markup. It is precached with the
-     * shell, so it must be prerendered — a dynamic route here fails at exactly the
+     * shell, so it must be prerendered—a dynamic route here fails at exactly the
      * moment it is needed.
      */
     offlineFallback?: string;
     /**
-     * Subdirectory under `public/` to emit `sw.js` and the manifest into, e.g.
+     * Subdirectory under `public/` to emit `sw.js` and the manifest into, for example,
      * `"studio"`. Default: the public root.
      *
-     * For a PWA served from its own subdomain that rewrites to a path prefix —
-     * `studio.example.com/` → `/studio/` — the browser fetches `/sw.js` at *its*
+     * For a PWA served from its own subdomain that rewrites to a path prefix—`studio.example.com/`
+     * → `/studio/`—the browser fetches `/sw.js` at *its*
      * origin root, which rewrites to `/studio/sw.js`. Emitting at the public root
      * puts the file where nothing will ask for it.
      *
      * Set this to the same prefix the host rewrites to. With `scope` equal to the
-     * serving path, no `Service-Worker-Allowed` header is needed — a worker may
+     * serving path, no `Service-Worker-Allowed` header is needed—a worker may
      * always control its own directory and below.
      */
     emitDir?: string;
 }
 /** True when this project switched the PWA on. */
 export declare const usesPwa: (config: AstroidConfig) => boolean;
-/** Resolved PWA settings — config over derivation over default. */
+/** Resolved PWA settings—config over derivation over default. */
 export declare function resolvePwa(config: AstroidConfig): Required<Omit<PwaConfig, "shell" | "offlineFallback" | "emitDir">> & {
     shell: string[];
     /** `null` when the app falls back to the scope root (see the config note). */
@@ -63,18 +63,18 @@ export declare function resolvePwa(config: AstroidConfig): Required<Omit<PwaConf
 /**
  * `public/manifest.webmanifest`.
  *
- * Icons are declared but NOT generated — a brand's icon is not something a
+ * Icons are declared but NOT generated—a brand's icon is not something a
  * scaffold can invent, and emitting placeholders would produce an installable
  * app with a grey square for a face. The generated README step says to add them.
  */
 export declare function generateWebManifest(config: AstroidConfig): string | null;
-/** `public/sw.js`. Plain JS — a service worker is not bundled. */
+/** `public/sw.js`. Plain JS—a service worker is not bundled. */
 export declare function generateServiceWorker(config: AstroidConfig): string | null;
 /**
  * The `public/_headers` block the PWA needs.
  *
  * `Service-Worker-Allowed` is emitted ONLY when the scope is broader than the
- * script's own location — which, with `sw.js` at the root, never is. Emitting it
+ * script's own location—which, with `sw.js` at the root, never is. Emitting it
  * unconditionally (as the reference does) is harmless but misleading: it implies
  * a requirement that isn't there, and someone later moving the script will trust
  * a header that no longer says what they need.

package/dist/pwa/generate.js

@@ -1,21 +1,21 @@
 // Copyright (c) 2026 BowenLabs. Astroid is MIT licensed.
 //
-// The PWA scaffold — a scoped service worker, a manifest, and the headers they
+// The PWA scaffold—a scoped service worker, a manifest, and the headers they
 // need.
 //
 // The scoping is the whole design, not a detail. A Louise site is CMS-edited:
 // an editor signs in, flips edit mode on, and edits the live page in place. A
 // service worker that cached HTML across the whole origin would serve that
-// editor a stale copy of the page they are trying to change — and the bug would
+// editor a stale copy of the page they are trying to change—and the bug would
 // present as "my edits don't save", which is about as far from the cause as a
 // report can get.
 //
 // So the generated worker is scoped, and inside its scope it still refuses to
 // touch anything dynamic:
 //
-//   • `/api/*`        never cached — checkout, auth, and every Louise write
-//   • editor routes   never cached — the studio must always be live
-//   • edit-mode URLs  never cached — `?louise` marks a request as an editing
+//   • `/api/*`        never cached—checkout, auth, and every Louise write
+//   • editor routes   never cached—the studio must always be live
+//   • edit-mode URLs  never cached—`?louise` marks a request as an editing
 //                     session, and caching one poisons it for everyone
 //
 // Everything else is the ordinary split: navigations network-first with a
@@ -23,7 +23,7 @@
 // when their content does.
 /** True when this project switched the PWA on. */
 export const usesPwa = (config) => (config.modules ?? []).includes("pwa");
-/** Resolved PWA settings — config over derivation over default. */
+/** Resolved PWA settings—config over derivation over default. */
 export function resolvePwa(config) {
     const pwa = config.pwa ?? {};
     // Normalized to a leading slash and no trailing one (except root), because
@@ -41,7 +41,7 @@ export function resolvePwa(config) {
         themeColor: pwa.themeColor ?? config.theme.colors.brand,
         offlineFallback: pwa.offlineFallback ?? null,
         emitDir: (pwa.emitDir ?? "").replace(/^\/+|\/+$/g, ""),
-        // The offline page is precached with the shell — a fallback fetched on
+        // The offline page is precached with the shell—a fallback fetched on
         // demand is a fallback that isn't there when the network is.
         shell: [
             scope,
@@ -51,7 +51,7 @@ export function resolvePwa(config) {
         ],
     };
 }
-/** URL prefix the emitted `sw.js` + manifest are served from — `""` at the
+/** URL prefix the emitted `sw.js` + manifest are served from—`""` at the
  *  public root, `"/studio"` under an `emitDir`. */
 function assetBase(emitDir) {
     const dir = (emitDir ?? "").replace(/^\/+|\/+$/g, "");
@@ -60,7 +60,7 @@ function assetBase(emitDir) {
 /**
  * `public/manifest.webmanifest`.
  *
- * Icons are declared but NOT generated — a brand's icon is not something a
+ * Icons are declared but NOT generated—a brand's icon is not something a
  * scaffold can invent, and emitting placeholders would produce an installable
  * app with a grey square for a face. The generated README step says to add them.
  */
@@ -100,7 +100,7 @@ export function generateWebManifest(config) {
         ],
     }, null, 2)}\n`;
 }
-/** `public/sw.js`. Plain JS — a service worker is not bundled. */
+/** `public/sw.js`. Plain JS—a service worker is not bundled. */
 export function generateServiceWorker(config) {
     if (!usesPwa(config))
         return null;
@@ -230,7 +230,7 @@ export function generateServiceWorker(config) {
  * The `public/_headers` block the PWA needs.
  *
  * `Service-Worker-Allowed` is emitted ONLY when the scope is broader than the
- * script's own location — which, with `sw.js` at the root, never is. Emitting it
+ * script's own location—which, with `sw.js` at the root, never is. Emitting it
  * unconditionally (as the reference does) is harmless but misleading: it implies
  * a requirement that isn't there, and someone later moving the script will trust
  * a header that no longer says what they need.
@@ -238,7 +238,7 @@ export function generateServiceWorker(config) {
 export function generatePwaHeaders(config) {
     if (!usesPwa(config))
         return null;
-    // Paths must match where the files are actually emitted — a stanza for
+    // Paths must match where the files are actually emitted—a stanza for
     // `/sw.js` while the worker lives at `/studio/sw.js` sets headers on nothing,
     // and the no-cache rule is what stops a bad worker sticking around.
     const base = assetBase(config.pwa?.emitDir);

package/dist/queues/consumer.d.ts

@@ -1,12 +1,12 @@
 import { type AstroidQueueMessage } from "./messages.js";
 export interface QueueHandlerOptions {
     /**
-     * Re-sync whatever the provider owns — the catalog mirror, a cache. Called
+     * Re-sync whatever the provider owns—the catalog mirror, a cache. Called
      * for a periodic refresh and for webhooks that touched the catalog.
      *
      * Receives the message that triggered it, so a site running more than one
      * commerce provider can branch on `message.provider` rather than refreshing
-     * everything for everything. A zero-argument seam stays valid — the parameter
+     * everything for everything. A zero-argument seam stays valid—the parameter
      * is there to be ignored until it's needed.
      *
      * Throwing marks the message for retry, which is usually right: a failed
@@ -24,7 +24,7 @@ export interface QueueHandlerOptions {
      * storefront and Square as its POS, at which point `refreshCatalog` means
      * "re-pull Fourthwall" while Square emits `inventory.count.updated` on every
      * single sale. Unscoped, a good Saturday becomes a sync storm against an
-     * unrelated provider's rate limit — and the periodic refresh is unaffected, so
+     * unrelated provider's rate limit—and the periodic refresh is unaffected, so
      * the site looks fine until the day it's busy.
      */
     catalogProvider?: string;

package/dist/queues/consumer.js

@@ -9,8 +9,8 @@
 // acks as a no-op.
 //
 // That last part matters more than it looks. Order, payment, and subscription
-// events are read live from the provider, so there is nothing local to update —
-// but they still arrive, in volume. A consumer that treats every event as
+// events are read live from the provider, so there is nothing local to
+// update—but they still arrive, in volume. A consumer that treats every event as
 // actionable turns a busy sales day into a catalog-refresh storm.
 import { affectsCatalog } from "./messages.js";
 /**

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.
  */
@@ -66,7 +66,7 @@ export function generateAstroidEnvBindings(config) {
         // 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;
@@ -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];
@@ -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) {