@lucaapp/service-utils 5.38.0 → 5.39.0

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

@@ -1,36 +1,35 @@
 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.
+ * Final fiscalization outcome of a payment, decided by backend-tse:
+ * - `FISCALIZED`: the Kassenbeleg is final — signed with its receipt PDF
+ *   materializable, or issued in Notfallmodus.
+ * - `NOT_FISCALIZED`: backend-tse will never fiscalize this payment (a luca-web
+ *   QR / self-service payment at a location that does not fiscalize web
+ *   orders). There is no fiscal row and no Kassenbeleg.
+ */
+export type FiscalizedPaymentStatus = 'FISCALIZED' | 'NOT_FISCALIZED';
+/**
+ * Emitted by backend-tse once a payment's fiscalization outcome is final, so
+ * consumers (backend-pay) need not poll readiness. Delivery is at least once:
+ * dedupe on the envelope `id` (the fiscal payment id, or the payment id when
+ * NOT_FISCALIZED).
  */
 export type FiscalizedPayment = {
     version: FiscalizedPaymentEventVersion;
+    status: FiscalizedPaymentStatus;
     /**
-     * `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.
+     * backend-pay `V3Payment.uuid` for luca-web QR / self-service payments. Null
+     * for POS card payments (backend-tse cannot tell the real uuid from the
+     * fast-path one) and cash; resolve those via `checkoutId`.
      */
-    paymentId?: string | null;
+    paymentId: string | null;
     /**
-     * backend-pay `V3Checkout.uuid` when known. Join key when
-     * `fiscalPaymentEventId` ≠ `paymentId`.
+     * `fiscal_payment_events.id` — the key for the receipt token / PDF. Null when
+     * NOT_FISCALIZED.
      */
-    checkoutId?: string | null;
-    notfallmodus?: boolean;
-    tseSigningEventId?: string | null;
-    statusCompleteAt?: Date | null;
+    fiscalPaymentEventId: string | null;
+    locationId: string;
+    /** backend-pay `V3Checkout.uuid` for card / web payments. */
+    checkoutId: string | null;
 };

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

@@ -26,6 +26,19 @@ export type OrderEventItem = {
     tax?: number;
     subItems?: OrderEventItem[];
 };
+/**
+ * Legal / billing details of the location group, printed as the Kassenbeleg
+ * issuer for mirrored web orders (LUCA-36795).
+ */
+export type OrderEventIssuer = {
+    legalName?: string | null;
+    street?: string | null;
+    postalCode?: string | null;
+    city?: string | null;
+    country?: string | null;
+    taxNumber?: string | null;
+    vatId?: string | null;
+};
 /**
  * Emitted by backend-pay when a luca-web order is created (LUCA-36037).
  * Carries the full order snapshot so consumers can mirror it without a callback.
@@ -45,4 +58,6 @@ export type OrderEvent = {
     note: string | null;
     createdAt: Date;
     items: OrderEventItem[];
+    /** Optional so older producers and consumers keep working. */
+    issuer?: OrderEventIssuer | null;
 };

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

@@ -3,8 +3,8 @@ export { KafkaTopic } from './events';
 export type { ConversationMessage } from './events/conversationMessage';
 export type { RefundEvent } from './events/refund';
 export { REFUND_EVENT_VERSION } from './events/refund';
-export type { OrderEvent, OrderEventItem, OrderEventType, OrderEventStatus, OrderEventTranslatableName, } from './events/order';
+export type { OrderEvent, OrderEventIssuer, OrderEventItem, OrderEventType, OrderEventStatus, OrderEventTranslatableName, } from './events/order';
 export { ORDER_EVENT_VERSION } from './events/order';
-export type { FiscalizedPayment } from './events/fiscalizedPayment';
+export type { FiscalizedPayment, FiscalizedPaymentStatus, } from './events/fiscalizedPayment';
 export { FISCALIZED_PAYMENT_EVENT_VERSION } from './events/fiscalizedPayment';
 export type { KafkaEvent, GenericKafkaEvent, EventPayloadHandler, GenericEventPayloadHandler, KafkaConfiguration, CustomTopicConfig, CustomTopicPoisonContext, CustomTopicPoisonHandler, } from './types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "5.38.0",
+  "version": "5.39.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [