platform-types 1.10.804 → 1.10.806

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cart.d.ts CHANGED
@@ -193,6 +193,24 @@ declare global {
193
193
  */
194
194
  cost?: number;
195
195
  price: number;
196
+ /**
197
+ * The net of `price`, per unit, in the same currency as the line
198
+ * (`calculateItemNeto(price, 1, rate, 1, 'decimal')`): equal to the
199
+ * `neto` a new IVA-declaring invoice prints for one undiscounted unit
200
+ * when the line currency is the voucher currency. A Factura C does not
201
+ * discriminate IVA (its `ImpNeto` is the gross), and a voucher in another
202
+ * currency converts first. Absent when the
203
+ * line has no declarable `ivaType` — never a 0 % fallback.
204
+ *
205
+ * ⚠️ READ-TIME and DISPLAY ONLY. Derived at the customer exits (web
206
+ * `GET /basket`, the customer basket write echo and its 409 rebase, the
207
+ * guest cart, the checkout cart-conflict body, the storefront re-priced
208
+ * cart and the customer `baskets` socket frame); never stored, never
209
+ * accepted on a write, never on an operator copy. Never charge, quote or
210
+ * total it — `CartTotals` carries no net. Shown by the storefront only
211
+ * while `ecommerce.config.showNetPlusIva` is on.
212
+ */
213
+ netOfIva?: number;
196
214
  listId?: number;
197
215
  currency?: string;
198
216
  currencyValue?: number;
@@ -6,7 +6,8 @@ exports.WEB_NOTIFICATIONS_MAX_LIMIT = exports.CUSTOMER_NOTIFICATION_TYPES = expo
6
6
  // legacy opt-ins and explicit channel maps remain source data on USER rows.
7
7
  // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
8
8
  // ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
9
- // PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST do not select a
9
+ // PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
10
+ // REFUND_OBLIGATION_OVERDUE do not select a
10
11
  // producer subscriber audience;
11
12
  // the consumer still reads the live USER row for each delivery channel.
12
13
  // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
@@ -236,6 +237,26 @@ var NotificationTypeEnum;
236
237
  * socket).
237
238
  */
238
239
  NotificationTypeEnum["STOREFRONT_QUOTE_REQUEST"] = "STOREFRONT_QUOTE_REQUEST";
240
+ /**
241
+ * A refund obligation went overdue: its due date passed and the hourly
242
+ * sweep, after reconciling the payment, still found the money owed
243
+ * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
244
+ * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
245
+ *
246
+ * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
247
+ * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
248
+ * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
249
+ * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
250
+ * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
251
+ * default-on when absent. Additive — no backfill or consumer migration owed.
252
+ *
253
+ * Once per `open` → `overdue` move: it rings only on that committed move,
254
+ * so an obligation a reopen sent back to `open` from a hold (a lifted
255
+ * dispute, the operator's decision) rings again on its new deadline. The
256
+ * daily repeat of an obligation already `overdue` writes the
257
+ * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
258
+ */
259
+ NotificationTypeEnum["REFUND_OBLIGATION_OVERDUE"] = "REFUND_OBLIGATION_OVERDUE";
239
260
  })(NotificationTypeEnum || (exports.NotificationTypeEnum = NotificationTypeEnum = {}));
240
261
  /**
241
262
  * The notification types a CUSTOMER bell can carry today; each links through
@@ -213,7 +213,27 @@ export declare enum NotificationTypeEnum {
213
213
  * audience — the bell would reach a signed-in requester's own storefront
214
214
  * socket).
215
215
  */
216
- STOREFRONT_QUOTE_REQUEST = "STOREFRONT_QUOTE_REQUEST"
216
+ STOREFRONT_QUOTE_REQUEST = "STOREFRONT_QUOTE_REQUEST",
217
+ /**
218
+ * A refund obligation went overdue: its due date passed and the hourly
219
+ * sweep, after reconciling the payment, still found the money owed
220
+ * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
221
+ * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
222
+ *
223
+ * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
224
+ * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
225
+ * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
226
+ * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
227
+ * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
228
+ * default-on when absent. Additive — no backfill or consumer migration owed.
229
+ *
230
+ * Once per `open` → `overdue` move: it rings only on that committed move,
231
+ * so an obligation a reopen sent back to `open` from a hold (a lifted
232
+ * dispute, the operator's decision) rings again on its new deadline. The
233
+ * daily repeat of an obligation already `overdue` writes the
234
+ * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
235
+ */
236
+ REFUND_OBLIGATION_OVERDUE = "REFUND_OBLIGATION_OVERDUE"
217
237
  }
218
238
  /**
219
239
  * The notification types a CUSTOMER bell can carry today; each links through
@@ -3,7 +3,8 @@
3
3
  // legacy opt-ins and explicit channel maps remain source data on USER rows.
4
4
  // Addressed ERROR / ML_FACTURADOR_COLLISION / ML_SELLER_SWITCHED /
5
5
  // ML_CONNECTION_BROKEN / MENTION / CUSTOMER_PENDING_APPROVAL /
6
- // PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST do not select a
6
+ // PAYMENT_ATTEMPT_RESOLUTION / CUSTOMER_WHOLESALE_REQUEST / STOREFRONT_QUOTE_REQUEST /
7
+ // REFUND_OBLIGATION_OVERDUE do not select a
7
8
  // producer subscriber audience;
8
9
  // the consumer still reads the live USER row for each delivery channel.
9
10
  // AFIP_CERT_EXPIRY is seeded on the founding user and uses the subscriber index.
@@ -233,6 +234,26 @@ export var NotificationTypeEnum;
233
234
  * socket).
234
235
  */
235
236
  NotificationTypeEnum["STOREFRONT_QUOTE_REQUEST"] = "STOREFRONT_QUOTE_REQUEST";
237
+ /**
238
+ * A refund obligation went overdue: its due date passed and the hourly
239
+ * sweep, after reconciling the payment, still found the money owed
240
+ * (`open` → `overdue`). Names the order (`orderId`) in the title; the app
241
+ * opens the refund queue (`GET /refund-obligations?state=overdue`) from it.
242
+ *
243
+ * ⚠️ ADMIN-ONLY, and its own preference key. The producer fans out to every
244
+ * non-disabled ADMIN of the store (`listActiveAdmins`) — the tier that closes
245
+ * an obligation — so a client offers the `REFUND_OBLIGATION_OVERDUE` toggle
246
+ * to ADMINs only. No legacy opt-in scan: the consumer enforces explicit
247
+ * type/channel preferences (`notificationPreferences.REFUND_OBLIGATION_OVERDUE`),
248
+ * default-on when absent. Additive — no backfill or consumer migration owed.
249
+ *
250
+ * Once per `open` → `overdue` move: it rings only on that committed move,
251
+ * so an obligation a reopen sent back to `open` from a hold (a lifted
252
+ * dispute, the operator's decision) rings again on its new deadline. The
253
+ * daily repeat of an obligation already `overdue` writes the
254
+ * `REFUND_OVERDUE` ERROR row and rings nothing. Never a `customerId`.
255
+ */
256
+ NotificationTypeEnum["REFUND_OBLIGATION_OVERDUE"] = "REFUND_OBLIGATION_OVERDUE";
236
257
  })(NotificationTypeEnum || (NotificationTypeEnum = {}));
237
258
  /**
238
259
  * The notification types a CUSTOMER bell can carry today; each links through
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "platform-types",
3
- "version": "1.10.804",
3
+ "version": "1.10.806",
4
4
  "description": "Shared wire and entity contracts for the platform.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",