africanmarketos591/mvr-api-ts-client: MVR API TypeScript Client v2.6.0

🚀 MVR API TypeScript SDK — Version 2.6.0 Released

This is the first official release of the African Market OS — Minimum Viable Relationships (MVR) API TypeScript Client.

The SDK provides a modern, strongly-typed, production-ready interface for interacting with all MVR v2.6.0-enterprise API endpoints.

🔥 Features Included

Core Endpoints

• ✔ MVR Scores
• ✔ Survey Aggregation
• ✔ Trends & Relational Velocity
• ✔ Forecasts & PMF Projections
• ✔ Benchmarking
• ✔ Insights
• ✔ Market Temperature Index
• ✔ Policy Multi-Audit

System Utilities

• ✔ Usage endpoint
• ✔ Metadata endpoint
• ✔ Health checks
• ✔ "Who Am I" endpoint
• ✔ Documentation endpoint

Authentication

• ✔ API Key (License + Buyer Email)
• ✔ Session Tokens (via withSession())

📦 Installation

npm install @africanmarketos/mvr-api-client

🧠 Quick Start
import { MVRApiClient } from '@africanmarketos/mvr-api-client';

// Initialize client
const client = new MVRApiClient({
  license: 'your-license-key',
  email: 'your@email.com'
});

// Fetch MVR Scores
const scores = await client.getScores('fintech');
console.log('MVR Index:', scores.mvr_index);

🔐 Error Handling Example
try {
  const result = await client.getScores();
} catch (error) {
  if (error.error_code === 'RATE_LIMIT_EXCEEDED') {
    console.log(`Rate limited. Retry after ${error.retry_after}s`);
  }
}

🔗 Licensing & Usage Policy

The SDK is MIT-licensed for free use.

However, the MVR Framework™ (methodology, diagnostics, terminology, and indices) follows the African Market OS Commercial & Referral Use Policy.

Machine-readable license:
africanmarketos.com

Commercial-use policy:
africanmarketos.com

🤖 Automated Publishing

This release automatically triggers GitHub Actions to:

Build the SDK

Package it

Publish to npm under:
@africanmarketos/mvr-api-client

No manual action required.

Thank you for using the MVR Framework™ ecosystem.
For support, licensing, or partnerships, contact [info@africanmarketos.com](mailto:info@africanmarketos.com)
.