claude-code-limiter-server 1.0.0

package/Caddyfile

@@ -0,0 +1,12 @@
+# Caddyfile for claude-code-limiter
+# Set the DOMAIN env var for auto-HTTPS, or leave unset for localhost.
+#
+# With a real domain (auto-HTTPS):
+#   DOMAIN=limiter.example.com docker compose up
+#
+# LAN-only (no HTTPS):
+#   docker compose up   (defaults to localhost)
+
+{$DOMAIN:localhost} {
+	reverse_proxy limiter:3000
+}

package/Dockerfile

@@ -0,0 +1,57 @@
+# Multi-stage build for claude-code-limiter server
+# Runs the Express server with SQLite, serves dashboard on same port
+
+# --- Stage 1: Install dependencies ---
+FROM node:20-slim AS deps
+
+WORKDIR /app
+
+# Install build tools for better-sqlite3 native compilation
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends python3 make g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY package.json package-lock.json* ./
+RUN npm ci --omit=dev
+
+# --- Stage 2: Production image ---
+FROM node:20-slim
+
+# Install curl for healthcheck + minimal runtime deps for better-sqlite3
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends curl && \
+    rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Copy node_modules (with compiled native modules) from deps stage
+COPY --from=deps /app/node_modules ./node_modules
+COPY package.json ./
+COPY src/ ./src/
+COPY bin/ ./bin/
+
+# Create data directory for SQLite volume
+RUN mkdir -p /data
+
+# Create non-root user for security
+RUN groupadd --system limiter && \
+    useradd --system --gid limiter --home /app limiter && \
+    chown -R limiter:limiter /app /data
+
+# Environment
+ENV NODE_ENV=production
+ENV DATA_DIR=/data
+
+EXPOSE 3000
+
+# SQLite database persisted via volume
+VOLUME ["/data"]
+
+# Healthcheck: verify the server responds
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:3000/health || exit 1
+
+# Run as non-root
+USER limiter
+
+CMD ["node", "bin/server.js"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Basha
+
+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/bin/server.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+'use strict';
+
+// Server entry point for Docker CMD and `npm start`.
+// Handles graceful shutdown on SIGTERM/SIGINT.
+
+const app = require('../src/server/index.js');
+
+const port = parseInt(process.env.PORT || '3000', 10);
+
+console.log(`[server] Starting claude-code-limiter server...`);
+console.log(`[server] NODE_ENV=${process.env.NODE_ENV || 'development'}`);
+console.log(`[server] DATA_DIR=${process.env.DATA_DIR || '(default)'}`);
+
+app.start(port);
+
+// ---- Graceful shutdown ----
+
+function shutdown(signal) {
+  console.log(`\n[server] Received ${signal}. Shutting down gracefully...`);
+
+  // Close the HTTP server so no new connections are accepted
+  if (app.server) {
+    app.server.close(() => {
+      console.log('[server] HTTP server closed.');
+      process.exit(0);
+    });
+
+    // Force exit after 10 seconds if connections don't drain
+    setTimeout(() => {
+      console.error('[server] Forcing shutdown after timeout.');
+      process.exit(1);
+    }, 10000).unref();
+  } else {
+    process.exit(0);
+  }
+}
+
+process.on('SIGTERM', () => shutdown('SIGTERM'));
+process.on('SIGINT',  () => shutdown('SIGINT'));
+
+// Catch unhandled errors so the container doesn't silently die
+process.on('unhandledRejection', (err) => {
+  console.error('[server] Unhandled rejection:', err);
+});
+
+process.on('uncaughtException', (err) => {
+  console.error('[server] Uncaught exception:', err);
+  process.exit(1);
+});

package/docker-compose.yml

@@ -0,0 +1,46 @@
+version: "3.8"
+
+services:
+  limiter:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: claude-limiter
+    restart: unless-stopped
+    environment:
+      - NODE_ENV=production
+      - PORT=3000
+      - DATA_DIR=/data
+      - ADMIN_PASSWORD=${ADMIN_PASSWORD:-changeme}
+      - JWT_SECRET=${JWT_SECRET:-}
+    volumes:
+      - limiter-data:/data
+    networks:
+      - limiter-net
+    expose:
+      - "3000"
+
+  caddy:
+    image: caddy:2
+    container_name: claude-limiter-caddy
+    restart: unless-stopped
+    ports:
+      - "80:80"
+      - "443:443"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+      - caddy-data:/data
+      - caddy-config:/config
+    networks:
+      - limiter-net
+    depends_on:
+      - limiter
+
+volumes:
+  limiter-data:
+  caddy-data:
+  caddy-config:
+
+networks:
+  limiter-net:
+    driver: bridge

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "claude-code-limiter-server",
+  "version": "1.0.0",
+  "description": "Dashboard server for claude-code-limiter",
+  "main": "src/server/index.js",
+  "bin": { "claude-limiter-server": "./bin/server.js" },
+  "scripts": { "start": "node bin/server.js" },
+  "files": ["bin/", "src/", "Dockerfile", "docker-compose.yml", "Caddyfile", "LICENSE"],
+  "engines": { "node": ">=18.0.0" },
+  "author": "howincodes",
+  "contributors": [
+    "farisbasha"
+  ],
+  "dependencies": {
+    "express": "^4.21.0",
+    "better-sqlite3": "^11.0.0",
+    "ws": "^8.18.0",
+    "bcryptjs": "^2.4.3",
+    "jsonwebtoken": "^9.0.2",
+    "uuid": "^10.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/howincodes/claude-code-limiter"
+  },
+  "license": "MIT"
+}