@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/typescript-service/templates/README.md.hbs

@@ -0,0 +1,85 @@
+# {{pascalCase name}}
+
+{{#if description}}
+{{description}}
+{{else}}
+A TypeScript service generated by Arbiter CLI.
+{{/if}}
+
+## Getting Started
+
+### Prerequisites
+
+- [Bun](https://bun.sh/) runtime
+{{#if includeDb}}
+- PostgreSQL database
+{{/if}}
+
+### Installation
+
+```bash
+bun install
+```
+
+### Development
+
+```bash
+bun run dev
+```
+
+The service will start at `http://localhost:3000`.
+
+### Building
+
+```bash
+bun run build
+```
+
+### Running in Production
+
+```bash
+bun run start
+```
+
+## API Endpoints
+
+### Health Check
+
+- `GET /health` - Service health status
+- `GET /health/ready` - Readiness check
+- `GET /health/live` - Liveness check
+
+{{#if includeDb}}
+## Database
+
+This service uses Drizzle ORM with PostgreSQL.
+
+### Migrations
+
+```bash
+bun run drizzle-kit generate:pg
+bun run drizzle-kit push:pg
+```
+
+### Environment Variables
+
+- `DATABASE_URL` - PostgreSQL connection string
+{{/if}}
+
+## Docker
+
+Build the image:
+
+```bash
+docker build -t {{kebabCase name}} .
+```
+
+Run the container:
+
+```bash
+docker run -p 3000:3000 {{kebabCase name}}
+```
+
+## License
+
+MIT

package/dist/templates/plopfiles/typescript-service/templates/config.ts.hbs

@@ -0,0 +1,15 @@
+/**
+ * Service Configuration
+ */
+
+export const config = {
+  port: parseInt(process.env.PORT ?? "3000", 10),
+  env: process.env.NODE_ENV ?? "development",
+{{#if includeDb}}
+  database: {
+    url: process.env.DATABASE_URL ?? "postgres://localhost:5432/{{snakeCase name}}",
+  },
+{{/if}}
+};
+
+export type Config = typeof config;

package/dist/templates/plopfiles/typescript-service/templates/db/index.ts.hbs

@@ -0,0 +1,19 @@
+/**
+ * Database connection and initialization
+ */
+
+import { drizzle } from "drizzle-orm/postgres-js";
+import postgres from "postgres";
+import { config } from "../config.js";
+import * as schema from "./schema.js";
+
+const client = postgres(config.database.url);
+export const db = drizzle(client, { schema });
+
+export async function initDb(): Promise<void> {
+  console.log("📦 Connecting to database...");
+  // Run any initialization logic here
+  console.log("✅ Database connected");
+}
+
+export { schema };

package/dist/templates/plopfiles/typescript-service/templates/db/schema.ts.hbs

@@ -0,0 +1,16 @@
+/**
+ * Database schema definitions
+ */
+
+import { pgTable, serial, text, timestamp, varchar } from "drizzle-orm/pg-core";
+
+export const examples = pgTable("examples", {
+  id: serial("id").primaryKey(),
+  name: varchar("name", { length: 255 }).notNull(),
+  description: text("description"),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  updatedAt: timestamp("updated_at").defaultNow().notNull(),
+});
+
+export type Example = typeof examples.$inferSelect;
+export type NewExample = typeof examples.$inferInsert;

package/dist/templates/plopfiles/typescript-service/templates/index.ts.hbs

@@ -0,0 +1,89 @@
+/**
+ * {{pascalCase name}} Service
+ *
+ * Generated by Arbiter CLI
+ */
+
+{{#if (eq framework "hono")}}
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { logger } from "hono/logger";
+import { cors } from "hono/cors";
+{{else if (eq framework "express")}}
+import express from "express";
+import cors from "cors";
+{{else}}
+import Fastify from "fastify";
+{{/if}}
+
+import { config } from "./config.js";
+import { routes } from "./routes/index.js";
+{{#if includeDb}}
+import { initDb } from "./db/index.js";
+{{/if}}
+
+{{#if (eq framework "hono")}}
+const app = new Hono();
+
+// Middleware
+app.use("*", logger());
+app.use("*", cors());
+
+// Routes
+app.route("/", routes);
+
+// Start server
+{{#if includeDb}}
+initDb().then(() => {
+{{/if}}
+  serve({
+    fetch: app.fetch,
+    port: config.port,
+  }, (info) => {
+    console.log(`🚀 {{pascalCase name}} listening on http://localhost:${info.port}`);
+  });
+{{#if includeDb}}
+});
+{{/if}}
+{{else if (eq framework "express")}}
+const app = express();
+
+// Middleware
+app.use(cors());
+app.use(express.json());
+
+// Routes
+app.use("/", routes);
+
+// Start server
+{{#if includeDb}}
+initDb().then(() => {
+{{/if}}
+  app.listen(config.port, () => {
+    console.log(`🚀 {{pascalCase name}} listening on http://localhost:${config.port}`);
+  });
+{{#if includeDb}}
+});
+{{/if}}
+{{else}}
+const app = Fastify({ logger: true });
+
+// Routes
+app.register(routes);
+
+// Start server
+const start = async () => {
+{{#if includeDb}}
+  await initDb();
+{{/if}}
+  try {
+    await app.listen({ port: config.port });
+    console.log(`🚀 {{pascalCase name}} listening on http://localhost:${config.port}`);
+  } catch (err) {
+    app.log.error(err);
+    process.exit(1);
+  }
+};
+
+start();
+{{/if}}

package/dist/templates/plopfiles/typescript-service/templates/package.json.hbs

@@ -0,0 +1,36 @@
+{
+  "name": "{{kebabCase name}}",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node",
+    "start": "bun run dist/index.js",
+    "test": "bun test",
+    "lint": "biome check .",
+    "format": "biome format --write ."
+  },
+  "dependencies": {
+{{#if (eq framework "hono")}}
+    "hono": "^4.0.0",
+    "@hono/node-server": "^1.8.0"
+{{else if (eq framework "express")}}
+    "express": "^4.18.0",
+    "@types/express": "^4.17.0"
+{{else}}
+    "fastify": "^4.25.0"
+{{/if}}
+{{#if includeDb}}
+    ,"drizzle-orm": "^0.29.0",
+    "postgres": "^3.4.0"
+{{/if}}
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.0",
+    "@biomejs/biome": "^1.5.0"
+{{#if includeDb}}
+    ,"drizzle-kit": "^0.20.0"
+{{/if}}
+  }
+}

package/dist/templates/plopfiles/typescript-service/templates/routes/health.ts.hbs

@@ -0,0 +1,61 @@
+/**
+ * Health check routes
+ */
+
+{{#if (eq framework "hono")}}
+import { Hono } from "hono";
+
+export const healthRoutes = new Hono();
+
+healthRoutes.get("/", (c) => {
+  return c.json({
+    status: "ok",
+    service: "{{kebabCase name}}",
+    timestamp: new Date().toISOString(),
+  });
+});
+
+healthRoutes.get("/ready", (c) => {
+  // Add readiness checks here (db connection, etc.)
+  return c.json({ ready: true });
+});
+
+healthRoutes.get("/live", (c) => {
+  return c.json({ live: true });
+});
+{{else if (eq framework "express")}}
+import { Router } from "express";
+
+export const healthRoutes = Router();
+
+healthRoutes.get("/", (req, res) => {
+  res.json({
+    status: "ok",
+    service: "{{kebabCase name}}",
+    timestamp: new Date().toISOString(),
+  });
+});
+
+healthRoutes.get("/ready", (req, res) => {
+  // Add readiness checks here (db connection, etc.)
+  res.json({ ready: true });
+});
+
+healthRoutes.get("/live", (req, res) => {
+  res.json({ live: true });
+});
+{{else}}
+import type { FastifyInstance } from "fastify";
+
+export async function healthRoutes(app: FastifyInstance) {
+  app.get("/", async () => ({
+    status: "ok",
+    service: "{{kebabCase name}}",
+    timestamp: new Date().toISOString(),
+  }));
+
+  app.get("/ready", async () => ({ ready: true }));
+
+  app.get("/live", async () => ({ live: true }));
+}
+{{/if}}

package/dist/templates/plopfiles/typescript-service/templates/routes/index.ts.hbs

@@ -0,0 +1,35 @@
+/**
+ * Route definitions for {{pascalCase name}}
+ */
+
+{{#if (eq framework "hono")}}
+import { Hono } from "hono";
+import { healthRoutes } from "./health.js";
+
+export const routes = new Hono();
+
+routes.route("/health", healthRoutes);
+
+// Add more routes here
+// routes.route("/api/v1", apiRoutes);
+{{else if (eq framework "express")}}
+import { Router } from "express";
+import { healthRoutes } from "./health.js";
+
+export const routes = Router();
+
+routes.use("/health", healthRoutes);
+
+// Add more routes here
+// routes.use("/api/v1", apiRoutes);
+{{else}}
+import type { FastifyInstance } from "fastify";
+import { healthRoutes } from "./health.js";
+
+export async function routes(app: FastifyInstance) {
+  app.register(healthRoutes, { prefix: "/health" });
+
+  // Add more routes here
+  // app.register(apiRoutes, { prefix: "/api/v1" });
+}
+{{/if}}

package/dist/templates/plopfiles/typescript-service/templates/tsconfig.json.hbs

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "types": ["bun-types"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/templates/plopfiles/typescript-service/templates/types.ts.hbs

@@ -0,0 +1,28 @@
+/**
+ * Shared types for {{pascalCase name}}
+ */
+
+export interface ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+  };
+}
+
+export interface PaginatedResponse<T> extends ApiResponse<T[]> {
+  pagination: {
+    page: number;
+    pageSize: number;
+    total: number;
+    totalPages: number;
+  };
+}
+
+export interface HealthStatus {
+  status: "ok" | "degraded" | "unhealthy";
+  service: string;
+  timestamp: string;
+  checks?: Record<string, boolean>;
+}

package/dist/templates/typescript/component.module.css.tpl

@@ -0,0 +1,6 @@
+.container {
+  /* {{componentName}} component styles */
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}

package/dist/templates/typescript/component.test.tsx.tpl

@@ -0,0 +1,9 @@
+import { render, screen } from '@testing-library/react';
+import { {{componentName}} } from './{{componentName}}';
+
+describe('{{componentName}}', () => {
+  it('renders successfully', () => {
+    render(<{{componentName}} {{testProps}}/>);
+    expect(screen.getByText('{{componentName}}')).toBeInTheDocument();
+  });
+});

package/dist/templates/typescript/component.tsx.tpl

@@ -0,0 +1,17 @@
+{{propsImport}}
+{{cssImport}}
+
+/**
+ * {{componentName}} Component
+ * {{componentDescription}}
+ */
+export function {{componentName}}({{propsParam}}) {
+  return (
+    <div{{containerClass}}>
+      <h1>{{componentName}}</h1>
+      {/* Component content */}
+    </div>
+  );
+}
+
+{{componentName}}.displayName = '{{componentName}}';

package/dist/templates/typescript/component.types.ts.tpl

@@ -0,0 +1,3 @@
+export interface {{componentName}}Props {
+{{propsInterface}}
+}

package/dist/templates/typescript/project/nextjs/app/globals.css.tpl

@@ -0,0 +1,10 @@
+:root {
+  color-scheme: light dark;
+  font-family: system-ui, sans-serif;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  margin: 0;
+}

package/dist/templates/typescript/project/nextjs/app/layout.tsx.tpl

@@ -0,0 +1,15 @@
+import './globals.css';
+import type { Metadata } from 'next';
+
+export const metadata: Metadata = {
+  title: '{{projectName}}',
+  description: '{{projectDescription}}',
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/dist/templates/typescript/project/nextjs/app/page.tsx.tpl

@@ -0,0 +1,8 @@
+export default function Home() {
+  return (
+    <main>
+      <h1>{{projectName}}</h1>
+      <p>Welcome to your Next.js project generated by Arbiter.</p>
+    </main>
+  );
+}

package/dist/templates/typescript/project/nextjs/babel.config.js.tpl

@@ -0,0 +1,8 @@
+module.exports = {
+  presets: ['next/babel'],
+  env: {
+    test: {
+      plugins: ['babel-plugin-dynamic-import-node'],
+    },
+  },
+};

package/dist/templates/typescript/project/nextjs/jest.config.js.tpl

@@ -0,0 +1,10 @@
+const nextJest = require('next/jest');
+
+const createJestConfig = nextJest({ dir: './' });
+
+const customJestConfig = {
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
+  testEnvironment: 'jsdom',
+};
+
+module.exports = createJestConfig(customJestConfig);

package/dist/templates/typescript/project/nextjs/jest.setup.ts.tpl

@@ -0,0 +1,6 @@
+import '@testing-library/jest-dom/extend-expect';
+import preloadAll from 'jest-next-dynamic';
+
+beforeAll(async () => {
+  await preloadAll();
+});

package/dist/templates/typescript/project/nextjs/next-env.d.ts.tpl

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/basic-features/typescript for more information.

package/dist/templates/typescript/project/nextjs/next.config.js.tpl

@@ -0,0 +1,9 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  experimental: {
+    appDir: true,
+  },
+};
+
+export default nextConfig;

package/dist/templates/typescript/project/nextjs/package.json.tpl

@@ -0,0 +1 @@
+{{packageJson}}

package/dist/templates/typescript/project/nextjs/tsconfig.json.tpl

@@ -0,0 +1 @@
+{{tsconfig}}

package/dist/templates/typescript/project/vite/App.css.tpl

@@ -0,0 +1,8 @@
+:root {
+  color-scheme: light dark;
+  font-family: system-ui, sans-serif;
+}
+
+body {
+  margin: 0;
+}

package/dist/templates/typescript/project/vite/App.tsx.tpl

@@ -0,0 +1,17 @@
+import { BrowserRouter } from 'react-router-dom';
+import { Suspense } from 'react';
+import { routes } from './routes';
+import { AppRoutes } from './routes/AppRoutes';
+import './App.css';
+
+export function App() {
+  return (
+    <BrowserRouter>
+      <Suspense fallback={<div>Loading...</div>}>
+        <AppRoutes routes={routes} />
+      </Suspense>
+    </BrowserRouter>
+  );
+}
+
+export default App;

package/dist/templates/typescript/project/vite/index.css.tpl

@@ -0,0 +1,8 @@
+:root {
+  color-scheme: light dark;
+  font-family: system-ui, sans-serif;
+}
+
+body {
+  margin: 0;
+}

package/dist/templates/typescript/project/vite/index.html.tpl

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/dist/templates/typescript/project/vite/main.tsx.tpl

@@ -0,0 +1,10 @@
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import { App } from './App';
+import './index.css';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);

package/dist/templates/typescript/project/vite/package.json.tpl

@@ -0,0 +1 @@
+{{packageJson}}

package/dist/templates/typescript/project/vite/test-setup.ts.tpl

@@ -0,0 +1 @@
+import '@testing-library/jest-dom';

package/dist/templates/typescript/project/vite/tsconfig.build.json.tpl

@@ -0,0 +1 @@
+{{tsconfigBuild}}

package/dist/templates/typescript/project/vite/tsconfig.json.tpl

@@ -0,0 +1 @@
+{{tsconfig}}

package/dist/templates/typescript/project/vite/tsconfig.node.json.tpl

@@ -0,0 +1 @@
+{{tsconfigNode}}

package/dist/templates/typescript/project/vite/vite.config.ts.tpl

@@ -0,0 +1,18 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    port: {{devServerPort}},
+  },
+  build: {
+    target: 'es2022',
+    sourcemap: true{{additionalBuildConfig}}
+  },
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['./src/test-setup.ts'],
+  },
+});

package/dist/templates/typescript/service.api.ts.tpl

@@ -0,0 +1,27 @@
+import express from 'express';
+import type { Request, Response, NextFunction } from 'express';
+
+const router = express.Router();
+
+/**
+ * {{serviceName}} API Routes
+ * Handles all {{serviceName}} related endpoints
+ */
+
+router.get('/', async (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.json({ message: '{{serviceName}} API working' });
+  } catch (error) {
+    next(error);
+  }
+});
+
+router.post('/', async (_req: Request, res: Response, next: NextFunction) => {
+  try {
+    res.status(201).json({ message: '{{serviceName}} created' });
+  } catch (error) {
+    next(error);
+  }
+});
+
+export { router as {{routerName}} };