ts-rails 1.0.0

package/README.md

@@ -0,0 +1,442 @@
+# ts-rails 🚂
+
+**The Core Engine for TS Rails.**  
+Hệ thống lõi cung cấp các tính năng mạnh mẽ tương tự Ruby on Rails cho hệ sinh thái Node.js, sử dụng TypeScript và Express.
+
+---
+
+## 🌟 Tính năng nổi bật
+
+- 🚀 **Application**: Tích hợp sâu vào lõi Express.
+- 🛣 **Routing Siêu Tốc**: Hỗ trợ `resource()` và helper `action()` để định nghĩa route nhanh chóng.
+- 🎮 **Controller Decorators**: Sử dụng `@BeforeAction`, `@AfterAction` để quản lý luồng xử lý (Filters).
+- 🔌 **Real-time Channels**: Tích hợp Socket.IO thông qua `RailsChannel` (giống ActionCable).
+- 📮 **Unified Mailers**: Interface gửi mail đồng nhất với hệ thống Adapter linh hoạt.
+- 📝 **Auto Swagger**: Tự động tạo tài liệu OpenAPI dựa trên khai báo route và validators.
+- 🔢 **Pagination & Response**: Chuẩn hóa dữ liệu trả về và hỗ trợ phân trang chuẩn mực.
+- 🖼 **View Helpers**: Hỗ trợ mạnh mẽ cho Pug/EJS với định dạng tiền tệ, thời gian và Vite assets.
+- 👷 **Background Jobs**: Định nghĩa job chạy nền đồng nhất cho cả BullMQ và AWS Lambda.
+- 🛠 **CLI Scaffolding**: Bộ generator mạnh mẽ giúp tạo code nhanh chóng.
+
+---
+
+## 📦 Cài đặt
+
+Cài đặt thông qua các package manager yêu thích của bạn:
+
+```bash
+# npm
+npm install ts-rails
+
+# yarn
+yarn add ts-rails
+
+# pnpm
+pnpm add ts-rails
+```
+
+---
+
+## 🛠 Các thành phần chính
+
+### 1. RailsApplication Core 🚂
+
+`RailsApplication` là trái tim của hệ thống, quản lý toàn bộ vòng đời ứng dụng (Lifecycle), từ việc thiết lập cấu hình, nạp Initializers, quản lý Middleware cho đến khởi chạy Server và Socket.IO.
+
+#### 1. Khởi tạo Application Class
+
+Để bắt đầu, bạn cần kế thừa lớp `RailsApplication`. Đây là nơi bạn định nghĩa cách ứng dụng của mình khởi động.
+
+```typescript
+import { RailsApplication } from "ts-rails";
+import { Route } from "./routes";
+
+export class Application extends RailsApplication {
+  constructor() {
+    super();
+    this.port = process.env.PORT || "8000";
+  }
+
+  // Gắn Router vào Express
+  protected mountRoutes() {
+    this.app.use("/", Route.draw());
+  }
+
+  // Khởi tạo các dịch vụ cần thiết (Database, Redis, etc.)
+  public async initialize() {
+    this.setupAppMiddlewares();
+    await this.setupServices();
+    this.bootstrap(); // Thiết lập server HTTP và Socket.IO
+  }
+}
+```
+
+#### 2. Middleware Factory Configuration
+
+Framework cung cấp một `MiddlewareFactory` toàn cục để bạn có thể ghi đè hoặc bổ sung các middleware hệ thống (như Rate Limit, Request Logging) bằng logic tùy chỉnh của mình.
+
+```typescript
+import { RailsApplication, MiddlewareFactory } from "ts-rails";
+import { rateLimitMiddleware } from "@middlewares/rateLimit.middleware";
+import { requestIdMiddleware } from "@middlewares/requestId.middleware";
+
+RailsApplication.middlewareFactory = {
+  rateLimit: rateLimitMiddleware,
+  requestId: () => requestIdMiddleware,
+  requestLogging: () => (req, res, next) => {
+    console.log(`${req.method} ${req.url}`);
+    next();
+  },
+} as MiddlewareFactory;
+```
+
+#### 3. Quản lý Controller Concerns (Mixins)
+
+Tương tự như Ruby on Rails, bạn có thể sử dụng `loadConcerns` để "nhúng" các hàm dùng chung vào Controller mà không cần kế thừa phức tạp.
+
+```typescript
+import { ApplicationController } from "@controllers/application.controller";
+
+// Trong phương thức initialize() của Application class:
+this.loadConcerns(
+  ApplicationController.prototype,
+  "app/controllers/concerns", // Đường dẫn tới thư mục chứa các file .ts concern
+);
+```
+
+_Ví dụ: Nếu bạn có file `rescuable.ts` trong thư mục concerns, các phương thức trong đó sẽ tự động xuất hiện trong `ApplicationController`._
+
+#### 4. Socket.IO Channels
+
+Đăng ký tất cả các lớp Channel để sử dụng tính năng Real-time:
+
+```typescript
+import * as channels from "@channels";
+
+RailsApplication.channelClasses = Object.values(channels);
+```
+
+#### 5. Background Processing (BullMQ)
+
+Framework hỗ trợ xử lý tác vụ chạy nền. Bạn có thể override `startBackgroundProcessor` để khởi chạy Worker:
+
+```typescript
+protected startBackgroundProcessor() {
+  // Logic setup BullMQ Worker hoặc các trình xử lý hàng đợi khác
+  setupBullMQWorker();
+}
+```
+
+#### 6. Vòng đời khởi chạy (Full Lifecycle)
+
+Dưới đây là thứ tự chuẩn để chạy ứng dụng:
+
+```typescript
+export class Application extends RailsApplication {
+  // ... các phương thức setupConfig, setupViewEngine ...
+
+  public async run() {
+    // 1. Chạy các Initializers (Logger, Mailer, Cache...)
+    initializeLogger();
+    initializeMailer();
+
+    // 2. Setup view engine & static files
+    this.app.set("view engine", "pug");
+
+    // 3. Khởi tạo hệ thống
+    await this.initialize();
+
+    // 4. Start Server
+    super.run();
+  }
+}
+
+const app = new Application();
+app.run();
+```
+
+#### 📄 Ghi chú
+
+Mọi cấu hình mặc định có thể được tùy chỉnh thông qua việc override các phương thức `protected` trong lớp `RailsApplication`.
+
+### 2. Resourceful Routing & `action()`
+
+Không còn phải khai báo từng route thủ công. Kết nối trực tiếp Route với Controller Class:
+
+```typescript
+import { RailsRoute, action } from "ts-rails";
+import { UsersController } from "../controllers/users.controller";
+
+export class AppRoute extends RailsRoute {
+  draw(): void {
+    / Tạo ra 7 routes tiêu chuẩn (index, show, create, update, destroy, ...)
+    this.resource("/users", UsersController, {
+      only: ["index", "show", "create"],
+      setPermissionFor: "USER_MANAGEMENT",
+    });
+
+    // Sử dụng helper action() cho các route tùy chỉnh
+    this.get("/profile", action(UsersController, "profile"));
+  }
+}
+```
+
+### 4. Strong Parameters & Validation
+
+Thư viện hỗ trợ cơ chế bảo mật tham số đầu vào (Whitelist) kết hợp với `class-validator` để tự động kiểm tra và chuyển đổi kiểu dữ liệu.
+
+#### Bước 1: Định nghĩa Validator Class
+
+```typescript
+import { IsEmail, IsString, MinLength, IsOptional } from "class-validator";
+
+export class CreateUserValidator {
+  @IsEmail({}, { message: "Email không hợp lệ" })
+  email: string;
+
+  @IsString()
+  @MinLength(3, { message: "Tên phải có ít nhất 3 ký tự" })
+  name: string;
+
+  @IsString()
+  @IsOptional()
+  bio?: string;
+}
+```
+
+#### Bước 2: Sử dụng trong Controller
+
+```typescript
+import { RailsController } from "ts-rails";
+import { CreateUserValidator } from "../validators/user.validator";
+
+export class UsersController extends RailsController {
+  async create() {
+    /**
+     * this.params(Validator) thực hiện:
+     * 1. Validate dữ liệu từ request body/query dựa trên class-validator.
+     * 2. Tự động trả về lỗi 422 nếu dữ liệu không hợp lệ.
+     * 3. .permit(...) whitelist các trường được phép nhận.
+     */
+    const userParams = await this.params(CreateUserValidator).permit(
+      "email",
+      "name",
+      "bio",
+    );
+
+    // userParams đã được validate và lọc sạch
+    const user = await UserService.create(userParams);
+    return this.renderJson(user);
+  }
+}
+```
+
+### 5. Controller Filters & Decorators
+
+Quản lý logic tiền xử lý và hậu xử lý cực kỳ dễ dàng:
+
+```typescript
+import { RailsController, BeforeAction, AfterAction } from "ts-rails";
+
+@BeforeAction("authenticate", { except: ["index"] })
+@AfterAction("logActivity", { only: ["create", "update"] })
+export class UsersController extends RailsController {
+  async authenticate() {
+    if (!this.req.session.userId) return this.renderError(401, "Unauthorized");
+  }
+
+  // ... logic xử lý các action khác
+}
+```
+
+### 6. File Upload Validation
+
+Tích hợp sẵn middleware xử lý upload và kiểm tra ràng buộc file ngay trong cấu hình route.
+
+```typescript
+this.resource("/products", ProductsController, {
+  upload: {
+    fields: [
+      { name: "thumbnail", maxCount: 1 },
+      { name: "gallery", maxCount: 5 },
+    ],
+    limits: {
+      fileSize: 5 * 1024 * 1024, // Giới hạn 5MB cho mỗi file
+    },
+    fileFilter: (req, file, cb) => {
+      // Chỉ cho phép file ảnh
+      if (!file.mimetype.startsWith("image/")) {
+        return cb(new Error("Chỉ chấp nhận định dạng hình ảnh!"), false);
+      }
+      cb(null, true);
+    },
+  },
+});
+```
+
+### 7. Real-time Channels (Socket.IO)
+
+Khai báo channel theo hướng đối tượng:
+
+```typescript
+import { RailsChannel } from "ts-rails";
+
+export class ChatChannel extends RailsChannel {
+  subscribe() {
+    this.on("message", (data) => {
+      this.broadcast("room_1", { content: data });
+    });
+  }
+}
+```
+
+### 8. View Helpers (Time, Currency, Vite)
+
+Cung cấp sẵn bộ `viewHelpers` để sử dụng trong các template engine:
+
+```typescript
+import { viewHelpers as h } from "ts-rails";
+
+h.timeAgo(Date.now()); // "a few seconds ago"
+h.numberToCurrency(50000); // "50.000 ₫"
+h.assetPath("main.ts"); // Tự động nhận diện path từ Vite manifest
+```
+
+### 9. Mailers & Custom Adapters
+
+Hệ thống Mailer hoạt động theo mô hình Adapter, cho phép bạn linh hoạt thay đổi dịch vụ gửi mail mà không làm thay đổi code business.
+
+#### Bước 1: Triển khai Adapter (Ví dụ: Gmail OAuth2)
+
+```typescript
+import { MailerAdapter } from "ts-rails";
+import { createTransport } from "nodemailer";
+
+export class GmailOAuth2Adapter implements MailerAdapter {
+  async sendMail(options: any): Promise<void> {
+    const transporter = createTransport({
+      service: "gmail",
+      auth: {
+        type: "OAuth2",
+        user: process.env.EMAIL_FROM,
+        clientId: process.env.GOOGLE_CLIENT_ID,
+        clientSecret: process.env.GOOGLE_CLIENT_SECRET,
+        refreshToken: process.env.GOOGLE_REFRESH_TOKEN,
+      },
+    });
+
+    await transporter.sendMail({
+      ...options,
+      from: options.from || this.getDefaultFromAddress(),
+    });
+  }
+
+  getDefaultFromAddress(): string {
+    return `TS Rails App <${process.env.EMAIL_FROM}>`;
+  }
+}
+```
+
+#### Bước 2: Đăng ký Adapter trong Initializer
+
+```typescript
+import { RailsApplication } from "ts-rails";
+import { GmailOAuth2Adapter } from "./mail/gmail-oauth2.adapter";
+
+// Cấu hình thường đặt trong configs/initializers/mailer.ts
+RailsApplication.mailerAdapter = new GmailOAuth2Adapter();
+```
+
+#### Bước 3: Định nghĩa và sử dụng Mailer
+
+```typescript
+import { RailsMailer } from "ts-rails";
+
+export class UserMailer extends RailsMailer {
+  static async welcome(user: any) {
+    await this.deliver({
+      to: user.email,
+      subject: "Welcome to TS Rails!",
+      template: "mailers/welcome",
+      locals: { name: user.name },
+    });
+  }
+}
+```
+
+### 10. Pagination & Standardized Response
+
+```typescript
+import { parsePagination, buildPaginatedResponse } from "ts-rails";
+
+async index() {
+  const { page, perPage, skip } = parsePagination(this.req.query);
+  const [data, total] = await db.user.findManyAndCount({ skip, take: perPage });
+
+  return this.renderJson(buildPaginatedResponse(data, total, { page, perPage }));
+}
+```
+
+---
+
+## ⚙️ Cấu hình & Tiện ích
+
+### Swagger Configuration
+
+Tự động quét và tạo tài liệu API:
+
+```typescript
+this.resource("/api/users", UsersController, {
+  document: {
+    body: CreateUserValidator,
+    summary: "Tạo người dùng mới",
+    tags: ["User Management"],
+  },
+});
+```
+
+### Logger & Cache
+
+Sử dụng interface đồng nhất cho toàn hệ thống:
+
+```typescript
+import { logger } from "ts-rails";
+import { Cache } from "ts-rails";
+
+logger.info("Server started");
+await Cache.set("key", value, { ttl: 3600 });
+```
+
+---
+
+## 💻 CLI Commands
+
+Sử dụng command `rails` để sinh mã nguồn nhanh chóng theo chuẩn `field:type`.
+
+**Cú pháp:**  
+`npx rails generate <loại> <TênModel> [field:type field:type ...]`
+
+### Các lệnh chính:
+
+| Lệnh           | Mô tả                                         | Ví dụ                                                              |
+| :------------- | :-------------------------------------------- | :----------------------------------------------------------------- |
+| `g scaffold`   | Tạo trọn bộ: Model, Controller, Views, Routes | `npx rails g scaffold Product name:string price:integer desc:text` |
+| `g resource`   | Tạo API Resource (Controller + Model)         | `npx rails g resource Order total:decimal status:string`           |
+| `g controller` | Tạo Controller mới                            | `npx rails g controller Admin/Dashboard`                           |
+| `g service`    | Tạo Service xử lý logic                       | `npx rails g service Payment`                                      |
+| `g mailer`     | Tạo class Mailer                              | `npx rails g mailer Notification`                                  |
+| `g job`        | Tạo Background Job                            | `npx rails g job SyncData`                                         |
+| `g channel`    | Tạo Socket.IO Channel                         | `npx rails g channel Chat`                                         |
+
+**Các kiểu dữ liệu hỗ trợ:**  
+`string`, `text`, `integer`, `float`, `decimal`, `boolean`, `date`, `datetime`, `json`.
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+_Phát triển bởi Hoan Pham và cộng đồng._

package/dist/app/channels/index.d.ts

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

package/dist/app/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../app/channels/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/app/channels/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("./railsChannel"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../app/channels/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/app/channels/railsChannel.d.ts

@@ -0,0 +1,11 @@
+import { Socket, Server as SocketServer } from "socket.io";
+export declare abstract class RailsChannel {
+    protected io: SocketServer;
+    protected socket: Socket;
+    constructor(io: SocketServer, socket: Socket);
+    abstract subscribe(): void;
+    protected join(room: string): void;
+    protected leave(room: string): void;
+    protected broadcastTo(room: string, event: string, ...data: any[]): void;
+}
+//# sourceMappingURL=railsChannel.d.ts.map

package/dist/app/channels/railsChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"railsChannel.d.ts","sourceRoot":"","sources":["../../../app/channels/railsChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,8BAAsB,YAAY;IAChC,SAAS,CAAC,EAAE,EAAE,YAAY,CAAC;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAc5C,QAAQ,CAAC,SAAS,IAAI,IAAI;IAM1B,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM;IAQ3B,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM;IAU5B,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;CAGlE"}

package/dist/app/channels/railsChannel.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RailsChannel = void 0;
+class RailsChannel {
+    constructor(io, socket) {
+        this.io = io;
+        this.socket = socket;
+    }
+    join(room) {
+        this.socket.join(room);
+    }
+    leave(room) {
+        this.socket.leave(room);
+    }
+    broadcastTo(room, event, ...data) {
+        this.io.to(room).emit(event, ...data);
+    }
+}
+exports.RailsChannel = RailsChannel;
+//# sourceMappingURL=railsChannel.js.map

package/dist/app/channels/railsChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"railsChannel.js","sourceRoot":"","sources":["../../../app/channels/railsChannel.ts"],"names":[],"mappings":";;;AAEA,MAAsB,YAAY;IAIhC,YAAY,EAAgB,EAAE,MAAc;QAC1C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAiBS,IAAI,CAAC,IAAY;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAMS,KAAK,CAAC,IAAY;QAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAQS,WAAW,CAAC,IAAY,EAAE,KAAa,EAAE,GAAG,IAAW;QAC/D,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC;CACF;AA7CD,oCA6CC"}

package/dist/app/controllers/controllerHelpers.d.ts

@@ -0,0 +1,4 @@
+import { RequestHandler } from "express";
+export declare function action(Klass: new (...args: any[]) => any, actionName: string): RequestHandler;
+export declare function action(Klass: new (...args: any[]) => any): RequestHandler;
+//# sourceMappingURL=controllerHelpers.d.ts.map

package/dist/app/controllers/controllerHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllerHelpers.d.ts","sourceRoot":"","sources":["../../../app/controllers/controllerHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,cAAc,EAAY,MAAM,SAAS,CAAC;AAS1E,wBAAgB,MAAM,CACpB,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAClC,UAAU,EAAE,MAAM,GACjB,cAAc,CAAC;AAClB,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,cAAc,CAAC"}

package/dist/app/controllers/controllerHelpers.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.action = action;
+function action(Klass, actionName = "execute") {
+    return async (req, res, next) => {
+        const instance = new Klass();
+        instance.req = req;
+        instance.res = res;
+        try {
+            const beforeResult = await runFilters(Klass, instance, actionName, "beforeActions");
+            if (beforeResult === false) {
+                return;
+            }
+            try {
+                if (actionName === "execute" &&
+                    typeof instance.execute === "function" &&
+                    instance.execute.length >= 3) {
+                    await instance.execute(req, res, next);
+                }
+                else {
+                    await instance[actionName]();
+                }
+            }
+            finally {
+                await runFilters(Klass, instance, actionName, "afterActions");
+            }
+        }
+        catch (error) {
+            next(error);
+        }
+    };
+}
+async function runFilters(Klass, instance, actionName, filterType) {
+    const filters = Klass[filterType] || [];
+    for (const filter of filters) {
+        const handlerName = filter.handler;
+        const options = filter.options;
+        const only = options === null || options === void 0 ? void 0 : options.only;
+        const except = options === null || options === void 0 ? void 0 : options.except;
+        const shouldRun = actionName !== "execute" &&
+            ((!only && !except) ||
+                (only && only.includes(actionName)) ||
+                (except && !except.includes(actionName)));
+        if (shouldRun) {
+            if (typeof instance[handlerName] !== "function") {
+                throw new Error(`Filter handler "${handlerName}" is not a valid method on ${Klass.name}`);
+            }
+            const result = await instance[handlerName]();
+            if (filterType === "beforeActions" && result === false)
+                return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=controllerHelpers.js.map

package/dist/app/controllers/controllerHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllerHelpers.js","sourceRoot":"","sources":["../../../app/controllers/controllerHelpers.ts"],"names":[],"mappings":";;AAoBA,wBAyCC;AAzCD,SAAgB,MAAM,CACpB,KAAkC,EAClC,UAAU,GAAG,SAAS;IAEtB,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QAC/D,MAAM,QAAQ,GAAG,IAAI,KAAK,EAAE,CAAC;QAC5B,QAAgB,CAAC,GAAG,GAAG,GAAG,CAAC;QAC3B,QAAgB,CAAC,GAAG,GAAG,GAAG,CAAC;QAE5B,IAAI,CAAC;YAEH,MAAM,YAAY,GAAG,MAAM,UAAU,CACnC,KAAK,EACL,QAAQ,EACR,UAAU,EACV,eAAe,CAChB,CAAC;YACF,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;gBAC3B,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBAEH,IACE,UAAU,KAAK,SAAS;oBACxB,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU;oBACtC,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,EAC5B,CAAC;oBACD,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;gBACzC,CAAC;qBAAM,CAAC;oBACN,MAAO,QAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,CAAC;YACH,CAAC;oBAAS,CAAC;gBAGT,MAAM,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,KAAU,EACV,QAAa,EACb,UAAkB,EAClB,UAA4C;IAE5C,MAAM,OAAO,GACX,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAE1B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAmD,CAAC;QAC3E,MAAM,IAAI,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,IAAI,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,CAAC;QAE/B,MAAM,SAAS,GACb,UAAU,KAAK,SAAS;YACxB,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC;gBACjB,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACnC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAE9C,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,OAAQ,QAAgB,CAAC,WAAW,CAAC,KAAK,UAAU,EAAE,CAAC;gBACzD,MAAM,IAAI,KAAK,CACb,mBAAmB,WAAW,8BAA8B,KAAK,CAAC,IAAI,EAAE,CACzE,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAO,QAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;YACtD,IAAI,UAAU,KAAK,eAAe,IAAI,MAAM,KAAK,KAAK;gBAAE,OAAO,KAAK,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/app/controllers/decorators.d.ts

@@ -0,0 +1,4 @@
+import { AfterActionOptions, BeforeActionOptions } from "./railsController";
+export declare function BeforeAction(handler: string, options?: BeforeActionOptions): (constructor: Function) => void;
+export declare function AfterAction(handler: string, options?: AfterActionOptions): (constructor: Function) => void;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/app/controllers/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../app/controllers/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAM5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,IACxD,aAAa,QAAQ,UAQvC;AAMD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,IACtD,aAAa,QAAQ,UAQvC"}

package/dist/app/controllers/decorators.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BeforeAction = BeforeAction;
+exports.AfterAction = AfterAction;
+function BeforeAction(handler, options) {
+    return function (constructor) {
+        const target = constructor;
+        if (!Object.prototype.hasOwnProperty.call(target, "beforeActions")) {
+            target.beforeActions = [...(target.beforeActions || [])];
+        }
+        target.beforeActions.push({ handler, options });
+    };
+}
+function AfterAction(handler, options) {
+    return function (constructor) {
+        const target = constructor;
+        if (!Object.prototype.hasOwnProperty.call(target, "afterActions")) {
+            target.afterActions = [...(target.afterActions || [])];
+        }
+        target.afterActions.push({ handler, options });
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/app/controllers/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../app/controllers/decorators.ts"],"names":[],"mappings":";;AAMA,oCASC;AAMD,kCASC;AAxBD,SAAgB,YAAY,CAAC,OAAe,EAAE,OAA6B;IACzE,OAAO,UAAU,WAAqB;QACpC,MAAM,MAAM,GAAG,WAAkB,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,CAAC;YAEnE,MAAM,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC;AACJ,CAAC;AAMD,SAAgB,WAAW,CAAC,OAAe,EAAE,OAA4B;IACvE,OAAO,UAAU,WAAqB;QACpC,MAAM,MAAM,GAAG,WAAkB,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YAElE,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/app/controllers/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./controllerHelpers";
+export * from "./decorators";
+export * from "./pagination";
+export * from "./railsController";
+export * from "./response";
+export * from "./strongParams";
+//# sourceMappingURL=index.d.ts.map

package/dist/app/controllers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../app/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/app/controllers/index.js

@@ -0,0 +1,23 @@
+"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("./controllerHelpers"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./pagination"), exports);
+__exportStar(require("./railsController"), exports);
+__exportStar(require("./response"), exports);
+__exportStar(require("./strongParams"), exports);
+//# sourceMappingURL=index.js.map

package/dist/app/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../app/controllers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,+CAA6B;AAC7B,+CAA6B;AAC7B,oDAAkC;AAClC,6CAA2B;AAC3B,iDAA+B"}