@nomalism-com/types 0.33.88 → 0.34.2

package/src/modules/stock/productGoogleSheets/interface.ts

@@ -0,0 +1,339 @@
+import {
+  type ProductImage,
+  type ProductVirtuals,
+  type UnitOfMeasure,
+  type VatTax,
+  type VatTaxZone,
+  type ProductPromotionVirtuals,
+  type ProductBaseVirtuals,
+  type ProductSheet,
+} from '../../../shared/entities';
+import * as IShared from '../../../shared/interface';
+import * as IDocumentLine from '../../supply/documentLine/interfaces';
+
+export const Route = 'product_sheets';
+
+export const UpperName = 'ProductsSheets';
+
+export const LowerName = UpperName[0].toLowerCase() + UpperName.substring(1);
+
+export type IProductPromotionVirtuals = ProductPromotionVirtuals;
+
+export type IProductVirtuals = ProductVirtuals;
+
+export type IProductBaseVirtuals = ProductBaseVirtuals;
+
+export type Entity = ProductSheet;
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type IProductsForSheetsResponse = Record<string, any>;
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type IProductFromSheetsValues = Record<string, any>;
+
+export type IProductSheetState = 'Ativa' | 'NaoVemMais' | 'VemTemporariamente';
+
+export const ProductStateEnum: {
+  Ativa: 'Ativa';
+  NaoVemMais: 'NaoVemMais';
+  VemTemporariamente: 'VemTemporariamente';
+} = {
+  Ativa: 'Ativa',
+  NaoVemMais: 'NaoVemMais',
+  VemTemporariamente: 'VemTemporariamente',
+};
+
+export const ProductStateLabels: Record<keyof typeof ProductStateEnum, string> = {
+  Ativa: 'Ativa',
+  NaoVemMais: 'Nao Vem Mais',
+  VemTemporariamente: 'Vem Temporariamente',
+};
+
+export type IProductState = (typeof ProductStateEnum)[keyof typeof ProductStateEnum];
+
+export const productState = Object.keys(ProductStateEnum);
+
+export const ProductTypeEnum: {
+  Encomenda: 'Encomenda';
+  Stock: 'Stock';
+  Servico: 'Servico';
+  Producao: 'Producao';
+  Portes: 'Portes';
+  RM: 'RM';
+  Montagem: 'Montagem';
+} = {
+  Encomenda: 'Encomenda',
+  Stock: 'Stock',
+  Servico: 'Servico',
+  Producao: 'Producao',
+  Portes: 'Portes',
+  RM: 'RM',
+  Montagem: 'Montagem',
+};
+
+export type IProductType = (typeof ProductTypeEnum)[keyof typeof ProductTypeEnum];
+
+export const productTypes = Object.keys(ProductTypeEnum);
+
+export interface ICreateRequest {
+  // create fields
+  id?: string;
+  reference?: string;
+  origin_id?: string | null;
+  id_provider?: number;
+  provider_ref?: string | null;
+  name?: string | null;
+  designation: string | null;
+  state?: IProductSheetState; // defaults to Ativa
+  type?: IProductType; // defaults to stock
+  type_of_inventory?: string; // defaults to 'M'
+  external_id?: string;
+  vat_tax_id?: string; // defaults to 'Normal'
+  weight?: number | null;
+  width?: number | null;
+  height?: number | null;
+  length?: number | null;
+  diameter?: number | null;
+  price_cost?: number; // can be undefined if price_sale & margin are numbers
+  price_sale?: number; // can be undefined if price_cost & margin are numbers
+  max_discount?: number; // replaces no_discount
+  unit_of_measure_quantity_id?: string; // defaults to configured quantity unit of measure
+  cabide_product_color?: string | null;
+  imported_from_sheets?: boolean;
+  values?: IProductsForSheetsResponse;
+  maintenances?: string;
+  compositions?: string;
+  attributes?: string;
+  created_by?: string;
+  updated_by?: string;
+}
+
+export interface IUpdateRequest {
+  designation?: string;
+  provider_ref?: string;
+  type?: IProductType;
+  unit_of_measure_quantity_notation?: string;
+  state?: IProductSheetState;
+  price_cost?: number;
+  price_sale?: number;
+}
+
+export interface IFindProductSheetByReference {
+  selector: string;
+}
+
+interface IProductSheetEntityBase extends Omit<Entity, 'values'> {
+  unit_of_measure_quantity: UnitOfMeasure;
+  vat_tax: VatTax & {
+    vat_tax_zones: VatTaxZone[];
+  };
+  promotions: ProductPromotionVirtuals[];
+  product_images: ProductImage[];
+}
+
+export interface IProductSheetEntity extends IProductSheetEntityBase {
+  base_virtual: ProductBaseVirtuals | null;
+}
+
+export interface IProductCabideColors {
+  id: string;
+  reference: string;
+  cabide_product_color: string;
+  thumbnail: string | null;
+}
+
+export interface IProductSheetCabideEntity {
+  reference: string;
+  designation: string;
+  provider: number;
+  hanger: string;
+  pattern: string;
+  type: string;
+  price_cost: number;
+  shipping: number;
+  margin: number;
+  tax_value: number;
+  price_sale_less_3m: number;
+  price_sale_greater_3m: number;
+  price_sale_piece: number;
+  width: number;
+  unit_of_measure_quantity_id: string;
+  unit_of_measure_quantity_notation: string;
+  composition: string;
+  maintenance: string;
+  attributes: string;
+  estimated_delivery: string;
+  existing_colors: IProductCabideColors[];
+}
+
+export interface IBasicSearchRequest extends IShared.IPaginationRequest {
+  search_value: string | null;
+  active?: boolean;
+  inactive?: boolean;
+  dnt_come_anymore?: boolean;
+  types?: string;
+}
+
+export interface IBasicSearchResponse {
+  id: string;
+  reference: string;
+  designation: string;
+  price: number;
+  promotion_price: number | null;
+  thumbnail?: string | null;
+  stock: number;
+  updated_at: Date;
+  state: IProductSheetState;
+  inactive: boolean;
+}
+
+export interface IEntityMinified {
+  id: string;
+  id_provider: number;
+  reference: string;
+  designation: string;
+  price_sale: number;
+  price_cost: number;
+  tax: number;
+  multimedia_id: string | null;
+  integer_only: boolean;
+}
+
+export interface IPrintLabelQueryRequest {
+  token: string;
+}
+
+export interface IFindByReferenceRequest {
+  reference: string; // partial search term (virtual reference)
+  allowProviderWildcard?: boolean; // allow searching for products with undefined provider "0-" (default false)
+  id_provider?: number; // limit search to this provider number
+  available?: boolean; // limit search to products with available stock
+  type?: IProductType; // limit search to product of this type
+}
+
+export interface IValidateByReferenceRequest extends IFindByReferenceRequest {
+  billing_country_id?: string;
+}
+
+export interface IFindSimilarProductsByNameRequest {
+  name: string;
+}
+
+export interface IFindSimilarProductsByNameResponse {
+  id: string;
+  reference: string;
+  thumbnail: string | null;
+}
+
+export interface IFindByProductTypeRequest {
+  id_provider: number;
+  type: IProductType;
+}
+
+export interface IFindByProductTypeResponse {
+  id: string;
+  reference: string;
+  price: number;
+}
+
+export interface ICheckStockByIdsRequest {
+  ids: string[];
+}
+
+export interface ICheckStockByIdsResponse {
+  id: string;
+  reference: string;
+  available: number;
+}
+
+export interface IFindReferenceAndIdForMobileResponse {
+  id: string;
+  reference: string;
+}
+
+export interface IFindDataForMobileResponse {
+  id: string;
+  reference: string;
+  designation: string;
+  type: IProductType;
+  state: IProductSheetState;
+  thumbnail: string | null;
+  attributes: string;
+  compositions: string;
+  unit_of_measure_quantity: Pick<UnitOfMeasure, 'notation' | 'integer_only'>;
+  promotions: IDocumentLine.IPromotions[];
+}
+
+export interface IFindStockForMobileResponse {
+  virtual: Pick<
+    IProductVirtuals,
+    'price_sale' | 'available' | 'ordered_quantity' | 'prison' | 'reserved' | 'total' | 'inativa'
+  >;
+}
+
+export type IFindForMobileRequest =
+  | {
+      reference: string;
+      id?: never;
+    }
+  | {
+      reference?: never;
+      id: string;
+    };
+
+export interface IProductLocation {
+  location_number: number;
+  product_id: string[];
+}
+
+export interface IRepository {
+  basicSearch(
+    params: IBasicSearchRequest,
+  ): Promise<IShared.IPaginationResponse<IBasicSearchResponse>>;
+
+  findReferenceAndIdForMobile(
+    params: IFindForMobileRequest,
+  ): Promise<IFindReferenceAndIdForMobileResponse | null>;
+
+  findDataForMobile(params: IShared.IFindByIdRequest): Promise<IFindDataForMobileResponse | null>;
+
+  findStockForMobile(params: IShared.IFindByIdRequest): Promise<IFindStockForMobileResponse | null>;
+
+  validateByRef(selector: IValidateByReferenceRequest): Promise<IEntityMinified | null>;
+
+  findSimilarProductsByName(
+    params: IFindSimilarProductsByNameRequest,
+  ): Promise<IFindSimilarProductsByNameResponse[]>;
+
+  findByProductType(params: IFindByProductTypeRequest): Promise<IFindByProductTypeResponse[]>;
+
+  findById(selector: IShared.IFindByIdRequest): Promise<IProductSheetEntity>;
+
+  findPreArtigo(selector: IFindProductSheetByReference): Promise<IProductSheetCabideEntity | null>;
+
+  updatePricesFromPreArtigo(): Promise<void>;
+
+  findByIdWithStock(selector: IShared.IFindByIdRequest): Promise<ProductVirtuals>;
+
+  googleSheetsFieldsByRef(selector: IFindByReferenceRequest): Promise<string>;
+
+  findRowPositionOnSheetsWithColumns(params: IFindProductSheetByReference): Promise<string | null>;
+
+  checkStockByIds(data: ICheckStockByIdsRequest): Promise<ICheckStockByIdsResponse[]>;
+
+  create(data: ICreateRequest): Promise<string>;
+
+  update(params: IShared.IFindByIdRequest, data: IUpdateRequest): Promise<void>;
+
+  updateGoogleSheetsLinesProduct(data: IShared.IFindByIdRequest[]): Promise<void>;
+
+  deleteOne(params: IShared.IFindByIdRequest): Promise<void>;
+
+  updateDbFromSheets(): Promise<void>;
+
+  partialLocation(data: IProductLocation): Promise<void>;
+
+  fullLocation(data: IProductLocation): Promise<void>;
+}
+
+export type IController = IShared.IEntityWithUserToken<IRepository>;

package/src/modules/stock/productGoogleSheets/route.schema.ts

@@ -0,0 +1,146 @@
+import joi from 'joi';
+import { messages } from '../../../shared/messages';
+import * as IShared from '../../../shared/interface';
+import {
+  IBasicSearchRequest,
+  IFindByProductTypeRequest,
+  IFindByReferenceRequest,
+  IValidateByReferenceRequest,
+  productTypes,
+  productState,
+  IFindForMobileRequest,
+  type IUpdateRequest,
+  ICheckStockByIdsRequest,
+  ICreateRequest,
+  IPrintLabelQueryRequest,
+  IFindProductSheetByReference,
+  IProductLocation,
+} from './interface';
+
+const printLabelQueryKeys: IShared.IRouteRequest<IPrintLabelQueryRequest> = {
+  token: joi.string().required(),
+};
+
+export const printLabelQuery = joi.object().keys(printLabelQueryKeys).messages(messages);
+
+export const checkStockByIdsBody = joi
+  .object<ICheckStockByIdsRequest>()
+  .keys({ ids: joi.array().items(joi.string().uuid().required()).required() })
+  .messages(messages);
+
+const basicSearchQueryKeys: IShared.IRouteRequest<IBasicSearchRequest> = {
+  per_page: joi.number().integer().positive().default(10).optional(),
+  current_page: joi.number().integer().positive().default(1).optional(),
+  active: joi.boolean().default(false).optional(),
+  inactive: joi.boolean().default(false).optional(),
+  search_value: joi.string().allow('', null).optional(),
+  dnt_come_anymore: joi.boolean().default(false).optional(),
+  types: joi.string().optional(),
+};
+export const basicSearchQuery = joi.object().keys(basicSearchQueryKeys).messages(messages);
+
+const findByRefKeys: IShared.IRouteRequest<IFindByReferenceRequest> = {
+  reference: joi.string().required(),
+  id_provider: joi.number().integer().positive().optional(),
+  available: joi.boolean().optional(),
+  allowProviderWildcard: joi.boolean().optional(),
+  type: joi
+    .string()
+    .valid(...productTypes)
+    .optional(),
+};
+export const findByRef = joi.object().keys(findByRefKeys).messages(messages);
+
+const validateByRefKeys: IShared.IRouteRequest<IValidateByReferenceRequest> = {
+  ...findByRefKeys,
+  billing_country_id: joi.string().uuid().optional(),
+};
+export const validateByRef = joi.object().keys(validateByRefKeys).messages(messages);
+
+const findByProductTypeKeys: IShared.IRouteRequest<IFindByProductTypeRequest> = {
+  id_provider: joi.number().positive().required(),
+  type: joi
+    .string()
+    .valid(...productTypes)
+    .required(),
+};
+export const findByProductTypeParams = joi.object().keys(findByProductTypeKeys).messages(messages);
+
+// create body validation
+const createBodyKeys: IShared.IRouteRequest<ICreateRequest> = {
+  id: joi.string().uuid().optional(),
+  origin_id: joi.string().empty('').optional(),
+  id_provider: joi.number().integer().positive().allow(0).optional(),
+  provider_ref: joi.string().empty('').optional(),
+  name: joi.string().empty('').optional(),
+  designation: joi.string().empty('').optional(),
+  type: joi
+    .string()
+    .valid(...productTypes)
+    .optional(),
+  external_id: joi.string().empty('').optional(),
+  vat_tax_id: joi.string().uuid().empty('').optional(),
+  weight: joi.number().positive().allow(0).allow(null, '').optional(),
+  width: joi.number().positive().allow(0).allow(null, '').optional(),
+  height: joi.number().positive().allow(0).allow(null, '').optional(),
+  length: joi.number().positive().allow(0).allow(null, '').optional(),
+  diameter: joi.number().positive().allow(0).allow(null, '').optional(),
+  price_cost: joi.number().positive().allow(0).optional(),
+  price_sale: joi.number().positive().allow(0).optional(),
+  unit_of_measure_quantity_id: joi.string().uuid().empty('').optional(),
+  cabide_product_color: joi.string().allow(null, '').optional(),
+  imported_from_sheets: joi.boolean().optional(),
+  reference: joi.string().optional(),
+  state: joi
+    .string()
+    .valid(...productState)
+    .optional(),
+  type_of_inventory: joi.string().optional(),
+  max_discount: joi.number().positive().allow(0).min(0).max(100).optional(),
+  values: joi.object().optional(),
+  maintenances: joi.string().optional(),
+  compositions: joi.string().optional(),
+  attributes: joi.string().optional(),
+};
+export const createBody = joi.object().keys(createBodyKeys).messages(messages);
+
+const updateBodyKeys: IShared.IRouteRequest<IUpdateRequest> = {
+  designation: joi.string().empty('').optional(),
+  provider_ref: joi.string().empty('').optional(),
+  type: joi
+    .string()
+    .valid(...productTypes)
+    .optional(),
+  price_cost: joi.number().positive().allow(0).optional(),
+  price_sale: joi.number().positive().allow(0).optional(),
+  unit_of_measure_quantity_notation: joi.string().empty('').optional(),
+  state: joi
+    .string()
+    .valid(...productState)
+    .optional(),
+};
+export const updateBody = joi.object().keys(updateBodyKeys).messages(messages);
+
+export const findForMobileQuery = joi
+  .object<IFindForMobileRequest>()
+  .keys({
+    id: joi.string().uuid().optional(),
+    reference: joi.string().optional(),
+  })
+  .xor('id', 'reference')
+  .messages(messages);
+
+export const findProductSheetByReferenceQuery = joi
+  .object<IFindProductSheetByReference>()
+  .keys({
+    selector: joi.string().required(),
+  })
+  .messages(messages);
+
+export const productLocationBody = joi
+  .object<IProductLocation>()
+  .keys({
+    location_number: joi.number().required(),
+    product_id: joi.array().items(joi.string().uuid()).required(),
+  })
+  .messages(messages);

package/src/modules/stock/productImage/interface.ts

@@ -0,0 +1,69 @@
+import * as IShared from '../../../shared/interface';
+import { ProductImage } from '../../../shared/entities';
+
+export type Entity = ProductImage;
+export const Route = 'product_image';
+export const UpperName = 'ProductImage';
+export const LowerName = UpperName[0].toLowerCase() + UpperName.substring(1);
+
+type IFindDetailedResponse = Entity;
+
+// omit any unnecessary fields
+export type IFindByIdResponse = Omit<IFindDetailedResponse, ''>;
+
+// omit any unnecessary fields
+export type IFindByOwnerIdResponse = Omit<IFindDetailedResponse, ''>;
+
+export type IFindRequest = Record<string, unknown>;
+
+// omit any unnecessary fields
+export type IFindResponse = Omit<IFindDetailedResponse, ''>;
+
+export const ImageTypeEnum: {
+  thumbnail: 'thumbnail';
+  site: 'site';
+} = {
+  thumbnail: 'thumbnail',
+  site: 'site',
+};
+
+export type IImageType = (typeof ImageTypeEnum)[keyof typeof ImageTypeEnum];
+
+export const imageTypes = Object.keys(ImageTypeEnum);
+
+export interface IFindPaginatedRequest extends IFindRequest, IShared.IPaginationRequest {}
+
+export type IFindWithPaginationResponse = IShared.IPaginationResponse<
+  Omit<IFindDetailedResponse, ''>
+>;
+
+export interface ICreateRequest {
+  // create fields
+  product_id: string;
+  product_sheet_id?: string;
+  multimedia_id: string;
+  type: IImageType;
+  created_by?: string | null;
+  updated_by?: string | null;
+}
+
+export interface IUpdateRequest {
+  // updatable fields
+  product_id?: string;
+  multimedia_id?: string;
+  type?: IImageType;
+}
+
+export interface IRepository {
+  findById(selector: IShared.IFindByIdRequest): Promise<IFindByIdResponse | null>;
+
+  findByOwnerId(params: IShared.IFindByOwnerIdRequest): Promise<IFindByOwnerIdResponse[]>;
+  find(selector: IFindRequest): Promise<IFindResponse[]>;
+  findPaginated(selector: IFindPaginatedRequest): Promise<IFindWithPaginationResponse>;
+
+  create(data: ICreateRequest): Promise<Entity>;
+  update(selector: IShared.IFindByIdRequest, data: IUpdateRequest): Promise<Entity | null>;
+  deleteOne(selector: IShared.IFindByIdRequest): Promise<Entity | null>;
+}
+
+export type IController = IShared.IEntityWithUserToken<IRepository>;

package/src/modules/stock/productImage/route.schema.ts

@@ -0,0 +1,52 @@
+import joi from 'joi';
+import { messages } from '../../../shared/messages';
+import * as IShared from '../../../shared/interface';
+import {
+  IFindRequest,
+  IFindPaginatedRequest,
+  ICreateRequest,
+  IUpdateRequest,
+  imageTypes,
+} from './interface';
+
+// create body validation
+const createBodyKeys: IShared.IRouteRequestWithStamps<ICreateRequest> = {
+  type: joi
+    .string()
+    .valid(...imageTypes)
+    .required(),
+  product_id: joi.string().uuid().required(),
+  product_sheet_id: joi.string().uuid().optional(),
+  multimedia_id: joi.string().uuid().required(),
+  created_by: joi.string().uuid().optional(),
+  updated_by: joi.string().uuid().optional(),
+};
+export const createBody = joi
+  .object()
+  .keys(createBodyKeys)
+  .xor('product_id', 'product_sheet_id')
+  .messages(messages);
+
+// update body validation
+const updateBodyKeys: IShared.IRouteRequest<IUpdateRequest> = {
+  type: joi
+    .string()
+    .valid(...imageTypes)
+    .optional(),
+  product_id: joi.string().uuid().optional(),
+  multimedia_id: joi.string().uuid().optional(),
+};
+export const updateBody = joi.object().keys(updateBodyKeys).messages(messages);
+
+const findQueryKeys: IShared.IRouteRequest<IFindRequest> = {};
+export const findQuery = joi.object().keys(findQueryKeys).messages(messages);
+
+// find with pagination query validation
+const findWithPaginationQueryKeys: IShared.IRouteRequest<IFindPaginatedRequest> = {
+  per_page: joi.number().integer().positive().default(10).optional(),
+  current_page: joi.number().integer().positive().default(1).optional(),
+};
+export const findWithPaginationQuery = joi
+  .object()
+  .keys(findWithPaginationQueryKeys)
+  .messages(messages);

package/src/modules/stock/promotion/interface.ts

@@ -0,0 +1,61 @@
+import * as IShared from '../../../shared/interface';
+import { Promotion } from '../../../shared/entities';
+
+export type Entity = Promotion;
+export const Route = 'promotion';
+export const UpperName = 'Promotion';
+export const LowerName = UpperName[0].toLowerCase() + UpperName.substring(1);
+
+type IFindDetailedResponse = Entity;
+
+// omit any unnecessary fields
+export type IFindByIdResponse = Omit<IFindDetailedResponse, ''>;
+
+// omit any unnecessary fields
+export type IFindByOwnerIdResponse = Omit<IFindDetailedResponse, ''>;
+
+export type IFindRequest = Record<string, unknown>;
+
+// omit any unnecessary fields
+export type IFindResponse = Omit<IFindDetailedResponse, ''>;
+
+export interface IFindPaginatedRequest extends IFindRequest, IShared.IPaginationRequest {}
+
+export type IFindWithPaginationResponse = IShared.IPaginationResponse<
+  Omit<IFindDetailedResponse, ''>
+>;
+
+export interface ICreateRequest {
+  // create fields
+  name: string;
+  initial_date: Date;
+  final_date: Date;
+  active_for_purchases_above?: number;
+  free_shipping_for_purchases_above?: number | null;
+  discount: number;
+}
+
+export interface IUpdateRequest {
+  // updatable fields
+  name?: string;
+  initial_date?: Date;
+  final_date?: Date;
+  active_for_purchases_above?: number;
+  free_shipping_for_purchases_above?: number | null;
+  discount?: number;
+}
+
+export interface IRepository {
+  findById(selector: IShared.IFindByIdRequest): Promise<IFindByIdResponse | null>;
+
+  findByOwnerId(params: IShared.IFindByOwnerIdRequest): Promise<IFindByOwnerIdResponse[]>;
+  findMinified(params?: IShared.IFindMinifiedRequest): Promise<IShared.IFindMinifiedResponse[]>;
+  find(selector: IFindRequest): Promise<IFindResponse[]>;
+  findPaginated(selector: IFindPaginatedRequest): Promise<IFindWithPaginationResponse>;
+
+  create(data: ICreateRequest): Promise<Entity>;
+  update(selector: IShared.IFindByIdRequest, data: IUpdateRequest): Promise<Entity | null>;
+  deleteOne(selector: IShared.IFindByIdRequest): Promise<Entity | null>;
+}
+
+export type IController = IShared.IEntityWithUserToken<IRepository>;

package/src/modules/stock/promotion/route.schema.ts

@@ -0,0 +1,39 @@
+import joi from 'joi';
+import { messages } from '../../../shared/messages';
+import * as IShared from '../../../shared/interface';
+import { IFindRequest, IFindPaginatedRequest, ICreateRequest, IUpdateRequest } from './interface';
+
+// create body validation
+const createBodyKeys: IShared.IRouteRequest<ICreateRequest> = {
+  name: joi.string().required(),
+  initial_date: joi.date().required(),
+  final_date: joi.date().required(),
+  active_for_purchases_above: joi.number().integer().positive().allow(0).optional(),
+  free_shipping_for_purchases_above: joi.number().integer().positive().allow(0, null).optional(),
+  discount: joi.number().positive().max(100).required(),
+};
+export const createBody = joi.object().keys(createBodyKeys).messages(messages);
+
+// update body validation
+const updateBodyKeys: IShared.IRouteRequest<IUpdateRequest> = {
+  name: joi.string().optional(),
+  initial_date: joi.date().optional(),
+  final_date: joi.date().optional(),
+  active_for_purchases_above: joi.number().integer().positive().allow(0).optional(),
+  free_shipping_for_purchases_above: joi.number().integer().positive().allow(0, null).optional(),
+  discount: joi.number().positive().max(100).optional(),
+};
+export const updateBody = joi.object().keys(updateBodyKeys).messages(messages);
+
+const findQueryKeys: IShared.IRouteRequest<IFindRequest> = {};
+export const findQuery = joi.object().keys(findQueryKeys).messages(messages);
+
+// find with pagination query validation
+const findWithPaginationQueryKeys: IShared.IRouteRequest<IFindPaginatedRequest> = {
+  per_page: joi.number().integer().positive().default(10).optional(),
+  current_page: joi.number().integer().positive().default(1).optional(),
+};
+export const findWithPaginationQuery = joi
+  .object()
+  .keys(findWithPaginationQueryKeys)
+  .messages(messages);