@lunora/astro 1.0.0-alpha.4 → 1.0.0-alpha.40

package/LICENSE.md

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/README.md

@@ -98,6 +98,24 @@ const preloaded = await preloadQuery(client, api.messages.list, {});
 <my-island data-preloaded={serializePreloaded(preloaded)}></my-island>
 ```
 
+### Feature flags
+
+`@lunora/astro` ships no flag hook — like every other surface, flags follow the same server/island split. Read `ctx.flags` server-side (a server endpoint, a function, or the same `.astro` frontmatter) and hand the resolved value to the island, or call `useFlag` inside the island itself via the adapter you hydrate with (`@lunora/react`, `@lunora/vue`, …). Requires [`@lunora/flags`](https://www.npmjs.com/package/@lunora/flags) wired in `lunora/flags.ts`.
+
+```astro
+---
+// src/pages/index.astro — resolve the flag once, server-side
+import { createServerClient, preloadQuery, preloadedQueryResult } from "@lunora/astro/server";
+import { api } from "../lunora/_generated/api";
+
+const client = createServerClient({ url: Astro.url.origin + "/_lunora/rpc" });
+const preloaded = await preloadQuery(client, api.homepage.heroFlag, {}); // a query that returns ctx.flags.boolean(...)
+const newHero = preloadedQueryResult(preloaded);
+---
+
+{newHero ? <NewHero client:load /> : <ClassicHero client:load />}
+```
+
 > This README covers the basics. For the full API, options, and guides, see the **[documentation](https://lunora.sh/docs/frameworks/bring-your-framework)**.
 
 ## Related

package/dist/index.d.mts

@@ -1,27 +1,27 @@
 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.
-*/
+ * 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
-* from a specific Astro major and type-checks even when `astro` is not installed
-* — `astro` is an *optional* peer here (only the host Astro app pulls it in).
-* The shape is assignable to/from Astro's real `AstroIntegration`, so adding the
-* returned object to `integrations` type-checks in a real Astro project.
-*/
+ * Structural subset of Astro's `AstroIntegration`. Declared locally (rather than
+ * importing `astro`'s type) so `@lunora/astro`'s public surface stays decoupled
+ * from a specific Astro major and type-checks even when `astro` is not installed
+ * — `astro` is an *optional* peer here (only the host Astro app pulls it in).
+ * The shape is assignable to/from Astro's real `AstroIntegration`, so adding the
+ * returned object to `integrations` type-checks in a real Astro project.
+ */
 interface AstroIntegrationLike {
   readonly hooks: {
     readonly [hook: string]: ((...arguments_: never[]) => unknown) | undefined;
@@ -31,41 +31,41 @@ interface AstroIntegrationLike {
 /** Options for the `lunora` integration. */
 interface LunoraIntegrationOptions {
   /**
-  * Path (or specifier) of the module that calls `withLunora` and is the
-  * composed worker's `export default`. Documented for the wiring story; when
-  * omitted the integration assumes the conventional `src/worker.ts`.
-  */
+   * Path (or specifier) of the module that calls `withLunora` and is the
+   * composed worker's `export default`. Documented for the wiring story; when
+   * omitted the integration assumes the conventional `src/worker.ts`.
+   */
   readonly serverEntry?: string;
 }
 /**
-* The Lunora Astro integration. Add it to `astro.config.*`:
-*
-* ```ts
-* import cloudflare from "@astrojs/cloudflare";
-* import { defineConfig } from "astro/config";
-* import { lunora } from "@lunora/astro";
-*
-* export default defineConfig({
-*   output: "server",
-*   adapter: cloudflare(),
-*   integrations: [lunora()],
-* });
-* ```
-*
-* 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.
-*
-* 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.
-*/
+ * The Lunora Astro integration. Add it to `astro.config.*`:
+ *
+ * ```ts
+ * import cloudflare from "@astrojs/cloudflare";
+ * import { defineConfig } from "astro/config";
+ * import { lunora } from "@lunora/astro";
+ *
+ * export default defineConfig({
+ *   output: "server",
+ *   adapter: cloudflare(),
+ *   integrations: [lunora()],
+ * });
+ * ```
+ *
+ * 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.
+ *
+ * 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.
+ */
 declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
 export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.d.ts

@@ -1,27 +1,27 @@
 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.
-*/
+ * 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
-* from a specific Astro major and type-checks even when `astro` is not installed
-* — `astro` is an *optional* peer here (only the host Astro app pulls it in).
-* The shape is assignable to/from Astro's real `AstroIntegration`, so adding the
-* returned object to `integrations` type-checks in a real Astro project.
-*/
+ * Structural subset of Astro's `AstroIntegration`. Declared locally (rather than
+ * importing `astro`'s type) so `@lunora/astro`'s public surface stays decoupled
+ * from a specific Astro major and type-checks even when `astro` is not installed
+ * — `astro` is an *optional* peer here (only the host Astro app pulls it in).
+ * The shape is assignable to/from Astro's real `AstroIntegration`, so adding the
+ * returned object to `integrations` type-checks in a real Astro project.
+ */
 interface AstroIntegrationLike {
   readonly hooks: {
     readonly [hook: string]: ((...arguments_: never[]) => unknown) | undefined;
@@ -31,41 +31,41 @@ interface AstroIntegrationLike {
 /** Options for the `lunora` integration. */
 interface LunoraIntegrationOptions {
   /**
-  * Path (or specifier) of the module that calls `withLunora` and is the
-  * composed worker's `export default`. Documented for the wiring story; when
-  * omitted the integration assumes the conventional `src/worker.ts`.
-  */
+   * Path (or specifier) of the module that calls `withLunora` and is the
+   * composed worker's `export default`. Documented for the wiring story; when
+   * omitted the integration assumes the conventional `src/worker.ts`.
+   */
   readonly serverEntry?: string;
 }
 /**
-* The Lunora Astro integration. Add it to `astro.config.*`:
-*
-* ```ts
-* import cloudflare from "@astrojs/cloudflare";
-* import { defineConfig } from "astro/config";
-* import { lunora } from "@lunora/astro";
-*
-* export default defineConfig({
-*   output: "server",
-*   adapter: cloudflare(),
-*   integrations: [lunora()],
-* });
-* ```
-*
-* 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.
-*
-* 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.
-*/
+ * The Lunora Astro integration. Add it to `astro.config.*`:
+ *
+ * ```ts
+ * import cloudflare from "@astrojs/cloudflare";
+ * import { defineConfig } from "astro/config";
+ * import { lunora } from "@lunora/astro";
+ *
+ * export default defineConfig({
+ *   output: "server",
+ *   adapter: cloudflare(),
+ *   integrations: [lunora()],
+ * });
+ * ```
+ *
+ * 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.
+ *
+ * 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.
+ */
 declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
 export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-export { lunora } from './packem_shared/lunora-DCkPGEVa.mjs';
+export { lunora } from './packem_shared/lunora-BPXRQkP4.mjs';
 export { withFrameworkWorker as withLunora } from '@lunora/runtime';

package/dist/packem_shared/{lunora-DCkPGEVa.mjs → lunora-BPXRQkP4.mjs}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/astro",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.40",
   "description": "Astro integration for Lunora — single-worker composition plus reactive-loader server helpers",
   "keywords": [
     "astro",
@@ -25,7 +25,7 @@
     "directory": "packages/astro"
   },
   "files": [
-    "dist",
+    "./dist",
     "README.md",
     "LICENSE.md",
     "__assets__"
@@ -50,8 +50,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.2",
-    "@lunora/runtime": "1.0.0-alpha.3"
+    "@lunora/client": "1.0.0-alpha.25",
+    "@lunora/runtime": "1.0.0-alpha.29"
   },
   "peerDependencies": {
     "astro": "^6.0.0"