hvp-shared 6.53.1 → 6.55.0

package/dist/types/coverage.types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Employment Coverage Types
+ *
+ * Types for employment coverage analysis — identifying gaps between
+ * employment records for each collaborator.
+ *
+ * @see GH#11 - Employment coverage visibility in collaborator views
+ */
+/**
+ * Overall coverage status for a collaborator's employment history.
+ */
+export declare enum CoverageStatus {
+    full = "full",
+    has_gaps = "has_gaps",
+    no_employments = "no_employments"
+}
+export declare const COVERAGE_STATUS_LABELS: Record<CoverageStatus, string>;
+/**
+ * A single block in the coverage timeline — either an employment or a gap.
+ *
+ * Used in the detail view to render a chronological timeline.
+ */
+export interface CoveragePeriod {
+    /** Whether this period is an employment record or a gap between records */
+    type: "employment" | "gap";
+    /** Start date of the period (ISO 8601) */
+    startDate: string;
+    /** End date of the period (ISO 8601). Null if employment is ongoing. */
+    endDate: string | null;
+    /** Duration in calendar days. 0 if ongoing. */
+    durationDays: number;
+    /** Employment ID — only present for employment periods */
+    employmentId?: string;
+    /** Job ID — only present for employment periods */
+    jobId?: string;
+    /** Guaranteed income — only present for employment periods */
+    guaranteedIncome?: number;
+}
+/**
+ * Coverage summary for a single collaborator.
+ *
+ * Used in the collaborators table for the "Cobertura" column chip.
+ *
+ * @example GET /api/employments/coverage-summary
+ */
+export interface CollaboratorCoverageSummary {
+    collaboratorId: string;
+    status: CoverageStatus;
+    totalGapDays: number;
+    employmentCount: number;
+    isCurrentlyCovered: boolean;
+}
+/**
+ * Detailed coverage info for a single collaborator, including the timeline.
+ *
+ * Used in the collaborator detail view for the EmploymentTimeline component.
+ *
+ * @example GET /api/employments/coverage/:collaboratorId
+ */
+export interface CollaboratorCoverageDetail extends CollaboratorCoverageSummary {
+    /** Chronological list of employment and gap periods */
+    periods: CoveragePeriod[];
+}

package/dist/types/coverage.types.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Employment Coverage Types
+ *
+ * Types for employment coverage analysis — identifying gaps between
+ * employment records for each collaborator.
+ *
+ * @see GH#11 - Employment coverage visibility in collaborator views
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COVERAGE_STATUS_LABELS = exports.CoverageStatus = void 0;
+// ─── Coverage Status Enum ───────────────────────────────────────────────────
+/**
+ * Overall coverage status for a collaborator's employment history.
+ */
+var CoverageStatus;
+(function (CoverageStatus) {
+    CoverageStatus["full"] = "full";
+    CoverageStatus["has_gaps"] = "has_gaps";
+    CoverageStatus["no_employments"] = "no_employments";
+})(CoverageStatus || (exports.CoverageStatus = CoverageStatus = {}));
+exports.COVERAGE_STATUS_LABELS = {
+    [CoverageStatus.full]: "Cubierto",
+    [CoverageStatus.has_gaps]: "Con huecos",
+    [CoverageStatus.no_employments]: "Sin empleos",
+};

package/dist/types/index.d.ts

@@ -12,3 +12,4 @@ export * from './qvet.types';
 export * from './background-job.types';
 export * from './payroll-v2.types';
 export * from './cash-reconciliation.types';
+export * from './coverage.types';

package/dist/types/index.js

@@ -28,3 +28,4 @@ __exportStar(require("./qvet.types"), exports);
 __exportStar(require("./background-job.types"), exports);
 __exportStar(require("./payroll-v2.types"), exports);
 __exportStar(require("./cash-reconciliation.types"), exports);
+__exportStar(require("./coverage.types"), exports);

package/package.json

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