platform

Documentation

Index

• func CreateOAuthSession(ctx context.Context, p *CreateOAuthSessionParams) (authURL string, err error)
• func CreateSecretGroup(ctx context.Context, p CreateSecretGroupParams) error
• func CreateSecretVersion(ctx context.Context, p CreateSecretVersionParams) error
• func DBConnect(ctx context.Context, appSlug, envSlug, dbName string, startupData []byte) (*websocket.Conn, error)
• func EnvLogs(ctx context.Context, appSlug, envSlug string) (*websocket.Conn, error)
• func GetEnvMeta(ctx context.Context, appSlug, envName string) (*metav1.Data, error)
• func GetLocalSecretValues(ctx context.Context, appSlug string, poll bool) (secrets map[string]string, err error)
• func ListSecretGroups(ctx context.Context, appSlug string, keys []string) ([]*gql.Secret, error)
• func UpdateSecretGroup(ctx context.Context, p UpdateSecretGroupParams) error
• type App
  • func CreateApp(ctx context.Context, p *CreateAppParams) (*App, error)
  • func GetApp(ctx context.Context, appSlug string) (*App, error)
  • func ListApps(ctx context.Context) ([]*App, error)
• type CreateAppParams
• type CreateOAuthSessionParams
• type CreateSecretGroupParams
• type CreateSecretVersionParams
• type Env
  • func ListEnvs(ctx context.Context, appSlug string) ([]*Env, error)
• type Error
  • func (e Error) Error() string
• type ExchangeAuthKeyParams
• type ExchangeOAuthTokenParams
• type InterfaceCodecExtension
  • func NewInterfaceCodecExtension() *InterfaceCodecExtension
  • func (e *InterfaceCodecExtension) DecorateDecoder(typ reflect2.Type, decoder jsoniter.ValDecoder) jsoniter.ValDecoder
• type OAuthData
  • func ExchangeAuthKey(ctx context.Context, p *ExchangeAuthKeyParams) (*OAuthData, error)
  • func ExchangeOAuthToken(ctx context.Context, p *ExchangeOAuthTokenParams) (*OAuthData, error)
• type SecretKind
• type SecretVersion
  • func SetAppSecret(ctx context.Context, appSlug string, kind SecretKind, secretKey, value string) (*SecretVersion, error)
• type UpdateSecretGroupParams

Functions

func CreateOAuthSession

func CreateOAuthSession(ctx context.Context, p *CreateOAuthSessionParams) (authURL string, err error)

func CreateSecretGroup

func CreateSecretGroup(ctx context.Context, p CreateSecretGroupParams) error

func CreateSecretVersion

func CreateSecretVersion(ctx context.Context, p CreateSecretVersionParams) error

func DBConnect

func DBConnect(ctx context.Context, appSlug, envSlug, dbName string, startupData []byte) (*websocket.Conn, error)

func EnvLogs

func EnvLogs(ctx context.Context, appSlug, envSlug string) (*websocket.Conn, error)

func GetEnvMeta

func GetEnvMeta(ctx context.Context, appSlug, envName string) (*metav1.Data, error)

func GetLocalSecretValues

func GetLocalSecretValues(ctx context.Context, appSlug string, poll bool) (secrets map[string]string, err error)

func ListSecretGroups

func ListSecretGroups(ctx context.Context, appSlug string, keys []string) ([]*gql.Secret, error)

func UpdateSecretGroup

func UpdateSecretGroup(ctx context.Context, p UpdateSecretGroupParams) error

Types

type App

type App struct {
	ID          string  `json:"eid"`
	LegacyID    string  `json:"id"`
	Slug        string  `json:"slug"`
	Name        string  `json:"name"`
	Description string  `json:"description"` // can be blank
	MainBranch  *string `json:"main_branch"` // nil if not set
}

func CreateApp

func CreateApp(ctx context.Context, p *CreateAppParams) (*App, error)

func GetApp

func GetApp(ctx context.Context, appSlug string) (*App, error)

func ListApps

func ListApps(ctx context.Context) ([]*App, error)

type CreateAppParams

type CreateAppParams struct {
	Name           string `json:"name"`
	InitialSecrets map[string]string
}

type CreateOAuthSessionParams

type CreateOAuthSessionParams struct {
	Challenge   string `json:"challenge"`
	State       string `json:"state"`
	RedirectURL string `json:"redirect_url"`
}

type CreateSecretGroupParams

type CreateSecretGroupParams struct {
	AppID          string
	Key            string
	PlaintextValue string
	Description    string
	Selector       []gql.SecretSelector
}

type CreateSecretVersionParams

type CreateSecretVersionParams struct {
	GroupID        string
	PlaintextValue string
	Etag           string
}

type Env

type Env struct {
	ID    string `json:"id"`
	Slug  string `json:"slug"`
	Type  string `json:"type"`
	Cloud string `json:"cloud"`
}

func ListEnvs

func ListEnvs(ctx context.Context, appSlug string) ([]*Env, error)

type Error

type Error struct {
	HTTPStatus string `json:"-"`
	HTTPCode   int    `json:"-"`
	Code       string
	Detail     json.RawMessage
}

func (Error) Error

func (e Error) Error() string

type ExchangeAuthKeyParams

type ExchangeAuthKeyParams struct {
	AuthKey string `json:"auth_key"`
}

type ExchangeOAuthTokenParams

type ExchangeOAuthTokenParams struct {
	Challenge string `json:"challenge"`
	Code      string `json:"code"`
}

type InterfaceCodecExtension

type InterfaceCodecExtension struct {
	jsoniter.DummyExtension
}

InterfaceCodecExtension is used to decode interface fields it'll store the type of the values in a wrapper object

func NewInterfaceCodecExtension

func NewInterfaceCodecExtension() *InterfaceCodecExtension

func (*InterfaceCodecExtension) DecorateDecoder

func (e *InterfaceCodecExtension) DecorateDecoder(typ reflect2.Type, decoder jsoniter.ValDecoder) jsoniter.ValDecoder

type OAuthData

type OAuthData struct {
	Token   *oauth2.Token `json:"token"`
	Actor   string        `json:"actor,omitempty"` // The ID of the user or app that authorized the token.
	Email   string        `json:"email"`           // empty if logging in as an app
	AppSlug string        `json:"app_slug"`        // empty if logging in as a user
}

func ExchangeAuthKey

func ExchangeAuthKey(ctx context.Context, p *ExchangeAuthKeyParams) (*OAuthData, error)

func ExchangeOAuthToken

func ExchangeOAuthToken(ctx context.Context, p *ExchangeOAuthTokenParams) (*OAuthData, error)

type SecretKind

type SecretKind string

const (
	DevelopmentSecrets SecretKind = "development"
	ProductionSecrets  SecretKind = "production"
)

type SecretVersion

type SecretVersion struct {
	Number  int       `json:"number"`
	Created time.Time `json:"created"`
}

func SetAppSecret

func SetAppSecret(ctx context.Context, appSlug string, kind SecretKind, secretKey, value string) (*SecretVersion, error)

type UpdateSecretGroupParams

type UpdateSecretGroupParams struct {
	ID   string
	Etag *string

	// Nil fore ach field here means it's kept unchanged.
	Selector    []gql.SecretSelector // nil means no changes
	Archived    *bool
	Description *string
}