mailtea-sdk 0.1.1 → 0.1.2

package/README.md

@@ -47,7 +47,10 @@ const mailtea = new Mailtea(apiKey, { baseUrl: "http://localhost:8787" });
 | `emails.update(id, { scheduled_at })` | Reschedule a scheduled email |
 | `emails.reschedule(id, scheduledAt)` | Convenience wrapper over `update` |
 | `emails.cancel(id)` | Cancel a scheduled email |
-| `contacts.create / list / get / update / delete` | Manage audience contacts |
+| `contacts.create / upsert / list / get / update / delete` | Manage audience contacts (`upsert` = `create`; the endpoint upserts) |
+| `posts.create(input)` | Create a newsletter post (draft, or `send: true`) → `{ id }` |
+| `posts.send(id, { scheduled_at? })` | Send a draft post to the audience, now or scheduled |
+| `posts.sendTest(id, input)` | Send a `[TEST]` copy of a post → `{ sent_to, failed_to }` |
 | `segments.create / list / get / update / delete` | Manage segments |
 | `tags.create / list / get / update / delete` | Manage tags |
 | `domains.create / list / get / verify / update / delete` | Manage sending domains (add, read DNS records, verify) |

package/dist/index.d.ts

@@ -410,6 +410,11 @@ declare class Contacts {
     constructor(request: RequestFn);
     /** Create (or upsert) a contact in a publication. */
     create(input: CreateContactInput): Promise<Contact>;
+    /**
+     * Create the contact or update it in place — alias of `create`, named for
+     * what `POST /v1/contacts` actually does.
+     */
+    upsert(input: CreateContactInput): Promise<Contact>;
     /** List contacts in a publication. Supports cursor pagination via `after`. */
     list(params: ListContactsParams): Promise<ListResponse<Contact>>;
     /** Retrieve a single contact by id or email. */
@@ -573,6 +578,16 @@ interface CreatePostResult {
     /** The new post's id. */
     id: string;
 }
+/** Input for `posts.send`. */
+interface SendPostInput {
+    /** ISO-8601; schedules the send instead of sending now. */
+    scheduled_at?: string;
+}
+/** Result of `posts.send`. */
+interface SendPostResult {
+    object: "post";
+    id: string;
+}
 /**
  * The `posts` resource (newsletter posts/issues). Access via `mailtea.posts`.
  */
@@ -586,6 +601,12 @@ declare class Posts {
      * schedule) — that requires the `issues:send` scope. Returns `{ id }`.
      */
     create(input: CreatePostInput): Promise<CreatePostResult>;
+    /**
+     * Send a draft post to the publication's audience — immediately, or at
+     * `scheduled_at` (ISO-8601) if given. Requires the `issues:send` scope.
+     * Returns `{ id }`.
+     */
+    send(id: string, input?: SendPostInput): Promise<SendPostResult>;
     /**
      * Send a TEST copy of a post to specific recipients to check it before
      * subscribers see it. Renders the post exactly as a subscriber would receive
@@ -957,4 +978,4 @@ interface VerifyWebhookSignatureInput {
  */
 declare function verifyWebhookSignature(input: VerifyWebhookSignatureInput): boolean;
 
-export { type ApiKeyListItem, type ApiKeyPermission, ApiKeys, type BatchEmailInput, type BatchEmailItemInput, type BatchEmailResponse, type CancelEmailResponse, type Contact, ContactProperties, type ContactProperty, type ContactPropertyType, type ContactStatus, Contacts, type CreateApiKeyInput, type CreateContactInput, type CreateContactPropertyInput, type CreateDomainInput, type CreatePostInput, type CreatePostResult, type CreateSegmentInput, type CreateTagInput, type CreateTrackingDomainInput, type CreateWebhookInput, type CreatedApiKey, type DeletedResponse, type Domain, type DomainPurpose, type DomainRecord, type DomainStatus, Domains, type EmailAnalytics, type EmailAnalyticsParams, type EmailAttachmentMeta, type EmailListItem, type EmailListResponse, type EmailStatus, type EmailTag, Emails, type InboundAttachment, type InboundAttachmentMeta, InboundAttachments, type InboundEmailListItem, InboundEmails, type InboundReplyInput, type InboundReplyResponse, type ListContactPropertiesParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListInboundEmailsParams, type ListResponse, type ListSegmentsParams, type ListTagsParams, type ListWebhooksParams, Mailtea, MailteaError, type MailteaErrorInit, type MailteaOptions, type PostTestSendResult, Posts, type RequestFn, type RetrievedEmail, type RetrievedInboundEmail, type Segment, Segments, type SendEmailInput, type SendEmailResponse, type SendPostTestInput, type SignWebhookInput, type Tag, type TagSubscription, type TagVisibility, Tags, type TemplateRef, type TrackingDomain, TrackingDomains, type UpdateContactInput, type UpdateContactPropertyInput, type UpdateDomainInput, type UpdateEmailInput, type UpdateEmailResponse, type UpdateSegmentInput, type UpdateTagInput, type UpdateWebhookInput, type VerifyWebhookSignatureInput, type Webhook, type WebhookEvent, type WebhookStatus, Webhooks, signWebhook, verifyWebhookSignature };
+export { type ApiKeyListItem, type ApiKeyPermission, ApiKeys, type BatchEmailInput, type BatchEmailItemInput, type BatchEmailResponse, type CancelEmailResponse, type Contact, ContactProperties, type ContactProperty, type ContactPropertyType, type ContactStatus, Contacts, type CreateApiKeyInput, type CreateContactInput, type CreateContactPropertyInput, type CreateDomainInput, type CreatePostInput, type CreatePostResult, type CreateSegmentInput, type CreateTagInput, type CreateTrackingDomainInput, type CreateWebhookInput, type CreatedApiKey, type DeletedResponse, type Domain, type DomainPurpose, type DomainRecord, type DomainStatus, Domains, type EmailAnalytics, type EmailAnalyticsParams, type EmailAttachmentMeta, type EmailListItem, type EmailListResponse, type EmailStatus, type EmailTag, Emails, type InboundAttachment, type InboundAttachmentMeta, InboundAttachments, type InboundEmailListItem, InboundEmails, type InboundReplyInput, type InboundReplyResponse, type ListContactPropertiesParams, type ListContactsParams, type ListDomainsParams, type ListEmailsParams, type ListInboundEmailsParams, type ListResponse, type ListSegmentsParams, type ListTagsParams, type ListWebhooksParams, Mailtea, MailteaError, type MailteaErrorInit, type MailteaOptions, type PostTestSendResult, Posts, type RequestFn, type RetrievedEmail, type RetrievedInboundEmail, type Segment, Segments, type SendEmailInput, type SendEmailResponse, type SendPostInput, type SendPostResult, type SendPostTestInput, type SignWebhookInput, type Tag, type TagSubscription, type TagVisibility, Tags, type TemplateRef, type TrackingDomain, TrackingDomains, type UpdateContactInput, type UpdateContactPropertyInput, type UpdateDomainInput, type UpdateEmailInput, type UpdateEmailResponse, type UpdateSegmentInput, type UpdateTagInput, type UpdateWebhookInput, type VerifyWebhookSignatureInput, type Webhook, type WebhookEvent, type WebhookStatus, Webhooks, signWebhook, verifyWebhookSignature };

package/dist/index.js

@@ -162,6 +162,13 @@ var Contacts = class {
   create(input) {
     return this.request("POST", "/v1/contacts", input);
   }
+  /**
+   * Create the contact or update it in place — alias of `create`, named for
+   * what `POST /v1/contacts` actually does.
+   */
+  upsert(input) {
+    return this.create(input);
+  }
   /** List contacts in a publication. Supports cursor pagination via `after`. */
   list(params) {
     return this.request(
@@ -287,6 +294,18 @@ var Posts = class {
   create(input) {
     return this.request("POST", "/v1/posts", input);
   }
+  /**
+   * Send a draft post to the publication's audience — immediately, or at
+   * `scheduled_at` (ISO-8601) if given. Requires the `issues:send` scope.
+   * Returns `{ id }`.
+   */
+  send(id, input) {
+    return this.request(
+      "POST",
+      `/v1/posts/${encodeURIComponent(id)}/send`,
+      input
+    );
+  }
   /**
    * Send a TEST copy of a post to specific recipients to check it before
    * subscribers see it. Renders the post exactly as a subscriber would receive

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mailtea-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Mailtea Node.js SDK — send, schedule, and manage email, contacts, and segments from your app or AI agent.",
   "license": "MIT",
   "type": "module",