api4datatug

type CompleteGitHubAuthorizationRequest ¶ added in v0.13.0

type CompleteGitHubAuthorizationRequest struct {
	Code  string `json:"code"`
	State string `json:"state"`
}

func (r CompleteGitHubAuthorizationRequest) Validate() error

type CompleteGitHubAuthorizationResponse ¶ added in v0.13.0

type CompleteGitHubAuthorizationResponse struct {
	Connected bool `json:"connected"`
}

type CreateProjectRequest ¶

type CreateProjectRequest struct {
	StoreID string `json:"-"`
	Title   string `json:"title"`
}

CreateProjectRequest is the body of a create-project request. The store is taken from the `?store=` query parameter (the same shape the datatug CLI agent's create_project endpoint uses), so it is not part of the JSON body.

func (v CreateProjectRequest) Validate() error

type CreateProjectResponse ¶

type CreateProjectResponse struct {
	ID string `json:"id"`
}

CreateProjectResponse is the response of a successful create-project call.

type CreateSharedProjectRequest ¶ added in v0.10.0

type CreateSharedProjectRequest struct {
	SpaceID   string `json:"spaceID"`
	CommandID string `json:"commandID"`
	Title     string `json:"title"`
}

func (r CreateSharedProjectRequest) Validate() error

type GitHubAuthorizationRouteOptions ¶ added in v0.13.0

type GitHubAuthorizationRouteOptions struct {
	Provider GitHubAuthorizationService
}

GitHubAuthorizationRouteOptions opts the host into actor-bound GitHub App OAuth routes. A nil provider keeps the routes fail-closed with 503.

type GitHubAuthorizationService ¶ added in v0.13.0

type GitHubAuthorizationService interface {
	BeginAuthorization(context.Context, string) (string, error)
	CompleteAuthorization(context.Context, string, string, string) error
	ListRepositories(context.Context, string) ([]githubauth4datatug.GitHubRepository, error)
}

GitHubAuthorizationService is the API layer's narrow host-composition port.

type GitHubRepositoryOption ¶ added in v0.13.0

type GitHubRepositoryOption struct {
	ID            int64  `json:"id"`
	Owner         string `json:"owner"`
	Name          string `json:"name"`
	DefaultBranch string `json:"defaultBranch"`
	Permission    string `json:"permission"`
}

type ListGitHubRepositoriesResponse ¶ added in v0.13.0

type ListGitHubRepositoriesResponse struct {
	Repositories []GitHubRepositoryOption `json:"repositories"`
}

type PlanRouteOptions ¶ added in v0.4.0

type PlanRouteOptions struct {
	Verifier VerifiedPlanCaller
	Service  facade4datatug.PersonalPlanService
}

type RegisterGithubProjectRequest ¶ added in v0.2.0

type RegisterGithubProjectRequest struct {
	Org    string `json:"org"`
	Repo   string `json:"repo"`
	Folder string `json:"folder"`
	Title  string `json:"title"`
}

RegisterGithubProjectRequest is the body of a register-github-project request: a project whose files the client has already committed to a GitHub repository, which the cloud only needs to record in the user's index.

func (v RegisterGithubProjectRequest) Validate() error

type RegisterGithubProjectResponse ¶ added in v0.2.0

type RegisterGithubProjectResponse struct {
	ID string `json:"id"`
}

RegisterGithubProjectResponse is the response of a successful call.

type RouteOptions ¶ added in v0.10.0

type RouteOptions struct {
	Plan                PlanRouteOptions
	SharedProjects      SharedProjectRouteOptions
	GitHubAuthorization GitHubAuthorizationRouteOptions
}

RouteOptions preserve the existing plan binding and explicitly opt a host into the new shared route. Old registration APIs retain their exact routes.

type SharedProjectRouteOptions ¶ added in v0.10.0

type SharedProjectRouteOptions struct {
	Service *facade4datatug.SharedProjectService
}

SharedProjectRouteOptions are opt-in. No host currently configures these; absent options do not enable creation or infer a Business billing binding. This stage proves Space/role ownership only. A later host activation must separately enforce paid-Space/shared-project limits and ended-plan read-only policy; Core membership alone is not a commercial entitlement. Host activation also requires reviewed Firebase rules: today's broad Space member grants do not make the separate create-receipt subtree private.

type StartGitHubAuthorizationResponse ¶ added in v0.13.0

type StartGitHubAuthorizationResponse struct {
	AuthorizationURL string `json:"authorizationURL"`
}

type VerifiedPlanCaller ¶ added in v0.4.0

type VerifiedPlanCaller interface {
	VerifyPlanCaller(context.Context, *http.Request) (string, error)
}

VerifiedPlanCaller is implemented by the host's credential verifier. It must check token signature, audience, scope and active grant as applicable; this route never regards the Authorization header itself as proof.