supersendtx 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,103 @@
+type SendEmailParams = {
+    from: string | {
+        email: string;
+        name?: string;
+    };
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    replyTo?: string;
+    reply_to?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+};
+type SendEmailResult = {
+    id: string;
+    status: string;
+};
+type EmailListItem = {
+    id: string;
+    from: string;
+    to: string[];
+    subject: string;
+    status: string;
+    last_event: string | null;
+    bounce_reason: string | null;
+    created_at: string;
+    sent_at: string | null;
+    delivered_at: string | null;
+    bounced_at: string | null;
+};
+type ListEmailsParams = {
+    limit?: number;
+};
+type WebhookEventType = 'email.delivered' | 'email.bounced';
+type WebhookEndpoint = {
+    id: string;
+    url: string;
+    events: string[];
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+};
+type CreateWebhookParams = {
+    url: string;
+    events?: WebhookEventType[];
+};
+type WebhookEndpointWithSecret = {
+    webhook: WebhookEndpoint;
+    secret: string;
+};
+type SuperSendTXOptions = {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+};
+type ApiErrorBody = {
+    error?: {
+        message?: string;
+        details?: unknown;
+    };
+};
+
+declare class EmailsResource {
+    private readonly client;
+    constructor(client: SuperSendTX);
+    list(params?: ListEmailsParams): Promise<{
+        emails: EmailListItem[];
+    }>;
+    send(params: SendEmailParams): Promise<SendEmailResult>;
+}
+
+declare class WebhooksResource {
+    private readonly client;
+    constructor(client: SuperSendTX);
+    list(): Promise<{
+        webhooks: WebhookEndpoint[];
+    }>;
+    create(params: CreateWebhookParams): Promise<WebhookEndpointWithSecret>;
+    delete(id: string): Promise<{
+        ok: boolean;
+    }>;
+}
+
+declare const DEFAULT_API_BASE_URL = "https://api.supersendtx.com";
+declare class SuperSendTX {
+    private readonly apiKey;
+    private readonly options;
+    readonly emails: EmailsResource;
+    readonly webhooks: WebhooksResource;
+    constructor(apiKey: string, options?: SuperSendTXOptions);
+    get baseUrl(): string;
+    get fetchImpl(): typeof fetch;
+    request<T>(path: string, init: RequestInit): Promise<T>;
+}
+
+declare class SuperSendTXError extends Error {
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(message: string, status: number, details?: unknown);
+    static fromResponse(status: number, body: ApiErrorBody): SuperSendTXError;
+}
+
+export { type CreateWebhookParams, DEFAULT_API_BASE_URL, type EmailListItem, type ListEmailsParams, type SendEmailParams, type SendEmailResult, SuperSendTX, SuperSendTXError, type SuperSendTXOptions, type WebhookEndpoint, type WebhookEndpointWithSecret, type WebhookEventType };

package/dist/index.js

@@ -0,0 +1,102 @@
+// src/errors.ts
+var SuperSendTXError = class _SuperSendTXError extends Error {
+  constructor(message, status, details) {
+    super(message);
+    this.name = "SuperSendTXError";
+    this.status = status;
+    this.details = details;
+  }
+  static fromResponse(status, body) {
+    const message = body.error?.message || `Request failed with status ${status}`;
+    return new _SuperSendTXError(message, status, body.error?.details);
+  }
+};
+
+// src/emails.ts
+var EmailsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(params = {}) {
+    const query = params.limit ? `?limit=${params.limit}` : "";
+    return this.client.request(`/emails${query}`, {
+      method: "GET"
+    });
+  }
+  async send(params) {
+    const payload = {
+      from: params.from,
+      to: params.to,
+      subject: params.subject
+    };
+    if (params.html) payload.html = params.html;
+    if (params.text) payload.text = params.text;
+    const replyTo = params.replyTo ?? params.reply_to;
+    if (replyTo) payload.reply_to = replyTo;
+    if (params.cc) payload.cc = params.cc;
+    if (params.bcc) payload.bcc = params.bcc;
+    return this.client.request("/emails", {
+      method: "POST",
+      body: JSON.stringify(payload)
+    });
+  }
+};
+
+// src/webhooks.ts
+var WebhooksResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("/webhooks", { method: "GET" });
+  }
+  async create(params) {
+    return this.client.request("/webhooks", {
+      method: "POST",
+      body: JSON.stringify(params)
+    });
+  }
+  async delete(id) {
+    return this.client.request(`/webhooks/${id}`, { method: "DELETE" });
+  }
+};
+
+// src/client.ts
+var DEFAULT_API_BASE_URL = "https://api.supersendtx.com";
+var SuperSendTX = class {
+  constructor(apiKey, options = {}) {
+    this.apiKey = apiKey;
+    this.options = options;
+    if (!apiKey?.startsWith("stx_")) {
+      throw new Error("SuperSend TX API key must start with stx_");
+    }
+    this.emails = new EmailsResource(this);
+    this.webhooks = new WebhooksResource(this);
+  }
+  get baseUrl() {
+    return (this.options.baseUrl || DEFAULT_API_BASE_URL).replace(/\/$/, "");
+  }
+  get fetchImpl() {
+    return this.options.fetch || fetch;
+  }
+  async request(path, init) {
+    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+      ...init,
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+        "Content-Type": "application/json",
+        ...init.headers || {}
+      }
+    });
+    const body = await response.json().catch(() => ({}));
+    if (!response.ok) {
+      throw SuperSendTXError.fromResponse(response.status, body);
+    }
+    return body;
+  }
+};
+export {
+  DEFAULT_API_BASE_URL,
+  SuperSendTX,
+  SuperSendTXError
+};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "supersendtx",
+  "version": "0.1.0",
+  "description": "SuperSend TX transactional email API client",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Super-Send/superTX-app.git",
+    "directory": "packages/supersendtx"
+  },
+  "homepage": "https://supersendtx.com",
+  "bugs": {
+    "url": "https://github.com/Super-Send/superTX-app/issues"
+  },
+  "keywords": [
+    "email",
+    "transactional",
+    "supersend",
+    "supersendtx",
+    "postal"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}