sendhive 0.1.0-beta.0

package/README.md

@@ -0,0 +1,118 @@
+# sendhive
+
+Tiny TypeScript SDK for the Sendhive email API. The shape mirrors Resend's Node SDK, so switching is a one-line change. Zero runtime dependencies; uses the global `fetch` (Node 18+, Bun, Deno, edge runtimes).
+
+## Install
+
+```bash
+bun add sendhive      # or: npm i sendhive
+```
+
+## Quick start
+
+```ts
+import { Sendhive } from 'sendhive'
+
+const sendhive = new Sendhive('sh_...', { baseUrl: 'http://localhost:3300' })
+
+const { data, error } = await sendhive.emails.send({
+  from: 'Kuldeep <hello@mail.waimers.in>',
+  to: 'a@b.com',
+  subject: 'Hi',
+  html: '<p>Hi</p>',
+})
+
+if (error) console.error(error.statusCode, error.name, error.message)
+else console.log(data.id)
+```
+
+The client never throws for API or network failures. It returns `{ data, error }`; exactly one is `null`.
+
+Both options fall back to environment variables: `SENDHIVE_API_KEY` and `SENDHIVE_BASE_URL`.
+
+No domain yet? Send from `test@sendhive.test` to an address of someone in your workspace (for example your own). It works before you verify anything, up to 10 a day.
+
+## Send
+
+`sendhive.emails.send(options)` calls `POST /api/emails`.
+
+| Option | Type | Notes |
+| --- | --- | --- |
+| `from` | `string` | `'Name <a@b.com>'` or `'a@b.com'` |
+| `to` | `string \| string[]` | |
+| `subject` | `string` | required, unless you send a `template` (then optional: it overrides the template's subject) |
+| `html` / `text` | `string` | at least one is required, unless you send a `template` |
+| `template` | `string` | slug or id of a saved template; cannot be combined with `html`, `text` or `react` |
+| `data` | `Record<string, string | number>` | values for the template's `{{variables}}` |
+| `cc`, `bcc` | `string \| string[]` | |
+| `replyTo` | `string \| string[]` | sent as `reply_to` |
+| `headers` | `Record<string, string>` | |
+| `tags` | `{ name, value }[]` | max 10 |
+| `react` | React element | optional; needs the optional peer `@react-email/render` |
+
+Returns `{ data: { id }, error: null }`.
+
+### Send a template
+
+Design a template once in the dashboard, then send it by its API name and fill its variables with `data`:
+
+```ts
+const { data, error } = await sendhive.emails.send({
+  from: 'Shop <orders@yourdomain.com>',
+  to: 'customer@example.com',
+  template: 'order-shipped',
+  data: { order_number: '1042', tracking_url: 'https://example.com/track/1042' },
+})
+```
+
+Every variable the template uses must have a value in `data`, otherwise you get `missing_template_variables`. Values are HTML-escaped for you, and a value used as a link must start with `http://`, `https://` or `mailto:`. An unknown template gives `template_not_found`.
+
+## Get
+
+```ts
+const { data, error } = await sendhive.emails.get('email_id')
+// data.status, data.last_event, data.events, data.sent_at, data.delivered_at ...
+```
+
+## Errors
+
+`error` is `{ statusCode, name, message, fix? }`. `fix` is `{ label, url }`: where to go to resolve the problem (a dashboard page or a docs page). Show it to your users or log it.
+
+```ts
+const { data, error } = await sendhive.emails.send({ ... })
+if (error) {
+  console.error(error.name, error.message)
+  if (error.fix) console.error(`${error.fix.label}: ${error.fix.url}`)
+}
+```
+
+| statusCode | name | Meaning |
+| --- | --- | --- |
+| 0 | `network_error` | request never reached the server (DNS, refused, offline) |
+| 401 | `missing_api_key` | no `Authorization: Bearer` header (no key given) |
+| 403 | `invalid_api_key` | key unknown or revoked |
+| 404 | `not_found` | email id not found for this key's organization |
+| 403 | `test_sender_recipient_not_allowed` | `test@sendhive.test` can only email members of your workspace |
+| 429 | `test_sender_limit_reached` | more than 10 test-sender emails today |
+| 503 | `test_sender_unavailable` | the server has no test sender configured |
+| 404 | `template_not_found` | no template with that slug or id in this organization |
+| 422 | `validation_error` | bad body; message names the field |
+| 422 | `missing_template_variables` | the template needs values that `data` does not have; message lists them |
+| 429 | `rate_limit_exceeded` | per-key rate limit; retry later |
+| other | as returned by the API | passed through unchanged |
+
+## Self-hosted instance
+
+Point `baseUrl` at your deployment (no trailing path):
+
+```ts
+new Sendhive(process.env.SENDHIVE_API_KEY, { baseUrl: 'https://mail-api.example.com' })
+```
+
+or set `SENDHIVE_BASE_URL=https://mail-api.example.com` and call `new Sendhive()`.
+
+## Develop
+
+```bash
+bun install && bun test && bun run build && bunx tsc --noEmit
+```

package/dist/index.cjs

@@ -0,0 +1,132 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Sendhive: () => Sendhive,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+function env(name) {
+  return typeof process !== "undefined" ? process.env?.[name] : void 0;
+}
+async function renderReact(element) {
+  const specifier = "@react-email/render";
+  let mod;
+  try {
+    mod = await import(
+      /* @vite-ignore */
+      specifier
+    );
+  } catch {
+    throw new Error("The `react` option needs the optional peer dependency @react-email/render.");
+  }
+  if (!mod.render) throw new Error("@react-email/render has no `render` export.");
+  return mod.render(element);
+}
+var Emails = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async send(options) {
+    const { replyTo, react, ...rest } = options;
+    let html = rest.html;
+    if (react !== void 0) {
+      try {
+        html = await renderReact(react);
+      } catch (err) {
+        return {
+          data: null,
+          error: { statusCode: 422, name: "validation_error", message: err.message }
+        };
+      }
+    }
+    const body = {
+      ...rest,
+      ...html !== void 0 ? { html } : {},
+      ...replyTo !== void 0 ? { reply_to: replyTo } : {}
+    };
+    return this.client.request("POST", "/api/emails", body);
+  }
+  async get(id) {
+    return this.client.request("GET", `/api/emails/${encodeURIComponent(id)}`);
+  }
+};
+var Sendhive = class {
+  emails;
+  apiKey;
+  baseUrl;
+  constructor(apiKey, options = {}) {
+    this.apiKey = apiKey ?? env("SENDHIVE_API_KEY");
+    const baseUrl = options.baseUrl ?? env("SENDHIVE_BASE_URL");
+    if (!baseUrl) throw new Error("Sendhive: set `baseUrl` or SENDHIVE_BASE_URL to your Sendhive server.");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.emails = new Emails(this);
+  }
+  /** @internal */
+  async request(method, path, body) {
+    const headers = { Accept: "application/json" };
+    if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`;
+    if (body !== void 0) headers["Content-Type"] = "application/json";
+    let res;
+    try {
+      res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+    } catch (err) {
+      return {
+        data: null,
+        error: {
+          statusCode: 0,
+          name: "network_error",
+          message: err instanceof Error ? err.message : String(err)
+        }
+      };
+    }
+    let json;
+    try {
+      json = await res.json();
+    } catch {
+      json = null;
+    }
+    if (!res.ok) {
+      const e = json ?? {};
+      return {
+        data: null,
+        error: {
+          statusCode: e.statusCode ?? res.status,
+          name: e.name ?? "application_error",
+          message: e.message ?? (res.statusText || "Unexpected response"),
+          ...e.fix ? { fix: e.fix } : {}
+        }
+      };
+    }
+    return { data: json, error: null };
+  }
+};
+var index_default = Sendhive;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Sendhive
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  Email,\n  Result,\n  SendEmailOptions,\n  SendEmailResponse,\n  SendhiveError,\n  SendhiveOptions,\n} from './types'\n\nexport type {\n  Email,\n  EmailEvent,\n  EmailTag,\n  Recipients,\n  Result,\n  SendEmailOptions,\n  SendEmailResponse,\n  SendhiveError,\n  SendhiveErrorFix,\n  SendhiveOptions,\n  TemplateData,\n} from './types'\n\nfunction env(name: string): string | undefined {\n  return typeof process !== 'undefined' ? process.env?.[name] : undefined\n}\n\n/** Optional peer: only loaded when the caller passes `react`. */\nasync function renderReact(element: unknown): Promise<string> {\n  const specifier = '@react-email/render'\n  let mod: { render?: (el: unknown) => string | Promise<string> }\n  try {\n    mod = await import(/* @vite-ignore */ specifier)\n  } catch {\n    throw new Error('The `react` option needs the optional peer dependency @react-email/render.')\n  }\n  if (!mod.render) throw new Error('@react-email/render has no `render` export.')\n  return mod.render(element)\n}\n\nclass Emails {\n  constructor(private readonly client: Sendhive) {}\n\n  async send(options: SendEmailOptions): Promise<Result<SendEmailResponse>> {\n    const { replyTo, react, ...rest } = options\n    let html = rest.html\n    if (react !== undefined) {\n      try {\n        html = await renderReact(react)\n      } catch (err) {\n        return {\n          data: null,\n          error: { statusCode: 422, name: 'validation_error', message: (err as Error).message },\n        }\n      }\n    }\n    const body = {\n      ...rest,\n      ...(html !== undefined ? { html } : {}),\n      ...(replyTo !== undefined ? { reply_to: replyTo } : {}),\n    }\n    return this.client.request<SendEmailResponse>('POST', '/api/emails', body)\n  }\n\n  async get(id: string): Promise<Result<Email>> {\n    return this.client.request<Email>('GET', `/api/emails/${encodeURIComponent(id)}`)\n  }\n}\n\nexport class Sendhive {\n  readonly emails: Emails\n  private readonly apiKey: string | undefined\n  private readonly baseUrl: string\n\n  constructor(apiKey?: string, options: SendhiveOptions = {}) {\n    this.apiKey = apiKey ?? env('SENDHIVE_API_KEY')\n    // No default host: an API key must never be sent to a server the caller did not choose.\n    const baseUrl = options.baseUrl ?? env('SENDHIVE_BASE_URL')\n    if (!baseUrl) throw new Error('Sendhive: set `baseUrl` or SENDHIVE_BASE_URL to your Sendhive server.')\n    this.baseUrl = baseUrl.replace(/\\/+$/, '')\n    this.emails = new Emails(this)\n  }\n\n  /** @internal */\n  async request<T>(method: 'GET' | 'POST', path: string, body?: unknown): Promise<Result<T>> {\n    const headers: Record<string, string> = { Accept: 'application/json' }\n    if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`\n    if (body !== undefined) headers['Content-Type'] = 'application/json'\n\n    let res: Response\n    try {\n      res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers,\n        body: body === undefined ? undefined : JSON.stringify(body),\n      })\n    } catch (err) {\n      return {\n        data: null,\n        error: {\n          statusCode: 0,\n          name: 'network_error',\n          message: err instanceof Error ? err.message : String(err),\n        },\n      }\n    }\n\n    let json: unknown\n    try {\n      json = await res.json()\n    } catch {\n      json = null\n    }\n\n    if (!res.ok) {\n      const e = (json ?? {}) as Partial<SendhiveError>\n      return {\n        data: null,\n        error: {\n          statusCode: e.statusCode ?? res.status,\n          name: e.name ?? 'application_error',\n          message: e.message ?? (res.statusText || 'Unexpected response'),\n          ...(e.fix ? { fix: e.fix } : {}),\n        },\n      }\n    }\n    return { data: json as T, error: null }\n  }\n}\n\nexport default Sendhive\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,113 @@
+/** Where to go to fix an error: a dashboard page or a docs page. */
+interface SendhiveErrorFix {
+    label: string;
+    url: string;
+}
+interface SendhiveError {
+    statusCode: number;
+    name: string;
+    message: string;
+    /** Set on errors from the API; not on `network_error`. */
+    fix?: SendhiveErrorFix;
+}
+type Recipients = string | string[];
+interface EmailTag {
+    name: string;
+    value: string;
+}
+interface SendEmailBase {
+    from: string;
+    to: Recipients;
+    cc?: Recipients;
+    bcc?: Recipients;
+    replyTo?: Recipients;
+    headers?: Record<string, string>;
+    tags?: EmailTag[];
+}
+/** Values for a template's {{variables}}. Strings and numbers only; the server escapes them. */
+type TemplateData = Record<string, string | number>;
+/** A message written by you: `subject` and at least one of `html`, `text` or `react`. */
+type SendContent = {
+    subject: string;
+    template?: never;
+    data?: never;
+} & ({
+    html: string;
+    text?: string;
+    react?: unknown;
+} | {
+    text: string;
+    html?: string;
+    react?: unknown;
+} | {
+    react: unknown;
+    html?: string;
+    text?: string;
+});
+/**
+ * A saved template, by its slug or id. Every variable the template uses must have a value in
+ * `data`. `subject` is optional: the template's own subject is used unless you pass one.
+ */
+type SendTemplate = {
+    template: string;
+    data?: TemplateData;
+    subject?: string;
+    html?: never;
+    text?: never;
+    react?: never;
+};
+/** Either your own content (`html` / `text` / `react`) or a saved `template` with `data`, never both. */
+type SendEmailOptions = SendEmailBase & (SendContent | SendTemplate);
+interface SendEmailResponse {
+    id: string;
+}
+interface EmailEvent {
+    type: string;
+    occurred_at: string;
+}
+interface Email {
+    object: 'email';
+    id: string;
+    from: string;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    reply_to: string[];
+    subject: string;
+    html: string | null;
+    text: string | null;
+    status: string;
+    last_event: string;
+    error: string | null;
+    created_at: string;
+    sent_at: string | null;
+    delivered_at: string | null;
+    events: EmailEvent[];
+}
+type Result<T> = {
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: SendhiveError;
+};
+interface SendhiveOptions {
+    baseUrl?: string;
+}
+
+declare class Emails {
+    private readonly client;
+    constructor(client: Sendhive);
+    send(options: SendEmailOptions): Promise<Result<SendEmailResponse>>;
+    get(id: string): Promise<Result<Email>>;
+}
+declare class Sendhive {
+    readonly emails: Emails;
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string, options?: SendhiveOptions);
+    /** @internal */
+    request<T>(method: 'GET' | 'POST', path: string, body?: unknown): Promise<Result<T>>;
+}
+
+export { type Email, type EmailEvent, type EmailTag, type Recipients, type Result, type SendEmailOptions, type SendEmailResponse, Sendhive, type SendhiveError, type SendhiveErrorFix, type SendhiveOptions, type TemplateData, Sendhive as default };

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+/** Where to go to fix an error: a dashboard page or a docs page. */
+interface SendhiveErrorFix {
+    label: string;
+    url: string;
+}
+interface SendhiveError {
+    statusCode: number;
+    name: string;
+    message: string;
+    /** Set on errors from the API; not on `network_error`. */
+    fix?: SendhiveErrorFix;
+}
+type Recipients = string | string[];
+interface EmailTag {
+    name: string;
+    value: string;
+}
+interface SendEmailBase {
+    from: string;
+    to: Recipients;
+    cc?: Recipients;
+    bcc?: Recipients;
+    replyTo?: Recipients;
+    headers?: Record<string, string>;
+    tags?: EmailTag[];
+}
+/** Values for a template's {{variables}}. Strings and numbers only; the server escapes them. */
+type TemplateData = Record<string, string | number>;
+/** A message written by you: `subject` and at least one of `html`, `text` or `react`. */
+type SendContent = {
+    subject: string;
+    template?: never;
+    data?: never;
+} & ({
+    html: string;
+    text?: string;
+    react?: unknown;
+} | {
+    text: string;
+    html?: string;
+    react?: unknown;
+} | {
+    react: unknown;
+    html?: string;
+    text?: string;
+});
+/**
+ * A saved template, by its slug or id. Every variable the template uses must have a value in
+ * `data`. `subject` is optional: the template's own subject is used unless you pass one.
+ */
+type SendTemplate = {
+    template: string;
+    data?: TemplateData;
+    subject?: string;
+    html?: never;
+    text?: never;
+    react?: never;
+};
+/** Either your own content (`html` / `text` / `react`) or a saved `template` with `data`, never both. */
+type SendEmailOptions = SendEmailBase & (SendContent | SendTemplate);
+interface SendEmailResponse {
+    id: string;
+}
+interface EmailEvent {
+    type: string;
+    occurred_at: string;
+}
+interface Email {
+    object: 'email';
+    id: string;
+    from: string;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    reply_to: string[];
+    subject: string;
+    html: string | null;
+    text: string | null;
+    status: string;
+    last_event: string;
+    error: string | null;
+    created_at: string;
+    sent_at: string | null;
+    delivered_at: string | null;
+    events: EmailEvent[];
+}
+type Result<T> = {
+    data: T;
+    error: null;
+} | {
+    data: null;
+    error: SendhiveError;
+};
+interface SendhiveOptions {
+    baseUrl?: string;
+}
+
+declare class Emails {
+    private readonly client;
+    constructor(client: Sendhive);
+    send(options: SendEmailOptions): Promise<Result<SendEmailResponse>>;
+    get(id: string): Promise<Result<Email>>;
+}
+declare class Sendhive {
+    readonly emails: Emails;
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(apiKey?: string, options?: SendhiveOptions);
+    /** @internal */
+    request<T>(method: 'GET' | 'POST', path: string, body?: unknown): Promise<Result<T>>;
+}
+
+export { type Email, type EmailEvent, type EmailTag, type Recipients, type Result, type SendEmailOptions, type SendEmailResponse, Sendhive, type SendhiveError, type SendhiveErrorFix, type SendhiveOptions, type TemplateData, Sendhive as default };

package/dist/index.js

@@ -0,0 +1,107 @@
+// src/index.ts
+function env(name) {
+  return typeof process !== "undefined" ? process.env?.[name] : void 0;
+}
+async function renderReact(element) {
+  const specifier = "@react-email/render";
+  let mod;
+  try {
+    mod = await import(
+      /* @vite-ignore */
+      specifier
+    );
+  } catch {
+    throw new Error("The `react` option needs the optional peer dependency @react-email/render.");
+  }
+  if (!mod.render) throw new Error("@react-email/render has no `render` export.");
+  return mod.render(element);
+}
+var Emails = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async send(options) {
+    const { replyTo, react, ...rest } = options;
+    let html = rest.html;
+    if (react !== void 0) {
+      try {
+        html = await renderReact(react);
+      } catch (err) {
+        return {
+          data: null,
+          error: { statusCode: 422, name: "validation_error", message: err.message }
+        };
+      }
+    }
+    const body = {
+      ...rest,
+      ...html !== void 0 ? { html } : {},
+      ...replyTo !== void 0 ? { reply_to: replyTo } : {}
+    };
+    return this.client.request("POST", "/api/emails", body);
+  }
+  async get(id) {
+    return this.client.request("GET", `/api/emails/${encodeURIComponent(id)}`);
+  }
+};
+var Sendhive = class {
+  emails;
+  apiKey;
+  baseUrl;
+  constructor(apiKey, options = {}) {
+    this.apiKey = apiKey ?? env("SENDHIVE_API_KEY");
+    const baseUrl = options.baseUrl ?? env("SENDHIVE_BASE_URL");
+    if (!baseUrl) throw new Error("Sendhive: set `baseUrl` or SENDHIVE_BASE_URL to your Sendhive server.");
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.emails = new Emails(this);
+  }
+  /** @internal */
+  async request(method, path, body) {
+    const headers = { Accept: "application/json" };
+    if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`;
+    if (body !== void 0) headers["Content-Type"] = "application/json";
+    let res;
+    try {
+      res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers,
+        body: body === void 0 ? void 0 : JSON.stringify(body)
+      });
+    } catch (err) {
+      return {
+        data: null,
+        error: {
+          statusCode: 0,
+          name: "network_error",
+          message: err instanceof Error ? err.message : String(err)
+        }
+      };
+    }
+    let json;
+    try {
+      json = await res.json();
+    } catch {
+      json = null;
+    }
+    if (!res.ok) {
+      const e = json ?? {};
+      return {
+        data: null,
+        error: {
+          statusCode: e.statusCode ?? res.status,
+          name: e.name ?? "application_error",
+          message: e.message ?? (res.statusText || "Unexpected response"),
+          ...e.fix ? { fix: e.fix } : {}
+        }
+      };
+    }
+    return { data: json, error: null };
+  }
+};
+var index_default = Sendhive;
+export {
+  Sendhive,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  Email,\n  Result,\n  SendEmailOptions,\n  SendEmailResponse,\n  SendhiveError,\n  SendhiveOptions,\n} from './types'\n\nexport type {\n  Email,\n  EmailEvent,\n  EmailTag,\n  Recipients,\n  Result,\n  SendEmailOptions,\n  SendEmailResponse,\n  SendhiveError,\n  SendhiveErrorFix,\n  SendhiveOptions,\n  TemplateData,\n} from './types'\n\nfunction env(name: string): string | undefined {\n  return typeof process !== 'undefined' ? process.env?.[name] : undefined\n}\n\n/** Optional peer: only loaded when the caller passes `react`. */\nasync function renderReact(element: unknown): Promise<string> {\n  const specifier = '@react-email/render'\n  let mod: { render?: (el: unknown) => string | Promise<string> }\n  try {\n    mod = await import(/* @vite-ignore */ specifier)\n  } catch {\n    throw new Error('The `react` option needs the optional peer dependency @react-email/render.')\n  }\n  if (!mod.render) throw new Error('@react-email/render has no `render` export.')\n  return mod.render(element)\n}\n\nclass Emails {\n  constructor(private readonly client: Sendhive) {}\n\n  async send(options: SendEmailOptions): Promise<Result<SendEmailResponse>> {\n    const { replyTo, react, ...rest } = options\n    let html = rest.html\n    if (react !== undefined) {\n      try {\n        html = await renderReact(react)\n      } catch (err) {\n        return {\n          data: null,\n          error: { statusCode: 422, name: 'validation_error', message: (err as Error).message },\n        }\n      }\n    }\n    const body = {\n      ...rest,\n      ...(html !== undefined ? { html } : {}),\n      ...(replyTo !== undefined ? { reply_to: replyTo } : {}),\n    }\n    return this.client.request<SendEmailResponse>('POST', '/api/emails', body)\n  }\n\n  async get(id: string): Promise<Result<Email>> {\n    return this.client.request<Email>('GET', `/api/emails/${encodeURIComponent(id)}`)\n  }\n}\n\nexport class Sendhive {\n  readonly emails: Emails\n  private readonly apiKey: string | undefined\n  private readonly baseUrl: string\n\n  constructor(apiKey?: string, options: SendhiveOptions = {}) {\n    this.apiKey = apiKey ?? env('SENDHIVE_API_KEY')\n    // No default host: an API key must never be sent to a server the caller did not choose.\n    const baseUrl = options.baseUrl ?? env('SENDHIVE_BASE_URL')\n    if (!baseUrl) throw new Error('Sendhive: set `baseUrl` or SENDHIVE_BASE_URL to your Sendhive server.')\n    this.baseUrl = baseUrl.replace(/\\/+$/, '')\n    this.emails = new Emails(this)\n  }\n\n  /** @internal */\n  async request<T>(method: 'GET' | 'POST', path: string, body?: unknown): Promise<Result<T>> {\n    const headers: Record<string, string> = { Accept: 'application/json' }\n    if (this.apiKey) headers.Authorization = `Bearer ${this.apiKey}`\n    if (body !== undefined) headers['Content-Type'] = 'application/json'\n\n    let res: Response\n    try {\n      res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers,\n        body: body === undefined ? undefined : JSON.stringify(body),\n      })\n    } catch (err) {\n      return {\n        data: null,\n        error: {\n          statusCode: 0,\n          name: 'network_error',\n          message: err instanceof Error ? err.message : String(err),\n        },\n      }\n    }\n\n    let json: unknown\n    try {\n      json = await res.json()\n    } catch {\n      json = null\n    }\n\n    if (!res.ok) {\n      const e = (json ?? {}) as Partial<SendhiveError>\n      return {\n        data: null,\n        error: {\n          statusCode: e.statusCode ?? res.status,\n          name: e.name ?? 'application_error',\n          message: e.message ?? (res.statusText || 'Unexpected response'),\n          ...(e.fix ? { fix: e.fix } : {}),\n        },\n      }\n    }\n    return { data: json as T, error: null }\n  }\n}\n\nexport default Sendhive\n"],"mappings":";AAuBA,SAAS,IAAI,MAAkC;AAC7C,SAAO,OAAO,YAAY,cAAc,QAAQ,MAAM,IAAI,IAAI;AAChE;AAGA,eAAe,YAAY,SAAmC;AAC5D,QAAM,YAAY;AAClB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM;AAAA;AAAA,MAA0B;AAAA;AAAA,EACxC,QAAQ;AACN,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AACA,MAAI,CAAC,IAAI,OAAQ,OAAM,IAAI,MAAM,6CAA6C;AAC9E,SAAO,IAAI,OAAO,OAAO;AAC3B;AAEA,IAAM,SAAN,MAAa;AAAA,EACX,YAA6B,QAAkB;AAAlB;AAAA,EAAmB;AAAA,EAAnB;AAAA,EAE7B,MAAM,KAAK,SAA+D;AACxE,UAAM,EAAE,SAAS,OAAO,GAAG,KAAK,IAAI;AACpC,QAAI,OAAO,KAAK;AAChB,QAAI,UAAU,QAAW;AACvB,UAAI;AACF,eAAO,MAAM,YAAY,KAAK;AAAA,MAChC,SAAS,KAAK;AACZ,eAAO;AAAA,UACL,MAAM;AAAA,UACN,OAAO,EAAE,YAAY,KAAK,MAAM,oBAAoB,SAAU,IAAc,QAAQ;AAAA,QACtF;AAAA,MACF;AAAA,IACF;AACA,UAAM,OAAO;AAAA,MACX,GAAG;AAAA,MACH,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,MACrC,GAAI,YAAY,SAAY,EAAE,UAAU,QAAQ,IAAI,CAAC;AAAA,IACvD;AACA,WAAO,KAAK,OAAO,QAA2B,QAAQ,eAAe,IAAI;AAAA,EAC3E;AAAA,EAEA,MAAM,IAAI,IAAoC;AAC5C,WAAO,KAAK,OAAO,QAAe,OAAO,eAAe,mBAAmB,EAAE,CAAC,EAAE;AAAA,EAClF;AACF;AAEO,IAAM,WAAN,MAAe;AAAA,EACX;AAAA,EACQ;AAAA,EACA;AAAA,EAEjB,YAAY,QAAiB,UAA2B,CAAC,GAAG;AAC1D,SAAK,SAAS,UAAU,IAAI,kBAAkB;AAE9C,UAAM,UAAU,QAAQ,WAAW,IAAI,mBAAmB;AAC1D,QAAI,CAAC,QAAS,OAAM,IAAI,MAAM,uEAAuE;AACrG,SAAK,UAAU,QAAQ,QAAQ,QAAQ,EAAE;AACzC,SAAK,SAAS,IAAI,OAAO,IAAI;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAM,QAAW,QAAwB,MAAc,MAAoC;AACzF,UAAM,UAAkC,EAAE,QAAQ,mBAAmB;AACrE,QAAI,KAAK,OAAQ,SAAQ,gBAAgB,UAAU,KAAK,MAAM;AAC9D,QAAI,SAAS,OAAW,SAAQ,cAAc,IAAI;AAElD,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI,IAAI;AAAA,QAC1C;AAAA,QACA;AAAA,QACA,MAAM,SAAS,SAAY,SAAY,KAAK,UAAU,IAAI;AAAA,MAC5D,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,UACL,YAAY;AAAA,UACZ,MAAM;AAAA,UACN,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,QAC1D;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,aAAO,MAAM,IAAI,KAAK;AAAA,IACxB,QAAQ;AACN,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAK,QAAQ,CAAC;AACpB,aAAO;AAAA,QACL,MAAM;AAAA,QACN,OAAO;AAAA,UACL,YAAY,EAAE,cAAc,IAAI;AAAA,UAChC,MAAM,EAAE,QAAQ;AAAA,UAChB,SAAS,EAAE,YAAY,IAAI,cAAc;AAAA,UACzC,GAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AACA,WAAO,EAAE,MAAM,MAAW,OAAO,KAAK;AAAA,EACxC;AACF;AAEA,IAAO,gBAAQ;","names":[]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "sendhive",
+  "version": "0.1.0-beta.0",
+  "description": "Tiny TypeScript SDK for the Sendhive email API (Resend-compatible shape).",
+  "keywords": [
+    "email",
+    "email-api",
+    "sendhive",
+    "transactional-email",
+    "amazon-ses",
+    "react-email",
+    "sdk"
+  ],
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run test && bun run typecheck && bun run build",
+    "bump:beta": "npm version prerelease --preid beta --no-git-tag-version",
+    "release:beta": "npm publish --tag beta",
+    "release": "npm publish"
+  },
+  "peerDependencies": {
+    "@react-email/render": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-email/render": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@react-email/render": "^2.0.6",
+    "@react-email/components": "^1.0.12",
+    "@types/bun": "latest",
+    "@types/react": "^19.3.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.0"
+  }
+}