@lucaapp/service-utils 5.37.0 → 5.38.0

package/dist/lib/kafka/events/fiscalizedPayment.d.ts

@@ -0,0 +1,36 @@
+export declare const FISCALIZED_PAYMENT_EVENT_VERSION = 1;
+export type FiscalizedPaymentEventVersion = typeof FISCALIZED_PAYMENT_EVENT_VERSION;
+/**
+ * Emitted by backend-tse when a payment's fiscalization reaches a terminal
+ * ready state (signed and receipt PDF materializable).
+ * Consumers (e.g. backend-pay) use this instead of polling readiness.
+ *
+ * ID fields are intentionally distinct — they are not always equal:
+ * - POS checkout fast-path can create `fiscal_payment_events` under a throwaway
+ *   Kafka uuid before `V3Payment` exists; TSE then reuses that fiscal row via
+ *   `checkoutId` and does not rewrite the fiscal id to `V3Payment.uuid`.
+ * - Cash / HTTP paths often have no `V3Payment` at all.
+ */
+export type FiscalizedPayment = {
+    version: FiscalizedPaymentEventVersion;
+    /**
+     * `fiscal_payment_events.id` — TSE primary key used for receipt-token /
+     * readiness / PDF. Always present. Envelope `id` should match this.
+     */
+    fiscalPaymentEventId: string;
+    locationId: string;
+    /**
+     * backend-pay `V3Payment.uuid` when TSE knows it (settled Kafka card/web
+     * path). May differ from `fiscalPaymentEventId` after fast-path reuse.
+     * Absent for cash / when only a throwaway Kafka uuid was seen.
+     */
+    paymentId?: string | null;
+    /**
+     * backend-pay `V3Checkout.uuid` when known. Join key when
+     * `fiscalPaymentEventId` ≠ `paymentId`.
+     */
+    checkoutId?: string | null;
+    notfallmodus?: boolean;
+    tseSigningEventId?: string | null;
+    statusCompleteAt?: Date | null;
+};

package/dist/lib/kafka/events/fiscalizedPayment.js

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

package/dist/lib/kafka/events/refund.d.ts

@@ -29,4 +29,6 @@ export type RefundEvent = {
     method?: string | null;
     /** Optional on the wire for in-flight events produced before this field existed. */
     reason?: string | null;
+    /** Operator who confirmed the refund; optional so older producers and consumers keep working. */
+    performedBy?: string | null;
 };

package/dist/lib/kafka/events.d.ts

@@ -1,6 +1,7 @@
 import type { Payment, PaymentEvent } from './events/payment';
 import type { OrderEvent } from './events/order';
 import type { RefundEvent } from './events/refund';
+import type { FiscalizedPayment } from './events/fiscalizedPayment';
 import type { Consumer } from './events/consumer';
 import type { Operator } from './events/operator';
 import type { LocationGroupEmployees } from './events/locationGroupEmployees';
@@ -23,6 +24,7 @@ declare enum KafkaTopic {
     PAYMENTS = "payments",
     ORDERS = "orders",
     REFUNDS = "refunds",
+    FISCALIZED_PAYMENTS = "fiscalized_payments",
     CONSUMERS = "consumers",
     OPERATORS = "operators",
     OPERATORS_PAY = "operators_pay",
@@ -48,6 +50,7 @@ type MessageFormats = {
     [KafkaTopic.PAYMENTS]: Payment | PaymentEvent;
     [KafkaTopic.ORDERS]: OrderEvent;
     [KafkaTopic.REFUNDS]: RefundEvent;
+    [KafkaTopic.FISCALIZED_PAYMENTS]: FiscalizedPayment;
     [KafkaTopic.CONSUMERS]: Consumer;
     [KafkaTopic.OPERATORS]: Operator;
     [KafkaTopic.OPERATORS_PAY]: OperatorPay;
@@ -73,6 +76,7 @@ declare const MessageIssuer: {
     payments: Service;
     orders: Service;
     refunds: Service;
+    fiscalized_payments: Service;
     consumers: Service;
     operators: Service;
     operator_devices: Service;

package/dist/lib/kafka/events.js

@@ -7,6 +7,7 @@ var KafkaTopic;
     KafkaTopic["PAYMENTS"] = "payments";
     KafkaTopic["ORDERS"] = "orders";
     KafkaTopic["REFUNDS"] = "refunds";
+    KafkaTopic["FISCALIZED_PAYMENTS"] = "fiscalized_payments";
     KafkaTopic["CONSUMERS"] = "consumers";
     KafkaTopic["OPERATORS"] = "operators";
     KafkaTopic["OPERATORS_PAY"] = "operators_pay";
@@ -32,6 +33,7 @@ const MessageIssuer = {
     [KafkaTopic.PAYMENTS]: serviceIdentity_1.Service.BACKEND_PAY,
     [KafkaTopic.ORDERS]: serviceIdentity_1.Service.BACKEND_PAY,
     [KafkaTopic.REFUNDS]: serviceIdentity_1.Service.BACKEND_PAY,
+    [KafkaTopic.FISCALIZED_PAYMENTS]: serviceIdentity_1.Service.BACKEND_TSE,
     [KafkaTopic.CONSUMERS]: serviceIdentity_1.Service.BACKEND,
     [KafkaTopic.OPERATORS]: serviceIdentity_1.Service.BACKEND,
     [KafkaTopic.OPERATOR_DEVICES]: serviceIdentity_1.Service.BACKEND,

package/dist/lib/kafka/index.d.ts

@@ -5,4 +5,6 @@ export type { RefundEvent } from './events/refund';
 export { REFUND_EVENT_VERSION } from './events/refund';
 export type { OrderEvent, OrderEventItem, OrderEventType, OrderEventStatus, OrderEventTranslatableName, } from './events/order';
 export { ORDER_EVENT_VERSION } from './events/order';
+export type { FiscalizedPayment } from './events/fiscalizedPayment';
+export { FISCALIZED_PAYMENT_EVENT_VERSION } from './events/fiscalizedPayment';
 export type { KafkaEvent, GenericKafkaEvent, EventPayloadHandler, GenericEventPayloadHandler, KafkaConfiguration, CustomTopicConfig, CustomTopicPoisonContext, CustomTopicPoisonHandler, } from './types';

package/dist/lib/kafka/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ORDER_EVENT_VERSION = exports.REFUND_EVENT_VERSION = exports.KafkaTopic = exports.KafkaClient = void 0;
+exports.FISCALIZED_PAYMENT_EVENT_VERSION = exports.ORDER_EVENT_VERSION = exports.REFUND_EVENT_VERSION = exports.KafkaTopic = exports.KafkaClient = void 0;
 var kafkaClient_1 = require("./kafkaClient");
 Object.defineProperty(exports, "KafkaClient", { enumerable: true, get: function () { return kafkaClient_1.KafkaClient; } });
 var events_1 = require("./events");
@@ -9,3 +9,5 @@ var refund_1 = require("./events/refund");
 Object.defineProperty(exports, "REFUND_EVENT_VERSION", { enumerable: true, get: function () { return refund_1.REFUND_EVENT_VERSION; } });
 var order_1 = require("./events/order");
 Object.defineProperty(exports, "ORDER_EVENT_VERSION", { enumerable: true, get: function () { return order_1.ORDER_EVENT_VERSION; } });
+var fiscalizedPayment_1 = require("./events/fiscalizedPayment");
+Object.defineProperty(exports, "FISCALIZED_PAYMENT_EVENT_VERSION", { enumerable: true, get: function () { return fiscalizedPayment_1.FISCALIZED_PAYMENT_EVENT_VERSION; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "5.37.0",
+  "version": "5.38.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -30,7 +30,7 @@
     "@types/response-time": "^2.3.9",
     "@types/swagger-ui-express": "4.1.8",
     "@types/validator": "13.7.1",
-    "axios": "1.18.0",
+    "axios": "1.20.0",
     "axios-rate-limit": "^1.4.0",
     "axios-retry": "^4.5.0",
     "body-parser": "1.20.6",
@@ -82,7 +82,7 @@
     "typescript": "npm:@typescript/typescript6@6.0.2",
     "vite-tsconfig-paths": "4.3.2",
     "vitest": "4.1.1",
-    "yarn-osv-audit": "0.1.8"
+    "yarn-osv-audit": "1.0.0"
   },
   "peerDependencies": {
     "@sentry/node": "^9.10.1",
@@ -111,13 +111,14 @@
     "node-forge": "1.4.0",
     "uuid": "^14.0.0",
     "follow-redirects": "^1.16.0",
-    "axios": "1.18.0",
+    "axios": "1.20.0",
     "path-to-regexp": "0.1.13",
-    "ip-address": "10.5.1",
+    "ip-address": "10.7.2",
     "fast-xml-builder": "^1.1.7",
-    "brace-expansion": "2.1.4",
+    "brace-expansion": "2.1.7",
     "form-data": "4.0.6",
     "js-yaml": "4.3.2",
-    "@opentelemetry/core": "2.8.0"
+    "@opentelemetry/core": "2.8.0",
+    "proxy-addr": "2.0.8"
   }
 }