@stack0/sdk 0.5.1 → 0.5.2

package/dist/mail/index.js

@@ -77,14 +77,644 @@ var HttpClient = class {
   }
 };
 
+// src/mail/audiences.ts
+var Audiences = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all audiences
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    const query = params.toString();
+    return this.http.get(`/mail/audiences${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get an audience by ID
+   */
+  async get(id) {
+    return this.http.get(`/mail/audiences/${id}`);
+  }
+  /**
+   * Create a new audience
+   */
+  async create(request) {
+    return this.http.post("/mail/audiences", request);
+  }
+  /**
+   * Update an audience
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/audiences/${id}`, data);
+  }
+  /**
+   * Delete an audience
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/audiences/${id}`);
+  }
+  /**
+   * List contacts in an audience
+   */
+  async listContacts(request) {
+    const { id, ...params } = request;
+    const searchParams = new URLSearchParams();
+    if (params.environment) searchParams.set("environment", params.environment);
+    if (params.limit) searchParams.set("limit", params.limit.toString());
+    if (params.offset) searchParams.set("offset", params.offset.toString());
+    if (params.search) searchParams.set("search", params.search);
+    if (params.status) searchParams.set("status", params.status);
+    const query = searchParams.toString();
+    return this.http.get(`/mail/audiences/${id}/contacts${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Add contacts to an audience
+   */
+  async addContacts(request) {
+    const { id, contactIds } = request;
+    return this.http.post(`/mail/audiences/${id}/contacts`, { contactIds });
+  }
+  /**
+   * Remove contacts from an audience
+   */
+  async removeContacts(request) {
+    const { id, contactIds } = request;
+    return this.http.deleteWithBody(`/mail/audiences/${id}/contacts`, {
+      contactIds
+    });
+  }
+};
+
+// src/mail/campaigns.ts
+var Campaigns = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all campaigns
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    if (request.status) params.set("status", request.status);
+    const query = params.toString();
+    return this.http.get(`/mail/campaigns${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a campaign by ID
+   */
+  async get(id) {
+    return this.http.get(`/mail/campaigns/${id}`);
+  }
+  /**
+   * Create a new campaign
+   */
+  async create(request) {
+    return this.http.post("/mail/campaigns", request);
+  }
+  /**
+   * Update a campaign
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/campaigns/${id}`, data);
+  }
+  /**
+   * Delete a campaign
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/campaigns/${id}`);
+  }
+  /**
+   * Send a campaign
+   */
+  async send(request) {
+    const { id, ...data } = request;
+    return this.http.post(`/mail/campaigns/${id}/send`, data);
+  }
+  /**
+   * Pause a sending campaign
+   */
+  async pause(id) {
+    return this.http.post(`/mail/campaigns/${id}/pause`, {});
+  }
+  /**
+   * Cancel a campaign
+   */
+  async cancel(id) {
+    return this.http.post(`/mail/campaigns/${id}/cancel`, {});
+  }
+  /**
+   * Duplicate a campaign
+   */
+  async duplicate(id) {
+    return this.http.post(`/mail/campaigns/${id}/duplicate`, {});
+  }
+  /**
+   * Get campaign statistics
+   */
+  async getStats(id) {
+    return this.http.get(`/mail/campaigns/${id}/stats`);
+  }
+};
+
+// src/mail/contacts.ts
+var Contacts = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all contacts
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    if (request.status) params.set("status", request.status);
+    const query = params.toString();
+    return this.http.get(`/mail/contacts${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a contact by ID
+   */
+  async get(id) {
+    return this.http.get(`/mail/contacts/${id}`);
+  }
+  /**
+   * Create a new contact
+   */
+  async create(request) {
+    return this.http.post("/mail/contacts", request);
+  }
+  /**
+   * Update a contact
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/contacts/${id}`, data);
+  }
+  /**
+   * Delete a contact
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/contacts/${id}`);
+  }
+  /**
+   * Import contacts in bulk
+   */
+  async import(request) {
+    return this.http.post("/mail/contacts/import", request);
+  }
+};
+
+// src/mail/domains.ts
+var Domains = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all domains for the organization
+   */
+  async list(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    return this.http.get(`/mail/domains?${params.toString()}`);
+  }
+  /**
+   * Add a new domain
+   */
+  async add(request) {
+    return this.http.post("/mail/domains", request);
+  }
+  /**
+   * Get DNS records for a domain
+   */
+  async getDnsRecords(domainId) {
+    return this.http.get(`/mail/domains/${domainId}/dns`);
+  }
+  /**
+   * Verify a domain
+   */
+  async verify(domainId) {
+    return this.http.post(`/mail/domains/${domainId}/verify`, {});
+  }
+  /**
+   * Delete a domain
+   */
+  async delete(domainId) {
+    return this.http.delete(`/mail/domains/${domainId}`);
+  }
+  /**
+   * Set a domain as the default
+   */
+  async setDefault(domainId) {
+    return this.http.post(`/mail/domains/${domainId}/default`, {});
+  }
+};
+
+// src/mail/events.ts
+var Events = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ============================================================================
+  // EVENT DEFINITIONS
+  // ============================================================================
+  /**
+   * List all event definitions
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    const query = params.toString();
+    return this.http.get(`/mail/events${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get an event definition by ID
+   */
+  async get(id) {
+    return this.http.get(`/mail/events/${id}`);
+  }
+  /**
+   * Create a new event definition
+   */
+  async create(request) {
+    return this.http.post("/mail/events", request);
+  }
+  /**
+   * Update an event definition
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/events/${id}`, data);
+  }
+  /**
+   * Delete an event definition
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/events/${id}`);
+  }
+  // ============================================================================
+  // EVENT TRACKING
+  // ============================================================================
+  /**
+   * Track a single event
+   * This can trigger email sequences configured to listen for this event
+   */
+  async track(request) {
+    return this.http.post("/mail/events/track", request);
+  }
+  /**
+   * Track multiple events in a batch (max 100)
+   */
+  async trackBatch(request) {
+    return this.http.post("/mail/events/track/batch", request);
+  }
+  // ============================================================================
+  // EVENT OCCURRENCES
+  // ============================================================================
+  /**
+   * List event occurrences
+   */
+  async listOccurrences(request = {}) {
+    const params = new URLSearchParams();
+    if (request.eventId) params.set("eventId", request.eventId);
+    if (request.contactId) params.set("contactId", request.contactId);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.startDate) {
+      params.set("startDate", request.startDate instanceof Date ? request.startDate.toISOString() : request.startDate);
+    }
+    if (request.endDate) {
+      params.set("endDate", request.endDate instanceof Date ? request.endDate.toISOString() : request.endDate);
+    }
+    const query = params.toString();
+    return this.http.get(`/mail/events/occurrences${query ? `?${query}` : ""}`);
+  }
+  // ============================================================================
+  // ANALYTICS
+  // ============================================================================
+  /**
+   * Get analytics for an event
+   */
+  async getAnalytics(id) {
+    return this.http.get(`/mail/events/analytics/${id}`);
+  }
+};
+
+// src/mail/sequences.ts
+var Sequences = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ============================================================================
+  // SEQUENCE CRUD
+  // ============================================================================
+  /**
+   * List all sequences
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    if (request.status) params.set("status", request.status);
+    if (request.triggerType) params.set("triggerType", request.triggerType);
+    const query = params.toString();
+    return this.http.get(`/mail/sequences${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a sequence by ID with all nodes and connections
+   */
+  async get(id) {
+    return this.http.get(`/mail/sequences/${id}`);
+  }
+  /**
+   * Create a new sequence
+   */
+  async create(request) {
+    return this.http.post("/mail/sequences", request);
+  }
+  /**
+   * Update a sequence
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/sequences/${id}`, data);
+  }
+  /**
+   * Delete a sequence
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/sequences/${id}`);
+  }
+  // ============================================================================
+  // SEQUENCE LIFECYCLE
+  // ============================================================================
+  /**
+   * Publish (activate) a sequence
+   */
+  async publish(id) {
+    return this.http.post(`/mail/sequences/${id}/publish`, {});
+  }
+  /**
+   * Pause an active sequence
+   */
+  async pause(id) {
+    return this.http.post(`/mail/sequences/${id}/pause`, {});
+  }
+  /**
+   * Resume a paused sequence
+   */
+  async resume(id) {
+    return this.http.post(`/mail/sequences/${id}/resume`, {});
+  }
+  /**
+   * Archive a sequence
+   */
+  async archive(id) {
+    return this.http.post(`/mail/sequences/${id}/archive`, {});
+  }
+  /**
+   * Duplicate a sequence
+   */
+  async duplicate(id, name) {
+    return this.http.post(`/mail/sequences/${id}/duplicate`, { name });
+  }
+  // ============================================================================
+  // NODE MANAGEMENT
+  // ============================================================================
+  /**
+   * Create a new node in a sequence
+   */
+  async createNode(request) {
+    const { id, ...data } = request;
+    return this.http.post(`/mail/sequences/${id}/nodes`, data);
+  }
+  /**
+   * Update a node
+   */
+  async updateNode(request) {
+    const { id, nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${id}/nodes/${nodeId}`, data);
+  }
+  /**
+   * Update node position (for visual editor)
+   */
+  async updateNodePosition(request) {
+    const { id, nodeId, positionX, positionY } = request;
+    return this.http.put(`/mail/sequences/${id}/nodes/${nodeId}/position`, { positionX, positionY });
+  }
+  /**
+   * Delete a node
+   */
+  async deleteNode(sequenceId, nodeId) {
+    return this.http.delete(`/mail/sequences/${sequenceId}/nodes/${nodeId}`);
+  }
+  // ============================================================================
+  // NODE CONFIGURATIONS
+  // ============================================================================
+  /**
+   * Set email node content
+   */
+  async setNodeEmail(sequenceId, request) {
+    const { nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${sequenceId}/nodes/${nodeId}/email`, data);
+  }
+  /**
+   * Set timer node configuration
+   */
+  async setNodeTimer(sequenceId, request) {
+    const { nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${sequenceId}/nodes/${nodeId}/timer`, data);
+  }
+  /**
+   * Set filter node configuration
+   */
+  async setNodeFilter(sequenceId, request) {
+    const { nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${sequenceId}/nodes/${nodeId}/filter`, data);
+  }
+  /**
+   * Set branch node configuration
+   */
+  async setNodeBranch(sequenceId, request) {
+    const { nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${sequenceId}/nodes/${nodeId}/branch`, data);
+  }
+  /**
+   * Set experiment node configuration
+   */
+  async setNodeExperiment(sequenceId, request) {
+    const { nodeId, ...data } = request;
+    return this.http.put(`/mail/sequences/${sequenceId}/nodes/${nodeId}/experiment`, data);
+  }
+  // ============================================================================
+  // CONNECTIONS
+  // ============================================================================
+  /**
+   * Create a connection between nodes
+   */
+  async createConnection(request) {
+    const { id, ...data } = request;
+    return this.http.post(`/mail/sequences/${id}/connections`, data);
+  }
+  /**
+   * Delete a connection
+   */
+  async deleteConnection(sequenceId, connectionId) {
+    return this.http.delete(`/mail/sequences/${sequenceId}/connections/${connectionId}`);
+  }
+  // ============================================================================
+  // SEQUENCE ENTRIES (CONTACTS IN SEQUENCE)
+  // ============================================================================
+  /**
+   * List contacts in a sequence
+   */
+  async listEntries(request) {
+    const { id, ...params } = request;
+    const searchParams = new URLSearchParams();
+    if (params.limit) searchParams.set("limit", params.limit.toString());
+    if (params.offset) searchParams.set("offset", params.offset.toString());
+    if (params.status) searchParams.set("status", params.status);
+    const query = searchParams.toString();
+    return this.http.get(`/mail/sequences/${id}/entries${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Add a contact to a sequence
+   */
+  async addContact(request) {
+    const { id, contactId } = request;
+    return this.http.post(`/mail/sequences/${id}/add-contact`, { contactId });
+  }
+  /**
+   * Remove a contact from a sequence
+   */
+  async removeContact(request) {
+    const { id, entryId, reason } = request;
+    return this.http.post(`/mail/sequences/${id}/remove-contact`, {
+      entryId,
+      reason
+    });
+  }
+  // ============================================================================
+  // ANALYTICS
+  // ============================================================================
+  /**
+   * Get sequence analytics
+   */
+  async getAnalytics(id) {
+    return this.http.get(`/mail/sequences/${id}/analytics`);
+  }
+};
+
+// src/mail/templates.ts
+var Templates = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * List all templates
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.isActive !== void 0) params.set("isActive", request.isActive.toString());
+    if (request.search) params.set("search", request.search);
+    const query = params.toString();
+    return this.http.get(`/mail/templates${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get a template by ID
+   */
+  async get(id) {
+    return this.http.get(`/mail/templates/${id}`);
+  }
+  /**
+   * Get a template by slug
+   */
+  async getBySlug(slug) {
+    return this.http.get(`/mail/templates/slug/${slug}`);
+  }
+  /**
+   * Create a new template
+   */
+  async create(request) {
+    return this.http.post("/mail/templates", request);
+  }
+  /**
+   * Update a template
+   */
+  async update(request) {
+    const { id, ...data } = request;
+    return this.http.put(`/mail/templates/${id}`, data);
+  }
+  /**
+   * Delete a template
+   */
+  async delete(id) {
+    return this.http.delete(`/mail/templates/${id}`);
+  }
+  /**
+   * Preview a template with variables
+   */
+  async preview(request) {
+    const { id, variables } = request;
+    return this.http.post(`/mail/templates/${id}/preview`, { variables });
+  }
+};
+
 // src/mail/client.ts
 var Mail = class {
   http;
+  /** Manage sending domains */
+  domains;
+  /** Manage email templates */
+  templates;
+  /** Manage contact audiences/lists */
+  audiences;
+  /** Manage contacts */
+  contacts;
+  /** Manage email campaigns */
+  campaigns;
+  /** Manage automated email sequences */
+  sequences;
+  /** Track and manage custom events */
+  events;
   constructor(config) {
     this.http = new HttpClient(config);
+    this.domains = new Domains(this.http);
+    this.templates = new Templates(this.http);
+    this.audiences = new Audiences(this.http);
+    this.contacts = new Contacts(this.http);
+    this.campaigns = new Campaigns(this.http);
+    this.sequences = new Sequences(this.http);
+    this.events = new Events(this.http);
   }
+  // ============================================================================
+  // TRANSACTIONAL EMAILS
+  // ============================================================================
   /**
-   * Send an email
+   * Send a single email
    *
    * @example
    * ```typescript
@@ -97,11 +727,40 @@ var Mail = class {
    * ```
    */
   async send(request) {
-    const response = await this.http.post("/mail/send", request);
-    if (typeof response.createdAt === "string") {
-      response.createdAt = new Date(response.createdAt);
-    }
-    return response;
+    return this.http.post("/mail/send", request);
+  }
+  /**
+   * Send multiple emails in a batch (up to 100)
+   * Each email can have different content and recipients
+   *
+   * @example
+   * ```typescript
+   * const result = await mail.sendBatch({
+   *   emails: [
+   *     { from: 'noreply@example.com', to: 'user1@example.com', subject: 'Hello', html: '<p>Hi User 1</p>' },
+   *     { from: 'noreply@example.com', to: 'user2@example.com', subject: 'Hello', html: '<p>Hi User 2</p>' },
+   *   ]
+   * });
+   * ```
+   */
+  async sendBatch(request) {
+    return this.http.post("/mail/send/batch", request);
+  }
+  /**
+   * Send a broadcast email (same content to multiple recipients, up to 1000)
+   *
+   * @example
+   * ```typescript
+   * const result = await mail.sendBroadcast({
+   *   from: 'noreply@example.com',
+   *   to: ['user1@example.com', 'user2@example.com', 'user3@example.com'],
+   *   subject: 'Newsletter',
+   *   html: '<p>Our latest updates...</p>',
+   * });
+   * ```
+   */
+  async sendBroadcast(request) {
+    return this.http.post("/mail/send/broadcast", request);
   }
   /**
    * Get email details by ID
@@ -113,17 +772,97 @@ var Mail = class {
    * ```
    */
   async get(id) {
-    const response = await this.http.get(`/mail/${id}`);
-    const dateFields = ["createdAt", "sentAt", "deliveredAt", "openedAt", "clickedAt", "bouncedAt"];
-    for (const field of dateFields) {
-      if (response[field] && typeof response[field] === "string") {
-        response[field] = new Date(response[field]);
-      }
+    return this.http.get(`/mail/${id}`);
+  }
+  /**
+   * List emails with optional filters
+   *
+   * @example
+   * ```typescript
+   * const result = await mail.list({
+   *   status: 'delivered',
+   *   limit: 50,
+   * });
+   * ```
+   */
+  async list(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.status) params.set("status", request.status);
+    if (request.from) params.set("from", request.from);
+    if (request.to) params.set("to", request.to);
+    if (request.subject) params.set("subject", request.subject);
+    if (request.tag) params.set("tag", request.tag);
+    if (request.startDate) {
+      params.set("startDate", request.startDate instanceof Date ? request.startDate.toISOString() : request.startDate);
+    }
+    if (request.endDate) {
+      params.set("endDate", request.endDate instanceof Date ? request.endDate.toISOString() : request.endDate);
     }
-    return response;
+    if (request.sortBy) params.set("sortBy", request.sortBy);
+    if (request.sortOrder) params.set("sortOrder", request.sortOrder);
+    const query = params.toString();
+    return this.http.get(`/mail${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Resend a previously sent email
+   */
+  async resend(id) {
+    return this.http.post(`/mail/${id}/resend`, {});
+  }
+  /**
+   * Cancel a scheduled email
+   */
+  async cancel(id) {
+    return this.http.post(`/mail/${id}/cancel`, {});
+  }
+  // ============================================================================
+  // ANALYTICS
+  // ============================================================================
+  /**
+   * Get overall email analytics
+   */
+  async getAnalytics() {
+    return this.http.get("/mail/analytics");
+  }
+  /**
+   * Get time series analytics (daily breakdown)
+   */
+  async getTimeSeriesAnalytics(request = {}) {
+    const params = new URLSearchParams();
+    if (request.days) params.set("days", request.days.toString());
+    const query = params.toString();
+    return this.http.get(`/mail/analytics/timeseries${query ? `?${query}` : ""}`);
+  }
+  /**
+   * Get hourly analytics
+   */
+  async getHourlyAnalytics() {
+    return this.http.get("/mail/analytics/hourly");
+  }
+  /**
+   * List unique senders with their statistics
+   */
+  async listSenders(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.search) params.set("search", request.search);
+    const query = params.toString();
+    return this.http.get(`/mail/senders${query ? `?${query}` : ""}`);
   }
 };
 
+exports.Audiences = Audiences;
+exports.Campaigns = Campaigns;
+exports.Contacts = Contacts;
+exports.Domains = Domains;
+exports.Events = Events;
 exports.Mail = Mail;
+exports.Sequences = Sequences;
+exports.Templates = Templates;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map