@lunora/vite 1.0.0-alpha.49 → 1.0.0-alpha.50

package/dist/index.d.mts

@@ -257,6 +257,27 @@ declare const buildWorkerEntrySource: (framework: DetectedFramework, generatedIm
 */
 declare const frameworkComposePlugin: (options: ResolvedLunoraPluginOptions, context: LunoraPluginContext) => Plugin;
 /**
+* The custom HMR event the Lunora Vite plugin sends on the client environment's
+* hot channel after a successful codegen run, in place of the old blanket
+* browser `full-reload`. The generated `api`/`server` modules are just
+* `FunctionReference` metadata, so Vite's granular module HMR re-imports the
+* changed `_generated/*` in place; this event is a non-destructive nudge that
+* lets open WebSocket subscriptions, optimistic state, the offline queue, and
+* form state survive a schema save.
+*
+* Kept in its own module (a single source of truth) so the codegen plugin —
+* whose sole export is the plugin factory — can reference it without becoming a
+* mixed default+named module, and so any future client-side listener can agree
+* on the exact string.
+*
+* There is no first-party client listener yet: `@lunora/client` / `@lunora/react`
+* ship as pre-bundled, side-effect-free dependencies where `import.meta.hot` is
+* `undefined` at runtime (Vite's dep optimizer), so a listener there would be
+* dead (and tree-shaken) code. A future app-local or codegen-emitted listener
+* can import this constant to re-validate active queries over the live socket.
+*/
+declare const LUNORA_API_UPDATED_EVENT = "lunora:api-updated";
+/**
 * Vite plugin (serve-only) that formats Lunora worker logs in the terminal.
 * Patches `process.stdout`/`process.stderr` once the dev server is configured
 * and restores them when it closes.
@@ -447,4 +468,4 @@ declare const resolveOverlayOption: (overlay: LunoraPluginOptions["overlay"]) =>
 */
 declare const lunora: (options?: LunoraPluginOptions) => LunoraPlugins;
 declare const VERSION = "0.0.0";
-export { CLASS_A_WIRING, type ClassAWiring, type CloudflarePluginOptions, DEV_WORKER_ENV_VALUE, DEV_WORKER_ENV_VAR, LUNORA_WORKER_VIRTUAL_ID, type LunoraPluginOptions, type LunoraPlugins, type OverlayPluginOptions, type PlanViteRemoteOptions, type ReconcileResult, type ResolvedLunoraPluginOptions, STUDIO_PATH, type Solution, type SolutionFinder, VERSION, type ViteRemotePlan, WORKER_STARTUP_HINT, augmentWorkerStartupError, buildStudioUrl, buildWorkerEntrySource, codegenPlugin, containerLogsPlugin, createCommandProbe, devStatePlugin, devVariablesPlugin, frameworkComposePlugin, isAutoComposable, isWorkerEntryEvalError, logStreamPlugin, lunora, lunoraSolutionFinder, lunoraSolutionFinders, planViteRemoteBindings, reconcileWranglerCrons, remoteBindingsCleanupPlugin, resolveOverlayOption, studioPlugin, withDevWorkerEnv, withRemoteBindings, withWorkerStartupHint, wranglerValidatorPlugin };
+export { CLASS_A_WIRING, type ClassAWiring, type CloudflarePluginOptions, DEV_WORKER_ENV_VALUE, DEV_WORKER_ENV_VAR, LUNORA_API_UPDATED_EVENT, LUNORA_WORKER_VIRTUAL_ID, type LunoraPluginOptions, type LunoraPlugins, type OverlayPluginOptions, type PlanViteRemoteOptions, type ReconcileResult, type ResolvedLunoraPluginOptions, STUDIO_PATH, type Solution, type SolutionFinder, VERSION, type ViteRemotePlan, WORKER_STARTUP_HINT, augmentWorkerStartupError, buildStudioUrl, buildWorkerEntrySource, codegenPlugin, containerLogsPlugin, createCommandProbe, devStatePlugin, devVariablesPlugin, frameworkComposePlugin, isAutoComposable, isWorkerEntryEvalError, logStreamPlugin, lunora, lunoraSolutionFinder, lunoraSolutionFinders, planViteRemoteBindings, reconcileWranglerCrons, remoteBindingsCleanupPlugin, resolveOverlayOption, studioPlugin, withDevWorkerEnv, withRemoteBindings, withWorkerStartupHint, wranglerValidatorPlugin };

package/dist/index.d.ts

@@ -257,6 +257,27 @@ declare const buildWorkerEntrySource: (framework: DetectedFramework, generatedIm
 */
 declare const frameworkComposePlugin: (options: ResolvedLunoraPluginOptions, context: LunoraPluginContext) => Plugin;
 /**
+* The custom HMR event the Lunora Vite plugin sends on the client environment's
+* hot channel after a successful codegen run, in place of the old blanket
+* browser `full-reload`. The generated `api`/`server` modules are just
+* `FunctionReference` metadata, so Vite's granular module HMR re-imports the
+* changed `_generated/*` in place; this event is a non-destructive nudge that
+* lets open WebSocket subscriptions, optimistic state, the offline queue, and
+* form state survive a schema save.
+*
+* Kept in its own module (a single source of truth) so the codegen plugin —
+* whose sole export is the plugin factory — can reference it without becoming a
+* mixed default+named module, and so any future client-side listener can agree
+* on the exact string.
+*
+* There is no first-party client listener yet: `@lunora/client` / `@lunora/react`
+* ship as pre-bundled, side-effect-free dependencies where `import.meta.hot` is
+* `undefined` at runtime (Vite's dep optimizer), so a listener there would be
+* dead (and tree-shaken) code. A future app-local or codegen-emitted listener
+* can import this constant to re-validate active queries over the live socket.
+*/
+declare const LUNORA_API_UPDATED_EVENT = "lunora:api-updated";
+/**
 * Vite plugin (serve-only) that formats Lunora worker logs in the terminal.
 * Patches `process.stdout`/`process.stderr` once the dev server is configured
 * and restores them when it closes.
@@ -447,4 +468,4 @@ declare const resolveOverlayOption: (overlay: LunoraPluginOptions["overlay"]) =>
 */
 declare const lunora: (options?: LunoraPluginOptions) => LunoraPlugins;
 declare const VERSION = "0.0.0";
-export { CLASS_A_WIRING, type ClassAWiring, type CloudflarePluginOptions, DEV_WORKER_ENV_VALUE, DEV_WORKER_ENV_VAR, LUNORA_WORKER_VIRTUAL_ID, type LunoraPluginOptions, type LunoraPlugins, type OverlayPluginOptions, type PlanViteRemoteOptions, type ReconcileResult, type ResolvedLunoraPluginOptions, STUDIO_PATH, type Solution, type SolutionFinder, VERSION, type ViteRemotePlan, WORKER_STARTUP_HINT, augmentWorkerStartupError, buildStudioUrl, buildWorkerEntrySource, codegenPlugin, containerLogsPlugin, createCommandProbe, devStatePlugin, devVariablesPlugin, frameworkComposePlugin, isAutoComposable, isWorkerEntryEvalError, logStreamPlugin, lunora, lunoraSolutionFinder, lunoraSolutionFinders, planViteRemoteBindings, reconcileWranglerCrons, remoteBindingsCleanupPlugin, resolveOverlayOption, studioPlugin, withDevWorkerEnv, withRemoteBindings, withWorkerStartupHint, wranglerValidatorPlugin };
+export { CLASS_A_WIRING, type ClassAWiring, type CloudflarePluginOptions, DEV_WORKER_ENV_VALUE, DEV_WORKER_ENV_VAR, LUNORA_API_UPDATED_EVENT, LUNORA_WORKER_VIRTUAL_ID, type LunoraPluginOptions, type LunoraPlugins, type OverlayPluginOptions, type PlanViteRemoteOptions, type ReconcileResult, type ResolvedLunoraPluginOptions, STUDIO_PATH, type Solution, type SolutionFinder, VERSION, type ViteRemotePlan, WORKER_STARTUP_HINT, augmentWorkerStartupError, buildStudioUrl, buildWorkerEntrySource, codegenPlugin, containerLogsPlugin, createCommandProbe, devStatePlugin, devVariablesPlugin, frameworkComposePlugin, isAutoComposable, isWorkerEntryEvalError, logStreamPlugin, lunora, lunoraSolutionFinder, lunoraSolutionFinders, planViteRemoteBindings, reconcileWranglerCrons, remoteBindingsCleanupPlugin, resolveOverlayOption, studioPlugin, withDevWorkerEnv, withRemoteBindings, withWorkerStartupHint, wranglerValidatorPlugin };

package/dist/index.mjs

@@ -3,7 +3,7 @@ import errorOverlayPlugin from '@visulima/vite-overlay';
 import { detectAgentRules, claimAgentRulesHint, AGENT_RULES_HINT, detectFramework } from '@lunora/config';
 export { detectFramework } from '@lunora/config';
 import { l as lunoraLine } from './packem_shared/log-BjO9EWah.mjs';
-import codegenPlugin from './packem_shared/codegenPlugin-CC4MeBmj.mjs';
+import codegenPlugin from './packem_shared/codegenPlugin-3AqQzOq0.mjs';
 import containerLogsPlugin from './packem_shared/containerLogsPlugin-DMssU3wb.mjs';
 import devStatePlugin from './packem_shared/devStatePlugin-D7Qc2gKr.mjs';
 import devVariablesPlugin from './packem_shared/devVariablesPlugin-CDNSnvOP.mjs';
@@ -21,6 +21,7 @@ import { withWorkerStartupHint } from './packem_shared/WORKER_STARTUP_HINT-DhsXU
 export { WORKER_STARTUP_HINT, augmentWorkerStartupError, isWorkerEntryEvalError } from './packem_shared/WORKER_STARTUP_HINT-DhsXUW8k.mjs';
 import { wranglerValidatorPlugin } from './packem_shared/wranglerValidatorPlugin-C5VWOD7N.mjs';
 export { reconcileWranglerCrons } from './packem_shared/reconcileWranglerCrons-PxGwfCp_.mjs';
+export { default as LUNORA_API_UPDATED_EVENT } from './packem_shared/LUNORA_API_UPDATED_EVENT-BrkWk3rr.mjs';
 
 const agentRulesHintPlugin = (options) => {
   return {

package/dist/packem_shared/LUNORA_API_UPDATED_EVENT-BrkWk3rr.mjs

@@ -0,0 +1,3 @@
+const LUNORA_API_UPDATED_EVENT = "lunora:api-updated";
+
+export { LUNORA_API_UPDATED_EVENT as default };

package/dist/packem_shared/{codegenPlugin-CC4MeBmj.mjs → codegenPlugin-3AqQzOq0.mjs}

@@ -1,10 +1,45 @@
 import { existsSync } from 'node:fs';
-import { resolve, sep, join } from 'node:path';
+import { join, resolve, sep, basename } from 'node:path';
 import { createCodegenProject, refreshCodegenProject, runCodegen, CodegenDiagnosticError } from '@lunora/codegen';
-import { collectWranglerSecretVariables, inferLunoraBindings, reconcileWranglerBindings } from '@lunora/config';
+import { findWranglerFile, LUNORA_CONFIG_FILE, readWranglerJsonc, WRANGLER_FILES, collectWranglerSecretVariables, inferLunoraBindings, reconcileWranglerBindings } from '@lunora/config';
+import { isRunnableDevEnvironment } from 'vite';
 import { reconcileWranglerCrons } from './reconcileWranglerCrons-PxGwfCp_.mjs';
+import LUNORA_API_UPDATED_EVENT from './LUNORA_API_UPDATED_EVENT-BrkWk3rr.mjs';
 import { L as LUNORA_TAG, a as advisoryLine } from './log-BjO9EWah.mjs';
 
+const fingerprintJsonc = (filePath, normalize) => {
+  try {
+    const { parsed, text } = readWranglerJsonc(filePath);
+    if (parsed === void 0) {
+      return `raw:${text}`;
+    }
+    return JSON.stringify(normalize ? normalize(parsed) : parsed);
+  } catch {
+    return "unreadable";
+  }
+};
+const stripCodegenOwnedCrons = (parsed) => {
+  const clone = { ...parsed };
+  const { triggers } = clone;
+  if (triggers !== null && typeof triggers === "object") {
+    const restTriggers = { ...triggers };
+    delete restTriggers.crons;
+    if (Object.keys(restTriggers).length > 0) {
+      clone.triggers = restTriggers;
+    } else {
+      delete clone.triggers;
+    }
+  }
+  return clone;
+};
+const computeConfigFingerprint = (projectRoot) => {
+  const wranglerFile = findWranglerFile(projectRoot);
+  const wranglerPart = wranglerFile === void 0 ? "absent" : fingerprintJsonc(wranglerFile, stripCodegenOwnedCrons);
+  const lunoraConfigPath = join(projectRoot, LUNORA_CONFIG_FILE);
+  const lunoraPart = existsSync(lunoraConfigPath) ? fingerprintJsonc(lunoraConfigPath) : "absent";
+  return `${wranglerPart}\0${lunoraPart}`;
+};
+
 const DEBOUNCE_MS = 100;
 const TSCONFIG_VARIANT_RE = /[/\\]tsconfig\..+\.json$/u;
 const formatExportGapOverlay = (gaps) => {
@@ -77,11 +112,36 @@ const runCodegenSafely = (options, logger, overlay, project) => {
     return void 0;
   }
 };
+const notifyEnvironmentsAfterCodegen = (server, changedFile, clearErrorOverlay) => {
+  let clientEnvironment;
+  for (const [name, environment] of Object.entries(server.environments)) {
+    if (name === "client") {
+      clientEnvironment = environment;
+      continue;
+    }
+    if (isRunnableDevEnvironment(environment)) {
+      continue;
+    }
+    environment.hot.send({ path: "*", triggeredBy: changedFile, type: "full-reload" });
+  }
+  if (clientEnvironment === void 0) {
+    server.hot.send({ type: "full-reload" });
+    return;
+  }
+  if (clearErrorOverlay) {
+    clientEnvironment.hot.send({ type: "full-reload" });
+    return;
+  }
+  clientEnvironment.hot.send({ event: LUNORA_API_UPDATED_EVENT, type: "custom" });
+};
 const codegenPlugin = (options) => {
   const absoluteSchemaDirectory = resolve(options.projectRoot, options.schemaDir);
   let absoluteGeneratedDirectory = resolve(options.projectRoot, options.generatedDir);
   let debounceTimer;
   let devServer;
+  let configFingerprint;
+  let configBaselineSettled = false;
+  let restartInFlight = false;
   return {
     async buildStart() {
       const logger = {
@@ -105,10 +165,16 @@ const codegenPlugin = (options) => {
           type: "error"
         });
       });
+      if (devServer !== void 0) {
+        configFingerprint = computeConfigFingerprint(options.projectRoot);
+        configBaselineSettled = true;
+      }
     },
     configureServer(server) {
       devServer = server;
       server.watcher.add(absoluteSchemaDirectory);
+      configFingerprint = computeConfigFingerprint(options.projectRoot);
+      configBaselineSettled = false;
       const serverLogger = {
         error: (message) => {
           server.config.logger.error(message);
@@ -120,8 +186,10 @@ const codegenPlugin = (options) => {
           server.config.logger.warn(message);
         }
       };
+      let hadErrorOverlay = false;
       const overlay = {
         onError(error, message) {
+          hadErrorOverlay = true;
           const loc = error instanceof CodegenDiagnosticError ? { column: error.column, file: error.file, line: error.line } : void 0;
           const overlayMessage = loc === void 0 ? `[lunora] codegen failed: ${message}
 (see terminal for full stack trace and file location)` : `[lunora] codegen failed: ${message}`;
@@ -186,12 +254,55 @@ const codegenPlugin = (options) => {
           }
           absoluteGeneratedDirectory = outputDirectory;
           invalidateGenerated();
-          server.hot.send({ type: "full-reload" });
+          notifyEnvironmentsAfterCodegen(server, normalized, hadErrorOverlay);
+          hadErrorOverlay = false;
         }, DEBOUNCE_MS);
       };
       server.watcher.on("add", onChange);
       server.watcher.on("change", onChange);
       server.watcher.on("unlink", onChange);
+      const configWatchPaths = /* @__PURE__ */ new Set([
+        ...WRANGLER_FILES.map((name) => resolve(options.projectRoot, name)),
+        resolve(options.projectRoot, LUNORA_CONFIG_FILE)
+      ]);
+      for (const configPath of configWatchPaths) {
+        server.watcher.add(configPath);
+      }
+      const onConfigChange = (file) => {
+        if (!configWatchPaths.has(resolve(file))) {
+          return;
+        }
+        if (restartInFlight) {
+          return;
+        }
+        const nextFingerprint = computeConfigFingerprint(options.projectRoot);
+        if (!configBaselineSettled) {
+          configFingerprint = nextFingerprint;
+          return;
+        }
+        if (configFingerprint === void 0) {
+          configFingerprint = nextFingerprint;
+          return;
+        }
+        if (nextFingerprint === configFingerprint) {
+          return;
+        }
+        configFingerprint = nextFingerprint;
+        restartInFlight = true;
+        server.config.logger.info(`${LUNORA_TAG} ${basename(resolve(file))} changed — restarting dev server`);
+        Promise.resolve(server.restart()).finally(() => {
+          restartInFlight = false;
+        }).catch((error) => {
+          const message = error instanceof Error ? error.message : String(error);
+          server.config.logger.error(
+            `${LUNORA_TAG} dev server restart failed: ${message} — keeping the running server; re-save your config to retry.`
+          );
+          server.hot.send({ err: { loc: void 0, message: `[lunora] dev server restart failed: ${message}`, stack: "" }, type: "error" });
+        });
+      };
+      server.watcher.on("add", onConfigChange);
+      server.watcher.on("change", onConfigChange);
+      server.watcher.on("unlink", onConfigChange);
       return () => {
         server.httpServer?.once("close", () => {
           closed = true;
@@ -203,6 +314,9 @@ const codegenPlugin = (options) => {
           server.watcher.off("add", onChange);
           server.watcher.off("change", onChange);
           server.watcher.off("unlink", onChange);
+          server.watcher.off("add", onConfigChange);
+          server.watcher.off("change", onConfigChange);
+          server.watcher.off("unlink", onConfigChange);
         });
       };
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/vite",
-  "version": "1.0.0-alpha.49",
+  "version": "1.0.0-alpha.50",
   "description": "The Lunora Vite plugin: codegen, type sync, wrangler validation, and an error overlay over @cloudflare/vite-plugin",
   "keywords": [
     "cloudflare",
@@ -46,15 +46,15 @@
   },
   "dependencies": {
     "@cloudflare/vite-plugin": "1.42.3",
-    "@lunora/codegen": "1.0.0-alpha.30",
-    "@lunora/config": "1.0.0-alpha.49",
+    "@lunora/codegen": "1.0.0-alpha.32",
+    "@lunora/config": "1.0.0-alpha.50",
     "@lunora/errors": "1.0.0-alpha.1",
     "@visulima/vite-overlay": "2.0.0-alpha.35",
     "jsonc-parser": "^3.3.1",
     "ts-morph": "^28.0.0"
   },
   "peerDependencies": {
-    "@lunora/studio": "1.0.0-alpha.34",
+    "@lunora/studio": "1.0.0-alpha.35",
     "vite": "^8.1.0"
   },
   "peerDependenciesMeta": {