@polymorphism-tech/morph-spec 4.16.0 → 4.17.0

package/framework/templates/code/dotnet/backend/repository.cs

@@ -1,148 +1,148 @@
-// ============================================================
-// REPOSITORY + UNIT OF WORK TEMPLATE (VSA Pattern)
-// Generated by MORPH Framework
-// ============================================================
-
-using System.Data.Common;
-using Microsoft.EntityFrameworkCore;
-using {{pascalCase PROJECT_NAME}}.Database;
-
-namespace {{pascalCase PROJECT_NAME}}.Repository;
-
-// ============================================================
-// IRepository<T> — Generic repository contract
-// ============================================================
-
-public interface IRepository<T> where T : class
-{
-    Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default);
-    Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default);
-    Task<T> AddAsync(T entity, CancellationToken cancellationToken = default);
-    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
-    Task DeleteAsync(T entity, CancellationToken cancellationToken = default);
-    IEnumerable<T> ExecuteQuery(string query, DbParameter[] dbParams);
-    Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default);
-    void RemoveRange(IEnumerable<T> entities);
-}
-
-// ============================================================
-// IUnitOfWork — Transaction boundary contract
-// ============================================================
-
-public interface IUnitOfWork
-{
-    int Commit();
-    void Rollback();
-    Task<int> CommitAsync(CancellationToken cancellationToken = default);
-    Task RollbackAsync();
-}
-
-// ============================================================
-// Repository<T> — EF Core generic repository implementation
-// ============================================================
-
-public class Repository<T> : IRepository<T> where T : class
-{
-    private readonly ApplicationDbContext _context;
-    private readonly DbSet<T> _dbSet;
-
-    public Repository(ApplicationDbContext context)
-    {
-        _context = context;
-        _dbSet = _context.Set<T>();
-    }
-
-    public async Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default)
-    {
-        return await _dbSet.ToListAsync(cancellationToken);
-    }
-
-    public async Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default)
-    {
-        return await _dbSet.FindAsync(new[] { id }, cancellationToken);
-    }
-
-    public async Task<T> AddAsync(T entity, CancellationToken cancellationToken = default)
-    {
-        await _dbSet.AddAsync(entity, cancellationToken);
-        return entity;
-    }
-
-    public Task UpdateAsync(T entity, CancellationToken cancellationToken = default)
-    {
-        _dbSet.Update(entity);
-        return Task.CompletedTask;
-    }
-
-    public Task DeleteAsync(T entity, CancellationToken cancellationToken = default)
-    {
-        _dbSet.Remove(entity);
-        return Task.CompletedTask;
-    }
-
-    public IEnumerable<T> ExecuteQuery(string query, DbParameter[] dbParams)
-    {
-        return _dbSet
-            .FromSqlRaw(query, dbParams)
-            .AsNoTracking()
-            .AsEnumerable();
-    }
-
-    public async Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default)
-    {
-        await _dbSet.AddRangeAsync(entities, cancellationToken);
-    }
-
-    public void RemoveRange(IEnumerable<T> entities)
-    {
-        _dbSet.RemoveRange(entities);
-    }
-}
-
-// ============================================================
-// UnitOfWork — EF Core transaction management
-// ============================================================
-
-public class UnitOfWork : IUnitOfWork
-{
-    private readonly ApplicationDbContext _dataContext;
-
-    public UnitOfWork(ApplicationDbContext dataContext)
-    {
-        _dataContext = dataContext;
-    }
-
-    public int Commit()
-    {
-        return _dataContext.SaveChanges();
-    }
-
-    public async Task<int> CommitAsync(CancellationToken cancellationToken = default)
-    {
-        return await _dataContext.SaveChangesAsync(cancellationToken);
-    }
-
-    public void Rollback()
-    {
-        _dataContext.Dispose();
-    }
-
-    public async Task RollbackAsync()
-    {
-        await _dataContext.DisposeAsync();
-    }
-}
-
-// ============================================================
-// DI REGISTRATION
-// ============================================================
-//
-// In Program.cs or a DI extension method:
-//
-// builder.Services.AddDbContext<ApplicationDbContext>(options =>
-//     options.UseSqlServer(connectionString));
-//
-// builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
-// builder.Services.AddScoped<IUnitOfWork, UnitOfWork>();
-//
-// ============================================================
+// ============================================================
+// REPOSITORY + UNIT OF WORK TEMPLATE (VSA Pattern)
+// Generated by MORPH Framework
+// ============================================================
+
+using System.Data.Common;
+using Microsoft.EntityFrameworkCore;
+using {{pascalCase PROJECT_NAME}}.Database;
+
+namespace {{pascalCase PROJECT_NAME}}.Repository;
+
+// ============================================================
+// IRepository<T> — Generic repository contract
+// ============================================================
+
+public interface IRepository<T> where T : class
+{
+    Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default);
+    Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default);
+    Task<T> AddAsync(T entity, CancellationToken cancellationToken = default);
+    Task UpdateAsync(T entity, CancellationToken cancellationToken = default);
+    Task DeleteAsync(T entity, CancellationToken cancellationToken = default);
+    IEnumerable<T> ExecuteQuery(string query, DbParameter[] dbParams);
+    Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default);
+    void RemoveRange(IEnumerable<T> entities);
+}
+
+// ============================================================
+// IUnitOfWork — Transaction boundary contract
+// ============================================================
+
+public interface IUnitOfWork
+{
+    int Commit();
+    void Rollback();
+    Task<int> CommitAsync(CancellationToken cancellationToken = default);
+    Task RollbackAsync(CancellationToken cancellationToken = default);
+}
+
+// ============================================================
+// Repository<T> — EF Core generic repository implementation
+// ============================================================
+
+public class Repository<T> : IRepository<T> where T : class
+{
+    private readonly ApplicationDbContext _context;
+    private readonly DbSet<T> _dbSet;
+
+    public Repository(ApplicationDbContext context)
+    {
+        _context = context;
+        _dbSet = _context.Set<T>();
+    }
+
+    public async Task<IEnumerable<T>> GetAllAsync(CancellationToken cancellationToken = default)
+    {
+        return await _dbSet.ToListAsync(cancellationToken);
+    }
+
+    public async Task<T?> GetByIdAsync(object id, CancellationToken cancellationToken = default)
+    {
+        return await _dbSet.FindAsync(new[] { id }, cancellationToken);
+    }
+
+    public async Task<T> AddAsync(T entity, CancellationToken cancellationToken = default)
+    {
+        await _dbSet.AddAsync(entity, cancellationToken);
+        return entity;
+    }
+
+    public Task UpdateAsync(T entity, CancellationToken cancellationToken = default)
+    {
+        _dbSet.Update(entity);
+        return Task.CompletedTask;
+    }
+
+    public Task DeleteAsync(T entity, CancellationToken cancellationToken = default)
+    {
+        _dbSet.Remove(entity);
+        return Task.CompletedTask;
+    }
+
+    public IEnumerable<T> ExecuteQuery(string query, DbParameter[] dbParams)
+    {
+        return _dbSet
+            .FromSqlRaw(query, dbParams)
+            .AsNoTracking()
+            .AsEnumerable();
+    }
+
+    public async Task AddRangeAsync(IEnumerable<T> entities, CancellationToken cancellationToken = default)
+    {
+        await _dbSet.AddRangeAsync(entities, cancellationToken);
+    }
+
+    public void RemoveRange(IEnumerable<T> entities)
+    {
+        _dbSet.RemoveRange(entities);
+    }
+}
+
+// ============================================================
+// UnitOfWork — EF Core transaction management
+// ============================================================
+
+public class UnitOfWork : IUnitOfWork
+{
+    private readonly ApplicationDbContext _dataContext;
+
+    public UnitOfWork(ApplicationDbContext dataContext)
+    {
+        _dataContext = dataContext;
+    }
+
+    public int Commit()
+    {
+        return _dataContext.SaveChanges();
+    }
+
+    public async Task<int> CommitAsync(CancellationToken cancellationToken = default)
+    {
+        return await _dataContext.SaveChangesAsync(cancellationToken);
+    }
+
+    public void Rollback()
+    {
+        _dataContext.Dispose();
+    }
+
+    public async Task RollbackAsync(CancellationToken cancellationToken = default)
+    {
+        await _dataContext.DisposeAsync();
+    }
+}
+
+// ============================================================
+// DI REGISTRATION
+// ============================================================
+//
+// In Program.cs or a DI extension method:
+//
+// builder.Services.AddDbContext<ApplicationDbContext>(options =>
+//     options.UseSqlServer(connectionString));
+//
+// builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
+// builder.Services.AddScoped<IUnitOfWork, UnitOfWork>();
+//
+// ============================================================

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

@@ -34,7 +34,7 @@ namespace {{NAMESPACE}}.Abstractions
 {
     public interface IApiEndpoint
     {
-        void MapEndpoint(WebApplication app);
+        void MapEndpoint(IEndpointRouteBuilder app);
     }
 }
 
@@ -235,7 +235,7 @@ using {{NAMESPACE}}.Extensions;
 
 internal sealed class Create{{pascalCase FEATURE_NAME}}Endpoint : IApiEndpoint
 {
-    public void MapEndpoint(WebApplication app)
+    public void MapEndpoint(IEndpointRouteBuilder app)
     {
         app.MapPost("{{ROUTE}}", async (
             IHandler<Create{{pascalCase FEATURE_NAME}}Request, Result<Create{{pascalCase FEATURE_NAME}}Response>> handler,

package/framework/templates/code/dotnet/database/vector-entity.cs

@@ -0,0 +1,93 @@
+// ============================================================
+// PGVECTOR ENTITY + CONFIGURATION TEMPLATE
+// Generated by MORPH Framework
+// ============================================================
+
+using System.ComponentModel.DataAnnotations.Schema;
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using Pgvector;
+
+#nullable disable
+
+namespace {{NAMESPACE}}.Domain.Entities;
+
+/// <summary>
+/// Entity with vector embedding for similarity search via pgvector.
+/// Dimensions: 1536 (text-embedding-3-small). Adjust if using a different model.
+/// </summary>
+public class {{pascalCase FEATURE_NAME}}
+{
+    public Guid Id { get; set; }
+    public string Title { get; set; } = string.Empty;
+    public string Content { get; set; } = string.Empty;
+    public string? Metadata { get; set; }
+
+    [Column(TypeName = "vector(1536)")]
+    public Vector? Embedding { get; set; }
+
+    public DateTimeOffset CreatedAt { get; set; } = DateTimeOffset.UtcNow;
+    public DateTimeOffset? UpdatedAt { get; set; }
+}
+
+// ============================================================
+// ENTITY TYPE CONFIGURATION
+// ============================================================
+
+namespace {{NAMESPACE}}.Infrastructure.Data.Configurations;
+
+public class {{pascalCase FEATURE_NAME}}Configuration : IEntityTypeConfiguration<{{pascalCase FEATURE_NAME}}>
+{
+    public void Configure(EntityTypeBuilder<{{pascalCase FEATURE_NAME}}> builder)
+    {
+        builder.ToTable("{{snakeCase FEATURE_NAME}}s");
+        builder.HasKey(e => e.Id);
+        builder.Property(e => e.Id).HasDefaultValueSql("gen_random_uuid()");
+        builder.Property(e => e.Title).IsRequired().HasMaxLength(200);
+        builder.Property(e => e.Content).IsRequired();
+        builder.Property(e => e.Metadata).HasColumnType("jsonb");
+        builder.Property(e => e.Embedding).HasColumnType("vector(1536)");
+        builder.Property(e => e.CreatedAt).HasDefaultValueSql("now()");
+
+        // HNSW index for cosine similarity search
+        builder.HasIndex(e => e.Embedding)
+            .HasMethod("hnsw")
+            .HasOperators("vector_cosine_ops")
+            .HasStorageParameter("m", 16)
+            .HasStorageParameter("ef_construction", 64);
+
+        builder.HasIndex(e => e.Title);
+    }
+}
+
+// ============================================================
+// SETUP INSTRUCTIONS
+// ============================================================
+//
+// 1. Install NuGet packages:
+//
+//    dotnet add package Pgvector.EntityFrameworkCore
+//    dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
+//
+// 2. Configure NpgsqlDataSource with vector support in Program.cs:
+//
+//    builder.Services.AddNpgsql<AppDbContext>(
+//        connectionString,
+//        npgsqlOptions => npgsqlOptions.UseVector());
+//
+// 3. Register in DbContext:
+//
+//    public DbSet<{{pascalCase FEATURE_NAME}}> {{pascalCase FEATURE_NAME}}s => Set<{{pascalCase FEATURE_NAME}}>();
+//
+//    protected override void OnModelCreating(ModelBuilder modelBuilder)
+//    {
+//        modelBuilder.HasPostgresExtension("vector");
+//        modelBuilder.ApplyConfiguration(new {{pascalCase FEATURE_NAME}}Configuration());
+//    }
+//
+// 4. Create and apply migration:
+//
+//    dotnet ef migrations add Add{{pascalCase FEATURE_NAME}}WithVector -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//    dotnet ef database update -p src/{{NAMESPACE}}.Infrastructure -s src/{{NAMESPACE}}.Web
+//
+// ============================================================

package/framework/templates/code/dotnet/feature/endpoint.cs.hbs

@@ -5,7 +5,7 @@ namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Featur
 
 internal sealed class {{pascalCase SLICE_NAME}}Endpoint : IApiEndpoint
 {
-    public void MapEndpoint(WebApplication app)
+    public void MapEndpoint(IEndpointRouteBuilder app)
     {
         app.MapPost("{{kebabCase FEATURE_NAME}}s", async (IHandler<{{pascalCase SLICE_NAME}}Request, Result<{{pascalCase SLICE_NAME}}Response>> handler, {{pascalCase SLICE_NAME}}Request command, CancellationToken cancellationToken) =>
         {

package/framework/templates/code/sql/{supabase-migration.sql → postgresql-migration.sql}

@@ -1,9 +1,8 @@
 -- ============================================================
 -- Migration: {{titleCase FEATURE_NAME}}
--- Stack: Next.js + Supabase
+-- Stack: Next.js + Neon
 -- Generated by MORPH Framework
 -- Date: {{DATE}}
--- Run: supabase db push
 -- ============================================================
 
 -- ============================================================
@@ -12,7 +11,7 @@
 
 create table if not exists public.{{TABLE_NAME}} (
   id uuid primary key default gen_random_uuid(),
-  user_id uuid not null references auth.users(id) on delete cascade,
+  user_id text not null,
   name text not null,
   status text not null default 'draft'
     check (status in ('draft', 'active', 'completed', 'archived', 'failed', 'cancelled')),
@@ -66,35 +65,27 @@ create trigger set_{{TABLE_NAME}}_updated_at
 -- Enable RLS
 alter table public.{{TABLE_NAME}} enable row level security;
 
--- Users can read their own rows
+-- Users can read their own rows (Clerk JWT)
 create policy "Users can read own {{TABLE_NAME}}"
   on public.{{TABLE_NAME}}
   for select
-  using (auth.uid() = user_id);
+  using (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
 -- Users can insert rows for themselves
 create policy "Users can insert own {{TABLE_NAME}}"
   on public.{{TABLE_NAME}}
   for insert
-  with check (auth.uid() = user_id);
+  with check (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
 -- Users can update their own rows
 create policy "Users can update own {{TABLE_NAME}}"
   on public.{{TABLE_NAME}}
   for update
-  using (auth.uid() = user_id)
-  with check (auth.uid() = user_id);
+  using (current_setting('request.jwt.claims')::json->>'sub' = user_id)
+  with check (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
 -- Users can delete their own rows
 create policy "Users can delete own {{TABLE_NAME}}"
   on public.{{TABLE_NAME}}
   for delete
-  using (auth.uid() = user_id);
-
--- ============================================================
--- 5. GRANTS
--- ============================================================
-
--- Grant access to authenticated users (via Supabase API)
-grant select, insert, update, delete on public.{{TABLE_NAME}} to authenticated;
-grant usage on schema public to authenticated;
+  using (current_setting('request.jwt.claims')::json->>'sub' = user_id);

package/framework/templates/code/sql/{supabase-migration.template.sql → postgresql-migration.template.sql}

@@ -19,7 +19,7 @@ create table if not exists public.{{TABLE_NAME}} (
   is_active boolean default true not null,
 
   -- Foreign keys (example)
-  -- user_id uuid references auth.users(id) on delete cascade,
+  -- user_id text not null,
 
   -- Timestamps
   created_at timestamptz default now() not null,
@@ -70,30 +70,27 @@ create policy "{{TABLE_NAME}}_select_policy"
   on public.{{TABLE_NAME}} for select
   using (true);
 
--- Policy: Users can only insert their own records (example)
+-- Policy: Users can only insert their own records (Clerk JWT)
 -- create policy "{{TABLE_NAME}}_insert_policy"
 --   on public.{{TABLE_NAME}} for insert
---   with check (auth.uid() = user_id);
+--   with check (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
--- Policy: Users can only update their own records (example)
+-- Policy: Users can only update their own records (Clerk JWT)
 -- create policy "{{TABLE_NAME}}_update_policy"
 --   on public.{{TABLE_NAME}} for update
---   using (auth.uid() = user_id)
---   with check (auth.uid() = user_id);
+--   using (current_setting('request.jwt.claims')::json->>'sub' = user_id)
+--   with check (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
--- Policy: Users can only delete their own records (example)
+-- Policy: Users can only delete their own records (Clerk JWT)
 -- create policy "{{TABLE_NAME}}_delete_policy"
 --   on public.{{TABLE_NAME}} for delete
---   using (auth.uid() = user_id);
+--   using (current_setting('request.jwt.claims')::json->>'sub' = user_id);
 
--- Policy: Admins have full access (example)
+-- Policy: Admins have full access (Clerk JWT)
 -- create policy "{{TABLE_NAME}}_admin_policy"
 --   on public.{{TABLE_NAME}} for all
 --   using (
---     exists (
---       select 1 from public.user_roles
---       where user_id = auth.uid() and role = 'admin'
---     )
+--     current_setting('request.jwt.claims')::json->>'role' = 'admin'
 --   );
 
 -- ========================================

package/framework/templates/code/sql/{rls-policy.sql → postgresql-rls-policy.sql}

@@ -1,6 +1,6 @@
 -- ============================================================
 -- RLS Policy: {{titleCase FEATURE_NAME}}
--- Stack: Next.js + Supabase
+-- Stack: Next.js + Neon
 -- Generated by MORPH Framework
 -- Date: {{DATE}}
 -- ============================================================
@@ -42,16 +42,16 @@ create policy "{{POLICY_NAME}}_delete"
 -- ============================================================
 -- Common USING / WITH CHECK expressions:
 --
--- Owner-based:
---   auth.uid() = user_id
+-- Owner-based (Clerk JWT):
+--   current_setting('request.jwt.claims')::json->>'sub' = user_id
 --
--- Role-based:
---   auth.jwt() ->> 'role' = 'admin'
+-- Role-based (Clerk JWT):
+--   current_setting('request.jwt.claims')::json->>'role' = 'admin'
 --
--- Organization-based:
---   org_id in (select org_id from public.org_members where user_id = auth.uid())
+-- Organization-based (Clerk JWT):
+--   org_id = (current_setting('request.jwt.claims')::json->>'org_id')
 --
 -- Public read, owner write:
 --   SELECT using (true)
---   INSERT/UPDATE/DELETE using (auth.uid() = user_id)
+--   INSERT/UPDATE/DELETE using (current_setting('request.jwt.claims')::json->>'sub' = user_id)
 -- ============================================================