@ruvyxa/adapter-bun 1.0.19 → 1.0.20

package/dist/index.d.ts

@@ -9,8 +9,17 @@ export interface BunAdapterOptions {
 /**
  * Create a Bun runtime deployment adapter for Ruvyxa.
  *
- * Produces a Bun-optimized server bundle that takes advantage of Bun's
- * native performance features. Deploys to any Bun-compatible hosting.
+ * Produces the same self-contained deployment the node adapter does — a
+ * compiled route registry, the request handler, and a `public/` directory —
+ * and runs it with `bun .ruvyxa/deploy/bun/server/index.mjs`. Bun implements
+ * `node:http`, `import.meta.dirname`, and the Web `Request`/`Response` classes
+ * the handler is written against, so the server source is shared rather than
+ * forked.
+ *
+ * Earlier releases emitted only a launcher that shelled out to
+ * `bunx ruvyxa start`, which meant a Bun host still needed the ruvyxa CLI and
+ * its native binary installed at runtime. The launcher is still emitted for
+ * that workflow; it is no longer the only option.
  *
  * @example
  * ```ts
@@ -18,7 +27,7 @@ export interface BunAdapterOptions {
  * import { bunAdapter } from "@ruvyxa/adapter-bun"
  *
  * export default config({
- *   adapter: bunAdapter({ entry: "./bun-entry.ts" })
+ *   adapter: bunAdapter()
  * })
  * ```
  */

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAA;AAGxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAsCnE;eAEc,UAAU"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAA+B,MAAM,cAAc,CAAA;AAGxE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAsDnE;eAEc,UAAU"}

package/dist/index.js

@@ -1,9 +1,18 @@
-import { clientBuildOutput, validateBuildContext } from '@ruvyxa/core';
+import { clientBuildOutput, standaloneServerSource, validateBuildContext } from '@ruvyxa/core';
 /**
  * Create a Bun runtime deployment adapter for Ruvyxa.
  *
- * Produces a Bun-optimized server bundle that takes advantage of Bun's
- * native performance features. Deploys to any Bun-compatible hosting.
+ * Produces the same self-contained deployment the node adapter does — a
+ * compiled route registry, the request handler, and a `public/` directory —
+ * and runs it with `bun .ruvyxa/deploy/bun/server/index.mjs`. Bun implements
+ * `node:http`, `import.meta.dirname`, and the Web `Request`/`Response` classes
+ * the handler is written against, so the server source is shared rather than
+ * forked.
+ *
+ * Earlier releases emitted only a launcher that shelled out to
+ * `bunx ruvyxa start`, which meant a Bun host still needed the ruvyxa CLI and
+ * its native binary installed at runtime. The launcher is still emitted for
+ * that workflow; it is no longer the only option.
  *
  * @example
  * ```ts
@@ -11,7 +20,7 @@ import { clientBuildOutput, validateBuildContext } from '@ruvyxa/core';
  * import { bunAdapter } from "@ruvyxa/adapter-bun"
  *
  * export default config({
- *   adapter: bunAdapter({ entry: "./bun-entry.ts" })
+ *   adapter: bunAdapter()
  * })
  * ```
  */
@@ -25,6 +34,7 @@ export function bunAdapter(options = {}) {
     return {
         name: 'bun',
         target: 'node',
+        supports: ['ssr', 'ssg', 'csr', 'isr', 'ppr', 'api'],
         build(ctx) {
             validateBuildContext(ctx, 'bunAdapter');
             return {
@@ -36,6 +46,15 @@ export function bunAdapter(options = {}) {
                 assetsDir: `${ctx.outDir}/assets`,
                 ...clientBuildOutput(ctx),
                 artifacts: [
+                    // Standalone server: compiled route registry + handler runtime
+                    {
+                        kind: 'function',
+                        path: 'deploy/bun/server',
+                        handlerSource: standaloneServerSource(),
+                    },
+                    // Static publish directory served by the standalone server. An
+                    // API-only app has no prerendered pages; the server still runs.
+                    { kind: 'static-site', path: 'deploy/bun/public', optional: true },
                     {
                         kind: 'file',
                         path: 'deploy/bun/start.mjs',
@@ -44,7 +63,13 @@ export function bunAdapter(options = {}) {
                     {
                         kind: 'file',
                         path: 'deploy/bun/README.md',
-                        contents: '# Ruvyxa Bun deployment\n\nRun `bun .ruvyxa/deploy/bun/start.mjs` from the application root after installing production dependencies.\n',
+                        contents: '# Ruvyxa Bun deployment\n\n' +
+                            'Standalone (no ruvyxa runtime dependency):\n\n' +
+                            '```bash\nbun .ruvyxa/deploy/bun/server/index.mjs\n```\n\n' +
+                            'Honors `PORT` (default 3000) and `HOST` (default 0.0.0.0). Copy the\n' +
+                            '`deploy/bun/` directory anywhere Bun runs and use the same command.\n\n' +
+                            'Alternative, using the installed ruvyxa CLI:\n\n' +
+                            '```bash\nbun .ruvyxa/deploy/bun/start.mjs\n```\n',
                     },
                 ],
             };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAUtE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAsB,EAAE;IACxD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,uDAAuD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,MAAM;QACd,KAAK,CAAC,GAAiB;YACrB,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YACvC,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,MAAM,aAAa;gBAClD,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,GAAG,iBAAiB,CAAC,GAAG,CAAC;gBACzB,SAAS,EAAE;oBACT;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB;wBAC5B,QAAQ,EAAE,+LAA+L;qBAC1M;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB;wBAC5B,QAAQ,EACN,yIAAyI;qBAC5I;iBACF;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,UAAU,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAU9F;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,UAAU,CAAC,OAAO,GAAsB,EAAE;IACxD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,uDAAuD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;IAC9E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;QACpD,KAAK,CAAC,GAAiB;YACrB,oBAAoB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YACvC,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,MAAM;gBACd,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,MAAM,aAAa;gBAClD,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,SAAS;gBACjC,GAAG,iBAAiB,CAAC,GAAG,CAAC;gBACzB,SAAS,EAAE;oBACT,+DAA+D;oBAC/D;wBACE,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,mBAAmB;wBACzB,aAAa,EAAE,sBAAsB,EAAE;qBACxC;oBACD,+DAA+D;oBAC/D,gEAAgE;oBAChE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAClE;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB;wBAC5B,QAAQ,EAAE,+LAA+L;qBAC1M;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sBAAsB;wBAC5B,QAAQ,EACN,6BAA6B;4BAC7B,gDAAgD;4BAChD,2DAA2D;4BAC3D,uEAAuE;4BACvE,yEAAyE;4BACzE,kDAAkD;4BAClD,kDAAkD;qBACrD;iBACF;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAED,eAAe,UAAU,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruvyxa/adapter-bun",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "Run Ruvyxa on Bun-flavored hosts with typed adapter metadata for entrypoints and assets.",
   "license": "Apache-2.0",
   "type": "module",
@@ -8,6 +8,7 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
+    "src",
     "README.md"
   ],
   "keywords": [
@@ -26,7 +27,7 @@
   },
   "homepage": "https://github.com/thirawat27/ruvyxa#readme",
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=22.12.0"
   },
   "publishConfig": {
     "access": "public"
@@ -38,7 +39,7 @@
     }
   },
   "dependencies": {
-    "@ruvyxa/core": "^1.0.19"
+    "@ruvyxa/core": "^1.0.20"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/index.ts

@@ -0,0 +1,93 @@
+import type { Adapter, AdapterOutput, BuildContext } from '@ruvyxa/core'
+import { clientBuildOutput, standaloneServerSource, validateBuildContext } from '@ruvyxa/core'
+
+/**
+ * Options for the Bun adapter.
+ */
+export interface BunAdapterOptions {
+  /** Custom entry point path. Defaults to `${outDir}/server/app`. */
+  entry?: string
+}
+
+/**
+ * Create a Bun runtime deployment adapter for Ruvyxa.
+ *
+ * Produces the same self-contained deployment the node adapter does — a
+ * compiled route registry, the request handler, and a `public/` directory —
+ * and runs it with `bun .ruvyxa/deploy/bun/server/index.mjs`. Bun implements
+ * `node:http`, `import.meta.dirname`, and the Web `Request`/`Response` classes
+ * the handler is written against, so the server source is shared rather than
+ * forked.
+ *
+ * Earlier releases emitted only a launcher that shelled out to
+ * `bunx ruvyxa start`, which meant a Bun host still needed the ruvyxa CLI and
+ * its native binary installed at runtime. The launcher is still emitted for
+ * that workflow; it is no longer the only option.
+ *
+ * @example
+ * ```ts
+ * import { config } from "ruvyxa/config"
+ * import { bunAdapter } from "@ruvyxa/adapter-bun"
+ *
+ * export default config({
+ *   adapter: bunAdapter()
+ * })
+ * ```
+ */
+export function bunAdapter(options: BunAdapterOptions = {}): Adapter {
+  if (options.entry !== undefined && typeof options.entry !== 'string') {
+    throw new Error(`[RUV2001] bunAdapter: "entry" must be a string, got ${typeof options.entry}`)
+  }
+
+  if (options.entry !== undefined && options.entry.trim() === '') {
+    throw new Error(`[RUV2001] bunAdapter: "entry" must not be an empty string`)
+  }
+
+  return {
+    name: 'bun',
+    target: 'node',
+    supports: ['ssr', 'ssg', 'csr', 'isr', 'ppr', 'api'],
+    build(ctx: BuildContext): AdapterOutput {
+      validateBuildContext(ctx, 'bunAdapter')
+      return {
+        name: 'bun',
+        target: 'node',
+        platform: 'bun',
+        runtime: 'bun',
+        entry: options.entry ?? `${ctx.outDir}/server/app`,
+        assetsDir: `${ctx.outDir}/assets`,
+        ...clientBuildOutput(ctx),
+        artifacts: [
+          // Standalone server: compiled route registry + handler runtime
+          {
+            kind: 'function',
+            path: 'deploy/bun/server',
+            handlerSource: standaloneServerSource(),
+          },
+          // Static publish directory served by the standalone server. An
+          // API-only app has no prerendered pages; the server still runs.
+          { kind: 'static-site', path: 'deploy/bun/public', optional: true },
+          {
+            kind: 'file',
+            path: 'deploy/bun/start.mjs',
+            contents: `const child = Bun.spawn(['bunx', '--no-install', 'ruvyxa', 'start'], { cwd: process.cwd(), stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' })\nprocess.exitCode = await child.exited\n`,
+          },
+          {
+            kind: 'file',
+            path: 'deploy/bun/README.md',
+            contents:
+              '# Ruvyxa Bun deployment\n\n' +
+              'Standalone (no ruvyxa runtime dependency):\n\n' +
+              '```bash\nbun .ruvyxa/deploy/bun/server/index.mjs\n```\n\n' +
+              'Honors `PORT` (default 3000) and `HOST` (default 0.0.0.0). Copy the\n' +
+              '`deploy/bun/` directory anywhere Bun runs and use the same command.\n\n' +
+              'Alternative, using the installed ruvyxa CLI:\n\n' +
+              '```bash\nbun .ruvyxa/deploy/bun/start.mjs\n```\n',
+          },
+        ],
+      }
+    },
+  }
+}
+
+export default bunAdapter