@drawbridge/drawbridge-utils 0.0.111 → 0.0.114

package/dist/sendgrid.js

@@ -0,0 +1,140 @@
+// lib/http.js
+var DEFAULT_TIMEOUT_MS = 15e3;
+var request = async ({
+  body,
+  headers = {},
+  method = "GET",
+  query,
+  timeout = DEFAULT_TIMEOUT_MS,
+  type = "json",
+  url
+}) => {
+  const fullUrl = new URL(url);
+  if (query) {
+    Object.entries(query).forEach(([k, v]) => fullUrl.searchParams.set(k, v));
+  }
+  ;
+  const isForm = type === "form";
+  const response = await fetch(fullUrl.toString(), {
+    method,
+    headers: {
+      "Content-Type": isForm ? "application/x-www-form-urlencoded" : "application/json",
+      ...headers
+    },
+    signal: AbortSignal.timeout(timeout),
+    ...body !== void 0 && {
+      body: isForm ? new URLSearchParams(body).toString() : JSON.stringify(body)
+    }
+  });
+  if (!response.ok) {
+    const text2 = await response.text().catch(() => "");
+    const error = new Error(text2 || response.statusText);
+    error.status = response.status;
+    throw error;
+  }
+  ;
+  const text = await response.text();
+  try {
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+};
+
+// lib/sendgrid.js
+import { createLogger } from "@drawbridge/drawbridge-telemetry";
+var logger = createLogger();
+var SENDGRID_BASE = "https://api.sendgrid.com";
+var RETRYABLE_STATUSES = [429, 500, 502, 503];
+var RETRY_DELAYS_MS = [1e3, 4e3];
+var sendWithRetry = async (send, { delays = RETRY_DELAYS_MS } = {}) => {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      return await send();
+    } catch (error) {
+      const status = Number(error == null ? void 0 : error.status);
+      const retryable = RETRYABLE_STATUSES.includes(status);
+      if (!retryable || attempt >= delays.length) {
+        if (!status) {
+          logger.warn("email.send.ambiguous-failure", {
+            name: error == null ? void 0 : error.name,
+            message: error == null ? void 0 : error.message
+          });
+        }
+        throw error;
+      }
+      logger.info("email.send.retry", {
+        attempt: attempt + 1,
+        status,
+        delayMs: delays[attempt]
+      });
+      await new Promise((resolve) => setTimeout(resolve, delays[attempt]));
+    }
+  }
+};
+var sendgridRequest = ({ apiKey, body, method, path, query, request: request2 = request }) => {
+  const key = apiKey || process.env.SENDGRID_API_KEY;
+  return request2({
+    body,
+    headers: {
+      "Authorization": "Bearer " + key
+    },
+    method,
+    query,
+    url: SENDGRID_BASE + path
+  });
+};
+var sendgrid = {
+  // `headers` (optional) carries the List-Unsubscribe pair on lead-facing
+  // commercial sends; omitted, the request body is byte-identical to the
+  // pre-opt-out-floor shape so system mail is untouched.
+  send: async ({ apiKey, from, headers, html, request: request2, subject, text, to }) => {
+    var _a, _b;
+    try {
+      const sender = (from == null ? void 0 : from.email) ? from : {
+        email: process.env.SENDGRID_FROM_ADDRESS,
+        name: "Drawbridge"
+      };
+      await sendWithRetry(() => sendgridRequest({
+        apiKey,
+        ...request2 && { request: request2 },
+        method: "POST",
+        path: "/v3/mail/send",
+        body: {
+          content: [
+            {
+              type: "text/plain",
+              value: text
+            },
+            {
+              type: "text/html",
+              value: html
+            }
+          ],
+          from: sender,
+          ...headers && { headers },
+          personalizations: [
+            {
+              to: [
+                { email: to }
+              ]
+            }
+          ],
+          subject
+        }
+      }));
+    } catch (error) {
+      try {
+        const parsed = JSON.parse(error.message);
+        if ((_b = (_a = parsed == null ? void 0 : parsed.errors) == null ? void 0 : _a[0]) == null ? void 0 : _b.message) error.message = parsed.errors[0].message;
+      } catch {
+      }
+      throw error;
+    }
+  }
+};
+export {
+  sendWithRetry,
+  sendgrid,
+  sendgridRequest
+};

package/dist/twilio.cjs

@@ -0,0 +1,112 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// lib/twilio.js
+var twilio_exports = {};
+__export(twilio_exports, {
+  twilio: () => twilio
+});
+module.exports = __toCommonJS(twilio_exports);
+
+// lib/http.js
+var DEFAULT_TIMEOUT_MS = 15e3;
+var request = async ({
+  body,
+  headers = {},
+  method = "GET",
+  query,
+  timeout = DEFAULT_TIMEOUT_MS,
+  type = "json",
+  url
+}) => {
+  const fullUrl = new URL(url);
+  if (query) {
+    Object.entries(query).forEach(([k, v]) => fullUrl.searchParams.set(k, v));
+  }
+  ;
+  const isForm = type === "form";
+  const response = await fetch(fullUrl.toString(), {
+    method,
+    headers: {
+      "Content-Type": isForm ? "application/x-www-form-urlencoded" : "application/json",
+      ...headers
+    },
+    signal: AbortSignal.timeout(timeout),
+    ...body !== void 0 && {
+      body: isForm ? new URLSearchParams(body).toString() : JSON.stringify(body)
+    }
+  });
+  if (!response.ok) {
+    const text2 = await response.text().catch(() => "");
+    const error = new Error(text2 || response.statusText);
+    error.status = response.status;
+    throw error;
+  }
+  ;
+  const text = await response.text();
+  try {
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+};
+
+// lib/twilio.js
+var twilio = {
+  sms: async ({
+    accountSid,
+    authToken,
+    from,
+    link,
+    message,
+    optOut = false,
+    prize,
+    // Injectable for the same reason sendgrid's is — see sendgrid.js.
+    request: request2 = request,
+    title,
+    to
+  }) => {
+    accountSid = accountSid || process.env.TWILIO_ACCOUNT_SID;
+    authToken = authToken || process.env.TWILIO_AUTH_TOKEN;
+    from = from || process.env.TWILIO_ACCOUNT_FROM;
+    const body = [
+      title,
+      message,
+      ...prize ? [prize.title + " (" + prize.value + ")"] : [],
+      ...link ? ["Verify here: " + link] : [],
+      ...optOut ? ["Reply STOP to opt out"] : []
+    ].filter(Boolean).join("\n");
+    return await request2({
+      method: "POST",
+      type: "form",
+      url: "https://api.twilio.com/2010-04-01/Accounts/" + accountSid + "/Messages.json",
+      headers: {
+        "Authorization": "Basic " + Buffer.from(accountSid + ":" + authToken).toString("base64")
+      },
+      body: {
+        Body: body,
+        From: from,
+        To: to
+      }
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  twilio
+});

package/dist/twilio.d.cts

@@ -0,0 +1,64 @@
+import { request } from './http.cjs';
+
+// TWILIO TRANSPORT. Vendor HTTP and nothing else, for the same reason SendGrid
+// sits beside it — see sendgrid.js.
+//
+// The message COMPOSITION is here too, deliberately: the newline-separated
+// shape, brand-first ordering and the absence of "Your prize is" / "Click here
+// to verify" phrasing are carrier-filter avoidance that got these messages
+// flagged once. That is a property of sending SMS, not of any one caller, and
+// splitting it from the transport is how one caller quietly reverts it.
+
+
+const twilio = {
+
+	sms : async ({
+		accountSid,
+		authToken,
+		from,
+		link,
+		message,
+		optOut = false,
+		prize,
+		// Injectable for the same reason sendgrid's is — see sendgrid.js.
+		request: request$1 = request,
+		title,
+		to
+	}) => {
+
+		accountSid = accountSid || process.env.TWILIO_ACCOUNT_SID;
+		authToken = authToken || process.env.TWILIO_AUTH_TOKEN;
+		from = from || process.env.TWILIO_ACCOUNT_FROM;
+
+		// Newline-separated, brand/title first, and no "Your prize is" /
+		// "Click here to verify your prize" phrasing — textbook carrier-filter
+		// bait that got these messages flagged. The opt-out line is appended
+		// on lead-facing sends (carrier compliance); OTC/auth sends pass
+		// nothing new and keep their exact copy.
+		const body = [
+			title,
+			message,
+			...( prize ? [ prize.title + ' (' + prize.value + ')' ] : [] ),
+			...( link ? [ 'Verify here: ' + link ] : [] ),
+			...( optOut ? [ 'Reply STOP to opt out' ] : [] )
+		].filter( Boolean ).join( '\n' );
+
+		return await request$1({
+			method : 'POST',
+			type : 'form',
+			url : 'https://api.twilio.com/2010-04-01/Accounts/' + accountSid + '/Messages.json',
+			headers : {
+				'Authorization' : 'Basic ' + Buffer.from( accountSid + ':' + authToken ).toString( 'base64' )
+			},
+			body : {
+				Body : body,
+				From : from,
+				To : to
+			}
+		});
+
+	}
+
+};
+
+export { twilio };

package/dist/twilio.d.ts

@@ -0,0 +1,64 @@
+import { request } from './http.js';
+
+// TWILIO TRANSPORT. Vendor HTTP and nothing else, for the same reason SendGrid
+// sits beside it — see sendgrid.js.
+//
+// The message COMPOSITION is here too, deliberately: the newline-separated
+// shape, brand-first ordering and the absence of "Your prize is" / "Click here
+// to verify" phrasing are carrier-filter avoidance that got these messages
+// flagged once. That is a property of sending SMS, not of any one caller, and
+// splitting it from the transport is how one caller quietly reverts it.
+
+
+const twilio = {
+
+	sms : async ({
+		accountSid,
+		authToken,
+		from,
+		link,
+		message,
+		optOut = false,
+		prize,
+		// Injectable for the same reason sendgrid's is — see sendgrid.js.
+		request: request$1 = request,
+		title,
+		to
+	}) => {
+
+		accountSid = accountSid || process.env.TWILIO_ACCOUNT_SID;
+		authToken = authToken || process.env.TWILIO_AUTH_TOKEN;
+		from = from || process.env.TWILIO_ACCOUNT_FROM;
+
+		// Newline-separated, brand/title first, and no "Your prize is" /
+		// "Click here to verify your prize" phrasing — textbook carrier-filter
+		// bait that got these messages flagged. The opt-out line is appended
+		// on lead-facing sends (carrier compliance); OTC/auth sends pass
+		// nothing new and keep their exact copy.
+		const body = [
+			title,
+			message,
+			...( prize ? [ prize.title + ' (' + prize.value + ')' ] : [] ),
+			...( link ? [ 'Verify here: ' + link ] : [] ),
+			...( optOut ? [ 'Reply STOP to opt out' ] : [] )
+		].filter( Boolean ).join( '\n' );
+
+		return await request$1({
+			method : 'POST',
+			type : 'form',
+			url : 'https://api.twilio.com/2010-04-01/Accounts/' + accountSid + '/Messages.json',
+			headers : {
+				'Authorization' : 'Basic ' + Buffer.from( accountSid + ':' + authToken ).toString( 'base64' )
+			},
+			body : {
+				Body : body,
+				From : from,
+				To : to
+			}
+		});
+
+	}
+
+};
+
+export { twilio };

package/dist/twilio.js

@@ -0,0 +1,86 @@
+// lib/http.js
+var DEFAULT_TIMEOUT_MS = 15e3;
+var request = async ({
+  body,
+  headers = {},
+  method = "GET",
+  query,
+  timeout = DEFAULT_TIMEOUT_MS,
+  type = "json",
+  url
+}) => {
+  const fullUrl = new URL(url);
+  if (query) {
+    Object.entries(query).forEach(([k, v]) => fullUrl.searchParams.set(k, v));
+  }
+  ;
+  const isForm = type === "form";
+  const response = await fetch(fullUrl.toString(), {
+    method,
+    headers: {
+      "Content-Type": isForm ? "application/x-www-form-urlencoded" : "application/json",
+      ...headers
+    },
+    signal: AbortSignal.timeout(timeout),
+    ...body !== void 0 && {
+      body: isForm ? new URLSearchParams(body).toString() : JSON.stringify(body)
+    }
+  });
+  if (!response.ok) {
+    const text2 = await response.text().catch(() => "");
+    const error = new Error(text2 || response.statusText);
+    error.status = response.status;
+    throw error;
+  }
+  ;
+  const text = await response.text();
+  try {
+    return text ? JSON.parse(text) : null;
+  } catch {
+    return null;
+  }
+};
+
+// lib/twilio.js
+var twilio = {
+  sms: async ({
+    accountSid,
+    authToken,
+    from,
+    link,
+    message,
+    optOut = false,
+    prize,
+    // Injectable for the same reason sendgrid's is — see sendgrid.js.
+    request: request2 = request,
+    title,
+    to
+  }) => {
+    accountSid = accountSid || process.env.TWILIO_ACCOUNT_SID;
+    authToken = authToken || process.env.TWILIO_AUTH_TOKEN;
+    from = from || process.env.TWILIO_ACCOUNT_FROM;
+    const body = [
+      title,
+      message,
+      ...prize ? [prize.title + " (" + prize.value + ")"] : [],
+      ...link ? ["Verify here: " + link] : [],
+      ...optOut ? ["Reply STOP to opt out"] : []
+    ].filter(Boolean).join("\n");
+    return await request2({
+      method: "POST",
+      type: "form",
+      url: "https://api.twilio.com/2010-04-01/Accounts/" + accountSid + "/Messages.json",
+      headers: {
+        "Authorization": "Basic " + Buffer.from(accountSid + ":" + authToken).toString("base64")
+      },
+      body: {
+        Body: body,
+        From: from,
+        To: to
+      }
+    });
+  }
+};
+export {
+  twilio
+};

package/package.json

@@ -133,6 +133,16 @@
       "import": "./dist/fetch.js",
       "require": "./dist/fetch.cjs"
     },
+    "./sendgrid": {
+      "types": "./dist/sendgrid.d.ts",
+      "import": "./dist/sendgrid.js",
+      "require": "./dist/sendgrid.cjs"
+    },
+    "./twilio": {
+      "types": "./dist/twilio.d.ts",
+      "import": "./dist/twilio.js",
+      "require": "./dist/twilio.cjs"
+    },
     "./http": {
       "types": "./dist/http.d.ts",
       "import": "./dist/http.js",
@@ -200,5 +210,5 @@
     "test": ". \"$HOME/.nvm/nvm.sh\" && nvm use && node --test"
   },
   "types": "dist/index.d.ts",
-  "version": "0.0.111"
+  "version": "0.0.114"
 }