hvp-shared 7.4.0 → 7.6.0

package/dist/contracts/external-study/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * External Study API Contracts
+ */
+export * from './types';
+export * from './requests';
+export * from './responses';

package/dist/contracts/external-study/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * External Study API Contracts
+ */
+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("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/external-study/requests.d.ts

@@ -0,0 +1,84 @@
+/**
+ * External Study Requests
+ */
+import { StudyStatus } from './types';
+/**
+ * Create a new external study.
+ *
+ * @example POST /api/external-studies
+ */
+export interface CreateExternalStudyRequest {
+    qvetPetId?: number;
+    qvetClientId?: number;
+    patientName: string;
+    clientName?: string;
+    studyTypeId: string;
+    studyTypeDetail?: string;
+    qvetSupplierId: number;
+    responsibleDoctorId: string;
+    requestedById?: string;
+    resultUrl?: string;
+    notes?: string;
+}
+/**
+ * Update a study's editable fields (patient, type, supplier, doctor, links, notes).
+ *
+ * For state transitions, use the dedicated transition endpoints.
+ *
+ * @example PATCH /api/external-studies/:id
+ */
+export interface UpdateExternalStudyRequest {
+    qvetPetId?: number;
+    qvetClientId?: number;
+    patientName?: string;
+    clientName?: string;
+    studyTypeId?: string;
+    studyTypeDetail?: string;
+    qvetSupplierId?: number;
+    responsibleDoctorId?: string;
+    requestedById?: string;
+    resultUrl?: string;
+    notes?: string;
+}
+/**
+ * Transition a study to a new state.
+ *
+ * Backend validates the transition is legal:
+ *   - solicitado → enviado, cancelado
+ *   - enviado → resultado_recibido, cancelado
+ *   - resultado_recibido → cerrado, cancelado
+ *   - cerrado, cancelado → no transitions out
+ *
+ * @example POST /api/external-studies/:id/transition
+ */
+export interface TransitionStudyRequest {
+    status: StudyStatus;
+}
+/**
+ * Toggle a post-received action timestamp.
+ *
+ * When `done=true` and the timestamp is unset, sets it to now.
+ * When `done=false`, clears the timestamp.
+ *
+ * Only valid when study status is resultado_recibido or cerrado.
+ *
+ * @example POST /api/external-studies/:id/post-action
+ */
+export interface PostActionRequest {
+    action: 'sentToInternalWhatsapp' | 'uploadedToQvet' | 'informedClient';
+    done: boolean;
+}
+/**
+ * Filter params for listing external studies.
+ */
+export interface ExternalStudyQueryFilters {
+    status?: StudyStatus | StudyStatus[];
+    responsibleDoctorId?: string;
+    qvetSupplierId?: number;
+    studyTypeId?: string;
+    /** ISO date strings */
+    fromDate?: string;
+    toDate?: string;
+    /** When true, returns only overdue active studies. */
+    overdueOnly?: boolean;
+}

package/dist/contracts/external-study/requests.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * External Study Requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/external-study/responses.d.ts

@@ -0,0 +1,60 @@
+/**
+ * External Study Responses
+ */
+import { StudyCategory } from '../study-type-catalog/types';
+import { StudyStatus } from './types';
+/**
+ * Single external study record.
+ *
+ * @example GET /api/external-studies/:id
+ */
+export interface ExternalStudyResponse {
+    id: string;
+    qvetPetId?: number;
+    qvetClientId?: number;
+    patientName: string;
+    clientName?: string;
+    studyTypeId: string;
+    studyTypeCategory: StudyCategory;
+    studyTypeDetail?: string;
+    qvetSupplierId: number;
+    responsibleDoctorId: string;
+    requestedById: string;
+    status: StudyStatus;
+    requestedAt: string;
+    sentAt?: string;
+    resultReceivedAt?: string;
+    closedAt?: string;
+    cancelledAt?: string;
+    sentToInternalWhatsappAt?: string;
+    uploadedToQvetAt?: string;
+    informedClientAt?: string;
+    resultUrl?: string;
+    notes?: string;
+    daysSinceRequested: number;
+    isOverdue: boolean;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+/**
+ * Pending dashboard summary for an external study (lighter payload for list views).
+ *
+ * Only IDs — frontend looks up names from local catalogs.
+ */
+export interface ExternalStudyPendingItem {
+    id: string;
+    patientName: string;
+    clientName?: string;
+    studyTypeId: string;
+    studyTypeCategory: StudyCategory;
+    studyTypeDetail?: string;
+    qvetSupplierId: number;
+    responsibleDoctorId: string;
+    requestedById: string;
+    status: StudyStatus;
+    requestedAt: string;
+    daysSinceRequested: number;
+    isOverdue: boolean;
+}

package/dist/contracts/external-study/responses.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * External Study Responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/external-study/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * External Study Types
+ *
+ * Tracks studies sent to external labs (YiHealth, Annilab, Peninsular)
+ * or imaging providers (USG/RX/ECO). Provides visibility on what's pending,
+ * who requested it, and what post-result actions remain.
+ */
+/**
+ * Workflow state of an external study.
+ *
+ * Transitions:
+ *   requested → sent → result_received → closed
+ *                              ↓
+ *                          cancelled (from any active state)
+ *
+ * Spanish UI labels are in `STUDY_STATUS_LABELS` — code/DB always uses English.
+ *
+ * Post-received actions (sentToInternalWhatsappAt, uploadedToQvetAt,
+ * informedClientAt) are independent timestamps — not states.
+ */
+export declare enum StudyStatus {
+    requested = "requested",
+    sent = "sent",
+    result_received = "result_received",
+    closed = "closed",
+    cancelled = "cancelled"
+}
+/** UI-only labels (Spanish). Code uses English enum values everywhere else. */
+export declare const STUDY_STATUS_LABELS: Record<StudyStatus, string>;
+/**
+ * Active states (not closed/cancelled). Used to filter pending dashboards.
+ */
+export declare const ACTIVE_STUDY_STATUSES: ReadonlyArray<StudyStatus>;
+/**
+ * Overdue thresholds in days (per category). Hardcoded for now; can move to
+ * settings later. A study is "overdue" when (today - requestedAt) > threshold
+ * AND status is in ACTIVE_STUDY_STATUSES.
+ */
+export declare const OVERDUE_THRESHOLD_DAYS: {
+    readonly LAB: 5;
+    readonly IMAGING: 3;
+};

package/dist/contracts/external-study/types.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * External Study Types
+ *
+ * Tracks studies sent to external labs (YiHealth, Annilab, Peninsular)
+ * or imaging providers (USG/RX/ECO). Provides visibility on what's pending,
+ * who requested it, and what post-result actions remain.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OVERDUE_THRESHOLD_DAYS = exports.ACTIVE_STUDY_STATUSES = exports.STUDY_STATUS_LABELS = exports.StudyStatus = void 0;
+/**
+ * Workflow state of an external study.
+ *
+ * Transitions:
+ *   requested → sent → result_received → closed
+ *                              ↓
+ *                          cancelled (from any active state)
+ *
+ * Spanish UI labels are in `STUDY_STATUS_LABELS` — code/DB always uses English.
+ *
+ * Post-received actions (sentToInternalWhatsappAt, uploadedToQvetAt,
+ * informedClientAt) are independent timestamps — not states.
+ */
+var StudyStatus;
+(function (StudyStatus) {
+    StudyStatus["requested"] = "requested";
+    StudyStatus["sent"] = "sent";
+    StudyStatus["result_received"] = "result_received";
+    StudyStatus["closed"] = "closed";
+    StudyStatus["cancelled"] = "cancelled";
+})(StudyStatus || (exports.StudyStatus = StudyStatus = {}));
+/** UI-only labels (Spanish). Code uses English enum values everywhere else. */
+exports.STUDY_STATUS_LABELS = {
+    [StudyStatus.requested]: 'Solicitado',
+    [StudyStatus.sent]: 'Enviado',
+    [StudyStatus.result_received]: 'Resultado recibido',
+    [StudyStatus.closed]: 'Cerrado',
+    [StudyStatus.cancelled]: 'Cancelado',
+};
+/**
+ * Active states (not closed/cancelled). Used to filter pending dashboards.
+ */
+exports.ACTIVE_STUDY_STATUSES = [
+    StudyStatus.requested,
+    StudyStatus.sent,
+    StudyStatus.result_received,
+];
+/**
+ * Overdue thresholds in days (per category). Hardcoded for now; can move to
+ * settings later. A study is "overdue" when (today - requestedAt) > threshold
+ * AND status is in ACTIVE_STUDY_STATUSES.
+ */
+exports.OVERDUE_THRESHOLD_DAYS = {
+    LAB: 5,
+    IMAGING: 3,
+};

package/dist/contracts/index.d.ts

@@ -16,3 +16,7 @@ export * from './client-billing';
 export * from './global-invoice';
 export * from './inventory-report';
 export * from './google-contacts';
+export * from './study-type-catalog';
+export * from './supplier-overlay';
+export * from './external-study';
+export * from './pending-dashboard';

package/dist/contracts/index.js

@@ -32,3 +32,7 @@ __exportStar(require("./client-billing"), exports);
 __exportStar(require("./global-invoice"), exports);
 __exportStar(require("./inventory-report"), exports);
 __exportStar(require("./google-contacts"), exports);
+__exportStar(require("./study-type-catalog"), exports);
+__exportStar(require("./supplier-overlay"), exports);
+__exportStar(require("./external-study"), exports);
+__exportStar(require("./pending-dashboard"), exports);

package/dist/contracts/pending-dashboard/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Pending Dashboard API Contracts
+ */
+export * from './responses';

package/dist/contracts/pending-dashboard/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Pending Dashboard API Contracts
+ */
+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);

package/dist/contracts/pending-dashboard/responses.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Pending Dashboard Responses
+ *
+ * Aggregated view of pending items across the system. Visible to anyone.
+ * Designed to grow over time — each card represents one source.
+ */
+import { ExternalStudyPendingItem } from '../external-study/responses';
+/**
+ * Sales (tickets) with outstanding balance.
+ */
+export interface PendingSaleSummary {
+    ticketNumber: number;
+    date: string;
+    qvetClientId?: number;
+    clientName?: string;
+    total: number;
+    paid: number;
+    outstanding: number;
+}
+/**
+ * @example GET /api/pending-dashboard
+ */
+export interface PendingDashboardResponse {
+    studies: {
+        overdueCount: number;
+        activeCount: number;
+        overdueItems: ExternalStudyPendingItem[];
+    };
+    sales: {
+        pendingTicketsCount: number;
+        totalOutstanding: number;
+        topItems: PendingSaleSummary[];
+    };
+}

package/dist/contracts/pending-dashboard/responses.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Pending Dashboard Responses
+ *
+ * Aggregated view of pending items across the system. Visible to anyone.
+ * Designed to grow over time — each card represents one source.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/study-type-catalog/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Study Type Catalog API Contracts
+ */
+export * from './types';
+export * from './requests';
+export * from './responses';

package/dist/contracts/study-type-catalog/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Study Type Catalog API Contracts
+ */
+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("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/study-type-catalog/requests.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Study Type Catalog Requests
+ */
+import { StudyCategory } from './types';
+/**
+ * Create a new study type in the catalog.
+ *
+ * @example POST /api/study-type-catalog
+ */
+export interface CreateStudyTypeRequest {
+    name: string;
+    qvetCode?: number;
+    category: StudyCategory;
+    isFlexible: boolean;
+    notes?: string;
+}
+/**
+ * Update an existing study type.
+ *
+ * @example PATCH /api/study-type-catalog/:id
+ */
+export interface UpdateStudyTypeRequest {
+    name?: string;
+    qvetCode?: number;
+    category?: StudyCategory;
+    isFlexible?: boolean;
+    isActive?: boolean;
+    notes?: string;
+}
+/**
+ * Filter params for listing study types.
+ */
+export interface StudyTypeQueryFilters {
+    category?: StudyCategory;
+    isActive?: boolean;
+}

package/dist/contracts/study-type-catalog/requests.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Study Type Catalog Requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/study-type-catalog/responses.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Study Type Catalog Responses
+ */
+import { StudyCategory } from './types';
+/**
+ * Single study type catalog entry.
+ *
+ * @example GET /api/study-type-catalog/:id
+ */
+export interface StudyTypeResponse {
+    id: string;
+    name: string;
+    qvetCode?: number;
+    category: StudyCategory;
+    isFlexible: boolean;
+    isActive: boolean;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+}

package/dist/contracts/study-type-catalog/responses.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Study Type Catalog Responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/study-type-catalog/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Study Type Catalog Types
+ *
+ * Catalog of available study types (LAB or IMAGING) used when creating
+ * an ExternalStudy. Some entries are "flexible" — they require a free-text
+ * detail at use time (e.g. "USG dirigido" → user types "USG cardíaco").
+ *
+ * Seeded initially from QVET catalog (SERVICIOS EXTERNOS → LABORATORIO/GABINETE)
+ * cross-referenced with sales activity. Anyone can add new entries via UI.
+ */
+/**
+ * Study category — determines the overdue threshold and groups studies.
+ */
+export declare enum StudyCategory {
+    LAB = "LAB",
+    IMAGING = "IMAGING"
+}
+export declare const STUDY_CATEGORY_LABELS: Record<StudyCategory, string>;

package/dist/contracts/study-type-catalog/types.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Study Type Catalog Types
+ *
+ * Catalog of available study types (LAB or IMAGING) used when creating
+ * an ExternalStudy. Some entries are "flexible" — they require a free-text
+ * detail at use time (e.g. "USG dirigido" → user types "USG cardíaco").
+ *
+ * Seeded initially from QVET catalog (SERVICIOS EXTERNOS → LABORATORIO/GABINETE)
+ * cross-referenced with sales activity. Anyone can add new entries via UI.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STUDY_CATEGORY_LABELS = exports.StudyCategory = void 0;
+/**
+ * Study category — determines the overdue threshold and groups studies.
+ */
+var StudyCategory;
+(function (StudyCategory) {
+    StudyCategory["LAB"] = "LAB";
+    StudyCategory["IMAGING"] = "IMAGING";
+})(StudyCategory || (exports.StudyCategory = StudyCategory = {}));
+exports.STUDY_CATEGORY_LABELS = {
+    [StudyCategory.LAB]: 'Laboratorio',
+    [StudyCategory.IMAGING]: 'Imagen',
+};

package/dist/contracts/supplier-overlay/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Supplier Overlay API Contracts
+ */
+export * from './types';
+export * from './requests';
+export * from './responses';

package/dist/contracts/supplier-overlay/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Supplier Overlay API Contracts
+ */
+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("./types"), exports);
+__exportStar(require("./requests"), exports);
+__exportStar(require("./responses"), exports);

package/dist/contracts/supplier-overlay/requests.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Supplier Overlay Requests
+ */
+/**
+ * Upsert a supplier overlay.
+ *
+ * Used to tag a QVET supplier as a study provider (or not).
+ * Creates the overlay if it doesn't exist; updates it if it does.
+ *
+ * @example PATCH /api/supplier-overlays/:qvetSupplierId
+ */
+export interface UpsertSupplierOverlayRequest {
+    isStudyProvider: boolean;
+    notes?: string;
+}
+/**
+ * Filter params for listing supplier overlays.
+ */
+export interface SupplierOverlayQueryFilters {
+    /** When true, returns only overlays where isStudyProvider=true. */
+    isStudyProvider?: boolean;
+}

package/dist/contracts/supplier-overlay/requests.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Supplier Overlay Requests
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/supplier-overlay/responses.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Supplier Overlay Responses
+ */
+/**
+ * Supplier overlay record (HVP-specific tags on top of a QVET supplier).
+ */
+export interface SupplierOverlayResponse {
+    id: string;
+    qvetSupplierId: number;
+    isStudyProvider: boolean;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+/**
+ * Combined response: a QVET supplier with its overlay attached (or null if no overlay yet).
+ *
+ * Used by the supplier overlay management UI to show the full QVET supplier list
+ * with an inline checkbox/toggle for `isStudyProvider`.
+ *
+ * @example GET /api/supplier-overlays
+ */
+export interface QvetSupplierWithOverlayResponse {
+    qvetSupplierId: number;
+    name: string;
+    taxId?: string;
+    email?: string;
+    phone1?: string;
+    isActive: boolean;
+    /** The HVP overlay (null when not yet tagged). */
+    overlay: SupplierOverlayResponse | null;
+}

package/dist/contracts/supplier-overlay/responses.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Supplier Overlay Responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/supplier-overlay/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Supplier Overlay Types
+ *
+ * Parallel data layer for QVET suppliers. Stores HVP-specific tags
+ * without polluting `qvet_suppliers` (which is upsert-overwritten on every QVET sync).
+ *
+ * Currently used to flag which suppliers are study providers (so they show up
+ * in the ExternalStudy form). Category (LAB/IMAGING) lives in StudyTypeCatalog,
+ * not here — the supplier just needs a yes/no flag.
+ */
+export {};

package/dist/contracts/supplier-overlay/types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Supplier Overlay Types
+ *
+ * Parallel data layer for QVET suppliers. Stores HVP-specific tags
+ * without polluting `qvet_suppliers` (which is upsert-overwritten on every QVET sync).
+ *
+ * Currently used to flag which suppliers are study providers (so they show up
+ * in the ExternalStudy form). Category (LAB/IMAGING) lives in StudyTypeCatalog,
+ * not here — the supplier just needs a yes/no flag.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

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