release: 4.2.0 (#3917)

Author: stainless-app[bot]

.devcontainer/Dockerfile

@@ -5,19 +5,18 @@ RUN apt-get update && apt-get install -y \
   libxkbcommon0 \
   ca-certificates \
   git \
-  golang \
   unzip \
   libc++1 \
   vim \
+  curl \
+  procps \
   && apt-get clean autoclean
 
+RUN curl -OL https://go.dev/dl/go1.24.0.linux-amd64.tar.gz && \
+  tar -C /usr/local -xzvf go1.24.0.linux-amd64.tar.gz && \
+  rm go1.24.0.linux-amd64.tar.gz
+ENV PATH="$PATH:/usr/local/go/bin"
+
 # Ensure UTF-8 encoding
 ENV LANG=C.UTF-8
 ENV LC_ALL=C.UTF-8
-
-ENV GOPATH=/go
-ENV PATH=$GOPATH/bin:$PATH
-
-WORKDIR /workspace
-
-COPY . /workspace

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.1.0"
+  ".": "4.2.0"
 }

.stats.yml

@@ -1,2 +1,2 @@
-configured_endpoints: 1525
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-4c85e60ad7ca96a7ddadf88e1e3c7b62fb791d39d435bedfe6caac2c27081a48.yml
+configured_endpoints: 1655
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-0ed9f898b31619623e50d660d04beca50e44987bfd3eb3a6ff98d3bca2a9c569.yml

CHANGELOG.md

@@ -22,7 +22,7 @@ Or to pin the version:
 <!-- x-release-please-start-version -->
 
 ```sh
-go get -u 'github.com/cloudflare/cloudflare-go/v4@v4.1.0'
+go get -u 'github.com/cloudflare/cloudflare-go/v4@v4.2.0'
 ```
 
 <!-- x-release-please-end -->
@@ -255,6 +255,30 @@ file returned by `os.Open` will be sent with the file name on disk.
 We also provide a helper `cloudflare.FileParam(reader io.Reader, filename string, contentType string)`
 which can be used to wrap any `io.Reader` with the appropriate file name and content type.
 
+```go
+// A file from the file system
+file, err := os.Open("/path/to/file")
+api_gateway.UserSchemaNewParams{
+	ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+	File:   cloudflare.F[io.Reader](file),
+	Kind:   cloudflare.F(api_gateway.UserSchemaNewParamsKindOpenAPIV3),
+}
+
+// A file from a string
+api_gateway.UserSchemaNewParams{
+	ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+	File:   cloudflare.F[io.Reader](strings.NewReader("my file contents")),
+	Kind:   cloudflare.F(api_gateway.UserSchemaNewParamsKindOpenAPIV3),
+}
+
+// With a custom filename and contentType
+api_gateway.UserSchemaNewParams{
+	ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+	File:   cloudflare.FileParam(strings.NewReader(`{"hello": "foo"}`), "file.go", "application/json"),
+	Kind:   cloudflare.F(api_gateway.UserSchemaNewParamsKindOpenAPIV3),
+}
+```
+
 ### Retries
 
 Certain errors will be automatically retried 2 times by default, with a short exponential backoff.

README.md

@@ -1 +1,3 @@
-Please see [this page](https://www.cloudflare.com/.well-known/security.txt) for information on how to report a vulnerability to Cloudflare. Thanks!
+# Reporting Security Vulnerabilities
+
+Please see [this page](https://www.cloudflare.com/.well-known/security.txt) for information on how to report a vulnerability to Cloudflare. Thanks!

SECURITY.md

@@ -32,35 +32,37 @@ func TestAbuseReportNewWithOptionalParams(t *testing.T) {
 		context.TODO(),
 		abuse_reports.AbuseReportNewParamsReportTypeAbuseDmca,
 		abuse_reports.AbuseReportNewParams{
-			AccountID:                  cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
-			Act:                        cloudflare.F(abuse_reports.AbuseReportNewParamsActAbuseDmca),
-			Agree:                      cloudflare.F(abuse_reports.AbuseReportNewParamsAgree0),
-			Email:                      cloudflare.F("email"),
-			Email2:                     cloudflare.F("email2"),
-			HostNotification:           cloudflare.F(abuse_reports.AbuseReportNewParamsHostNotificationSend),
-			NcmecNotification:          cloudflare.F(abuse_reports.AbuseReportNewParamsNcmecNotificationSend),
-			OwnerNotification:          cloudflare.F(abuse_reports.AbuseReportNewParamsOwnerNotificationSend),
-			URLs:                       cloudflare.F("urls"),
-			Address1:                   cloudflare.F("x"),
-			AgentName:                  cloudflare.F("x"),
-			City:                       cloudflare.F("x"),
-			Comments:                   cloudflare.F("x"),
-			Company:                    cloudflare.F("x"),
-			Country:                    cloudflare.F("x"),
-			DestinationIPs:             cloudflare.F("destination_ips"),
-			Justification:              cloudflare.F("x"),
-			Name:                       cloudflare.F("x"),
-			NcseiSubjectRepresentation: cloudflare.F(true),
-			OriginalWork:               cloudflare.F("x"),
-			PortsProtocols:             cloudflare.F("ports_protocols"),
-			Signature:                  cloudflare.F("signature"),
-			SourceIPs:                  cloudflare.F("source_ips"),
-			State:                      cloudflare.F("x"),
-			Tele:                       cloudflare.F("x"),
-			Title:                      cloudflare.F("x"),
-			TrademarkNumber:            cloudflare.F("x"),
-			TrademarkOffice:            cloudflare.F("x"),
-			TrademarkSymbol:            cloudflare.F("x"),
+			AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+			Body: abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReport{
+				Address1:                   cloudflare.F("x"),
+				AgentName:                  cloudflare.F("x"),
+				Agree:                      cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportAgree0),
+				City:                       cloudflare.F("x"),
+				Country:                    cloudflare.F("x"),
+				HostNotification:           cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportHostNotificationSend),
+				OriginalWork:               cloudflare.F("x"),
+				OwnerNotification:          cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportOwnerNotificationSend),
+				Signature:                  cloudflare.F("signature"),
+				State:                      cloudflare.F("x"),
+				Act:                        cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportActAbuseDmca),
+				Comments:                   cloudflare.F("x"),
+				Company:                    cloudflare.F("x"),
+				DestinationIPs:             cloudflare.F("destination_ips"),
+				Email:                      cloudflare.F("email"),
+				Email2:                     cloudflare.F("email2"),
+				Justification:              cloudflare.F("x"),
+				Name:                       cloudflare.F("x"),
+				NcmecNotification:          cloudflare.F(abuse_reports.AbuseReportNewParamsBodyAbuseReportsDmcaReportNcmecNotificationSend),
+				NcseiSubjectRepresentation: cloudflare.F(true),
+				PortsProtocols:             cloudflare.F("ports_protocols"),
+				SourceIPs:                  cloudflare.F("source_ips"),
+				Tele:                       cloudflare.F("x"),
+				Title:                      cloudflare.F("x"),
+				TrademarkNumber:            cloudflare.F("x"),
+				TrademarkOffice:            cloudflare.F("x"),
+				TrademarkSymbol:            cloudflare.F("x"),
+				URLs:                       cloudflare.F("urls"),
+			},
 		},
 	)
 	if err != nil {

abuse_reports/abusereport.go

@@ -115,6 +115,12 @@ const CloudflareTunnelTunTypeCfdTunnel = shared.CloudflareTunnelTunTypeCfdTunnel
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeWARPConnector = shared.CloudflareTunnelTunTypeWARPConnector
 
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeWARP = shared.CloudflareTunnelTunTypeWARP
+
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeMagic = shared.CloudflareTunnelTunTypeMagic
+
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeIPSec = shared.CloudflareTunnelTunTypeIPSec
 
@@ -127,6 +133,9 @@ const CloudflareTunnelTunTypeCNI = shared.CloudflareTunnelTunTypeCNI
 // This is an alias to an internal type.
 type ErrorData = shared.ErrorData
 
+// This is an alias to an internal type.
+type ErrorDataSource = shared.ErrorDataSource
+
 // This is an alias to an internal type.
 type Member = shared.Member
 

abuse_reports/abusereport_test.go

@@ -115,6 +115,12 @@ const CloudflareTunnelTunTypeCfdTunnel = shared.CloudflareTunnelTunTypeCfdTunnel
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeWARPConnector = shared.CloudflareTunnelTunTypeWARPConnector
 
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeWARP = shared.CloudflareTunnelTunTypeWARP
+
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeMagic = shared.CloudflareTunnelTunTypeMagic
+
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeIPSec = shared.CloudflareTunnelTunTypeIPSec
 
@@ -127,6 +133,9 @@ const CloudflareTunnelTunTypeCNI = shared.CloudflareTunnelTunTypeCNI
 // This is an alias to an internal type.
 type ErrorData = shared.ErrorData
 
+// This is an alias to an internal type.
+type ErrorDataSource = shared.ErrorDataSource
+
 // This is an alias to an internal type.
 type Member = shared.Member
 

abuse_reports/aliases.go

@@ -36,11 +36,13 @@ func TestTokenNewWithOptionalParams(t *testing.T) {
 		Policies: cloudflare.F([]shared.TokenPolicyParam{{
 			Effect: cloudflare.F(shared.TokenPolicyEffectAllow),
 			PermissionGroups: cloudflare.F([]shared.TokenPolicyPermissionGroupParam{{
+				ID: cloudflare.F("c8fed203ed3043cba015a93ad1616f1f"),
 				Meta: cloudflare.F(shared.TokenPolicyPermissionGroupsMetaParam{
 					Key:   cloudflare.F("key"),
 					Value: cloudflare.F("value"),
 				}),
 			}, {
+				ID: cloudflare.F("82e64a83756745bbbb1c9c2701bf816b"),
 				Meta: cloudflare.F(shared.TokenPolicyPermissionGroupsMetaParam{
 					Key:   cloudflare.F("key"),
 					Value: cloudflare.F("value"),
@@ -101,11 +103,13 @@ func TestTokenUpdateWithOptionalParams(t *testing.T) {
 				Policies: cloudflare.F([]shared.TokenPolicyParam{{
 					Effect: cloudflare.F(shared.TokenPolicyEffectAllow),
 					PermissionGroups: cloudflare.F([]shared.TokenPolicyPermissionGroupParam{{
+						ID: cloudflare.F("c8fed203ed3043cba015a93ad1616f1f"),
 						Meta: cloudflare.F(shared.TokenPolicyPermissionGroupsMetaParam{
 							Key:   cloudflare.F("key"),
 							Value: cloudflare.F("value"),
 						}),
 					}, {
+						ID: cloudflare.F("82e64a83756745bbbb1c9c2701bf816b"),
 						Meta: cloudflare.F(shared.TokenPolicyPermissionGroupsMetaParam{
 							Key:   cloudflare.F("key"),
 							Value: cloudflare.F("value"),

accounts/aliases.go

@@ -8,6 +8,7 @@ import (
 	"fmt"
 	"net/http"
 
+	"github.com/cloudflare/cloudflare-go/v4/internal/apijson"
 	"github.com/cloudflare/cloudflare-go/v4/internal/param"
 	"github.com/cloudflare/cloudflare-go/v4/internal/requestconfig"
 	"github.com/cloudflare/cloudflare-go/v4/option"
@@ -87,9 +88,95 @@ func (r *TokenPermissionGroupService) GetAutoPaging(ctx context.Context, query T
 	return pagination.NewSinglePageAutoPager(r.Get(ctx, query, opts...))
 }
 
-type TokenPermissionGroupListResponse = interface{}
+type TokenPermissionGroupListResponse struct {
+	// Public ID.
+	ID string `json:"id"`
+	// Permission Group Name
+	Name string `json:"name"`
+	// Resources to which the Permission Group is scoped
+	Scopes []TokenPermissionGroupListResponseScope `json:"scopes"`
+	JSON   tokenPermissionGroupListResponseJSON    `json:"-"`
+}
+
+// tokenPermissionGroupListResponseJSON contains the JSON metadata for the struct
+// [TokenPermissionGroupListResponse]
+type tokenPermissionGroupListResponseJSON struct {
+	ID          apijson.Field
+	Name        apijson.Field
+	Scopes      apijson.Field
+	raw         string
+	ExtraFields map[string]apijson.Field
+}
+
+func (r *TokenPermissionGroupListResponse) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r tokenPermissionGroupListResponseJSON) RawJSON() string {
+	return r.raw
+}
+
+type TokenPermissionGroupListResponseScope string
+
+const (
+	TokenPermissionGroupListResponseScopeComCloudflareAPIAccount     TokenPermissionGroupListResponseScope = "com.cloudflare.api.account"
+	TokenPermissionGroupListResponseScopeComCloudflareAPIAccountZone TokenPermissionGroupListResponseScope = "com.cloudflare.api.account.zone"
+	TokenPermissionGroupListResponseScopeComCloudflareAPIUser        TokenPermissionGroupListResponseScope = "com.cloudflare.api.user"
+	TokenPermissionGroupListResponseScopeComCloudflareEdgeR2Bucket   TokenPermissionGroupListResponseScope = "com.cloudflare.edge.r2.bucket"
+)
+
+func (r TokenPermissionGroupListResponseScope) IsKnown() bool {
+	switch r {
+	case TokenPermissionGroupListResponseScopeComCloudflareAPIAccount, TokenPermissionGroupListResponseScopeComCloudflareAPIAccountZone, TokenPermissionGroupListResponseScopeComCloudflareAPIUser, TokenPermissionGroupListResponseScopeComCloudflareEdgeR2Bucket:
+		return true
+	}
+	return false
+}
 
-type TokenPermissionGroupGetResponse = interface{}
+type TokenPermissionGroupGetResponse struct {
+	// Public ID.
+	ID string `json:"id"`
+	// Permission Group Name
+	Name string `json:"name"`
+	// Resources to which the Permission Group is scoped
+	Scopes []TokenPermissionGroupGetResponseScope `json:"scopes"`
+	JSON   tokenPermissionGroupGetResponseJSON    `json:"-"`
+}
+
+// tokenPermissionGroupGetResponseJSON contains the JSON metadata for the struct
+// [TokenPermissionGroupGetResponse]
+type tokenPermissionGroupGetResponseJSON struct {
+	ID          apijson.Field
+	Name        apijson.Field
+	Scopes      apijson.Field
+	raw         string
+	ExtraFields map[string]apijson.Field
+}
+
+func (r *TokenPermissionGroupGetResponse) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r tokenPermissionGroupGetResponseJSON) RawJSON() string {
+	return r.raw
+}
+
+type TokenPermissionGroupGetResponseScope string
+
+const (
+	TokenPermissionGroupGetResponseScopeComCloudflareAPIAccount     TokenPermissionGroupGetResponseScope = "com.cloudflare.api.account"
+	TokenPermissionGroupGetResponseScopeComCloudflareAPIAccountZone TokenPermissionGroupGetResponseScope = "com.cloudflare.api.account.zone"
+	TokenPermissionGroupGetResponseScopeComCloudflareAPIUser        TokenPermissionGroupGetResponseScope = "com.cloudflare.api.user"
+	TokenPermissionGroupGetResponseScopeComCloudflareEdgeR2Bucket   TokenPermissionGroupGetResponseScope = "com.cloudflare.edge.r2.bucket"
+)
+
+func (r TokenPermissionGroupGetResponseScope) IsKnown() bool {
+	switch r {
+	case TokenPermissionGroupGetResponseScopeComCloudflareAPIAccount, TokenPermissionGroupGetResponseScopeComCloudflareAPIAccountZone, TokenPermissionGroupGetResponseScopeComCloudflareAPIUser, TokenPermissionGroupGetResponseScopeComCloudflareEdgeR2Bucket:
+		return true
+	}
+	return false
+}
 
 type TokenPermissionGroupListParams struct {
 	// Account identifier tag.

accounts/token_test.go

@@ -115,6 +115,12 @@ const CloudflareTunnelTunTypeCfdTunnel = shared.CloudflareTunnelTunTypeCfdTunnel
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeWARPConnector = shared.CloudflareTunnelTunTypeWARPConnector
 
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeWARP = shared.CloudflareTunnelTunTypeWARP
+
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeMagic = shared.CloudflareTunnelTunTypeMagic
+
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeIPSec = shared.CloudflareTunnelTunTypeIPSec
 
@@ -127,6 +133,9 @@ const CloudflareTunnelTunTypeCNI = shared.CloudflareTunnelTunTypeCNI
 // This is an alias to an internal type.
 type ErrorData = shared.ErrorData
 
+// This is an alias to an internal type.
+type ErrorDataSource = shared.ErrorDataSource
+
 // This is an alias to an internal type.
 type Member = shared.Member
 

accounts/tokenpermissiongroup.go

@@ -115,6 +115,12 @@ const CloudflareTunnelTunTypeCfdTunnel = shared.CloudflareTunnelTunTypeCfdTunnel
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeWARPConnector = shared.CloudflareTunnelTunTypeWARPConnector
 
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeWARP = shared.CloudflareTunnelTunTypeWARP
+
+// This is an alias to an internal value.
+const CloudflareTunnelTunTypeMagic = shared.CloudflareTunnelTunTypeMagic
+
 // This is an alias to an internal value.
 const CloudflareTunnelTunTypeIPSec = shared.CloudflareTunnelTunTypeIPSec
 
@@ -127,6 +133,9 @@ const CloudflareTunnelTunTypeCNI = shared.CloudflareTunnelTunTypeCNI
 // This is an alias to an internal type.
 type ErrorData = shared.ErrorData
 
+// This is an alias to an internal type.
+type ErrorDataSource = shared.ErrorDataSource
+
 // This is an alias to an internal type.
 type Member = shared.Member