Sreehari425 · Sreehari425 · Oct 19, 2025 · Oct 10, 2025 · Oct 10, 2025 · Oct 10, 2025
diff --git a/.github/workflows/basic-ci.yml b/.github/workflows/basic-ci.yml
@@ -1,5 +1,6 @@
 name: CI
 
+
 on:
   push:
     branches:
@@ -8,10 +9,6 @@ on:
     branches:
       - main
   workflow_dispatch:
-
-permissions:
-  contents: read
-
 env:
   CARGO_TERM_COLOR: always
 

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "presenceforge"
-version = "0.0.0"
-edition = "2021"
+version = "0.1.0-dev"
+edition = "2024"
 authors = ["Sreehari Anil <sreehari7102008@gmail.com>"]
 description = "A library for Discord Rich Presence (IPC) integration"
 readme = "README.md"

diff --git a/README.md b/README.md
@@ -4,11 +4,12 @@ A Rust library for Discord Rich Presence that actually works without the headach
 
 [![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](https://github.com/Sreehari425/presenceforge#license)
 [![Rust](https://img.shields.io/badge/rust-1.70+-blue.svg)](https://www.rust-lang.org)
+![Crates.io Version](https://img.shields.io/crates/v/presenceforge)
 
-> **Note**: This is currently in early development (v0.0.0). Things might break
+> **Note**: This is currently in development (v0.1.0-dev). Things might break
 > This is a learning/hobby project.
->
-> ⚠️ FINAL WARNING: PresenceForge is a learning/hobby project. If you need production-ready Discord Rich Presence, use a mature library like pypresence, discord-rpc, or CraftPresence.
+> Features and APIs may change in future versions.
+
 
 ## Documentation
 
@@ -26,44 +27,41 @@ A Rust library for Discord Rich Presence that actually works without the headach
 ## What Works
 
 - [x] Linux and macOS (Unix domain sockets)
-- [x] Windows support (named pipes) - needs testing
+- [x] Windows support (named pipes) 
 - [x] Flatpak Discord support (automatic detection)
 - [x] Basic Rich Presence activities
 - [x] Activity builder pattern
 - [x] Images, buttons, and timestamps
 - [x] Async support with runtime-agnostic design
 - [x] Support for tokio, async-std, and smol
 - [x] Flexible pipe/socket selection
-- [ ] Error handling could be better
-- [ ] Party/lobby features (partial implementation only)
 
 ## Quick Start
 
 Add PresenceForge to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge" }
+presenceforge = "0.1.0-dev"
 ```
 
 For async support, add one of the runtime features:
 
 ```toml
 [dependencies]
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["tokio-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["tokio-runtime"] }
 # OR
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["async-std-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["async-std-runtime"] }
 # OR
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["smol-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["smol-runtime"] }
 ```
 
-> **Note**: Not published to crates.io yet. Use the git dependency for now.
 
 ### Basic Usage (Synchronous)
 
 ```rust
-use presenceforge::{DiscordIpcClient, ActivityBuilder};
-
+use presenceforge::ActivityBuilder;
+use presenceforge::sync::DiscordIpcClient;
 fn main() -> Result<(), Box<dyn std::error::Error>> {
     let mut client = DiscordIpcClient::new("your_client_id")?;
     client.connect()?;
@@ -173,8 +171,8 @@ fn main() -> Result {
 ### Game Integration
 
 ```rust
-use presenceforge::{ActivityBuilder, DiscordIpcClient};
-
+use presenceforge::ActivityBuilder;
+use presenceforge::sync::DiscordIpcClient;
 let activity = ActivityBuilder::new()
     .state("Forest Level")
     .details("Fighting goblins")
@@ -276,7 +274,7 @@ ActivityBuilder::new()
     .small_image("image_key")        // Small image asset
     .small_text("Hover text")        // Small image hover text
     .button("Label", "https://url")  // Clickable button (max 2)
-    .party_size(1, 4)               // Party size (current, max)
+    .party("id",1, 4)               // Party size (current, max)
     .build()
 ```
 
@@ -341,8 +339,8 @@ cargo run --example async_tokio --features tokio-runtime
 PresenceForge uses the `Result` type for error handling:
 
 ```rust
-use presenceforge::{DiscordIpcClient, DiscordIpcError};
-
+use presenceforge::DiscordIpcError;
+use presenceforge::sync::DiscordIpcClient;
 match client.connect() {
     Ok(_) => println!("Connected successfully!"),
     Err(DiscordIpcError::ConnectionFailed) => {
@@ -358,7 +356,7 @@ match client.connect() {
 - [ ] Party/lobby functionality (partial implementation)
 - [x] Async support (tokio, async-std, and smol)
 - [x] More comprehensive examples
-- [ ] Publish to crates.io
+- [x] Publish to crates.io
 - [ ] CI/CD pipeline
 - [x] Proper documentation
 - [x] Connection retry logic with exponential backoff

diff --git a/changelogs/0.1.0-dev.md b/changelogs/0.1.0-dev.md
@@ -0,0 +1,34 @@
+# Unreleased
+
+## [0.1.0-dev] - dev-release
+
+
+### Added
+
+#### Core Features
+
+- Cross-platform Discord IPC support (Unix sockets for Linux/macOS, named pipes for Windows)
+- Automatic discovery of Discord IPC pipes/sockets
+- Flatpak Discord support with automatic detection
+- Synchronous client API (`DiscordIpcClient`)
+- Unified async API (`AsyncDiscordIpcClient`) with runtime-agnostic design
+- Support for Tokio, async-std, and smol runtimes via feature flags
+- Activity builder pattern for creating Rich Presence activities
+- Full Discord Rich Presence field support (state, details, timestamps, assets, buttons, party)
+- Basic input validation for all Discord field length limits
+- Pipe discovery and custom path selection
+- Connection timeout configuration
+- Retry logic with exponential backoff (sync and async)
+- Comprehensive error handling with categorization
+- UUID v4-based cryptographic nonces for request tracking
+
+#### Testing
+
+- Unit tests for core functionality
+- Integration tests for activity builder, serialization, error handling, IPC protocol, and retry logic
+
+### Feature Flags
+
+- `tokio-runtime` - Tokio async runtime support
+- `async-std-runtime` - async-std runtime support
+- `smol-runtime` - smol runtime support
diff --git a/docs/ACTIVITY_BUILDER_REFERENCE.md b/docs/ACTIVITY_BUILDER_REFERENCE.md
@@ -95,7 +95,7 @@ S = Small Image (overlays large image in bottom-right corner)
 #### Start Timestamp (Elapsed Time)
 
 ```rust
-.start_timestamp_now().expect("timestamp")  // Start counting from now
+.start_timestamp_now()?  // Start counting from now (returns Result)
 // or
 .start_timestamp(1234567890)  // Unix timestamp (u64)
 ```
@@ -134,15 +134,15 @@ let end_time = now + 300;
 
 ### 6. **Party** (`party()`)
 
-#### Note: Partialy tested feature
+#### Note: Partially tested feature
 
 ```rust
-.party("unique-party-id", 2, 4)  // party_id, current_size, max_size
+.party("unique-party-id", 2, 4)  // id, current_size, max_size
 ```
 
 - **Appears as:** "2 of 4" below the state text
 - **Parameters:**
-  - `party_id`: Unique identifier for the party (string)
+  - `id`: Unique identifier for the party (string)
   - `current_size`: Current number of players (u32)
   - `max_size`: Maximum number of players (u32)
 - **Use for:** Multiplayer games, voice channels, collaborative work
@@ -174,7 +174,7 @@ let end_time = now + 300;
 ### 8. **Secrets** (For "Ask to Join" and Spectate features)
 
 > **⚠️ Feature Flag Required:** These methods require the `secrets` feature flag to be enabled.
-> Add to your `Cargo.toml`: `presenceforge = { git = "...", features = ["secrets"] }`
+> Add to your `Cargo.toml`: `presenceforge = { version = "0.1.0-dev", features = ["secrets"] }`
 
 #### Note: untested feature
 
@@ -238,7 +238,8 @@ let end_time = now + 300;
 Here's an activity using all fields:
 
 ```rust
-use presenceforge::{ActivityBuilder, DiscordIpcClient};
+use presenceforge::sync::DiscordIpcClient;
+use presenceforge::ActivityBuilder;
 
 let activity = ActivityBuilder::new()
     // Text
@@ -252,7 +253,7 @@ let activity = ActivityBuilder::new()
     .small_text("Level 42 Warrior")
 
     // Time
-    .start_timestamp_now().expect("timestamp")
+    .start_timestamp_now()?
 
     // Party
     .party("party-12345", 3, 4)

diff --git a/docs/API_REFERENCE.md b/docs/API_REFERENCE.md
@@ -2,7 +2,8 @@
 
 API reference for PresenceForge (work-in-progress; APIs may change).
 
-> ⚠️ **NOTE:** This feature is experimental/untested. Use at your own risk.
+> **Note:** PresenceForge v0.1.0-dev is an early development release.  
+> It’s functional, but features may change or be incomplete.
 
 ## Table of Contents
 
@@ -27,7 +28,7 @@ The synchronous Discord IPC client for managing Rich Presence.
 Creates a new Discord IPC client with automatic pipe discovery.
 
 ```rust
-use presenceforge::DiscordIpcClient;
+use presenceforge::sync::DiscordIpcClient;
 
 let client = DiscordIpcClient::new("your_client_id")?;
 ```
@@ -49,7 +50,8 @@ let client = DiscordIpcClient::new("your_client_id")?;
 Creates a new Discord IPC client with custom pipe configuration.
 
 ```rust
-use presenceforge::{DiscordIpcClient, PipeConfig};
+use presenceforge::PipeConfig;
+use presenceforge::sync::DiscordIpcClient;
 
 // Auto-discovery (equivalent to ::new())
 let client = DiscordIpcClient::new_with_config("client_id", None)?;
@@ -310,28 +312,19 @@ Adds a button to the Rich Presence (max 2 buttons).
 
 ### Party Methods
 
-#### `party_id(self, id: impl Into<String>) -> Self`
-
-Sets the party ID (for grouping players).
-
-```rust
-.party_id("party_12345")
-```
-
----
-
-#### `party_size(self, current: i32, max: i32) -> Self`
+#### `party(self, id: impl Into<String>, current_size: u32, max_size: u32) -> Self`
 
-Sets the party size display.
+Sets the party information (ID and size) in a single method.
 
 ```rust
-.party_size(2, 4)  // Shows "2 of 4"
+.party("party_12345", 2, 4)  // Shows "2 of 4"
 ```
 
 **Parameters:**
 
-- `current` - Current number of players
-- `max` - Maximum number of players
+- `id` - Unique party identifier for grouping players
+- `current_size` - Current number of players
+- `max_size` - Maximum number of players
 
 ---
 

diff --git a/docs/ASYNC_RUNTIMES.md b/docs/ASYNC_RUNTIMES.md
@@ -1,6 +1,7 @@
 # Async Runtimes Guide
 
-> ⚠️ **NOTE:** This feature is experimental/untested. Use at your own risk.
+> **Note:** PresenceForge v0.1.0-dev is an early development release.  
+> It’s functional, but features may change or be incomplete.
 
 ## Table of Contents
 
@@ -62,13 +63,13 @@ Add to your `Cargo.toml` with **one** of these feature flags:
 ```toml
 [dependencies]
 # For Tokio
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["tokio-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["tokio-runtime"] }
 
 # For async-std
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["async-std-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["async-std-runtime"] }
 
 # For smol
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["smol-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["smol-runtime"] }
 ```
 
 **This exact code works with all three runtimes:**
@@ -89,7 +90,7 @@ async fn setup_presence() -> Result {
     let activity = ActivityBuilder::new()
         .state("Playing async")
         .details("Runtime-agnostic!")
-        .start_timestamp_now().expect("timestamp")
+        .start_timestamp_now()?
         .build();
 
     // Set activity
@@ -139,7 +140,7 @@ Add to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["tokio-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["tokio-runtime"] }
 tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
 ```
 
@@ -162,7 +163,7 @@ async fn main() -> Result {
     let activity = ActivityBuilder::new()
         .state("Playing async")
         .details("Using Tokio")
-        .start_timestamp_now().expect("timestamp")
+        .start_timestamp_now()?
         .build();
 
     // Set activity
@@ -211,7 +212,7 @@ async fn main() -> Result {
                 let activity = ActivityBuilder::new()
                 .state(format!("Update #{}", counter))
                 .details("Tokio Background Task")
-                .start_timestamp_now().expect("timestamp")
+                .start_timestamp_now()?
                 .build();
 
             let mut client = presence_client.lock().await;
@@ -319,7 +320,7 @@ async-std provides an async API similar to the standard library.
 
 ```toml
 [dependencies]
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["async-std-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["async-std-runtime"] }
 async-std = { version = "1", features = ["attributes"] }
 ```
 
@@ -418,7 +419,7 @@ smol is a small and fast async runtime.
 
 ```toml
 [dependencies]
-presenceforge = { git = "https://github.com/Sreehari425/presenceforge", features = ["smol-runtime"] }
+presenceforge = { version = "0.1.0-dev", features = ["smol-runtime"] }
 smol = "2"
 ```
 
@@ -441,7 +442,7 @@ fn main() -> Result {
         let activity = ActivityBuilder::new()
             .state("Playing async")
             .details("Using smol")
-            .start_timestamp_now().expect("timestamp")
+            .start_timestamp_now()?
             .build();
 
         client.set_activity(&activity).await?;
@@ -639,7 +640,8 @@ async fn main() -> Result {
 ### Sync Code
 
 ```rust
-use presenceforge::{DiscordIpcClient, ActivityBuilder};
+use presenceforge::ActivityBuilder;
+use presenceforge::sync::DiscordIpcClient;
 
 fn main() -> Result<(), Box<dyn std::error::Error>> {
     let mut client = DiscordIpcClient::new("client_id")?;