@hiveku-apps/email 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hiveku
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @hiveku/email
+
+Official Node.js / TypeScript SDK for the **Hiveku Transactional Email Service**.
+
+Send transactional emails, manage sending domains, and track delivery stats — all through a simple API.
+
+## Installation
+
+```bash
+npm install @hiveku/email
+```
+
+## Quick start
+
+```typescript
+import HivekuEmail from '@hiveku/email';
+
+const email = new HivekuEmail('hk_live_YOUR_KEY');
+
+await email.send({
+  from: 'Acme <hello@acme.com>',
+  to: 'user@example.com',
+  subject: 'Welcome to Acme!',
+  html: '<p>Thanks for signing up.</p>',
+});
+```
+
+Or set `HIVEKU_EMAIL_API_KEY` in your environment and call the module-level helper:
+
+```typescript
+import { sendEmail } from '@hiveku/email';
+
+await sendEmail({
+  from: 'hello@yourdomain.com',
+  to: 'user@example.com',
+  subject: 'Hello World',
+  html: '<p>Welcome!</p>',
+});
+```
+
+## Usage with curl
+
+```bash
+curl -X POST https://api.hiveku.com/v1/email/send \
+  -H "Authorization: Bearer hk_live_YOUR_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "from": "hello@yourdomain.com",
+    "to": ["user@example.com"],
+    "subject": "Hello World",
+    "html": "<p>Welcome!</p>"
+  }'
+```
+
+## API
+
+### `new HivekuEmail(apiKeyOrConfig?)`
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `apiKey` | `string` | Your Hiveku API key (`hk_live_...` or `hk_test_...`) |
+| `baseUrl` | `string` | Override the API base URL |
+| `timeout` | `number` | Request timeout in ms (default: `30000`) |
+
+### Methods
+
+| Method | Description |
+|--------|-------------|
+| `send(options)` | Send a single email |
+| `sendBatch(emails[])` | Send up to 50 emails in one request |
+| `listDomains()` | List all sending domains |
+| `addDomain(domain)` | Add a domain and get DNS records |
+| `verifyDomain(domainId)` | Re-check domain DNS verification |
+| `deleteDomain(domainId)` | Remove a domain |
+| `getUsage(options?)` | Get delivery stats |
+| `generateSmtpCredentials()` | Generate SMTP credentials |
+
+### `send(options)` options
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `from` | `string` | ✓ | Sender — `"Name <email>"` or plain address |
+| `to` | `string \| string[]` | ✓ | Recipient(s) |
+| `subject` | `string` | ✓ | Subject line |
+| `html` | `string` | | HTML body |
+| `text` | `string` | | Plain-text body |
+| `replyTo` | `string` | | Reply-to address |
+| `cc` | `string[]` | | CC recipients |
+| `bcc` | `string[]` | | BCC recipients |
+| `headers` | `Record<string,string>` | | Custom headers |
+| `tags` | `Record<string,string>` | | Tracking tags |
+| `attachments` | `Attachment[]` | | File attachments (base64) |
+| `scheduledAt` | `string` | | Schedule delivery (ISO 8601) |
+
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `HIVEKU_EMAIL_API_KEY` | API key used by the default client |
+| `HIVEKU_API_URL` | Override the API base URL |
+
+## Links
+
+- Dashboard: [app.hiveku.com](https://app.hiveku.com)
+- API Docs: [app.hiveku.com/docs](https://app.hiveku.com/docs)
+- Status: [status.hiveku.com](https://status.hiveku.com)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/index.ts
+var HivekuEmailError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "HivekuEmailError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var HivekuEmail = class {
+  constructor(apiKeyOrConfig) {
+    if (typeof apiKeyOrConfig === "string") {
+      this.apiKey = apiKeyOrConfig;
+      this.baseUrl = "https://api.hiveku.com";
+      this.timeout = 3e4;
+    } else {
+      this.apiKey = apiKeyOrConfig?.apiKey || (typeof process !== "undefined" ? process.env.HIVEKU_EMAIL_API_KEY ?? "" : "");
+      this.baseUrl = apiKeyOrConfig?.baseUrl || (typeof process !== "undefined" ? process.env.HIVEKU_API_URL ?? "https://api.hiveku.com" : "https://api.hiveku.com");
+      this.timeout = apiKeyOrConfig?.timeout ?? 3e4;
+    }
+    if (!this.apiKey) {
+      throw new Error(
+        "Hiveku Email API key is required. Pass it to the constructor or set the HIVEKU_EMAIL_API_KEY environment variable."
+      );
+    }
+  }
+  // --------------------------------------------------------------------------
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "User-Agent": `hiveku-email-sdk/1.0.0`
+        },
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new HivekuEmailError(
+          data.error || `Request failed with status ${res.status}`,
+          res.status,
+          data.code || "UNKNOWN_ERROR"
+        );
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ── Sending ──────────────────────────────────────────────────────────────
+  /**
+   * Send a single transactional email.
+   *
+   * @example
+   * await email.send({
+   *   from: 'Acme <hello@acme.com>',
+   *   to: 'user@example.com',
+   *   subject: 'Welcome!',
+   *   html: '<p>Thanks for signing up.</p>',
+   * });
+   */
+  async send(options) {
+    return this.request("POST", "/api/v1/email/send", {
+      from: options.from,
+      to: Array.isArray(options.to) ? options.to : [options.to],
+      subject: options.subject,
+      html: options.html,
+      text: options.text,
+      reply_to: options.replyTo,
+      cc: options.cc,
+      bcc: options.bcc,
+      headers: options.headers,
+      tags: options.tags,
+      attachments: options.attachments,
+      scheduled_at: options.scheduledAt
+    });
+  }
+  /**
+   * Send up to 50 emails in a single request.
+   */
+  async sendBatch(emails) {
+    if (emails.length > 50) throw new Error("Maximum 50 emails per batch.");
+    return this.request("POST", "/api/v1/email/batch", {
+      emails: emails.map((e) => ({
+        from: e.from,
+        to: Array.isArray(e.to) ? e.to : [e.to],
+        subject: e.subject,
+        html: e.html,
+        text: e.text,
+        reply_to: e.replyTo,
+        cc: e.cc,
+        bcc: e.bcc,
+        tags: e.tags,
+        attachments: e.attachments,
+        scheduled_at: e.scheduledAt
+      }))
+    });
+  }
+  // ── Domains ───────────────────────────────────────────────────────────────
+  /** List all domains on this account. */
+  async listDomains() {
+    return this.request("GET", "/api/v1/email/domains");
+  }
+  /** Add a domain and get the DNS records to configure. */
+  async addDomain(domain) {
+    return this.request("POST", "/api/v1/email/domains", { domain });
+  }
+  /** Trigger re-verification of a domain's DNS records. */
+  async verifyDomain(domainId) {
+    return this.request("POST", `/api/v1/email/domains/${domainId}`);
+  }
+  /** Remove a domain from the account. */
+  async deleteDomain(domainId) {
+    return this.request("DELETE", `/api/v1/email/domains/${domainId}`);
+  }
+  // ── Usage ─────────────────────────────────────────────────────────────────
+  /** Get send/delivery stats for a date range. */
+  async getUsage(options) {
+    const params = new URLSearchParams();
+    if (options?.startDate) params.set("start_date", options.startDate);
+    if (options?.endDate) params.set("end_date", options.endDate);
+    const qs = params.toString();
+    return this.request("GET", `/api/v1/email/usage${qs ? `?${qs}` : ""}`);
+  }
+  // ── SMTP ──────────────────────────────────────────────────────────────────
+  /**
+   * Generate SMTP credentials — useful for services like Supabase Auth or
+   * any system that only supports SMTP.
+   */
+  async generateSmtpCredentials() {
+    return this.request("POST", "/api/v1/email/smtp-credentials");
+  }
+};
+var _defaultClient = null;
+function init(apiKey, config) {
+  _defaultClient = new HivekuEmail({ apiKey, ...config });
+}
+function getDefault() {
+  if (!_defaultClient) {
+    _defaultClient = new HivekuEmail();
+  }
+  return _defaultClient;
+}
+function sendEmail(options) {
+  return getDefault().send(options);
+}
+var index_default = HivekuEmail;
+
+exports.HivekuEmail = HivekuEmail;
+exports.HivekuEmailError = HivekuEmailError;
+exports.default = index_default;
+exports.init = init;
+exports.sendEmail = sendEmail;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @hiveku/email — Official Hiveku Transactional Email SDK\n * https://hiveku.com\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SendEmailOptions {\n  /** Sender address. Supports \"Name <email>\" format. */\n  from: string;\n  /** One or more recipient addresses. */\n  to: string | string[];\n  /** Email subject line. */\n  subject: string;\n  /** HTML body content. */\n  html?: string;\n  /** Plain text body content. */\n  text?: string;\n  /** Reply-to address. */\n  replyTo?: string;\n  /** CC recipients. */\n  cc?: string[];\n  /** BCC recipients. */\n  bcc?: string[];\n  /** Custom headers. */\n  headers?: Record<string, string>;\n  /** Tags for tracking / filtering (key-value pairs). */\n  tags?: Record<string, string>;\n  /** File attachments. */\n  attachments?: Array<{\n    filename: string;\n    /** Base64-encoded file content. */\n    content: string;\n    contentType?: string;\n  }>;\n  /** Schedule delivery (ISO 8601). */\n  scheduledAt?: string;\n}\n\nexport interface SendEmailResponse {\n  id: string;\n  status: 'queued' | 'sent' | 'failed';\n}\n\nexport interface BatchSendResponse {\n  results: SendEmailResponse[];\n}\n\nexport interface EmailDomain {\n  id: string;\n  domain: string;\n  status: 'pending' | 'verified' | 'failed';\n  dnsRecords?: Array<{\n    type: string;\n    name: string;\n    value: string;\n    priority?: number;\n  }>;\n  createdAt: string;\n}\n\nexport interface UsageStats {\n  sent: number;\n  delivered: number;\n  bounced: number;\n  complained: number;\n  opened: number;\n  clicked: number;\n  period: {\n    start: string;\n    end: string;\n  };\n  limits: {\n    daily: number;\n    monthly: number;\n    dailyUsed: number;\n    monthlyUsed: number;\n  };\n}\n\nexport interface SmtpCredentials {\n  host: string;\n  port: number;\n  username: string;\n  password: string;\n  secure: boolean;\n}\n\nexport interface HivekuEmailConfig {\n  /** Your Hiveku API key (hk_live_... or hk_test_...). */\n  apiKey?: string;\n  /** Override the base URL (default: https://api.hiveku.com). */\n  baseUrl?: string;\n  /** Request timeout in milliseconds (default: 30000). */\n  timeout?: number;\n}\n\nexport class HivekuEmailError extends Error {\n  status: number;\n  code: string;\n\n  constructor(message: string, status: number, code: string) {\n    super(message);\n    this.name = 'HivekuEmailError';\n    this.status = status;\n    this.code = code;\n  }\n}\n\n// ============================================================================\n// Client\n// ============================================================================\n\nexport class HivekuEmail {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(apiKeyOrConfig?: string | HivekuEmailConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = 'https://api.hiveku.com';\n      this.timeout = 30_000;\n    } else {\n      this.apiKey =\n        apiKeyOrConfig?.apiKey ||\n        (typeof process !== 'undefined' ? process.env.HIVEKU_EMAIL_API_KEY ?? '' : '');\n      this.baseUrl =\n        apiKeyOrConfig?.baseUrl ||\n        (typeof process !== 'undefined'\n          ? process.env.HIVEKU_API_URL ?? 'https://api.hiveku.com'\n          : 'https://api.hiveku.com');\n      this.timeout = apiKeyOrConfig?.timeout ?? 30_000;\n    }\n\n    if (!this.apiKey) {\n      throw new Error(\n        'Hiveku Email API key is required. Pass it to the constructor or set the HIVEKU_EMAIL_API_KEY environment variable.'\n      );\n    }\n  }\n\n  // --------------------------------------------------------------------------\n\n  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': `hiveku-email-sdk/1.0.0`,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      const data = (await res.json()) as Record<string, unknown>;\n\n      if (!res.ok) {\n        throw new HivekuEmailError(\n          (data.error as string) || `Request failed with status ${res.status}`,\n          res.status,\n          (data.code as string) || 'UNKNOWN_ERROR'\n        );\n      }\n\n      return data as T;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  // ── Sending ──────────────────────────────────────────────────────────────\n\n  /**\n   * Send a single transactional email.\n   *\n   * @example\n   * await email.send({\n   *   from: 'Acme <hello@acme.com>',\n   *   to: 'user@example.com',\n   *   subject: 'Welcome!',\n   *   html: '<p>Thanks for signing up.</p>',\n   * });\n   */\n  async send(options: SendEmailOptions): Promise<SendEmailResponse> {\n    return this.request<SendEmailResponse>('POST', '/api/v1/email/send', {\n      from: options.from,\n      to: Array.isArray(options.to) ? options.to : [options.to],\n      subject: options.subject,\n      html: options.html,\n      text: options.text,\n      reply_to: options.replyTo,\n      cc: options.cc,\n      bcc: options.bcc,\n      headers: options.headers,\n      tags: options.tags,\n      attachments: options.attachments,\n      scheduled_at: options.scheduledAt,\n    });\n  }\n\n  /**\n   * Send up to 50 emails in a single request.\n   */\n  async sendBatch(emails: SendEmailOptions[]): Promise<BatchSendResponse> {\n    if (emails.length > 50) throw new Error('Maximum 50 emails per batch.');\n\n    return this.request<BatchSendResponse>('POST', '/api/v1/email/batch', {\n      emails: emails.map((e) => ({\n        from: e.from,\n        to: Array.isArray(e.to) ? e.to : [e.to],\n        subject: e.subject,\n        html: e.html,\n        text: e.text,\n        reply_to: e.replyTo,\n        cc: e.cc,\n        bcc: e.bcc,\n        tags: e.tags,\n        attachments: e.attachments,\n        scheduled_at: e.scheduledAt,\n      })),\n    });\n  }\n\n  // ── Domains ───────────────────────────────────────────────────────────────\n\n  /** List all domains on this account. */\n  async listDomains(): Promise<{ domains: EmailDomain[] }> {\n    return this.request('GET', '/api/v1/email/domains');\n  }\n\n  /** Add a domain and get the DNS records to configure. */\n  async addDomain(domain: string): Promise<EmailDomain> {\n    return this.request('POST', '/api/v1/email/domains', { domain });\n  }\n\n  /** Trigger re-verification of a domain's DNS records. */\n  async verifyDomain(domainId: string): Promise<EmailDomain> {\n    return this.request('POST', `/api/v1/email/domains/${domainId}`);\n  }\n\n  /** Remove a domain from the account. */\n  async deleteDomain(domainId: string): Promise<{ success: boolean }> {\n    return this.request('DELETE', `/api/v1/email/domains/${domainId}`);\n  }\n\n  // ── Usage ─────────────────────────────────────────────────────────────────\n\n  /** Get send/delivery stats for a date range. */\n  async getUsage(options?: { startDate?: string; endDate?: string }): Promise<UsageStats> {\n    const params = new URLSearchParams();\n    if (options?.startDate) params.set('start_date', options.startDate);\n    if (options?.endDate) params.set('end_date', options.endDate);\n    const qs = params.toString();\n    return this.request('GET', `/api/v1/email/usage${qs ? `?${qs}` : ''}`);\n  }\n\n  // ── SMTP ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Generate SMTP credentials — useful for services like Supabase Auth or\n   * any system that only supports SMTP.\n   */\n  async generateSmtpCredentials(): Promise<SmtpCredentials> {\n    return this.request('POST', '/api/v1/email/smtp-credentials');\n  }\n}\n\n// ============================================================================\n// Module-level convenience\n// ============================================================================\n\nlet _defaultClient: HivekuEmail | null = null;\n\n/** Initialize the default module-level client. */\nexport function init(apiKey: string, config?: Omit<HivekuEmailConfig, 'apiKey'>): void {\n  _defaultClient = new HivekuEmail({ apiKey, ...config });\n}\n\nfunction getDefault(): HivekuEmail {\n  if (!_defaultClient) {\n    _defaultClient = new HivekuEmail();\n  }\n  return _defaultClient;\n}\n\n/** Send an email using the module-level default client. */\nexport function sendEmail(options: SendEmailOptions): Promise<SendEmailResponse> {\n  return getDefault().send(options);\n}\n\nexport default HivekuEmail;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,143 @@
+/**
+ * @hiveku/email — Official Hiveku Transactional Email SDK
+ * https://hiveku.com
+ */
+interface SendEmailOptions {
+    /** Sender address. Supports "Name <email>" format. */
+    from: string;
+    /** One or more recipient addresses. */
+    to: string | string[];
+    /** Email subject line. */
+    subject: string;
+    /** HTML body content. */
+    html?: string;
+    /** Plain text body content. */
+    text?: string;
+    /** Reply-to address. */
+    replyTo?: string;
+    /** CC recipients. */
+    cc?: string[];
+    /** BCC recipients. */
+    bcc?: string[];
+    /** Custom headers. */
+    headers?: Record<string, string>;
+    /** Tags for tracking / filtering (key-value pairs). */
+    tags?: Record<string, string>;
+    /** File attachments. */
+    attachments?: Array<{
+        filename: string;
+        /** Base64-encoded file content. */
+        content: string;
+        contentType?: string;
+    }>;
+    /** Schedule delivery (ISO 8601). */
+    scheduledAt?: string;
+}
+interface SendEmailResponse {
+    id: string;
+    status: 'queued' | 'sent' | 'failed';
+}
+interface BatchSendResponse {
+    results: SendEmailResponse[];
+}
+interface EmailDomain {
+    id: string;
+    domain: string;
+    status: 'pending' | 'verified' | 'failed';
+    dnsRecords?: Array<{
+        type: string;
+        name: string;
+        value: string;
+        priority?: number;
+    }>;
+    createdAt: string;
+}
+interface UsageStats {
+    sent: number;
+    delivered: number;
+    bounced: number;
+    complained: number;
+    opened: number;
+    clicked: number;
+    period: {
+        start: string;
+        end: string;
+    };
+    limits: {
+        daily: number;
+        monthly: number;
+        dailyUsed: number;
+        monthlyUsed: number;
+    };
+}
+interface SmtpCredentials {
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure: boolean;
+}
+interface HivekuEmailConfig {
+    /** Your Hiveku API key (hk_live_... or hk_test_...). */
+    apiKey?: string;
+    /** Override the base URL (default: https://api.hiveku.com). */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+}
+declare class HivekuEmailError extends Error {
+    status: number;
+    code: string;
+    constructor(message: string, status: number, code: string);
+}
+declare class HivekuEmail {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(apiKeyOrConfig?: string | HivekuEmailConfig);
+    private request;
+    /**
+     * Send a single transactional email.
+     *
+     * @example
+     * await email.send({
+     *   from: 'Acme <hello@acme.com>',
+     *   to: 'user@example.com',
+     *   subject: 'Welcome!',
+     *   html: '<p>Thanks for signing up.</p>',
+     * });
+     */
+    send(options: SendEmailOptions): Promise<SendEmailResponse>;
+    /**
+     * Send up to 50 emails in a single request.
+     */
+    sendBatch(emails: SendEmailOptions[]): Promise<BatchSendResponse>;
+    /** List all domains on this account. */
+    listDomains(): Promise<{
+        domains: EmailDomain[];
+    }>;
+    /** Add a domain and get the DNS records to configure. */
+    addDomain(domain: string): Promise<EmailDomain>;
+    /** Trigger re-verification of a domain's DNS records. */
+    verifyDomain(domainId: string): Promise<EmailDomain>;
+    /** Remove a domain from the account. */
+    deleteDomain(domainId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Get send/delivery stats for a date range. */
+    getUsage(options?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<UsageStats>;
+    /**
+     * Generate SMTP credentials — useful for services like Supabase Auth or
+     * any system that only supports SMTP.
+     */
+    generateSmtpCredentials(): Promise<SmtpCredentials>;
+}
+/** Initialize the default module-level client. */
+declare function init(apiKey: string, config?: Omit<HivekuEmailConfig, 'apiKey'>): void;
+/** Send an email using the module-level default client. */
+declare function sendEmail(options: SendEmailOptions): Promise<SendEmailResponse>;
+
+export { type BatchSendResponse, type EmailDomain, HivekuEmail, type HivekuEmailConfig, HivekuEmailError, type SendEmailOptions, type SendEmailResponse, type SmtpCredentials, type UsageStats, HivekuEmail as default, init, sendEmail };

package/dist/index.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @hiveku/email — Official Hiveku Transactional Email SDK
+ * https://hiveku.com
+ */
+interface SendEmailOptions {
+    /** Sender address. Supports "Name <email>" format. */
+    from: string;
+    /** One or more recipient addresses. */
+    to: string | string[];
+    /** Email subject line. */
+    subject: string;
+    /** HTML body content. */
+    html?: string;
+    /** Plain text body content. */
+    text?: string;
+    /** Reply-to address. */
+    replyTo?: string;
+    /** CC recipients. */
+    cc?: string[];
+    /** BCC recipients. */
+    bcc?: string[];
+    /** Custom headers. */
+    headers?: Record<string, string>;
+    /** Tags for tracking / filtering (key-value pairs). */
+    tags?: Record<string, string>;
+    /** File attachments. */
+    attachments?: Array<{
+        filename: string;
+        /** Base64-encoded file content. */
+        content: string;
+        contentType?: string;
+    }>;
+    /** Schedule delivery (ISO 8601). */
+    scheduledAt?: string;
+}
+interface SendEmailResponse {
+    id: string;
+    status: 'queued' | 'sent' | 'failed';
+}
+interface BatchSendResponse {
+    results: SendEmailResponse[];
+}
+interface EmailDomain {
+    id: string;
+    domain: string;
+    status: 'pending' | 'verified' | 'failed';
+    dnsRecords?: Array<{
+        type: string;
+        name: string;
+        value: string;
+        priority?: number;
+    }>;
+    createdAt: string;
+}
+interface UsageStats {
+    sent: number;
+    delivered: number;
+    bounced: number;
+    complained: number;
+    opened: number;
+    clicked: number;
+    period: {
+        start: string;
+        end: string;
+    };
+    limits: {
+        daily: number;
+        monthly: number;
+        dailyUsed: number;
+        monthlyUsed: number;
+    };
+}
+interface SmtpCredentials {
+    host: string;
+    port: number;
+    username: string;
+    password: string;
+    secure: boolean;
+}
+interface HivekuEmailConfig {
+    /** Your Hiveku API key (hk_live_... or hk_test_...). */
+    apiKey?: string;
+    /** Override the base URL (default: https://api.hiveku.com). */
+    baseUrl?: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+}
+declare class HivekuEmailError extends Error {
+    status: number;
+    code: string;
+    constructor(message: string, status: number, code: string);
+}
+declare class HivekuEmail {
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor(apiKeyOrConfig?: string | HivekuEmailConfig);
+    private request;
+    /**
+     * Send a single transactional email.
+     *
+     * @example
+     * await email.send({
+     *   from: 'Acme <hello@acme.com>',
+     *   to: 'user@example.com',
+     *   subject: 'Welcome!',
+     *   html: '<p>Thanks for signing up.</p>',
+     * });
+     */
+    send(options: SendEmailOptions): Promise<SendEmailResponse>;
+    /**
+     * Send up to 50 emails in a single request.
+     */
+    sendBatch(emails: SendEmailOptions[]): Promise<BatchSendResponse>;
+    /** List all domains on this account. */
+    listDomains(): Promise<{
+        domains: EmailDomain[];
+    }>;
+    /** Add a domain and get the DNS records to configure. */
+    addDomain(domain: string): Promise<EmailDomain>;
+    /** Trigger re-verification of a domain's DNS records. */
+    verifyDomain(domainId: string): Promise<EmailDomain>;
+    /** Remove a domain from the account. */
+    deleteDomain(domainId: string): Promise<{
+        success: boolean;
+    }>;
+    /** Get send/delivery stats for a date range. */
+    getUsage(options?: {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<UsageStats>;
+    /**
+     * Generate SMTP credentials — useful for services like Supabase Auth or
+     * any system that only supports SMTP.
+     */
+    generateSmtpCredentials(): Promise<SmtpCredentials>;
+}
+/** Initialize the default module-level client. */
+declare function init(apiKey: string, config?: Omit<HivekuEmailConfig, 'apiKey'>): void;
+/** Send an email using the module-level default client. */
+declare function sendEmail(options: SendEmailOptions): Promise<SendEmailResponse>;
+
+export { type BatchSendResponse, type EmailDomain, HivekuEmail, type HivekuEmailConfig, HivekuEmailError, type SendEmailOptions, type SendEmailResponse, type SmtpCredentials, type UsageStats, HivekuEmail as default, init, sendEmail };

package/dist/index.js

@@ -0,0 +1,156 @@
+// src/index.ts
+var HivekuEmailError = class extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "HivekuEmailError";
+    this.status = status;
+    this.code = code;
+  }
+};
+var HivekuEmail = class {
+  constructor(apiKeyOrConfig) {
+    if (typeof apiKeyOrConfig === "string") {
+      this.apiKey = apiKeyOrConfig;
+      this.baseUrl = "https://api.hiveku.com";
+      this.timeout = 3e4;
+    } else {
+      this.apiKey = apiKeyOrConfig?.apiKey || (typeof process !== "undefined" ? process.env.HIVEKU_EMAIL_API_KEY ?? "" : "");
+      this.baseUrl = apiKeyOrConfig?.baseUrl || (typeof process !== "undefined" ? process.env.HIVEKU_API_URL ?? "https://api.hiveku.com" : "https://api.hiveku.com");
+      this.timeout = apiKeyOrConfig?.timeout ?? 3e4;
+    }
+    if (!this.apiKey) {
+      throw new Error(
+        "Hiveku Email API key is required. Pass it to the constructor or set the HIVEKU_EMAIL_API_KEY environment variable."
+      );
+    }
+  }
+  // --------------------------------------------------------------------------
+  async request(method, path, body) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const res = await fetch(`${this.baseUrl}${path}`, {
+        method,
+        headers: {
+          Authorization: `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json",
+          "User-Agent": `hiveku-email-sdk/1.0.0`
+        },
+        body: body !== void 0 ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      const data = await res.json();
+      if (!res.ok) {
+        throw new HivekuEmailError(
+          data.error || `Request failed with status ${res.status}`,
+          res.status,
+          data.code || "UNKNOWN_ERROR"
+        );
+      }
+      return data;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  // ── Sending ──────────────────────────────────────────────────────────────
+  /**
+   * Send a single transactional email.
+   *
+   * @example
+   * await email.send({
+   *   from: 'Acme <hello@acme.com>',
+   *   to: 'user@example.com',
+   *   subject: 'Welcome!',
+   *   html: '<p>Thanks for signing up.</p>',
+   * });
+   */
+  async send(options) {
+    return this.request("POST", "/api/v1/email/send", {
+      from: options.from,
+      to: Array.isArray(options.to) ? options.to : [options.to],
+      subject: options.subject,
+      html: options.html,
+      text: options.text,
+      reply_to: options.replyTo,
+      cc: options.cc,
+      bcc: options.bcc,
+      headers: options.headers,
+      tags: options.tags,
+      attachments: options.attachments,
+      scheduled_at: options.scheduledAt
+    });
+  }
+  /**
+   * Send up to 50 emails in a single request.
+   */
+  async sendBatch(emails) {
+    if (emails.length > 50) throw new Error("Maximum 50 emails per batch.");
+    return this.request("POST", "/api/v1/email/batch", {
+      emails: emails.map((e) => ({
+        from: e.from,
+        to: Array.isArray(e.to) ? e.to : [e.to],
+        subject: e.subject,
+        html: e.html,
+        text: e.text,
+        reply_to: e.replyTo,
+        cc: e.cc,
+        bcc: e.bcc,
+        tags: e.tags,
+        attachments: e.attachments,
+        scheduled_at: e.scheduledAt
+      }))
+    });
+  }
+  // ── Domains ───────────────────────────────────────────────────────────────
+  /** List all domains on this account. */
+  async listDomains() {
+    return this.request("GET", "/api/v1/email/domains");
+  }
+  /** Add a domain and get the DNS records to configure. */
+  async addDomain(domain) {
+    return this.request("POST", "/api/v1/email/domains", { domain });
+  }
+  /** Trigger re-verification of a domain's DNS records. */
+  async verifyDomain(domainId) {
+    return this.request("POST", `/api/v1/email/domains/${domainId}`);
+  }
+  /** Remove a domain from the account. */
+  async deleteDomain(domainId) {
+    return this.request("DELETE", `/api/v1/email/domains/${domainId}`);
+  }
+  // ── Usage ─────────────────────────────────────────────────────────────────
+  /** Get send/delivery stats for a date range. */
+  async getUsage(options) {
+    const params = new URLSearchParams();
+    if (options?.startDate) params.set("start_date", options.startDate);
+    if (options?.endDate) params.set("end_date", options.endDate);
+    const qs = params.toString();
+    return this.request("GET", `/api/v1/email/usage${qs ? `?${qs}` : ""}`);
+  }
+  // ── SMTP ──────────────────────────────────────────────────────────────────
+  /**
+   * Generate SMTP credentials — useful for services like Supabase Auth or
+   * any system that only supports SMTP.
+   */
+  async generateSmtpCredentials() {
+    return this.request("POST", "/api/v1/email/smtp-credentials");
+  }
+};
+var _defaultClient = null;
+function init(apiKey, config) {
+  _defaultClient = new HivekuEmail({ apiKey, ...config });
+}
+function getDefault() {
+  if (!_defaultClient) {
+    _defaultClient = new HivekuEmail();
+  }
+  return _defaultClient;
+}
+function sendEmail(options) {
+  return getDefault().send(options);
+}
+var index_default = HivekuEmail;
+
+export { HivekuEmail, HivekuEmailError, index_default as default, init, sendEmail };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @hiveku/email — Official Hiveku Transactional Email SDK\n * https://hiveku.com\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface SendEmailOptions {\n  /** Sender address. Supports \"Name <email>\" format. */\n  from: string;\n  /** One or more recipient addresses. */\n  to: string | string[];\n  /** Email subject line. */\n  subject: string;\n  /** HTML body content. */\n  html?: string;\n  /** Plain text body content. */\n  text?: string;\n  /** Reply-to address. */\n  replyTo?: string;\n  /** CC recipients. */\n  cc?: string[];\n  /** BCC recipients. */\n  bcc?: string[];\n  /** Custom headers. */\n  headers?: Record<string, string>;\n  /** Tags for tracking / filtering (key-value pairs). */\n  tags?: Record<string, string>;\n  /** File attachments. */\n  attachments?: Array<{\n    filename: string;\n    /** Base64-encoded file content. */\n    content: string;\n    contentType?: string;\n  }>;\n  /** Schedule delivery (ISO 8601). */\n  scheduledAt?: string;\n}\n\nexport interface SendEmailResponse {\n  id: string;\n  status: 'queued' | 'sent' | 'failed';\n}\n\nexport interface BatchSendResponse {\n  results: SendEmailResponse[];\n}\n\nexport interface EmailDomain {\n  id: string;\n  domain: string;\n  status: 'pending' | 'verified' | 'failed';\n  dnsRecords?: Array<{\n    type: string;\n    name: string;\n    value: string;\n    priority?: number;\n  }>;\n  createdAt: string;\n}\n\nexport interface UsageStats {\n  sent: number;\n  delivered: number;\n  bounced: number;\n  complained: number;\n  opened: number;\n  clicked: number;\n  period: {\n    start: string;\n    end: string;\n  };\n  limits: {\n    daily: number;\n    monthly: number;\n    dailyUsed: number;\n    monthlyUsed: number;\n  };\n}\n\nexport interface SmtpCredentials {\n  host: string;\n  port: number;\n  username: string;\n  password: string;\n  secure: boolean;\n}\n\nexport interface HivekuEmailConfig {\n  /** Your Hiveku API key (hk_live_... or hk_test_...). */\n  apiKey?: string;\n  /** Override the base URL (default: https://api.hiveku.com). */\n  baseUrl?: string;\n  /** Request timeout in milliseconds (default: 30000). */\n  timeout?: number;\n}\n\nexport class HivekuEmailError extends Error {\n  status: number;\n  code: string;\n\n  constructor(message: string, status: number, code: string) {\n    super(message);\n    this.name = 'HivekuEmailError';\n    this.status = status;\n    this.code = code;\n  }\n}\n\n// ============================================================================\n// Client\n// ============================================================================\n\nexport class HivekuEmail {\n  private apiKey: string;\n  private baseUrl: string;\n  private timeout: number;\n\n  constructor(apiKeyOrConfig?: string | HivekuEmailConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = 'https://api.hiveku.com';\n      this.timeout = 30_000;\n    } else {\n      this.apiKey =\n        apiKeyOrConfig?.apiKey ||\n        (typeof process !== 'undefined' ? process.env.HIVEKU_EMAIL_API_KEY ?? '' : '');\n      this.baseUrl =\n        apiKeyOrConfig?.baseUrl ||\n        (typeof process !== 'undefined'\n          ? process.env.HIVEKU_API_URL ?? 'https://api.hiveku.com'\n          : 'https://api.hiveku.com');\n      this.timeout = apiKeyOrConfig?.timeout ?? 30_000;\n    }\n\n    if (!this.apiKey) {\n      throw new Error(\n        'Hiveku Email API key is required. Pass it to the constructor or set the HIVEKU_EMAIL_API_KEY environment variable.'\n      );\n    }\n  }\n\n  // --------------------------------------------------------------------------\n\n  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const res = await fetch(`${this.baseUrl}${path}`, {\n        method,\n        headers: {\n          Authorization: `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n          'User-Agent': `hiveku-email-sdk/1.0.0`,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: controller.signal,\n      });\n\n      const data = (await res.json()) as Record<string, unknown>;\n\n      if (!res.ok) {\n        throw new HivekuEmailError(\n          (data.error as string) || `Request failed with status ${res.status}`,\n          res.status,\n          (data.code as string) || 'UNKNOWN_ERROR'\n        );\n      }\n\n      return data as T;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  // ── Sending ──────────────────────────────────────────────────────────────\n\n  /**\n   * Send a single transactional email.\n   *\n   * @example\n   * await email.send({\n   *   from: 'Acme <hello@acme.com>',\n   *   to: 'user@example.com',\n   *   subject: 'Welcome!',\n   *   html: '<p>Thanks for signing up.</p>',\n   * });\n   */\n  async send(options: SendEmailOptions): Promise<SendEmailResponse> {\n    return this.request<SendEmailResponse>('POST', '/api/v1/email/send', {\n      from: options.from,\n      to: Array.isArray(options.to) ? options.to : [options.to],\n      subject: options.subject,\n      html: options.html,\n      text: options.text,\n      reply_to: options.replyTo,\n      cc: options.cc,\n      bcc: options.bcc,\n      headers: options.headers,\n      tags: options.tags,\n      attachments: options.attachments,\n      scheduled_at: options.scheduledAt,\n    });\n  }\n\n  /**\n   * Send up to 50 emails in a single request.\n   */\n  async sendBatch(emails: SendEmailOptions[]): Promise<BatchSendResponse> {\n    if (emails.length > 50) throw new Error('Maximum 50 emails per batch.');\n\n    return this.request<BatchSendResponse>('POST', '/api/v1/email/batch', {\n      emails: emails.map((e) => ({\n        from: e.from,\n        to: Array.isArray(e.to) ? e.to : [e.to],\n        subject: e.subject,\n        html: e.html,\n        text: e.text,\n        reply_to: e.replyTo,\n        cc: e.cc,\n        bcc: e.bcc,\n        tags: e.tags,\n        attachments: e.attachments,\n        scheduled_at: e.scheduledAt,\n      })),\n    });\n  }\n\n  // ── Domains ───────────────────────────────────────────────────────────────\n\n  /** List all domains on this account. */\n  async listDomains(): Promise<{ domains: EmailDomain[] }> {\n    return this.request('GET', '/api/v1/email/domains');\n  }\n\n  /** Add a domain and get the DNS records to configure. */\n  async addDomain(domain: string): Promise<EmailDomain> {\n    return this.request('POST', '/api/v1/email/domains', { domain });\n  }\n\n  /** Trigger re-verification of a domain's DNS records. */\n  async verifyDomain(domainId: string): Promise<EmailDomain> {\n    return this.request('POST', `/api/v1/email/domains/${domainId}`);\n  }\n\n  /** Remove a domain from the account. */\n  async deleteDomain(domainId: string): Promise<{ success: boolean }> {\n    return this.request('DELETE', `/api/v1/email/domains/${domainId}`);\n  }\n\n  // ── Usage ─────────────────────────────────────────────────────────────────\n\n  /** Get send/delivery stats for a date range. */\n  async getUsage(options?: { startDate?: string; endDate?: string }): Promise<UsageStats> {\n    const params = new URLSearchParams();\n    if (options?.startDate) params.set('start_date', options.startDate);\n    if (options?.endDate) params.set('end_date', options.endDate);\n    const qs = params.toString();\n    return this.request('GET', `/api/v1/email/usage${qs ? `?${qs}` : ''}`);\n  }\n\n  // ── SMTP ──────────────────────────────────────────────────────────────────\n\n  /**\n   * Generate SMTP credentials — useful for services like Supabase Auth or\n   * any system that only supports SMTP.\n   */\n  async generateSmtpCredentials(): Promise<SmtpCredentials> {\n    return this.request('POST', '/api/v1/email/smtp-credentials');\n  }\n}\n\n// ============================================================================\n// Module-level convenience\n// ============================================================================\n\nlet _defaultClient: HivekuEmail | null = null;\n\n/** Initialize the default module-level client. */\nexport function init(apiKey: string, config?: Omit<HivekuEmailConfig, 'apiKey'>): void {\n  _defaultClient = new HivekuEmail({ apiKey, ...config });\n}\n\nfunction getDefault(): HivekuEmail {\n  if (!_defaultClient) {\n    _defaultClient = new HivekuEmail();\n  }\n  return _defaultClient;\n}\n\n/** Send an email using the module-level default client. */\nexport function sendEmail(options: SendEmailOptions): Promise<SendEmailResponse> {\n  return getDefault().send(options);\n}\n\nexport default HivekuEmail;\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@hiveku-apps/email",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for the Hiveku Transactional Email Service",
+  "keywords": ["email", "transactional", "hiveku", "sdk", "smtp"],
+  "homepage": "https://hiveku.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/locus2012/hiveku_builder.git",
+    "directory": "packages/email"
+  },
+  "license": "MIT",
+  "author": "Hiveku",
+  "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"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}