feat: feat(api): add csam_scanner Stainless resource (TMD-1300, LRSP-1810)

* feat(api): use csam_scanner as top-level resource (TMD-1300)

Replaces the original bot-authored structure (csam_scanner parent with
third_party subresource pointing at non-existent /settings/csam_scanner
paths) with a single top-level csam_scanner resource whose methods
point at the real /settings/csam_scanner_third_party endpoint.

This matches the structure already on the staging branch (via !922):
  client.zones.settings.csam_scanner.get(zone_id=...)
  client.zones.settings.csam_scanner.edit(zone_id=..., ...)

Required because the csam_scanner path was removed from the OpenAPI
spec in csam-config-service !453 (only csam_scanner_third_party is
operational). Keeping the old structure would cause Stainless codegen
to reference paths that don't exist in the production aggregate.

* feat(api): add csam_scanner to SDK navigation listing

Register csam_scanner in the Security section of the resources
navigation so it appears in SDK client namespaces and generated docs.

Ref: APIX-798

* feat(api): add CSAM scanner settings endpoint mappings

Map csam_scanner and csam_scanner_third_party zone settings endpoints
to SDK resources with get and edit methods.

Ref: APIX-798

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 2307
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-774615a3ce44b5eb565859bf51c5943af86fde77b7d12b7d796892d6203dc330.yml
+configured_endpoints: 2309
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare/cloudflare-01d10fad10d28bf4cdd77d09cb2144e5622c7ec37a61e9cf631550b951dbbb76.yml
 openapi_spec_hash: 0a8f757d1f412c1d81fb1ecf4bfba78b
-config_hash: aed7aa51410f7a92236320eb8c9040f1
+config_hash: 8dfaaa0e720fb13448f4c6f7b22dffab

api.md

@@ -231,6 +231,8 @@ from cloudflare.types import (
 
 # [AISecurity](src/cloudflare/resources/ai_security/api.md)
 
+# [CsamScanner](src/cloudflare/resources/csam_scanner/api.md)
+
 # [AbuseReports](src/cloudflare/resources/abuse_reports/api.md)
 
 # [AI](src/cloudflare/resources/ai/api.md)

src/cloudflare/_client.py

@@ -99,6 +99,7 @@
         rate_limits,
         url_scanner,
         connectivity,
+        csam_scanner,
         custom_pages,
         dns_firewall,
         healthchecks,
@@ -211,6 +212,7 @@
     from .resources.rate_limits.rate_limits import RateLimitsResource, AsyncRateLimitsResource
     from .resources.url_scanner.url_scanner import URLScannerResource, AsyncURLScannerResource
     from .resources.connectivity.connectivity import ConnectivityResource, AsyncConnectivityResource
+    from .resources.csam_scanner.csam_scanner import CsamScannerResource, AsyncCsamScannerResource
     from .resources.custom_pages.custom_pages import CustomPagesResource, AsyncCustomPagesResource
     from .resources.dns_firewall.dns_firewall import DNSFirewallResource, AsyncDNSFirewallResource
     from .resources.healthchecks.healthchecks import HealthchecksResource, AsyncHealthchecksResource
@@ -1014,6 +1016,12 @@ def ai_security(self) -> AISecurityResource:
 
         return AISecurityResource(self)
 
+    @cached_property
+    def csam_scanner(self) -> CsamScannerResource:
+        from .resources.csam_scanner import CsamScannerResource
+
+        return CsamScannerResource(self)
+
     @cached_property
     def abuse_reports(self) -> AbuseReportsResource:
         from .resources.abuse_reports import AbuseReportsResource
@@ -1942,6 +1950,12 @@ def ai_security(self) -> AsyncAISecurityResource:
 
         return AsyncAISecurityResource(self)
 
+    @cached_property
+    def csam_scanner(self) -> AsyncCsamScannerResource:
+        from .resources.csam_scanner import AsyncCsamScannerResource
+
+        return AsyncCsamScannerResource(self)
+
     @cached_property
     def abuse_reports(self) -> AsyncAbuseReportsResource:
         from .resources.abuse_reports import AsyncAbuseReportsResource
@@ -2792,6 +2806,12 @@ def ai_security(self) -> ai_security.AISecurityResourceWithRawResponse:
 
         return AISecurityResourceWithRawResponse(self._client.ai_security)
 
+    @cached_property
+    def csam_scanner(self) -> csam_scanner.CsamScannerResourceWithRawResponse:
+        from .resources.csam_scanner import CsamScannerResourceWithRawResponse
+
+        return CsamScannerResourceWithRawResponse(self._client.csam_scanner)
+
     @cached_property
     def abuse_reports(self) -> abuse_reports.AbuseReportsResourceWithRawResponse:
         from .resources.abuse_reports import AbuseReportsResourceWithRawResponse
@@ -3469,6 +3489,12 @@ def ai_security(self) -> ai_security.AsyncAISecurityResourceWithRawResponse:
 
         return AsyncAISecurityResourceWithRawResponse(self._client.ai_security)
 
+    @cached_property
+    def csam_scanner(self) -> csam_scanner.AsyncCsamScannerResourceWithRawResponse:
+        from .resources.csam_scanner import AsyncCsamScannerResourceWithRawResponse
+
+        return AsyncCsamScannerResourceWithRawResponse(self._client.csam_scanner)
+
     @cached_property
     def abuse_reports(self) -> abuse_reports.AsyncAbuseReportsResourceWithRawResponse:
         from .resources.abuse_reports import AsyncAbuseReportsResourceWithRawResponse
@@ -4146,6 +4172,12 @@ def ai_security(self) -> ai_security.AISecurityResourceWithStreamingResponse:
 
         return AISecurityResourceWithStreamingResponse(self._client.ai_security)
 
+    @cached_property
+    def csam_scanner(self) -> csam_scanner.CsamScannerResourceWithStreamingResponse:
+        from .resources.csam_scanner import CsamScannerResourceWithStreamingResponse
+
+        return CsamScannerResourceWithStreamingResponse(self._client.csam_scanner)
+
     @cached_property
     def abuse_reports(self) -> abuse_reports.AbuseReportsResourceWithStreamingResponse:
         from .resources.abuse_reports import AbuseReportsResourceWithStreamingResponse
@@ -4833,6 +4865,12 @@ def ai_security(self) -> ai_security.AsyncAISecurityResourceWithStreamingRespons
 
         return AsyncAISecurityResourceWithStreamingResponse(self._client.ai_security)
 
+    @cached_property
+    def csam_scanner(self) -> csam_scanner.AsyncCsamScannerResourceWithStreamingResponse:
+        from .resources.csam_scanner import AsyncCsamScannerResourceWithStreamingResponse
+
+        return AsyncCsamScannerResourceWithStreamingResponse(self._client.csam_scanner)
+
     @cached_property
     def abuse_reports(self) -> abuse_reports.AsyncAbuseReportsResourceWithStreamingResponse:
         from .resources.abuse_reports import AsyncAbuseReportsResourceWithStreamingResponse

src/cloudflare/resources/csam_scanner/__init__.py

@@ -0,0 +1,19 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .csam_scanner import (
+    CsamScannerResource,
+    AsyncCsamScannerResource,
+    CsamScannerResourceWithRawResponse,
+    AsyncCsamScannerResourceWithRawResponse,
+    CsamScannerResourceWithStreamingResponse,
+    AsyncCsamScannerResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "CsamScannerResource",
+    "AsyncCsamScannerResource",
+    "CsamScannerResourceWithRawResponse",
+    "AsyncCsamScannerResourceWithRawResponse",
+    "CsamScannerResourceWithStreamingResponse",
+    "AsyncCsamScannerResourceWithStreamingResponse",
+]

src/cloudflare/resources/csam_scanner/api.md

@@ -0,0 +1,12 @@
+# CsamScanner
+
+Types:
+
+```python
+from cloudflare.types.csam_scanner import CsamScannerEditResponse, CsamScannerGetResponse
+```
+
+Methods:
+
+- <code title="patch /zones/{zone_id}/settings/csam_scanner_third_party">client.csam_scanner.<a href="./src/cloudflare/resources/csam_scanner/csam_scanner.py">edit</a>(\*, zone_id, \*\*<a href="src/cloudflare/types/csam_scanner/csam_scanner_edit_params.py">params</a>) -> <a href="./src/cloudflare/types/csam_scanner/csam_scanner_edit_response.py">Optional[CsamScannerEditResponse]</a></code>
+- <code title="get /zones/{zone_id}/settings/csam_scanner_third_party">client.csam_scanner.<a href="./src/cloudflare/resources/csam_scanner/csam_scanner.py">get</a>(\*, zone_id) -> <a href="./src/cloudflare/types/csam_scanner/csam_scanner_get_response.py">Optional[CsamScannerGetResponse]</a></code>