feat: add PhoneNumber Compliance API support

Add new regulatory compliance APIs under PhoneNumber/Compliance/ path:
- Requirements API (GET) for discovering compliance requirements
- Compliance Applications API (POST, GET, LIST, PATCH, DELETE)
- Number Linking API (POST) for bulk linking numbers to applications

Includes multipart form-data support for document file uploads with
indexed file fields (documents[N].file) and JSON data field.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Koushik SK

plivo/resources/__init__.py

@@ -22,3 +22,4 @@
 from .multipartycall import MultiPartyCalls, MultiPartyCall, MultiPartyCallParticipant
 from .verify import Sessions
 from .tollfree_verification import TollfreeVerifications
+from .phone_number_compliance import PhoneNumberComplianceRequirements, PhoneNumberComplianceApplications, PhoneNumberComplianceLink

plivo/resources/phone_number_compliance.py

@@ -0,0 +1,119 @@
+import json
+import os
+from plivo.base import PlivoResource, PlivoResourceInterface
+
+
+class PhoneNumberComplianceRequirement(PlivoResource):
+    _name = 'PhoneNumberComplianceRequirement'
+    _identifier_string = 'requirement_id'
+
+
+class PhoneNumberComplianceRequirements(PlivoResourceInterface):
+    _resource_type = PhoneNumberComplianceRequirement
+
+    def get(self, country_iso=None, number_type=None, user_type=None):
+        # GET /PhoneNumber/Compliance/Requirements
+        return self.client.request(
+            'GET',
+            ('PhoneNumber', 'Compliance', 'Requirements'),
+            dict(country_iso=country_iso, number_type=number_type, user_type=user_type)
+        )
+
+
+class PhoneNumberCompliance(PlivoResource):
+    _name = 'PhoneNumberCompliance'
+    _identifier_string = 'compliance_id'
+
+
+class PhoneNumberComplianceApplications(PlivoResourceInterface):
+    _resource_type = PhoneNumberCompliance
+
+    def create(self, data=None, documents=None):
+        """
+        data: dict with keys country_iso, number_type, alias, end_user, documents, callback_url, callback_method
+        documents: list of local file paths for document uploads
+        """
+        payload, files = _build_compliance_multipart(data, documents)
+        return self.client.request(
+            'POST',
+            ('PhoneNumber', 'Compliance'),
+            payload,
+            files=files
+        )
+
+    def list(self, limit=None, offset=None, status=None, country_iso=None,
+             number_type=None, user_type=None, alias=None, expand=None):
+        params = {}
+        if limit is not None:
+            params['limit'] = limit
+        if offset is not None:
+            params['offset'] = offset
+        if status:
+            params['status'] = status
+        if country_iso:
+            params['country_iso'] = country_iso
+        if number_type:
+            params['number_type'] = number_type
+        if user_type:
+            params['user_type'] = user_type
+        if alias:
+            params['alias'] = alias
+        if expand:
+            params['expand'] = expand
+        return self.client.request(
+            'GET',
+            ('PhoneNumber', 'Compliance'),
+            params
+        )
+
+    def get(self, compliance_id, expand=None):
+        params = {}
+        if expand:
+            params['expand'] = expand
+        return self.client.request(
+            'GET',
+            ('PhoneNumber', 'Compliance', compliance_id),
+            params
+        )
+
+    def update(self, compliance_id, data=None, documents=None):
+        payload, files = _build_compliance_multipart(data, documents)
+        return self.client.request(
+            'PATCH',
+            ('PhoneNumber', 'Compliance', compliance_id),
+            payload,
+            files=files
+        )
+
+    def delete(self, compliance_id):
+        return self.client.request(
+            'DELETE',
+            ('PhoneNumber', 'Compliance', compliance_id)
+        )
+
+
+class PhoneNumberComplianceLink(PlivoResourceInterface):
+
+    def link(self, numbers=None):
+        """
+        numbers: list of dicts, each with 'number' and 'compliance_application_id'
+        """
+        return self.client.request(
+            'POST',
+            ('PhoneNumber', 'Compliance', 'Link'),
+            dict(numbers=numbers)
+        )
+
+
+def _build_compliance_multipart(data, documents):
+    payload = {}
+    files = {}
+    if data:
+        payload['data'] = json.dumps(data)
+    if documents:
+        for idx, doc_path in enumerate(documents):
+            field_name = 'documents[{}].file'.format(idx)
+            files[field_name] = (os.path.basename(doc_path), open(doc_path, 'rb'))
+    if not files:
+        files = None
+    return payload, files

plivo/rest/client.py

@@ -24,6 +24,7 @@
 from plivo.resources.queued_calls import QueuedCalls
 from plivo.resources.regulatory_compliance import EndUsers, ComplianceDocumentTypes, ComplianceDocuments, \
     ComplianceRequirements, ComplianceApplications
+from plivo.resources.phone_number_compliance import PhoneNumberComplianceRequirements, PhoneNumberComplianceApplications, PhoneNumberComplianceLink
 from plivo.utils import is_valid_mainaccount, is_valid_subaccount
 from plivo.version import __version__
 from requests import Request, Session
@@ -127,6 +128,9 @@ def __init__(self, auth_id=None, auth_token=None, proxies=None, timeout=5):
         self.verify_session = Sessions(self)
         self.verify_callerids = VerifyCallerids(self)
         self.transcriptions = Transcriptions(self)
+        self.phone_number_compliance_requirements = PhoneNumberComplianceRequirements(self)
+        self.phone_number_compliance = PhoneNumberComplianceApplications(self)
+        self.phone_number_compliance_link = PhoneNumberComplianceLink(self)
 
 
     def __enter__(self):