waha-shared 1.0.544 → 1.0.545

package/README.md

@@ -37,7 +37,7 @@ data/languages/
 
 ## Type Generation Pipeline
 
-Types flow through a pipeline managed by `npm run prep`:
+Types flow through a pipeline managed by `pnpm prep`:
 
 ```text
 Zod schema (.zod.ts) and raw data file (.json)
@@ -47,12 +47,12 @@ Zod schema (.zod.ts) and raw data file (.json)
   → TypeScript index.ts
 ```
 
-When you modify a `.zod.ts` file, run `npm run prep` from the repo root to regenerate everything downstream.
+When you modify a `.zod.ts` file, run `pnpm prep` from the repo root to regenerate everything downstream.
 
 ## Building & Publishing
 
 ```bash
-npm run update
+pnpm publish:latest
 ```
 
 This will update the `dist` folder, commit changes, and publish to the npm registry.
@@ -64,4 +64,4 @@ The `dist/` directory is the build output — never edit files in it directly.
 1. Create a new directory under `data/`, e.g. `data/myNewData/`
 2. Add the raw JSON file: `myNewData.json`
 3. Define the Zod schema: `myNewData.zod.ts`
-4. Run `npm run prep` to auto-generate the JSON schema, Python types, Python data, and index file
+4. Run `pnpm prep` to auto-generate the JSON schema, Python types, Python data, and index file

package/dist/functions/resend.d.ts

@@ -1,6 +1,6 @@
-import { type ErrorResponse as ResendErrorResponse } from 'resend';
-import { type DripEmailId, type DripLanguageId } from '../types/resend';
+import { type Contact, type ListEmail, type ErrorResponse as ResendErrorResponse } from 'resend';
 import type { DripSequenceId } from '../types/dripSequence';
+import { type DripEmailId, type DripLanguageId } from '../types/resend';
 /**
  * Rate limits and server errors. Network failures (no status code) aren't
  * retried: the request may have landed, and repeating a create or an event
@@ -79,11 +79,34 @@ export declare function createResendContact({ token, email, name, }: {
  * `segmentId` is given. Read-only.
  */
 export declare function listContactEmails(token: string, segmentId?: string): Promise<Set<string>>;
+/**
+ * Every contact, or only those in one segment when `segmentId` is given. The
+ * list omits a contact's properties and topics; those take a call per contact.
+ * Read-only.
+ */
+export declare function listContacts(token: string, segmentId?: string): Promise<Contact[]>;
+/** A contact's custom property values, by key. Read-only. */
+export declare function getContactProperties(token: string, contactId: string): Promise<Record<string, string | number>>;
+/**
+ * Every email sent since a time, newest first. Includes each recipient's copy
+ * of a broadcast as well as emails sent through the API and automations.
+ * Read-only.
+ */
+export declare function listEmailsSince(token: string, since: Date): Promise<ListEmail[]>;
 /** Every segment's id and name. Read-only. */
 export declare function listSegments(token: string): Promise<{
     id: string;
     name: string;
 }[]>;
+/** Every template's name, by template id. Read-only. */
+export declare function listTemplateNames(token: string): Promise<Map<string, string>>;
+/**
+ * The template behind each email automations sent since a time, by email id.
+ * An email's own record doesn't say, so this reads it from the send steps of
+ * every automation run that could have sent one since then: those still
+ * running, and those that finished since. Read-only.
+ */
+export declare function listAutomationEmailTemplates(token: string, since: Date): Promise<Map<string, string>>;
 /** Creates a segment and returns its id. */
 export declare function createSegment(token: string, name: string): Promise<string>;
 /**

package/dist/functions/resend.mjs

@@ -9,7 +9,10 @@ import "../chunks/chunk-5WXWDALL.mjs";
 import "../chunks/chunk-5AVXA5JL.mjs";
 
 // functions/resend.ts
-import { Resend } from "resend";
+import {
+  Resend
+} from "resend";
+import z from "zod";
 function isRetryable(error) {
   const status = error.statusCode;
   return status !== null && (status === 429 || status >= 500);
@@ -22,6 +25,19 @@ async function withRetry(call) {
     await new Promise((resolve) => setTimeout(resolve, attempt * 500));
   }
 }
+async function listAll(fetchPage, what) {
+  const items = [];
+  for (let after; ; ) {
+    const page = verify(
+      await withRetry(() => fetchPage(after)),
+      `Listing ${what} after ${after ?? "the start"}`
+    );
+    items.push(...page.data);
+    const last = page.data[page.data.length - 1];
+    if (!page.has_more || !last) return items;
+    after = last.id;
+  }
+}
 function verify(result, context) {
   if (result.error) throw new Error(`${context}: ${result.error.message}`);
   if (!result.data) throw new Error(`${context}: Resend returned no data.`);
@@ -94,20 +110,47 @@ async function createResendContact({
   ).id;
 }
 async function listContactEmails(token, segmentId) {
+  const contacts = await listContacts(token, segmentId);
+  return new Set(contacts.map(({ email }) => lower(email)));
+}
+async function listContacts(token, segmentId) {
+  const resend = new Resend(token);
+  return listAll(
+    (after) => resend.contacts.list({
+      limit: 100,
+      ...segmentId && { segmentId },
+      ...after && { after }
+    }),
+    `contacts${segmentId ? ` in segment ${segmentId}` : ""}`
+  );
+}
+async function getContactProperties(token, contactId) {
+  const resend = new Resend(token);
+  const contact = verify(
+    await withRetry(() => resend.contacts.get(contactId)),
+    `Getting contact ${contactId}`
+  );
+  return Object.fromEntries(
+    Object.entries(contact.properties ?? {}).map(([key, { value }]) => [
+      key,
+      value
+    ])
+  );
+}
+async function listEmailsSince(token, since) {
   const resend = new Resend(token);
-  const emails = /* @__PURE__ */ new Set();
+  const emails = [];
   for (let after; ; ) {
     const page = verify(
       await withRetry(
-        () => resend.contacts.list({
-          limit: 100,
-          ...segmentId && { segmentId },
-          ...after && { after }
-        })
+        () => resend.emails.list({ limit: 100, ...after && { after } })
       ),
-      `Listing contacts${segmentId ? ` in segment ${segmentId}` : ""} after ${after ?? "the start"}`
+      `Listing emails after ${after ?? "the start"}`
     );
-    for (const contact of page.data) emails.add(lower(contact.email));
+    for (const email of page.data) {
+      if (new Date(email.created_at) < since) return emails;
+      emails.push(email);
+    }
     const last = page.data[page.data.length - 1];
     if (!page.has_more || !last) return emails;
     after = last.id;
@@ -115,19 +158,58 @@ async function listContactEmails(token, segmentId) {
 }
 async function listSegments(token) {
   const resend = new Resend(token);
-  const segments = [];
-  for (let after; ; ) {
-    const page = verify(
-      await withRetry(
-        () => resend.segments.list({ limit: 100, ...after && { after } })
-      ),
-      `Listing segments after ${after ?? "the start"}`
+  const segments = await listAll(
+    (after) => resend.segments.list({ limit: 100, ...after && { after } }),
+    "segments"
+  );
+  return segments.map(({ id, name }) => ({ id, name }));
+}
+async function listTemplateNames(token) {
+  const resend = new Resend(token);
+  const templates = await listAll(
+    (after) => resend.templates.list({ limit: 100, ...after && { after } }),
+    "templates"
+  );
+  return new Map(templates.map(({ id, name }) => [id, name]));
+}
+var SendEmailOutput = z.object({
+  email_id: z.string(),
+  template_id: z.string()
+});
+async function listAutomationEmailTemplates(token, since) {
+  const resend = new Resend(token);
+  const templates = /* @__PURE__ */ new Map();
+  const automations = await listAll(
+    (after) => resend.automations.list({ limit: 100, ...after && { after } }),
+    "automations"
+  );
+  for (const automation of automations) {
+    const runs = await listAll(
+      (after) => resend.automations.runs.list({
+        automationId: automation.id,
+        limit: 100,
+        ...after && { after }
+      }),
+      `runs of automation ${automation.id}`
     );
-    for (const { id, name } of page.data) segments.push({ id, name });
-    const last = page.data[page.data.length - 1];
-    if (!page.has_more || !last) return segments;
-    after = last.id;
+    for (const { id: runId, status, completed_at } of runs) {
+      const mayHaveSent = status === "running" || !completed_at || new Date(completed_at) >= since;
+      if (!mayHaveSent) continue;
+      const run = verify(
+        await withRetry(
+          () => resend.automations.runs.get({ automationId: automation.id, runId })
+        ),
+        `Getting run ${runId} of automation ${automation.id}`
+      );
+      for (const step of run.steps) {
+        if (step.type !== "send_email") continue;
+        const output = SendEmailOutput.safeParse(step.output);
+        if (output.success)
+          templates.set(output.data.email_id, output.data.template_id);
+      }
+    }
   }
+  return templates;
 }
 async function createSegment(token, name) {
   const resend = new Resend(token);
@@ -321,10 +403,15 @@ export {
   dripId,
   enrollInDonorSequence,
   enrollInDripSequence,
+  getContactProperties,
   isDripLanguage,
   isRetryable,
+  listAutomationEmailTemplates,
   listContactEmails,
+  listContacts,
+  listEmailsSince,
   listSegments,
+  listTemplateNames,
   setSegmentMembership,
   splitName,
   subscribeToNewsletter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "waha-shared",
-  "version": "1.0.544",
+  "version": "1.0.545",
   "author": "Waha",
   "dependencies": {
     "@types/signale": "^1.4.7",
@@ -25,15 +25,8 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@crowdin/crowdin-api-client": "^1.59.2",
-    "@orpc/client": "^1.16.1",
-    "@orpc/contract": "^1.16.1",
-    "@orpc/openapi-client": "^1.16.1",
-    "@types/react": "^19.3.0",
     "esbuild": "^0.28.2",
-    "react": "^19.3.1",
-    "typescript": "~5.9.2",
-    "zod": "^4.6.7"
+    "typescript": "~5.9.2"
   },
   "files": [
     "dist",
@@ -43,7 +36,7 @@
   "license": "MIT",
   "scripts": {
     "build": "node build.mts",
-    "update": "bash publish.sh",
-    "update:preview": "bash publish.sh --preview"
+    "publish:latest": "bash publish.sh",
+    "publish:preview": "bash publish.sh --preview"
   }
 }