@lunora/nuxt 1.0.0-alpha.111 → 1.0.0-alpha.112

package/dist/module.d.mts

@@ -11,6 +11,50 @@ import { defineNuxtModule } from '@nuxt/kit';
  * otherwise-valid build") and the `@lunora/astro` precedent this mirrors.
  */
 declare const checkWorkerEntry: (rootDirectory: string, warn: (message: string) => void) => void;
+/**
+ * One entry of Nuxt's resolved plugin list (`app.plugins` at `app:resolve`):
+ * an absolute `src` plus the `mode` Nuxt derived for it. Declared structurally
+ * for the same reason as {@link LunoraNuxtModule} — `@nuxt/schema`, which owns
+ * `NuxtPlugin`, is not a resolvable dependency here — and `NuxtPlugin[]`
+ * satisfies it.
+ */
+interface ResolvedNuxtPlugin {
+  mode?: "all" | "client" | "server";
+  src: string;
+}
+/**
+ * Warn when the project's ONLY `LunoraClient` provider is a client-only plugin.
+ *
+ * `@lunora/vue`'s composables call `useLunora()` unconditionally — ahead of
+ * their own browser guard — and it throws when nothing is injected. A
+ * `plugins/lunora.client.ts` by definition never runs on the server, so the
+ * first server-rendered page touching Lunora answers 500 with
+ * `useLunora(): no LunoraClient provided`. The fix is dropping `.client` from
+ * the filename plus a universal way to read the origin, which the warning says.
+ *
+ * Takes Nuxt's own resolved plugin list (`app.plugins`, from the `app:resolve`
+ * hook) rather than scanning `plugins/` itself. That is the whole point: Nuxt
+ * loads plugins with a two-pattern, ONE-level glob — top-level entries plus a
+ * subdirectory's `index` file — over every layer's configured plugins dir, so
+ * a filesystem scan of its own has to mirror the glob, the extension list,
+ * `dir.plugins` and every layer — and gets the answer WRONG in both directions
+ * when it doesn't. A recursive scan counts `plugins/lib/make-client.ts` (an
+ * ordinary colocated helper Nuxt never loads) as a universal provider and goes
+ * silent on a genuinely broken app. Reading `mode` off the resolved entry also
+ * drops the `.client` filename rule, since that is what Nuxt derived it from.
+ *
+ * Detection of the provider itself is the same shape as
+ * {@link looksLikeShardDoExport}: a documented keyword test, not a TS parse,
+ * because the outcome is a build-time warning. Its imprecision is a
+ * `createLunora` mention inside a comment, whose only cost is a warning
+ * pointing at a file that is already about the client.
+ *
+ * Silence requires a provider Nuxt loads on the server — `mode` `"all"` or
+ * `"server"` — not merely a working app: an app that confines every Lunora
+ * usage to `<ClientOnly>` is correct with a client-only provider and still
+ * warns, which is why the message names that case as a reason to ignore it.
+ */
+declare const checkClientOnlyProvider: (plugins: ReadonlyArray<ResolvedNuxtPlugin>, warn: (message: string) => void) => void;
 /** Options for the `@lunora/nuxt` module (configurable under the `lunora` key in `nuxt.config`). */
 interface ModuleOptions {
   /**
@@ -31,4 +75,4 @@ type LunoraNuxtModule = typeof defineNuxtModule<ModuleOptions> extends {
   (): unknown;
 } ? Result : never;
 declare const lunoraNuxtModule: LunoraNuxtModule;
-export { ModuleOptions, checkWorkerEntry, lunoraNuxtModule as default };
+export { ModuleOptions, ResolvedNuxtPlugin, checkClientOnlyProvider, checkWorkerEntry, lunoraNuxtModule as default };

package/dist/module.d.ts

@@ -11,6 +11,50 @@ import { defineNuxtModule } from '@nuxt/kit';
  * otherwise-valid build") and the `@lunora/astro` precedent this mirrors.
  */
 declare const checkWorkerEntry: (rootDirectory: string, warn: (message: string) => void) => void;
+/**
+ * One entry of Nuxt's resolved plugin list (`app.plugins` at `app:resolve`):
+ * an absolute `src` plus the `mode` Nuxt derived for it. Declared structurally
+ * for the same reason as {@link LunoraNuxtModule} — `@nuxt/schema`, which owns
+ * `NuxtPlugin`, is not a resolvable dependency here — and `NuxtPlugin[]`
+ * satisfies it.
+ */
+interface ResolvedNuxtPlugin {
+  mode?: "all" | "client" | "server";
+  src: string;
+}
+/**
+ * Warn when the project's ONLY `LunoraClient` provider is a client-only plugin.
+ *
+ * `@lunora/vue`'s composables call `useLunora()` unconditionally — ahead of
+ * their own browser guard — and it throws when nothing is injected. A
+ * `plugins/lunora.client.ts` by definition never runs on the server, so the
+ * first server-rendered page touching Lunora answers 500 with
+ * `useLunora(): no LunoraClient provided`. The fix is dropping `.client` from
+ * the filename plus a universal way to read the origin, which the warning says.
+ *
+ * Takes Nuxt's own resolved plugin list (`app.plugins`, from the `app:resolve`
+ * hook) rather than scanning `plugins/` itself. That is the whole point: Nuxt
+ * loads plugins with a two-pattern, ONE-level glob — top-level entries plus a
+ * subdirectory's `index` file — over every layer's configured plugins dir, so
+ * a filesystem scan of its own has to mirror the glob, the extension list,
+ * `dir.plugins` and every layer — and gets the answer WRONG in both directions
+ * when it doesn't. A recursive scan counts `plugins/lib/make-client.ts` (an
+ * ordinary colocated helper Nuxt never loads) as a universal provider and goes
+ * silent on a genuinely broken app. Reading `mode` off the resolved entry also
+ * drops the `.client` filename rule, since that is what Nuxt derived it from.
+ *
+ * Detection of the provider itself is the same shape as
+ * {@link looksLikeShardDoExport}: a documented keyword test, not a TS parse,
+ * because the outcome is a build-time warning. Its imprecision is a
+ * `createLunora` mention inside a comment, whose only cost is a warning
+ * pointing at a file that is already about the client.
+ *
+ * Silence requires a provider Nuxt loads on the server — `mode` `"all"` or
+ * `"server"` — not merely a working app: an app that confines every Lunora
+ * usage to `<ClientOnly>` is correct with a client-only provider and still
+ * warns, which is why the message names that case as a reason to ignore it.
+ */
+declare const checkClientOnlyProvider: (plugins: ReadonlyArray<ResolvedNuxtPlugin>, warn: (message: string) => void) => void;
 /** Options for the `@lunora/nuxt` module (configurable under the `lunora` key in `nuxt.config`). */
 interface ModuleOptions {
   /**
@@ -31,4 +75,4 @@ type LunoraNuxtModule = typeof defineNuxtModule<ModuleOptions> extends {
   (): unknown;
 } ? Result : never;
 declare const lunoraNuxtModule: LunoraNuxtModule;
-export { ModuleOptions, checkWorkerEntry, lunoraNuxtModule as default };
+export { ModuleOptions, ResolvedNuxtPlugin, checkClientOnlyProvider, checkWorkerEntry, lunoraNuxtModule as default };

package/dist/module.json

@@ -1,5 +1,5 @@
 {
   "configKey": "lunora",
   "name": "@lunora/nuxt",
-  "version": "1.0.0-alpha.110"
+  "version": "1.0.0-alpha.111"
 }

package/dist/module.mjs

@@ -1 +1 @@
-import{existsSync as i,readFileSync as u}from"node:fs";import{join as s,resolve as d,dirname as p}from"node:path";import{defineNuxtModule as h,createResolver as c,addServerHandler as m,useLogger as f}from"@nuxt/kit";const S=(r,t,o)=>r.startsWith("~~/")?s(t,r.slice(3)):r.startsWith("~/")?s(o,r.slice(2)):r.startsWith("./")||r.startsWith("../")?s(t,r):r,v=/\.js$/,D=r=>{const t=s(r,"lunora");return{name:"lunora:nitro-ts-source-resolve",resolveId:{handler(o,e){if(!o.endsWith(".js"))return;let n;if(o.startsWith("#lunora/")?n=s(t,o.slice(8)):o.startsWith(".")&&e!==void 0&&(n=d(p(e),o)),n===void 0)return;const a=n.replace(v,".ts");return i(a)?a:void 0},order:"pre"}}},l='export { default } from "./.output/server/index.mjs"; export { ShardDO } from "./lunora/server";',E=/\bexport\b/u,R=/\bShardDO\b/u,O=/\bexport\s*\*\s*from\s*["'][^"']*lunora[^"']*["']/u,T=r=>E.test(r)?R.test(r)||O.test(r):!1,g=(r,t)=>{const o=s(r,"worker.ts");if(!i(o)){t(`missing worker.ts at the project root — add a wrapper that re-exports Nitro's handler and \`ShardDO\` (\`${l}\`) and point wrangler's \`main\` at it, so the SHARD Durable Object is exported from the deployed worker.`);return}let e;try{e=u(o,"utf8")}catch(n){const a=n instanceof Error?n.message:String(n);t(`could not read worker.ts at the project root (${a}) — skipping the \`ShardDO\` export check.`);return}T(e)||t(`worker.ts at the project root does not appear to export \`ShardDO\` — add \`export { ShardDO } from "./lunora/server";\` (e.g. \`${l}\`) and point wrangler's \`main\` at it, so the SHARD Durable Object is exported from the deployed worker.`)},_="/_lunora",b=h({defaults:{appEntry:"~/lunora/server"},meta:{configKey:"lunora",name:"@lunora/nuxt"},setup(r,t){const o=c(import.meta.url);t.options.alias["#lunora/app"]=S(r.appEntry,t.options.rootDir,t.options.srcDir),t.hook("nitro:config",e=>{const n=[...e.rollupConfig?.plugins??[],D(t.options.rootDir)];e.rollupConfig={...e.rollupConfig,plugins:n}}),m({handler:o.resolve("./runtime/server/lunora"),route:`${_}/**`}),g(t.options.rootDir,e=>{f("@lunora/nuxt").warn(e)})}});export{g as checkWorkerEntry,b as default};
+import{existsSync as u,readFileSync as d}from"node:fs";import{join as s,resolve as h,dirname as p}from"node:path";import{defineNuxtModule as c,createResolver as v,addServerHandler as f,useLogger as i}from"@nuxt/kit";const m=(r,o,t)=>r.startsWith("~~/")?s(o,r.slice(3)):r.startsWith("~/")?s(t,r.slice(2)):r.startsWith("./")||r.startsWith("../")?s(o,r):r,g=/\.js$/,R=r=>{const o=s(r,"lunora");return{name:"lunora:nitro-ts-source-resolve",resolveId:{handler(t,e){if(!t.endsWith(".js"))return;let n;if(t.startsWith("#lunora/")?n=s(o,t.slice(8)):t.startsWith(".")&&e!==void 0&&(n=h(p(e),t)),n===void 0)return;const a=n.replace(g,".ts");return u(a)?a:void 0},order:"pre"}}},l='export { default } from "./.output/server/index.mjs"; export { ShardDO } from "./lunora/server";',S=/\bexport\b/u,E=/\bShardDO\b/u,D=/\bexport\s*\*\s*from\s*["'][^"']*lunora[^"']*["']/u,O=r=>S.test(r)?E.test(r)||D.test(r):!1,w=(r,o)=>{const t=s(r,"worker.ts");if(!u(t)){o(`missing worker.ts at the project root — add a wrapper that re-exports Nitro's handler and \`ShardDO\` (\`${l}\`) and point wrangler's \`main\` at it, so the SHARD Durable Object is exported from the deployed worker.`);return}let e;try{e=d(t,"utf8")}catch(n){const a=n instanceof Error?n.message:String(n);o(`could not read worker.ts at the project root (${a}) — skipping the \`ShardDO\` export check.`);return}O(e)||o(`worker.ts at the project root does not appear to export \`ShardDO\` — add \`export { ShardDO } from "./lunora/server";\` (e.g. \`${l}\`) and point wrangler's \`main\` at it, so the SHARD Durable Object is exported from the deployed worker.`)},T=/\bcreateLunora\b/u,k=r=>{try{return T.test(d(r,"utf8"))}catch{return!1}},_=(r,o)=>{const t=r.filter(e=>k(e.src));t.length===0||t.some(e=>e.mode!=="client")||o(`the only plugin providing a \`LunoraClient\` is client-only (${t.map(e=>e.src).join(", ")}) — \`@lunora/vue\`'s composables resolve the client during SSR too and throw \`useLunora(): no LunoraClient provided\` without one, so the first server-rendered page that touches Lunora answers 500. Drop the \`.client\` from the filename to make the plugin universal, and read the origin with \`useRequestURL().origin\`, which resolves from the incoming request on the server and from \`window.location\` in the browser. Ignore this if every Lunora usage is confined to \`<ClientOnly>\`, which never renders on the server.`)},y="/_lunora",L=c({defaults:{appEntry:"~/lunora/server"},meta:{configKey:"lunora",name:"@lunora/nuxt"},setup(r,o){const t=v(import.meta.url);o.options.alias["#lunora/app"]=m(r.appEntry,o.options.rootDir,o.options.srcDir),o.hook("nitro:config",e=>{const n=[...e.rollupConfig?.plugins??[],R(o.options.rootDir)];e.rollupConfig={...e.rollupConfig,plugins:n}}),f({handler:t.resolve("./runtime/server/lunora"),route:`${y}/**`}),w(o.options.rootDir,e=>{i("@lunora/nuxt").warn(e)}),o.hook("app:resolve",e=>{_(e.plugins,n=>{i("@lunora/nuxt").warn(n)})})}});export{_ as checkClientOnlyProvider,w as checkWorkerEntry,L as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/nuxt",
-  "version": "1.0.0-alpha.111",
+  "version": "1.0.0-alpha.112",
   "description": "Nuxt module for Lunora — single-worker composition (mounts /_lunora/* into Nitro) plus reactive-loader server helpers",
   "keywords": [
     "cloudflare",
@@ -51,8 +51,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.82",
-    "@lunora/runtime": "1.0.0-alpha.97",
+    "@lunora/client": "1.0.0-alpha.83",
+    "@lunora/runtime": "1.0.0-alpha.98",
     "@nuxt/kit": "^4.5.2"
   },
   "peerDependencies": {