hvp-shared 6.3.0 → 6.5.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/catalog-item/requests.d.ts

@@ -3,7 +3,7 @@
  *
  * Request DTOs for catalog item endpoints.
  */
-import { UsageType, SyncStatus } from '../../constants/catalog-item.constants';
+import { UsageType, SyncStatus, StockPolicy } from '../../constants/catalog-item.constants';
 import { MarketCompetition } from '../../constants/market-competition.constants';
 import { PricingRuleCode } from '../../constants/pricing-rule.constants';
 /**
@@ -104,7 +104,11 @@ export interface UpdateCatalogItemHvpDataRequest {
     pricingRuleCode?: PricingRuleCode;
     /** Recommended price (calculated from pricing rule) */
     recommendedPrice?: number;
-    /** Flag: item requires manual stock review (algorithm doesn't apply) */
+    /** How stock levels are managed */
+    stockPolicy?: StockPolicy;
+    /** Observations generated by analysis script */
+    stockObservations?: string;
+    /** @deprecated Use stockPolicy: 'manual' instead */
     requiresManualReview?: boolean;
 }
 /**

package/dist/contracts/catalog-item/responses.d.ts

@@ -4,7 +4,7 @@
  * Response DTOs for catalog item endpoints.
  */
 import { SyncField } from '../../types/sync-field.types';
-import { UsageType, SyncStatus } from '../../constants/catalog-item.constants';
+import { UsageType, SyncStatus, StockPolicy } from '../../constants/catalog-item.constants';
 import { MarketCompetition } from '../../constants/market-competition.constants';
 import { PricingRuleCode } from '../../constants/pricing-rule.constants';
 import { Warehouse } from '../../types/qvet.types';
@@ -136,7 +136,11 @@ export interface CatalogItemDetailResponse {
          * Calculated from: cost * (1 + targetMargin/100) * (1 + VAT/100)
          */
         recommendedPrice?: number;
-        /** Flag: item requires manual stock review (algorithm doesn't apply) */
+        /** How stock levels are managed */
+        stockPolicy?: StockPolicy;
+        /** Observations generated by analysis script */
+        stockObservations?: string;
+        /** @deprecated Use stockPolicy: 'manual' instead */
         requiresManualReview?: boolean;
     };
     hasPendingChanges: boolean;

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.3.0",
+  "version": "6.5.0",
   "description": "Shared types and utilities for HVP backend and frontend",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",