appsdk

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

type Caller struct {
	Type CallerType `json:"type"`
	ID   string     `json:"id,omitempty"`
}

type CallerType string

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

type Chat struct {
	Type string `json:"type"`
	ID   string `json:"id"`
}

type Context struct {
	Caller          Caller            `json:"caller"`
	Channel         Channel           `json:"channel"`
	User            *User             `json:"user,omitempty"`
	UserChat        *UserChat         `json:"userChat,omitempty"`
	AuthToken       string            `json:"authToken,omitempty"`
	LegacyAuthToken string            `json:"legacyAuthToken,omitempty"`
	APICredentials  map[string]string `json:"apiCredentials,omitempty"`
	Config          map[string]any    `json:"config,omitempty"`
	Language        string            `json:"language,omitempty"`
	Sandbox         bool              `json:"sandbox,omitempty"`
	SessionID       string            `json:"sessionId,omitempty"`
	SeedState       any               `json:"seedState,omitempty"`
}

type ErrorMapper func(error) error

type Extensible[T any] struct {
	Base   *T
	Fields ExtraFields
}

type Extension interface {
	Register(app *App) error
}

type ExtensionRegistration struct {
	Name          string `json:"name"`
	SystemVersion string `json:"systemVersion"`
}

type ExtraFields map[string]any

type FunctionError struct {
	Code    int
	Type    string
	Message string
	Data    any
}

type FunctionErrorResponse struct {
	Code    int             `json:"code"`
	Message string          `json:"message"`
	Data    json.RawMessage `json:"data,omitempty"`
	// Type is an optional logical error category such as "invalidParams",
	// "methodNotFound", or "internal". Keep code/message as the canonical contract.
	Type string `json:"type,omitempty"`
}

type FunctionOption func(*functionDefinition) error

type FunctionRequest struct {
	Method        string          `json:"method"`
	Params        json.RawMessage `json:"params,omitempty"`
	Context       Context         `json:"context"`
	SystemVersion string          `json:"systemVersion,omitempty"`
}

type FunctionResponse struct {
	Result json.RawMessage        `json:"result,omitempty"`
	Error  *FunctionErrorResponse `json:"error,omitempty"`
}

type FunctionSchema struct {
	Name         string         `json:"name"`
	Description  string         `json:"description,omitempty"`
	InputSchema  map[string]any `json:"inputSchema"`
	OutputSchema map[string]any `json:"outputSchema,omitempty"`
}

type GetFunctionsResponse struct {
	Result GetFunctionsResult `json:"result"`
}

type GetFunctionsResult struct {
	Functions    []FunctionSchema `json:"functions"`
	Success      bool             `json:"success"`
	ErrorMessage string           `json:"errorMessage"`
}

type HandlerFunc func(ctx context.Context, fnCtx Context, params json.RawMessage) (json.RawMessage, error)

type InputHandlerFunc[TIn any] func(ctx context.Context, fnCtx Context, input *TIn) (any, error)

type Options struct {
	AppID       string
	AppSecret   string
	Debug       bool
	ErrorMapper ErrorMapper
}

type ResultMarshaler interface {
	MarshalSDKResult() (json.RawMessage, error)
}

type TypedHandlerFunc[TIn any, TOut any] func(ctx context.Context, fnCtx Context, input *TIn) (*TOut, error)

type User struct {
	ID        string          `json:"id,omitempty"`
	ChannelID string          `json:"channelId,omitempty"`
	Type      string          `json:"type,omitempty"`
	Member    bool            `json:"member,omitempty"`
	MemberID  string          `json:"memberId,omitempty"`
	Profile   json.RawMessage `json:"profile,omitempty"`
}

type UserChat struct {
	ID      string          `json:"id,omitempty"`
	Profile json.RawMessage `json:"profile,omitempty"`
	State   string          `json:"state,omitempty"`
}

type Validator interface {
	Validate() error
}