How Git-Archiver Works

flowchart TB
    subgraph User["🌐 User Interface"]
        A[Web Browser]
    end

    subgraph Edge["⚡ Edge Layer"]
        B[Cloudflare Worker
API Gateway]
        C[(KV Store
Rate Limits)]
    end

    subgraph GitHub["🐙 GitHub Infrastructure"]
        D[GitHub Issues
Job Queue]
        E[GitHub Actions
Workflow Runner]
        F[GitHub Releases
Archive Storage]
        G[index.json
Repository Index]
    end

    A -->|1. Submit URL| B
    B -->|2. Rate Check| C
    B -->|3. Create Issue| D
    D -->|4. Trigger| E
    E -->|5. Clone & Archive| F
    E -->|6. Update| G
    A -->|7. Browse/Download| B
    B -->|8. Fetch Index| G
    B -->|9. Proxy Downloads| F

    style A fill:#1a1e2a,stroke:#00d4ff,color:#f1f5f9
    style B fill:#12151e,stroke:#00d4ff,color:#00d4ff
    style C fill:#12151e,stroke:#7c3aed,color:#7c3aed
    style D fill:#12151e,stroke:#f59e0b,color:#f59e0b
    style E fill:#12151e,stroke:#10b981,color:#10b981
    style F fill:#12151e,stroke:#00d4ff,color:#00d4ff
    style G fill:#12151e,stroke:#00d4ff,color:#00d4ff
                

sequenceDiagram
    participant U as User
    participant W as Cloudflare Worker
    participant KV as KV Store
    participant GH as GitHub API
    participant A as GitHub Actions
    participant R as GitHub Releases

    U->>W: POST /submit {url}
    W->>KV: Check rate limit
    KV-->>W: OK (remaining: 9)
    W->>GH: Validate repo exists
    GH-->>W: 200 OK (public, 50MB)
    W->>GH: Check pending issues
    GH-->>W: No duplicates
    W->>GH: Create issue with label
    GH-->>W: Issue #123 created
    W-->>U: 201 Created {issue_url}

    Note over GH,A: Webhook triggers workflow

    A->>GH: Clone repository
    A->>A: Create .tar.gz archive
    A->>R: Upload to release
    A->>R: Update index.json
    A->>GH: Close issue #123
                

flowchart LR
    subgraph Releases["GitHub Releases"]
        direction TB
        I[("📋 index
index.json")]
        R1["📦 owner__repo__2024-01-15
archive.tar.gz + README.md"]
        R2["📦 facebook__react__2024-01-14
archive.tar.gz + README.md"]
        R3["📦 torvalds__linux__2024-01-10
archive.tar.gz + README.md"]
    end

    subgraph Index["index.json Structure"]
        direction TB
        J["{ repositories: {
  'owner/repo': {
    versions: [...],
    latest_tag: '...',
    total_size: 123456
  }
}}"]
    end

    I --> J

    style I fill:#12151e,stroke:#00d4ff,color:#00d4ff
    style R1 fill:#12151e,stroke:#7c3aed,color:#f1f5f9
    style R2 fill:#12151e,stroke:#7c3aed,color:#f1f5f9
    style R3 fill:#12151e,stroke:#7c3aed,color:#f1f5f9
    style J fill:#1a1e2a,stroke:#00d4ff,color:#94a3b8