@bluefly/api v1.0.7

BFAPI - Drupal-Native API Gateway

Status: ⚠️ ARCHIVED - Deliberately abandoned in favor of strategic focus
Alternative: Use Drupal AI module + ECA workflows for API orchestration
Documentation: Central Documentation Hub

High-performance API gateway optimized for Drupal ecosystem integration with AI service orchestration

⚠️ PROJECT STATUS: This package has been strategically archived as part of platform consolidation. The functionality is better served by the native Drupal AI ecosystem (AI module + ECA workflows) which provides superior integration and maintainability.

Strategic Direction

This project has been deliberately abandoned in favor of:

• Drupal AI Module: Native AI provider abstraction layer
• ECA Workflows: Visual workflow automation for API orchestration
• Configuration-First: Leverage community-maintained contrib modules
• Quality Focus: Concentrate resources on working solutions

For current AI integration patterns, see Private LLM Implementation Guide.

Why This Exists Instead of Using Standard API Gateways

Problems with Generic API Gateways (Kong, Ambassador, etc.)

• No Drupal integration: Generic gateways don't understand Drupal permissions, entities, or workflows
• Complex AI routing: Standard gateways lack AI-specific routing and load balancing
• Limited normalization: No built-in API response normalization for consistency
• Authentication gaps: No native integration with Drupal authentication systems

Our Unique Approach

• Drupal-native: Native integration with Drupal permissions, entities, and configuration
• AI-optimized routing: Intelligent routing for AI services with model-specific optimizations
• Response normalization: Consistent API responses across all integrated services
• Performance optimization: Specialized caching and optimization for AI workloads

Open Source Integration

Built on Top of

• Express.js: High-performance Node.js web framework
• OpenAPI 3.1: Standard API documentation and validation
• Redis: High-performance caching and session management
• Prometheus: Metrics collection and monitoring
• JWT: Token-based authentication

Technical Differentiation

• Drupal integration: Native JWT validation with Drupal user permissions
• AI service orchestration: Intelligent routing to bfllm, bfmcp, and external AI services
• Response normalization: Consistent API patterns across all services
• Performance optimization: AI-specific caching and request optimization

Development

npm install
npm run dev          # Development server with hot reload
npm run build        # Production build
npm test             # Run test suite
npm run lint:fix     # Fix code style issues

Integration with Drupal

// Drupal integration via llm module
$apiGateway = \Drupal::service('llm.bfapi_client');
$result = $apiGateway->request('ai/inference', [
  'model' => 'llama2-7b',
  'prompt' => $prompt,
  'user' => $user->id()
]);

AI Service Routing

• bfllm integration: Direct routing to LLM inference service
• bfmcp integration: MCP protocol tool orchestration
• External APIs: OpenAI, Anthropic, and other provider integration
• Load balancing: Intelligent routing based on service health and performance

For detailed technical information, see docs/TECHNICAL_DIFFERENTIATION.md

📚 Platform Documentation

• Complete Platform Overview: Bluefly AI Platform Documentation
• Technical Architecture: System Architecture & Data Flow
• Implementation Guides: Central Guides
• Module Documentation: All Modules
• Package Documentation: All Packages

This project is part of the Bluefly AI Platform - Private LLM enterprise solution with complete data sovereignty.

Last Updated: June 09, 2025