hvp-shared 3.2.0 → 3.2.1

package/dist/contracts/collaborator/index.d.ts

@@ -3,3 +3,4 @@
  * Request and Response types for Collaborator endpoints
  */
 export * from './responses';
+export * from './requests';

package/dist/contracts/collaborator/index.js

@@ -19,4 +19,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./responses"), exports);
-// export * from './requests';  // TODO: Create when needed
+__exportStar(require("./requests"), exports);

package/dist/contracts/collaborator/requests.d.ts

@@ -0,0 +1,132 @@
+import { WebAppRole } from '../../constants/collaborator.constants';
+import { AddressValidationProps } from '../../validation/address.validation';
+/**
+ * Create Collaborator Request
+ *
+ * Data required to create a new collaborator.
+ * Used by admin/manager roles.
+ *
+ * @example POST /api/collaborators/create
+ */
+export interface CreateCollaboratorRequest {
+    first_name: string;
+    last_name: string;
+    col_code: string;
+    role: WebAppRole;
+    isActive: boolean;
+    isDisplayedWeb: boolean;
+    isRegistered: boolean;
+    second_last_name?: string;
+    email?: string;
+    phone?: string;
+    photoURL?: string;
+    birthDate?: string;
+    job?: string;
+    branch?: string;
+    startDate?: string;
+    hireDate?: string;
+    endDate?: string;
+    address?: AddressValidationProps;
+    facebook?: string;
+    instagram?: string;
+    rfcCode?: string;
+    curp?: string;
+    imssNumber?: string;
+    useFiscalAddressSameAsMain?: boolean;
+    fiscalAddress?: AddressValidationProps;
+    taxZipCode?: string;
+    contractType?: string;
+    regimeType?: string;
+    fiscalRegime?: string;
+    bank?: string;
+    bankAccount?: string;
+    baseSalary?: number;
+    dailySalary?: number;
+    accessCode?: string;
+    password?: string;
+}
+/**
+ * Update Collaborator Request
+ *
+ * Partial data to update an existing collaborator.
+ * All fields optional - only provided fields will be updated.
+ *
+ * @example PATCH /api/collaborators/:id
+ */
+export interface UpdateCollaboratorRequest {
+    first_name?: string;
+    last_name?: string;
+    second_last_name?: string;
+    email?: string;
+    phone?: string;
+    photoURL?: string;
+    birthDate?: string;
+    role?: WebAppRole;
+    isActive?: boolean;
+    isDisplayedWeb?: boolean;
+    isRegistered?: boolean;
+    job?: string;
+    branch?: string;
+    startDate?: string;
+    hireDate?: string;
+    endDate?: string;
+    address?: AddressValidationProps;
+    facebook?: string;
+    instagram?: string;
+    rfcCode?: string;
+    curp?: string;
+    imssNumber?: string;
+    useFiscalAddressSameAsMain?: boolean;
+    fiscalAddress?: AddressValidationProps;
+    taxZipCode?: string;
+    contractType?: string;
+    regimeType?: string;
+    fiscalRegime?: string;
+    bank?: string;
+    bankAccount?: string;
+    baseSalary?: number;
+    dailySalary?: number;
+    accessCode?: string;
+    password?: string;
+}
+/**
+ * Register Collaborator Request
+ *
+ * Public registration flow for collaborators.
+ * Collaborator provides col_code, accessCode, email and password to register.
+ *
+ * @example PATCH /api/collaborators/register
+ */
+export interface RegisterCollaboratorRequest {
+    col_code: string;
+    accessCode: string;
+    email: string;
+    password: string;
+}
+/**
+ * Update Many Collaborators Request
+ *
+ * Batch update multiple collaborators.
+ * Each item must include id + fields to update.
+ *
+ * @example PATCH /api/collaborators
+ */
+export interface UpdateManyCollaboratorsRequest {
+    collaborators: Array<{
+        id: string;
+    } & Partial<UpdateCollaboratorRequest>>;
+}
+/**
+ * Collaborator Query Filters
+ *
+ * Query parameters for filtering collaborators list.
+ *
+ * @example GET /api/collaborators?isActive=true&role=Colaborador
+ */
+export interface CollaboratorQueryFilters {
+    isActive?: boolean;
+    role?: WebAppRole;
+    branch?: string;
+    isRegistered?: boolean;
+    isDisplayedWeb?: boolean;
+}

package/dist/contracts/collaborator/requests.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/collaborator/responses.d.ts

@@ -27,27 +27,22 @@ export interface PublicCollaboratorResponse {
  *
  * @example GET /api/collaborators/:id (authenticated collaborator)
  */
-export interface CollaboratorViewResponse {
-    id: string;
-    col_code: string;
-    first_name: string;
-    last_name: string;
+export interface CollaboratorViewResponse extends PublicCollaboratorResponse {
     email?: string;
     phone?: string;
-    photoURL?: string;
-    birthDate?: Date;
-    role: WebAppRole;
-    isActive: boolean;
+    birthDate?: string;
     isDisplayedWeb: boolean;
     isRegistered: boolean;
     job?: string;
     branch?: string;
-    hireDate?: Date;
+    startDate?: string;
+    hireDate?: string;
+    endDate?: string;
     address?: AddressValidationProps;
     facebook?: string;
     instagram?: string;
-    createdAt?: Date;
-    updatedAt?: Date;
+    createdAt?: string;
+    updatedAt?: string;
 }
 /**
  * Admin Collaborator Response
@@ -59,28 +54,9 @@ export interface CollaboratorViewResponse {
  *
  * @example GET /api/collaborators/:id (admin authenticated)
  */
-export interface AdminCollaboratorResponse {
-    id: string;
-    col_code: string;
-    first_name: string;
-    last_name: string;
+export interface AdminCollaboratorResponse extends CollaboratorViewResponse {
     second_last_name?: string;
-    email?: string;
-    phone?: string;
-    photoURL?: string;
-    birthDate?: Date;
-    role: WebAppRole;
-    isActive: boolean;
-    isDisplayedWeb: boolean;
-    isRegistered: boolean;
-    registeredDate?: Date;
-    job?: string;
-    branch?: string;
-    hireDate?: Date;
-    endDate?: Date;
-    address?: AddressValidationProps;
-    facebook?: string;
-    instagram?: string;
+    registeredDate?: string;
     rfcCode?: string;
     curp?: string;
     imssNumber?: string;
@@ -97,8 +73,6 @@ export interface AdminCollaboratorResponse {
     accessCode?: string;
     createdBy?: string;
     updatedBy?: string;
-    createdAt?: Date;
-    updatedAt?: Date;
 }
 /**
  * Union type for all collaborator response types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvp-shared",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",