Version 5.0.0 beta 1

system/3rd_party/Pdp/TopLevelDomainList.php

@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pdp;
+
+use Countable;
+use DateTimeImmutable;
+use Iterator;
+use IteratorAggregate;
+
+/**
+ * @extends IteratorAggregate<string>
+ */
+interface TopLevelDomainList extends Countable, DomainNameResolver, IteratorAggregate
+{
+    /**
+     * Returns the Version ID.
+     */
+    public function version(): string;
+
+    /**
+     * Returns the List Last Modified Date.
+     */
+    public function lastUpdated(): DateTimeImmutable;
+
+    
+    public function count(): int;
+
+    /**
+     * Tells whether the list is empty.
+     */
+    public function isEmpty(): bool;
+
+    /**
+     * @return Iterator<string>
+     */
+    public function getIterator(): Iterator;
+
+    /**
+     * Returns PSL info for a given domain against the PSL rules for ICANN domain detection.
+     *
+     * @throws SyntaxError           if the domain is invalid
+     * @throws UnableToResolveDomain if the domain does not contain a IANA Effective TLD
+     */
+    public function getIANADomain(Host $host): ResolvedDomainName;
+}