userapi

type BadRequest = externalRef0.Problem

type Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {

	// UpsertUserWithBody Create-or-update a user at login time (auth service credential only)
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with POST /internal/users/upsert (the `UpsertUser` operationId).
	UpsertUserWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpsertUser Create-or-update a user at login time (auth service credential only)
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with POST /internal/users/upsert (the `UpsertUser` operationId).
	UpsertUser(ctx context.Context, body UpsertUserJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetSharedProfilesByIds Batch profile cards for hydration (returned regardless of visibility - actions are signed; page access stays gated)
	//
	// Corresponds with GET /shared/profiles/by-ids (the `GetSharedProfilesByIds` operationId).
	GetSharedProfilesByIds(ctx context.Context, params *GetSharedProfilesByIdsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SearchSharedProfiles Substring search over listed profiles' folded handles
	//
	// Corresponds with GET /shared/profiles/search (the `SearchSharedProfiles` operationId).
	SearchSharedProfiles(ctx context.Context, params *SearchSharedProfilesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetSharedProfile Resolve a handle to its profile card (any authenticated caller; non-private only)
	//
	// Corresponds with GET /shared/profiles/{handle} (the `GetSharedProfile` operationId).
	GetSharedProfile(ctx context.Context, handle string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteUser Delete a user account (self only); idempotent
	//
	// Corresponds with DELETE /users/{userId} (the `DeleteUser` operationId).
	DeleteUser(ctx context.Context, userId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetUser Fetch a user (self, a service credential, or admin)
	//
	// Corresponds with GET /users/{userId} (the `GetUser` operationId).
	GetUser(ctx context.Context, userId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateUserWithBody Self-service profile update (handle, avatar URL, currency, visibility)
	//
	// Takes any type of body and a specified content type.
	//
	// Corresponds with PATCH /users/{userId} (the `UpdateUser` operationId).
	UpdateUserWithBody(ctx context.Context, userId openapi_types.UUID, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateUser Self-service profile update (handle, avatar URL, currency, visibility)
	//
	// Takes a body of the `application/json` content type.
	//
	// Corresponds with PATCH /users/{userId} (the `UpdateUser` operationId).
	UpdateUser(ctx context.Context, userId openapi_types.UUID, body UpdateUserJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {

	// UpsertUserWithBodyWithResponse Create-or-update a user at login time (auth service credential only)
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with POST /internal/users/upsert (the `UpsertUser` operationId).
	UpsertUserWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpsertUserResponse, error)

	// UpsertUserWithResponse Create-or-update a user at login time (auth service credential only)
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with POST /internal/users/upsert (the `UpsertUser` operationId).
	UpsertUserWithResponse(ctx context.Context, body UpsertUserJSONRequestBody, reqEditors ...RequestEditorFn) (*UpsertUserResponse, error)

	// GetSharedProfilesByIdsWithResponse Batch profile cards for hydration (returned regardless of visibility - actions are signed; page access stays gated)
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /shared/profiles/by-ids (the `GetSharedProfilesByIds` operationId).
	GetSharedProfilesByIdsWithResponse(ctx context.Context, params *GetSharedProfilesByIdsParams, reqEditors ...RequestEditorFn) (*GetSharedProfilesByIdsResponse, error)

	// SearchSharedProfilesWithResponse Substring search over listed profiles' folded handles
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /shared/profiles/search (the `SearchSharedProfiles` operationId).
	SearchSharedProfilesWithResponse(ctx context.Context, params *SearchSharedProfilesParams, reqEditors ...RequestEditorFn) (*SearchSharedProfilesResponse, error)

	// GetSharedProfileWithResponse Resolve a handle to its profile card (any authenticated caller; non-private only)
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /shared/profiles/{handle} (the `GetSharedProfile` operationId).
	GetSharedProfileWithResponse(ctx context.Context, handle string, reqEditors ...RequestEditorFn) (*GetSharedProfileResponse, error)

	// DeleteUserWithResponse Delete a user account (self only); idempotent
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with DELETE /users/{userId} (the `DeleteUser` operationId).
	DeleteUserWithResponse(ctx context.Context, userId openapi_types.UUID, reqEditors ...RequestEditorFn) (*DeleteUserResponse, error)

	// GetUserWithResponse Fetch a user (self, a service credential, or admin)
	//
	// Returns a wrapper object for the known response body format(s).
	//
	// Corresponds with GET /users/{userId} (the `GetUser` operationId).
	GetUserWithResponse(ctx context.Context, userId openapi_types.UUID, reqEditors ...RequestEditorFn) (*GetUserResponse, error)

	// UpdateUserWithBodyWithResponse Self-service profile update (handle, avatar URL, currency, visibility)
	//
	// Takes any type of body and a specified content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PATCH /users/{userId} (the `UpdateUser` operationId).
	UpdateUserWithBodyWithResponse(ctx context.Context, userId openapi_types.UUID, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateUserResponse, error)

	// UpdateUserWithResponse Self-service profile update (handle, avatar URL, currency, visibility)
	//
	// Takes a body of the `application/json` content type, and returns a wrapper object for the known response body format(s).
	//
	// Corresponds with PATCH /users/{userId} (the `UpdateUser` operationId).
	UpdateUserWithResponse(ctx context.Context, userId openapi_types.UUID, body UpdateUserJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateUserResponse, error)
}

type Conflict = externalRef0.Problem

type DeleteUserResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSON403 the response for an HTTP 403 `application/problem+json` response
	ApplicationproblemJSON403 *Forbidden
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type Forbidden = externalRef0.Problem

type GetSharedProfileResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *ProfileCard
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSON404 the response for an HTTP 404 `application/problem+json` response
	ApplicationproblemJSON404 *NotFound
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type GetSharedProfilesByIdsParams struct {
	Ids []openapi_types.UUID `form:"ids" json:"ids"`
}

type GetSharedProfilesByIdsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *struct {
		Profiles []ProfileCard `json:"profiles"`
	}
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type GetUserResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *User
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSON403 the response for an HTTP 403 `application/problem+json` response
	ApplicationproblemJSON403 *Forbidden
	// ApplicationproblemJSON404 the response for an HTTP 404 `application/problem+json` response
	ApplicationproblemJSON404 *NotFound
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type InternalError = externalRef0.Problem

type NotFound = externalRef0.Problem

type ProfileCard = externalRef0.ProfileCard

type RequestEditorFn func(ctx context.Context, req *http.Request) error

type SearchSharedProfilesParams struct {
	Q externalRef0.UserSearchQ `form:"q" json:"q"`
}

type SearchSharedProfilesResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *struct {
		Profiles []ProfileCard `json:"profiles"`
	}
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type TooManyRequests = externalRef0.Problem

type Unauthorized = externalRef0.Problem

type UpdateUserJSONRequestBody = UpdateUserRequest

type UpdateUserRequest struct {
	AvatarUrl *string `json:"avatar_url,omitempty"`

	// Handle New typed form. Any change to the typed string, including a decoration-only edit (case or underscores only, same folded key), still consumes the cooldown: one change per cooldown window (429 handle_cooldown); folded-key collisions answer 409 handle_taken.
	Handle            *externalRef0.Handle       `json:"handle,omitempty"`
	LandingPage       *externalRef0.LandingPage  `json:"landing_page,omitempty"`
	PreferredCurrency *externalRef0.CurrencyCode `json:"preferred_currency,omitempty"`
	ProfileVisibility *externalRef0.Visibility   `json:"profile_visibility,omitempty"`
}

type UpdateUserResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *User
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSON403 the response for an HTTP 403 `application/problem+json` response
	ApplicationproblemJSON403 *Forbidden
	// ApplicationproblemJSON404 the response for an HTTP 404 `application/problem+json` response
	ApplicationproblemJSON404 *NotFound
	// ApplicationproblemJSON409 the response for an HTTP 409 `application/problem+json` response
	ApplicationproblemJSON409 *Conflict
	// ApplicationproblemJSON429 the response for an HTTP 429 `application/problem+json` response
	ApplicationproblemJSON429 *TooManyRequests
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type UpsertUserJSONRequestBody = UpsertUserRequest

type UpsertUserRequest struct {
	AvatarUrl *string `json:"avatar_url,omitempty"`

	// DisplayName The provider's display name. Used ONLY as the handle derivation seed when this upsert creates the account; it is not stored and never overwrites an existing handle.
	DisplayName string `json:"display_name"`
	Email       string `json:"email"`

	// LocaleHint BCP 47 language tag from the login request's Accept-Language header. Applied only when this upsert creates the account: it seeds preferred_currency and never touches an existing user.
	LocaleHint *string `json:"locale_hint,omitempty"`
}

type UpsertUserResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	// JSON200 the response for an HTTP 200 `application/json` response
	JSON200 *User
	// ApplicationproblemJSON400 the response for an HTTP 400 `application/problem+json` response
	ApplicationproblemJSON400 *BadRequest
	// ApplicationproblemJSON401 the response for an HTTP 401 `application/problem+json` response
	ApplicationproblemJSON401 *Unauthorized
	// ApplicationproblemJSON403 the response for an HTTP 403 `application/problem+json` response
	ApplicationproblemJSON403 *Forbidden
	// ApplicationproblemJSONDefault the response for an HTTP default `application/problem+json` response
	ApplicationproblemJSONDefault *InternalError
}

type User struct {
	AvatarUrl *string   `json:"avatar_url,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	Email     string    `json:"email"`

	// Handle The user's single identity. 2-30 chars, alphanumeric plus interior underscores; case and underscores are decoration (uniqueness folds them).
	Handle externalRef0.Handle `json:"handle"`
	Id     openapi_types.UUID  `json:"id"`

	// LandingPage Where the app opens after sign-in. Private preference, defaulted to feed for every account; never on ProfileCard.
	LandingPage externalRef0.LandingPage `json:"landing_page"`

	// PreferredCurrency The display currency the SPA converts market values into. Defaulted from locale_hint at account creation, USD when no hint maps.
	PreferredCurrency externalRef0.CurrencyCode `json:"preferred_currency"`
	ProfileVisibility externalRef0.Visibility   `json:"profile_visibility"`
	Roles             []externalRef0.Role       `json:"roles"`
	UpdatedAt         time.Time                 `json:"updated_at"`
}