@polymorphism-tech/morph-spec 4.7.0 → 4.7.2

package/.morph/framework/templates/frontend/nextjs/env.mjs.hbs

@@ -0,0 +1,32 @@
+// env.mjs — Zod-validated environment variables
+// Crashes at startup if required vars are missing — no silent undefined
+import { z } from 'zod';
+
+const serverSchema = z.object({
+  API_URL: z.string().url('API_URL must be a valid URL'),
+  NODE_ENV: z.enum(['development', 'test', 'production']).default('development'),
+});
+
+const clientSchema = z.object({
+  NEXT_PUBLIC_APP_URL: z.string().url().optional(),
+});
+
+// Validate server-side env (only available on server)
+const serverEnv = serverSchema.safeParse(process.env);
+if (!serverEnv.success) {
+  console.error('❌ Invalid server environment variables:');
+  console.error(serverEnv.error.flatten().fieldErrors);
+  throw new Error('Invalid environment variables');
+}
+
+// Validate client-side env
+const clientEnv = clientSchema.safeParse({
+  NEXT_PUBLIC_APP_URL: process.env.NEXT_PUBLIC_APP_URL,
+});
+if (!clientEnv.success) {
+  console.error('❌ Invalid client environment variables:');
+  console.error(clientEnv.error.flatten().fieldErrors);
+  throw new Error('Invalid client environment variables');
+}
+
+export const env = { ...serverEnv.data, ...clientEnv.data };

package/.morph/framework/templates/frontend/nextjs/feature-form.tsx.hbs

@@ -0,0 +1,56 @@
+// features/{{kebabCase featureName}}/components/create-{{kebabCase featureName}}-form.tsx
+'use client';
+
+import { useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { Form, FormControl, FormField, FormItem, FormLabel, FormMessage } from '@/components/ui/form';
+import { Input } from '@/components/ui/input';
+import { Button } from '@/components/ui/button';
+import { useCreate{{pascalCase featureName}} } from '@/features/{{kebabCase featureName}}/hooks/use-create-{{kebabCase featureName}}';
+import { create{{pascalCase featureName}}Schema, type Create{{pascalCase featureName}}Input } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.schemas';
+
+interface Create{{pascalCase featureName}}FormProps {
+  onSuccess?: () => void;
+}
+
+export function Create{{pascalCase featureName}}Form({ onSuccess }: Create{{pascalCase featureName}}FormProps) {
+  const form = useForm<Create{{pascalCase featureName}}Input>({
+    resolver: zodResolver(create{{pascalCase featureName}}Schema),
+    defaultValues: { name: '' },
+  });
+
+  const { mutate: create{{pascalCase featureName}}, isPending } = useCreate{{pascalCase featureName}}();
+
+  function onSubmit(values: Create{{pascalCase featureName}}Input) {
+    create{{pascalCase featureName}}(values, {
+      onSuccess: () => { form.reset(); onSuccess?.(); },
+      onError: (error) => { form.setError('root', { message: error.message }); },
+    });
+  }
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-4">
+        <FormField
+          control={form.control}
+          name="name"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Name</FormLabel>
+              <FormControl>
+                <Input placeholder="Enter name" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        {form.formState.errors.root && (
+          <p className="text-sm text-destructive">{form.formState.errors.root.message}</p>
+        )}
+        <Button type="submit" disabled={isPending}>
+          {isPending ? 'Creating...' : 'Create {{pascalCase featureName}}'}
+        </Button>
+      </form>
+    </Form>
+  );
+}

package/.morph/framework/templates/frontend/nextjs/page.tsx.hbs

@@ -0,0 +1,22 @@
+// app/(dashboard)/{{kebabCase featureName}}/page.tsx
+// Server Component — fetches initial data, renders feature component
+import { {{pascalCase featureName}}List } from '@/features/{{kebabCase featureName}}';
+
+async function get{{pascalCase featureName}}List() {
+  const res = await fetch(`${process.env.API_URL}/api/{{kebabCase featureName}}`, {
+    next: { revalidate: 30 },
+    headers: { 'Content-Type': 'application/json' },
+  });
+  if (!res.ok) throw new Error('Failed to fetch {{featureName}}');
+  return res.json();
+}
+
+export default async function {{pascalCase featureName}}Page() {
+  const data = await get{{pascalCase featureName}}List();
+  return (
+    <div className="container py-6">
+      <h1 className="text-2xl font-bold mb-6">{{pascalCase featureName}}</h1>
+      <{{pascalCase featureName}}List initialData={data} />
+    </div>
+  );
+}

package/.morph/framework/templates/frontend/nextjs/tsconfig.json.hbs

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": false,
+    "skipLibCheck": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/.morph/framework/templates/frontend/nextjs/use-feature.ts.hbs

@@ -0,0 +1,54 @@
+// features/{{kebabCase featureName}}/hooks/use-{{kebabCase featureName}}s.ts
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import { {{camelCase featureName}}Schema } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.schemas';
+import type { Create{{pascalCase featureName}}Input } from '@/features/{{kebabCase featureName}}/types/{{kebabCase featureName}}.types';
+
+// ============================================
+// Query Key Factory
+// ============================================
+
+export const {{camelCase featureName}}Keys = {
+  all: ['{{kebabCase featureName}}'] as const,
+  lists: () => [...{{camelCase featureName}}Keys.all, 'list'] as const,
+  detail: (id: string) => [...{{camelCase featureName}}Keys.all, 'detail', id] as const,
+};
+
+// ============================================
+// List Hook (TanStack Query v5 syntax)
+// ============================================
+
+const {{camelCase featureName}}ListSchema = z.array({{camelCase featureName}}Schema);
+
+export function use{{pascalCase featureName}}s() {
+  return useQuery({
+    queryKey: {{camelCase featureName}}Keys.lists(),
+    queryFn: async () => {
+      const res = await fetch('/api/{{kebabCase featureName}}');
+      if (!res.ok) throw new Error('Failed to fetch {{featureName}}');
+      return {{camelCase featureName}}ListSchema.parse(await res.json());
+    },
+  });
+}
+
+// ============================================
+// Create Mutation
+// ============================================
+
+export function useCreate{{pascalCase featureName}}() {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: async (input: Create{{pascalCase featureName}}Input) => {
+      const res = await fetch('/api/{{kebabCase featureName}}', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(input),
+      });
+      if (!res.ok) throw new Error('Failed to create {{featureName}}');
+      return res.json();
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: {{camelCase featureName}}Keys.lists() });
+    },
+  });
+}

package/.morph/framework/templates/infrastructure/azure/Dockerfile.example

@@ -0,0 +1,82 @@
+# ==============================================================================
+# MORPH-SPEC - .NET 8 Blazor Server Dockerfile
+# Multi-stage build for production-ready container
+# ==============================================================================
+
+# ==============================================================================
+# Stage 1: Base Runtime
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
+
+# Set working directory
+WORKDIR /app
+
+# Expose ports
+EXPOSE 8080
+EXPOSE 8081
+
+# Create non-root user for security
+RUN adduser --disabled-password --gecos '' appuser && chown -R appuser /app
+USER appuser
+
+# ==============================================================================
+# Stage 2: Build
+# ==============================================================================
+FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
+
+# Set working directory
+WORKDIR /src
+
+# Copy project files
+# Adjust paths according to your solution structure
+COPY ["src/YourApp/YourApp.csproj", "src/YourApp/"]
+COPY ["src/YourApp.Core/YourApp.Core.csproj", "src/YourApp.Core/"]
+COPY ["src/YourApp.Infrastructure/YourApp.Infrastructure.csproj", "src/YourApp.Infrastructure/"]
+
+# Restore dependencies
+RUN dotnet restore "src/YourApp/YourApp.csproj"
+
+# Copy all source code
+COPY . .
+
+# Build project
+WORKDIR "/src/src/YourApp"
+RUN dotnet build "YourApp.csproj" -c Release -o /app/build
+
+# ==============================================================================
+# Stage 3: Publish
+# ==============================================================================
+FROM build AS publish
+
+# Publish application
+RUN dotnet publish "YourApp.csproj" \
+    -c Release \
+    -o /app/publish \
+    /p:UseAppHost=false \
+    /p:PublishTrimmed=false \
+    /p:PublishSingleFile=false
+
+# ==============================================================================
+# Stage 4: Final
+# ==============================================================================
+FROM base AS final
+
+# Set working directory
+WORKDIR /app
+
+# Copy published files from publish stage
+COPY --from=publish /app/publish .
+
+# Set environment variables
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+ENV DOTNET_RUNNING_IN_CONTAINER=true
+ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false
+
+# Health check endpoint
+# Adjust path to match your health check endpoint
+HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:8080/health || exit 1
+
+# Set entry point
+ENTRYPOINT ["dotnet", "YourApp.dll"]

package/.morph/framework/templates/infrastructure/azure/README.md

@@ -0,0 +1,286 @@
+# MORPH-SPEC - Templates Bicep
+
+Templates de infraestrutura para Azure com suporte a App Service e Container Apps.
+
+---
+
+## 🚀 Quick Start
+
+### 1. App Service Free (Desenvolvimento - $0/mês)
+
+```bash
+# Deploy infraestrutura com App Service Free
+az deployment group create \
+  --resource-group rg-myapp-dev \
+  --template-file main.bicep \
+  --parameters @parameters.dev.json \
+  --parameters appName=myapp
+```
+
+### 2. Container Apps (Produção - $5-15/mês)
+
+```bash
+# Build e push imagem para ACR
+az acr build \
+  --registry acrXXXX \
+  --image myapp:v1.0.0 \
+  --file Dockerfile \
+  .
+
+# Deploy infraestrutura com Container Apps
+az deployment group create \
+  --resource-group rg-myapp-prod \
+  --template-file main.bicep \
+  --parameters @parameters.prod.json \
+  --parameters appName=myapp
+```
+
+---
+
+## 📁 Estrutura de Arquivos
+
+```
+infra/
+├── main.bicep                    # Entry point com lógica condicional
+├── parameters.dev.json           # Params dev (App Service Free)
+├── parameters.prod.json          # Params prod (Container Apps)
+├── app-service.bicep             # Template App Service
+├── container-app.bicep           # Template Container App
+├── container-app-env.bicep       # Container Apps Environment
+├── sql-database.bicep            # Azure SQL Database
+├── storage.bicep                 # Storage Account
+├── key-vault.bicep               # Key Vault
+└── app-insights.bicep            # Application Insights
+```
+
+---
+
+## ⚙️ Parâmetros Principais
+
+### main.bicep
+
+| Parâmetro | Tipo | Default | Descrição |
+|-----------|------|---------|-----------|
+| `environment` | string | `dev` | Ambiente (dev, staging, prod) |
+| `appName` | string | **required** | Nome da aplicação (3-15 chars) |
+| `location` | string | `resourceGroup().location` | Região Azure |
+| `hostingType` | string | `appservice` | Tipo de hosting (`appservice` ou `containerapp`) |
+| `appServiceSku` | string | `F1` | SKU do App Service (F1, B1, S1, P1v2) |
+| `containerImage` | string | `mcr.microsoft.com/hello-world:latest` | Imagem Docker (apenas Container Apps) |
+| `sqlAdminPassword` | securestring | **required** | Senha do SQL Server |
+
+---
+
+## 🌐 Escolhendo o Hosting Type
+
+### App Service (`hostingType: appservice`)
+
+**Usar quando:**
+- ✅ Orçamento zero (Free F1)
+- ✅ MVP ou protótipo
+- ✅ Tráfego baixo (<100 req/dia)
+- ✅ App tolerante a cold starts (20 min sleep)
+- ✅ Deploy simplificado (sem Docker)
+
+**SKUs disponíveis:**
+- `F1` (Free): $0/mês - 1GB RAM, 60 min CPU/dia, sleep após 20min
+- `B1` (Basic): $13/mês - 1.75GB RAM, always-on
+- `S1` (Standard): $70/mês - 1.75GB RAM, auto-scale, slots
+- `P1v2` (Premium): $85/mês - 3.5GB RAM, melhor performance
+
+### Container Apps (`hostingType: containerapp`)
+
+**Usar quando:**
+- ✅ Produção com SLA 24/7
+- ✅ Auto-scaling baseado em demanda
+- ✅ SSL customizado necessário
+- ✅ Background jobs (Hangfire)
+- ✅ Arquitetura microserviços
+
+**Custo:** $0-15/mês (scale-to-zero + consumo)
+
+---
+
+## 📝 Configuração por Ambiente
+
+### Development (parameters.dev.json)
+
+```json
+{
+  "environment": { "value": "dev" },
+  "hostingType": { "value": "appservice" },
+  "appServiceSku": { "value": "F1" }
+}
+```
+
+**Infraestrutura:**
+- App Service Free F1
+- Azure SQL Free (32GB)
+- App Insights Free (5GB)
+
+**Custo total:** $0/mês
+
+### Staging (parameters.staging.json)
+
+```json
+{
+  "environment": { "value": "staging" },
+  "hostingType": { "value": "containerapp" },
+  "minReplicas": { "value": 0 }  // scale-to-zero
+}
+```
+
+**Infraestrutura:**
+- Container Apps (scale-to-zero)
+- Azure SQL Free (32GB)
+- ACR Basic
+- App Insights Free
+
+**Custo total:** $5-10/mês
+
+### Production (parameters.prod.json)
+
+```json
+{
+  "environment": { "value": "prod" },
+  "hostingType": { "value": "containerapp" },
+  "minReplicas": { "value": 1 }  // always-on
+}
+```
+
+**Infraestrutura:**
+- Container Apps (min 1 replica)
+- Azure SQL Free (ou pago se necessário)
+- ACR Basic
+- App Insights (pode ultrapassar free tier)
+
+**Custo total:** $10-20/mês
+
+---
+
+## 🔧 Customização
+
+### Adicionar variáveis de ambiente
+
+**App Service:**
+```bicep
+module appService 'app-service.bicep' = {
+  params: {
+    envVars: {
+      MY_CUSTOM_VAR: 'value'
+      ANOTHER_VAR: 'another-value'
+    }
+  }
+}
+```
+
+**Container Apps:**
+```bicep
+module containerApp 'container-app.bicep' = {
+  params: {
+    envVars: [
+      {
+        name: 'MY_CUSTOM_VAR'
+        value: 'value'
+      }
+    ]
+  }
+}
+```
+
+### Usar secrets do Key Vault
+
+```bicep
+param sqlAdminPassword string {
+  reference: {
+    keyVault: {
+      id: '/subscriptions/.../providers/Microsoft.KeyVault/vaults/kv-myapp'
+    }
+    secretName: 'sql-admin-password'
+  }
+}
+```
+
+---
+
+## 🔄 Migração App Service → Container Apps
+
+Ver guia completo em: `../../standards/migration-guide.md`
+
+**Resumo:**
+1. Criar Dockerfile
+2. Implementar health checks
+3. Build e push para ACR
+4. Atualizar `parameters.json` → `hostingType: containerapp`
+5. Redeploy
+6. Testar
+7. Cutover DNS
+
+---
+
+## 📊 Outputs Gerados
+
+Após deploy, os seguintes outputs são gerados:
+
+```bash
+# Obter URL da aplicação
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.appUrl.value
+
+# Obter connection string SQL
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.sqlConnectionString.value
+
+# Obter App Insights connection string
+az deployment group show \
+  -g rg-myapp-dev \
+  -n deployment-name \
+  --query properties.outputs.appInsightsConnectionString.value
+```
+
+---
+
+## 🆘 Troubleshooting
+
+### Erro: "The template deployment 'X' is not valid"
+
+Validar template:
+```bash
+az deployment group validate \
+  --resource-group rg-myapp-dev \
+  --template-file main.bicep \
+  --parameters @parameters.dev.json
+```
+
+### Erro: "SKU not available in this location"
+
+Verificar SKUs disponíveis:
+```bash
+az appservice list-locations --sku F1
+```
+
+### Deploy muito lento
+
+Container Apps pode levar 5-10 minutos no primeiro deploy. Use `--no-wait` para não bloquear:
+```bash
+az deployment group create \
+  ... \
+  --no-wait
+```
+
+---
+
+## 📚 Referências
+
+- [Bicep Documentation](https://learn.microsoft.com/azure/azure-resource-manager/bicep/)
+- [App Service Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.web/sites)
+- [Container Apps Bicep Reference](https://learn.microsoft.com/azure/templates/microsoft.app/containerapps)
+- [Azure CLI Reference](https://learn.microsoft.com/cli/azure/)
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/.morph/framework/templates/infrastructure/azure/app-insights.bicep

@@ -0,0 +1,63 @@
+// ==============================================================================
+// MORPH-SPEC - Application Insights
+// Azure Application Insights for monitoring and telemetry
+// ==============================================================================
+
+@description('Application Insights name')
+param name string
+
+@description('Location')
+param location string
+
+@description('Tags')
+param tags object = {}
+
+@description('Log Analytics Workspace ID')
+param logAnalyticsWorkspaceId string
+
+@description('Application type')
+@allowed(['web', 'other'])
+param applicationType string = 'web'
+
+@description('Retention in days')
+@minValue(30)
+@maxValue(730)
+param retentionInDays int = 90
+
+// ==============================================================================
+// APPLICATION INSIGHTS
+// ==============================================================================
+
+resource appInsights 'Microsoft.Insights/components@2020-02-02' = {
+  name: name
+  location: location
+  tags: tags
+  kind: applicationType
+  properties: {
+    Application_Type: applicationType
+    WorkspaceResourceId: logAnalyticsWorkspaceId
+    IngestionMode: 'LogAnalytics'
+    publicNetworkAccessForIngestion: 'Enabled'
+    publicNetworkAccessForQuery: 'Enabled'
+    RetentionInDays: retentionInDays
+  }
+}
+
+// ==============================================================================
+// OUTPUTS
+// ==============================================================================
+
+@description('Application Insights ID')
+output id string = appInsights.id
+
+@description('Application Insights name')
+output name string = appInsights.name
+
+@description('Instrumentation Key')
+output instrumentationKey string = appInsights.properties.InstrumentationKey
+
+@description('Connection String')
+output connectionString string = appInsights.properties.ConnectionString
+
+@description('App ID')
+output appId string = appInsights.properties.AppId