@ereo/runtime-bun 0.1.6

package/README.md

@@ -0,0 +1,137 @@
+# @ereo/runtime-bun
+
+Bun runtime adapter for the EreoJS framework. This is the default runtime, optimized for Bun's exceptional performance and built-in features.
+
+## Installation
+
+```bash
+bun add @ereo/runtime-bun
+```
+
+## Quick Start
+
+```typescript
+import { createBunRuntime, serve } from '@ereo/runtime-bun';
+
+// Quick start with defaults
+const runtime = await serve({
+  server: { port: 3000 },
+});
+
+// Or with more control
+const runtime = createBunRuntime({
+  server: {
+    port: 3000,
+    hostname: 'localhost',
+  },
+  config: {
+    // Framework configuration
+  },
+});
+
+runtime.use(myPlugin);
+await runtime.start();
+```
+
+## API
+
+### `createBunRuntime(options?)`
+
+Create a new Bun runtime instance.
+
+```typescript
+const runtime = createBunRuntime({
+  server: { port: 3000 },
+  config: { /* EreoJS config */ },
+});
+```
+
+### `serve(options?)`
+
+Quick start helper that creates and starts the runtime.
+
+```typescript
+const runtime = await serve({ server: { port: 3000 } });
+```
+
+### Runtime Methods
+
+```typescript
+const runtime = createBunRuntime({ server: { port: 3000 } });
+
+// Register plugins
+runtime.use(myPlugin);
+
+// Start the server
+const server = await runtime.start();
+
+// Handle requests directly (useful for testing)
+const response = await runtime.handle(new Request('http://localhost/api/health'));
+
+// Stop the server
+runtime.stop();
+```
+
+## Bun-Specific Utilities
+
+The package includes optimized utilities that leverage Bun's built-in features:
+
+```typescript
+import {
+  readFile,
+  writeFile,
+  readJSON,
+  gzip,
+  gunzip,
+  hashPassword,
+  verifyPassword,
+  randomUUID,
+  sleep,
+  spawn,
+  env,
+  requireEnv,
+  getDatabase,
+} from '@ereo/runtime-bun';
+
+// File operations
+const content = await readFile('./data.txt');
+await writeFile('./output.txt', content);
+const config = await readJSON('./config.json');
+
+// Compression
+const compressed = gzip('Hello World');
+const decompressed = gunzip(compressed);
+
+// Password hashing
+const hash = await hashPassword('secret');
+const valid = await verifyPassword('secret', hash);
+
+// Environment variables
+const apiKey = env('API_KEY', 'default');
+const dbUrl = requireEnv('DATABASE_URL'); // throws if missing
+
+// SQLite database
+const db = await getDatabase('./app.db');
+```
+
+## Key Features
+
+- Native Bun server integration
+- Optimized file I/O with Bun.file
+- Built-in gzip compression
+- Secure password hashing with Bun.password
+- SQLite database support via bun:sqlite
+- Environment variable helpers
+- Process spawning utilities
+
+## Documentation
+
+For full documentation, visit [https://ereo.dev/docs/runtime-bun](https://ereo.dev/docs/runtime-bun)
+
+## Part of EreoJS
+
+This package is part of the [EreoJS monorepo](https://github.com/anthropics/ereo-js).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @ereo/runtime-bun
+ *
+ * Bun runtime adapter for the EreoJS framework.
+ * This is the default runtime, optimized for Bun's performance.
+ */
+import type { Server } from 'bun';
+import type { FrameworkConfig, Plugin } from '@ereo/core';
+import { createApp, EreoApp } from '@ereo/core';
+import { createServer, type ServerOptions } from '@ereo/server';
+/**
+ * Bun runtime options.
+ */
+export interface BunRuntimeOptions {
+    /** Server configuration */
+    server?: ServerOptions;
+    /** Framework configuration */
+    config?: FrameworkConfig;
+}
+/**
+ * Bun runtime adapter.
+ */
+export declare class BunRuntime {
+    private app;
+    private server;
+    private bunServer;
+    private options;
+    constructor(options?: BunRuntimeOptions);
+    /**
+     * Get the EreoJS app instance.
+     */
+    getApp(): EreoApp;
+    /**
+     * Register a plugin.
+     */
+    use(plugin: Plugin): this;
+    /**
+     * Start the server.
+     */
+    start(): Promise<Server<unknown>>;
+    /**
+     * Stop the server.
+     */
+    stop(): void;
+    /**
+     * Handle a request directly (for testing or custom integrations).
+     */
+    handle(request: Request): Promise<Response>;
+}
+/**
+ * Create a Bun runtime.
+ */
+export declare function createBunRuntime(options?: BunRuntimeOptions): BunRuntime;
+/**
+ * Quick start helper.
+ */
+export declare function serve(options?: BunRuntimeOptions): Promise<BunRuntime>;
+/**
+ * Get Bun's SQLite database.
+ * Uses dynamic import to avoid bundling issues in non-Bun environments.
+ */
+export declare function getDatabase(path: string): Promise<import("bun:sqlite").Database>;
+/**
+ * Check if running in Bun.
+ */
+export declare function isBun(): boolean;
+/**
+ * Get Bun version.
+ */
+export declare function getBunVersion(): string;
+/**
+ * Bun-optimized file reading.
+ */
+export declare function readFile(path: string): Promise<string>;
+/**
+ * Bun-optimized file writing.
+ */
+export declare function writeFile(path: string, content: string): Promise<void>;
+/**
+ * Bun-optimized JSON reading.
+ */
+export declare function readJSON<T = unknown>(path: string): Promise<T>;
+/**
+ * Bun-optimized gzip compression.
+ */
+export declare function gzip(data: string | ArrayBuffer): Uint8Array;
+/**
+ * Bun-optimized gunzip decompression.
+ */
+export declare function gunzip(data: ArrayBuffer): Uint8Array;
+/**
+ * Bun password hashing.
+ */
+export declare function hashPassword(password: string): Promise<string>;
+/**
+ * Bun password verification.
+ */
+export declare function verifyPassword(password: string, hash: string): Promise<boolean>;
+/**
+ * Generate crypto-random UUID.
+ */
+export declare function randomUUID(): string;
+/**
+ * Sleep utility using Bun.sleep.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Spawn a shell command.
+ */
+export declare function spawn(command: string[], options?: {
+    cwd?: string;
+    env?: Record<string, string>;
+}): Bun.Subprocess<"ignore", "pipe", "inherit">;
+/**
+ * Get environment variable with type safety.
+ * Uses Bun.env for better Bun compatibility.
+ */
+export declare function env<T extends string = string>(key: string, defaultValue?: T): T;
+/**
+ * Get required environment variable (throws if missing).
+ * Uses Bun.env for better Bun compatibility.
+ */
+export declare function requireEnv(key: string): string;
+export { createApp, createServer };
+export type { FrameworkConfig, Plugin, ServerOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,119 @@
+// @bun
+var __require = import.meta.require;
+
+// src/index.ts
+import { createApp } from "@ereo/core";
+import { createServer } from "@ereo/server";
+
+class BunRuntime {
+  app;
+  server = null;
+  bunServer = null;
+  options;
+  constructor(options = {}) {
+    this.options = options;
+    this.app = createApp({ config: options.config });
+  }
+  getApp() {
+    return this.app;
+  }
+  use(plugin) {
+    this.app.use(plugin);
+    return this;
+  }
+  async start() {
+    this.server = createServer(this.options.server);
+    this.server.setApp(this.app);
+    const server = await this.server.start();
+    this.bunServer = server;
+    return server;
+  }
+  stop() {
+    if (this.server) {
+      this.server.stop();
+    }
+  }
+  async handle(request) {
+    return this.app.handle(request);
+  }
+}
+function createBunRuntime(options) {
+  return new BunRuntime(options);
+}
+async function serve(options) {
+  const runtime = createBunRuntime(options);
+  await runtime.start();
+  return runtime;
+}
+async function getDatabase(path) {
+  const { Database } = await import("bun:sqlite");
+  return new Database(path);
+}
+function isBun() {
+  return typeof Bun !== "undefined";
+}
+function getBunVersion() {
+  return Bun.version;
+}
+async function readFile(path) {
+  return Bun.file(path).text();
+}
+async function writeFile(path, content) {
+  await Bun.write(path, content);
+}
+async function readJSON(path) {
+  return Bun.file(path).json();
+}
+function gzip(data) {
+  return Bun.gzipSync(data);
+}
+function gunzip(data) {
+  return Bun.gunzipSync(data);
+}
+async function hashPassword(password) {
+  return Bun.password.hash(password);
+}
+async function verifyPassword(password, hash) {
+  return Bun.password.verify(password, hash);
+}
+function randomUUID() {
+  return crypto.randomUUID();
+}
+async function sleep(ms) {
+  return Bun.sleep(ms);
+}
+function spawn(command, options) {
+  return Bun.spawn(command, options);
+}
+function env(key, defaultValue) {
+  return Bun.env[key] ?? defaultValue;
+}
+function requireEnv(key) {
+  const value = Bun.env[key];
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${key}`);
+  }
+  return value;
+}
+export {
+  writeFile,
+  verifyPassword,
+  spawn,
+  sleep,
+  serve,
+  requireEnv,
+  readJSON,
+  readFile,
+  randomUUID,
+  isBun,
+  hashPassword,
+  gzip,
+  gunzip,
+  getDatabase,
+  getBunVersion,
+  env,
+  createServer,
+  createBunRuntime,
+  createApp,
+  BunRuntime
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@ereo/runtime-bun",
+  "version": "0.1.6",
+  "license": "MIT",
+  "author": "Ereo Team",
+  "homepage": "https://ereo.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ereojs/ereo.git",
+    "directory": "packages/runtime-bun"
+  },
+  "bugs": {
+    "url": "https://github.com/ereojs/ereo/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --external @ereo/core --external @ereo/server && bun run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist",
+    "dev": "bun build ./src/index.ts --outdir ./dist --target bun --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ereo/core": "workspace:*",
+    "@ereo/server": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "typescript": "^5.4.0"
+  }
+}