feat: align SDK with stabilized API — add 14 endpoints, fix field mappings, expand Company type

Reconcile the SDK against the production VynCo API (v1.6.0):

- Company: add 21 missing fields (address, geo, purpose, auditor_name, FINMA, EHRAID, etc.)
- CompanyListParams: add 7 filter params (status, legalForm, capitalMin/Max, auditorCategory, sort)
- Dashboard types: replace AuditorTenureStats, DataCompleteness, PipelineStatus with API-matching shapes
- Fix i32→i64: CreditBalance.used_this_month, BillingSummary.used_this_month, MemberUsage.credits_used
- AiSearchResponse.results: Vec<Company> → Vec<serde_json::Value>

New endpoints (14):
  companies: get_full, structure, acquisitions, notes CRUD (4), tags CRUD (4), export_excel
  dossiers: generate
  teams: join

New types: CompanyFullResponse, PersonEntry, ChangeEntry, RelationshipEntry, CorporateStructure,
  RelatedCompanyEntry, Note, CreateNoteRequest, UpdateNoteRequest, Tag, CreateTagRequest,
  TagSummary, ExcelExportRequest, ExcelExportFilter, Acquisition, LongestTenure,
  JoinTeamRequest, JoinTeamResponse

Infrastructure: Client::request_bytes_with_body for POST→raw-bytes (CSV export).
Tests: 8 new (45 total), all passing. fmt/clippy clean.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: mivertowski

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## What This Is
 
-Rust SDK (`vynco` crate) for the VynCo Swiss Corporate Intelligence API. Covers 69 public API endpoints across 18 resource modules. Aligned with the VynCo OpenAPI 2.0.0 specification.
+Rust SDK (`vynco` crate) for the VynCo Swiss Corporate Intelligence API. Covers 83 public API endpoints across 18 resource modules. Aligned with the VynCo API v1.6.0.
 
 ## Commands
 
@@ -39,12 +39,12 @@ cargo test -- --nocapture      # Run tests with stdout visible
 
 **Error mapping:** HTTP status → `VyncoError` variant: 401→Authentication, 402→InsufficientCredits, 403→Forbidden, 404→NotFound, 400/422→Validation, 409→Conflict, 429→RateLimit, 5xx→Server. Error bodies follow RFC 7807 ProblemDetails with `error_type`, `title`, `status`, `detail` (`Option<String>`), and `instance` (`Option<String>`) fields.
 
-### Resources (18 modules, 69 endpoints)
+### Resources (18 modules, 83 endpoints)
 
 | Resource | Endpoints |
 |----------|-----------|
 | `health` | `check` |
-| `companies` | `list`, `get`, `count`, `events`, `statistics`, `compare`, `news`, `reports`, `relationships`, `hierarchy`, `fingerprint`, `nearby` |
+| `companies` | `list`, `get`, `get_full`, `count`, `events`, `statistics`, `compare`, `structure`, `acquisitions`, `news`, `reports`, `relationships`, `hierarchy`, `fingerprint`, `nearby`, `notes`, `create_note`, `update_note`, `delete_note`, `tags`, `create_tag`, `delete_tag`, `all_tags`, `export_excel` |
 | `auditors` | `history`, `tenures` |
 | `dashboard` | `get` |
 | `screening` | `screen` |
@@ -55,11 +55,11 @@ cargo test -- --nocapture      # Run tests with stdout visible
 | `api_keys` | `list`, `create`, `revoke` |
 | `credits` | `balance`, `usage`, `history` |
 | `billing` | `create_checkout`, `create_portal` |
-| `teams` | `me`, `create`, `members`, `invite_member`, `update_member_role`, `remove_member`, `billing_summary` |
+| `teams` | `me`, `create`, `members`, `invite_member`, `update_member_role`, `remove_member`, `billing_summary`, `join` |
 | `changes` | `list`, `by_company`, `statistics` |
 | `persons` | `board_members` |
 | `analytics` | `statistics`, `cantons`, `auditors`, `cluster`, `anomalies`, `rfm_segments`, `cohorts`, `candidates` |
-| `dossiers` | `create`, `list`, `get`, `delete` |
+| `dossiers` | `create`, `list`, `get`, `delete`, `generate` |
 | `graph` | `get`, `export`, `analyze` |
 
 ### Serde Conventions

examples/vynco_cli.rs

@@ -338,19 +338,27 @@ async fn run(client: Client, command: Command) -> Result<(), VyncoError> {
         Command::Dashboard => {
             let resp = client.dashboard().get().await?;
             let d = &resp.data.data;
-            println!("Total companies: {}", d.total_companies);
-            println!("With canton:     {}", d.with_canton);
-            println!("With status:     {}", d.with_status);
-            println!("With legal form: {}", d.with_legal_form);
-            println!("With capital:    {}", d.with_capital);
-            println!("Completeness:    {:.1}%", d.completeness_pct);
+            println!("Total companies:     {}", d.total_companies);
+            println!("Enriched:            {}", d.enriched_companies);
+            println!("With industry:       {}", d.companies_with_industry);
+            println!("With geo:            {}", d.companies_with_geo);
+            println!("Total persons:       {}", d.total_persons);
+            println!("Total changes:       {}", d.total_changes);
+            println!("SOGC publications:   {}", d.total_sogc_publications);
 
             let t = &resp.data.auditor_tenures;
             println!("\nAuditor tenures:");
-            println!("  Total:          {}", t.total_tenures);
-            println!("  Long (7+yr):    {}", t.long_tenures_7plus);
+            println!("  Tracked:        {}", t.total_tracked);
+            println!("  Current:        {}", t.current_auditors);
+            println!("  Over 7yr:       {}", t.tenures_over_7_years);
+            println!("  Over 10yr:      {}", t.tenures_over_10_years);
             println!("  Avg years:      {:.1}", t.avg_tenure_years);
-            println!("  Max years:      {:.1}", t.max_tenure_years);
+            if let Some(lt) = &t.longest_tenure {
+                println!(
+                    "  Longest:        {:.1}yr — {} ({})",
+                    lt.tenure_years, lt.auditor_name, lt.company_name
+                );
+            }
             print_meta(&resp.meta);
         }
 

src/blocking.rs

@@ -191,6 +191,11 @@ impl Companies<'_> {
         self.client.block_on(self.client.inner.companies().get(uid))
     }
 
+    pub fn get_full(&self, uid: &str) -> Result<Response<CompanyFullResponse>> {
+        self.client
+            .block_on(self.client.inner.companies().get_full(uid))
+    }
+
     pub fn count(&self) -> Result<Response<CompanyCount>> {
         self.client.block_on(self.client.inner.companies().count())
     }
@@ -235,10 +240,70 @@ impl Companies<'_> {
             .block_on(self.client.inner.companies().fingerprint(uid))
     }
 
+    pub fn structure(&self, uid: &str) -> Result<Response<CorporateStructure>> {
+        self.client
+            .block_on(self.client.inner.companies().structure(uid))
+    }
+
+    pub fn acquisitions(&self, uid: &str) -> Result<Response<Vec<Acquisition>>> {
+        self.client
+            .block_on(self.client.inner.companies().acquisitions(uid))
+    }
+
     pub fn nearby(&self, params: &NearbyParams) -> Result<Response<Vec<NearbyCompany>>> {
         self.client
             .block_on(self.client.inner.companies().nearby(params))
     }
+
+    pub fn notes(&self, uid: &str) -> Result<Response<Vec<Note>>> {
+        self.client
+            .block_on(self.client.inner.companies().notes(uid))
+    }
+
+    pub fn create_note(&self, uid: &str, req: &CreateNoteRequest) -> Result<Response<Note>> {
+        self.client
+            .block_on(self.client.inner.companies().create_note(uid, req))
+    }
+
+    pub fn update_note(
+        &self,
+        uid: &str,
+        note_id: &str,
+        req: &UpdateNoteRequest,
+    ) -> Result<Response<Note>> {
+        self.client
+            .block_on(self.client.inner.companies().update_note(uid, note_id, req))
+    }
+
+    pub fn delete_note(&self, uid: &str, note_id: &str) -> Result<ResponseMeta> {
+        self.client
+            .block_on(self.client.inner.companies().delete_note(uid, note_id))
+    }
+
+    pub fn tags(&self, uid: &str) -> Result<Response<Vec<Tag>>> {
+        self.client
+            .block_on(self.client.inner.companies().tags(uid))
+    }
+
+    pub fn create_tag(&self, uid: &str, req: &CreateTagRequest) -> Result<Response<Tag>> {
+        self.client
+            .block_on(self.client.inner.companies().create_tag(uid, req))
+    }
+
+    pub fn delete_tag(&self, uid: &str, tag_id: &str) -> Result<ResponseMeta> {
+        self.client
+            .block_on(self.client.inner.companies().delete_tag(uid, tag_id))
+    }
+
+    pub fn all_tags(&self) -> Result<Response<Vec<TagSummary>>> {
+        self.client
+            .block_on(self.client.inner.companies().all_tags())
+    }
+
+    pub fn export_excel(&self, req: &ExcelExportRequest) -> Result<ExportFile> {
+        self.client
+            .block_on(self.client.inner.companies().export_excel(req))
+    }
 }
 
 pub struct Auditors<'a> {
@@ -509,6 +574,10 @@ impl Teams<'_> {
         self.client
             .block_on(self.client.inner.teams().billing_summary())
     }
+
+    pub fn join(&self, req: &JoinTeamRequest) -> Result<Response<JoinTeamResponse>> {
+        self.client.block_on(self.client.inner.teams().join(req))
+    }
 }
 
 pub struct Changes<'a> {
@@ -613,6 +682,11 @@ impl Dossiers<'_> {
         self.client
             .block_on(self.client.inner.dossiers().delete(id))
     }
+
+    pub fn generate(&self, uid: &str) -> Result<Response<Dossier>> {
+        self.client
+            .block_on(self.client.inner.dossiers().generate(uid))
+    }
 }
 
 pub struct Graph<'a> {

src/client.rs

@@ -262,6 +262,45 @@ impl Client {
         Ok((bytes, meta, content_type, filename))
     }
 
+    /// Send a request with a JSON body and return raw bytes (e.g. CSV exports).
+    /// Returns `(bytes, meta, content_type, filename)`.
+    pub(crate) async fn request_bytes_with_body<B: Serialize>(
+        &self,
+        method: Method,
+        path: &str,
+        body: &B,
+    ) -> Result<(Vec<u8>, ResponseMeta, String, String)> {
+        let builder = self.http.request(method.clone(), self.url(path)).json(body);
+        let resp = self.execute_raw(builder).await?;
+        let meta = ResponseMeta::from_headers(resp.headers());
+        let status = resp.status();
+
+        let content_type = resp
+            .headers()
+            .get(header::CONTENT_TYPE)
+            .and_then(|v| v.to_str().ok())
+            .unwrap_or("application/octet-stream")
+            .to_string();
+
+        let filename = resp
+            .headers()
+            .get(header::CONTENT_DISPOSITION)
+            .and_then(|v| v.to_str().ok())
+            .and_then(|v| {
+                v.split("filename=")
+                    .nth(1)
+                    .map(|f| f.trim_matches('"').to_string())
+            })
+            .unwrap_or_default();
+
+        if !status.is_success() {
+            return Err(self.map_error(status, resp).await);
+        }
+
+        let bytes = resp.bytes().await.map_err(VyncoError::Http)?.to_vec();
+        Ok((bytes, meta, content_type, filename))
+    }
+
     /// Execute a request with retry logic, returning the deserialized body + metadata.
     async fn execute<T: DeserializeOwned>(
         &self,