transport

transport

Internal package transport provides HTTP client utilities and transport layers.

transport

import "github.com/agentstation/starmap/internal/transport"

Index

• Variables
• func DecodeResponse(resp *http.Response, target any) error
• type Authenticator
• type BearerAuth
  • func (a *BearerAuth) Apply(req *http.Request, apiKey string)
• type Client
  • func New(provider *catalogs.Provider) *Client
  • func (c *Client) Do(req *http.Request, provider *catalogs.Provider) (*http.Response, error)
  • func (c *Client) DoWithContext(ctx context.Context, req *http.Request, provider *catalogs.Provider) (*http.Response, error)
  • func (c *Client) Get(ctx context.Context, url string, provider *catalogs.Provider) (*http.Response, error)
• type HeaderAuth
  • func (a *HeaderAuth) Apply(req *http.Request, apiKey string)
• type NoAuth
  • func (a *NoAuth) Apply(_ *http.Request, _ string)
• type ProviderAuth
  • func (a *ProviderAuth) Apply(req *http.Request, apiKey string)
• type QueryAuth
  • func (a *QueryAuth) Apply(req *http.Request, apiKey string)
• type RequestBuilder
  • func NewRequestBuilder(provider *catalogs.Provider) *RequestBuilder
  • func (rb *RequestBuilder) AddProviderHeaders(req *http.Request)
  • func (rb *RequestBuilder) GetBaseURL() string
  • func (rb *RequestBuilder) GetModelsURL(defaultURL string) string

Variables

DefaultHTTPTimeout is the default timeout for HTTP requests.

var DefaultHTTPTimeout = constants.DefaultHTTPTimeout

func DecodeResponse

func DecodeResponse(resp *http.Response, target any) error

DecodeResponse decodes a JSON response into the target structure.

type Authenticator

Authenticator applies authentication to HTTP requests.

type Authenticator interface {
    Apply(req *http.Request, apiKey string)
}

type BearerAuth

BearerAuth implements Bearer token authentication.

type BearerAuth struct{}

func (*BearerAuth) Apply

func (a *BearerAuth) Apply(req *http.Request, apiKey string)

Apply implements the Authenticator interface for BearerAuth.

type Client

Client provides HTTP client functionality with authentication.

type Client struct {
    // contains filtered or unexported fields
}

func New

func New(provider *catalogs.Provider) *Client

New creates a new transport client with the specified authenticator.

func (*Client) Do

func (c *Client) Do(req *http.Request, provider *catalogs.Provider) (*http.Response, error)

Do performs an HTTP request with authentication applied.

func (*Client) DoWithContext

func (c *Client) DoWithContext(ctx context.Context, req *http.Request, provider *catalogs.Provider) (*http.Response, error)

DoWithContext performs an HTTP request with authentication applied and context support. The provided context will be used for the request, overriding any existing context in req.

func (*Client) Get

func (c *Client) Get(ctx context.Context, url string, provider *catalogs.Provider) (*http.Response, error)

Get performs a GET request.

type HeaderAuth

HeaderAuth implements custom header authentication.

type HeaderAuth struct {
    Header string
}

func (*HeaderAuth) Apply

func (a *HeaderAuth) Apply(req *http.Request, apiKey string)

Apply implements the Authenticator interface for HeaderAuth.

type NoAuth

NoAuth implements no authentication.

type NoAuth struct{}

func (*NoAuth) Apply

func (a *NoAuth) Apply(_ *http.Request, _ string)

Apply implements the Authenticator interface for NoAuth.

type ProviderAuth

ProviderAuth implements provider-specific authentication using catalog configuration.

type ProviderAuth struct {
    Provider *catalogs.Provider
}

func (*ProviderAuth) Apply

func (a *ProviderAuth) Apply(req *http.Request, apiKey string)

Apply implements the Authenticator interface for ProviderAuth.

type QueryAuth

QueryAuth implements API key as query parameter authentication.

type QueryAuth struct {
    Param string
}

func (*QueryAuth) Apply

func (a *QueryAuth) Apply(req *http.Request, apiKey string)

Apply implements the Authenticator interface for QueryAuth.

type RequestBuilder

RequestBuilder helps build HTTP requests with provider-specific configurations.

type RequestBuilder struct {
    // contains filtered or unexported fields
}

func NewRequestBuilder

func NewRequestBuilder(provider *catalogs.Provider) *RequestBuilder

NewRequestBuilder creates a new request builder for a provider.

func (*RequestBuilder) AddProviderHeaders

func (rb *RequestBuilder) AddProviderHeaders(req *http.Request)

AddProviderHeaders adds provider-specific headers to a request.

func (*RequestBuilder) GetBaseURL

func (rb *RequestBuilder) GetBaseURL() string

GetBaseURL returns the base URL for API requests.

func (*RequestBuilder) GetModelsURL

func (rb *RequestBuilder) GetModelsURL(defaultURL string) string

GetModelsURL returns the URL for listing models.

Generated by gomarkdoc