Optimize Docker build and improve configuration for Raspberry Pi

.dockerignore

@@ -1,2 +1,113 @@
+# =============================================================================
+# Docker Ignore File
+# =============================================================================
+# Excludes files from Docker build context to speed up builds
+# and reduce image size
+# =============================================================================
+
+# =============================================================================
+# Git
+# =============================================================================
+.git
+.gitignore
+.gitattributes
+
+# =============================================================================
+# Node.js
+# =============================================================================
+node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.npm
+.yarn
+
+# =============================================================================
+# IDE and Editor Files
+# =============================================================================
+.idea
+.vscode
+*.swp
+*.swo
+*~
+.DS_Store
+
+# =============================================================================
+# Environment and Secrets (NEVER include in image!)
+# =============================================================================
+.env
+.env.*
+*.env
+!.env.example
+
+# =============================================================================
+# Persistent Data Directories (mounted as volumes)
+# =============================================================================
+credentials/
+instances/
+logs/
+maps/
+temp/
+
+# =============================================================================
+# Documentation
+# =============================================================================
 docs/
-node_modules/
+*.md
+!README.md
+LICENSE
+CONTRIBUTING.md
+SECURITY.md
+CHANGELOG.md
+
+# =============================================================================
+# GitHub
+# =============================================================================
+.github/
+
+# =============================================================================
+# Testing
+# =============================================================================
+test/
+tests/
+__tests__/
+coverage/
+.nyc_output/
+
+# =============================================================================
+# Docker Files (prevent recursive builds)
+# =============================================================================
+Dockerfile*
+docker-compose*
+.docker/
+.dockerignore
+
+# =============================================================================
+# Build Artifacts
+# =============================================================================
+dist/
+build/
+*.log
+
+# =============================================================================
+# OS Generated Files
+# =============================================================================
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# =============================================================================
+# Temporary Files
+# =============================================================================
+*.tmp
+*.temp
+*.bak
+*.backup
+
+# =============================================================================
+# Scripts not needed in container
+# =============================================================================
+update.sh
+update.bat
+*.sh
+!entrypoint.sh

.env.example

@@ -0,0 +1,28 @@
+# =============================================================================
+# HondaBot - Environment Variables Example
+# =============================================================================
+# Copy this file to .env and fill in your values
+# NEVER commit your .env file to version control!
+# =============================================================================
+
+# Discord Bot Configuration (Required)
+# Get these from: https://discord.com/developers/applications
+RPP_DISCORD_CLIENT_ID=your_client_id_here
+RPP_DISCORD_TOKEN=your_bot_token_here
+RPP_DISCORD_USERNAME=your_discord_username
+
+# Timezone (Optional)
+# See: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+TZ=UTC
+
+# =============================================================================
+# Advanced Settings (Usually don't need to change)
+# =============================================================================
+
+# Node.js memory limit (in MB)
+# Adjust based on your Raspberry Pi model:
+# - Pi 4 1GB: 512
+# - Pi 4 2GB: 768
+# - Pi 4 4GB: 1024 (default)
+# - Pi 4 8GB: 2048
+# NODE_MAX_MEMORY=1024

.github/workflows/lint.yml

@@ -1,14 +1,20 @@
+name: Lint
+
 on:
   push:
+    branches:
+      - master
   pull_request:
+    branches:
+      - master
 
 jobs:
   lint:
     name: Lint - Node ${{ matrix.node }}
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node: [ 22 ]
+        node: [ 22, 24 ]
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-node@v4

.gitignore

@@ -5,3 +5,8 @@ credentials
 maps
 logs
 temp
+.DS_Store
+src/.DS_Store
+src/resources/.DS_Store
+# Compiled TypeScript output
+dist/

.nvmrc

@@ -0,0 +1 @@
+24

Dockerfile

@@ -1,17 +1,117 @@
-FROM node:18
+# syntax=docker/dockerfile:1
 
-RUN apt-get update && apt-get install -y graphicsmagick && apt-get clean
+# =============================================================================
+# Dockerfile for Raspberry Pi 4 (ARM64)
+# =============================================================================
+# Multi-stage build optimized for ARM64 devices like Raspberry Pi 4
+# - Uses BuildKit cache mounts for faster rebuilds
+# - Pre-compiles TypeScript for faster startup and lower memory usage
+# - Uses slim base image to reduce size
+# - Runs as non-root user for security
+#
+# Build with: DOCKER_BUILDKIT=1 docker build -t hondabot .
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# Stage 1: Build base with common dependencies
+# -----------------------------------------------------------------------------
+FROM node:22-bookworm-slim AS base
+
+# Install build dependencies needed for native modules (sharp, etc.)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3 \
+    make \
+    g++ \
+    git \
+    && rm -rf /var/lib/apt/lists/* \
+    && npm install -g npm@11.9.0
+
+# -----------------------------------------------------------------------------
+# Stage 2: Dependencies & Build
+# -----------------------------------------------------------------------------
+FROM base AS builder
+
+WORKDIR /build
+
+# Copy package files and patches for better layer caching
+# Note: patches/ is needed for the postinstall script that patches rustplus.proto
+COPY package.json package-lock.json ./
+COPY patches/ ./patches/
+
+# Install all dependencies with BuildKit cache mount for npm
+# This dramatically speeds up rebuilds by caching downloaded packages
+RUN --mount=type=cache,target=/root/.npm,sharing=locked \
+    npm ci --include=dev
+
+# Copy source code
+COPY . .
+
+# Compile TypeScript to JavaScript for production
+RUN NODE_OPTIONS="--max-old-space-size=2048" npm run build
+
+# -----------------------------------------------------------------------------
+# Stage 3: Production Dependencies
+# -----------------------------------------------------------------------------
+FROM base AS deps
+
+WORKDIR /deps
+
+COPY package.json package-lock.json ./
+COPY patches/ ./patches/
+
+# Install production deps with cache mount
+# Note: Cannot use --ignore-scripts as sharp needs post-install on ARM64
+# Note: patches/ is needed for the postinstall script that patches rustplus.proto
+RUN --mount=type=cache,target=/root/.npm,sharing=locked \
+    npm ci --omit=dev
+
+# -----------------------------------------------------------------------------
+# Stage 4: Final Runtime Image
+# -----------------------------------------------------------------------------
+FROM node:22-bookworm-slim AS runtime
+
+LABEL org.opencontainers.image.title="HondaBot"
+LABEL org.opencontainers.image.description="Discord bot for Rust+ integration"
+
+# Install runtime dependencies (sharp includes its own libvips)
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    dumb-init \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+RUN groupadd --gid 1001 hondabot \
+    && useradd --uid 1001 --gid hondabot --shell /bin/bash --create-home hondabot
 
 WORKDIR /app
 
-COPY package.json /app/package.json
-COPY package-lock.json /app/package-lock.json
-RUN npm install
-COPY . /app
+# Copy production dependencies
+COPY --from=deps /deps/node_modules ./node_modules
+
+# Copy compiled JavaScript
+COPY --from=builder /build/dist ./dist
+COPY --from=builder /build/package.json ./
+
+# Copy runtime resources (must be in dist/src/ to match compiled code paths)
+COPY --from=builder /build/src/resources ./dist/src/resources
+COPY --from=builder /build/src/languages ./dist/src/languages
+COPY --from=builder /build/src/staticFiles ./dist/src/staticFiles
+COPY --from=builder /build/src/templates ./dist/src/templates
+
+# Create data directories
+RUN mkdir -p /app/credentials /app/instances /app/logs /app/maps /app/temp \
+    && chown -R hondabot:hondabot /app
+
+VOLUME ["/app/credentials", "/app/instances", "/app/logs", "/app/maps"]
+
+ENV NODE_ENV=production
+ENV NODE_OPTIONS="--max-old-space-size=1024"
+
+USER hondabot
 
-VOLUME [ "/app/credentials" ]
-VOLUME [ "/app/instances" ]
-VOLUME [ "/app/logs" ]
-VOLUME [ "/app/maps" ]
+HEALTHCHECK --interval=60s --timeout=10s --start-period=120s --retries=3 \
+    CMD node -e "console.log('healthy')" || exit 1
 
-CMD ["npm", "start"]
+ENTRYPOINT ["/usr/bin/dumb-init", "--"]
+CMD ["node", "dist/index.js"]