rsbinder 0.12.0

// Copyright 2026 Jeff Kim <hiking90@gmail.com>
// SPDX-License-Identifier: Apache-2.0

//! Plan 2-19 — an interface declared with `#[rsbinder::interface]` really
//! serves and really answers, over a socket rather than in-process, so the
//! generated `on_transact` / `Bp` halves are both exercised.
//!
//! The byte-identity of this generated code against the `.aidl` path is
//! pinned separately, by the golden tests inside `rsbinder-macros`.
//!
//! AC-22.9 (`macro_interface_gateway_republishes_a_proxy`): `#[interface]` renders through the
//! same generator as `.aidl` (plan 2-19 D1), so the delegating
//! `impl IFoo for Strong<dyn IFoo>` exists here too — a proxy satisfies `Bn*::new_binder`'s
//! bound, and the gateway spelling compiles and forwards on this path as well.

#![cfg(all(feature = "macros", feature = "rpc"))]

use std::path::PathBuf;
use std::sync::{Arc, Mutex};

use rsbinder::{interface, BinderEnum, BinderResult, Endpoint, Interface, Parcelable, Strong, Uri};

#[interface(descriptor = "rsbinder.test.IMacroEcho")]
pub trait IMacroEcho {
    fn echo(&self, msg: &str) -> BinderResult<String>;
    fn add(&self, a: i32, b: i32) -> BinderResult<i32>;
    /// Out parameter: the server sizes and fills the caller's vector.
    fn fill(&self, values: &mut Vec<i32>) -> BinderResult<()>;
    /// Inout: sent, mutated, read back.
    fn bump(&self, #[inout] values: &mut Vec<i32>) -> BinderResult<()>;
    fn maybe(&self, msg: Option<&str>) -> BinderResult<Option<String>>;
    fn register(&self, cb: &Strong<dyn IMacroSink>) -> BinderResult<()>;
    #[oneway]
    fn ping(&self) -> BinderResult<()>;
}

#[interface(descriptor = "rsbinder.test.IMacroSink")]
pub trait IMacroSink {
    fn hit(&self, tag: &str) -> BinderResult<()>;
}

/// A parcelable and an enum, derived rather than written in `.aidl`. Only the
/// codec is generated, so `Default`/`Debug`/`Clone` are derived alongside.
#[derive(Parcelable, Default, Debug, Clone, PartialEq)]
pub struct Config {
    pub name: String,
    pub retries: i32,
    pub extra: Option<Vec<u8>>,
}

#[derive(BinderEnum, Default, Clone, Copy, Debug, PartialEq, Eq)]
#[repr(i32)]
pub enum Mode {
    #[default]
    Fast = 0,
    Safe = 1,
}

#[interface(descriptor = "rsbinder.test.IMacroData")]
pub trait IMacroData {
    fn apply(&self, cfg: &Config, mode: Mode) -> BinderResult<Config>;
    fn modes(&self, all: &[Mode]) -> BinderResult<Vec<Mode>>;
    fn maybe_cfg(&self, cfg: Option<&Config>) -> BinderResult<Option<Config>>;
}

/// A self-referencing interface: the callback is the same type as the callee.
/// Compiled and called for real, because the textual golden tests cannot tell
/// a type that parses from one that type-checks.
#[interface(descriptor = "rsbinder.test.IMacroChain")]
pub trait IMacroChain {
    fn relay(&self, next: &Strong<dyn IMacroChain>, msg: &str) -> BinderResult<String>;
    fn name(&self) -> BinderResult<String>;
}

struct Echo {
    pinged: Arc<Mutex<u32>>,
}
impl Interface for Echo {}
impl IMacroEcho for Echo {
    fn echo(&self, msg: &str) -> BinderResult<String> {
        Ok(format!("echo:{msg}"))
    }
    fn add(&self, a: i32, b: i32) -> BinderResult<i32> {
        Ok(a + b)
    }
    fn fill(&self, values: &mut Vec<i32>) -> BinderResult<()> {
        for (i, slot) in values.iter_mut().enumerate() {
            *slot = i as i32 * 10;
        }
        Ok(())
    }
    fn bump(&self, values: &mut Vec<i32>) -> BinderResult<()> {
        for v in values.iter_mut() {
            *v += 1;
        }
        Ok(())
    }
    fn maybe(&self, msg: Option<&str>) -> BinderResult<Option<String>> {
        Ok(msg.map(|m| m.to_uppercase()))
    }
    fn register(&self, cb: &Strong<dyn IMacroSink>) -> BinderResult<()> {
        cb.hit("from-server")
    }
    fn ping(&self) -> BinderResult<()> {
        *self.pinged.lock().unwrap() += 1;
        Ok(())
    }
}

struct Sink {
    seen: Arc<Mutex<Vec<String>>>,
}
impl Interface for Sink {}
impl IMacroSink for Sink {
    fn hit(&self, tag: &str) -> BinderResult<()> {
        self.seen.lock().unwrap().push(tag.to_string());
        Ok(())
    }
}

struct Chain {
    tag: String,
}
impl Interface for Chain {}
impl IMacroChain for Chain {
    fn relay(&self, next: &Strong<dyn IMacroChain>, msg: &str) -> BinderResult<String> {
        Ok(format!("{}>{}:{msg}", self.tag, next.name()?))
    }
    fn name(&self) -> BinderResult<String> {
        Ok(self.tag.clone())
    }
}

struct Data;
impl Interface for Data {}
impl IMacroData for Data {
    fn apply(&self, cfg: &Config, mode: Mode) -> BinderResult<Config> {
        let mut out = cfg.clone();
        out.retries += 1;
        out.name = format!("{}:{mode:?}", cfg.name);
        Ok(out)
    }
    fn modes(&self, all: &[Mode]) -> BinderResult<Vec<Mode>> {
        Ok(all.iter().rev().copied().collect())
    }
    fn maybe_cfg(&self, cfg: Option<&Config>) -> BinderResult<Option<Config>> {
        Ok(cfg.cloned())
    }
}

struct SockPath(PathBuf);
impl SockPath {
    fn new(tag: &str) -> Self {
        let mut p = std::env::temp_dir();
        p.push(format!("rsb_macro_{}_{}.sock", tag, std::process::id()));
        let _ = std::fs::remove_file(&p);
        SockPath(p)
    }
    fn uri(&self) -> Uri {
        Uri::new(Endpoint::unix(&self.0))
    }
    fn service(&self, name: &str) -> Uri {
        Endpoint::unix(&self.0).with_service(name)
    }
}
impl Drop for SockPath {
    fn drop(&mut self) {
        let _ = std::fs::remove_file(&self.0);
    }
}

#[test]
fn macro_interface_round_trips_over_rpc() {
    let sock = SockPath::new("echo");
    let pinged = Arc::new(Mutex::new(0));
    let _guard = rsbinder::serve(sock.uri())
        .expect("serve")
        .add(
            "echo",
            BnMacroEcho::new_binder(Echo {
                pinged: pinged.clone(),
            }),
        )
        .expect("add")
        .spawn()
        .expect("spawn");

    let echo: Strong<dyn IMacroEcho> = rsbinder::connect(sock.service("echo")).expect("connect");

    assert_eq!(echo.echo("hi").unwrap(), "echo:hi");
    assert_eq!(echo.add(40, 2).unwrap(), 42);

    // Out: the length travels on the request, the contents on the reply.
    let mut out = vec![0i32; 4];
    echo.fill(&mut out).unwrap();
    assert_eq!(out, vec![0, 10, 20, 30]);

    // Inout: contents travel both ways.
    let mut inout = vec![1i32, 2, 3];
    echo.bump(&mut inout).unwrap();
    assert_eq!(inout, vec![2, 3, 4]);

    assert_eq!(echo.maybe(Some("shout")).unwrap().as_deref(), Some("SHOUT"));
    assert_eq!(echo.maybe(None).unwrap(), None);

    // A twoway call after the oneway one proves the server has drained it.
    echo.ping().unwrap();
    echo.echo("barrier").unwrap();
    assert_eq!(*pinged.lock().unwrap(), 1);
}

#[test]
fn macro_interface_carries_a_callback_binder() {
    let sock = SockPath::new("cb");
    let _guard = rsbinder::serve(sock.uri())
        .expect("serve")
        .add(
            "echo",
            BnMacroEcho::new_binder(Echo {
                pinged: Arc::new(Mutex::new(0)),
            }),
        )
        .expect("add")
        .spawn()
        .expect("spawn");

    let echo: Strong<dyn IMacroEcho> = rsbinder::connect(sock.service("echo")).expect("connect");
    let seen = Arc::new(Mutex::new(Vec::new()));
    let sink = BnMacroSink::new_binder(Sink { seen: seen.clone() });

    echo.register(&sink).expect("register");
    assert_eq!(seen.lock().unwrap().as_slice(), ["from-server"]);
}

/// The descriptor goes on the wire; over RPC the first transact's token checks it, not the cast.
#[test]
fn macro_interface_descriptor_is_the_attribute_value() {
    assert_eq!(
        <Echo as IMacroEcho>::descriptor(),
        "rsbinder.test.IMacroEcho"
    );
    assert_eq!(
        <Sink as IMacroSink>::descriptor(),
        "rsbinder.test.IMacroSink"
    );
}

/// AC-22.9: a macro-interface proxy republishes through `Bn*::new_binder`; see module doc.
#[test]
fn macro_interface_gateway_republishes_a_proxy() {
    let up = SockPath::new("gwup");
    let down = SockPath::new("gwdown");

    let _c = rsbinder::serve(up.uri())
        .expect("serve")
        .add(
            "echo",
            BnMacroEcho::new_binder(Echo {
                pinged: Arc::new(Mutex::new(0)),
            }),
        )
        .expect("add")
        .spawn()
        .expect("spawn");

    let upstream: Strong<dyn IMacroEcho> = rsbinder::connect(up.service("echo")).expect("connect");
    let _b = rsbinder::serve(down.uri())
        .expect("serve")
        .add("echo", BnMacroEcho::new_binder(upstream))
        .expect("the macro path yields the same one-line gateway")
        .spawn()
        .expect("spawn");

    let via: Strong<dyn IMacroEcho> = rsbinder::connect(down.service("echo")).expect("connect");
    assert_eq!(via.echo("hi").unwrap(), "echo:hi");
    assert_eq!(via.add(40, 2).unwrap(), 42);
}

#[test]
fn macro_interface_can_reference_itself() {
    let sock = SockPath::new("chain");
    let _guard = rsbinder::serve(sock.uri())
        .expect("serve")
        .add(
            "chain",
            BnMacroChain::new_binder(Chain {
                tag: "server".into(),
            }),
        )
        .expect("add")
        .spawn()
        .expect("spawn");

    let chain: Strong<dyn IMacroChain> = rsbinder::connect(sock.service("chain")).expect("connect");
    let local = BnMacroChain::new_binder(Chain {
        tag: "local".into(),
    });

    // The server calls back into the binder we handed it, of its own type.
    assert_eq!(chain.relay(&local, "hi").unwrap(), "server>local:hi");
}

#[test]
fn derived_parcelable_and_enum_cross_the_wire() {
    let sock = SockPath::new("data");
    let _guard = rsbinder::serve(sock.uri())
        .expect("serve")
        .add("data", BnMacroData::new_binder(Data))
        .expect("add")
        .spawn()
        .expect("spawn");

    let data: Strong<dyn IMacroData> = rsbinder::connect(sock.service("data")).expect("connect");

    let cfg = Config {
        name: "cfg".into(),
        retries: 2,
        extra: Some(vec![1, 2, 3]),
    };
    let back = data.apply(&cfg, Mode::Safe).unwrap();
    assert_eq!(back.name, "cfg:Safe");
    assert_eq!(back.retries, 3);
    assert_eq!(back.extra, Some(vec![1, 2, 3]));

    // An enum travels as its `#[repr]` scalar, arrays included.
    assert_eq!(
        data.modes(&[Mode::Fast, Mode::Safe]).unwrap(),
        vec![Mode::Safe, Mode::Fast]
    );

    // `Option` is AIDL's `@nullable`, both ways.
    assert_eq!(data.maybe_cfg(Some(&cfg)).unwrap(), Some(cfg));
    assert_eq!(data.maybe_cfg(None).unwrap(), None);
}