@nest-omni/core 1.0.0

package/src/common/dto/abstract.dto.ts

@@ -0,0 +1,64 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+import { DYNAMIC_TRANSLATION_DECORATOR_KEY } from '../../decorators';
+import { ContextProvider } from '../../providers';
+import {
+  AbstractEntity,
+  AbstractStringPrimaryEntity,
+} from '../abstract.entity';
+
+export class AbstractDto {
+  @ApiProperty()
+  id: number | string;
+
+  @ApiProperty()
+  createdAt: Date;
+
+  @ApiProperty()
+  updatedAt: Date;
+
+  translations?: AbstractTranslationDto[];
+
+  constructor(
+    entity: AbstractEntity | AbstractStringPrimaryEntity,
+    options?: { excludeFields?: boolean },
+  ) {
+    if (!options?.excludeFields) {
+      this.id = entity.id;
+      this.createdAt = entity.createdAt;
+      this.updatedAt = entity.updatedAt;
+    }
+
+    const languageCode = ContextProvider.getLanguage();
+
+    if (languageCode && entity.translations) {
+      const translationEntity = entity.translations.find(
+        (titleTranslation) => titleTranslation.languageCode === languageCode,
+      )!;
+
+      const fields: Record<string, string> = {};
+
+      for (const key of Object.keys(translationEntity)) {
+        const metadata = Reflect.getMetadata(
+          DYNAMIC_TRANSLATION_DECORATOR_KEY,
+          this,
+          key,
+        );
+
+        if (metadata) {
+          fields[key] = translationEntity[key];
+        }
+      }
+
+      Object.assign(this, fields);
+    } else {
+      this.translations = entity.translations?.toDtos();
+    }
+  }
+}
+
+export class AbstractTranslationDto extends AbstractDto {
+  constructor(entity: AbstractEntity | AbstractStringPrimaryEntity) {
+    super(entity, { excludeFields: true });
+  }
+}

package/src/common/dto/bulk-id.dto.d.ts

@@ -0,0 +1,3 @@
+export declare class BulkIdDto {
+    id: number[];
+}

package/src/common/dto/bulk-id.dto.js

@@ -0,0 +1,63 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkIdDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+let BulkIdDto = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _id_decorators;
+    let _id_initializers = [];
+    return _a = class BulkIdDto {
+            constructor() {
+                this.id = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _id_initializers, void 0));
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _id_decorators = [(0, swagger_1.ApiProperty)({
+                    type: 'integer',
+                    description: 'ID',
+                    isArray: true,
+                    required: false,
+                }), (0, class_validator_1.IsArray)()];
+            __esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+exports.BulkIdDto = BulkIdDto;

package/src/common/dto/bulk-id.dto.ts

@@ -0,0 +1,13 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsArray } from 'class-validator';
+
+export class BulkIdDto {
+  @ApiProperty({
+    type: 'integer',
+    description: 'ID',
+    isArray: true,
+    required: false,
+  })
+  @IsArray()
+  id: number[];
+}

package/src/common/dto/create-translation.dto.d.ts

@@ -0,0 +1,5 @@
+import { LanguageCode } from '../../constants';
+export declare class CreateTranslationDto {
+    languageCode: LanguageCode;
+    text: string;
+}

package/src/common/dto/create-translation.dto.js

@@ -0,0 +1,63 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateTranslationDto = void 0;
+const constants_1 = require("../../constants");
+const decorators_1 = require("../../decorators");
+let CreateTranslationDto = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _languageCode_decorators;
+    let _languageCode_initializers = [];
+    let _text_decorators;
+    let _text_initializers = [];
+    return _a = class CreateTranslationDto {
+            constructor() {
+                this.languageCode = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _languageCode_initializers, void 0));
+                this.text = __runInitializers(this, _text_initializers, void 0);
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _languageCode_decorators = [(0, decorators_1.EnumField)(() => constants_1.LanguageCode)];
+            _text_decorators = [(0, decorators_1.StringField)()];
+            __esDecorate(null, null, _languageCode_decorators, { kind: "field", name: "languageCode", static: false, private: false, access: { has: obj => "languageCode" in obj, get: obj => obj.languageCode, set: (obj, value) => { obj.languageCode = value; } }, metadata: _metadata }, _languageCode_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _text_decorators, { kind: "field", name: "text", static: false, private: false, access: { has: obj => "text" in obj, get: obj => obj.text, set: (obj, value) => { obj.text = value; } }, metadata: _metadata }, _text_initializers, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+exports.CreateTranslationDto = CreateTranslationDto;

package/src/common/dto/create-translation.dto.ts

@@ -0,0 +1,10 @@
+import { LanguageCode } from '../../constants';
+import { EnumField, StringField } from '../../decorators';
+
+export class CreateTranslationDto {
+  @EnumField(() => LanguageCode)
+  languageCode: LanguageCode;
+
+  @StringField()
+  text: string;
+}

package/src/common/dto/page-meta.dto.d.ts

@@ -0,0 +1,15 @@
+import type { PageOptionsDto } from './page-options.dto';
+interface IPageMetaDtoParameters {
+    pageOptionsDto: PageOptionsDto;
+    itemCount: number;
+}
+export declare class PageMetaDto {
+    readonly page: number;
+    readonly pageSize: number;
+    readonly itemCount: number;
+    readonly pageCount: number;
+    readonly hasPreviousPage: boolean;
+    readonly hasNextPage: boolean;
+    constructor({ pageOptionsDto, itemCount }: IPageMetaDtoParameters);
+}
+export {};

package/src/common/dto/page-meta.dto.js

@@ -0,0 +1,88 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageMetaDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+let PageMetaDto = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _page_decorators;
+    let _page_initializers = [];
+    let _pageSize_decorators;
+    let _pageSize_initializers = [];
+    let _itemCount_decorators;
+    let _itemCount_initializers = [];
+    let _pageCount_decorators;
+    let _pageCount_initializers = [];
+    let _hasPreviousPage_decorators;
+    let _hasPreviousPage_initializers = [];
+    let _hasNextPage_decorators;
+    let _hasNextPage_initializers = [];
+    return _a = class PageMetaDto {
+            constructor({ pageOptionsDto, itemCount }) {
+                this.page = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _page_initializers, void 0));
+                this.pageSize = __runInitializers(this, _pageSize_initializers, void 0);
+                this.itemCount = __runInitializers(this, _itemCount_initializers, void 0);
+                this.pageCount = __runInitializers(this, _pageCount_initializers, void 0);
+                this.hasPreviousPage = __runInitializers(this, _hasPreviousPage_initializers, void 0);
+                this.hasNextPage = __runInitializers(this, _hasNextPage_initializers, void 0);
+                this.page = pageOptionsDto.page;
+                this.pageSize = pageOptionsDto.pageSize;
+                this.itemCount = itemCount;
+                this.pageCount = Math.ceil(this.itemCount / this.pageSize);
+                this.hasPreviousPage = this.page > 1;
+                this.hasNextPage = this.page < this.pageCount;
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _page_decorators = [(0, swagger_1.ApiProperty)()];
+            _pageSize_decorators = [(0, swagger_1.ApiProperty)()];
+            _itemCount_decorators = [(0, swagger_1.ApiProperty)()];
+            _pageCount_decorators = [(0, swagger_1.ApiProperty)()];
+            _hasPreviousPage_decorators = [(0, swagger_1.ApiProperty)()];
+            _hasNextPage_decorators = [(0, swagger_1.ApiProperty)()];
+            __esDecorate(null, null, _page_decorators, { kind: "field", name: "page", static: false, private: false, access: { has: obj => "page" in obj, get: obj => obj.page, set: (obj, value) => { obj.page = value; } }, metadata: _metadata }, _page_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _pageSize_decorators, { kind: "field", name: "pageSize", static: false, private: false, access: { has: obj => "pageSize" in obj, get: obj => obj.pageSize, set: (obj, value) => { obj.pageSize = value; } }, metadata: _metadata }, _pageSize_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _itemCount_decorators, { kind: "field", name: "itemCount", static: false, private: false, access: { has: obj => "itemCount" in obj, get: obj => obj.itemCount, set: (obj, value) => { obj.itemCount = value; } }, metadata: _metadata }, _itemCount_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _pageCount_decorators, { kind: "field", name: "pageCount", static: false, private: false, access: { has: obj => "pageCount" in obj, get: obj => obj.pageCount, set: (obj, value) => { obj.pageCount = value; } }, metadata: _metadata }, _pageCount_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _hasPreviousPage_decorators, { kind: "field", name: "hasPreviousPage", static: false, private: false, access: { has: obj => "hasPreviousPage" in obj, get: obj => obj.hasPreviousPage, set: (obj, value) => { obj.hasPreviousPage = value; } }, metadata: _metadata }, _hasPreviousPage_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _hasNextPage_decorators, { kind: "field", name: "hasNextPage", static: false, private: false, access: { has: obj => "hasNextPage" in obj, get: obj => obj.hasNextPage, set: (obj, value) => { obj.hasNextPage = value; } }, metadata: _metadata }, _hasNextPage_initializers, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+exports.PageMetaDto = PageMetaDto;

package/src/common/dto/page-meta.dto.ts

@@ -0,0 +1,37 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+import type { PageOptionsDto } from './page-options.dto';
+
+interface IPageMetaDtoParameters {
+  pageOptionsDto: PageOptionsDto;
+  itemCount: number;
+}
+
+export class PageMetaDto {
+  @ApiProperty()
+  readonly page: number;
+
+  @ApiProperty()
+  readonly pageSize: number;
+
+  @ApiProperty()
+  readonly itemCount: number;
+
+  @ApiProperty()
+  readonly pageCount: number;
+
+  @ApiProperty()
+  readonly hasPreviousPage: boolean;
+
+  @ApiProperty()
+  readonly hasNextPage: boolean;
+
+  constructor({ pageOptionsDto, itemCount }: IPageMetaDtoParameters) {
+    this.page = pageOptionsDto.page;
+    this.pageSize = pageOptionsDto.pageSize;
+    this.itemCount = itemCount;
+    this.pageCount = Math.ceil(this.itemCount / this.pageSize);
+    this.hasPreviousPage = this.page > 1;
+    this.hasNextPage = this.page < this.pageCount;
+  }
+}

package/src/common/dto/page-options.dto.d.ts

@@ -0,0 +1,8 @@
+import { Order } from '../../constants';
+export declare class PageOptionsDto {
+    readonly order: Order;
+    readonly page: number;
+    readonly pageSize: number;
+    get skip(): number;
+    readonly q?: string;
+}

package/src/common/dto/page-options.dto.js

@@ -0,0 +1,87 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageOptionsDto = void 0;
+const constants_1 = require("../../constants");
+const decorators_1 = require("../../decorators");
+let PageOptionsDto = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _order_decorators;
+    let _order_initializers = [];
+    let _page_decorators;
+    let _page_initializers = [];
+    let _pageSize_decorators;
+    let _pageSize_initializers = [];
+    let _q_decorators;
+    let _q_initializers = [];
+    return _a = class PageOptionsDto {
+            constructor() {
+                this.order = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _order_initializers, constants_1.Order.ASC));
+                this.page = __runInitializers(this, _page_initializers, 1);
+                this.pageSize = __runInitializers(this, _pageSize_initializers, 10);
+                this.q = __runInitializers(this, _q_initializers, void 0);
+            }
+            get skip() {
+                return (this.page - 1) * this.pageSize;
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _order_decorators = [(0, decorators_1.EnumFieldOptional)(() => constants_1.Order, {
+                    default: constants_1.Order.ASC,
+                })];
+            _page_decorators = [(0, decorators_1.NumberFieldOptional)({
+                    minimum: 1,
+                    default: 1,
+                    int: true,
+                })];
+            _pageSize_decorators = [(0, decorators_1.NumberFieldOptional)({
+                    minimum: 1,
+                    maximum: 50,
+                    default: 10,
+                    int: true,
+                })];
+            _q_decorators = [(0, decorators_1.StringFieldOptional)()];
+            __esDecorate(null, null, _order_decorators, { kind: "field", name: "order", static: false, private: false, access: { has: obj => "order" in obj, get: obj => obj.order, set: (obj, value) => { obj.order = value; } }, metadata: _metadata }, _order_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _page_decorators, { kind: "field", name: "page", static: false, private: false, access: { has: obj => "page" in obj, get: obj => obj.page, set: (obj, value) => { obj.page = value; } }, metadata: _metadata }, _page_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _pageSize_decorators, { kind: "field", name: "pageSize", static: false, private: false, access: { has: obj => "pageSize" in obj, get: obj => obj.pageSize, set: (obj, value) => { obj.pageSize = value; } }, metadata: _metadata }, _pageSize_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _q_decorators, { kind: "field", name: "q", static: false, private: false, access: { has: obj => "q" in obj, get: obj => obj.q, set: (obj, value) => { obj.q = value; } }, metadata: _metadata }, _q_initializers, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+exports.PageOptionsDto = PageOptionsDto;

package/src/common/dto/page-options.dto.ts

@@ -0,0 +1,35 @@
+import { Order } from '../../constants';
+import {
+  EnumFieldOptional,
+  NumberFieldOptional,
+  StringFieldOptional,
+} from '../../decorators';
+
+export class PageOptionsDto {
+  @EnumFieldOptional(() => Order, {
+    default: Order.ASC,
+  })
+  readonly order: Order = Order.ASC;
+
+  @NumberFieldOptional({
+    minimum: 1,
+    default: 1,
+    int: true,
+  })
+  readonly page: number = 1;
+
+  @NumberFieldOptional({
+    minimum: 1,
+    maximum: 50,
+    default: 10,
+    int: true,
+  })
+  readonly pageSize: number = 10;
+
+  get skip(): number {
+    return (this.page - 1) * this.pageSize;
+  }
+
+  @StringFieldOptional()
+  readonly q?: string;
+}

package/src/common/dto/page.dto.d.ts

@@ -0,0 +1,11 @@
+import { PageMetaDto } from './page-meta.dto';
+export declare class PageDto<T> {
+    readonly data: T[];
+    count: number;
+    total: number;
+    page: number;
+    pageCount: number;
+    hasPreviousPage: boolean;
+    hasNextPage: boolean;
+    constructor(data: T[], meta: PageMetaDto);
+}

package/src/common/dto/page.dto.js

@@ -0,0 +1,94 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PageDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+let PageDto = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _data_decorators;
+    let _data_initializers = [];
+    let _count_decorators;
+    let _count_initializers = [];
+    let _total_decorators;
+    let _total_initializers = [];
+    let _page_decorators;
+    let _page_initializers = [];
+    let _pageCount_decorators;
+    let _pageCount_initializers = [];
+    let _hasPreviousPage_decorators;
+    let _hasPreviousPage_initializers = [];
+    let _hasNextPage_decorators;
+    let _hasNextPage_initializers = [];
+    return _a = class PageDto {
+            constructor(data, meta) {
+                this.data = (__runInitializers(this, _instanceExtraInitializers), __runInitializers(this, _data_initializers, void 0));
+                this.count = __runInitializers(this, _count_initializers, void 0);
+                this.total = __runInitializers(this, _total_initializers, void 0);
+                this.page = __runInitializers(this, _page_initializers, void 0);
+                this.pageCount = __runInitializers(this, _pageCount_initializers, void 0);
+                this.hasPreviousPage = __runInitializers(this, _hasPreviousPage_initializers, void 0);
+                this.hasNextPage = __runInitializers(this, _hasNextPage_initializers, void 0);
+                this.data = data;
+                this.count = meta.pageSize;
+                this.pageCount = meta.pageCount;
+                this.page = meta.page;
+                this.total = meta.itemCount;
+                this.hasPreviousPage = meta.hasPreviousPage;
+                this.hasNextPage = meta.hasNextPage;
+            }
+        },
+        (() => {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _data_decorators = [(0, swagger_1.ApiProperty)({ isArray: true })];
+            _count_decorators = [(0, swagger_1.ApiProperty)()];
+            _total_decorators = [(0, swagger_1.ApiProperty)()];
+            _page_decorators = [(0, swagger_1.ApiProperty)()];
+            _pageCount_decorators = [(0, swagger_1.ApiProperty)()];
+            _hasPreviousPage_decorators = [(0, swagger_1.ApiProperty)()];
+            _hasNextPage_decorators = [(0, swagger_1.ApiProperty)()];
+            __esDecorate(null, null, _data_decorators, { kind: "field", name: "data", static: false, private: false, access: { has: obj => "data" in obj, get: obj => obj.data, set: (obj, value) => { obj.data = value; } }, metadata: _metadata }, _data_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _count_decorators, { kind: "field", name: "count", static: false, private: false, access: { has: obj => "count" in obj, get: obj => obj.count, set: (obj, value) => { obj.count = value; } }, metadata: _metadata }, _count_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _total_decorators, { kind: "field", name: "total", static: false, private: false, access: { has: obj => "total" in obj, get: obj => obj.total, set: (obj, value) => { obj.total = value; } }, metadata: _metadata }, _total_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _page_decorators, { kind: "field", name: "page", static: false, private: false, access: { has: obj => "page" in obj, get: obj => obj.page, set: (obj, value) => { obj.page = value; } }, metadata: _metadata }, _page_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _pageCount_decorators, { kind: "field", name: "pageCount", static: false, private: false, access: { has: obj => "pageCount" in obj, get: obj => obj.pageCount, set: (obj, value) => { obj.pageCount = value; } }, metadata: _metadata }, _pageCount_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _hasPreviousPage_decorators, { kind: "field", name: "hasPreviousPage", static: false, private: false, access: { has: obj => "hasPreviousPage" in obj, get: obj => obj.hasPreviousPage, set: (obj, value) => { obj.hasPreviousPage = value; } }, metadata: _metadata }, _hasPreviousPage_initializers, _instanceExtraInitializers);
+            __esDecorate(null, null, _hasNextPage_decorators, { kind: "field", name: "hasNextPage", static: false, private: false, access: { has: obj => "hasNextPage" in obj, get: obj => obj.hasNextPage, set: (obj, value) => { obj.hasNextPage = value; } }, metadata: _metadata }, _hasNextPage_initializers, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        })(),
+        _a;
+})();
+exports.PageDto = PageDto;

package/src/common/dto/page.dto.ts

@@ -0,0 +1,36 @@
+import { ApiProperty } from '@nestjs/swagger';
+
+import { PageMetaDto } from './page-meta.dto';
+
+export class PageDto<T> {
+  @ApiProperty({ isArray: true })
+  readonly data: T[];
+
+  @ApiProperty()
+  count: number;
+
+  @ApiProperty()
+  total: number;
+
+  @ApiProperty()
+  page: number;
+
+  @ApiProperty()
+  pageCount: number;
+
+  @ApiProperty()
+  hasPreviousPage: boolean;
+
+  @ApiProperty()
+  hasNextPage: boolean;
+
+  constructor(data: T[], meta: PageMetaDto) {
+    this.data = data;
+    this.count = meta.pageSize;
+    this.pageCount = meta.pageCount;
+    this.page = meta.page;
+    this.total = meta.itemCount;
+    this.hasPreviousPage = meta.hasPreviousPage;
+    this.hasNextPage = meta.hasNextPage;
+  }
+}