nle-cloud-sdk 0.1.1

Unofficial asynchronous Rust SDK for the NLECloud (新大陆物联网云平台) IoT platform
Documentation
use crate::utils::flexible_datetime_opt;
use chrono::NaiveDateTime;
use serde::{Deserialize, Serialize};

/// Project details (`ProjectInfoDTO`).
#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
#[serde(rename_all = "PascalCase")]
pub struct ProjectInfoDto {
    /// Project identifier.
    #[serde(rename = "ProjectID", alias = "ProjectId")]
    pub project_id: i32,

    /// Project name.
    pub name: Option<String>,

    /// Industry category.
    pub industry: Option<String>,

    /// Network connectivity kind (e.g. "WIFI", "以太网", "蜂窝网络", "蓝牙").
    #[serde(rename = "NetWorkKind", alias = "NetworkKind")]
    pub net_work_kind: Option<String>,

    /// Project 32-character tag identifier.
    pub project_tag: Option<String>,

    /// Creation timestamp.
    #[serde(default, with = "flexible_datetime_opt")]
    pub create_date: Option<NaiveDateTime>,

    /// Project description / remarks.
    pub remark: Option<String>,
}

/// Query parameters for fuzzy searching projects (`ProjectFuzzyQryPagingParas`).
#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
#[serde(rename_all = "PascalCase")]
pub struct ProjectFuzzyQryPagingParas {
    /// Keyword to match project name or ID.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub keyword: Option<String>,

    /// 32-character project tag.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub project_tag: Option<String>,

    /// Network kind filter (1: WIFI, 2: Ethernet, 3: Cellular, 4: Bluetooth).
    #[serde(
        rename = "NetWorkKind",
        alias = "NetworkKind",
        skip_serializing_if = "Option::is_none"
    )]
    pub net_work_kind: Option<u8>,

    /// Number of items per page (default 20, max 100).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub page_size: Option<i32>,

    /// 1-based page index.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub page_index: Option<i32>,

    /// Start date (YYYY-MM-DD).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub start_date: Option<String>,

    /// End date (YYYY-MM-DD).
    #[serde(skip_serializing_if = "Option::is_none")]
    pub end_date: Option<String>,
}

/// Payload for adding or updating a project.
#[derive(Debug, Clone, Serialize, Deserialize, Default, PartialEq)]
#[serde(rename_all = "PascalCase")]
pub struct ProjectAddUpdateDto {
    /// Project name (1 to 30 characters).
    pub name: String,

    /// Industry category (1: Security, 2: Smart Home, 3: Wearables, 4: Agriculture, 5: Industrial IoT, etc.).
    pub industry: u8,

    /// Network kind (1: WiFi, 2: Ethernet, 3: Cellular, 4: Bluetooth, 5: NB-IoT).
    #[serde(rename = "NetWorkKind", alias = "NetworkKind")]
    pub net_work_kind: u8,

    /// Project remarks or description.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub remark: Option<String>,
}

impl ProjectAddUpdateDto {
    /// Creates a new project creation payload with required parameters.
    ///
    /// - `name`: Project display name (1 to 30 characters).
    /// - `industry`: Industry classification ID (e.g. 1: Security, 4: Agriculture, 5: Industrial IoT).
    /// - `net_work_kind`: Network connection type (1: WiFi, 2: Ethernet, 3: Cellular, 4: Bluetooth, 5: NB-IoT).
    pub fn new(name: impl Into<String>, industry: u8, net_work_kind: u8) -> Self {
        Self {
            name: name.into(),
            industry,
            net_work_kind,
            remark: None,
        }
    }
}