SmartCoreHub Core SDK Extensions VC

VS Code / Cursor helper for the NuGet package SmartCoreHub.Core.SDK.

Extensão para trazer o catálogo grande de inteligência do NuGet SmartCoreHub.Core.SDK para o editor: inventário navegável (~291 tipos públicos), snippets com IntelliSense (sch-*), docs de migração e prompts para agentes (Copilot / Cursor).

Propósito

O pacote NuGet continua a ser a fonte dos tipos; a extensão é a camada de descoberta e padrões no IDE.

Para quem é

• Quem precisa descobrir a superfície do SDK sem abrir o monólito
• Quem migra legado (Result/Guard/cache/repos/ASP.NET) via NuGet
• Times que usam Copilot/Cursor e anexam AI-CONTEXT + API-CATALOG + MIGRATION-GUIDE

Como começar

1. Workspace .NET (net8.0 / net10.0 recomendados para APIs “heavy”).
2. Command Palette → SmartCoreHub SDK: Install NuGet Package
   (ou dotnet add package SmartCoreHub.Core.SDK).
3. Abra a activity bar SmartCoreHub SDK → API Catalog e explore namespaces/tipos.
4. Digite sch no editor C# (ou Insert Snippet…) para padrões do SDK.
5. Prepare Agent Context — docs + clipboard para @ no chat.
6. Código legado selecionado → Suggest Migration for Selection → cole no agente.

Catálogo e IntelliSense

Navegar o inventário

1. Sidebar API Catalog — namespaces do API-CATALOG.md (~291 tipos).
2. Abra um tipo para ir à secção do catálogo (ou ao .cs se o monólito estiver no workspace).
3. Open API Catalog — markdown completo (cache NuGet ou monólito).

Snippets (IntelliSense de padrões)

Após o NuGet instalado, o IntelliSense Roslyn completa membros dos tipos; os snippets aceleram os padrões certos (ex.: IApplicationDispatcher na borda HTTP, não IMediator).

Exemplos de uso

A — Domínio com Result + Guard

using SmartCoreHub.Core.SDK.Domain.Common;
using SmartCoreHub.Core.SDK.Domain.Validation;

public Result<string> Normalize(string input)
{
    Guard.AgainstEmptyString(input, nameof(input));
    return Result.Success(input.Trim());
}

B — Controller HTTP (sem IMediator na borda)

using SmartCoreHub.Core.SDK.Service.API.Generic;
using SmartCoreHub.Core.SDK.Application.Cqrs.Abstractions;
using SmartCoreHub.Core.SDK.Domain.DTOs.Common;

[ApiController]
[Route("api/[controller]")]
public class ProductsController(IApplicationDispatcher dispatcher) : BaseApiController
{
    [HttpPost]
    public Task<ServiceResponse<Guid>> Create(CreateProductCommand cmd, CancellationToken ct)
        => dispatcher.SendAsync(cmd, ct);
}

C — DI mínimo

services.AddSdkCorePrimitives(includeNullAppLogger: false);
services.AddSdkCaching();
services.AddScoped(typeof(IGenericRepository<>), typeof(GenericRepository<>));

D — IA + catálogo

1. Prepare Agent Context (abre AI-CONTEXT, API-CATALOG, MIGRATION-GUIDE + clipboard).
2. No chat, cole o clipboard e @-anexe os três ficheiros.
3. Selecione legado → Suggest Migration → cole de novo.

Cursor: sem API estável de auto-@; Prepare Agent Context + anexo manual é o fluxo suportado.

Comandos (Command Palette)

Dicas

• TFM: net8.0 / net10.0 para EF/Dapper/Redis/ASP.NET/CQRS.
• Controllers: IApplicationDispatcher + ServiceResponse<T> — nunca IMediator na borda HTTP.
• Docs: %USERPROFILE%\.nuget\packages\smartcorehub.core.sdk\<versão>\
• Ordem de migração: Domain → Infrastructure → API → Hosting/CQRS (MIGRATION-GUIDE.md).

O que NÃO migrar para o NuGet

• Validators FluentValidation de feature (host)
• DbContext, migrations e entidades de produto
• JwtTokenService / API Key acoplados ao domínio do host

Recursos

• NuGet: https://www.nuget.org/packages/SmartCoreHub.Core.SDK/
• Requisitos / visão: Documentation/Features/SmartCoreHub.Core.SDK-Extensões-IDE/
• Melhorias de catálogo/IntelliSense: …-Melhorias-Catalogo-IntelliSense.md