@messagebird/sdk 0.1.1 → 0.2.0

package/dist/index.js

@@ -1237,6 +1237,22 @@ var createEmailMessage = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var createEmailMessageBatch = (options) => (options.client ?? client).post({
+  security: [
+    { scheme: "bearer", type: "http" },
+    {
+      in: "cookie",
+      name: "bird_session",
+      type: "apiKey"
+    }
+  ],
+  url: "/v1/email/batches",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
 var getEmailMessage = (options) => (options.client ?? client).get({
   security: [
     { scheme: "bearer", type: "http" },
@@ -1339,7 +1355,7 @@ var EmailResource = class extends Resource {
    *
    * try {
    *   await bird.email.send({
-   *     from: "onboarding@messagebird.dev",
+   *     from: { email: "onboarding@messagebird.dev", name: "Bird" },
    *     to: ["delivered@messagebird.dev"],
    *     subject: "Hello from Bird",
    *     html: "<p>My first Bird email.</p>",
@@ -1356,7 +1372,7 @@ var EmailResource = class extends Resource {
    * // bird:snippet:start email.safe
    * const { data, error } = await bird.email
    *   .send({
-   *     from: "onboarding@messagebird.dev",
+   *     from: { email: "onboarding@messagebird.dev", name: "Bird" },
    *     to: ["delivered@messagebird.dev"],
    *     subject: "Hello from Bird",
    *     html: "<p>My first Bird email.</p>",
@@ -1374,6 +1390,44 @@ var EmailResource = class extends Resource {
       ({ signal, headers }) => createEmailMessage({ client: this.client, body, headers, signal })
     );
   }
+  /**
+   * Send a batch of up to 100 independent email messages in one request. The
+   * batch is validated as a unit — if any item fails validation (unverified
+   * sender, all recipients suppressed, field-level errors) the whole batch is
+   * rejected with a `BirdValidationError` and nothing is queued. Resolves with
+   * one accepted item per submitted message, in submission order, once the batch
+   * is accepted (the API's 202). Channel defaults are applied per item.
+   *
+   * @example Send a batch of messages
+   * // bird:snippet:start email.sendBatch
+   * const batch = await bird.email.sendBatch([
+   *   {
+   *     from: { email: "onboarding@messagebird.dev", name: "Bird" },
+   *     to: ["alice@example.com"],
+   *     subject: "Your receipt",
+   *     html: "<p>Thanks, Alice.</p>",
+   *   },
+   *   {
+   *     from: { email: "onboarding@messagebird.dev", name: "Bird" },
+   *     to: ["bob@example.com"],
+   *     subject: "Your receipt",
+   *     html: "<p>Thanks, Bob.</p>",
+   *   },
+   * ]);
+   * for (const item of batch.data) console.log(item.id, item.status);
+   * // bird:snippet:end email.sendBatch
+   */
+  sendBatch(params, options) {
+    const body = params.map((item) => ({
+      ...this.#defaults,
+      ...item
+    }));
+    return this.call(
+      "POST",
+      options,
+      ({ signal, headers }) => createEmailMessageBatch({ client: this.client, body, headers, signal })
+    );
+  }
   /**
    * Fetch a message with aggregate delivery status.
    *
@@ -1389,7 +1443,12 @@ var EmailResource = class extends Resource {
     return this.call(
       "GET",
       options,
-      ({ signal, headers }) => getEmailMessage({ client: this.client, path: { message_id: messageId }, headers, signal })
+      ({ signal, headers }) => getEmailMessage({
+        client: this.client,
+        path: { message_id: messageId },
+        headers,
+        signal
+      })
     );
   }
   /**
@@ -1437,6 +1496,13 @@ var WebhooksResource = class {
    * types are returned as-is (handle them in a `default` case) so a newer server
    * event can't break an older SDK.
    *
+   * @example One call verifies the signature and returns the typed event
+   * // bird:snippet:start webhook.unwrap
+   * // Pass the RAW request body; set the secret via new BirdClient({ webhooks: { secret } }).
+   * const event = bird.webhooks.unwrap(rawBody, headers);
+   * console.log(event.type); // discriminated union — narrow on event.type
+   * // bird:snippet:end webhook.unwrap
+   *
    * @example Verify and dispatch — pass the raw request body, never the parsed JSON
    * // new BirdClient({ apiKey, webhooks: { secret } })
    * try {
@@ -1527,7 +1593,7 @@ var BirdClient = class {
     this.#headers = {
       ...opts.defaultHeaders,
       Authorization: `Bearer ${opts.apiKey}`,
-      "User-Agent": `bird-sdk-js/${"0.1.1"}`
+      "User-Agent": `bird-sdk-js/${"0.2.0"}`
     };
     this.#client = createClient(
       createConfig({
@@ -1603,6 +1669,33 @@ var BirdClient = class {
   }
 };
 
-export { BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, BirdWebhookVerificationError, baseUrlForRegion, regionFromApiKey };
+// src/event-types.gen.ts
+var WebhookEventType = {
+  DomainFailed: "domain.failed",
+  DomainVerified: "domain.verified",
+  EmailAccepted: "email.accepted",
+  EmailBounced: "email.bounced",
+  EmailClicked: "email.clicked",
+  EmailComplained: "email.complained",
+  EmailDeferred: "email.deferred",
+  EmailDelivered: "email.delivered",
+  EmailListUnsubscribed: "email.list_unsubscribed",
+  EmailOpened: "email.opened",
+  EmailOutOfBandBounce: "email.out_of_band_bounce",
+  EmailProcessed: "email.processed",
+  EmailReceived: "email.received",
+  EmailRejected: "email.rejected",
+  EmailSuppressionCreated: "email_suppression.created",
+  EmailUnsubscribed: "email.unsubscribed",
+  SmsAccepted: "sms.accepted",
+  SmsDelivered: "sms.delivered",
+  SmsExpired: "sms.expired",
+  SmsFailed: "sms.failed",
+  SmsRejected: "sms.rejected",
+  SmsSent: "sms.sent",
+  SmsUndelivered: "sms.undelivered"
+};
+
+export { BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, BirdWebhookVerificationError, WebhookEventType, baseUrlForRegion, regionFromApiKey };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map