platform-types 1.10.739 → 1.10.741

package/dist/auth.d.ts

@@ -112,7 +112,8 @@ declare global {
          * First-touch acquisition captured by the registration client; the api
          * server-stamps `capturedAt`.
          *
-         * ⚠️ A STRICT allow-list, not a tracking bag. An unknown key (`gclid`,
+         * ⚠️ A STRICT allow-list, not a tracking bag. `fbclid` (Meta's ad click
+         * id) is the ONE click id accepted; any other unknown key (`gclid`,
          * `utm_term`, a raw referrer, a client-sent `capturedAt`) refuses the WHOLE
          * registration. Send all three required keys or omit the object entirely.
          */

package/dist/cjs/supplier.js

@@ -28,6 +28,23 @@ exports.DEFAULT_PURCHASE_MATCH_TOLERANCE = Object.freeze({ pct: 1 });
  *   store's, or a receipt is not under it.
  * - `PURCHASE_ORDER_NOT_RECEIVABLE` · 409 — the purchase order is `draft` or
  *   `cancelled`.
+ * - `RECEIPT_ALREADY_BILLED` · 409 — a receipt the bill names is already
+ *   covered by another bill (`PurchaseReceipt.billedBy`); `data.receiptIds`
+ *   lists them. Nothing is written.
+ * - `SUPPLIER_INVOICE_EDIT_CONFLICT` · 409 — an edit of a bill that stores or
+ *   writes `receiptIds` (an empty list included) lost to another edit of the
+ *   same bill that landed first and moved only the row version (when the
+ *   `fce` block, the PDF or the payments moved too, that guard's own code
+ *   answers); or a receipt the edit stops naming changed hands since the read;
+ *   or the save met another transaction on the bill or one of its receipts
+ *   in flight, and again on its one retry. Nothing is written; re-read the
+ *   bill and retry.
+ * - `BILL_RECEIPT_CHANGE_TOO_LARGE` · 400 — the receipts the save would mark
+ *   and unmark, plus the bill row, exceed one DynamoDB transaction (100
+ *   items). Nothing is written; save the receipts in smaller steps.
+ * - `PURCHASE_RECEIPTS_READ_TRUNCATED` · 503 — the purchase order's receipt
+ *   read was cut short, so the receipts to mark and the verdict cannot be
+ *   decided. Nothing is written.
  * - `PURCHASE_ORDER_SUPPLIER_MISMATCH` · 400 — the bill's supplier is not the
  *   purchase order's.
  * - `ADMIN_REQUIRED` · 403 — only ADMIN or MANAGER may override.
@@ -40,11 +57,15 @@ exports.DEFAULT_PURCHASE_MATCH_TOLERANCE = Object.freeze({ pct: 1 });
  *   purchase-order line the bill's order does not have, one whose `productId`
  *   differs, one another bill line already names, or names one with no
  *   purchase order on the bill.
- * - `VALIDATION_FAILED` · 400
+ * - `VALIDATION_FAILED` · 400 — includes `receiptIds` naming one receipt twice.
  */
 exports.SUPPLIER_INVOICE_MATCH_ERROR_CODES = [
     'RECEIPT_NOT_ON_PURCHASE_ORDER',
     'PURCHASE_ORDER_NOT_RECEIVABLE',
+    'RECEIPT_ALREADY_BILLED',
+    'SUPPLIER_INVOICE_EDIT_CONFLICT',
+    'BILL_RECEIPT_CHANGE_TOO_LARGE',
+    'PURCHASE_RECEIPTS_READ_TRUNCATED',
     'PURCHASE_ORDER_SUPPLIER_MISMATCH',
     'ADMIN_REQUIRED',
     'SUPPLIER_INVOICE_NOT_FOUND',

package/dist/purchaseReceipt.d.ts

@@ -100,6 +100,15 @@ declare global {
         warehouseId?: string;
         /** Operator note. ⚠️ Never personal data — this row is not scrubbed and has no TTL. */
         notes?: string;
+        /**
+         * SERVER-OWNED. The `invoiceId` of the vendor bill that covers this receipt.
+         * Set and cleared only by the vendor-bill writer (`POST /suppliers
+         * { mode: 'invoice' }`), in the same transaction as that bill's row and
+         * under a condition that refuses a second bill (`409 RECEIPT_ALREADY_BILLED`);
+         * never read from a request body. Absent on a receipt no bill covers, and on
+         * receipts billed before the marker existed.
+         */
+        billedBy?: string;
         items: PurchaseReceiptItem[];
     }
     /** The fields every receipt line carries, whichever quantity and cost it names. */

package/dist/store.d.ts

@@ -346,6 +346,13 @@ declare global {
         medium: string;
         campaign: string;
         content?: string;
+        /**
+         * Meta's ad click id (the `fbclid` URL parameter), present only when the
+         * sign-up arrived from a Meta ad. Case-sensitive: stored and sent to Meta
+         * byte-for-byte. Trimmed, then 1–500 characters of `[A-Za-z0-9_-]`; only
+         * ever present together with the required UTM keys above.
+         */
+        fbclid?: string;
         /** Unix ms, stamped by the api from the registration timestamp. */
         capturedAt: number;
     }

package/dist/supplier.d.ts

@@ -215,7 +215,10 @@ declare global {
         /**
          * The receipts this bill covers, each under `purchaseOrderId`. When a write
          * names a purchase order and no receipts, the server stores every receipt
-         * that order had at that moment.
+         * that order had at that moment and no other bill covers. At most one
+         * bill covers a receipt: each one named is marked with this bill's id
+         * (`PurchaseReceipt.billedBy`), and one another bill already covers is
+         * `409 RECEIPT_ALREADY_BILLED`.
          */
         receiptIds?: string[];
         /**
@@ -584,6 +587,23 @@ export declare const DEFAULT_PURCHASE_MATCH_TOLERANCE: Readonly<PurchaseMatchTol
  *   store's, or a receipt is not under it.
  * - `PURCHASE_ORDER_NOT_RECEIVABLE` · 409 — the purchase order is `draft` or
  *   `cancelled`.
+ * - `RECEIPT_ALREADY_BILLED` · 409 — a receipt the bill names is already
+ *   covered by another bill (`PurchaseReceipt.billedBy`); `data.receiptIds`
+ *   lists them. Nothing is written.
+ * - `SUPPLIER_INVOICE_EDIT_CONFLICT` · 409 — an edit of a bill that stores or
+ *   writes `receiptIds` (an empty list included) lost to another edit of the
+ *   same bill that landed first and moved only the row version (when the
+ *   `fce` block, the PDF or the payments moved too, that guard's own code
+ *   answers); or a receipt the edit stops naming changed hands since the read;
+ *   or the save met another transaction on the bill or one of its receipts
+ *   in flight, and again on its one retry. Nothing is written; re-read the
+ *   bill and retry.
+ * - `BILL_RECEIPT_CHANGE_TOO_LARGE` · 400 — the receipts the save would mark
+ *   and unmark, plus the bill row, exceed one DynamoDB transaction (100
+ *   items). Nothing is written; save the receipts in smaller steps.
+ * - `PURCHASE_RECEIPTS_READ_TRUNCATED` · 503 — the purchase order's receipt
+ *   read was cut short, so the receipts to mark and the verdict cannot be
+ *   decided. Nothing is written.
  * - `PURCHASE_ORDER_SUPPLIER_MISMATCH` · 400 — the bill's supplier is not the
  *   purchase order's.
  * - `ADMIN_REQUIRED` · 403 — only ADMIN or MANAGER may override.
@@ -596,9 +616,9 @@ export declare const DEFAULT_PURCHASE_MATCH_TOLERANCE: Readonly<PurchaseMatchTol
  *   purchase-order line the bill's order does not have, one whose `productId`
  *   differs, one another bill line already names, or names one with no
  *   purchase order on the bill.
- * - `VALIDATION_FAILED` · 400
+ * - `VALIDATION_FAILED` · 400 — includes `receiptIds` naming one receipt twice.
  */
-export declare const SUPPLIER_INVOICE_MATCH_ERROR_CODES: readonly ["RECEIPT_NOT_ON_PURCHASE_ORDER", "PURCHASE_ORDER_NOT_RECEIVABLE", "PURCHASE_ORDER_SUPPLIER_MISMATCH", "ADMIN_REQUIRED", "SUPPLIER_INVOICE_NOT_FOUND", "SUPPLIER_INVOICE_MATCH_NOT_EXCEPTION", "INVOICE_LINES_TOTAL_MISMATCH", "INVOICE_LINE_NOT_ON_PURCHASE_ORDER", "VALIDATION_FAILED"];
+export declare const SUPPLIER_INVOICE_MATCH_ERROR_CODES: readonly ["RECEIPT_NOT_ON_PURCHASE_ORDER", "PURCHASE_ORDER_NOT_RECEIVABLE", "RECEIPT_ALREADY_BILLED", "SUPPLIER_INVOICE_EDIT_CONFLICT", "BILL_RECEIPT_CHANGE_TOO_LARGE", "PURCHASE_RECEIPTS_READ_TRUNCATED", "PURCHASE_ORDER_SUPPLIER_MISMATCH", "ADMIN_REQUIRED", "SUPPLIER_INVOICE_NOT_FOUND", "SUPPLIER_INVOICE_MATCH_NOT_EXCEPTION", "INVOICE_LINES_TOTAL_MISMATCH", "INVOICE_LINE_NOT_ON_PURCHASE_ORDER", "VALIDATION_FAILED"];
 export type SupplierInvoiceMatchErrorCode = (typeof SUPPLIER_INVOICE_MATCH_ERROR_CODES)[number];
 /** Every `SupplierInvoicePaymentStatus`, as a runtime value. */
 export declare const SUPPLIER_INVOICE_PAYMENT_STATUSES: readonly ["open", "partial", "paid"];

package/dist/supplier.js

@@ -25,6 +25,23 @@ export const DEFAULT_PURCHASE_MATCH_TOLERANCE = Object.freeze({ pct: 1 });
  *   store's, or a receipt is not under it.
  * - `PURCHASE_ORDER_NOT_RECEIVABLE` · 409 — the purchase order is `draft` or
  *   `cancelled`.
+ * - `RECEIPT_ALREADY_BILLED` · 409 — a receipt the bill names is already
+ *   covered by another bill (`PurchaseReceipt.billedBy`); `data.receiptIds`
+ *   lists them. Nothing is written.
+ * - `SUPPLIER_INVOICE_EDIT_CONFLICT` · 409 — an edit of a bill that stores or
+ *   writes `receiptIds` (an empty list included) lost to another edit of the
+ *   same bill that landed first and moved only the row version (when the
+ *   `fce` block, the PDF or the payments moved too, that guard's own code
+ *   answers); or a receipt the edit stops naming changed hands since the read;
+ *   or the save met another transaction on the bill or one of its receipts
+ *   in flight, and again on its one retry. Nothing is written; re-read the
+ *   bill and retry.
+ * - `BILL_RECEIPT_CHANGE_TOO_LARGE` · 400 — the receipts the save would mark
+ *   and unmark, plus the bill row, exceed one DynamoDB transaction (100
+ *   items). Nothing is written; save the receipts in smaller steps.
+ * - `PURCHASE_RECEIPTS_READ_TRUNCATED` · 503 — the purchase order's receipt
+ *   read was cut short, so the receipts to mark and the verdict cannot be
+ *   decided. Nothing is written.
  * - `PURCHASE_ORDER_SUPPLIER_MISMATCH` · 400 — the bill's supplier is not the
  *   purchase order's.
  * - `ADMIN_REQUIRED` · 403 — only ADMIN or MANAGER may override.
@@ -37,11 +54,15 @@ export const DEFAULT_PURCHASE_MATCH_TOLERANCE = Object.freeze({ pct: 1 });
  *   purchase-order line the bill's order does not have, one whose `productId`
  *   differs, one another bill line already names, or names one with no
  *   purchase order on the bill.
- * - `VALIDATION_FAILED` · 400
+ * - `VALIDATION_FAILED` · 400 — includes `receiptIds` naming one receipt twice.
  */
 export const SUPPLIER_INVOICE_MATCH_ERROR_CODES = [
     'RECEIPT_NOT_ON_PURCHASE_ORDER',
     'PURCHASE_ORDER_NOT_RECEIVABLE',
+    'RECEIPT_ALREADY_BILLED',
+    'SUPPLIER_INVOICE_EDIT_CONFLICT',
+    'BILL_RECEIPT_CHANGE_TOO_LARGE',
+    'PURCHASE_RECEIPTS_READ_TRUNCATED',
     'PURCHASE_ORDER_SUPPLIER_MISMATCH',
     'ADMIN_REQUIRED',
     'SUPPLIER_INVOICE_NOT_FOUND',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "platform-types",
-	"version": "1.10.739",
+	"version": "1.10.741",
 	"description": "Shared wire and entity contracts for the platform.",
 	"type": "module",
 	"main": "dist/index.js",