Add login support for WebSocket API

.github/FUNDING.yml

@@ -1 +0,0 @@
-liberapay: Elara6331

.gitignore

@@ -1,3 +1 @@
-/test
+/test
-/gen
-/lemmy/

README.md

@@ -1,43 +1,31 @@
 # Go-Lemmy
 
-[![Go Reference](https://pkg.go.dev/badge/go.arsenm.dev/go-lemmy.svg)](https://pkg.go.dev/go.elara.ws/go-lemmy)
+[![Go Reference](https://pkg.go.dev/badge/go.arsenm.dev/go-lemmy.svg)](https://pkg.go.dev/go.arsenm.dev/go-lemmy)
 
-Go bindings to the [Lemmy](https://join-lemmy.org) API, automatically generated from Lemmy's source code using the generator in [cmd/gen](cmd/gen).
+Go bindings to the [Lemmy](https://join-lemmy.org) API
 
-### Examples
+Example:
 
-Examples can be found in the [examples](examples) directory.
+```go
+ctx := context.Background()
 
-### How to generate
+c, err := lemmy.New("https://lemmy.ml")
+if err != nil {
+    panic(err)
+}
 
-First, clone the [lemmy-js-client](https://github.com/LemmyNet/lemmy-js-client) repo at whatever version you need:
+err = c.Login(ctx, types.Login{
+    UsernameOrEmail: "email@example.com",
+    Password:        `TestPwd`,
+})
+if err != nil {
+    panic(err)
+}
 
-```bash
+_, err = c.SaveUserSettings(ctx, types.SaveUserSettings{
-git clone https://github.com/LemmyNet/lemmy-js-client -b 0.18.3
+    BotAccount: types.NewOptional(true),
-```
+})
-
+if err != nil {
-Inside it, build the JSON docs file:
+    panic(err)
-
+}
-```bash
+```
-npm run docs -- --json docs.json
-```
-
-Next, build the generator:
-
-```bash
-go build ./cmd/gen
-```
-
-Remove all the existing generated code:
-
-```bash
-rm **/*.gen.go
-```
-
-Execute the generator:
-
-```bash
-./gen -json-file <path_to_docs.json> -out-dir .
-```
-
-And that's it! Your generated code should be ready for use.

admin.go

@@ -0,0 +1,128 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) AddAdmin(ctx context.Context, d types.AddAdmin) (*types.AddAdminResponse, error) {
+	ar := &types.AddAdminResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/admin/add", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) ApproveRegistrationApplication(ctx context.Context, d types.ApproveRegistrationApplication) (*types.RegistrationApplicationResponse, error) {
+	ar := &types.RegistrationApplicationResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/admin/registration_application/approve", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) UnreadRegistrationApplicationCount(ctx context.Context, d types.GetUnreadRegistrationApplicationCount) (*types.GetUnreadRegistrationApplicationCountResponse, error) {
+	ar := &types.GetUnreadRegistrationApplicationCountResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/admin/registration_application/count", nil, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) RegistrationApplications(ctx context.Context, d types.ListRegistrationApplications) (*types.ListRegistrationApplicationsResponse, error) {
+	ar := &types.ListRegistrationApplicationsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/admin/registration_application/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PurgeComment(ctx context.Context, d types.PurgeComment) (*types.PurgeItemResponse, error) {
+	ar := &types.PurgeItemResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/admin/purge/comment", nil, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PurgeCommunity(ctx context.Context, d types.PurgeCommunity) (*types.PurgeItemResponse, error) {
+	ar := &types.PurgeItemResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/admin/purge/community", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PurgePerson(ctx context.Context, d types.PurgePerson) (*types.PurgeItemResponse, error) {
+	ar := &types.PurgeItemResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/admin/purge/person", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PurgePost(ctx context.Context, d types.PurgePost) (*types.PurgeItemResponse, error) {
+	ar := &types.PurgeItemResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/admin/purge/post", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

cmd/gen/extractor/extractor.go

@@ -1,233 +0,0 @@
-package extractor
-
-import (
-	"fmt"
-	"os"
-	"strings"
-
-	"github.com/tidwall/gjson"
-)
-
-type Route struct {
-	Name       string
-	Summary    string
-	Method     string
-	Path       string
-	ParamsName string
-	ReturnName string
-}
-
-type Struct struct {
-	Name       string
-	Fields     []Field
-	UnionNames []string
-}
-
-type Field struct {
-	Name       string
-	IsArray    bool
-	IsOptional bool
-	Type       string
-}
-
-type Extractor struct {
-	root gjson.Result
-}
-
-// New parses the file at path and returns an extractor with its contents.
-func New(path string) (*Extractor, error) {
-	data, err := os.ReadFile(path)
-	if err != nil {
-		return nil, err
-	}
-
-	return &Extractor{gjson.ParseBytes(data)}, nil
-}
-
-// Extract reads the JSON document and extracts all the routes and structs from it.
-func (e *Extractor) Extract() ([]Route, []Struct) {
-	structs := map[int64]Struct{}
-	var out []Route
-
-	// Get all the routes in the JSON document
-	routes := e.root.Get("children.#.children.#(kind==2048)#|@flatten")
-
-	for _, route := range routes.Array() {
-		name := route.Get("name").String()
-		signature := route.Get(`signatures.0`)
-
-		// Get the code part of the route's summary.
-		// This will contain the HTTP method and path.
-		httpInfo := signature.Get(`comment.summary.#(kind=="code").text`).String()
-		if !strings.HasPrefix(httpInfo, "`HTTP") {
-			continue
-		}
-		method, path := parseHTTPInfo(httpInfo)
-
-		summary := strings.TrimSpace(signature.Get(`comment.summary.#(kind=="text").text`).String())
-		if summary == "" {
-			continue
-		}
-
-		// Get the ID and name of the type this function accepts
-		paramsID := signature.Get("parameters.0.type.target").Int()
-		paramsName := signature.Get("parameters.0.type.name").String()
-
-		// Get the ID and name of the type this function returns
-		returnID := signature.Get("type.typeArguments.0.target").Int()
-		returnName := signature.Get("type.typeArguments.0.name").String()
-
-		anyType := false
-		if returnName == "any" {
-			anyType = true
-		}
-
-		// Get the referenced structs from the JSON document
-		e.getStructs([]int64{paramsID, returnID}, structs)
-
-		// If the parameters struct contains no fields or union names
-		if len(structs[paramsID].Fields) == 0 && len(structs[paramsID].UnionNames) == 0 {
-			// Delete the params struct from the structs map
-			// to make sure it doesn't get generated
-			delete(structs, paramsID)
-
-			// Set paramsName to an empty string to signify that this route
-			// has no input parameters.
-			paramsName = ""
-		}
-
-		// If the return struct contains no fields or union names
-		if len(structs[returnID].Fields) == 0 && len(structs[returnID].UnionNames) == 0 {
-			// Delete the return struct from the structs map
-			// to make sure it doesn't get generated
-			delete(structs, returnID)
-
-			// Set paramsName to an empty string to signify that this route
-			// has no return value.
-			returnName = ""
-		}
-
-		if anyType {
-			returnName = "map[string]any"
-		}
-
-		out = append(out, Route{
-			Name:       name,
-			Summary:    summary,
-			Method:     method,
-			Path:       path,
-			ParamsName: paramsName,
-			ReturnName: returnName,
-		})
-	}
-	return out, getStructSlice(structs)
-}
-
-func (e *Extractor) getStructs(ids []int64, structs map[int64]Struct) {
-	for _, id := range ids {
-		if _, ok := structs[id]; ok {
-			continue
-		}
-
-		// Get the struct with the given ID from the JSON document
-		jstruct := e.root.Get(fmt.Sprintf("children.#(id==%d)", id))
-		if !jstruct.Exists() {
-			continue
-		}
-
-		name := jstruct.Get("name").String()
-
-		if jstruct.Get("type.type").String() == "union" {
-			structs[id] = Struct{
-				Name:       name,
-				UnionNames: e.unionNames(jstruct),
-			}
-		} else {
-			fields, newIDs := e.fields(jstruct)
-
-			structs[id] = Struct{
-				Name:   name,
-				Fields: fields,
-			}
-
-			// Recursively get any structs referenced by this one
-			e.getStructs(newIDs, structs)
-		}
-
-	}
-}
-
-// unionNames gets all the names of union type members
-func (e *Extractor) unionNames(jstruct gjson.Result) []string {
-	jnames := jstruct.Get("type.types").Array()
-	out := make([]string, len(jnames))
-	for i, name := range jnames {
-		out[i] = name.Get("value").String()
-	}
-	return out
-}
-
-// fields gets all the fields in a given struct from the JSON document.
-// It returns the fields and the IDs of any types they referenced.
-func (e *Extractor) fields(jstruct gjson.Result) ([]Field, []int64) {
-	var fields []Field
-	var ids []int64
-	jfields := jstruct.Get("children").Array()
-	for _, jfield := range jfields {
-		var field Field
-
-		field.Name = jfield.Get("name").String()
-		field.IsOptional = jfield.Get("flags.isOptional").Bool()
-
-		if jfield.Get("type.type").String() == "array" {
-			field.IsArray = true
-			field.Type = jfield.Get("type.elementType.name").String()
-
-			switch jfield.Get("type.elementType.type").String() {
-			case "reference":
-				// If this field is referencing another type, add that type's id
-				// to the ids slice.
-				ids = append(ids, jfield.Get("type.elementType.target").Int())
-			case "union":
-				// Convert unions to strings
-				field.Type = "string"
-			}
-		} else {
-			field.Type = jfield.Get("type.name").String()
-
-			switch jfield.Get("type.type").String() {
-			case "reference":
-				// If this field is referencing another type, add that type's id
-				// to the ids slice.
-				ids = append(ids, jfield.Get("type.target").Int())
-			case "union":
-				// Convert unions to strings
-				field.Type = "string"
-			}
-		}
-
-		fields = append(fields, field)
-	}
-	return fields, ids
-}
-
-// parseHTTPInfo parses the string from a route's summary,
-// and returns the method and path it uses
-func parseHTTPInfo(httpInfo string) (method, path string) {
-	httpInfo = strings.Trim(httpInfo, "`")
-	method, path, _ = strings.Cut(httpInfo, " ")
-	method = strings.TrimPrefix(method, "HTTP.")
-	method = strings.ToUpper(method)
-	return method, path
-}
-
-// getStructSlice returns all the structs in a map
-func getStructSlice(m map[int64]Struct) []Struct {
-	out := make([]Struct, len(m))
-	i := 0
-	for _, s := range m {
-		out[i] = s
-		i++
-	}
-	return out
-}

cmd/gen/generator/routes.go

@@ -1,114 +0,0 @@
-package generator
-
-import (
-	"io"
-	"strings"
-
-	"github.com/dave/jennifer/jen"
-	"go.elara.ws/go-lemmy/cmd/gen/extractor"
-)
-
-type RoutesGenerator struct {
-	w       io.Writer
-	PkgName string
-}
-
-func NewRoutes(w io.Writer, pkgName string) *RoutesGenerator {
-	return &RoutesGenerator{w, pkgName}
-}
-
-func (r *RoutesGenerator) Generate(routes []extractor.Route) error {
-	f := jen.NewFile(r.PkgName)
-	f.HeaderComment("Code generated by go.elara.ws/go-lemmy/cmd/gen (routes generator). DO NOT EDIT.")
-
-	for _, r := range routes {
-		f.Comment(r.Summary)
-		f.Func().Params(
-			jen.Id("c").Id("*Client"),
-		).Id(transformName(r.Name)).ParamsFunc(func(g *jen.Group) {
-			g.Id("ctx").Qual("context", "Context")
-			if r.ParamsName != "" {
-				g.Id("data").Id(r.ParamsName)
-			}
-		}).ParamsFunc(func(g *jen.Group) {
-			if r.ReturnName == "map[string]any" {
-				g.Map(jen.String()).Any()
-			} else if r.ReturnName != "" {
-				g.Op("*").Id(r.ReturnName)
-			}
-
-			g.Error()
-		}).BlockFunc(func(g *jen.Group) {
-			data := jen.Id("data")
-			// If there are no parameters, set the data to nil
-			if r.ParamsName == "" {
-				data = jen.Nil()
-			}
-
-			returnName := r.ReturnName
-			if returnName == "" {
-				returnName = "emptyResponse"
-			}
-
-			if returnName == "map[string]any" {
-				g.Id("resData").Op(":=").Map(jen.String()).Any().Block()
-			} else {
-				g.Id("resData").Op(":=").Op("&").Id(returnName).Block()
-			}
-
-			funcName := "req"
-			if r.Method == "GET" {
-				funcName = "getReq"
-			}
-
-			g.List(jen.Id("res"), jen.Err()).Op(":=").Id("c").Dot(funcName).ParamsFunc(func(g *jen.Group) {
-				g.Id("ctx")
-				g.Lit(r.Method)
-				g.Lit(r.Path)
-				g.Add(data)
-				
-				if returnName == "map[string]any" {
-					g.Op("&").Id("resData")
-				} else {
-					g.Id("resData")
-				}
-			})
-			g.If(jen.Err().Op("!=").Nil()).BlockFunc(func(g *jen.Group) {
-				if returnName == "emptyResponse" {
-					g.Return(jen.Err())
-				} else {
-					g.Return(jen.Nil(), jen.Err())
-				}
-			})
-
-			if r.ReturnName == "map[string]any" {
-				g.Err().Op("=").Id("resError").Params(jen.Id("res"), jen.Id("NewOptionalNil[string]").Params())
-			} else {
-				g.Err().Op("=").Id("resError").Params(jen.Id("res"), jen.Id("resData").Dot("Error"))
-			}
-			
-			g.If(jen.Err().Op("!=").Nil()).BlockFunc(func(g *jen.Group) {
-				if returnName == "emptyResponse" {
-					g.Return(jen.Err())
-				} else {
-					g.Return(jen.Nil(), jen.Err())
-				}
-			})
-
-			if returnName == "emptyResponse" {
-				g.Return(jen.Nil())
-			} else {
-				g.Return(jen.Id("resData"), jen.Nil())
-			}
-		})
-	}
-
-	return f.Render(r.w)
-}
-
-func transformName(s string) string {
-	s = strings.ToUpper(s[:1]) + s[1:]
-	s = strings.TrimPrefix(s, "Get")
-	s = strings.TrimPrefix(s, "List")
-	return s
-}

cmd/gen/generator/struct.go

@@ -1,123 +0,0 @@
-package generator
-
-import (
-	"io"
-	"strings"
-	"unicode"
-
-	"github.com/dave/jennifer/jen"
-	"go.elara.ws/go-lemmy/cmd/gen/extractor"
-)
-
-type StructGenerator struct {
-	w       io.Writer
-	PkgName string
-}
-
-func NewStruct(w io.Writer, pkgName string) *StructGenerator {
-	return &StructGenerator{w, pkgName}
-}
-
-func (s *StructGenerator) Generate(items []extractor.Struct) error {
-	f := jen.NewFile(s.PkgName)
-	f.HeaderComment("Code generated by go.elara.ws/go-lemmy/cmd/gen (struct generator). DO NOT EDIT.")
-
-	for _, item := range items {
-		if len(item.UnionNames) > 0 {
-			f.Type().Id(item.Name).String()
-
-			f.Const().DefsFunc(func(g *jen.Group) {
-				for _, member := range item.UnionNames {
-					constName := strings.Replace(item.Name+string(member), " ", "", -1)
-					g.Id(constName).Id(item.Name).Op("=").Lit(string(member))
-				}
-			})
-		} else {
-			f.Type().Id(item.Name).StructFunc(func(g *jen.Group) {
-				for _, field := range item.Fields {
-					g.Id(transformFieldName(field.Name)).Add(getType(field)).Tag(map[string]string{
-						"json": field.Name,
-						"url":  field.Name + ",omitempty",
-					})
-				}
-
-				if strings.HasSuffix(item.Name, "Response") {
-					g.Id("Error").Id("Optional").Types(jen.String()).Tag(map[string]string{"json": "error"})
-				}
-			})
-		}
-	}
-
-	return f.Render(s.w)
-}
-
-func getType(f extractor.Field) jen.Code {
-	// Some time fields are strings in the JS client,
-	// use time.Time for those
-	switch f.Name {
-	case "published", "updated", "when_":
-		return jen.Qual("time", "Time")
-	}
-
-	// Rank types such as hot_rank and hot_rank_active may be floats.
-	if strings.Contains(f.Name, "rank") {
-		return jen.Float64()
-	}
-
-	t := transformType(f.Name, f.Type)
-	if f.IsArray {
-		t = "[]" + t
-	}
-	if f.IsOptional {
-		t = "Optional[" + t + "]"
-	}
-	return jen.Id(t)
-}
-
-func transformType(name, t string) string {
-	switch t {
-	case "number":
-		return "int64"
-	case "boolean":
-		return "bool"
-	default:
-		return t
-	}
-}
-
-func transformFieldName(s string) string {
-	s = snakeToCamel(s)
-	s = strings.NewReplacer(
-		"Id", "ID",
-		"Url", "URL",
-		"Nsfw", "NSFW",
-		"Jwt", "JWT",
-		"Crud", "CRUD",
-		"Pm", "PM",
-		"Totp", "TOTP",
-		"2fa", "2FA",
-		"Png", "PNG",
-		"Uuid", "UUID",
-		"Wav", "WAV",
-	).Replace(s)
-	return s
-}
-
-func snakeToCamel(s string) string {
-	sb := &strings.Builder{}
-	capitalizeNext := true
-	for _, char := range s {
-		if char == '_' {
-			capitalizeNext = true
-			continue
-		}
-
-		if capitalizeNext {
-			sb.WriteRune(unicode.ToUpper(char))
-			capitalizeNext = false
-		} else {
-			sb.WriteRune(char)
-		}
-	}
-	return sb.String()
-}

cmd/gen/main.go

@@ -1,51 +0,0 @@
-package main
-
-import (
-	"flag"
-	"os"
-	"path/filepath"
-
-	"go.elara.ws/go-lemmy/cmd/gen/extractor"
-	"go.elara.ws/go-lemmy/cmd/gen/generator"
-	"go.elara.ws/logger"
-	"go.elara.ws/logger/log"
-)
-
-func init() {
-	log.Logger = logger.NewPretty(os.Stderr)
-}
-
-func main() {
-	jsonFile := flag.String("json-file", "lemmy.json", "Path to the JSON file generated from lemmy's docs")
-	outDir := flag.String("out-dir", "out", "Directory to write output in")
-	flag.Parse()
-
-	e, err := extractor.New(*jsonFile)
-	if err != nil {
-		log.Fatal("Error creating extractor").Err(err).Send()
-	}
-
-	routes, structs := e.Extract()
-
-	otf, err := os.Create(filepath.Join(*outDir, "types.gen.go"))
-	if err != nil {
-		log.Fatal("Error creating types output file").Err(err).Send()
-	}
-	defer otf.Close()
-
-	err = generator.NewStruct(otf, "lemmy").Generate(structs)
-	if err != nil {
-		log.Fatal("Error generating output routes file").Err(err).Send()
-	}
-
-	orf, err := os.Create(filepath.Join(*outDir, "routes.gen.go"))
-	if err != nil {
-		log.Fatal("Error creating routes output file").Err(err).Send()
-	}
-	defer orf.Close()
-
-	err = generator.NewRoutes(orf, "lemmy").Generate(routes)
-	if err != nil {
-		log.Fatal("Error generating output routes file").Err(err).Send()
-	}
-}

comment.go

@@ -0,0 +1,158 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) Comments(ctx context.Context, d types.GetComments) (*types.GetCommentsResponse, error) {
+	ar := &types.GetCommentsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/comment/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CreateComment(ctx context.Context, d types.CreateComment) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CreateCommentReport(ctx context.Context, d types.CreateCommentReport) (*types.CommentReportResponse, error) {
+	ar := &types.CommentReportResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment/report", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) DeleteComment(ctx context.Context, d types.DeleteComment) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment/delete", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) RemoveComment(ctx context.Context, d types.RemoveComment) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment/remove", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) EditComment(ctx context.Context, d types.EditComment) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/comment", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) LikeComment(ctx context.Context, d types.CreateCommentLike) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment/like", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CommentReports(ctx context.Context, d types.ListCommentReports) (*types.ListCommentReportsResponse, error) {
+	ar := &types.ListCommentReportsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/comments/report/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) MarkCommentReplyAsRead(ctx context.Context, d types.MarkCommentReplyAsRead) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/comment/mark_as_read", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) SaveComment(ctx context.Context, d types.SaveComment) (*types.CommentResponse, error) {
+	ar := &types.CommentResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/comment/save", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

community.go

@@ -0,0 +1,173 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) AddModToCommunity(ctx context.Context, d types.AddModToCommunity) (*types.AddModToCommunityResponse, error) {
+	ar := &types.AddModToCommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/mod", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) BanFromCommunity(ctx context.Context, d types.BanFromCommunity) (*types.BanFromCommunityResponse, error) {
+	ar := &types.BanFromCommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/ban_user", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) BlockCommunity(ctx context.Context, d types.BlockCommunity) (*types.BlockCommunityResponse, error) {
+	ar := &types.BlockCommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/block", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CreateCommunity(ctx context.Context, d types.CreateCommunity) (*types.CommunityResponse, error) {
+	ar := &types.CommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) EditCommunity(ctx context.Context, d types.EditCommunity) (*types.CommunityResponse, error) {
+	ar := &types.CommunityResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/community", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) FollowCommunity(ctx context.Context, d types.FollowCommunity) (*types.CommunityResponse, error) {
+	ar := &types.CommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/follow", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) DeleteCommunity(ctx context.Context, d types.DeleteCommunity) (*types.CommunityResponse, error) {
+	ar := &types.CommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/delete", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) RemoveCommunity(ctx context.Context, d types.RemoveCommunity) (*types.CommunityResponse, error) {
+	ar := &types.CommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/remove", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Community(ctx context.Context, d types.GetCommunity) (*types.GetCommunityResponse, error) {
+	ar := &types.GetCommunityResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/community", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Communities(ctx context.Context, d types.ListCommunities) (*types.ListCommunitiesResponse, error) {
+	ar := &types.ListCommunitiesResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/community/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) TransferCommunity(ctx context.Context, d types.TransferCommunity) (*types.GetCommunityResponse, error) {
+	ar := &types.GetCommunityResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/community/transfer", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

examples/basic/main.go

@@ -1,31 +0,0 @@
-package main
-
-import (
-	"context"
-
-	"go.elara.ws/go-lemmy"
-)
-
-func main() {
-	ctx := context.Background()
-
-	c, err := lemmy.New("https://lemmy.ml")
-	if err != nil {
-		panic(err)
-	}
-
-	err = c.ClientLogin(ctx, lemmy.Login{
-		UsernameOrEmail: "user@example.com",
-		Password:        `TestPwd`,
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	_, err = c.SaveUserSettings(ctx, lemmy.SaveUserSettings{
-		BotAccount: lemmy.NewOptional(true),
-	})
-	if err != nil {
-		panic(err)
-	}
-}

examples/comments/main.go

@@ -1,48 +0,0 @@
-package main
-
-import (
-	"context"
-	"log"
-
-	"go.elara.ws/go-lemmy"
-)
-
-func main() {
-	ctx := context.Background()
-
-	c, err := lemmy.New("https://lemmy.ml")
-	if err != nil {
-		panic(err)
-	}
-
-	err = c.ClientLogin(ctx, lemmy.Login{
-		UsernameOrEmail: "user@example.com",
-		Password:        `TestPwd`,
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	cr, err := c.CreateComment(ctx, lemmy.CreateComment{
-		PostID:  2,
-		Content: "Hello from go-lemmy!",
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	cr2, err := c.CreateComment(ctx, lemmy.CreateComment{
-		PostID:   2,
-		ParentID: lemmy.NewOptional(cr.CommentView.Comment.ID),
-		Content:  "Reply from go-lemmy",
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	log.Printf(
-		"Created comment %d and replied to it with comment %d!\n",
-		cr.CommentView.Comment.ID,
-		cr2.CommentView.Comment.ID,
-	)
-}

examples/posts/main.go

@@ -1,43 +0,0 @@
-package main
-
-import (
-	"context"
-	"log"
-
-	"go.elara.ws/go-lemmy"
-)
-
-func main() {
-	ctx := context.Background()
-
-	c, err := lemmy.New("https://lemmy.ml")
-	if err != nil {
-		panic(err)
-	}
-
-	// Log in to lemmy.ml
-	err = c.ClientLogin(ctx, lemmy.Login{
-		UsernameOrEmail: "user@example.com",
-		Password:        `TestPwd`,
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	// Get the linux community to get its ID.
-	gcr, err := c.Community(ctx, lemmy.GetCommunity{
-		Name: lemmy.NewOptional("linux"),
-	})
-	if err != nil {
-		panic(err)
-	}
-
-	// Create a Hello World post in the linux community.
-	pr, err := c.CreatePost(ctx, lemmy.CreatePost{
-		CommunityID: gcr.CommunityView.Community.ID,
-		Name:        "Hello, World!",
-		Body:        lemmy.NewOptional("This is an example post"),
-	})
-
-	log.Println("Created post:", pr.PostView.Post.ID)
-}

go.mod

@@ -1,20 +1,14 @@
-module go.elara.ws/go-lemmy
+module go.arsenm.dev/go-lemmy
 
 go 1.19
 
 require (
-	github.com/dave/jennifer v1.6.0
 	github.com/google/go-querystring v1.1.0
-	github.com/tidwall/gjson v1.17.0
+	github.com/mitchellh/mapstructure v1.5.0
-	go.elara.ws/logger v0.0.0-20230421022458-e80700db2090
+	github.com/recws-org/recws v1.4.0
-	golang.org/x/exp v0.0.0-20230105000112-eab7a2c85304
 )
 
 require (
-	github.com/gookit/color v1.5.1 // indirect
+	github.com/gorilla/websocket v1.4.2 // indirect
-	github.com/mattn/go-isatty v0.0.14 // indirect
+	github.com/jpillora/backoff v1.0.0 // indirect
-	github.com/tidwall/match v1.1.1 // indirect
-	github.com/tidwall/pretty v1.2.0 // indirect
-	github.com/xo/terminfo v0.0.0-20210125001918-ca9a967f8778 // indirect
-	golang.org/x/sys v0.1.0 // indirect
 )

go.sum

@@ -1,37 +1,13 @@
-github.com/dave/jennifer v1.6.0 h1:MQ/6emI2xM7wt0tJzJzyUik2Q3Tcn2eE0vtYgh4GPVI=
+github.com/google/go-cmp v0.5.2 h1:X2ev0eStA3AbceY54o37/0PQ/UWqKEiiO2dKL5OPaFM=
-github.com/dave/jennifer v1.6.0/go.mod h1:AxTG893FiZKqxy3FP1kL80VMshSMuz2G+EgvszgGRnk=
-github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
-github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
-github.com/google/go-cmp v0.5.8 h1:e6P7q2lk1O+qJJb4BtCQXlK8vWEO8V1ZeuEdJNOqZyg=
 github.com/google/go-querystring v1.1.0 h1:AnCroh3fv4ZBgVIf1Iwtovgjaw/GiKJo8M8yD/fhyJ8=
 github.com/google/go-querystring v1.1.0/go.mod h1:Kcdr2DB4koayq7X8pmAG4sNG59So17icRSOU623lUBU=
-github.com/gookit/color v1.5.1 h1:Vjg2VEcdHpwq+oY63s/ksHrgJYCTo0bwWvmmYWdE9fQ=
+github.com/gorilla/websocket v1.4.2 h1:+/TMaTYc4QFitKJxsQ7Yye35DkWvkdLcvGKqM+x0Ufc=
-github.com/gookit/color v1.5.1/go.mod h1:wZFzea4X8qN6vHOSP2apMb4/+w/orMznEzYsIHPaqKM=
+github.com/gorilla/websocket v1.4.2/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
-github.com/mattn/go-isatty v0.0.14 h1:yVuAays6BHfxijgZPzw+3Zlu5yQgKGP2/hcQbHb7S9Y=
+github.com/jpillora/backoff v1.0.0 h1:uvFg412JmmHBHw7iwprIxkPMI+sGQ4kzOWsMeHnm2EA=
-github.com/mattn/go-isatty v0.0.14/go.mod h1:7GGIvUiUoEMVVmxf/4nioHXj79iQHKdU27kJ6hsGG94=
+github.com/jpillora/backoff v1.0.0/go.mod h1:J/6gKK9jxlEcS3zixgDgUAsiuZ7yrSoa/FX5e0EB2j4=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/mitchellh/mapstructure v1.5.0 h1:jeMsZIYE/09sWLaz43PL7Gy6RuMjD2eJVyuac5Z2hdY=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/mitchellh/mapstructure v1.5.0/go.mod h1:bFUtVrKA4DC2yAKiSyO/QUcy7e+RRV2QTWOzhPopBRo=
-github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
+github.com/recws-org/recws v1.4.0 h1:y9LLddtAicjejikNZXiaY9DQjIwcAQ82acd1XU6n0lU=
-github.com/stretchr/testify v1.7.2/go.mod h1:R6va5+xMeoiuVRoj+gSkQ7d3FALtqAAGI1FQKckRals=
+github.com/recws-org/recws v1.4.0/go.mod h1:7+NQkTmBdU98VSzkzq9/P7+X0xExioUVBx9OeRKQIkk=
-github.com/stretchr/testify v1.8.0 h1:pSgiaMZlXftHpm5L7V1+rVB+AZJydKsMxsQBIJw4PKk=
-github.com/tidwall/gjson v1.17.0 h1:/Jocvlh98kcTfpN2+JzGQWQcqrPQwDrVEMApx/M5ZwM=
-github.com/tidwall/gjson v1.17.0/go.mod h1:/wbyibRr2FHMks5tjHJ5F8dMZh3AcwJEMf5vlfC0lxk=
-github.com/tidwall/match v1.1.1 h1:+Ho715JplO36QYgwN9PGYNhgZvoUSc9X2c80KVTi+GA=
-github.com/tidwall/match v1.1.1/go.mod h1:eRSPERbgtNPcGhD8UCthc6PmLEQXEWd3PRB5JTxsfmM=
-github.com/tidwall/pretty v1.2.0 h1:RWIZEg2iJ8/g6fDDYzMpobmaoGh5OLl4AXtGUGPcqCs=
-github.com/tidwall/pretty v1.2.0/go.mod h1:ITEVvHYasfjBbM0u2Pg8T2nJnzm8xPwvNhhsoaGGjNU=
-github.com/xo/terminfo v0.0.0-20210125001918-ca9a967f8778 h1:QldyIu/L63oPpyvQmHgvgickp1Yw510KJOqX7H24mg8=
-github.com/xo/terminfo v0.0.0-20210125001918-ca9a967f8778/go.mod h1:2MuV+tbUrU1zIOPMxZ5EncGwgmMJsa+9ucAQZXxsObs=
-go.elara.ws/logger v0.0.0-20230421022458-e80700db2090 h1:RVC8XvWo6Yw4HUshqx4TSzuBDScDghafU6QFRJ4xPZg=
-go.elara.ws/logger v0.0.0-20230421022458-e80700db2090/go.mod h1:qng49owViqsW5Aey93lwBXONw20oGbJIoLVscB16mPM=
-golang.org/x/exp v0.0.0-20230105000112-eab7a2c85304 h1:YUqj+XKtfrn3kXjFIiZ8jwKROD7ioAOOHUuo3ZZ2opc=
-golang.org/x/exp v0.0.0-20230105000112-eab7a2c85304/go.mod h1:CxIveKay+FTh1D0yPZemJVgC/95VzuuOLq5Qi4xnoYc=
-golang.org/x/sys v0.0.0-20210330210617-4fbd30eecc44/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
-golang.org/x/sys v0.0.0-20210630005230-0f9fa26af87c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.1.0 h1:kunALQeHf1/185U1i0GOB/fy1IPRDDpuoOOqRReG57U=
-golang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

lemmy.go

@@ -4,61 +4,63 @@ import (
 	"bytes"
 	"context"
 	"encoding/json"
-	"errors"
-	"fmt"
 	"io"
 	"net/http"
 	"net/url"
+	"reflect"
 
 	"github.com/google/go-querystring/query"
+	"go.arsenm.dev/go-lemmy/types"
 )
 
-// ErrNoToken is an error returned by ClientLogin if the server sends a null or empty token
-var ErrNoToken = errors.New("the server didn't provide a token value in its response")
-
-// Client is a client for Lemmy's HTTP API
 type Client struct {
 	client  *http.Client
 	baseURL *url.URL
-	Token   string
+	token   string
 }
 
-// New creates a new Lemmy client with the default HTTP client.
 func New(baseURL string) (*Client, error) {
 	return NewWithClient(baseURL, http.DefaultClient)
 }
 
-// NewWithClient creates a new Lemmy client with the given HTTP client
 func NewWithClient(baseURL string, client *http.Client) (*Client, error) {
 	u, err := url.Parse(baseURL)
 	if err != nil {
 		return nil, err
 	}
 	u = u.JoinPath("/api/v3")
+
 	return &Client{baseURL: u, client: client}, nil
 }
 
-// ClientLogin logs in to Lemmy by calling the login endpoint, and
+func (c *Client) Login(ctx context.Context, l types.Login) error {
-// stores the returned token in the Token field for use in future requests.
+	var lr types.LoginResponse
-//
+	res, err := c.req(ctx, http.MethodPost, "/user/login", l, &lr)
-// The Token field can be set manually if you'd like to persist the
-// token somewhere.
-func (c *Client) ClientLogin(ctx context.Context, data Login) error {
-	lr, err := c.Login(ctx, data)
 	if err != nil {
 		return err
 	}
 
-	token, ok := lr.JWT.Value()
+	err = resError(res, lr.LemmyResponse)
-	if !ok || token == "" {
+	if err != nil {
-		return ErrNoToken
+		return err
 	}
-	c.Token = token
+
+	c.token = lr.JWT.MustValue()
+
 	return nil
 }
 
-// req makes a request to the server
+func (c *Client) Token() string {
+	return c.token
+}
+
+func (c *Client) SetToken(t string) {
+	c.token = t
+}
+
 func (c *Client) req(ctx context.Context, method string, path string, data, resp any) (*http.Response, error) {
+	data = c.setAuth(data)
+
 	var r io.Reader
 	if data != nil {
 		jsonData, err := json.Marshal(data)
@@ -80,10 +82,6 @@ func (c *Client) req(ctx context.Context, method string, path string, data, resp
 
 	req.Header.Add("Content-Type", "application/json")
 
-	if c.Token != "" {
-		req.Header.Add("Authorization", "Bearer "+c.Token)
-	}
-
 	res, err := c.client.Do(req)
 	if err != nil {
 		return nil, err
@@ -100,18 +98,15 @@ func (c *Client) req(ctx context.Context, method string, path string, data, resp
 	return res, nil
 }
 
-// getReq makes a get request to the Lemmy server.
-// It's separate from req() because it uses query
-// parameters rather than a JSON request body.
 func (c *Client) getReq(ctx context.Context, method string, path string, data, resp any) (*http.Response, error) {
+	data = c.setAuth(data)
+
 	getURL := c.baseURL.JoinPath(path)
-	if data != nil {
+	vals, err := query.Values(data)
-		vals, err := query.Values(data)
+	if err != nil {
-		if err != nil {
+		return nil, err
-			return nil, err
-		}
-		getURL.RawQuery = vals.Encode()
 	}
+	getURL.RawQuery = vals.Encode()
 
 	req, err := http.NewRequestWithContext(
 		ctx,
@@ -123,10 +118,6 @@ func (c *Client) getReq(ctx context.Context, method string, path string, data, r
 		return nil, err
 	}
 
-	if c.Token != "" {
-		req.Header.Add("Authorization", "Bearer "+c.Token)
-	}
-
 	res, err := c.client.Do(req)
 	if err != nil {
 		return nil, err
@@ -143,39 +134,44 @@ func (c *Client) getReq(ctx context.Context, method string, path string, data, r
 	return res, nil
 }
 
-// Error represents an error returned by the Lemmy API
+func resError(res *http.Response, lr types.LemmyResponse) error {
-type Error struct {
+	if lr.Error.IsValid() {
-	ErrStr string
+		return types.LemmyError{
-	Code   int
-}
-
-func (le Error) Error() string {
-	if le.ErrStr != "" {
-		return fmt.Sprintf("%d %s: %s", le.Code, http.StatusText(le.Code), le.ErrStr)
-	} else {
-		return fmt.Sprintf("%d %s", le.Code, http.StatusText(le.Code))
-	}
-}
-
-// emptyResponse is a response without any fields.
-// It has an Error field to capture any errors.
-type emptyResponse struct {
-	Error Optional[string] `json:"error"`
-}
-
-// resError checks if the response contains an error, and if so, returns
-// a Go error representing it.
-func resError(res *http.Response, err Optional[string]) error {
-	if errstr, ok := err.Value(); ok {
-		return Error{
 			Code:   res.StatusCode,
-			ErrStr: errstr,
+			ErrStr: lr.Error.MustValue(),
 		}
 	} else if res.StatusCode != http.StatusOK {
-		return Error{
+		return types.HTTPError{
 			Code: res.StatusCode,
 		}
 	} else {
 		return nil
 	}
 }
+
+func (c *Client) setAuth(data any) any {
+	if data == nil {
+		return data
+	}
+
+	val := reflect.New(reflect.TypeOf(data))
+	val.Elem().Set(reflect.ValueOf(data))
+
+	authField := val.Elem().FieldByName("Auth")
+	if !authField.IsValid() {
+		return data
+	}
+
+	switch authField.Type().String() {
+	case "string":
+		authField.SetString(c.token)
+	case "types.Optional[string]":
+		setMtd := authField.MethodByName("Set")
+		out := setMtd.Call([]reflect.Value{reflect.ValueOf(c.token)})
+		authField.Set(out[0])
+	default:
+		return data
+	}
+
+	return val.Elem().Interface()
+}

person.go

@@ -0,0 +1,301 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) BanPerson(ctx context.Context, d types.BanPerson) (*types.BanPersonResponse, error) {
+	ar := &types.BanPersonResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/ban", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) BlockPerson(ctx context.Context, d types.BlockPerson) (*types.BlockPersonResponse, error) {
+	ar := &types.BlockPersonResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/block", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) ChangePassword(ctx context.Context, d types.ChangePassword) (*types.LoginResponse, error) {
+	ar := &types.LoginResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/user/change_password", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	c.token = ar.JWT.MustValue()
+
+	return ar, nil
+}
+
+func (c *Client) DeleteAccount(ctx context.Context, d types.DeleteAccount) (*types.DeleteAccountResponse, error) {
+	ar := &types.DeleteAccountResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/delete_account", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) BannedPersons(ctx context.Context, d types.GetBannedPersons) (*types.BannedPersonsResponse, error) {
+	ar := &types.BannedPersonsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/banned", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Captcha(ctx context.Context, d types.GetCaptcha) (*types.CaptchaResponse, error) {
+	ar := &types.CaptchaResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/get_captcha", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PersonDetails(ctx context.Context, d types.GetPersonDetails) (*types.GetPersonDetailsResponse, error) {
+	ar := &types.GetPersonDetailsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PersonMentions(ctx context.Context, d types.GetPersonMentions) (*types.GetPersonMentionsResponse, error) {
+	ar := &types.GetPersonMentionsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/mention", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Replies(ctx context.Context, d types.GetReplies) (*types.GetRepliesResponse, error) {
+	ar := &types.GetRepliesResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/replies", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) ReportCount(ctx context.Context, d types.GetReportCount) (*types.GetReportCountResponse, error) {
+	ar := &types.GetReportCountResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/report_count", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) UnreadCount(ctx context.Context, d types.GetUnreadCount) (*types.GetUnreadCountResponse, error) {
+	ar := &types.GetUnreadCountResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/user/unread_count", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) LeaveAdmin(ctx context.Context, d types.LeaveAdmin) (*types.GetSiteResponse, error) {
+	ar := &types.GetSiteResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/leave_admin", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) MarkAllAsRead(ctx context.Context, d types.MarkAllAsRead) (*types.GetRepliesResponse, error) {
+	ar := &types.GetRepliesResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/mark_all_as_read", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) MarkPersonMentionAsRead(ctx context.Context, d types.MarkPersonMentionAsRead) (*types.PersonMentionResponse, error) {
+	ar := &types.PersonMentionResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/mention/mark_as_read", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PasswordChange(ctx context.Context, d types.PasswordChange) (*types.LoginResponse, error) {
+	ar := &types.LoginResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/password_change", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	c.token = ar.JWT.MustValue()
+
+	return ar, nil
+}
+
+func (c *Client) PasswordReset(ctx context.Context, d types.PasswordReset) (*types.PasswordResetResponse, error) {
+	ar := &types.PasswordResetResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/password_reset", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Register(ctx context.Context, d types.Register) (*types.LoginResponse, error) {
+	ar := &types.LoginResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/user/register", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	c.token = ar.JWT.MustValue()
+
+	return ar, nil
+}
+
+func (c *Client) SaveUserSettings(ctx context.Context, d types.SaveUserSettings) (*types.LoginResponse, error) {
+	ar := &types.LoginResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/user/save_user_settings", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	c.token = ar.JWT.MustValue()
+
+	return ar, nil
+}
+
+func (c *Client) VerifyEmail(ctx context.Context, d types.VerifyEmail) (*types.VerifyEmailResponse, error) {
+	ar := &types.VerifyEmailResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/user/verify_email", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

post.go

@@ -0,0 +1,233 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) CreatePost(ctx context.Context, d types.CreatePost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) EditPost(ctx context.Context, d types.EditPost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/post", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Post(ctx context.Context, d types.GetPost) (*types.GetPostResponse, error) {
+	ar := &types.GetPostResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/post", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CreatePostReport(ctx context.Context, d types.CreatePostReport) (*types.PostReportResponse, error) {
+	ar := &types.PostReportResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/report", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) DeletePost(ctx context.Context, d types.DeletePost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/delete", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) RemovePost(ctx context.Context, d types.RemovePost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/remove", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Posts(ctx context.Context, d types.GetPosts) (*types.GetPostsResponse, error) {
+	ar := &types.GetPostsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/post/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) SiteMetadata(ctx context.Context, d types.GetSiteMetadata) (*types.GetSiteMetadataResponse, error) {
+	ar := &types.GetSiteMetadataResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/post/site_metadata", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) LikePost(ctx context.Context, d types.CreatePostLike) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/like", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PostReports(ctx context.Context, d types.ListPostReports) (*types.ListPostReportsResponse, error) {
+	ar := &types.ListPostReportsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/post/report/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) LockPost(ctx context.Context, d types.LockPost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/lock", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) MarkPostAsRead(ctx context.Context, d types.MarkPostAsRead) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/mark_as_read", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) ResolvePostReport(ctx context.Context, d types.ResolvePostReport) (*types.PostReportResponse, error) {
+	ar := &types.PostReportResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/post/report/resolve", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) SavePost(ctx context.Context, d types.SavePost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/post/save", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) StickyPost(ctx context.Context, d types.StickyPost) (*types.PostResponse, error) {
+	ar := &types.PostResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/post/sticky", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

privateMessage.go

@@ -0,0 +1,128 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) CreatePrivateMessage(ctx context.Context, d types.CreatePrivateMessage) (*types.PrivateMessageResponse, error) {
+	ar := &types.PrivateMessageResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/private_message", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) CreatePrivateMessageReport(ctx context.Context, d types.CreatePrivateMessageReport) (*types.PrivateMessageReportResponse, error) {
+	ar := &types.PrivateMessageReportResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/private_message/report", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) DeletePrivateMessage(ctx context.Context, d types.DeletePrivateMessage) (*types.PrivateMessageResponse, error) {
+	ar := &types.PrivateMessageResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/private_message/delete", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) EditPrivateMessage(ctx context.Context, d types.EditPrivateMessage) (*types.PrivateMessageResponse, error) {
+	ar := &types.PrivateMessageResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/private_message", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PrivateMessages(ctx context.Context, d types.GetPrivateMessages) (*types.PrivateMessagesResponse, error) {
+	ar := &types.PrivateMessagesResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/private_message/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) PrivateMessageReports(ctx context.Context, d types.ListPrivateMessageReports) (*types.ListPrivateMessageReportsResponse, error) {
+	ar := &types.ListPrivateMessageReportsResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/private_message/report/list", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) MarkPrivateMessageAsRead(ctx context.Context, d types.MarkPrivateMessageAsRead) (*types.PrivateMessageResponse, error) {
+	ar := &types.PrivateMessageResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/private_message/mark_as_read", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) ResolvePrivateMessageReport(ctx context.Context, d types.ResolvePrivateMessageReport) (*types.PrivateMessageReportResponse, error) {
+	ar := &types.PrivateMessageReportResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/private_message/report/resolve", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

search.go

@@ -0,0 +1,23 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) Search(ctx context.Context, d types.Search) (*types.SearchResponse, error) {
+	ar := &types.SearchResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/search", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

site.go

@@ -0,0 +1,53 @@
+package lemmy
+
+import (
+	"context"
+	"net/http"
+
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+func (c *Client) CreateSite(ctx context.Context, d types.CreateSite) (*types.SiteResponse, error) {
+	ar := &types.SiteResponse{}
+	res, err := c.req(ctx, http.MethodPost, "/site", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) EditSite(ctx context.Context, d types.EditSite) (*types.SiteResponse, error) {
+	ar := &types.SiteResponse{}
+	res, err := c.req(ctx, http.MethodPut, "/site", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}
+
+func (c *Client) Site(ctx context.Context, d types.GetSite) (*types.GetSiteResponse, error) {
+	ar := &types.GetSiteResponse{}
+	res, err := c.getReq(ctx, http.MethodGet, "/site", d, &ar)
+	if err != nil {
+		return nil, err
+	}
+
+	err = resError(res, ar.LemmyResponse)
+	if err != nil {
+		return nil, err
+	}
+
+	return ar, nil
+}

types/aggregates.go

@@ -0,0 +1,55 @@
+package types
+
+type PersonAggregates struct {
+	ID           int `json:"id" url:"id,omitempty"`
+	PersonID     int `json:"person_id" url:"person_id,omitempty"`
+	PostCount    int `json:"post_count" url:"post_count,omitempty"`
+	PostScore    int `json:"post_score" url:"post_score,omitempty"`
+	CommentCount int `json:"comment_count" url:"comment_count,omitempty"`
+	CommentScore int `json:"comment_score" url:"comment_score,omitempty"`
+}
+
+type SiteAggregates struct {
+	ID                  int `json:"id" url:"id,omitempty"`
+	SiteID              int `json:"site_id" url:"site_id,omitempty"`
+	Users               int `json:"users" url:"users,omitempty"`
+	Posts               int `json:"posts" url:"posts,omitempty"`
+	Comments            int `json:"comments" url:"comments,omitempty"`
+	Communities         int `json:"communities" url:"communities,omitempty"`
+	UsersActiveDay      int `json:"users_active_day" url:"users_active_day,omitempty"`
+	UsersActiveWeek     int `json:"users_active_week" url:"users_active_week,omitempty"`
+	UsersActiveMonth    int `json:"users_active_month" url:"users_active_month,omitempty"`
+	UsersActiveHalfYear int `json:"users_active_half_year" url:"users_active_half_year,omitempty"`
+}
+
+type PostAggregates struct {
+	ID                     int    `json:"id" url:"id,omitempty"`
+	PostID                 int    `json:"post_id" url:"post_id,omitempty"`
+	Comments               int    `json:"comments" url:"comments,omitempty"`
+	Score                  int    `json:"score" url:"score,omitempty"`
+	Upvotes                int    `json:"upvotes" url:"upvotes,omitempty"`
+	Downvotes              int    `json:"downvotes" url:"downvotes,omitempty"`
+	NewestCommentTimeNecro string `json:"newest_comment_time_necro" url:"newest_comment_time_necro,omitempty"`
+	NewestCommentTime      string `json:"newest_comment_time" url:"newest_comment_time,omitempty"`
+}
+
+type CommunityAggregates struct {
+	ID                  int `json:"id" url:"id,omitempty"`
+	CommunityID         int `json:"community_id" url:"community_id,omitempty"`
+	Subscribers         int `json:"subscribers" url:"subscribers,omitempty"`
+	Posts               int `json:"posts" url:"posts,omitempty"`
+	Comments            int `json:"comments" url:"comments,omitempty"`
+	UsersActiveDay      int `json:"users_active_day" url:"users_active_day,omitempty"`
+	UsersActiveWeek     int `json:"users_active_week" url:"users_active_week,omitempty"`
+	UsersActiveMonth    int `json:"users_active_month" url:"users_active_month,omitempty"`
+	UsersActiveHalfYear int `json:"users_active_half_year" url:"users_active_half_year,omitempty"`
+}
+
+type CommentAggregates struct {
+	ID         int `json:"id" url:"id,omitempty"`
+	CommentID  int `json:"comment_id" url:"comment_id,omitempty"`
+	Score      int `json:"score" url:"score,omitempty"`
+	Upvotes    int `json:"upvotes" url:"upvotes,omitempty"`
+	Downvotes  int `json:"downvotes" url:"downvotes,omitempty"`
+	ChildCount int `json:"child_count" url:"child_count,omitempty"`
+}

types/comment.go

@@ -0,0 +1,105 @@
+package types
+
+type CreateComment struct {
+	Content    string           `json:"content" url:"content,omitempty"`
+	PostID     int              `json:"post_id" url:"post_id,omitempty"`
+	ParentID   Optional[int]    `json:"parent_id" url:"parent_id,omitempty"`
+	LanguageID Optional[int]    `json:"language_id" url:"language_id,omitempty"`
+	FormID     Optional[string] `json:"form_id" url:"form_id,omitempty"`
+	Auth       string           `json:"auth" url:"auth,omitempty"`
+}
+
+type GetComment struct {
+	ID   int              `json:"id" url:"id,omitempty"`
+	Auth Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type EditComment struct {
+	CommentID     int              `json:"comment_id" url:"comment_id,omitempty"`
+	Content       Optional[string] `json:"content" url:"content,omitempty"`
+	Distinguished Optional[bool]   `json:"distinguished" url:"distinguished,omitempty"`
+	LanguageID    Optional[int]    `json:"language_id" url:"language_id,omitempty"`
+	FormID        Optional[string] `json:"form_id" url:"form_id,omitempty"`
+	Auth          string           `json:"auth" url:"auth,omitempty"`
+}
+
+type DeleteComment struct {
+	CommentID int    `json:"comment_id" url:"comment_id,omitempty"`
+	Deleted   bool   `json:"deleted" url:"deleted,omitempty"`
+	Auth      string `json:"auth" url:"auth,omitempty"`
+}
+
+type RemoveComment struct {
+	CommentID int              `json:"comment_id" url:"comment_id,omitempty"`
+	Removed   bool             `json:"removed" url:"removed,omitempty"`
+	Reason    Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth      string           `json:"auth" url:"auth,omitempty"`
+}
+
+type SaveComment struct {
+	CommentID int    `json:"comment_id" url:"comment_id,omitempty"`
+	Save      bool   `json:"save" url:"save,omitempty"`
+	Auth      string `json:"auth" url:"auth,omitempty"`
+}
+
+type CommentResponse struct {
+	CommentView  CommentView      `json:"comment_view" url:"comment_view,omitempty"`
+	RecipientIDs []int            `json:"recipient_i_ds" url:"recipient_i_ds,omitempty"`
+	FormID       Optional[string] `json:"form_id" url:"form_id,omitempty"`
+	LemmyResponse
+}
+
+type CreateCommentLike struct {
+	CommentID int    `json:"comment_id" url:"comment_id,omitempty"`
+	Score     int16  `json:"score" url:"score,omitempty"`
+	Auth      string `json:"auth" url:"auth,omitempty"`
+}
+
+type GetComments struct {
+	Type          Optional[ListingType]     `json:"type" url:"type,omitempty"`
+	Sort          Optional[CommentSortType] `json:"sort" url:"sort,omitempty"`
+	MaxDepth      Optional[int]             `json:"max_depth" url:"max_depth,omitempty"`
+	Page          Optional[int]             `json:"page" url:"page,omitempty"`
+	Limit         Optional[int]             `json:"limit" url:"limit,omitempty"`
+	CommunityID   Optional[int]             `json:"community_id" url:"community_id,omitempty"`
+	CommunityName Optional[string]          `json:"community_name" url:"community_name,omitempty"`
+	PostID        Optional[int]             `json:"post_id" url:"post_id,omitempty"`
+	ParentID      Optional[int]             `json:"parent_id" url:"parent_id,omitempty"`
+	SavedOnly     Optional[bool]            `json:"saved_only" url:"saved_only,omitempty"`
+	Auth          Optional[string]          `json:"auth" url:"auth,omitempty"`
+}
+
+type GetCommentsResponse struct {
+	Comments []CommentView `json:"comments" url:"comments,omitempty"`
+	LemmyResponse
+}
+
+type CreateCommentReport struct {
+	CommentID int    `json:"comment_id" url:"comment_id,omitempty"`
+	Reason    string `json:"reason" url:"reason,omitempty"`
+	Auth      string `json:"auth" url:"auth,omitempty"`
+}
+
+type CommentReportResponse struct {
+	CommentReportView CommentReportView `json:"comment_report_view" url:"comment_report_view,omitempty"`
+	LemmyResponse
+}
+
+type ResolveCommentReport struct {
+	ReportID int    `json:"report_id" url:"report_id,omitempty"`
+	Resolved bool   `json:"resolved" url:"resolved,omitempty"`
+	Auth     string `json:"auth" url:"auth,omitempty"`
+}
+
+type ListCommentReports struct {
+	Page           Optional[int]  `json:"page" url:"page,omitempty"`
+	Limit          Optional[int]  `json:"limit" url:"limit,omitempty"`
+	UnresolvedOnly Optional[bool] `json:"unresolved_only" url:"unresolved_only,omitempty"`
+	CommunityID    Optional[int]  `json:"community_id" url:"community_id,omitempty"`
+	Auth           string         `json:"auth" url:"auth,omitempty"`
+}
+
+type ListCommentReportsResponse struct {
+	CommentReports []CommentReportView `json:"comment_reports" url:"comment_reports,omitempty"`
+	LemmyResponse
+}

types/community.go

@@ -0,0 +1,131 @@
+package types
+
+type GetCommunity struct {
+	ID   Optional[int]    `json:"id" url:"id,omitempty"`
+	Name Optional[string] `json:"name" url:"name,omitempty"`
+	Auth Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type GetCommunityResponse struct {
+	CommunityView       CommunityView            `json:"community_view" url:"community_view,omitempty"`
+	Site                Optional[Site]           `json:"site" url:"site,omitempty"`
+	Moderators          []CommunityModeratorView `json:"moderators" url:"moderators,omitempty"`
+	Online              uint                     `json:"online" url:"online,omitempty"`
+	DiscussionLanguages []int                    `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	DefaultPostLanguage Optional[int]            `json:"default_post_language" url:"default_post_language,omitempty"`
+	LemmyResponse
+}
+
+type CreateCommunity struct {
+	Name                    string           `json:"name" url:"name,omitempty"`
+	Title                   string           `json:"title" url:"title,omitempty"`
+	Description             Optional[string] `json:"description" url:"description,omitempty"`
+	Icon                    Optional[string] `json:"icon" url:"icon,omitempty"`
+	Banner                  Optional[string] `json:"banner" url:"banner,omitempty"`
+	NSFW                    Optional[bool]   `json:"nsfw" url:"nsfw,omitempty"`
+	PostingRestrictedToMods Optional[bool]   `json:"posting_restricted_to_mods" url:"posting_restricted_to_mods,omitempty"`
+	Auth                    string           `json:"auth" url:"auth,omitempty"`
+}
+
+type CommunityResponse struct {
+	CommunityView CommunityView `json:"community_view" url:"community_view,omitempty"`
+	LemmyResponse
+}
+
+type ListCommunities struct {
+	Type  Optional[ListingType] `json:"type" url:"type,omitempty"`
+	Sort  Optional[SortType]    `json:"sort" url:"sort,omitempty"`
+	Page  Optional[int64]       `json:"page" url:"page,omitempty"`
+	Limit Optional[int64]       `json:"limit" url:"limit,omitempty"`
+	Auth  Optional[string]      `json:"auth" url:"auth,omitempty"`
+}
+
+type ListCommunitiesResponse struct {
+	Communities []CommunityView `json:"communities" url:"communities,omitempty"`
+	LemmyResponse
+}
+
+type BanFromCommunity struct {
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	PersonID    int              `json:"person_id" url:"person_id,omitempty"`
+	Ban         bool             `json:"ban" url:"ban,omitempty"`
+	RemoveData  Optional[bool]   `json:"remove_data" url:"remove_data,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Expires     Optional[int64]  `json:"expires" url:"expires,omitempty"`
+	Auth        string           `json:"auth" url:"auth,omitempty"`
+}
+
+type BanFromCommunityResponse struct {
+	PersonView PersonViewSafe `json:"person_view" url:"person_view,omitempty"`
+	Banned     bool           `json:"banned" url:"banned,omitempty"`
+	LemmyResponse
+}
+
+type AddModToCommunity struct {
+	CommunityID int    `json:"community_id" url:"community_id,omitempty"`
+	PersonID    int    `json:"person_id" url:"person_id,omitempty"`
+	Added       bool   `json:"added" url:"added,omitempty"`
+	Auth        string `json:"auth" url:"auth,omitempty"`
+}
+
+type AddModToCommunityResponse struct {
+	Moderators []CommunityModeratorView `json:"moderators" url:"moderators,omitempty"`
+	LemmyResponse
+}
+
+type EditCommunity struct {
+	CommunityID             int              `json:"community_id" url:"community_id,omitempty"`
+	Title                   Optional[string] `json:"title" url:"title,omitempty"`
+	Description             Optional[string] `json:"description" url:"description,omitempty"`
+	Icon                    Optional[string] `json:"icon" url:"icon,omitempty"`
+	Banner                  Optional[string] `json:"banner" url:"banner,omitempty"`
+	NSFW                    Optional[bool]   `json:"nsfw" url:"nsfw,omitempty"`
+	PostingRestrictedToMods Optional[bool]   `json:"posting_restricted_to_mods" url:"posting_restricted_to_mods,omitempty"`
+	DiscussionLanguages     Optional[[]int]  `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	Auth                    string           `json:"auth" url:"auth,omitempty"`
+}
+
+type HideCommunity struct {
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	Hidden      bool             `json:"hidden" url:"hidden,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth        string           `json:"auth" url:"auth,omitempty"`
+}
+
+type DeleteCommunity struct {
+	CommunityID int    `json:"community_id" url:"community_id,omitempty"`
+	Deleted     bool   `json:"deleted" url:"deleted,omitempty"`
+	Auth        string `json:"auth" url:"auth,omitempty"`
+}
+
+type RemoveCommunity struct {
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	Removed     bool             `json:"removed" url:"removed,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Expires     Optional[int64]  `json:"expires" url:"expires,omitempty"`
+	Auth        string           `json:"auth" url:"auth,omitempty"`
+}
+
+type FollowCommunity struct {
+	CommunityID int    `json:"community_id" url:"community_id,omitempty"`
+	Follow      bool   `json:"follow" url:"follow,omitempty"`
+	Auth        string `json:"auth" url:"auth,omitempty"`
+}
+
+type BlockCommunity struct {
+	CommunityID int    `json:"community_id" url:"community_id,omitempty"`
+	Block       bool   `json:"block" url:"block,omitempty"`
+	Auth        string `json:"auth" url:"auth,omitempty"`
+}
+
+type BlockCommunityResponse struct {
+	CommunityView CommunityView `json:"community_view" url:"community_view,omitempty"`
+	Blocked       bool          `json:"blocked" url:"blocked,omitempty"`
+	LemmyResponse
+}
+
+type TransferCommunity struct {
+	CommunityID int    `json:"community_id" url:"community_id,omitempty"`
+	PersonID    int    `json:"person_id" url:"person_id,omitempty"`
+	Auth        string `json:"auth" url:"auth,omitempty"`
+}

types/optional.go

@@ -1,53 +1,64 @@
-package lemmy
+package types
 
 import (
 	"bytes"
 	"encoding/json"
+	"errors"
 	"fmt"
 	"net/url"
 )
 
-// Optional represents an optional value
+var ErrOptionalEmpty = errors.New("optional value is empty")
+
 type Optional[T any] struct {
 	value *T
 }
 
-// NewOptional creates an optional with value v
 func NewOptional[T any](v T) Optional[T] {
 	return Optional[T]{value: &v}
 }
 
-// NewOptionalNil creates a new nil optional value
+func NewOptionalPtr[T any](v *T) Optional[T] {
+	return Optional[T]{value: v}
+}
+
 func NewOptionalNil[T any]() Optional[T] {
 	return Optional[T]{}
 }
 
-// Set sets the value of the optional
 func (o Optional[T]) Set(v T) Optional[T] {
 	o.value = &v
 	return o
 }
 
-// SetNil sets the optional value to nil
+func (o Optional[T]) SetPtr(v *T) Optional[T] {
+	o.value = v
+	return o
+}
+
 func (o Optional[T]) SetNil() Optional[T] {
 	o.value = nil
 	return o
 }
 
-// IsValid returns true if the value of the optional is not nil
 func (o Optional[T]) IsValid() bool {
 	return o.value != nil
 }
 
-// Value returns the value in the optional.
+func (o Optional[T]) MustValue() T {
-func (o Optional[T]) Value() (T, bool) {
+	if o.value == nil {
-	if o.value != nil {
+		panic("optional value is nil")
-		return *o.value, true
 	}
-	return *new(T), false
+	return *o.value
+}
+
+func (o Optional[T]) Value() (T, error) {
+	if o.value != nil {
+		return *o.value, ErrOptionalEmpty
+	}
+	return *new(T), nil
 }
 
-// ValueOr returns the value inside the optional if it exists, or else it returns fallback
 func (o Optional[T]) ValueOr(fallback T) T {
 	if o.value != nil {
 		return *o.value
@@ -55,21 +66,10 @@ func (o Optional[T]) ValueOr(fallback T) T {
 	return fallback
 }
 
-// ValueOrZero returns the value inside the optional if it exists, or else it returns the zero value of T
-func (o Optional[T]) ValueOrZero() T {
-	if o.value != nil {
-		return *o.value
-	}
-	var value T
-	return value
-}
-
-// MarshalJSON encodes the optional value as JSON
 func (o Optional[T]) MarshalJSON() ([]byte, error) {
 	return json.Marshal(o.value)
 }
 
-// UnmarshalJSON decodes JSON into the optional value
 func (o *Optional[T]) UnmarshalJSON(b []byte) error {
 	if bytes.Equal(b, []byte("null")) {
 		o.value = nil
@@ -80,7 +80,6 @@ func (o *Optional[T]) UnmarshalJSON(b []byte) error {
 	return json.Unmarshal(b, o.value)
 }
 
-// EncodeValues encodes the optional as a URL query parameter
 func (o Optional[T]) EncodeValues(key string, v *url.Values) error {
 	s := o.String()
 	if s != "<nil>" {
@@ -89,7 +88,6 @@ func (o Optional[T]) EncodeValues(key string, v *url.Values) error {
 	return nil
 }
 
-// String returns the string representation of the optional value
 func (o Optional[T]) String() string {
 	if o.value == nil {
 		return "<nil>"
@@ -97,7 +95,6 @@ func (o Optional[T]) String() string {
 	return fmt.Sprint(*o.value)
 }
 
-// GoString returns the Go representation of the optional value
 func (o Optional[T]) GoString() string {
 	if o.value == nil {
 		return "nil"

types/others.go

@@ -0,0 +1,162 @@
+package types
+
+type UserOperation string
+
+const (
+	UserOpLogin                                 UserOperation = "Login"
+	UserOpRegister                              UserOperation = "Register"
+	UserOpGetCaptcha                            UserOperation = "GetCaptcha"
+	UserOpCreateCommunity                       UserOperation = "CreateCommunity"
+	UserOpCreatePost                            UserOperation = "CreatePost"
+	UserOpListCommunities                       UserOperation = "ListCommunities"
+	UserOpGetPost                               UserOperation = "GetPost"
+	UserOpGetCommunity                          UserOperation = "GetCommunity"
+	UserOpCreateComment                         UserOperation = "CreateComment"
+	UserOpEditComment                           UserOperation = "EditComment"
+	UserOpDeleteComment                         UserOperation = "DeleteComment"
+	UserOpRemoveComment                         UserOperation = "RemoveComment"
+	UserOpSaveComment                           UserOperation = "SaveComment"
+	UserOpCreateCommentLike                     UserOperation = "CreateCommentLike"
+	UserOpGetPosts                              UserOperation = "GetPosts"
+	UserOpCreatePostLike                        UserOperation = "CreatePostLike"
+	UserOpEditPost                              UserOperation = "EditPost"
+	UserOpDeletePost                            UserOperation = "DeletePost"
+	UserOpRemovePost                            UserOperation = "RemovePost"
+	UserOpLockPost                              UserOperation = "LockPost"
+	UserOpFeaturePost                           UserOperation = "FeaturePost"
+	UserOpMarkPostAsRead                        UserOperation = "MarkPostAsRead"
+	UserOpSavePost                              UserOperation = "SavePost"
+	UserOpEditCommunity                         UserOperation = "EditCommunity"
+	UserOpDeleteCommunity                       UserOperation = "DeleteCommunity"
+	UserOpRemoveCommunity                       UserOperation = "RemoveCommunity"
+	UserOpFollowCommunity                       UserOperation = "FollowCommunity"
+	UserOpGetPersonDetails                      UserOperation = "GetPersonDetails"
+	UserOpGetReplies                            UserOperation = "GetReplies"
+	UserOpGetPersonMentions                     UserOperation = "GetPersonMentions"
+	UserOpMarkPersonMentionAsRead               UserOperation = "MarkPersonMentionAsRead"
+	UserOpMarkCommentReplyAsRead                UserOperation = "MarkCommentReplyAsRead"
+	UserOpGetModlog                             UserOperation = "GetModlog"
+	UserOpBanFromCommunity                      UserOperation = "BanFromCommunity"
+	UserOpAddModToCommunity                     UserOperation = "AddModToCommunity"
+	UserOpCreateSite                            UserOperation = "CreateSite"
+	UserOpEditSite                              UserOperation = "EditSite"
+	UserOpGetSite                               UserOperation = "GetSite"
+	UserOpAddAdmin                              UserOperation = "AddAdmin"
+	UserOpGetUnreadRegistrationApplicationCount UserOperation = "GetUnreadRegistrationApplicationCount"
+	UserOpListRegistrationApplications          UserOperation = "ListRegistrationApplications"
+	UserOpApproveRegistrationApplication        UserOperation = "ApproveRegistrationApplication"
+	UserOpBanPerson                             UserOperation = "BanPerson"
+	UserOpGetBannedPersons                      UserOperation = "GetBannedPersons"
+	UserOpSearch                                UserOperation = "Search"
+	UserOpResolveObject                         UserOperation = "ResolveObject"
+	UserOpMarkAllAsRead                         UserOperation = "MarkAllAsRead"
+	UserOpSaveUserSettings                      UserOperation = "SaveUserSettings"
+	UserOpTransferCommunity                     UserOperation = "TransferCommunity"
+	UserOpLeaveAdmin                            UserOperation = "LeaveAdmin"
+	UserOpDeleteAccount                         UserOperation = "DeleteAccount"
+	UserOpPasswordReset                         UserOperation = "PasswordReset"
+	UserOpPasswordChange                        UserOperation = "PasswordChange"
+	UserOpCreatePrivateMessage                  UserOperation = "CreatePrivateMessage"
+	UserOpEditPrivateMessage                    UserOperation = "EditPrivateMessage"
+	UserOpDeletePrivateMessage                  UserOperation = "DeletePrivateMessage"
+	UserOpMarkPrivateMessageAsRead              UserOperation = "MarkPrivateMessageAsRead"
+	UserOpCreatePrivateMessageReport            UserOperation = "CreatePrivateMessageReport"
+	UserOpResolvePrivateMessageReport           UserOperation = "ResolvePrivateMessageReport"
+	UserOpListPrivateMessageReports             UserOperation = "ListPrivateMessageReports"
+	UserOpGetPrivateMessages                    UserOperation = "GetPrivateMessages"
+	UserOpUserJoin                              UserOperation = "UserJoin"
+	UserOpGetComments                           UserOperation = "GetComments"
+	UserOpPostJoin                              UserOperation = "PostJoin"
+	UserOpCommunityJoin                         UserOperation = "CommunityJoin"
+	UserOpChangePassword                        UserOperation = "ChangePassword"
+	UserOpGetSiteMetadata                       UserOperation = "GetSiteMetadata"
+	UserOpBlockCommunity                        UserOperation = "BlockCommunity"
+	UserOpBlockPerson                           UserOperation = "BlockPerson"
+	UserOpPurgePerson                           UserOperation = "PurgePerson"
+	UserOpPurgeCommunity                        UserOperation = "PurgeCommunity"
+	UserOpPurgePost                             UserOperation = "PurgePost"
+	UserOpPurgeComment                          UserOperation = "PurgeComment"
+	UserOpCreateCommentReport                   UserOperation = "CreateCommentReport"
+	UserOpResolveCommentReport                  UserOperation = "ResolveCommentReport"
+	UserOpListCommentReports                    UserOperation = "ListCommentReports"
+	UserOpCreatePostReport                      UserOperation = "CreatePostReport"
+	UserOpResolvePostReport                     UserOperation = "ResolvePostReport"
+	UserOpListPostReports                       UserOperation = "ListPostReports"
+	UserOpGetReportCount                        UserOperation = "GetReportCount"
+	UserOpGetUnreadCount                        UserOperation = "GetUnreadCount"
+	UserOpVerifyEmail                           UserOperation = "VerifyEmail"
+)
+
+type SortType string
+
+const (
+	Active       SortType = "Active"
+	Hot          SortType = "Hot"
+	New          SortType = "New"
+	Old          SortType = "Old"
+	TopDay       SortType = "TopDay"
+	TopWeek      SortType = "TopWeek"
+	TopMonth     SortType = "TopMonth"
+	TopYear      SortType = "TopYear"
+	TopAll       SortType = "TopAll"
+	MostComments SortType = "MostComments"
+	NewComments  SortType = "NewComments"
+)
+
+type CommentSortType string
+
+const (
+	CommentSortHot CommentSortType = "Hot"
+	CommentSortTop CommentSortType = "Top"
+	CommentSortNew CommentSortType = "New"
+	CommentSortOld CommentSortType = "Old"
+)
+
+type ListingType string
+
+const (
+	ListingAll        ListingType = "All"
+	ListingLocal      ListingType = "Local"
+	ListingSubscribed ListingType = "Subscribed"
+	ListingCommunity  ListingType = "Community"
+)
+
+type SearchType string
+
+const (
+	SearchAll         SearchType = "All"
+	SearchComments    SearchType = "Comments"
+	SearchPosts       SearchType = "Posts"
+	SearchCommunities SearchType = "Communities"
+	SearchUsers       SearchType = "Users"
+	SearchURL         SearchType = "URL"
+)
+
+type ModlogActionType string
+
+const (
+	ModlogAll                  ModlogActionType = "All"
+	ModlogModRemovePost        ModlogActionType = "ModRemovePost"
+	ModlogModLockPost          ModlogActionType = "ModLockPost"
+	ModlogModStickyPost        ModlogActionType = "ModStickyPost"
+	ModlogModRemoveComment     ModlogActionType = "ModRemoveComment"
+	ModlogModRemoveCommunity   ModlogActionType = "ModRemoveCommunity"
+	ModlogModBanFromCommunity  ModlogActionType = "ModBanFromCommunity"
+	ModlogModAddCommunity      ModlogActionType = "ModAddCommunity"
+	ModlogModTransferCommunity ModlogActionType = "ModTransferCommunity"
+	ModlogModAdd               ModlogActionType = "ModAdd"
+	ModlogModBan               ModlogActionType = "ModBan"
+	ModlogModHideCommunity     ModlogActionType = "ModHideCommunity"
+	ModlogAdminPurgePerson     ModlogActionType = "AdminPurgePerson"
+	ModlogAdminPurgeCommunity  ModlogActionType = "AdminPurgeCommunity"
+	ModlogAdminPurgePost       ModlogActionType = "AdminPurgePost"
+	ModlogAdminPurgeComment    ModlogActionType = "AdminPurgeComment"
+)
+
+type SubscribedType string
+
+const (
+	Subscribed    SubscribedType = "Subscribed"
+	NotSubscribed SubscribedType = "NotSubscribed"
+	Pending       SubscribedType = "Pending"
+)

types/person.go

@@ -0,0 +1,243 @@
+package types
+
+type Login struct {
+	Password        string `json:"password" url:"password,omitempty"`
+	UsernameOrEmail string `json:"username_or_email" url:"username_or_email,omitempty"`
+}
+
+type LoginResponse struct {
+	JWT                 Optional[string] `json:"jwt" url:"jwt,omitempty"`
+	RegistrationCreated bool             `json:"registration_created" url:"registration_created,omitempty"`
+	VeriftEmailSent     bool             `json:"verify_email_sent" url:"verify_email_sent,omitempty"`
+	LemmyResponse
+}
+
+type Register struct {
+	Username       string           `json:"username" url:"username,omitempty"`
+	Password       string           `json:"password" url:"password,omitempty"`
+	PasswordVerify string           `json:"password_verify" url:"password_verify,omitempty"`
+	ShowNSFW       bool             `json:"show_nsfw" url:"show_nsfw,omitempty"`
+	Email          Optional[string] `json:"email" url:"email,omitempty"`
+	CaptchaUuid    Optional[string] `json:"captcha_uuid" url:"captcha_uuid,omitempty"`
+	CaptchaAnswer  Optional[string] `json:"captcha_answer" url:"captcha_answer,omitempty"`
+	Honeypot       Optional[string] `json:"honeypot" url:"honeypot,omitempty"`
+	Answer         Optional[string] `json:"answer" url:"answer,omitempty"`
+}
+
+type GetCaptcha struct{}
+
+type CaptchaResponse struct {
+	Png  string `json:"png" url:"png,omitempty"`
+	Wav  string `json:"wav" url:"wav,omitempty"`
+	Uuid string `json:"uuid" url:"uuid,omitempty"`
+	LemmyResponse
+}
+
+type SaveUserSettings struct {
+	ShowNSFW                 Optional[bool]   `json:"show_nsfw" url:"show_nsfw,omitempty"`
+	ShowScores               Optional[bool]   `json:"show_scores" url:"show_scores,omitempty"`
+	Theme                    Optional[string] `json:"theme" url:"theme,omitempty"`
+	DefaultSortType          Optional[int16]  `json:"default_sort_type" url:"default_sort_type,omitempty"`
+	DefaultListingType       Optional[int16]  `json:"default_listing_type" url:"default_listing_type,omitempty"`
+	InterfaceLanguage        Optional[string] `json:"interface_language" url:"interface_language,omitempty"`
+	Avatar                   Optional[string] `json:"avatar" url:"avatar,omitempty"`
+	Banner                   Optional[string] `json:"banner" url:"banner,omitempty"`
+	DisplayName              Optional[string] `json:"display_name" url:"display_name,omitempty"`
+	Email                    Optional[string] `json:"email" url:"email,omitempty"`
+	Bio                      Optional[string] `json:"bio" url:"bio,omitempty"`
+	MatrixUserID             Optional[string] `json:"matrix_user_id" url:"matrix_user_id,omitempty"`
+	ShowAvatars              Optional[bool]   `json:"show_avatars" url:"show_avatars,omitempty"`
+	SendNotificationsToEmail Optional[bool]   `json:"send_notifications_to_email" url:"send_notifications_to_email,omitempty"`
+	BotAccount               Optional[bool]   `json:"bot_account" url:"bot_account,omitempty"`
+	ShowBotAccounts          Optional[bool]   `json:"show_bot_accounts" url:"show_bot_accounts,omitempty"`
+	ShowReadPosts            Optional[bool]   `json:"show_read_posts" url:"show_read_posts,omitempty"`
+	ShowNewPostNotifs        Optional[bool]   `json:"show_new_post_notifs" url:"show_new_post_notifs,omitempty"`
+	DiscussionLanguages      Optional[[]int]  `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	Auth                     string           `json:"auth" url:"auth,omitempty"`
+}
+
+type ChangePassword struct {
+	NewPassword       string `json:"new_password" url:"new_password,omitempty"`
+	NewPasswordVerify string `json:"new_password_verify" url:"new_password_verify,omitempty"`
+	OldPassword       string `json:"old_password" url:"old_password,omitempty"`
+	Auth              string `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPersonDetails struct {
+	PersonID    Optional[int]      `json:"person_id" url:"person_id,omitempty"`
+	Username    Optional[string]   `json:"username" url:"username,omitempty"`
+	Sort        Optional[SortType] `json:"sort" url:"sort,omitempty"`
+	Page        Optional[int64]    `json:"page" url:"page,omitempty"`
+	Limit       Optional[int64]    `json:"limit" url:"limit,omitempty"`
+	CommunityID Optional[int]      `json:"community_id" url:"community_id,omitempty"`
+	SavedOnly   Optional[bool]     `json:"saved_only" url:"saved_only,omitempty"`
+	Auth        Optional[string]   `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPersonDetailsResponse struct {
+	PersonView PersonViewSafe           `json:"person_view" url:"person_view,omitempty"`
+	Comments   []CommentView            `json:"comments" url:"comments,omitempty"`
+	Posts      []PostView               `json:"posts" url:"posts,omitempty"`
+	Moderates  []CommunityModeratorView `json:"moderates" url:"moderates,omitempty"`
+	LemmyResponse
+}
+
+type GetReplies struct {
+	Limit      Optional[int]             `json:"limit" url:"limit,omitempty"`
+	Page       Optional[int]             `json:"page" url:"page,omitempty"`
+	Sort       Optional[CommentSortType] `json:"sort" url:"sort,omitempty"`
+	UnreadOnly Optional[bool]            `json:"unread_only" url:"unread_only,omitempty"`
+	Auth       string                    `json:"auth" url:"auth,omitempty"`
+}
+
+type GetRepliesResponse struct {
+	Replies []CommentReplyView `json:"replies" url:"replies,omitempty"`
+	LemmyResponse
+}
+
+type GetPersonMentionsResponse struct {
+	Mentions []PersonMentionView `json:"mentions" url:"mentions,omitempty"`
+	LemmyResponse
+}
+
+type MarkAllAsRead struct {
+	Auth string `json:"auth" url:"auth,omitempty"`
+}
+
+type AddAdmin struct {
+	PersonID int    `json:"person_id" url:"person_id,omitempty"`
+	Added    bool   `json:"added" url:"added,omitempty"`
+	Auth     string `json:"auth" url:"auth,omitempty"`
+}
+
+type AddAdminResponse struct {
+	Admins []PersonViewSafe `json:"admins" url:"admins,omitempty"`
+	LemmyResponse
+}
+
+type BanPerson struct {
+	PersonID   int              `json:"person_id" url:"person_id,omitempty"`
+	Ban        bool             `json:"ban" url:"ban,omitempty"`
+	RemoveData Optional[bool]   `json:"remove_data" url:"remove_data,omitempty"`
+	Reason     Optional[string] `json:"reason" url:"reason,omitempty"`
+	Expires    Optional[int64]  `json:"expires" url:"expires,omitempty"`
+	Auth       string           `json:"auth" url:"auth,omitempty"`
+}
+
+type GetBannedPersons struct {
+	Auth string `json:"auth" url:"auth,omitempty"`
+}
+
+type BanPersonResponse struct {
+	PersonView PersonViewSafe `json:"person_view" url:"person_view,omitempty"`
+	Banned     bool           `json:"banned" url:"banned,omitempty"`
+	LemmyResponse
+}
+
+type BlockPerson struct {
+	PersonID int    `json:"person_id" url:"person_id,omitempty"`
+	Block    bool   `json:"block" url:"block,omitempty"`
+	Auth     string `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPersonMentions struct {
+	Sort       Optional[CommentSortType] `json:"sort" url:"sort,omitempty"`
+	Page       Optional[int64]           `json:"page" url:"page,omitempty"`
+	Limit      Optional[int64]           `json:"limit" url:"limit,omitempty"`
+	UnreadOnly Optional[bool]            `json:"unread_only" url:"unread_only,omitempty"`
+	Auth       string                    `json:"auth" url:"auth,omitempty"`
+}
+
+type MarkPersonMentionAsRead struct {
+	PersonMentionID int    `json:"person_mention_id" url:"person_mention_id,omitempty"`
+	Read            bool   `json:"read" url:"read,omitempty"`
+	Auth            string `json:"auth" url:"auth,omitempty"`
+}
+
+type PersonMentionResponse struct {
+	PersonMentionView PersonMentionView `json:"person_mention_view" url:"person_mention_view,omitempty"`
+	LemmyResponse
+}
+
+type MarkCommentReplyAsRead struct {
+	CommentReplyID int    `json:"comment_reply_id" url:"comment_reply_id,omitempty"`
+	Read           bool   `json:"read" url:"read,omitempty"`
+	Auth           string `json:"auth" url:"auth,omitempty"`
+}
+
+type CommentReplyResponse struct {
+	CommentReplyView CommentReplyView `json:"comment_reply_view" url:"comment_reply_view,omitempty"`
+	LemmyResponse
+}
+
+type DeleteAccount struct {
+	Password string `json:"password" url:"password,omitempty"`
+	Auth     string `json:"auth" url:"auth,omitempty"`
+}
+
+type DeleteAccountResponse struct {
+	LemmyResponse
+}
+
+type PasswordReset struct {
+	Email string `json:"email" url:"email,omitempty"`
+}
+
+type PasswordResetResponse struct {
+	LemmyResponse
+}
+
+type PasswordChangeAfterReset struct {
+	Token          string `json:"token" url:"token,omitempty"`
+	Password       string `json:"password" url:"password,omitempty"`
+	PasswordVerify string `json:"password_verify" url:"password_verify,omitempty"`
+}
+
+type GetReportCount struct {
+	CommunityID Optional[int] `json:"community_id" url:"community_id,omitempty"`
+	Auth        string        `json:"auth" url:"auth,omitempty"`
+}
+
+type GetReportCountResponse struct {
+	CommunityID           Optional[int]   `json:"community_id" url:"community_id,omitempty"`
+	CommentReports        int64           `json:"comment_reports" url:"comment_reports,omitempty"`
+	PostReports           int64           `json:"post_reports" url:"post_reports,omitempty"`
+	PrivateMessageReports Optional[int64] `json:"private_message_reports" url:"private_message_reports,omitempty"`
+	LemmyResponse
+}
+
+type GetUnreadCount struct {
+	Auth string `json:"auth" url:"auth,omitempty"`
+}
+
+type GetUnreadCountResponse struct {
+	Replies         int64 `json:"replies" url:"replies,omitempty"`
+	Mentions        int64 `json:"mentions" url:"mentions,omitempty"`
+	PrivateMessages int64 `json:"private_messages" url:"private_messages,omitempty"`
+	LemmyResponse
+}
+
+type VerifyEmail struct {
+	Token string `json:"token" url:"token,omitempty"`
+}
+
+type VerifyEmailResponse struct {
+	LemmyResponse
+}
+
+type BlockPersonResponse struct {
+	Blocked    bool           `json:"blocked" url:"blocked,omitempty"`
+	PersonView PersonViewSafe `json:"person_view" url:"person_view,omitempty"`
+	LemmyResponse
+}
+
+type BannedPersonsResponse struct {
+	Banned []PersonViewSafe `json:"banned" url:"banned,omitempty"`
+	LemmyResponse
+}
+
+type PasswordChange struct {
+	Password       string `json:"password" url:"password,omitempty"`
+	PasswordVerify string `json:"password_verify" url:"password_verify,omitempty"`
+	Token          string `json:"token" url:"token,omitempty"`
+}

types/post.go

@@ -0,0 +1,146 @@
+package types
+
+type CreatePost struct {
+	Name        string           `json:"name" url:"name,omitempty"`
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	URL         Optional[string] `json:"url" url:"url,omitempty"`
+	Body        Optional[string] `json:"body" url:"body,omitempty"`
+	Honeypot    Optional[string] `json:"honeypot" url:"honeypot,omitempty"`
+	NSFW        Optional[bool]   `json:"nsfw" url:"nsfw,omitempty"`
+	LanguageID  Optional[int]    `json:"language_id" url:"language_id,omitempty"`
+	Auth        string           `json:"auth" url:"auth,omitempty"`
+}
+
+type PostResponse struct {
+	PostView PostView `json:"post_view" url:"post_view,omitempty"`
+	LemmyResponse
+}
+
+type GetPost struct {
+	ID        Optional[int]    `json:"id" url:"id,omitempty"`
+	CommentID Optional[int]    `json:"comment_id" url:"comment_id,omitempty"`
+	Auth      Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPostResponse struct {
+	PostView      PostView                 `json:"post_view" url:"post_view,omitempty"`
+	CommunityView CommunityView            `json:"community_view" url:"community_view,omitempty"`
+	Moderators    []CommunityModeratorView `json:"moderators" url:"moderators,omitempty"`
+	Online        uint                     `json:"online" url:"online,omitempty"`
+	LemmyResponse
+}
+
+type GetPosts struct {
+	Type          Optional[ListingType] `json:"type" url:"type,omitempty"`
+	Sort          Optional[SortType]    `json:"sort" url:"sort,omitempty"`
+	Page          Optional[int64]       `json:"page" url:"page,omitempty"`
+	Limit         Optional[int64]       `json:"limit" url:"limit,omitempty"`
+	CommunityID   Optional[int]         `json:"community_id" url:"community_id,omitempty"`
+	CommunityName Optional[string]      `json:"community_name" url:"community_name,omitempty"`
+	SavedOnly     Optional[bool]        `json:"saved_only" url:"saved_only,omitempty"`
+	Auth          Optional[string]      `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPostsResponse struct {
+	Posts []PostView `json:"posts" url:"posts,omitempty"`
+	LemmyResponse
+}
+
+type CreatePostLike struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Score  int16            `json:"score" url:"score,omitempty"`
+	Auth   Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type EditPost struct {
+	PostID     int              `json:"post_id" url:"post_id,omitempty"`
+	Name       Optional[string] `json:"name" url:"name,omitempty"`
+	URL        Optional[string] `json:"url" url:"url,omitempty"`
+	Body       Optional[string] `json:"body" url:"body,omitempty"`
+	NSFW       Optional[bool]   `json:"nsfw" url:"nsfw,omitempty"`
+	LanguageID Optional[int]    `json:"language_id" url:"language_id,omitempty"`
+	Auth       Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type DeletePost struct {
+	PostID  int              `json:"post_id" url:"post_id,omitempty"`
+	Deleted bool             `json:"deleted" url:"deleted,omitempty"`
+	Auth    Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type RemovePost struct {
+	PostID  int              `json:"post_id" url:"post_id,omitempty"`
+	Removed bool             `json:"removed" url:"removed,omitempty"`
+	Reason  Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth    Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type MarkPostAsRead struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Read   bool             `json:"read" url:"read,omitempty"`
+	Auth   Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type LockPost struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Locked bool             `json:"locked" url:"locked,omitempty"`
+	Auth   Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type StickyPost struct {
+	PostID   int              `json:"post_id" url:"post_id,omitempty"`
+	Stickied bool             `json:"stickied" url:"stickied,omitempty"`
+	Auth     Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type SavePost struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Save   bool             `json:"save" url:"save,omitempty"`
+	Auth   Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type CreatePostReport struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Reason string           `json:"reason" url:"reason,omitempty"`
+	Auth   Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type PostReportResponse struct {
+	PostReportView PostReportView `json:"post_report_view" url:"post_report_view,omitempty"`
+	LemmyResponse
+}
+
+type ResolvePostReport struct {
+	ReportID int              `json:"report_id" url:"report_id,omitempty"`
+	Resolved bool             `json:"resolved" url:"resolved,omitempty"`
+	Auth     Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type ListPostReports struct {
+	Page           Optional[int64]  `json:"page" url:"page,omitempty"`
+	Limit          Optional[int64]  `json:"limit" url:"limit,omitempty"`
+	UnresolvedOnly Optional[bool]   `json:"unresolved_only" url:"unresolved_only,omitempty"`
+	CommunityID    Optional[int]    `json:"community_id" url:"community_id,omitempty"`
+	Auth           Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type ListPostReportsResponse struct {
+	PostReports []PostReportView `json:"post_reports" url:"post_reports,omitempty"`
+	LemmyResponse
+}
+
+type GetSiteMetadata struct {
+	URL string `json:"url" url:"url,omitempty"`
+}
+
+type GetSiteMetadataResponse struct {
+	Metadata SiteMetadata `json:"metadata" url:"metadata,omitempty"`
+	LemmyResponse
+}
+
+type SiteMetadata struct {
+	Title         Optional[string] `json:"title" url:"title,omitempty"`
+	Description   Optional[string] `json:"description" url:"description,omitempty"`
+	Image         Optional[string] `json:"image" url:"image,omitempty"`
+	EmbedVideoURL Optional[string] `json:"embed_video_url" url:"embed_video_url,omitempty"`
+}

types/privateMessage.go

@@ -0,0 +1,71 @@
+package types
+
+type CreatePrivateMessage struct {
+	Content     string           `json:"content" url:"content,omitempty"`
+	RecipientID int              `json:"recipient_id" url:"recipient_id,omitempty"`
+	Auth        Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type EditPrivateMessage struct {
+	PrivateMessageID int              `json:"private_message_id" url:"private_message_id,omitempty"`
+	Content          string           `json:"content" url:"content,omitempty"`
+	Auth             Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type DeletePrivateMessage struct {
+	PrivateMessageID int              `json:"private_message_id" url:"private_message_id,omitempty"`
+	Deleted          bool             `json:"deleted" url:"deleted,omitempty"`
+	Auth             Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type MarkPrivateMessageAsRead struct {
+	PrivateMessageID int              `json:"private_message_id" url:"private_message_id,omitempty"`
+	Read             bool             `json:"read" url:"read,omitempty"`
+	Auth             Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type GetPrivateMessages struct {
+	UnreadOnly Optional[bool]   `json:"unread_only" url:"unread_only,omitempty"`
+	Page       Optional[int64]  `json:"page" url:"page,omitempty"`
+	Limit      Optional[int64]  `json:"limit" url:"limit,omitempty"`
+	Auth       Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type PrivateMessagesResponse struct {
+	PrivateMessages []PrivateMessageView `json:"private_messages" url:"private_messages,omitempty"`
+	LemmyResponse
+}
+
+type PrivateMessageResponse struct {
+	PrivateMessageView PrivateMessageView `json:"private_message_view" url:"private_message_view,omitempty"`
+	LemmyResponse
+}
+
+type CreatePrivateMessageReport struct {
+	PrivateMessageID int              `json:"private_message_id" url:"private_message_id,omitempty"`
+	Reason           string           `json:"reason" url:"reason,omitempty"`
+	Auth             Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type PrivateMessageReportResponse struct {
+	PrivateMessageReportView PrivateMessageReportView `json:"private_message_report_view" url:"private_message_report_view,omitempty"`
+	LemmyResponse
+}
+
+type ResolvePrivateMessageReport struct {
+	ReportID int              `json:"report_id" url:"report_id,omitempty"`
+	Resolved bool             `json:"resolved" url:"resolved,omitempty"`
+	Auth     Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type ListPrivateMessageReports struct {
+	Page           Optional[int64]  `json:"page" url:"page,omitempty"`
+	Limit          Optional[int64]  `json:"limit" url:"limit,omitempty"`
+	UnresolvedOnly Optional[bool]   `json:"unresolved_only" url:"unresolved_only,omitempty"`
+	Auth           Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type ListPrivateMessageReportsResponse struct {
+	PrivateMessageReports []PrivateMessageReportView `json:"private_message_reports" url:"private_message_reports,omitempty"`
+	LemmyResponse
+}

types/site.go

@@ -0,0 +1,256 @@
+package types
+
+type Search struct {
+	CommunityID   Optional[int]         `json:"community_id" url:"community_id,omitempty"`
+	CommunityName Optional[string]      `json:"community_name" url:"community_name,omitempty"`
+	CreatorID     Optional[int]         `json:"creator_id" url:"creator_id,omitempty"`
+	Limit         Optional[int]         `json:"limit" url:"limit,omitempty"`
+	ListingType   Optional[ListingType] `json:"listing_type" url:"listing_type,omitempty"`
+	Page          Optional[int]         `json:"page" url:"page,omitempty"`
+	Query         string                `json:"q" url:"q,omitempty"`
+	Sort          Optional[SortType]    `json:"sort" url:"sort,omitempty"`
+	Type          Optional[SearchType]  `json:"type_" url:"type_,omitempty"`
+}
+
+type SearchResponse struct {
+	Type        string           `json:"type" url:"type,omitempty"`
+	Comments    []CommentView    `json:"comments" url:"comments,omitempty"`
+	Posts       []PostView       `json:"posts" url:"posts,omitempty"`
+	Communities []CommunityView  `json:"communities" url:"communities,omitempty"`
+	Users       []PersonViewSafe `json:"users" url:"users,omitempty"`
+	LemmyResponse
+}
+
+type ResolveObject struct {
+	Query string           `json:"q" url:"q,omitempty"`
+	Auth  Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type ResolveObjectResponse struct {
+	Comment   Optional[CommentView]    `json:"comment" url:"comment,omitempty"`
+	Post      Optional[PostView]       `json:"post" url:"post,omitempty"`
+	Community Optional[CommunityView]  `json:"community" url:"community,omitempty"`
+	Person    Optional[PersonViewSafe] `json:"person" url:"person,omitempty"`
+	LemmyResponse
+}
+
+type GetModlog struct {
+	ModPersonID   Optional[int]              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	CommunityID   Optional[int]              `json:"community_id" url:"community_id,omitempty"`
+	Page          Optional[int64]            `json:"page" url:"page,omitempty"`
+	Limit         Optional[int64]            `json:"limit" url:"limit,omitempty"`
+	Auth          Optional[string]           `json:"auth" url:"auth,omitempty"`
+	Type          Optional[ModlogActionType] `json:"type" url:"type,omitempty"`
+	OtherPersonID Optional[int]              `json:"other_person_id" url:"other_person_id,omitempty"`
+}
+
+type GetModlogResponse struct {
+	RemovedPosts           []ModRemovePostView        `json:"removed_posts" url:"removed_posts,omitempty"`
+	LockedPosts            []ModLockPostView          `json:"locked_posts" url:"locked_posts,omitempty"`
+	StickiedPosts          []ModStickyPostView        `json:"stickied_posts" url:"stickied_posts,omitempty"`
+	RemovedComments        []ModRemoveCommentView     `json:"removed_comments" url:"removed_comments,omitempty"`
+	RemovedCommunities     []ModRemoveCommunityView   `json:"removed_communities" url:"removed_communities,omitempty"`
+	BannedFromCommunity    []ModBanFromCommunityView  `json:"banned_from_community" url:"banned_from_community,omitempty"`
+	Banned                 []ModBanView               `json:"banned" url:"banned,omitempty"`
+	AddedToCommunity       []ModAddCommunityView      `json:"added_to_community" url:"added_to_community,omitempty"`
+	TransferredToCommunity []ModTransferCommunityView `json:"transferred_to_community" url:"transferred_to_community,omitempty"`
+	Added                  []ModAddView               `json:"added" url:"added,omitempty"`
+	AdminPurgedPersons     []AdminPurgePersonView     `json:"admin_purged_persons" url:"admin_purged_persons,omitempty"`
+	AdminPurgedCommunities []AdminPurgeCommunityView  `json:"admin_purged_communities" url:"admin_purged_communities,omitempty"`
+	AdminPurgedPosts       []AdminPurgePostView       `json:"admin_purged_posts" url:"admin_purged_posts,omitempty"`
+	AdminPurgedComments    []AdminPurgeCommentView    `json:"admin_purged_comments" url:"admin_purged_comments,omitempty"`
+	HiddenCommunities      []ModHideCommunityView     `json:"hidden_communities" url:"hidden_communities,omitempty"`
+	LemmyResponse
+}
+
+type CreateSite struct {
+	Name                       string             `json:"name" url:"name,omitempty"`
+	Sidebar                    Optional[string]   `json:"sidebar" url:"sidebar,omitempty"`
+	Description                Optional[string]   `json:"description" url:"description,omitempty"`
+	Icon                       Optional[string]   `json:"icon" url:"icon,omitempty"`
+	Banner                     Optional[string]   `json:"banner" url:"banner,omitempty"`
+	EnableDownvotes            Optional[bool]     `json:"enable_downvotes" url:"enable_downvotes,omitempty"`
+	OpenRegistration           Optional[bool]     `json:"open_registration" url:"open_registration,omitempty"`
+	EnableNSFW                 Optional[bool]     `json:"enable_nsfw" url:"enable_nsfw,omitempty"`
+	CommunityCreationAdminOnly Optional[bool]     `json:"community_creation_admin_only" url:"community_creation_admin_only,omitempty"`
+	RequireEmailVerification   Optional[bool]     `json:"require_email_verification" url:"require_email_verification,omitempty"`
+	RequireApplication         Optional[bool]     `json:"require_application" url:"require_application,omitempty"`
+	ApplicationQuestion        Optional[string]   `json:"application_question" url:"application_question,omitempty"`
+	PrivateInstance            Optional[bool]     `json:"private_instance" url:"private_instance,omitempty"`
+	DefaultTheme               Optional[string]   `json:"default_theme" url:"default_theme,omitempty"`
+	DefaultPostListingType     Optional[string]   `json:"default_post_listing_type" url:"default_post_listing_type,omitempty"`
+	LegalInformation           Optional[string]   `json:"legal_information" url:"legal_information,omitempty"`
+	ApplicationEmailAdmins     Optional[bool]     `json:"application_email_admins" url:"application_email_admins,omitempty"`
+	HideModlogModNames         Optional[bool]     `json:"hide_modlog_mod_names" url:"hide_modlog_mod_names,omitempty"`
+	DiscussionLanguages        Optional[[]int]    `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	SlurFilterRegex            Optional[string]   `json:"slur_filter_regex" url:"slur_filter_regex,omitempty"`
+	ActorNameMaxLength         Optional[int]      `json:"actor_name_max_length" url:"actor_name_max_length,omitempty"`
+	RateLimitMessage           Optional[int]      `json:"rate_limit_message" url:"rate_limit_message,omitempty"`
+	RateLimitMessagePerSecond  Optional[int]      `json:"rate_limit_message_per_second" url:"rate_limit_message_per_second,omitempty"`
+	RateLimitPost              Optional[int]      `json:"rate_limit_post" url:"rate_limit_post,omitempty"`
+	RateLimitPostPerSecond     Optional[int]      `json:"rate_limit_post_per_second" url:"rate_limit_post_per_second,omitempty"`
+	RateLimitRegister          Optional[int]      `json:"rate_limit_register" url:"rate_limit_register,omitempty"`
+	RateLimitRegisterPerSecond Optional[int]      `json:"rate_limit_register_per_second" url:"rate_limit_register_per_second,omitempty"`
+	RateLimitImage             Optional[int]      `json:"rate_limit_image" url:"rate_limit_image,omitempty"`
+	RateLimitImagePerSecond    Optional[int]      `json:"rate_limit_image_per_second" url:"rate_limit_image_per_second,omitempty"`
+	RateLimitComment           Optional[int]      `json:"rate_limit_comment" url:"rate_limit_comment,omitempty"`
+	RateLimitCommentPerSecond  Optional[int]      `json:"rate_limit_comment_per_second" url:"rate_limit_comment_per_second,omitempty"`
+	RateLimitSearch            Optional[int]      `json:"rate_limit_search" url:"rate_limit_search,omitempty"`
+	RateLimitSearchPerSecond   Optional[int]      `json:"rate_limit_search_per_second" url:"rate_limit_search_per_second,omitempty"`
+	FederationEnabled          Optional[bool]     `json:"federation_enabled" url:"federation_enabled,omitempty"`
+	FederationDebug            Optional[bool]     `json:"federation_debug" url:"federation_debug,omitempty"`
+	FederationWorkerCount      Optional[int]      `json:"federation_worker_count" url:"federation_worker_count,omitempty"`
+	CaptchaEnabled             Optional[bool]     `json:"captcha_enabled" url:"captcha_enabled,omitempty"`
+	CaptchaDifficulty          Optional[string]   `json:"captcha_difficulty" url:"captcha_difficulty,omitempty"`
+	AllowedInstances           Optional[[]string] `json:"allowed_instances" url:"allowed_instances,omitempty"`
+	BlockedInstances           Optional[[]string] `json:"blocked_instances" url:"blocked_instances,omitempty"`
+	Auth                       string             `json:"auth" url:"auth,omitempty"`
+}
+
+type EditSite struct {
+	Name                       Optional[string]   `json:"name" url:"name,omitempty"`
+	Sidebar                    Optional[string]   `json:"sidebar" url:"sidebar,omitempty"`
+	Description                Optional[string]   `json:"description" url:"description,omitempty"`
+	Icon                       Optional[string]   `json:"icon" url:"icon,omitempty"`
+	Banner                     Optional[string]   `json:"banner" url:"banner,omitempty"`
+	EnableDownvotes            Optional[bool]     `json:"enable_downvotes" url:"enable_downvotes,omitempty"`
+	OpenRegistration           Optional[bool]     `json:"open_registration" url:"open_registration,omitempty"`
+	EnableNSFW                 Optional[bool]     `json:"enable_nsfw" url:"enable_nsfw,omitempty"`
+	CommunityCreationAdminOnly Optional[bool]     `json:"community_creation_admin_only" url:"community_creation_admin_only,omitempty"`
+	RequireEmailVerification   Optional[bool]     `json:"require_email_verification" url:"require_email_verification,omitempty"`
+	RequireApplication         Optional[bool]     `json:"require_application" url:"require_application,omitempty"`
+	ApplicationQuestion        Optional[string]   `json:"application_question" url:"application_question,omitempty"`
+	PrivateInstance            Optional[bool]     `json:"private_instance" url:"private_instance,omitempty"`
+	DefaultTheme               Optional[string]   `json:"default_theme" url:"default_theme,omitempty"`
+	DefaultPostListingType     Optional[string]   `json:"default_post_listing_type" url:"default_post_listing_type,omitempty"`
+	LegalInformation           Optional[string]   `json:"legal_information" url:"legal_information,omitempty"`
+	ApplicationEmailAdmins     Optional[bool]     `json:"application_email_admins" url:"application_email_admins,omitempty"`
+	HideModlogModNames         Optional[bool]     `json:"hide_modlog_mod_names" url:"hide_modlog_mod_names,omitempty"`
+	DiscussionLanguages        Optional[[]int]    `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	SlurFilterRegex            Optional[string]   `json:"slur_filter_regex" url:"slur_filter_regex,omitempty"`
+	ActorNameMaxLength         Optional[int]      `json:"actor_name_max_length" url:"actor_name_max_length,omitempty"`
+	RateLimitMessage           Optional[int]      `json:"rate_limit_message" url:"rate_limit_message,omitempty"`
+	RateLimitMessagePerSecond  Optional[int]      `json:"rate_limit_message_per_second" url:"rate_limit_message_per_second,omitempty"`
+	RateLimitPost              Optional[int]      `json:"rate_limit_post" url:"rate_limit_post,omitempty"`
+	RateLimitPostPerSecond     Optional[int]      `json:"rate_limit_post_per_second" url:"rate_limit_post_per_second,omitempty"`
+	RateLimitRegister          Optional[int]      `json:"rate_limit_register" url:"rate_limit_register,omitempty"`
+	RateLimitRegisterPerSecond Optional[int]      `json:"rate_limit_register_per_second" url:"rate_limit_register_per_second,omitempty"`
+	RateLimitImage             Optional[int]      `json:"rate_limit_image" url:"rate_limit_image,omitempty"`
+	RateLimitImagePerSecond    Optional[int]      `json:"rate_limit_image_per_second" url:"rate_limit_image_per_second,omitempty"`
+	RateLimitComment           Optional[int]      `json:"rate_limit_comment" url:"rate_limit_comment,omitempty"`
+	RateLimitCommentPerSecond  Optional[int]      `json:"rate_limit_comment_per_second" url:"rate_limit_comment_per_second,omitempty"`
+	RateLimitSearch            Optional[int]      `json:"rate_limit_search" url:"rate_limit_search,omitempty"`
+	RateLimitSearchPerSecond   Optional[int]      `json:"rate_limit_search_per_second" url:"rate_limit_search_per_second,omitempty"`
+	FederationEnabled          Optional[bool]     `json:"federation_enabled" url:"federation_enabled,omitempty"`
+	FederationDebug            Optional[bool]     `json:"federation_debug" url:"federation_debug,omitempty"`
+	FederationWorkerCount      Optional[int]      `json:"federation_worker_count" url:"federation_worker_count,omitempty"`
+	CaptchaEnabled             Optional[bool]     `json:"captcha_enabled" url:"captcha_enabled,omitempty"`
+	CaptchaDifficulty          Optional[string]   `json:"captcha_difficulty" url:"captcha_difficulty,omitempty"`
+	AllowedInstances           Optional[[]string] `json:"allowed_instances" url:"allowed_instances,omitempty"`
+	BlockedInstances           Optional[[]string] `json:"blocked_instances" url:"blocked_instances,omitempty"`
+	Taglines                   Optional[[]string] `json:"taglines" url:"taglines,omitempty"`
+	Auth                       string             `json:"auth" url:"auth,omitempty"`
+}
+
+type GetSite struct {
+	Auth Optional[string] `json:"auth" url:"auth,omitempty"`
+}
+
+type SiteResponse struct {
+	SiteView SiteView `json:"site_view" url:"site_view,omitempty"`
+	LemmyResponse
+}
+
+type GetSiteResponse struct {
+	SiteView            SiteView                     `json:"site_view" url:"site_view,omitempty"`
+	Admins              []PersonViewSafe             `json:"admins" url:"admins,omitempty"`
+	Online              int                          `json:"online" url:"online,omitempty"`
+	Version             string                       `json:"version" url:"version,omitempty"`
+	MyUser              Optional[MyUserInfo]         `json:"my_user" url:"my_user,omitempty"`
+	FederatedInstances  Optional[FederatedInstances] `json:"federated_instances" url:"federated_instances,omitempty"`
+	AllLanguages        []Language                   `json:"all_languages" url:"all_languages,omitempty"`
+	DiscussionLanguages []int                        `json:"discussion_languages" url:"discussion_languages,omitempty"`
+	Taglines            Optional[[]Tagline]          `json:"taglines" url:"taglines,omitempty"`
+	LemmyResponse
+}
+
+type MyUserInfo struct {
+	LocalUserView       LocalUserSettingsView    `json:"local_user_view" url:"local_user_view,omitempty"`
+	Follows             []CommunityFollowerView  `json:"follows" url:"follows,omitempty"`
+	Moderates           []CommunityModeratorView `json:"moderates" url:"moderates,omitempty"`
+	CommunityBlocks     []CommunityBlockView     `json:"community_blocks" url:"community_blocks,omitempty"`
+	PersonBlocks        []PersonBlockView        `json:"person_blocks" url:"person_blocks,omitempty"`
+	DiscussionLanguages []Language               `json:"discussion_languages" url:"discussion_languages,omitempty"`
+}
+
+type LeaveAdmin struct {
+	Auth string `json:"auth" url:"auth,omitempty"`
+}
+
+type FederatedInstances struct {
+	Linked  []string           `json:"linked" url:"linked,omitempty"`
+	Allowed Optional[[]string] `json:"allowed" url:"allowed,omitempty"`
+	Blocked Optional[[]string] `json:"blocked" url:"blocked,omitempty"`
+}
+
+type PurgePerson struct {
+	PersonID int              `json:"person_id" url:"person_id,omitempty"`
+	Reason   Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth     string           `json:"auth" url:"auth,omitempty"`
+}
+
+type PurgeCommunity struct {
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth        string           `json:"auth" url:"auth,omitempty"`
+}
+
+type PurgePost struct {
+	PostID int              `json:"post_id" url:"post_id,omitempty"`
+	Reason Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth   string           `json:"auth" url:"auth,omitempty"`
+}
+
+type PurgeComment struct {
+	CommentID int              `json:"comment_id" url:"comment_id,omitempty"`
+	Reason    Optional[string] `json:"reason" url:"reason,omitempty"`
+	Auth      string           `json:"auth" url:"auth,omitempty"`
+}
+
+type PurgeItemResponse struct {
+	Success bool `json:"success" url:"success,omitempty"`
+	LemmyResponse
+}
+
+type ListRegistrationApplications struct {
+	UnreadOnly Optional[bool] `json:"unread_only" url:"unread_only,omitempty"`
+	Page       Optional[int]  `json:"page" url:"page,omitempty"`
+	Limit      Optional[int]  `json:"limit" url:"limit,omitempty"`
+	Auth       string         `json:"auth" url:"auth,omitempty"`
+}
+
+type ListRegistrationApplicationsResponse struct {
+	RegistrationApplications []RegistrationApplicationView `json:"registration_applications" url:"registration_applications,omitempty"`
+	LemmyResponse
+}
+
+type ApproveRegistrationApplication struct {
+	ID         int              `json:"id" url:"id,omitempty"`
+	Approve    bool             `json:"approve" url:"approve,omitempty"`
+	DenyReason Optional[string] `json:"deny_reason" url:"deny_reason,omitempty"`
+	Auth       string           `json:"auth" url:"auth,omitempty"`
+}
+
+type RegistrationApplicationResponse struct {
+	RegistrationApplication RegistrationApplicationView `json:"registration_application" url:"registration_application,omitempty"`
+	LemmyResponse
+}
+
+type GetUnreadRegistrationApplicationCount struct {
+	Auth string `json:"auth" url:"auth,omitempty"`
+}
+
+type GetUnreadRegistrationApplicationCountResponse struct {
+	RegistrationApplications int `json:"registration_applications" url:"registration_applications,omitempty"`
+	LemmyResponse
+}

types/source.go

@@ -0,0 +1,402 @@
+package types
+
+import "time"
+
+type LocalUserSettings struct {
+	ID                  int              `json:"id" url:"id,omitempty"`
+	PersonID            int              `json:"person_id" url:"person_id,omitempty"`
+	Email               Optional[string] `json:"email" url:"email,omitempty"`
+	ShowNSFW            bool             `json:"show_nsfw" url:"show_nsfw,omitempty"`
+	Theme               string           `json:"theme" url:"theme,omitempty"`
+	DefaultSortType     int              `json:"default_sort_type" url:"default_sort_type,omitempty"`
+	DefaultListingType  int              `json:"default_listing_type" url:"default_listing_type,omitempty"`
+	InterfaceLanguage   string           `json:"interface_language" url:"interface_language,omitempty"`
+	ShowAvatars         bool             `json:"show_avatars" url:"show_avatars,omitempty"`
+	SendNotifications   bool             `json:"send_notifications_to_email" url:"send_notifications_to_email,omitempty"`
+	ValidatorTime       string           `json:"validator_time" url:"validator_time,omitempty"`
+	ShowBotAccounts     bool             `json:"show_bot_accounts" url:"show_bot_accounts,omitempty"`
+	ShowScores          bool             `json:"show_scores" url:"show_scores,omitempty"`
+	ShowReadPosts       bool             `json:"show_read_posts" url:"show_read_posts,omitempty"`
+	ShowNewPostNotifs   bool             `json:"show_new_post_notifs" url:"show_new_post_notifs,omitempty"`
+	EmailVerified       bool             `json:"email_verified" url:"email_verified,omitempty"`
+	AcceptedApplication bool             `json:"accepted_application" url:"accepted_application,omitempty"`
+}
+
+type PersonSafe struct {
+	ID             int              `json:"id" url:"id,omitempty"`
+	Name           string           `json:"name" url:"name,omitempty"`
+	DisplayName    Optional[string] `json:"display_name" url:"display_name,omitempty"`
+	Avatar         Optional[string] `json:"avatar" url:"avatar,omitempty"`
+	Banned         bool             `json:"banned" url:"banned,omitempty"`
+	Published      string           `json:"published" url:"published,omitempty"`
+	Updated        Optional[string] `json:"updated" url:"updated,omitempty"`
+	ActorID        string           `json:"actor_id" url:"actor_id,omitempty"`
+	Bio            Optional[string] `json:"bio" url:"bio,omitempty"`
+	Local          bool             `json:"local" url:"local,omitempty"`
+	Banner         Optional[string] `json:"banner" url:"banner,omitempty"`
+	Deleted        bool             `json:"deleted" url:"deleted,omitempty"`
+	InboxURL       string           `json:"inbox_url" url:"inbox_url,omitempty"`
+	SharedInboxURL Optional[string] `json:"shared_inbox_url" url:"shared_inbox_url,omitempty"`
+	MatrixUserID   Optional[string] `json:"matrix_user_id" url:"matrix_user_id,omitempty"`
+	Admin          bool             `json:"admin" url:"admin,omitempty"`
+	BotAccount     bool             `json:"bot_account" url:"bot_account,omitempty"`
+	BanExpires     Optional[string] `json:"ban_expires" url:"ban_expires,omitempty"`
+	InstanceID     int              `json:"instance_id" url:"instance_id,omitempty"`
+}
+
+type Site struct {
+	ID              int              `json:"id" url:"id,omitempty"`
+	Name            string           `json:"name" url:"name,omitempty"`
+	Sidebar         Optional[string] `json:"sidebar" url:"sidebar,omitempty"`
+	Published       string           `json:"published" url:"published,omitempty"`
+	Updated         Optional[string] `json:"updated" url:"updated,omitempty"`
+	Icon            Optional[string] `json:"icon" url:"icon,omitempty"`
+	Banner          Optional[string] `json:"banner" url:"banner,omitempty"`
+	Description     Optional[string] `json:"description" url:"description,omitempty"`
+	ActorID         string           `json:"actor_id" url:"actor_id,omitempty"`
+	LastRefreshedAt string           `json:"last_refreshed_at" url:"last_refreshed_at,omitempty"`
+	InboxURL        string           `json:"inbox_url" url:"inbox_url,omitempty"`
+	PrivateKey      Optional[string] `json:"private_key" url:"private_key,omitempty"`
+	PublicKey       string           `json:"public_key" url:"public_key,omitempty"`
+	InstanceID      int              `json:"instance_id" url:"instance_id,omitempty"`
+}
+
+type LocalSite struct {
+	ID                         int              `json:"id" url:"id,omitempty"`
+	SiteID                     int              `json:"site_id" url:"site_id,omitempty"`
+	SiteSetup                  bool             `json:"site_setup" url:"site_setup,omitempty"`
+	EnableDownvotes            bool             `json:"enable_downvotes" url:"enable_downvotes,omitempty"`
+	OpenRegistration           bool             `json:"open_registration" url:"open_registration,omitempty"`
+	EnableNSFW                 bool             `json:"enable_nsfw" url:"enable_nsfw,omitempty"`
+	AdminOnlyCommunityCreation bool             `json:"community_creation_admin_only" url:"community_creation_admin_only,omitempty"`
+	RequireEmailVerification   bool             `json:"require_email_verification" url:"require_email_verification,omitempty"`
+	RequireApplication         bool             `json:"require_application" url:"require_application,omitempty"`
+	ApplicationQuestion        Optional[string] `json:"application_question" url:"application_question,omitempty"`
+	PrivateInstance            bool             `json:"private_instance" url:"private_instance,omitempty"`
+	DefaultTheme               string           `json:"default_theme" url:"default_theme,omitempty"`
+	DefaultPostListingType     string           `json:"default_post_listing_type" url:"default_post_listing_type,omitempty"`
+	LegalInformation           Optional[string] `json:"legal_information" url:"legal_information,omitempty"`
+	HideModlogModNames         bool             `json:"hide_modlog_mod_names" url:"hide_modlog_mod_names,omitempty"`
+	ApplicationEmailAdmins     bool             `json:"application_email_admins" url:"application_email_admins,omitempty"`
+	SlurFilterRegex            Optional[string] `json:"slur_filter_regex" url:"slur_filter_regex,omitempty"`
+	ActorNameMaxLength         int              `json:"actor_name_max_length" url:"actor_name_max_length,omitempty"`
+	FederationEnabled          bool             `json:"federation_enabled" url:"federation_enabled,omitempty"`
+	FederationDebug            bool             `json:"federation_debug" url:"federation_debug,omitempty"`
+	FederationStrictAllowlist  bool             `json:"federation_strict_allowlist" url:"federation_strict_allowlist,omitempty"`
+	FederationRetryLimit       int              `json:"federation_http_fetch_retry_limit" url:"federation_http_fetch_retry_limit,omitempty"`
+	FederationWorkerCount      int              `json:"federation_worker_count" url:"federation_worker_count,omitempty"`
+	CaptchaEnabled             bool             `json:"captcha_enabled" url:"captcha_enabled,omitempty"`
+	CaptchaDifficulty          string           `json:"captcha_difficulty" url:"captcha_difficulty,omitempty"`
+	Published                  string           `json:"published" url:"published,omitempty"`
+	Updated                    Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type LocalSiteRateLimit struct {
+	ID                int              `json:"id" url:"id,omitempty"`
+	LocalSiteID       int              `json:"local_site_id" url:"local_site_id,omitempty"`
+	Message           int              `json:"message" url:"message,omitempty"`
+	MessagePerSecond  int              `json:"message_per_second" url:"message_per_second,omitempty"`
+	Post              int              `json:"post" url:"post,omitempty"`
+	PostPerSecond     int              `json:"post_per_second" url:"post_per_second,omitempty"`
+	Register          int              `json:"register" url:"register,omitempty"`
+	RegisterPerSecond int              `json:"register_per_second" url:"register_per_second,omitempty"`
+	Image             int              `json:"image" url:"image,omitempty"`
+	ImagePerSecond    int              `json:"image_per_second" url:"image_per_second,omitempty"`
+	Comment           int              `json:"comment" url:"comment,omitempty"`
+	CommentPerSecond  int              `json:"comment_per_second" url:"comment_per_second,omitempty"`
+	Search            int              `json:"search" url:"search,omitempty"`
+	SearchPerSecond   int              `json:"search_per_second" url:"search_per_second,omitempty"`
+	Published         string           `json:"published" url:"published,omitempty"`
+	Updated           Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type PrivateMessage struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	CreatorID   int              `json:"creator_id" url:"creator_id,omitempty"`
+	RecipientID int              `json:"recipient_id" url:"recipient_id,omitempty"`
+	Content     string           `json:"content" url:"content,omitempty"`
+	Deleted     bool             `json:"deleted" url:"deleted,omitempty"`
+	Read        bool             `json:"read" url:"read,omitempty"`
+	Published   string           `json:"published" url:"published,omitempty"`
+	Updated     Optional[string] `json:"updated" url:"updated,omitempty"`
+	ApID        string           `json:"ap_id" url:"ap_id,omitempty"`
+	Local       bool             `json:"local" url:"local,omitempty"`
+}
+
+type PostReport struct {
+	ID               int              `json:"id" url:"id,omitempty"`
+	CreatorID        int              `json:"creator_id" url:"creator_id,omitempty"`
+	PostID           int              `json:"post_id" url:"post_id,omitempty"`
+	OriginalPostName string           `json:"original_post_name" url:"original_post_name,omitempty"`
+	OriginalPostURL  Optional[string] `json:"original_post_url" url:"original_post_url,omitempty"`
+	OriginalPostBody Optional[string] `json:"original_post_body" url:"original_post_body,omitempty"`
+	Reason           string           `json:"reason" url:"reason,omitempty"`
+	Resolved         bool             `json:"resolved" url:"resolved,omitempty"`
+	ResolverID       Optional[int]    `json:"resolver_id" url:"resolver_id,omitempty"`
+	Published        string           `json:"published" url:"published,omitempty"`
+	Updated          Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type Post struct {
+	ID               int              `json:"id" url:"id,omitempty"`
+	Name             string           `json:"name" url:"name,omitempty"`
+	URL              Optional[string] `json:"url" url:"url,omitempty"`
+	Body             Optional[string] `json:"body" url:"body,omitempty"`
+	CreatorID        int              `json:"creator_id" url:"creator_id,omitempty"`
+	CommunityID      int              `json:"community_id" url:"community_id,omitempty"`
+	Removed          bool             `json:"removed" url:"removed,omitempty"`
+	Locked           bool             `json:"locked" url:"locked,omitempty"`
+	Published        string           `json:"published" url:"published,omitempty"`
+	Updated          Optional[string] `json:"updated" url:"updated,omitempty"`
+	Deleted          bool             `json:"deleted" url:"deleted,omitempty"`
+	NSFW             bool             `json:"nsfw" url:"nsfw,omitempty"`
+	Stickied         bool             `json:"stickied" url:"stickied,omitempty"`
+	EmbedTitle       Optional[string] `json:"embed_title" url:"embed_title,omitempty"`
+	EmbedDescription Optional[string] `json:"embed_description" url:"embed_description,omitempty"`
+	EmbedVideoURL    Optional[string] `json:"embed_video_url" url:"embed_video_url,omitempty"`
+	ThumbnailURL     Optional[string] `json:"thumbnail_url" url:"thumbnail_url,omitempty"`
+	ApID             string           `json:"ap_id" url:"ap_id,omitempty"`
+	Local            bool             `json:"local" url:"local,omitempty"`
+	LanguageID       int              `json:"language_id" url:"language_id,omitempty"`
+}
+
+type PasswordResetRequest struct {
+	ID             int    `json:"id" url:"id,omitempty"`
+	LocalUserID    int    `json:"local_user_id" url:"local_user_id,omitempty"`
+	TokenEncrypted string `json:"token_encrypted" url:"token_encrypted,omitempty"`
+	Published      string `json:"published" url:"published,omitempty"`
+}
+
+type ModRemovePost struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	ModPersonID int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	PostID      int              `json:"post_id" url:"post_id,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Removed     Optional[bool]   `json:"removed" url:"removed,omitempty"`
+	When        string           `json:"when_" url:"when_,omitempty"`
+}
+
+type ModLockPost struct {
+	ID          int            `json:"id" url:"id,omitempty"`
+	ModPersonID int            `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	PostID      int            `json:"post_id" url:"post_id,omitempty"`
+	Locked      Optional[bool] `json:"locked" url:"locked,omitempty"`
+	When        string         `json:"when_" url:"when_,omitempty"`
+}
+
+// ModStickyPost represents a post stickied by a moderator.
+type ModStickyPost struct {
+	ID          int            `json:"id" url:"id,omitempty"`
+	ModPersonID int            `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	PostID      int            `json:"post_id" url:"post_id,omitempty"`
+	Stickied    Optional[bool] `json:"stickied" url:"stickied,omitempty"`
+	When        string         `json:"when_" url:"when_,omitempty"`
+}
+
+// ModRemoveComment represents a comment removal by a moderator.
+type ModRemoveComment struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	ModPersonID int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	CommentID   int              `json:"comment_id" url:"comment_id,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Removed     Optional[bool]   `json:"removed" url:"removed,omitempty"`
+	When        string           `json:"when_" url:"when_,omitempty"`
+}
+
+// ModRemoveCommunity represents a community removal by a moderator.
+type ModRemoveCommunity struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	ModPersonID int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Removed     Optional[bool]   `json:"removed" url:"removed,omitempty"`
+	Expires     Optional[string] `json:"expires" url:"expires,omitempty"`
+	When        string           `json:"when_" url:"when_,omitempty"`
+}
+
+// ModBanFromCommunity represents a user being banned from a community by a moderator.
+type ModBanFromCommunity struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	ModPersonID   int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	OtherPersonID int              `json:"other_person_id" url:"other_person_id,omitempty"`
+	CommunityID   int              `json:"community_id" url:"community_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	Banned        Optional[bool]   `json:"banned" url:"banned,omitempty"`
+	Expires       Optional[string] `json:"expires" url:"expires,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+// ModBan represents a user being banned by a moderator.
+type ModBan struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	ModPersonID   int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	OtherPersonID int              `json:"other_person_id" url:"other_person_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	Banned        Optional[bool]   `json:"banned" url:"banned,omitempty"`
+	Expires       Optional[string] `json:"expires" url:"expires,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+// ModAddCommunity represents a user being added as a moderator of a community.
+type ModAddCommunity struct {
+	ID            int            `json:"id" url:"id,omitempty"`
+	ModPersonID   int            `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	OtherPersonID int            `json:"other_person_id" url:"other_person_id,omitempty"`
+	CommunityID   int            `json:"community_id" url:"community_id,omitempty"`
+	Removed       Optional[bool] `json:"removed" url:"removed,omitempty"`
+	When          string         `json:"when_" url:"when_,omitempty"`
+}
+
+// ModTransferCommunity represents a community being transferred to another moderator.
+type ModTransferCommunity struct {
+	ID            int            `json:"id" url:"id,omitempty"`
+	ModPersonID   int            `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	OtherPersonID int            `json:"other_person_id" url:"other_person_id,omitempty"`
+	CommunityID   int            `json:"community_id" url:"community_id,omitempty"`
+	Removed       Optional[bool] `json:"removed" url:"removed,omitempty"`
+	When          string         `json:"when_" url:"when_,omitempty"`
+}
+
+// ModAdd represents a user being added as a moderator.
+type ModAdd struct {
+	ID            int            `json:"id" url:"id,omitempty"`
+	ModPersonID   int            `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	OtherPersonID int            `json:"other_person_id" url:"other_person_id,omitempty"`
+	Removed       Optional[bool] `json:"removed" url:"removed,omitempty"`
+	When          string         `json:"when_" url:"when_,omitempty"`
+}
+
+type AdminPurgePerson struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	AdminPersonID int              `json:"admin_person_id" url:"admin_person_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+type AdminPurgeCommunity struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	AdminPersonID int              `json:"admin_person_id" url:"admin_person_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+type AdminPurgePost struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	AdminPersonID int              `json:"admin_person_id" url:"admin_person_id,omitempty"`
+	CommunityID   int              `json:"community_id" url:"community_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+type AdminPurgeComment struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	AdminPersonID int              `json:"admin_person_id" url:"admin_person_id,omitempty"`
+	PostID        int              `json:"post_id" url:"post_id,omitempty"`
+	Reason        Optional[string] `json:"reason" url:"reason,omitempty"`
+	When          string           `json:"when_" url:"when_,omitempty"`
+}
+
+type CommunitySafe struct {
+	ID                      int              `json:"id" url:"id,omitempty"`
+	Name                    string           `json:"name" url:"name,omitempty"`
+	Title                   string           `json:"title" url:"title,omitempty"`
+	Description             Optional[string] `json:"description" url:"description,omitempty"`
+	Removed                 bool             `json:"removed" url:"removed,omitempty"`
+	Published               string           `json:"published" url:"published,omitempty"`
+	Updated                 Optional[string] `json:"updated" url:"updated,omitempty"`
+	Deleted                 bool             `json:"deleted" url:"deleted,omitempty"`
+	NSFW                    bool             `json:"nsfw" url:"nsfw,omitempty"`
+	ActorID                 string           `json:"actor_id" url:"actor_id,omitempty"`
+	Local                   bool             `json:"local" url:"local,omitempty"`
+	Icon                    Optional[string] `json:"icon" url:"icon,omitempty"`
+	Banner                  Optional[string] `json:"banner" url:"banner,omitempty"`
+	Hidden                  bool             `json:"hidden" url:"hidden,omitempty"`
+	PostingRestrictedToMods bool             `json:"posting_restricted_to_mods" url:"posting_restricted_to_mods,omitempty"`
+	InstanceID              int              `json:"instance_id" url:"instance_id,omitempty"`
+}
+
+type CommentReport struct {
+	ID                  int              `json:"id" url:"id,omitempty"`
+	CreatorID           int              `json:"creator_id" url:"creator_id,omitempty"`
+	CommentID           int              `json:"comment_id" url:"comment_id,omitempty"`
+	OriginalCommentText string           `json:"original_comment_text" url:"original_comment_text,omitempty"`
+	Reason              string           `json:"reason" url:"reason,omitempty"`
+	Resolved            bool             `json:"resolved" url:"resolved,omitempty"`
+	ResolverID          Optional[int]    `json:"resolver_id" url:"resolver_id,omitempty"`
+	Published           string           `json:"published" url:"published,omitempty"`
+	Updated             Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type Comment struct {
+	ID            int              `json:"id" url:"id,omitempty"`
+	CreatorID     int              `json:"creator_id" url:"creator_id,omitempty"`
+	PostID        int              `json:"post_id" url:"post_id,omitempty"`
+	Content       string           `json:"content" url:"content,omitempty"`
+	Removed       bool             `json:"removed" url:"removed,omitempty"`
+	Published     string           `json:"published" url:"published,omitempty"`
+	Updated       Optional[string] `json:"updated" url:"updated,omitempty"`
+	Deleted       bool             `json:"deleted" url:"deleted,omitempty"`
+	APID          string           `json:"ap_id" url:"ap_id,omitempty"`
+	Local         bool             `json:"local" url:"local,omitempty"`
+	Path          string           `json:"path" url:"path,omitempty"`
+	Distinguished bool             `json:"distinguished" url:"distinguished,omitempty"`
+	LanguageID    int              `json:"language_id" url:"language_id,omitempty"`
+}
+
+type PersonMention struct {
+	ID          int    `json:"id" url:"id,omitempty"`
+	RecipientID int    `json:"recipient_id" url:"recipient_id,omitempty"`
+	CommentID   int    `json:"comment_id" url:"comment_id,omitempty"`
+	Read        bool   `json:"read" url:"read,omitempty"`
+	Published   string `json:"published" url:"published,omitempty"`
+}
+
+type Language struct {
+	ID   int    `json:"id" url:"id,omitempty"`
+	Code string `json:"code" url:"code,omitempty"`
+	Name string `json:"name" url:"name,omitempty"`
+}
+
+type PrivateMessageReport struct {
+	ID               int              `json:"id" url:"id,omitempty"`
+	CreatorID        int              `json:"creator_id" url:"creator_id,omitempty"`
+	PrivateMessageID int              `json:"private_message_id" url:"private_message_id,omitempty"`
+	OriginalPMText   string           `json:"original_pm_text" url:"original_pm_text,omitempty"`
+	Reason           string           `json:"reason" url:"reason,omitempty"`
+	Resolved         bool             `json:"resolved" url:"resolved,omitempty"`
+	ResolverID       Optional[int]    `json:"resolver_id" url:"resolver_id,omitempty"`
+	Published        string           `json:"published" url:"published,omitempty"`
+	Updated          Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type RegistrationApplication struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	LocalUserID int              `json:"local_user_id" url:"local_user_id,omitempty"`
+	Answer      string           `json:"answer" url:"answer,omitempty"`
+	AdminID     Optional[int]    `json:"admin_id" url:"admin_id,omitempty"`
+	DenyReason  Optional[string] `json:"deny_reason" url:"deny_reason,omitempty"`
+	Published   string           `json:"published" url:"published,omitempty"`
+}
+
+type ModHideCommunityView struct {
+	ModHideCommunity ModHideCommunity     `json:"mod_hide_community" url:"mod_hide_community,omitempty"`
+	Admin            Optional[PersonSafe] `json:"admin" url:"admin,omitempty"`
+	Community        CommunitySafe        `json:"community" url:"community,omitempty"`
+}
+
+type ModHideCommunity struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	CommunityID int              `json:"community_id" url:"community_id,omitempty"`
+	ModPersonID int              `json:"mod_person_id" url:"mod_person_id,omitempty"`
+	Reason      Optional[string] `json:"reason" url:"reason,omitempty"`
+	Hidden      Optional[bool]   `json:"hidden" url:"hidden,omitempty"`
+	When        time.Time        `json:"when_" url:"when_,omitempty"`
+}
+
+type CommentReply struct {
+	ID          int    `json:"id" url:"id,omitempty"`
+	RecipientID int    `json:"recipient_id" url:"recipient_id,omitempty"`
+	CommentID   int    `json:"comment_id" url:"comment_id,omitempty"`
+	Read        bool   `json:"read" url:"read,omitempty"`
+	Published   string `json:"published" url:"published,omitempty"`
+}

types/types.go

@@ -0,0 +1,33 @@
+package types
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+)
+
+type LemmyResponse struct {
+	Error Optional[string] `json:"error" url:"error,omitempty"`
+}
+
+type HTTPError struct {
+	Code int
+}
+
+func (he HTTPError) Error() string {
+	return fmt.Sprintf("%d %s", he.Code, http.StatusText(he.Code))
+}
+
+type LemmyError struct {
+	ErrStr string
+	Code   int
+}
+
+func (le LemmyError) Error() string {
+	return fmt.Sprintf("%d %s: %s", le.Code, http.StatusText(le.Code), le.ErrStr)
+}
+
+type LemmyWebSocketMsg struct {
+	Op   UserOperation   `json:"op"`
+	Data json.RawMessage `json:"data"`
+}

types/views.go

@@ -0,0 +1,254 @@
+package types
+
+type PersonViewSafe struct {
+	Person PersonSafe       `json:"person" url:"person,omitempty"`
+	Counts PersonAggregates `json:"counts" url:"counts,omitempty"`
+}
+
+type PersonMentionView struct {
+	PersonMention              PersonMention     `json:"person_mention" url:"person_mention,omitempty"`
+	Comment                    Comment           `json:"comment" url:"comment,omitempty"`
+	Creator                    PersonSafe        `json:"creator" url:"creator,omitempty"`
+	Post                       Post              `json:"post" url:"post,omitempty"`
+	CommunitySafe              CommunitySafe     `json:"community_safe" url:"community_safe,omitempty"`
+	Recipient                  PersonSafe        `json:"recipient" url:"recipient,omitempty"`
+	Counts                     CommentAggregates `json:"counts" url:"counts,omitempty"`
+	CreatorBannedFromCommunity bool              `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	Subscribed                 bool              `json:"subscribed" url:"subscribed,omitempty"`
+	Saved                      bool              `json:"saved" url:"saved,omitempty"`
+	CreatorBlocked             bool              `json:"creator_blocked" url:"creator_blocked,omitempty"`
+	MyVote                     Optional[int]     `json:"my_vote" url:"my_vote,omitempty"`
+}
+
+type LocalUserSettingsView struct {
+	LocalUserSettings LocalUserSettings `json:"local_user_settings" url:"local_user_settings,omitempty"`
+	Person            PersonSafe        `json:"person" url:"person,omitempty"`
+	Counts            PersonAggregates  `json:"counts" url:"counts,omitempty"`
+}
+
+type SiteView struct {
+	Site               Site                `json:"site" url:"site,omitempty"`
+	LocalSite          LocalSite           `json:"local_site" url:"local_site,omitempty"`
+	LocalSiteRateLimit LocalSiteRateLimit  `json:"local_site_rate_limit" url:"local_site_rate_limit,omitempty"`
+	Taglines           Optional[[]Tagline] `json:"taglines" url:"taglines,omitempty"`
+	Counts             SiteAggregates      `json:"counts" url:"counts,omitempty"`
+}
+
+type PrivateMessageView struct {
+	PrivateMessage PrivateMessage `json:"private_message" url:"private_message,omitempty"`
+	Creator        PersonSafe     `json:"creator" url:"creator,omitempty"`
+	Recipient      PersonSafe     `json:"recipient" url:"recipient,omitempty"`
+}
+
+type PostView struct {
+	Post                       Post           `json:"post" url:"post,omitempty"`
+	Creator                    PersonSafe     `json:"creator" url:"creator,omitempty"`
+	Community                  CommunitySafe  `json:"community" url:"community,omitempty"`
+	CreatorBannedFromCommunity bool           `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	Counts                     PostAggregates `json:"counts" url:"counts,omitempty"`
+	Subscribed                 bool           `json:"subscribed" url:"subscribed,omitempty"`
+	Saved                      bool           `json:"saved" url:"saved,omitempty"`
+	Read                       bool           `json:"read" url:"read,omitempty"`
+	CreatorBlocked             bool           `json:"creator_blocked" url:"creator_blocked,omitempty"`
+	MyVote                     Optional[int]  `json:"my_vote" url:"my_vote,omitempty"`
+	UnreadComments             int            `json:"unread_comments" url:"unread_comments,omitempty"`
+}
+
+type PostReportView struct {
+	PostReport                 PostReport           `json:"post_report" url:"post_report,omitempty"`
+	Post                       Post                 `json:"post" url:"post,omitempty"`
+	Community                  CommunitySafe        `json:"community" url:"community,omitempty"`
+	Creator                    PersonSafe           `json:"creator" url:"creator,omitempty"`
+	PostCreator                PersonSafe           `json:"post_creator" url:"post_creator,omitempty"`
+	CreatorBannedFromCommunity bool                 `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	MyVote                     Optional[int]        `json:"my_vote" url:"my_vote,omitempty"`
+	Counts                     PostAggregates       `json:"counts" url:"counts,omitempty"`
+	Resolver                   Optional[PersonSafe] `json:"resolver" url:"resolver,omitempty"`
+}
+
+type CommentView struct {
+	Comment                    Comment           `json:"comment" url:"comment,omitempty"`
+	Creator                    PersonSafe        `json:"creator" url:"creator,omitempty"`
+	Post                       Post              `json:"post" url:"post,omitempty"`
+	Community                  CommunitySafe     `json:"community" url:"community,omitempty"`
+	Counts                     CommentAggregates `json:"counts" url:"counts,omitempty"`
+	CreatorBannedFromCommunity bool              `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	Subscribed                 bool              `json:"subscribed" url:"subscribed,omitempty"`
+	Saved                      bool              `json:"saved" url:"saved,omitempty"`
+	CreatorBlocked             bool              `json:"creator_blocked" url:"creator_blocked,omitempty"`
+	MyVote                     Optional[int]     `json:"my_vote" url:"my_vote,omitempty"`
+}
+
+type CommentReportView struct {
+	CommentReport              CommentReport        `json:"comment_report" url:"comment_report,omitempty"`
+	Comment                    Comment              `json:"comment" url:"comment,omitempty"`
+	Post                       Post                 `json:"post" url:"post,omitempty"`
+	CommunitySafe              CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+	Creator                    PersonSafe           `json:"creator" url:"creator,omitempty"`
+	CommentCreator             PersonSafe           `json:"comment_creator" url:"comment_creator,omitempty"`
+	Counts                     CommentAggregates    `json:"counts" url:"counts,omitempty"`
+	CreatorBannedFromCommunity bool                 `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	MyVote                     Optional[int]        `json:"my_vote" url:"my_vote,omitempty"`
+	Resolver                   Optional[PersonSafe] `json:"resolver" url:"resolver,omitempty"`
+}
+
+type ModAddCommunityView struct {
+	ModAddCommunity ModAddCommunity      `json:"mod_add_community" url:"mod_add_community,omitempty"`
+	Moderator       Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	CommunitySafe   CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+	ModdedPerson    PersonSafe           `json:"modded_person" url:"modded_person,omitempty"`
+}
+
+type ModTransferCommunityView struct {
+	ModTransferCommunity ModTransferCommunity `json:"mod_transfer_community" url:"mod_transfer_community,omitempty"`
+	Moderator            Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	CommunitySafe        CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+	ModdedPerson         PersonSafe           `json:"modded_person" url:"modded_person,omitempty"`
+}
+
+type ModAddView struct {
+	ModAdd       ModAdd               `json:"mod_add" url:"mod_add,omitempty"`
+	Moderator    Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	ModdedPerson PersonSafe           `json:"modded_person" url:"modded_person,omitempty"`
+}
+
+type ModBanFromCommunityView struct {
+	ModBanFromCommunity ModBanFromCommunity  `json:"mod_ban_from_community" url:"mod_ban_from_community,omitempty"`
+	Moderator           Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	CommunitySafe       CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+	BannedPerson        PersonSafe           `json:"banned_person" url:"banned_person,omitempty"`
+}
+
+type ModBanView struct {
+	ModBan       ModBan               `json:"mod_ban" url:"mod_ban,omitempty"`
+	Moderator    Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	BannedPerson PersonSafe           `json:"banned_person" url:"banned_person,omitempty"`
+}
+
+type ModLockPostView struct {
+	ModLockPost   ModLockPost          `json:"mod_lock_post" url:"mod_lock_post,omitempty"`
+	Moderator     Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	Post          Post                 `json:"post" url:"post,omitempty"`
+	CommunitySafe CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type ModRemoveCommentView struct {
+	ModRemoveComment ModRemoveComment     `json:"mod_remove_comment" url:"mod_remove_comment,omitempty"`
+	Moderator        Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	Comment          Comment              `json:"comment" url:"comment,omitempty"`
+	Commenter        PersonSafe           `json:"commenter" url:"commenter,omitempty"`
+	Post             Post                 `json:"post" url:"post,omitempty"`
+	CommunitySafe    CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type ModRemoveCommunityView struct {
+	ModRemoveCommunity ModRemoveCommunity   `json:"mod_remove_community" url:"mod_remove_community,omitempty"`
+	Moderator          Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	CommunitySafe      CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type ModRemovePostView struct {
+	ModRemovePost ModRemovePost        `json:"mod_remove_post" url:"mod_remove_post,omitempty"`
+	Moderator     Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	Post          Post                 `json:"post" url:"post,omitempty"`
+	CommunitySafe CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type ModStickyPostView struct {
+	ModStickyPost ModStickyPost        `json:"mod_sticky_post" url:"mod_sticky_post,omitempty"`
+	Moderator     Optional[PersonSafe] `json:"moderator" url:"moderator,omitempty"`
+	Post          Post                 `json:"post" url:"post,omitempty"`
+	CommunitySafe CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type AdminPurgeCommunityView struct {
+	AdminPurgeCommunity AdminPurgeCommunity  `json:"admin_purge_community" url:"admin_purge_community,omitempty"`
+	Admin               Optional[PersonSafe] `json:"admin" url:"admin,omitempty"`
+}
+
+type AdminPurgePersonView struct {
+	AdminPurgePerson AdminPurgePerson     `json:"admin_purge_person" url:"admin_purge_person,omitempty"`
+	Admin            Optional[PersonSafe] `json:"admin" url:"admin,omitempty"`
+}
+
+type AdminPurgePostView struct {
+	AdminPurgePost AdminPurgePost       `json:"admin_purge_post" url:"admin_purge_post,omitempty"`
+	Admin          Optional[PersonSafe] `json:"admin" url:"admin,omitempty"`
+	CommunitySafe  CommunitySafe        `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type AdminPurgeCommentView struct {
+	AdminPurgeComment AdminPurgeComment    `json:"admin_purge_comment" url:"admin_purge_comment,omitempty"`
+	Admin             Optional[PersonSafe] `json:"admin" url:"admin,omitempty"`
+	Post              Post                 `json:"post" url:"post,omitempty"`
+}
+
+type CommunityFollowerView struct {
+	CommunitySafe CommunitySafe `json:"community_safe" url:"community_safe,omitempty"`
+	Follower      PersonSafe    `json:"follower" url:"follower,omitempty"`
+}
+
+type CommunityBlockView struct {
+	PersonSafe    PersonSafe    `json:"person_safe" url:"person_safe,omitempty"`
+	CommunitySafe CommunitySafe `json:"community_safe" url:"community_safe,omitempty"`
+}
+
+type CommunityModeratorView struct {
+	CommunitySafe CommunitySafe `json:"community_safe" url:"community_safe,omitempty"`
+	Moderator     PersonSafe    `json:"moderator" url:"moderator,omitempty"`
+}
+
+type CommunityPersonBanView struct {
+	CommunitySafe CommunitySafe `json:"community_safe" url:"community_safe,omitempty"`
+	Person        PersonSafe    `json:"person" url:"person,omitempty"`
+}
+
+type PersonBlockView struct {
+	PersonSafe PersonSafe `json:"person_safe" url:"person_safe,omitempty"`
+	Target     PersonSafe `json:"target" url:"target,omitempty"`
+}
+
+type CommunityView struct {
+	CommunitySafe CommunitySafe       `json:"community_safe" url:"community_safe,omitempty"`
+	Subscribed    bool                `json:"subscribed" url:"subscribed,omitempty"`
+	Blocked       bool                `json:"blocked" url:"blocked,omitempty"`
+	Counts        CommunityAggregates `json:"counts" url:"counts,omitempty"`
+}
+
+type RegistrationApplicationView struct {
+	RegistrationApplication RegistrationApplication `json:"registration_application" url:"registration_application,omitempty"`
+	CreatorLocalUser        LocalUserSettings       `json:"creator_local_user" url:"creator_local_user,omitempty"`
+	Creator                 PersonSafe              `json:"creator" url:"creator,omitempty"`
+	Admin                   Optional[PersonSafe]    `json:"admin" url:"admin,omitempty"`
+}
+
+type PrivateMessageReportView struct {
+	PrivateMessageReport  PrivateMessageReport `json:"private_message_report" url:"private_message_report,omitempty"`
+	PrivateMessage        PrivateMessage       `json:"private_message" url:"private_message,omitempty"`
+	PrivateMessageCreator PersonSafe           `json:"private_message_creator" url:"private_message_creator,omitempty"`
+	Creator               PersonSafe           `json:"creator" url:"creator,omitempty"`
+	Resolver              Optional[PersonSafe] `json:"resolver" url:"resolver,omitempty"`
+}
+
+type Tagline struct {
+	ID          int              `json:"id" url:"id,omitempty"`
+	LocalSiteID int              `json:"local_site_id" url:"local_site_id,omitempty"`
+	Content     string           `json:"content" url:"content,omitempty"`
+	Published   string           `json:"published" url:"published,omitempty"`
+	Updated     Optional[string] `json:"updated" url:"updated,omitempty"`
+}
+
+type CommentReplyView struct {
+	CommentReply               CommentReply      `json:"comment_reply" url:"comment_reply,omitempty"`
+	Comment                    Comment           `json:"comment" url:"comment,omitempty"`
+	Creator                    PersonSafe        `json:"creator" url:"creator,omitempty"`
+	Post                       Post              `json:"post" url:"post,omitempty"`
+	Community                  CommunitySafe     `json:"community" url:"community,omitempty"`
+	Recipient                  PersonSafe        `json:"recipient" url:"recipient,omitempty"`
+	Counts                     CommentAggregates `json:"counts" url:"counts,omitempty"`
+	CreatorBannedFromCommunity bool              `json:"creator_banned_from_community" url:"creator_banned_from_community,omitempty"`
+	Subscribed                 bool              `json:"subscribed" url:"subscribed,omitempty"`
+	Saved                      bool              `json:"saved" url:"saved,omitempty"`
+	CreatorBlocked             bool              `json:"creator_blocked" url:"creator_blocked,omitempty"`
+	MyVote                     Optional[int]     `json:"my_vote" url:"my_vote,omitempty"`
+}

types/websocket.go

@@ -0,0 +1,37 @@
+package types
+
+type UserJoin struct {
+	Auth string `json:"auth"`
+}
+
+type UserJoinResponse struct {
+	Joined bool `json:"joined"`
+	LemmyResponse
+}
+
+type CommunityJoin struct {
+	CommunityID int `json:"community_id"`
+}
+
+type CommunityJoinResponse struct {
+	Joined bool `json:"joined"`
+	LemmyResponse
+}
+
+type ModJoin struct {
+	CommunityID int `json:"community_id"`
+}
+
+type ModJoinResponse struct {
+	Joined bool `json:"joined"`
+	LemmyResponse
+}
+
+type PostJoin struct {
+	PostID int `json:"post_id"`
+}
+
+type PostJoinResponse struct {
+	Joined bool `json:"joined"`
+	LemmyResponse
+}

websocket.go

@@ -0,0 +1,132 @@
+package lemmy
+
+import (
+	"context"
+	"encoding/json"
+	"net/http"
+	"net/url"
+	"reflect"
+	"time"
+
+	"github.com/recws-org/recws"
+	"go.arsenm.dev/go-lemmy/types"
+)
+
+type authData struct {
+	Auth string `json:"auth"`
+}
+
+type WSClient struct {
+	conn    *recws.RecConn
+	baseURL *url.URL
+	respCh  chan types.LemmyWebSocketMsg
+	errCh   chan error
+	token   string
+}
+
+func NewWebSocket(baseURL string) (*WSClient, error) {
+	ws := &recws.RecConn{
+		KeepAliveTimeout: 10 * time.Second,
+	}
+
+	u, err := url.Parse(baseURL)
+	if err != nil {
+		return nil, err
+	}
+	u = u.JoinPath("/api/v3")
+
+	ws.Dial(u.JoinPath("ws").String(), nil)
+
+	out := &WSClient{
+		conn:    ws,
+		baseURL: u,
+		respCh:  make(chan types.LemmyWebSocketMsg, 10),
+		errCh:   make(chan error, 10),
+	}
+
+	go func() {
+		for {
+			var msg types.LemmyWebSocketMsg
+			err = ws.ReadJSON(&msg)
+			if err != nil {
+				out.errCh <- err
+				continue
+			}
+			out.respCh <- msg
+		}
+	}()
+
+	return out, nil
+}
+
+func (c *WSClient) Login(ctx context.Context, l types.Login) error {
+	u := &url.URL{}
+	*u = *c.baseURL
+
+	if u.Scheme == "ws" {
+		u.Scheme = "http"
+	} else if u.Scheme == "wss" {
+		u.Scheme = "https"
+	}
+
+	hc := &Client{baseURL: u, client: http.DefaultClient}
+	err := hc.Login(ctx, l)
+	if err != nil {
+		return err
+	}
+	c.token = hc.token
+	return nil
+}
+
+func (c *WSClient) Request(op types.UserOperation, data any) error {
+	if data == nil {
+		data = authData{}
+	}
+
+	data = c.setAuth(data)
+
+	d, err := json.Marshal(data)
+	if err != nil {
+		return err
+	}
+
+	return c.conn.WriteJSON(types.LemmyWebSocketMsg{
+		Op:   op,
+		Data: d,
+	})
+}
+
+func (c *WSClient) Responses() <-chan types.LemmyWebSocketMsg {
+	return c.respCh
+}
+
+func (c *WSClient) Errors() <-chan error {
+	return c.errCh
+}
+
+func (c *WSClient) setAuth(data any) any {
+	val := reflect.New(reflect.TypeOf(data))
+	val.Elem().Set(reflect.ValueOf(data))
+
+	authField := val.Elem().FieldByName("Auth")
+	if !authField.IsValid() {
+		return data
+	}
+
+	switch authField.Type().String() {
+	case "string":
+		authField.SetString(c.token)
+	case "types.Optional[string]":
+		setMtd := authField.MethodByName("Set")
+		out := setMtd.Call([]reflect.Value{reflect.ValueOf(c.token)})
+		authField.Set(out[0])
+	default:
+		return data
+	}
+
+	return val.Elem().Interface()
+}
+
+func DecodeResponse(data json.RawMessage, out any) error {
+	return json.Unmarshal(data, out)
+}