@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

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

@@ -1,173 +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
+// ============================================================
+// 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