feat: utils

Signed-off-by: David Dal Busco <david.dalbusco@outlook.com>

Author: peterpeterparker

docs/reference/functions/rust/utils.mdx

@@ -0,0 +1,58 @@
+# Utils
+
+The following utilities are provided to help you work with document and asset data inside your Satellite. They simplify tasks such as decoding and encoding data, serializing custom types, and interacting with Juno’s core features in a consistent way.
+
+:::note[📦 Crate]
+
+All utilities on this page are provided by the [junobuild-utils](https://docs.rs/junobuild-utils/latest/junobuild_utils/index.html) crate.
+
+To use them, add this to your Cargo.toml:
+
+```toml
+[dependencies]
+junobuild-utils = "*"
+```
+
+Replace `*` with the specific version you want to use, or omit the version to always use the latest version.
+
+:::
+
+---
+
+## decode_doc_data
+
+Deserializes raw document data (`&[u8]`) into a typed Rust struct. Use this inside hooks or assertions to get the document contents in a strongly typed way.
+
+```rust
+pub fn decode_doc_data<T: for<'a> Deserialize<'a>>(
+    data: &[u8],
+) -> Result<T, String>
+```
+
+📦 See full definition on [docs.rs](https://docs.rs/junobuild-utils/latest/junobuild_utils/fn.decode_doc_data.html)
+
+---
+
+## encode_doc_data
+
+Serializes a Rust struct into a `Vec<u8>` for storing a document into the datastore. Use this when modifying or creating document data inside a hook or assertion.
+
+```rust
+pub fn encode_doc_data<T: Serialize>(data: &T) -> Result<Vec<u8>, String>
+```
+
+📦 See full definition on [docs.rs](https://docs.rs/junobuild-utils/latest/junobuild_utils/fn.encode_doc_data.html)
+
+---
+
+## encode_doc_data_to_string
+
+Serializes a Rust struct into a JSON String. Use this if you want to store or inspect document data in a readable format. Commonly used when exposing JSON data on the web, for example by reproducing documents from the datastore into the storage.
+
+```rust
+pub fn encode_doc_data_to_string<T: Serialize>(
+    data: &T,
+) -> Result<String, String>
+```
+
+📦 See full definition on [docs.rs](https://docs.rs/junobuild-utils/latest/junobuild_utils/fn.encode_doc_data_to_string.html)

sidebars.ts

@@ -196,7 +196,32 @@ const sidebars: SidebarsConfig = {
     "reference/cli",
     "reference/configuration",
     "reference/plugins",
-    "reference/settings"
+    "reference/settings",
+    {
+      type: "category",
+      label: "Functions",
+      link: {
+        type: "generated-index",
+        slug: "/reference/functions",
+        description:
+          "API reference for writing serverless functions in Rust or TypeScript."
+      },
+      items: [
+        {
+          type: "category",
+          label: "Rust",
+          link: {
+            type: "generated-index",
+            slug: "/reference/functions/rust",
+            description:
+              "API reference for writing serverless functions in Rust."
+          },
+          items: [
+            "reference/functions/rust/utils"
+          ]
+        },
+      ]
+    },
   ]
 };