@lunora/astro 0.0.0 → 1.0.0-alpha.1

package/dist/index.d.mts

@@ -0,0 +1,71 @@
+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
+* 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;
+  };
+  readonly name: string;
+}
+/** 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`.
+  */
+  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.
+*/
+declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
+export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+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
+* 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;
+  };
+  readonly name: string;
+}
+/** 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`.
+  */
+  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.
+*/
+declare const lunora: (options?: LunoraIntegrationOptions) => AstroIntegrationLike;
+export { type AstroIntegrationLike, type LunoraIntegrationOptions, lunora };

package/dist/index.mjs

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

package/dist/packem_shared/lunora-DCkPGEVa.mjs

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

package/dist/server.d.mts

@@ -0,0 +1 @@
+export { type ArgsOf, type AuthLike, type FunctionReference, type HeadersSource, type Preloaded, type ReturnOf, type ServerClientOptions, type ServerSession, createServerClient, deserializePreloaded, getServerSession, preloadQuery, preloadedQueryResult, serializePreloaded } from '@lunora/client/ssr';

package/dist/server.d.ts

@@ -0,0 +1 @@
+export { type ArgsOf, type AuthLike, type FunctionReference, type HeadersSource, type Preloaded, type ReturnOf, type ServerClientOptions, type ServerSession, createServerClient, deserializePreloaded, getServerSession, preloadQuery, preloadedQueryResult, serializePreloaded } from '@lunora/client/ssr';

package/dist/server.mjs

@@ -0,0 +1 @@
+export { createServerClient, deserializePreloaded, getServerSession, preloadQuery, preloadedQueryResult, serializePreloaded } from '@lunora/client/ssr';

package/package.json

@@ -1,31 +1,67 @@
 {
   "name": "@lunora/astro",
-  "version": "0.0.0",
+  "version": "1.0.0-alpha.1",
   "description": "Astro integration for Lunora — single-worker composition plus reactive-loader server helpers",
-  "license": "FSL-1.1-Apache-2.0",
+  "keywords": [
+    "astro",
+    "cloudflare",
+    "durable-objects",
+    "integration",
+    "lunora",
+    "realtime",
+    "ssr",
+    "workers"
+  ],
   "homepage": "https://lunora.sh",
+  "bugs": "https://github.com/anolilab/lunora/issues",
+  "license": "FSL-1.1-Apache-2.0",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/anolilab/lunora.git",
     "directory": "packages/astro"
   },
-  "bugs": {
-    "url": "https://github.com/anolilab/lunora/issues"
-  },
-  "keywords": [
-    "lunora",
-    "cloudflare",
-    "workers",
-    "durable-objects",
-    "astro",
-    "integration",
-    "ssr",
-    "realtime"
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md",
+    "__assets__"
   ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.mjs"
+    },
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
   },
-  "files": [
-    "README.md"
-  ]
+  "dependencies": {
+    "@lunora/client": "1.0.0-alpha.1",
+    "@lunora/runtime": "1.0.0-alpha.1"
+  },
+  "peerDependencies": {
+    "astro": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^22.15.0 || >=24.11.0"
+  }
 }