@gambrel/bun 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,106 @@
+Required Notice: Copyright (c) 2026 Nolly (https://github.com/thenolle)
+
+# PolyForm Strict License 1.0.0
+
+<https://polyformproject.org/licenses/strict/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the software
+to do everything you might do with the software that would
+otherwise infringe the licensor's copyright in it for any
+permitted purpose, other than distributing the software or
+making changes or new works based on the software.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# @gambrel/bun
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`Bun.serve` adapter
+
+Part of [Gambrel](https://github.com/thenolle/gambrel), a small TypeScript-first, JSX-based full-stack framework for Bun.
+
+## Install
+
+```bash
+bun add @gambrel/bun
+```
+
+## Documentation
+
+See the [Gambrel documentation](https://github.com/thenolle/gambrel/tree/master/docs).
+
+## License
+
+Licensed under the PolyForm-Strict-1.0.0: noncommercial use only, no distribution, no modification. See the LICENSE file.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { serve } from './serve.js';
+export { staticFiles } from './static.js';
+export type { ServeOptions, ServerHandle } from './serve.js';
+export type { StaticFilesOptions } from './static.js';

package/dist/index.js

@@ -0,0 +1,54 @@
+// @bun
+// packages/bun/src/serve.ts
+function serve(app, options = {}) {
+  const server = Bun.serve({
+    port: options.port ?? 3000,
+    development: options.development ?? false,
+    ...options.hostname === undefined ? {} : { hostname: options.hostname },
+    fetch: (request) => app.fetch(request)
+  });
+  return {
+    url: server.url,
+    stop: (closeActiveConnections = false) => server.stop(closeActiveConnections)
+  };
+}
+// packages/bun/src/static.ts
+import { stat } from "fs/promises";
+import { resolve, sep } from "path";
+import { text } from "@gambrel/core";
+function isMissing(error) {
+  return typeof error === "object" && error !== null && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
+}
+function staticFiles(options) {
+  const directory = resolve(options.directory);
+  const prefix = options.prefix.endsWith("/") ? options.prefix : `${options.prefix}/`;
+  return async (ctx, next) => {
+    if (ctx.method !== "GET" && ctx.method !== "HEAD" || !ctx.url.pathname.startsWith(prefix))
+      return next();
+    let relativePath;
+    try {
+      relativePath = decodeURIComponent(ctx.url.pathname.slice(prefix.length));
+    } catch {
+      return text("Bad Request", { status: 400 });
+    }
+    const path = resolve(directory, relativePath);
+    if (relativePath.includes("\x00") || !path.startsWith(directory + sep))
+      return text("Not Found", { status: 404 });
+    try {
+      if (!(await stat(path)).isFile())
+        return text("Not Found", { status: 404 });
+    } catch (error) {
+      if (isMissing(error))
+        return text("Not Found", { status: 404 });
+      throw error;
+    }
+    const file = Bun.file(path);
+    return new Response(ctx.method === "HEAD" ? null : file, {
+      headers: { "content-type": file.type, "cache-control": "no-cache" }
+    });
+  };
+}
+export {
+  serve,
+  staticFiles
+};

package/dist/serve.d.ts

@@ -0,0 +1,24 @@
+import type { App } from '@gambrel/core';
+export interface ServeOptions {
+    /**
+     * TCP port. Use 0 to let the OS pick a free port. Defaults to 3000.
+     */
+    readonly port?: number;
+    /**
+     * Interface to bind. Defaults to Bun's default.
+     */
+    readonly hostname?: string;
+    /**
+     * Enables Bun's development mode (more detailed error pages). Independent of the
+     * application's own `development` option. Defaults to false.
+     */
+    readonly development?: boolean;
+}
+export interface ServerHandle {
+    readonly url: URL;
+    stop(closeActiveConnections?: boolean): Promise<void>;
+}
+/**
+ * Serves an application through `Bun.serve`. Every request is passed to `app.fetch`.
+ */
+export declare function serve(app: Pick<App, 'fetch'>, options?: ServeOptions): ServerHandle;

package/dist/static.d.ts

@@ -0,0 +1,18 @@
+import { type Middleware } from '@gambrel/core';
+export interface StaticFilesOptions {
+    /**
+     * Directory to serve files from.
+     */
+    readonly directory: string;
+    /**
+     * URL prefix, for example `/assets`.
+     */
+    readonly prefix: string;
+}
+/**
+ * Serves files under `prefix` from `directory` for GET and HEAD requests. Requests under
+ * the prefix never fall through: a missing file, a directory or a path that escapes the
+ * directory is a plain-text 404, so a missing asset can never be answered with an HTML page.
+ * Other methods and other paths go to the next handler. Responses use `cache-control: no-cache`.
+ */
+export declare function staticFiles(options: StaticFilesOptions): Middleware;

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@gambrel/bun",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "`Bun.serve` adapter",
+  "license": "PolyForm-Strict-1.0.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@gambrel/core": "^0.2.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thenolle/gambrel.git",
+    "directory": "packages/bun"
+  },
+  "homepage": "https://github.com/thenolle/gambrel#readme",
+  "bugs": {
+    "url": "https://github.com/thenolle/gambrel/issues"
+  },
+  "keywords": [
+    "gambrel",
+    "bun",
+    "typescript",
+    "ssr",
+    "jsx"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}