systemprompt-identifiers 0.74.0

Typed newtype identifiers (UserId, TraceId, AgentId, McpServerId…) for systemprompt.io AI governance infrastructure. Enforces type-safe IDs across every boundary in the MCP governance pipeline.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! Shared document store identifiers.
//!
//! Documents, folders, revisions, edit sessions, comments and proposals
//! are UUID-backed.
//! [`ContentHash`] is a lowercase hex SHA-256 digest: the blob address a
//! revision, a drive manifest entry and a bridge commit all carry, so it is
//! checked to exactly 64 lowercase hex characters. The digest itself is
//! computed in `systemprompt_provider_contracts::documents::content_hash`,
//! keeping this crate free of hashing dependencies.
//!
//! [`DocumentNodeId`] is the stable anchor of one node of a document
//! projection, minted once and carried across revisions;
//! [`DocumentOpId`] is the caller-chosen key that makes a write idempotent;
//! [`DocumentTemplateId`] names a registered template; [`DriveDeviceId`]
//! names the bridge device that committed a revision.
//!
//! Copyright (c) systemprompt.io — Business Source License 1.1.
//! See <https://systemprompt.io> for licensing details.

use crate::error::IdValidationError;

crate::define_id!(DocumentId, uuid);
crate::define_id!(DocumentFolderId, uuid);
crate::define_id!(DocumentRevisionId, uuid);
crate::define_id!(DocumentEditSessionId, uuid);
crate::define_id!(DocumentCommentId, uuid);
crate::define_id!(DocumentProposalId, uuid);
crate::define_id!(ContentHash, checked, validate_content_hash);
crate::define_id!(DocumentNodeId, checked, |value| {
    crate::macros::validate_non_empty("DocumentNodeId", value)
});
crate::define_id!(DocumentOpId, checked, |value| {
    crate::macros::validate_non_empty("DocumentOpId", value)
});
crate::define_id!(DocumentTemplateId, checked, |value| {
    crate::macros::validate_non_empty("DocumentTemplateId", value)
});
crate::define_id!(DriveDeviceId, checked, |value| {
    crate::macros::validate_non_empty("DriveDeviceId", value)
});

const CONTENT_HASH_LEN: usize = 64;

fn validate_content_hash(value: &str) -> Result<(), IdValidationError> {
    if value.is_empty() {
        return Err(IdValidationError::empty("ContentHash"));
    }
    if value.len() != CONTENT_HASH_LEN {
        return Err(IdValidationError::invalid(
            "ContentHash",
            "must be exactly 64 hex characters",
        ));
    }
    if !value
        .bytes()
        .all(|b| b.is_ascii_digit() || (b'a'..=b'f').contains(&b))
    {
        return Err(IdValidationError::invalid(
            "ContentHash",
            "must be lowercase hex",
        ));
    }
    Ok(())
}