@messagebird/n8n-nodes-bird 0.14.0 → 0.16.0

package/dist/nodes/Bird/generated/events.gen.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.birdEvents = void 0;
 // Code generated by surface-gen; DO NOT EDIT.
 exports.birdEvents = [
-    { name: "amb.accepted", value: "amb.accepted", description: "Bird charged and accepted an outbound message for processing. This does not mean Apple received the message." },
+    { name: "amb.accepted", value: "amb.accepted", description: "An outbound message was accepted for processing after confirming billing coverage. This does not confirm receipt by Apple." },
     { name: "amb.conversation_closed", value: "amb.conversation_closed", description: "A customer conversation closed. Closing a conversation is not a message." },
     { name: "amb.conversation_reopened", value: "amb.conversation_reopened", description: "An existing customer conversation reopened after it had closed" },
     { name: "amb.conversation_started", value: "amb.conversation_started", description: "A customer conversation opened for the first time" },

package/dist/nodes/Bird/generated/properties.gen.js

@@ -26,7 +26,7 @@ exports.birdProperties = [
             { name: "SMS Template", value: "sms_templates", description: "Browse the SMS templates available to the workspace" },
             { name: "Suppression", value: "suppression", description: "Manage the email suppression list" },
             { name: "Verify", value: "verify", description: "Send one-time passcodes and check them" },
-            { name: "Voice", value: "voice", description: "Place calls, read call legs and statistics, and configure Voice" },
+            { name: "Voice", value: "voice", description: "Place and read calls, read legs and statistics, and configure Voice" },
             { name: "Webhook", value: "webhooks", description: "Manage outbound webhook endpoints" },
             { name: "WhatsApp", value: "whatsapp", description: "Send WhatsApp messages, connect its senders, and read templates and stats" },
             { name: "Workspace", value: "workspace", description: "Inspect the current workspace and its settings" },
@@ -2591,33 +2591,40 @@ exports.birdProperties = [
         default: {},
         displayOptions: { show: { resource: ["email"], operation: ["stats_by_broadcast"] } },
         options: [
+            {
+                displayName: "Category",
+                name: "category",
+                type: "string",
+                default: "",
+                description: "Not supported on breakdown endpoints. Supplying it returns a `422`. To compare categories, use `GET /v1/email/stats/categories`. The summary, daily, and hourly statistics accept `category` as a filter.",
+            },
             {
                 displayName: "From",
                 name: "from",
                 type: "string",
                 default: "",
-                description: "Start date (inclusive) in `YYYY-MM-DD`, UTC. Defaults to 30 days before `to` when omitted.",
+                description: "Start date (inclusive) in `YYYY-MM-DD`, interpreted as a calendar day in `timezone` (UTC when omitted). Defaults to 30 days before `to` when omitted.",
             },
             {
-                displayName: "To",
-                name: "to",
-                type: "string",
+                displayName: "Max Results",
+                name: "max_results",
+                type: "number",
                 default: "",
-                description: "End date (inclusive) in `YYYY-MM-DD`, UTC. Defaults to today (UTC) when omitted. Window may not exceed 365 days.",
+                description: "Maximum number of broadcast rows to return, ranked by the `sort` field descending",
             },
             {
-                displayName: "Category",
-                name: "category",
+                displayName: "Timezone",
+                name: "timezone",
                 type: "string",
                 default: "",
-                description: "Not supported on breakdown endpoints. Supplying it returns a `422`. To compare categories, use `GET /v1/email/stats/categories`. The summary, daily, and hourly statistics accept `category` as a filter.",
+                description: "IANA timezone identifier used to group statistics, for example `Asia/Kathmandu`. The default is UTC. Day and hour boundaries, including the default window when `from` and `to` are omitted, follow this timezone. When this parameter is set, pass `from` and `to` as calendar days or `Z` instants instead of timestamps with explicit UTC offsets.",
             },
             {
-                displayName: "Max Results",
-                name: "max_results",
-                type: "number",
+                displayName: "To",
+                name: "to",
+                type: "string",
                 default: "",
-                description: "Maximum number of broadcast rows to return, ranked by the `sort` field descending",
+                description: "End date (inclusive) in `YYYY-MM-DD`, interpreted as a calendar day in `timezone` (UTC when omitted). Defaults to today in that timezone when omitted. Window may not exceed 365 days.",
             },
         ],
     },
@@ -6822,6 +6829,53 @@ exports.birdProperties = [
             },
         ],
     },
+    {
+        displayName: "Webhook",
+        name: "webhook_id",
+        type: "resourceLocator",
+        required: true,
+        default: { mode: "list", value: "" },
+        displayOptions: { show: { resource: ["webhooks"], operation: ["replay"] } },
+        modes: [
+            {
+                displayName: "From List",
+                name: "list",
+                type: "list",
+                placeholder: "Select a Webhook...",
+                typeOptions: { searchListMethod: "webhooksList", searchable: true },
+            },
+            {
+                displayName: "By ID",
+                name: "id",
+                type: "string",
+            },
+        ],
+        description: "ID of the webhook endpoint (`whk_` prefix), as returned when it was created",
+    },
+    {
+        displayName: "Additional Fields",
+        name: "additionalFields",
+        type: "collection",
+        placeholder: "Add Field",
+        default: {},
+        displayOptions: { show: { resource: ["webhooks"], operation: ["replay"] } },
+        options: [
+            {
+                displayName: "Since",
+                name: "since",
+                type: "dateTime",
+                default: "",
+                description: "Replay events whose delivery attempt failed at or after this timestamp. The bound is inclusive and applies to attempt time, not to when the event occurred, so a retry that trailed its event by a day falls in the window by the hour it was attempted. Defaults to 24 hours before the request when omitted. Attempts are retained for three days, so that is the oldest history a replay reaches: an earlier `since` widens the window without recovering anything older.",
+            },
+            {
+                displayName: "Until",
+                name: "until",
+                type: "dateTime",
+                default: "",
+                description: "Replay events whose delivery attempt failed at or before this timestamp, on the same attempt-time bound as `since`. Omitted, it resolves to the time of the request.",
+            },
+        ],
+    },
     {
         displayName: "Webhook",
         name: "webhook_id",
@@ -7540,7 +7594,7 @@ exports.birdProperties = [
                         typeOptions: { multipleValues: true },
                         placeholder: "Add Pair",
                         default: {},
-                        description: "Custom property values for this contact. Each key must be an active contact property. Each value must match the property's declared type: string, number, boolean, or RFC 3339 datetime. Strings can contain up to `500` characters, and a `null` value is ignored. Unregistered or archived keys return a validation error. The serialized data is limited to 2 KB.",
+                        description: "Custom contact property values. Keys must be registered and active; values must match their declared type. Strings can contain up to 500 characters and the serialized map is limited to 2 KB. Invalid values fail this contact. Null values remove keys when updating and are ignored when creating.",
                         options: [
                             {
                                 displayName: "Pair",
@@ -7568,35 +7622,35 @@ exports.birdProperties = [
                         type: "string",
                         placeholder: "name@email.com",
                         default: "",
-                        description: "The contact's email address. Trimmed and lowercased before it is stored and checked for uniqueness. Unique within the workspace. Supply an email address, a phone number, or both.",
+                        description: "Email address, up to 254 characters. Trimmed and lowercased before matching. Invalid addresses fail this contact.",
                     },
                     {
                         displayName: "External ID",
                         name: "external_id",
                         type: "string",
                         default: "",
-                        description: "Your own identifier for this contact, such as a user ID in your system. Unique within the workspace when set.",
+                        description: "Your identifier for the contact, up to 254 characters. Unique within the workspace when set.",
                     },
                     {
                         displayName: "First Name",
                         name: "first_name",
                         type: "string",
                         default: "",
-                        description: "The contact's first name",
+                        description: "First name, up to 100 characters",
                     },
                     {
                         displayName: "Last Name",
                         name: "last_name",
                         type: "string",
                         default: "",
-                        description: "The contact's last name",
+                        description: "Last name, up to 100 characters",
                     },
                     {
                         displayName: "Phone Number",
                         name: "phone_number",
                         type: "string",
                         default: "",
-                        description: "The contact's phone number in E.164 format, including the leading `+` and country code. Spaces and punctuation are accepted and stripped; the number is stored in its canonical form, which may differ from what you send, and is unique within the workspace. An empty string is treated as if the field were omitted. Supply an email address, a phone number, or both.",
+                        description: "Phone number with a country code, up to 32 characters. Spaces and punctuation are accepted. An empty string is treated as omitted.",
                     },
                 ],
             },
@@ -10079,53 +10133,6 @@ exports.birdProperties = [
         ],
         description: "ID of the Realtime app key (`rak_` prefix), as returned when the key was created",
     },
-    {
-        displayName: "Webhook",
-        name: "webhook_id",
-        type: "resourceLocator",
-        required: true,
-        default: { mode: "list", value: "" },
-        displayOptions: { show: { resource: ["webhooks"], operation: ["replay"] } },
-        modes: [
-            {
-                displayName: "From List",
-                name: "list",
-                type: "list",
-                placeholder: "Select a Webhook...",
-                typeOptions: { searchListMethod: "webhooksList", searchable: true },
-            },
-            {
-                displayName: "By ID",
-                name: "id",
-                type: "string",
-            },
-        ],
-        description: "ID of the webhook endpoint (`whk_` prefix), as returned when it was created",
-    },
-    {
-        displayName: "Additional Fields",
-        name: "additionalFields",
-        type: "collection",
-        placeholder: "Add Field",
-        default: {},
-        displayOptions: { show: { resource: ["webhooks"], operation: ["replay"] } },
-        options: [
-            {
-                displayName: "Since",
-                name: "since",
-                type: "dateTime",
-                default: "",
-                description: "Replay events whose delivery attempt failed at or after this timestamp. The bound is inclusive and applies to attempt time, not to when the event occurred, so a retry that trailed its event by a day falls in the window by the hour it was attempted. Defaults to 24 hours before the request when omitted. Attempts are retained for three days, so that is the oldest history a replay reaches: an earlier `since` widens the window without recovering anything older.",
-            },
-            {
-                displayName: "Until",
-                name: "until",
-                type: "dateTime",
-                default: "",
-                description: "Replay events whose delivery attempt failed at or before this timestamp, on the same attempt-time bound as `since`. Omitted, it resolves to the time of the request.",
-            },
-        ],
-    },
     {
         displayName: "Message",
         name: "message_id",

package/dist/nodes/Bird/generated/routing.gen.js

@@ -22,7 +22,7 @@ exports.birdRoutes = {
     "email:stats_by_client": { method: "GET", path: "/v1/email/stats/clients", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["starting_after", "ending_before", "from", "to", "timezone", "category", "group_by", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["emails"] },
     "email:stats_by_bounce_code": { method: "GET", path: "/v1/email/stats/bounce-codes", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["starting_after", "ending_before", "from", "to", "timezone", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["emails"] },
     "email:stats_by_complaint_type": { method: "GET", path: "/v1/email/stats/complaint-types", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["starting_after", "ending_before", "from", "to", "timezone", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["emails"] },
-    "email:stats_by_broadcast": { method: "GET", path: "/v1/email/stats/broadcasts", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["starting_after", "ending_before", "from", "to", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["email_marketing"] },
+    "email:stats_by_broadcast": { method: "GET", path: "/v1/email/stats/broadcasts", pathParams: [], topLevel: [], collections: ["additionalFields", "sort"], query: ["starting_after", "ending_before", "from", "to", "timezone", "category", "sort", "limit"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["email_marketing"] },
     "email:templates_list": { method: "GET", path: "/v1/email/templates", pathParams: [], topLevel: [], collections: ["additionalFields"], query: ["scope", "category", "source", "theme", "q", "limit", "starting_after", "ending_before"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["email_management"] },
     "sms:send": { method: "POST", path: "/v1/sms/messages", pathParams: [], topLevel: ["to"], collections: ["additionalFields"], query: [], body: ["to", "from", "text", "category", "tags", "metadata", "options", "template"], jsonFields: [], structured: { "tags": "list", "metadata": "map", "options": "struct", "template": "struct" }, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["sms"] },
     "sms:send_batch": { method: "POST", path: "/v1/sms/batches", pathParams: [], topLevel: ["messages"], collections: ["additionalFields"], query: [], body: ["messages"], jsonFields: ["messages"], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: true, scopes: ["sms"] },
@@ -101,6 +101,7 @@ exports.birdRoutes = {
     "webhooks:test": { method: "POST", path: "/v1/webhooks/{webhook_id}/test", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: [], body: ["event_type"], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "webhooks:delete": { method: "DELETE", path: "/v1/webhooks/{webhook_id}", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "webhooks:attempts": { method: "GET", path: "/v1/webhooks/{webhook_id}/attempts", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: ["limit", "before", "after"], body: [], jsonFields: [], structured: {}, renames: { "max_results": "limit" }, arrayFields: [], dateTimeFields: ["before", "after"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["webhooks"] },
+    "webhooks:replay": { method: "POST", path: "/v1/webhooks/{webhook_id}/replay", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: [], body: ["since", "until"], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: ["since", "until"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "webhooks:rotate_secret": { method: "POST", path: "/v1/webhooks/{webhook_id}/rotate-secret", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "webhooks:update": { method: "PATCH", path: "/v1/webhooks/{webhook_id}", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["updateFields"], query: [], body: ["url", "description", "events", "status"], jsonFields: [], structured: {}, renames: {}, arrayFields: ["events"], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "workspace:get": { method: "GET", path: "/v1/workspace", pathParams: [], topLevel: [], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: false, scopes: ["workspace"] },
@@ -165,7 +166,6 @@ exports.birdRoutes = {
     "realtime:apps_keys_create": { method: "POST", path: "/v1/realtime/apps/{realtime_app_id}/keys", pathParams: ["realtime_app_id"], topLevel: ["realtime_app_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["realtime"] },
     "realtime:apps_keys_revoke": { method: "POST", path: "/v1/realtime/apps/{realtime_app_id}/keys/{realtime_app_key_id}/revoke", pathParams: ["realtime_app_id", "realtime_app_key_id"], topLevel: ["realtime_app_id", "realtime_app_key_id"], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["realtime"] },
     "realtime:regions_list": { method: "GET", path: "/v1/realtime/regions", pathParams: [], topLevel: [], collections: ["additionalFields"], query: [], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: true, idempotencyHeader: false, scopes: ["realtime"] },
-    "webhooks:replay": { method: "POST", path: "/v1/webhooks/{webhook_id}/replay", pathParams: ["webhook_id"], topLevel: ["webhook_id"], collections: ["additionalFields"], query: [], body: ["since", "until"], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: ["since", "until"], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["webhooks"] },
     "email:list_events": { method: "GET", path: "/v1/email/messages/{message_id}/events", pathParams: ["message_id"], topLevel: ["message_id"], collections: ["additionalFields"], query: ["limit", "starting_after", "ending_before", "type"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: true, collection: true, idempotencyHeader: false, scopes: ["emails"] },
     "email:threads_messages_update": { method: "PATCH", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["updateFields"], query: [], body: ["labels", "contact_id"], jsonFields: [], structured: { "labels": "struct" }, renames: {}, arrayFields: ["labels.add", "labels.remove"], dateTimeFields: [], nullableFields: ["contact_id"], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },
     "email:threads_messages_delete": { method: "DELETE", path: "/v1/email/threads/{thread_id}/messages/{message_id}", pathParams: ["thread_id", "message_id"], topLevel: ["thread_id", "message_id"], collections: ["additionalFields"], query: ["permanent"], body: [], jsonFields: [], structured: {}, renames: {}, arrayFields: [], dateTimeFields: [], nullableFields: [], binaryFields: [], rawBodyField: "", paginated: false, collection: false, idempotencyHeader: true, scopes: ["mailbox"] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@messagebird/n8n-nodes-bird",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "The official Bird node for n8n: email, SMS, WhatsApp, and verification, plus a webhook trigger for Bird events.",
   "license": "MIT",
   "author": {