feat: App auth endpoints

.github/workflows/dev-image-builder.yml

@@ -0,0 +1,49 @@
+name: Dev API Image Builder
+
+on:
+  pull_request:
+    branches:
+      - master
+    types:
+      - opened
+      - synchronize
+      - reopened
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GH_TOKEN }}
+
+      - name: Set environment variables
+        run: |
+          echo "APP_ENV=development" >> $GITHUB_ENV
+          echo "IMAGE_NAME=ghcr.io/clashkinginc/clashkingapi-dev" >> $GITHUB_ENV
+
+      - name: Sanitize branch name
+        id: sanitize
+        run: echo "SANITIZED_BRANCH=$(echo '${{ github.event.pull_request.head.ref }}' | sed 's/[^a-zA-Z0-9_.-]/-/g')" >> $GITHUB_ENV
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ env.IMAGE_NAME }}:${{ env.SANITIZED_BRANCH }}
+            ${{ env.IMAGE_NAME }}:latest
+          build-args: APP_ENV=${{ env.APP_ENV }}
+

.github/workflows/prod-image-builder.yml

@@ -0,0 +1,51 @@
+name: Production API Image Builder
+
+on:
+  push:
+    branches:
+      - master  # Trigger only on push to master
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.ref_name }}  # Automatically checkout the triggering branch
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v2
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GH_TOKEN }}
+
+      - name: Set environment variables
+        run: |
+          echo "APP_ENV=production" >> $GITHUB_ENV
+          echo "IMAGE_NAME=ghcr.io/clashkinginc/clashkingapi" >> $GITHUB_ENV
+
+      - name: Sanitize branch name
+        id: sanitize
+        run: echo "SANITIZED_BRANCH=$(echo '${{ github.event.pull_request.head.ref }}' | sed 's/[^a-zA-Z0-9_.-]/-/g')" >> $GITHUB_ENV
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: |
+            ${{ env.IMAGE_NAME }}:latest
+            ${{ env.IMAGE_NAME }}:${{ github.sha }}
+          build-args: APP_ENV=${{ env.APP_ENV }}
+
+      - name: Verify pushed images
+        run: |
+          echo "Pushed image: ${{ env.IMAGE_NAME }}:latest"
+          echo "Pushed image: ${{ env.IMAGE_NAME }}:${{ github.sha }}"

.gitignore

@@ -1,7 +1,9 @@
-# created by virtualenv automatically
-.env
-*.xml
-*.idea
-.idea/
-*pycache*
-.venv/
+# created by virtualenv automatically
+.env
+*.xml
+*.idea
+.idea/
+*pycache*
+.venv/
+.claude/*
+CLAUDE.md

Dockerfile

@@ -1,19 +1,30 @@
-FROM python:3.11-bookworm
-
-LABEL org.opencontainers.image.source=https://github.com/ClashKingInc/ClashKingAPI
-LABEL org.opencontainers.image.description="Image for the ClashKing API"
-LABEL org.opencontainers.image.licenses=MIT
-
-RUN apt-get update && apt-get install -y libsnappy-dev
-
-WORKDIR /app
-
-COPY requirements.txt .
-
-RUN pip install --no-cache-dir -r requirements.txt
-
-COPY . .
-
-EXPOSE 6000
-
-CMD ["python", "main.py"]
+# Use the official Python 3.11 image
+FROM python:3.11-bookworm
+
+# Metadata labels for the image
+LABEL org.opencontainers.image.source="https://github.com/ClashKingInc/ClashKingAPI"
+LABEL org.opencontainers.image.description="Image for the ClashKing API"
+LABEL org.opencontainers.image.licenses="MIT"
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y libsnappy-dev
+
+# Set the working directory
+WORKDIR /app
+
+# Copy and install Python dependencies
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application files
+COPY . .
+
+# Define the environment variable for auth mode (default to development)
+ARG APP_ENV=development
+ENV APP_ENV=${APP_ENV}
+
+# Expose the ports used by different environments
+EXPOSE 6000 8073 8010
+
+# Dynamically set the correct port based on APP_ENV
+CMD ["sh", "-c", "python main.py --port=$( [ \"$APP_ENV\" = \"development\" ] && echo 8073 || ( [ \"$APP_ENV\" = \"local\" ] && echo 8000 || echo 8010 ) )"]

README.md

@@ -1,38 +1,38 @@
-# ClashKing API (api.clashk.ing)
-
-Welcome to the [ClashKing API](https://api.clashk.ing)! This is a public API designed to provide extra & historical **Clash of Clans** data for others. 
----
-
-## Key
-- **Public Access**: No authentication required.  
-- **No Rate Limits**: Fetch data freely, but please use responsibly.  
-- **Cloudflare**: Cached & Protected by.
-- **Infra**: Backed by three instances with a load balancer.
-- **Caching**: Responses are cached for 5 minutes.  
-
-### Respecting Data and Credit
-Due to the resource-intensive nature of this data - it requires considerable CPU, Storage, Internet Bandwidth, and in turn cost, please:
-1. **Credit the source**: We ask you to credit the ClashKing API where this data is used to ensure clarity and fairness.  
-2. **No impression of self-collection**: Do not create the impression that your application collects this data independently.  
-
-There is no strict requirement for credit format, but we appreciate a visible mention or link to [ClashKing](https://clashk.ing) in your project.
-
----
-
-## Collaboration and Standards
-
-The ClashKing API is open to contributions! You can suggest new features, fixes, or updates. Contributions should follow proper formatting and standards.  
-
----
-
-## Assets
-
-ClashKing also hosts a public CDN for Clash of Clans assets at **assets.clashk.ing**. These include game icons, images, and other resources. For more details, visit the [ClashKingAssets repository](https://github.com/ClashKingInc/ClashKingAssets).
-
----
-
-## Notice
-
-This project is **not affiliated with, endorsed, sponsored, or specifically approved by Supercell**. For more information, see [Supercell’s Fan Content Policy](https://supercell.com/en/fan-content-policy/).  
-
-By using this API, you agree to use it responsibly and in compliance with Supercell’s Terms of Service and Fan Content Policy.
+# ClashKing API (api.clashk.ing)
+
+Welcome to the [ClashKing API](https://api.clashk.ing)! This is a public API designed to provide extra & historical **Clash of Clans** data for others. 
+---
+
+## Key
+- **Public Access**: No authentication required.  
+- **No Rate Limits**: Fetch data freely, but please use responsibly.  
+- **Cloudflare**: Cached & Protected by.
+- **Infra**: Backed by three instances with a load balancer.
+- **Caching**: Responses are cached for 5 minutes.  
+
+### Respecting Data and Credit
+Due to the resource-intensive nature of this data - it requires considerable CPU, Storage, Internet Bandwidth, and in turn cost, please:
+1. **Credit the source**: We ask you to credit the ClashKing API where this data is used to ensure clarity and fairness.  
+2. **No impression of self-collection**: Do not create the impression that your application collects this data independently.  
+
+There is no strict requirement for credit format, but we appreciate a visible mention or link to [ClashKing](https://clashk.ing) in your project.
+
+---
+
+## Collaboration and Standards
+
+The ClashKing API is open to contributions! You can suggest new features, fixes, or updates. Contributions should follow proper formatting and standards.  
+
+---
+
+## Assets
+
+ClashKing also hosts a public CDN for Clash of Clans assets at **assets.clashk.ing**. These include game icons, images, and other resources. For more details, visit the [ClashKingAssets repository](https://github.com/ClashKingInc/ClashKingAssets).
+
+---
+
+## Notice
+
+This project is **not affiliated with, endorsed, sponsored, or specifically approved by Supercell**. For more information, see [Supercell’s Fan Content Policy](https://supercell.com/en/fan-content-policy/).  
+
+By using this API, you agree to use it responsibly and in compliance with Supercell’s Terms of Service and Fan Content Policy.