@atlashub/smartstack-cli 3.39.0 → 3.40.0

package/templates/project/README.md

@@ -1,79 +1,79 @@
-# SmartStack Client Project Templates
-
-These templates are used by the SmartStack CLI to generate new client projects.
-
-## Template Files
-
-| File | Description | Destination |
-|------|-------------|-------------|
-| `ExtensionsDbContext.cs.template` | DbContext for client entities | `{ProjectName}.Infrastructure/Persistence/` |
-| `IExtensionsDbContext.cs.template` | Interface for ExtensionsDbContext | `{ProjectName}.Application/Common/Interfaces/` |
-| `DependencyInjection.Infrastructure.cs.template` | DI configuration for Infrastructure | `{ProjectName}.Infrastructure/` |
-| `Program.cs.template` | API entry point with migration order | `{ProjectName}.Api/` |
-| `DesignTimeExtensionsDbContextFactory.cs.template` | Factory for EF Core CLI tools | `{ProjectName}.Infrastructure/Persistence/` |
-| `ExampleEntity.cs.template` | Example entity with FK to Core | `{ProjectName}.Domain/Entities/` (optional) |
-| `ExampleService.cs.template` | Example service using ICoreDataService | `{ProjectName}.Infrastructure/Services/` (optional) |
-| `ExampleEntityConfiguration.cs.template` | Example EF Core configuration | `{ProjectName}.Infrastructure/Persistence/Configurations/` (optional) |
-
-## Placeholders
-
-The following placeholders are replaced during project generation:
-
-| Placeholder | Description | Example |
-|-------------|-------------|---------|
-| `{{ProjectName}}` | PascalCase project name | `MyCompany` |
-
-## Architecture Overview
-
-### Dual DbContext Pattern
-
-SmartStack uses two separate DbContexts:
-
-1. **CoreDbContext** (from SmartStack NuGet package)
-   - Schema: `core`
-   - Manages: Users, Roles, Permissions, Navigation, etc.
-   - Migrations: `core.__EFMigrationsHistory`
-
-2. **ExtensionsDbContext** (client project)
-   - Schema: `extensions`
-   - Manages: Client-specific entities
-   - Migrations: `extensions.__EFMigrationsHistory`
-
-### FK References to Core Entities
-
-When your entities need to reference Core entities (User, Role, etc.):
-
-```csharp
-// IN YOUR ENTITY - Store GUID only
-public Guid CustomerId { get; private set; }  // FK to User
-
-// IN YOUR SERVICE - Use ICoreDataService
-var user = await _coreDataService.GetUserByIdAsync(entity.CustomerId);
-```
-
-**DO NOT** create navigation properties to Core entities, as ExtensionsDbContext doesn't know about them.
-
-### Migration Order
-
-Migrations must be applied in order:
-
-1. Core migrations first (SmartStack platform tables)
-2. Extensions migrations second (client tables that may reference Core)
-
-This is handled automatically in `Program.cs.template`.
-
-## Usage
-
-```bash
-# Create new project
-smartstack init MyProject
-
-# Add entity to Extensions
-smartstack scaffold entity Order --context extensions
-
-# Create migration
-dotnet ef migrations add ext_v1.0.0_001_AddOrders --context ExtensionsDbContext
-
-# Apply migrations
-dotnet ef database update
-```
+# SmartStack Client Project Templates
+
+These templates are used by the SmartStack CLI to generate new client projects.
+
+## Template Files
+
+| File | Description | Destination |
+|------|-------------|-------------|
+| `ExtensionsDbContext.cs.template` | DbContext for client entities | `{ProjectName}.Infrastructure/Persistence/` |
+| `IExtensionsDbContext.cs.template` | Interface for ExtensionsDbContext | `{ProjectName}.Application/Common/Interfaces/` |
+| `DependencyInjection.Infrastructure.cs.template` | DI configuration for Infrastructure | `{ProjectName}.Infrastructure/` |
+| `Program.cs.template` | API entry point with migration order | `{ProjectName}.Api/` |
+| `DesignTimeExtensionsDbContextFactory.cs.template` | Factory for EF Core CLI tools | `{ProjectName}.Infrastructure/Persistence/` |
+| `ExampleEntity.cs.template` | Example entity with FK to Core | `{ProjectName}.Domain/Entities/` (optional) |
+| `ExampleService.cs.template` | Example service using ICoreDataService | `{ProjectName}.Infrastructure/Services/` (optional) |
+| `ExampleEntityConfiguration.cs.template` | Example EF Core configuration | `{ProjectName}.Infrastructure/Persistence/Configurations/` (optional) |
+
+## Placeholders
+
+The following placeholders are replaced during project generation:
+
+| Placeholder | Description | Example |
+|-------------|-------------|---------|
+| `{{ProjectName}}` | PascalCase project name | `MyCompany` |
+
+## Architecture Overview
+
+### Dual DbContext Pattern
+
+SmartStack uses two separate DbContexts:
+
+1. **CoreDbContext** (from SmartStack NuGet package)
+   - Schema: `core`
+   - Manages: Users, Roles, Permissions, Navigation, etc.
+   - Migrations: `core.__EFMigrationsHistory`
+
+2. **ExtensionsDbContext** (client project)
+   - Schema: `extensions`
+   - Manages: Client-specific entities
+   - Migrations: `extensions.__EFMigrationsHistory`
+
+### FK References to Core Entities
+
+When your entities need to reference Core entities (User, Role, etc.):
+
+```csharp
+// IN YOUR ENTITY - Store GUID only
+public Guid CustomerId { get; private set; }  // FK to User
+
+// IN YOUR SERVICE - Use ICoreDataService
+var user = await _coreDataService.GetUserByIdAsync(entity.CustomerId);
+```
+
+**DO NOT** create navigation properties to Core entities, as ExtensionsDbContext doesn't know about them.
+
+### Migration Order
+
+Migrations must be applied in order:
+
+1. Core migrations first (SmartStack platform tables)
+2. Extensions migrations second (client tables that may reference Core)
+
+This is handled automatically in `Program.cs.template`.
+
+## Usage
+
+```bash
+# Create new project
+smartstack init MyProject
+
+# Add entity to Extensions
+smartstack scaffold entity Order --context extensions
+
+# Create migration
+dotnet ef migrations add ext_v1.0.0_001_AddOrders --context ExtensionsDbContext
+
+# Apply migrations
+dotnet ef database update
+```

package/templates/project/api.ts.template

@@ -1,12 +1,12 @@
-// Re-export SmartStack's shared API client
-// IMPORTANT: Do NOT create a custom axios instance — use the SmartStack-provided client
-// which handles authentication, token refresh, and session management automatically.
-import { apiClient, api } from '@atlashub/smartstack';
-
-export { api };
-export default apiClient;
-
-// For module-specific API calls, extend from the shared client:
-// import apiClient from './api';
-// import { api } from './api';
-// export const getEmployees = () => api.get('/api/business/human-resources/employees');
+// Re-export SmartStack's shared API client
+// IMPORTANT: Do NOT create a custom axios instance — use the SmartStack-provided client
+// which handles authentication, token refresh, and session management automatically.
+import { apiClient, api } from '@atlashub/smartstack';
+
+export { api };
+export default apiClient;
+
+// For module-specific API calls, extend from the shared client:
+// import apiClient from './api';
+// import { api } from './api';
+// export const getEmployees = () => api.get('/api/human-resources/employees');

package/templates/project/appsettings.json.template

@@ -1,170 +1,170 @@
-{
-  "ConnectionStrings": {
-    "DefaultConnection": "Server=(local);Database={{ProjectName}};Integrated Security=true;TrustServerCertificate=true;Connection Timeout=60;Pooling=true;Min Pool Size=0;Max Pool Size=50;Load Balance Timeout=30"
-  },
-  "SmartStack": {
-    "AutoMigrate": true,
-    "FailOnMigrationError": true,
-    "EnableDevSeeding": false,
-    "UseAzureStorage": false,
-    "UseEntraId": false,
-    "EnableSwagger": true,
-    "CorsOrigins": [
-      "http://localhost:3000",
-      "http://localhost:5173",
-      "http://localhost:5174",
-      "http://localhost:5175"
-    ]
-  },
-  "Jwt": {
-    "Secret": "{{JwtSecret}}",
-    "Issuer": "{{ProjectName}}",
-    "Audience": "{{ProjectName}}",
-    "AccessTokenExpirationMinutes": 60,
-    "RefreshTokenExpirationDays": 7
-  },
-  "Authentication": {
-    "Microsoft": {
-      "ClientId": "",
-      "ClientSecret": "",
-      "CallbackPath": "/api/auth/microsoft/callback"
-    },
-    "Google": {
-      "ClientId": "",
-      "ClientSecret": "",
-      "CallbackPath": "/api/auth/google/callback"
-    },
-    "FrontendUrl": "http://localhost:5173"
-  },
-  "Session": {
-    "IdleTimeoutMinutes": 20,
-    "AbsoluteTimeoutHours": 8,
-    "WarningThresholdMinutes": 5,
-    "EnableValidation": true,
-    "RefreshTokenExpirationDays": 7,
-    "CleanupBatchSize": 100,
-    "MaxConcurrentSessions": 3,
-    "CleanupIntervalMinutes": 5
-  },
-  "Serilog": {
-    "MinimumLevel": {
-      "Default": "Information",
-      "Override": {
-        "Microsoft": "Warning",
-        "Microsoft.EntityFrameworkCore": "Warning",
-        "Microsoft.AspNetCore": "Warning",
-        "System": "Warning"
-      }
-    },
-    "Enrich": ["FromLogContext", "WithMachineName", "WithThreadId"],
-    "Properties": {
-      "Application": "{{ProjectName}}"
-    }
-  },
-  "Logging": {
-    "Sinks": {
-      "Console": {
-        "Enabled": true
-      },
-      "File": {
-        "Enabled": true,
-        "Path": "logs/{{ProjectNameLower}}-.log",
-        "RollingInterval": "Day",
-        "RetainedFileCountLimit": 21
-      },
-      "Seq": {
-        "Enabled": false,
-        "ServerUrl": "http://localhost:5341"
-      },
-      "ApplicationInsights": {
-        "Enabled": false,
-        "ConnectionString": ""
-      }
-    }
-  },
-  "AzureStorage": {
-    "UseAzure": false,
-    "Normal": {
-      "ConnectionString": "",
-      "ContainerName": "files",
-      "MaxFileSizeMB": 50,
-      "RetentionDays": 0,
-      "AllowedExtensions": []
-    },
-    "Legal": {
-      "ConnectionString": "",
-      "ContainerName": "legal-files",
-      "MaxFileSizeMB": 50,
-      "RetentionDays": 3653,
-      "EnableLegalHold": true,
-      "EnableRetentionPolicy": true,
-      "AllowedExtensions": []
-    }
-  },
-  "FileStorage": {
-    "BasePath": "d:\\{{ProjectName}}Files",
-    "Normal": {
-      "FolderName": "normal",
-      "MaxFileSizeMB": 50,
-      "RetentionDays": 0,
-      "AllowedExtensions": []
-    },
-    "Legal": {
-      "FolderName": "legal",
-      "MaxFileSizeMB": 50,
-      "RetentionDays": 3653,
-      "AllowedExtensions": []
-    }
-  },
-  "Email": {
-    "Enabled": true,
-    "Provider": "Development",
-    "FromEmail": "noreply@{{ProjectDomain}}",
-    "FromName": "{{ProjectName}}",
-    "BaseUrl": "http://localhost:5173",
-    "TokenExpiration": {
-      "EmailConfirmation": "24:00:00",
-      "PasswordReset": "01:00:00"
-    },
-    "Development": {
-      "SmtpHost": "localhost",
-      "SmtpPort": 1025,
-      "UseSsl": false,
-      "WebInterfaceUrl": "http://localhost:8025"
-    },
-    "Mailgun": {
-      "ApiKey": "",
-      "Domain": "",
-      "Region": "EU"
-    },
-    "AzureAcs": {
-      "ConnectionString": "",
-      "SenderAddress": ""
-    }
-  },
-  "Zefix": {
-    "Username": "",
-    "Password": ""
-  },
-  "Entra": {
-    "TenantId": "",
-    "ClientId": "",
-    "ClientSecret": "",
-    "SyncEnabled": false,
-    "SyncIntervalMinutes": 60,
-    "UseDeltaSync": true,
-    "DefaultConflictResolution": "ManualReview",
-    "AutoCreateReferences": true,
-    "BackgroundSyncEnabled": false,
-    "BackgroundSyncIntervalMinutes": 60
-  },
-  "MultiTenant": {
-    "Enabled": true,
-    "EnableB2B": true,
-    "EnableB2C": true,
-    "SystemTenantSlug": "default",
-    "SystemTenantName": "Default Workspace",
-    "AutoAssignUsersToSystemTenant": true
-  },
-  "AllowedHosts": "*"
-}
+{
+  "ConnectionStrings": {
+    "DefaultConnection": "Server=(local);Database={{ProjectName}};Integrated Security=true;TrustServerCertificate=true;Connection Timeout=60;Pooling=true;Min Pool Size=0;Max Pool Size=50;Load Balance Timeout=30"
+  },
+  "SmartStack": {
+    "AutoMigrate": true,
+    "FailOnMigrationError": true,
+    "EnableDevSeeding": false,
+    "UseAzureStorage": false,
+    "UseEntraId": false,
+    "EnableSwagger": true,
+    "CorsOrigins": [
+      "http://localhost:3000",
+      "http://localhost:5173",
+      "http://localhost:5174",
+      "http://localhost:5175"
+    ]
+  },
+  "Jwt": {
+    "Secret": "{{JwtSecret}}",
+    "Issuer": "{{ProjectName}}",
+    "Audience": "{{ProjectName}}",
+    "AccessTokenExpirationMinutes": 60,
+    "RefreshTokenExpirationDays": 7
+  },
+  "Authentication": {
+    "Microsoft": {
+      "ClientId": "",
+      "ClientSecret": "",
+      "CallbackPath": "/api/auth/microsoft/callback"
+    },
+    "Google": {
+      "ClientId": "",
+      "ClientSecret": "",
+      "CallbackPath": "/api/auth/google/callback"
+    },
+    "FrontendUrl": "http://localhost:5173"
+  },
+  "Session": {
+    "IdleTimeoutMinutes": 20,
+    "AbsoluteTimeoutHours": 8,
+    "WarningThresholdMinutes": 5,
+    "EnableValidation": true,
+    "RefreshTokenExpirationDays": 7,
+    "CleanupBatchSize": 100,
+    "MaxConcurrentSessions": 3,
+    "CleanupIntervalMinutes": 5
+  },
+  "Serilog": {
+    "MinimumLevel": {
+      "Default": "Information",
+      "Override": {
+        "Microsoft": "Warning",
+        "Microsoft.EntityFrameworkCore": "Warning",
+        "Microsoft.AspNetCore": "Warning",
+        "System": "Warning"
+      }
+    },
+    "Enrich": ["FromLogContext", "WithMachineName", "WithThreadId"],
+    "Properties": {
+      "Application": "{{ProjectName}}"
+    }
+  },
+  "Logging": {
+    "Sinks": {
+      "Console": {
+        "Enabled": true
+      },
+      "File": {
+        "Enabled": true,
+        "Path": "logs/{{ProjectNameLower}}-.log",
+        "RollingInterval": "Day",
+        "RetainedFileCountLimit": 21
+      },
+      "Seq": {
+        "Enabled": false,
+        "ServerUrl": "http://localhost:5341"
+      },
+      "ApplicationInsights": {
+        "Enabled": false,
+        "ConnectionString": ""
+      }
+    }
+  },
+  "AzureStorage": {
+    "UseAzure": false,
+    "Normal": {
+      "ConnectionString": "",
+      "ContainerName": "files",
+      "MaxFileSizeMB": 50,
+      "RetentionDays": 0,
+      "AllowedExtensions": []
+    },
+    "Legal": {
+      "ConnectionString": "",
+      "ContainerName": "legal-files",
+      "MaxFileSizeMB": 50,
+      "RetentionDays": 3653,
+      "EnableLegalHold": true,
+      "EnableRetentionPolicy": true,
+      "AllowedExtensions": []
+    }
+  },
+  "FileStorage": {
+    "BasePath": "d:\\{{ProjectName}}Files",
+    "Normal": {
+      "FolderName": "normal",
+      "MaxFileSizeMB": 50,
+      "RetentionDays": 0,
+      "AllowedExtensions": []
+    },
+    "Legal": {
+      "FolderName": "legal",
+      "MaxFileSizeMB": 50,
+      "RetentionDays": 3653,
+      "AllowedExtensions": []
+    }
+  },
+  "Email": {
+    "Enabled": true,
+    "Provider": "Development",
+    "FromEmail": "noreply@{{ProjectDomain}}",
+    "FromName": "{{ProjectName}}",
+    "BaseUrl": "http://localhost:5173",
+    "TokenExpiration": {
+      "EmailConfirmation": "24:00:00",
+      "PasswordReset": "01:00:00"
+    },
+    "Development": {
+      "SmtpHost": "localhost",
+      "SmtpPort": 1025,
+      "UseSsl": false,
+      "WebInterfaceUrl": "http://localhost:8025"
+    },
+    "Mailgun": {
+      "ApiKey": "",
+      "Domain": "",
+      "Region": "EU"
+    },
+    "AzureAcs": {
+      "ConnectionString": "",
+      "SenderAddress": ""
+    }
+  },
+  "Zefix": {
+    "Username": "",
+    "Password": ""
+  },
+  "Entra": {
+    "TenantId": "",
+    "ClientId": "",
+    "ClientSecret": "",
+    "SyncEnabled": false,
+    "SyncIntervalMinutes": 60,
+    "UseDeltaSync": true,
+    "DefaultConflictResolution": "ManualReview",
+    "AutoCreateReferences": true,
+    "BackgroundSyncEnabled": false,
+    "BackgroundSyncIntervalMinutes": 60
+  },
+  "MultiTenant": {
+    "Enabled": true,
+    "EnableB2B": true,
+    "EnableB2C": true,
+    "SystemTenantSlug": "default",
+    "SystemTenantName": "Default Workspace",
+    "AutoAssignUsersToSystemTenant": true
+  },
+  "AllowedHosts": "*"
+}

package/templates/project/claude-settings.json.template

@@ -1,5 +1,5 @@
-{
-  "env": {
-    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
-  }
-}
+{
+  "env": {
+    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
+  }
+}

package/templates/project/test-frontend/msw/handlers.ts

@@ -1,58 +1,58 @@
-import { http, HttpResponse } from 'msw';
-
-/**
- * Default MSW handlers for SmartStack API endpoints.
- * These handlers mock common API calls used across the application.
- *
- * Override these in individual tests using server.use().
- *
- * @example
- * // In a test file:
- * server.use(
- *   http.get('/api/products', () =>
- *     HttpResponse.json({
- *       items: [{ id: '1', code: 'P-01', name: 'Test Product' }],
- *       totalCount: 1,
- *       pageNumber: 1,
- *       pageSize: 10,
- *     })
- *   )
- * );
- */
-export const handlers = [
-  // Auth endpoints
-  http.get('/api/auth/me', () =>
-    HttpResponse.json({
-      id: 'test-user-id',
-      email: 'test-admin@smartstack.io',
-      name: 'Test Admin',
-      role: 'Administrator',
-      permissions: ['*'],
-    })
-  ),
-
-  http.post('/api/auth/login', () =>
-    HttpResponse.json({
-      token: 'test-jwt-token',
-      user: {
-        id: 'test-user-id',
-        email: 'test-admin@smartstack.io',
-        name: 'Test Admin',
-      },
-    })
-  ),
-
-  // Navigation endpoints
-  http.get('/api/navigation', () =>
-    HttpResponse.json([])
-  ),
-
-  // User preferences
-  http.get('/api/users/preferences', () =>
-    HttpResponse.json({})
-  ),
-
-  http.put('/api/users/preferences', () =>
-    HttpResponse.json({ success: true })
-  ),
-];
+import { http, HttpResponse } from 'msw';
+
+/**
+ * Default MSW handlers for SmartStack API endpoints.
+ * These handlers mock common API calls used across the application.
+ *
+ * Override these in individual tests using server.use().
+ *
+ * @example
+ * // In a test file:
+ * server.use(
+ *   http.get('/api/products', () =>
+ *     HttpResponse.json({
+ *       items: [{ id: '1', code: 'P-01', name: 'Test Product' }],
+ *       totalCount: 1,
+ *       pageNumber: 1,
+ *       pageSize: 10,
+ *     })
+ *   )
+ * );
+ */
+export const handlers = [
+  // Auth endpoints
+  http.get('/api/auth/me', () =>
+    HttpResponse.json({
+      id: 'test-user-id',
+      email: 'test-admin@smartstack.io',
+      name: 'Test Admin',
+      role: 'Administrator',
+      permissions: ['*'],
+    })
+  ),
+
+  http.post('/api/auth/login', () =>
+    HttpResponse.json({
+      token: 'test-jwt-token',
+      user: {
+        id: 'test-user-id',
+        email: 'test-admin@smartstack.io',
+        name: 'Test Admin',
+      },
+    })
+  ),
+
+  // Navigation endpoints
+  http.get('/api/navigation', () =>
+    HttpResponse.json([])
+  ),
+
+  // User preferences
+  http.get('/api/users/preferences', () =>
+    HttpResponse.json({})
+  ),
+
+  http.put('/api/users/preferences', () =>
+    HttpResponse.json({ success: true })
+  ),
+];