openship 0.1.0

package/apps/api/src/modules/billing/billing.service.ts

@@ -0,0 +1,33 @@
+/**
+ * Billing service — Stripe integration for cloud pricing.
+ *
+ * Self-hosted instances skip billing entirely (gated by CLOUD_MODE env var).
+ */
+
+export async function createCheckoutSession(userId: string, planId: string) {
+  // TODO: Create Stripe Checkout session
+}
+
+export async function createCustomer(userId: string, email: string) {
+  // TODO: Create Stripe customer
+}
+
+export async function getSubscription(userId: string) {
+  // TODO: Fetch active subscription from DB
+}
+
+export async function cancelSubscription(subscriptionId: string) {
+  // TODO: Cancel Stripe subscription at period end
+}
+
+export async function recordUsage(userId: string, metric: string, quantity: number) {
+  // TODO: Record metered usage for billing
+}
+
+export async function getUsageSummary(userId: string) {
+  // TODO: Aggregate usage for current billing period
+}
+
+export async function handleStripeEvent(event: unknown) {
+  // TODO: Handle subscription.created, invoice.paid, etc.
+}

package/apps/api/src/modules/deployments/deployment.controller.ts

@@ -0,0 +1,35 @@
+import type { Context } from "hono";
+
+export async function list(c: Context) {
+  // TODO: List deployments (optionally filtered by projectId)
+  return c.json({ data: [] });
+}
+
+export async function create(c: Context) {
+  // TODO: Trigger new deployment via adapter
+  return c.json({ message: "deployment queued" }, 202);
+}
+
+export async function getById(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Get deployment details + status
+  return c.json({ data: { id } });
+}
+
+export async function logs(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Stream or return deployment logs
+  return c.json({ data: { id, logs: [] } });
+}
+
+export async function rollback(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Rollback to this deployment
+  return c.json({ message: "rollback initiated" });
+}
+
+export async function cancel(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Cancel in-progress deployment
+  return c.json({ message: "deployment cancelled" });
+}

package/apps/api/src/modules/deployments/deployment.routes.ts

@@ -0,0 +1,11 @@
+import { Hono } from "hono";
+import * as deploymentController from "./deployment.controller";
+
+export const deploymentRoutes = new Hono();
+
+deploymentRoutes.get("/", deploymentController.list);
+deploymentRoutes.post("/", deploymentController.create);
+deploymentRoutes.get("/:id", deploymentController.getById);
+deploymentRoutes.get("/:id/logs", deploymentController.logs);
+deploymentRoutes.post("/:id/rollback", deploymentController.rollback);
+deploymentRoutes.post("/:id/cancel", deploymentController.cancel);

package/apps/api/src/modules/deployments/deployment.schema.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+
+export const createDeploymentSchema = z.object({
+  projectId: z.string().uuid(),
+  branch: z.string().default("main"),
+  environment: z.enum(["production", "preview"]).default("production"),
+});

package/apps/api/src/modules/deployments/deployment.service.ts

@@ -0,0 +1,23 @@
+/**
+ * Deployment service — orchestrates builds and deployments via adapters.
+ */
+
+export async function queueDeployment(projectId: string, opts: { branch?: string }) {
+  // TODO: Create deployment record, push to BullMQ queue
+}
+
+export async function processDeployment(deploymentId: string) {
+  // TODO: Pull adapter (Docker / Oblien), build, deploy
+}
+
+export async function getDeploymentLogs(deploymentId: string) {
+  // TODO: Fetch logs from adapter or storage
+}
+
+export async function rollbackDeployment(deploymentId: string) {
+  // TODO: Re-activate a previous deployment
+}
+
+export async function cancelDeployment(deploymentId: string) {
+  // TODO: Signal adapter to stop build
+}

package/apps/api/src/modules/domains/domain.controller.ts

@@ -0,0 +1,21 @@
+import type { Context } from "hono";
+
+export async function list(c: Context) {
+  return c.json({ data: [] });
+}
+
+export async function add(c: Context) {
+  // TODO: Add custom domain, generate DNS verification record
+  return c.json({ message: "domain added" }, 201);
+}
+
+export async function remove(c: Context) {
+  const id = c.req.param("id");
+  return c.json({ message: "domain removed" });
+}
+
+export async function verify(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Check DNS records to verify ownership
+  return c.json({ message: "verification started" });
+}

package/apps/api/src/modules/domains/domain.routes.ts

@@ -0,0 +1,9 @@
+import { Hono } from "hono";
+import * as domainController from "./domain.controller";
+
+export const domainRoutes = new Hono();
+
+domainRoutes.get("/", domainController.list);
+domainRoutes.post("/", domainController.add);
+domainRoutes.delete("/:id", domainController.remove);
+domainRoutes.post("/:id/verify", domainController.verify);

package/apps/api/src/modules/domains/domain.service.ts

@@ -0,0 +1,19 @@
+/**
+ * Domain service — manage custom domains and SSL certificates.
+ */
+
+export async function addDomain(projectId: string, domain: string) {
+  // TODO: Store domain, create TXT verification record
+}
+
+export async function verifyDomain(domainId: string) {
+  // TODO: DNS lookup to check verification
+}
+
+export async function removeDomain(domainId: string) {
+  // TODO: Remove domain and revoke certificate
+}
+
+export async function provisionSSL(domain: string) {
+  // TODO: Issue Let's Encrypt certificate
+}

package/apps/api/src/modules/health/health.routes.ts

@@ -0,0 +1,10 @@
+/**
+ * Health check module — used by load balancers and Docker health checks.
+ */
+import { Hono } from "hono";
+
+export const healthRoutes = new Hono();
+
+healthRoutes.get("/", (c) => {
+  return c.json({ status: "ok", timestamp: new Date().toISOString() });
+});

package/apps/api/src/modules/projects/project.controller.ts

@@ -0,0 +1,29 @@
+import type { Context } from "hono";
+
+export async function list(c: Context) {
+  // TODO: List all projects for authenticated user
+  return c.json({ data: [] });
+}
+
+export async function create(c: Context) {
+  // TODO: Create new project
+  return c.json({ message: "created" }, 201);
+}
+
+export async function getById(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Fetch project by ID
+  return c.json({ data: { id } });
+}
+
+export async function update(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Update project
+  return c.json({ data: { id } });
+}
+
+export async function remove(c: Context) {
+  const id = c.req.param("id");
+  // TODO: Soft-delete project
+  return c.json({ message: "deleted" });
+}

package/apps/api/src/modules/projects/project.routes.ts

@@ -0,0 +1,10 @@
+import { Hono } from "hono";
+import * as projectController from "./project.controller";
+
+export const projectRoutes = new Hono();
+
+projectRoutes.get("/", projectController.list);
+projectRoutes.post("/", projectController.create);
+projectRoutes.get("/:id", projectController.getById);
+projectRoutes.patch("/:id", projectController.update);
+projectRoutes.delete("/:id", projectController.remove);

package/apps/api/src/modules/projects/project.schema.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+export const createProjectSchema = z.object({
+  name: z.string().min(1).max(100),
+  repo: z.string().url().optional(),
+  framework: z.enum(["nextjs", "node", "static", "docker"]).optional(),
+});
+
+export const updateProjectSchema = createProjectSchema.partial();

package/apps/api/src/modules/projects/project.service.ts

@@ -0,0 +1,23 @@
+/**
+ * Project service — CRUD operations for user projects.
+ */
+
+export async function listProjects(userId: string) {
+  // TODO: Query DB for user's projects
+}
+
+export async function createProject(userId: string, data: { name: string; repo?: string }) {
+  // TODO: Insert project, set up initial config
+}
+
+export async function getProject(projectId: string) {
+  // TODO: Fetch single project
+}
+
+export async function updateProject(projectId: string, data: Partial<{ name: string }>) {
+  // TODO: Update project fields
+}
+
+export async function deleteProject(projectId: string) {
+  // TODO: Soft-delete project and associated deployments
+}

package/apps/api/src/modules/webhooks/webhook.controller.ts

@@ -0,0 +1,22 @@
+import type { Context } from "hono";
+
+export async function github(c: Context) {
+  // TODO: Verify GitHub signature, parse push event, trigger deployment
+  return c.json({ received: true });
+}
+
+export async function gitlab(c: Context) {
+  // TODO: Verify GitLab token, parse push event
+  return c.json({ received: true });
+}
+
+export async function bitbucket(c: Context) {
+  // TODO: Verify Bitbucket signature
+  return c.json({ received: true });
+}
+
+export async function custom(c: Context) {
+  const projectId = c.req.param("projectId");
+  // TODO: Trigger deployment for project from custom webhook
+  return c.json({ received: true, projectId });
+}

package/apps/api/src/modules/webhooks/webhook.routes.ts

@@ -0,0 +1,12 @@
+import { Hono } from "hono";
+import * as webhookController from "./webhook.controller";
+
+export const webhookRoutes = new Hono();
+
+/* Git provider webhooks (push events trigger deployments) */
+webhookRoutes.post("/github", webhookController.github);
+webhookRoutes.post("/gitlab", webhookController.gitlab);
+webhookRoutes.post("/bitbucket", webhookController.bitbucket);
+
+/* Generic webhook for custom integrations */
+webhookRoutes.post("/custom/:projectId", webhookController.custom);

package/apps/api/src/modules/webhooks/webhook.service.ts

@@ -0,0 +1,11 @@
+/**
+ * Webhook service — verifies signatures and dispatches events.
+ */
+
+export async function verifyGitHubSignature(payload: string, signature: string, secret: string) {
+  // TODO: HMAC-SHA256 verification
+}
+
+export async function handlePushEvent(projectId: string, branch: string, commitSha: string) {
+  // TODO: Queue new deployment
+}

package/apps/api/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "openship-tsconfig/node.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/apps/cli/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "openship-cli",
+  "version": "0.1.0",
+  "type": "module",
+  "bin": {
+    "openship": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo node_modules"
+  },
+  "dependencies": {
+    "openship-core": "workspace:*",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "prompts": "^2.4.0"
+  },
+  "devDependencies": {
+    "openship-tsconfig": "workspace:*",
+    "@types/prompts": "^2.4.0",
+    "tsx": "^4.11.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.4.0"
+  }
+}

package/apps/cli/src/commands/deploy.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+
+export const deployCommand = new Command("deploy")
+  .description("Deploy the current project")
+  .option("--prod", "Deploy to production")
+  .option("--preview", "Create a preview deployment")
+  .action(async (opts) => {
+    // TODO: Read openship.json, upload or push, trigger deployment via API
+    const env = opts.prod ? "production" : "preview";
+    console.log(`Deploying to ${env}...`);
+  });

package/apps/cli/src/commands/init.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+
+export const initCommand = new Command("init")
+  .description("Initialize an Openship project in the current directory")
+  .action(async () => {
+    // TODO: Create openship.json config, detect framework, link to account
+    console.log("Initializing Openship project...");
+  });

package/apps/cli/src/commands/login.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+
+export const loginCommand = new Command("login")
+  .description("Authenticate with your Openship account")
+  .action(async () => {
+    // TODO: Open browser for OAuth or prompt for API token
+    console.log("Logging in...");
+  });

package/apps/cli/src/commands/logs.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+
+export const logsCommand = new Command("logs")
+  .description("Stream deployment logs")
+  .argument("[deploymentId]", "Deployment ID (defaults to latest)")
+  .action(async (deploymentId?: string) => {
+    // TODO: Connect to API and stream logs
+    console.log(`Streaming logs for ${deploymentId || "latest deployment"}...`);
+  });

package/apps/cli/src/index.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { deployCommand } from "./commands/deploy";
+import { loginCommand } from "./commands/login";
+import { initCommand } from "./commands/init";
+import { logsCommand } from "./commands/logs";
+
+const program = new Command();
+
+program
+  .name("openship")
+  .description("Openship CLI — deploy from your terminal")
+  .version("0.1.0");
+
+program.addCommand(initCommand);
+program.addCommand(loginCommand);
+program.addCommand(deployCommand);
+program.addCommand(logsCommand);
+
+program.parse();

package/apps/cli/src/lib/api-client.ts

@@ -0,0 +1,35 @@
+/**
+ * CLI HTTP client — communicates with the Openship API.
+ */
+
+const DEFAULT_API_URL = "http://localhost:4000/api";
+
+export function getApiUrl(): string {
+  return process.env.OPENSHIP_API_URL || DEFAULT_API_URL;
+}
+
+export async function apiRequest(path: string, options?: RequestInit) {
+  const url = `${getApiUrl()}${path}`;
+  const token = getStoredToken();
+
+  const res = await fetch(url, {
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      ...options?.headers,
+    },
+  });
+
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new Error(body.error || `API error: ${res.status}`);
+  }
+
+  return res.json();
+}
+
+function getStoredToken(): string | null {
+  // TODO: Read token from ~/.openship/config.json
+  return null;
+}

package/apps/cli/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "openship-tsconfig/node.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/apps/dashboard/Dockerfile

@@ -0,0 +1,24 @@
+# ─── Build stage ────────────────────────────────────────
+FROM node:20-alpine AS builder
+RUN corepack enable && corepack prepare pnpm@9.0.0 --activate
+WORKDIR /app
+
+COPY pnpm-workspace.yaml pnpm-lock.yaml* package.json ./
+COPY tooling/ ./tooling/
+COPY packages/ ./packages/
+COPY apps/dashboard/ ./apps/dashboard/
+
+RUN pnpm install --frozen-lockfile
+RUN pnpm run build --filter=openship-dashboard...
+
+# ─── Production stage ──────────────────────────────────
+FROM node:20-alpine AS runner
+WORKDIR /app
+
+COPY --from=builder /app/apps/dashboard/.next/standalone ./
+COPY --from=builder /app/apps/dashboard/.next/static ./.next/static
+COPY --from=builder /app/apps/dashboard/public ./public
+
+ENV NODE_ENV=production
+EXPOSE 3001
+CMD ["node", "server.js"]

package/apps/dashboard/next.config.mjs

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  transpilePackages: ["openship-ui", "openship-core", "openship-db"],
+};
+
+export default nextConfig;

package/apps/dashboard/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "openship-dashboard",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --port 3001",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "clean": "rm -rf .next .turbo node_modules"
+  },
+  "dependencies": {
+    "openship-ui": "workspace:*",
+    "openship-core": "workspace:*",
+    "openship-db": "workspace:*",
+    "next": "^14.2.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "next-auth": "^5.0.0-beta.0"
+  },
+  "devDependencies": {
+    "openship-tsconfig": "workspace:*",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.4.0"
+  }
+}

package/apps/dashboard/src/app/(auth)/layout.tsx

@@ -0,0 +1,6 @@
+/**
+ * Auth layout — minimal shell without sidebar, used for login/register pages.
+ */
+export default function AuthLayout({ children }: { children: React.ReactNode }) {
+  return <div className="min-h-screen bg-gray-50">{children}</div>;
+}

package/apps/dashboard/src/app/(auth)/login/page.tsx

@@ -0,0 +1,11 @@
+export default function LoginPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center">
+      <div className="w-full max-w-sm rounded-lg border p-8">
+        <h1 className="mb-6 text-2xl font-bold">Sign in to Openship</h1>
+        {/* Auth form will go here — next-auth / credentials / OAuth */}
+        <p className="text-sm text-gray-500">Authentication coming soon.</p>
+      </div>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(auth)/register/page.tsx

@@ -0,0 +1,10 @@
+export default function RegisterPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center">
+      <div className="w-full max-w-sm rounded-lg border p-8">
+        <h1 className="mb-6 text-2xl font-bold">Create an account</h1>
+        <p className="text-sm text-gray-500">Registration coming soon.</p>
+      </div>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/billing/page.tsx

@@ -0,0 +1,10 @@
+export default function BillingPage() {
+  return (
+    <div>
+      <h1 className="text-2xl font-bold">Billing</h1>
+      <p className="mt-2 text-gray-600">
+        Manage your subscription, usage, and payment methods.
+      </p>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/deployments/page.tsx

@@ -0,0 +1,8 @@
+export default function DeploymentsPage() {
+  return (
+    <div>
+      <h1 className="text-2xl font-bold">Deployments</h1>
+      <p className="mt-2 text-gray-600">View and manage your deployment history.</p>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/domains/page.tsx

@@ -0,0 +1,8 @@
+export default function DomainsPage() {
+  return (
+    <div>
+      <h1 className="text-2xl font-bold">Domains</h1>
+      <p className="mt-2 text-gray-600">Manage custom domains and DNS records.</p>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/layout.tsx

@@ -0,0 +1,37 @@
+/**
+ * Dashboard shell layout — sidebar + top bar wrapper.
+ * All authenticated dashboard pages live under this layout.
+ */
+export default function DashboardLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <div className="flex h-screen">
+      {/* Sidebar */}
+      <aside className="w-64 shrink-0 border-r bg-gray-50 p-4">
+        <div className="mb-8 text-lg font-bold">Openship</div>
+        <nav className="flex flex-col gap-1 text-sm">
+          <a href="/projects" className="rounded px-3 py-2 hover:bg-gray-200">
+            Projects
+          </a>
+          <a href="/deployments" className="rounded px-3 py-2 hover:bg-gray-200">
+            Deployments
+          </a>
+          <a href="/domains" className="rounded px-3 py-2 hover:bg-gray-200">
+            Domains
+          </a>
+          <a href="/monitoring" className="rounded px-3 py-2 hover:bg-gray-200">
+            Monitoring
+          </a>
+          <a href="/settings" className="rounded px-3 py-2 hover:bg-gray-200">
+            Settings
+          </a>
+          <a href="/billing" className="rounded px-3 py-2 hover:bg-gray-200">
+            Billing
+          </a>
+        </nav>
+      </aside>
+
+      {/* Main content */}
+      <main className="flex-1 overflow-y-auto p-6">{children}</main>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/monitoring/page.tsx

@@ -0,0 +1,8 @@
+export default function MonitoringPage() {
+  return (
+    <div>
+      <h1 className="text-2xl font-bold">Monitoring</h1>
+      <p className="mt-2 text-gray-600">Logs, metrics, and health checks for your services.</p>
+    </div>
+  );
+}

package/apps/dashboard/src/app/(dashboard)/projects/page.tsx

@@ -0,0 +1,8 @@
+export default function ProjectsPage() {
+  return (
+    <div>
+      <h1 className="text-2xl font-bold">Projects</h1>
+      <p className="mt-2 text-gray-600">Create and manage your deployment projects.</p>
+    </div>
+  );
+}