@polymorphism-tech/morph-spec 4.3.3 → 4.3.4

package/framework/templates/code/dotnet/contracts/api-contracts.cs

@@ -0,0 +1,173 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}}
+// Stack: Next.js + Supabase + .NET API
+// Generated by MORPH Framework
+// Date: {{DATE}}
+// ============================================================
+
+#region Usings
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+#endregion
+
+namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
+
+#region Configuration
+
+/// <summary>
+/// Supabase configuration options.
+/// Bind from appsettings.json "Supabase" section.
+/// </summary>
+public sealed record SupabaseConfig
+{
+    public required string Url { get; init; }
+    public required string AnonKey { get; init; }
+    public required string ServiceRoleKey { get; init; }
+    public required string JwtSecret { get; init; }
+}
+
+#endregion
+
+#region Pagination
+
+/// <summary>
+/// Pagination query parameters. Use with [AsParameters] in Minimal API.
+/// </summary>
+public sealed record PaginationQuery(
+    int Page = 1,
+    int PageSize = 20)
+{
+    public int Offset => (Page - 1) * PageSize;
+}
+
+/// <summary>
+/// Paginated result wrapper.
+/// </summary>
+public sealed record PagedResult<T>(
+    List<T> Items,
+    int TotalCount,
+    int Page,
+    int PageSize)
+{
+    public int TotalPages => (int)Math.Ceiling(TotalCount / (double)PageSize);
+    public bool HasNext => Page < TotalPages;
+    public bool HasPrevious => Page > 1;
+}
+
+#endregion
+
+#region Repository Interfaces
+
+/// <summary>
+/// Generic repository interface for Supabase/PostgreSQL data access via Dapper.
+/// </summary>
+public interface IRepository<T, TId>
+{
+    Task<T?> GetByIdAsync(TId id, CancellationToken cancellationToken = default);
+    Task<List<T>> GetAllAsync(CancellationToken cancellationToken = default);
+    Task<PagedResult<T>> GetPagedAsync(PaginationQuery query, CancellationToken cancellationToken = default);
+    Task<TId> CreateAsync(T entity, CancellationToken cancellationToken = default);
+    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
+    Task DeleteAsync(TId id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Service Interfaces
+
+/// <summary>
+/// Service for managing {{pascalCase FEATURE_NAME}} operations.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}Service
+{
+    /// <summary>
+    /// Gets a {{pascalCase FEATURE_NAME}} by its identifier.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(Guid id, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Gets paginated list of {{pascalCase FEATURE_NAME}} items.
+    /// </summary>
+    Task<PagedResult<{{pascalCase FEATURE_NAME}}Dto>> GetPagedAsync(PaginationQuery query, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Creates a new {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Updates an existing {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task UpdateAsync(Guid id, Update{{pascalCase FEATURE_NAME}}Request request, Guid userId, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Deletes a {{pascalCase FEATURE_NAME}}.
+    /// </summary>
+    Task DeleteAsync(Guid id, Guid userId, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region DTOs
+
+/// <summary>
+/// Data transfer object for {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record {{pascalCase FEATURE_NAME}}Dto(
+    Guid Id,
+    string Name,
+    Guid UserId,
+    {{pascalCase FEATURE_NAME}}Status Status,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+/// <summary>
+/// Request to create a new {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record Create{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other required fields
+);
+
+/// <summary>
+/// Request to update an existing {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public sealed record Update{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other updatable fields
+);
+
+#endregion
+
+#region Enums
+
+/// <summary>
+/// Status of a {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public enum {{pascalCase FEATURE_NAME}}Status
+{
+    Draft = 0,
+    Active = 1,
+    Completed = 2,
+    Archived = 3,
+    // Error states
+    Failed = 100,
+    Cancelled = 101
+}
+
+#endregion
+
+#region Exceptions
+
+public sealed class {{pascalCase FEATURE_NAME}}NotFoundException(Guid id)
+    : Exception($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.");
+
+public sealed class {{pascalCase FEATURE_NAME}}AccessDeniedException(Guid id, Guid userId)
+    : Exception($"User {userId} does not have access to {{pascalCase FEATURE_NAME}} {id}.");
+
+#endregion

package/framework/templates/code/dotnet/contracts/contracts.cs

@@ -0,0 +1,217 @@
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}}
+// Generated by MORPH Framework
+// Date: {{DATE}}
+// ============================================================
+
+#region Usings
+
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+
+#endregion
+
+namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}};
+
+#region Service Interfaces
+
+/// <summary>
+/// Service for managing {{pascalCase FEATURE_NAME}} operations.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}Service
+{
+    /// <summary>
+    /// Gets a {{FEATURE_NAME_LOWER_SNAKE}} by its identifier.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Gets all {{FEATURE_NAME_LOWER_SNAKE}}s.
+    /// </summary>
+    Task<List<{{pascalCase FEATURE_NAME}}Dto>> GetAllAsync(CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Creates a new {{FEATURE_NAME_LOWER_SNAKE}}.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}Dto> CreateAsync(Create{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Updates an existing {{FEATURE_NAME_LOWER_SNAKE}}.
+    /// </summary>
+    Task UpdateAsync(int id, Update{{pascalCase FEATURE_NAME}}Request request, CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// Deletes a {{FEATURE_NAME_LOWER_SNAKE}}.
+    /// </summary>
+    Task DeleteAsync(int id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region DTOs
+
+/// <summary>
+/// Data transfer object for {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public record {{pascalCase FEATURE_NAME}}Dto(
+    int Id,
+    string Name,
+    {{pascalCase FEATURE_NAME}}Status Status,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+);
+
+/// <summary>
+/// Request to create a new {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public record Create{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other required fields
+);
+
+/// <summary>
+/// Request to update an existing {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public record Update{{pascalCase FEATURE_NAME}}Request(
+    string Name
+    // Add other updatable fields
+);
+
+#endregion
+
+#region Enums
+
+/// <summary>
+/// Status of a {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public enum {{pascalCase FEATURE_NAME}}Status
+{
+    Pending = 0,
+    Active = 1,
+    Completed = 2,
+    Failed = 3
+}
+
+#endregion
+
+#region Repository Interfaces
+
+/// <summary>
+/// Repository for {{pascalCase FEATURE_NAME}} data access.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}Repository
+{
+    Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default);
+    Task<List<{{pascalCase FEATURE_NAME}}>> GetAllAsync(CancellationToken cancellationToken = default);
+    Task AddAsync({{pascalCase FEATURE_NAME}} entity, CancellationToken cancellationToken = default);
+    void Update({{pascalCase FEATURE_NAME}} entity);
+    void Remove({{pascalCase FEATURE_NAME}} entity);
+    Task SaveChangesAsync(CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Domain Entity Reference
+
+/*
+/// <summary>
+/// {{pascalCase FEATURE_NAME}} domain entity.
+/// Implement in Domain/Entities/{{pascalCase FEATURE_NAME}}.cs
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}
+{
+    public int Id { get; private set; }
+    public string Name { get; private set; } = string.Empty;
+    public {{pascalCase FEATURE_NAME}}Status Status { get; private set; }
+    public DateTime CreatedAt { get; private set; }
+    public DateTime? UpdatedAt { get; private set; }
+
+    private {{pascalCase FEATURE_NAME}}() { } // EF Constructor
+
+    public static {{pascalCase FEATURE_NAME}} Create(string name)
+    {
+        return new {{pascalCase FEATURE_NAME}}
+        {
+            Name = name,
+            Status = {{pascalCase FEATURE_NAME}}Status.Pending,
+            CreatedAt = DateTime.UtcNow
+        };
+    }
+
+    public void Activate()
+    {
+        Status = {{pascalCase FEATURE_NAME}}Status.Active;
+        UpdatedAt = DateTime.UtcNow;
+    }
+
+    public void Complete()
+    {
+        Status = {{pascalCase FEATURE_NAME}}Status.Completed;
+        UpdatedAt = DateTime.UtcNow;
+    }
+}
+*/
+
+#endregion
+
+#region AI Agent Interfaces (if applicable)
+
+/// <summary>
+/// AI Agent for {{pascalCase FEATURE_NAME}} analysis.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}AnalyzerAgent
+{
+    /// <summary>
+    /// Analyzes {{FEATURE_NAME_LOWER_SNAKE}} data using AI.
+    /// </summary>
+    Task<{{pascalCase FEATURE_NAME}}AnalysisResult> AnalyzeAsync(
+        {{pascalCase FEATURE_NAME}}Data data,
+        CancellationToken cancellationToken = default);
+}
+
+public record {{pascalCase FEATURE_NAME}}Data(
+    // Input data for analysis
+    string Content
+);
+
+public record {{pascalCase FEATURE_NAME}}AnalysisResult(
+    string Summary,
+    List<string> Insights,
+    List<string> Recommendations,
+    double ConfidenceScore
+);
+
+#endregion
+
+#region Hangfire Job Interfaces (if applicable)
+
+/// <summary>
+/// Background job for processing {{pascalCase FEATURE_NAME}}.
+/// </summary>
+public interface I{{pascalCase FEATURE_NAME}}ProcessorJob
+{
+    /// <summary>
+    /// Executes the {{FEATURE_NAME_LOWER_SNAKE}} processing job.
+    /// </summary>
+    Task ExecuteAsync(int id, CancellationToken cancellationToken = default);
+}
+
+#endregion
+
+#region Exceptions
+
+public class {{pascalCase FEATURE_NAME}}NotFoundException : Exception
+{
+    public {{pascalCase FEATURE_NAME}}NotFoundException(int id)
+        : base($"{{pascalCase FEATURE_NAME}} with ID {id} was not found.") { }
+}
+
+public class {{pascalCase FEATURE_NAME}}ProcessingException : Exception
+{
+    public {{pascalCase FEATURE_NAME}}ProcessingException(string message, Exception? innerException = null)
+        : base(message, innerException) { }
+}
+
+#endregion

package/framework/templates/code/dotnet/database/migration.cs

@@ -0,0 +1,83 @@
+// ============================================================
+// EF CORE MIGRATION TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using Microsoft.EntityFrameworkCore.Migrations;
+
+#nullable disable
+
+namespace {{NAMESPACE}}.Infrastructure.Data.Migrations;
+
+/// <inheritdoc />
+public partial class Add{{pascalCase FEATURE_NAME}} : Migration
+{
+    /// <inheritdoc />
+    protected override void Up(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.CreateTable(
+            name: "{{pascalCase FEATURE_NAME}}s",
+            columns: table => new
+            {
+                Id = table.Column<int>(type: "int", nullable: false)
+                    .Annotation("SqlServer:Identity", "1, 1"),
+                Name = table.Column<string>(type: "nvarchar(200)", maxLength: 200, nullable: false),
+                Status = table.Column<string>(type: "nvarchar(50)", maxLength: 50, nullable: false),
+                CreatedAt = table.Column<DateTime>(type: "datetime2", nullable: false,
+                    defaultValueSql: "GETUTCDATE()"),
+                UpdatedAt = table.Column<DateTime>(type: "datetime2", nullable: true)
+            },
+            constraints: table =>
+            {
+                table.PrimaryKey("PK_{{pascalCase FEATURE_NAME}}s", x => x.Id);
+            });
+
+        // Indexes
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_Name",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "Name");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_Status",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "Status");
+
+        migrationBuilder.CreateIndex(
+            name: "IX_{{pascalCase FEATURE_NAME}}s_CreatedAt",
+            table: "{{pascalCase FEATURE_NAME}}s",
+            column: "CreatedAt");
+    }
+
+    /// <inheritdoc />
+    protected override void Down(MigrationBuilder migrationBuilder)
+    {
+        migrationBuilder.DropTable(
+            name: "{{pascalCase FEATURE_NAME}}s");
+    }
+}
+
+// ============================================================
+// HOW TO CREATE A MIGRATION
+// ============================================================
+//
+// 1. Add your entity to AppDbContext:
+//
+//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
+//
+// 2. Add your configuration:
+//
+//    protected override void OnModelCreating(ModelBuilder modelBuilder)
+//    {
+//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
+//    }
+//
+// 3. Run migration command:
+//
+//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}} -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//
+// 4. Apply migration:
+//
+//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//
+// ============================================================