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"`
	Webhooks        map[string]WebhookEndpointContext `json:"webhooks,omitempty"`
	OAuthFlow       *OAuthFlowContext                 `json:"oauthFlow,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"`
	Deprecated   *bool          `json:"deprecated,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 NeedsUserInputResult struct {
	Type              string              `json:"type"`
	RequestID         string              `json:"requestId"`
	Questions         []UserInputQuestion `json:"questions"`
	ContinuationToken string              `json:"continuationToken"`
	Message           string              `json:"message,omitempty"`
}

type OAuthFlowContext struct {
	AppID           string  `json:"appId"`
	ChannelID       string  `json:"channelId"`
	ManagerID       string  `json:"managerId"`
	AuthScope       string  `json:"authScope"`
	Key             *string `json:"key,omitempty"`
	TargetManagerID *string `json:"targetManagerId,omitempty"`
}

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 UserInputOption struct {
	Value     string `json:"value"`
	Label     string `json:"label"`
	Exclusive bool   `json:"exclusive,omitempty"`
}

type UserInputQuestion struct {
	Key           string            `json:"key"`
	Label         string            `json:"label"`
	Prompt        string            `json:"prompt"`
	InputType     UserInputType     `json:"inputType"`
	Required      bool              `json:"required"`
	Options       []UserInputOption `json:"options,omitempty"`
	MinSelections *int              `json:"minSelections,omitempty"`
	MaxSelections *int              `json:"maxSelections,omitempty"`
	Placeholder   string            `json:"placeholder,omitempty"`
	MinLength     *int              `json:"minLength,omitempty"`
	MaxLength     *int              `json:"maxLength,omitempty"`
	Min           any               `json:"min,omitempty"`
	Max           any               `json:"max,omitempty"`
	Step          *float64          `json:"step,omitempty"`
}

type UserInputType string

type Validator interface {
	Validate() error
}

type WebhookEndpointContext struct {
	URL string `json:"url"`
}