@lunora/rspack 0.0.0 → 1.0.0-alpha.10

package/dist/index.d.mts

@@ -0,0 +1,137 @@
+import { R as ResolvedLunoraRspackOptions, L as LunoraRspackOptions } from "./packem_shared/types.d-DcuVeaxB.mjs";
+import '@lunora/codegen';
+/**
+ * The slice of the Rspack compiler this plugin touches, projected structurally.
+ *
+ * `@rspack/core` is an OPTIONAL peer here, so its `Compiler` type must not appear
+ * in the emitted `.d.ts` — a consumer without it installed would fail to resolve
+ * the reference. Projecting only what we tap also makes the plugin work unchanged
+ * under webpack 5, whose plugin API these members come from.
+ *
+ * A projection is only safe while it stays a real subset of the thing it
+ * projects, and a renamed hook or a reshaped dependency set upstream would
+ * silently stop it being one — this package would keep compiling and fail at the
+ * first `rspack build`. `__tests__/compiler-projection.test.ts` asserts a real
+ * `Compiler`/`Compilation` still satisfies every member below, so that drift is a
+ * type error here rather than a runtime one in a user's project.
+ */
+/** A `lite-tapable` async hook, narrowed to the `tapPromise` registration we use. */
+interface AsyncTapHook<T> {
+  tapPromise: (name: string, callback: (value: T) => Promise<void>) => void;
+}
+/** The mutable dependency set a compilation exposes for watch invalidation. */
+interface DependencySet {
+  add: (dependency: string) => void;
+}
+/** The slice of `Compilation` this plugin reads or mutates. */
+interface CompilationLike {
+  /** Directories whose contents invalidate this compilation when they change. */
+  contextDependencies: DependencySet;
+  /**
+   * Build errors. Pushing here fails the build — `stats.hasErrors()` goes true,
+   * assets are not emitted, and the CLI exits non-zero — WITHOUT aborting a
+   * watch session, which is why every blocking finding this plugin reports goes
+   * here rather than out of a rejected hook.
+   */
+  errors: Error[];
+  /** Individual files that invalidate this compilation when they change. */
+  fileDependencies: DependencySet;
+}
+/** The slice of `Compiler` this plugin taps. */
+interface CompilerLike {
+  hooks: {
+    /** After each compilation seals — where dependencies and findings are registered. */
+    afterCompile: AsyncTapHook<CompilationLike>;
+    /** Before each compilation — where codegen runs, so the build sees fresh output. */
+    beforeCompile: AsyncTapHook<unknown>;
+  };
+  /**
+   * `true` under `compiler.watch()`, `false` for a one-shot `compiler.run()`.
+   *
+   * Only ever read from INSIDE a hook callback. `apply()` runs during
+   * `createCompiler()`, before `watch()` assigns this — read at tap time it is
+   * unconditionally `false`, which silently inverts every decision that depends
+   * on it.
+   */
+  watchMode?: boolean;
+}
+/**
+ * The Rspack (and webpack 5) plugin: runs `@lunora/codegen` before every
+ * compilation, provisions the Cloudflare bindings the code implies into
+ * `wrangler.jsonc`, and validates that config.
+ *
+ * Everything hangs off two hooks. `beforeCompile` carries the startup and
+ * regeneration pass, so a compilation never reads a stale `_generated/*`.
+ * `afterCompile` registers the watch dependencies and reports whatever the pass
+ * found into `compilation.errors`.
+ *
+ * **Findings are reported, never thrown.** A rejected hook takes a watch session
+ * down with it; `compilation.errors` fails a one-shot build just as hard (assets
+ * are not emitted and the CLI exits non-zero) while leaving the watcher up to
+ * regenerate on the next save. That is what lets one code path serve both modes,
+ * and `compiler.watchMode` then decides only whether a *schema advisory* is worth
+ * failing over — a production build refuses one, exactly as `vite build` and
+ * `lunora deploy` do, and a watch rebuild logs it and carries on.
+ */
+declare class LunoraRspackPlugin {
+  #private;
+  constructor(options: ResolvedLunoraRspackOptions);
+  /**
+   * Run the once-per-session dev preparation (`.dev.vars` scaffolding, the
+   * agent-rules hint) and mark the session started.
+   *
+   * Public because ORDER matters and only the caller knows it: wrangler reads
+   * `.dev.vars` once, while resolving bindings at startup. A host that spawns
+   * the Worker — `@lunora/rspack/rsbuild` does, from `onBeforeStartDevServer`,
+   * which Rsbuild runs before the first compilation — must therefore await this
+   * first, or the very first `rsbuild dev` after a fresh clone boots a Worker
+   * with every secret `undefined`. That surfaces as auth failures rather than a
+   * clear error, and the SECOND run works, because `.dev.vars` is on disk by
+   * then. Neither creating the file nor rewriting `wrangler.jsonc` afterwards
+   * rescues the running process.
+   *
+   * Idempotent: the pass below sees `#started` and skips its own call.
+   */
+  prepareDevSession(): Promise<void>;
+  /**
+   * Run a watch-mode codegen pass now, ahead of the first compilation.
+   *
+   * Public for the same ordering reason as {@link prepareDevSession}: the
+   * Worker `@lunora/rspack/rsbuild` spawns is bundled by `wrangler dev` at
+   * startup, and it imports `_generated/app` — which, on a fresh clone, only
+   * this pass writes. Spawned first, wrangler dies on an unresolvable import
+   * before the first compilation ever generates it. The first compilation then
+   * finds the fingerprint unchanged and skips its own pass.
+   */
+  generateForDev(): Promise<void>;
+  /** Rspack's plugin entry point. */
+  apply(compiler: CompilerLike): void;
+}
+/**
+ * Lunora Rspack plugin. Add it to `plugins` in `rspack.config.*` (or
+ * `tools.rspack.plugins` under Rsbuild) and it will:
+ *
+ * 1. Run `@lunora/codegen` before every compilation, and again on any edit
+ * under `lunora/` in watch mode.
+ * 2. Write the Cloudflare bindings your code implies into `wrangler.jsonc`,
+ * plus your cron triggers and the compatibility date.
+ * 3. Validate that config against the schema's requirements (`validateWrangler`).
+ * 4. Run the project's `postcodegen` hook.
+ *
+ * A production build fails on an ERROR-level advisory or platform diagnostic; a
+ * watch rebuild logs them and carries on.
+ *
+ * **It does not run your Worker.** Rspack has no `@cloudflare/vite-plugin`
+ * equivalent — no workerd/miniflare integration — so this plugin builds the
+ * client half and `wrangler dev` (or `lunora dev`) runs the Worker, which is the
+ * same split as `@lunora/vite`'s `cloudflare: false` path. The Vite plugin's
+ * dev-server features therefore have no counterpart here: no error overlay, no
+ * embedded Studio, no worker log streaming, no remote-binding injection. Use
+ * `lunora dev` for those, or `@lunora/vite` if you want them in-process.
+ *
+ * The plugin API tapped here is webpack 5's, so the same instance works in a
+ * webpack build unchanged.
+ */
+declare const lunoraRspack: (options?: LunoraRspackOptions) => LunoraRspackPlugin;
+declare const VERSION: string;
+export { type CompilerLike, type LunoraRspackOptions, LunoraRspackPlugin, VERSION, lunoraRspack };

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+import { R as ResolvedLunoraRspackOptions, L as LunoraRspackOptions } from "./packem_shared/types.d-DcuVeaxB.js";
+import '@lunora/codegen';
+/**
+ * The slice of the Rspack compiler this plugin touches, projected structurally.
+ *
+ * `@rspack/core` is an OPTIONAL peer here, so its `Compiler` type must not appear
+ * in the emitted `.d.ts` — a consumer without it installed would fail to resolve
+ * the reference. Projecting only what we tap also makes the plugin work unchanged
+ * under webpack 5, whose plugin API these members come from.
+ *
+ * A projection is only safe while it stays a real subset of the thing it
+ * projects, and a renamed hook or a reshaped dependency set upstream would
+ * silently stop it being one — this package would keep compiling and fail at the
+ * first `rspack build`. `__tests__/compiler-projection.test.ts` asserts a real
+ * `Compiler`/`Compilation` still satisfies every member below, so that drift is a
+ * type error here rather than a runtime one in a user's project.
+ */
+/** A `lite-tapable` async hook, narrowed to the `tapPromise` registration we use. */
+interface AsyncTapHook<T> {
+  tapPromise: (name: string, callback: (value: T) => Promise<void>) => void;
+}
+/** The mutable dependency set a compilation exposes for watch invalidation. */
+interface DependencySet {
+  add: (dependency: string) => void;
+}
+/** The slice of `Compilation` this plugin reads or mutates. */
+interface CompilationLike {
+  /** Directories whose contents invalidate this compilation when they change. */
+  contextDependencies: DependencySet;
+  /**
+   * Build errors. Pushing here fails the build — `stats.hasErrors()` goes true,
+   * assets are not emitted, and the CLI exits non-zero — WITHOUT aborting a
+   * watch session, which is why every blocking finding this plugin reports goes
+   * here rather than out of a rejected hook.
+   */
+  errors: Error[];
+  /** Individual files that invalidate this compilation when they change. */
+  fileDependencies: DependencySet;
+}
+/** The slice of `Compiler` this plugin taps. */
+interface CompilerLike {
+  hooks: {
+    /** After each compilation seals — where dependencies and findings are registered. */
+    afterCompile: AsyncTapHook<CompilationLike>;
+    /** Before each compilation — where codegen runs, so the build sees fresh output. */
+    beforeCompile: AsyncTapHook<unknown>;
+  };
+  /**
+   * `true` under `compiler.watch()`, `false` for a one-shot `compiler.run()`.
+   *
+   * Only ever read from INSIDE a hook callback. `apply()` runs during
+   * `createCompiler()`, before `watch()` assigns this — read at tap time it is
+   * unconditionally `false`, which silently inverts every decision that depends
+   * on it.
+   */
+  watchMode?: boolean;
+}
+/**
+ * The Rspack (and webpack 5) plugin: runs `@lunora/codegen` before every
+ * compilation, provisions the Cloudflare bindings the code implies into
+ * `wrangler.jsonc`, and validates that config.
+ *
+ * Everything hangs off two hooks. `beforeCompile` carries the startup and
+ * regeneration pass, so a compilation never reads a stale `_generated/*`.
+ * `afterCompile` registers the watch dependencies and reports whatever the pass
+ * found into `compilation.errors`.
+ *
+ * **Findings are reported, never thrown.** A rejected hook takes a watch session
+ * down with it; `compilation.errors` fails a one-shot build just as hard (assets
+ * are not emitted and the CLI exits non-zero) while leaving the watcher up to
+ * regenerate on the next save. That is what lets one code path serve both modes,
+ * and `compiler.watchMode` then decides only whether a *schema advisory* is worth
+ * failing over — a production build refuses one, exactly as `vite build` and
+ * `lunora deploy` do, and a watch rebuild logs it and carries on.
+ */
+declare class LunoraRspackPlugin {
+  #private;
+  constructor(options: ResolvedLunoraRspackOptions);
+  /**
+   * Run the once-per-session dev preparation (`.dev.vars` scaffolding, the
+   * agent-rules hint) and mark the session started.
+   *
+   * Public because ORDER matters and only the caller knows it: wrangler reads
+   * `.dev.vars` once, while resolving bindings at startup. A host that spawns
+   * the Worker — `@lunora/rspack/rsbuild` does, from `onBeforeStartDevServer`,
+   * which Rsbuild runs before the first compilation — must therefore await this
+   * first, or the very first `rsbuild dev` after a fresh clone boots a Worker
+   * with every secret `undefined`. That surfaces as auth failures rather than a
+   * clear error, and the SECOND run works, because `.dev.vars` is on disk by
+   * then. Neither creating the file nor rewriting `wrangler.jsonc` afterwards
+   * rescues the running process.
+   *
+   * Idempotent: the pass below sees `#started` and skips its own call.
+   */
+  prepareDevSession(): Promise<void>;
+  /**
+   * Run a watch-mode codegen pass now, ahead of the first compilation.
+   *
+   * Public for the same ordering reason as {@link prepareDevSession}: the
+   * Worker `@lunora/rspack/rsbuild` spawns is bundled by `wrangler dev` at
+   * startup, and it imports `_generated/app` — which, on a fresh clone, only
+   * this pass writes. Spawned first, wrangler dies on an unresolvable import
+   * before the first compilation ever generates it. The first compilation then
+   * finds the fingerprint unchanged and skips its own pass.
+   */
+  generateForDev(): Promise<void>;
+  /** Rspack's plugin entry point. */
+  apply(compiler: CompilerLike): void;
+}
+/**
+ * Lunora Rspack plugin. Add it to `plugins` in `rspack.config.*` (or
+ * `tools.rspack.plugins` under Rsbuild) and it will:
+ *
+ * 1. Run `@lunora/codegen` before every compilation, and again on any edit
+ * under `lunora/` in watch mode.
+ * 2. Write the Cloudflare bindings your code implies into `wrangler.jsonc`,
+ * plus your cron triggers and the compatibility date.
+ * 3. Validate that config against the schema's requirements (`validateWrangler`).
+ * 4. Run the project's `postcodegen` hook.
+ *
+ * A production build fails on an ERROR-level advisory or platform diagnostic; a
+ * watch rebuild logs them and carries on.
+ *
+ * **It does not run your Worker.** Rspack has no `@cloudflare/vite-plugin`
+ * equivalent — no workerd/miniflare integration — so this plugin builds the
+ * client half and `wrangler dev` (or `lunora dev`) runs the Worker, which is the
+ * same split as `@lunora/vite`'s `cloudflare: false` path. The Vite plugin's
+ * dev-server features therefore have no counterpart here: no error overlay, no
+ * embedded Studio, no worker log streaming, no remote-binding injection. Use
+ * `lunora dev` for those, or `@lunora/vite` if you want them in-process.
+ *
+ * The plugin API tapped here is webpack 5's, so the same instance works in a
+ * webpack build unchanged.
+ */
+declare const lunoraRspack: (options?: LunoraRspackOptions) => LunoraRspackPlugin;
+declare const VERSION: string;
+export { type CompilerLike, type LunoraRspackOptions, LunoraRspackPlugin, VERSION, lunoraRspack };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{createRequire as r}from"node:module";import{r as e}from"./packem_shared/options-rWtSt-oe.mjs";import{LunoraRspackPlugin as t}from"./packem_shared/LunoraRspackPlugin-DPrjGG-k.mjs";const s=o=>new t(e(o)),i=r(import.meta.url)("../package.json").version;export{t as LunoraRspackPlugin,i as VERSION,s as lunoraRspack};

package/dist/packem_shared/LunoraRspackPlugin-DPrjGG-k.mjs

@@ -0,0 +1,3 @@
+import{createHash as g}from"node:crypto";import{existsSync as u,readFileSync as p}from"node:fs";import{join as m,resolve as v}from"node:path";import{createCodegenProject as w,refreshCodegenProject as R,runCodegen as j,findTsconfig as a,fingerprintSchemaSources as S}from"@lunora/codegen";import{LUNORA_TAG as y,reportCodegenFindings as E,blockingFindingsMessage as D,isCodegenDisabled as P,CODEGEN_ENV as c,lunoraLine as n,runPostCodegenHook as b,ensureDevVariables as k,createConfirm as C,fillDevSecrets as F,ensureDevWorkerEnv as A,detectAgentRules as L,claimAgentRulesHint as T,AGENT_RULES_HINT as N}from"@lunora/config";import{collectWranglerSecretVariables as _,reconcileWranglerExtras as W,findWranglerFile as h,reconcileBindingsSafely as x,assertWranglerSatisfiesSchema as M}from"@lunora/config/cloudflare";const G=(t,e,r)=>{const i=m(t.projectRoot,t.schemaDir,"schema.ts");if(!u(i)){e.warn(`${y} no schema found at ${i} — run \`lunora init\` or create it, then rebuild.`);return}const s=j({apiSpec:t.apiSpec,lunoraDirectory:t.schemaDir,project:r,projectRoot:t.projectRoot,target:t.target,wranglerVariables:_(t.projectRoot)});return W(t.projectRoot,s.cronTriggers,e),E(s,e),D(s)},H=t=>{let e;return{drop:()=>{e=void 0},get:()=>(e===void 0?e=w(t):R(e,t),e)}},d="LunoraRspackPlugin",I=2,l=t=>{try{return p(t,"utf8")}catch{return""}},o={error:t=>{console.error(t)},info:t=>{console.info(t)},warn:t=>{console.warn(t)}},f=async t=>{const e=r=>{o.info(n(r))};await k({confirm:C("[lunora] "),cwd:t.projectRoot,info:e}),F({cwd:t.projectRoot,info:e}),A(t.projectRoot,e),!L(t.projectRoot).installed&&T()&&o.warn(`
+${n(N)}
+`)};class q{#e;#r;#c;#o;#i=!1;#n;#h;#s=[];#t;#a;constructor(e){this.#e=e,this.#r=v(e.projectRoot,e.schemaDir),this.#c=P(process.env[c]),this.#o=H(this.#r)}async prepareDevSession(){this.#i||(this.#i=!0,await f(this.#e))}async generateForDev(){await this.#d(!0)}apply(e){e.hooks.beforeCompile.tapPromise(d,async()=>{await this.#d(e.watchMode===!0)}),e.hooks.afterCompile.tapPromise(d,r=>{r.contextDependencies.add(this.#r);for(const i of[a(this.#r),h(this.#e.projectRoot)])i!==void 0&&r.fileDependencies.add(i);for(const i of this.#s)r.errors.push(i);return Promise.resolve()})}async#d(e){this.#a??=this.#f(e).finally(()=>{this.#a=void 0}),await this.#a}async#f(e){if(e&&this.#c){this.#i||(this.#i=!0,o.info(n(`codegen disabled via ${c} — skipping generation and the wrangler checks.`)));return}const r=this.#m();r!==this.#h&&(this.#o.drop(),this.#h=r,this.#n=void 0);const i=this.#u(r);if(!this.#g(i)){this.#s=[];try{!this.#i&&e&&await f(this.#e),this.#i=!0,await this.#p(e),this.#s.length===0?(this.#n=i,this.#t=void 0):this.#l(i)}catch(s){this.#o.drop(),this.#n=void 0,this.#s.push(s instanceof Error?s:new Error(String(s))),this.#l(i),o.error(s instanceof Error?s.message:String(s))}}}#g(e){return e===this.#n?!0:this.#t!==void 0&&this.#t.fingerprint===e&&this.#t.attempts>=I}#l(e){this.#t=this.#t?.fingerprint===e?{attempts:this.#t.attempts+1,fingerprint:e}:{attempts:1,fingerprint:e}}#u(e){const r=h(this.#e.projectRoot);return[S(this.#r),e,r===void 0?"":l(r)].map(s=>g("sha256").update(s).digest("hex")).join("")}async#p(e){await x(this.#e,o),this.#e.validateWrangler&&M(this.#e,o.warn,"Update your wrangler.jsonc and rebuild.");const r=G(this.#e,o,this.#o.get()),i=await b({cwd:this.#e.projectRoot,logger:o});i.error!==void 0&&this.#s.push(new Error(i.error)),!e&&r!==void 0&&this.#s.push(new Error(r))}#m(){const e=a(this.#r);return e===void 0?"":l(e)}}export{q as LunoraRspackPlugin,d as PLUGIN_NAME};

package/dist/packem_shared/options-rWtSt-oe.mjs

@@ -0,0 +1 @@
+import{resolveTargetOrThrow as o,isRunnableTarget as a,runnableTargetIds as n}from"@lunora/config";const i=(t,r)=>{const e=o(t,r);if(!a(e))throw new Error(`target "${e}" has no command-line toolchain, so the Lunora Rspack plugin cannot build for it — it can only generate for it (\`lunora codegen --target ${e}\`). Buildable targets: ${n().join(", ")}`);return e},c=t=>{const r=t??{},e=r.projectRoot??process.cwd();return{apiSpec:r.apiSpec??"openapi",projectRoot:e,schemaDir:r.schemaDir??"lunora",target:i(e,r.target),validateWrangler:r.validateWrangler??!0}};export{c as r};

package/dist/packem_shared/types.d-DcuVeaxB.d.mts

@@ -0,0 +1,44 @@
+import { CodegenOptions } from '@lunora/codegen';
+/**
+ * Options for the `lunoraRspack()` plugin factory.
+ *
+ * Deliberately a subset of `@lunora/vite`'s. Everything absent here is
+ * Vite-dev-server machinery with no Rspack counterpart (`overlay`,
+ * `cloudflare`, `shard`) — see the package README for which of those the
+ * wrangler side of the stack covers instead. `studio` lives on the Rsbuild
+ * options, since it needs a dev server to mount on.
+ */
+interface LunoraRspackOptions {
+  /**
+   * Which machine-readable API spec(s) codegen emits into `_generated/`.
+   * `"openapi"` (default) writes `openapi.json` (OpenAPI 3.1; RPC + REST),
+   * `"openrpc"` writes `openrpc.json` (OpenRPC 1.x; RPC-only), `"both"` writes
+   * both, and `"none"` writes neither. Forwarded to `runCodegen({ apiSpec })`;
+   * the value set is derived from `CodegenOptions` so it can't drift.
+   */
+  apiSpec?: CodegenOptions["apiSpec"];
+  /** Project root containing the `lunora/` directory. Defaults to `process.cwd()`. */
+  projectRoot?: string;
+  /** Directory name (relative to `projectRoot`) containing `schema.ts` and function files. Defaults to `"lunora"`. */
+  schemaDir?: string;
+  /**
+   * Deploy target the emitted `ctx.*` surface is tailored to. Defaults to
+   * `"target"` in `lunora.config.*`, then `"cloudflare"`.
+   *
+   * Set it here only to override the project config for one build — keeping
+   * this and `lunora deploy` on the same target is what the shared resolution
+   * in `@lunora/config` exists to guarantee.
+   */
+  target?: string;
+  /** Validate that `wrangler.jsonc` declares the bindings the schema implies. Defaults to `true`. */
+  validateWrangler?: boolean;
+}
+/** Resolved options after merging defaults. */
+interface ResolvedLunoraRspackOptions {
+  apiSpec: NonNullable<CodegenOptions["apiSpec"]>;
+  projectRoot: string;
+  schemaDir: string;
+  target: string;
+  validateWrangler: boolean;
+}
+export { LunoraRspackOptions as L, ResolvedLunoraRspackOptions as R };

package/dist/packem_shared/types.d-DcuVeaxB.d.ts

@@ -0,0 +1,44 @@
+import { CodegenOptions } from '@lunora/codegen';
+/**
+ * Options for the `lunoraRspack()` plugin factory.
+ *
+ * Deliberately a subset of `@lunora/vite`'s. Everything absent here is
+ * Vite-dev-server machinery with no Rspack counterpart (`overlay`,
+ * `cloudflare`, `shard`) — see the package README for which of those the
+ * wrangler side of the stack covers instead. `studio` lives on the Rsbuild
+ * options, since it needs a dev server to mount on.
+ */
+interface LunoraRspackOptions {
+  /**
+   * Which machine-readable API spec(s) codegen emits into `_generated/`.
+   * `"openapi"` (default) writes `openapi.json` (OpenAPI 3.1; RPC + REST),
+   * `"openrpc"` writes `openrpc.json` (OpenRPC 1.x; RPC-only), `"both"` writes
+   * both, and `"none"` writes neither. Forwarded to `runCodegen({ apiSpec })`;
+   * the value set is derived from `CodegenOptions` so it can't drift.
+   */
+  apiSpec?: CodegenOptions["apiSpec"];
+  /** Project root containing the `lunora/` directory. Defaults to `process.cwd()`. */
+  projectRoot?: string;
+  /** Directory name (relative to `projectRoot`) containing `schema.ts` and function files. Defaults to `"lunora"`. */
+  schemaDir?: string;
+  /**
+   * Deploy target the emitted `ctx.*` surface is tailored to. Defaults to
+   * `"target"` in `lunora.config.*`, then `"cloudflare"`.
+   *
+   * Set it here only to override the project config for one build — keeping
+   * this and `lunora deploy` on the same target is what the shared resolution
+   * in `@lunora/config` exists to guarantee.
+   */
+  target?: string;
+  /** Validate that `wrangler.jsonc` declares the bindings the schema implies. Defaults to `true`. */
+  validateWrangler?: boolean;
+}
+/** Resolved options after merging defaults. */
+interface ResolvedLunoraRspackOptions {
+  apiSpec: NonNullable<CodegenOptions["apiSpec"]>;
+  projectRoot: string;
+  schemaDir: string;
+  target: string;
+  validateWrangler: boolean;
+}
+export { LunoraRspackOptions as L, ResolvedLunoraRspackOptions as R };

package/dist/rsbuild.d.mts

@@ -0,0 +1,122 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { L as LunoraRspackOptions } from "./packem_shared/types.d-DcuVeaxB.mjs";
+import '@lunora/codegen';
+/** Path prefix the Lunora Worker serves — RPC, the WebSocket, and the studio. */
+declare const LUNORA_PATH = "/_lunora";
+/** Name Rsbuild lists this plugin under. */
+declare const RSBUILD_PLUGIN_NAME = "lunora:rsbuild";
+interface LunoraRsbuildOptions extends LunoraRspackOptions {
+  /**
+   * Serve Lunora Studio at `/__lunora` on the dev server — the same URL, and
+   * the same app, as `@lunora/vite`. Needs `@lunora/studio` installed.
+   * `false` opts out.
+   *
+   * Defaults to `true`.
+   */
+  studio?: boolean;
+  /**
+   * Run `wrangler dev` alongside the dev server and proxy {@link LUNORA_PATH}
+   * to it. `false` opts out — for a project that starts the Worker itself, or
+   * an Rsbuild build with no dev server to attach to.
+   *
+   * Defaults to `true`.
+   */
+  worker?: boolean;
+  /**
+   * Port the Worker serves on. Defaults to the wrangler config's `dev.port`,
+   * then `8787`.
+   */
+  workerPort?: number;
+  /** Extra arguments appended to `wrangler dev`. */
+  wranglerArgs?: ReadonlyArray<string>;
+}
+/**
+ * The slice of Rsbuild's plugin API this uses, projected structurally for the
+ * same reason `./compiler.ts` projects the Rspack compiler: `@rsbuild/core` is an
+ * OPTIONAL peer, so its types must not reach this package's published `.d.ts`.
+ */
+interface RsbuildApiLike {
+  getRsbuildConfig: () => Readonly<RsbuildConfigLike>;
+  modifyRsbuildConfig: (callback: (config: RsbuildConfigLike) => RsbuildConfigLike) => void;
+  modifyRspackConfig: (callback: (config: RspackConfigLike) => RspackConfigLike) => void;
+  onAfterStartDevServer: (callback: (params: {
+    port: number;
+  }) => Promise<void> | void) => void;
+  onBeforeStartDevServer: (callback: (params: {
+    server: DevServerLike;
+  }) => Promise<void> | void) => void;
+  onCloseDevServer: (callback: () => Promise<void> | void) => void;
+}
+/** The slice of Rsbuild's dev server this uses: its Connect middleware stack. */
+interface DevServerLike {
+  middlewares: {
+    use: (handler: (request: IncomingMessage, response: ServerResponse, next: () => void) => void) => unknown;
+  };
+}
+/** A single entry of Rsbuild's array-form `server.proxy`. */
+type ProxyArrayEntry = Record<string, unknown> & {
+  pathFilter?: unknown;
+};
+/**
+ * Rsbuild's `server.proxy`, which is a record OR an array — the distinction that
+ * matters, because spreading an array into an object literal turns its entries
+ * into numeric keys and Rsbuild then reads each key as a `pathFilter`, silently
+ * unrouting every rule that relied on the default match-all.
+ */
+type ProxyConfigLike = ProxyArrayEntry[] | Record<string, unknown>;
+/** The slice of the Rspack config this plugin writes. */
+interface RspackConfigLike {
+  plugins?: unknown;
+}
+/** The slice of Rsbuild's config this plugin writes. */
+interface RsbuildConfigLike {
+  server?: {
+    base?: string;
+    host?: string;
+    proxy?: ProxyConfigLike;
+  };
+}
+/** The Rsbuild plugin shape. */
+interface RsbuildPluginLike {
+  name: string;
+  setup: (api: RsbuildApiLike) => void;
+}
+/**
+ * Add the Lunora route to whichever form of `server.proxy` the project uses,
+ * without converting one form into the other.
+ *
+ * In both forms the project's own entry for this path WINS: the plugin supplies
+ * a default, not a policy. `127.0.0.1` rather than `localhost` because Node
+ * resolves `localhost` to `::1` first on some hosts while wrangler binds IPv4.
+ */
+declare const withLunoraProxy: (existing: ProxyConfigLike | undefined, port: number) => ProxyConfigLike;
+/**
+ * Lunora Rsbuild plugin — the one-command dev story.
+ *
+ * `rsbuild dev` starts the client dev server AND the Lunora Worker, and routes
+ * `/_lunora/*` to it. Nothing to wire: no hand-written proxy, no second terminal,
+ * no `wrangler.dev.jsonc`.
+ *
+ * It is a different shape from `lunoraRspack` because Rsbuild plugins are
+ * `{ name, setup }` and Rspack plugins are `{ apply }`. This one registers the
+ * Rspack plugin itself through `modifyRspackConfig`, so codegen, binding
+ * provisioning and wrangler validation come along with it — one entry in
+ * `plugins` wires the whole thing.
+ *
+ * **Why a child process rather than in-process workerd.** `@cloudflare/vite-plugin`
+ * runs the Worker inside the dev server using Vite's Environment API: a module
+ * runner in workerd pulls each module over RPC from Vite. Rspack has no equivalent
+ * runner protocol, and the alternative — bundling the Worker ourselves and handing
+ * it to Miniflare — means reimplementing wrangler's `nodejs_compat`, Durable Object
+ * migrations, binding wiring and local persistence. `wrangler dev` already does all
+ * of that correctly. The process boundary is invisible from the developer's seat;
+ * what differs is that the Worker restarts rather than hot-swapping modules.
+ *
+ * The proxy is same-origin on purpose: the browser talks to the dev server's own
+ * origin, so `LunoraClient` needs no CORS and the auth cookie is first-party.
+ * `ws: true` is what carries the live-query socket — without it queries answer and
+ * subscriptions never arrive, which is the single most expensive way this can be
+ * misconfigured by hand.
+ */
+declare const lunoraRsbuild: (options?: LunoraRsbuildOptions) => RsbuildPluginLike;
+export { type DevServerLike, LUNORA_PATH, type LunoraRsbuildOptions, type ProxyConfigLike, RSBUILD_PLUGIN_NAME, type RsbuildApiLike, type RsbuildConfigLike, type RsbuildPluginLike, type RspackConfigLike, lunoraRsbuild, withLunoraProxy };

package/dist/rsbuild.d.ts

@@ -0,0 +1,122 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { L as LunoraRspackOptions } from "./packem_shared/types.d-DcuVeaxB.js";
+import '@lunora/codegen';
+/** Path prefix the Lunora Worker serves — RPC, the WebSocket, and the studio. */
+declare const LUNORA_PATH = "/_lunora";
+/** Name Rsbuild lists this plugin under. */
+declare const RSBUILD_PLUGIN_NAME = "lunora:rsbuild";
+interface LunoraRsbuildOptions extends LunoraRspackOptions {
+  /**
+   * Serve Lunora Studio at `/__lunora` on the dev server — the same URL, and
+   * the same app, as `@lunora/vite`. Needs `@lunora/studio` installed.
+   * `false` opts out.
+   *
+   * Defaults to `true`.
+   */
+  studio?: boolean;
+  /**
+   * Run `wrangler dev` alongside the dev server and proxy {@link LUNORA_PATH}
+   * to it. `false` opts out — for a project that starts the Worker itself, or
+   * an Rsbuild build with no dev server to attach to.
+   *
+   * Defaults to `true`.
+   */
+  worker?: boolean;
+  /**
+   * Port the Worker serves on. Defaults to the wrangler config's `dev.port`,
+   * then `8787`.
+   */
+  workerPort?: number;
+  /** Extra arguments appended to `wrangler dev`. */
+  wranglerArgs?: ReadonlyArray<string>;
+}
+/**
+ * The slice of Rsbuild's plugin API this uses, projected structurally for the
+ * same reason `./compiler.ts` projects the Rspack compiler: `@rsbuild/core` is an
+ * OPTIONAL peer, so its types must not reach this package's published `.d.ts`.
+ */
+interface RsbuildApiLike {
+  getRsbuildConfig: () => Readonly<RsbuildConfigLike>;
+  modifyRsbuildConfig: (callback: (config: RsbuildConfigLike) => RsbuildConfigLike) => void;
+  modifyRspackConfig: (callback: (config: RspackConfigLike) => RspackConfigLike) => void;
+  onAfterStartDevServer: (callback: (params: {
+    port: number;
+  }) => Promise<void> | void) => void;
+  onBeforeStartDevServer: (callback: (params: {
+    server: DevServerLike;
+  }) => Promise<void> | void) => void;
+  onCloseDevServer: (callback: () => Promise<void> | void) => void;
+}
+/** The slice of Rsbuild's dev server this uses: its Connect middleware stack. */
+interface DevServerLike {
+  middlewares: {
+    use: (handler: (request: IncomingMessage, response: ServerResponse, next: () => void) => void) => unknown;
+  };
+}
+/** A single entry of Rsbuild's array-form `server.proxy`. */
+type ProxyArrayEntry = Record<string, unknown> & {
+  pathFilter?: unknown;
+};
+/**
+ * Rsbuild's `server.proxy`, which is a record OR an array — the distinction that
+ * matters, because spreading an array into an object literal turns its entries
+ * into numeric keys and Rsbuild then reads each key as a `pathFilter`, silently
+ * unrouting every rule that relied on the default match-all.
+ */
+type ProxyConfigLike = ProxyArrayEntry[] | Record<string, unknown>;
+/** The slice of the Rspack config this plugin writes. */
+interface RspackConfigLike {
+  plugins?: unknown;
+}
+/** The slice of Rsbuild's config this plugin writes. */
+interface RsbuildConfigLike {
+  server?: {
+    base?: string;
+    host?: string;
+    proxy?: ProxyConfigLike;
+  };
+}
+/** The Rsbuild plugin shape. */
+interface RsbuildPluginLike {
+  name: string;
+  setup: (api: RsbuildApiLike) => void;
+}
+/**
+ * Add the Lunora route to whichever form of `server.proxy` the project uses,
+ * without converting one form into the other.
+ *
+ * In both forms the project's own entry for this path WINS: the plugin supplies
+ * a default, not a policy. `127.0.0.1` rather than `localhost` because Node
+ * resolves `localhost` to `::1` first on some hosts while wrangler binds IPv4.
+ */
+declare const withLunoraProxy: (existing: ProxyConfigLike | undefined, port: number) => ProxyConfigLike;
+/**
+ * Lunora Rsbuild plugin — the one-command dev story.
+ *
+ * `rsbuild dev` starts the client dev server AND the Lunora Worker, and routes
+ * `/_lunora/*` to it. Nothing to wire: no hand-written proxy, no second terminal,
+ * no `wrangler.dev.jsonc`.
+ *
+ * It is a different shape from `lunoraRspack` because Rsbuild plugins are
+ * `{ name, setup }` and Rspack plugins are `{ apply }`. This one registers the
+ * Rspack plugin itself through `modifyRspackConfig`, so codegen, binding
+ * provisioning and wrangler validation come along with it — one entry in
+ * `plugins` wires the whole thing.
+ *
+ * **Why a child process rather than in-process workerd.** `@cloudflare/vite-plugin`
+ * runs the Worker inside the dev server using Vite's Environment API: a module
+ * runner in workerd pulls each module over RPC from Vite. Rspack has no equivalent
+ * runner protocol, and the alternative — bundling the Worker ourselves and handing
+ * it to Miniflare — means reimplementing wrangler's `nodejs_compat`, Durable Object
+ * migrations, binding wiring and local persistence. `wrangler dev` already does all
+ * of that correctly. The process boundary is invisible from the developer's seat;
+ * what differs is that the Worker restarts rather than hot-swapping modules.
+ *
+ * The proxy is same-origin on purpose: the browser talks to the dev server's own
+ * origin, so `LunoraClient` needs no CORS and the auth cookie is first-party.
+ * `ws: true` is what carries the live-query socket — without it queries answer and
+ * subscriptions never arrive, which is the single most expensive way this can be
+ * misconfigured by hand.
+ */
+declare const lunoraRsbuild: (options?: LunoraRsbuildOptions) => RsbuildPluginLike;
+export { type DevServerLike, LUNORA_PATH, type LunoraRsbuildOptions, type ProxyConfigLike, RSBUILD_PLUGIN_NAME, type RsbuildApiLike, type RsbuildConfigLike, type RsbuildPluginLike, type RspackConfigLike, lunoraRsbuild, withLunoraProxy };

package/dist/rsbuild.mjs

@@ -0,0 +1,2 @@
+import{formatLunoraEvent as y,lunoraLine as l}from"@lunora/config";import{createStudioMiddleware as k,isNonLoopbackHost as A,studioMountPath as R}from"@lunora/config/studio-host";import{r as E}from"./packem_shared/options-rWtSt-oe.mjs";import{LunoraRspackPlugin as L}from"./packem_shared/LunoraRspackPlugin-DPrjGG-k.mjs";import{spawn as x}from"node:child_process";import{existsSync as D,mkdirSync as P}from"node:fs";import{connect as T}from"node:net";import{resolve as v,dirname as b}from"node:path";import{findWranglerFile as O,readWranglerJsonc as _}from"@lunora/config/cloudflare";const C=8787,d=3e4,W=150,$=5e3,u=(e,r,t)=>{let o;for(const[n,s]of e.entries())s.startsWith(`${r}=`)?o=s.slice(r.length+1):(s===r||s===t)&&n+1<e.length&&(o=e[n+1]);return o},h=(e,r=[])=>{const t=u(r,"--config","-c"),o=t===void 0?O(e):v(e,t);if(o===void 0||!D(o))return;const{parsed:n}=_(o);return n===void 0?void 0:{config:n,env:u(r,"--env","-e"),path:o}},I=(e,r,t)=>{if(r!==void 0)return r;const o=h(e,t)?.config.dev?.port;return typeof o=="number"?o:C},N=(e,r)=>{const t=h(e,r);if(t===void 0)return;const n=((t.env===void 0?void 0:t.config.env?.[t.env]?.assets)??t.config.assets)?.directory;typeof n=="string"&&P(v(b(t.path),n),{recursive:!0})},w=async e=>new Promise(r=>{const t=T({host:"127.0.0.1",port:e}),o=n=>{t.destroy(),r(n)};t.once("connect",()=>{o(!0)}),t.once("error",()=>{o(!1)})}),f=e=>{const r=y(e);if(r===void 0){e.trim()!==""&&console.log(e);return}const t=l(r.text);r.level==="error"?console.error(t):r.level==="warn"?console.warn(t):console.info(t)},p=e=>{let r="";e?.setEncoding("utf8"),e?.on("data",t=>{r+=t;const o=r.split(`
+`);r=o.pop()??"";for(const n of o)f(n)}),e?.once("end",()=>{r!==""&&(f(r),r="")})},M=async e=>{if(await w(e.port))throw new Error(`could not start the worker: port ${String(e.port)} is already in use. Stop whatever is serving there (another \`rsbuild dev\` or \`lunora dev\`?), or set \`workerPort\`.`);N(e.projectRoot,e.wranglerArgs);const r=["dev","--port",String(e.port),"--var","WORKER_ENV:development",...e.wranglerArgs??[]],t=process.platform==="win32",o=x(t?"wrangler.cmd":"wrangler",r,{cwd:e.projectRoot,shell:t,stdio:["ignore","pipe","pipe"]});p(o.stdout),p(o.stderr);let n;o.once("error",a=>{n=a.code==="ENOENT"?new Error("could not start the worker: `wrangler` was not found on PATH. Add it to the project (`npm install -D wrangler`), or pass `worker: false` to run the worker yourself."):a});const s=()=>{o.kill("SIGKILL")};process.once("exit",s);const i=async()=>{process.removeListener("exit",s),!(o.exitCode!==null||o.signalCode!==null)&&await new Promise(a=>{const S=setTimeout(()=>{o.kill("SIGKILL")},$);o.once("exit",()=>{clearTimeout(S),a()}),o.kill("SIGTERM")})};let c;o.once("exit",a=>{c??=new Error(`wrangler dev exited with code ${String(a)} before it was ready`)});const m=Date.now()+d;for(;Date.now()<m;){if(n!==void 0)throw n;if(c!==void 0)throw c;if(await w(e.port)){if(o.exitCode!==null||o.signalCode!==null)throw await i(),new Error(`the worker on port ${String(e.port)} is not the one this plugin started — it exited while something else took the port.`);return{port:e.port,stop:i}}await new Promise(a=>{setTimeout(a,W)})}throw await i(),new Error(`wrangler dev did not start listening on port ${String(e.port)} within ${String(d/1e3)}s`)},g="/_lunora",j="lunora:rsbuild",F=(e,r)=>{const t=`http://127.0.0.1:${String(r)}`;return Array.isArray(e)?[...e,{changeOrigin:!0,pathFilter:g,target:t,ws:!0}]:{[g]:{changeOrigin:!0,target:t,ws:!0},...e}},U=(e,r)=>{e.onBeforeStartDevServer(({server:t})=>{const{base:o,host:n}=e.getRsbuildConfig().server??{};t.middlewares.use(k({apiSpec:r.apiSpec,base:o,isNonLoopbackBind:A(n),projectRoot:r.projectRoot,schemaDirectory:r.schemaDir}))}),e.onAfterStartDevServer(({port:t})=>{console.info(l(`studio on http://localhost:${String(t)}${R(e.getRsbuildConfig().server?.base)}`))})},Q=e=>{const r=E(e),t=I(r.projectRoot,e?.workerPort,e?.wranglerArgs),o=new L(r);return{name:j,setup:n=>{if(n.modifyRspackConfig(i=>({...i,plugins:[...Array.isArray(i.plugins)?i.plugins:[],o]})),n.modifyRsbuildConfig(i=>({...i,server:{...i.server,proxy:F(i.server?.proxy,t)}})),e?.studio!==!1&&U(n,r),e?.worker===!1)return;let s;n.onBeforeStartDevServer(async()=>{await o.prepareDevSession(),await o.generateForDev(),console.info(l(`starting the worker on http://127.0.0.1:${String(t)} …`)),s=await M({port:t,projectRoot:r.projectRoot,wranglerArgs:e?.wranglerArgs})}),n.onCloseDevServer(async()=>{await s?.stop(),s=void 0})}}};export{g as LUNORA_PATH,j as RSBUILD_PLUGIN_NAME,Q as lunoraRsbuild,F as withLunoraProxy};