@gennext/lb-infra 0.1.4 → 0.2.0

package/README.md

@@ -1,105 +1,340 @@
 # @gennext/lb-infra
 
-Thư viện hạ tầng tiêu chuẩn (Infrastructure Library) dành cho các dịch vụ backend LoopBack 4 tại Gennex. Package này cung cấp các thành phần cốt lõi để chuẩn hóa mã nguồn, cải thiện tính ổn định và khả năng quan sát (observability) của hệ thống.
+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.
 
-## ✨ Tính năng chính
+## 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).
 
-- 🚀 **Base Components:** Cung cấp Base Model, Base Entity, Base DataSource và Base Helper chuẩn hóa.
-- 🪵 **Enhanced Logger:** Logger nâng cao dựa trên Winston, hỗ trợ Request ID tự động (AsyncLocalStorage), Data Masking dữ liệu nhạy cảm và Access Log.
-- 📦 **Redis Helpers:** Wrapper cho ioredis hỗ trợ Cluster, tự động nén dữ liệu (zlib), và tích hợp sẵn JSON commands (RedisJSON).
-- 🛠️ **Utilities:** Bộ tiện ích phong phú cho Crypto, Date (DayJS), Error Handling, Model mapping, và Promise concurrency control.
-- 🚦 **Standardized Error Handling:** Hệ thống Error class chuyên biệt (NotImplemented, Validation, ApplicationError) hỗ trợ metadata và serialization.
-- 🔌 **Standard Exports:** Re-export các module LoopBack phổ biến (@lb/auth, @lb/core, @lb/rest, @lb/repo) để đồng bộ phiên bản.
+**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).
 
-## 📦 Cài đặt
+---
 
+## 2. Cài đặt
+
+Cài đặt package chính:
 ```bash
 bun add @gennext/lb-infra
-# Hoặc dùng npm/yarn
-npm install @gennext/lb-infra
 ```
 
-## 🚀 Sử dụng nhanh
+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 { BaseApplication, bootMixin, bootStrapApplication, IApplicationConfigs } from '@gennext/lb-infra';
+
+class OrderApplication extends bootMixin(BaseApplication) {
+  getAppInfo() {
+    return {
+      name: 'Order Service',
+      version: '1.0.0',
+    };
+  }
+}
+
+const configs: IApplicationConfigs = {
+  port: Number(process.env.PORT) || 3000,
+  path: { base: '/api' }
+};
+
+bootStrapApplication(OrderApplication, configs);
+```
+
+---
+
+## 4. Data layer
+Sử dụng Drizzle để định nghĩa schema và các Repository để thao tác dữ liệu.
 
-### 1. Cấu hình & Sử dụng Logger
-Logger hỗ trợ tự động đính kèm `requestId` xuyên suốt luồng xử lý (trên cả console và file log).
+### 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.
 
-```ts
-import { LoggerFactory } from '@gennext/lb-infra';
+```typescript
+import { pgTable, text, integer } from 'drizzle-orm/pg-core';
+import { generateIdColumnDefs, generateSoftDeleteColumnDefs, generateTzColumnDefs } from '@gennext/lb-infra';
 
-// Cấu hình toàn cục (thường gọi ở main.ts hoặc app.ts)
-LoggerFactory.config({
-  mode: 'modern',
-  defaultRequestIDSystem: 'requestContext',
-  defaultLogFormat: 'modern',
-  defaultDataMasking: {
-    useMaskDataLib: true,
-  },
+export const orders = pgTable('orders', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  orderNumber: text('order_number').notNull(),
+  amount: integer('amount'),
+  ...generateTzColumnDefs(),
+  ...generateSoftDeleteColumnDefs(),
 });
+```
+
+### Repositories
+Sử dụng `DefaultCrudRepository` hoặc `SoftDeletableRepository` để có sẵn các hàm CRUD.
+
+```typescript
+import { SoftDeletableRepository } from '@gennext/lb-infra';
+import { orders } from '../models/order.schema';
+
+export class OrderRepository extends SoftDeletableRepository<typeof orders> {
+  constructor() {
+    super(orders);
+  }
+}
+```
+
+---
+
+## 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 { BaseService } from '@gennext/lb-infra';
 
-const logger = LoggerFactory.getLogger(['user-service', 'auth']);
-logger.info('Dịch vụ đã sẵn sàng');
+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;
+    }
+  }
+}
 ```
 
-### 2. Sử dụng Redis Helper
-Hỗ trợ đầy đủ các thao tác với Object, String và RedisJSON.
+---
 
-```ts
-import { RedisHelper } from '@gennext/lb-infra';
+## 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`.
 
-const cache = new RedisHelper({
-  name: 'app-cache',
-  host: process.env.REDIS_HOST,
-  port: 6379,
+```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) 
 });
 
-// Lưu trữ object (tự động serialize JSON)
-await cache.set({ key: 'user:1', value: { id: 1, name: 'Gennex' } });
+@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);
+      }
+    });
+  }
+}
+```
+
+---
+
+## 7. DataSources
+Cấu hình kết nối cơ sở dữ liệu qua các class kế thừa.
 
-// Đọc và chuyển đổi object
-const user = await cache.getObject({ key: 'user:1' });
+```typescript
+import { PostgresDataSource, RedisDataSource } from '@gennext/lb-infra/datasources';
+
+export class DbDataSource extends PostgresDataSource {
+  static dataSourceName = 'db';
+}
+
+export class CacheDataSource extends RedisDataSource {
+  static dataSourceName = 'redis';
+}
 ```
 
-### 3. Xử lý Lỗi (Error Handling)
-Hỗ trợ các class lỗi có cấu trúc, giúp Frontend dễ dàng xử lý thông báo lỗi.
+---
 
-```ts
-import { ValidationError, NotImplementedError } from '@gennext/lb-infra';
+## 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.
 
-// Khi dữ liệu không hợp lệ
-throw new ValidationError('Email không đúng định dạng', { email: 'invalid-email' });
+```typescript
+import { LoggerFactory, RequestContext } from '@gennext/lb-infra';
 
-// Khi tính năng chưa được triển khai
-throw new NotImplementedError('exportToExcel');
+const logger = LoggerFactory.getLogger(['OrderModule']);
+
+// 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]
+});
 ```
 
-### 4. Utilities tiện ích
-```ts
-import { sleep, executePromiseWithLimit } from '@gennext/lb-infra';
+---
 
-// Chờ 1 giây
-await sleep(1000);
+## 9. Redis helper
+Bộ công cụ hỗ trợ Redis String, Hash, JSON và Pub/Sub.
 
-// Chạy 100 task đồng thời, nhưng giới hạn tối đa 5 task cùng lúc
-await executePromiseWithLimit({
-  tasks: myTaskArray,
-  limit: 5
+```typescript
+import { RedisHelper } from '@gennext/lb-infra/helpers/redis';
+
+const redis = new RedisHelper({ host: 'localhost', port: 6379 });
+
+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' });
 ```
 
-## 📂 Cấu trúc thư mục
+---
 
-- `src/base`: Các lớp cơ sở cho Model, DataSource, Helper.
-- `src/common`: Các kiểu dữ liệu, hằng số và mã kết quả chung.
-- `src/datasources`: Triển khai các kết nối dữ liệu (Postgres, Redis).
-- `src/helpers`: Các module bổ trợ quan trọng (Logger, Redis).
-- `src/utilities`: Các hàm tiện ích dùng chung.
+## 10. Authentication
+Tích hợp sẵn các chiến lược xác thực phổ biến.
 
-## 🛠️ Scripts hỗ trợ (Maintainer)
+```typescript
+import { AuthenticateComponent, JwtStrategy } from '@gennext/lb-infra';
 
-- `bun run build`: Biên dịch mã nguồn sang thư mục `dist`.
-- `bun run test`: Chạy bộ test suite (Node.js test runner).
-- `bun run lint`: Kiểm tra chất lượng và định dạng mã nguồn.
+// 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 { AuthorizeComponent, DrizzleCasbinAdapter } from '@gennext/lb-infra';
+
+this.component(AuthorizeComponent);
+// Dùng DrizzleCasbinAdapter để lưu policy vào PostgreSQL
+```
+
+---
+
+## 12. Components tùy chọn
+
+### gRPC
+```typescript
+import { BaseGrpcController } from '@gennext/lb-infra/components/grpc';
+
+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.
+
+---
+
+## 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.
 
-## 📄 License
-MIT - Gennex Technology.
+---
+
+## 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
+// --- 1. Model (order.schema.ts) ---
+export const orders = pgTable('orders', {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  item: text('item').notNull(),
+  ...generateTzColumnDefs()
+});
+
+// --- 2. Repository (order.repository.ts) ---
+export class OrderRepository extends DefaultCrudRepository<typeof orders> {
+  constructor() { super(orders); }
+}
+
+// --- 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'));
+      }
+    });
+  }
+}
+
+// --- 5. Application (main.ts) ---
+class OrderApp extends bootMixin(BaseApplication) {
+  getAppInfo() { return { name: 'OrderAPI', version: '1.0' }; }
+}
+
+bootStrapApplication(OrderApp, { port: 8080 });
+```

package/dist/drizzle.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("drizzle-kit").Config;
+export default _default;
+//# sourceMappingURL=drizzle.config.d.ts.map

package/dist/drizzle.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.d.ts","sourceRoot":"","sources":["../drizzle.config.ts"],"names":[],"mappings":";AAEA,wBAYG"}

package/dist/drizzle.config.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const drizzle_kit_1 = require("drizzle-kit");
+exports.default = (0, drizzle_kit_1.defineConfig)({
+    dialect: 'postgresql',
+    schema: './src/**/*.schema.ts',
+    out: './migration',
+    dbCredentials: {
+        host: process.env.APP_ENV_POSTGRES_HOST,
+        port: Number(process.env.APP_ENV_POSTGRES_PORT),
+        user: process.env.APP_ENV_POSTGRES_USERNAME,
+        password: process.env.APP_ENV_POSTGRES_PASSWORD,
+        database: process.env.APP_ENV_POSTGRES_DATABASE,
+        ssl: false,
+    },
+});
+//# sourceMappingURL=drizzle.config.js.map

package/dist/drizzle.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.js","sourceRoot":"","sources":["../drizzle.config.ts"],"names":[],"mappings":";;AAAA,6CAA2C;AAE3C,kBAAe,IAAA,0BAAY,EAAC;IAC1B,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,sBAAsB;IAC9B,GAAG,EAAE,aAAa;IAClB,aAAa,EAAE;QACb,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAsB;QACxC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAsB,CAAC;QAChD,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,yBAA0B;QAC5C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,yBAA0B;QAChD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,yBAA0B;QAChD,GAAG,EAAE,KAAK;KACX;CACF,CAAC,CAAC"}

package/dist/src/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/src/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/src/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/src/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/src/base/applications/index.d.ts

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

package/dist/src/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/src/base/applications/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./base.application"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/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 → src/base}/base.helper.d.ts

@@ -1,4 +1,4 @@
-import { Logger } from '../helpers/logger';
+import { Logger } from '@/helpers/logger';
 export declare class BaseHelper {
     protected identifier: string;
     protected scope: string;

package/dist/src/base/base.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.helper.d.ts","sourceRoot":"","sources":["../../../src/base/base.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAEzD,qBAAa,UAAU;IACrB,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAKxD,SAAS,KAAK,MAAM,IAAI,MAAM,CAO7B;CACF"}

package/dist/{base → src/base}/base.helper.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseHelper = void 0;
-const logger_1 = require("../helpers/logger");
+const logger_1 = require("@/helpers/logger");
 class BaseHelper {
     constructor(opts) {
         this.scope = opts.scope;

package/dist/src/base/base.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.helper.js","sourceRoot":"","sources":["../../../src/base/base.helper.ts"],"names":[],"mappings":";;;AAAA,6CAAyD;AAEzD,MAAa,UAAU;IAKrB,YAAY,IAA4C;QACtD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,IAAc,MAAM;QAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,GAAG,sBAAa,CAAC,SAAS,CACpC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAlBD,gCAkBC"}

package/dist/src/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/src/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"}