npm - zupost - Versions diffs - 0.0.0 → 0.1.1 - Mend

zupost 0.0.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,9 @@
+MIT License
+Copyright (c) 2026 Zupost
+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 ADDED Viewed

@@ -0,0 +1,119 @@
+<img src="./.github/banner.png">
+<br />
+<div align="center"><strong>Node SDK</strong></div>
+<div align="center">Use your favorite mail provider Zupost, seamless with our node SDK. </div>
+<br />
+## Introduction
+Zupost is a mail provider that allows you to send emails easily and efficiently. This SDK allows you to integrate Zupost easily into your Node.js applications.
+## Installation
+```bash
+npm install zupost
+```
+## Usage Examples
+### Initialize the Client
+```typescript
+import { Zupost } from 'zupost';
+const zupost = new Zupost('your-api-key');
+```
+### Send an Email
+```typescript
+// Send with HTML content
+const { emailId } = await zupost.emails.send({
+	from: 'sender@example.com',
+	to: 'recipient@example.com',
+	subject: 'Hello World',
+	html: '<h1>Hello!</h1>',
+});
+// Send to multiple recipients
+await zupost.emails.send({
+	from: 'sender@example.com',
+	to: ['user1@example.com', 'user2@example.com'],
+	subject: 'Team Update',
+	markdown: '# Hello Team\n\nThis is a **markdown** email.',
+});
+// Send with a template
+await zupost.emails.send({
+	from: 'sender@example.com',
+	to: 'recipient@example.com',
+	subject: 'Welcome!',
+	templateId: 'welcome-template',
+	variables: { name: 'John' },
+});
+```
+### Send with React Email
+Zupost supports [React Email](https://react.email) components out of the box.
+```bash
+npm install @react-email/components
+```
+```tsx
+import { Zupost } from 'zupost';
+import { Html, Head, Body, Container, Text } from '@react-email/components';
+const WelcomeEmail = ({ name }: { name: string }) => (
+	<Html>
+		<Head />
+		<Body>
+			<Container>
+				<Text>Hello {name}!</Text>
+				<Text>Welcome to our platform.</Text>
+			</Container>
+		</Body>
+	</Html>
+);
+const zupost = new Zupost('your-api-key');
+await zupost.emails.send({
+	from: 'sender@example.com',
+	to: 'recipient@example.com',
+	subject: 'Welcome!',
+	react: <WelcomeEmail name="John" />,
+});
+```
+### Send a Campaign
+```typescript
+const { success, message } = await zupost.campaigns.send({
+	campaignId: 'campaign_123',
+});
+if (success) {
+	console.log('Campaign sent:', message);
+}
+```
+### Configuration Options
+```typescript
+const zupost = new Zupost('your-api-key', {
+	baseUrl: 'https://custom-api.zupost.com', // Optional: custom API URL
+});
+```
+## Contributing
+We welcome contributions! Please open an issue or submit a pull request.
+## License
+This SDK is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/index.d.mts CHANGED Viewed

@@ -1,57 +1,230 @@
-interface CreateEmailContent {
+import { Options } from '@react-email/render';
+import { ReactNode } from 'react';
+/**
+ * Options for sending an email.
+ */
+interface SendEmailOptions {
     /**
-     * HTML content of the email body.
+     * Sender email address.
+     * @example "sender@example.com"
      */
-    html: string;
+    from: string;
     /**
-     * Plain text content of the email body.
+     * Recipient email address(es).
+     * @example "recipient@example.com" or ["a@example.com", "b@example.com"]
      */
-    text: string;
-}
-interface CreateEmailOptions {
+    to: string | string[];
     /**
-     * Email address of the recipient. Use an array for multiple recipients (up to 50).
+     * Email subject.
+     * @example "Hello World"
      */
-    to: string | string[];
+    subject?: string;
     /**
-     * Email address of the sender. To add a display name, use: "Name <email@domain.com>".
+     * Reply-to email address(es).
      */
-    from: string;
+    replyTo?: string | string[];
     /**
-     * BCC recipient(s). Use a string or an array for multiple addresses.
+     * CC recipient(s).
+     */
+    cc?: string | string[];
+    /**
+     * BCC recipient(s).
      */
     bcc?: string | string[];
     /**
-     * CC recipient(s). Use a string or an array for multiple addresses.
+     * ID of the email template to use.
      */
-    cc?: string | string[];
+    templateId?: string;
     /**
-     * Additional custom headers for the email.
+     * Variables for template interpolation.
      */
-    headers?: Record<string, string>;
+    variables?: Record<string, string>;
     /**
-     * Reply-to address(es). Use a string or an array for multiple addresses.
+     * Markdown content for the email.
      */
-    replyTo?: string | string[];
+    markdown?: string;
+    /**
+     * HTML content for the email.
+     */
+    html?: string;
+    /**
+     * React component for the email.
+     */
+    react?: ReactNode;
     /**
-     * Subject line of the email.
+     * Options for the React email renderer.
      */
-    subject: string;
+    reactOptions?: Options;
     /**
-     * Schedule the email for future delivery (ISO 8601 format, e.g., 2024-08-05T11:52:01.858Z).
+     * Plain text content for the email.
      */
-    scheduledAt?: string;
+    text?: string;
+    /**
+     * Attachments for the email. Each attachment must be an object with the following properties:
+     *
+     * @property filename - The name of the file as it will appear in the email (e.g., "document.pdf").
+     * @property content - The file content as a Base64-encoded string (e.g., "JVBERi0xLjQKJ...").
+     *
+     * @example
+     * attachments: [
+     *   {
+     *     filename: "example.pdf",
+     *     content: "JVBERi0xLjQKJ..."
+     *   },
+     *   {
+     *     filename: "image.png",
+     *     content: "iVBORw0KGgoAAAANSUhEUg..."
+     *   }
+     * ]
+     */
+    attachments?: Array<{
+        /** The name of the file as it will appear in the email (e.g., "document.pdf"). */
+        filename: string;
+        /** The file content as a Base64-encoded string (e.g., "JVBERi0xLjQKJ..."). */
+        content: string;
+    }>;
+}
+/**
+ * Response from sending an email.
+ */
+interface SendEmailResponse {
+    /**
+     * Unique identifier of the sent email.
+     */
+    id: string;
+}
+/**
+ * Emails API for sending transactional emails.
+ */
+declare class Emails {
+    private readonly zupost;
+    constructor(zupost: Zupost);
+    /**
+     * Send an email using template, markdown or HTML content.
+     *
+     * @param options - Email options including recipient, sender, and content.
+     * @returns A promise that resolves to the email response containing emailId.
+     *
+     * @example
+     * ```typescript
+     * const zupost = new Zupost('your-api-key');
+     *
+     * // Send with HTML content
+     * const { emailId } = await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: 'recipient@example.com',
+     *   subject: 'Hello World',
+     *   html: '<h1>Hello!</h1>',
+     * });
+     *
+     * // Send with a template
+     * await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: ['user1@example.com', 'user2@example.com'],
+     *   subject: 'Welcome!',
+     *   templateId: 'welcome-template',
+     *   variables: { name: 'John' },
+     * });
+     *
+     * // Send with markdown
+     * await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: 'recipient@example.com',
+     *   subject: 'Newsletter',
+     *   markdown: '# Hello\n\nThis is **markdown** content.',
+     * });
+     * ```
+     */
+    send(options: SendEmailOptions): Promise<SendEmailResponse>;
 }
+/**
+ * Options for sending a campaign.
+ */
+interface SendCampaignOptions {
+    /**
+     * ID of the campaign to send.
+     * @example "campaign_123"
+     */
+    campaignId: string;
+}
+/**
+ * Response from sending a campaign.
+ */
+interface SendCampaignResponse {
+    /**
+     * Whether the campaign was successfully initiated.
+     */
+    success: boolean;
+    /**
+     * A message regarding the campaign status.
+     */
+    message: string;
+}
+/**
+ * Campaigns API for sending email campaigns to audiences.
+ */
+declare class Campaigns {
+    private readonly zupost;
+    constructor(zupost: Zupost);
+    /**
+     * Send a campaign to selected audiences.
+     *
+     * @param options - Campaign options including the campaign ID.
+     * @returns A promise that resolves to the campaign response.
+     *
+     * @example
+     * ```typescript
+     * const zupost = new Zupost('your-api-key');
+     *
+     * const { success, message } = await zupost.campaigns.send({
+     *   campaignId: 'campaign_123',
+     * });
+     *
+     * if (success) {
+     *   console.log('Campaign sent:', message);
+     * }
+     * ```
+     */
+    send(options: SendCampaignOptions): Promise<SendCampaignResponse>;
+}
+interface ZupostOptions {
+    /**
+     * Custom API URL. Defaults to 'https://api.zupost.com'.
+     */
+    baseUrl?: string;
+}
 declare class Zupost {
-    readonly apiKey: string;
-    readonly apiUrl?: string | undefined;
     private readonly headers;
     private readonly baseUrl;
-    constructor(apiKey: string, apiUrl?: string | undefined);
-    request(path: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE', body?: BodyInit): Promise<unknown>;
-    get(path: string): Promise<unknown>;
-    post(path: string, body: BodyInit): Promise<unknown>;
+    /**
+     * Emails API for sending transactional emails.
+     */
+    readonly emails: Emails;
+    /**
+     * Campaigns API for sending email campaigns to audiences.
+     */
+    readonly campaigns: Campaigns;
+    constructor(apiKey: string, options?: ZupostOptions);
+    /**
+     * @internal
+     * Makes a request to the Zupost API.
+     */
+    request<T = unknown>(path: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE', body?: unknown): Promise<T>;
+    /**
+     * @internal
+     * Makes a GET request to the Zupost API.
+     */
+    get<T = unknown>(path: string): Promise<T>;
+    /**
+     * @internal
+     * Makes a POST request to the Zupost API.
+     */
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
 }
-export { type CreateEmailContent, type CreateEmailOptions, Zupost };
+export { type SendCampaignOptions, type SendCampaignResponse, type SendEmailOptions, type SendEmailResponse, Zupost, type ZupostOptions };

package/dist/index.d.ts CHANGED Viewed

@@ -1,57 +1,230 @@
-interface CreateEmailContent {
+import { Options } from '@react-email/render';
+import { ReactNode } from 'react';
+/**
+ * Options for sending an email.
+ */
+interface SendEmailOptions {
     /**
-     * HTML content of the email body.
+     * Sender email address.
+     * @example "sender@example.com"
      */
-    html: string;
+    from: string;
     /**
-     * Plain text content of the email body.
+     * Recipient email address(es).
+     * @example "recipient@example.com" or ["a@example.com", "b@example.com"]
      */
-    text: string;
-}
-interface CreateEmailOptions {
+    to: string | string[];
     /**
-     * Email address of the recipient. Use an array for multiple recipients (up to 50).
+     * Email subject.
+     * @example "Hello World"
      */
-    to: string | string[];
+    subject?: string;
     /**
-     * Email address of the sender. To add a display name, use: "Name <email@domain.com>".
+     * Reply-to email address(es).
      */
-    from: string;
+    replyTo?: string | string[];
     /**
-     * BCC recipient(s). Use a string or an array for multiple addresses.
+     * CC recipient(s).
+     */
+    cc?: string | string[];
+    /**
+     * BCC recipient(s).
      */
     bcc?: string | string[];
     /**
-     * CC recipient(s). Use a string or an array for multiple addresses.
+     * ID of the email template to use.
      */
-    cc?: string | string[];
+    templateId?: string;
     /**
-     * Additional custom headers for the email.
+     * Variables for template interpolation.
      */
-    headers?: Record<string, string>;
+    variables?: Record<string, string>;
     /**
-     * Reply-to address(es). Use a string or an array for multiple addresses.
+     * Markdown content for the email.
      */
-    replyTo?: string | string[];
+    markdown?: string;
+    /**
+     * HTML content for the email.
+     */
+    html?: string;
+    /**
+     * React component for the email.
+     */
+    react?: ReactNode;
     /**
-     * Subject line of the email.
+     * Options for the React email renderer.
      */
-    subject: string;
+    reactOptions?: Options;
     /**
-     * Schedule the email for future delivery (ISO 8601 format, e.g., 2024-08-05T11:52:01.858Z).
+     * Plain text content for the email.
      */
-    scheduledAt?: string;
+    text?: string;
+    /**
+     * Attachments for the email. Each attachment must be an object with the following properties:
+     *
+     * @property filename - The name of the file as it will appear in the email (e.g., "document.pdf").
+     * @property content - The file content as a Base64-encoded string (e.g., "JVBERi0xLjQKJ...").
+     *
+     * @example
+     * attachments: [
+     *   {
+     *     filename: "example.pdf",
+     *     content: "JVBERi0xLjQKJ..."
+     *   },
+     *   {
+     *     filename: "image.png",
+     *     content: "iVBORw0KGgoAAAANSUhEUg..."
+     *   }
+     * ]
+     */
+    attachments?: Array<{
+        /** The name of the file as it will appear in the email (e.g., "document.pdf"). */
+        filename: string;
+        /** The file content as a Base64-encoded string (e.g., "JVBERi0xLjQKJ..."). */
+        content: string;
+    }>;
+}
+/**
+ * Response from sending an email.
+ */
+interface SendEmailResponse {
+    /**
+     * Unique identifier of the sent email.
+     */
+    id: string;
+}
+/**
+ * Emails API for sending transactional emails.
+ */
+declare class Emails {
+    private readonly zupost;
+    constructor(zupost: Zupost);
+    /**
+     * Send an email using template, markdown or HTML content.
+     *
+     * @param options - Email options including recipient, sender, and content.
+     * @returns A promise that resolves to the email response containing emailId.
+     *
+     * @example
+     * ```typescript
+     * const zupost = new Zupost('your-api-key');
+     *
+     * // Send with HTML content
+     * const { emailId } = await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: 'recipient@example.com',
+     *   subject: 'Hello World',
+     *   html: '<h1>Hello!</h1>',
+     * });
+     *
+     * // Send with a template
+     * await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: ['user1@example.com', 'user2@example.com'],
+     *   subject: 'Welcome!',
+     *   templateId: 'welcome-template',
+     *   variables: { name: 'John' },
+     * });
+     *
+     * // Send with markdown
+     * await zupost.emails.send({
+     *   from: 'sender@example.com',
+     *   to: 'recipient@example.com',
+     *   subject: 'Newsletter',
+     *   markdown: '# Hello\n\nThis is **markdown** content.',
+     * });
+     * ```
+     */
+    send(options: SendEmailOptions): Promise<SendEmailResponse>;
 }
+/**
+ * Options for sending a campaign.
+ */
+interface SendCampaignOptions {
+    /**
+     * ID of the campaign to send.
+     * @example "campaign_123"
+     */
+    campaignId: string;
+}
+/**
+ * Response from sending a campaign.
+ */
+interface SendCampaignResponse {
+    /**
+     * Whether the campaign was successfully initiated.
+     */
+    success: boolean;
+    /**
+     * A message regarding the campaign status.
+     */
+    message: string;
+}
+/**
+ * Campaigns API for sending email campaigns to audiences.
+ */
+declare class Campaigns {
+    private readonly zupost;
+    constructor(zupost: Zupost);
+    /**
+     * Send a campaign to selected audiences.
+     *
+     * @param options - Campaign options including the campaign ID.
+     * @returns A promise that resolves to the campaign response.
+     *
+     * @example
+     * ```typescript
+     * const zupost = new Zupost('your-api-key');
+     *
+     * const { success, message } = await zupost.campaigns.send({
+     *   campaignId: 'campaign_123',
+     * });
+     *
+     * if (success) {
+     *   console.log('Campaign sent:', message);
+     * }
+     * ```
+     */
+    send(options: SendCampaignOptions): Promise<SendCampaignResponse>;
+}
+interface ZupostOptions {
+    /**
+     * Custom API URL. Defaults to 'https://api.zupost.com'.
+     */
+    baseUrl?: string;
+}
 declare class Zupost {
-    readonly apiKey: string;
-    readonly apiUrl?: string | undefined;
     private readonly headers;
     private readonly baseUrl;
-    constructor(apiKey: string, apiUrl?: string | undefined);
-    request(path: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE', body?: BodyInit): Promise<unknown>;
-    get(path: string): Promise<unknown>;
-    post(path: string, body: BodyInit): Promise<unknown>;
+    /**
+     * Emails API for sending transactional emails.
+     */
+    readonly emails: Emails;
+    /**
+     * Campaigns API for sending email campaigns to audiences.
+     */
+    readonly campaigns: Campaigns;
+    constructor(apiKey: string, options?: ZupostOptions);
+    /**
+     * @internal
+     * Makes a request to the Zupost API.
+     */
+    request<T = unknown>(path: string, method: 'GET' | 'POST' | 'PUT' | 'DELETE', body?: unknown): Promise<T>;
+    /**
+     * @internal
+     * Makes a GET request to the Zupost API.
+     */
+    get<T = unknown>(path: string): Promise<T>;
+    /**
+     * @internal
+     * Makes a POST request to the Zupost API.
+     */
+    post<T = unknown>(path: string, body: unknown): Promise<T>;
 }
-export { type CreateEmailContent, type CreateEmailOptions, Zupost };
+export { type SendCampaignOptions, type SendCampaignResponse, type SendEmailOptions, type SendEmailResponse, Zupost, type ZupostOptions };