hvp-shared 6.4.0 → 6.6.0

package/dist/constants/background-job.constants.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Background Job Constants
+ *
+ * Enums and constants for background job system.
+ * Used by frontend (polling) and backend (job execution).
+ */
+/**
+ * Job types for QVET sync operations
+ */
+export declare enum JobType {
+    SYNC_SALES = "SYNC_SALES",
+    SYNC_PURCHASES = "SYNC_PURCHASES",
+    SYNC_INVENTORY = "SYNC_INVENTORY",
+    SYNC_TRANSFERS = "SYNC_TRANSFERS",
+    SYNC_MOVEMENTS = "SYNC_MOVEMENTS",
+    SYNC_STOCK_CONFIG = "SYNC_STOCK_CONFIG",
+    SYNC_CATALOG = "SYNC_CATALOG",
+    SYNC_ALL = "SYNC_ALL"
+}
+/**
+ * Job execution status
+ */
+export declare enum JobStatus {
+    PENDING = "pending",
+    PROCESSING = "processing",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * Current step within a sync job
+ */
+export declare enum JobStep {
+    DOWNLOAD = "download",
+    PARSE = "parse",
+    TRANSFORM = "transform",
+    SYNC = "sync"
+}
+/**
+ * Human-readable labels for job types (Spanish for UI)
+ */
+export declare const JOB_TYPE_LABELS: Record<JobType, string>;
+/**
+ * Human-readable labels for job steps (Spanish for UI)
+ */
+export declare const JOB_STEP_LABELS: Record<JobStep, string>;
+/**
+ * Human-readable labels for job status (Spanish for UI)
+ */
+export declare const JOB_STATUS_LABELS: Record<JobStatus, string>;

package/dist/constants/background-job.constants.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * Background Job Constants
+ *
+ * Enums and constants for background job system.
+ * Used by frontend (polling) and backend (job execution).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JOB_STATUS_LABELS = exports.JOB_STEP_LABELS = exports.JOB_TYPE_LABELS = exports.JobStep = exports.JobStatus = exports.JobType = void 0;
+/**
+ * Job types for QVET sync operations
+ */
+var JobType;
+(function (JobType) {
+    JobType["SYNC_SALES"] = "SYNC_SALES";
+    JobType["SYNC_PURCHASES"] = "SYNC_PURCHASES";
+    JobType["SYNC_INVENTORY"] = "SYNC_INVENTORY";
+    JobType["SYNC_TRANSFERS"] = "SYNC_TRANSFERS";
+    JobType["SYNC_MOVEMENTS"] = "SYNC_MOVEMENTS";
+    JobType["SYNC_STOCK_CONFIG"] = "SYNC_STOCK_CONFIG";
+    JobType["SYNC_CATALOG"] = "SYNC_CATALOG";
+    JobType["SYNC_ALL"] = "SYNC_ALL";
+})(JobType || (exports.JobType = JobType = {}));
+/**
+ * Job execution status
+ */
+var JobStatus;
+(function (JobStatus) {
+    JobStatus["PENDING"] = "pending";
+    JobStatus["PROCESSING"] = "processing";
+    JobStatus["COMPLETED"] = "completed";
+    JobStatus["FAILED"] = "failed";
+    JobStatus["CANCELLED"] = "cancelled";
+})(JobStatus || (exports.JobStatus = JobStatus = {}));
+/**
+ * Current step within a sync job
+ */
+var JobStep;
+(function (JobStep) {
+    JobStep["DOWNLOAD"] = "download";
+    JobStep["PARSE"] = "parse";
+    JobStep["TRANSFORM"] = "transform";
+    JobStep["SYNC"] = "sync";
+})(JobStep || (exports.JobStep = JobStep = {}));
+/**
+ * Human-readable labels for job types (Spanish for UI)
+ */
+exports.JOB_TYPE_LABELS = {
+    [JobType.SYNC_SALES]: 'Sincronizar Ventas',
+    [JobType.SYNC_PURCHASES]: 'Sincronizar Compras',
+    [JobType.SYNC_INVENTORY]: 'Sincronizar Inventario',
+    [JobType.SYNC_TRANSFERS]: 'Sincronizar Traspasos',
+    [JobType.SYNC_MOVEMENTS]: 'Sincronizar Movimientos',
+    [JobType.SYNC_STOCK_CONFIG]: 'Sincronizar Config. Stock',
+    [JobType.SYNC_CATALOG]: 'Sincronizar Catálogo',
+    [JobType.SYNC_ALL]: 'Sincronizar Todo',
+};
+/**
+ * Human-readable labels for job steps (Spanish for UI)
+ */
+exports.JOB_STEP_LABELS = {
+    [JobStep.DOWNLOAD]: 'Descargando',
+    [JobStep.PARSE]: 'Procesando archivo',
+    [JobStep.TRANSFORM]: 'Transformando datos',
+    [JobStep.SYNC]: 'Guardando en base de datos',
+};
+/**
+ * Human-readable labels for job status (Spanish for UI)
+ */
+exports.JOB_STATUS_LABELS = {
+    [JobStatus.PENDING]: 'Pendiente',
+    [JobStatus.PROCESSING]: 'En proceso',
+    [JobStatus.COMPLETED]: 'Completado',
+    [JobStatus.FAILED]: 'Fallido',
+    [JobStatus.CANCELLED]: 'Cancelado',
+};

package/dist/constants/index.d.ts

@@ -10,3 +10,4 @@ export * from './pricing-rule.constants';
 export * from './qvet-catalog';
 export * from './qvet-warehouses';
 export * from './qvet-inventory';
+export * from './background-job.constants';

package/dist/constants/index.js

@@ -26,3 +26,4 @@ __exportStar(require("./pricing-rule.constants"), exports);
 __exportStar(require("./qvet-catalog"), exports);
 __exportStar(require("./qvet-warehouses"), exports);
 __exportStar(require("./qvet-inventory"), exports);
+__exportStar(require("./background-job.constants"), exports);

package/dist/contracts/index.d.ts

@@ -4,3 +4,4 @@
  */
 export * from './collaborator';
 export * from './catalog-item';
+export * from './qvet';

package/dist/contracts/index.js

@@ -20,3 +20,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./collaborator"), exports);
 __exportStar(require("./catalog-item"), exports);
+__exportStar(require("./qvet"), exports);

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

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

package/dist/contracts/qvet/index.js

@@ -0,0 +1,20 @@
+"use strict";
+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 });
+/**
+ * QVET API Contracts
+ */
+__exportStar(require("./responses"), exports);

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

@@ -0,0 +1,101 @@
+/**
+ * QVET API Response Types
+ *
+ * Response interfaces for QVET data endpoints.
+ * Used by frontend to consume synced QVET data.
+ */
+/**
+ * Single sale record from QVET
+ * Represents one line item in a sale transaction
+ */
+export interface QvetSaleResponse {
+    _id: string;
+    date: string;
+    warehouse: string;
+    subtotal: number;
+    paidAmount: number;
+    total: number;
+    quantity: number;
+    discount: number;
+    debt: number;
+    taxAmount: number;
+    taxRate: number;
+    paymentMethod: string;
+    priceList: string;
+    qvetCode: number;
+    productName: string;
+    section: string;
+    family: string;
+    subfamily: string;
+    isActive: boolean;
+    hasStockControl: boolean;
+    customerName: string;
+    qvetCustomerId?: number;
+    petName?: string;
+    qvetPetId?: number;
+    sellerName: string;
+    sellerInitials?: string;
+    branch: string;
+    syncedAt: string;
+}
+/**
+ * Paginated list of sales
+ */
+export interface QvetSalesListResponse {
+    ok: boolean;
+    data: QvetSaleResponse[];
+    pagination: {
+        total: number;
+        limit: number;
+        skip: number;
+        hasMore: boolean;
+    };
+}
+/**
+ * Sales summary statistics for a period
+ */
+export interface QvetSalesSummaryResponse {
+    ok: boolean;
+    data: {
+        totalRecords: number;
+        totalSales: number;
+        totalSubtotal: number;
+        totalTax: number;
+        totalDiscount: number;
+        totalQuantity: number;
+        avgTicket: number;
+        uniqueCustomers: number;
+        uniqueProducts: number;
+    };
+}
+/**
+ * Sales by section aggregation
+ */
+export interface QvetSalesBySectionItem {
+    section: string;
+    totalSales: number;
+    totalQuantity: number;
+    recordCount: number;
+}
+export interface QvetSalesBySectionResponse {
+    ok: boolean;
+    data: QvetSalesBySectionItem[];
+}
+/**
+ * Query parameters for sales endpoint
+ */
+export interface QvetSalesQueryParams {
+    startDate?: string;
+    endDate?: string;
+    year?: number;
+    month?: number;
+    halfMonth?: 1 | 2;
+    warehouse?: string;
+    section?: string;
+    family?: string;
+    qvetCode?: number;
+    customerName?: string;
+    limit?: number;
+    skip?: number;
+    sort?: string;
+}

package/dist/contracts/qvet/responses.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * QVET API Response Types
+ *
+ * Response interfaces for QVET data endpoints.
+ * Used by frontend to consume synced QVET data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/background-job.types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Background Job Types
+ *
+ * Interfaces for background job system.
+ * Used by frontend (polling) and backend (job execution).
+ */
+import { JobStatus, JobStep, JobType } from '../constants/background-job.constants';
+/**
+ * Job progress information
+ */
+export interface JobProgress {
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Human-readable progress message */
+    progressMessage: string;
+    /** Current execution step */
+    currentStep: JobStep;
+}
+/**
+ * Job execution result
+ */
+export interface JobResult {
+    /** Total records processed */
+    recordsProcessed: number;
+    /** New records created */
+    recordsCreated: number;
+    /** Existing records updated */
+    recordsUpdated: number;
+    /** Records deleted (if applicable) */
+    recordsDeleted: number;
+    /** Non-fatal errors encountered */
+    errors: string[];
+}
+/**
+ * Job error details
+ */
+export interface JobError {
+    /** Error message */
+    message: string;
+    /** Stack trace (only in development) */
+    stack?: string;
+}
+/**
+ * Background job response (for API)
+ */
+export interface BackgroundJobResponse {
+    /** Job ID */
+    id: string;
+    /** Job type */
+    type: JobType;
+    /** Current status */
+    status: JobStatus;
+    /** Progress (0-100) */
+    progress: number;
+    /** Progress message */
+    progressMessage?: string;
+    /** Current step */
+    currentStep?: JobStep;
+    /** Job creation timestamp */
+    createdAt: string;
+    /** Job start timestamp */
+    startedAt?: string;
+    /** Job completion timestamp */
+    completedAt?: string;
+    /** Execution duration in milliseconds */
+    durationMs?: number;
+    /** Result (when completed) */
+    result?: JobResult;
+    /** Error (when failed) */
+    error?: JobError;
+}
+/**
+ * Request to create a new sync job
+ */
+export interface CreateSyncJobRequest {
+    /** Type of sync to perform */
+    type: JobType;
+    /** Optional parameters for the sync */
+    params?: Record<string, unknown>;
+}
+/**
+ * Sync status for a report type
+ */
+export interface SyncReportStatus {
+    /** Last sync job ID */
+    lastJobId?: string;
+    /** Last sync status */
+    lastStatus?: JobStatus;
+    /** Last sync timestamp */
+    lastSyncAt?: string;
+    /** Whether a sync is currently running */
+    isRunning: boolean;
+}
+/**
+ * Overall sync status response
+ */
+export interface SyncStatusResponse {
+    /** Status per report type */
+    reports: Record<string, SyncReportStatus>;
+    /** Currently running jobs */
+    runningJobs: Array<{
+        id: string;
+        type: JobType;
+        progress: number;
+        startedAt: string;
+    }>;
+}

package/dist/types/background-job.types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Background Job Types
+ *
+ * Interfaces for background job system.
+ * Used by frontend (polling) and backend (job execution).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -9,3 +9,4 @@ export * from './error-codes.types';
 export * from './sync-field.types';
 export * from './catalog-item.types';
 export * from './qvet.types';
+export * from './background-job.types';

package/dist/types/index.js

@@ -25,3 +25,4 @@ __exportStar(require("./error-codes.types"), exports);
 __exportStar(require("./sync-field.types"), exports);
 __exportStar(require("./catalog-item.types"), exports);
 __exportStar(require("./qvet.types"), exports);
+__exportStar(require("./background-job.types"), exports);

package/package.json

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