Cloud Domain Analyzer

Build a domain analyzer that can correctly identify and classify domains hosted on cloud platforms versus regular ICANN domains.

Background

Cloud platforms like AWS S3, GitHub Pages, and Heroku provide hosting services using subdomains of their own domains (e.g., bucket.s3.amazonaws.com, username.github.io). For security and analytics purposes, it's important to correctly identify the registrable domain for such URLs versus regular website domains.

Your task is to build a tool that can analyze a list of URLs and produce a report showing:

1. Which domains are hosted on cloud platforms (private suffixes)
2. Which are regular ICANN domains
3. The actual registrable domain for each URL

Requirements

Input

Your program should read URLs from a file called urls.txt (one URL per line) and analyze each URL.

Output

Generate a JSON report file called domain-report.json with the following structure:

{
  "icann_domains": [
    {
      "url": "original url",
      "domain": "registrable domain",
      "publicSuffix": "public suffix",
      "subdomain": "subdomain if any"
    }
  ],
  "private_domains": [
    {
      "url": "original url",
      "domain": "registrable domain on cloud platform",
      "publicSuffix": "private suffix",
      "subdomain": "subdomain if any"
    }
  ],
  "summary": {
    "total": 0,
    "icann_count": 0,
    "private_count": 0
  }
}

Domain Classification

• ICANN domains: Regular domains using official TLDs (.com, .org, .co.uk, etc.)
• Private domains: Domains hosted on cloud platforms using private suffixes

For cloud platform URLs, the tool should identify the actual registrable domain including the private suffix (e.g., for my-bucket.s3.amazonaws.com, the domain should be my-bucket.s3.amazonaws.com not just amazonaws.com).

Test Cases

• Analyzing https://www.google.com/search produces an ICANN domain entry with domain google.com, publicSuffix com, subdomain www @test

• Analyzing https://my-app.herokuapp.com/page produces a private domain entry with domain my-app.herokuapp.com, publicSuffix herokuapp.com, subdomain empty @test

• Analyzing https://docs.example.co.uk/guide produces an ICANN domain entry with domain example.co.uk, publicSuffix co.uk, subdomain docs @test

• Analyzing https://mybucket.s3.amazonaws.com/file.txt produces a private domain entry with domain mybucket.s3.amazonaws.com, publicSuffix s3.amazonaws.com, subdomain empty @test

Implementation

Create the following files:

• src/analyzer.ts - Main analyzer implementation
• test/analyzer.test.ts - Test suite
• urls.txt - Sample input file (create with at least 5 diverse URLs)

@generates

Dependencies { .dependencies }

tldts { .dependency }

Provides URL parsing and domain extraction capabilities.