millionsend 0.0.1 → 0.2.0

package/README.md

@@ -1,7 +1,154 @@
 # 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.
+
+### Contacts
+
+Contacts are team-global — one list per team, no audiences.
+
+```ts
+await ms.contacts.create({ email: "ada@acme.dev", firstName: "Ada",
+                           properties: { plan: "pro" } });
+await ms.contacts.get({ 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({ 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
+
+Target a `segmentId` and/or `topicId`; omit both to send to all contacts.
+
+```ts
+const { data } = await ms.broadcasts.create({
+  segmentId, 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 the team's contacts — a MillionSend
+superset with no Resend equivalent.
+
+```ts
+await ms.segments.create({
+  name: "Pro plan",
+  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.
+- **No audiences.** Contacts are team-global, so `.audiences` calls have no equivalent — drop them and call `.contacts` directly. For subsets of contacts, use `.segments` (dynamic filters) or topics.
+
+## 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,38 @@
+import { type MillionSendOptions } from "./http.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 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,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,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;CAe1D;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,47 @@
+import { HttpClient } from "./http.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;
+    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.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,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,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,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/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;AAerB,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,53 @@
+import { listQuery } from "../query.js";
+function toWire(o) {
+    return {
+        name: o.name,
+        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,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,20 @@
+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): 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;AA8BrB,+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;IAIjE,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,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;CAGpE"}

package/dist/resources/contacts.js

@@ -0,0 +1,64 @@
+import { listQuery } from "../query.js";
+function normalize(address) {
+    return typeof address === "string" ? { id: address } : address;
+}
+/** Contact path: email wins over id. */
+function contactPath(addr) {
+    return `/contacts/${encodeURIComponent(addr.email ?? addr.id ?? "")}`;
+}
+function createBody(o) {
+    return {
+        email: o.email,
+        first_name: o.firstName,
+        last_name: o.lastName,
+        unsubscribed: o.unsubscribed,
+        properties: o.properties,
+    };
+}
+function updateBody(o) {
+    return {
+        first_name: o.firstName,
+        last_name: o.lastName,
+        unsubscribed: o.unsubscribed,
+        properties: o.properties,
+    };
+}
+/** Per-contact topic subscriptions (opt in/out of a topic). */
+export class ContactTopics {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    update(options) {
+        const key = encodeURIComponent(options.email ?? options.id ?? "");
+        return this.http.request({
+            method: "PATCH",
+            path: `/contacts/${key}/topics`,
+            body: options.topics,
+        });
+    }
+}
+export class Contacts {
+    http;
+    topics;
+    constructor(http) {
+        this.http = http;
+        this.topics = new ContactTopics(http);
+    }
+    create(payload) {
+        return this.http.request({ method: "POST", path: "/contacts", body: createBody(payload) });
+    }
+    get(address) {
+        return this.http.request({ method: "GET", path: contactPath(normalize(address)) });
+    }
+    update(options) {
+        return this.http.request({ method: "PATCH", path: contactPath(options), body: updateBody(options) });
+    }
+    remove(address) {
+        return this.http.request({ method: "DELETE", path: contactPath(normalize(address)) });
+    }
+    list(options) {
+        return this.http.request({ method: "GET", path: "/contacts", query: listQuery(options) });
+    }
+}
+//# sourceMappingURL=contacts.js.map

package/dist/resources/contacts.js.map

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

package/dist/resources/emails.d.ts

@@ -0,0 +1,28 @@
+import type { Result } from "../error.js";
+import type { HttpClient, RequestOptions } from "../http.js";
+import type { CancelEmailResponse, CreateEmailResponse, Email, SendEmailOptions } from "../types.js";
+export declare class Emails {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** POST /emails — supports an Idempotency-Key. */
+    send(payload: SendEmailOptions, options?: RequestOptions): Promise<Result<CreateEmailResponse>>;
+    /** Alias of {@link send}, mirroring Resend. */
+    create(payload: SendEmailOptions, options?: RequestOptions): Promise<Result<CreateEmailResponse>>;
+    /** GET /emails/:id */
+    get(id: string): Promise<Result<Email>>;
+    /** POST /emails/:id/cancel — only scheduled, unsent emails. */
+    cancel(id: string): Promise<Result<CancelEmailResponse>>;
+}
+export declare class Batch {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** POST /emails/batch — 1–100 emails in one call; supports an Idempotency-Key. */
+    send(payload: SendEmailOptions[], options?: RequestOptions): Promise<Result<{
+        data: CreateEmailResponse[];
+    }>>;
+    /** Alias of {@link send}, mirroring Resend. */
+    create(payload: SendEmailOptions[], options?: RequestOptions): Promise<Result<{
+        data: CreateEmailResponse[];
+    }>>;
+}
+//# sourceMappingURL=emails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emails.d.ts","sourceRoot":"","sources":["../../src/resources/emails.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,EACL,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAiBrB,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,kDAAkD;IAClD,IAAI,CACF,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IASvC,+CAA+C;IAC/C,MAAM,CACJ,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAIvC,sBAAsB;IACtB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAIvC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;CAMzD;AAED,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,kFAAkF;IAClF,IAAI,CACF,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC,CAAC;IASnD,+CAA+C;IAC/C,MAAM,CACJ,OAAO,EAAE,gBAAgB,EAAE,EAC3B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,mBAAmB,EAAE,CAAA;KAAE,CAAC,CAAC;CAGpD"}

package/dist/resources/emails.js

@@ -0,0 +1,64 @@
+function toWire(o) {
+    return {
+        from: o.from,
+        to: o.to,
+        subject: o.subject,
+        html: o.html,
+        text: o.text,
+        cc: o.cc,
+        bcc: o.bcc,
+        reply_to: o.replyTo,
+        scheduled_at: o.scheduledAt,
+        tags: o.tags,
+    };
+}
+export class Emails {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** POST /emails — supports an Idempotency-Key. */
+    send(payload, options = {}) {
+        return this.http.request({
+            method: "POST",
+            path: "/emails",
+            body: toWire(payload),
+            idempotencyKey: options.idempotencyKey,
+        });
+    }
+    /** Alias of {@link send}, mirroring Resend. */
+    create(payload, options = {}) {
+        return this.send(payload, options);
+    }
+    /** GET /emails/:id */
+    get(id) {
+        return this.http.request({ method: "GET", path: `/emails/${encodeURIComponent(id)}` });
+    }
+    /** POST /emails/:id/cancel — only scheduled, unsent emails. */
+    cancel(id) {
+        return this.http.request({
+            method: "POST",
+            path: `/emails/${encodeURIComponent(id)}/cancel`,
+        });
+    }
+}
+export class Batch {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** POST /emails/batch — 1–100 emails in one call; supports an Idempotency-Key. */
+    send(payload, options = {}) {
+        return this.http.request({
+            method: "POST",
+            path: "/emails/batch",
+            body: payload.map(toWire),
+            idempotencyKey: options.idempotencyKey,
+        });
+    }
+    /** Alias of {@link send}, mirroring Resend. */
+    create(payload, options = {}) {
+        return this.send(payload, options);
+    }
+}
+//# sourceMappingURL=emails.js.map

package/dist/resources/emails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emails.js","sourceRoot":"","sources":["../../src/resources/emails.ts"],"names":[],"mappings":"AASA,SAAS,MAAM,CAAC,CAAmB;IACjC,OAAO;QACL,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,QAAQ,EAAE,CAAC,CAAC,OAAO;QACnB,YAAY,EAAE,CAAC,CAAC,WAAW;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,kDAAkD;IAClD,IAAI,CACF,OAAyB,EACzB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YACrB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,MAAM,CACJ,OAAyB,EACzB,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,sBAAsB;IACtB,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,SAAS;SACjD,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,OAAO,KAAK;IACa;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,kFAAkF;IAClF,IAAI,CACF,OAA2B,EAC3B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YACzB,cAAc,EAAE,OAAO,CAAC,cAAc;SACvC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,MAAM,CACJ,OAA2B,EAC3B,UAA0B,EAAE;QAE5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/resources/segments.d.ts

@@ -0,0 +1,17 @@
+import type { Result } from "../error.js";
+import type { HttpClient } from "../http.js";
+import type { CreateSegmentOptions, List, ListOptions, RemoveSegmentResponse, Segment, UpdateSegmentOptions } from "../types.js";
+/**
+ * Dynamic segments — a saved filter over the team's contacts (MillionSend
+ * extension, no Resend equivalent). `get` returns a live `contact_count`.
+ */
+export declare class Segments {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(payload: CreateSegmentOptions): Promise<Result<Segment>>;
+    get(id: string): Promise<Result<Segment>>;
+    list(options?: ListOptions): Promise<Result<List<Segment>>>;
+    update(id: string, payload: UpdateSegmentOptions): Promise<Result<Segment>>;
+    remove(id: string): Promise<Result<RemoveSegmentResponse>>;
+}
+//# sourceMappingURL=segments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/resources/segments.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,oBAAoB,EACpB,IAAI,EACJ,WAAW,EACX,qBAAqB,EACrB,OAAO,EACP,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAQ/D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAIzC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAI3D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAQ3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;CAG3D"}

package/dist/resources/segments.js

@@ -0,0 +1,35 @@
+import { listQuery } from "../query.js";
+/**
+ * Dynamic segments — a saved filter over the team's contacts (MillionSend
+ * extension, no Resend equivalent). `get` returns a live `contact_count`.
+ */
+export class Segments {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(payload) {
+        return this.http.request({
+            method: "POST",
+            path: "/segments",
+            body: { name: payload.name, filter: payload.filter },
+        });
+    }
+    get(id) {
+        return this.http.request({ method: "GET", path: `/segments/${encodeURIComponent(id)}` });
+    }
+    list(options) {
+        return this.http.request({ method: "GET", path: "/segments", query: listQuery(options) });
+    }
+    update(id, payload) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/segments/${encodeURIComponent(id)}`,
+            body: { name: payload.name, filter: payload.filter },
+        });
+    }
+    remove(id) {
+        return this.http.request({ method: "DELETE", path: `/segments/${encodeURIComponent(id)}` });
+    }
+}
+//# sourceMappingURL=segments.js.map

package/dist/resources/segments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.js","sourceRoot":"","sources":["../../src/resources/segments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAUxC;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAC,OAA6B;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,CAAC,OAAqB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,CAAC,EAAU,EAAE,OAA6B;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE;YAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;CACF"}

package/dist/resources/topics.d.ts

@@ -0,0 +1,16 @@
+import type { Result } from "../error.js";
+import type { HttpClient } from "../http.js";
+import type { CreateTopicOptions, RemoveTopicResponse, Topic, TopicId } from "../types.js";
+/** Subscription topics — granular unsubscribe categories for a team. */
+export declare class Topics {
+    private readonly http;
+    constructor(http: HttpClient);
+    create(payload: CreateTopicOptions): Promise<Result<TopicId>>;
+    get(id: string): Promise<Result<Topic>>;
+    /** GET /topics — a bare `{ data }` list (topics are unpaginated). */
+    list(): Promise<Result<{
+        data: Topic[];
+    }>>;
+    remove(id: string): Promise<Result<RemoveTopicResponse>>;
+}
+//# sourceMappingURL=topics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"topics.d.ts","sourceRoot":"","sources":["../../src/resources/topics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3F,wEAAwE;AACxE,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAY7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAIvC,qEAAqE;IACrE,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,KAAK,EAAE,CAAA;KAAE,CAAC,CAAC;IAI1C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;CAGzD"}

package/dist/resources/topics.js

@@ -0,0 +1,29 @@
+/** Subscription topics — granular unsubscribe categories for a team. */
+export class Topics {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    create(payload) {
+        return this.http.request({
+            method: "POST",
+            path: "/topics",
+            body: {
+                name: payload.name,
+                description: payload.description,
+                default_subscription: payload.defaultSubscription,
+            },
+        });
+    }
+    get(id) {
+        return this.http.request({ method: "GET", path: `/topics/${encodeURIComponent(id)}` });
+    }
+    /** GET /topics — a bare `{ data }` list (topics are unpaginated). */
+    list() {
+        return this.http.request({ method: "GET", path: "/topics" });
+    }
+    remove(id) {
+        return this.http.request({ method: "DELETE", path: `/topics/${encodeURIComponent(id)}` });
+    }
+}
+//# sourceMappingURL=topics.js.map

package/dist/resources/topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topics.js","sourceRoot":"","sources":["../../src/resources/topics.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,MAAM,OAAO,MAAM;IACY;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAC,OAA2B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,SAAS;YACf,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,oBAAoB,EAAE,OAAO,CAAC,mBAAmB;aAClD;SACF,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,qEAAqE;IACrE,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Public request/response types. Inputs are camelCase (mapped to the wire's
+ * snake_case by each resource); responses are the wire shape verbatim, so the
+ * `object`/`created_at`/`first_name` fields read exactly as the API returns.
+ */
+export type Recipients = string | string[];
+export interface Tag {
+    name: string;
+    value: string;
+}
+export interface ListOptions {
+    limit?: number;
+    /** Keyset cursor: return items after this id. Mutually exclusive with `before`. */
+    after?: string;
+    before?: string;
+}
+export interface List<T> {
+    object: "list";
+    data: T[];
+    has_more: boolean;
+}
+export interface SendEmailOptions {
+    from: string;
+    to: Recipients;
+    subject: string;
+    html?: string;
+    text?: string;
+    cc?: Recipients;
+    bcc?: Recipients;
+    replyTo?: Recipients;
+    /** ISO 8601 with offset; up to 30 days ahead. */
+    scheduledAt?: string;
+    tags?: Tag[];
+}
+export interface CreateEmailResponse {
+    id: string;
+}
+export interface Email {
+    object: "email";
+    id: string;
+    from: string;
+    to: string[];
+    cc: string[] | null;
+    bcc: string[] | null;
+    reply_to: string[] | null;
+    subject: string;
+    html: string | null;
+    text: string | null;
+    created_at: string;
+    scheduled_at: string | null;
+    message_id: string;
+    last_event: string;
+}
+export interface CancelEmailResponse {
+    object: "email";
+    id: string;
+}
+export interface BatchResponse {
+    data: CreateEmailResponse[];
+}
+export interface CreateContactOptions {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    unsubscribed?: boolean;
+    properties?: Record<string, string | number | boolean | null>;
+}
+/** Address a contact by id or email (email wins if both are given). */
+export interface ContactAddress {
+    id?: string;
+    email?: string;
+}
+export interface UpdateContactOptions extends ContactAddress {
+    firstName?: string | null;
+    lastName?: string | null;
+    unsubscribed?: boolean;
+    properties?: Record<string, string | number | boolean | null>;
+}
+export interface ContactId {
+    object: "contact";
+    id: string;
+}
+export interface Contact {
+    object: "contact";
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    created_at: string;
+    unsubscribed: boolean;
+    properties: Record<string, string>;
+}
+export interface ContactListItem {
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    created_at: string;
+    unsubscribed: boolean;
+}
+export interface RemoveContactResponse {
+    object: "contact";
+    contact: string;
+    deleted: true;
+}
+export type TopicSubscription = "opt_in" | "opt_out";
+export interface ContactTopicUpdate {
+    id: string;
+    subscription: TopicSubscription;
+}
+export interface UpdateContactTopicsOptions extends ContactAddress {
+    topics: ContactTopicUpdate[];
+}
+export interface UpdateContactTopicsResponse {
+    id: string;
+}
+export interface CreateTopicOptions {
+    name: string;
+    description?: string;
+    defaultSubscription: TopicSubscription;
+}
+export interface Topic {
+    id: string;
+    name: string;
+    description?: string;
+    default_subscription: TopicSubscription;
+    created_at: string;
+}
+export interface TopicId {
+    id: string;
+}
+export interface RemoveTopicResponse {
+    id: string;
+    object: "topic";
+    deleted: true;
+}
+export interface CreateBroadcastOptions {
+    name?: string;
+    segmentId?: string;
+    from: string;
+    subject: string;
+    html?: string;
+    text?: string;
+    replyTo?: Recipients;
+    topicId?: string | null;
+}
+export interface UpdateBroadcastOptions {
+    name?: string;
+    segmentId?: string;
+    from?: string;
+    subject?: string;
+    html?: string;
+    text?: string;
+    replyTo?: Recipients;
+    topicId?: string | null;
+}
+export interface SendBroadcastOptions {
+    /** ISO 8601 with offset; omit to send now. */
+    scheduledAt?: string;
+}
+export interface BroadcastId {
+    id: string;
+}
+export interface BroadcastListItem {
+    id: string;
+    name: string | null;
+    segment_id: string | null;
+    status: string;
+    created_at: string;
+    scheduled_at: string | null;
+    sent_at: string | null;
+}
+export interface Broadcast extends BroadcastListItem {
+    object: "broadcast";
+    from: string;
+    subject: string;
+    reply_to: string[] | null;
+    preview_text: string | null;
+    topic_id: string | null;
+    html: string | null;
+    text: string | null;
+}
+export interface CancelBroadcastResponse {
+    object: "broadcast";
+    id: string;
+}
+export interface RemoveBroadcastResponse {
+    object: "broadcast";
+    id: string;
+    deleted: true;
+}
+export type SegmentMatch = "all" | "any";
+export interface SegmentCondition {
+    field: string;
+    op: string;
+    value?: string | null;
+}
+export interface SegmentFilter {
+    match: SegmentMatch;
+    conditions: SegmentCondition[];
+}
+export interface CreateSegmentOptions {
+    name: string;
+    filter: SegmentFilter;
+}
+export interface UpdateSegmentOptions {
+    name?: string;
+    filter?: SegmentFilter;
+}
+export interface Segment {
+    object: "segment";
+    id: string;
+    name: string;
+    filter: SegmentFilter;
+    created_at: string;
+    /** Present on `get` only — the live count of matching contacts. */
+    contact_count?: number;
+}
+export interface RemoveSegmentResponse {
+    object: "segment";
+    id: string;
+    deleted: true;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE3C,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,QAAQ,EAAE,OAAO,CAAC;CACnB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,mBAAmB,EAAE,CAAC;CAC7B;AAGD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/D;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAChE,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;CACZ;AAGD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,iBAAiB,CAAC;CACxC;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,iBAAiB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;CACf;AAGD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAU,SAAQ,iBAAiB;IAClD,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,IAAI,CAAC;CACf;AAGD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,IAAI,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public request/response types. Inputs are camelCase (mapped to the wire's
+ * snake_case by each resource); responses are the wire shape verbatim, so the
+ * `object`/`created_at`/`first_name` fields read exactly as the API returns.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,13 +1,38 @@
 {
   "name": "millionsend",
-  "version": "0.0.1",
-  "description": "Official Node.js SDK for MillionSend — the open-source email platform. Under active development; API coming soon.",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "files": ["index.js", "index.d.ts", "README.md", "LICENSE"],
-  "keywords": ["email", "millionsend", "ses", "transactional-email"],
-  "homepage": "https://github.com/MillionSend",
-  "repository": { "type": "git", "url": "git+https://github.com/MillionSend/millionsend-node.git" },
+  "version": "0.2.0",
+  "description": "Official MillionSend SDK for Node.js — a Resend-compatible email API you can self-host.",
+  "type": "module",
   "license": "MIT",
-  "engines": { "node": ">=18" }
+  "author": "MillionSend",
+  "homepage": "https://github.com/MillionSend/millionsend-node#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MillionSend/millionsend-node.git"
+  },
+  "keywords": ["millionsend", "resend", "email", "ses", "sdk", "transactional", "broadcast"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepack": "pnpm build"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
 }

package/index.d.ts

@@ -1,4 +0,0 @@
-export declare class MillionSend {
-  constructor(apiKey?: string);
-}
-export default MillionSend;

package/index.js

@@ -1,14 +0,0 @@
-// MillionSend Node.js SDK — under active development.
-// The published API will mirror the shape you already know:
-//   const millionsend = new MillionSend(process.env.MILLIONSEND_API_KEY);
-//   await millionsend.emails.send({ from, to, subject, html });
-// Follow https://github.com/MillionSend for progress.
-class MillionSend {
-  constructor() {
-    throw new Error(
-      'The MillionSend SDK is under active development — this placeholder release only reserves the package name. Follow https://github.com/MillionSend for the first working release.'
-    );
-  }
-}
-module.exports = { MillionSend };
-module.exports.default = MillionSend;