@diegoaltoworks/chatter 0.45.0 → 0.47.0

package/README.md

@@ -53,7 +53,22 @@ Bun.serve({ port: 8181, fetch: app.fetch });
 npx chatter create-apikey --name "my-app" --expires-in 365d
 ```
 
-**Requirements:** OpenAI API key, Turso database, Bun runtime. See [Requirements Guide](./docs/requirements.md) for setup instructions.
+**Requirements:** OpenAI API key, Turso database, and Bun >= 1.2 or Node >= 24. See [Requirements Guide](./docs/requirements.md) for setup instructions.
+
+### Runtime
+
+The package runs on **Bun or Node** (>= 24 — it is built and published for both,
+and CI loads the built bundles under each). Two things differ:
+
+- **Serving the app** — `Bun.serve({ port: 8181, fetch: app.fetch })` on Bun;
+  `serve({ port: 8181, fetch: app.fetch })` from [`@hono/node-server`](https://github.com/honojs/node-server) on Node.
+- **Static assets** — serving the widget files (`/chatter.js`, `/chatter.css`)
+  and a `publicDir` needs a runtime adapter, picked automatically. On Node that
+  adapter is `@hono/node-server`, an optional peer dependency: install it, or
+  run with `features: { headless: true }` if the server serves no files.
+
+Everything else — the chat pipeline, RAG, channels, the OpenAI-compatible API —
+is runtime-neutral. Development and the quality gates run on Bun.
 
 ## Examples
 

package/dist/core/serve-static.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The one place the server touches a runtime-specific static-file adapter.
+ *
+ * `hono/bun`'s `serveStatic` reads the `Bun` global at import time, so a static
+ * `import` of it makes the whole package Bun-only: `import("./dist/server.mjs")`
+ * under Node throws "Bun is not defined" before a single route is mounted, even
+ * in headless mode where no file is ever served. This module keeps both
+ * adapters behind lazy, literal dynamic imports and picks one from the runtime
+ * actually executing, so the import graph stays runtime-neutral and only a
+ * server that really serves files pays for an adapter.
+ *
+ * Under Node the adapter is `@hono/node-server/serve-static`, an OPTIONAL peer
+ * dependency: a Node consumer running headless never needs it, so a missing
+ * package must not be an import-time failure.
+ */
+import type { MiddlewareHandler } from "hono";
+/** The subset of both adapters' options this package uses. */
+export interface ServeStaticOptions {
+    /** File to serve, relative to `root` (which defaults to the process cwd). */
+    path: string;
+    root?: string;
+}
+export type ServeStaticFn = (options: ServeStaticOptions) => MiddlewareHandler;
+/** Runtimes we have a static-file adapter for. */
+export type StaticRuntime = "bun" | "node";
+/** Module specifier loaded for each runtime — exported so tests can assert the mapping without importing. */
+export declare const STATIC_ADAPTERS: Record<StaticRuntime, string>;
+/** Which adapter the current process needs. Bun exposes a `Bun` global; nothing else does. */
+export declare function detectRuntime(): StaticRuntime;
+/** Wraps a failed adapter import in an actionable message. Exported separately so the wording is unit-testable without simulating a missing module. */
+export declare function wrapMissingAdapterError(runtime: StaticRuntime, cause: unknown): Error;
+/**
+ * Resolve the static-file middleware factory for `runtime`, memoised per
+ * runtime. A rejected load is evicted so a later call can retry (the package
+ * may have been installed in between), mirroring `loadBaileys()`.
+ */
+export declare function loadServeStatic(runtime?: StaticRuntime): Promise<ServeStaticFn>;
+//# sourceMappingURL=serve-static.d.ts.map

package/dist/core/serve-static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-static.d.ts","sourceRoot":"","sources":["../../src/core/serve-static.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,iBAAiB,CAAC;AAE/E,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;AAE3C,6GAA6G;AAC7G,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAGzD,CAAC;AAEF,8FAA8F;AAC9F,wBAAgB,aAAa,IAAI,aAAa,CAE7C;AAED,uJAAuJ;AACvJ,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAUrF;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,aAA+B,GAAG,OAAO,CAAC,aAAa,CAAC,CAkBhG"}

package/dist/index.js

@@ -4265,49 +4265,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative, options, skipNormalization) {
+    function resolveComponent(base, relative2, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative = parse3(serialize(relative, options), options);
+        relative2 = parse3(serialize(relative2, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative.scheme) {
-        target.scheme = relative.scheme;
-        target.userinfo = relative.userinfo;
-        target.host = relative.host;
-        target.port = relative.port;
-        target.path = removeDotSegments(relative.path || "");
-        target.query = relative.query;
+      if (!options.tolerant && relative2.scheme) {
+        target.scheme = relative2.scheme;
+        target.userinfo = relative2.userinfo;
+        target.host = relative2.host;
+        target.port = relative2.port;
+        target.path = removeDotSegments(relative2.path || "");
+        target.query = relative2.query;
       } else {
-        if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-          target.userinfo = relative.userinfo;
-          target.host = relative.host;
-          target.port = relative.port;
-          target.path = removeDotSegments(relative.path || "");
-          target.query = relative.query;
+        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
+          target.userinfo = relative2.userinfo;
+          target.host = relative2.host;
+          target.port = relative2.port;
+          target.path = removeDotSegments(relative2.path || "");
+          target.query = relative2.query;
         } else {
-          if (!relative.path) {
+          if (!relative2.path) {
             target.path = base.path;
-            if (relative.query !== void 0) {
-              target.query = relative.query;
+            if (relative2.query !== void 0) {
+              target.query = relative2.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative.path[0] === "/") {
-              target.path = removeDotSegments(relative.path);
+            if (relative2.path[0] === "/") {
+              target.path = removeDotSegments(relative2.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative.path;
+                target.path = "/" + relative2.path;
               } else if (!base.path) {
-                target.path = relative.path;
+                target.path = relative2.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative.query;
+            target.query = relative2.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -4315,7 +4315,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative.fragment;
+      target.fragment = relative2.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -33178,9 +33178,9 @@ function publicRoutes(deps) {
 }
 
 // src/server.ts
+var import_node_path4 = require("node:path");
 var import_client2 = require("@libsql/client");
 var import_hono5 = require("hono");
-var import_bun = require("hono/bun");
 var import_openai2 = __toESM(require("openai"));
 
 // src/channels/senders.ts
@@ -33235,6 +33235,36 @@ function createSenderRegistry() {
   };
 }
 
+// src/core/serve-static.ts
+var STATIC_ADAPTERS = {
+  bun: "hono/bun",
+  node: "@hono/node-server/serve-static"
+};
+function detectRuntime() {
+  return typeof globalThis.Bun === "undefined" ? "node" : "bun";
+}
+function wrapMissingAdapterError(runtime, cause) {
+  const specifier = STATIC_ADAPTERS[runtime];
+  return new Error(
+    `Serving static files under ${runtime} requires '${specifier}', which could not be loaded. ` + (runtime === "node" ? "Install the optional peer dependency with `npm install @hono/node-server` (or bun/pnpm/yarn), or run Chatter headless (`features.headless: true`) if it should serve no static assets." : "Upgrade 'hono' to a version that ships the Bun adapter."),
+    { cause }
+  );
+}
+var cache = /* @__PURE__ */ new Map();
+function loadServeStatic(runtime = detectRuntime()) {
+  const cached2 = cache.get(runtime);
+  if (cached2) return cached2;
+  const loading = (runtime === "bun" ? import("hono/bun") : import("@hono/node-server/serve-static")).then(
+    (module2) => module2.serveStatic,
+    (error51) => {
+      cache.delete(runtime);
+      throw wrapMissingAdapterError(runtime, error51);
+    }
+  );
+  cache.set(runtime, loading);
+  return loading;
+}
+
 // src/core/widgets.ts
 var import_node_fs3 = require("node:fs");
 var import_node_path3 = require("node:path");
@@ -33313,52 +33343,60 @@ async function createServer(config2) {
       chat: config2.chat || {}
     })
   );
-  if (!headless && staticDir) {
-    const relativePath = require("node:path").relative(process.cwd(), staticDir);
-    app.get("/chatter.js", (0, import_bun.serveStatic)({ path: `${relativePath}/chatter.js` }));
-    app.get("/chatter.css", (0, import_bun.serveStatic)({ path: `${relativePath}/chatter.css` }));
-  }
-  if (!headless && publicDir) {
-    app.get("/", (0, import_bun.serveStatic)({ path: `${publicDir}/index.html` }));
-    app.get("/chat", (0, import_bun.serveStatic)({ path: `${publicDir}/chat.html` }));
-    app.get("/private", (0, import_bun.serveStatic)({ path: `${publicDir}/private.html` }));
-    app.get("/vanilla/chat", (0, import_bun.serveStatic)({ path: `${publicDir}/vanilla/chat.html` }));
+  let serveStatic = null;
+  if (!headless && (staticDir || publicDir)) {
+    try {
+      serveStatic = await loadServeStatic();
+    } catch (error51) {
+      console.error(`\u274C Static assets disabled: ${error51.message}`);
+    }
+  }
+  if (serveStatic && staticDir) {
+    const relativePath = (0, import_node_path4.relative)(process.cwd(), staticDir);
+    app.get("/chatter.js", serveStatic({ path: `${relativePath}/chatter.js` }));
+    app.get("/chatter.css", serveStatic({ path: `${relativePath}/chatter.css` }));
+  }
+  if (serveStatic && publicDir) {
+    app.get("/", serveStatic({ path: `${publicDir}/index.html` }));
+    app.get("/chat", serveStatic({ path: `${publicDir}/chat.html` }));
+    app.get("/private", serveStatic({ path: `${publicDir}/private.html` }));
+    app.get("/vanilla/chat", serveStatic({ path: `${publicDir}/vanilla/chat.html` }));
     app.get(
       "/demo/widget-button-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-button-public.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-button-public.html` })
     );
     app.get(
       "/demo/widget-button-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-button-private.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-button-private.html` })
     );
     app.get(
       "/demo/widget-inline-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-inline-public.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-inline-public.html` })
     );
     app.get(
       "/demo/widget-inline-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-inline-private.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-inline-private.html` })
     );
     app.get(
       "/demo/react-button-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-button-public.html` })
+      serveStatic({ path: `${publicDir}/demo/react-button-public.html` })
     );
     app.get(
       "/demo/react-button-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-button-private.html` })
+      serveStatic({ path: `${publicDir}/demo/react-button-private.html` })
     );
     app.get(
       "/demo/react-inline-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-inline-public.html` })
+      serveStatic({ path: `${publicDir}/demo/react-inline-public.html` })
     );
     app.get(
       "/demo/react-inline-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-inline-private.html` })
+      serveStatic({ path: `${publicDir}/demo/react-inline-private.html` })
     );
-    app.get("/demo/public", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-public.html` }));
-    app.get("/demo/private", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-private.html` }));
-    app.get("/demo/chatbot", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-chatbot.html` }));
-    app.get("/demo/react", (0, import_bun.serveStatic)({ path: `${publicDir}/react-demo.html` }));
+    app.get("/demo/public", serveStatic({ path: `${publicDir}/demo-public.html` }));
+    app.get("/demo/private", serveStatic({ path: `${publicDir}/demo-private.html` }));
+    app.get("/demo/chatbot", serveStatic({ path: `${publicDir}/demo-chatbot.html` }));
+    app.get("/demo/react", serveStatic({ path: `${publicDir}/react-demo.html` }));
   }
   const senders = createSenderRegistry();
   const deps = { client, store, db, config: config2, prompts, apiKeyManager, senders };

package/dist/index.mjs

@@ -4,13 +4,7 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
+var __commonJS = (cb, mod) => function __require() {
   try {
     return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
   } catch (e) {
@@ -4269,49 +4263,49 @@ var require_fast_uri = __commonJS({
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
-    function resolveComponent(base, relative, options, skipNormalization) {
+    function resolveComponent(base, relative2, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
         base = parse3(serialize(base, options), options);
-        relative = parse3(serialize(relative, options), options);
+        relative2 = parse3(serialize(relative2, options), options);
       }
       options = options || {};
-      if (!options.tolerant && relative.scheme) {
-        target.scheme = relative.scheme;
-        target.userinfo = relative.userinfo;
-        target.host = relative.host;
-        target.port = relative.port;
-        target.path = removeDotSegments(relative.path || "");
-        target.query = relative.query;
+      if (!options.tolerant && relative2.scheme) {
+        target.scheme = relative2.scheme;
+        target.userinfo = relative2.userinfo;
+        target.host = relative2.host;
+        target.port = relative2.port;
+        target.path = removeDotSegments(relative2.path || "");
+        target.query = relative2.query;
       } else {
-        if (relative.userinfo !== void 0 || relative.host !== void 0 || relative.port !== void 0) {
-          target.userinfo = relative.userinfo;
-          target.host = relative.host;
-          target.port = relative.port;
-          target.path = removeDotSegments(relative.path || "");
-          target.query = relative.query;
+        if (relative2.userinfo !== void 0 || relative2.host !== void 0 || relative2.port !== void 0) {
+          target.userinfo = relative2.userinfo;
+          target.host = relative2.host;
+          target.port = relative2.port;
+          target.path = removeDotSegments(relative2.path || "");
+          target.query = relative2.query;
         } else {
-          if (!relative.path) {
+          if (!relative2.path) {
             target.path = base.path;
-            if (relative.query !== void 0) {
-              target.query = relative.query;
+            if (relative2.query !== void 0) {
+              target.query = relative2.query;
             } else {
               target.query = base.query;
             }
           } else {
-            if (relative.path[0] === "/") {
-              target.path = removeDotSegments(relative.path);
+            if (relative2.path[0] === "/") {
+              target.path = removeDotSegments(relative2.path);
             } else {
               if ((base.userinfo !== void 0 || base.host !== void 0 || base.port !== void 0) && !base.path) {
-                target.path = "/" + relative.path;
+                target.path = "/" + relative2.path;
               } else if (!base.path) {
-                target.path = relative.path;
+                target.path = relative2.path;
               } else {
-                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative.path;
+                target.path = base.path.slice(0, base.path.lastIndexOf("/") + 1) + relative2.path;
               }
               target.path = removeDotSegments(target.path);
             }
-            target.query = relative.query;
+            target.query = relative2.query;
           }
           target.userinfo = base.userinfo;
           target.host = base.host;
@@ -4319,7 +4313,7 @@ var require_fast_uri = __commonJS({
         }
         target.scheme = base.scheme;
       }
-      target.fragment = relative.fragment;
+      target.fragment = relative2.fragment;
       return target;
     }
     function equal(uriA, uriB, options) {
@@ -33138,9 +33132,9 @@ function publicRoutes(deps) {
 }
 
 // src/server.ts
+import { relative } from "node:path";
 import { createClient as createClient2 } from "@libsql/client";
 import { Hono as Hono5 } from "hono";
-import { serveStatic } from "hono/bun";
 import OpenAI2 from "openai";
 
 // src/channels/senders.ts
@@ -33195,6 +33189,36 @@ function createSenderRegistry() {
   };
 }
 
+// src/core/serve-static.ts
+var STATIC_ADAPTERS = {
+  bun: "hono/bun",
+  node: "@hono/node-server/serve-static"
+};
+function detectRuntime() {
+  return typeof globalThis.Bun === "undefined" ? "node" : "bun";
+}
+function wrapMissingAdapterError(runtime, cause) {
+  const specifier = STATIC_ADAPTERS[runtime];
+  return new Error(
+    `Serving static files under ${runtime} requires '${specifier}', which could not be loaded. ` + (runtime === "node" ? "Install the optional peer dependency with `npm install @hono/node-server` (or bun/pnpm/yarn), or run Chatter headless (`features.headless: true`) if it should serve no static assets." : "Upgrade 'hono' to a version that ships the Bun adapter."),
+    { cause }
+  );
+}
+var cache = /* @__PURE__ */ new Map();
+function loadServeStatic(runtime = detectRuntime()) {
+  const cached2 = cache.get(runtime);
+  if (cached2) return cached2;
+  const loading = (runtime === "bun" ? import("hono/bun") : import("@hono/node-server/serve-static")).then(
+    (module) => module.serveStatic,
+    (error51) => {
+      cache.delete(runtime);
+      throw wrapMissingAdapterError(runtime, error51);
+    }
+  );
+  cache.set(runtime, loading);
+  return loading;
+}
+
 // src/core/widgets.ts
 import { existsSync } from "node:fs";
 import { dirname, join as join3 } from "node:path";
@@ -33272,12 +33296,20 @@ async function createServer(config2) {
       chat: config2.chat || {}
     })
   );
-  if (!headless && staticDir) {
-    const relativePath = __require("node:path").relative(process.cwd(), staticDir);
+  let serveStatic = null;
+  if (!headless && (staticDir || publicDir)) {
+    try {
+      serveStatic = await loadServeStatic();
+    } catch (error51) {
+      console.error(`\u274C Static assets disabled: ${error51.message}`);
+    }
+  }
+  if (serveStatic && staticDir) {
+    const relativePath = relative(process.cwd(), staticDir);
     app.get("/chatter.js", serveStatic({ path: `${relativePath}/chatter.js` }));
     app.get("/chatter.css", serveStatic({ path: `${relativePath}/chatter.css` }));
   }
-  if (!headless && publicDir) {
+  if (serveStatic && publicDir) {
     app.get("/", serveStatic({ path: `${publicDir}/index.html` }));
     app.get("/chat", serveStatic({ path: `${publicDir}/chat.html` }));
     app.get("/private", serveStatic({ path: `${publicDir}/private.html` }));

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAc5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG;IAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAkM7E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAc5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG;IAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CA+M7E"}

package/dist/server.js

@@ -33,9 +33,9 @@ __export(server_exports, {
   createServer: () => createServer
 });
 module.exports = __toCommonJS(server_exports);
+var import_node_path4 = require("node:path");
 var import_client2 = require("@libsql/client");
 var import_hono5 = require("hono");
-var import_bun = require("hono/bun");
 var import_openai = __toESM(require("openai"));
 
 // src/auth/apikeys.ts
@@ -442,6 +442,36 @@ var VectorStore = class _VectorStore {
   }
 };
 
+// src/core/serve-static.ts
+var STATIC_ADAPTERS = {
+  bun: "hono/bun",
+  node: "@hono/node-server/serve-static"
+};
+function detectRuntime() {
+  return typeof globalThis.Bun === "undefined" ? "node" : "bun";
+}
+function wrapMissingAdapterError(runtime, cause) {
+  const specifier = STATIC_ADAPTERS[runtime];
+  return new Error(
+    `Serving static files under ${runtime} requires '${specifier}', which could not be loaded. ` + (runtime === "node" ? "Install the optional peer dependency with `npm install @hono/node-server` (or bun/pnpm/yarn), or run Chatter headless (`features.headless: true`) if it should serve no static assets." : "Upgrade 'hono' to a version that ships the Bun adapter."),
+    { cause }
+  );
+}
+var cache = /* @__PURE__ */ new Map();
+function loadServeStatic(runtime = detectRuntime()) {
+  const cached = cache.get(runtime);
+  if (cached) return cached;
+  const loading = (runtime === "bun" ? import("hono/bun") : import("@hono/node-server/serve-static")).then(
+    (module2) => module2.serveStatic,
+    (error) => {
+      cache.delete(runtime);
+      throw wrapMissingAdapterError(runtime, error);
+    }
+  );
+  cache.set(runtime, loading);
+  return loading;
+}
+
 // src/core/widgets.ts
 var import_node_fs3 = require("node:fs");
 var import_node_path3 = require("node:path");
@@ -1425,52 +1455,60 @@ async function createServer(config) {
       chat: config.chat || {}
     })
   );
-  if (!headless && staticDir) {
-    const relativePath = require("node:path").relative(process.cwd(), staticDir);
-    app.get("/chatter.js", (0, import_bun.serveStatic)({ path: `${relativePath}/chatter.js` }));
-    app.get("/chatter.css", (0, import_bun.serveStatic)({ path: `${relativePath}/chatter.css` }));
+  let serveStatic = null;
+  if (!headless && (staticDir || publicDir)) {
+    try {
+      serveStatic = await loadServeStatic();
+    } catch (error) {
+      console.error(`\u274C Static assets disabled: ${error.message}`);
+    }
+  }
+  if (serveStatic && staticDir) {
+    const relativePath = (0, import_node_path4.relative)(process.cwd(), staticDir);
+    app.get("/chatter.js", serveStatic({ path: `${relativePath}/chatter.js` }));
+    app.get("/chatter.css", serveStatic({ path: `${relativePath}/chatter.css` }));
   }
-  if (!headless && publicDir) {
-    app.get("/", (0, import_bun.serveStatic)({ path: `${publicDir}/index.html` }));
-    app.get("/chat", (0, import_bun.serveStatic)({ path: `${publicDir}/chat.html` }));
-    app.get("/private", (0, import_bun.serveStatic)({ path: `${publicDir}/private.html` }));
-    app.get("/vanilla/chat", (0, import_bun.serveStatic)({ path: `${publicDir}/vanilla/chat.html` }));
+  if (serveStatic && publicDir) {
+    app.get("/", serveStatic({ path: `${publicDir}/index.html` }));
+    app.get("/chat", serveStatic({ path: `${publicDir}/chat.html` }));
+    app.get("/private", serveStatic({ path: `${publicDir}/private.html` }));
+    app.get("/vanilla/chat", serveStatic({ path: `${publicDir}/vanilla/chat.html` }));
     app.get(
       "/demo/widget-button-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-button-public.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-button-public.html` })
     );
     app.get(
       "/demo/widget-button-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-button-private.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-button-private.html` })
     );
     app.get(
       "/demo/widget-inline-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-inline-public.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-inline-public.html` })
     );
     app.get(
       "/demo/widget-inline-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/widget-inline-private.html` })
+      serveStatic({ path: `${publicDir}/demo/widget-inline-private.html` })
     );
     app.get(
       "/demo/react-button-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-button-public.html` })
+      serveStatic({ path: `${publicDir}/demo/react-button-public.html` })
     );
     app.get(
       "/demo/react-button-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-button-private.html` })
+      serveStatic({ path: `${publicDir}/demo/react-button-private.html` })
     );
     app.get(
       "/demo/react-inline-public",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-inline-public.html` })
+      serveStatic({ path: `${publicDir}/demo/react-inline-public.html` })
     );
     app.get(
       "/demo/react-inline-private",
-      (0, import_bun.serveStatic)({ path: `${publicDir}/demo/react-inline-private.html` })
+      serveStatic({ path: `${publicDir}/demo/react-inline-private.html` })
     );
-    app.get("/demo/public", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-public.html` }));
-    app.get("/demo/private", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-private.html` }));
-    app.get("/demo/chatbot", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-chatbot.html` }));
-    app.get("/demo/react", (0, import_bun.serveStatic)({ path: `${publicDir}/react-demo.html` }));
+    app.get("/demo/public", serveStatic({ path: `${publicDir}/demo-public.html` }));
+    app.get("/demo/private", serveStatic({ path: `${publicDir}/demo-private.html` }));
+    app.get("/demo/chatbot", serveStatic({ path: `${publicDir}/demo-chatbot.html` }));
+    app.get("/demo/react", serveStatic({ path: `${publicDir}/react-demo.html` }));
   }
   const senders = createSenderRegistry();
   const deps = { client, store, db, config, prompts, apiKeyManager, senders };

package/dist/server.mjs

@@ -1,14 +1,7 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/server.ts
+import { relative } from "node:path";
 import { createClient as createClient2 } from "@libsql/client";
 import { Hono as Hono5 } from "hono";
-import { serveStatic } from "hono/bun";
 import OpenAI from "openai";
 
 // src/auth/apikeys.ts
@@ -415,6 +408,36 @@ var VectorStore = class _VectorStore {
   }
 };
 
+// src/core/serve-static.ts
+var STATIC_ADAPTERS = {
+  bun: "hono/bun",
+  node: "@hono/node-server/serve-static"
+};
+function detectRuntime() {
+  return typeof globalThis.Bun === "undefined" ? "node" : "bun";
+}
+function wrapMissingAdapterError(runtime, cause) {
+  const specifier = STATIC_ADAPTERS[runtime];
+  return new Error(
+    `Serving static files under ${runtime} requires '${specifier}', which could not be loaded. ` + (runtime === "node" ? "Install the optional peer dependency with `npm install @hono/node-server` (or bun/pnpm/yarn), or run Chatter headless (`features.headless: true`) if it should serve no static assets." : "Upgrade 'hono' to a version that ships the Bun adapter."),
+    { cause }
+  );
+}
+var cache = /* @__PURE__ */ new Map();
+function loadServeStatic(runtime = detectRuntime()) {
+  const cached = cache.get(runtime);
+  if (cached) return cached;
+  const loading = (runtime === "bun" ? import("hono/bun") : import("@hono/node-server/serve-static")).then(
+    (module) => module.serveStatic,
+    (error) => {
+      cache.delete(runtime);
+      throw wrapMissingAdapterError(runtime, error);
+    }
+  );
+  cache.set(runtime, loading);
+  return loading;
+}
+
 // src/core/widgets.ts
 import { existsSync } from "node:fs";
 import { dirname, join as join3 } from "node:path";
@@ -1397,12 +1420,20 @@ async function createServer(config) {
       chat: config.chat || {}
     })
   );
-  if (!headless && staticDir) {
-    const relativePath = __require("node:path").relative(process.cwd(), staticDir);
+  let serveStatic = null;
+  if (!headless && (staticDir || publicDir)) {
+    try {
+      serveStatic = await loadServeStatic();
+    } catch (error) {
+      console.error(`\u274C Static assets disabled: ${error.message}`);
+    }
+  }
+  if (serveStatic && staticDir) {
+    const relativePath = relative(process.cwd(), staticDir);
     app.get("/chatter.js", serveStatic({ path: `${relativePath}/chatter.js` }));
     app.get("/chatter.css", serveStatic({ path: `${relativePath}/chatter.css` }));
   }
-  if (!headless && publicDir) {
+  if (serveStatic && publicDir) {
     app.get("/", serveStatic({ path: `${publicDir}/index.html` }));
     app.get("/chat", serveStatic({ path: `${publicDir}/chat.html` }));
     app.get("/private", serveStatic({ path: `${publicDir}/private.html` }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -78,9 +78,9 @@
     "build": "bun run build:clean && bun run build:types && bun run build:esm && bun run build:cjs && bun run build:server && bun run build:mcp && bun run build:usage && bun run build:personas && bun run build:channels && bun run build:whatsapp && bun run build:flows && bun run build:images && bun run build:scheduler && bun run build:bin && bun run build:client && bun run build:copy-client",
     "build:clean": "rm -rf dist",
     "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
-    "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
-    "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.js --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
-    "build:server": "esbuild src/server.ts --bundle --format=esm --outfile=dist/server.mjs --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24 && esbuild src/server.ts --bundle --format=cjs --outfile=dist/server.js --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
+    "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:@hono/node-server --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
+    "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.js --external:@hono/node-server --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
+    "build:server": "esbuild src/server.ts --bundle --format=esm --outfile=dist/server.mjs --external:@hono/node-server --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24 && esbuild src/server.ts --bundle --format=cjs --outfile=dist/server.js --external:@hono/node-server --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
     "build:mcp": "esbuild src/mcp-server.ts --bundle --format=esm --outfile=dist/mcp-server.mjs --external:@modelcontextprotocol/sdk --external:openai --external:@libsql/client --external:zod --platform=node --target=node24 && esbuild src/mcp-server.ts --bundle --format=cjs --outfile=dist/mcp-server.js --external:@modelcontextprotocol/sdk --external:openai --external:@libsql/client --external:zod --platform=node --target=node24",
     "build:usage": "esbuild src/usage/index.ts --bundle --format=esm --outfile=dist/usage/index.mjs --external:@libsql/client --platform=node --target=node24 && esbuild src/usage/index.ts --bundle --format=cjs --outfile=dist/usage/index.js --external:@libsql/client --platform=node --target=node24",
     "build:personas": "esbuild src/personas/index.ts --bundle --format=esm --outfile=dist/personas/index.mjs --platform=node --target=node24 && esbuild src/personas/index.ts --bundle --format=cjs --outfile=dist/personas/index.js --platform=node --target=node24",
@@ -96,6 +96,7 @@
     "test:unit": "bun test src/**/*.test.ts",
     "test:integration": "bun test test/integration/**/*.test.ts",
     "test:pack": "bun scripts/verify-pack.ts",
+    "test:node": "node scripts/verify-node.mjs",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
     "typecheck": "tsc --noEmit",
@@ -139,9 +140,11 @@
   },
   "homepage": "https://github.com/diegoaltoworks/chatter#readme",
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=24.0.0",
+    "bun": ">=1.2.0"
   },
   "peerDependencies": {
+    "@hono/node-server": "^2.0.5",
     "@libsql/client": "^0.17.2",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@whiskeysockets/baileys": "^7.0.0-rc14",
@@ -151,6 +154,9 @@
     "zod": "^3.25.76 || ^4.4.3"
   },
   "peerDependenciesMeta": {
+    "@hono/node-server": {
+      "optional": true
+    },
     "@whiskeysockets/baileys": {
       "optional": true
     },
@@ -163,6 +169,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.7",
+    "@hono/node-server": "2.0.12",
     "@libsql/client": "0.17.4",
     "@modelcontextprotocol/sdk": "1.30.0",
     "@types/bun": "1.3.14",
@@ -188,7 +195,6 @@
   "overrides": {
     "qs": "^6.15.3",
     "ws": "^8.21.1",
-    "@hono/node-server": "^2.0.5",
     "fast-uri": "^3.1.3",
     "ip-address": "^10.4.0"
   }