@keystrokehq/sendgrid 0.0.16 → 0.1.2

package/dist/actions/get-single-send-stats-by-id.cjs

@@ -0,0 +1,60 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-single-send-stats-by-id.ts
+const SendgridGetSingleSendStatsByIdInput = zod.z.object({
+	id: zod.z.string().describe("The ID of Single Send for which you want to retrieve stats."),
+	end_date: zod.z.string().describe("Format: YYYY-MM-DD. The end date for the stats search period. If not specified, defaults to the current date.").optional(),
+	group_by: zod.z.array(zod.z.enum(["ab_variation", "ab_phase"])).describe("For A/B Single Sends, allows grouping stats by 'ab_variation' or 'ab_phase' to see performance metrics for each variation or test phase separately.").optional(),
+	timezone: zod.z.string().default("UTC").describe("[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".").optional(),
+	page_size: zod.z.number().int().default(25).describe("The number of elements you want returned on each page.").optional(),
+	page_token: zod.z.string().describe("Token for pagination. To get the next page, use the value from `_metadata.next` in the response. If `_metadata.prev` doesn't exist, you're at the first page. If `_metadata.next` is not present, you're at the last page.").optional(),
+	start_date: zod.z.string().describe("Format: YYYY-MM-DD. The start date for the stats search period. If not specified, defaults to the Single Send's creation date.").optional(),
+	aggregated_by: zod.z.enum([
+		"total",
+		"day",
+		"week",
+		"month"
+	]).describe("Dictates how the stats are time-sliced. Supported values: 'total', 'day', 'week', 'month'. Use 'total' for aggregate stats or 'day'/'week'/'month' for time-series data.").optional()
+}).describe("Request schema for `GetSingleSendStatsById`");
+const SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema = zod.z.object({
+	opens: zod.z.number().int().describe("The total number of times that your email was opened, including multiple opens by the same recipient.").nullable().optional(),
+	clicks: zod.z.number().int().describe("The total number of times that recipients clicked within your email, including multiple clicks by the same recipient on the same links.").nullable().optional(),
+	bounces: zod.z.number().int().describe("The number of emails that bounced instead of being delivered.").nullable().optional(),
+	requests: zod.z.number().int().describe("The number of emails you asked Marketing Campaigns to deliver. Each attempt to send email via SendGrid is considered a request.").nullable().optional(),
+	delivered: zod.z.number().int().describe("The number of emails that were accepted by the receiving inbox server. Delivered is calculated as the number of emails requested minus the number of emails that were suppressed, bounced, or blocked.").nullable().optional(),
+	bounce_drops: zod.z.number().int().describe("The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Bounced list.").nullable().optional(),
+	spam_reports: zod.z.number().int().describe("The number of recipients who marked your email as spam.").nullable().optional(),
+	unique_opens: zod.z.number().int().describe("The number of unique recipients that opened your email, regardless of how many times an individual may have opened the email.").nullable().optional(),
+	unsubscribes: zod.z.number().int().describe("The number of recipients who chose to unsubscribe from within the specific email.").nullable().optional(),
+	unique_clicks: zod.z.number().int().describe("The number of unique recipients that clicked your email, regardless of how many times an individual may have clicked within the email.").nullable().optional(),
+	invalid_emails: zod.z.number().int().describe("The number of recipient email addresses you attempted to send to that were not formatted correctly.").nullable().optional(),
+	spam_report_drops: zod.z.number().int().describe("The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Spam Report list.").nullable().optional()
+}).passthrough().describe("Statistics metrics for a Single Send");
+const SendgridGetSingleSendStatsById_SingleSendStatsResultSchema = zod.z.object({
+	stats: SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema.nullable(),
+	ab_phase: zod.z.string().describe("The A/B phase of the Single Send stat returned. If the group_by parameter doesn't include ab_phase in the request, then the value is 'all'.").nullable().optional(),
+	ab_variation: zod.z.string().describe("The A/B variation of the Single Send stat returned. If the group_by parameter doesn't include ab_variation in the request, then the value is 'all'.").nullable().optional(),
+	aggregated_by: zod.z.string().describe("Describes the time unit to which the stat is rolled up, based on the aggregated_by parameter included in the request. Can be 'total' or a date in YYYY-MM-DD format.").nullable().optional(),
+	singlesend_id: zod.z.string().describe("The ID of the Single Send for which stats are returned.").nullable()
+}).passthrough().describe("Individual stats result for a Single Send");
+const SendgridGetSingleSendStatsById_StatsMetadataSchema = zod.z.object({
+	next: zod.z.string().describe("URL of the next page of results. If this field isn't present, you're at the end of the list.").nullable().optional(),
+	prev: zod.z.string().describe("URL of the previous page of results. If this field isn't present, you're at the start of the list.").nullable().optional(),
+	self: zod.z.string().describe("URL of the current page of results.").nullable().optional(),
+	count: zod.z.number().int().describe("The number of items in the entire list, i.e., across all pages.").nullable().optional()
+}).passthrough().describe("Pagination metadata");
+const SendgridGetSingleSendStatsByIdOutput = zod.z.object({
+	results: zod.z.array(SendgridGetSingleSendStatsById_SingleSendStatsResultSchema).describe("Array of statistics objects for the Single Send, grouped and aggregated according to the query parameters."),
+	_metadata: SendgridGetSingleSendStatsById_StatsMetadataSchema.nullable().optional()
+}).passthrough().describe("Response schema for `GetSingleSendStatsById`");
+const sendgridGetSingleSendStatsById = require_action.action("SENDGRID_GET_SINGLE_SEND_STATS_BY_ID", {
+	slug: "sendgrid-get-single-send-stats-by-id",
+	name: "Get single send stats by id",
+	description: "Retrieve individual Single Send stats using its ID. For multiple IDs, use \"Get All Single Sends Stats\". Filter results by date or refine with `group_by` and `aggregated_by` parameters.",
+	input: SendgridGetSingleSendStatsByIdInput,
+	output: SendgridGetSingleSendStatsByIdOutput
+});
+//#endregion
+exports.sendgridGetSingleSendStatsById = sendgridGetSingleSendStatsById;
+
+//# sourceMappingURL=get-single-send-stats-by-id.cjs.map

package/dist/actions/get-single-send-stats-by-id.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-send-stats-by-id.cjs","names":["z","action"],"sources":["../../src/actions/get-single-send-stats-by-id.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridGetSingleSendStatsByIdInput = z.object({\n  id: z.string().describe(\"The ID of Single Send for which you want to retrieve stats.\"),\n  end_date: z.string().describe(\"Format: YYYY-MM-DD. The end date for the stats search period. If not specified, defaults to the current date.\").optional(),\n  group_by: z.array(z.enum([\"ab_variation\", \"ab_phase\"])).describe(\"For A/B Single Sends, allows grouping stats by 'ab_variation' or 'ab_phase' to see performance metrics for each variation or test phase separately.\").optional(),\n  timezone: z.string().default(\"UTC\").describe(\"[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \\\"America/Chicago\\\".\").optional(),\n  page_size: z.number().int().default(25).describe(\"The number of elements you want returned on each page.\").optional(),\n  page_token: z.string().describe(\"Token for pagination. To get the next page, use the value from `_metadata.next` in the response. If `_metadata.prev` doesn't exist, you're at the first page. If `_metadata.next` is not present, you're at the last page.\").optional(),\n  start_date: z.string().describe(\"Format: YYYY-MM-DD. The start date for the stats search period. If not specified, defaults to the Single Send's creation date.\").optional(),\n  aggregated_by: z.enum([\"total\", \"day\", \"week\", \"month\"]).describe(\"Dictates how the stats are time-sliced. Supported values: 'total', 'day', 'week', 'month'. Use 'total' for aggregate stats or 'day'/'week'/'month' for time-series data.\").optional(),\n}).describe(\"Request schema for `GetSingleSendStatsById`\");\nconst SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema = z.object({\n  opens: z.number().int().describe(\"The total number of times that your email was opened, including multiple opens by the same recipient.\").nullable().optional(),\n  clicks: z.number().int().describe(\"The total number of times that recipients clicked within your email, including multiple clicks by the same recipient on the same links.\").nullable().optional(),\n  bounces: z.number().int().describe(\"The number of emails that bounced instead of being delivered.\").nullable().optional(),\n  requests: z.number().int().describe(\"The number of emails you asked Marketing Campaigns to deliver. Each attempt to send email via SendGrid is considered a request.\").nullable().optional(),\n  delivered: z.number().int().describe(\"The number of emails that were accepted by the receiving inbox server. Delivered is calculated as the number of emails requested minus the number of emails that were suppressed, bounced, or blocked.\").nullable().optional(),\n  bounce_drops: z.number().int().describe(\"The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Bounced list.\").nullable().optional(),\n  spam_reports: z.number().int().describe(\"The number of recipients who marked your email as spam.\").nullable().optional(),\n  unique_opens: z.number().int().describe(\"The number of unique recipients that opened your email, regardless of how many times an individual may have opened the email.\").nullable().optional(),\n  unsubscribes: z.number().int().describe(\"The number of recipients who chose to unsubscribe from within the specific email.\").nullable().optional(),\n  unique_clicks: z.number().int().describe(\"The number of unique recipients that clicked your email, regardless of how many times an individual may have clicked within the email.\").nullable().optional(),\n  invalid_emails: z.number().int().describe(\"The number of recipient email addresses you attempted to send to that were not formatted correctly.\").nullable().optional(),\n  spam_report_drops: z.number().int().describe(\"The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Spam Report list.\").nullable().optional(),\n}).passthrough().describe(\"Statistics metrics for a Single Send\");\nconst SendgridGetSingleSendStatsById_SingleSendStatsResultSchema = z.object({\n  stats: SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema.nullable(),\n  ab_phase: z.string().describe(\"The A/B phase of the Single Send stat returned. If the group_by parameter doesn't include ab_phase in the request, then the value is 'all'.\").nullable().optional(),\n  ab_variation: z.string().describe(\"The A/B variation of the Single Send stat returned. If the group_by parameter doesn't include ab_variation in the request, then the value is 'all'.\").nullable().optional(),\n  aggregated_by: z.string().describe(\"Describes the time unit to which the stat is rolled up, based on the aggregated_by parameter included in the request. Can be 'total' or a date in YYYY-MM-DD format.\").nullable().optional(),\n  singlesend_id: z.string().describe(\"The ID of the Single Send for which stats are returned.\").nullable(),\n}).passthrough().describe(\"Individual stats result for a Single Send\");\nconst SendgridGetSingleSendStatsById_StatsMetadataSchema = z.object({\n  next: z.string().describe(\"URL of the next page of results. If this field isn't present, you're at the end of the list.\").nullable().optional(),\n  prev: z.string().describe(\"URL of the previous page of results. If this field isn't present, you're at the start of the list.\").nullable().optional(),\n  self: z.string().describe(\"URL of the current page of results.\").nullable().optional(),\n  count: z.number().int().describe(\"The number of items in the entire list, i.e., across all pages.\").nullable().optional(),\n}).passthrough().describe(\"Pagination metadata\");\nexport const SendgridGetSingleSendStatsByIdOutput = z.object({\n  results: z.array(SendgridGetSingleSendStatsById_SingleSendStatsResultSchema).describe(\"Array of statistics objects for the Single Send, grouped and aggregated according to the query parameters.\"),\n  _metadata: SendgridGetSingleSendStatsById_StatsMetadataSchema.nullable().optional(),\n}).passthrough().describe(\"Response schema for `GetSingleSendStatsById`\");\n\nexport const sendgridGetSingleSendStatsById = action(\"SENDGRID_GET_SINGLE_SEND_STATS_BY_ID\", {\n  slug: \"sendgrid-get-single-send-stats-by-id\",\n  name: \"Get single send stats by id\",\n  description: \"Retrieve individual Single Send stats using its ID. For multiple IDs, use \\\"Get All Single Sends Stats\\\". Filter results by date or refine with `group_by` and `aggregated_by` parameters.\",\n  input: SendgridGetSingleSendStatsByIdInput,\n  output: SendgridGetSingleSendStatsByIdOutput,\n});\n"],"mappings":"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"}

package/dist/actions/get-single-send-stats-by-id.d.cts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+
+//#region src/actions/get-single-send-stats-by-id.d.ts
+declare const SendgridGetSingleSendStatsByIdInput: z.ZodObject<{
+  id: z.ZodString;
+  end_date: z.ZodOptional<z.ZodString>;
+  group_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    ab_variation: "ab_variation";
+    ab_phase: "ab_phase";
+  }>>>;
+  timezone: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  page_size: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+  page_token: z.ZodOptional<z.ZodString>;
+  start_date: z.ZodOptional<z.ZodString>;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    total: "total";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridGetSingleSendStatsByIdOutput: z.ZodObject<{
+  results: z.ZodArray<z.ZodObject<{
+    stats: z.ZodNullable<z.ZodObject<{
+      opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      bounce_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      spam_reports: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unique_opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unsubscribes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unique_clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      invalid_emails: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      spam_report_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>;
+    ab_phase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ab_variation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aggregated_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    singlesend_id: z.ZodNullable<z.ZodString>;
+  }, z.core.$loose>>;
+  _metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    self: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const sendgridGetSingleSendStatsById: import("@keystrokehq/action").WorkflowActionDefinition<{
+  id: string;
+  end_date?: string | undefined;
+  group_by?: ("ab_variation" | "ab_phase")[] | undefined;
+  timezone?: string | undefined;
+  page_size?: number | undefined;
+  page_token?: string | undefined;
+  start_date?: string | undefined;
+  aggregated_by?: "total" | "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridGetSingleSendStatsById };
+//# sourceMappingURL=get-single-send-stats-by-id.d.cts.map

package/dist/actions/get-single-send-stats-by-id.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-send-stats-by-id.d.cts","names":[],"sources":["../../src/actions/get-single-send-stats-by-id.ts"],"mappings":";;;cAIa,mCAAA,EAAmC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;cAqCnC,oCAAA,EAAoC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKpC,8BAAA,gCAA8B,wBAAA"}

package/dist/actions/get-single-send-stats-by-id.d.mts

@@ -0,0 +1,62 @@
+import { z } from "zod";
+
+//#region src/actions/get-single-send-stats-by-id.d.ts
+declare const SendgridGetSingleSendStatsByIdInput: z.ZodObject<{
+  id: z.ZodString;
+  end_date: z.ZodOptional<z.ZodString>;
+  group_by: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    ab_variation: "ab_variation";
+    ab_phase: "ab_phase";
+  }>>>;
+  timezone: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+  page_size: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+  page_token: z.ZodOptional<z.ZodString>;
+  start_date: z.ZodOptional<z.ZodString>;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    total: "total";
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridGetSingleSendStatsByIdOutput: z.ZodObject<{
+  results: z.ZodArray<z.ZodObject<{
+    stats: z.ZodNullable<z.ZodObject<{
+      opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      bounce_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      spam_reports: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unique_opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unsubscribes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      unique_clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      invalid_emails: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      spam_report_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$loose>>;
+    ab_phase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ab_variation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    aggregated_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    singlesend_id: z.ZodNullable<z.ZodString>;
+  }, z.core.$loose>>;
+  _metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    self: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const sendgridGetSingleSendStatsById: import("@keystrokehq/action").WorkflowActionDefinition<{
+  id: string;
+  end_date?: string | undefined;
+  group_by?: ("ab_variation" | "ab_phase")[] | undefined;
+  timezone?: string | undefined;
+  page_size?: number | undefined;
+  page_token?: string | undefined;
+  start_date?: string | undefined;
+  aggregated_by?: "total" | "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridGetSingleSendStatsById };
+//# sourceMappingURL=get-single-send-stats-by-id.d.mts.map

package/dist/actions/get-single-send-stats-by-id.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-send-stats-by-id.d.mts","names":[],"sources":["../../src/actions/get-single-send-stats-by-id.ts"],"mappings":";;;cAIa,mCAAA,EAAmC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;cAqCnC,oCAAA,EAAoC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKpC,8BAAA,gCAA8B,wBAAA"}

package/dist/actions/get-single-send-stats-by-id.mjs

@@ -0,0 +1,59 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/get-single-send-stats-by-id.ts
+const SendgridGetSingleSendStatsByIdInput = z.object({
+	id: z.string().describe("The ID of Single Send for which you want to retrieve stats."),
+	end_date: z.string().describe("Format: YYYY-MM-DD. The end date for the stats search period. If not specified, defaults to the current date.").optional(),
+	group_by: z.array(z.enum(["ab_variation", "ab_phase"])).describe("For A/B Single Sends, allows grouping stats by 'ab_variation' or 'ab_phase' to see performance metrics for each variation or test phase separately.").optional(),
+	timezone: z.string().default("UTC").describe("[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \"America/Chicago\".").optional(),
+	page_size: z.number().int().default(25).describe("The number of elements you want returned on each page.").optional(),
+	page_token: z.string().describe("Token for pagination. To get the next page, use the value from `_metadata.next` in the response. If `_metadata.prev` doesn't exist, you're at the first page. If `_metadata.next` is not present, you're at the last page.").optional(),
+	start_date: z.string().describe("Format: YYYY-MM-DD. The start date for the stats search period. If not specified, defaults to the Single Send's creation date.").optional(),
+	aggregated_by: z.enum([
+		"total",
+		"day",
+		"week",
+		"month"
+	]).describe("Dictates how the stats are time-sliced. Supported values: 'total', 'day', 'week', 'month'. Use 'total' for aggregate stats or 'day'/'week'/'month' for time-series data.").optional()
+}).describe("Request schema for `GetSingleSendStatsById`");
+const SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema = z.object({
+	opens: z.number().int().describe("The total number of times that your email was opened, including multiple opens by the same recipient.").nullable().optional(),
+	clicks: z.number().int().describe("The total number of times that recipients clicked within your email, including multiple clicks by the same recipient on the same links.").nullable().optional(),
+	bounces: z.number().int().describe("The number of emails that bounced instead of being delivered.").nullable().optional(),
+	requests: z.number().int().describe("The number of emails you asked Marketing Campaigns to deliver. Each attempt to send email via SendGrid is considered a request.").nullable().optional(),
+	delivered: z.number().int().describe("The number of emails that were accepted by the receiving inbox server. Delivered is calculated as the number of emails requested minus the number of emails that were suppressed, bounced, or blocked.").nullable().optional(),
+	bounce_drops: z.number().int().describe("The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Bounced list.").nullable().optional(),
+	spam_reports: z.number().int().describe("The number of recipients who marked your email as spam.").nullable().optional(),
+	unique_opens: z.number().int().describe("The number of unique recipients that opened your email, regardless of how many times an individual may have opened the email.").nullable().optional(),
+	unsubscribes: z.number().int().describe("The number of recipients who chose to unsubscribe from within the specific email.").nullable().optional(),
+	unique_clicks: z.number().int().describe("The number of unique recipients that clicked your email, regardless of how many times an individual may have clicked within the email.").nullable().optional(),
+	invalid_emails: z.number().int().describe("The number of recipient email addresses you attempted to send to that were not formatted correctly.").nullable().optional(),
+	spam_report_drops: z.number().int().describe("The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Spam Report list.").nullable().optional()
+}).passthrough().describe("Statistics metrics for a Single Send");
+const SendgridGetSingleSendStatsById_SingleSendStatsResultSchema = z.object({
+	stats: SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema.nullable(),
+	ab_phase: z.string().describe("The A/B phase of the Single Send stat returned. If the group_by parameter doesn't include ab_phase in the request, then the value is 'all'.").nullable().optional(),
+	ab_variation: z.string().describe("The A/B variation of the Single Send stat returned. If the group_by parameter doesn't include ab_variation in the request, then the value is 'all'.").nullable().optional(),
+	aggregated_by: z.string().describe("Describes the time unit to which the stat is rolled up, based on the aggregated_by parameter included in the request. Can be 'total' or a date in YYYY-MM-DD format.").nullable().optional(),
+	singlesend_id: z.string().describe("The ID of the Single Send for which stats are returned.").nullable()
+}).passthrough().describe("Individual stats result for a Single Send");
+const SendgridGetSingleSendStatsById_StatsMetadataSchema = z.object({
+	next: z.string().describe("URL of the next page of results. If this field isn't present, you're at the end of the list.").nullable().optional(),
+	prev: z.string().describe("URL of the previous page of results. If this field isn't present, you're at the start of the list.").nullable().optional(),
+	self: z.string().describe("URL of the current page of results.").nullable().optional(),
+	count: z.number().int().describe("The number of items in the entire list, i.e., across all pages.").nullable().optional()
+}).passthrough().describe("Pagination metadata");
+const sendgridGetSingleSendStatsById = action("SENDGRID_GET_SINGLE_SEND_STATS_BY_ID", {
+	slug: "sendgrid-get-single-send-stats-by-id",
+	name: "Get single send stats by id",
+	description: "Retrieve individual Single Send stats using its ID. For multiple IDs, use \"Get All Single Sends Stats\". Filter results by date or refine with `group_by` and `aggregated_by` parameters.",
+	input: SendgridGetSingleSendStatsByIdInput,
+	output: z.object({
+		results: z.array(SendgridGetSingleSendStatsById_SingleSendStatsResultSchema).describe("Array of statistics objects for the Single Send, grouped and aggregated according to the query parameters."),
+		_metadata: SendgridGetSingleSendStatsById_StatsMetadataSchema.nullable().optional()
+	}).passthrough().describe("Response schema for `GetSingleSendStatsById`")
+});
+//#endregion
+export { sendgridGetSingleSendStatsById };
+
+//# sourceMappingURL=get-single-send-stats-by-id.mjs.map

package/dist/actions/get-single-send-stats-by-id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-send-stats-by-id.mjs","names":[],"sources":["../../src/actions/get-single-send-stats-by-id.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridGetSingleSendStatsByIdInput = z.object({\n  id: z.string().describe(\"The ID of Single Send for which you want to retrieve stats.\"),\n  end_date: z.string().describe(\"Format: YYYY-MM-DD. The end date for the stats search period. If not specified, defaults to the current date.\").optional(),\n  group_by: z.array(z.enum([\"ab_variation\", \"ab_phase\"])).describe(\"For A/B Single Sends, allows grouping stats by 'ab_variation' or 'ab_phase' to see performance metrics for each variation or test phase separately.\").optional(),\n  timezone: z.string().default(\"UTC\").describe(\"[IANA Area/Region](https://en.wikipedia.org/wiki/Tz_database#Names_of_timezones) string representing the timezone in which the stats are to be presented, e.g., \\\"America/Chicago\\\".\").optional(),\n  page_size: z.number().int().default(25).describe(\"The number of elements you want returned on each page.\").optional(),\n  page_token: z.string().describe(\"Token for pagination. To get the next page, use the value from `_metadata.next` in the response. If `_metadata.prev` doesn't exist, you're at the first page. If `_metadata.next` is not present, you're at the last page.\").optional(),\n  start_date: z.string().describe(\"Format: YYYY-MM-DD. The start date for the stats search period. If not specified, defaults to the Single Send's creation date.\").optional(),\n  aggregated_by: z.enum([\"total\", \"day\", \"week\", \"month\"]).describe(\"Dictates how the stats are time-sliced. Supported values: 'total', 'day', 'week', 'month'. Use 'total' for aggregate stats or 'day'/'week'/'month' for time-series data.\").optional(),\n}).describe(\"Request schema for `GetSingleSendStatsById`\");\nconst SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema = z.object({\n  opens: z.number().int().describe(\"The total number of times that your email was opened, including multiple opens by the same recipient.\").nullable().optional(),\n  clicks: z.number().int().describe(\"The total number of times that recipients clicked within your email, including multiple clicks by the same recipient on the same links.\").nullable().optional(),\n  bounces: z.number().int().describe(\"The number of emails that bounced instead of being delivered.\").nullable().optional(),\n  requests: z.number().int().describe(\"The number of emails you asked Marketing Campaigns to deliver. Each attempt to send email via SendGrid is considered a request.\").nullable().optional(),\n  delivered: z.number().int().describe(\"The number of emails that were accepted by the receiving inbox server. Delivered is calculated as the number of emails requested minus the number of emails that were suppressed, bounced, or blocked.\").nullable().optional(),\n  bounce_drops: z.number().int().describe(\"The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Bounced list.\").nullable().optional(),\n  spam_reports: z.number().int().describe(\"The number of recipients who marked your email as spam.\").nullable().optional(),\n  unique_opens: z.number().int().describe(\"The number of unique recipients that opened your email, regardless of how many times an individual may have opened the email.\").nullable().optional(),\n  unsubscribes: z.number().int().describe(\"The number of recipients who chose to unsubscribe from within the specific email.\").nullable().optional(),\n  unique_clicks: z.number().int().describe(\"The number of unique recipients that clicked your email, regardless of how many times an individual may have clicked within the email.\").nullable().optional(),\n  invalid_emails: z.number().int().describe(\"The number of recipient email addresses you attempted to send to that were not formatted correctly.\").nullable().optional(),\n  spam_report_drops: z.number().int().describe(\"The number of emails that Marketing Campaigns dropped or did not send because the recipient is on your Spam Report list.\").nullable().optional(),\n}).passthrough().describe(\"Statistics metrics for a Single Send\");\nconst SendgridGetSingleSendStatsById_SingleSendStatsResultSchema = z.object({\n  stats: SendgridGetSingleSendStatsById_SingleSendStatsMetricsSchema.nullable(),\n  ab_phase: z.string().describe(\"The A/B phase of the Single Send stat returned. If the group_by parameter doesn't include ab_phase in the request, then the value is 'all'.\").nullable().optional(),\n  ab_variation: z.string().describe(\"The A/B variation of the Single Send stat returned. If the group_by parameter doesn't include ab_variation in the request, then the value is 'all'.\").nullable().optional(),\n  aggregated_by: z.string().describe(\"Describes the time unit to which the stat is rolled up, based on the aggregated_by parameter included in the request. Can be 'total' or a date in YYYY-MM-DD format.\").nullable().optional(),\n  singlesend_id: z.string().describe(\"The ID of the Single Send for which stats are returned.\").nullable(),\n}).passthrough().describe(\"Individual stats result for a Single Send\");\nconst SendgridGetSingleSendStatsById_StatsMetadataSchema = z.object({\n  next: z.string().describe(\"URL of the next page of results. If this field isn't present, you're at the end of the list.\").nullable().optional(),\n  prev: z.string().describe(\"URL of the previous page of results. If this field isn't present, you're at the start of the list.\").nullable().optional(),\n  self: z.string().describe(\"URL of the current page of results.\").nullable().optional(),\n  count: z.number().int().describe(\"The number of items in the entire list, i.e., across all pages.\").nullable().optional(),\n}).passthrough().describe(\"Pagination metadata\");\nexport const SendgridGetSingleSendStatsByIdOutput = z.object({\n  results: z.array(SendgridGetSingleSendStatsById_SingleSendStatsResultSchema).describe(\"Array of statistics objects for the Single Send, grouped and aggregated according to the query parameters.\"),\n  _metadata: SendgridGetSingleSendStatsById_StatsMetadataSchema.nullable().optional(),\n}).passthrough().describe(\"Response schema for `GetSingleSendStatsById`\");\n\nexport const sendgridGetSingleSendStatsById = action(\"SENDGRID_GET_SINGLE_SEND_STATS_BY_ID\", {\n  slug: \"sendgrid-get-single-send-stats-by-id\",\n  name: \"Get single send stats by id\",\n  description: \"Retrieve individual Single Send stats using its ID. For multiple IDs, use \\\"Get All Single Sends Stats\\\". Filter results by date or refine with `group_by` and `aggregated_by` parameters.\",\n  input: SendgridGetSingleSendStatsByIdInput,\n  output: SendgridGetSingleSendStatsByIdOutput,\n});\n"],"mappings":"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"}

package/dist/actions/get-single-sends-search.cjs

@@ -0,0 +1,45 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-single-sends-search.ts
+const SendgridGetSingleSendsSearchInput = zod.z.object({
+	name: zod.z.string().describe("Search for Single Sends by name using wildcard matching. The search is case-insensitive and matches partial names. Example: 'welcome' matches 'Welcome Email', 'welcome-new-users', etc.").optional(),
+	status: zod.z.array(zod.z.enum([
+		"draft",
+		"scheduled",
+		"triggered"
+	]).describe("Status of a Single Send campaign.")).describe("Filter by Single Send status. Accepts multiple values: 'draft' (not yet sent), 'scheduled' (queued for future send), 'triggered' (already sent). Example: ['draft', 'scheduled'].").optional(),
+	page_size: zod.z.number().int().describe("Number of Single Sends to return per page. Controls pagination size for the search results.").optional(),
+	categories: zod.z.array(zod.z.string()).describe("Filter by categories. Returns Single Sends that match ANY of the specified categories (OR logic). Example: ['Newsletter', 'Promotion'].").optional(),
+	page_token: zod.z.string().describe("Token for retrieving the next page of results. Returned in the response metadata when more results are available.").optional()
+}).describe("Request schema for `GetSingleSendsSearch`");
+const SendgridGetSingleSendsSearch_SingleSendResultSchema = zod.z.object({
+	id: zod.z.string().describe("The unique ID for the Single Send.").nullable(),
+	name: zod.z.string().describe("The name of the Single Send.").nullable(),
+	status: zod.z.string().describe("The current status of the Single Send. May be 'draft', 'scheduled', or 'triggered'.").nullable(),
+	send_at: zod.z.string().describe("An ISO 8601 formatted date-time when the Single Send is set to be sent. Only present for scheduled Single Sends.").nullable().optional(),
+	is_abtest: zod.z.boolean().describe("True if the Single Send's A/B Test functionality has been toggled on.").nullable().optional(),
+	categories: zod.z.array(zod.z.string()).describe("The categories associated with this Single Send.").nullable().optional(),
+	created_at: zod.z.string().describe("The ISO 8601 time at which the Single Send was created.").nullable().optional(),
+	updated_at: zod.z.string().describe("The ISO 8601 time at which the Single Send was last updated.").nullable().optional()
+}).describe("Individual Single Send item in search results.");
+const SendgridGetSingleSendsSearch_SearchMetadataSchema = zod.z.object({
+	next: zod.z.string().describe("The URL of the next page. If this field is not present, you're at the last page.").nullable().optional(),
+	prev: zod.z.string().describe("The URL of the previous page. If this field doesn't exist, you're at the first page.").nullable().optional(),
+	self: zod.z.string().describe("The URL of the current page.").nullable().optional(),
+	count: zod.z.number().int().describe("The total count of items across all pages.").nullable().optional()
+}).describe("Pagination metadata containing links to navigate through multiple pages of results.");
+const SendgridGetSingleSendsSearchOutput = zod.z.object({
+	result: zod.z.array(SendgridGetSingleSendsSearch_SingleSendResultSchema).describe("Array of Single Send objects matching the search criteria. Returns condensed Single Send details (singlesend_response_short)."),
+	_metadata: SendgridGetSingleSendsSearch_SearchMetadataSchema.nullable().optional()
+}).describe("Response schema for `GetSingleSendsSearch`");
+const sendgridGetSingleSendsSearch = require_action.action("SENDGRID_GET_SINGLE_SENDS_SEARCH", {
+	slug: "sendgrid-get-single-sends-search",
+	name: "Get single sends search",
+	description: "Search for Single Sends (marketing email campaigns) by name, status, and/or categories. Use this endpoint to find specific Single Sends when you have many campaigns. - Search by name using partial/wildcard matching - Filter by status: 'draft', 'scheduled', or 'triggered' - Filter by categories (returns campaigns matching ANY specified category) Results are paginated. Use page_token from the response to retrieve additional pages. Requires Marketing Campaigns API access (marketing.singlesends.read scope).",
+	input: SendgridGetSingleSendsSearchInput,
+	output: SendgridGetSingleSendsSearchOutput
+});
+//#endregion
+exports.sendgridGetSingleSendsSearch = sendgridGetSingleSendsSearch;
+
+//# sourceMappingURL=get-single-sends-search.cjs.map

package/dist/actions/get-single-sends-search.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-sends-search.cjs","names":["z","action"],"sources":["../../src/actions/get-single-sends-search.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridGetSingleSendsSearchInput = z.object({\n  name: z.string().describe(\"Search for Single Sends by name using wildcard matching. The search is case-insensitive and matches partial names. Example: 'welcome' matches 'Welcome Email', 'welcome-new-users', etc.\").optional(),\n  status: z.array(z.enum([\"draft\", \"scheduled\", \"triggered\"]).describe(\"Status of a Single Send campaign.\")).describe(\"Filter by Single Send status. Accepts multiple values: 'draft' (not yet sent), 'scheduled' (queued for future send), 'triggered' (already sent). Example: ['draft', 'scheduled'].\").optional(),\n  page_size: z.number().int().describe(\"Number of Single Sends to return per page. Controls pagination size for the search results.\").optional(),\n  categories: z.array(z.string()).describe(\"Filter by categories. Returns Single Sends that match ANY of the specified categories (OR logic). Example: ['Newsletter', 'Promotion'].\").optional(),\n  page_token: z.string().describe(\"Token for retrieving the next page of results. Returned in the response metadata when more results are available.\").optional(),\n}).describe(\"Request schema for `GetSingleSendsSearch`\");\nconst SendgridGetSingleSendsSearch_SingleSendResultSchema = z.object({\n  id: z.string().describe(\"The unique ID for the Single Send.\").nullable(),\n  name: z.string().describe(\"The name of the Single Send.\").nullable(),\n  status: z.string().describe(\"The current status of the Single Send. May be 'draft', 'scheduled', or 'triggered'.\").nullable(),\n  send_at: z.string().describe(\"An ISO 8601 formatted date-time when the Single Send is set to be sent. Only present for scheduled Single Sends.\").nullable().optional(),\n  is_abtest: z.boolean().describe(\"True if the Single Send's A/B Test functionality has been toggled on.\").nullable().optional(),\n  categories: z.array(z.string()).describe(\"The categories associated with this Single Send.\").nullable().optional(),\n  created_at: z.string().describe(\"The ISO 8601 time at which the Single Send was created.\").nullable().optional(),\n  updated_at: z.string().describe(\"The ISO 8601 time at which the Single Send was last updated.\").nullable().optional(),\n}).describe(\"Individual Single Send item in search results.\");\nconst SendgridGetSingleSendsSearch_SearchMetadataSchema = z.object({\n  next: z.string().describe(\"The URL of the next page. If this field is not present, you're at the last page.\").nullable().optional(),\n  prev: z.string().describe(\"The URL of the previous page. If this field doesn't exist, you're at the first page.\").nullable().optional(),\n  self: z.string().describe(\"The URL of the current page.\").nullable().optional(),\n  count: z.number().int().describe(\"The total count of items across all pages.\").nullable().optional(),\n}).describe(\"Pagination metadata containing links to navigate through multiple pages of results.\");\nexport const SendgridGetSingleSendsSearchOutput = z.object({\n  result: z.array(SendgridGetSingleSendsSearch_SingleSendResultSchema).describe(\"Array of Single Send objects matching the search criteria. Returns condensed Single Send details (singlesend_response_short).\"),\n  _metadata: SendgridGetSingleSendsSearch_SearchMetadataSchema.nullable().optional(),\n}).describe(\"Response schema for `GetSingleSendsSearch`\");\n\nexport const sendgridGetSingleSendsSearch = action(\"SENDGRID_GET_SINGLE_SENDS_SEARCH\", {\n  slug: \"sendgrid-get-single-sends-search\",\n  name: \"Get single sends search\",\n  description: \"Search for Single Sends (marketing email campaigns) by name, status, and/or categories. Use this endpoint to find specific Single Sends when you have many campaigns. - Search by name using partial/wildcard matching - Filter by status: 'draft', 'scheduled', or 'triggered' - Filter by categories (returns campaigns matching ANY specified category) Results are paginated. Use page_token from the response to retrieve additional pages. Requires Marketing Campaigns API access (marketing.singlesends.read scope).\",\n  input: SendgridGetSingleSendsSearchInput,\n  output: SendgridGetSingleSendsSearchOutput,\n});\n"],"mappings":";;;AAIA,MAAa,oCAAoCA,IAAAA,EAAE,OAAO;CACxD,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,0LAA0L,CAAC,CAAC,SAAS;CAC/N,QAAQA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,KAAK;EAAC;EAAS;EAAa;CAAW,CAAC,CAAC,CAAC,SAAS,mCAAmC,CAAC,CAAC,CAAC,SAAS,mLAAmL,CAAC,CAAC,SAAS;CAClT,WAAWA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,6FAA6F,CAAC,CAAC,SAAS;CAC7I,YAAYA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,yIAAyI,CAAC,CAAC,SAAS;CAC7L,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,mHAAmH,CAAC,CAAC,SAAS;AAChK,CAAC,CAAC,CAAC,SAAS,2CAA2C;AACvD,MAAM,sDAAsDA,IAAAA,EAAE,OAAO;CACnE,IAAIA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,oCAAoC,CAAC,CAAC,SAAS;CACvE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,SAAS;CACnE,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,qFAAqF,CAAC,CAAC,SAAS;CAC5H,SAASA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,kHAAkH,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACrK,WAAWA,IAAAA,EAAE,QAAQ,CAAC,CAAC,SAAS,uEAAuE,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC7H,YAAYA,IAAAA,EAAE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,kDAAkD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjH,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,yDAAyD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC/G,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,8DAA8D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACtH,CAAC,CAAC,CAAC,SAAS,gDAAgD;AAC5D,MAAM,oDAAoDA,IAAAA,EAAE,OAAO;CACjE,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,kFAAkF,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClI,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,sFAAsF,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACtI,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC9E,OAAOA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,4CAA4C,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACrG,CAAC,CAAC,CAAC,SAAS,qFAAqF;AACjG,MAAa,qCAAqCA,IAAAA,EAAE,OAAO;CACzD,QAAQA,IAAAA,EAAE,MAAM,mDAAmD,CAAC,CAAC,SAAS,+HAA+H;CAC7M,WAAW,kDAAkD,SAAS,CAAC,CAAC,SAAS;AACnF,CAAC,CAAC,CAAC,SAAS,4CAA4C;AAExD,MAAa,+BAA+BC,eAAAA,OAAO,oCAAoC;CACrF,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAAQ;AACV,CAAC"}

package/dist/actions/get-single-sends-search.d.cts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+
+//#region src/actions/get-single-sends-search.d.ts
+declare const SendgridGetSingleSendsSearchInput: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    draft: "draft";
+    scheduled: "scheduled";
+    triggered: "triggered";
+  }>>>;
+  page_size: z.ZodOptional<z.ZodNumber>;
+  categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  page_token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SendgridGetSingleSendsSearchOutput: z.ZodObject<{
+  result: z.ZodArray<z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    send_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    is_abtest: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>>;
+  _metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    self: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const sendgridGetSingleSendsSearch: import("@keystrokehq/action").WorkflowActionDefinition<{
+  name?: string | undefined;
+  status?: ("draft" | "scheduled" | "triggered")[] | undefined;
+  page_size?: number | undefined;
+  categories?: string[] | undefined;
+  page_token?: string | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridGetSingleSendsSearch };
+//# sourceMappingURL=get-single-sends-search.d.cts.map

package/dist/actions/get-single-sends-search.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-sends-search.d.cts","names":[],"sources":["../../src/actions/get-single-sends-search.ts"],"mappings":";;;cAIa,iCAAA,EAAiC,CAAA,CAAA,SAAA;;;;;;;;;;;cAuBjC,kCAAA,EAAkC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;cAKlC,4BAAA,gCAA4B,wBAAA"}

package/dist/actions/get-single-sends-search.d.mts

@@ -0,0 +1,42 @@
+import { z } from "zod";
+
+//#region src/actions/get-single-sends-search.d.ts
+declare const SendgridGetSingleSendsSearchInput: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    draft: "draft";
+    scheduled: "scheduled";
+    triggered: "triggered";
+  }>>>;
+  page_size: z.ZodOptional<z.ZodNumber>;
+  categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  page_token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SendgridGetSingleSendsSearchOutput: z.ZodObject<{
+  result: z.ZodArray<z.ZodObject<{
+    id: z.ZodNullable<z.ZodString>;
+    name: z.ZodNullable<z.ZodString>;
+    status: z.ZodNullable<z.ZodString>;
+    send_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    is_abtest: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    updated_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>>;
+  _metadata: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    next: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    prev: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    self: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const sendgridGetSingleSendsSearch: import("@keystrokehq/action").WorkflowActionDefinition<{
+  name?: string | undefined;
+  status?: ("draft" | "scheduled" | "triggered")[] | undefined;
+  page_size?: number | undefined;
+  categories?: string[] | undefined;
+  page_token?: string | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridGetSingleSendsSearch };
+//# sourceMappingURL=get-single-sends-search.d.mts.map

package/dist/actions/get-single-sends-search.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-sends-search.d.mts","names":[],"sources":["../../src/actions/get-single-sends-search.ts"],"mappings":";;;cAIa,iCAAA,EAAiC,CAAA,CAAA,SAAA;;;;;;;;;;;cAuBjC,kCAAA,EAAkC,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;cAKlC,4BAAA,gCAA4B,wBAAA"}

package/dist/actions/get-single-sends-search.mjs

@@ -0,0 +1,44 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/get-single-sends-search.ts
+const SendgridGetSingleSendsSearchInput = z.object({
+	name: z.string().describe("Search for Single Sends by name using wildcard matching. The search is case-insensitive and matches partial names. Example: 'welcome' matches 'Welcome Email', 'welcome-new-users', etc.").optional(),
+	status: z.array(z.enum([
+		"draft",
+		"scheduled",
+		"triggered"
+	]).describe("Status of a Single Send campaign.")).describe("Filter by Single Send status. Accepts multiple values: 'draft' (not yet sent), 'scheduled' (queued for future send), 'triggered' (already sent). Example: ['draft', 'scheduled'].").optional(),
+	page_size: z.number().int().describe("Number of Single Sends to return per page. Controls pagination size for the search results.").optional(),
+	categories: z.array(z.string()).describe("Filter by categories. Returns Single Sends that match ANY of the specified categories (OR logic). Example: ['Newsletter', 'Promotion'].").optional(),
+	page_token: z.string().describe("Token for retrieving the next page of results. Returned in the response metadata when more results are available.").optional()
+}).describe("Request schema for `GetSingleSendsSearch`");
+const SendgridGetSingleSendsSearch_SingleSendResultSchema = z.object({
+	id: z.string().describe("The unique ID for the Single Send.").nullable(),
+	name: z.string().describe("The name of the Single Send.").nullable(),
+	status: z.string().describe("The current status of the Single Send. May be 'draft', 'scheduled', or 'triggered'.").nullable(),
+	send_at: z.string().describe("An ISO 8601 formatted date-time when the Single Send is set to be sent. Only present for scheduled Single Sends.").nullable().optional(),
+	is_abtest: z.boolean().describe("True if the Single Send's A/B Test functionality has been toggled on.").nullable().optional(),
+	categories: z.array(z.string()).describe("The categories associated with this Single Send.").nullable().optional(),
+	created_at: z.string().describe("The ISO 8601 time at which the Single Send was created.").nullable().optional(),
+	updated_at: z.string().describe("The ISO 8601 time at which the Single Send was last updated.").nullable().optional()
+}).describe("Individual Single Send item in search results.");
+const SendgridGetSingleSendsSearch_SearchMetadataSchema = z.object({
+	next: z.string().describe("The URL of the next page. If this field is not present, you're at the last page.").nullable().optional(),
+	prev: z.string().describe("The URL of the previous page. If this field doesn't exist, you're at the first page.").nullable().optional(),
+	self: z.string().describe("The URL of the current page.").nullable().optional(),
+	count: z.number().int().describe("The total count of items across all pages.").nullable().optional()
+}).describe("Pagination metadata containing links to navigate through multiple pages of results.");
+const sendgridGetSingleSendsSearch = action("SENDGRID_GET_SINGLE_SENDS_SEARCH", {
+	slug: "sendgrid-get-single-sends-search",
+	name: "Get single sends search",
+	description: "Search for Single Sends (marketing email campaigns) by name, status, and/or categories. Use this endpoint to find specific Single Sends when you have many campaigns. - Search by name using partial/wildcard matching - Filter by status: 'draft', 'scheduled', or 'triggered' - Filter by categories (returns campaigns matching ANY specified category) Results are paginated. Use page_token from the response to retrieve additional pages. Requires Marketing Campaigns API access (marketing.singlesends.read scope).",
+	input: SendgridGetSingleSendsSearchInput,
+	output: z.object({
+		result: z.array(SendgridGetSingleSendsSearch_SingleSendResultSchema).describe("Array of Single Send objects matching the search criteria. Returns condensed Single Send details (singlesend_response_short)."),
+		_metadata: SendgridGetSingleSendsSearch_SearchMetadataSchema.nullable().optional()
+	}).describe("Response schema for `GetSingleSendsSearch`")
+});
+//#endregion
+export { sendgridGetSingleSendsSearch };
+
+//# sourceMappingURL=get-single-sends-search.mjs.map

package/dist/actions/get-single-sends-search.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-single-sends-search.mjs","names":[],"sources":["../../src/actions/get-single-sends-search.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridGetSingleSendsSearchInput = z.object({\n  name: z.string().describe(\"Search for Single Sends by name using wildcard matching. The search is case-insensitive and matches partial names. Example: 'welcome' matches 'Welcome Email', 'welcome-new-users', etc.\").optional(),\n  status: z.array(z.enum([\"draft\", \"scheduled\", \"triggered\"]).describe(\"Status of a Single Send campaign.\")).describe(\"Filter by Single Send status. Accepts multiple values: 'draft' (not yet sent), 'scheduled' (queued for future send), 'triggered' (already sent). Example: ['draft', 'scheduled'].\").optional(),\n  page_size: z.number().int().describe(\"Number of Single Sends to return per page. Controls pagination size for the search results.\").optional(),\n  categories: z.array(z.string()).describe(\"Filter by categories. Returns Single Sends that match ANY of the specified categories (OR logic). Example: ['Newsletter', 'Promotion'].\").optional(),\n  page_token: z.string().describe(\"Token for retrieving the next page of results. Returned in the response metadata when more results are available.\").optional(),\n}).describe(\"Request schema for `GetSingleSendsSearch`\");\nconst SendgridGetSingleSendsSearch_SingleSendResultSchema = z.object({\n  id: z.string().describe(\"The unique ID for the Single Send.\").nullable(),\n  name: z.string().describe(\"The name of the Single Send.\").nullable(),\n  status: z.string().describe(\"The current status of the Single Send. May be 'draft', 'scheduled', or 'triggered'.\").nullable(),\n  send_at: z.string().describe(\"An ISO 8601 formatted date-time when the Single Send is set to be sent. Only present for scheduled Single Sends.\").nullable().optional(),\n  is_abtest: z.boolean().describe(\"True if the Single Send's A/B Test functionality has been toggled on.\").nullable().optional(),\n  categories: z.array(z.string()).describe(\"The categories associated with this Single Send.\").nullable().optional(),\n  created_at: z.string().describe(\"The ISO 8601 time at which the Single Send was created.\").nullable().optional(),\n  updated_at: z.string().describe(\"The ISO 8601 time at which the Single Send was last updated.\").nullable().optional(),\n}).describe(\"Individual Single Send item in search results.\");\nconst SendgridGetSingleSendsSearch_SearchMetadataSchema = z.object({\n  next: z.string().describe(\"The URL of the next page. If this field is not present, you're at the last page.\").nullable().optional(),\n  prev: z.string().describe(\"The URL of the previous page. If this field doesn't exist, you're at the first page.\").nullable().optional(),\n  self: z.string().describe(\"The URL of the current page.\").nullable().optional(),\n  count: z.number().int().describe(\"The total count of items across all pages.\").nullable().optional(),\n}).describe(\"Pagination metadata containing links to navigate through multiple pages of results.\");\nexport const SendgridGetSingleSendsSearchOutput = z.object({\n  result: z.array(SendgridGetSingleSendsSearch_SingleSendResultSchema).describe(\"Array of Single Send objects matching the search criteria. Returns condensed Single Send details (singlesend_response_short).\"),\n  _metadata: SendgridGetSingleSendsSearch_SearchMetadataSchema.nullable().optional(),\n}).describe(\"Response schema for `GetSingleSendsSearch`\");\n\nexport const sendgridGetSingleSendsSearch = action(\"SENDGRID_GET_SINGLE_SENDS_SEARCH\", {\n  slug: \"sendgrid-get-single-sends-search\",\n  name: \"Get single sends search\",\n  description: \"Search for Single Sends (marketing email campaigns) by name, status, and/or categories. Use this endpoint to find specific Single Sends when you have many campaigns. - Search by name using partial/wildcard matching - Filter by status: 'draft', 'scheduled', or 'triggered' - Filter by categories (returns campaigns matching ANY specified category) Results are paginated. Use page_token from the response to retrieve additional pages. Requires Marketing Campaigns API access (marketing.singlesends.read scope).\",\n  input: SendgridGetSingleSendsSearchInput,\n  output: SendgridGetSingleSendsSearchOutput,\n});\n"],"mappings":";;;AAIA,MAAa,oCAAoC,EAAE,OAAO;CACxD,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,0LAA0L,CAAC,CAAC,SAAS;CAC/N,QAAQ,EAAE,MAAM,EAAE,KAAK;EAAC;EAAS;EAAa;CAAW,CAAC,CAAC,CAAC,SAAS,mCAAmC,CAAC,CAAC,CAAC,SAAS,mLAAmL,CAAC,CAAC,SAAS;CAClT,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,6FAA6F,CAAC,CAAC,SAAS;CAC7I,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,yIAAyI,CAAC,CAAC,SAAS;CAC7L,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,mHAAmH,CAAC,CAAC,SAAS;AAChK,CAAC,CAAC,CAAC,SAAS,2CAA2C;AACvD,MAAM,sDAAsD,EAAE,OAAO;CACnE,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,oCAAoC,CAAC,CAAC,SAAS;CACvE,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,SAAS;CACnE,QAAQ,EAAE,OAAO,CAAC,CAAC,SAAS,qFAAqF,CAAC,CAAC,SAAS;CAC5H,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS,kHAAkH,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACrK,WAAW,EAAE,QAAQ,CAAC,CAAC,SAAS,uEAAuE,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC7H,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,kDAAkD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjH,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,yDAAyD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC/G,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,8DAA8D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACtH,CAAC,CAAC,CAAC,SAAS,gDAAgD;AAC5D,MAAM,oDAAoD,EAAE,OAAO;CACjE,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,kFAAkF,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClI,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,sFAAsF,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACtI,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC9E,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,4CAA4C,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACrG,CAAC,CAAC,CAAC,SAAS,qFAAqF;AAMjG,MAAa,+BAA+B,OAAO,oCAAoC;CACrF,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAVgD,EAAE,OAAO;EACzD,QAAQ,EAAE,MAAM,mDAAmD,CAAC,CAAC,SAAS,+HAA+H;EAC7M,WAAW,kDAAkD,SAAS,CAAC,CAAC,SAAS;CACnF,CAAC,CAAC,CAAC,SAAS,4CAOF;AACV,CAAC"}

package/dist/actions/get-subuser-monthly-stats.cjs

@@ -0,0 +1,56 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/get-subuser-monthly-stats.ts
+const SendgridGetSubuserMonthlyStatsInput = zod.z.object({
+	date: zod.z.string().describe("The date of the month to retrieve statistics for. Must be formatted YYYY-MM-DD. For example, '2025-01-01' retrieves statistics for January 2025."),
+	limit: zod.z.number().int().default(5).describe("The maximum number of results to return. Defaults to 5.").optional(),
+	offset: zod.z.number().int().default(0).describe("The starting point in the result list for pagination. Defaults to 0.").optional(),
+	subuser_name: zod.z.string().describe("The username of the Subuser whose monthly email statistics you want to retrieve."),
+	sort_by_metric: zod.z.enum([
+		"blocks",
+		"bounces",
+		"clicks",
+		"delivered",
+		"opens",
+		"requests",
+		"unique_clicks",
+		"unique_opens",
+		"unsubscribes"
+	]).default("delivered").describe("The metric to sort results by. Valid values are: 'blocks', 'bounces', 'clicks', 'delivered', 'opens', 'requests', 'unique_clicks', 'unique_opens', 'unsubscribes'. Default is 'delivered'.").optional(),
+	sort_by_direction: zod.z.enum(["desc", "asc"]).describe("Sort direction for ordering results.").optional()
+}).describe("Request schema for `RetrieveTheMonthlyEmailStatisticsForASingleSubuser`");
+const SendgridGetSubuserMonthlyStats_StatsMetricsSchema = zod.z.object({
+	opens: zod.z.number().int().describe("Number of email opens.").nullable().optional(),
+	blocks: zod.z.number().int().describe("Number of blocked emails.").nullable().optional(),
+	clicks: zod.z.number().int().describe("Number of email clicks.").nullable().optional(),
+	bounces: zod.z.number().int().describe("Number of bounced emails.").nullable().optional(),
+	deferred: zod.z.number().int().describe("Number of deferred emails.").nullable().optional(),
+	requests: zod.z.number().int().describe("Number of email send requests.").nullable().optional(),
+	delivered: zod.z.number().int().describe("Number of delivered emails.").nullable().optional(),
+	processed: zod.z.number().int().describe("Number of processed emails.").nullable().optional(),
+	bounce_drops: zod.z.number().int().describe("Number of bounce drops.").nullable().optional(),
+	spam_reports: zod.z.number().int().describe("Number of spam reports.").nullable().optional(),
+	unique_opens: zod.z.number().int().describe("Number of unique opens.").nullable().optional(),
+	unsubscribes: zod.z.number().int().describe("Number of unsubscribes.").nullable().optional(),
+	unique_clicks: zod.z.number().int().describe("Number of unique clicks.").nullable().optional(),
+	invalid_emails: zod.z.number().int().describe("Number of invalid email addresses.").nullable().optional(),
+	spam_report_drops: zod.z.number().int().describe("Number of spam report drops.").nullable().optional(),
+	unsubscribe_drops: zod.z.number().int().describe("Number of unsubscribe drops.").nullable().optional()
+}).describe("Email statistics metrics for a date.");
+const SendgridGetSubuserMonthlyStats_StatsEntrySchema = zod.z.object({ metrics: SendgridGetSubuserMonthlyStats_StatsMetricsSchema.nullable().optional() }).describe("A single statistics entry for a date.");
+const SendgridGetSubuserMonthlyStats_SubuserMonthlyStatsItemSchema = zod.z.object({
+	date: zod.z.string().describe("The date of the statistics in YYYY-MM-DD format.").nullable().optional(),
+	stats: zod.z.array(SendgridGetSubuserMonthlyStats_StatsEntrySchema).describe("List of statistics entries.").nullable().optional()
+}).describe("Monthly statistics for a subuser on a specific date.");
+const SendgridGetSubuserMonthlyStatsOutput = zod.z.object({ data: zod.z.union([zod.z.array(SendgridGetSubuserMonthlyStats_SubuserMonthlyStatsItemSchema), zod.z.record(zod.z.string(), zod.z.unknown())]).nullable().optional() }).describe("Response schema for `RetrieveTheMonthlyEmailStatisticsForASingleSubuser`");
+const sendgridGetSubuserMonthlyStats = require_action.action("SENDGRID_GET_SUBUSER_MONTHLY_STATS", {
+	slug: "sendgrid-get-subuser-monthly-stats",
+	name: "Get subuser monthly stats",
+	description: "Retrieves monthly email statistics for a specific subuser. Returns metrics such as blocks, bounces, clicks, delivered emails, opens, requests, unique clicks/opens, and unsubscribes. **Note**: This endpoint requires the `subusers.stats.monthly.read` API scope and is only available for SendGrid Pro plans and above that have subusers configured. **Important**: Sort operations are not available for: bounce_drops, deferred, invalid_emails, processed, spam_report_drops, spam_reports, or unsubscribe_drops metrics.",
+	input: SendgridGetSubuserMonthlyStatsInput,
+	output: SendgridGetSubuserMonthlyStatsOutput
+});
+//#endregion
+exports.sendgridGetSubuserMonthlyStats = sendgridGetSubuserMonthlyStats;
+
+//# sourceMappingURL=get-subuser-monthly-stats.cjs.map