@drawbridge/drawbridge-utils 0.0.143 → 0.0.144

package/dist/connections/index.cjs

@@ -3366,6 +3366,26 @@ var toCanonicalEmail = (value) => {
   return local + "@" + domain;
 };
 
+// lib/encrypt.js
+var import_crypto = __toESM(require("crypto"), 1);
+var ALGORITHM = "aes-256-gcm";
+var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
+var decrypt = (value) => {
+  if (typeof value !== "string") return value;
+  const [ivHex, tagHex, dataHex] = value.split(":");
+  const decipher = import_crypto.default.createDecipheriv(
+    ALGORITHM,
+    getKey(),
+    Buffer.from(ivHex, "hex")
+  );
+  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
+  const result = Buffer.concat([
+    decipher.update(Buffer.from(dataHex, "hex")),
+    decipher.final()
+  ]);
+  return JSON.parse(result.toString("utf8"));
+};
+
 // lib/slugify.js
 var import_slugify = __toESM(require("slugify"), 1);
 var slugify = (value, nochars = false) => {
@@ -3420,6 +3440,8 @@ var generateDiscountCode = (0, import_nanoid2.customAlphabet)("0123456789ABCDEFG
 var ORDER_EVENT_HANDLE = slugify("drawbridge-orders");
 var REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1e3;
 var OAUTH_ERROR_SOURCE = "oauth";
+var BILLING_ERROR_SOURCE = "billing";
+var BILLING_ERROR_MESSAGE = "Order billing isn't set up for this store \u2014 reselect and approve the plan from the Shopify connection page.";
 var OAUTH_GRANT_REVOKED_CODES = ["application_cannot_be_found", "invalid_grant"];
 var inbound = {
   headers: {
@@ -3940,6 +3962,9 @@ var shopify_default2 = {
           }
         }
         const billable = (org == null ? void 0 : org.billingProvider) === "shopify" && fee > 0 && !backfill;
+        const providerRow = billable ? await read.get({ collection: "provider", query: { slug: "shopify" } }) : null;
+        const { orderEventHandle } = (providerRow == null ? void 0 : providerRow.settings) ? decrypt(providerRow.settings) : {};
+        const handle = typeof orderEventHandle === "string" && slugify(orderEventHandle) || ORDER_EVENT_HANDLE;
         if (billable && !((_f = connection2 == null ? void 0 : connection2.source) == null ? void 0 : _f.id)) {
           (_g = logger2 == null ? void 0 : logger2.error) == null ? void 0 : _g.call(logger2, new Error(
             "shopify.usage.billing.skipped on order " + orderId + ": " + Math.round(fee * 100) + " cents not billed \u2014 connection " + (connection2 == null ? void 0 : connection2.id) + " has no source.id"
@@ -3958,7 +3983,7 @@ var shopify_default2 = {
             // verify it against the transaction prefix and refuse a
             // drifted pair — idempotency keys are permanent, so a
             // mistraceable event can never be resent under its own key.
-            handle: ORDER_EVENT_HANDLE,
+            handle,
             idempotencyKey: String(orderId),
             orderDocId,
             orderId: String(orderId),
@@ -3968,7 +3993,7 @@ var shopify_default2 = {
             // here — the event handle plus the order id — and sent as the
             // event's `reference`. queue/usage.js stamps the same id onto
             // the order as billed.transaction.
-            transaction: ORDER_EVENT_HANDLE + "." + orderId,
+            transaction: handle + "." + orderId,
             value: Math.round(fee * 100)
           },
           name: "billing",
@@ -4173,6 +4198,46 @@ var shopify_default2 = {
               query: { id: connection2.id }
             });
           }
+          const hasBillingIssue = (connection2.errors || []).some((entry) => entry.source === BILLING_ERROR_SOURCE);
+          if (metered === null && !hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $push: {
+                  errors: {
+                    message: BILLING_ERROR_MESSAGE,
+                    source: BILLING_ERROR_SOURCE
+                  }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+          }
+          if (typeof metered === "string" && hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $pull: {
+                  errors: { source: BILLING_ERROR_SOURCE }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+            writes.push({
+              collection: "connection",
+              data: {
+                $set: { status: "active" }
+              },
+              operation: "update",
+              query: {
+                id: connection2.id,
+                status: "error",
+                "errors.0": { $exists: false }
+              }
+            });
+          }
           return {
             writes,
             enqueues: [{
@@ -4337,7 +4402,15 @@ var shopify_default2 = {
       { input: "text", key: "apiKey", credential: "SHOPIFY_API_KEY", label: "API key", required: true },
       { input: "password", key: "apiSecret", credential: "SHOPIFY_API_SECRET", label: "API secret", redact: true, required: true },
       { input: "text", key: "appHandle", credential: "SHOPIFY_APP_HANDLE", label: "App handle", required: true },
-      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true }
+      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true },
+      // The usage meter's event handle, when the plan config's meter ever
+      // changes: stored value overrides the built-in default
+      // (events.order.handle) at the mint point, and `format : 'slug'`
+      // normalizes it on save — a handle can carry no spaces or capitals,
+      // and classification against it is case-sensitive. Optional: empty
+      // means the default, and the sender still refuses any handle that
+      // disagrees with the transaction it minted.
+      { format: "slug", input: "text", key: "orderEventHandle", label: "Order event handle", required: false, setting: true }
     ]
   },
   // A pre-launch integration: it only surfaces once the App Store listing
@@ -4479,8 +4552,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "pending" ? [
         {
           action: "billing",
-          message: "Approve the Drawbridge plan to activate this connection. You'll confirm the pricing on Shopify, then everything else happens here.",
-          title: "Approve your plan"
+          message: "Approve the Drawbridge plan to activate this connection. You'll be asked to select a plan on Shopify, then everything else happens here.",
+          title: "Approve your plan",
+          type: "warning"
         }
       ] : [],
       // The store's ACTIVE approval carries no usage component — stamped by
@@ -4493,8 +4567,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "active" && ((_a = data2 == null ? void 0 : data2.source) == null ? void 0 : _a.metered) === null ? [
         {
           action: "billing",
-          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. Approve the updated plan to fix it \u2014 one click here, one confirmation on Shopify.",
-          title: "Fix order billing"
+          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. You'll need to reselect your plan on Shopify and approve it to fix this.",
+          title: "Fix order billing",
+          type: "error"
         }
       ] : []
     ];

package/dist/connections/index.d.cts

@@ -7,6 +7,7 @@ import { channels } from '../pricing.cjs';
 import { customAlphabet } from 'nanoid';
 import { toCanonicalEmail } from '../email.cjs';
 import { conversionRate } from '../plans.cjs';
+import { decrypt } from '../encrypt.cjs';
 import { slugify } from '../slugify.cjs';
 import { safeRequest } from '../safe-http.cjs';
 import 'libphonenumber-js';
@@ -19,6 +20,8 @@ import '../index.cjs';
 import 'currency-codes';
 import '../color.cjs';
 import 'tinycolor2';
+import 'crypto';
+import '../token.cjs';
 import 'slugify';
 import 'dns';
 import 'node:http';
@@ -3869,6 +3872,13 @@ const REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1000;
 
 const OAUTH_ERROR_SOURCE = 'oauth';
 
+// The billing Issue a probed-unmetered store carries in its connection
+// errors, written and cleared beside the source.metered stamp (health check
+// and drawbridge-sync's approval restamp share the source tag). One string,
+// used by both writers, so the entries dedupe and $pull cleanly.
+const BILLING_ERROR_SOURCE = 'billing';
+const BILLING_ERROR_MESSAGE = 'Order billing isn\'t set up for this store — reselect and approve the plan from the Shopify connection page.';
+
 // What Shopify says when the merchant has uninstalled or revoked. Neither is
 // retryable and both mean the same thing to a merchant: reconnect.
 const OAUTH_GRANT_REVOKED_CODES = [ 'application_cannot_be_found', 'invalid_grant' ];
@@ -4592,6 +4602,22 @@ var shopify = {
 				// roll back.
 				const billable = org?.billingProvider === 'shopify' && fee > 0 && ! backfill;
 
+				// THE EFFECTIVE METER HANDLE. The provider row's orderEventHandle
+				// (admin-editable, for the day the plan config's meter changes)
+				// overrides the built-in default; slugified again on read as belt
+				// and braces with the save-side formatter, since a drifted stored
+				// value would mint transactions no meter classifies. Read directly
+				// (not via providerSettings — that module imports this one) and
+				// only for a billable order, which keeps the cost off every
+				// ordinary redemption.
+				const providerRow = billable
+					? await read.get({ collection : 'provider', query : { slug : 'shopify' } })
+					: null;
+
+				const { orderEventHandle } = providerRow?.settings ? decrypt( providerRow.settings ) : {};
+
+				const handle = ( typeof orderEventHandle === 'string' && slugify( orderEventHandle ) ) || ORDER_EVENT_HANDLE;
+
 				// A billable order with no shop id is revenue lost SILENTLY — the
 				// gate below just yields no job, the order records normally, and the
 				// connection looks healthy. An Error (not a warn) because this is
@@ -4622,7 +4648,7 @@ var shopify = {
 							// verify it against the transaction prefix and refuse a
 							// drifted pair — idempotency keys are permanent, so a
 							// mistraceable event can never be resent under its own key.
-							handle : ORDER_EVENT_HANDLE,
+							handle,
 							idempotencyKey : String( orderId ),
 							orderDocId,
 							orderId : String( orderId ),
@@ -4632,7 +4658,7 @@ var shopify = {
 							// here — the event handle plus the order id — and sent as the
 							// event's `reference`. queue/usage.js stamps the same id onto
 							// the order as billed.transaction.
-							transaction : ORDER_EVENT_HANDLE + '.' + orderId,
+							transaction : handle + '.' + orderId,
 							value : Math.round( fee * 100 )
 						},
 						name : 'billing',
@@ -4962,6 +4988,63 @@ var shopify = {
 
 					}
 
+					// THE ISSUE MARKER rides beside the stamp: a probed-unmetered
+					// store carries a billing entry in the connection's own errors —
+					// the Issues surface a merchant already knows — and a metered
+					// verdict clears it. Keyed on PRESENCE rather than the verdict
+					// changing, so a connection stamped before this writer existed
+					// still gains its entry on the next run. Status is deliberately
+					// untouched on the way in (orders must keep recording), and the
+					// way out mirrors the resume idiom: reactivate only a connection
+					// that is errored with nothing else wrong.
+					const hasBillingIssue = ( connection.errors || [] ).some( ( entry ) => entry.source === BILLING_ERROR_SOURCE );
+
+					if( metered === null && ! hasBillingIssue ){
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$push : {
+									errors : {
+										message : BILLING_ERROR_MESSAGE,
+										source : BILLING_ERROR_SOURCE
+									}
+								}
+							},
+							operation : 'update',
+							query : { id : connection.id }
+						});
+
+					}
+
+					if( typeof metered === 'string' && hasBillingIssue ){
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$pull : {
+									errors : { source : BILLING_ERROR_SOURCE }
+								}
+							},
+							operation : 'update',
+							query : { id : connection.id }
+						});
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$set : { status : 'active' }
+							},
+							operation : 'update',
+							query : {
+								id : connection.id,
+								status : 'error',
+								'errors.0' : { $exists : false }
+							}
+						});
+
+					}
+
 					return {
 						writes,
 						enqueues : [ {
@@ -5174,7 +5257,15 @@ var shopify = {
 			{ input : 'text', key : 'apiKey', credential : 'SHOPIFY_API_KEY', label : 'API key', required : true },
 			{ input : 'password', key : 'apiSecret', credential : 'SHOPIFY_API_SECRET', label : 'API secret', redact : true, required : true },
 			{ input : 'text', key : 'appHandle', credential : 'SHOPIFY_APP_HANDLE', label : 'App handle', required : true },
-			{ input : 'text', key : 'listingUrl', credential : 'SHOPIFY_APP_LISTING_URL', label : 'App listing URL', required : true }
+			{ input : 'text', key : 'listingUrl', credential : 'SHOPIFY_APP_LISTING_URL', label : 'App listing URL', required : true },
+			// The usage meter's event handle, when the plan config's meter ever
+			// changes: stored value overrides the built-in default
+			// (events.order.handle) at the mint point, and `format : 'slug'`
+			// normalizes it on save — a handle can carry no spaces or capitals,
+			// and classification against it is case-sensitive. Optional: empty
+			// means the default, and the sender still refuses any handle that
+			// disagrees with the transaction it minted.
+			{ format : 'slug', input : 'text', key : 'orderEventHandle', label : 'Order event handle', required : false, setting : true }
 		]
 	},
 	// A pre-launch integration: it only surfaces once the App Store listing
@@ -5326,8 +5417,9 @@ var shopify = {
 			? [
 				{
 					action : 'billing',
-					message : 'Approve the Drawbridge plan to activate this connection. You\'ll confirm the pricing on Shopify, then everything else happens here.',
-					title : 'Approve your plan'
+					message : 'Approve the Drawbridge plan to activate this connection. You\'ll be asked to select a plan on Shopify, then everything else happens here.',
+					title : 'Approve your plan',
+					type : 'warning'
 				}
 			]
 			: []
@@ -5343,8 +5435,9 @@ var shopify = {
 			? [
 				{
 					action : 'billing',
-					message : 'Order billing isn\'t set up for this store, so campaign-attributed orders aren\'t being charged. Approve the updated plan to fix it — one click here, one confirmation on Shopify.',
-					title : 'Fix order billing'
+					message : 'Order billing isn\'t set up for this store, so campaign-attributed orders aren\'t being charged. You\'ll need to reselect your plan on Shopify and approve it to fix this.',
+					title : 'Fix order billing',
+					type : 'error'
 				}
 			]
 			: []

package/dist/connections/index.d.ts

@@ -7,6 +7,7 @@ import { channels } from '../pricing.js';
 import { customAlphabet } from 'nanoid';
 import { toCanonicalEmail } from '../email.js';
 import { conversionRate } from '../plans.js';
+import { decrypt } from '../encrypt.js';
 import { slugify } from '../slugify.js';
 import { safeRequest } from '../safe-http.js';
 import 'libphonenumber-js';
@@ -19,6 +20,8 @@ import '../index.js';
 import 'currency-codes';
 import '../color.js';
 import 'tinycolor2';
+import 'crypto';
+import '../token.js';
 import 'slugify';
 import 'dns';
 import 'node:http';
@@ -3869,6 +3872,13 @@ const REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1000;
 
 const OAUTH_ERROR_SOURCE = 'oauth';
 
+// The billing Issue a probed-unmetered store carries in its connection
+// errors, written and cleared beside the source.metered stamp (health check
+// and drawbridge-sync's approval restamp share the source tag). One string,
+// used by both writers, so the entries dedupe and $pull cleanly.
+const BILLING_ERROR_SOURCE = 'billing';
+const BILLING_ERROR_MESSAGE = 'Order billing isn\'t set up for this store — reselect and approve the plan from the Shopify connection page.';
+
 // What Shopify says when the merchant has uninstalled or revoked. Neither is
 // retryable and both mean the same thing to a merchant: reconnect.
 const OAUTH_GRANT_REVOKED_CODES = [ 'application_cannot_be_found', 'invalid_grant' ];
@@ -4592,6 +4602,22 @@ var shopify = {
 				// roll back.
 				const billable = org?.billingProvider === 'shopify' && fee > 0 && ! backfill;
 
+				// THE EFFECTIVE METER HANDLE. The provider row's orderEventHandle
+				// (admin-editable, for the day the plan config's meter changes)
+				// overrides the built-in default; slugified again on read as belt
+				// and braces with the save-side formatter, since a drifted stored
+				// value would mint transactions no meter classifies. Read directly
+				// (not via providerSettings — that module imports this one) and
+				// only for a billable order, which keeps the cost off every
+				// ordinary redemption.
+				const providerRow = billable
+					? await read.get({ collection : 'provider', query : { slug : 'shopify' } })
+					: null;
+
+				const { orderEventHandle } = providerRow?.settings ? decrypt( providerRow.settings ) : {};
+
+				const handle = ( typeof orderEventHandle === 'string' && slugify( orderEventHandle ) ) || ORDER_EVENT_HANDLE;
+
 				// A billable order with no shop id is revenue lost SILENTLY — the
 				// gate below just yields no job, the order records normally, and the
 				// connection looks healthy. An Error (not a warn) because this is
@@ -4622,7 +4648,7 @@ var shopify = {
 							// verify it against the transaction prefix and refuse a
 							// drifted pair — idempotency keys are permanent, so a
 							// mistraceable event can never be resent under its own key.
-							handle : ORDER_EVENT_HANDLE,
+							handle,
 							idempotencyKey : String( orderId ),
 							orderDocId,
 							orderId : String( orderId ),
@@ -4632,7 +4658,7 @@ var shopify = {
 							// here — the event handle plus the order id — and sent as the
 							// event's `reference`. queue/usage.js stamps the same id onto
 							// the order as billed.transaction.
-							transaction : ORDER_EVENT_HANDLE + '.' + orderId,
+							transaction : handle + '.' + orderId,
 							value : Math.round( fee * 100 )
 						},
 						name : 'billing',
@@ -4962,6 +4988,63 @@ var shopify = {
 
 					}
 
+					// THE ISSUE MARKER rides beside the stamp: a probed-unmetered
+					// store carries a billing entry in the connection's own errors —
+					// the Issues surface a merchant already knows — and a metered
+					// verdict clears it. Keyed on PRESENCE rather than the verdict
+					// changing, so a connection stamped before this writer existed
+					// still gains its entry on the next run. Status is deliberately
+					// untouched on the way in (orders must keep recording), and the
+					// way out mirrors the resume idiom: reactivate only a connection
+					// that is errored with nothing else wrong.
+					const hasBillingIssue = ( connection.errors || [] ).some( ( entry ) => entry.source === BILLING_ERROR_SOURCE );
+
+					if( metered === null && ! hasBillingIssue ){
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$push : {
+									errors : {
+										message : BILLING_ERROR_MESSAGE,
+										source : BILLING_ERROR_SOURCE
+									}
+								}
+							},
+							operation : 'update',
+							query : { id : connection.id }
+						});
+
+					}
+
+					if( typeof metered === 'string' && hasBillingIssue ){
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$pull : {
+									errors : { source : BILLING_ERROR_SOURCE }
+								}
+							},
+							operation : 'update',
+							query : { id : connection.id }
+						});
+
+						writes.push({
+							collection : 'connection',
+							data : {
+								$set : { status : 'active' }
+							},
+							operation : 'update',
+							query : {
+								id : connection.id,
+								status : 'error',
+								'errors.0' : { $exists : false }
+							}
+						});
+
+					}
+
 					return {
 						writes,
 						enqueues : [ {
@@ -5174,7 +5257,15 @@ var shopify = {
 			{ input : 'text', key : 'apiKey', credential : 'SHOPIFY_API_KEY', label : 'API key', required : true },
 			{ input : 'password', key : 'apiSecret', credential : 'SHOPIFY_API_SECRET', label : 'API secret', redact : true, required : true },
 			{ input : 'text', key : 'appHandle', credential : 'SHOPIFY_APP_HANDLE', label : 'App handle', required : true },
-			{ input : 'text', key : 'listingUrl', credential : 'SHOPIFY_APP_LISTING_URL', label : 'App listing URL', required : true }
+			{ input : 'text', key : 'listingUrl', credential : 'SHOPIFY_APP_LISTING_URL', label : 'App listing URL', required : true },
+			// The usage meter's event handle, when the plan config's meter ever
+			// changes: stored value overrides the built-in default
+			// (events.order.handle) at the mint point, and `format : 'slug'`
+			// normalizes it on save — a handle can carry no spaces or capitals,
+			// and classification against it is case-sensitive. Optional: empty
+			// means the default, and the sender still refuses any handle that
+			// disagrees with the transaction it minted.
+			{ format : 'slug', input : 'text', key : 'orderEventHandle', label : 'Order event handle', required : false, setting : true }
 		]
 	},
 	// A pre-launch integration: it only surfaces once the App Store listing
@@ -5326,8 +5417,9 @@ var shopify = {
 			? [
 				{
 					action : 'billing',
-					message : 'Approve the Drawbridge plan to activate this connection. You\'ll confirm the pricing on Shopify, then everything else happens here.',
-					title : 'Approve your plan'
+					message : 'Approve the Drawbridge plan to activate this connection. You\'ll be asked to select a plan on Shopify, then everything else happens here.',
+					title : 'Approve your plan',
+					type : 'warning'
 				}
 			]
 			: []
@@ -5343,8 +5435,9 @@ var shopify = {
 			? [
 				{
 					action : 'billing',
-					message : 'Order billing isn\'t set up for this store, so campaign-attributed orders aren\'t being charged. Approve the updated plan to fix it — one click here, one confirmation on Shopify.',
-					title : 'Fix order billing'
+					message : 'Order billing isn\'t set up for this store, so campaign-attributed orders aren\'t being charged. You\'ll need to reselect your plan on Shopify and approve it to fix this.',
+					title : 'Fix order billing',
+					type : 'error'
 				}
 			]
 			: []

package/dist/connections/index.js

@@ -3292,6 +3292,26 @@ var toCanonicalEmail = (value) => {
   return local + "@" + domain;
 };
 
+// lib/encrypt.js
+import crypto from "crypto";
+var ALGORITHM = "aes-256-gcm";
+var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
+var decrypt = (value) => {
+  if (typeof value !== "string") return value;
+  const [ivHex, tagHex, dataHex] = value.split(":");
+  const decipher = crypto.createDecipheriv(
+    ALGORITHM,
+    getKey(),
+    Buffer.from(ivHex, "hex")
+  );
+  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
+  const result = Buffer.concat([
+    decipher.update(Buffer.from(dataHex, "hex")),
+    decipher.final()
+  ]);
+  return JSON.parse(result.toString("utf8"));
+};
+
 // lib/slugify.js
 import slug from "slugify";
 var slugify = (value, nochars = false) => {
@@ -3346,6 +3366,8 @@ var generateDiscountCode = customAlphabet2("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ
 var ORDER_EVENT_HANDLE = slugify("drawbridge-orders");
 var REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1e3;
 var OAUTH_ERROR_SOURCE = "oauth";
+var BILLING_ERROR_SOURCE = "billing";
+var BILLING_ERROR_MESSAGE = "Order billing isn't set up for this store \u2014 reselect and approve the plan from the Shopify connection page.";
 var OAUTH_GRANT_REVOKED_CODES = ["application_cannot_be_found", "invalid_grant"];
 var inbound = {
   headers: {
@@ -3866,6 +3888,9 @@ var shopify_default2 = {
           }
         }
         const billable = (org == null ? void 0 : org.billingProvider) === "shopify" && fee > 0 && !backfill;
+        const providerRow = billable ? await read.get({ collection: "provider", query: { slug: "shopify" } }) : null;
+        const { orderEventHandle } = (providerRow == null ? void 0 : providerRow.settings) ? decrypt(providerRow.settings) : {};
+        const handle = typeof orderEventHandle === "string" && slugify(orderEventHandle) || ORDER_EVENT_HANDLE;
         if (billable && !((_f = connection2 == null ? void 0 : connection2.source) == null ? void 0 : _f.id)) {
           (_g = logger2 == null ? void 0 : logger2.error) == null ? void 0 : _g.call(logger2, new Error(
             "shopify.usage.billing.skipped on order " + orderId + ": " + Math.round(fee * 100) + " cents not billed \u2014 connection " + (connection2 == null ? void 0 : connection2.id) + " has no source.id"
@@ -3884,7 +3909,7 @@ var shopify_default2 = {
             // verify it against the transaction prefix and refuse a
             // drifted pair — idempotency keys are permanent, so a
             // mistraceable event can never be resent under its own key.
-            handle: ORDER_EVENT_HANDLE,
+            handle,
             idempotencyKey: String(orderId),
             orderDocId,
             orderId: String(orderId),
@@ -3894,7 +3919,7 @@ var shopify_default2 = {
             // here — the event handle plus the order id — and sent as the
             // event's `reference`. queue/usage.js stamps the same id onto
             // the order as billed.transaction.
-            transaction: ORDER_EVENT_HANDLE + "." + orderId,
+            transaction: handle + "." + orderId,
             value: Math.round(fee * 100)
           },
           name: "billing",
@@ -4099,6 +4124,46 @@ var shopify_default2 = {
               query: { id: connection2.id }
             });
           }
+          const hasBillingIssue = (connection2.errors || []).some((entry) => entry.source === BILLING_ERROR_SOURCE);
+          if (metered === null && !hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $push: {
+                  errors: {
+                    message: BILLING_ERROR_MESSAGE,
+                    source: BILLING_ERROR_SOURCE
+                  }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+          }
+          if (typeof metered === "string" && hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $pull: {
+                  errors: { source: BILLING_ERROR_SOURCE }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+            writes.push({
+              collection: "connection",
+              data: {
+                $set: { status: "active" }
+              },
+              operation: "update",
+              query: {
+                id: connection2.id,
+                status: "error",
+                "errors.0": { $exists: false }
+              }
+            });
+          }
           return {
             writes,
             enqueues: [{
@@ -4263,7 +4328,15 @@ var shopify_default2 = {
       { input: "text", key: "apiKey", credential: "SHOPIFY_API_KEY", label: "API key", required: true },
       { input: "password", key: "apiSecret", credential: "SHOPIFY_API_SECRET", label: "API secret", redact: true, required: true },
       { input: "text", key: "appHandle", credential: "SHOPIFY_APP_HANDLE", label: "App handle", required: true },
-      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true }
+      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true },
+      // The usage meter's event handle, when the plan config's meter ever
+      // changes: stored value overrides the built-in default
+      // (events.order.handle) at the mint point, and `format : 'slug'`
+      // normalizes it on save — a handle can carry no spaces or capitals,
+      // and classification against it is case-sensitive. Optional: empty
+      // means the default, and the sender still refuses any handle that
+      // disagrees with the transaction it minted.
+      { format: "slug", input: "text", key: "orderEventHandle", label: "Order event handle", required: false, setting: true }
     ]
   },
   // A pre-launch integration: it only surfaces once the App Store listing
@@ -4405,8 +4478,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "pending" ? [
         {
           action: "billing",
-          message: "Approve the Drawbridge plan to activate this connection. You'll confirm the pricing on Shopify, then everything else happens here.",
-          title: "Approve your plan"
+          message: "Approve the Drawbridge plan to activate this connection. You'll be asked to select a plan on Shopify, then everything else happens here.",
+          title: "Approve your plan",
+          type: "warning"
         }
       ] : [],
       // The store's ACTIVE approval carries no usage component — stamped by
@@ -4419,8 +4493,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "active" && ((_a = data2 == null ? void 0 : data2.source) == null ? void 0 : _a.metered) === null ? [
         {
           action: "billing",
-          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. Approve the updated plan to fix it \u2014 one click here, one confirmation on Shopify.",
-          title: "Fix order billing"
+          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. You'll need to reselect your plan on Shopify and approve it to fix this.",
+          title: "Fix order billing",
+          type: "error"
         }
       ] : []
     ];
@@ -4429,7 +4504,7 @@ var shopify_default2 = {
 };
 
 // lib/connections/providers/webhook.js
-import crypto from "crypto";
+import crypto2 from "crypto";
 
 // lib/safe-http.js
 import dns2 from "dns";
@@ -4664,7 +4739,7 @@ var webhook_default = {
         request2.body = body;
         const outgoing = { ...headers };
         if (settings == null ? void 0 : settings.secret) {
-          outgoing["X-Drawbridge-Signature"] = "sha256=" + crypto.createHmac("sha256", settings.secret).update(JSON.stringify(body)).digest("hex");
+          outgoing["X-Drawbridge-Signature"] = "sha256=" + crypto2.createHmac("sha256", settings.secret).update(JSON.stringify(body)).digest("hex");
         }
         const response = await send2({ body, headers: outgoing, method, url });
         return { message: "Webhook POSTed to " + url + ".", request: request2, response: response || { delivered: true } };

package/dist/providers.cjs

@@ -3272,6 +3272,45 @@ var toCanonicalEmail = (value) => {
   return local + "@" + domain;
 };
 
+// lib/encrypt.js
+var import_crypto2 = __toESM(require("crypto"), 1);
+
+// lib/token.js
+var import_crypto = __toESM(require("crypto"), 1);
+var generate = (bytes = 32, encoding = "base64url") => {
+  const buf = import_crypto.default.randomBytes(bytes);
+  return encoding ? buf.toString(encoding) : buf;
+};
+
+// lib/encrypt.js
+var ALGORITHM = "aes-256-gcm";
+var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
+var encrypt = (value) => {
+  const iv = generate(12, null);
+  const cipher = import_crypto2.default.createCipheriv(ALGORITHM, getKey(), iv);
+  const data2 = Buffer.concat([
+    cipher.update(JSON.stringify(value), "utf8"),
+    cipher.final()
+  ]);
+  const tag = cipher.getAuthTag();
+  return [iv, tag, data2].map((b) => b.toString("hex")).join(":");
+};
+var decrypt = (value) => {
+  if (typeof value !== "string") return value;
+  const [ivHex, tagHex, dataHex] = value.split(":");
+  const decipher = import_crypto2.default.createDecipheriv(
+    ALGORITHM,
+    getKey(),
+    Buffer.from(ivHex, "hex")
+  );
+  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
+  const result = Buffer.concat([
+    decipher.update(Buffer.from(dataHex, "hex")),
+    decipher.final()
+  ]);
+  return JSON.parse(result.toString("utf8"));
+};
+
 // lib/slugify.js
 var import_slugify = __toESM(require("slugify"), 1);
 var slugify = (value, nochars = false) => {
@@ -3326,6 +3365,8 @@ var generateDiscountCode = (0, import_nanoid2.customAlphabet)("0123456789ABCDEFG
 var ORDER_EVENT_HANDLE = slugify("drawbridge-orders");
 var REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1e3;
 var OAUTH_ERROR_SOURCE = "oauth";
+var BILLING_ERROR_SOURCE = "billing";
+var BILLING_ERROR_MESSAGE = "Order billing isn't set up for this store \u2014 reselect and approve the plan from the Shopify connection page.";
 var OAUTH_GRANT_REVOKED_CODES = ["application_cannot_be_found", "invalid_grant"];
 var inbound = {
   headers: {
@@ -3846,6 +3887,9 @@ var shopify_default2 = {
           }
         }
         const billable = (org == null ? void 0 : org.billingProvider) === "shopify" && fee > 0 && !backfill;
+        const providerRow = billable ? await read.get({ collection: "provider", query: { slug: "shopify" } }) : null;
+        const { orderEventHandle } = (providerRow == null ? void 0 : providerRow.settings) ? decrypt(providerRow.settings) : {};
+        const handle = typeof orderEventHandle === "string" && slugify(orderEventHandle) || ORDER_EVENT_HANDLE;
         if (billable && !((_f = connection2 == null ? void 0 : connection2.source) == null ? void 0 : _f.id)) {
           (_g = logger2 == null ? void 0 : logger2.error) == null ? void 0 : _g.call(logger2, new Error(
             "shopify.usage.billing.skipped on order " + orderId + ": " + Math.round(fee * 100) + " cents not billed \u2014 connection " + (connection2 == null ? void 0 : connection2.id) + " has no source.id"
@@ -3864,7 +3908,7 @@ var shopify_default2 = {
             // verify it against the transaction prefix and refuse a
             // drifted pair — idempotency keys are permanent, so a
             // mistraceable event can never be resent under its own key.
-            handle: ORDER_EVENT_HANDLE,
+            handle,
             idempotencyKey: String(orderId),
             orderDocId,
             orderId: String(orderId),
@@ -3874,7 +3918,7 @@ var shopify_default2 = {
             // here — the event handle plus the order id — and sent as the
             // event's `reference`. queue/usage.js stamps the same id onto
             // the order as billed.transaction.
-            transaction: ORDER_EVENT_HANDLE + "." + orderId,
+            transaction: handle + "." + orderId,
             value: Math.round(fee * 100)
           },
           name: "billing",
@@ -4079,6 +4123,46 @@ var shopify_default2 = {
               query: { id: connection2.id }
             });
           }
+          const hasBillingIssue = (connection2.errors || []).some((entry) => entry.source === BILLING_ERROR_SOURCE);
+          if (metered === null && !hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $push: {
+                  errors: {
+                    message: BILLING_ERROR_MESSAGE,
+                    source: BILLING_ERROR_SOURCE
+                  }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+          }
+          if (typeof metered === "string" && hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $pull: {
+                  errors: { source: BILLING_ERROR_SOURCE }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+            writes.push({
+              collection: "connection",
+              data: {
+                $set: { status: "active" }
+              },
+              operation: "update",
+              query: {
+                id: connection2.id,
+                status: "error",
+                "errors.0": { $exists: false }
+              }
+            });
+          }
           return {
             writes,
             enqueues: [{
@@ -4243,7 +4327,15 @@ var shopify_default2 = {
       { input: "text", key: "apiKey", credential: "SHOPIFY_API_KEY", label: "API key", required: true },
       { input: "password", key: "apiSecret", credential: "SHOPIFY_API_SECRET", label: "API secret", redact: true, required: true },
       { input: "text", key: "appHandle", credential: "SHOPIFY_APP_HANDLE", label: "App handle", required: true },
-      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true }
+      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true },
+      // The usage meter's event handle, when the plan config's meter ever
+      // changes: stored value overrides the built-in default
+      // (events.order.handle) at the mint point, and `format : 'slug'`
+      // normalizes it on save — a handle can carry no spaces or capitals,
+      // and classification against it is case-sensitive. Optional: empty
+      // means the default, and the sender still refuses any handle that
+      // disagrees with the transaction it minted.
+      { format: "slug", input: "text", key: "orderEventHandle", label: "Order event handle", required: false, setting: true }
     ]
   },
   // A pre-launch integration: it only surfaces once the App Store listing
@@ -4385,8 +4477,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "pending" ? [
         {
           action: "billing",
-          message: "Approve the Drawbridge plan to activate this connection. You'll confirm the pricing on Shopify, then everything else happens here.",
-          title: "Approve your plan"
+          message: "Approve the Drawbridge plan to activate this connection. You'll be asked to select a plan on Shopify, then everything else happens here.",
+          title: "Approve your plan",
+          type: "warning"
         }
       ] : [],
       // The store's ACTIVE approval carries no usage component — stamped by
@@ -4399,8 +4492,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "active" && ((_a = data2 == null ? void 0 : data2.source) == null ? void 0 : _a.metered) === null ? [
         {
           action: "billing",
-          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. Approve the updated plan to fix it \u2014 one click here, one confirmation on Shopify.",
-          title: "Fix order billing"
+          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. You'll need to reselect your plan on Shopify and approve it to fix this.",
+          title: "Fix order billing",
+          type: "error"
         }
       ] : []
     ];
@@ -4930,45 +5024,6 @@ var publicConnectionKeys = Object.freeze([
   "warnings"
 ]);
 
-// lib/encrypt.js
-var import_crypto2 = __toESM(require("crypto"), 1);
-
-// lib/token.js
-var import_crypto = __toESM(require("crypto"), 1);
-var generate = (bytes = 32, encoding = "base64url") => {
-  const buf = import_crypto.default.randomBytes(bytes);
-  return encoding ? buf.toString(encoding) : buf;
-};
-
-// lib/encrypt.js
-var ALGORITHM = "aes-256-gcm";
-var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
-var encrypt = (value) => {
-  const iv = generate(12, null);
-  const cipher = import_crypto2.default.createCipheriv(ALGORITHM, getKey(), iv);
-  const data2 = Buffer.concat([
-    cipher.update(JSON.stringify(value), "utf8"),
-    cipher.final()
-  ]);
-  const tag = cipher.getAuthTag();
-  return [iv, tag, data2].map((b) => b.toString("hex")).join(":");
-};
-var decrypt = (value) => {
-  if (typeof value !== "string") return value;
-  const [ivHex, tagHex, dataHex] = value.split(":");
-  const decipher = import_crypto2.default.createDecipheriv(
-    ALGORITHM,
-    getKey(),
-    Buffer.from(ivHex, "hex")
-  );
-  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
-  const result = Buffer.concat([
-    decipher.update(Buffer.from(dataHex, "hex")),
-    decipher.final()
-  ]);
-  return JSON.parse(result.toString("utf8"));
-};
-
 // lib/providers.js
 var providerFields = (slug2) => {
   var _a;
@@ -5008,9 +5063,10 @@ var saveProviderSettings = async ({ authenticated, clear, controller, settings,
   });
   const stored = (existing == null ? void 0 : existing.settings) ? decrypt(existing.settings) : {};
   const pasted = (value) => typeof value === "string" ? value.trim().replace(/^['"]+|['"]+$/g, "") : value;
+  const normalized = (field2, value) => field2.format === "slug" && typeof value === "string" && value ? slugify(value) : value;
   const merged = mergeSettings({
     existing: stored,
-    incoming: Object.fromEntries(fields2.map((field2) => [field2.key, pasted(settings == null ? void 0 : settings[field2.key])]))
+    incoming: Object.fromEntries(fields2.map((field2) => [field2.key, normalized(field2, pasted(settings == null ? void 0 : settings[field2.key]))]))
   });
   for (const key of Array.isArray(clear) ? clear : []) {
     if (fields2.some((field2) => field2.key === key)) delete merged[key];

package/dist/providers.d.cts

@@ -1,5 +1,6 @@
 import { connections, mergeSettings } from './connections/index.cjs';
 import { decrypt, encrypt } from './encrypt.cjs';
+import { slugify } from './slugify.cjs';
 import './connections/oauth.cjs';
 import 'node:crypto';
 import './phone.cjs';
@@ -18,8 +19,6 @@ import 'nanoid';
 import './color.cjs';
 import 'tinycolor2';
 import './email.cjs';
-import './slugify.cjs';
-import 'slugify';
 import './safe-http.cjs';
 import 'dns';
 import 'node:http';
@@ -29,6 +28,7 @@ import 'axios';
 import 'net';
 import 'crypto';
 import './token.cjs';
+import 'slugify';
 
 // DRAWBRIDGE'S OWN CREDENTIALS for a vendor, as opposed to a merchant's.
 //
@@ -202,6 +202,17 @@ const saveProviderSettings = async ({ authenticated, clear, controller, settings
 		? value.trim().replace( /^['"]+|['"]+$/g, '' )
 		: value;
 
+	// A field declared `format : 'slug'` is normalized on the way IN — a value
+	// like Shopify's meter event handle can legally hold no spaces or capitals,
+	// and classification against it is case-sensitive, so the stored copy is
+	// forced into the only shape the vendor accepts rather than trusting the
+	// admin's typing.
+	const normalized = ( field, value ) => (
+		field.format === 'slug' && typeof value === 'string' && value
+			? slugify( value )
+			: value
+	);
+
 	// mergeSettings is the blank-keeps rule, already used for merchant
 	// connection settings in route/organization-connection.js — same behaviour,
 	// one implementation. The declared-field allowlist is the part that is ours:
@@ -209,7 +220,7 @@ const saveProviderSettings = async ({ authenticated, clear, controller, settings
 	// not declare reaching the document.
 	const merged = mergeSettings({
 		existing : stored,
-		incoming : Object.fromEntries( fields.map( ( field ) => [ field.key, pasted( settings?.[ field.key ] ) ] ) )
+		incoming : Object.fromEntries( fields.map( ( field ) => [ field.key, normalized( field, pasted( settings?.[ field.key ] ) ) ] ) )
 	});
 
 	// CLEARING IS EXPLICIT, because blank already means keep and the two cannot

package/dist/providers.d.ts

@@ -1,5 +1,6 @@
 import { connections, mergeSettings } from './connections/index.js';
 import { decrypt, encrypt } from './encrypt.js';
+import { slugify } from './slugify.js';
 import './connections/oauth.js';
 import 'node:crypto';
 import './phone.js';
@@ -18,8 +19,6 @@ import 'nanoid';
 import './color.js';
 import 'tinycolor2';
 import './email.js';
-import './slugify.js';
-import 'slugify';
 import './safe-http.js';
 import 'dns';
 import 'node:http';
@@ -29,6 +28,7 @@ import 'axios';
 import 'net';
 import 'crypto';
 import './token.js';
+import 'slugify';
 
 // DRAWBRIDGE'S OWN CREDENTIALS for a vendor, as opposed to a merchant's.
 //
@@ -202,6 +202,17 @@ const saveProviderSettings = async ({ authenticated, clear, controller, settings
 		? value.trim().replace( /^['"]+|['"]+$/g, '' )
 		: value;
 
+	// A field declared `format : 'slug'` is normalized on the way IN — a value
+	// like Shopify's meter event handle can legally hold no spaces or capitals,
+	// and classification against it is case-sensitive, so the stored copy is
+	// forced into the only shape the vendor accepts rather than trusting the
+	// admin's typing.
+	const normalized = ( field, value ) => (
+		field.format === 'slug' && typeof value === 'string' && value
+			? slugify( value )
+			: value
+	);
+
 	// mergeSettings is the blank-keeps rule, already used for merchant
 	// connection settings in route/organization-connection.js — same behaviour,
 	// one implementation. The declared-field allowlist is the part that is ours:
@@ -209,7 +220,7 @@ const saveProviderSettings = async ({ authenticated, clear, controller, settings
 	// not declare reaching the document.
 	const merged = mergeSettings({
 		existing : stored,
-		incoming : Object.fromEntries( fields.map( ( field ) => [ field.key, pasted( settings?.[ field.key ] ) ] ) )
+		incoming : Object.fromEntries( fields.map( ( field ) => [ field.key, normalized( field, pasted( settings?.[ field.key ] ) ) ] ) )
 	});
 
 	// CLEARING IS EXPLICIT, because blank already means keep and the two cannot

package/dist/providers.js

@@ -3228,6 +3228,45 @@ var toCanonicalEmail = (value) => {
   return local + "@" + domain;
 };
 
+// lib/encrypt.js
+import crypto2 from "crypto";
+
+// lib/token.js
+import crypto from "crypto";
+var generate = (bytes = 32, encoding = "base64url") => {
+  const buf = crypto.randomBytes(bytes);
+  return encoding ? buf.toString(encoding) : buf;
+};
+
+// lib/encrypt.js
+var ALGORITHM = "aes-256-gcm";
+var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
+var encrypt = (value) => {
+  const iv = generate(12, null);
+  const cipher = crypto2.createCipheriv(ALGORITHM, getKey(), iv);
+  const data2 = Buffer.concat([
+    cipher.update(JSON.stringify(value), "utf8"),
+    cipher.final()
+  ]);
+  const tag = cipher.getAuthTag();
+  return [iv, tag, data2].map((b) => b.toString("hex")).join(":");
+};
+var decrypt = (value) => {
+  if (typeof value !== "string") return value;
+  const [ivHex, tagHex, dataHex] = value.split(":");
+  const decipher = crypto2.createDecipheriv(
+    ALGORITHM,
+    getKey(),
+    Buffer.from(ivHex, "hex")
+  );
+  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
+  const result = Buffer.concat([
+    decipher.update(Buffer.from(dataHex, "hex")),
+    decipher.final()
+  ]);
+  return JSON.parse(result.toString("utf8"));
+};
+
 // lib/slugify.js
 import slug from "slugify";
 var slugify = (value, nochars = false) => {
@@ -3282,6 +3321,8 @@ var generateDiscountCode = customAlphabet2("0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ
 var ORDER_EVENT_HANDLE = slugify("drawbridge-orders");
 var REFRESH_TOKEN_FRESHNESS_BUFFER_MS = 5 * 24 * 60 * 60 * 1e3;
 var OAUTH_ERROR_SOURCE = "oauth";
+var BILLING_ERROR_SOURCE = "billing";
+var BILLING_ERROR_MESSAGE = "Order billing isn't set up for this store \u2014 reselect and approve the plan from the Shopify connection page.";
 var OAUTH_GRANT_REVOKED_CODES = ["application_cannot_be_found", "invalid_grant"];
 var inbound = {
   headers: {
@@ -3802,6 +3843,9 @@ var shopify_default2 = {
           }
         }
         const billable = (org == null ? void 0 : org.billingProvider) === "shopify" && fee > 0 && !backfill;
+        const providerRow = billable ? await read.get({ collection: "provider", query: { slug: "shopify" } }) : null;
+        const { orderEventHandle } = (providerRow == null ? void 0 : providerRow.settings) ? decrypt(providerRow.settings) : {};
+        const handle = typeof orderEventHandle === "string" && slugify(orderEventHandle) || ORDER_EVENT_HANDLE;
         if (billable && !((_f = connection2 == null ? void 0 : connection2.source) == null ? void 0 : _f.id)) {
           (_g = logger2 == null ? void 0 : logger2.error) == null ? void 0 : _g.call(logger2, new Error(
             "shopify.usage.billing.skipped on order " + orderId + ": " + Math.round(fee * 100) + " cents not billed \u2014 connection " + (connection2 == null ? void 0 : connection2.id) + " has no source.id"
@@ -3820,7 +3864,7 @@ var shopify_default2 = {
             // verify it against the transaction prefix and refuse a
             // drifted pair — idempotency keys are permanent, so a
             // mistraceable event can never be resent under its own key.
-            handle: ORDER_EVENT_HANDLE,
+            handle,
             idempotencyKey: String(orderId),
             orderDocId,
             orderId: String(orderId),
@@ -3830,7 +3874,7 @@ var shopify_default2 = {
             // here — the event handle plus the order id — and sent as the
             // event's `reference`. queue/usage.js stamps the same id onto
             // the order as billed.transaction.
-            transaction: ORDER_EVENT_HANDLE + "." + orderId,
+            transaction: handle + "." + orderId,
             value: Math.round(fee * 100)
           },
           name: "billing",
@@ -4035,6 +4079,46 @@ var shopify_default2 = {
               query: { id: connection2.id }
             });
           }
+          const hasBillingIssue = (connection2.errors || []).some((entry) => entry.source === BILLING_ERROR_SOURCE);
+          if (metered === null && !hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $push: {
+                  errors: {
+                    message: BILLING_ERROR_MESSAGE,
+                    source: BILLING_ERROR_SOURCE
+                  }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+          }
+          if (typeof metered === "string" && hasBillingIssue) {
+            writes.push({
+              collection: "connection",
+              data: {
+                $pull: {
+                  errors: { source: BILLING_ERROR_SOURCE }
+                }
+              },
+              operation: "update",
+              query: { id: connection2.id }
+            });
+            writes.push({
+              collection: "connection",
+              data: {
+                $set: { status: "active" }
+              },
+              operation: "update",
+              query: {
+                id: connection2.id,
+                status: "error",
+                "errors.0": { $exists: false }
+              }
+            });
+          }
           return {
             writes,
             enqueues: [{
@@ -4199,7 +4283,15 @@ var shopify_default2 = {
       { input: "text", key: "apiKey", credential: "SHOPIFY_API_KEY", label: "API key", required: true },
       { input: "password", key: "apiSecret", credential: "SHOPIFY_API_SECRET", label: "API secret", redact: true, required: true },
       { input: "text", key: "appHandle", credential: "SHOPIFY_APP_HANDLE", label: "App handle", required: true },
-      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true }
+      { input: "text", key: "listingUrl", credential: "SHOPIFY_APP_LISTING_URL", label: "App listing URL", required: true },
+      // The usage meter's event handle, when the plan config's meter ever
+      // changes: stored value overrides the built-in default
+      // (events.order.handle) at the mint point, and `format : 'slug'`
+      // normalizes it on save — a handle can carry no spaces or capitals,
+      // and classification against it is case-sensitive. Optional: empty
+      // means the default, and the sender still refuses any handle that
+      // disagrees with the transaction it minted.
+      { format: "slug", input: "text", key: "orderEventHandle", label: "Order event handle", required: false, setting: true }
     ]
   },
   // A pre-launch integration: it only surfaces once the App Store listing
@@ -4341,8 +4433,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "pending" ? [
         {
           action: "billing",
-          message: "Approve the Drawbridge plan to activate this connection. You'll confirm the pricing on Shopify, then everything else happens here.",
-          title: "Approve your plan"
+          message: "Approve the Drawbridge plan to activate this connection. You'll be asked to select a plan on Shopify, then everything else happens here.",
+          title: "Approve your plan",
+          type: "warning"
         }
       ] : [],
       // The store's ACTIVE approval carries no usage component — stamped by
@@ -4355,8 +4448,9 @@ var shopify_default2 = {
       ...(data2 == null ? void 0 : data2.status) === "active" && ((_a = data2 == null ? void 0 : data2.source) == null ? void 0 : _a.metered) === null ? [
         {
           action: "billing",
-          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. Approve the updated plan to fix it \u2014 one click here, one confirmation on Shopify.",
-          title: "Fix order billing"
+          message: "Order billing isn't set up for this store, so campaign-attributed orders aren't being charged. You'll need to reselect your plan on Shopify and approve it to fix this.",
+          title: "Fix order billing",
+          type: "error"
         }
       ] : []
     ];
@@ -4365,7 +4459,7 @@ var shopify_default2 = {
 };
 
 // lib/connections/providers/webhook.js
-import crypto from "crypto";
+import crypto3 from "crypto";
 
 // lib/safe-http.js
 import dns2 from "dns";
@@ -4600,7 +4694,7 @@ var webhook_default = {
         request2.body = body;
         const outgoing = { ...headers };
         if (settings == null ? void 0 : settings.secret) {
-          outgoing["X-Drawbridge-Signature"] = "sha256=" + crypto.createHmac("sha256", settings.secret).update(JSON.stringify(body)).digest("hex");
+          outgoing["X-Drawbridge-Signature"] = "sha256=" + crypto3.createHmac("sha256", settings.secret).update(JSON.stringify(body)).digest("hex");
         }
         const response = await send2({ body, headers: outgoing, method, url });
         return { message: "Webhook POSTed to " + url + ".", request: request2, response: response || { delivered: true } };
@@ -4886,45 +4980,6 @@ var publicConnectionKeys = Object.freeze([
   "warnings"
 ]);
 
-// lib/encrypt.js
-import crypto3 from "crypto";
-
-// lib/token.js
-import crypto2 from "crypto";
-var generate = (bytes = 32, encoding = "base64url") => {
-  const buf = crypto2.randomBytes(bytes);
-  return encoding ? buf.toString(encoding) : buf;
-};
-
-// lib/encrypt.js
-var ALGORITHM = "aes-256-gcm";
-var getKey = () => Buffer.from(process.env.ENCRYPT_CONNECTION_SECRET, "hex");
-var encrypt = (value) => {
-  const iv = generate(12, null);
-  const cipher = crypto3.createCipheriv(ALGORITHM, getKey(), iv);
-  const data2 = Buffer.concat([
-    cipher.update(JSON.stringify(value), "utf8"),
-    cipher.final()
-  ]);
-  const tag = cipher.getAuthTag();
-  return [iv, tag, data2].map((b) => b.toString("hex")).join(":");
-};
-var decrypt = (value) => {
-  if (typeof value !== "string") return value;
-  const [ivHex, tagHex, dataHex] = value.split(":");
-  const decipher = crypto3.createDecipheriv(
-    ALGORITHM,
-    getKey(),
-    Buffer.from(ivHex, "hex")
-  );
-  decipher.setAuthTag(Buffer.from(tagHex, "hex"));
-  const result = Buffer.concat([
-    decipher.update(Buffer.from(dataHex, "hex")),
-    decipher.final()
-  ]);
-  return JSON.parse(result.toString("utf8"));
-};
-
 // lib/providers.js
 var providerFields = (slug2) => {
   var _a;
@@ -4964,9 +5019,10 @@ var saveProviderSettings = async ({ authenticated, clear, controller, settings,
   });
   const stored = (existing == null ? void 0 : existing.settings) ? decrypt(existing.settings) : {};
   const pasted = (value) => typeof value === "string" ? value.trim().replace(/^['"]+|['"]+$/g, "") : value;
+  const normalized = (field2, value) => field2.format === "slug" && typeof value === "string" && value ? slugify(value) : value;
   const merged = mergeSettings({
     existing: stored,
-    incoming: Object.fromEntries(fields2.map((field2) => [field2.key, pasted(settings == null ? void 0 : settings[field2.key])]))
+    incoming: Object.fromEntries(fields2.map((field2) => [field2.key, normalized(field2, pasted(settings == null ? void 0 : settings[field2.key]))]))
   });
   for (const key of Array.isArray(clear) ? clear : []) {
     if (fields2.some((field2) => field2.key === key)) delete merged[key];

package/package.json

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