@classytic/payroll 1.0.2 → 2.0.0

package/src/utils/query-builders.js

@@ -1,185 +0,0 @@
-/**
- * Query Builders - Fluent API, Type-Safe, Beautiful
- * Inspired by Angular's RxJS and Playwright's chaining
- */
-
-import mongoose from 'mongoose';
-
-export const toObjectId = (id) =>
-  id instanceof mongoose.Types.ObjectId ? id : new mongoose.Types.ObjectId(id);
-
-export class QueryBuilder {
-  constructor(initialQuery = {}) {
-    this.query = { ...initialQuery };
-  }
-
-  where(field, value) {
-    this.query[field] = value;
-    return this;
-  }
-
-  whereIn(field, values) {
-    this.query[field] = { $in: values };
-    return this;
-  }
-
-  whereNotIn(field, values) {
-    this.query[field] = { $nin: values };
-    return this;
-  }
-
-  whereGte(field, value) {
-    this.query[field] = { ...this.query[field], $gte: value };
-    return this;
-  }
-
-  whereLte(field, value) {
-    this.query[field] = { ...this.query[field], $lte: value };
-    return this;
-  }
-
-  whereBetween(field, start, end) {
-    this.query[field] = { $gte: start, $lte: end };
-    return this;
-  }
-
-  whereExists(field) {
-    this.query[field] = { $exists: true };
-    return this;
-  }
-
-  whereNotExists(field) {
-    this.query[field] = { $exists: false };
-    return this;
-  }
-
-  build() {
-    return this.query;
-  }
-}
-
-export const createQueryBuilder = (initialQuery) => new QueryBuilder(initialQuery);
-
-export class EmployeeQueryBuilder extends QueryBuilder {
-  forOrganization(organizationId) {
-    return this.where('organizationId', toObjectId(organizationId));
-  }
-
-  forUser(userId) {
-    return this.where('userId', toObjectId(userId));
-  }
-
-  withStatus(...statuses) {
-    return statuses.length === 1
-      ? this.where('status', statuses[0])
-      : this.whereIn('status', statuses);
-  }
-
-  active() {
-    return this.withStatus('active');
-  }
-
-  employed() {
-    return this.whereIn('status', ['active', 'on_leave', 'suspended']);
-  }
-
-  inDepartment(department) {
-    return this.where('department', department);
-  }
-
-  inPosition(position) {
-    return this.where('position', position);
-  }
-
-  withEmploymentType(type) {
-    return this.where('employmentType', type);
-  }
-
-  hiredAfter(date) {
-    return this.whereGte('hireDate', date);
-  }
-
-  hiredBefore(date) {
-    return this.whereLte('hireDate', date);
-  }
-}
-
-export class PayrollQueryBuilder extends QueryBuilder {
-  forOrganization(organizationId) {
-    return this.where('organizationId', toObjectId(organizationId));
-  }
-
-  forEmployee(employeeId) {
-    return this.where('employeeId', toObjectId(employeeId));
-  }
-
-  forPeriod(month, year) {
-    if (month) this.where('period.month', month);
-    if (year) this.where('period.year', year);
-    return this;
-  }
-
-  withStatus(...statuses) {
-    return statuses.length === 1
-      ? this.where('status', statuses[0])
-      : this.whereIn('status', statuses);
-  }
-
-  paid() {
-    return this.withStatus('paid');
-  }
-
-  pending() {
-    return this.withStatus('pending', 'processing');
-  }
-
-  inDateRange(start, end) {
-    return this.whereBetween('paymentDate', start, end);
-  }
-}
-
-export const employee = () => new EmployeeQueryBuilder();
-export const payroll = () => new PayrollQueryBuilder();
-
-export const buildEmployeeQuery = ({ organizationId, userId, statuses }) => {
-  const builder = employee().forOrganization(organizationId);
-
-  if (userId) builder.forUser(userId);
-  if (statuses) builder.withStatus(...statuses);
-
-  return builder.build();
-};
-
-export const buildPayrollQuery = ({ employeeId, period, statuses }) => {
-  const builder = payroll().forEmployee(employeeId);
-
-  if (period) builder.forPeriod(period.month, period.year);
-  if (statuses) builder.withStatus(...statuses);
-
-  return builder.build();
-};
-
-export const buildAggregationPipeline = (...stages) => stages.filter(Boolean);
-
-export const matchStage = (query) => ({ $match: query });
-
-export const groupStage = (groupBy, aggregations) => ({
-  $group: {
-    _id: groupBy,
-    ...aggregations,
-  },
-});
-
-export const sortStage = (sortBy) => ({ $sort: sortBy });
-
-export const limitStage = (limit) => ({ $limit: limit });
-
-export const projectStage = (fields) => ({ $project: fields });
-
-export const lookupStage = ({ from, localField, foreignField, as }) => ({
-  $lookup: { from, localField, foreignField, as },
-});
-
-export const unwindStage = (path, options = {}) => ({
-  $unwind: { path, ...options },
-});

package/src/utils/validation.utils.js

@@ -1,122 +0,0 @@
-/**
- * Validation Utilities - Fluent, Composable, Type-Safe
- * Beautiful validation with clear semantics
- */
-
-export const isActive = (employee) =>
-  employee?.status === 'active';
-
-export const isOnLeave = (employee) =>
-  employee?.status === 'on_leave';
-
-export const isSuspended = (employee) =>
-  employee?.status === 'suspended';
-
-export const isTerminated = (employee) =>
-  employee?.status === 'terminated';
-
-export const isEmployed = (employee) =>
-  isActive(employee) || isOnLeave(employee) || isSuspended(employee);
-
-export const canReceiveSalary = (employee) =>
-  isActive(employee) || isOnLeave(employee);
-
-export const canUpdateEmployment = (employee) =>
-  !isTerminated(employee);
-
-export const isInProbation = (employee, now = new Date()) =>
-  employee?.probationEndDate && new Date(employee.probationEndDate) > now;
-
-export const hasCompletedProbation = (employee, now = new Date()) =>
-  employee?.probationEndDate && new Date(employee.probationEndDate) <= now;
-
-export const hasCompensation = (employee) =>
-  employee?.compensation?.baseAmount > 0;
-
-export const isEligibleForBonus = (employee, requiredMonths = 6) => {
-  if (!isActive(employee)) return false;
-  const monthsEmployed = monthsBetween(employee.hireDate, new Date());
-  return monthsEmployed >= requiredMonths;
-};
-
-export const isValidCompensation = (compensation) =>
-  compensation?.baseAmount > 0 &&
-  compensation?.frequency &&
-  compensation?.currency;
-
-export const isValidBankDetails = (bankDetails) =>
-  bankDetails?.accountNumber &&
-  bankDetails?.bankName &&
-  bankDetails?.accountHolderName;
-
-export const hasRequiredFields = (obj, fields) =>
-  fields.every((field) => obj?.[field] !== undefined && obj?.[field] !== null);
-
-export const createValidator = (validationFns) => (data) => {
-  const errors = [];
-
-  for (const [field, validator] of Object.entries(validationFns)) {
-    const result = validator(data[field], data);
-    if (result !== true) {
-      errors.push({ field, message: result });
-    }
-  }
-
-  return {
-    isValid: errors.length === 0,
-    errors,
-  };
-};
-
-export const required = (fieldName) => (value) =>
-  value !== undefined && value !== null && value !== ''
-    ? true
-    : `${fieldName} is required`;
-
-export const min = (minValue, fieldName) => (value) =>
-  value >= minValue ? true : `${fieldName} must be at least ${minValue}`;
-
-export const max = (maxValue, fieldName) => (value) =>
-  value <= maxValue ? true : `${fieldName} must not exceed ${maxValue}`;
-
-export const inRange = (minValue, maxValue, fieldName) => (value) =>
-  value >= minValue && value <= maxValue
-    ? true
-    : `${fieldName} must be between ${minValue} and ${maxValue}`;
-
-export const oneOf = (allowedValues, fieldName) => (value) =>
-  allowedValues.includes(value)
-    ? true
-    : `${fieldName} must be one of: ${allowedValues.join(', ')}`;
-
-export const compose = (...validators) => (value, data) => {
-  for (const validator of validators) {
-    const result = validator(value, data);
-    if (result !== true) return result;
-  }
-  return true;
-};
-
-// Additional validators
-export const isPositive = (fieldName) => (value) =>
-  value > 0 ? true : `${fieldName} must be positive`;
-
-export const isValidStatus = (value) =>
-  ['active', 'on_leave', 'suspended', 'terminated'].includes(value);
-
-export const isValidEmploymentType = (value) =>
-  ['full_time', 'part_time', 'contract', 'internship'].includes(value);
-
-// Aliases for consistency
-export const minValue = min;
-export const maxValue = max;
-export const isInRange = inRange;
-
-const monthsBetween = (start, end) => {
-  const startDate = new Date(start);
-  const endDate = new Date(end);
-  return (
-    (endDate.getFullYear() - startDate.getFullYear()) * 12 +
-    (endDate.getMonth() - startDate.getMonth())
-  );
-};