@empleado-juan/commons 1.0.0

package/dist/constants/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared Constants
+ * Used across frontend and backend services
+ */
+export declare const TIME_CONSTANTS: {
+    readonly SECOND: 1000;
+    readonly MINUTE: number;
+    readonly HOUR: number;
+    readonly DAY: number;
+    readonly WEEK: number;
+};
+export declare const LICENSE_CONSTANTS: {
+    readonly CACHE_TTL: number;
+    readonly GRACE_PERIOD: number;
+    readonly MAX_GRACE_PERIOD: number;
+    readonly VALIDATION_TIMEOUT: number;
+    readonly HEARTBEAT_INTERVAL: number;
+};
+export declare const API_RESPONSE: {
+    readonly SUCCESS: "success";
+    readonly ERROR: "error";
+    readonly WARNING: "warning";
+};
+export declare const PAGINATION: {
+    readonly DEFAULT_PAGE: 1;
+    readonly DEFAULT_LIMIT: 20;
+    readonly MAX_LIMIT: 100;
+};
+export declare const GIT_CO_AUTHOR: "Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>";
+//# sourceMappingURL=index.d.ts.map

package/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAGX,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAGX,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAGX,eAAO,MAAM,aAAa,EAAG,2DAAoE,CAAC"}

package/dist/constants/index.js

@@ -0,0 +1,34 @@
+/**
+ * Shared Constants
+ * Used across frontend and backend services
+ */
+// Time constants
+export const TIME_CONSTANTS = {
+    SECOND: 1000,
+    MINUTE: 60 * 1000,
+    HOUR: 60 * 60 * 1000,
+    DAY: 24 * 60 * 60 * 1000,
+    WEEK: 7 * 24 * 60 * 60 * 1000,
+};
+// License constants
+export const LICENSE_CONSTANTS = {
+    CACHE_TTL: 5 * 60 * 1000, // 5 minutes
+    GRACE_PERIOD: 24 * 60 * 60 * 1000, // 24 hours
+    MAX_GRACE_PERIOD: 48 * 60 * 60 * 1000, // 48 hours
+    VALIDATION_TIMEOUT: 10 * 1000, // 10 seconds
+    HEARTBEAT_INTERVAL: 5 * 60 * 1000, // 5 minutes
+};
+// API Response constants
+export const API_RESPONSE = {
+    SUCCESS: 'success',
+    ERROR: 'error',
+    WARNING: 'warning',
+};
+// Pagination defaults
+export const PAGINATION = {
+    DEFAULT_PAGE: 1,
+    DEFAULT_LIMIT: 20,
+    MAX_LIMIT: 100,
+};
+// Co-Author for git commits
+export const GIT_CO_AUTHOR = 'Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>';

package/dist/enums/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Shared Enums
+ * Used across frontend and backend services
+ */
+export declare enum AttendanceEventType {
+    CHECK_IN = "CHECK_IN",
+    CHECK_OUT = "CHECK_OUT",
+    BREAK_START = "BREAK_START",
+    BREAK_END = "BREAK_END"
+}
+export declare enum VerifyMode {
+    PASSWORD = "PASSWORD",
+    FINGERPRINT = "FINGERPRINT",
+    CARD = "CARD",
+    FACE = "FACE"
+}
+export declare enum EmployeeStatus {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    SUSPENDED = "SUSPENDED"
+}
+export declare enum PaymentType {
+    MONTHLY = "MONTHLY",
+    BIWEEKLY = "BIWEEKLY",
+    WEEKLY = "WEEKLY",
+    HOURLY = "HOURLY"
+}
+export declare enum ContractType {
+    INDEFINIDO = "INDEFINIDO",
+    FIJO = "FIJO",
+    OBRA_LABOR = "OBRA_LABOR",
+    APRENDIZAJE = "APRENDIZAJE"
+}
+export declare enum PayrollFrequency {
+    WEEKLY = "WEEKLY",
+    BIWEEKLY = "BIWEEKLY",
+    MONTHLY = "MONTHLY"
+}
+export declare enum UserRole {
+    SUPER_ADMIN = "SUPER_ADMIN",
+    ADMIN = "ADMIN",
+    MANAGER = "MANAGER",
+    EMPLOYEE = "EMPLOYEE"
+}
+export declare enum InstallationStatus {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    SUSPENDED = "SUSPENDED"
+}
+export declare enum LicenseValidationReason {
+    VALID = "VALID",
+    EXPIRED = "EXPIRED",
+    NO_LICENSE = "NO_LICENSE",
+    INSTALLATION_NOT_FOUND = "INSTALLATION_NOT_FOUND",
+    INSTALLATION_SUSPENDED = "INSTALLATION_SUSPENDED",
+    MAX_CLIENTS_EXCEEDED = "MAX_CLIENTS_EXCEEDED",
+    GRACE_PERIOD_EXPIRED = "GRACE_PERIOD_EXPIRED",
+    DEACTIVATED_REMOTELY = "DEACTIVATED_REMOTELY"
+}
+export declare enum ShiftType {
+    FIXED = "FIXED",
+    ROTATING = "ROTATING",
+    FLEXIBLE = "FLEXIBLE"
+}
+export declare enum DayType {
+    WORK = "WORK",
+    REST = "REST",
+    HOLIDAY = "HOLIDAY"
+}
+export declare enum MessageBrokerType {
+    RABBITMQ = "rabbitmq",
+    KAFKA = "kafka",
+    SQS = "sqs"
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/enums/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/enums/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;CACxB;AAGD,oBAAY,UAAU;IACpB,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAGD,oBAAY,cAAc;IACxB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAGD,oBAAY,WAAW;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAGD,oBAAY,YAAY;IACtB,UAAU,eAAe;IACzB,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B;AAGD,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAGD,oBAAY,QAAQ;IAClB,WAAW,gBAAgB;IAC3B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAGD,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAGD,oBAAY,uBAAuB;IACjC,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,sBAAsB,2BAA2B;IACjD,sBAAsB,2BAA2B;IACjD,oBAAoB,yBAAyB;IAC7C,oBAAoB,yBAAyB;IAC7C,oBAAoB,yBAAyB;CAC9C;AAGD,oBAAY,SAAS;IACnB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAGD,oBAAY,OAAO;IACjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,OAAO,YAAY;CACpB;AAGD,oBAAY,iBAAiB;IAC3B,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,GAAG,QAAQ;CACZ"}

package/dist/enums/index.js

@@ -0,0 +1,98 @@
+/**
+ * Shared Enums
+ * Used across frontend and backend services
+ */
+// Attendance Event Types
+export var AttendanceEventType;
+(function (AttendanceEventType) {
+    AttendanceEventType["CHECK_IN"] = "CHECK_IN";
+    AttendanceEventType["CHECK_OUT"] = "CHECK_OUT";
+    AttendanceEventType["BREAK_START"] = "BREAK_START";
+    AttendanceEventType["BREAK_END"] = "BREAK_END";
+})(AttendanceEventType || (AttendanceEventType = {}));
+// Verification Modes (Biometric devices)
+export var VerifyMode;
+(function (VerifyMode) {
+    VerifyMode["PASSWORD"] = "PASSWORD";
+    VerifyMode["FINGERPRINT"] = "FINGERPRINT";
+    VerifyMode["CARD"] = "CARD";
+    VerifyMode["FACE"] = "FACE";
+})(VerifyMode || (VerifyMode = {}));
+// Employee Status
+export var EmployeeStatus;
+(function (EmployeeStatus) {
+    EmployeeStatus["ACTIVE"] = "ACTIVE";
+    EmployeeStatus["INACTIVE"] = "INACTIVE";
+    EmployeeStatus["SUSPENDED"] = "SUSPENDED";
+})(EmployeeStatus || (EmployeeStatus = {}));
+// Payment Types
+export var PaymentType;
+(function (PaymentType) {
+    PaymentType["MONTHLY"] = "MONTHLY";
+    PaymentType["BIWEEKLY"] = "BIWEEKLY";
+    PaymentType["WEEKLY"] = "WEEKLY";
+    PaymentType["HOURLY"] = "HOURLY";
+})(PaymentType || (PaymentType = {}));
+// Contract Types
+export var ContractType;
+(function (ContractType) {
+    ContractType["INDEFINIDO"] = "INDEFINIDO";
+    ContractType["FIJO"] = "FIJO";
+    ContractType["OBRA_LABOR"] = "OBRA_LABOR";
+    ContractType["APRENDIZAJE"] = "APRENDIZAJE";
+})(ContractType || (ContractType = {}));
+// Payroll Frequency
+export var PayrollFrequency;
+(function (PayrollFrequency) {
+    PayrollFrequency["WEEKLY"] = "WEEKLY";
+    PayrollFrequency["BIWEEKLY"] = "BIWEEKLY";
+    PayrollFrequency["MONTHLY"] = "MONTHLY";
+})(PayrollFrequency || (PayrollFrequency = {}));
+// User Roles
+export var UserRole;
+(function (UserRole) {
+    UserRole["SUPER_ADMIN"] = "SUPER_ADMIN";
+    UserRole["ADMIN"] = "ADMIN";
+    UserRole["MANAGER"] = "MANAGER";
+    UserRole["EMPLOYEE"] = "EMPLOYEE";
+})(UserRole || (UserRole = {}));
+// Installation Status
+export var InstallationStatus;
+(function (InstallationStatus) {
+    InstallationStatus["ACTIVE"] = "ACTIVE";
+    InstallationStatus["INACTIVE"] = "INACTIVE";
+    InstallationStatus["SUSPENDED"] = "SUSPENDED";
+})(InstallationStatus || (InstallationStatus = {}));
+// License Validation Reasons
+export var LicenseValidationReason;
+(function (LicenseValidationReason) {
+    LicenseValidationReason["VALID"] = "VALID";
+    LicenseValidationReason["EXPIRED"] = "EXPIRED";
+    LicenseValidationReason["NO_LICENSE"] = "NO_LICENSE";
+    LicenseValidationReason["INSTALLATION_NOT_FOUND"] = "INSTALLATION_NOT_FOUND";
+    LicenseValidationReason["INSTALLATION_SUSPENDED"] = "INSTALLATION_SUSPENDED";
+    LicenseValidationReason["MAX_CLIENTS_EXCEEDED"] = "MAX_CLIENTS_EXCEEDED";
+    LicenseValidationReason["GRACE_PERIOD_EXPIRED"] = "GRACE_PERIOD_EXPIRED";
+    LicenseValidationReason["DEACTIVATED_REMOTELY"] = "DEACTIVATED_REMOTELY";
+})(LicenseValidationReason || (LicenseValidationReason = {}));
+// Shift Types
+export var ShiftType;
+(function (ShiftType) {
+    ShiftType["FIXED"] = "FIXED";
+    ShiftType["ROTATING"] = "ROTATING";
+    ShiftType["FLEXIBLE"] = "FLEXIBLE";
+})(ShiftType || (ShiftType = {}));
+// Day Types
+export var DayType;
+(function (DayType) {
+    DayType["WORK"] = "WORK";
+    DayType["REST"] = "REST";
+    DayType["HOLIDAY"] = "HOLIDAY";
+})(DayType || (DayType = {}));
+// Message Broker Types
+export var MessageBrokerType;
+(function (MessageBrokerType) {
+    MessageBrokerType["RABBITMQ"] = "rabbitmq";
+    MessageBrokerType["KAFKA"] = "kafka";
+    MessageBrokerType["SQS"] = "sqs";
+})(MessageBrokerType || (MessageBrokerType = {}));

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @empleado-juan/commons
+ *
+ * Shared code between frontend and backend services
+ * Including types, enums, constants, and validators
+ */
+export * from './enums/index.js';
+export * from './types/index.js';
+export * from './constants/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @empleado-juan/commons
+ *
+ * Shared code between frontend and backend services
+ * Including types, enums, constants, and validators
+ */
+// Export all enums
+export * from './enums/index.js';
+// Export all types
+export * from './types/index.js';
+// Export all constants
+export * from './constants/index.js';

package/dist/types/attendance.d.ts

@@ -0,0 +1,39 @@
+import { AttendanceEventType, VerifyMode } from '../enums/index.js';
+/**
+ * Attendance Record Types
+ */
+export interface AttendanceRecord {
+    id: string;
+    employeeId: string;
+    branchId: string;
+    deviceId?: string;
+    timestamp: Date;
+    eventType: AttendanceEventType;
+    verifyMode?: VerifyMode;
+    isManual: boolean;
+    notes?: string;
+    hikvisionEventId?: string;
+    rawData?: any;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateAttendanceInput {
+    employeeId: string;
+    branchId: string;
+    deviceId?: string;
+    timestamp: Date;
+    eventType: AttendanceEventType;
+    verifyMode?: VerifyMode;
+    isManual?: boolean;
+    notes?: string;
+}
+export interface AttendanceEvent {
+    id: string;
+    employeeId: string;
+    timestamp: Date;
+    eventType: AttendanceEventType;
+    branchId: string;
+    deviceId?: string;
+    verifyMode?: VerifyMode;
+}
+//# sourceMappingURL=attendance.d.ts.map

package/dist/types/attendance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attendance.d.ts","sourceRoot":"","sources":["../../src/types/attendance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB"}

package/dist/types/attendance.js

@@ -0,0 +1 @@
+export {};

package/dist/types/employee.d.ts

@@ -0,0 +1,83 @@
+import { PaymentType } from '../enums/index.js';
+/**
+ * Employee Types
+ */
+export interface Employee {
+    id: string;
+    branchId: string;
+    employeeNumber: string;
+    firstName: string;
+    lastName: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    positionId?: string;
+    departmentId?: string;
+    supervisorId?: string;
+    hireDate: Date;
+    terminationDate?: Date;
+    baseSalary?: number;
+    hourlyRate?: number;
+    paymentType: PaymentType;
+    bankAccount?: string;
+    hikvisionUserId?: string;
+    cardNumber?: string;
+    photo?: string;
+    isActive: boolean;
+    requiresAttendance: boolean;
+    isSuspended: boolean;
+    suspendedAt?: Date;
+    suspendedUntil?: Date;
+    suspensionReason?: string;
+    deactivatedAt?: Date;
+    deactivationReason?: string;
+    userId?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CreateEmployeeInput {
+    branchId: string;
+    employeeNumber: string;
+    firstName: string;
+    lastName: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    positionId?: string;
+    departmentId?: string;
+    supervisorId?: string;
+    hireDate: Date;
+    baseSalary?: number;
+    hourlyRate?: number;
+    paymentType?: PaymentType;
+    bankAccount?: string;
+    hikvisionUserId?: string;
+    cardNumber?: string;
+    photo?: string;
+    scheduleId?: string;
+    scheduleStartDate?: Date;
+    createUserAccount?: boolean;
+    userPassword?: string;
+}
+export interface UpdateEmployeeInput {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+    positionId?: string;
+    departmentId?: string;
+    supervisorId?: string;
+    baseSalary?: number;
+    hourlyRate?: number;
+    paymentType?: PaymentType;
+    bankAccount?: string;
+    scheduleId?: string;
+    scheduleStartDate?: Date;
+    photo?: string;
+    isActive?: boolean;
+    isSuspended?: boolean;
+    suspendedUntil?: Date;
+    suspensionReason?: string;
+}
+//# sourceMappingURL=employee.d.ts.map

package/dist/types/employee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"employee.d.ts","sourceRoot":"","sources":["../../src/types/employee.ts"],"names":[],"mappings":"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"}

package/dist/types/employee.js

@@ -0,0 +1 @@
+export {};

package/dist/types/events.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Event System Types
+ * Used for message broker events
+ */
+export interface EventMessage {
+    key?: string;
+    value: string | object;
+    headers?: Record<string, string>;
+}
+export interface AttendanceCreatedEvent {
+    id: string;
+    clientId: string;
+    employeeId: string;
+    timestamp: string;
+    eventType: string;
+    branchId: string;
+    deviceId?: string;
+    verifyMode?: string;
+    data: any;
+}
+export interface EmployeeCreatedEvent {
+    id: string;
+    clientId: string;
+    employeeNumber: string;
+    firstName: string;
+    lastName: string;
+    email?: string;
+    branchId: string;
+    isActive: boolean;
+    data: any;
+}
+export interface CompensationCreatedEvent {
+    id: string;
+    employeeId: string;
+    validFrom: string;
+    validTo?: string;
+    baseSalaryMonthlyCents: number;
+    hourlyRateCents: number;
+    contractType: string;
+    paymentFrequency: string;
+    scheduledHoursPerWeek: number;
+    legalTemplateVersionId: string;
+    changeReason?: string;
+    authorizedBy?: string;
+    data: any;
+}
+export interface ScheduleCreatedEvent {
+    id: string;
+    employeeId: string;
+    shiftTemplateId: string;
+    startDate: string;
+    endDate?: string;
+    rotationStartDate?: string;
+    isActive: boolean;
+    data: any;
+}
+export declare const EVENT_TOPICS: {
+    readonly ATTENDANCE_CREATED: "attendance-created";
+    readonly ATTENDANCE_UPDATED: "attendance-updated";
+    readonly EMPLOYEE_CREATED: "employee-created";
+    readonly EMPLOYEE_UPDATED: "employee-updated";
+    readonly EMPLOYEE_DELETED: "employee-deleted";
+    readonly COMPENSATION_CREATED: "compensation-created";
+    readonly COMPENSATION_UPDATED: "compensation-updated";
+    readonly SCHEDULE_CREATED: "schedule-created";
+    readonly SCHEDULE_UPDATED: "schedule-updated";
+};
+export type EventTopic = typeof EVENT_TOPICS[keyof typeof EVENT_TOPICS];
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,GAAG,CAAC;CACX;AAGD,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/types/events.js

@@ -0,0 +1,16 @@
+/**
+ * Event System Types
+ * Used for message broker events
+ */
+// Event topic names
+export const EVENT_TOPICS = {
+    ATTENDANCE_CREATED: 'attendance-created',
+    ATTENDANCE_UPDATED: 'attendance-updated',
+    EMPLOYEE_CREATED: 'employee-created',
+    EMPLOYEE_UPDATED: 'employee-updated',
+    EMPLOYEE_DELETED: 'employee-deleted',
+    COMPENSATION_CREATED: 'compensation-created',
+    COMPENSATION_UPDATED: 'compensation-updated',
+    SCHEDULE_CREATED: 'schedule-created',
+    SCHEDULE_UPDATED: 'schedule-updated',
+};

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared Types Index
+ * Export all types from this file
+ */
+export * from './attendance.js';
+export * from './employee.js';
+export * from './license.js';
+export * from './events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+/**
+ * Shared Types Index
+ * Export all types from this file
+ */
+export * from './attendance.js';
+export * from './employee.js';
+export * from './license.js';
+export * from './events.js';

package/dist/types/license.d.ts

@@ -0,0 +1,57 @@
+import { InstallationStatus, LicenseValidationReason } from '../enums/index.js';
+/**
+ * License System Types
+ */
+export interface LicenseStatus {
+    valid: boolean;
+    expiresAt?: Date;
+    maxClients?: number;
+    features?: Record<string, any>;
+    reason?: LicenseValidationReason | string;
+    warning?: string;
+    graceTimeRemaining?: number;
+    hoursOffline?: number;
+    companyName?: string;
+    installationStatus?: InstallationStatus;
+}
+export interface License {
+    id: string;
+    installationId: string;
+    licenseKey: string;
+    expiresAt: Date;
+    maxClients?: number;
+    features?: Record<string, any>;
+    isActive: boolean;
+    generatedById: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Installation {
+    id: string;
+    installationId: string;
+    companyName: string;
+    contactEmail?: string;
+    contactName?: string;
+    contactPhone?: string;
+    status: InstallationStatus;
+    isOnline: boolean;
+    lastSeenAt?: Date;
+    employeeCount?: number;
+    clientCount?: number;
+    version?: string;
+    notes?: string;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface HeartbeatMetrics {
+    employeeCount: number;
+    clientCount: number;
+    version: string;
+}
+export interface LicenseCache {
+    status: LicenseStatus;
+    timestamp: number;
+    lastSuccessfulValidation: number;
+}
+//# sourceMappingURL=license.d.ts.map

package/dist/types/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/types/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,uBAAuB,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;CAClC"}

package/dist/types/license.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@empleado-juan/commons",
+  "version": "1.0.0",
+  "description": "Shared code between frontend and backend services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["shared", "types", "enums", "validators"],
+  "author": "Empleado Juan Team",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}

package/src/constants/index.ts

@@ -0,0 +1,39 @@
+/**
+ * Shared Constants
+ * Used across frontend and backend services
+ */
+
+// Time constants
+export const TIME_CONSTANTS = {
+  SECOND: 1000,
+  MINUTE: 60 * 1000,
+  HOUR: 60 * 60 * 1000,
+  DAY: 24 * 60 * 60 * 1000,
+  WEEK: 7 * 24 * 60 * 60 * 1000,
+} as const;
+
+// License constants
+export const LICENSE_CONSTANTS = {
+  CACHE_TTL: 5 * 60 * 1000, // 5 minutes
+  GRACE_PERIOD: 24 * 60 * 60 * 1000, // 24 hours
+  MAX_GRACE_PERIOD: 48 * 60 * 60 * 1000, // 48 hours
+  VALIDATION_TIMEOUT: 10 * 1000, // 10 seconds
+  HEARTBEAT_INTERVAL: 5 * 60 * 1000, // 5 minutes
+} as const;
+
+// API Response constants
+export const API_RESPONSE = {
+  SUCCESS: 'success',
+  ERROR: 'error',
+  WARNING: 'warning',
+} as const;
+
+// Pagination defaults
+export const PAGINATION = {
+  DEFAULT_PAGE: 1,
+  DEFAULT_LIMIT: 20,
+  MAX_LIMIT: 100,
+} as const;
+
+// Co-Author for git commits
+export const GIT_CO_AUTHOR = 'Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>' as const;

package/src/enums/index.ts

@@ -0,0 +1,98 @@
+/**
+ * Shared Enums
+ * Used across frontend and backend services
+ */
+
+// Attendance Event Types
+export enum AttendanceEventType {
+  CHECK_IN = 'CHECK_IN',
+  CHECK_OUT = 'CHECK_OUT',
+  BREAK_START = 'BREAK_START',
+  BREAK_END = 'BREAK_END',
+}
+
+// Verification Modes (Biometric devices)
+export enum VerifyMode {
+  PASSWORD = 'PASSWORD',
+  FINGERPRINT = 'FINGERPRINT',
+  CARD = 'CARD',
+  FACE = 'FACE',
+}
+
+// Employee Status
+export enum EmployeeStatus {
+  ACTIVE = 'ACTIVE',
+  INACTIVE = 'INACTIVE',
+  SUSPENDED = 'SUSPENDED',
+}
+
+// Payment Types
+export enum PaymentType {
+  MONTHLY = 'MONTHLY',
+  BIWEEKLY = 'BIWEEKLY',
+  WEEKLY = 'WEEKLY',
+  HOURLY = 'HOURLY',
+}
+
+// Contract Types
+export enum ContractType {
+  INDEFINIDO = 'INDEFINIDO',
+  FIJO = 'FIJO',
+  OBRA_LABOR = 'OBRA_LABOR',
+  APRENDIZAJE = 'APRENDIZAJE',
+}
+
+// Payroll Frequency
+export enum PayrollFrequency {
+  WEEKLY = 'WEEKLY',
+  BIWEEKLY = 'BIWEEKLY',
+  MONTHLY = 'MONTHLY',
+}
+
+// User Roles
+export enum UserRole {
+  SUPER_ADMIN = 'SUPER_ADMIN',
+  ADMIN = 'ADMIN',
+  MANAGER = 'MANAGER',
+  EMPLOYEE = 'EMPLOYEE',
+}
+
+// Installation Status
+export enum InstallationStatus {
+  ACTIVE = 'ACTIVE',
+  INACTIVE = 'INACTIVE',
+  SUSPENDED = 'SUSPENDED',
+}
+
+// License Validation Reasons
+export enum LicenseValidationReason {
+  VALID = 'VALID',
+  EXPIRED = 'EXPIRED',
+  NO_LICENSE = 'NO_LICENSE',
+  INSTALLATION_NOT_FOUND = 'INSTALLATION_NOT_FOUND',
+  INSTALLATION_SUSPENDED = 'INSTALLATION_SUSPENDED',
+  MAX_CLIENTS_EXCEEDED = 'MAX_CLIENTS_EXCEEDED',
+  GRACE_PERIOD_EXPIRED = 'GRACE_PERIOD_EXPIRED',
+  DEACTIVATED_REMOTELY = 'DEACTIVATED_REMOTELY',
+}
+
+// Shift Types
+export enum ShiftType {
+  FIXED = 'FIXED',
+  ROTATING = 'ROTATING',
+  FLEXIBLE = 'FLEXIBLE',
+}
+
+// Day Types
+export enum DayType {
+  WORK = 'WORK',
+  REST = 'REST',
+  HOLIDAY = 'HOLIDAY',
+}
+
+// Message Broker Types
+export enum MessageBrokerType {
+  RABBITMQ = 'rabbitmq',
+  KAFKA = 'kafka',
+  SQS = 'sqs',
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @empleado-juan/commons
+ *
+ * Shared code between frontend and backend services
+ * Including types, enums, constants, and validators
+ */
+
+// Export all enums
+export * from './enums/index.js';
+
+// Export all types
+export * from './types/index.js';
+
+// Export all constants
+export * from './constants/index.js';

package/src/types/attendance.ts

@@ -0,0 +1,42 @@
+import { AttendanceEventType, VerifyMode } from '../enums/index.js';
+
+/**
+ * Attendance Record Types
+ */
+
+export interface AttendanceRecord {
+  id: string;
+  employeeId: string;
+  branchId: string;
+  deviceId?: string;
+  timestamp: Date;
+  eventType: AttendanceEventType;
+  verifyMode?: VerifyMode;
+  isManual: boolean;
+  notes?: string;
+  hikvisionEventId?: string;
+  rawData?: any;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CreateAttendanceInput {
+  employeeId: string;
+  branchId: string;
+  deviceId?: string;
+  timestamp: Date;
+  eventType: AttendanceEventType;
+  verifyMode?: VerifyMode;
+  isManual?: boolean;
+  notes?: string;
+}
+
+export interface AttendanceEvent {
+  id: string;
+  employeeId: string;
+  timestamp: Date;
+  eventType: AttendanceEventType;
+  branchId: string;
+  deviceId?: string;
+  verifyMode?: VerifyMode;
+}

package/src/types/employee.ts

@@ -0,0 +1,86 @@
+import { EmployeeStatus, PaymentType } from '../enums/index.js';
+
+/**
+ * Employee Types
+ */
+
+export interface Employee {
+  id: string;
+  branchId: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email?: string;
+  phone?: string;
+  address?: string;
+  positionId?: string;
+  departmentId?: string;
+  supervisorId?: string;
+  hireDate: Date;
+  terminationDate?: Date;
+  baseSalary?: number;
+  hourlyRate?: number;
+  paymentType: PaymentType;
+  bankAccount?: string;
+  hikvisionUserId?: string;
+  cardNumber?: string;
+  photo?: string;
+  isActive: boolean;
+  requiresAttendance: boolean;
+  isSuspended: boolean;
+  suspendedAt?: Date;
+  suspendedUntil?: Date;
+  suspensionReason?: string;
+  deactivatedAt?: Date;
+  deactivationReason?: string;
+  userId?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface CreateEmployeeInput {
+  branchId: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email?: string;
+  phone?: string;
+  address?: string;
+  positionId?: string;
+  departmentId?: string;
+  supervisorId?: string;
+  hireDate: Date;
+  baseSalary?: number;
+  hourlyRate?: number;
+  paymentType?: PaymentType;
+  bankAccount?: string;
+  hikvisionUserId?: string;
+  cardNumber?: string;
+  photo?: string;
+  scheduleId?: string;
+  scheduleStartDate?: Date;
+  createUserAccount?: boolean;
+  userPassword?: string;
+}
+
+export interface UpdateEmployeeInput {
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  phone?: string;
+  address?: string;
+  positionId?: string;
+  departmentId?: string;
+  supervisorId?: string;
+  baseSalary?: number;
+  hourlyRate?: number;
+  paymentType?: PaymentType;
+  bankAccount?: string;
+  scheduleId?: string;
+  scheduleStartDate?: Date;
+  photo?: string;
+  isActive?: boolean;
+  isSuspended?: boolean;
+  suspendedUntil?: Date;
+  suspensionReason?: string;
+}

package/src/types/events.ts

@@ -0,0 +1,76 @@
+/**
+ * Event System Types
+ * Used for message broker events
+ */
+
+export interface EventMessage {
+  key?: string;
+  value: string | object;
+  headers?: Record<string, string>;
+}
+
+export interface AttendanceCreatedEvent {
+  id: string;
+  clientId: string;
+  employeeId: string;
+  timestamp: string;
+  eventType: string;
+  branchId: string;
+  deviceId?: string;
+  verifyMode?: string;
+  data: any;
+}
+
+export interface EmployeeCreatedEvent {
+  id: string;
+  clientId: string;
+  employeeNumber: string;
+  firstName: string;
+  lastName: string;
+  email?: string;
+  branchId: string;
+  isActive: boolean;
+  data: any;
+}
+
+export interface CompensationCreatedEvent {
+  id: string;
+  employeeId: string;
+  validFrom: string;
+  validTo?: string;
+  baseSalaryMonthlyCents: number;
+  hourlyRateCents: number;
+  contractType: string;
+  paymentFrequency: string;
+  scheduledHoursPerWeek: number;
+  legalTemplateVersionId: string;
+  changeReason?: string;
+  authorizedBy?: string;
+  data: any;
+}
+
+export interface ScheduleCreatedEvent {
+  id: string;
+  employeeId: string;
+  shiftTemplateId: string;
+  startDate: string;
+  endDate?: string;
+  rotationStartDate?: string;
+  isActive: boolean;
+  data: any;
+}
+
+// Event topic names
+export const EVENT_TOPICS = {
+  ATTENDANCE_CREATED: 'attendance-created',
+  ATTENDANCE_UPDATED: 'attendance-updated',
+  EMPLOYEE_CREATED: 'employee-created',
+  EMPLOYEE_UPDATED: 'employee-updated',
+  EMPLOYEE_DELETED: 'employee-deleted',
+  COMPENSATION_CREATED: 'compensation-created',
+  COMPENSATION_UPDATED: 'compensation-updated',
+  SCHEDULE_CREATED: 'schedule-created',
+  SCHEDULE_UPDATED: 'schedule-updated',
+} as const;
+
+export type EventTopic = typeof EVENT_TOPICS[keyof typeof EVENT_TOPICS];

package/src/types/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared Types Index
+ * Export all types from this file
+ */
+
+export * from './attendance.js';
+export * from './employee.js';
+export * from './license.js';
+export * from './events.js';

package/src/types/license.ts

@@ -0,0 +1,62 @@
+import { InstallationStatus, LicenseValidationReason } from '../enums/index.js';
+
+/**
+ * License System Types
+ */
+
+export interface LicenseStatus {
+  valid: boolean;
+  expiresAt?: Date;
+  maxClients?: number;
+  features?: Record<string, any>;
+  reason?: LicenseValidationReason | string;
+  warning?: string;
+  graceTimeRemaining?: number;
+  hoursOffline?: number;
+  companyName?: string;
+  installationStatus?: InstallationStatus;
+}
+
+export interface License {
+  id: string;
+  installationId: string;
+  licenseKey: string;
+  expiresAt: Date;
+  maxClients?: number;
+  features?: Record<string, any>;
+  isActive: boolean;
+  generatedById: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface Installation {
+  id: string;
+  installationId: string;
+  companyName: string;
+  contactEmail?: string;
+  contactName?: string;
+  contactPhone?: string;
+  status: InstallationStatus;
+  isOnline: boolean;
+  lastSeenAt?: Date;
+  employeeCount?: number;
+  clientCount?: number;
+  version?: string;
+  notes?: string;
+  createdById: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface HeartbeatMetrics {
+  employeeCount: number;
+  clientCount: number;
+  version: string;
+}
+
+export interface LicenseCache {
+  status: LicenseStatus;
+  timestamp: number;
+  lastSuccessfulValidation: number;
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}