bun-api-starter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Razi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+<div align="center">
+
+# bun-api-starter
+
+```
+        create-bun-api my-api
+                 |
+                 v
+  .env ──> PORT ──> Elysia ──> /          ( service info )
+                       |  └──> /health    ( health check )
+                       |
+                 bun --watch src/server.ts
+```
+
+**One-command scaffold for a type-safe Bun + Elysia REST API.**
+
+</div>
+
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/bun-api-starter?style=flat-square&color=6f42c1&logo=npm&label=npm)](https://www.npmjs.com/package/bun-api-starter)
+[![downloads](https://img.shields.io/npm/dm/bun-api-starter?style=flat-square&color=7c4dd0)](https://www.npmjs.com/package/bun-api-starter)
+[![license](https://img.shields.io/github/license/knownasrazi/bun-api-starter?style=flat-square&color=5a37a0)](LICENSE)
+[![CI](https://img.shields.io/github/actions/workflow/status/knownasrazi/bun-api-starter/ci.yml?style=flat-square&label=CI)](https://github.com/knownasrazi/bun-api-starter/actions)
+[![bun](https://img.shields.io/badge/runtime-bun-5a37a0?style=flat-square&logo=bun&logoColor=white)](https://bun.sh)
+
+</div>
+
+---
+
+## start an api
+
+```bash
+bunx create-bun-api my-api
+cd my-api
+
+bun install
+bun run dev
+```
+
+Banner appears on `http://localhost:5000`. Port comes from `.env`.
+
+## what lands in the folder
+
+```
+my-api
+|-- package.json        # elysia 1, dotenvx, bun scripts
+|-- tsconfig.json       # strict, bundler resolution
+|-- biome.json          # formatting + linting
+|-- .env.example        # PORT=5000
+|-- src
+|   |-- server.ts       # app, routes, listen
+|   `-- routes
+|       `-- health.ts   # example route module
+`-- README.md           # scaffolded with your name
+```
+
+## routes it ships with
+
+| method | path | response |
+| ------ | ---- | -------- |
+| GET | `/` | `{ "name": "<project>", "status": "online" }` |
+| GET | `/health` | `{ "ok": true }` |
+
+## add a route
+
+```ts
+// src/routes/echo.ts
+import { Elysia } from "elysia";
+
+export const echo = new Elysia().post("/echo", ({ body }) => body, {
+  body: { message: String },
+});
+```
+
+```ts
+// src/server.ts
+import { echo } from "./routes/echo";
+// ...
+const app = new Elysia().get("/", () => ({ status: "online" })).use(echo);
+```
+
+Every route module is just an `Elysia` instance - compose them with `.use()`.
+
+## why this over wrestling setup
+
+| pain | solution |
+| ---- | -------- |
+| Elysia + Bun handshake | pre-wired in `server.ts` |
+| `.env` never loads | dotenvx imported up top |
+| no lint/format baseline | pinned `biome.json` |
+| route files with no pattern | `src/routes/*.ts` + `.use()` |
+
+## details
+
+- Elysia serves OpenAPI at `/swagger` when running with `BUN_RUNTIME_TRANSPILER=1` - see Elysia docs for the recipe.
+- `bun run dev` hot-reloads on save.
+
+## development of this package
+
+```bash
+git clone https://github.com/knownasrazi/bun-api-starter.git
+cd bun-api-starter
+bun install
+bun run release
+```
+
+## license
+
+[MIT](./LICENSE) + [Razi](https://github.com/knownasrazi)
+
+---
+
+<div align="center">
+
+*one command in. an api answering requests.*
+
+</div>

package/dist/chunk-L5ZPLS3Y.js

@@ -0,0 +1,33 @@
+import { mkdir, readdir, readFile, writeFile } from 'fs/promises';
+import { join, dirname, resolve, basename } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/scaffold.ts
+var PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), "..");
+var TEMPLATE_DIR = join(PROJECT_ROOT, "template");
+async function scaffold(targetDir) {
+  const target = resolve(targetDir);
+  const projectName = basename(target);
+  await mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target, projectName);
+  return target;
+}
+async function copyTree(from, to, projectName) {
+  const entries = await readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = join(from, entry.name);
+    const dest = join(to, entry.name);
+    if (entry.isDirectory()) {
+      await mkdir(dest, { recursive: true });
+      await copyTree(src, dest, projectName);
+    } else {
+      let data = await readFile(src, "utf8");
+      data = data.replaceAll("<PACKAGE_NAME>", projectName);
+      await writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+export { TEMPLATE_DIR, scaffold };
+//# sourceMappingURL=chunk-L5ZPLS3Y.js.map
+//# sourceMappingURL=chunk-L5ZPLS3Y.js.map

package/dist/chunk-L5ZPLS3Y.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":[],"mappings":";;;;;AAIA,IAAM,YAAA,GAAe,KAAK,OAAA,CAAQ,aAAA,CAAc,YAAY,GAAG,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAe,IAAA,CAAK,YAAA,EAAc,UAAU;AAEzD,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAAS,QAAQ,SAAS,CAAA;AAChC,EAAA,MAAM,WAAA,GAAc,SAAS,MAAM,CAAA;AACnC,EAAA,MAAM,KAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,YAAA,EAAc,MAAA,EAAQ,WAAW,CAAA;AAChD,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,IAAA,EAAc,EAAA,EAAY,WAAA,EAAoC;AACpF,EAAA,MAAM,UAAU,MAAM,OAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAM,KAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,GAAA,EAAK,IAAA,EAAM,WAAW,CAAA;AAAA,IACvC,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAM,QAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,gBAAA,EAAkB,WAAW,CAAA;AACpD,MAAA,MAAM,SAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF","file":"chunk-L5ZPLS3Y.js","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  const projectName = basename(target);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target, projectName);\n  return target;\n}\n\nasync function copyTree(from: string, to: string, projectName: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest, projectName);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      data = data.replaceAll(\"<PACKAGE_NAME>\", projectName);\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n"]}

package/dist/cli.cjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env bun
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+var PROJECT_ROOT = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href)))), "..");
+var TEMPLATE_DIR = path.join(PROJECT_ROOT, "template");
+async function scaffold(targetDir) {
+  const target = path.resolve(targetDir);
+  const projectName = path.basename(target);
+  await promises.mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target, projectName);
+  return target;
+}
+async function copyTree(from, to, projectName) {
+  const entries = await promises.readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = path.join(from, entry.name);
+    const dest = path.join(to, entry.name);
+    if (entry.isDirectory()) {
+      await promises.mkdir(dest, { recursive: true });
+      await copyTree(src, dest, projectName);
+    } else {
+      let data = await promises.readFile(src, "utf8");
+      data = data.replaceAll("<PACKAGE_NAME>", projectName);
+      await promises.writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+// src/cli.ts
+var name = process.argv[2] ?? "";
+if (name === "") {
+  console.error("usage: create-bun-api <project-name>");
+  process.exit(1);
+}
+if (name.includes(" ")) {
+  console.error("error: project name must be a single word");
+  process.exit(1);
+}
+async function main() {
+  const target = await scaffold(name);
+  console.log(`scaffolded a bun api at ${target}`);
+  console.log("next:");
+  console.log(`  cd ${name}`);
+  console.log("  bun install");
+  console.log("  cp .env.example .env  # optional, PORT defaults to 5000");
+  console.log("  bun run dev");
+}
+void main();
+//# sourceMappingURL=cli.cjs.map
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts","../src/cli.ts"],"names":["join","dirname","fileURLToPath","resolve","basename","mkdir","readdir","readFile","writeFile"],"mappings":";;;;;;;;AAIA,IAAM,YAAA,GAAeA,UAAKC,YAAA,CAAQC,iBAAA,CAAc,yPAAe,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAeF,SAAA,CAAK,YAAA,EAAc,UAAU,CAAA;AAEzD,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAASG,aAAQ,SAAS,CAAA;AAChC,EAAA,MAAM,WAAA,GAAcC,cAAS,MAAM,CAAA;AACnC,EAAA,MAAMC,cAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,YAAA,EAAc,MAAA,EAAQ,WAAW,CAAA;AAChD,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,IAAA,EAAc,EAAA,EAAY,WAAA,EAAoC;AACpF,EAAA,MAAM,UAAU,MAAMC,gBAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAMN,SAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAOA,SAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAMK,cAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,GAAA,EAAK,IAAA,EAAM,WAAW,CAAA;AAAA,IACvC,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAME,iBAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,gBAAA,EAAkB,WAAW,CAAA;AACpD,MAAA,MAAMC,kBAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF;;;AC3BA,IAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,IAAK,EAAA;AAEhC,IAAI,SAAS,EAAA,EAAI;AACf,EAAA,OAAA,CAAQ,MAAM,sCAAsC,CAAA;AACpD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AACA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACtB,EAAA,OAAA,CAAQ,MAAM,2CAA2C,CAAA;AACzD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AAEA,eAAe,IAAA,GAAsB;AACnC,EAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,IAAI,CAAA;AAClC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,wBAAA,EAA2B,MAAM,CAAA,CAAE,CAAA;AAC/C,EAAA,OAAA,CAAQ,IAAI,OAAO,CAAA;AACnB,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAE,CAAA;AAC1B,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC3B,EAAA,OAAA,CAAQ,IAAI,2DAA2D,CAAA;AACvE,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC7B;AAEA,KAAK,IAAA,EAAK","file":"cli.cjs","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  const projectName = basename(target);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target, projectName);\n  return target;\n}\n\nasync function copyTree(from: string, to: string, projectName: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest, projectName);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      data = data.replaceAll(\"<PACKAGE_NAME>\", projectName);\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n","#!/usr/bin/env bun\nimport { scaffold } from \"./scaffold.js\";\n\nconst name = process.argv[2] ?? \"\";\n\nif (name === \"\") {\n  console.error(\"usage: create-bun-api <project-name>\");\n  process.exit(1);\n}\nif (name.includes(\" \")) {\n  console.error(\"error: project name must be a single word\");\n  process.exit(1);\n}\n\nasync function main(): Promise<void> {\n  const target = await scaffold(name);\n  console.log(`scaffolded a bun api at ${target}`);\n  console.log(\"next:\");\n  console.log(`  cd ${name}`);\n  console.log(\"  bun install\");\n  console.log(\"  cp .env.example .env  # optional, PORT defaults to 5000\");\n  console.log(\"  bun run dev\");\n}\n\nvoid main();\n"]}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env bun

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env bun

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env bun
+import { scaffold } from './chunk-L5ZPLS3Y.js';
+
+// src/cli.ts
+var name = process.argv[2] ?? "";
+if (name === "") {
+  console.error("usage: create-bun-api <project-name>");
+  process.exit(1);
+}
+if (name.includes(" ")) {
+  console.error("error: project name must be a single word");
+  process.exit(1);
+}
+async function main() {
+  const target = await scaffold(name);
+  console.log(`scaffolded a bun api at ${target}`);
+  console.log("next:");
+  console.log(`  cd ${name}`);
+  console.log("  bun install");
+  console.log("  cp .env.example .env  # optional, PORT defaults to 5000");
+  console.log("  bun run dev");
+}
+void main();
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"names":[],"mappings":";;;;AAGA,IAAM,IAAA,GAAO,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,IAAK,EAAA;AAEhC,IAAI,SAAS,EAAA,EAAI;AACf,EAAA,OAAA,CAAQ,MAAM,sCAAsC,CAAA;AACpD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AACA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,EAAG;AACtB,EAAA,OAAA,CAAQ,MAAM,2CAA2C,CAAA;AACzD,EAAA,OAAA,CAAQ,KAAK,CAAC,CAAA;AAChB;AAEA,eAAe,IAAA,GAAsB;AACnC,EAAA,MAAM,MAAA,GAAS,MAAM,QAAA,CAAS,IAAI,CAAA;AAClC,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,wBAAA,EAA2B,MAAM,CAAA,CAAE,CAAA;AAC/C,EAAA,OAAA,CAAQ,IAAI,OAAO,CAAA;AACnB,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAE,CAAA;AAC1B,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC3B,EAAA,OAAA,CAAQ,IAAI,2DAA2D,CAAA;AACvE,EAAA,OAAA,CAAQ,IAAI,eAAe,CAAA;AAC7B;AAEA,KAAK,IAAA,EAAK","file":"cli.js","sourcesContent":["#!/usr/bin/env bun\nimport { scaffold } from \"./scaffold.js\";\n\nconst name = process.argv[2] ?? \"\";\n\nif (name === \"\") {\n  console.error(\"usage: create-bun-api <project-name>\");\n  process.exit(1);\n}\nif (name.includes(\" \")) {\n  console.error(\"error: project name must be a single word\");\n  process.exit(1);\n}\n\nasync function main(): Promise<void> {\n  const target = await scaffold(name);\n  console.log(`scaffolded a bun api at ${target}`);\n  console.log(\"next:\");\n  console.log(`  cd ${name}`);\n  console.log(\"  bun install\");\n  console.log(\"  cp .env.example .env  # optional, PORT defaults to 5000\");\n  console.log(\"  bun run dev\");\n}\n\nvoid main();\n"]}

package/dist/index.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var url = require('url');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/scaffold.ts
+var PROJECT_ROOT = path.join(path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))), "..");
+var TEMPLATE_DIR = path.join(PROJECT_ROOT, "template");
+async function scaffold(targetDir) {
+  const target = path.resolve(targetDir);
+  const projectName = path.basename(target);
+  await promises.mkdir(target, { recursive: true });
+  await copyTree(TEMPLATE_DIR, target, projectName);
+  return target;
+}
+async function copyTree(from, to, projectName) {
+  const entries = await promises.readdir(from, { withFileTypes: true });
+  for (const entry of entries) {
+    const src = path.join(from, entry.name);
+    const dest = path.join(to, entry.name);
+    if (entry.isDirectory()) {
+      await promises.mkdir(dest, { recursive: true });
+      await copyTree(src, dest, projectName);
+    } else {
+      let data = await promises.readFile(src, "utf8");
+      data = data.replaceAll("<PACKAGE_NAME>", projectName);
+      await promises.writeFile(dest, data, "utf8");
+    }
+  }
+}
+
+exports.TEMPLATE_DIR = TEMPLATE_DIR;
+exports.scaffold = scaffold;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scaffold.ts"],"names":["join","dirname","fileURLToPath","resolve","basename","mkdir","readdir","readFile","writeFile"],"mappings":";;;;;;;;AAIA,IAAM,YAAA,GAAeA,UAAKC,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,GAAG,IAAI,CAAA;AAEhE,IAAM,YAAA,GAAeF,SAAA,CAAK,YAAA,EAAc,UAAU;AAEzD,eAAsB,SAAS,SAAA,EAAoC;AACjE,EAAA,MAAM,MAAA,GAASG,aAAQ,SAAS,CAAA;AAChC,EAAA,MAAM,WAAA,GAAcC,cAAS,MAAM,CAAA;AACnC,EAAA,MAAMC,cAAA,CAAM,MAAA,EAAQ,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC,EAAA,MAAM,QAAA,CAAS,YAAA,EAAc,MAAA,EAAQ,WAAW,CAAA;AAChD,EAAA,OAAO,MAAA;AACT;AAEA,eAAe,QAAA,CAAS,IAAA,EAAc,EAAA,EAAY,WAAA,EAAoC;AACpF,EAAA,MAAM,UAAU,MAAMC,gBAAA,CAAQ,MAAM,EAAE,aAAA,EAAe,MAAM,CAAA;AAC3D,EAAA,KAAA,MAAW,SAAS,OAAA,EAAS;AAC3B,IAAA,MAAM,GAAA,GAAMN,SAAA,CAAK,IAAA,EAAM,KAAA,CAAM,IAAI,CAAA;AACjC,IAAA,MAAM,IAAA,GAAOA,SAAA,CAAK,EAAA,EAAI,KAAA,CAAM,IAAI,CAAA;AAChC,IAAA,IAAI,KAAA,CAAM,aAAY,EAAG;AACvB,MAAA,MAAMK,cAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACrC,MAAA,MAAM,QAAA,CAAS,GAAA,EAAK,IAAA,EAAM,WAAW,CAAA;AAAA,IACvC,CAAA,MAAO;AACL,MAAA,IAAI,IAAA,GAAO,MAAME,iBAAA,CAAS,GAAA,EAAK,MAAM,CAAA;AACrC,MAAA,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,gBAAA,EAAkB,WAAW,CAAA;AACpD,MAAA,MAAMC,kBAAA,CAAU,IAAA,EAAM,IAAA,EAAM,MAAM,CAAA;AAAA,IACpC;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PROJECT_ROOT = join(dirname(fileURLToPath(import.meta.url)), \"..\");\n\nexport const TEMPLATE_DIR = join(PROJECT_ROOT, \"template\");\n\nexport async function scaffold(targetDir: string): Promise<string> {\n  const target = resolve(targetDir);\n  const projectName = basename(target);\n  await mkdir(target, { recursive: true });\n  await copyTree(TEMPLATE_DIR, target, projectName);\n  return target;\n}\n\nasync function copyTree(from: string, to: string, projectName: string): Promise<void> {\n  const entries = await readdir(from, { withFileTypes: true });\n  for (const entry of entries) {\n    const src = join(from, entry.name);\n    const dest = join(to, entry.name);\n    if (entry.isDirectory()) {\n      await mkdir(dest, { recursive: true });\n      await copyTree(src, dest, projectName);\n    } else {\n      let data = await readFile(src, \"utf8\");\n      data = data.replaceAll(\"<PACKAGE_NAME>\", projectName);\n      await writeFile(dest, data, \"utf8\");\n    }\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,4 @@
+declare const TEMPLATE_DIR: string;
+declare function scaffold(targetDir: string): Promise<string>;
+
+export { TEMPLATE_DIR, scaffold };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+declare const TEMPLATE_DIR: string;
+declare function scaffold(targetDir: string): Promise<string>;
+
+export { TEMPLATE_DIR, scaffold };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { TEMPLATE_DIR, scaffold } from './chunk-L5ZPLS3Y.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "bun-api-starter",
+  "version": "1.0.0",
+  "description": "Scaffold a modern Bun + Elysia REST API with one command. Type-safe routes, zero configuration.",
+  "keywords": [
+    "bun",
+    "elysia",
+    "api",
+    "rest",
+    "starter",
+    "scaffold",
+    "boilerplate",
+    "create",
+    "typescript",
+    "server"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Razi",
+    "url": "https://github.com/knownasrazi"
+  },
+  "type": "module",
+  "bin": {
+    "create-bun-api": "./dist/cli.js"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --diagnostic-level=warn .",
+    "format": "biome format --write .",
+    "release": "bun run lint && bun run typecheck && bun run build && bun test"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/bun": "^1.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.0"
+  }
+}

package/template/.env.example

@@ -0,0 +1 @@
+PORT=5000

package/template/README.md

@@ -0,0 +1,24 @@
+# <PACKAGE_NAME>
+
+A Bun + Elysia API scaffolded with [bun-api-starter](https://github.com/knownasrazi/bun-api-starter).
+
+## setup
+
+```bash
+cp .env.example .env   # optional, PORT defaults to 5000
+bun install
+```
+
+## run
+
+```bash
+bun run dev    # watch mode
+bun run start  # production
+```
+
+## routes
+
+- `GET /` - service info
+- `GET /health` - health check
+
+Every file under `src/routes/` exports an `Elysia` instance; mount them in `src/server.ts` with `.use(...)`.

package/template/biome.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.5.12/schema.json",
+  "files": {
+    "includes": ["**", "!**/dist", "!**/coverage", "!**/node_modules", "!**/bun.lock"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120,
+    "formatWithErrors": false
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended"
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "all"
+    }
+  }
+}

package/template/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "<PACKAGE_NAME>",
+  "version": "0.0.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "bun --watch src/server.ts",
+    "start": "bun src/server.ts",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format --write ."
+  },
+  "dependencies": {
+    "@dotenvx/dotenvx": "^1.40.2",
+    "elysia": "^1.4.29"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/bun": "^1.2.2",
+    "typescript": "^5.9.0"
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,16 @@
+import "@dotenvx/dotenvx/config";
+import { Client } from "seyfert";
+
+const client = new Client({
+  intents: ["Guilds", "GuildMembers", "GuildMessages", "MessageContent"],
+  locations: {
+    base: "src",
+    commands: "commands",
+  },
+});
+
+client.once("ready", () => {
+  console.log("[seyfert] bot is online");
+});
+
+void client.start();

package/template/src/routes/health.ts

@@ -0,0 +1,3 @@
+import { Elysia } from "elysia";
+
+export const health = new Elysia().get("/health", () => ({ ok: true }));

package/template/src/server.ts

@@ -0,0 +1,13 @@
+import "@dotenvx/dotenvx/config";
+import { Elysia } from "elysia";
+import { health } from "./routes/health";
+
+const port = Number(process.env.PORT ?? 5000);
+
+const app = new Elysia()
+  .get("/", () => ({ name: "<PACKAGE_NAME>", status: "online" }))
+  .use(health);
+
+app.listen(port);
+
+console.log(`api up at http://localhost:${port}`);

package/template/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "types": ["@types/bun"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "verbatimModuleSyntax": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}