Struct ThingsId 

pub struct ThingsId(/* private fields */);

Identifier for any Things 3 entity (task, project, area, tag, heading).

Things 3 uses two distinct identifier formats in the wild:

1. Native Things IDs — 21- or 22-character base62 strings the Things app itself produces (e.g. R4t2G8Q63aGZq4epMHNeCr). These appear on every entity created via the Things UI or via osascript.
2. RFC-4122 UUIDs — 36-character hyphenated hex strings that the SqlxBackend generates for entities created through rust-things3 (e.g. 9d3f1e44-5c2a-4b8e-9c1f-7e2d8a4b3c5e).

Both formats coexist in the same SQLite uuid column. This type stores whichever format the entity was created with — never lossy conversion, always round-trip-safe through osascript, the database, and JSON wire format.

#[serde(transparent)] means the JSON shape is unchanged from when the type was Uuid: a bare string field, no enum tagging.

Validation boundary

serde deserialization (via #[serde(transparent)]) accepts any string and does not call from_str — it calls from_trusted semantics. This is intentional: request structs deserialized from the DB or from AppleScript output already contain trusted values. If you add a new code path that deserializes a request struct containing ThingsId fields directly from untrusted JSON (e.g. a new HTTP handler), call ThingsId::from_str explicitly on each ID field before acting on it rather than relying on serde to validate.

Construction

• ThingsId::new_v4 — fresh hyphenated UUID, used by SqlxBackend
• ThingsId::from_str — strict parse, rejects anything that isn’t one of the two known formats; used at MCP boundaries
• From<Uuid> — infallible, wraps a UUID’s hyphenated form

Implementations

impl ThingsId

pub fn new_v4() -> Self

Generate a fresh hyphenated UUID, suitable for SqlxBackend-created entities.

pub fn new_things_native() -> Self

Generate a fresh Things-native 22-char Base62 ID. Use this for any new entity that may be referenced via AppleScript — Things 3’s AppleScript dictionary only accepts this format in to do id "..." references, so a hyphenated UUID would fail with -1728 (#148).

Internally derived from a v4 UUID’s 16 random bytes, base62-encoded (a 16-byte / 128-bit value fits in 22 base62 characters).

pub fn as_str(&self) -> &str

Borrow the underlying string (for SQL parameter binding, AppleScript interpolation, logging, etc.).

pub fn into_string(self) -> String

Consume into the owned String.

Trait Implementations

impl AsRef<str> for ThingsId

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for ThingsId

fn clone(&self) -> ThingsId

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ThingsId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ThingsId

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ThingsId

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Uuid> for ThingsId

fn from(uuid: Uuid) -> Self

Converts to this type from the input type.

impl FromStr for ThingsId

fn from_str(s: &str) -> Result<Self, Self::Err>

Strict parse. Accepts:

• Hyphenated RFC-4122 UUIDs (36 chars)
• Things native IDs (21 or 22 base62 chars)

Anything else returns a ThingsError::Validation so MCP callers see a clear error before the request hits the database.

type Err = ThingsError

The associated error which can be returned from parsing.

impl Hash for ThingsId

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ThingsId

fn cmp(&self, other: &ThingsId) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ThingsId

fn eq(&self, other: &ThingsId) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for ThingsId

fn partial_cmp(&self, other: &ThingsId) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ThingsId

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ThingsId

impl StructuralPartialEq for ThingsId