@gennext/lb-infra 0.1.5 → 0.2.1

package/README.md

@@ -1,211 +1,340 @@
-# Hướng dẫn sử dụng `@gennext/lb-infra`
+# @gennext/lb-infra
 
-`@gennext/lb-infra` là một thư viện Core Infrastructure được thiết kế để chuẩn hóa kiến trúc và các tiện ích dùng chung cho các microservice / project sử dụng framework LoopBack 4 trong hệ sinh thái Gennex.
+Hệ thống thư viện hạ tầng (infrastructure) backend dựa trên TypeScript, tối ưu cho hiệu năng và tính chuẩn hóa.
 
-File này tổng hợp **những tính năng chính**, **cách cấu hình** và **cách sử dụng** các thành phần mà thư viện này cung cấp.
+## 1. Giới thiệu
+`@gennext/lb-infra` là nền tảng xây dựng backend hiện đại tại Gennex, kết hợp các công nghệ:
+- **Hono**: Web framework siêu nhẹ, hỗ trợ TypeScript và OpenAPI native.
+- **Drizzle ORM**: ORM thế hệ mới, type-safe tuyệt đối cho PostgreSQL.
+- **Zod**: Thư viện validation và định nghĩa schema mạnh mẽ.
+- **Winston**: Hệ thống logging đa kênh (Console, File, UDP).
+
+**Khi nào nên dùng:** Phù hợp cho các dự án yêu cầu tốc độ phản hồi cao, cấu trúc mã nguồn tường minh (Controller-Service-Repository) và tự động hóa tài liệu API (Swagger/OpenAPI).
 
 ---
 
-## 1. Logger (Quản lý log với Winston)
-Hệ thống logger được thiết kế sẵn để ghi log ra console và tự động xoay vòng file log (Daily Rotate File).
+## 2. Cài đặt
 
-### Cấu hình & Sử dụng
-Bạn không cần cấu hình phức tạp, chỉ cần gọi `LoggerFactory`.
+Cài đặt package chính:
+```bash
+bun add @gennext/lb-infra
+```
+
+Các peer dependency cần thiết:
+```bash
+bun add hono @hono/zod-openapi zod drizzle-orm pg winston
+# Nếu dùng Auth/Authorization
+bun add jose casbin
+```
+
+---
+
+## 3. Khởi tạo ứng dụng
+Sử dụng `BaseApplication` kết hợp với `bootMixin` để tự động quét và đăng ký các thành phần.
 
 ```typescript
-import { LoggerFactory } from '@gennext/lb-infra';
+import { BaseApplication, bootMixin, bootStrapApplication, IApplicationConfigs } from '@gennext/lb-infra';
+
+class OrderApplication extends bootMixin(BaseApplication) {
+  getAppInfo() {
+    return {
+      name: 'Order Service',
+      version: '1.0.0',
+    };
+  }
+}
 
-// Khởi tạo logger cho một class hoặc file cụ thể
-// Khuyên dùng truyền array scope để dễ traceback (VD: ['Core', 'AuthController'])
-const logger = LoggerFactory.getLogger(['Gateway', 'AuthController']);
+const configs: IApplicationConfigs = {
+  port: Number(process.env.PORT) || 3000,
+  path: { base: '/api' }
+};
 
-// Các mức độ log
-logger.info('User login successful', { userId: 123 });
-logger.debug('Debugging details: %j', someObject);
-logger.warn('Rate limit warning for IP: %s', ipAddress);
-logger.error('Database connection failed | Error: %s', error.message);
+bootStrapApplication(OrderApplication, configs);
 ```
 
 ---
 
-## 2. Redis (Quản lý Cache & Pub/Sub)
-Cung cấp `RedisManager` để quản lý nhiều instance kết nối Redis và `DefaultRedisHelper` chứa các hàm tối ưu cho việc thao tác với Redis.
+## 4. Data layer
+Sử dụng Drizzle để định nghĩa schema và các Repository để thao tác dữ liệu.
 
-### Cấu hình kết nối
-Thường được gọi khi khởi động ứng dụng (ví dụ trong `application.ts`):
+### Khai báo Drizzle Schema
+Sử dụng các helper trong `column-defs.ts` để chuẩn hóa cấu trúc bảng.
 
 ```typescript
-import { RedisManager } from '@gennext/lb-infra';
-
-RedisManager.getInstance('default', {
-  scope: 'App',
-  identifier: 'PrimaryRedis',
-  client: new Redis({
-    host: process.env.REDIS_HOST,
-    port: parseInt(process.env.REDIS_PORT),
-    password: process.env.REDIS_PASSWORD
-  }),
-  onConnected: () => console.log('Redis connected!'),
+import { pgTable, text, integer } from 'drizzle-orm/pg-core';
+import { generateIdColumnDefs, generateSoftDeleteColumnDefs, generateTzColumnDefs } from '@gennext/lb-infra';
+
+export const orders = pgTable('orders', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  orderNumber: text('order_number').notNull(),
+  amount: integer('amount'),
+  ...generateTzColumnDefs(),
+  ...generateSoftDeleteColumnDefs(),
 });
 ```
 
-### Cách sử dụng các hàm tối ưu
-```typescript
-const redis = RedisManager.getInstance('default'); // Lấy instance tên 'default'
-
-// 1. Thao tác chuỗi (String)
-await redis.set({ key: 'user:1', value: { name: 'John' }, options: { log: true } });
-const user = await redis.getObject({ key: 'user:1' }); 
-
-// 2. Thao tác hàng loạt (MGET, MSET) cực nhanh (O(N))
-await redis.mset({
-  payload: [
-    { key: 'user:1', value: { name: 'A' } },
-    { key: 'user:2', value: { name: 'B' } }
-  ]
-});
-const users = await redis.getObjects({ keys: ['user:1', 'user:2'] });
+### Repositories
+Sử dụng `DefaultCrudRepository` hoặc `SoftDeletableRepository` để có sẵn các hàm CRUD.
 
-// 3. Pub/Sub (Đã tối ưu hóa nén và gửi đa kênh)
-await redis.publish({
-  topics: ['channel-A', 'channel-B'],
-  payload: { action: 'RELOAD_CONFIG' },
-  useCompress: true // Tự động nén zlib để tối ưu băng thông
-});
+```typescript
+import { SoftDeletableRepository } from '@gennext/lb-infra';
+import { orders } from '../models/order.schema';
 
-redis.subscribe({ topic: 'channel-A' });
+export class OrderRepository extends SoftDeletableRepository<typeof orders> {
+  constructor() {
+    super(orders);
+  }
+}
 ```
 
 ---
 
-## 3. Cơ chế Database Migration (Đồng bộ Schema)
-Cho phép bạn viết các script để migrate database khi hệ thống khởi động.
-
-### Cấu hình & Sử dụng
-Trong file `migrate.ts` của project:
+## 5. Service layer
+Các service kế thừa `BaseService` và sử dụng `this.logger` (HFLogger pattern) để ghi log theo phương thức.
 
 ```typescript
-import { bootstrapMigration, TMigrationProcess } from '@gennext/lb-infra';
-
-// Định nghĩa các bước migration
-const migrations: Array<TMigrationProcess> = [
-  {
-    name: 'SeedAdminUser',
-    options: { alwaysRun: false }, // Chỉ chạy 1 lần, lần sau sẽ bỏ qua
-    cleanFn: async (app) => {
-      // Logic chạy nếu args có cờ --rebuild (Xóa data cũ)
-      const repo = await app.getRepository(UserRepository);
-      await repo.deleteAll();
-    },
-    fn: async (app) => {
-      // Logic migration chính
-      const repo = await app.getRepository(UserRepository);
-      await repo.create({ username: 'admin', role: 'ADMIN' });
+import { BaseService } from '@gennext/lb-infra';
+
+export class OrderService extends BaseService {
+  async processOrder(orderId: string) {
+    const logger = this.logger.for('processOrder');
+    logger.info('Starting process', { orderId });
+    
+    try {
+      // Logic xử lý đơn hàng...
+    } catch (error) {
+      logger.error('Failed to process', error);
+      throw error;
     }
   }
-];
+}
+```
+
+---
 
-// Khởi chạy
-bootstrapMigration(app, migrations, process.argv).catch(err => {
-  console.error('Cannot migrate database', err);
-  process.exit(1);
+## 6. Controller & Routing
+Controller quản lý các route và tích hợp Zod để tự động tạo tài liệu OpenAPI qua `defineRoute` hoặc `bindRoute`.
+
+```typescript
+import { BaseController, controller } from '@gennext/lb-infra';
+import { z } from 'zod';
+
+const OrderSchema = z.object({ 
+  id: z.string().uuid(), 
+  amount: z.number().min(1) 
 });
+
+@controller({ path: '/orders' })
+export class OrderController extends BaseController {
+  async binding() {
+    this.bindRoute({
+      configs: {
+        path: '/',
+        method: 'post',
+        request: { 
+          body: { content: { 'application/json': { schema: OrderSchema } } } 
+        },
+        responses: {
+          200: { 
+            description: 'Order created', 
+            content: { 'application/json': { schema: OrderSchema } } 
+          }
+        }
+      }
+    }).to({
+      handler: async (c) => {
+        const body = await c.req.json();
+        return c.json(body);
+      }
+    });
+  }
+}
 ```
 
 ---
 
-## 4. HTTP Client (Axios Utilities)
-Cung cấp các hàm bọc Axios để tự động xử lý và chuẩn hóa các lỗi HTTP.
+## 7. DataSources
+Cấu hình kết nối cơ sở dữ liệu qua các class kế thừa.
 
-### Sử dụng
 ```typescript
-import { get, post, put, del } from '@gennext/lb-infra';
-import axios from 'axios';
+import { PostgresDataSource, RedisDataSource } from '@gennext/lb-infra/datasources';
 
-const client = axios.create({ baseURL: 'https://api.example.com' });
+export class DbDataSource extends PostgresDataSource {
+  static dataSourceName = 'db';
+}
 
-try {
-  // Không cần xử lý try/catch bên trong, hàm get/post đã tự log và ném lỗi chuẩn hóa
-  const response = await post(client, '/users', { name: 'John' });
-  console.log(response.data);
-} catch (error) {
-  // error ở đây đã được trích xuất (error.response.data.error)
+export class CacheDataSource extends RedisDataSource {
+  static dataSourceName = 'redis';
 }
 ```
 
 ---
 
-## 5. Utilities (Tiện ích dùng chung)
-Tất cả các tiện ích đều được gom tại `src/utilities` và được export thẳng ra ngoài.
+## 8. Logger helper
+Hệ thống log mạnh mẽ hỗ trợ `RequestContext` để theo vết Request ID xuyên suốt các layer.
 
-### 5.1. Xử lý Lỗi (`error.utility`)
-Chuẩn hóa lỗi bắn ra cho client.
 ```typescript
-import { getError } from '@gennext/lb-infra';
+import { LoggerFactory, RequestContext } from '@gennext/lb-infra';
+
+const logger = LoggerFactory.getLogger(['OrderModule']);
 
-throw getError({
-  statusCode: 400,
-  message: 'Invalid email format',
-  name: 'ValidationError'
+// Sử dụng RequestContext để gắn ID tự động
+RequestContext.run({ requestId: 'req-123' }, () => {
+  logger.info('User action log'); // Log sẽ có prefix [req-123]
 });
 ```
 
-### 5.2. Mã hóa & Hashing (`crypto.utility`)
+---
+
+## 9. Redis helper
+Bộ công cụ hỗ trợ Redis String, Hash, JSON và Pub/Sub.
+
 ```typescript
-import { hash, hashPassword, comparePassword } from '@gennext/lb-infra';
+import { RedisHelper } from '@gennext/lb-infra/helpers/redis';
 
-// Hash bình thường (MD5, SHA256)
-const signature = hash('my-text', { algorithm: 'SHA256', outputType: 'hex' });
+const redis = new RedisHelper({ host: 'localhost', port: 6379 });
 
-// Hash mật khẩu (Tích hợp tự sinh salt)
-const hashedPw = await hashPassword('123456');
-const isValid = await comparePassword('123456', hashedPw);
+await redis.set({ key: 'config', value: { theme: 'dark' } });
+
+// Thao tác với RedisJSON
+await redis.jSet({ 
+  key: 'user:data', 
+  path: '$', 
+  value: { settings: { lang: 'vi' } } 
+});
+
+const lang = await redis.jGet({ key: 'user:data', path: '$.settings.lang' });
 ```
 
-### 5.3. Parse & Chuỗi hóa JSON An toàn (`parse.utility` / `axios.utility`)
-Chống sập ứng dụng (crash) khi JSON bị lỗi định dạng.
+---
+
+## 10. Authentication
+Tích hợp sẵn các chiến lược xác thực phổ biến.
+
+```typescript
+import { AuthenticateComponent, JwtStrategy } from '@gennext/lb-infra';
+
+// Trong BaseApplication
+this.component(AuthenticateComponent);
+this.bind('authentication.strategies.jwt').toClass(JwtStrategy);
+```
+
+---
+
+## 11. Authorization
+Phân quyền dựa trên thuộc tính (RBAC/ABAC) sử dụng Casbin.
+
 ```typescript
-import { safeParseJson, safeStringifyJson } from '@gennext/lb-infra';
+import { AuthorizeComponent, DrizzleCasbinAdapter } from '@gennext/lb-infra';
 
-const obj = safeParseJson('{"bad_json": ... }'); // Trả về undefined thay vì văng lỗi
-const str = safeStringifyJson({ circular: reference }); // Trả về undefined an toàn
+this.component(AuthorizeComponent);
+// Dùng DrizzleCasbinAdapter để lưu policy vào PostgreSQL
 ```
 
-### 5.4. Promise & Thời gian (`promise.utility`)
+---
+
+## 12. Components tùy chọn
+
+### gRPC
 ```typescript
-import { delay } from '@gennext/lb-infra';
+import { BaseGrpcController } from '@gennext/lb-infra/components/grpc';
 
-await delay(1000); // Chờ 1 giây
+export class UserGrpcController extends BaseGrpcController {
+  // Implement gRPC methods defined in proto
+}
 ```
 
+### Socket.IO
+Sử dụng `SocketIOServerHelper` để quản lý kết nối thời gian thực.
+
+### Health Check
+Tích hợp sẵn endpoint `/health` để monitor trạng thái hệ thống.
+
 ---
 
-## 6. Lớp Base (Base Classes)
-`@gennext/lb-infra` cung cấp các class cha chuẩn mực cho LoopBack 4 để tự động tích hợp Logger, Scope. Giúp source code các dự án con nhất quán.
+## 13. Utilities
+Các hàm tiện ích tối ưu trong `src/utilities`:
+
+- `getError(opts)`: Tạo error object chuẩn kèm `statusCode`.
+- `hash(text, opts)`: Hỗ trợ MD5, SHA256...
+- `safeParseJson(str)`: Parse JSON không lo crash.
+- `executePromiseWithLimit({ tasks, limit })`: Chạy batch tasks có giới hạn số lượng chạy song song.
+- `getDateTz()`: Lấy thời gian hiện tại theo múi giờ cấu hình.
+- `buildBatchUpdateQuery(table, data)`: Helper tạo câu lệnh cập nhật hàng loạt cho Drizzle.
+
+---
 
-- **`BaseHelper`**: Class cha cho các Helper.
-- **`BaseDatasource`**: Class cha cho cấu hình Datasource. Tự động thêm Logger.
-- *(Và các base class khác đang dần được hoàn thiện)*
+## 14. Base classes
+
+| Class | Thuộc tính/Phương thức có sẵn |
+| :--- | :--- |
+| `BaseHelper` | `this.logger` |
+| `BaseService` | `this.logger` (HFLogger), `this.get(key)` (DI) |
+| `BaseController` | `this.logger`, `this.bindRoute()`, `this.defineRoute()` |
+| `BaseDataSource` | `this.name`, `this.connector` |
+
+---
+
+## 15. Biến môi trường
+
+| Tên biến | Mô tả | Giá trị mặc định |
+| :--- | :--- | :--- |
+| `APP_ENV_APPLICATION_NAME` | Tên ứng dụng xuất hiện trong log | `APP` |
+| `APP_ENV_POSTGRES_HOST` | Địa chỉ PostgreSQL | `localhost` |
+| `APP_ENV_POSTGRES_PORT` | Cổng PostgreSQL | `5432` |
+| `APP_ENV_POSTGRES_USERNAME` | Username DB | `postgres` |
+| `APP_ENV_POSTGRES_PASSWORD` | Password DB | `password` |
+| `APP_ENV_POSTGRES_DATABASE` | Tên Database | `postgres` |
+| `APP_ENV_REDIS_DATASOURCE_HOST` | Địa chỉ Redis | `0.0.0.0` |
+| `APP_ENV_REDIS_DATASOURCE_PORT` | Cổng Redis | `6379` |
+| `APP_ENV_LOGGER_FOLDER_PATH` | Đường dẫn lưu file log | `./logs` |
+| `DEBUG` | Kích hoạt log debug | `false` |
+
+---
+
+## 16. Ví dụ end-to-end: Order Service
 
 ```typescript
-import { BaseHelper } from '@gennext/lb-infra';
+// --- 1. Model (order.schema.ts) ---
+export const orders = pgTable('orders', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  item: text('item').notNull(),
+  ...generateTzColumnDefs()
+});
 
-export class MyCustomHelper extends BaseHelper {
-  constructor() {
-    super({ scope: 'MyHelper', identifier: 'Instance1' });
-  }
+// --- 2. Repository (order.repository.ts) ---
+export class OrderRepository extends DefaultCrudRepository<typeof orders> {
+  constructor() { super(orders); }
+}
 
-  doSomething() {
-    // Thuộc tính this.logger đã được tiêm sẵn từ BaseHelper
-    this.logger.info('Doing something...');
+// --- 3. Service (order.service.ts) ---
+export class OrderService extends BaseService {
+  async create(item: string) {
+    const repo = this.get<OrderRepository>('repositories.OrderRepository');
+    return repo.create({ item });
   }
 }
-```
 
----
+// --- 4. Controller (order.controller.ts) ---
+@controller({ path: '/orders' })
+export class OrderController extends BaseController {
+  async binding() {
+    this.bindRoute({
+      path: '/', method: 'post',
+      responses: { 200: { description: 'Success' } }
+    }).to({
+      handler: async (c) => {
+        const service = this.get<OrderService>('services.OrderService');
+        return c.json(await service.create('Product A'));
+      }
+    });
+  }
+}
 
-## 7. Data Validation với Zod
-Thư viện cung cấp sẵn lớp validation sử dụng thư viện Zod kết hợp với OpenAPI. 
-Bạn có thể import các schema chuẩn từ `@gennext/lb-infra/validators` để tái sử dụng mà không cần viết lại.
+// --- 5. Application (main.ts) ---
+class OrderApp extends bootMixin(BaseApplication) {
+  getAppInfo() { return { name: 'OrderAPI', version: '1.0' }; }
+}
 
-*(Sẽ có tài liệu chi tiết cho Validator ở file chuyên biệt)*
+bootStrapApplication(OrderApp, { port: 8080 });
+```

package/dist/base/applications/base.application.d.ts

@@ -0,0 +1,62 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type { Logger } from '../../helpers';
+import type { ValueOrPromise } from '../../common';
+import type { ClassType } from '../../common/types';
+export interface IApplicationConfigs {
+    host?: string;
+    port: number;
+    path?: {
+        base: string;
+        isStrict?: boolean;
+    };
+    debug?: {
+        shouldShowRoutes?: boolean;
+    };
+    error?: {
+        rootKey?: string;
+    };
+}
+export interface IApplicationInfo {
+    name: string;
+    version: string;
+    description?: string;
+}
+export interface IMiddlewareConfigs {
+    [key: string]: any;
+}
+export declare abstract class BaseApplication {
+    protected logger: Logger;
+    protected server: OpenAPIHono;
+    protected bindings: Map<string, any>;
+    protected configs: IApplicationConfigs;
+    constructor(configs: IApplicationConfigs);
+    abstract getAppInfo(): ValueOrPromise<IApplicationInfo>;
+    staticConfigure(): void;
+    preConfigure(): ValueOrPromise<void>;
+    setupMiddlewares(): Promise<void>;
+    postConfigure(): ValueOrPromise<void>;
+    controller(_ControllerClass: new (...args: any[]) => any): void;
+    repository(_RepositoryClass: new (...args: any[]) => any): void;
+    dataSource(_DataSourceClass: new (...args: any[]) => any): void;
+    service(_ServiceClass: new (...args: any[]) => any): void;
+    component(_ComponentClass: new (...args: any[]) => any): void;
+    bind<T>(opts: {
+        key: string;
+    }): {
+        toValue: (v: T) => void;
+        toClass: (c: ClassType<T>) => void;
+    };
+    get<T>(opts: {
+        key: string;
+        isOptional?: boolean;
+    }): T;
+    getServer(): OpenAPIHono;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    static(_opts: {
+        folderPath: string;
+        mountPath?: string;
+    }): void;
+    protected applyMiddlewares(_configs: IMiddlewareConfigs): Promise<void>;
+}
+//# sourceMappingURL=base.application.d.ts.map

package/dist/base/applications/base.application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.application.d.ts","sourceRoot":"","sources":["../../../src/base/applications/base.application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C,KAAK,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,8BAAsB,eAAe;IACnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAC9B,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,SAAS,CAAC,OAAO,EAAE,mBAAmB,CAAC;gBAE3B,OAAO,EAAE,mBAAmB;IAQxC,QAAQ,CAAC,UAAU,IAAI,cAAc,CAAC,gBAAgB,CAAC;IAEvD,eAAe,IAAI,IAAI;IACvB,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC;IAC9B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IACvC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC;IAErC,UAAU,CAAC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAC/D,UAAU,CAAC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAC/D,UAAU,CAAC,gBAAgB,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAC/D,OAAO,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IACzD,SAAS,CAAC,eAAe,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAE7D,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;qBAEZ,CAAC;qBAGD,SAAS,CAAC,CAAC,CAAC;;IAM7B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,CAAC;IAOtD,SAAS,IAAI,WAAW;IAIlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,MAAM,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;cAE/C,gBAAgB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAC9E"}

package/dist/base/applications/base.application.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseApplication = void 0;
+const helpers_1 = require("../../helpers");
+class BaseApplication {
+    constructor(configs) {
+        this.configs = configs;
+        this.logger = helpers_1.LoggerFactory.getLogger(['Application']);
+        this.bindings = new Map();
+        const { OpenAPIHono } = require('@hono/zod-openapi');
+        this.server = new OpenAPIHono();
+    }
+    staticConfigure() { }
+    preConfigure() { }
+    async setupMiddlewares() { }
+    postConfigure() { }
+    controller(_ControllerClass) { }
+    repository(_RepositoryClass) { }
+    dataSource(_DataSourceClass) { }
+    service(_ServiceClass) { }
+    component(_ComponentClass) { }
+    bind(opts) {
+        return {
+            toValue: (v) => {
+                this.bindings.set(opts.key, v);
+            },
+            toClass: (c) => {
+                this.bindings.set(opts.key, new c());
+            },
+        };
+    }
+    get(opts) {
+        if (!this.bindings.has(opts.key) && !opts.isOptional) {
+            throw new Error(`Binding not found: ${opts.key}`);
+        }
+        return this.bindings.get(opts.key);
+    }
+    getServer() {
+        return this.server;
+    }
+    async start() {
+        await this.preConfigure();
+        await this.setupMiddlewares();
+        if (typeof this.boot === 'function') {
+            await this.boot();
+        }
+        await this.postConfigure();
+    }
+    async stop() { }
+    static(_opts) { }
+    async applyMiddlewares(_configs) { }
+}
+exports.BaseApplication = BaseApplication;
+//# sourceMappingURL=base.application.js.map

package/dist/base/applications/base.application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.application.js","sourceRoot":"","sources":["../../../src/base/applications/base.application.ts"],"names":[],"mappings":";;;AAEA,2CAA8C;AAsB9C,MAAsB,eAAe;IAMnC,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,uBAAa,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,CAAC;IAID,eAAe,KAAU,CAAC;IAC1B,YAAY,KAA0B,CAAC;IACvC,KAAK,CAAC,gBAAgB,KAAmB,CAAC;IAC1C,aAAa,KAA0B,CAAC;IAExC,UAAU,CAAC,gBAA6C,IAAS,CAAC;IAClE,UAAU,CAAC,gBAA6C,IAAS,CAAC;IAClE,UAAU,CAAC,gBAA6C,IAAS,CAAC;IAClE,OAAO,CAAC,aAA0C,IAAS,CAAC;IAC5D,SAAS,CAAC,eAA4C,IAAS,CAAC;IAEhE,IAAI,CAAI,IAAqB;QAC3B,OAAO;YACL,OAAO,EAAE,CAAC,CAAI,EAAE,EAAE;gBAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,CAAC,CAAe,EAAE,EAAE;gBAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;SACF,CAAC;IACJ,CAAC;IAED,GAAG,CAAI,IAA2C;QAChD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAM,CAAC;IAC1C,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9B,IAAI,OAAQ,IAAY,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7C,MAAO,IAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,MAAM,CAAC,KAAiD,IAAS,CAAC;IAExD,KAAK,CAAC,gBAAgB,CAAC,QAA4B,IAAkB,CAAC;CACjF;AA/DD,0CA+DC"}

package/dist/base/applications/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base.application';
+//# sourceMappingURL=index.d.ts.map

package/dist/base/applications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/base/applications/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/base/{migration → applications}/index.js

@@ -14,6 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./migration.interface"), exports);
-__exportStar(require("./migration.service"), exports);
+__exportStar(require("./base.application"), exports);
 //# sourceMappingURL=index.js.map

package/dist/base/applications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/base/applications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC"}

package/dist/base/controllers/base.controller.d.ts

@@ -0,0 +1,23 @@
+import type { ValueOrPromise } from '../../common';
+import type { Logger } from '../../helpers';
+import type { IRouteDefinition, IRouteHandler } from '../http';
+export interface IControllerOptions {
+    scope?: string;
+    path?: string;
+}
+export declare abstract class BaseController {
+    protected logger: Logger;
+    protected definitions: Record<string, IRouteDefinition>;
+    constructor(opts: IControllerOptions);
+    abstract binding(): ValueOrPromise<void>;
+    protected defineRoute(_handler: IRouteHandler): void;
+    protected defineJSXRoute(_handler: IRouteHandler): void;
+    protected bindRoute(opts: {
+        configs: IRouteDefinition;
+    }): {
+        to: (h: {
+            handler: any;
+        }) => void;
+    };
+}
+//# sourceMappingURL=base.controller.d.ts.map

package/dist/base/controllers/base.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.controller.d.ts","sourceRoot":"","sources":["../../../src/base/controllers/base.controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8BAAsB,cAAc;IAClC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;gBAE5C,IAAI,EAAE,kBAAkB;IAKpC,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC;IAExC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAEpD,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAEvD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,gBAAgB,CAAA;KAAE;gBAE3C;YAAE,OAAO,EAAE,GAAG,CAAA;SAAE;;CAQ7B"}