nostr: add title, image and description constructors to Tag

Ref #466

Signed-off-by: Yuki Kishimoto <[email protected]>

Author: yukibtc

CHANGELOG.md

@@ -37,6 +37,7 @@
 ### Added
 
 * nostr: add `EventBuilder::interest_set` ([Yuki Kishimoto])
+* nostr: add `title`, `image` and `description` constructors to `Tag` ([Yuki Kishimoto])
 * pool: add `SendOutput` and `SendEventOutput` structs ([Yuki Kishimoto])
 * js(sdk): partially expose `JsRelayPool` ([Yuki Kishimoto])
 * book: add some python examples ([RydalWater])

bindings/nostr-ffi/src/event/tag.rs

@@ -397,6 +397,33 @@ impl Tag {
         }
     }
 
+    /// Compose `["title", "<title>"]` tag
+    #[inline]
+    #[uniffi::constructor]
+    pub fn title(title: &str) -> Self {
+        Self {
+            inner: tag::Tag::title(title),
+        }
+    }
+
+    /// Compose image tag
+    #[inline]
+    #[uniffi::constructor(default(dimensions = None))]
+    pub fn image(url: &str, dimensions: Option<Arc<ImageDimensions>>) -> Self {
+        Self {
+            inner: tag::Tag::image(UncheckedUrl::from(url), dimensions.map(|d| **d)),
+        }
+    }
+
+    /// Compose `["description", "<description>"]` tag
+    #[inline]
+    #[uniffi::constructor]
+    pub fn description(description: &str) -> Self {
+        Self {
+            inner: tag::Tag::description(description),
+        }
+    }
+
     /// Compose custom tag
     ///
     /// JSON: `["<kind>", "<value-1>", "<value-2>", ...]`

bindings/nostr-js/src/event/tag.rs

@@ -313,6 +313,30 @@ impl JsTag {
         }
     }
 
+    /// Compose `["title", "<title>"]` tag
+    #[inline]
+    pub fn title(title: &str) -> Self {
+        Self {
+            inner: Tag::title(title),
+        }
+    }
+
+    /// Compose image tag
+    #[inline]
+    pub fn image(url: &str, dimensions: Option<JsImageDimensions>) -> Self {
+        Self {
+            inner: Tag::image(UncheckedUrl::from(url), dimensions.map(|d| d.into())),
+        }
+    }
+
+    /// Compose `["description", "<description>"]` tag
+    #[inline]
+    pub fn description(description: &str) -> Self {
+        Self {
+            inner: Tag::description(description),
+        }
+    }
+
     /// Check if is a standard event tag with `root` marker
     #[inline]
     #[wasm_bindgen(js_name = isRoot)]

crates/nostr/src/event/tag/mod.rs

@@ -31,7 +31,7 @@ use crate::nips::nip10::Marker;
 use crate::nips::nip56::Report;
 use crate::nips::nip65::RelayMetadata;
 use crate::types::url::Url;
-use crate::{PublicKey, SingleLetterTag, Timestamp};
+use crate::{ImageDimensions, PublicKey, SingleLetterTag, Timestamp, UncheckedUrl};
 
 /// Tag
 #[derive(Debug, Clone)]
@@ -257,6 +257,30 @@ impl Tag {
         Self::from_standardized_without_cell(TagStandard::Hashtag(hashtag.into()))
     }
 
+    /// Compose `["title", "<title>"]` tag
+    #[inline]
+    pub fn title<T>(title: T) -> Self
+    where
+        T: Into<String>,
+    {
+        Self::from_standardized_without_cell(TagStandard::Title(title.into()))
+    }
+
+    /// Compose image tag
+    #[inline]
+    pub fn image(url: UncheckedUrl, dimensions: Option<ImageDimensions>) -> Self {
+        Self::from_standardized_without_cell(TagStandard::Image(url, dimensions))
+    }
+
+    /// Compose `["description", "<description>"]` tag
+    #[inline]
+    pub fn description<T>(description: T) -> Self
+    where
+        T: Into<String>,
+    {
+        Self::from_standardized_without_cell(TagStandard::Description(description.into()))
+    }
+
     /// Compose custom tag
     ///
     /// JSON: `["<kind>", "<value-1>", "<value-2>", ...]`