content-cms — IMP FORGE

Content management with publishing workflow and block-based content

Tier	content
Role	unclassified (baselined)
Path	`crates/content/cms`
Edition	2021
Targets	content_cms
Public items	225 across 10 modules
Tests	160

What it is for

# content-cms

Content management library crates with publishing workflow and block-based content.

Core Concepts

Content Pages: Support both regular pages and blog posts
Publishing Workflow: Draft → Published → Archived with immutable snapshots
Block-Based Content: Extensible block system for flexible layouts
Access Control: Public, Authenticated, Role-based, and Entitlement levels
SEO Support: Metadata, Open Graph, canonical URLs, robots directives

Example

use content_cms::{
ContentPage, ContentBlock, BlogCategory, Redirect,
PageType, PageStatus, AccessLevel,
snapshot::publish_page,
};
use uuid::Uuid;

// Create a blog post
let mut post = ContentPage::builder()
.slug("hello-world")
.title("Hello World")
.post()
.excerpt("My first blog post")
.seo_description("An introduction to our blog")
.build();

// Add content blocks
let blocks = vec
ContentBlock::builder()
.page(post.id)
.hero()
.data(serde_json::json!({
"title": "Welcome to My Blog",
"background_url": "/images/hero.jpg"
}))
.sequence(0)
.build(),
ContentBlock::builder()
.page(post.id)
.rich_text()
.data(serde_json::json!({
"content": "<p>This is my first post...</p>"
}))
.sequence(1)
.build(),
;

// Publish the post
let publisher_id = Uuid::new_v4();
let snapshot = publish_page(&mut post, &blocks, publisher_id);

assert!(post.is_published());
assert!(snapshot.verify_checksum());

Capabilities

`ContentBlock:ContentBlock`

ContentBlock model for block-based page content.

Item
`pub struct ContentBlock`

`ContentBlock:builder`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn builder() -> ContentBlockBuilder`

`ContentBlock:created`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn created_at(& self) -> DateTime <Utc>`

`ContentBlock:deleted`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn deleted_at(& self) -> Option <DateTime <Utc>>`

`ContentBlock:get`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn get_string(& self, key : & str) -> Option <& str>`
`ContentBlock :: fn get_i64(& self, key : & str) -> Option <i64>`
`ContentBlock :: fn get_bool(& self, key : & str) -> Option <bool>`

`ContentBlock:id`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn id(& self) -> Uuid`

`ContentBlock:is`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn is_for_page(& self, page_id : Uuid) -> bool`
`ContentBlock :: fn is_type(& self, block_type : & str) -> bool`
`ContentBlock :: fn is_active(& self) -> bool`
`ContentBlock :: fn is_inactive(& self) -> bool`

`ContentBlock:restore`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn restore(& mut self)`

`ContentBlock:soft`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn soft_delete(& mut self)`

`ContentBlock:updated`

ContentBlock model for block-based page content.

Item
`ContentBlock :: fn updated_at(& self) -> DateTime <Utc>`

`ContentBlockBuilder:ContentBlockBuilder`

ContentBlock model for block-based page content.

Item
`pub struct ContentBlockBuilder`

`ContentBlockBuilder:active`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn active(mut self, is_active : bool) -> Self`

`ContentBlockBuilder:block`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn block_type(mut self, block_type : impl Into <String>) -> Self`

`ContentBlockBuilder:build`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn build(self) -> ContentBlock`

`ContentBlockBuilder:cta`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn cta(self) -> Self`

`ContentBlockBuilder:data`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn data(mut self, data : JsonValue) -> Self`

`ContentBlockBuilder:divider`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn divider(self) -> Self`

`ContentBlockBuilder:embed`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn embed(self) -> Self`

`ContentBlockBuilder:heading`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn heading(self) -> Self`

`ContentBlockBuilder:hero`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn hero(self) -> Self`

`ContentBlockBuilder:image`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn image(self) -> Self`
`ContentBlockBuilder :: fn image_gallery(self) -> Self`

`ContentBlockBuilder:inactive`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn inactive(mut self) -> Self`

`ContentBlockBuilder:new`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn new() -> Self`

`ContentBlockBuilder:page`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn page(mut self, page_id : Uuid) -> Self`

`ContentBlockBuilder:rich`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn rich_text(self) -> Self`

`ContentBlockBuilder:sequence`

ContentBlock model for block-based page content.

Item
`ContentBlockBuilder :: fn sequence(mut self, sequence : u32) -> Self`

`block::block_types (other)`

_No module-level documentation is present in the source._

Item
`pub const RICH_TEXT: & str`
`pub const HEADING: & str`
`pub const IMAGE: & str`
`pub const IMAGE_GALLERY: & str`
`pub const HERO: & str`
`pub const CTA: & str`
`pub const EMBED: & str`
`pub const DIVIDER: & str`
`pub const ALL: & & str`
`fn is_builtin(block_type : & str) -> bool`

`BlogCategory`

BlogCategory model for organizing blog posts.

Item
`pub struct BlogCategory`
`BlogCategory :: fn builder() -> BlogCategoryBuilder`
`BlogCategory :: fn matches_slug(& self, slug : & str) -> bool`
`BlogCategory :: fn slugify(name : & str) -> String`
`BlogCategory :: fn id(& self) -> Uuid`
`BlogCategory :: fn created_at(& self) -> DateTime <Utc>`
`BlogCategory :: fn updated_at(& self) -> DateTime <Utc>`
`BlogCategory :: fn deleted_at(& self) -> Option <DateTime <Utc>>`
`BlogCategory :: fn soft_delete(& mut self)`
`BlogCategory :: fn restore(& mut self)`

`BlogCategoryBuilder`

BlogCategory model for organizing blog posts.

Item
`pub struct BlogCategoryBuilder`
`BlogCategoryBuilder :: fn new() -> Self`
`BlogCategoryBuilder :: fn name(mut self, name : impl Into <String>) -> Self`
`BlogCategoryBuilder :: fn slug(mut self, slug : impl Into <String>) -> Self`
`BlogCategoryBuilder :: fn description(mut self, description : impl Into <String>) -> Self`
`BlogCategoryBuilder :: fn color(mut self, color : impl Into <String>) -> Self`
`BlogCategoryBuilder :: fn sort_order(mut self, order : i32) -> Self`
`BlogCategoryBuilder :: fn build(self) -> BlogCategory`

`AccessLevel`

CMS enums for page type, status, and access control.

Item
`pub enum AccessLevel`
`AccessLevel :: fn as_str(& self) -> & 'static str`
`AccessLevel :: fn requires_auth(& self) -> bool`
`AccessLevel :: fn is_public(& self) -> bool`
`AccessLevel :: fn is_role_based(& self) -> bool`
`AccessLevel :: fn is_entitlement_based(& self) -> bool`
`AccessLevel :: fn fmt(& self, f : & mut fmt::Formatter <'_>) -> fmt::Result`
`AccessLevel :: fn from_str(s : & str) -> Result <Self, Self::Err>`

`PageStatus`

CMS enums for page type, status, and access control.

Item
`pub enum PageStatus`
`PageStatus :: fn as_str(& self) -> & 'static str`
`PageStatus :: fn is_published(& self) -> bool`
`PageStatus :: fn is_draft(& self) -> bool`
`PageStatus :: fn is_archived(& self) -> bool`
`PageStatus :: fn is_visible(& self) -> bool`
`PageStatus :: fn fmt(& self, f : & mut fmt::Formatter <'_>) -> fmt::Result`
`PageStatus :: fn from_str(s : & str) -> Result <Self, Self::Err>`

`PageType`

CMS enums for page type, status, and access control.

Item
`pub enum PageType`
`PageType :: fn as_str(& self) -> & 'static str`
`PageType :: fn is_post(& self) -> bool`
`PageType :: fn is_page(& self) -> bool`
`PageType :: fn fmt(& self, f : & mut fmt::Formatter <'_>) -> fmt::Result`
`PageType :: fn from_str(s : & str) -> Result <Self, Self::Err>`

`CMSError:CMSError`

CMS error types.

Item
`pub enum CMSError`

`CMSError:access`

CMS error types.

Item
`CMSError :: fn access_denied(slug : impl Into <String>, reason : impl Into <String>) -> Self`

`CMSError:block`

CMS error types.

Item
`CMSError :: fn block_not_found(id : Uuid) -> Self`
`CMSError :: fn block_validation_failed(block_type : impl Into <String>, message : impl Into <String>,) -> Self`

`CMSError:cannot`

CMS error types.

Item
`CMSError :: fn cannot_publish(reason : impl Into <String>) -> Self`

`CMSError:category`

CMS error types.

Item
`CMSError :: fn category_not_found(id : Uuid) -> Self`
`CMSError :: fn category_not_found_by_slug(slug : impl Into <String>) -> Self`

`CMSError:duplicate`

CMS error types.

Item
`CMSError :: fn duplicate_slug(slug : impl Into <String>) -> Self`
`CMSError :: fn duplicate_redirect_path(path : impl Into <String>) -> Self`

`CMSError:invalid`

CMS error types.

Item
`CMSError :: fn invalid_slug(slug : impl Into <String>) -> Self`
`CMSError :: fn invalid_block_type(block_type : impl Into <String>) -> Self`
`CMSError :: fn invalid_seo_field(field : impl Into <String>, message : impl Into <String>) -> Self`

`CMSError:not`

CMS error types.

Item
`CMSError :: fn not_published(id : Uuid) -> Self`

`CMSError:page`

CMS error types.

Item
`CMSError :: fn page_not_found(id : Uuid) -> Self`
`CMSError :: fn page_not_found_by_slug(slug : impl Into <String>) -> Self`

`CMSError:redirect`

CMS error types.

Item
`CMSError :: fn redirect_not_found(id : Uuid) -> Self`
`CMSError :: fn redirect_not_found_by_path(path : impl Into <String>) -> Self`

`CMSError:version`

CMS error types.

Item
`CMSError :: fn version_page_mismatch(version_id : Uuid, version_page_id : Uuid, page_id : Uuid) -> Self`

`lifecycle (other)`

Version-pair content lifecycle.

Item
`fn save_draft(page : & mut ContentPage, draft_version : & PageVersion) -> Result <(), CMSError>`
`fn publish_draft(page : & mut ContentPage, publish_version : & PageVersion, published_by : Uuid,) -> Result <(), CMSError>`
`fn rollback(page : & mut ContentPage, target : & PageVersion, published_by : Uuid,) -> Result <(), CMSError>`

`DraftState`

Version-pair content lifecycle.

Item
`pub enum DraftState`
`DraftState :: fn as_str(& self) -> & 'static str`
`DraftState :: fn has_unpublished_changes(& self) -> bool`
`fn draft_state(page : & ContentPage) -> DraftState`
`fn draft_state_from(published_version_id : Option <Uuid>, draft_version_id : Option <Uuid>,) -> DraftState`