nsend-email 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,194 @@
+interface NSendConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface SendEmailParams {
+    from: string;
+    to: string | string[];
+    subject?: string;
+    html?: string;
+    text?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    reply_to?: string | string[];
+    template_id?: string;
+    variables?: Record<string, string>;
+    metadata?: Record<string, string>;
+}
+interface SendEmailResult {
+    id: string;
+    status: string;
+}
+interface BatchResult {
+    data: Array<{
+        id?: string;
+        status?: string;
+        error?: string;
+    }>;
+}
+interface Email {
+    id: string;
+    from: string;
+    to: string[];
+    cc: string[];
+    bcc: string[];
+    subject: string;
+    status: string;
+    created_at: string;
+    sent_at: string | null;
+}
+interface Domain {
+    id: string;
+    name: string;
+    status: string;
+    dns_records?: Array<{
+        type: string;
+        name: string;
+        value: string;
+        purpose: string;
+    }>;
+    created_at: string;
+}
+interface ApiKey {
+    id: string;
+    name: string;
+    key?: string;
+    key_prefix: string;
+    last_used_at: string | null;
+    created_at: string;
+}
+interface Template {
+    id: string;
+    name: string;
+    subject: string;
+    html?: string;
+    text?: string;
+    variables: string[];
+    created_at: string;
+    updated_at: string;
+}
+interface InboundEmail {
+    id: string;
+    from: string;
+    to: string[];
+    cc: string[];
+    subject: string;
+    html: string | null;
+    text: string | null;
+    thread_id: string | null;
+    message_id: string | null;
+    headers: Record<string, string>;
+    received_at: string;
+}
+interface Thread {
+    id: string;
+    subject: string;
+    message_count: {
+        inbound: number;
+        outbound: number;
+    };
+    last_message_at: string;
+    created_at: string;
+    messages?: Array<{
+        id: string;
+        direction: "inbound" | "outbound";
+        from: string;
+        to: string[];
+        subject: string;
+        html: string | null;
+        text: string | null;
+        status?: string;
+        timestamp: string;
+    }>;
+}
+declare class ApiClient {
+    private baseUrl;
+    private apiKey;
+    constructor(baseUrl: string, apiKey: string);
+    request<T>(path: string, options?: RequestInit): Promise<T>;
+}
+declare class EmailsResource {
+    private client;
+    constructor(client: ApiClient);
+    send(params: SendEmailParams): Promise<SendEmailResult>;
+    batch(params: SendEmailParams[]): Promise<BatchResult>;
+    get(id: string): Promise<Email>;
+}
+declare class DomainsResource {
+    private client;
+    constructor(client: ApiClient);
+    create(name: string): Promise<Domain>;
+    list(): Promise<Domain[]>;
+    get(id: string): Promise<Domain>;
+    verify(id: string): Promise<Domain>;
+    delete(id: string): Promise<{
+        deleted: boolean;
+    }>;
+}
+declare class ApiKeysResource {
+    private client;
+    constructor(client: ApiClient);
+    create(name: string): Promise<ApiKey>;
+    list(): Promise<ApiKey[]>;
+    revoke(id: string): Promise<{
+        deleted: boolean;
+    }>;
+}
+declare class TemplatesResource {
+    private client;
+    constructor(client: ApiClient);
+    create(params: {
+        name: string;
+        subject: string;
+        html: string;
+        text?: string;
+    }): Promise<Template>;
+    list(): Promise<Template[]>;
+    get(id: string): Promise<Template>;
+    update(id: string, params: Partial<{
+        name: string;
+        subject: string;
+        html: string;
+        text: string;
+    }>): Promise<Template>;
+    delete(id: string): Promise<{
+        deleted: boolean;
+    }>;
+}
+declare class InboxResource {
+    private client;
+    constructor(client: ApiClient);
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<InboundEmail[]>;
+    get(id: string): Promise<InboundEmail>;
+}
+declare class ThreadsResource {
+    private client;
+    constructor(client: ApiClient);
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Thread[]>;
+    get(id: string): Promise<Thread>;
+    reply(threadId: string, params: {
+        from: string;
+        html?: string;
+        text?: string;
+        cc?: string | string[];
+    }): Promise<SendEmailResult & {
+        thread_id: string;
+    }>;
+}
+declare class NSend {
+    readonly emails: EmailsResource;
+    readonly domains: DomainsResource;
+    readonly apiKeys: ApiKeysResource;
+    readonly templates: TemplatesResource;
+    readonly inbox: InboxResource;
+    readonly threads: ThreadsResource;
+    constructor(config: NSendConfig);
+}
+
+export { type ApiKey, type BatchResult, type Domain, type Email, type InboundEmail, NSend, type NSendConfig, type SendEmailParams, type SendEmailResult, type Template, type Thread, NSend as default };

package/dist/index.js

@@ -0,0 +1,191 @@
+// src/index.ts
+var NSendError = class extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "NSendError";
+  }
+  status;
+  body;
+};
+var ApiClient = class {
+  constructor(baseUrl, apiKey) {
+    this.baseUrl = baseUrl;
+    this.apiKey = apiKey;
+  }
+  baseUrl;
+  apiKey;
+  async request(path, options = {}) {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+        ...options.headers
+      }
+    });
+    const body = await res.json();
+    if (!res.ok) {
+      throw new NSendError(
+        body.error || `API error ${res.status}`,
+        res.status,
+        body
+      );
+    }
+    return body;
+  }
+};
+var EmailsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async send(params) {
+    return this.client.request("/emails", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async batch(params) {
+    return this.client.request("/emails/batch", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async get(id) {
+    return this.client.request(`/emails/${id}`);
+  }
+};
+var DomainsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(name) {
+    return this.client.request("/domains", {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
+  async list() {
+    return this.client.request("/domains");
+  }
+  async get(id) {
+    return this.client.request(`/domains/${id}`);
+  }
+  async verify(id) {
+    return this.client.request(`/domains/${id}/verify`, { method: "POST" });
+  }
+  async delete(id) {
+    return this.client.request(`/domains/${id}`, { method: "DELETE" });
+  }
+};
+var ApiKeysResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(name) {
+    return this.client.request("/api-keys", {
+      method: "POST",
+      body: JSON.stringify({ name })
+    });
+  }
+  async list() {
+    return this.client.request("/api-keys");
+  }
+  async revoke(id) {
+    return this.client.request(`/api-keys/${id}`, { method: "DELETE" });
+  }
+};
+var TemplatesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async create(params) {
+    return this.client.request("/templates", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async list() {
+    return this.client.request("/templates");
+  }
+  async get(id) {
+    return this.client.request(`/templates/${id}`);
+  }
+  async update(id, params) {
+    return this.client.request(`/templates/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(params)
+    });
+  }
+  async delete(id) {
+    return this.client.request(`/templates/${id}`, { method: "DELETE" });
+  }
+};
+var InboxResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.offset) query.set("offset", String(params.offset));
+    const qs = query.toString();
+    return this.client.request(`/inbox${qs ? `?${qs}` : ""}`);
+  }
+  async get(id) {
+    return this.client.request(`/inbox/${id}`);
+  }
+};
+var ThreadsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async list(params) {
+    const query = new URLSearchParams();
+    if (params?.limit) query.set("limit", String(params.limit));
+    if (params?.offset) query.set("offset", String(params.offset));
+    const qs = query.toString();
+    return this.client.request(`/threads${qs ? `?${qs}` : ""}`);
+  }
+  async get(id) {
+    return this.client.request(`/threads/${id}`);
+  }
+  async reply(threadId, params) {
+    return this.client.request(`/threads/${threadId}/reply`, {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+};
+var NSend = class {
+  emails;
+  domains;
+  apiKeys;
+  templates;
+  inbox;
+  threads;
+  constructor(config) {
+    const client = new ApiClient(
+      config.baseUrl || "http://localhost:3000",
+      config.apiKey
+    );
+    this.emails = new EmailsResource(client);
+    this.domains = new DomainsResource(client);
+    this.apiKeys = new ApiKeysResource(client);
+    this.templates = new TemplatesResource(client);
+    this.inbox = new InboxResource(client);
+    this.threads = new ThreadsResource(client);
+  }
+};
+var index_default = NSend;
+export {
+  NSend,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "nsend-email",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for NSend — email API for developers and agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch"
+  }
+}