@drawbridge/drawbridge-utils 0.0.169 → 0.0.171

package/dist/providers.cjs

@@ -774,10 +774,11 @@ var attentive_default2 = {
       sync: async ({ lead, settings, suppressed, token }, { fetcher } = {}) => {
         var _a, _b, _c, _d;
         const segment = settings == null ? void 0 : settings.segment;
-        if (!segment) return { message: "No Attentive segment is chosen for this connection.", skipped: true };
         const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
         const phone = toE164(((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.phone) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.phone));
-        if (!email && !phone) return { message: "That lead has no email address or phone number to sync.", skipped: true };
+        const request2 = { email: email || null, phone: phone || null, segment: (settings == null ? void 0 : settings.segment) || null };
+        if (!segment) return { message: "No Attentive segment is chosen for this connection.", request: request2, skipped: true };
+        if (!email && !phone) return { message: "That lead has no email address or phone number to sync.", request: request2, skipped: true };
         const user = {
           ...email && { email },
           ...phone && { phone }
@@ -799,6 +800,7 @@ var attentive_default2 = {
           });
           return {
             message: "Attentive accepted an unsubscribe for this contact \u2014 they have opted out.",
+            request: request2,
             response: { accepted: true, unsubscribed: true }
           };
         }
@@ -839,6 +841,7 @@ var attentive_default2 = {
           // queued them — a merchant who reads "synced" and looks for the person
           // in Attentive a second later has been told the wrong thing.
           message: "Attentive accepted this contact for the segment. Attentive processes these asynchronously, so it appears there shortly.",
+          request: request2,
           response: {
             accepted: true,
             ...(membership == null ? void 0 : membership.batchJobId) && { batchJobId: membership.batchJobId }
@@ -2855,7 +2858,7 @@ var drawbridge_default2 = {
           text: { max: 2e3, type: "string" }
         },
         triggers: ["schedule.day", "schedule.week", "schedule.month"],
-        usage: { actions: 0 }
+        usage: { actions: channels.email.actionsPerSend }
       }),
       // To organization MEMBERS. Never suppressed — an entrant's opt-out must
       // not silence an alert to staff — and not billed.
@@ -2880,10 +2883,14 @@ var drawbridge_default2 = {
           subject: { max: 150, type: "string" }
         },
         triggers: ["lead.insert"],
-        // Zero is a PRICE, and a deliberate one. Declared rather than omitted
-        // so "this is free" and "nobody decided" stay different statements;
-        // completeStep bills only when actions > 0.
-        usage: { actions: 0 }
+        // EVERY STEP IN A BILLABLE WORKFLOW COUNTS, team mail included. This
+        // leaves our SendGrid account and costs the same to send as any other
+        // email, so it carries the same weight. Whether anything is charged at
+        // all is the workflow's `billable` tag, not the step's audience — and
+        // this step triggers on lead.insert, so a merchant notifying
+        // themselves on every entry spends against their allowance twice per
+        // lead, once for the entry and once for the notification.
+        usage: { actions: channels.email.actionsPerSend }
       }),
       // To a LEAD. Suppression applies and the send is billed.
       send: () => ({
@@ -3239,13 +3246,15 @@ var klaviyo_default2 = {
       // different thing from deleting the profile.
       remove: false,
       sync: async ({ context, lead, segments, settings, suppressed, token }, { fetcher } = {}) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const list = settings == null ? void 0 : settings.list;
-        if (!list) return { message: "No Klaviyo list is chosen for this connection.", skipped: true };
-        const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
-        if (!email) return { message: "That lead has no email address to sync.", skipped: true };
+        const request2 = { email: ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email) || null, list: (settings == null ? void 0 : settings.list) || null };
+        if (!list) return { message: "No Klaviyo list is chosen for this connection.", request: request2, skipped: true };
+        const email = ((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.email) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.email);
+        if (!email) return { message: "That lead has no email address to sync.", request: request2, skipped: true };
         const person = (context == null ? void 0 : context.contact) || null;
         const totals = (person == null ? void 0 : person.totals) || {};
+        const count = (value) => typeof value === "number" ? value : (value == null ? void 0 : value.total) || 0;
         const profile = await api2("/profile-import", {
           fetcher,
           method: "POST",
@@ -3259,13 +3268,13 @@ var klaviyo_default2 = {
                     drawbridge_campaigns: (person.campaigns || []).length,
                     drawbridge_draws: totals.draws || 0,
                     drawbridge_entries: totals.entries || 0,
-                    drawbridge_orders: totals.orders || 0,
+                    drawbridge_orders: count(totals.orders),
                     // Campaign-attributed, NOT lifetime. A merchant running
                     // Shopify already has lifetime revenue in Klaviyo through
                     // Klaviyo's own integration; what only we can say is how
                     // much a campaign drove. Named so the two cannot be
                     // mistaken for one another in a segment builder.
-                    drawbridge_revenue: totals.gross || 0
+                    drawbridge_revenue: count(totals.gross)
                   },
                   // THE DRAWBRIDGE SEGMENTS THEY ARE IN, as a list property the
                   // merchant builds Klaviyo segments on top of. Klaviyo owns no
@@ -3299,8 +3308,8 @@ var klaviyo_default2 = {
           },
           token
         });
-        const profileId = (_c = profile == null ? void 0 : profile.data) == null ? void 0 : _c.id;
-        if (!profileId) return { message: "Klaviyo returned no profile id.", skipped: true };
+        const profileId = (_e = profile == null ? void 0 : profile.data) == null ? void 0 : _e.id;
+        if (!profileId) return { message: "Klaviyo returned no profile id.", request: request2, skipped: true };
         await api2("/profile-subscription-bulk-create-jobs/", {
           fetcher,
           method: "POST",
@@ -3329,6 +3338,7 @@ var klaviyo_default2 = {
           // Merged into `context` for later steps in this run.
           context: { klaviyoProfileId: profileId },
           message: suppressed ? "Synced to Klaviyo as unsubscribed \u2014 this contact has opted out." : "Synced to the Klaviyo list.",
+          request: request2,
           // Recorded on the run for support to read back, not a write
           // instruction — the hook has already written what it needed to.
           response: { klaviyoProfileId: profileId }
@@ -3770,7 +3780,8 @@ var api3 = async (path, { dc, fetcher = fetch, method = "GET", payload, token })
   return response.status === 204 ? null : response.json();
 };
 var subscriberHash = (email) => (0, import_node_crypto5.createHash)("md5").update(String(email).trim().toLowerCase()).digest("hex");
-var tagName = (title) => "Drawbridge: " + title;
+var TAG_NAME_LIMIT = 100;
+var tagName = (title) => ("Drawbridge: " + title).slice(0, TAG_NAME_LIMIT);
 var mailchimp_default2 = {
   // OAUTH 2, authorization code. Every url below is quoted from
   // mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/ rather
@@ -3908,15 +3919,16 @@ var mailchimp_default2 = {
       // why there is no create-or-update branch here. Quoted from Mailchimp's
       // Marketing API reference for the list-members resource.
       sync: async ({ connection: connection2, lead, segments, settings, suppressed, token }, { fetcher, read } = {}) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const audience = settings == null ? void 0 : settings.audience;
-        if (!audience) return { message: "No Mailchimp audience is chosen for this connection.", skipped: true };
-        const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
-        if (!email) return { message: "That lead has no email address to sync.", skipped: true };
+        const request2 = { audience: (settings == null ? void 0 : settings.audience) || null, email: ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email) || null };
+        if (!audience) return { message: "No Mailchimp audience is chosen for this connection.", request: request2, skipped: true };
+        const email = ((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.email) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.email);
+        if (!email) return { message: "That lead has no email address to sync.", request: request2, skipped: true };
         const hash = subscriberHash(email);
         const [firstName, ...restOfName] = String((lead == null ? void 0 : lead.name) || "").trim().split(/\s+/).filter(Boolean);
         const lastName = restOfName.join(" ");
-        const phone = ((_c = lead == null ? void 0 : lead.phone) == null ? void 0 : _c.number) || null;
+        const phone = ((_e = lead == null ? void 0 : lead.phone) == null ? void 0 : _e.number) || null;
         const mergeFields = {
           ...firstName && { FNAME: firstName },
           ...lastName && { LNAME: lastName },
@@ -3973,6 +3985,7 @@ var mailchimp_default2 = {
           // Merged into `context` for later steps in this run.
           context: { mailchimpMemberId: (member == null ? void 0 : member.id) || hash },
           message: suppressed ? "Synced to Mailchimp as unsubscribed \u2014 this contact has opted out." : "Synced to the Mailchimp audience.",
+          request: request2,
           // Recorded on the run for support to read back, not a write
           // instruction — the hook has already written what it needed to.
           response: { mailchimpMemberId: (member == null ? void 0 : member.id) || hash }
@@ -3995,10 +4008,12 @@ var mailchimp_default2 = {
       // on attaching people to it by name. Both address the same object. The
       // segment schema says it outright: "The type of segment. Static segments
       // are now known as tags"
-      // (api.mailchimp.com/schema/3.0/Swagger.json, fetched 2026-09-11).
+      // (api.mailchimp.com/schema/3.0/Definitions/Lists/Segments/Response.json,
+      // fetched 2026-09-12 — the root Swagger.json carries no prose, only $refs
+      // into fragment files like this one).
       //
-      // IDEMPOTENT ON EVERY PATH: called on create, on rename, on the boot
-      // sweep and on backfill, it converges. That is what lets one hook serve
+      // IDEMPOTENT ON EVERY PATH: called on create, on rename, on a connection
+      // finishing its configuration, and on the backfill migration, it converges. That is what lets one hook serve
       // all four without a create-vs-update branch anywhere else.
       register: async ({ connection: connection2, context, manifest, settings, token, workflow }, { fetcher, read } = {}) => {
         var _a;
@@ -5025,7 +5040,7 @@ var shopify_default2 = {
       //
       // The shell has already refused a missing or inactive Shopify connection,
       // so what is left is the two things only this hook can know are wrong.
-      product: async ({ connection: connection2, context, workflow }, { mintId } = {}) => {
+      product: async ({ connection: connection2, context, workflow }, { mintId, read } = {}) => {
         const request2 = {
           numericId: (context == null ? void 0 : context.id) || null,
           organizationId: workflow.organization,
@@ -5034,7 +5049,13 @@ var shopify_default2 = {
         if (!(context == null ? void 0 : context.id)) return { message: "Skipped \u2014 product webhook payload had no id.", request: request2, response: { skipped: true }, skipped: true };
         if (!connection2.shop) return { message: "Skipped \u2014 Shopify connection is missing shop domain.", request: request2, response: { skipped: true }, skipped: true };
         const providerId = "gid://shopify/Product/" + context.id;
-        const productId = mintId();
+        const query = {
+          "provider.id": providerId,
+          "provider.slug": "shopify",
+          "source.domain": connection2.shop
+        };
+        const existing = (read == null ? void 0 : read.get) ? await read.get({ collection: "product", query }) : null;
+        const productId = (existing == null ? void 0 : existing.id) || mintId();
         return {
           enqueues: [{
             data: { product: productId, providerId, shop: connection2.shop },
@@ -5064,11 +5085,7 @@ var shopify_default2 = {
             },
             operation: "update",
             options: { upsert: true },
-            query: {
-              "provider.id": providerId,
-              "provider.slug": "shopify",
-              "source.domain": connection2.shop
-            }
+            query
           }]
         };
       }
@@ -5338,7 +5355,7 @@ var shopify_default2 = {
               options: { jobId: "connection.update.register." + workflow.connection + "." + (0, import_node_crypto6.randomUUID)() },
               queue: "connection"
             }],
-            message: ((scopesMissing == null ? void 0 : scopesMissing.length) ? "Health check: ping ok, webhooks reconciled \u2014 connection errored, granted scopes are missing: " + scopesMissing.join(", ") + "." : refreshTokenRotated ? "Health check passed \u2014 refresh token rotated, ping ok, webhooks reconciled." : "Health check passed \u2014 ping ok, webhooks reconciled.") + (sourceRepaired ? " Billing source repaired from the live shop." : "") + (metered === null ? " No usage line on the store's approved plan \u2014 order billing needs the merchant to approve the updated plan." : ""),
+            message: ((scopesMissing == null ? void 0 : scopesMissing.length) ? "Health check: ping ok, scopes reconciled \u2014 connection errored, granted scopes are missing: " + scopesMissing.join(", ") + "." : refreshTokenRotated ? "Health check passed \u2014 refresh token rotated, ping ok, scopes reconciled." : "Health check passed \u2014 ping ok, scopes reconciled.") + (sourceRepaired ? " Billing source repaired from the live shop." : "") + (metered === null ? " No usage line on the store's approved plan \u2014 order billing needs the merchant to approve the updated plan." : ""),
             request: request2,
             response: {
               billingProbeFailed,

package/dist/providers.js

@@ -725,10 +725,11 @@ var attentive_default2 = {
       sync: async ({ lead, settings, suppressed, token }, { fetcher } = {}) => {
         var _a, _b, _c, _d;
         const segment = settings == null ? void 0 : settings.segment;
-        if (!segment) return { message: "No Attentive segment is chosen for this connection.", skipped: true };
         const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
         const phone = toE164(((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.phone) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.phone));
-        if (!email && !phone) return { message: "That lead has no email address or phone number to sync.", skipped: true };
+        const request2 = { email: email || null, phone: phone || null, segment: (settings == null ? void 0 : settings.segment) || null };
+        if (!segment) return { message: "No Attentive segment is chosen for this connection.", request: request2, skipped: true };
+        if (!email && !phone) return { message: "That lead has no email address or phone number to sync.", request: request2, skipped: true };
         const user = {
           ...email && { email },
           ...phone && { phone }
@@ -750,6 +751,7 @@ var attentive_default2 = {
           });
           return {
             message: "Attentive accepted an unsubscribe for this contact \u2014 they have opted out.",
+            request: request2,
             response: { accepted: true, unsubscribed: true }
           };
         }
@@ -790,6 +792,7 @@ var attentive_default2 = {
           // queued them — a merchant who reads "synced" and looks for the person
           // in Attentive a second later has been told the wrong thing.
           message: "Attentive accepted this contact for the segment. Attentive processes these asynchronously, so it appears there shortly.",
+          request: request2,
           response: {
             accepted: true,
             ...(membership == null ? void 0 : membership.batchJobId) && { batchJobId: membership.batchJobId }
@@ -2806,7 +2809,7 @@ var drawbridge_default2 = {
           text: { max: 2e3, type: "string" }
         },
         triggers: ["schedule.day", "schedule.week", "schedule.month"],
-        usage: { actions: 0 }
+        usage: { actions: channels.email.actionsPerSend }
       }),
       // To organization MEMBERS. Never suppressed — an entrant's opt-out must
       // not silence an alert to staff — and not billed.
@@ -2831,10 +2834,14 @@ var drawbridge_default2 = {
           subject: { max: 150, type: "string" }
         },
         triggers: ["lead.insert"],
-        // Zero is a PRICE, and a deliberate one. Declared rather than omitted
-        // so "this is free" and "nobody decided" stay different statements;
-        // completeStep bills only when actions > 0.
-        usage: { actions: 0 }
+        // EVERY STEP IN A BILLABLE WORKFLOW COUNTS, team mail included. This
+        // leaves our SendGrid account and costs the same to send as any other
+        // email, so it carries the same weight. Whether anything is charged at
+        // all is the workflow's `billable` tag, not the step's audience — and
+        // this step triggers on lead.insert, so a merchant notifying
+        // themselves on every entry spends against their allowance twice per
+        // lead, once for the entry and once for the notification.
+        usage: { actions: channels.email.actionsPerSend }
       }),
       // To a LEAD. Suppression applies and the send is billed.
       send: () => ({
@@ -3190,13 +3197,15 @@ var klaviyo_default2 = {
       // different thing from deleting the profile.
       remove: false,
       sync: async ({ context, lead, segments, settings, suppressed, token }, { fetcher } = {}) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const list = settings == null ? void 0 : settings.list;
-        if (!list) return { message: "No Klaviyo list is chosen for this connection.", skipped: true };
-        const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
-        if (!email) return { message: "That lead has no email address to sync.", skipped: true };
+        const request2 = { email: ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email) || null, list: (settings == null ? void 0 : settings.list) || null };
+        if (!list) return { message: "No Klaviyo list is chosen for this connection.", request: request2, skipped: true };
+        const email = ((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.email) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.email);
+        if (!email) return { message: "That lead has no email address to sync.", request: request2, skipped: true };
         const person = (context == null ? void 0 : context.contact) || null;
         const totals = (person == null ? void 0 : person.totals) || {};
+        const count = (value) => typeof value === "number" ? value : (value == null ? void 0 : value.total) || 0;
         const profile = await api2("/profile-import", {
           fetcher,
           method: "POST",
@@ -3210,13 +3219,13 @@ var klaviyo_default2 = {
                     drawbridge_campaigns: (person.campaigns || []).length,
                     drawbridge_draws: totals.draws || 0,
                     drawbridge_entries: totals.entries || 0,
-                    drawbridge_orders: totals.orders || 0,
+                    drawbridge_orders: count(totals.orders),
                     // Campaign-attributed, NOT lifetime. A merchant running
                     // Shopify already has lifetime revenue in Klaviyo through
                     // Klaviyo's own integration; what only we can say is how
                     // much a campaign drove. Named so the two cannot be
                     // mistaken for one another in a segment builder.
-                    drawbridge_revenue: totals.gross || 0
+                    drawbridge_revenue: count(totals.gross)
                   },
                   // THE DRAWBRIDGE SEGMENTS THEY ARE IN, as a list property the
                   // merchant builds Klaviyo segments on top of. Klaviyo owns no
@@ -3250,8 +3259,8 @@ var klaviyo_default2 = {
           },
           token
         });
-        const profileId = (_c = profile == null ? void 0 : profile.data) == null ? void 0 : _c.id;
-        if (!profileId) return { message: "Klaviyo returned no profile id.", skipped: true };
+        const profileId = (_e = profile == null ? void 0 : profile.data) == null ? void 0 : _e.id;
+        if (!profileId) return { message: "Klaviyo returned no profile id.", request: request2, skipped: true };
         await api2("/profile-subscription-bulk-create-jobs/", {
           fetcher,
           method: "POST",
@@ -3280,6 +3289,7 @@ var klaviyo_default2 = {
           // Merged into `context` for later steps in this run.
           context: { klaviyoProfileId: profileId },
           message: suppressed ? "Synced to Klaviyo as unsubscribed \u2014 this contact has opted out." : "Synced to the Klaviyo list.",
+          request: request2,
           // Recorded on the run for support to read back, not a write
           // instruction — the hook has already written what it needed to.
           response: { klaviyoProfileId: profileId }
@@ -3721,7 +3731,8 @@ var api3 = async (path, { dc, fetcher = fetch, method = "GET", payload, token })
   return response.status === 204 ? null : response.json();
 };
 var subscriberHash = (email) => createHash2("md5").update(String(email).trim().toLowerCase()).digest("hex");
-var tagName = (title) => "Drawbridge: " + title;
+var TAG_NAME_LIMIT = 100;
+var tagName = (title) => ("Drawbridge: " + title).slice(0, TAG_NAME_LIMIT);
 var mailchimp_default2 = {
   // OAUTH 2, authorization code. Every url below is quoted from
   // mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/ rather
@@ -3859,15 +3870,16 @@ var mailchimp_default2 = {
       // why there is no create-or-update branch here. Quoted from Mailchimp's
       // Marketing API reference for the list-members resource.
       sync: async ({ connection: connection2, lead, segments, settings, suppressed, token }, { fetcher, read } = {}) => {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const audience = settings == null ? void 0 : settings.audience;
-        if (!audience) return { message: "No Mailchimp audience is chosen for this connection.", skipped: true };
-        const email = ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email);
-        if (!email) return { message: "That lead has no email address to sync.", skipped: true };
+        const request2 = { audience: (settings == null ? void 0 : settings.audience) || null, email: ((_b = (_a = lead == null ? void 0 : lead.canonical) == null ? void 0 : _a.email) == null ? void 0 : _b.value) || (lead == null ? void 0 : lead.email) || null };
+        if (!audience) return { message: "No Mailchimp audience is chosen for this connection.", request: request2, skipped: true };
+        const email = ((_d = (_c = lead == null ? void 0 : lead.canonical) == null ? void 0 : _c.email) == null ? void 0 : _d.value) || (lead == null ? void 0 : lead.email);
+        if (!email) return { message: "That lead has no email address to sync.", request: request2, skipped: true };
         const hash = subscriberHash(email);
         const [firstName, ...restOfName] = String((lead == null ? void 0 : lead.name) || "").trim().split(/\s+/).filter(Boolean);
         const lastName = restOfName.join(" ");
-        const phone = ((_c = lead == null ? void 0 : lead.phone) == null ? void 0 : _c.number) || null;
+        const phone = ((_e = lead == null ? void 0 : lead.phone) == null ? void 0 : _e.number) || null;
         const mergeFields = {
           ...firstName && { FNAME: firstName },
           ...lastName && { LNAME: lastName },
@@ -3924,6 +3936,7 @@ var mailchimp_default2 = {
           // Merged into `context` for later steps in this run.
           context: { mailchimpMemberId: (member == null ? void 0 : member.id) || hash },
           message: suppressed ? "Synced to Mailchimp as unsubscribed \u2014 this contact has opted out." : "Synced to the Mailchimp audience.",
+          request: request2,
           // Recorded on the run for support to read back, not a write
           // instruction — the hook has already written what it needed to.
           response: { mailchimpMemberId: (member == null ? void 0 : member.id) || hash }
@@ -3946,10 +3959,12 @@ var mailchimp_default2 = {
       // on attaching people to it by name. Both address the same object. The
       // segment schema says it outright: "The type of segment. Static segments
       // are now known as tags"
-      // (api.mailchimp.com/schema/3.0/Swagger.json, fetched 2026-09-11).
+      // (api.mailchimp.com/schema/3.0/Definitions/Lists/Segments/Response.json,
+      // fetched 2026-09-12 — the root Swagger.json carries no prose, only $refs
+      // into fragment files like this one).
       //
-      // IDEMPOTENT ON EVERY PATH: called on create, on rename, on the boot
-      // sweep and on backfill, it converges. That is what lets one hook serve
+      // IDEMPOTENT ON EVERY PATH: called on create, on rename, on a connection
+      // finishing its configuration, and on the backfill migration, it converges. That is what lets one hook serve
       // all four without a create-vs-update branch anywhere else.
       register: async ({ connection: connection2, context, manifest, settings, token, workflow }, { fetcher, read } = {}) => {
         var _a;
@@ -4976,7 +4991,7 @@ var shopify_default2 = {
       //
       // The shell has already refused a missing or inactive Shopify connection,
       // so what is left is the two things only this hook can know are wrong.
-      product: async ({ connection: connection2, context, workflow }, { mintId } = {}) => {
+      product: async ({ connection: connection2, context, workflow }, { mintId, read } = {}) => {
         const request2 = {
           numericId: (context == null ? void 0 : context.id) || null,
           organizationId: workflow.organization,
@@ -4985,7 +5000,13 @@ var shopify_default2 = {
         if (!(context == null ? void 0 : context.id)) return { message: "Skipped \u2014 product webhook payload had no id.", request: request2, response: { skipped: true }, skipped: true };
         if (!connection2.shop) return { message: "Skipped \u2014 Shopify connection is missing shop domain.", request: request2, response: { skipped: true }, skipped: true };
         const providerId = "gid://shopify/Product/" + context.id;
-        const productId = mintId();
+        const query = {
+          "provider.id": providerId,
+          "provider.slug": "shopify",
+          "source.domain": connection2.shop
+        };
+        const existing = (read == null ? void 0 : read.get) ? await read.get({ collection: "product", query }) : null;
+        const productId = (existing == null ? void 0 : existing.id) || mintId();
         return {
           enqueues: [{
             data: { product: productId, providerId, shop: connection2.shop },
@@ -5015,11 +5036,7 @@ var shopify_default2 = {
             },
             operation: "update",
             options: { upsert: true },
-            query: {
-              "provider.id": providerId,
-              "provider.slug": "shopify",
-              "source.domain": connection2.shop
-            }
+            query
           }]
         };
       }
@@ -5289,7 +5306,7 @@ var shopify_default2 = {
               options: { jobId: "connection.update.register." + workflow.connection + "." + randomUUID2() },
               queue: "connection"
             }],
-            message: ((scopesMissing == null ? void 0 : scopesMissing.length) ? "Health check: ping ok, webhooks reconciled \u2014 connection errored, granted scopes are missing: " + scopesMissing.join(", ") + "." : refreshTokenRotated ? "Health check passed \u2014 refresh token rotated, ping ok, webhooks reconciled." : "Health check passed \u2014 ping ok, webhooks reconciled.") + (sourceRepaired ? " Billing source repaired from the live shop." : "") + (metered === null ? " No usage line on the store's approved plan \u2014 order billing needs the merchant to approve the updated plan." : ""),
+            message: ((scopesMissing == null ? void 0 : scopesMissing.length) ? "Health check: ping ok, scopes reconciled \u2014 connection errored, granted scopes are missing: " + scopesMissing.join(", ") + "." : refreshTokenRotated ? "Health check passed \u2014 refresh token rotated, ping ok, scopes reconciled." : "Health check passed \u2014 ping ok, scopes reconciled.") + (sourceRepaired ? " Billing source repaired from the live shop." : "") + (metered === null ? " No usage line on the store's approved plan \u2014 order billing needs the merchant to approve the updated plan." : ""),
             request: request2,
             response: {
               billingProbeFailed,

package/package.json

@@ -226,5 +226,5 @@
     "prepublishOnly": ". \"$HOME/.nvm/nvm.sh\" && nvm use && tsup && node --test"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.169"
+  "version": "0.0.171"
 }