@polymorphism-tech/morph-spec 4.16.0 → 4.18.0

package/framework/templates/code/typescript/contracts.ts

@@ -1,168 +1,167 @@
-// ============================================================
-// CONTRACTS: {{titleCase FEATURE_NAME}}
-// Stack: Next.js + Supabase
-// Generated by MORPH Framework
-// Date: {{DATE}}
-// ============================================================
-
-// ----- Supabase Config -----
-
-export interface SupabaseConfig {
-  url: string;
-  anonKey: string;
-}
-
-// ----- API Client Types -----
-
-export interface ApiClientConfig {
-  baseUrl: string;
-  getAccessToken: () => Promise<string | null>;
-}
-
-export interface ApiError {
-  message: string;
-  code: string;
-  statusCode: number;
-  details?: Record<string, string[]>;
-}
-
-export type ApiResult<T> =
-  | { success: true; data: T }
-  | { success: false; error: ApiError };
-
-// ----- Pagination -----
-
-export interface PaginationQuery {
-  page?: number;
-  pageSize?: number;
-}
-
-export interface PagedResult<T> {
-  items: T[];
-  totalCount: number;
-  page: number;
-  pageSize: number;
-  totalPages: number;
-  hasNext: boolean;
-  hasPrevious: boolean;
-}
-
-// ----- Supabase Client Type Aliases -----
-// Generated by: supabase gen types typescript --project-id <id> > types/database.ts
-
-export type Tables<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Row"];
-
-export type Insertable<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Insert"];
-
-export type Updatable<T extends keyof Database["public"]["Tables"]> =
-  Database["public"]["Tables"][T]["Update"];
-
-// ----- Database Schema (placeholder - replace with generated types) -----
-
-export interface Database {
-  public: {
-    Tables: {
-      {{FEATURE_NAME}}: {
-        Row: {
-          id: string;
-          name: string;
-          user_id: string;
-          status: {{pascalCase FEATURE_NAME}}Status;
-          created_at: string;
-          updated_at: string | null;
-        };
-        Insert: {
-          id?: string;
-          name: string;
-          user_id?: string;
-          status?: {{pascalCase FEATURE_NAME}}Status;
-          created_at?: string;
-          updated_at?: string | null;
-        };
-        Update: {
-          id?: string;
-          name?: string;
-          user_id?: string;
-          status?: {{pascalCase FEATURE_NAME}}Status;
-          created_at?: string;
-          updated_at?: string | null;
-        };
-      };
-    };
-    Views: Record<string, never>;
-    Functions: Record<string, never>;
-    Enums: {
-      {{FEATURE_NAME}}_status: {{pascalCase FEATURE_NAME}}Status;
-    };
-  };
-}
-
-// ----- Feature Types -----
-
-export type {{pascalCase FEATURE_NAME}}Status =
-  | "draft"
-  | "active"
-  | "completed"
-  | "archived"
-  | "failed"
-  | "cancelled";
-
-export interface {{pascalCase FEATURE_NAME}} {
-  id: string;
-  name: string;
-  userId: string;
-  status: {{pascalCase FEATURE_NAME}}Status;
-  createdAt: string;
-  updatedAt: string | null;
-}
-
-export interface Create{{pascalCase FEATURE_NAME}}Input {
-  name: string;
-  // Add other required fields
-}
-
-export interface Update{{pascalCase FEATURE_NAME}}Input {
-  name?: string;
-  // Add other updatable fields
-}
-
-// ----- Storage Types -----
-
-export interface StorageUpload {
-  bucket: string;
-  path: string;
-  file: File;
-  contentType?: string;
-}
-
-export interface StorageFile {
-  id: string;
-  name: string;
-  bucket: string;
-  path: string;
-  publicUrl: string;
-  size: number;
-  contentType: string;
-  createdAt: string;
-}
-
-// ----- Auth Types -----
-
-export interface AuthUser {
-  id: string;
-  email: string;
-  displayName: string | null;
-  avatarUrl: string | null;
-}
-
-export interface AuthSession {
-  user: AuthUser;
-  accessToken: string;
-  expiresAt: number;
-}
-
-// ----- Form Schemas (use with zod) -----
-// Define zod schemas in component files, not here.
-// This file is for type definitions only.
+// ============================================================
+// CONTRACTS: {{titleCase FEATURE_NAME}}
+// Stack: Next.js + Neon
+// Generated by MORPH Framework
+// Date: {{DATE}}
+// ============================================================
+
+// ----- Neon Config -----
+
+export interface NeonConfig {
+  connectionString: string;
+}
+
+// ----- API Client Types -----
+
+export interface ApiClientConfig {
+  baseUrl: string;
+  getAccessToken: () => Promise<string | null>;
+}
+
+export interface ApiError {
+  message: string;
+  code: string;
+  statusCode: number;
+  details?: Record<string, string[]>;
+}
+
+export type ApiResult<T> =
+  | { success: true; data: T }
+  | { success: false; error: ApiError };
+
+// ----- Pagination -----
+
+export interface PaginationQuery {
+  page?: number;
+  pageSize?: number;
+}
+
+export interface PagedResult<T> {
+  items: T[];
+  totalCount: number;
+  page: number;
+  pageSize: number;
+  totalPages: number;
+  hasNext: boolean;
+  hasPrevious: boolean;
+}
+
+// ----- Database Client Type Aliases -----
+// Generated by your ORM (Drizzle or Prisma) from your Neon PostgreSQL schema
+
+export type Tables<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Row"];
+
+export type Insertable<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Insert"];
+
+export type Updatable<T extends keyof Database["public"]["Tables"]> =
+  Database["public"]["Tables"][T]["Update"];
+
+// ----- Database Schema (placeholder - replace with generated types) -----
+
+export interface Database {
+  public: {
+    Tables: {
+      {{FEATURE_NAME}}: {
+        Row: {
+          id: string;
+          name: string;
+          user_id: string;
+          status: {{pascalCase FEATURE_NAME}}Status;
+          created_at: string;
+          updated_at: string | null;
+        };
+        Insert: {
+          id?: string;
+          name: string;
+          user_id?: string;
+          status?: {{pascalCase FEATURE_NAME}}Status;
+          created_at?: string;
+          updated_at?: string | null;
+        };
+        Update: {
+          id?: string;
+          name?: string;
+          user_id?: string;
+          status?: {{pascalCase FEATURE_NAME}}Status;
+          created_at?: string;
+          updated_at?: string | null;
+        };
+      };
+    };
+    Views: Record<string, never>;
+    Functions: Record<string, never>;
+    Enums: {
+      {{FEATURE_NAME}}_status: {{pascalCase FEATURE_NAME}}Status;
+    };
+  };
+}
+
+// ----- Feature Types -----
+
+export type {{pascalCase FEATURE_NAME}}Status =
+  | "draft"
+  | "active"
+  | "completed"
+  | "archived"
+  | "failed"
+  | "cancelled";
+
+export interface {{pascalCase FEATURE_NAME}} {
+  id: string;
+  name: string;
+  userId: string;
+  status: {{pascalCase FEATURE_NAME}}Status;
+  createdAt: string;
+  updatedAt: string | null;
+}
+
+export interface Create{{pascalCase FEATURE_NAME}}Input {
+  name: string;
+  // Add other required fields
+}
+
+export interface Update{{pascalCase FEATURE_NAME}}Input {
+  name?: string;
+  // Add other updatable fields
+}
+
+// ----- Storage Types -----
+
+export interface StorageUpload {
+  bucket: string;
+  path: string;
+  file: File;
+  contentType?: string;
+}
+
+export interface StorageFile {
+  id: string;
+  name: string;
+  bucket: string;
+  path: string;
+  publicUrl: string;
+  size: number;
+  contentType: string;
+  createdAt: string;
+}
+
+// ----- Auth Types -----
+
+export interface AuthUser {
+  id: string;
+  email: string;
+  displayName: string | null;
+  avatarUrl: string | null;
+}
+
+export interface AuthSession {
+  user: AuthUser;
+  accessToken: string;
+  expiresAt: number;
+}
+
+// ----- Form Schemas (use with zod) -----
+// Define zod schemas in component files, not here.
+// This file is for type definitions only.

package/framework/templates/context/CONTEXT.md

@@ -28,9 +28,9 @@
 
 ### Database
 {{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
-{{#if SUPABASE_ENABLED}}- **Supabase** (PostgreSQL + Auth + Storage + RLS)
-  - Project: {{SUPABASE_PROJECT_ID}}
-  - Region: {{SUPABASE_REGION}}
+{{#if NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
+  - Project: {{NEON_PROJECT_ID}}
+  - Region: {{NEON_REGION}}
 {{/if}}
 
 ### Infrastructure

package/framework/templates/docs/proposal.md

@@ -52,12 +52,12 @@
 2. **{Feature 2}** - {brief description}
 3. **{Feature 3}** - {brief description}
 
-{{#if (eq STACK "nextjs-supabase")}}
+{{#if (eq STACK "nextjs-neon")}}
 ### Technical Approach
 
 | Layer | Technology | Role |
 |-------|-----------|------|
-| **Database** | Supabase (PostgreSQL + RLS) | {tables, policies, storage} |
+| **Database** | Neon (PostgreSQL + RLS) | {tables, policies, storage} |
 | **Backend API** | .NET 10 Minimal API | {endpoints, business logic} |
 | **Frontend** | Next.js 15 (App Router) | {pages, components, auth} |
 | **Infra** | EasyPanel + Docker | {deployment, SSL} |
@@ -74,12 +74,12 @@
 
 ---
 
-{{#if (eq STACK "nextjs-supabase")}}
+{{#if (eq STACK "nextjs-neon")}}
 ## Cost Estimate
 
 | Resource | Provider | Monthly Cost | Notes |
 |----------|----------|-------------|-------|
-| Supabase | Free / Pro | $0 - $25 | {DB, Auth, Storage, Realtime} |
+| Neon | Free / Launch | $0 - $19 | {DB, Connection Pooling, Branching} |
 | VPS (EasyPanel) | {provider} | ${X} | {API + Web containers} |
 | External APIs | {provider} | ${X} | {if applicable} |
 | **Total** | | **${X}/month** | |
@@ -138,7 +138,7 @@ How will we know this feature is successful?
 | Phase | Estimate |
 |-------|----------|
 | Design & Spec | {X}h |
-{{#if (eq STACK "nextjs-supabase")}}| Database & Migrations | {X}h |
+{{#if (eq STACK "nextjs-neon")}}| Database & Migrations | {X}h |
 | Backend API | {X}h |
 | Frontend | {X}h |
 {{else}}| Implementation | {X}h |
@@ -158,7 +158,7 @@ How will we know this feature is successful?
 
 Once approved:
 1. Create detailed `spec.md` with technical design
-{{#if (eq STACK "nextjs-supabase")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
+{{#if (eq STACK "nextjs-neon")}}2. Define contracts (`contracts.cs` + `contracts.ts`)
 3. Record decisions in `decisions.md`
 4. Break down into `tasks.md`
 5. Begin implementation

package/framework/templates/docs/ui-components.md

@@ -8,7 +8,7 @@
 
 ---
 
-{{#if (eq STACK "nextjs-supabase")}}
+{{#if (eq STACK "nextjs-neon")}}
 ## Component Library: shadcn/ui
 
 ### C001: Button

package/framework/templates/feature/decisions.md

@@ -1,121 +1,122 @@
-# Architecture Decision Records - {{titleCase FEATURE_NAME}}
-
-## ADR-001: {Decision Title}
-
-**Date:** {{DATE}}
-**Status:** Proposed | Accepted | Deprecated | Superseded
-**Deciders:** MORPH Agents, Developer
-
-### Context
-
-{Describe the context and problem that led to this decision}
-
-### Decision
-
-{Describe the decision made}
-
-### Consequences
-
-**Pros:**
-- {Positive consequence 1}
-- {Positive consequence 2}
-
-**Cons:**
-- {Negative consequence 1}
-
-**Risks:**
-- {Identified risk}
-
-### Alternatives Considered
-
-#### Option A: {Name}
-- Pros: {advantages}
-- Cons: {disadvantages}
-- **Rejected because:** {reason}
-
-#### Option B: {Name}
-- Pros: {advantages}
-- Cons: {disadvantages}
-- **Rejected because:** {reason}
-
----
-
-{{#if (eq STACK "nextjs-supabase")}}
-## ADR-002: Database Access Strategy
-
-**Date:** {{DATE}}
-**Status:** Accepted
-
-### Context
-
-Need to decide how the .NET API accesses Supabase PostgreSQL.
-
-### Decision
-
-Use Dapper with Npgsql for direct SQL queries. No EF Core.
-
-### Consequences
-
-**Pros:**
-- Full control over SQL queries
-- Better performance (no ORM overhead)
-- Direct access to PostgreSQL features (jsonb, pgvector, functions)
-- RLS policies apply naturally through connection
-
-**Cons:**
-- No automatic migrations (use Supabase CLI instead)
-- Manual SQL query writing
-- No change tracking
-
----
-
-## ADR-003: Auth Strategy
-
-**Date:** {{DATE}}
-**Status:** Accepted
-
-### Context
-
-Need authentication for both Next.js frontend and .NET API.
-
-### Decision
-
-Use Supabase Auth with @supabase/ssr on frontend. Validate JWT tokens in .NET API middleware.
-
-### Consequences
-
-**Pros:**
-- Single auth provider for both layers
-- RLS policies work automatically with auth.uid()
-- Built-in social login, magic links, email/password
-- No separate auth service to maintain
-
-**Cons:**
-- Coupled to Supabase ecosystem
-- JWT secret must be shared with .NET API
-{{/if}}
-
----
-
-## Template for New ADRs
-
-```markdown
-## ADR-XXX: {Title}
-
-**Date:**
-**Status:** Proposed | Accepted | Deprecated | Superseded
-
-### Context
-{Why is this decision needed?}
-
-### Decision
-{What was decided?}
-
-### Consequences
-**Pros:** {list}
-**Cons:** {list}
-```
-
----
-
-*Generated by MORPH Framework*
+# Architecture Decision Records - {{titleCase FEATURE_NAME}}
+
+## ADR-001: {Decision Title}
+
+**Date:** {{DATE}}
+**Status:** Proposed | Accepted | Deprecated | Superseded
+**Deciders:** MORPH Agents, Developer
+
+### Context
+
+{Describe the context and problem that led to this decision}
+
+### Decision
+
+{Describe the decision made}
+
+### Consequences
+
+**Pros:**
+- {Positive consequence 1}
+- {Positive consequence 2}
+
+**Cons:**
+- {Negative consequence 1}
+
+**Risks:**
+- {Identified risk}
+
+### Alternatives Considered
+
+#### Option A: {Name}
+- Pros: {advantages}
+- Cons: {disadvantages}
+- **Rejected because:** {reason}
+
+#### Option B: {Name}
+- Pros: {advantages}
+- Cons: {disadvantages}
+- **Rejected because:** {reason}
+
+---
+
+{{#if (eq STACK "nextjs-neon")}}
+## ADR-002: Database Access Strategy
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need to decide how the .NET API accesses Neon PostgreSQL.
+
+### Decision
+
+Use Dapper with Npgsql for direct SQL queries. No EF Core.
+
+### Consequences
+
+**Pros:**
+- Full control over SQL queries
+- Better performance (no ORM overhead)
+- Direct access to PostgreSQL features (jsonb, pgvector, functions)
+- RLS policies apply naturally through connection
+
+**Cons:**
+- No automatic migrations (use Neon CLI / dotnet ef instead)
+- Manual SQL query writing
+- No change tracking
+
+---
+
+## ADR-003: Auth Strategy
+
+**Date:** {{DATE}}
+**Status:** Accepted
+
+### Context
+
+Need authentication for both Next.js frontend and .NET API.
+
+### Decision
+
+Use Neon Auth (Better Auth) for authentication. Auth data lives in the Neon database. JWT validated by .NET API middleware.
+
+### Consequences
+
+**Pros:**
+- Auth data in same database — no external provider, no sync delays
+- RLS policies work with Neon Auth JWT via auth.user_id() / pg_session_jwt
+- Built-in social login, email/password via @neondatabase/auth SDK
+- Branch isolation — each Neon branch gets isolated auth data
+- No webhooks needed — query neon_auth schema directly
+
+**Cons:**
+- Neon Auth is currently in Beta
+- JWT must be forwarded to .NET API for backend auth
+{{/if}}
+
+---
+
+## Template for New ADRs
+
+```markdown
+## ADR-XXX: {Title}
+
+**Date:**
+**Status:** Proposed | Accepted | Deprecated | Superseded
+
+### Context
+{Why is this decision needed?}
+
+### Decision
+{What was decided?}
+
+### Consequences
+**Pros:** {list}
+**Cons:** {list}
+```
+
+---
+
+*Generated by MORPH Framework*