feat(api): OpenAPI spec update via Stainless API

api.md

@@ -3589,7 +3589,7 @@ Response Types:
 Methods:
 
 - <code title="post /accounts/{account_id}/pages/projects/{project_name}/deployments">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.New">New</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, params <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentNewParams">ProjectDeploymentNewParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#PagesDeployments">PagesDeployments</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
-- <code title="get /accounts/{account_id}/pages/projects/{project_name}/deployments">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, query <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentListParams">ProjectDeploymentListParams</a>) ([]<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#PagesDeployments">PagesDeployments</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="get /accounts/{account_id}/pages/projects/{project_name}/deployments">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.List">List</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, params <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentListParams">ProjectDeploymentListParams</a>) ([]<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#PagesDeployments">PagesDeployments</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="delete /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, deploymentID <a href="https://pkg.go.dev/builtin#string">string</a>, body <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentDeleteParams">ProjectDeploymentDeleteParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentDeleteResponse">ProjectDeploymentDeleteResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="get /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, deploymentID <a href="https://pkg.go.dev/builtin#string">string</a>, query <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentGetParams">ProjectDeploymentGetParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#PagesDeployments">PagesDeployments</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 - <code title="post /accounts/{account_id}/pages/projects/{project_name}/deployments/{deployment_id}/retry">client.Pages.Projects.Deployments.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentService.Retry">Retry</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, projectName <a href="https://pkg.go.dev/builtin#string">string</a>, deploymentID <a href="https://pkg.go.dev/builtin#string">string</a>, body <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#ProjectDeploymentRetryParams">ProjectDeploymentRetryParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages">pages</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v2/pages#PagesDeployments">PagesDeployments</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>

pages/project.go

@@ -1033,6 +1033,8 @@ func (r pagesProjectsDeploymentConfigsPreviewServicesJSON) RawJSON() string {
 
 // Service binding.
 type PagesProjectsDeploymentConfigsPreviewServicesServiceBinding struct {
+	// The entrypoint to bind to.
+	Entrypoint string `json:"entrypoint,nullable"`
 	// The Service environment.
 	Environment string `json:"environment"`
 	// The Service name.
@@ -1044,6 +1046,7 @@ type PagesProjectsDeploymentConfigsPreviewServicesServiceBinding struct {
 // JSON metadata for the struct
 // [PagesProjectsDeploymentConfigsPreviewServicesServiceBinding]
 type pagesProjectsDeploymentConfigsPreviewServicesServiceBindingJSON struct {
+	Entrypoint  apijson.Field
 	Environment apijson.Field
 	Service     apijson.Field
 	raw         string
@@ -1733,6 +1736,8 @@ func (r pagesProjectsDeploymentConfigsProductionServicesJSON) RawJSON() string {
 
 // Service binding.
 type PagesProjectsDeploymentConfigsProductionServicesServiceBinding struct {
+	// The entrypoint to bind to.
+	Entrypoint string `json:"entrypoint,nullable"`
 	// The Service environment.
 	Environment string `json:"environment"`
 	// The Service name.
@@ -1744,6 +1749,7 @@ type PagesProjectsDeploymentConfigsProductionServicesServiceBinding struct {
 // JSON metadata for the struct
 // [PagesProjectsDeploymentConfigsProductionServicesServiceBinding]
 type pagesProjectsDeploymentConfigsProductionServicesServiceBindingJSON struct {
+	Entrypoint  apijson.Field
 	Environment apijson.Field
 	Service     apijson.Field
 	raw         string
@@ -2197,6 +2203,8 @@ func (r ProjectNewParamsDeploymentConfigsPreviewServices) MarshalJSON() (data []
 
 // Service binding.
 type ProjectNewParamsDeploymentConfigsPreviewServicesServiceBinding struct {
+	// The entrypoint to bind to.
+	Entrypoint param.Field[string] `json:"entrypoint"`
 	// The Service environment.
 	Environment param.Field[string] `json:"environment"`
 	// The Service name.
@@ -2513,6 +2521,8 @@ func (r ProjectNewParamsDeploymentConfigsProductionServices) MarshalJSON() (data
 
 // Service binding.
 type ProjectNewParamsDeploymentConfigsProductionServicesServiceBinding struct {
+	// The entrypoint to bind to.
+	Entrypoint param.Field[string] `json:"entrypoint"`
 	// The Service environment.
 	Environment param.Field[string] `json:"environment"`
 	// The Service name.

pages/project_test.go

@@ -102,6 +102,7 @@ func TestProjectNewWithOptionalParams(t *testing.T) {
 				}),
 				Services: cloudflare.F(pages.ProjectNewParamsDeploymentConfigsPreviewServices{
 					ServiceBinding: cloudflare.F(pages.ProjectNewParamsDeploymentConfigsPreviewServicesServiceBinding{
+						Entrypoint:  cloudflare.F("MyHandler"),
 						Environment: cloudflare.F("production"),
 						Service:     cloudflare.F("example-worker"),
 					}),
@@ -174,6 +175,7 @@ func TestProjectNewWithOptionalParams(t *testing.T) {
 				}),
 				Services: cloudflare.F(pages.ProjectNewParamsDeploymentConfigsProductionServices{
 					ServiceBinding: cloudflare.F(pages.ProjectNewParamsDeploymentConfigsProductionServicesServiceBinding{
+						Entrypoint:  cloudflare.F("MyHandler"),
 						Environment: cloudflare.F("production"),
 						Service:     cloudflare.F("example-worker"),
 					}),

pages/projectdeployment.go

@@ -6,8 +6,10 @@ import (
 	"context"
 	"fmt"
 	"net/http"
+	"net/url"
 
 	"github.com/cloudflare/cloudflare-go/v2/internal/apijson"
+	"github.com/cloudflare/cloudflare-go/v2/internal/apiquery"
 	"github.com/cloudflare/cloudflare-go/v2/internal/param"
 	"github.com/cloudflare/cloudflare-go/v2/internal/requestconfig"
 	"github.com/cloudflare/cloudflare-go/v2/option"
@@ -48,11 +50,11 @@ func (r *ProjectDeploymentService) New(ctx context.Context, projectName string,
 }
 
 // Fetch a list of project deployments.
-func (r *ProjectDeploymentService) List(ctx context.Context, projectName string, query ProjectDeploymentListParams, opts ...option.RequestOption) (res *[]PagesDeployments, err error) {
+func (r *ProjectDeploymentService) List(ctx context.Context, projectName string, params ProjectDeploymentListParams, opts ...option.RequestOption) (res *[]PagesDeployments, err error) {
 	opts = append(r.Options[:], opts...)
 	var env ProjectDeploymentListResponseEnvelope
-	path := fmt.Sprintf("accounts/%s/pages/projects/%s/deployments", query.AccountID, projectName)
-	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, nil, &env, opts...)
+	path := fmt.Sprintf("accounts/%s/pages/projects/%s/deployments", params.AccountID, projectName)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodGet, path, params, &env, opts...)
 	if err != nil {
 		return
 	}
@@ -214,6 +216,33 @@ func (r ProjectDeploymentNewResponseEnvelopeSuccess) IsKnown() bool {
 type ProjectDeploymentListParams struct {
 	// Identifier
 	AccountID param.Field[string] `path:"account_id,required"`
+	// What type of deployments to fetch.
+	Env param.Field[ProjectDeploymentListParamsEnv] `query:"env"`
+}
+
+// URLQuery serializes [ProjectDeploymentListParams]'s query parameters as
+// `url.Values`.
+func (r ProjectDeploymentListParams) URLQuery() (v url.Values) {
+	return apiquery.MarshalWithSettings(r, apiquery.QuerySettings{
+		ArrayFormat:  apiquery.ArrayQueryFormatComma,
+		NestedFormat: apiquery.NestedQueryFormatBrackets,
+	})
+}
+
+// What type of deployments to fetch.
+type ProjectDeploymentListParamsEnv string
+
+const (
+	ProjectDeploymentListParamsEnvProduction ProjectDeploymentListParamsEnv = "production"
+	ProjectDeploymentListParamsEnvPreview    ProjectDeploymentListParamsEnv = "preview"
+)
+
+func (r ProjectDeploymentListParamsEnv) IsKnown() bool {
+	switch r {
+	case ProjectDeploymentListParamsEnvProduction, ProjectDeploymentListParamsEnvPreview:
+		return true
+	}
+	return false
 }
 
 type ProjectDeploymentListResponseEnvelope struct {

pages/projectdeployment_test.go

@@ -45,7 +45,7 @@ func TestProjectDeploymentNewWithOptionalParams(t *testing.T) {
 	}
 }
 
-func TestProjectDeploymentList(t *testing.T) {
+func TestProjectDeploymentListWithOptionalParams(t *testing.T) {
 	t.Skip("skipped: tests are disabled for the time being")
 	baseURL := "http://localhost:4010"
 	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {
@@ -64,6 +64,7 @@ func TestProjectDeploymentList(t *testing.T) {
 		"this-is-my-project-01",
 		pages.ProjectDeploymentListParams{
 			AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+			Env:       cloudflare.F(pages.ProjectDeploymentListParamsEnvPreview),
 		},
 	)
 	if err != nil {