every-plugin 3.0.0-rc.3 → 3.0.0-rc.5

package/dist/build/ui/generated-config.cjs

@@ -19,6 +19,9 @@ function hasFolderFormUi(cwd) {
 	const uiDir = node_path.default.join(cwd, UI_DIR);
 	return node_fs.default.existsSync(node_path.default.join(uiDir, "src", "routes")) && !node_fs.default.existsSync(node_path.default.join(uiDir, "package.json"));
 }
+function uiDistDirFor(cwd) {
+	return node_path.default.join(cwd, UI_DIR, "dist");
+}
 function generatedUiConfig(pluginId) {
 	return `import path from "node:path";
 import { createUiRsbuildConfig } from "every-plugin/build/ui";
@@ -115,4 +118,5 @@ exports.ensureGeneratedUiRsbuildConfig = ensureGeneratedUiRsbuildConfig;
 exports.hasCoreUiWorkspace = hasCoreUiWorkspace;
 exports.hasFolderFormUi = hasFolderFormUi;
 exports.pluginLayoutKey = pluginLayoutKey;
+exports.uiDistDirFor = uiDistDirFor;
 //# sourceMappingURL=generated-config.cjs.map

package/dist/build/ui/generated-config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generated-config.cjs","names":["path","fs","findBosConfigPath"],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQA,kBAAK,KAAK,KAAK,MAAM;CACnC,OACEC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAACC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgBE,kCAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtBF,kBAAK,SAASA,kBAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAMA,kBAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAACC,gBAAG,WAAW,OAAO,KAAKA,gBAAG,aAAa,SAAS,MAAM,MAAM,MAClE,gBAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACEA,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAIC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,gBAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAOA,kBAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}
+{"version":3,"file":"generated-config.cjs","names":["path","fs","findBosConfigPath"],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nexport function uiDistDirFor(cwd: string): string {\n  return path.join(cwd, UI_DIR, \"dist\");\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQA,kBAAK,KAAK,KAAK,MAAM;CACnC,OACEC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAACC,gBAAG,WAAWD,kBAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAgB,aAAa,KAAqB;CAChD,OAAOA,kBAAK,KAAK,KAAK,QAAQ,MAAM;AACtC;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgBE,kCAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtBF,kBAAK,SAASA,kBAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAMA,kBAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAACC,gBAAG,WAAW,OAAO,KAAKA,gBAAG,aAAa,SAAS,MAAM,MAAM,MAClE,gBAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACEA,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAACC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAIC,gBAAG,WAAWD,kBAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAASA,kBAAK,KAAK,KAAK,oBAAoB;CAClD,gBAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAUA,kBAAK,KAAK,QAAQ,mBAAmB;CACrD,gBAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAOA,kBAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}

package/dist/build/ui/generated-config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-config.d.cts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAmDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}
+{"version":3,"file":"generated-config.d.cts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAuDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}

package/dist/build/ui/generated-config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-config.d.mts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAmDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}
+{"version":3,"file":"generated-config.d.mts","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"mappings":";;;;;;;iBAcgB,gBAAgB;;;;;;;iBAuDhB,+BAA+B;;;;;;;;iBAiC/B,mBAAmB;;;;;;;iBAyBnB,mCAAmC"}

package/dist/build/ui/generated-config.mjs

@@ -16,6 +16,9 @@ function hasFolderFormUi(cwd) {
 	const uiDir = path.join(cwd, UI_DIR);
 	return fs.existsSync(path.join(uiDir, "src", "routes")) && !fs.existsSync(path.join(uiDir, "package.json"));
 }
+function uiDistDirFor(cwd) {
+	return path.join(cwd, UI_DIR, "dist");
+}
 function generatedUiConfig(pluginId) {
 	return `import path from "node:path";
 import { createUiRsbuildConfig } from "every-plugin/build/ui";
@@ -107,5 +110,5 @@ function ensureGeneratedCoreUiRsbuildConfig(cwd = process.cwd()) {
 }
 
 //#endregion
-export { ensureGeneratedCoreUiRsbuildConfig, ensureGeneratedUiRsbuildConfig, hasCoreUiWorkspace, hasFolderFormUi, pluginLayoutKey };
+export { ensureGeneratedCoreUiRsbuildConfig, ensureGeneratedUiRsbuildConfig, hasCoreUiWorkspace, hasFolderFormUi, pluginLayoutKey, uiDistDirFor };
 //# sourceMappingURL=generated-config.mjs.map

package/dist/build/ui/generated-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"generated-config.mjs","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQ,KAAK,KAAK,KAAK,MAAM;CACnC,OACE,GAAG,WAAW,KAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAAC,GAAG,WAAW,KAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgB,kBAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtB,KAAK,SAAS,KAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAM,KAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAAC,GAAG,WAAW,OAAO,KAAK,GAAG,aAAa,SAAS,MAAM,MAAM,MAClE,GAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACE,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAI,GAAG,WAAW,KAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,GAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAO,KAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}
+{"version":3,"file":"generated-config.mjs","names":[],"sources":["../../../src/build/ui/generated-config.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { findBosConfigPath } from \"../rspack/compose\";\n\nconst UI_DIR = \"ui\";\nconst GENERATED_CONFIG_DIR = \".every-plugin\";\nconst GENERATED_UI_CONFIG = \"ui.rsbuild.config.generated.mjs\";\n\n/**\n * Folder-form UI source: a `ui/` directory with route files but no own\n * package.json — the plugin workspace owns the build (single-workspace\n * plugin, one dev process, one deploy train). Workspace-form ui sources\n * (own package.json + scripts) are NOT managed here.\n */\nexport function hasFolderFormUi(cwd: string): boolean {\n  const uiDir = path.join(cwd, UI_DIR);\n  return (\n    fs.existsSync(path.join(uiDir, \"src\", \"routes\")) &&\n    !fs.existsSync(path.join(uiDir, \"package.json\"))\n  );\n}\n\nexport function uiDistDirFor(cwd: string): string {\n  return path.join(cwd, UI_DIR, \"dist\");\n}\n\nfunction generatedUiConfig(pluginId: string): string {\n  return `import path from \"node:path\";\nimport { createUiRsbuildConfig } from \"every-plugin/build/ui\";\nimport pkg from \"../package.json\";\n\nconst workspaceRoot = path.resolve(import.meta.dirname, \"..\", \"ui\");\n\nexport default createUiRsbuildConfig({\n  workspaceRoot,\n  pkg,\n  role: \"consumer\",\n  manifestName: ${JSON.stringify(pluginId)},\n  devPort: Number(process.env.BOS_UI_PORT) || 0,\n  webEntry: \"./ui/src/routeConfig.gen.ts\",\n  webExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  nodeEntry: \"./ui/src/routeConfig.gen.ts\",\n  nodeExposes: { \"./routeConfig\": \"./ui/src/routeConfig.gen.ts\" },\n  routesDirectory: \"./ui/src/routes\",\n});\n`;\n}\n\n/**\n * Canonical config-layout derivation: the composition key for a plugin\n * workspace — the `<key>` of the `plugins/<key>` directory relative to the\n * nearest `bos.config.json`. The dev server and the generated ui config\n * both key off this; no consumer keeps a private copy.\n */\nexport function pluginLayoutKey(cwd: string): string | null {\n  const bosConfigPath = findBosConfigPath(cwd);\n  const relativeWorkspace = bosConfigPath\n    ? path.relative(path.dirname(bosConfigPath), cwd)\n    : undefined;\n  const [workspaceGroup, layoutKey] = relativeWorkspace?.split(path.sep) ?? [];\n  return workspaceGroup === \"plugins\" && layoutKey ? layoutKey : null;\n}\n\n/**\n * Synthesize the rsbuild config for a folder-form ui source (the plugin\n * build contract, not per-plugin config — mirrors the rspack generated\n * config). Returns the config file path, or null when the workspace has no\n * folder-form ui source.\n */\nexport function ensureGeneratedUiRsbuildConfig(cwd: string): string | null {\n  if (!hasFolderFormUi(cwd)) return null;\n  // The manifest's name derives ONLY from the plugins/<key> layout key\n  // (ADR 0008 §2) — a non-derivable key fails the build loudly, never the\n  // container-name fallback that mis-keyed manifests.\n  const pluginId = pluginLayoutKey(cwd);\n  if (!pluginId) {\n    throw new Error(\n      `[every-plugin] cannot derive the ui's composition key from ${cwd} — no authored config (bos.app.ts / bos.config.json) found above a plugins/<key> directory. The manifest name is the layout key; the container name is never a fallback.`,\n    );\n  }\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  const next = generatedUiConfig(pluginId);\n  if (!fs.existsSync(outPath) || fs.readFileSync(outPath, \"utf8\") !== next) {\n    fs.writeFileSync(outPath, next);\n  }\n  return outPath;\n}\n\nconst CORE_UI_MARKERS = {\n  routes: \"src/routes\",\n  contract: \"src/contract.ts\",\n};\n\n/**\n * Workspace-form core ui: the workspace IS the ui (own package.json, route\n * tree) and is not plugin-shaped — the /api counterpart of the plugin\n * workspace form. The entry stub is NOT a marker: it is generated\n * (ADR 0023), so a fresh clone has no bootstrap stubs until the first\n * generation pass.\n */\nexport function hasCoreUiWorkspace(cwd: string = process.cwd()): boolean {\n  return (\n    fs.existsSync(path.join(cwd, CORE_UI_MARKERS.routes)) &&\n    !fs.existsSync(path.join(cwd, CORE_UI_MARKERS.contract)) &&\n    !fs.existsSync(path.join(cwd, \"plugin.dev.ts\"))\n  );\n}\n\nfunction generatedCoreUiConfig(): string {\n  return `import { defineConfig } from \"@rsbuild/core\";\nimport { readAuthoredConfigInput } from \"everything-dev/config\";\nimport { createCoreUiRsbuildConfig } from \"every-plugin/build/ui\";\n\nexport default defineConfig(async () =>\n  createCoreUiRsbuildConfig(await readAuthoredConfigInput()),\n);\n`;\n}\n\n/**\n * Synthesize the rsbuild config for a workspace-form core ui with no local\n * `rsbuild.config.ts` — the /api generated-config model. A local file is an\n * override and wins untouched. Returns the workspace-relative config path,\n * or null when the workspace is not a core ui (or has a local config).\n */\nexport function ensureGeneratedCoreUiRsbuildConfig(cwd: string = process.cwd()): string | null {\n  if (!hasCoreUiWorkspace(cwd)) return null;\n  if (fs.existsSync(path.join(cwd, \"rsbuild.config.ts\"))) return null;\n  const outDir = path.join(cwd, GENERATED_CONFIG_DIR);\n  fs.mkdirSync(outDir, { recursive: true });\n  const outPath = path.join(outDir, GENERATED_UI_CONFIG);\n  fs.writeFileSync(outPath, generatedCoreUiConfig());\n  console.log(\"[every-plugin] rsbuild.config.ts not found — using the core ui build factory.\");\n  return path.join(GENERATED_CONFIG_DIR, GENERATED_UI_CONFIG);\n}\n"],"mappings":";;;;;AAIA,MAAM,SAAS;AACf,MAAM,uBAAuB;AAC7B,MAAM,sBAAsB;;;;;;;AAQ5B,SAAgB,gBAAgB,KAAsB;CACpD,MAAM,QAAQ,KAAK,KAAK,KAAK,MAAM;CACnC,OACE,GAAG,WAAW,KAAK,KAAK,OAAO,OAAO,QAAQ,CAAC,KAC/C,CAAC,GAAG,WAAW,KAAK,KAAK,OAAO,cAAc,CAAC;AAEnD;AAEA,SAAgB,aAAa,KAAqB;CAChD,OAAO,KAAK,KAAK,KAAK,QAAQ,MAAM;AACtC;AAEA,SAAS,kBAAkB,UAA0B;CACnD,OAAO;;;;;;;;;;kBAUS,KAAK,UAAU,QAAQ,EAAE;;;;;;;;;AAS3C;;;;;;;AAQA,SAAgB,gBAAgB,KAA4B;CAC1D,MAAM,gBAAgB,kBAAkB,GAAG;CAI3C,MAAM,CAAC,gBAAgB,cAHG,gBACtB,KAAK,SAAS,KAAK,QAAQ,aAAa,GAAG,GAAG,IAC9C,OACiD,EAAE,MAAM,KAAK,GAAG,KAAK,CAAC;CAC3E,OAAO,mBAAmB,aAAa,YAAY,YAAY;AACjE;;;;;;;AAQA,SAAgB,+BAA+B,KAA4B;CACzE,IAAI,CAAC,gBAAgB,GAAG,GAAG,OAAO;CAIlC,MAAM,WAAW,gBAAgB,GAAG;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,8DAA8D,IAAI,yKACpE;CAEF,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,MAAM,OAAO,kBAAkB,QAAQ;CACvC,IAAI,CAAC,GAAG,WAAW,OAAO,KAAK,GAAG,aAAa,SAAS,MAAM,MAAM,MAClE,GAAG,cAAc,SAAS,IAAI;CAEhC,OAAO;AACT;AAEA,MAAM,kBAAkB;CACtB,QAAQ;CACR,UAAU;AACZ;;;;;;;;AASA,SAAgB,mBAAmB,MAAc,QAAQ,IAAI,GAAY;CACvE,OACE,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,MAAM,CAAC,KACpD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,gBAAgB,QAAQ,CAAC,KACvD,CAAC,GAAG,WAAW,KAAK,KAAK,KAAK,eAAe,CAAC;AAElD;AAEA,SAAS,wBAAgC;CACvC,OAAO;;;;;;;;AAQT;;;;;;;AAQA,SAAgB,mCAAmC,MAAc,QAAQ,IAAI,GAAkB;CAC7F,IAAI,CAAC,mBAAmB,GAAG,GAAG,OAAO;CACrC,IAAI,GAAG,WAAW,KAAK,KAAK,KAAK,mBAAmB,CAAC,GAAG,OAAO;CAC/D,MAAM,SAAS,KAAK,KAAK,KAAK,oBAAoB;CAClD,GAAG,UAAU,QAAQ,EAAE,WAAW,KAAK,CAAC;CACxC,MAAM,UAAU,KAAK,KAAK,QAAQ,mBAAmB;CACrD,GAAG,cAAc,SAAS,sBAAsB,CAAC;CACjD,QAAQ,IAAI,+EAA+E;CAC3F,OAAO,KAAK,KAAK,sBAAsB,mBAAmB;AAC5D"}

package/dist/client.cjs

@@ -0,0 +1,69 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _orpc_client = require("@orpc/client");
+let _orpc_client_fetch = require("@orpc/client/fetch");
+
+//#region src/client.ts
+const RATE_LIMIT_MAX_RETRIES = 3;
+const RATE_LIMIT_RETRY_CAP_MS = 2e3;
+const browserClients = /* @__PURE__ */ new Map();
+async function fetchWithRateLimitRetry(fetchUrl, options) {
+	let response = await fetch(fetchUrl, options);
+	for (let attempt = 1; attempt <= RATE_LIMIT_MAX_RETRIES && response.status === 429; attempt++) {
+		const retryAfterSeconds = Number(response.headers.get("retry-after"));
+		const delay = Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0 ? Math.min(retryAfterSeconds * 1e3, RATE_LIMIT_RETRY_CAP_MS) : 100 * attempt;
+		await new Promise((resolve) => setTimeout(resolve, delay));
+		response = await fetch(fetchUrl, options);
+	}
+	return response;
+}
+function createRpcLink(config, headers) {
+	return new _orpc_client_fetch.RPCLink({
+		origin: config.hostUrl,
+		url: config.path,
+		interceptors: [(0, _orpc_client.onError)((error) => {
+			if (typeof globalThis.window === "undefined") return;
+			if (error && typeof error === "object" && "message" in error) {
+				const message = String(error.message).toLowerCase();
+				if (message.includes("fetch") || message.includes("network") || message.includes("failed to fetch")) import("sonner").then(({ toast }) => {
+					const message = config.connectionError?.() ?? {
+						title: "Unable to connect to API",
+						description: "The API is currently unavailable. Please try again later."
+					};
+					toast.error(message.title, {
+						id: "api-connection-error",
+						description: message.description
+					});
+				}).catch(() => {});
+			}
+		})],
+		fetch(fetchUrl, options) {
+			return fetchWithRateLimitRetry(fetchUrl, {
+				...options,
+				credentials: "include",
+				headers: headers ? {
+					...Object.fromEntries(headers),
+					...options?.headers
+				} : options?.headers
+			});
+		}
+	});
+}
+function buildRpcClient(config, headers) {
+	if (!config.hostUrl) throw new Error("Missing runtime host URL");
+	return (0, _orpc_client.createORPCClient)(createRpcLink(config, headers));
+}
+function createRpcClient(config, headers) {
+	if (typeof globalThis.window !== "undefined" && !headers) {
+		const key = `${config.hostUrl}${config.path}`;
+		const memoized = browserClients.get(key);
+		if (memoized) return memoized;
+		const client = buildRpcClient(config, headers);
+		browserClients.set(key, client);
+		return client;
+	}
+	return buildRpcClient(config, headers);
+}
+
+//#endregion
+exports.createRpcClient = createRpcClient;
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.cjs","names":["RPCLink","onError","createORPCClient"],"sources":["../src/client.ts"],"sourcesContent":["import { createORPCClient, onError } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\nimport type { ContractRouterClient, RouterContract } from \"@orpc/contract\";\n\nexport type RpcConnectionErrorCopy = () => { title: string; description: string };\n\nexport interface RpcClientConfig {\n  hostUrl: string;\n  path: `/${string}`;\n  connectionError?: RpcConnectionErrorCopy;\n}\n\nconst RATE_LIMIT_MAX_RETRIES = 3;\nconst RATE_LIMIT_RETRY_CAP_MS = 2_000;\nconst browserClients = new Map<string, unknown>();\ntype FetchInput = Parameters<typeof fetch>[0];\n\nasync function fetchWithRateLimitRetry(\n  fetchUrl: FetchInput,\n  options?: RequestInit,\n): Promise<Response> {\n  let response = await fetch(fetchUrl, options);\n  for (let attempt = 1; attempt <= RATE_LIMIT_MAX_RETRIES && response.status === 429; attempt++) {\n    const retryAfterSeconds = Number(response.headers.get(\"retry-after\"));\n    const delay =\n      Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0\n        ? Math.min(retryAfterSeconds * 1000, RATE_LIMIT_RETRY_CAP_MS)\n        : 100 * attempt;\n    await new Promise((resolve) => setTimeout(resolve, delay));\n    response = await fetch(fetchUrl, options);\n  }\n\n  return response;\n}\n\nfunction createRpcLink(config: RpcClientConfig, headers?: Headers) {\n  return new RPCLink({\n    origin: config.hostUrl,\n    url: config.path,\n    interceptors: [\n      onError((error: unknown) => {\n        const browserWindow = (globalThis as { window?: unknown }).window;\n        if (typeof browserWindow === \"undefined\") {\n          return;\n        }\n\n        if (error && typeof error === \"object\" && \"message\" in error) {\n          const message = String(error.message).toLowerCase();\n          if (\n            message.includes(\"fetch\") ||\n            message.includes(\"network\") ||\n            message.includes(\"failed to fetch\")\n          ) {\n            void import(\"sonner\")\n              .then(({ toast }) => {\n                const message = config.connectionError?.() ?? {\n                  title: \"Unable to connect to API\",\n                  description: \"The API is currently unavailable. Please try again later.\",\n                };\n                toast.error(message.title, {\n                  id: \"api-connection-error\",\n                  description: message.description,\n                });\n              })\n              .catch(() => {});\n          }\n        }\n      }),\n    ],\n    fetch(fetchUrl: FetchInput, options?: RequestInit) {\n      return fetchWithRateLimitRetry(fetchUrl, {\n        ...options,\n        credentials: \"include\",\n        headers: headers\n          ? { ...Object.fromEntries(headers), ...(options?.headers as Record<string, string>) }\n          : options?.headers,\n      });\n    },\n  });\n}\n\nfunction buildRpcClient<T extends RouterContract>(\n  config: RpcClientConfig,\n  headers?: Headers,\n): ContractRouterClient<T> {\n  if (!config.hostUrl) {\n    throw new Error(\"Missing runtime host URL\");\n  }\n\n  return createORPCClient(createRpcLink(config, headers)) as ContractRouterClient<T>;\n}\n\nexport function createRpcClient<T extends RouterContract = RouterContract>(\n  config: RpcClientConfig,\n  headers?: Headers,\n): ContractRouterClient<T> {\n  const browserWindow = (globalThis as { window?: unknown }).window;\n  if (typeof browserWindow !== \"undefined\" && !headers) {\n    const key = `${config.hostUrl}${config.path}`;\n    const memoized = browserClients.get(key);\n    if (memoized) {\n      return memoized as ContractRouterClient<T>;\n    }\n\n    const client = buildRpcClient<T>(config, headers);\n    browserClients.set(key, client);\n    return client;\n  }\n\n  return buildRpcClient<T>(config, headers);\n}\n"],"mappings":";;;;;AAYA,MAAM,yBAAyB;AAC/B,MAAM,0BAA0B;AAChC,MAAM,iCAAiB,IAAI,IAAqB;AAGhD,eAAe,wBACb,UACA,SACmB;CACnB,IAAI,WAAW,MAAM,MAAM,UAAU,OAAO;CAC5C,KAAK,IAAI,UAAU,GAAG,WAAW,0BAA0B,SAAS,WAAW,KAAK,WAAW;EAC7F,MAAM,oBAAoB,OAAO,SAAS,QAAQ,IAAI,aAAa,CAAC;EACpE,MAAM,QACJ,OAAO,SAAS,iBAAiB,KAAK,oBAAoB,IACtD,KAAK,IAAI,oBAAoB,KAAM,uBAAuB,IAC1D,MAAM;EACZ,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,KAAK,CAAC;EACzD,WAAW,MAAM,MAAM,UAAU,OAAO;CAC1C;CAEA,OAAO;AACT;AAEA,SAAS,cAAc,QAAyB,SAAmB;CACjE,OAAO,IAAIA,2BAAQ;EACjB,QAAQ,OAAO;EACf,KAAK,OAAO;EACZ,cAAc,KACZC,uBAAS,UAAmB;GAE1B,IAAI,OADmB,WAAoC,WAC9B,aAC3B;GAGF,IAAI,SAAS,OAAO,UAAU,YAAY,aAAa,OAAO;IAC5D,MAAM,UAAU,OAAO,MAAM,OAAO,CAAC,CAAC,YAAY;IAClD,IACE,QAAQ,SAAS,OAAO,KACxB,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,iBAAiB,GAElC,AAAK,OAAO,SAAS,CAClB,MAAM,EAAE,YAAY;KACnB,MAAM,UAAU,OAAO,kBAAkB,KAAK;MAC5C,OAAO;MACP,aAAa;KACf;KACA,MAAM,MAAM,QAAQ,OAAO;MACzB,IAAI;MACJ,aAAa,QAAQ;KACvB,CAAC;IACH,CAAC,CAAC,CACD,YAAY,CAAC,CAAC;GAErB;EACF,CAAC,CACH;EACA,MAAM,UAAsB,SAAuB;GACjD,OAAO,wBAAwB,UAAU;IACvC,GAAG;IACH,aAAa;IACb,SAAS,UACL;KAAE,GAAG,OAAO,YAAY,OAAO;KAAG,GAAI,SAAS;IAAmC,IAClF,SAAS;GACf,CAAC;EACH;CACF,CAAC;AACH;AAEA,SAAS,eACP,QACA,SACyB;CACzB,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,MAAM,0BAA0B;CAG5C,WAAOC,+BAAiB,cAAc,QAAQ,OAAO,CAAC;AACxD;AAEA,SAAgB,gBACd,QACA,SACyB;CAEzB,IAAI,OADmB,WAAoC,WAC9B,eAAe,CAAC,SAAS;EACpD,MAAM,MAAM,GAAG,OAAO,UAAU,OAAO;EACvC,MAAM,WAAW,eAAe,IAAI,GAAG;EACvC,IAAI,UACF,OAAO;EAGT,MAAM,SAAS,eAAkB,QAAQ,OAAO;EAChD,eAAe,IAAI,KAAK,MAAM;EAC9B,OAAO;CACT;CAEA,OAAO,eAAkB,QAAQ,OAAO;AAC1C"}

package/dist/client.d.cts

@@ -0,0 +1,15 @@
+import { ContractRouterClient, RouterContract } from "@orpc/contract";
+//#region src/client.d.ts
+type RpcConnectionErrorCopy = () => {
+  title: string;
+  description: string;
+};
+interface RpcClientConfig {
+  hostUrl: string;
+  path: `/${string}`;
+  connectionError?: RpcConnectionErrorCopy;
+}
+declare function createRpcClient<T extends RouterContract = RouterContract>(config: RpcClientConfig, headers?: Headers): ContractRouterClient<T>;
+//#endregion
+export { RpcClientConfig, RpcConnectionErrorCopy, createRpcClient };
+//# sourceMappingURL=client.d.cts.map

package/dist/client.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;KAIY;EAAiC;EAAe;;UAE3C;EACf;EACA;EACA,kBAAkB;;iBAmFJ,gBAAgB,UAAU,iBAAiB,gBACzD,QAAQ,iBACR,UAAU,UACT,qBAAqB"}

package/dist/client.d.mts

@@ -0,0 +1,15 @@
+import { ContractRouterClient, RouterContract } from "@orpc/contract";
+//#region src/client.d.ts
+type RpcConnectionErrorCopy = () => {
+  title: string;
+  description: string;
+};
+interface RpcClientConfig {
+  hostUrl: string;
+  path: `/${string}`;
+  connectionError?: RpcConnectionErrorCopy;
+}
+declare function createRpcClient<T extends RouterContract = RouterContract>(config: RpcClientConfig, headers?: Headers): ContractRouterClient<T>;
+//#endregion
+export { RpcClientConfig, RpcConnectionErrorCopy, createRpcClient };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;KAIY;EAAiC;EAAe;;UAE3C;EACf;EACA;EACA,kBAAkB;;iBAmFJ,gBAAgB,UAAU,iBAAiB,gBACzD,QAAQ,iBACR,UAAU,UACT,qBAAqB"}

package/dist/client.mjs

@@ -0,0 +1,68 @@
+import { createORPCClient, onError } from "@orpc/client";
+import { RPCLink } from "@orpc/client/fetch";
+
+//#region src/client.ts
+const RATE_LIMIT_MAX_RETRIES = 3;
+const RATE_LIMIT_RETRY_CAP_MS = 2e3;
+const browserClients = /* @__PURE__ */ new Map();
+async function fetchWithRateLimitRetry(fetchUrl, options) {
+	let response = await fetch(fetchUrl, options);
+	for (let attempt = 1; attempt <= RATE_LIMIT_MAX_RETRIES && response.status === 429; attempt++) {
+		const retryAfterSeconds = Number(response.headers.get("retry-after"));
+		const delay = Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0 ? Math.min(retryAfterSeconds * 1e3, RATE_LIMIT_RETRY_CAP_MS) : 100 * attempt;
+		await new Promise((resolve) => setTimeout(resolve, delay));
+		response = await fetch(fetchUrl, options);
+	}
+	return response;
+}
+function createRpcLink(config, headers) {
+	return new RPCLink({
+		origin: config.hostUrl,
+		url: config.path,
+		interceptors: [onError((error) => {
+			if (typeof globalThis.window === "undefined") return;
+			if (error && typeof error === "object" && "message" in error) {
+				const message = String(error.message).toLowerCase();
+				if (message.includes("fetch") || message.includes("network") || message.includes("failed to fetch")) import("sonner").then(({ toast }) => {
+					const message = config.connectionError?.() ?? {
+						title: "Unable to connect to API",
+						description: "The API is currently unavailable. Please try again later."
+					};
+					toast.error(message.title, {
+						id: "api-connection-error",
+						description: message.description
+					});
+				}).catch(() => {});
+			}
+		})],
+		fetch(fetchUrl, options) {
+			return fetchWithRateLimitRetry(fetchUrl, {
+				...options,
+				credentials: "include",
+				headers: headers ? {
+					...Object.fromEntries(headers),
+					...options?.headers
+				} : options?.headers
+			});
+		}
+	});
+}
+function buildRpcClient(config, headers) {
+	if (!config.hostUrl) throw new Error("Missing runtime host URL");
+	return createORPCClient(createRpcLink(config, headers));
+}
+function createRpcClient(config, headers) {
+	if (typeof globalThis.window !== "undefined" && !headers) {
+		const key = `${config.hostUrl}${config.path}`;
+		const memoized = browserClients.get(key);
+		if (memoized) return memoized;
+		const client = buildRpcClient(config, headers);
+		browserClients.set(key, client);
+		return client;
+	}
+	return buildRpcClient(config, headers);
+}
+
+//#endregion
+export { createRpcClient };
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { createORPCClient, onError } from \"@orpc/client\";\nimport { RPCLink } from \"@orpc/client/fetch\";\nimport type { ContractRouterClient, RouterContract } from \"@orpc/contract\";\n\nexport type RpcConnectionErrorCopy = () => { title: string; description: string };\n\nexport interface RpcClientConfig {\n  hostUrl: string;\n  path: `/${string}`;\n  connectionError?: RpcConnectionErrorCopy;\n}\n\nconst RATE_LIMIT_MAX_RETRIES = 3;\nconst RATE_LIMIT_RETRY_CAP_MS = 2_000;\nconst browserClients = new Map<string, unknown>();\ntype FetchInput = Parameters<typeof fetch>[0];\n\nasync function fetchWithRateLimitRetry(\n  fetchUrl: FetchInput,\n  options?: RequestInit,\n): Promise<Response> {\n  let response = await fetch(fetchUrl, options);\n  for (let attempt = 1; attempt <= RATE_LIMIT_MAX_RETRIES && response.status === 429; attempt++) {\n    const retryAfterSeconds = Number(response.headers.get(\"retry-after\"));\n    const delay =\n      Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0\n        ? Math.min(retryAfterSeconds * 1000, RATE_LIMIT_RETRY_CAP_MS)\n        : 100 * attempt;\n    await new Promise((resolve) => setTimeout(resolve, delay));\n    response = await fetch(fetchUrl, options);\n  }\n\n  return response;\n}\n\nfunction createRpcLink(config: RpcClientConfig, headers?: Headers) {\n  return new RPCLink({\n    origin: config.hostUrl,\n    url: config.path,\n    interceptors: [\n      onError((error: unknown) => {\n        const browserWindow = (globalThis as { window?: unknown }).window;\n        if (typeof browserWindow === \"undefined\") {\n          return;\n        }\n\n        if (error && typeof error === \"object\" && \"message\" in error) {\n          const message = String(error.message).toLowerCase();\n          if (\n            message.includes(\"fetch\") ||\n            message.includes(\"network\") ||\n            message.includes(\"failed to fetch\")\n          ) {\n            void import(\"sonner\")\n              .then(({ toast }) => {\n                const message = config.connectionError?.() ?? {\n                  title: \"Unable to connect to API\",\n                  description: \"The API is currently unavailable. Please try again later.\",\n                };\n                toast.error(message.title, {\n                  id: \"api-connection-error\",\n                  description: message.description,\n                });\n              })\n              .catch(() => {});\n          }\n        }\n      }),\n    ],\n    fetch(fetchUrl: FetchInput, options?: RequestInit) {\n      return fetchWithRateLimitRetry(fetchUrl, {\n        ...options,\n        credentials: \"include\",\n        headers: headers\n          ? { ...Object.fromEntries(headers), ...(options?.headers as Record<string, string>) }\n          : options?.headers,\n      });\n    },\n  });\n}\n\nfunction buildRpcClient<T extends RouterContract>(\n  config: RpcClientConfig,\n  headers?: Headers,\n): ContractRouterClient<T> {\n  if (!config.hostUrl) {\n    throw new Error(\"Missing runtime host URL\");\n  }\n\n  return createORPCClient(createRpcLink(config, headers)) as ContractRouterClient<T>;\n}\n\nexport function createRpcClient<T extends RouterContract = RouterContract>(\n  config: RpcClientConfig,\n  headers?: Headers,\n): ContractRouterClient<T> {\n  const browserWindow = (globalThis as { window?: unknown }).window;\n  if (typeof browserWindow !== \"undefined\" && !headers) {\n    const key = `${config.hostUrl}${config.path}`;\n    const memoized = browserClients.get(key);\n    if (memoized) {\n      return memoized as ContractRouterClient<T>;\n    }\n\n    const client = buildRpcClient<T>(config, headers);\n    browserClients.set(key, client);\n    return client;\n  }\n\n  return buildRpcClient<T>(config, headers);\n}\n"],"mappings":";;;;AAYA,MAAM,yBAAyB;AAC/B,MAAM,0BAA0B;AAChC,MAAM,iCAAiB,IAAI,IAAqB;AAGhD,eAAe,wBACb,UACA,SACmB;CACnB,IAAI,WAAW,MAAM,MAAM,UAAU,OAAO;CAC5C,KAAK,IAAI,UAAU,GAAG,WAAW,0BAA0B,SAAS,WAAW,KAAK,WAAW;EAC7F,MAAM,oBAAoB,OAAO,SAAS,QAAQ,IAAI,aAAa,CAAC;EACpE,MAAM,QACJ,OAAO,SAAS,iBAAiB,KAAK,oBAAoB,IACtD,KAAK,IAAI,oBAAoB,KAAM,uBAAuB,IAC1D,MAAM;EACZ,MAAM,IAAI,SAAS,YAAY,WAAW,SAAS,KAAK,CAAC;EACzD,WAAW,MAAM,MAAM,UAAU,OAAO;CAC1C;CAEA,OAAO;AACT;AAEA,SAAS,cAAc,QAAyB,SAAmB;CACjE,OAAO,IAAI,QAAQ;EACjB,QAAQ,OAAO;EACf,KAAK,OAAO;EACZ,cAAc,CACZ,SAAS,UAAmB;GAE1B,IAAI,OADmB,WAAoC,WAC9B,aAC3B;GAGF,IAAI,SAAS,OAAO,UAAU,YAAY,aAAa,OAAO;IAC5D,MAAM,UAAU,OAAO,MAAM,OAAO,CAAC,CAAC,YAAY;IAClD,IACE,QAAQ,SAAS,OAAO,KACxB,QAAQ,SAAS,SAAS,KAC1B,QAAQ,SAAS,iBAAiB,GAElC,AAAK,OAAO,SAAS,CAClB,MAAM,EAAE,YAAY;KACnB,MAAM,UAAU,OAAO,kBAAkB,KAAK;MAC5C,OAAO;MACP,aAAa;KACf;KACA,MAAM,MAAM,QAAQ,OAAO;MACzB,IAAI;MACJ,aAAa,QAAQ;KACvB,CAAC;IACH,CAAC,CAAC,CACD,YAAY,CAAC,CAAC;GAErB;EACF,CAAC,CACH;EACA,MAAM,UAAsB,SAAuB;GACjD,OAAO,wBAAwB,UAAU;IACvC,GAAG;IACH,aAAa;IACb,SAAS,UACL;KAAE,GAAG,OAAO,YAAY,OAAO;KAAG,GAAI,SAAS;IAAmC,IAClF,SAAS;GACf,CAAC;EACH;CACF,CAAC;AACH;AAEA,SAAS,eACP,QACA,SACyB;CACzB,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,MAAM,0BAA0B;CAG5C,OAAO,iBAAiB,cAAc,QAAQ,OAAO,CAAC;AACxD;AAEA,SAAgB,gBACd,QACA,SACyB;CAEzB,IAAI,OADmB,WAAoC,WAC9B,eAAe,CAAC,SAAS;EACpD,MAAM,MAAM,GAAG,OAAO,UAAU,OAAO;EACvC,MAAM,WAAW,eAAe,IAAI,GAAG;EACvC,IAAI,UACF,OAAO;EAGT,MAAM,SAAS,eAAkB,QAAQ,OAAO;EAChD,eAAe,IAAI,KAAK,MAAM;EAC9B,OAAO;CACT;CAEA,OAAO,eAAkB,QAAQ,OAAO;AAC1C"}

package/dist/dev/host.cjs

@@ -0,0 +1,149 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let node_http = require("node:http");
+
+//#region src/dev/host.ts
+const corsHeaders = {
+	"Access-Control-Allow-Origin": "*",
+	"Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, PATCH, OPTIONS",
+	"Access-Control-Allow-Headers": "X-Requested-With, content-type, Authorization"
+};
+const applyCorsHeaders = (res) => {
+	Object.entries(corsHeaders).forEach(([key, value]) => {
+		res.setHeader(key, value);
+	});
+};
+const sendJson = (res, status, body) => {
+	res.statusCode = status;
+	res.setHeader("content-type", "application/json; charset=utf-8");
+	res.end(JSON.stringify(body));
+};
+const sendText = (res, status, text) => {
+	res.statusCode = status;
+	res.setHeader("content-type", "text/plain; charset=utf-8");
+	res.end(text);
+};
+const pathnameOf = (req) => ((req.url ?? "/").split("?")[0] ?? "/").replace(/\/+$/, "") || "/";
+const toWebRequest = (req, port) => {
+	const url = `http://localhost:${port}${req.url}`;
+	return new Request(url, {
+		method: req.method,
+		headers: req.headers,
+		body: req.method !== "GET" && req.method !== "HEAD" ? req : void 0,
+		duplex: req.method !== "GET" && req.method !== "HEAD" ? "half" : void 0
+	});
+};
+const buildHostContext = (effectContext, webRequest, cachedRawBodyRef) => {
+	const rawClone = webRequest.method === "GET" || webRequest.method === "HEAD" ? null : webRequest.clone();
+	return {
+		reqHeaders: webRequest.headers,
+		"effect/context": effectContext,
+		getRawBody: async () => {
+			if (cachedRawBodyRef.value !== null) return cachedRawBodyRef.value;
+			if (!rawClone) {
+				cachedRawBodyRef.value = "";
+				return cachedRawBodyRef.value;
+			}
+			cachedRawBodyRef.value = await rawClone.text();
+			return cachedRawBodyRef.value;
+		}
+	};
+};
+const handleOrpc = async (req, res, handler, prefix, errorLabel, effectContext, port) => {
+	try {
+		const webRequest = toWebRequest(req, port);
+		const result = await handler.handle(webRequest, {
+			prefix,
+			context: buildHostContext(effectContext, webRequest, { value: null })
+		});
+		if (result.response) {
+			res.statusCode = result.response.status;
+			result.response.headers.forEach((value, key) => {
+				res.setHeader(key, value);
+			});
+			const text = await result.response.text();
+			if (!res.getHeader("content-length")) res.setHeader("content-length", Buffer.byteLength(text).toString());
+			res.end(text);
+		} else sendText(res, 404, "Not Found");
+	} catch (error) {
+		console.error(`${errorLabel} error:`, error);
+		sendJson(res, 500, { error: error.message });
+	}
+};
+async function startDirectModuleHost(options) {
+	const port = options.port ?? 0;
+	let resolvedPort = port;
+	const rpcPrefix = options.rpcPrefix ?? "/api/rpc";
+	const apiPrefix = options.apiPrefix ?? "/api";
+	const staticHandler = options.staticHandler ?? null;
+	const resolveEffectContext = typeof options.effectContext === "function" ? options.effectContext : () => options.effectContext;
+	const server = (0, node_http.createServer)((req, res) => {
+		applyCorsHeaders(res);
+		const pathname = pathnameOf(req);
+		if (req.method === "OPTIONS") {
+			res.statusCode = 200;
+			res.end();
+			return;
+		}
+		if (pathname === "/" && (req.method === "GET" || req.method === "HEAD")) {
+			sendJson(res, 200, {
+				ok: true,
+				module: options.name,
+				version: options.version,
+				status: options.handlers.rpc ? "ready" : "loading",
+				endpoints: {
+					health: "/health",
+					docs: apiPrefix,
+					rpc: rpcPrefix
+				}
+			});
+			return;
+		}
+		if (pathname === "/health" && (req.method === "GET" || req.method === "HEAD")) {
+			sendText(res, 200, "OK");
+			return;
+		}
+		if (pathname.startsWith(`${rpcPrefix}/`)) {
+			if (!options.handlers.rpc) {
+				sendJson(res, 503, { error: "Plugin still loading..." });
+				return;
+			}
+			handleOrpc(req, res, options.handlers.rpc, rpcPrefix, "RPC", resolveEffectContext(), resolvedPort).catch(() => {});
+			return;
+		}
+		if (pathname === apiPrefix || pathname.startsWith(`${apiPrefix}/`)) {
+			if (!options.handlers.api) {
+				sendJson(res, 503, { error: "Plugin still loading..." });
+				return;
+			}
+			handleOrpc(req, res, options.handlers.api, apiPrefix, "OpenAPI", resolveEffectContext(), resolvedPort).catch(() => {});
+			return;
+		}
+		if (staticHandler) {
+			staticHandler(req, res, () => {
+				sendText(res, 404, "Not Found");
+			});
+			return;
+		}
+		sendText(res, 404, "Not Found");
+	});
+	await new Promise((resolve, reject) => {
+		server.once("error", reject);
+		server.listen(port, () => resolve());
+	});
+	const address = server.address();
+	if (!address || typeof address === "string") {
+		await new Promise((resolve) => server.close(() => resolve()));
+		throw new Error("Failed to resolve host port");
+	}
+	resolvedPort = address.port;
+	return {
+		port: resolvedPort,
+		close: async () => {
+			await new Promise((resolve) => server.close(() => resolve()));
+		}
+	};
+}
+
+//#endregion
+exports.startDirectModuleHost = startDirectModuleHost;
+//# sourceMappingURL=host.cjs.map

package/dist/dev/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.cjs","names":["createServer"],"sources":["../../src/dev/host.ts"],"sourcesContent":["import type http from \"node:http\";\nimport { createServer } from \"node:http\";\n\nconst corsHeaders = {\n  \"Access-Control-Allow-Origin\": \"*\",\n  \"Access-Control-Allow-Methods\": \"GET, POST, PUT, DELETE, PATCH, OPTIONS\",\n  \"Access-Control-Allow-Headers\": \"X-Requested-With, content-type, Authorization\",\n};\n\nconst applyCorsHeaders = (res: http.ServerResponse) => {\n  Object.entries(corsHeaders).forEach(([key, value]) => {\n    res.setHeader(key, value);\n  });\n};\n\nconst sendJson = (res: http.ServerResponse, status: number, body: unknown) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  res.end(JSON.stringify(body));\n};\n\nconst sendText = (res: http.ServerResponse, status: number, text: string) => {\n  res.statusCode = status;\n  res.setHeader(\"content-type\", \"text/plain; charset=utf-8\");\n  res.end(text);\n};\n\nconst pathnameOf = (req: http.IncomingMessage): string =>\n  ((req.url ?? \"/\").split(\"?\")[0] ?? \"/\").replace(/\\/+$/, \"\") || \"/\";\n\nconst toWebRequest = (req: http.IncomingMessage, port: number): Request => {\n  const url = `http://localhost:${port}${req.url}`;\n  return new Request(url, {\n    method: req.method,\n    headers: req.headers,\n    body: req.method !== \"GET\" && req.method !== \"HEAD\" ? req : undefined,\n    duplex: req.method !== \"GET\" && req.method !== \"HEAD\" ? \"half\" : undefined,\n  } as RequestInit);\n};\n\nconst buildHostContext = (\n  effectContext: unknown,\n  webRequest: Request,\n  cachedRawBodyRef: { value: string | null },\n) => {\n  const rawClone =\n    webRequest.method === \"GET\" || webRequest.method === \"HEAD\" ? null : webRequest.clone();\n\n  return {\n    reqHeaders: webRequest.headers,\n    \"effect/context\": effectContext,\n    getRawBody: async (): Promise<string> => {\n      if (cachedRawBodyRef.value !== null) return cachedRawBodyRef.value;\n      if (!rawClone) {\n        cachedRawBodyRef.value = \"\";\n        return cachedRawBodyRef.value;\n      }\n      cachedRawBodyRef.value = await rawClone.text();\n      return cachedRawBodyRef.value;\n    },\n  };\n};\n\nexport interface DirectModuleHostHandler {\n  handle(\n    request: Request,\n    options: { prefix: string; context: unknown },\n  ): Promise<{ response?: Response }>;\n}\n\nconst handleOrpc = async (\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  handler: DirectModuleHostHandler,\n  prefix: string,\n  errorLabel: string,\n  effectContext: unknown,\n  port: number,\n) => {\n  try {\n    const webRequest = toWebRequest(req, port);\n    const cachedRawBodyRef = { value: null as string | null };\n    const result = await handler.handle(webRequest, {\n      prefix,\n      context: buildHostContext(effectContext, webRequest, cachedRawBodyRef),\n    });\n\n    if (result.response) {\n      res.statusCode = result.response.status;\n      result.response.headers.forEach((value: string, key: string) => {\n        res.setHeader(key, value);\n      });\n      const text = await result.response.text();\n      if (!res.getHeader(\"content-length\")) {\n        res.setHeader(\"content-length\", Buffer.byteLength(text).toString());\n      }\n      res.end(text);\n    } else {\n      sendText(res, 404, \"Not Found\");\n    }\n  } catch (error) {\n    console.error(`${errorLabel} error:`, error);\n    sendJson(res, 500, { error: (error as Error).message });\n  }\n};\n\nexport interface DirectModuleHostHandlers {\n  rpc: DirectModuleHostHandler | null;\n  api: DirectModuleHostHandler | null;\n}\n\nexport interface DirectModuleHostOptions {\n  name: string;\n  handlers: DirectModuleHostHandlers;\n  effectContext: unknown;\n  port?: number;\n  version?: string;\n  rpcPrefix?: `/${string}`;\n  apiPrefix?: `/${string}`;\n  staticHandler?:\n    | ((req: http.IncomingMessage, res: http.ServerResponse, next: () => void) => void)\n    | null;\n}\n\nexport interface DirectModuleHostHandle {\n  port: number;\n  close: () => Promise<void>;\n}\n\nexport async function startDirectModuleHost(\n  options: DirectModuleHostOptions,\n): Promise<DirectModuleHostHandle> {\n  const port = options.port ?? 0;\n  let resolvedPort = port;\n  const rpcPrefix = options.rpcPrefix ?? \"/api/rpc\";\n  const apiPrefix = options.apiPrefix ?? \"/api\";\n  const staticHandler = options.staticHandler ?? null;\n  const resolveEffectContext: () => unknown =\n    typeof options.effectContext === \"function\"\n      ? (options.effectContext as () => unknown)\n      : () => options.effectContext;\n\n  const server = createServer((req, res) => {\n    applyCorsHeaders(res);\n    const pathname = pathnameOf(req);\n\n    if (req.method === \"OPTIONS\") {\n      res.statusCode = 200;\n      res.end();\n      return;\n    }\n\n    if (pathname === \"/\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendJson(res, 200, {\n        ok: true,\n        module: options.name,\n        version: options.version,\n        status: options.handlers.rpc ? \"ready\" : \"loading\",\n        endpoints: {\n          health: \"/health\",\n          docs: apiPrefix,\n          rpc: rpcPrefix,\n        },\n      });\n      return;\n    }\n\n    if (pathname === \"/health\" && (req.method === \"GET\" || req.method === \"HEAD\")) {\n      sendText(res, 200, \"OK\");\n      return;\n    }\n\n    if (pathname.startsWith(`${rpcPrefix}/`)) {\n      if (!options.handlers.rpc) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(\n        req,\n        res,\n        options.handlers.rpc,\n        rpcPrefix,\n        \"RPC\",\n        resolveEffectContext(),\n        resolvedPort,\n      ).catch(() => {});\n      return;\n    }\n\n    if (pathname === apiPrefix || pathname.startsWith(`${apiPrefix}/`)) {\n      if (!options.handlers.api) {\n        sendJson(res, 503, { error: \"Plugin still loading...\" });\n        return;\n      }\n      handleOrpc(\n        req,\n        res,\n        options.handlers.api,\n        apiPrefix,\n        \"OpenAPI\",\n        resolveEffectContext(),\n        resolvedPort,\n      ).catch(() => {});\n      return;\n    }\n\n    if (staticHandler) {\n      staticHandler(req, res, () => {\n        sendText(res, 404, \"Not Found\");\n      });\n      return;\n    }\n\n    sendText(res, 404, \"Not Found\");\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject);\n    server.listen(port, () => resolve());\n  });\n\n  const address = server.address();\n  if (!address || typeof address === \"string\") {\n    await new Promise<void>((resolve) => server.close(() => resolve()));\n    throw new Error(\"Failed to resolve host port\");\n  }\n  resolvedPort = address.port;\n\n  return {\n    port: resolvedPort,\n    close: async () => {\n      await new Promise<void>((resolve) => server.close(() => resolve()));\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/dev/host.d.cts

@@ -0,0 +1,32 @@
+import http from "node:http";
+//#region src/dev/host.d.ts
+interface DirectModuleHostHandler {
+  handle(request: Request, options: {
+    prefix: string;
+    context: unknown;
+  }): Promise<{
+    response?: Response;
+  }>;
+}
+interface DirectModuleHostHandlers {
+  rpc: DirectModuleHostHandler | null;
+  api: DirectModuleHostHandler | null;
+}
+interface DirectModuleHostOptions {
+  name: string;
+  handlers: DirectModuleHostHandlers;
+  effectContext: unknown;
+  port?: number;
+  version?: string;
+  rpcPrefix?: `/${string}`;
+  apiPrefix?: `/${string}`;
+  staticHandler?: ((req: http.IncomingMessage, res: http.ServerResponse, next: () => void) => void) | null;
+}
+interface DirectModuleHostHandle {
+  port: number;
+  close: () => Promise<void>;
+}
+declare function startDirectModuleHost(options: DirectModuleHostOptions): Promise<DirectModuleHostHandle>;
+//#endregion
+export { DirectModuleHostHandle, DirectModuleHostHandler, DirectModuleHostHandlers, DirectModuleHostOptions, startDirectModuleHost };
+//# sourceMappingURL=host.d.cts.map

package/dist/dev/host.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.cts","names":[],"sources":["../../src/dev/host.ts"],"mappings":";;UA+DiB;EACf,OACE,SAAS,SACT;IAAW;IAAgB;MAC1B;IAAU,WAAW;;;UAuCT;EACf,KAAK;EACL,KAAK;;UAGU;EACf;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA,kBACM,KAAK,KAAK,iBAAiB,KAAK,KAAK,gBAAgB;;UAI5C;EACf;EACA,aAAa;;iBAGO,sBACpB,SAAS,0BACR,QAAQ"}

package/dist/dev/host.d.mts

@@ -0,0 +1,32 @@
+import http from "node:http";
+//#region src/dev/host.d.ts
+interface DirectModuleHostHandler {
+  handle(request: Request, options: {
+    prefix: string;
+    context: unknown;
+  }): Promise<{
+    response?: Response;
+  }>;
+}
+interface DirectModuleHostHandlers {
+  rpc: DirectModuleHostHandler | null;
+  api: DirectModuleHostHandler | null;
+}
+interface DirectModuleHostOptions {
+  name: string;
+  handlers: DirectModuleHostHandlers;
+  effectContext: unknown;
+  port?: number;
+  version?: string;
+  rpcPrefix?: `/${string}`;
+  apiPrefix?: `/${string}`;
+  staticHandler?: ((req: http.IncomingMessage, res: http.ServerResponse, next: () => void) => void) | null;
+}
+interface DirectModuleHostHandle {
+  port: number;
+  close: () => Promise<void>;
+}
+declare function startDirectModuleHost(options: DirectModuleHostOptions): Promise<DirectModuleHostHandle>;
+//#endregion
+export { DirectModuleHostHandle, DirectModuleHostHandler, DirectModuleHostHandlers, DirectModuleHostOptions, startDirectModuleHost };
+//# sourceMappingURL=host.d.mts.map

package/dist/dev/host.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.mts","names":[],"sources":["../../src/dev/host.ts"],"mappings":";;UA+DiB;EACf,OACE,SAAS,SACT;IAAW;IAAgB;MAC1B;IAAU,WAAW;;;UAuCT;EACf,KAAK;EACL,KAAK;;UAGU;EACf;EACA,UAAU;EACV;EACA;EACA;EACA;EACA;EACA,kBACM,KAAK,KAAK,iBAAiB,KAAK,KAAK,gBAAgB;;UAI5C;EACf;EACA,aAAa;;iBAGO,sBACpB,SAAS,0BACR,QAAQ"}