jsonapi

type API struct {
	Schema *Schema
}

type AnyResourceType interface {
	// contains filtered or unexported methods
}

type AttributeDefinition[T any] struct {
	// Defines the type and implementation of the attribute.
	Resolver AttributeResolver[T]
}

type AttributeResolver[T any] interface {
	// Resolve implementations should compute a value and return a JSON-serializable object.
	ResolveAttribute(ctx context.Context, resource T) (any, *types.Error)
}

type RelationshipDefinition[T any] struct {
	// Defines the type and implementation of the relationship.
	Resolver RelationshipResolver[T]
}

type RelationshipResolver[T any] interface {
	// Implementations should compute a value and return a `types.Relationship` or an error. The
	// relationship will automatically have links added to it, but resolvers may add additional
	// links to the result.
	//
	// If `dataRequested` is false, resolvers may choose to omit the `Data` field from the result.
	//
	// Generally you should use `ToOneRelationshipResolver` or `ToManyRelationshipResolver` instead
	// of implementing this directly.
	ResolveRelationship(ctx context.Context, resource T, dataRequested bool, params url.Values) (types.Relationship, *types.Error)

	// Implementations should add the given members and return a `types.Relationship` or an error.
	// The relationship will automatically have links added to it, but resolvers may add additional
	// links to the result.
	AddRelationshipMembers(ctx context.Context, resource T, members []types.ResourceId) (types.Relationship, *types.Error)

	// Implementations should remove the given members and return a `types.Relationship` or an error.
	// The relationship will automatically have links added to it, but resolvers may add additional
	// links to the result.
	RemoveRelationshipMembers(ctx context.Context, resource T, members []types.ResourceId) (types.Relationship, *types.Error)
}

type ResourceType[T any] struct {
	// The attributes of the resource type. These must not overlap with the resource relationships.
	Attributes map[string]*AttributeDefinition[T]

	// The relationships of the resource type. These must not overlap with the resource attributes.
	Relationships map[string]*RelationshipDefinition[T]

	// If given, the resource can be directly referenced using an id, e.g. via the /{type_name}/{id}
	// endpoint.
	Get func(ctx context.Context, id string) (T, *types.Error)

	// If given, the resource can be updated, e.g. via the PATCH method on the /{type_name}/{id}
	// endpoint.
	//
	// Relationship values are either `nil`, `types.ResourceId`, or `[]types.ResourceId`.
	Patch func(ctx context.Context, id string, attributes map[string]json.RawMessage, relationships map[string]any) (T, *types.Error)

	// If given, the resource can be created, e.g. via the POST method on the /{type_name} endpoint.
	//
	// Relationship values are either `nil`, `types.ResourceId`, or `[]types.ResourceId`.
	Create func(ctx context.Context, attributes map[string]json.RawMessage, relationships map[string]any) (T, types.ResourceId, *types.Error)

	// If given, the resource can be deleted via the DELETE method on the /{type_name}/{id}
	// endpoint.
	Delete func(ctx context.Context, id string) *types.Error
}

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

type SchemaDefinition struct {
	// The schema's resource types. Convention is for names to be lowercase, plural name such as
	// "articles".
	ResourceTypes map[string]AnyResourceType
}

type ToManyRelationshipResolver[T any] struct {
	ResolveByDefault bool

	Resolve func(ctx context.Context, resource T) ([]types.ResourceId, *types.Error)

	AddMembers func(ctx context.Context, resource T, members []types.ResourceId) ([]types.ResourceId, *types.Error)

	RemoveMembers func(ctx context.Context, resource T, members []types.ResourceId) ([]types.ResourceId, *types.Error)
}

type ToOneRelationshipResolver[T any] struct {
	ResolveByDefault bool

	Resolve func(ctx context.Context, resource T) (*types.ResourceId, *types.Error)
}