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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-commerce",
-  "version": "1.0.0-beta.220",
+  "version": "1.0.0-beta.221",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,18 +25,18 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.220",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.220",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.220",
-    "@aglyn/shared-ui-next": "1.0.0-beta.220",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.220",
-    "@aglyn/shared-util-email": "1.0.0-beta.220",
-    "@aglyn/shared-util-http": "1.0.0-beta.220",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.220",
-    "@aglyn/shared-util-tools": "1.0.0-beta.220",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.220",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.220",
-    "@aglyn/tenant-runtime": "1.0.0-beta.220",
+    "@aglyn/aglyn": "1.0.0-beta.221",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.221",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.221",
+    "@aglyn/shared-ui-next": "1.0.0-beta.221",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.221",
+    "@aglyn/shared-util-email": "1.0.0-beta.221",
+    "@aglyn/shared-util-http": "1.0.0-beta.221",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.221",
+    "@aglyn/shared-util-tools": "1.0.0-beta.221",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.221",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.221",
+    "@aglyn/tenant-runtime": "1.0.0-beta.221",
     "@stripe/react-stripe-js": "^6.12.0",
     "@stripe/stripe-js": "^9.17.0",
     "@swc/helpers": "0.5.23",

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";
@@ -1870,9 +1870,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 +1955,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 +2524,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 +2718,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 +3135,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 +3581,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 +3969,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)})`
                 }