github.com/qiniu/go-sdk/v7@v7.27.0/sandbox/template.go

package sandbox

import (
	"context"
	"fmt"
	"time"
)

// ListDefaultTemplates 列出所有默认模板。
func (c *Client) ListDefaultTemplates(ctx context.Context) ([]Template, error) {
	resp, err := c.api.ListDefaultTemplatesWithResponse(ctx)
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templatesFromAPI(*resp.JSON200), nil
}

// ListTemplates 列出所有模板。
func (c *Client) ListTemplates(ctx context.Context, params *ListTemplatesParams) ([]Template, error) {
	resp, err := c.api.ListTemplatesWithResponse(ctx, params.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templatesFromAPI(*resp.JSON200), nil
}

// CreateTemplate 创建一个新模板（v3 API）。
func (c *Client) CreateTemplate(ctx context.Context, body CreateTemplateParams) (*TemplateCreateResponse, error) {
	resp, err := c.api.CreateTemplateV3WithResponse(ctx, body.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON202 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateCreateResponseFromAPI(resp.JSON202), nil
}

// GetTemplate 返回模板详情及其构建记录。
func (c *Client) GetTemplate(ctx context.Context, templateID string, params *GetTemplateParams) (*TemplateWithBuilds, error) {
	resp, err := c.api.GetTemplateWithResponse(ctx, templateID, params.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateWithBuildsFromAPI(resp.JSON200), nil
}

// DeleteTemplate 删除一个模板。
func (c *Client) DeleteTemplate(ctx context.Context, templateID string) error {
	resp, err := c.api.DeleteTemplateWithResponse(ctx, templateID)
	if err != nil {
		return err
	}
	sc := resp.HTTPResponse.StatusCode
	if sc != 200 && sc != 204 {
		return newAPIError(resp.HTTPResponse, resp.Body)
	}
	return nil
}

// UpdateTemplate 更新一个模板。
func (c *Client) UpdateTemplate(ctx context.Context, templateID string, body UpdateTemplateParams) error {
	resp, err := c.api.UpdateTemplateWithResponse(ctx, templateID, body.toAPI())
	if err != nil {
		return err
	}
	if resp.HTTPResponse.StatusCode != 200 {
		return newAPIError(resp.HTTPResponse, resp.Body)
	}
	return nil
}

// GetTemplateBuildStatus 返回模板的构建状态。
func (c *Client) GetTemplateBuildStatus(ctx context.Context, templateID, buildID string, params *GetBuildStatusParams) (*TemplateBuildInfo, error) {
	resp, err := c.api.GetTemplateBuildStatusWithResponse(ctx, templateID, buildID, params.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateBuildInfoFromAPI(resp.JSON200), nil
}

// GetTemplateBuildLogs 返回模板的构建日志。
func (c *Client) GetTemplateBuildLogs(ctx context.Context, templateID, buildID string, params *GetBuildLogsParams) (*TemplateBuildLogs, error) {
	resp, err := c.api.GetTemplateBuildLogsWithResponse(ctx, templateID, buildID, params.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateBuildLogsFromAPI(resp.JSON200), nil
}

// StartTemplateBuild 启动模板构建（v2 API）。
func (c *Client) StartTemplateBuild(ctx context.Context, templateID, buildID string, body StartTemplateBuildParams) error {
	apiBody, err := body.toAPI()
	if err != nil {
		return err
	}
	resp, err := c.api.StartTemplateBuildV2WithResponse(ctx, templateID, buildID, apiBody)
	if err != nil {
		return err
	}
	if resp.HTTPResponse.StatusCode != 202 {
		return newAPIError(resp.HTTPResponse, resp.Body)
	}
	return nil
}

// RebuildTemplate 在已有模板上创建一个新的 waiting build（对应 POST /templates/{templateID}）。
// 返回新 build 的标识（含 BuildID），调用方需随后调用 StartTemplateBuild 触发该 build。
// 典型流程：RebuildTemplate → StartTemplateBuild → WaitForBuild。
func (c *Client) RebuildTemplate(ctx context.Context, templateID string, body RebuildTemplateParams) (*TemplateCreateResponse, error) {
	resp, err := c.api.RebuildTemplateWithResponse(ctx, templateID, body.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON202 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateCreateResponseFromLegacyAPI(resp.JSON202), nil
}

// GetTemplateFiles 返回模板构建文件的上传链接。
func (c *Client) GetTemplateFiles(ctx context.Context, templateID, hash string) (*TemplateBuildFileUpload, error) {
	resp, err := c.api.GetTemplateFilesWithResponse(ctx, templateID, hash)
	if err != nil {
		return nil, err
	}
	if resp.JSON201 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateBuildFileUploadFromAPI(resp.JSON201), nil
}

// GetTemplateByAlias 检查指定别名的模板是否存在。
func (c *Client) GetTemplateByAlias(ctx context.Context, alias string) (*TemplateAliasResponse, error) {
	resp, err := c.api.GetTemplateByAliasWithResponse(ctx, alias)
	if err != nil {
		return nil, err
	}
	if resp.JSON200 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return templateAliasResponseFromAPI(resp.JSON200), nil
}

// AssignTemplateTags 为模板构建分配标签。
func (c *Client) AssignTemplateTags(ctx context.Context, body ManageTagsParams) (*AssignedTemplateTags, error) {
	resp, err := c.api.AssignTemplateTagsWithResponse(ctx, body.toAPI())
	if err != nil {
		return nil, err
	}
	if resp.JSON201 == nil {
		return nil, newAPIError(resp.HTTPResponse, resp.Body)
	}
	return assignedTemplateTagsFromAPI(resp.JSON201), nil
}

// DeleteTemplateTags 删除模板的标签。
func (c *Client) DeleteTemplateTags(ctx context.Context, body DeleteTagsParams) error {
	resp, err := c.api.DeleteTemplateTagsWithResponse(ctx, body.toAPI())
	if err != nil {
		return err
	}
	if resp.HTTPResponse.StatusCode != 204 {
		return newAPIError(resp.HTTPResponse, resp.Body)
	}
	return nil
}

// WaitForBuild 轮询 GetTemplateBuildStatus 直到构建达到终态（"ready" 或 "error"）。
// 默认轮询间隔为 2 秒，可通过 WithPollInterval 等选项自定义。
func (c *Client) WaitForBuild(ctx context.Context, templateID, buildID string, opts ...PollOption) (*TemplateBuildInfo, error) {
	o := defaultPollOpts(2 * time.Second)
	for _, fn := range opts {
		fn(o)
	}

	return pollLoop(ctx, o, func() (bool, *TemplateBuildInfo, error) {
		info, err := c.GetTemplateBuildStatus(ctx, templateID, buildID, nil)
		if err != nil {
			return false, nil, fmt.Errorf("get build status %s/%s: %w", templateID, buildID, err)
		}
		switch info.Status {
		case BuildStatusReady:
			return true, info, nil
		case BuildStatusError:
			return true, info, fmt.Errorf("build %s/%s failed", templateID, buildID)
		}
		return false, nil, nil
	})
}