rpc

type DatagraphRef struct {
	// Resource ID
	ID xid.ID `json:"id"`
	// Resource kind (e.g., 'post', 'node', 'account')
	Kind string `json:"kind"`
}

type Event string

type EventAccountCreated struct {
	Event string `json:"event"`
	// Account ID
	ID account.AccountID `json:"id"`
}

type EventAccountSuspended struct {
	Event string `json:"event"`
	// Account ID
	ID account.AccountID `json:"id"`
}

type EventAccountUnsuspended struct {
	Event string `json:"event"`
	// Account ID
	ID account.AccountID `json:"id"`
}

type EventAccountUpdated struct {
	Event string `json:"event"`
	// Account ID
	ID account.AccountID `json:"id"`
}

type EventActivityCreated struct {
	Event string `json:"event"`
	// Activity/Event ID
	ID event_ref.EventID `json:"id"`
}

type EventActivityDeleted struct {
	Event string `json:"event"`
	// Activity/Event ID
	ID event_ref.EventID `json:"id"`
}

type EventActivityPublished struct {
	Event string `json:"event"`
	// Activity/Event ID
	ID event_ref.EventID `json:"id"`
}

type EventActivityUpdated struct {
	Event string `json:"event"`
	// Activity/Event ID
	ID event_ref.EventID `json:"id"`
}

type EventCategoryDeleted struct {
	Event string `json:"event"`
	// Category ID
	ID xid.ID `json:"id"`
	// Category slug
	Slug string `json:"slug"`
}

type EventCategoryUpdated struct {
	Event string `json:"event"`
	// Category ID
	ID xid.ID `json:"id"`
	// Category slug
	Slug string `json:"slug"`
}

type EventMemberMentioned struct {
	// Account ID of the member who mentioned
	By    account.AccountID `json:"by"`
	Event string            `json:"event"`
	// Reference to the mentioned item.
	Item DatagraphRef `json:"item"`
	// Reference to the content item where the mention was found.
	Source DatagraphRef `json:"source"`
}

type EventNodeCreated struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventNodeDeleted struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventNodePublished struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventNodeSubmittedForReview struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventNodeUnpublished struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventNodeUpdated struct {
	Event string `json:"event"`
	// Library node ID
	ID library.NodeID `json:"id"`
	// Node slug
	Slug string `json:"slug"`
}

type EventPayload struct {
	EventPayloadUnion
}

type EventPayloadUnion interface {
	EventPayloadType() string
	// contains filtered or unexported methods
}

type EventPostLiked struct {
	Event string `json:"event"`
	// Post ID that was liked
	PostID post.ID `json:"post_id"`
	// Root thread post ID
	RootPostID post.ID `json:"root_post_id"`
}

type EventPostReacted struct {
	Event string `json:"event"`
	// Post ID that was reacted to
	PostID post.ID `json:"post_id"`
	// Root thread post ID
	RootPostID post.ID `json:"root_post_id"`
}

type EventPostUnliked struct {
	Event string `json:"event"`
	// Post ID that was unliked
	PostID post.ID `json:"post_id"`
	// Root thread post ID
	RootPostID post.ID `json:"root_post_id"`
}

type EventPostUnreacted struct {
	Event string `json:"event"`
	// Post ID that was unreacted
	PostID post.ID `json:"post_id"`
	// Root thread post ID
	RootPostID post.ID `json:"root_post_id"`
}

type EventReportCreated struct {
	Event string `json:"event"`
	// Report ID
	ID report.ID `json:"id"`
	// Optional account ID of reporter, not set if it was an automated system report.
	ReportedBy opt.Optional[account.AccountID] `json:"reported_by,omitempty"`
	// Reference to the item that was reported.
	Target opt.Optional[DatagraphRef] `json:"target,omitempty"`
}

type EventReportUpdated struct {
	Event string `json:"event"`
	// Optional account ID of handler
	HandledBy opt.Optional[account.AccountID] `json:"handled_by,omitempty"`
	// Report ID
	ID report.ID `json:"id"`
	// Optional account ID of reporter
	ReportedBy opt.Optional[account.AccountID] `json:"reported_by,omitempty"`
	// Report status
	Status report.Status `json:"status"`
	// Reference to the item that the report is about.
	Target opt.Optional[DatagraphRef] `json:"target,omitempty"`
}

type EventSettingsUpdated struct {
	Event string `json:"event"`
	// Settings object
	Settings map[string]interface{} `json:"settings"`
}

type EventThreadDeleted struct {
	Event string `json:"event"`
	// Thread post ID
	ID post.ID `json:"id"`
}

type EventThreadPublished struct {
	Event string `json:"event"`
	// Thread post ID
	ID post.ID `json:"id"`
}

type EventThreadReplyCreated struct {
	Event string `json:"event"`
	// Reply author account ID
	ReplyAuthorID account.AccountID `json:"reply_author_id"`
	// Reply post ID
	ReplyID post.ID `json:"reply_id"`
	// Optional ID of the author being replied to
	ReplyToAuthorID opt.Optional[account.AccountID] `json:"reply_to_author_id,omitempty"`
	// Optional ID of the post being replied to
	ReplyToTargetID opt.Optional[post.ID] `json:"reply_to_target_id,omitempty"`
	// Thread author account ID
	ThreadAuthorID account.AccountID `json:"thread_author_id"`
	// Thread post ID
	ThreadID post.ID `json:"thread_id"`
}

type EventThreadReplyDeleted struct {
	Event string `json:"event"`
	// Reply post ID
	ReplyID post.ID `json:"reply_id"`
	// Thread post ID
	ThreadID post.ID `json:"thread_id"`
}

type EventThreadReplyPublished struct {
	Event string `json:"event"`
	// Reply post ID
	ReplyID post.ID `json:"reply_id"`
	// Thread post ID
	ThreadID post.ID `json:"thread_id"`
}

type EventThreadReplyUnpublished struct {
	Event string `json:"event"`
	// Reply post ID
	ReplyID post.ID `json:"reply_id"`
	// Thread post ID
	ThreadID post.ID `json:"thread_id"`
}

type EventThreadReplyUpdated struct {
	Event string `json:"event"`
	// Reply post ID
	ReplyID post.ID `json:"reply_id"`
	// Thread post ID
	ThreadID post.ID `json:"thread_id"`
}

type EventThreadUnpublished struct {
	Event string `json:"event"`
	// Thread post ID
	ID post.ID `json:"id"`
}

type EventThreadUpdated struct {
	Event string `json:"event"`
	// Thread post ID
	ID post.ID `json:"id"`
}

type HostToPluginRequest struct {
	HostToPluginRequestUnion
}

type HostToPluginRequestUnion interface {
	HostToPluginRequestType() string
	// contains filtered or unexported methods
}

type HostToPluginResponse struct {
	Error   opt.Optional[HostToPluginResponseError] `json:"error,omitempty"`
	ID      xid.ID                                  `json:"id"`
	Jsonrpc string                                  `json:"jsonrpc"`
	Result  HostToPluginResponseUnion               `json:"result"`
}

type HostToPluginResponseError struct {
	Code    opt.Optional[int]    `json:"code,omitempty"`
	Message opt.Optional[string] `json:"message,omitempty"`
}

type HostToPluginResponseUnion struct {
	HostToPluginResponseUnionUnion
}

type HostToPluginResponseUnionUnion interface {
	HostToPluginResponseUnionType() string
	// contains filtered or unexported methods
}

type JsonRpcRequest struct {
	ID      xid.ID `json:"id"`
	Jsonrpc string `json:"jsonrpc"`
}

type JsonRpcResponse struct {
	Error   opt.Optional[JsonRpcResponseError] `json:"error,omitempty"`
	ID      xid.ID                             `json:"id"`
	Jsonrpc string                             `json:"jsonrpc"`
}

type JsonRpcResponseError struct {
	Code    opt.Optional[int]    `json:"code,omitempty"`
	Message opt.Optional[string] `json:"message,omitempty"`
}

type Manifest struct {
	// Optional API access configuration for this plugin. When provided, the host can provision a bot account and access key for API calls via RPC.
	//
	Access opt.Optional[ManifestAccess] `json:"access,omitempty"`
	// Arguments passed to the "command" invocation.
	// This field is used only for Supervised plugins. External plugins can omit it or provide placeholder values.
	//
	Args []string `json:"args,omitempty"`
	// The author of the plugin. Must match the pattern `^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`.
	// (NOTE: May change in future.)
	//
	Author string `json:"author"`
	// The executable or script used to launch your plugin. If your plugin is a binary (Go, Rust, C, etc) then this should be a path to that binary, it's best to put it in the root of your plugin archive like `./myplugin.exe` or `./myplugin`. If your plugin is a script (Python, Node, etc) then this should be the interpreter's `$PATH` executable (e.g. `python` or `node`)  and you should include the script in the `args` field.
	// This field is used only for Supervised plugins. External plugins can provide a placeholder value and it will be ignored by the runtime.
	// Note that Storyden cannot guarantee that the runtime environment defined by the person hosting Storyden will have any language's interpreter on the `$PATH`. If you are running your own instance and building a custom plugin, you should `FROM` the Storyden base image for your deployment so that you know what runtimes are available.
	// If you are distributing a plugin for others to use, we highly recommend that you use a statically compiled language such as Go, Rust or Zig for your plugin so that it's guaranteed to be compatible with any runtime.
	//
	Command             string                                    `json:"command"`
	ConfigurationSchema opt.Optional[ManifestConfigurationSchema] `json:"configuration_schema,omitempty"`
	// The description of the plugin. Displayed in Plugin Registries as well as in UI of Storyden installations when installed.
	//
	Description string `json:"description"`
	// The list of events the plugin subscribes to and will receive from the host via RPC. Events allow your plugins to react to things that humans or robots do on Storyden.
	//
	EventsConsumed []Event `json:"events_consumed,omitempty"`
	// The unique identifier of the plugin. Must match the pattern `^[a-zA-Z0-9](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`.
	// (NOTE: May change in future.)
	//
	ID string `json:"id"`
	// The name of the plugin. This is not a unique identifier and is only used for display purposes within the Plugin Registry and Storyden installation.
	//
	Name string `json:"name"`
	// The version of the plugin. This is not used for any versioning or compatibility purposes by the runtime and is only used for display purposes currently.
	//
	Version string `json:"version"`
}

type ManifestAccess struct {
	// Optional profile bio for the provisioned account.
	Bio opt.Optional[string] `json:"bio,omitempty"`
	// The account handle to provision for this plugin's API identity.
	//
	Handle string `json:"handle"`
	// Optional profile links for the provisioned account.
	Links []ManifestAccessExternalLink `json:"links,omitempty"`
	// Optional profile metadata for the provisioned account.
	Metadata map[string]interface{} `json:"metadata,omitempty"`
	// The account display name to provision for this plugin's API identity.
	//
	Name string `json:"name"`
	// The list of permission names requested for API access. See https://storyden.org/docs/introduction/members/permissions for available values and descriptions.
	//
	Permissions []string `json:"permissions"`
}

type ManifestAccessExternalLink struct {
	Text string  `json:"text"`
	URL  url.URL `json:"url"`
}

type ManifestConfigurationSchema struct {
	Fields []PluginConfigurationFieldSchema `json:"fields,omitempty"`
}

type PluginConfigurationField struct {
	PluginConfigurationFieldUnion
}

type PluginConfigurationFieldBoolean struct {
	Default opt.Optional[bool] `json:"default,omitempty"`
	// A description of the configuration field.
	Description string `json:"description"`
	// A unique identifier for this configuration field, used for
	// referencing the field in the plugin configuration object.
	//
	ID string `json:"id"`
	// A human-readable label for the configuration field.
	Label string `json:"label"`
	Type  string `json:"type"`
}

type PluginConfigurationFieldNumber struct {
	Default opt.Optional[float64] `json:"default,omitempty"`
	// A description of the configuration field.
	Description string `json:"description"`
	// A unique identifier for this configuration field, used for
	// referencing the field in the plugin configuration object.
	//
	ID string `json:"id"`
	// A human-readable label for the configuration field.
	Label string `json:"label"`
	Type  string `json:"type"`
}

type PluginConfigurationFieldSchema = PluginConfigurationField

type PluginConfigurationFieldString struct {
	Default opt.Optional[string] `json:"default,omitempty"`
	// A description of the configuration field.
	Description string `json:"description"`
	// A unique identifier for this configuration field, used for
	// referencing the field in the plugin configuration object.
	//
	ID string `json:"id"`
	// A human-readable label for the configuration field.
	Label string `json:"label"`
	Type  string `json:"type"`
}

type PluginConfigurationFieldUnion interface {
	PluginConfigurationFieldType() string
	// contains filtered or unexported methods
}

type PluginToHostRequest struct {
	PluginToHostRequestUnion
}

type PluginToHostRequestUnion interface {
	PluginToHostRequestType() string
	// contains filtered or unexported methods
}

type PluginToHostResponse struct {
	Error   opt.Optional[PluginToHostResponseError] `json:"error,omitempty"`
	ID      xid.ID                                  `json:"id"`
	Jsonrpc string                                  `json:"jsonrpc"`
	Result  PluginToHostResponseUnion               `json:"result"`
}

type PluginToHostResponseError struct {
	Code    opt.Optional[int]    `json:"code,omitempty"`
	Message opt.Optional[string] `json:"message,omitempty"`
}

type PluginToHostResponseUnion struct {
	PluginToHostResponseUnionUnion
}

type PluginToHostResponseUnionUnion interface {
	PluginToHostResponseUnionType() string
	// contains filtered or unexported methods
}

type RPCRequestAccessGet struct {
	ID      xid.ID `json:"id"`
	Jsonrpc string `json:"jsonrpc"`
	Method  string `json:"method"`
}

type RPCRequestConfigure struct {
	ID      xid.ID                 `json:"id"`
	Jsonrpc string                 `json:"jsonrpc"`
	Method  string                 `json:"method"`
	Params  map[string]interface{} `json:"params"`
}

type RPCRequestEvent struct {
	ID      xid.ID       `json:"id"`
	Jsonrpc string       `json:"jsonrpc"`
	Method  string       `json:"method"`
	Params  EventPayload `json:"params"`
}

type RPCRequestGetConfig struct {
	ID      xid.ID                                  `json:"id"`
	Jsonrpc string                                  `json:"jsonrpc"`
	Method  string                                  `json:"method"`
	Params  opt.Optional[RPCRequestGetConfigParams] `json:"params,omitempty"`
}

type RPCRequestGetConfigParams struct {
	// Specific config keys to retrieve. If empty, returns all config.
	Keys []string `json:"keys,omitempty"`
}

type RPCRequestPing struct {
	ID      xid.ID                             `json:"id"`
	Jsonrpc string                             `json:"jsonrpc"`
	Method  string                             `json:"method"`
	Params  opt.Optional[RPCRequestPingParams] `json:"params,omitempty"`
}

type RPCRequestPingParams struct {
}

type RPCResponseAccessGet struct {
	Error   opt.Optional[RPCResponseAccessGetError] `json:"error,omitempty"`
	ID      xid.ID                                  `json:"id"`
	Jsonrpc string                                  `json:"jsonrpc"`
	Method  opt.Optional[string]                    `json:"method,omitempty"`
	Result  RPCResponseAccessGetResult              `json:"result"`
}

type RPCResponseAccessGetError struct {
	Code    opt.Optional[int]    `json:"code,omitempty"`
	Message opt.Optional[string] `json:"message,omitempty"`
}

type RPCResponseAccessGetResult struct {
	// Bearer access key for API authentication.
	AccessKey string `json:"access_key"`
	// Base URL for API requests.
	APIBaseURL url.URL `json:"api_base_url"`
}

type RPCResponseConfigure struct {
	Method opt.Optional[string] `json:"method,omitempty"`
	Ok     bool                 `json:"ok"`
}

type RPCResponseEvent struct {
	Method opt.Optional[string] `json:"method,omitempty"`
	Ok     bool                 `json:"ok"`
}

type RPCResponseGetConfig struct {
	// Configuration key-value pairs
	Config map[string]interface{} `json:"config"`
	Method string                 `json:"method"`
}

type RPCResponsePing struct {
	Method opt.Optional[string] `json:"method,omitempty"`
	Pong   bool                 `json:"pong"`
	// Optional status message
	Status opt.Optional[string] `json:"status,omitempty"`
	// How long the plugin has been running
	UptimeSeconds opt.Optional[float64] `json:"uptime_seconds,omitempty"`
}