@aglyn/plugins-commerce 1.0.0-beta.220 → 1.0.0-beta.222

package/src/lib/server/billing-webhook.js

@@ -17,7 +17,7 @@
 import * as Aglyn from "@aglyn/aglyn/server";
 import { findUserByUidAcrossPools, firebaseAdmin, getOrgForHost, meterHostEmail, notifyHostManagers, notifyRiskEvent, raiseOperatorAlert, renderHostEmailWithTokens, updateExisting, hostSendingIdentity } from "@aglyn/tenant-data-admin";
 import { paymentProvider } from "@aglyn/tenant-data-admin/server/payment-provider";
-import { captureHostContact } from "@aglyn/tenant-runtime";
+import recordCapturedContact from "@aglyn/aglyn/plugin-manager/record-captured-contact";
 import { formatOperatorAlertAmount } from "@aglyn/aglyn/app-utils/operator-alerts";
 import { resolveSiteTimeZone } from "@aglyn/aglyn/app-utils/collection-entry-date";
 import { resolveHostToken } from "@aglyn/aglyn/app-utils/host-tokens";
@@ -25,11 +25,8 @@ import { COMMERCE_CHARGEBACK_UNROUTABLE, COMMERCE_FEE_REPRICE_REFUSED, COMMERCE_
 import { createHmac } from "crypto";
 import { isEmailConfigured, sendEmail } from "@aglyn/shared-util-email";
 import * as CommerceModel from "../model/index.js";
-import { recordContactRefund } from "./contact-refund.js";
-// Leaf import, not the barrel, for the reason `contact-refund.ts` records: the
-// specs in this library mock `@aglyn/tenant-data-admin` wholesale, and a
-// permissive stub would turn a reversal that never happened green.
-import { reverseEmailAttributedRevenue } from "@aglyn/tenant-data-admin/server/email-revenue-attribution";
+import { recordPluginPersonRefund } from "@aglyn/aglyn/plugin-manager/plugin-person-records";
+import { reverseOrderConversion } from "@aglyn/aglyn/plugin-manager/plugin-conversion-credit";
 import { paymentRiskEventFrom } from "@aglyn/aglyn/app-utils/payment-risk";
 import { recordPaymentRiskOnRecord } from "@aglyn/tenant-data-admin/server/payment-risk-record";
 import { isTransientStripeStatus, reverseDestinationTransfer } from "@aglyn/tenant-data-admin/server/stripe-transfer-reversal";
@@ -418,7 +415,7 @@ async function findOrderForDispute(paymentIntentId) {
  * `charge.dispute.created`: FLAG the order, reverse nothing (AGL-1787).
  *
  * A dispute can be WON, and this is the whole reason the reversal waits for
- * `closed`. Nothing here un-writes: `recordContactRefund` is monotonic by
+ * `closed`. Nothing here un-writes: a person's refunds are monotonic by
  * construction (AGL-1754 chose counters over decrements precisely so a reader
  * can never be handed a number that went backwards), so a reversal written on
  * `created` and reversed again on a win would need a decrement the contact
@@ -1870,9 +1867,9 @@ async function findOrderForDispute(paymentIntentId) {
             const subscriptionRef = hostRef.collection('subscriptions').doc(String(object.subscription));
             // Redelivery guard (AGL-1732, the AGL-498 shape). Stripe delivers at
             // least once, and the effects below this write are NOT idempotent —
-            // `upsertHostContact`'s `purchaseCents` is a `FieldValue.increment`, so
-            // a replay would inflate the subscriber's lifetime value and their
-            // order count on every retry.
+            // the capture's `purchaseCents` is added to the person's lifetime
+            // value, so a replay would inflate the subscriber's lifetime value and
+            // their order count on every retry.
             //
             // Keyed on `checkoutSessionId` rather than on the document existing:
             // `customer.subscription.created` writes the SAME doc path (status and
@@ -1955,24 +1952,35 @@ async function findOrderForDispute(paymentIntentId) {
                 link: `/${hostId}/products`
             });
             // AWAITED SINCE AGL-2473, here and at the five sibling call sites in
-            // this file. `upsertHostContact` carries `purchaseCents`, so it is what
-            // feeds `ltvCents` and the RFM ranking — a `void`ed one is a paying
-            // customer quietly missing from the segment the merchant emails. It
-            // touches only our own Firestore, which is the whole line AGL-2473
-            // drew: Aglyn's own storage is awaited, a stranger's server is queued.
-            // `refund.ts` already awaited its sibling for exactly this reason.
-            await captureHostContact(_extends({
+            // this file. The capture carries `purchaseCents`, which is what the
+            // record system adds to a person's lifetime value and the RFM ranking
+            // — a `void`ed one is a paying customer quietly missing from the
+            // segment the merchant emails. It touches only our own Firestore,
+            // which is the whole line AGL-2473 drew: Aglyn's own storage is
+            // awaited, a stranger's server is queued. `refund.ts` already awaited
+            // its sibling for exactly this reason.
+            //
+            // Through the contact-capture contract (AGL-3080), like every other
+            // door commerce owns: the plugin that keeps people decides what a
+            // purchase makes of them, and commerce imports none of it.
+            await recordCapturedContact(_extends({
+                orgId: '',
                 hostId: String(hostId),
-                email: object == null ? void 0 : (_object_customer_details1 = object.customer_details) == null ? void 0 : _object_customer_details1.email,
-                name: (_ref10 = object == null ? void 0 : (_object_customer_details2 = object.customer_details) == null ? void 0 : _object_customer_details2.name) != null ? _ref10 : undefined,
-                source: 'order',
+                identity: {
+                    email: object == null ? void 0 : (_object_customer_details1 = object.customer_details) == null ? void 0 : _object_customer_details1.email,
+                    name: (_ref10 = object == null ? void 0 : (_object_customer_details2 = object.customer_details) == null ? void 0 : _object_customer_details2.name) != null ? _ref10 : null
+                },
+                // A purchase makes the person a relationship (AGL-3232): a contact,
+                // with an open lead for the address closed onto it.
+                surface: 'relationship',
                 // Every order door names `customer` (AGL-2612): a floor, so the
                 // stage fills or advances and never moves anybody back.
-                initialLifecycleStage: 'customer'
+                lifecycleFloor: 'customer'
             }, subscriptionCents > 0 ? {
                 purchaseCents: subscriptionCents
             } : {}, {
                 interaction: {
+                    source: 'order',
                     refId: String(object.subscription),
                     summary: `Started a subscription ($${(subscriptionCents / 100).toFixed(2)})`
                 }
@@ -2513,20 +2521,23 @@ async function findOrderForDispute(paymentIntentId) {
                 // counting only the first charge ranks them as a one-purchase
                 // customer forever. Keyed to the invoice so the guard above is what
                 // stops a redelivery inflating it.
-                await captureHostContact(_extends({
+                await recordCapturedContact({
+                    orgId: '',
                     hostId: invoiceHostId,
-                    email: renewalEmail
-                }, soldSnapshot.get('customerName') ? {
-                    name: String(soldSnapshot.get('customerName'))
-                } : {}, {
-                    source: 'order',
-                    initialLifecycleStage: 'customer',
+                    identity: _extends({
+                        email: renewalEmail
+                    }, soldSnapshot.get('customerName') ? {
+                        name: String(soldSnapshot.get('customerName'))
+                    } : {}),
+                    surface: 'relationship',
+                    lifecycleFloor: 'customer',
                     purchaseCents: paidCents,
                     interaction: {
+                        source: 'order',
                         refId: invoiceId,
                         summary: `Subscription renewed ($${(paidCents / 100).toFixed(2)})`
                     }
-                }));
+                });
             }
         }
     }
@@ -2704,18 +2715,22 @@ async function findOrderForDispute(paymentIntentId) {
                 if (guestContactEmail) {
                     var _ref37, _ref38;
                     var _object_customer_details6;
-                    await captureHostContact(_extends({
+                    await recordCapturedContact(_extends({
+                        orgId: '',
                         hostId: String(hostId),
-                        email: guestContactEmail,
-                        name: (_ref37 = (_ref38 = object == null ? void 0 : (_object_customer_details6 = object.customer_details) == null ? void 0 : _object_customer_details6.name) != null ? _ref38 : reservation['guestName']) != null ? _ref37 : undefined,
-                        source: 'booking',
+                        identity: {
+                            email: guestContactEmail,
+                            name: (_ref37 = (_ref38 = object == null ? void 0 : (_object_customer_details6 = object.customer_details) == null ? void 0 : _object_customer_details6.name) != null ? _ref38 : reservation['guestName']) != null ? _ref37 : null
+                        },
+                        surface: 'relationship',
                         // A paid stay is a sale (AGL-2612), whatever the source says
                         // about the kind of thing that was bought.
-                        initialLifecycleStage: 'customer'
+                        lifecycleFloor: 'customer'
                     }, paidCents > 0 ? {
                         purchaseCents: paidCents
                     } : {}, {
                         interaction: {
+                            source: 'booking',
                             refId: String(reservationId),
                             summary: `Reserved a stay ($${(paidCents / 100).toFixed(2)})`
                         }
@@ -3117,17 +3132,21 @@ async function findOrderForDispute(paymentIntentId) {
                 body: `Order ${cartOrderLabel} came in on {site}: ${cartUnits} ` + `item${cartUnits === 1 ? '' : 's'}, ${cartOrderTotal}` + ((object == null ? void 0 : (_object_customer_details8 = object.customer_details) == null ? void 0 : _object_customer_details8.email) ? `, from ${object.customer_details.email}.` : '.'),
                 link: `/${hostId}/products`
             });
-            await captureHostContact(_extends({
+            await recordCapturedContact(_extends({
+                orgId: '',
                 hostId: String(hostId),
-                email: object == null ? void 0 : (_object_customer_details9 = object.customer_details) == null ? void 0 : _object_customer_details9.email,
-                name: (_ref43 = object == null ? void 0 : (_object_customer_details10 = object.customer_details) == null ? void 0 : _object_customer_details10.name) != null ? _ref43 : undefined,
-                source: 'order',
-                initialLifecycleStage: 'customer'
+                identity: {
+                    email: object == null ? void 0 : (_object_customer_details9 = object.customer_details) == null ? void 0 : _object_customer_details9.email,
+                    name: (_ref43 = object == null ? void 0 : (_object_customer_details10 = object.customer_details) == null ? void 0 : _object_customer_details10.name) != null ? _ref43 : null
+                },
+                surface: 'relationship',
+                lifecycleFloor: 'customer'
             }, marketingOptIn ? {
                 marketingConsent: true
             } : {}, {
                 purchaseCents: Number((_ref44 = object == null ? void 0 : object.amount_total) != null ? _ref44 : 0),
                 interaction: {
+                    source: 'order',
                     refId: String(object.id),
                     summary: `Placed an order ($${(Number((_ref45 = object == null ? void 0 : object.amount_total) != null ? _ref45 : 0) / 100).toFixed(2)})`
                 }
@@ -3559,16 +3578,20 @@ async function findOrderForDispute(paymentIntentId) {
                     var _ref68, _ref69, _ref70;
                     var _order_totals1, _object_customer_details17;
                     const chargedCents = Number((_ref68 = object == null ? void 0 : object.amount_total) != null ? _ref68 : 0) || Number((_ref69 = (_order_totals1 = order.totals) == null ? void 0 : _order_totals1.totalCents) != null ? _ref69 : 0);
-                    await captureHostContact(_extends({
+                    await recordCapturedContact(_extends({
+                        orgId: '',
                         hostId: String(hostId),
-                        email: draftEmail,
-                        name: (_ref70 = object == null ? void 0 : (_object_customer_details17 = object.customer_details) == null ? void 0 : _object_customer_details17.name) != null ? _ref70 : undefined,
-                        source: 'order',
-                        initialLifecycleStage: 'customer'
+                        identity: {
+                            email: draftEmail,
+                            name: (_ref70 = object == null ? void 0 : (_object_customer_details17 = object.customer_details) == null ? void 0 : _object_customer_details17.name) != null ? _ref70 : null
+                        },
+                        surface: 'relationship',
+                        lifecycleFloor: 'customer'
                     }, chargedCents > 0 ? {
                         purchaseCents: chargedCents
                     } : {}, {
                         interaction: {
+                            source: 'order',
                             refId: String(orderId),
                             summary: `Paid ${CommerceModel.formatOrderNumber(order, String(orderId))} ($${(chargedCents / 100).toFixed(2)})`
                         }
@@ -3943,14 +3966,18 @@ async function findOrderForDispute(paymentIntentId) {
                 }
             })();
             // Contacts ingestion (AGL-197): buyers become contacts.
-            await captureHostContact({
+            await recordCapturedContact({
+                orgId: '',
                 hostId: String(hostId),
-                email: object == null ? void 0 : (_object_customer_details19 = object.customer_details) == null ? void 0 : _object_customer_details19.email,
-                name: (_ref79 = object == null ? void 0 : (_object_customer_details20 = object.customer_details) == null ? void 0 : _object_customer_details20.name) != null ? _ref79 : undefined,
-                source: 'order',
-                initialLifecycleStage: 'customer',
+                identity: {
+                    email: object == null ? void 0 : (_object_customer_details19 = object.customer_details) == null ? void 0 : _object_customer_details19.email,
+                    name: (_ref79 = object == null ? void 0 : (_object_customer_details20 = object.customer_details) == null ? void 0 : _object_customer_details20.name) != null ? _ref79 : null
+                },
+                surface: 'relationship',
+                lifecycleFloor: 'customer',
                 purchaseCents: Number((_ref80 = object == null ? void 0 : object.amount_total) != null ? _ref80 : 0),
                 interaction: {
+                    source: 'order',
                     refId: String(object.id),
                     summary: `Placed an order ($${(Number((_ref81 = object == null ? void 0 : object.amount_total) != null ? _ref81 : 0) / 100).toFixed(2)})`
                 }
@@ -4341,18 +4368,18 @@ async function findOrderForDispute(paymentIntentId) {
                         link: `/${hostId}/orders`
                     });
                     // The customer's side of the ledger (AGL-1754), through the same
-                    // writer a refund uses and with `kind` set so the contact's timeline
-                    // says "charged back". Skipped when nothing was reversed: a won
+                    // seam a refund uses and with the reason set so the person's
+                    // timeline says "charged back". Skipped when nothing was reversed: a won
                     // dispute moved no money, and a lost one that found nothing left to
                     // reverse would otherwise record a $0 entry against the buyer.
                     if (settled.reversedCents > 0) {
-                        await recordContactRefund({
+                        await recordPluginPersonRefund({
                             hostId,
-                            orderId: snapshot.id,
+                            refId: snapshot.id,
                             email: settled.customerEmail,
                             amountCents: settled.reversedCents,
-                            closedTheOrder: settled.closedTheOrder,
-                            kind: 'chargeback'
+                            closedTheSale: settled.closedTheOrder,
+                            reason: 'chargeback'
                         });
                         // The shelf's side (AGL-1797), the SAME door the admin-initiated
                         // refund writes so the two cannot diverge the way the contact
@@ -4374,7 +4401,7 @@ async function findOrderForDispute(paymentIntentId) {
                         // for it — and the reversal is recorded beside the credit rather
                         // than subtracted from it, exactly as the contact ledger above
                         // records `refundedCents` beside `ltvCents`.
-                        await reverseEmailAttributedRevenue({
+                        await reverseOrderConversion({
                             hostId,
                             orderId: snapshot.id,
                             amountCents: settled.reversedCents,