@zauru-sdk/common 6.4.1 → 6.5.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [6.5.0](https://github.com/intuitiva/zauru-typescript-sdk/compare/@zauru-sdk/common@6.4.1...@zauru-sdk/common@6.5.0) (2026-09-14)
+
+
+### Features
+
+* apply rejection percentage rules when saving PO discounts ([2b44998](https://github.com/intuitiva/zauru-typescript-sdk/commit/2b44998241e3b25d2a0d98a1c7f83a21b21cc265))
+
+
+
+
+
 ## [6.4.1](https://github.com/intuitiva/zauru-typescript-sdk/compare/@zauru-sdk/common@6.4.0...@zauru-sdk/common@6.4.1) (2026-09-14)
 
 **Note:** Version bump only for package @zauru-sdk/common

package/dist/esm/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common.js"), exports);
 __exportStar(require("./gtZones.js"), exports);
+__exportStar(require("./rejectionPercentageAdjustment.js"), exports);

package/dist/esm/rejectionPercentageAdjustment.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRejectionPercentageRulesToFinancials = exports.applyRejectionPercentageAdjustmentRules = exports.resolveRejectionPercentageBase = exports.resolveRejectionPercentageOrigin = exports.formatRejectionPercentageAdjustmentDescription = exports.rejectionPercentageAdjustmentRuleMatches = exports.filterActiveRejectionPercentageAdjustmentRules = exports.REJECTION_PERCENTAGE_ADJUSTMENT_RULES_TABLE_VAR = void 0;
+const common_js_1 = require("./common.js");
+exports.REJECTION_PERCENTAGE_ADJUSTMENT_RULES_TABLE_VAR = "rejection_percentage_adjustment_rules_web_app_table_id";
+const defaultFilters = () => ({
+    itemMode: "all",
+    itemIds: [],
+    tipoMode: "all",
+    tipos: [],
+    programaMode: "all",
+    providerCategoryIds: [],
+});
+const normalizeComparableValue = (value) => String(value ?? "").replace(/\s+/g, " ").trim();
+const matchesFilter = (mode, selected, value) => {
+    const normalizedMode = mode ?? "all";
+    const values = selected ?? [];
+    if (normalizedMode === "all") {
+        return true;
+    }
+    if (value === undefined || value === null) {
+        return false;
+    }
+    const asString = normalizeComparableValue(value);
+    if (!asString) {
+        return false;
+    }
+    const included = values.some((item) => normalizeComparableValue(item) === asString);
+    if (normalizedMode === "include") {
+        return values.length > 0 && included;
+    }
+    return !included;
+};
+const filterActiveRejectionPercentageAdjustmentRules = (rules) => (rules ?? [])
+    .filter((rule) => !rule.data?.fechaEliminacion && rule.data?.activa !== false)
+    .sort((a, b) => (a.data?.prioridad ?? 0) - (b.data?.prioridad ?? 0) || a.id - b.id);
+exports.filterActiveRejectionPercentageAdjustmentRules = filterActiveRejectionPercentageAdjustmentRules;
+const rejectionPercentageAdjustmentRuleMatches = (rule, ctx) => {
+    const filtros = rule.filtros ?? defaultFilters();
+    const itemIds = ctx.itemIds ?? [];
+    const tipoAndPrograma = matchesFilter(filtros.tipoMode, filtros.tipos, ctx.tipo) &&
+        matchesFilter(filtros.programaMode, filtros.providerCategoryIds, ctx.providerCategoryId);
+    if (!tipoAndPrograma) {
+        return false;
+    }
+    if (filtros.itemMode === "all") {
+        return true;
+    }
+    if (itemIds.length === 0) {
+        return false;
+    }
+    return itemIds.some((itemId) => matchesFilter(filtros.itemMode, filtros.itemIds, itemId));
+};
+exports.rejectionPercentageAdjustmentRuleMatches = rejectionPercentageAdjustmentRuleMatches;
+const roundPercentage = (value, digits = 4) => {
+    const factor = 10 ** digits;
+    return Math.round((value + Number.EPSILON) * factor) / factor;
+};
+const clampPercentage = (value) => Math.min(100, Math.max(0, value));
+const formatPercentage = (value) => Number.isInteger(value) ? String(value) : String(roundPercentage(value));
+const formatFinalPercentage = (value) => roundPercentage(value, 2).toFixed(2);
+const formatRuleEffect = (step) => {
+    const sign = step.operation === "subtract" ? "-" : "+";
+    return `${sign} ${formatPercentage(step.value)}% (${step.ruleName})`;
+};
+const formatRejectionPercentageAdjustmentDescription = (result, baseLabel = "origen") => {
+    const base = `${formatPercentage(result.basePercentage)} (${baseLabel})`;
+    if (result.steps.length === 0) {
+        return base;
+    }
+    return `${base} ${result.steps.map(formatRuleEffect).join(" ")} = ${formatFinalPercentage(result.finalPercentage)}`;
+};
+exports.formatRejectionPercentageAdjustmentDescription = formatRejectionPercentageAdjustmentDescription;
+const resolveRejectionPercentageOrigin = (passedPercentage, memo) => {
+    const parsed = (0, common_js_1.parseJsonMemo)(memo);
+    const passed = clampPercentage(Number.isFinite(Number(passedPercentage)) ? Number(passedPercentage) : 0);
+    const calc = parsed.rejectionCalculations;
+    if (!calc || !Number.isFinite(Number(calc.finalPercentage))) {
+        return passed;
+    }
+    const previousFinal = roundPercentage(Number(calc.finalPercentage), 2);
+    const previousBase = Number(calc.basePercentage);
+    const safePreviousBase = Number.isFinite(previousBase)
+        ? clampPercentage(previousBase)
+        : passed;
+    if (roundPercentage(passed, 2) === previousFinal) {
+        return safePreviousBase;
+    }
+    return clampPercentage(safePreviousBase + (passed - previousFinal));
+};
+exports.resolveRejectionPercentageOrigin = resolveRejectionPercentageOrigin;
+const resolveRejectionPercentageBase = (memo) => (0, exports.resolveRejectionPercentageOrigin)((0, common_js_1.getRejectionPercentage)(memo), memo);
+exports.resolveRejectionPercentageBase = resolveRejectionPercentageBase;
+const applyRejectionPercentageAdjustmentRules = (basePercentage, rules, ctx) => {
+    const start = Number(basePercentage);
+    const safeBase = Number.isFinite(start) ? clampPercentage(start) : 0;
+    let runningTotal = safeBase;
+    const steps = [];
+    const normalized = rules
+        .map((rule) => ("data" in rule ? rule.data : rule))
+        .filter((rule) => Boolean(rule))
+        .filter((rule) => !rule.fechaEliminacion && rule.activa !== false)
+        .sort((a, b) => (a.prioridad ?? 0) - (b.prioridad ?? 0));
+    for (const rule of normalized) {
+        if (!(0, exports.rejectionPercentageAdjustmentRuleMatches)(rule, ctx)) {
+            continue;
+        }
+        const value = Number(rule.valor) || 0;
+        const previous = runningTotal;
+        runningTotal =
+            rule.operacion === "subtract" ? previous - value : previous + value;
+        runningTotal = clampPercentage(roundPercentage(runningTotal));
+        steps.push({
+            ruleName: rule.nombre,
+            operation: rule.operacion,
+            value,
+            appliedAmount: roundPercentage(runningTotal - previous),
+            runningTotal,
+        });
+    }
+    const result = {
+        basePercentage: roundPercentage(safeBase),
+        finalPercentage: roundPercentage(runningTotal, 2),
+        description: "",
+        steps,
+    };
+    result.description = (0, exports.formatRejectionPercentageAdjustmentDescription)(result);
+    return result;
+};
+exports.applyRejectionPercentageAdjustmentRules = applyRejectionPercentageAdjustmentRules;
+const applyRejectionPercentageRulesToFinancials = (input) => {
+    const origin = (0, exports.resolveRejectionPercentageOrigin)(input.originPercentage, input.memo);
+    const result = (0, exports.applyRejectionPercentageAdjustmentRules)(origin, input.rules, input.ctx);
+    const { discount } = (0, common_js_1.calculatePurchaseOrderFinancials)({
+        details: input.details,
+        rejectionPercentage: result.finalPercentage,
+    });
+    return {
+        memo: (0, common_js_1.mergeJsonMemo)(input.memo, {
+            rejectionPercentage: result.finalPercentage,
+            rejectionCalculations: {
+                basePercentage: result.basePercentage,
+                finalPercentage: result.finalPercentage,
+                description: result.description,
+                steps: result.steps,
+            },
+        }),
+        discount,
+        finalPercentage: result.finalPercentage,
+    };
+};
+exports.applyRejectionPercentageRulesToFinancials = applyRejectionPercentageRulesToFinancials;

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./common.js";
 export * from "./gtZones.js";
+export * from "./rejectionPercentageAdjustment.js";

package/dist/rejectionPercentageAdjustment.d.ts

@@ -0,0 +1,19 @@
+import type { PurchaseOrderFinancialDetail, RejectionPercentageAdjustmentContext, RejectionPercentageAdjustmentResult, RejectionPercentageAdjustmentRule, WebAppRowGraphQL } from "@zauru-sdk/types";
+export declare const REJECTION_PERCENTAGE_ADJUSTMENT_RULES_TABLE_VAR = "rejection_percentage_adjustment_rules_web_app_table_id";
+export declare const filterActiveRejectionPercentageAdjustmentRules: (rules?: WebAppRowGraphQL<RejectionPercentageAdjustmentRule>[]) => WebAppRowGraphQL<RejectionPercentageAdjustmentRule>[];
+export declare const rejectionPercentageAdjustmentRuleMatches: (rule: RejectionPercentageAdjustmentRule, ctx: RejectionPercentageAdjustmentContext) => boolean;
+export declare const formatRejectionPercentageAdjustmentDescription: (result: Pick<RejectionPercentageAdjustmentResult, "basePercentage" | "finalPercentage" | "steps">, baseLabel?: string) => string;
+export declare const resolveRejectionPercentageOrigin: (passedPercentage: number, memo?: string | object) => number;
+export declare const resolveRejectionPercentageBase: (memo?: string | object) => number;
+export declare const applyRejectionPercentageAdjustmentRules: (basePercentage: number, rules: Array<RejectionPercentageAdjustmentRule | WebAppRowGraphQL<RejectionPercentageAdjustmentRule>>, ctx: RejectionPercentageAdjustmentContext) => RejectionPercentageAdjustmentResult;
+export declare const applyRejectionPercentageRulesToFinancials: (input: {
+    memo?: string | object;
+    originPercentage: number;
+    details: PurchaseOrderFinancialDetail[];
+    rules: Array<RejectionPercentageAdjustmentRule | WebAppRowGraphQL<RejectionPercentageAdjustmentRule>>;
+    ctx: RejectionPercentageAdjustmentContext;
+}) => {
+    memo: string;
+    discount: number;
+    finalPercentage: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zauru-sdk/common",
-  "version": "6.4.1",
+  "version": "6.5.0",
   "description": "Funciones de uso común en el desarrollo de webapps en Zauru",
   "main": "./dist/esm/index.js",
   "module": "./dist/esm/index.js",
@@ -25,5 +25,5 @@
     "moment": "^2.30.1",
     "moment-timezone": "^0.5.45"
   },
-  "gitHead": "ab1ff7197a4688c0e887942b4e7a1f6b729a510e"
+  "gitHead": "2dceb781cae3f4c45ceecb915977c6d142bca6b9"
 }

package/src/index.ts

@@ -1,2 +1,3 @@
 export * from "./common.js";
 export * from "./gtZones.js";
+export * from "./rejectionPercentageAdjustment.js";

package/src/rejectionPercentageAdjustment.ts

@@ -0,0 +1,258 @@
+import type {
+  PriceAdjustmentFilterMode,
+  PriceAdjustmentFilters,
+  PurchaseOrderFinancialDetail,
+  RejectionPercentageAdjustmentContext,
+  RejectionPercentageAdjustmentResult,
+  RejectionPercentageAdjustmentRule,
+  RejectionPercentageAdjustmentStep,
+  WebAppRowGraphQL,
+} from "@zauru-sdk/types";
+import {
+  calculatePurchaseOrderFinancials,
+  getRejectionPercentage,
+  mergeJsonMemo,
+  parseJsonMemo,
+} from "./common.js";
+
+export const REJECTION_PERCENTAGE_ADJUSTMENT_RULES_TABLE_VAR =
+  "rejection_percentage_adjustment_rules_web_app_table_id";
+
+const defaultFilters = (): PriceAdjustmentFilters => ({
+  itemMode: "all",
+  itemIds: [],
+  tipoMode: "all",
+  tipos: [],
+  programaMode: "all",
+  providerCategoryIds: [],
+});
+
+const normalizeComparableValue = (
+  value: string | number | undefined | null,
+): string => String(value ?? "").replace(/\s+/g, " ").trim();
+
+const matchesFilter = (
+  mode: PriceAdjustmentFilterMode | undefined,
+  selected: Array<string | number> | undefined,
+  value: string | number | undefined,
+): boolean => {
+  const normalizedMode = mode ?? "all";
+  const values = selected ?? [];
+
+  if (normalizedMode === "all") {
+    return true;
+  }
+
+  if (value === undefined || value === null) {
+    return false;
+  }
+
+  const asString = normalizeComparableValue(value);
+  if (!asString) {
+    return false;
+  }
+
+  const included = values.some(
+    (item) => normalizeComparableValue(item) === asString,
+  );
+
+  if (normalizedMode === "include") {
+    return values.length > 0 && included;
+  }
+
+  return !included;
+};
+
+export const filterActiveRejectionPercentageAdjustmentRules = (
+  rules?: WebAppRowGraphQL<RejectionPercentageAdjustmentRule>[],
+) =>
+  (rules ?? [])
+    .filter(
+      (rule) => !rule.data?.fechaEliminacion && rule.data?.activa !== false,
+    )
+    .sort(
+      (a, b) =>
+        (a.data?.prioridad ?? 0) - (b.data?.prioridad ?? 0) || a.id - b.id,
+    );
+
+export const rejectionPercentageAdjustmentRuleMatches = (
+  rule: RejectionPercentageAdjustmentRule,
+  ctx: RejectionPercentageAdjustmentContext,
+): boolean => {
+  const filtros = rule.filtros ?? defaultFilters();
+  const itemIds = ctx.itemIds ?? [];
+
+  const tipoAndPrograma =
+    matchesFilter(filtros.tipoMode, filtros.tipos, ctx.tipo) &&
+    matchesFilter(
+      filtros.programaMode,
+      filtros.providerCategoryIds,
+      ctx.providerCategoryId,
+    );
+
+  if (!tipoAndPrograma) {
+    return false;
+  }
+
+  if (filtros.itemMode === "all") {
+    return true;
+  }
+
+  if (itemIds.length === 0) {
+    return false;
+  }
+
+  return itemIds.some((itemId) =>
+    matchesFilter(filtros.itemMode, filtros.itemIds, itemId),
+  );
+};
+
+const roundPercentage = (value: number, digits = 4) => {
+  const factor = 10 ** digits;
+  return Math.round((value + Number.EPSILON) * factor) / factor;
+};
+
+const clampPercentage = (value: number) => Math.min(100, Math.max(0, value));
+
+const formatPercentage = (value: number) =>
+  Number.isInteger(value) ? String(value) : String(roundPercentage(value));
+
+const formatFinalPercentage = (value: number) =>
+  roundPercentage(value, 2).toFixed(2);
+
+const formatRuleEffect = (step: RejectionPercentageAdjustmentStep) => {
+  const sign = step.operation === "subtract" ? "-" : "+";
+  return `${sign} ${formatPercentage(step.value)}% (${step.ruleName})`;
+};
+
+export const formatRejectionPercentageAdjustmentDescription = (
+  result: Pick<
+    RejectionPercentageAdjustmentResult,
+    "basePercentage" | "finalPercentage" | "steps"
+  >,
+  baseLabel = "origen",
+): string => {
+  const base = `${formatPercentage(result.basePercentage)} (${baseLabel})`;
+  if (result.steps.length === 0) {
+    return base;
+  }
+  return `${base} ${result.steps.map(formatRuleEffect).join(" ")} = ${formatFinalPercentage(result.finalPercentage)}`;
+};
+
+export const resolveRejectionPercentageOrigin = (
+  passedPercentage: number,
+  memo?: string | object,
+): number => {
+  const parsed = parseJsonMemo(memo);
+  const passed = clampPercentage(
+    Number.isFinite(Number(passedPercentage)) ? Number(passedPercentage) : 0,
+  );
+  const calc = parsed.rejectionCalculations;
+  if (!calc || !Number.isFinite(Number(calc.finalPercentage))) {
+    return passed;
+  }
+
+  const previousFinal = roundPercentage(Number(calc.finalPercentage), 2);
+  const previousBase = Number(calc.basePercentage);
+  const safePreviousBase = Number.isFinite(previousBase)
+    ? clampPercentage(previousBase)
+    : passed;
+
+  if (roundPercentage(passed, 2) === previousFinal) {
+    return safePreviousBase;
+  }
+
+  return clampPercentage(safePreviousBase + (passed - previousFinal));
+};
+
+export const resolveRejectionPercentageBase = (
+  memo?: string | object,
+): number =>
+  resolveRejectionPercentageOrigin(getRejectionPercentage(memo), memo);
+
+export const applyRejectionPercentageAdjustmentRules = (
+  basePercentage: number,
+  rules: Array<
+    | RejectionPercentageAdjustmentRule
+    | WebAppRowGraphQL<RejectionPercentageAdjustmentRule>
+  >,
+  ctx: RejectionPercentageAdjustmentContext,
+): RejectionPercentageAdjustmentResult => {
+  const start = Number(basePercentage);
+  const safeBase = Number.isFinite(start) ? clampPercentage(start) : 0;
+  let runningTotal = safeBase;
+  const steps: RejectionPercentageAdjustmentStep[] = [];
+
+  const normalized = rules
+    .map((rule) => ("data" in rule ? rule.data : rule))
+    .filter((rule): rule is RejectionPercentageAdjustmentRule => Boolean(rule))
+    .filter((rule) => !rule.fechaEliminacion && rule.activa !== false)
+    .sort((a, b) => (a.prioridad ?? 0) - (b.prioridad ?? 0));
+
+  for (const rule of normalized) {
+    if (!rejectionPercentageAdjustmentRuleMatches(rule, ctx)) {
+      continue;
+    }
+
+    const value = Number(rule.valor) || 0;
+    const previous = runningTotal;
+    runningTotal =
+      rule.operacion === "subtract" ? previous - value : previous + value;
+    runningTotal = clampPercentage(roundPercentage(runningTotal));
+    steps.push({
+      ruleName: rule.nombre,
+      operation: rule.operacion,
+      value,
+      appliedAmount: roundPercentage(runningTotal - previous),
+      runningTotal,
+    });
+  }
+
+  const result: RejectionPercentageAdjustmentResult = {
+    basePercentage: roundPercentage(safeBase),
+    finalPercentage: roundPercentage(runningTotal, 2),
+    description: "",
+    steps,
+  };
+  result.description = formatRejectionPercentageAdjustmentDescription(result);
+  return result;
+};
+
+export const applyRejectionPercentageRulesToFinancials = (input: {
+  memo?: string | object;
+  originPercentage: number;
+  details: PurchaseOrderFinancialDetail[];
+  rules: Array<
+    | RejectionPercentageAdjustmentRule
+    | WebAppRowGraphQL<RejectionPercentageAdjustmentRule>
+  >;
+  ctx: RejectionPercentageAdjustmentContext;
+}): { memo: string; discount: number; finalPercentage: number } => {
+  const origin = resolveRejectionPercentageOrigin(
+    input.originPercentage,
+    input.memo,
+  );
+  const result = applyRejectionPercentageAdjustmentRules(
+    origin,
+    input.rules,
+    input.ctx,
+  );
+  const { discount } = calculatePurchaseOrderFinancials({
+    details: input.details,
+    rejectionPercentage: result.finalPercentage,
+  });
+
+  return {
+    memo: mergeJsonMemo(input.memo, {
+      rejectionPercentage: result.finalPercentage,
+      rejectionCalculations: {
+        basePercentage: result.basePercentage,
+        finalPercentage: result.finalPercentage,
+        description: result.description,
+        steps: result.steps,
+      },
+    }),
+    discount,
+    finalPercentage: result.finalPercentage,
+  };
+};