millionsend 0.0.1 → 0.1.0

package/README.md

@@ -1,7 +1,156 @@
 # millionsend
 
-Official Node.js SDK for [MillionSend](https://github.com/MillionSend) — the open-source,
-self-hostable email platform (bring your own AWS SES, or use the hosted cloud).
+Official Node.js / TypeScript SDK for [MillionSend](https://github.com/MillionSend/millionsend) — a self-hostable, Resend-compatible email API on AWS SES.
 
-**Status: under active development.** This release reserves the package name; the first working
-SDK will land here. Watch the [MillionSend GitHub org](https://github.com/MillionSend) for progress.
+The API is wire-compatible with Resend, and this SDK deliberately mirrors the
+shape of `resend`, so migrating is mostly a find-and-replace: swap the import,
+the class name, and point `baseUrl` at your instance.
+
+## Install
+
+```bash
+npm install millionsend
+# or: pnpm add millionsend / yarn add millionsend / bun add millionsend
+```
+
+Requires Node.js 18+ (uses the global `fetch`).
+
+## Quickstart
+
+```ts
+import { MillionSend } from "millionsend";
+
+const ms = new MillionSend("ms_123", { baseUrl: "https://mail.acme.dev" });
+
+const { data, error } = await ms.emails.send({
+  from: "Acme <onboarding@acme.dev>",
+  to: "delivered@resend.dev",
+  subject: "Hello from MillionSend",
+  html: "<strong>It works!</strong>",
+});
+
+if (error) {
+  console.error(error.name, error.message);
+} else {
+  console.log("sent", data.id);
+}
+```
+
+## Configuration
+
+```ts
+new MillionSend(apiKey?, {
+  baseUrl?, // your instance URL; defaults to MILLIONSEND_BASE_URL, then http://localhost:3001
+  fetch?,   // custom fetch implementation (proxies, tests, custom agents)
+  userAgent?, // extra User-Agent suffix
+});
+```
+
+- `apiKey` falls back to `process.env.MILLIONSEND_API_KEY`. Missing key → throws at construction.
+- `baseUrl` falls back to `process.env.MILLIONSEND_BASE_URL`. MillionSend is self-hosted, so **set this to your deployment in production.**
+
+## Errors
+
+No method throws for an API error — every call resolves to `{ data, error }`.
+`error` is `null` on success; otherwise `{ name, message, statusCode }` where
+`name` is a stable snake_case code you can switch on (`validation_error`,
+`not_found`, `restricted_api_key`, `sending_paused`, …). Client-side and
+transport failures carry `statusCode: null`.
+
+```ts
+const { data, error } = await ms.emails.get(id);
+if (error?.name === "not_found") { /* … */ }
+```
+
+## Resources
+
+### Emails
+
+```ts
+await ms.emails.send(payload, { idempotencyKey });   // POST /emails
+await ms.emails.get(id);                               // GET /emails/:id
+await ms.emails.cancel(id);                            // POST /emails/:id/cancel (scheduled only)
+await ms.batch.send([payloadA, payloadB], { idempotencyKey }); // up to 100
+```
+
+Send options are camelCase and mapped to the wire: `replyTo` → `reply_to`,
+`scheduledAt` → `scheduled_at`. `to`/`cc`/`bcc`/`replyTo` accept a string or an array.
+
+### Audiences & contacts
+
+```ts
+const { data: audience } = await ms.audiences.create({ name: "Registered users" });
+await ms.audiences.list({ limit: 20, after });
+await ms.audiences.get(id);
+await ms.audiences.remove(id);
+
+await ms.contacts.create({ audienceId, email: "ada@acme.dev", firstName: "Ada",
+                           properties: { plan: "pro" } });
+await ms.contacts.get({ audienceId, email });     // by id or email (email wins)
+await ms.contacts.get(contactId);                  // bare string works too
+await ms.contacts.update({ id, unsubscribed: true, firstName: null }); // null clears
+await ms.contacts.remove({ email });
+await ms.contacts.list({ audienceId, limit: 50 });
+
+// Topic subscriptions (granular unsubscribe)
+await ms.contacts.topics.update({ email, topics: [{ id: topicId, subscription: "opt_out" }] });
+```
+
+### Topics
+
+```ts
+await ms.topics.create({ name: "Product updates", defaultSubscription: "opt_in" });
+await ms.topics.get(id);
+await ms.topics.list();     // bare { data } — topics are unpaginated
+await ms.topics.remove(id);
+```
+
+### Broadcasts
+
+```ts
+const { data } = await ms.broadcasts.create({
+  audienceId, from: "Acme <news@acme.dev>", subject: "Launch",
+  html: "<p>Hi {{{FIRST_NAME|there}}}</p>",
+});
+await ms.broadcasts.list();
+await ms.broadcasts.get(id);
+await ms.broadcasts.update(id, { subject: "Launch 🚀" });  // draft only
+await ms.broadcasts.send(id, { scheduledAt: "2026-09-01T09:00:00Z" }); // omit to send now
+await ms.broadcasts.cancel(id);   // scheduled only
+await ms.broadcasts.remove(id);   // draft only
+```
+
+### Segments (MillionSend extension)
+
+Dynamic segments are a saved filter over an audience's contacts — a MillionSend
+superset with no Resend equivalent.
+
+```ts
+await ms.segments.create({
+  name: "Pro plan",
+  audienceId,
+  filter: { match: "all", conditions: [{ field: "property:plan", op: "equals", value: "pro" }] },
+});
+await ms.segments.get(id);   // includes a live contact_count
+await ms.segments.list();
+await ms.segments.update(id, { name: "Pro tier" });
+await ms.segments.remove(id);
+```
+
+## Migrating from Resend
+
+```diff
+- import { Resend } from "resend";
+- const resend = new Resend("re_123");
++ import { MillionSend } from "millionsend";
++ const ms = new MillionSend("ms_123", { baseUrl: "https://mail.acme.dev" });
+```
+
+Method names and payloads match. Notes:
+
+- **Domains and API keys** are managed in the MillionSend dashboard, not via the API, so there are no `.domains`/`.apiKeys` resources here.
+- Resend's `.segments` is an alias of audiences; MillionSend's `.segments` is the distinct dynamic-filter feature. Use `.audiences` for a straight port.
+
+## License
+
+MIT

package/dist/error.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The error shape the MillionSend API returns on every non-2xx response, plus
+ * the two client-side conditions (a bad request never sent, a transport
+ * failure) which carry `statusCode: null`. Mirrors Resend's `ErrorResponse`, so
+ * code that switches on `error.name` ports across unchanged.
+ */
+export interface ErrorResponse {
+    /** Stable snake_case code — the discriminant, e.g. "validation_error", "not_found". */
+    name: string;
+    message: string;
+    /** HTTP status; null when the request never reached the API. */
+    statusCode: number | null;
+}
+/** Every method resolves to this — it never throws for an API error. */
+export type Result<T> = {
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: ErrorResponse;
+};
+/** Coerce an arbitrary parsed error body into the canonical shape. */
+export declare function toErrorResponse(body: unknown, status: number): ErrorResponse;
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAExF,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAa5E"}

package/dist/error.js

@@ -0,0 +1,16 @@
+/** Coerce an arbitrary parsed error body into the canonical shape. */
+export function toErrorResponse(body, status) {
+    if (body && typeof body === "object") {
+        const b = body;
+        const name = typeof b.name === "string" ? b.name : "application_error";
+        const message = typeof b.message === "string" ? b.message : `Request failed with status ${status}`;
+        const statusCode = typeof b.statusCode === "number" ? b.statusCode : status;
+        return { name, message, statusCode };
+    }
+    return {
+        name: "application_error",
+        message: `Request failed with status ${status}`,
+        statusCode: status,
+    };
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAiBA,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,IAAa,EAAE,MAAc;IAC3D,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACvE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,MAAM,EAAE,CAAC;QACnG,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACvC,CAAC;IACD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,8BAA8B,MAAM,EAAE;QAC/C,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,34 @@
+import { type Result } from "./error.js";
+export interface MillionSendOptions {
+    /**
+     * Your MillionSend instance URL (no trailing slash needed). Falls back to
+     * `MILLIONSEND_BASE_URL`, then `http://localhost:3001`. Self-hosted, so there
+     * is no cloud default — set this to your deployment in production.
+     */
+    baseUrl?: string;
+    /** Inject a fetch implementation (tests, proxies, custom agents). */
+    fetch?: typeof fetch;
+    /** Extra User-Agent suffix appended after the SDK's own token. */
+    userAgent?: string;
+}
+export interface RequestOptions {
+    /** POST-only idempotency key (emails.send, batch.send). */
+    idempotencyKey?: string;
+}
+interface DoRequest {
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    body?: unknown;
+    query?: Record<string, string | number | undefined> | undefined;
+    idempotencyKey?: string | undefined;
+}
+export declare class HttpClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly userAgent;
+    constructor(apiKey: string, options?: MillionSendOptions);
+    request<T>({ method, path, body, query, idempotencyKey }: DoRequest): Promise<Result<T>>;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,MAAM,EAAmB,MAAM,YAAY,CAAC;AAK9E,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,SAAS;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IAChE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAYD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAkBtD,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CA0C/F"}

package/dist/http.js

@@ -0,0 +1,75 @@
+import { toErrorResponse } from "./error.js";
+const DEFAULT_BASE_URL = "http://localhost:3001";
+const SDK_VERSION = "0.1.0";
+function queryString(query) {
+    if (!query)
+        return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined)
+            params.set(key, String(value));
+    }
+    const s = params.toString();
+    return s ? `?${s}` : "";
+}
+export class HttpClient {
+    apiKey;
+    baseUrl;
+    fetchImpl;
+    userAgent;
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey;
+        this.baseUrl = (options.baseUrl ?? process.env.MILLIONSEND_BASE_URL ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        // Bind so a passed-in fetch keeps its own `this`; default to the global.
+        const chosen = options.fetch ?? globalThis.fetch;
+        if (!chosen) {
+            throw new Error("No fetch implementation found. Use Node 18+ or pass `fetch` in the client options.");
+        }
+        this.fetchImpl = chosen;
+        const base = `millionsend-node/${SDK_VERSION}`;
+        this.userAgent = options.userAgent ? `${base} ${options.userAgent}` : base;
+    }
+    async request({ method, path, body, query, idempotencyKey }) {
+        const url = `${this.baseUrl}${path}${queryString(query)}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            "User-Agent": this.userAgent,
+        };
+        const init = { method, headers };
+        if (body !== undefined && method !== "GET" && method !== "DELETE") {
+            headers["Content-Type"] = "application/json";
+            init.body = JSON.stringify(body);
+        }
+        // Idempotency is POST-only on the wire; sending it elsewhere is a no-op.
+        if (idempotencyKey && method === "POST")
+            headers["Idempotency-Key"] = idempotencyKey;
+        let response;
+        try {
+            response = await this.fetchImpl(url, init);
+        }
+        catch (cause) {
+            const error = {
+                name: "application_error",
+                message: cause instanceof Error ? cause.message : String(cause),
+                statusCode: null,
+            };
+            return { data: null, error };
+        }
+        const text = await response.text();
+        let parsed = null;
+        if (text) {
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                parsed = text;
+            }
+        }
+        if (!response.ok) {
+            return { data: null, error: toErrorResponse(parsed, response.status) };
+        }
+        return { data: parsed, error: null };
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import { type MillionSendOptions } from "./http.js";
+import { Audiences } from "./resources/audiences.js";
+import { Broadcasts } from "./resources/broadcasts.js";
+import { Contacts } from "./resources/contacts.js";
+import { Batch, Emails } from "./resources/emails.js";
+import { Segments } from "./resources/segments.js";
+import { Topics } from "./resources/topics.js";
+/**
+ * The MillionSend client. Construct once and reuse.
+ *
+ * ```ts
+ * import { MillionSend } from "millionsend";
+ * const ms = new MillionSend("ms_...", { baseUrl: "https://mail.acme.dev" });
+ * const { data, error } = await ms.emails.send({
+ *   from: "Acme <onboarding@acme.dev>",
+ *   to: "delivered@resend.dev",
+ *   subject: "Hello",
+ *   html: "<strong>it works</strong>",
+ * });
+ * ```
+ *
+ * No method throws for an API error — each resolves to `{ data, error }`, with
+ * `error` being an {@link ErrorResponse} discriminated by `error.name`. The only
+ * throw is a missing API key at construction.
+ */
+export declare class MillionSend {
+    readonly emails: Emails;
+    readonly batch: Batch;
+    readonly audiences: Audiences;
+    readonly contacts: Contacts;
+    readonly broadcasts: Broadcasts;
+    readonly topics: Topics;
+    readonly segments: Segments;
+    constructor(apiKey?: string, options?: MillionSendOptions);
+}
+export default MillionSend;
+export type { ErrorResponse, Result } from "./error.js";
+export type { MillionSendOptions, RequestOptions } from "./http.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAEhB,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB;CAgB1D;AAED,eAAe,WAAW,CAAC;AAE3B,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpE,mBAAmB,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,50 @@
+import { HttpClient } from "./http.js";
+import { Audiences } from "./resources/audiences.js";
+import { Broadcasts } from "./resources/broadcasts.js";
+import { Contacts } from "./resources/contacts.js";
+import { Batch, Emails } from "./resources/emails.js";
+import { Segments } from "./resources/segments.js";
+import { Topics } from "./resources/topics.js";
+/**
+ * The MillionSend client. Construct once and reuse.
+ *
+ * ```ts
+ * import { MillionSend } from "millionsend";
+ * const ms = new MillionSend("ms_...", { baseUrl: "https://mail.acme.dev" });
+ * const { data, error } = await ms.emails.send({
+ *   from: "Acme <onboarding@acme.dev>",
+ *   to: "delivered@resend.dev",
+ *   subject: "Hello",
+ *   html: "<strong>it works</strong>",
+ * });
+ * ```
+ *
+ * No method throws for an API error — each resolves to `{ data, error }`, with
+ * `error` being an {@link ErrorResponse} discriminated by `error.name`. The only
+ * throw is a missing API key at construction.
+ */
+export class MillionSend {
+    emails;
+    batch;
+    audiences;
+    contacts;
+    broadcasts;
+    topics;
+    segments;
+    constructor(apiKey, options) {
+        const key = apiKey ?? process.env.MILLIONSEND_API_KEY;
+        if (!key) {
+            throw new Error("Missing API key. Pass it to new MillionSend(apiKey) or set MILLIONSEND_API_KEY.");
+        }
+        const http = new HttpClient(key, options);
+        this.emails = new Emails(http);
+        this.batch = new Batch(http);
+        this.audiences = new Audiences(http);
+        this.contacts = new Contacts(http);
+        this.broadcasts = new Broadcasts(http);
+        this.topics = new Topics(http);
+        this.segments = new Segments(http);
+    }
+}
+export default MillionSend;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,WAAW;IACb,MAAM,CAAS;IACf,KAAK,CAAQ;IACb,SAAS,CAAY;IACrB,QAAQ,CAAW;IACnB,UAAU,CAAa;IACvB,MAAM,CAAS;IACf,QAAQ,CAAW;IAE5B,YAAY,MAAe,EAAE,OAA4B;QACvD,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACtD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}

package/dist/query.d.ts

@@ -0,0 +1,4 @@
+import type { ListOptions } from "./types.js";
+/** Flatten keyset list options into the query map (undefined values are dropped). */
+export declare function listQuery(options?: ListOptions): Record<string, string | number | undefined> | undefined;
+//# sourceMappingURL=query.d.ts.map

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qFAAqF;AACrF,wBAAgB,SAAS,CACvB,OAAO,CAAC,EAAE,WAAW,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAGzD"}

package/dist/query.js

@@ -0,0 +1,7 @@
+/** Flatten keyset list options into the query map (undefined values are dropped). */
+export function listQuery(options) {
+    if (!options)
+        return undefined;
+    return { limit: options.limit, after: options.after, before: options.before };
+}
+//# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,SAAS,CACvB,OAAqB;IAErB,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAChF,CAAC"}

package/dist/resources/audiences.d.ts

@@ -0,0 +1,17 @@
+import type { Result } from "../error.js";
+import type { HttpClient } from "../http.js";
+import type { Audience, AudienceListItem, CreateAudienceOptions, List, ListOptions, RemoveAudienceResponse } from "../types.js";
+/**
+ * Audiences — named contact lists. Resend-compatible: a migrating app's
+ * `audiences.*` calls map straight over. (MillionSend's dynamic-filter
+ * `segments` are a separate, richer resource — see `client.segments`.)
+ */
+export declare class Audiences {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(payload: CreateAudienceOptions): Promise<Result<Audience>>;
+    get(id: string): Promise<Result<Audience>>;
+    list(options?: ListOptions): Promise<Result<List<AudienceListItem>>>;
+    remove(id: string): Promise<Result<RemoveAudienceResponse>>;
+}
+//# sourceMappingURL=audiences.d.ts.map

package/dist/resources/audiences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.d.ts","sourceRoot":"","sources":["../../src/resources/audiences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,EACrB,IAAI,EACJ,WAAW,EACX,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAIjE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAI1C,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAIpE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;CAG5D"}

package/dist/resources/audiences.js

@@ -0,0 +1,25 @@
+import { listQuery } from "../query.js";
+/**
+ * Audiences — named contact lists. Resend-compatible: a migrating app's
+ * `audiences.*` calls map straight over. (MillionSend's dynamic-filter
+ * `segments` are a separate, richer resource — see `client.segments`.)
+ */
+export class Audiences {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(payload) {
+        return this.http.request({ method: "POST", path: "/audiences", body: { name: payload.name } });
+    }
+    get(id) {
+        return this.http.request({ method: "GET", path: `/audiences/${encodeURIComponent(id)}` });
+    }
+    list(options) {
+        return this.http.request({ method: "GET", path: "/audiences", query: listQuery(options) });
+    }
+    remove(id) {
+        return this.http.request({ method: "DELETE", path: `/audiences/${encodeURIComponent(id)}` });
+    }
+}
+//# sourceMappingURL=audiences.js.map

package/dist/resources/audiences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audiences.js","sourceRoot":"","sources":["../../src/resources/audiences.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAC,OAA8B;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjG,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,OAAqB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/dist/resources/broadcasts.d.ts

@@ -0,0 +1,16 @@
+import type { Result } from "../error.js";
+import type { HttpClient } from "../http.js";
+import type { Broadcast, BroadcastId, BroadcastListItem, CancelBroadcastResponse, CreateBroadcastOptions, List, ListOptions, RemoveBroadcastResponse, SendBroadcastOptions, UpdateBroadcastOptions } from "../types.js";
+export declare class Broadcasts {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(payload: CreateBroadcastOptions): Promise<Result<BroadcastId>>;
+    get(id: string): Promise<Result<Broadcast>>;
+    list(options?: ListOptions): Promise<Result<List<BroadcastListItem>>>;
+    update(id: string, payload: UpdateBroadcastOptions): Promise<Result<BroadcastId>>;
+    remove(id: string): Promise<Result<RemoveBroadcastResponse>>;
+    /** POST /broadcasts/:id/send — omit scheduledAt to send now. */
+    send(id: string, options?: SendBroadcastOptions): Promise<Result<BroadcastId>>;
+    cancel(id: string): Promise<Result<CancelBroadcastResponse>>;
+}
+//# sourceMappingURL=broadcasts.d.ts.map

package/dist/resources/broadcasts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcasts.d.ts","sourceRoot":"","sources":["../../src/resources/broadcasts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,IAAI,EACJ,WAAW,EACX,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAgBrB,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAIrE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAI3C,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAIrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAQjF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAI5D,gEAAgE;IAChE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAQlF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;CAM7D"}

package/dist/resources/broadcasts.js

@@ -0,0 +1,54 @@
+import { listQuery } from "../query.js";
+function toWire(o) {
+    return {
+        name: o.name,
+        audience_id: o.audienceId,
+        segment_id: o.segmentId,
+        from: o.from,
+        subject: o.subject,
+        html: o.html,
+        text: o.text,
+        reply_to: o.replyTo,
+        topic_id: o.topicId,
+    };
+}
+export class Broadcasts {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(payload) {
+        return this.http.request({ method: "POST", path: "/broadcasts", body: toWire(payload) });
+    }
+    get(id) {
+        return this.http.request({ method: "GET", path: `/broadcasts/${encodeURIComponent(id)}` });
+    }
+    list(options) {
+        return this.http.request({ method: "GET", path: "/broadcasts", query: listQuery(options) });
+    }
+    update(id, payload) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/broadcasts/${encodeURIComponent(id)}`,
+            body: toWire(payload),
+        });
+    }
+    remove(id) {
+        return this.http.request({ method: "DELETE", path: `/broadcasts/${encodeURIComponent(id)}` });
+    }
+    /** POST /broadcasts/:id/send — omit scheduledAt to send now. */
+    send(id, options = {}) {
+        return this.http.request({
+            method: "POST",
+            path: `/broadcasts/${encodeURIComponent(id)}/send`,
+            body: { scheduled_at: options.scheduledAt },
+        });
+    }
+    cancel(id) {
+        return this.http.request({
+            method: "POST",
+            path: `/broadcasts/${encodeURIComponent(id)}/cancel`,
+        });
+    }
+}
+//# sourceMappingURL=broadcasts.js.map

package/dist/resources/broadcasts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcasts.js","sourceRoot":"","sources":["../../src/resources/broadcasts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAcxC,SAAS,MAAM,CAAC,CAAkD;IAChE,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,UAAU;QACzB,UAAU,EAAE,CAAC,CAAC,SAAS;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,QAAQ,EAAE,CAAC,CAAC,OAAO;QACnB,QAAQ,EAAE,CAAC,CAAC,OAAO;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,UAAU;IACQ;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAC,OAA+B;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,OAAqB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,OAA+B;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAC7C,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,gEAAgE;IAChE,IAAI,CAAC,EAAU,EAAE,UAAgC,EAAE;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,OAAO;YAClD,IAAI,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe,kBAAkB,CAAC,EAAE,CAAC,SAAS;SACrD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/resources/contacts.d.ts

@@ -0,0 +1,22 @@
+import type { Result } from "../error.js";
+import type { HttpClient } from "../http.js";
+import type { Contact, ContactAddress, ContactId, ContactListItem, CreateContactOptions, List, ListOptions, RemoveContactResponse, UpdateContactOptions, UpdateContactTopicsOptions, UpdateContactTopicsResponse } from "../types.js";
+/** Per-contact topic subscriptions (opt in/out of a topic). */
+export declare class ContactTopics {
+    private readonly http;
+    constructor(http: HttpClient);
+    update(options: UpdateContactTopicsOptions): Promise<Result<UpdateContactTopicsResponse>>;
+}
+export declare class Contacts {
+    private readonly http;
+    readonly topics: ContactTopics;
+    constructor(http: HttpClient);
+    create(payload: CreateContactOptions): Promise<Result<ContactId>>;
+    get(address: string | ContactAddress): Promise<Result<Contact>>;
+    update(options: UpdateContactOptions): Promise<Result<ContactId>>;
+    remove(address: string | ContactAddress): Promise<Result<RemoveContactResponse>>;
+    list(options?: ListOptions & {
+        audienceId?: string;
+    }): Promise<Result<List<ContactListItem>>>;
+}
+//# sourceMappingURL=contacts.d.ts.map

package/dist/resources/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/resources/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAiCrB,+DAA+D;AAC/D,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;CAQ1F;AAED,qBAAa,QAAQ;IAGP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEF,IAAI,EAAE,UAAU;IAI7C,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAOjE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAI/D,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAIjE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAIhF,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;CAM9F"}