hvp-shared 13.13.0 → 13.15.0

package/dist/constants/force-majeure.enums.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Force Majeure (Fuerza mayor) Enums
+ *
+ * Single source of truth for force-majeure declaration scope.
+ * A declaration marks a day (or range) as "fuerza mayor" for everyone or for a
+ * single branch. Affected collaborators are paid full salary with their actual
+ * scheduled hours computed. See GH#423.
+ */
+export declare enum ForceMajeureScope {
+    all = "all",
+    branch = "branch"
+}
+/** Spanish display labels for ForceMajeureScope */
+export declare const FORCE_MAJEURE_SCOPE_LABELS: Record<ForceMajeureScope, string>;

package/dist/constants/force-majeure.enums.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Force Majeure (Fuerza mayor) Enums
+ *
+ * Single source of truth for force-majeure declaration scope.
+ * A declaration marks a day (or range) as "fuerza mayor" for everyone or for a
+ * single branch. Affected collaborators are paid full salary with their actual
+ * scheduled hours computed. See GH#423.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORCE_MAJEURE_SCOPE_LABELS = exports.ForceMajeureScope = void 0;
+var ForceMajeureScope;
+(function (ForceMajeureScope) {
+    ForceMajeureScope["all"] = "all";
+    ForceMajeureScope["branch"] = "branch";
+})(ForceMajeureScope || (exports.ForceMajeureScope = ForceMajeureScope = {}));
+/** Spanish display labels for ForceMajeureScope */
+exports.FORCE_MAJEURE_SCOPE_LABELS = {
+    [ForceMajeureScope.all]: 'Todas las sucursales',
+    [ForceMajeureScope.branch]: 'Sucursal específica',
+};

package/dist/constants/index.d.ts

@@ -19,6 +19,7 @@ export * from './employment.enums';
 export * from './qvet-cash-flow.enums';
 export * from './time-off.enums';
 export * from './time-off.constants';
+export * from './force-majeure.enums';
 export * from './hris.constants';
 export * from './payroll-features.constants';
 export * from './inventory-session.enums';

package/dist/constants/index.js

@@ -35,6 +35,7 @@ __exportStar(require("./employment.enums"), exports);
 __exportStar(require("./qvet-cash-flow.enums"), exports);
 __exportStar(require("./time-off.enums"), exports);
 __exportStar(require("./time-off.constants"), exports);
+__exportStar(require("./force-majeure.enums"), exports);
 __exportStar(require("./hris.constants"), exports);
 __exportStar(require("./payroll-features.constants"), exports);
 __exportStar(require("./inventory-session.enums"), exports);

package/dist/constants/time-off.constants.d.ts

@@ -20,5 +20,8 @@ export declare const LEGAL_VACATIONS: {
 /**
  * TimeOffTypes that consume vacation balance.
  * Only these types count against a collaborator's vacation days.
+ *
+ * NOTE: TimeOffType.PaidLeave (Permiso con goce de sueldo) is intentionally
+ * EXCLUDED — a paid leave pays full salary but must NOT consume vacation days.
  */
 export declare const VACATION_CONSUMING_TYPES: readonly TimeOffType[];

package/dist/constants/time-off.constants.js

@@ -87,6 +87,9 @@ exports.LEGAL_VACATIONS = {
 /**
  * TimeOffTypes that consume vacation balance.
  * Only these types count against a collaborator's vacation days.
+ *
+ * NOTE: TimeOffType.PaidLeave (Permiso con goce de sueldo) is intentionally
+ * EXCLUDED — a paid leave pays full salary but must NOT consume vacation days.
  */
 exports.VACATION_CONSUMING_TYPES = [
     time_off_enums_1.TimeOffType.Vacation,

package/dist/constants/time-off.enums.d.ts

@@ -19,7 +19,14 @@ export declare enum TimeOffType {
     AuthorizedUnjustifiedAbsence = "Falta injustificada autorizada",
     EarlyLeavePermission = "Permiso de salida anticipada",
     LatePermission = "Permiso de llegar tarde",
-    CompensationShift = "Reposici\u00F3n de jornada"
+    CompensationShift = "Reposici\u00F3n de jornada",
+    /**
+     * Employer-paid authorized absence at full ordinary salary (paternity,
+     * marriage, bereavement, etc.). The specific motive goes in the request note.
+     * Pays full salary, NO discount, does NOT consume vacation balance, grants
+     * NO prima vacacional, and pays NO commission/average-income compensation.
+     */
+    PaidLeave = "Permiso con goce de sueldo"
 }
 /** Spanish display labels for TimeOffType */
 export declare const TIME_OFF_TYPE_LABELS: Record<TimeOffType, string>;

package/dist/constants/time-off.enums.js

@@ -25,6 +25,13 @@ var TimeOffType;
     TimeOffType["EarlyLeavePermission"] = "Permiso de salida anticipada";
     TimeOffType["LatePermission"] = "Permiso de llegar tarde";
     TimeOffType["CompensationShift"] = "Reposici\u00F3n de jornada";
+    /**
+     * Employer-paid authorized absence at full ordinary salary (paternity,
+     * marriage, bereavement, etc.). The specific motive goes in the request note.
+     * Pays full salary, NO discount, does NOT consume vacation balance, grants
+     * NO prima vacacional, and pays NO commission/average-income compensation.
+     */
+    TimeOffType["PaidLeave"] = "Permiso con goce de sueldo";
 })(TimeOffType || (exports.TimeOffType = TimeOffType = {}));
 /** Spanish display labels for TimeOffType */
 exports.TIME_OFF_TYPE_LABELS = {
@@ -37,6 +44,7 @@ exports.TIME_OFF_TYPE_LABELS = {
     [TimeOffType.EarlyLeavePermission]: 'Permiso de salida anticipada',
     [TimeOffType.LatePermission]: 'Permiso de llegar tarde',
     [TimeOffType.CompensationShift]: 'Reposición de jornada',
+    [TimeOffType.PaidLeave]: 'Permiso con goce de sueldo',
 };
 /** Spanish display labels for TimeOffStatus */
 exports.TIME_OFF_STATUS_LABELS = {

package/dist/contracts/force-majeure/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Force Majeure Declaration API Contracts
+ * Request and Response types for force-majeure declaration endpoints.
+ */
+export * from './responses';
+export * from './requests';

package/dist/contracts/force-majeure/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Force Majeure Declaration API Contracts
+ * Request and Response types for force-majeure declaration endpoints.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./responses"), exports);
+__exportStar(require("./requests"), exports);

package/dist/contracts/force-majeure/requests.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Force Majeure Declaration Request Types
+ *
+ * API request contracts for force-majeure declaration endpoints. A single
+ * declaration covers everyone (or a branch) for the given day(s); affected
+ * collaborators are resolved at attendance-read time (individual time-off wins).
+ *
+ * @example POST /api/force-majeure
+ * @example PATCH /api/force-majeure/:id
+ */
+import { ForceMajeureScope } from '../../constants/force-majeure.enums';
+/**
+ * Create Force Majeure Declaration
+ *
+ * @example POST /api/force-majeure
+ */
+export interface CreateForceMajeureDeclarationRequest {
+    /** Affected day(s), ISO 8601 at Mexico start-of-day. */
+    dates: string[];
+    scope: ForceMajeureScope;
+    /** Required when scope is `branch`. */
+    branchId?: string;
+    reason: string;
+}
+/**
+ * Update Force Majeure Declaration (partial).
+ *
+ * @example PATCH /api/force-majeure/:id
+ */
+export interface UpdateForceMajeureDeclarationRequest {
+    dates?: string[];
+    scope?: ForceMajeureScope;
+    branchId?: string;
+    reason?: string;
+}
+/**
+ * Query filters for listing declarations.
+ *
+ * @example GET /api/force-majeure?fromDate=...&toDate=...
+ */
+export interface ForceMajeureDeclarationQuery {
+    /** Return declarations overlapping this date range (ISO 8601). */
+    fromDate?: string;
+    toDate?: string;
+    branchId?: string;
+}

package/dist/contracts/force-majeure/requests.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Force Majeure Declaration Request Types
+ *
+ * API request contracts for force-majeure declaration endpoints. A single
+ * declaration covers everyone (or a branch) for the given day(s); affected
+ * collaborators are resolved at attendance-read time (individual time-off wins).
+ *
+ * @example POST /api/force-majeure
+ * @example PATCH /api/force-majeure/:id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/force-majeure/responses.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Force Majeure Declaration Response Types
+ *
+ * API response contracts for force-majeure declaration endpoints.
+ *
+ * @example GET /api/force-majeure
+ * @example GET /api/force-majeure/:id
+ */
+import { ForceMajeureScope } from '../../constants/force-majeure.enums';
+/**
+ * Force Majeure Declaration
+ *
+ * A declared closure for a day (or range), affecting everyone or a single
+ * branch. Collaborators with a scheduled shift and no full-day individual
+ * time-off on those days are paid full salary with their scheduled hours.
+ */
+export interface ForceMajeureDeclarationResponse {
+    id: string;
+    /** Affected day(s), ISO 8601 at Mexico start-of-day. */
+    dates: string[];
+    scope: ForceMajeureScope;
+    /** Present when scope is `branch`. */
+    branchId?: string;
+    reason: string;
+    createdAt?: string;
+    updatedAt?: string;
+    createdBy?: string;
+    updatedBy?: string;
+}

package/dist/contracts/force-majeure/responses.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Force Majeure Declaration Response Types
+ *
+ * API response contracts for force-majeure declaration endpoints.
+ *
+ * @example GET /api/force-majeure
+ * @example GET /api/force-majeure/:id
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/index.d.ts

@@ -10,6 +10,7 @@ export * from './qvet';
 export * from './stock-calculation';
 export * from './cash-reconciliation';
 export * from './time-off-request';
+export * from './force-majeure';
 export * from './job';
 export * from './inventory-session';
 export * from './client-billing';

package/dist/contracts/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./qvet"), exports);
 __exportStar(require("./stock-calculation"), exports);
 __exportStar(require("./cash-reconciliation"), exports);
 __exportStar(require("./time-off-request"), exports);
+__exportStar(require("./force-majeure"), exports);
 __exportStar(require("./job"), exports);
 __exportStar(require("./inventory-session"), exports);
 __exportStar(require("./client-billing"), exports);

package/package.json

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