@atlashub/smartstack-mcp 1.1.0

package/templates/component.tsx.hbs

@@ -0,0 +1,298 @@
+import React, { useState, useEffect, useCallback } from 'react';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface {{name}}Data {
+  id?: string;
+  createdAt?: string;
+  updatedAt?: string;
+  // TODO: Add {{name}} specific properties
+}
+
+export interface {{name}}Props {
+  /** Entity ID for edit mode */
+  id?: string;
+  /** Initial data */
+  initialData?: Partial<{{name}}Data>;
+  /** Callback when data is saved */
+  onSave?: (data: {{name}}Data) => void;
+  /** Callback when cancelled */
+  onCancel?: () => void;
+  /** Loading state from parent */
+  loading?: boolean;
+  /** Read-only mode */
+  readOnly?: boolean;
+}
+
+// ============================================================================
+// Component
+// ============================================================================
+
+/**
+ * {{name}} component
+ *
+ * @example
+ * ```tsx
+ * <{{name}}
+ *   id="123"
+ *   onSave={(data) => console.log('Saved:', data)}
+ *   onCancel={() => navigate(-1)}
+ * />
+ * ```
+ */
+export const {{name}}: React.FC<{{name}}Props> = ({
+  id,
+  initialData,
+  onSave,
+  onCancel,
+  loading: externalLoading,
+  readOnly = false,
+}) => {
+  // State
+  const [data, setData] = useState<{{name}}Data>(initialData || {});
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [isDirty, setIsDirty] = useState(false);
+
+  // Combined loading state
+  const isLoading = loading || externalLoading;
+
+  // Fetch data when ID changes
+  useEffect(() => {
+    if (id && !initialData) {
+      fetchData(id);
+    }
+  }, [id, initialData]);
+
+  // Fetch data from API
+  const fetchData = useCallback(async (fetchId: string) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const response = await {{nameCamel}}Api.getById(fetchId);
+      // setData(response);
+
+      // Placeholder
+      setData({ id: fetchId });
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Failed to load data');
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  // Handle field change
+  const handleChange = useCallback((field: keyof {{name}}Data, value: unknown) => {
+    setData(prev => ({ ...prev, [field]: value }));
+    setIsDirty(true);
+  }, []);
+
+  // Handle form submission
+  const handleSubmit = useCallback(async (e: React.FormEvent) => {
+    e.preventDefault();
+
+    if (readOnly) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = data.id
+      //   ? await {{nameCamel}}Api.update(data.id, data)
+      //   : await {{nameCamel}}Api.create(data);
+
+      if (onSave) {
+        onSave(data);
+      }
+
+      setIsDirty(false);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : 'Failed to save');
+    } finally {
+      setLoading(false);
+    }
+  }, [data, onSave, readOnly]);
+
+  // Handle cancel
+  const handleCancel = useCallback(() => {
+    if (isDirty) {
+      const confirmed = window.confirm('You have unsaved changes. Are you sure you want to cancel?');
+      if (!confirmed) return;
+    }
+
+    if (onCancel) {
+      onCancel();
+    }
+  }, [isDirty, onCancel]);
+
+  // Render loading state
+  if (isLoading && !data.id) {
+    return (
+      <div className="flex items-center justify-center p-8">
+        <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-500" />
+        <span className="ml-2 text-gray-600">Loading...</span>
+      </div>
+    );
+  }
+
+  // Render error state
+  if (error) {
+    return (
+      <div className="p-4 bg-red-50 border border-red-200 rounded-lg">
+        <div className="flex items-center">
+          <svg className="h-5 w-5 text-red-400" viewBox="0 0 20 20" fill="currentColor">
+            <path fillRule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM8.707 7.293a1 1 0 00-1.414 1.414L8.586 10l-1.293 1.293a1 1 0 101.414 1.414L10 11.414l1.293 1.293a1 1 0 001.414-1.414L11.414 10l1.293-1.293a1 1 0 00-1.414-1.414L10 8.586 8.707 7.293z" clipRule="evenodd" />
+          </svg>
+          <span className="ml-2 text-red-700">{error}</span>
+        </div>
+        <button
+          onClick={() => id && fetchData(id)}
+          className="mt-2 text-sm text-red-600 hover:text-red-800 underline"
+        >
+          Try again
+        </button>
+      </div>
+    );
+  }
+
+  return (
+    <div className="bg-white rounded-lg shadow-sm border border-gray-200">
+      {/* Header */}
+      <div className="px-6 py-4 border-b border-gray-200">
+        <h2 className="text-xl font-semibold text-gray-900">
+          {id ? 'Edit' : 'Create'} {{name}}
+        </h2>
+        {isDirty && (
+          <span className="text-sm text-amber-600">Unsaved changes</span>
+        )}
+      </div>
+
+      {/* Form */}
+      <form onSubmit={handleSubmit} className="p-6 space-y-6">
+        {/* TODO: Add form fields */}
+        <div className="text-gray-500 text-center py-8">
+          Add your form fields here
+        </div>
+
+        {/* Actions */}
+        {!readOnly && (
+          <div className="flex items-center justify-end gap-3 pt-4 border-t border-gray-200">
+            {onCancel && (
+              <button
+                type="button"
+                onClick={handleCancel}
+                disabled={isLoading}
+                className="px-4 py-2 text-gray-700 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 disabled:opacity-50"
+              >
+                Cancel
+              </button>
+            )}
+            <button
+              type="submit"
+              disabled={isLoading || !isDirty}
+              className="px-4 py-2 text-white bg-blue-600 rounded-lg hover:bg-blue-700 disabled:opacity-50 disabled:cursor-not-allowed"
+            >
+              {isLoading ? 'Saving...' : 'Save'}
+            </button>
+          </div>
+        )}
+      </form>
+    </div>
+  );
+};
+
+export default {{name}};
+
+// ============================================================================
+// Hook
+// ============================================================================
+
+export interface Use{{name}}Options {
+  id?: string;
+  autoFetch?: boolean;
+}
+
+export function use{{name}}(options: Use{{name}}Options = {}) {
+  const { id, autoFetch = true } = options;
+
+  const [data, setData] = useState<{{name}}Data | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetch = useCallback(async (fetchId?: string) => {
+    const targetId = fetchId || id;
+    if (!targetId) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = await {{nameCamel}}Api.getById(targetId);
+      // setData(result);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+    } finally {
+      setLoading(false);
+    }
+  }, [id]);
+
+  const save = useCallback(async (saveData: {{name}}Data) => {
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // const result = saveData.id
+      //   ? await {{nameCamel}}Api.update(saveData.id, saveData)
+      //   : await {{nameCamel}}Api.create(saveData);
+      // setData(result);
+      // return result;
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  const remove = useCallback(async (removeId?: string) => {
+    const targetId = removeId || id;
+    if (!targetId) return;
+
+    setLoading(true);
+    setError(null);
+
+    try {
+      // TODO: Implement API call
+      // await {{nameCamel}}Api.delete(targetId);
+      setData(null);
+    } catch (e) {
+      setError(e instanceof Error ? e : new Error('Unknown error'));
+      throw e;
+    } finally {
+      setLoading(false);
+    }
+  }, [id]);
+
+  useEffect(() => {
+    if (autoFetch && id) {
+      fetch();
+    }
+  }, [autoFetch, id, fetch]);
+
+  return {
+    data,
+    loading,
+    error,
+    fetch,
+    save,
+    remove,
+    setData,
+  };
+}

package/templates/controller.cs.hbs

@@ -0,0 +1,166 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Extensions.Logging;
+
+namespace {{namespace}}.Controllers;
+
+/// <summary>
+/// API controller for {{name}} operations
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]
+[Produces("application/json")]
+public class {{name}}Controller : ControllerBase
+{
+    private readonly ILogger<{{name}}Controller> _logger;
+    // private readonly I{{name}}Service _{{nameCamel}}Service;
+
+    public {{name}}Controller(
+        ILogger<{{name}}Controller> logger
+        // I{{name}}Service {{nameCamel}}Service
+    )
+    {
+        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+        // _{{nameCamel}}Service = {{nameCamel}}Service ?? throw new ArgumentNullException(nameof({{nameCamel}}Service));
+    }
+
+    /// <summary>
+    /// Get all {{namePlural}}
+    /// </summary>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>List of {{namePlural}}</returns>
+    [HttpGet]
+    [ProducesResponseType(typeof(IEnumerable<{{name}}Dto>), 200)]
+    public async Task<ActionResult<IEnumerable<{{name}}Dto>>> GetAll(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting all {{namePlural}}");
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetAllAsync(cancellationToken);
+        // return Ok(result);
+
+        return Ok(Array.Empty<{{name}}Dto>());
+    }
+
+    /// <summary>
+    /// Get {{nameCamel}} by ID
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>{{name}} details</returns>
+    [HttpGet("{id:guid}")]
+    [ProducesResponseType(typeof({{name}}Dto), 200)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult<{{name}}Dto>> GetById(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Getting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // var result = await _{{nameCamel}}Service.GetByIdAsync(id, cancellationToken);
+        // if (result == null) return NotFound();
+        // return Ok(result);
+
+        return NotFound();
+    }
+
+    /// <summary>
+    /// Create new {{nameCamel}}
+    /// </summary>
+    /// <param name="request">Create request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    /// <returns>Created {{nameCamel}}</returns>
+    [HttpPost]
+    [ProducesResponseType(typeof({{name}}Dto), 201)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult<{{name}}Dto>> Create(
+        [FromBody] Create{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Creating new {{nameCamel}}");
+
+        // TODO: Validate and create using service
+        // var result = await _{{nameCamel}}Service.CreateAsync(request, cancellationToken);
+        // return CreatedAtAction(nameof(GetById), new { id = result.Id }, result);
+
+        var id = Guid.NewGuid();
+        return CreatedAtAction(nameof(GetById), new { id }, null);
+    }
+
+    /// <summary>
+    /// Update {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="request">Update request</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpPut("{id:guid}")]
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    [ProducesResponseType(400)]
+    public async Task<ActionResult> Update(
+        Guid id,
+        [FromBody] Update{{name}}Request request,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Updating {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.UpdateAsync(id, request, cancellationToken);
+
+        return NoContent();
+    }
+
+    /// <summary>
+    /// Delete {{nameCamel}}
+    /// </summary>
+    /// <param name="id">{{name}} ID</param>
+    /// <param name="cancellationToken">Cancellation token</param>
+    [HttpDelete("{id:guid}")]
+    [ProducesResponseType(204)]
+    [ProducesResponseType(404)]
+    public async Task<ActionResult> Delete(
+        Guid id,
+        CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Deleting {{nameCamel}} {Id}", id);
+
+        // TODO: Implement using service
+        // await _{{nameCamel}}Service.DeleteAsync(id, cancellationToken);
+
+        return NoContent();
+    }
+}
+
+// ============================================================================
+// DTOs
+// ============================================================================
+
+/// <summary>
+/// {{name}} data transfer object
+/// </summary>
+public record {{name}}Dto(
+    Guid Id,
+    DateTime CreatedAt,
+    DateTime? UpdatedAt
+    // TODO: Add additional properties
+);
+
+/// <summary>
+/// Request to create a new {{nameCamel}}
+/// </summary>
+public record Create{{name}}Request(
+    // TODO: Add creation properties
+);
+
+/// <summary>
+/// Request to update a {{nameCamel}}
+/// </summary>
+public record Update{{name}}Request(
+    // TODO: Add update properties
+);

package/templates/entity-extension.cs.hbs

@@ -0,0 +1,87 @@
+using System;
+using System.ComponentModel.DataAnnotations;
+
+namespace {{namespace}};
+
+/// <summary>
+/// {{name}} entity{{#if baseEntity}} extending {{baseEntity}}{{/if}}
+/// </summary>
+public class {{name}}{{#if baseEntity}} : IHasId{{/if}}
+{
+{{#unless baseEntity}}
+    /// <summary>
+    /// Unique identifier
+    /// </summary>
+    [Key]
+    public Guid Id { get; set; } = Guid.NewGuid();
+
+    /// <summary>
+    /// Creation timestamp
+    /// </summary>
+    public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
+
+    /// <summary>
+    /// Last update timestamp
+    /// </summary>
+    public DateTime? UpdatedAt { get; set; }
+
+{{/unless}}
+{{#if baseEntity}}
+    /// <summary>
+    /// Foreign key to {{baseEntity}}
+    /// </summary>
+    public Guid {{baseEntity}}Id { get; set; }
+
+    /// <summary>
+    /// Navigation property to {{baseEntity}}
+    /// </summary>
+    public virtual {{baseEntity}} {{baseEntity}} { get; set; } = null!;
+
+{{/if}}
+    // TODO: Add {{name}} specific properties here
+}
+
+// ============================================================================
+// EF Core Configuration
+// ============================================================================
+namespace {{infrastructureNamespace}}.Persistence.Configurations;
+
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using {{domainNamespace}};
+
+public class {{name}}Configuration : IEntityTypeConfiguration<{{name}}>
+{
+    public void Configure(EntityTypeBuilder<{{name}}> builder)
+    {
+        // Table name with convention prefix
+        builder.ToTable("{{tablePrefix}}{{name}}s");
+
+        // Primary key
+        builder.HasKey(e => e.Id);
+
+{{#if baseEntity}}
+        // Relationship to {{baseEntity}} (1:1)
+        builder.HasOne(e => e.{{baseEntity}})
+               .WithOne()
+               .HasForeignKey<{{name}}>(e => e.{{baseEntity}}Id)
+               .OnDelete(DeleteBehavior.Cascade);
+
+        // Index on foreign key
+        builder.HasIndex(e => e.{{baseEntity}}Id)
+               .IsUnique();
+{{/if}}
+
+        // TODO: Add additional configuration
+    }
+}
+
+// ============================================================================
+// DbContext Update (add to ApplicationDbContext.cs)
+// ============================================================================
+// public DbSet<{{name}}> {{name}}s => Set<{{name}}>();
+
+// ============================================================================
+// Migration Command
+// ============================================================================
+// dotnet ef migrations add $(date +%Y%m%d)_Core_XXX_Add{{name}}

package/templates/service-extension.cs.hbs

@@ -0,0 +1,53 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Collections.Generic;
+using Microsoft.Extensions.Logging;
+
+namespace {{namespace}};
+
+/// <summary>
+/// Interface for {{name}} service operations
+/// </summary>
+public interface I{{name}}Service
+{
+{{#each methods}}
+    /// <summary>
+    /// {{this}} operation
+    /// </summary>
+    Task<object> {{this}}(CancellationToken cancellationToken = default);
+
+{{/each}}
+}
+
+/// <summary>
+/// Implementation of {{name}} service
+/// </summary>
+public class {{name}}Service : I{{name}}Service
+{
+    private readonly ILogger<{{name}}Service> _logger;
+
+    public {{name}}Service(ILogger<{{name}}Service> logger)
+    {
+        _logger = logger ?? throw new ArgumentNullException(nameof(logger));
+    }
+
+{{#each methods}}
+    /// <inheritdoc />
+    public async Task<object> {{this}}(CancellationToken cancellationToken = default)
+    {
+        _logger.LogInformation("Executing {{this}} in {{../name}}Service");
+
+        // TODO: Implement {{this}} logic
+        await Task.CompletedTask;
+
+        throw new NotImplementedException("{{this}} is not yet implemented");
+    }
+
+{{/each}}
+}
+
+// ============================================================================
+// Registration (add to DependencyInjection.cs)
+// ============================================================================
+// services.AddScoped<I{{name}}Service, {{name}}Service>();