fragment-ts 1.2.4 → 1.2.6

package/API.md

@@ -4,6 +4,7 @@ This document lists public exports and their intended usage.
 Each item is documented on its own line for easy search and indexing.
 
 ## Core Application
+
 - `FragmentApplication(options)` class decorator
 - `FragmentWebApplication` bootstrap class
 - `DIContainer` dependency injection container
@@ -11,6 +12,7 @@ Each item is documented on its own line for easy search and indexing.
 - `ComponentScanner` manual component scanning
 
 ## Core Decorators
+
 - `@FragmentApplication(options)`
 - `@Controller(path?)`
 - `@Service()`
@@ -19,6 +21,7 @@ Each item is documented on its own line for easy search and indexing.
 - `@AutoConfiguration()`
 
 ## Injection Decorators
+
 - `@Autowired()`
 - `@Inject(token)`
 - `@InjectRepository(entity)`
@@ -28,6 +31,7 @@ Each item is documented on its own line for easy search and indexing.
 - `@Lazy()`
 
 ## HTTP Decorators
+
 - `@Get(path?)`
 - `@Post(path?)`
 - `@Put(path?)`
@@ -41,63 +45,50 @@ Each item is documented on its own line for easy search and indexing.
 - `@Res()`
 
 ## Lifecycle Decorators
+
 - `@PostConstruct()`
 - `@PreDestroy()`
 - `@OnStartup(order?)`
 - `@OnShutdown(order?)`
 
 ## Pipeline Decorators
+
 - `@FragmentMiddleware(MiddlewareClass)`
 - `@FragmentGuard(GuardClass)`
 - `@FragmentInterceptor(InterceptorClass)`
 - `@FragmentExceptionFilter(ExceptionFilterClass)`
 
 ## Plugin Decorators
+
 - `@Plugin(options)`
 - `@Plugin(token, qualifier?) (property)`
 - `@OnPluginInit(order?)`
 - `@OnPluginShutdown(order?)`
 
 ## Mail Decorators
+
 - `@Mailer(options)`
 - `@Mail(qualifier?) (property)`
 - `@MailTemplate(options)`
 
 ## Notification Decorators
+
 - `@NotificationChannel(options)`
 
 ## Jobs Decorators
+
 - `@Job(options)`
 - `@Cron(expression, options?)`
 
-## Frontend Decorators
-- `@View(options)`
-- `@Views(options)`
-- `@Store(options)`
-- `@UIComponent(options)`
-- `@Template(options)`
-- `@Templates(options)`
-- `@Action(options)`
-- `@Actions(options)`
-- `@Effect(options)`
-- `@Effects(options)`
-- `@State(options?)`
-- `@States(options?)`
-
 ## Docs Decorators
+
 - `@ApiTag(tag)`
 - `@ApiOperation({ summary, description })`
 - `@ApiResponse({ status, description, type, isArray, example })`
 - `@ApiProperty({ description, required, example, type })`
-## Frontend Classes
-- `FrontendModule`
-- `FrontendRegistry`
-- `FrontendRouter`
-- `StoreManager`
-- `ThemeManager`
-- `MobXStoreAdapter`
 
 ## Mail Classes
+
 - `MailManager`
 - `MailTemplateRegistry`
 - `MailTransportRegistry`
@@ -109,6 +100,7 @@ Each item is documented on its own line for easy search and indexing.
 - `MailQueueAdapter`
 
 ## Notification Classes
+
 - `NotificationManager`
 - `NotificationRegistry`
 - `NotificationChannel`
@@ -118,6 +110,7 @@ Each item is documented on its own line for easy search and indexing.
 - `NotificationChannelSelection`
 
 ## Jobs Classes
+
 - `Job`
 - `ScheduledJob`
 - `JobManager`
@@ -128,20 +121,24 @@ Each item is documented on its own line for easy search and indexing.
 - `ScheduleOptions`
 
 ## Docs Classes
+
 - `DocGenerator`
 
 ## Auth Module
+
 - `AuthModule`
 - `authMiddleware()`
 - `roleGuard()`
 
 ## AI Module
+
 - `AIModule`
 - `AIProvider`
 - `OpenAIProvider`
 - `OllamaProvider`
 
 ## Errors
+
 - `FragmentError`
 - `BadRequestError`
 - `UnauthorizedError`
@@ -152,11 +149,13 @@ Each item is documented on its own line for easy search and indexing.
 - `InternalServerError`
 
 ## Logging
+
 - `FragmentLogger`
 - `LoggerSettings`
 - `LogLevel`
 
 ## Testing
+
 - `initTestRunner()`
 - `describe()`
 - `it()`
@@ -165,20 +164,24 @@ Each item is documented on its own line for easy search and indexing.
 - `afterEach()`
 
 ## CLI Programmatic API
+
 - `FragmentCommand`
 - `CommandRegistry`
 - `CommandRunner`
 
 ## Request Context
+
 - `RequestContextStorage`
 - `@RequestContext()`
 
 ## Third-Party Re-exports
+
 - `express` (from Express)
 - `typeorm`
 - `dotenv`
 
 ## CLI Commands
+
 - `fragment init [dir]`
 - `fragment init --type=plugin`
 - `fragment serve`
@@ -212,7 +215,9 @@ Each item is documented on its own line for easy search and indexing.
 - `fragment make:store <name>`
 - `fragment make:component <name>`
 - `fragment make:template <name>`
+
 ## Configuration Keys
+
 - `structure.type`
 - `verbose`
 - `logging.level`
@@ -235,15 +240,9 @@ Each item is documented on its own line for easy search and indexing.
 - `docs.perModuleRoutes`
 - `plugins`
 - `pluginAutoQualify`
-- `frontend.enabled`
-- `frontend.templates.default`
-- `frontend.templates.system`
-- `frontend.templates.custom`
-- `frontend.styles.framework`
-- `frontend.styles.tailwind`
-- `frontend.routes.base`
 
 ## API Notes
+
 - `@FragmentApplication(options)` is part of the public API surface.
 - `@Controller(path?)` is part of the public API surface.
 - `@Service()` is part of the public API surface.
@@ -272,23 +271,13 @@ Each item is documented on its own line for easy search and indexing.
 - `@PreDestroy()` is part of the lifecycle API surface.
 - `@OnStartup(order?)` is part of the lifecycle API surface.
 - `@OnShutdown(order?)` is part of the lifecycle API surface.
-- `@View(options)` is part of the frontend API surface.
-- `@Views(options)` is part of the frontend API surface.
-- `@Store(options)` is part of the frontend API surface.
-- `@UIComponent(options)` is part of the frontend API surface.
-- `@Template(options)` is part of the frontend API surface.
-- `@Templates(options)` is part of the frontend API surface.
-- `@Action(options)` is part of the frontend API surface.
-- `@Actions(options)` is part of the frontend API surface.
-- `@Effect(options)` is part of the frontend API surface.
-- `@Effects(options)` is part of the frontend API surface.
-- `@State(options?)` is part of the frontend API surface.
-- `@States(options?)` is part of the frontend API surface.
 - `@ApiTag(tag)` is part of the docs API surface.
 - `@ApiOperation({ summary, description })` is part of the docs API surface.
 - `@ApiResponse({ status, description, type, isArray, example })` is part of the docs API surface.
 - `@ApiProperty({ description, required, example, type })` is part of the docs API surface.
+
 ## Extended API Index
+
 - CLI: `fragment init [dir]` is supported by the framework binary.
 - CLI: `fragment init --type=plugin` is supported by the framework binary.
 - CLI: `fragment serve` is supported by the framework binary.
@@ -344,24 +333,21 @@ Each item is documented on its own line for easy search and indexing.
 - Config: `docs.perModuleRoutes` appears in the configuration schema.
 - Config: `plugins` appears in the configuration schema.
 - Config: `pluginAutoQualify` appears in the configuration schema.
-- Config: `frontend.enabled` appears in the configuration schema.
-- Config: `frontend.templates.default` appears in the configuration schema.
-- Config: `frontend.templates.system` appears in the configuration schema.
-- Config: `frontend.templates.custom` appears in the configuration schema.
-- Config: `frontend.routes.base` appears in the configuration schema.
+
 ## Export Notes
+
 - Import from the root package (`fragment-ts`) instead of deep paths to avoid breakage across releases.
 - Ensure `reflect-metadata` is imported once at app startup before any decorators are evaluated.
 - File suffixes drive component discovery; keep names aligned with suffixes for consistent scanning.
 - Use `FragmentError` (or subclasses) for consistent HTTP mapping and structured logging.
 - Prefer `FragmentLogger` over `console.log` to honor `verbose` and log level settings.
-- Frontend metadata relies on MobX. Ensure `mobx` is installed when frontend is enabled.
 - Use `CommandRunner.run()` for programmatic CLI usage in jobs or scripts.
 - Docs decorators (`@ApiTag`, `@ApiOperation`, etc.) only affect documentation output, not runtime behavior.
 - Config values support `${ENV:default}` interpolation through `ConfigUtils`.
 - TypeORM exports are available under `eloquent` for convenience.
 
 ## API Conventions
+
 - Keep decorators adjacent to the class or method they configure.
 - Prefer constructor injection for required dependencies and property injection for optional ones.
 - Avoid manual `new` for DI-managed classes; let the container resolve them.
@@ -376,9 +362,11 @@ Each item is documented on its own line for easy search and indexing.
 - Keep file suffixes aligned with component types to keep scanning reliable.
 
 ## API Walkthrough Examples
+
 This section gives short, implementation-oriented examples for the most-used APIs.
 
 ### Application Bootstrapping
+
 ```ts
 import { FragmentApplication, FragmentWebApplication } from "fragment-ts";
 
@@ -394,6 +382,7 @@ bootstrap();
 ```
 
 ### DI and Services
+
 ```ts
 import { Service, Inject } from "fragment-ts";
 
@@ -416,6 +405,7 @@ class SessionService {
 ```
 
 ### FragmentError Usage
+
 ```ts
 import { FragmentError } from "fragment-ts";
 
@@ -427,6 +417,7 @@ class PolicyError extends FragmentError {
 ```
 
 ### HTTP Controllers
+
 ```ts
 import { Controller, Get, Post, Body } from "fragment-ts";
 
@@ -445,6 +436,7 @@ class TaskController {
 ```
 
 ### Plugin Lifecycle
+
 ```ts
 import { Plugin, OnPluginInit, OnPluginShutdown } from "fragment-ts";
 
@@ -459,6 +451,7 @@ class AuditPlugin {
 ```
 
 ### Mail and Templates
+
 ```ts
 import { Mailer, MailTemplate, MailManager } from "fragment-ts";
 import type { MailProvider, MailMessage } from "fragment-ts";
@@ -474,10 +467,15 @@ class ConsoleMailer implements MailProvider {
 class WelcomeTemplate {}
 
 const mail = new MailManager();
-await mail.send({ to: "user@example.com", template: "welcome", data: { name: "Ada" } });
+await mail.send({
+  to: "user@example.com",
+  template: "welcome",
+  data: { name: "Ada" },
+});
 ```
 
 ### Notifications
+
 ```ts
 import { NotificationManager, NotificationChannel } from "fragment-ts";
 
@@ -488,8 +486,12 @@ class SmsChannel extends NotificationChannel<string> {
 }
 
 class AlertNotification {
-  via() { return ["sms"]; }
-  toSms() { return "Service degraded"; }
+  via() {
+    return ["sms"];
+  }
+  toSms() {
+    return "Service degraded";
+  }
 }
 
 const manager = new NotificationManager();
@@ -497,6 +499,7 @@ await manager.send(new AlertNotification());
 ```
 
 ### Jobs and Scheduling
+
 ```ts
 import { Job, Cron, ScheduledJob } from "fragment-ts";
 
@@ -511,32 +514,8 @@ class MetricsJob extends ScheduledJob {
 new MetricsJob().everyHour(6);
 ```
 
-### Frontend Metadata
-```ts
-import { View, Store, Template, UIComponent, State, Action } from "fragment-ts";
-
-@Template({ name: "app", kind: "system", components: ["TopNav"] })
-class AppTemplate {}
-
-@UIComponent({ name: "TopNav" })
-class TopNav {}
-
-@Store({ name: "home" })
-class HomeStore {
-  @State()
-  count = 0;
-
-  @Action()
-  increment() {
-    this.count += 1;
-  }
-}
-
-@View({ path: "/", template: "app", store: "home" })
-class HomeView {}
-```
-
 ### Docs Generation
+
 ```ts
 import { DocGenerator } from "fragment-ts";
 
@@ -545,6 +524,7 @@ generator.generate({ outputDir: "docs", perModule: true });
 ```
 
 ### Programmatic CLI
+
 ```ts
 import { CommandRunner } from "fragment-ts";