hvp-shared 6.54.0 → 6.56.0

package/dist/contracts/index.d.ts

@@ -10,3 +10,4 @@ export * from './qvet';
 export * from './stock-calculation';
 export * from './cash-reconciliation';
 export * from './time-off-request';
+export * from './job';

package/dist/contracts/index.js

@@ -26,3 +26,4 @@ __exportStar(require("./qvet"), exports);
 __exportStar(require("./stock-calculation"), exports);
 __exportStar(require("./cash-reconciliation"), exports);
 __exportStar(require("./time-off-request"), exports);
+__exportStar(require("./job"), exports);

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

@@ -0,0 +1,6 @@
+/**
+ * Job API Contracts
+ * Request and Response types for Job endpoints
+ */
+export * from './responses';
+export * from './requests';

package/dist/contracts/job/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Job API Contracts
+ * Request and Response types for Job 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/job/requests.d.ts

@@ -0,0 +1,51 @@
+import { JobCategory } from '../../constants/job-category.constants';
+import { JobPromotionStats } from '../../types/job-promotion-stats.types';
+/**
+ * Create Job Request
+ *
+ * Data required to create a new job position.
+ *
+ * @example POST /api/jobs
+ */
+export interface CreateJobRequest {
+    title: string;
+    description?: string;
+    category?: JobCategory;
+    sortingOrder?: number;
+    active: boolean;
+    positionFactor?: number;
+    guaranteedJobIncome?: number;
+    jobFixedIncome?: number;
+    fixedShareOfGuaranteedIncome?: number;
+    isCommissionAdjusted?: boolean;
+    commissionRateAdjustment?: number;
+    expressBranchCompensation?: number;
+    promotionJobId?: string;
+    quarterPromotionRequirements?: JobPromotionStats;
+    historicalPromotionRequirements?: JobPromotionStats;
+}
+/**
+ * Update Job Request
+ *
+ * Partial data to update an existing job.
+ * All fields optional — only provided fields are updated.
+ *
+ * @example PATCH /api/jobs/:id
+ */
+export interface UpdateJobRequest {
+    title?: string;
+    description?: string;
+    category?: JobCategory;
+    sortingOrder?: number;
+    active?: boolean;
+    positionFactor?: number;
+    guaranteedJobIncome?: number;
+    jobFixedIncome?: number;
+    fixedShareOfGuaranteedIncome?: number;
+    isCommissionAdjusted?: boolean;
+    commissionRateAdjustment?: number;
+    expressBranchCompensation?: number;
+    promotionJobId?: string;
+    quarterPromotionRequirements?: JobPromotionStats;
+    historicalPromotionRequirements?: JobPromotionStats;
+}

package/dist/contracts/job/requests.js

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

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

@@ -0,0 +1,35 @@
+import { JobCategory } from '../../constants/job-category.constants';
+import { JobPromotionStats } from '../../types/job-promotion-stats.types';
+/**
+ * Job Response
+ *
+ * Complete job data returned by the API.
+ * Jobs don't have a permission hierarchy (no sensitive data),
+ * so a single response type is sufficient.
+ *
+ * Used for: Job list, job detail view, job form pre-fill.
+ *
+ * @example GET /api/jobs/:id
+ */
+export interface JobResponse {
+    id: string;
+    title: string;
+    description?: string;
+    category?: JobCategory;
+    sortingOrder: number;
+    active: boolean;
+    positionFactor: number;
+    guaranteedJobIncome?: number;
+    jobFixedIncome?: number;
+    fixedShareOfGuaranteedIncome: number;
+    isCommissionAdjusted: boolean;
+    commissionRateAdjustment: number;
+    expressBranchCompensation: number;
+    promotionJobId?: string;
+    quarterPromotionRequirements?: JobPromotionStats;
+    historicalPromotionRequirements?: JobPromotionStats;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy: string;
+}

package/dist/contracts/job/responses.js

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

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

@@ -31,6 +31,10 @@ export interface CoveragePeriod {
     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.

package/dist/types/index.d.ts

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

package/dist/types/index.js

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

package/dist/types/job-promotion-stats.types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Job Promotion Stats
+ *
+ * Performance thresholds required for promotion eligibility.
+ * Used in Job entity for both quarterly and historical requirements.
+ *
+ * @example
+ * const requirements: JobPromotionStats = {
+ *   complexSurgeries: 5,
+ *   surgeries: 20,
+ *   surgeryAssistances: 10,
+ *   consultations: 50,
+ *   vaccines: 30,
+ *   totalServices: 115,
+ * };
+ */
+export interface JobPromotionStats {
+    complexSurgeries: number;
+    surgeries: number;
+    surgeryAssistances: number;
+    consultations: number;
+    vaccines: number;
+    totalServices: number;
+}

package/dist/types/job-promotion-stats.types.js

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

package/package.json

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