client

func (*APIError) Error ¶

func (e *APIError) Error() string

Error implements the error interface.

func (*Client) CreateComment ¶ added in v0.3.0

func (c *Client) CreateComment(
	ctx context.Context,
	contentID int,
	req CreateCommentRequest,
) (json.RawMessage, json.RawMessage, error)

CreateComment POSTs a comment to /api/v1/content/{id}/comments and returns the decoded data and meta payloads, or an *APIError on failure.

func (*Client) CreateContent ¶

func (c *Client) CreateContent(
	ctx context.Context,
	req CreateContentRequest,
) (json.RawMessage, json.RawMessage, error)

CreateContent POSTs a content-create request to /api/v1/content and returns the decoded data and meta payloads, or an *APIError on failure.

func (*Client) DeleteComment ¶ added in v0.3.0

func (c *Client) DeleteComment(
	ctx context.Context,
	contentID int,
	commentID int,
) (json.RawMessage, json.RawMessage, error)

DeleteComment sends DELETE /api/v1/content/{id}/comments/{commentId}. A 204 No Content success returns (nil, nil, nil); a 404 or other 4xx/5xx returns an *APIError. An admin key may delete any comment; a non-admin key only its own (the server returns 404 for a comment the caller does not own, no disclosure).

func (*Client) DeleteContent ¶

func (c *Client) DeleteContent(
	ctx context.Context,
	id int,
) (json.RawMessage, json.RawMessage, error)

DeleteContent sends DELETE /api/v1/content/{id}. A 204 No Content success returns (nil, nil, nil); a 404 or other 4xx/5xx returns an *APIError.

func (*Client) GetContent ¶

func (c *Client) GetContent(
	ctx context.Context,
	id int,
) (json.RawMessage, json.RawMessage, error)

GetContent sends GET /api/v1/content/{id} and returns the decoded data and meta payloads, or an *APIError on failure.

func (*Client) GetMedia ¶

func (c *Client) GetMedia(
	ctx context.Context,
	id int,
) (json.RawMessage, json.RawMessage, error)

GetMedia sends GET /api/v1/media/{id} and returns the decoded data and meta payloads, or an *APIError on failure.

func (*Client) ListComments ¶ added in v0.3.0

func (c *Client) ListComments(
	ctx context.Context,
	contentID int,
) (json.RawMessage, json.RawMessage, error)

ListComments sends GET /api/v1/content/{id}/comments and returns the decoded data (a bare array of comment projections) and meta, or an *APIError on failure.

func (*Client) ListContent ¶

func (c *Client) ListContent(
	ctx context.Context,
	limit int,
	cursor string,
	filters ListContentFilters,
) (json.RawMessage, json.RawMessage, error)

ListContent sends GET /api/v1/content?limit=&cursor=&tag=&language=&status=&post_type=&author=&search= and returns the decoded data (a bare array of content projections) and meta (with pagination), or an *APIError on failure. A limit of 0 (or negative) is passed as "no limit" (the server uses its default); an empty cursor is passed as "no cursor" (the first page). Each non-empty filter field emits its query key; an empty field is omitted entirely so the wire stays minimal. Tags is expanded into repeated ?tag= keys (one per tag) so the server can AND-of-tags.

func (*Client) ListMedia ¶

func (c *Client) ListMedia(
	ctx context.Context,
	limit int,
	cursor string,
) (json.RawMessage, json.RawMessage, error)

ListMedia sends GET /api/v1/media?limit=&cursor= and returns the decoded data (a bare array of media projections) and meta (with pagination), or an *APIError on failure. A limit of 0 (or negative) is passed as "no limit" (the server uses its default); an empty cursor is passed as "no cursor" (the first page).

func (*Client) PublishContent ¶

func (c *Client) PublishContent(
	ctx context.Context,
	id int,
) (json.RawMessage, json.RawMessage, error)

PublishContent sends POST /api/v1/content/{id}/publish with an empty body and returns the decoded data and meta payloads, or an *APIError on failure. The server endpoint is idempotent: publishing an already-published post returns 200 with the current projection. Ownership is enforced server-side; a non-admin non-owner call returns 404 (not 403, no disclosure).

func (*Client) SetSystemFields ¶ added in v0.2.0

func (c *Client) SetSystemFields(
	ctx context.Context,
	id int,
	systemFields map[string]any,
) (json.RawMessage, json.RawMessage, error)

SetSystemFields sends PUT /api/v1/content/{id}/system-fields with the given system field key/value pairs and returns the decoded data and meta payloads, or an *APIError on failure. System fields are admin-managed metadata (e.g. editorial_status, internal_notes), so the server returns 403 FORBIDDEN unless the API key belongs to an Admin; an unknown key returns ErrUnknownSystemFieldKey and a value that fails the field schema returns ErrSystemFieldValidation, both surfaced as a 400 VALIDATION_ERROR.

func (*Client) UnpublishContent ¶

func (c *Client) UnpublishContent(
	ctx context.Context,
	id int,
) (json.RawMessage, json.RawMessage, error)

UnpublishContent sends POST /api/v1/content/{id}/unpublish with an empty body and returns the decoded data and meta payloads, or an *APIError on failure. The server endpoint is idempotent: unpublishing an already-draft post returns 200 with the current projection. Same ownership contract as PublishContent.

func (*Client) UpdateCommentStatus ¶ added in v0.3.0

func (c *Client) UpdateCommentStatus(
	ctx context.Context,
	contentID int,
	commentID int,
	status string,
) (json.RawMessage, json.RawMessage, error)

UpdateCommentStatus sends PUT /api/v1/content/{id}/comments/{commentId}/status with the given status (approved/rejected/spam) and returns the decoded data and meta payloads, or an *APIError on failure. Admin only: the server returns 403 FORBIDDEN to a non-admin key.

func (*Client) UpdateContent ¶

func (c *Client) UpdateContent(
	ctx context.Context,
	id int,
	req UpdateContentRequest,
) (json.RawMessage, json.RawMessage, error)

UpdateContent sends PUT /api/v1/content/{id} with the given request body and returns the decoded data and meta payloads, or an *APIError on failure. The request body is the same shape as CreateContent. The server's update handler preserves the server-managed fields (SEO metadata — metaDescription / ogTitle / ogDescription, allowComments, translationGroupId) from the existing item, so a partial update that omits them is safe; postType / tags / language are now settable and forwarded as-given (the server validates them).

func (*Client) UploadMedia ¶

func (c *Client) UploadMedia(
	ctx context.Context,
	req UploadMediaRequest,
) (json.RawMessage, json.RawMessage, error)

UploadMedia sends POST /api/v1/media as multipart/form-data with a `file` part and an optional `metadata` JSON part, then returns the decoded data and meta payloads (the server returns 200 with the media projection in the data envelope) or an *APIError on failure.

The multipart body is buffered in memory; the server enforces its own size limit at r.ParseMultipartForm. The 204/304+envelope defenses from doRequest apply unchanged.