🧠 Core Module - Núcleo Agnóstico da Rede Anku

Este módulo contém as regras de negócio fundamentais da rede, totalmente agnósticas de tecnologia.

📁 Estrutura

core/
  types/           # Tipos fundamentais (Post, Host, Profile)
  contracts/       # Interfaces/contratos abstratos
  services/        # Serviços de negócio (lógica pura)
  adapters/        # Adaptadores para frameworks específicos
    nestjs/        # Adaptadores para NestJS

🎯 Princípios

1. Agnóstico: Não depende de nenhum framework
2. Portável: Pode ser usado com qualquer tecnologia
3. Testável: Lógica de negócio isolada e fácil de testar
4. Extensível: Fácil adicionar novos adapters

📋 Ações Mínimas da Rede

O core define as operações essenciais para a rede funcionar:

Posts

• publishPost() - Publicar novo post
• getPost() - Buscar post por ID
• getPosts() - Listar todos os posts

Seguir

• followHost() - Seguir um host/autor
• getFollowedHosts() - Listar hosts seguidos

Perfil

• getLocalProfile() - Perfil do autor local
• getRemoteProfile() - Perfil de autor remoto
• getLocalConfig() - Configuração local
• getRemoteConfig() - Configuração remota

Sincronização

• syncWithFollowedHosts() - Sincronizar com hosts seguidos

🔌 Contratos

O core define contratos (interfaces) que qualquer implementação deve seguir:

• INetworkNode - Contrato principal do nó
• IPostRepository - Contrato para repositório de posts
• IHostRepository - Contrato para repositório de hosts

🔄 Como Usar

Com NestJS (atual)

import { NestNetworkNodeAdapter } from './core/adapters/nestjs';

// No seu módulo
@Module({
  providers: [
    NestNetworkNodeAdapter,
    // ... outros providers
  ],
})
export class AppModule {}

// No seu serviço
constructor(
  private readonly networkNodeAdapter: NestNetworkNodeAdapter,
) {
  this.node = networkNodeAdapter.createNetworkNode(
    'http://localhost:3000',
    'user'
  );
}

// Usar
await this.node.publishPost({ content: 'Hello!' });

Com Outro Framework

Crie um adapter similar ao NestJS adapter, implementando os contratos:

import { NetworkNodeService } from '@anku/core';
import { IPostRepository, IHostRepository } from '@anku/core';

class MyPostRepository implements IPostRepository {
  // Implementar métodos...
}

class MyHostRepository implements IHostRepository {
  // Implementar métodos...
}

const node = new NetworkNodeService(
  new MyPostRepository(),
  new MyHostRepository(),
  // ... providers
);

🚀 Benefícios

1. Reutilização: O mesmo core pode ser usado em diferentes projetos
2. Testabilidade: Fácil testar lógica de negócio isoladamente
3. Flexibilidade: Trocar de framework sem reescrever lógica
4. Clareza: Separação clara entre regras de negócio e infraestrutura