@codai/sdk

v1.0.0

Published

5 months ago

Universal SDK for CODAI Ecosystem - Complete cross-app integration

Downloads

0High
0Medium
0Low

dragoscatalin

codai sdk ecosystem ai integration universal cross-app enterprise

CODAI Universal SDK

The CODAI Universal SDK provides seamless integration across the entire CODAI ecosystem, enabling developers to build applications that leverage the full power of all CODAI services.

🌟 Features

Complete Ecosystem Integration: Access all 36 CODAI applications through a single, unified interface
Type-Safe Development: Full TypeScript support with comprehensive type definitions
Cross-App Communication: Built-in event system for real-time inter-application messaging
Health Monitoring: Comprehensive service health checks and performance monitoring
Enterprise Ready: GDPR/CCPA compliance, security, and audit logging built-in
Modular Architecture: Use only the services you need with tree-shaking support

🚀 Quick Start

Installation

npm install @codai/sdk
# or
pnpm add @codai/sdk
# or
yarn add @codai/sdk

Basic Usage

import { createCodaiSDK } from '@codai/sdk';

const config = {
  appId: 'my-app',
  environment: 'production',
  apiVersion: 'v1',
  endpoints: {
    auth: 'https://logai.ro/api',
    storage: 'https://stocai.ro/api',
    memory: 'https://memorai.ro/api',
    analytics: 'https://analizai.ro/api',
    wallet: 'https://bancai.ro/api',
    marketplace: 'https://marketai.ro/api',
    legal: 'https://legalizai.ro/api',
    support: 'https://ajutai.ro/api',
    identity: 'https://id.codai.ro/api'
  }
};

// Initialize SDK
const sdk = await createCodaiSDK(config);

// Use services
const user = await sdk.auth.login({
  email: '[email protected]',
  password: 'password'
});

// Upload file
const file = new File(['content'], 'document.txt');
const uploadResult = await sdk.storage.uploadFile(file, {
  name: 'document.txt',
  isPublic: false
});

// Track analytics
await sdk.analytics.track('file_uploaded', {
  fileType: 'text',
  size: file.size
});

// Cleanup
await sdk.destroy();

📚 Available Services

Authentication Service (`sdk.auth`)

User authentication and session management
SSO integration with LOGAI.ro
Role-based access control

// Login user
const result = await sdk.auth.login({
  email: '[email protected]',
  password: 'password'
});

// Get current user
const user = await sdk.auth.getCurrentUser();

// Logout
await sdk.auth.logout();

Storage Service (`sdk.storage`)

File upload, download, and management
Integration with STOCAI.ro
Secure file sharing and permissions

// Upload file
const metadata = await sdk.storage.uploadFile(file, {
  name: 'report.pdf',
  tags: ['report', 'quarterly'],
  isPublic: false
});

// Download file
const fileData = await sdk.storage.downloadFile(metadata.id);

// List files
const files = await sdk.storage.getFiles({
  tags: ['report'],
  limit: 10
});

Memory Service (`sdk.memory`)

AI-powered memory and context management
Integration with MEMORAI.ro
Intelligent information retrieval

// Store memory
const memory = await sdk.memory.remember('user123', {
  content: 'User prefers dark theme',
  metadata: { category: 'preferences' }
});

// Recall memories
const memories = await sdk.memory.recall('user123', 'theme preferences');

// Forget memory
await sdk.memory.forget('user123', memory.id);

Analytics Service (`sdk.analytics`)

Real-time analytics and dashboards
Integration with ANALIZAI.ro
User behavior tracking

// Track event
await sdk.analytics.track('page_view', {
  page: '/dashboard',
  user_id: 'user123'
});

// Create dashboard
const dashboard = await sdk.analytics.createDashboard({
  name: 'User Engagement',
  widgets: [
    {
      type: 'line_chart',
      title: 'Daily Active Users',
      metric: 'active_users'
    }
  ]
});

Wallet Service (`sdk.wallet`)

Financial transactions and wallet management
Integration with BANCAI.ro
Multi-currency support

// Create wallet
const wallet = await sdk.wallet.createWallet({
  name: 'Business Wallet',
  currency: 'RON',
  userId: 'user123'
});

// Send payment
const payment = await sdk.wallet.createTransaction({
  fromWalletId: wallet.id,
  amount: 100.00,
  currency: 'RON',
  description: 'Service payment'
});

Marketplace Service (`sdk.marketplace`)

Product listings and e-commerce
Integration with MARKETAI.ro
Order management

// Create product
const product = await sdk.marketplace.createProduct({
  name: 'AI Assistant License',
  price: { amount: 299.99, currency: 'RON' },
  category: 'software'
});

// Search products
const results = await sdk.marketplace.searchProducts({
  query: 'AI assistant',
  categoryId: 'software'
});

// Create order
const order = await sdk.marketplace.createOrder({
  items: [{ productId: product.id, quantity: 1 }],
  customerId: 'user123'
});

Legal Service (`sdk.legal`)

Legal document management
Integration with LEGALIZAI.ro
Compliance automation

// Get templates
const templates = await sdk.legal.getTemplates({
  category: 'contracts'
});

// Create document
const document = await sdk.legal.createDocument({
  templateId: templates[0].id,
  title: 'Service Agreement',
  content: 'Contract content...'
});

// Schedule consultation
const consultation = await sdk.legal.createConsultation({
  type: 'contract_review',
  documentId: document.id
});

Support Service (`sdk.support`)

Customer support and helpdesk
Integration with AJUTAI.ro
Knowledge base and live chat

// Create ticket
const ticket = await sdk.support.createTicket({
  subject: 'Technical Issue',
  description: 'Need help with integration',
  priority: 'medium'
});

// Search knowledge base
const articles = await sdk.support.searchKnowledgeBase({
  query: 'API integration'
});

// Start chat
const chat = await sdk.support.startChat({
  ticketId: ticket.id
});

Identity Service (`sdk.identity`)

Identity verification and KYC
Integration with ID.CODAI.ro
Document verification

// Start verification
const verification = await sdk.identity.createVerification({
  userId: 'user123',
  verificationType: 'enhanced'
});

// Upload document
await sdk.identity.uploadDocument({
  verificationId: verification.id,
  documentType: 'national_id',
  file: documentFile
});

// Get trust score
const trustScore = await sdk.identity.getTrustScore('user123');

🔄 Cross-App Communication

The SDK provides a powerful event system for real-time communication between applications:

// Get event bus
const eventBus = sdk.getEventBus();

// Subscribe to events
eventBus.subscribe('user:action', (data) => {
  console.log('User action:', data);
});

// Send targeted message
eventBus.sendMessage('analytics-app', {
  type: 'user_event',
  data: { action: 'file_upload' }
});

// Broadcast to all apps
eventBus.broadcast({
  type: 'system_notification',
  message: 'Maintenance scheduled'
});

🏥 Health Monitoring

Monitor the health and performance of all services:

// Get health status
const health = await sdk.getHealth();
console.log('System status:', health.status);
console.log('Services:', health.services);

// Subscribe to health events
sdk.getEventBus().subscribe('sdk:health:unhealthy', (data) => {
  console.warn('Health alert:', data);
  // Implement alerting logic
});

⚙️ Configuration

Full Configuration Example

const config = {
  // App identification
  appId: 'my-codai-app',
  environment: 'production', // 'development' | 'staging' | 'production'
  apiVersion: 'v1',
  
  // Service endpoints
  endpoints: {
    auth: 'https://logai.ro/api',
    storage: 'https://stocai.ro/api',
    memory: 'https://memorai.ro/api',
    analytics: 'https://analizai.ro/api',
    wallet: 'https://bancai.ro/api',
    marketplace: 'https://marketai.ro/api',
    legal: 'https://legalizai.ro/api',
    support: 'https://ajutai.ro/api',
    identity: 'https://id.codai.ro/api',
    gateway: 'https://api.codai.ro'
  },
  
  // Authentication settings
  authentication: {
    enabled: true,
    ssoEnabled: true,
    sessionTimeout: 24 * 60 * 60 * 1000, // 24 hours
    refreshThreshold: 5 * 60 * 1000, // 5 minutes
    storage: 'localStorage'
  },
  
  // Security configuration
  security: {
    encryption: {
      enabled: true,
      algorithm: 'AES-256-GCM'
    },
    rateLimiting: {
      enabled: true,
      maxRequests: 1000,
      windowMs: 60 * 1000 // 1 minute
    }
  },
  
  // Compliance settings
  compliance: {
    gdpr: true,
    ccpa: true,
    hipaa: false,
    auditLogging: true
  },
  
  // Request settings
  timeout: 30000,
  retryAttempts: 3,
  retryDelay: 1000,
  
  // Monitoring
  debug: false,
  telemetry: true,
  healthCheckInterval: 60000 // 1 minute
};

🔒 Security & Compliance

The SDK includes built-in security and compliance features:

Encryption: All sensitive data is encrypted using AES-256-GCM
GDPR Compliance: Automatic data handling compliance
CCPA Compliance: California privacy law compliance
Rate Limiting: Configurable request rate limiting
Audit Logging: Comprehensive audit trail
Secure Storage: Encrypted local storage options

🧪 Testing

# Run all tests
pnpm test

# Run with coverage
pnpm test:coverage

# Run specific test file
pnpm test src/__tests__/basic.test.ts

📊 TypeScript Support

The SDK is built with TypeScript and provides comprehensive type definitions:

import type { 
  CodaiConfig, 
  CodaiEventMap, 
  User, 
  FileMetadata,
  Memory,
  Analytics,
  Wallet,
  Product,
  LegalDocument,
  SupportTicket,
  IdentityVerification 
} from '@codai/sdk';

🌍 CODAI Ecosystem

The CODAI Universal SDK integrates with the entire CODAI ecosystem:

LOGAI.ro - Authentication & Identity Management
STOCAI.ro - File Storage & Management
MEMORAI.ro - AI Memory & Context Management
ANALIZAI.ro - Analytics & Business Intelligence
BANCAI.ro - Financial Services & Payments
MARKETAI.ro - E-commerce & Marketplace
LEGALIZAI.ro - Legal Services & Compliance
AJUTAI.ro - Customer Support & Helpdesk
ID.CODAI.ro - Identity Verification & KYC

📋 Examples

Check the examples directory for comprehensive usage examples:

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🚀 Roadmap

[ ] React Native support
[ ] Vue.js integration
[ ] Real-time collaboration features
[ ] Advanced AI integrations
[ ] Blockchain integrations
[ ] Mobile SDK versions

Built with ❤️ by the CODAI Team

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme