@lunora/astro 1.0.0-alpha.61 → 1.0.0-alpha.63

package/dist/index.d.mts

@@ -1,19 +1,4 @@
 export { type FrameworkHostHandler as AstroWorkerHandler, type LunoraWorker as ComposedWorker, type FrameworkWorkerOptions as LunoraOptions, withFrameworkWorker as withLunora } from '@lunora/runtime';
-/**
- * The Lunora Astro **integration** — an `AstroIntegration` object
- * (`{ name, hooks }`) added to `astro.config.*`'s `integrations` array.
- *
- * Astro is multi-framework at the UI layer, so this integration is **not** a new
- * reactive runtime. Its job is the *composition* seam (PLAN4 class-B): make the
- * Worker `@astrojs/cloudflare` emits mount Lunora realtime under `/_lunora/*`
- * via `withLunora`, and surface the framework-neutral server helpers
- * (`@lunora/astro/server`) to Astro server endpoints / `.astro` frontmatter.
- *
- * Reactivity itself comes from whichever island adapter the app hydrates with —
- * `@lunora/react`, `@lunora/solid`, `@lunora/svelte`, or `@lunora/vue` — each of
- * which ships its own `hydratePreloaded(preloaded)` for the SSR-seed → live
- * handoff. This package owns the server/composition half only.
- */
 /**
  * Structural subset of Astro's `AstroIntegration`. Declared locally (rather than
  * importing `astro`'s type) so `@lunora/astro`'s public surface stays decoupled
@@ -54,18 +39,21 @@ interface LunoraIntegrationOptions {
  *
  * What it does:
  *
- * - Marks the build so the `@astrojs/cloudflare` server entry is wrapped with
- *   `withLunora` — the composed worker reserves `/_lunora/*` for Lunora realtime
- *   and forwards everything else to Astro's SSR handler (one worker, one deploy).
  * - Documents the `serverEntry` (default `src/worker.ts`) where the
  *   `withLunora(astroWorker, { shardDO: env.SHARD, … })` composition lives.
+ * - Checks, at `astro:config:done`, that `serverEntry` exists and contains an
+ *   actual `withLunora(...)` CALL (not merely an import of it) — and warns
+ *   (does not fail the build) when it doesn't, so a missing wrapper is caught
+ *   at build time instead of shipping a worker where `/_lunora/*` is unrouted
+ *   and realtime silently 404s.
  *
- * The hook is intentionally minimal here: the load-bearing composition is the
- * `withLunora` wrapper at the server-entry boundary (see `withLunora` for the
- * `@astrojs/cloudflare` injection point). The integration object exists so the
- * wiring is declared in `astro.config` the idiomatic Astro way, and so future
- * build-time hooks (binding reconcile, dev middleware) have a home without
- * changing the public surface.
+ * This integration does NOT wrap the server entry itself — no file is written
+ * or modified. The load-bearing composition is the `withLunora` call the
+ * project author writes at the server-entry boundary (see `withLunora` for the
+ * `@astrojs/cloudflare` injection point); this object exists so the wiring is
+ * declared in `astro.config` the idiomatic Astro way, checked once at build
+ * time, and has a home for future build-time hooks (binding reconcile, dev
+ * middleware) without changing the public surface.
  */
 declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
 export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.d.ts

@@ -1,19 +1,4 @@
 export { type FrameworkHostHandler as AstroWorkerHandler, type LunoraWorker as ComposedWorker, type FrameworkWorkerOptions as LunoraOptions, withFrameworkWorker as withLunora } from '@lunora/runtime';
-/**
- * The Lunora Astro **integration** — an `AstroIntegration` object
- * (`{ name, hooks }`) added to `astro.config.*`'s `integrations` array.
- *
- * Astro is multi-framework at the UI layer, so this integration is **not** a new
- * reactive runtime. Its job is the *composition* seam (PLAN4 class-B): make the
- * Worker `@astrojs/cloudflare` emits mount Lunora realtime under `/_lunora/*`
- * via `withLunora`, and surface the framework-neutral server helpers
- * (`@lunora/astro/server`) to Astro server endpoints / `.astro` frontmatter.
- *
- * Reactivity itself comes from whichever island adapter the app hydrates with —
- * `@lunora/react`, `@lunora/solid`, `@lunora/svelte`, or `@lunora/vue` — each of
- * which ships its own `hydratePreloaded(preloaded)` for the SSR-seed → live
- * handoff. This package owns the server/composition half only.
- */
 /**
  * Structural subset of Astro's `AstroIntegration`. Declared locally (rather than
  * importing `astro`'s type) so `@lunora/astro`'s public surface stays decoupled
@@ -54,18 +39,21 @@ interface LunoraIntegrationOptions {
  *
  * What it does:
  *
- * - Marks the build so the `@astrojs/cloudflare` server entry is wrapped with
- *   `withLunora` — the composed worker reserves `/_lunora/*` for Lunora realtime
- *   and forwards everything else to Astro's SSR handler (one worker, one deploy).
  * - Documents the `serverEntry` (default `src/worker.ts`) where the
  *   `withLunora(astroWorker, { shardDO: env.SHARD, … })` composition lives.
+ * - Checks, at `astro:config:done`, that `serverEntry` exists and contains an
+ *   actual `withLunora(...)` CALL (not merely an import of it) — and warns
+ *   (does not fail the build) when it doesn't, so a missing wrapper is caught
+ *   at build time instead of shipping a worker where `/_lunora/*` is unrouted
+ *   and realtime silently 404s.
  *
- * The hook is intentionally minimal here: the load-bearing composition is the
- * `withLunora` wrapper at the server-entry boundary (see `withLunora` for the
- * `@astrojs/cloudflare` injection point). The integration object exists so the
- * wiring is declared in `astro.config` the idiomatic Astro way, and so future
- * build-time hooks (binding reconcile, dev middleware) have a home without
- * changing the public surface.
+ * This integration does NOT wrap the server entry itself — no file is written
+ * or modified. The load-bearing composition is the `withLunora` call the
+ * project author writes at the server-entry boundary (see `withLunora` for the
+ * `@astrojs/cloudflare` injection point); this object exists so the wiring is
+ * declared in `astro.config` the idiomatic Astro way, checked once at build
+ * time, and has a home for future build-time hooks (binding reconcile, dev
+ * middleware) without changing the public surface.
  */
 declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
 export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.mjs

@@ -1 +1 @@
-import{lunora as a}from"./packem_shared/lunora-DR6Obxyg.mjs";import{withFrameworkWorker as t}from"@lunora/runtime";export{a as lunora,t as withLunora};
+import{lunora as a}from"./packem_shared/lunora-DUrBrtb9.mjs";import{withFrameworkWorker as t}from"@lunora/runtime";export{a as lunora,t as withLunora};

package/dist/packem_shared/lunora-DUrBrtb9.mjs

@@ -0,0 +1,6 @@
+import{existsSync as h,readFileSync as c}from"node:fs";import{fileURLToPath as w}from"node:url";const i=['import { withLunora } from "@lunora/astro/server";',"","export default withLunora(astroWorker, { shardDO: env.SHARD /* , … */ });"].join(`
+`),d=/\bwithLunora\s*\(/u,m=(u={})=>{const t=(u.serverEntry??"src/worker.ts").trim();return{hooks:{"astro:config:done":(o={})=>{if(t.length===0)throw new TypeError("@lunora/astro: `serverEntry` must be a non-empty path.");const e=o.config?.root;if(e===void 0)return;const n=r=>{o.logger?.warn?o.logger.warn(r):console.warn(r)},a=w(new URL(t,e));if(!h(a)){n(`@lunora/astro: server entry "${t}" not found — add it (or point \`lunora({ serverEntry })\` at the right path) and wrap the Astro worker with \`withLunora\`, or \`/_lunora/*\` (Lunora realtime) will be unrouted:
+
+${i}`);return}let s;try{s=c(a,"utf8")}catch(r){const l=r instanceof Error?r.message:String(r);n(`@lunora/astro: could not read server entry "${t}" (${l}) — skipping the \`withLunora\` check.`);return}d.test(s)||n(`@lunora/astro: couldn't find a \`withLunora(...)\` call in the server entry "${t}" — \`/_lunora/*\` (Lunora realtime) will be unrouted and subscriptions will silently 404. Wrap the Astro worker:
+
+${i}`)}},name:"@lunora/astro"}};export{m as lunora};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/astro",
-  "version": "1.0.0-alpha.61",
+  "version": "1.0.0-alpha.63",
   "description": "Astro integration for Lunora — single-worker composition plus reactive-loader server helpers",
   "keywords": [
     "astro",
@@ -50,8 +50,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.35",
-    "@lunora/runtime": "1.0.0-alpha.49"
+    "@lunora/client": "1.0.0-alpha.36",
+    "@lunora/runtime": "1.0.0-alpha.51"
   },
   "peerDependencies": {
     "astro": ">=6.0.0"

package/dist/packem_shared/lunora-DR6Obxyg.mjs

@@ -1 +0,0 @@
-const t=(r={})=>{const o=(r.serverEntry??"src/worker.ts").trim();return{hooks:{"astro:config:done":()=>{if(o.length===0)throw new TypeError("@lunora/astro: `serverEntry` must be a non-empty path.")}},name:"@lunora/astro"}};export{t as lunora};