@keystrokehq/sendgrid 0.0.16 → 0.1.2

package/dist/actions/retrieve-email-statistics-by-mailbox-provider.d.mts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+
+//#region src/actions/retrieve-email-statistics-by-mailbox-provider.d.ts
+declare const SendgridRetrieveEmailStatisticsByMailboxProviderInput: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  end_date: z.ZodOptional<z.ZodString>;
+  start_date: z.ZodString;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+  mailbox_providers: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const SendgridRetrieveEmailStatisticsByMailboxProviderOutput: z.ZodUnknown;
+declare const sendgridRetrieveEmailStatisticsByMailboxProvider: import("@keystrokehq/action").WorkflowActionDefinition<{
+  start_date: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  end_date?: string | undefined;
+  aggregated_by?: "day" | "week" | "month" | undefined;
+  mailbox_providers?: string | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridRetrieveEmailStatisticsByMailboxProvider };
+//# sourceMappingURL=retrieve-email-statistics-by-mailbox-provider.d.mts.map

package/dist/actions/retrieve-email-statistics-by-mailbox-provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-by-mailbox-provider.d.mts","names":[],"sources":["../../src/actions/retrieve-email-statistics-by-mailbox-provider.ts"],"mappings":";;;cAIa,qDAAA,EAAqD,CAAA,CAAA,SAAA;;;;;;;;;;;;cAQrD,sDAAA,EAAsD,CAAA,CAAA,UAAc;AAAA,cAEpE,gDAAA,gCAAgD,wBAAA"}

package/dist/actions/retrieve-email-statistics-by-mailbox-provider.mjs

@@ -0,0 +1,24 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+const sendgridRetrieveEmailStatisticsByMailboxProvider = action("SENDGRID_RETRIEVE_EMAIL_STATISTICS_BY_MAILBOX_PROVIDER", {
+	slug: "sendgrid-retrieve-email-statistics-by-mailbox-provider",
+	name: "Retrieve email statistics by mailbox provider",
+	description: "Retrieve email statistics segmented by recipient mailbox provider (e.g., Gmail, Yahoo, Microsoft Outlook). This endpoint is part of the Advanced Stats API and requires the 'stats.read' permission. Note: SendGrid only stores up to 7 days of mailbox provider statistics data. The response provides email delivery and engagement metrics grouped by date and mailbox provider, useful for understanding deliverability performance across different email service providers. Common mailbox providers include: Gmail, Yahoo, Microsoft Outlook (includes hotmail.com, outlook.com, live.com), AOL, and Apple Mail. SendGrid offers groupings for over 200 mailbox providers.",
+	input: z.object({
+		limit: z.number().int().describe("The number of results to return. Default is 500 (maximum per request). Use with offset for pagination.").optional(),
+		offset: z.number().int().describe("The point in the list to begin retrieving results. Use with limit for pagination. Default is 0.").optional(),
+		end_date: z.string().describe("The end date of the statistics to retrieve. Format: YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.").optional(),
+		start_date: z.string().describe("The starting date of the statistics to retrieve (required). Format: YYYY-MM-DD (e.g., '2024-01-01'). Note: SendGrid only stores up to 7 days of mailbox provider statistics."),
+		aggregated_by: z.enum([
+			"day",
+			"week",
+			"month"
+		]).describe("Aggregation period for email statistics.").optional(),
+		mailbox_providers: z.string().describe("The mailbox provider to filter statistics by (e.g., 'Gmail', 'Yahoo', 'Microsoft Outlook'). IMPORTANT: The first character must be capitalized (e.g., 'Gmail' works, 'gmail' does not). Common providers include: Gmail, Yahoo, Microsoft Outlook, AOL, Apple Mail. Note: You can pass multiple providers by specifying this parameter multiple times in raw API calls.").optional()
+	}).describe("Request schema for `RetrieveEmailStatisticsByMailboxProvider`"),
+	output: z.unknown()
+});
+//#endregion
+export { sendgridRetrieveEmailStatisticsByMailboxProvider };
+
+//# sourceMappingURL=retrieve-email-statistics-by-mailbox-provider.mjs.map

package/dist/actions/retrieve-email-statistics-by-mailbox-provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-by-mailbox-provider.mjs","names":[],"sources":["../../src/actions/retrieve-email-statistics-by-mailbox-provider.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridRetrieveEmailStatisticsByMailboxProviderInput = z.object({\n  limit: z.number().int().describe(\"The number of results to return. Default is 500 (maximum per request). Use with offset for pagination.\").optional(),\n  offset: z.number().int().describe(\"The point in the list to begin retrieving results. Use with limit for pagination. Default is 0.\").optional(),\n  end_date: z.string().describe(\"The end date of the statistics to retrieve. Format: YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.\").optional(),\n  start_date: z.string().describe(\"The starting date of the statistics to retrieve (required). Format: YYYY-MM-DD (e.g., '2024-01-01'). Note: SendGrid only stores up to 7 days of mailbox provider statistics.\"),\n  aggregated_by: z.enum([\"day\", \"week\", \"month\"]).describe(\"Aggregation period for email statistics.\").optional(),\n  mailbox_providers: z.string().describe(\"The mailbox provider to filter statistics by (e.g., 'Gmail', 'Yahoo', 'Microsoft Outlook'). IMPORTANT: The first character must be capitalized (e.g., 'Gmail' works, 'gmail' does not). Common providers include: Gmail, Yahoo, Microsoft Outlook, AOL, Apple Mail. Note: You can pass multiple providers by specifying this parameter multiple times in raw API calls.\").optional(),\n}).describe(\"Request schema for `RetrieveEmailStatisticsByMailboxProvider`\");\nexport const SendgridRetrieveEmailStatisticsByMailboxProviderOutput = z.unknown();\n\nexport const sendgridRetrieveEmailStatisticsByMailboxProvider = action(\"SENDGRID_RETRIEVE_EMAIL_STATISTICS_BY_MAILBOX_PROVIDER\", {\n  slug: \"sendgrid-retrieve-email-statistics-by-mailbox-provider\",\n  name: \"Retrieve email statistics by mailbox provider\",\n  description: \"Retrieve email statistics segmented by recipient mailbox provider (e.g., Gmail, Yahoo, Microsoft Outlook). This endpoint is part of the Advanced Stats API and requires the 'stats.read' permission. Note: SendGrid only stores up to 7 days of mailbox provider statistics data. The response provides email delivery and engagement metrics grouped by date and mailbox provider, useful for understanding deliverability performance across different email service providers. Common mailbox providers include: Gmail, Yahoo, Microsoft Outlook (includes hotmail.com, outlook.com, live.com), AOL, and Apple Mail. SendGrid offers groupings for over 200 mailbox providers.\",\n  input: SendgridRetrieveEmailStatisticsByMailboxProviderInput,\n  output: SendgridRetrieveEmailStatisticsByMailboxProviderOutput,\n});\n"],"mappings":";;AAcA,MAAa,mDAAmD,OAAO,0DAA0D;CAC/H,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAdmE,EAAE,OAAO;EAC5E,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wGAAwG,CAAC,CAAC,SAAS;EACpJ,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,iGAAiG,CAAC,CAAC,SAAS;EAC9I,UAAU,EAAE,OAAO,CAAC,CAAC,SAAS,0HAA0H,CAAC,CAAC,SAAS;EACnK,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,8KAA8K;EAC9M,eAAe,EAAE,KAAK;GAAC;GAAO;GAAQ;EAAO,CAAC,CAAC,CAAC,SAAS,0CAA0C,CAAC,CAAC,SAAS;EAC9G,mBAAmB,EAAE,OAAO,CAAC,CAAC,SAAS,yWAAyW,CAAC,CAAC,SAAS;CAC7Z,CAAC,CAAC,CAAC,SAAS,+DAOH;CACP,QAPoE,EAAE,QAO9D;AACV,CAAC"}

package/dist/actions/retrieve-email-statistics-for-categories.cjs

@@ -0,0 +1,54 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/retrieve-email-statistics-for-categories.ts
+const SendgridRetrieveEmailStatisticsForCategoriesInput = zod.z.object({
+	limit: zod.z.number().int().describe("Maximum number of results to return per page. Default is 500.").optional(),
+	offset: zod.z.number().int().describe("Number of results to skip for pagination. Default is 0.").optional(),
+	end_date: zod.z.string().describe("The end date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.").optional(),
+	categories: zod.z.string().describe("The category name(s) to retrieve statistics for. For multiple categories, this can be a comma-separated list (e.g., 'marketing,transactional'). Maximum 10 categories per request."),
+	start_date: zod.z.string().describe("The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-01'). Category statistics are only available for the previous 13 months."),
+	aggregated_by: zod.z.enum([
+		"day",
+		"week",
+		"month"
+	]).describe("Aggregation period for email statistics.").optional()
+}).describe("Request schema for `RetrieveEmailStatisticsForCategories`\n\nRetrieves email statistics for specified categories within a date range.\nStatistics include metrics like delivered, opened, clicked, bounced, etc.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema = zod.z.object({
+	opens: zod.z.number().int().describe("The total number of times emails were opened.").nullable().optional(),
+	blocks: zod.z.number().int().describe("The number of emails that were not allowed to be delivered by ISPs.").nullable().optional(),
+	clicks: zod.z.number().int().describe("The number of links clicked in your emails.").nullable().optional(),
+	bounces: zod.z.number().int().describe("The number of emails that bounced instead of being delivered.").nullable().optional(),
+	deferred: zod.z.number().int().describe("The number of emails temporarily unable to be delivered.").nullable().optional(),
+	requests: zod.z.number().int().describe("The number of emails requested to be delivered.").nullable().optional(),
+	delivered: zod.z.number().int().describe("The number of emails confirmed as delivered to recipients.").nullable().optional(),
+	processed: zod.z.number().int().describe("The number of emails received and processed by SendGrid.").nullable().optional(),
+	bounce_drops: zod.z.number().int().describe("The number of emails dropped because of previous bounces.").nullable().optional(),
+	spam_reports: zod.z.number().int().describe("The number of recipients who marked emails as spam.").nullable().optional(),
+	unique_opens: zod.z.number().int().describe("The number of unique recipients who opened emails.").nullable().optional(),
+	unsubscribes: zod.z.number().int().describe("The number of recipients who unsubscribed.").nullable().optional(),
+	unique_clicks: zod.z.number().int().describe("The number of unique recipients who clicked links.").nullable().optional(),
+	invalid_emails: zod.z.number().int().describe("The number of recipients with malformed or invalid email addresses.").nullable().optional(),
+	spam_report_drops: zod.z.number().int().describe("The number of emails dropped due to prior spam reports.").nullable().optional(),
+	unsubscribe_drops: zod.z.number().int().describe("The number of emails dropped due to unsubscription.").nullable().optional()
+}).describe("Email statistics metrics for a category.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema = zod.z.object({
+	name: zod.z.string().describe("The name of the category.").nullable().optional(),
+	type: zod.z.string().describe("The type of stats - usually 'category'.").nullable().optional(),
+	metrics: SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema.nullable().optional()
+}).describe("Statistics for a single category on a specific date.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema = zod.z.object({
+	date: zod.z.string().describe("The date for these statistics in YYYY-MM-DD format.").nullable().optional(),
+	stats: zod.z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema).describe("List of category statistics for this date.").nullable().optional()
+}).describe("A single entry containing date and category stats.");
+const SendgridRetrieveEmailStatisticsForCategoriesOutput = zod.z.object({ data: zod.z.union([zod.z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema), zod.z.record(zod.z.string(), zod.z.unknown())]).nullable().optional() }).describe("Response schema for `RetrieveEmailStatisticsForCategories`\n\nReturns email statistics organized by date and category. Each entry\ncontains metrics like delivered, opened, clicked, bounced, etc.");
+const sendgridRetrieveEmailStatisticsForCategories = require_action.action("SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_CATEGORIES", {
+	slug: "sendgrid-retrieve-email-statistics-for-categories",
+	name: "Retrieve email statistics for categories",
+	description: "Retrieve email statistics for specific categories within a date range. This endpoint returns detailed email metrics (delivered, opens, clicks, bounces, spam reports, etc.) for the specified categories, grouped by date. **Use Cases:** - Monitor email performance for specific campaign categories - Compare statistics across different email categories - Track trends over time with day/week/month aggregation **Limitations:** - Category statistics are available for the previous 13 months only - Free plans: limited to 100 categories daily - Paid plans: limited to 1,000 categories daily - Maximum 10 categories per request **Required Scope:** `categories.stats.read`",
+	input: SendgridRetrieveEmailStatisticsForCategoriesInput,
+	output: SendgridRetrieveEmailStatisticsForCategoriesOutput
+});
+//#endregion
+exports.sendgridRetrieveEmailStatisticsForCategories = sendgridRetrieveEmailStatisticsForCategories;
+
+//# sourceMappingURL=retrieve-email-statistics-for-categories.cjs.map

package/dist/actions/retrieve-email-statistics-for-categories.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-categories.cjs","names":["z","action"],"sources":["../../src/actions/retrieve-email-statistics-for-categories.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridRetrieveEmailStatisticsForCategoriesInput = z.object({\n  limit: z.number().int().describe(\"Maximum number of results to return per page. Default is 500.\").optional(),\n  offset: z.number().int().describe(\"Number of results to skip for pagination. Default is 0.\").optional(),\n  end_date: z.string().describe(\"The end date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.\").optional(),\n  categories: z.string().describe(\"The category name(s) to retrieve statistics for. For multiple categories, this can be a comma-separated list (e.g., 'marketing,transactional'). Maximum 10 categories per request.\"),\n  start_date: z.string().describe(\"The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-01'). Category statistics are only available for the previous 13 months.\"),\n  aggregated_by: z.enum([\"day\", \"week\", \"month\"]).describe(\"Aggregation period for email statistics.\").optional(),\n}).describe(\"Request schema for `RetrieveEmailStatisticsForCategories`\\n\\nRetrieves email statistics for specified categories within a date range.\\nStatistics include metrics like delivered, opened, clicked, bounced, etc.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema = z.object({\n  opens: z.number().int().describe(\"The total number of times emails were opened.\").nullable().optional(),\n  blocks: z.number().int().describe(\"The number of emails that were not allowed to be delivered by ISPs.\").nullable().optional(),\n  clicks: z.number().int().describe(\"The number of links clicked in your emails.\").nullable().optional(),\n  bounces: z.number().int().describe(\"The number of emails that bounced instead of being delivered.\").nullable().optional(),\n  deferred: z.number().int().describe(\"The number of emails temporarily unable to be delivered.\").nullable().optional(),\n  requests: z.number().int().describe(\"The number of emails requested to be delivered.\").nullable().optional(),\n  delivered: z.number().int().describe(\"The number of emails confirmed as delivered to recipients.\").nullable().optional(),\n  processed: z.number().int().describe(\"The number of emails received and processed by SendGrid.\").nullable().optional(),\n  bounce_drops: z.number().int().describe(\"The number of emails dropped because of previous bounces.\").nullable().optional(),\n  spam_reports: z.number().int().describe(\"The number of recipients who marked emails as spam.\").nullable().optional(),\n  unique_opens: z.number().int().describe(\"The number of unique recipients who opened emails.\").nullable().optional(),\n  unsubscribes: z.number().int().describe(\"The number of recipients who unsubscribed.\").nullable().optional(),\n  unique_clicks: z.number().int().describe(\"The number of unique recipients who clicked links.\").nullable().optional(),\n  invalid_emails: z.number().int().describe(\"The number of recipients with malformed or invalid email addresses.\").nullable().optional(),\n  spam_report_drops: z.number().int().describe(\"The number of emails dropped due to prior spam reports.\").nullable().optional(),\n  unsubscribe_drops: z.number().int().describe(\"The number of emails dropped due to unsubscription.\").nullable().optional(),\n}).describe(\"Email statistics metrics for a category.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema = z.object({\n  name: z.string().describe(\"The name of the category.\").nullable().optional(),\n  type: z.string().describe(\"The type of stats - usually 'category'.\").nullable().optional(),\n  metrics: SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema.nullable().optional(),\n}).describe(\"Statistics for a single category on a specific date.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema = z.object({\n  date: z.string().describe(\"The date for these statistics in YYYY-MM-DD format.\").nullable().optional(),\n  stats: z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema).describe(\"List of category statistics for this date.\").nullable().optional(),\n}).describe(\"A single entry containing date and category stats.\");\nexport const SendgridRetrieveEmailStatisticsForCategoriesOutput = z.object({\n  data: z.union([z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema), z.record(z.string(), z.unknown())]).nullable().optional(),\n}).describe(\"Response schema for `RetrieveEmailStatisticsForCategories`\\n\\nReturns email statistics organized by date and category. Each entry\\ncontains metrics like delivered, opened, clicked, bounced, etc.\");\n\nexport const sendgridRetrieveEmailStatisticsForCategories = action(\"SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_CATEGORIES\", {\n  slug: \"sendgrid-retrieve-email-statistics-for-categories\",\n  name: \"Retrieve email statistics for categories\",\n  description: \"Retrieve email statistics for specific categories within a date range. This endpoint returns detailed email metrics (delivered, opens, clicks, bounces, spam reports, etc.) for the specified categories, grouped by date. **Use Cases:** - Monitor email performance for specific campaign categories - Compare statistics across different email categories - Track trends over time with day/week/month aggregation **Limitations:** - Category statistics are available for the previous 13 months only - Free plans: limited to 100 categories daily - Paid plans: limited to 1,000 categories daily - Maximum 10 categories per request **Required Scope:** `categories.stats.read`\",\n  input: SendgridRetrieveEmailStatisticsForCategoriesInput,\n  output: SendgridRetrieveEmailStatisticsForCategoriesOutput,\n});\n"],"mappings":"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"}

package/dist/actions/retrieve-email-statistics-for-categories.d.cts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+//#region src/actions/retrieve-email-statistics-for-categories.d.ts
+declare const SendgridRetrieveEmailStatisticsForCategoriesInput: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  end_date: z.ZodOptional<z.ZodString>;
+  categories: z.ZodString;
+  start_date: z.ZodString;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridRetrieveEmailStatisticsForCategoriesOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      metrics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        blocks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        deferred: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        processed: 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>>;
+        unsubscribe_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+}, z.core.$strip>;
+declare const sendgridRetrieveEmailStatisticsForCategories: import("@keystrokehq/action").WorkflowActionDefinition<{
+  categories: string;
+  start_date: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  end_date?: string | undefined;
+  aggregated_by?: "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridRetrieveEmailStatisticsForCategories };
+//# sourceMappingURL=retrieve-email-statistics-for-categories.d.cts.map

package/dist/actions/retrieve-email-statistics-for-categories.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-categories.d.cts","names":[],"sources":["../../src/actions/retrieve-email-statistics-for-categories.ts"],"mappings":";;;cAIa,iDAAA,EAAiD,CAAA,CAAA,SAAA;;;;;;;;;;;;cAmCjD,kDAAA,EAAkD,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAIlD,4CAAA,gCAA4C,wBAAA"}

package/dist/actions/retrieve-email-statistics-for-categories.d.mts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+//#region src/actions/retrieve-email-statistics-for-categories.d.ts
+declare const SendgridRetrieveEmailStatisticsForCategoriesInput: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  end_date: z.ZodOptional<z.ZodString>;
+  categories: z.ZodString;
+  start_date: z.ZodString;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridRetrieveEmailStatisticsForCategoriesOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      metrics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        blocks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        deferred: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        processed: 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>>;
+        unsubscribe_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+}, z.core.$strip>;
+declare const sendgridRetrieveEmailStatisticsForCategories: import("@keystrokehq/action").WorkflowActionDefinition<{
+  categories: string;
+  start_date: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  end_date?: string | undefined;
+  aggregated_by?: "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridRetrieveEmailStatisticsForCategories };
+//# sourceMappingURL=retrieve-email-statistics-for-categories.d.mts.map

package/dist/actions/retrieve-email-statistics-for-categories.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-categories.d.mts","names":[],"sources":["../../src/actions/retrieve-email-statistics-for-categories.ts"],"mappings":";;;cAIa,iDAAA,EAAiD,CAAA,CAAA,SAAA;;;;;;;;;;;;cAmCjD,kDAAA,EAAkD,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAIlD,4CAAA,gCAA4C,wBAAA"}

package/dist/actions/retrieve-email-statistics-for-categories.mjs

@@ -0,0 +1,53 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/retrieve-email-statistics-for-categories.ts
+const SendgridRetrieveEmailStatisticsForCategoriesInput = z.object({
+	limit: z.number().int().describe("Maximum number of results to return per page. Default is 500.").optional(),
+	offset: z.number().int().describe("Number of results to skip for pagination. Default is 0.").optional(),
+	end_date: z.string().describe("The end date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.").optional(),
+	categories: z.string().describe("The category name(s) to retrieve statistics for. For multiple categories, this can be a comma-separated list (e.g., 'marketing,transactional'). Maximum 10 categories per request."),
+	start_date: z.string().describe("The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-01'). Category statistics are only available for the previous 13 months."),
+	aggregated_by: z.enum([
+		"day",
+		"week",
+		"month"
+	]).describe("Aggregation period for email statistics.").optional()
+}).describe("Request schema for `RetrieveEmailStatisticsForCategories`\n\nRetrieves email statistics for specified categories within a date range.\nStatistics include metrics like delivered, opened, clicked, bounced, etc.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema = z.object({
+	opens: z.number().int().describe("The total number of times emails were opened.").nullable().optional(),
+	blocks: z.number().int().describe("The number of emails that were not allowed to be delivered by ISPs.").nullable().optional(),
+	clicks: z.number().int().describe("The number of links clicked in your emails.").nullable().optional(),
+	bounces: z.number().int().describe("The number of emails that bounced instead of being delivered.").nullable().optional(),
+	deferred: z.number().int().describe("The number of emails temporarily unable to be delivered.").nullable().optional(),
+	requests: z.number().int().describe("The number of emails requested to be delivered.").nullable().optional(),
+	delivered: z.number().int().describe("The number of emails confirmed as delivered to recipients.").nullable().optional(),
+	processed: z.number().int().describe("The number of emails received and processed by SendGrid.").nullable().optional(),
+	bounce_drops: z.number().int().describe("The number of emails dropped because of previous bounces.").nullable().optional(),
+	spam_reports: z.number().int().describe("The number of recipients who marked emails as spam.").nullable().optional(),
+	unique_opens: z.number().int().describe("The number of unique recipients who opened emails.").nullable().optional(),
+	unsubscribes: z.number().int().describe("The number of recipients who unsubscribed.").nullable().optional(),
+	unique_clicks: z.number().int().describe("The number of unique recipients who clicked links.").nullable().optional(),
+	invalid_emails: z.number().int().describe("The number of recipients with malformed or invalid email addresses.").nullable().optional(),
+	spam_report_drops: z.number().int().describe("The number of emails dropped due to prior spam reports.").nullable().optional(),
+	unsubscribe_drops: z.number().int().describe("The number of emails dropped due to unsubscription.").nullable().optional()
+}).describe("Email statistics metrics for a category.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema = z.object({
+	name: z.string().describe("The name of the category.").nullable().optional(),
+	type: z.string().describe("The type of stats - usually 'category'.").nullable().optional(),
+	metrics: SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema.nullable().optional()
+}).describe("Statistics for a single category on a specific date.");
+const SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema = z.object({
+	date: z.string().describe("The date for these statistics in YYYY-MM-DD format.").nullable().optional(),
+	stats: z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema).describe("List of category statistics for this date.").nullable().optional()
+}).describe("A single entry containing date and category stats.");
+const sendgridRetrieveEmailStatisticsForCategories = action("SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_CATEGORIES", {
+	slug: "sendgrid-retrieve-email-statistics-for-categories",
+	name: "Retrieve email statistics for categories",
+	description: "Retrieve email statistics for specific categories within a date range. This endpoint returns detailed email metrics (delivered, opens, clicks, bounces, spam reports, etc.) for the specified categories, grouped by date. **Use Cases:** - Monitor email performance for specific campaign categories - Compare statistics across different email categories - Track trends over time with day/week/month aggregation **Limitations:** - Category statistics are available for the previous 13 months only - Free plans: limited to 100 categories daily - Paid plans: limited to 1,000 categories daily - Maximum 10 categories per request **Required Scope:** `categories.stats.read`",
+	input: SendgridRetrieveEmailStatisticsForCategoriesInput,
+	output: z.object({ data: z.union([z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema), z.record(z.string(), z.unknown())]).nullable().optional() }).describe("Response schema for `RetrieveEmailStatisticsForCategories`\n\nReturns email statistics organized by date and category. Each entry\ncontains metrics like delivered, opened, clicked, bounced, etc.")
+});
+//#endregion
+export { sendgridRetrieveEmailStatisticsForCategories };
+
+//# sourceMappingURL=retrieve-email-statistics-for-categories.mjs.map

package/dist/actions/retrieve-email-statistics-for-categories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-categories.mjs","names":[],"sources":["../../src/actions/retrieve-email-statistics-for-categories.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridRetrieveEmailStatisticsForCategoriesInput = z.object({\n  limit: z.number().int().describe(\"Maximum number of results to return per page. Default is 500.\").optional(),\n  offset: z.number().int().describe(\"Number of results to skip for pagination. Default is 0.\").optional(),\n  end_date: z.string().describe(\"The end date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-31'). Defaults to today if not specified.\").optional(),\n  categories: z.string().describe(\"The category name(s) to retrieve statistics for. For multiple categories, this can be a comma-separated list (e.g., 'marketing,transactional'). Maximum 10 categories per request.\"),\n  start_date: z.string().describe(\"The starting date of the statistics to retrieve. Must follow format YYYY-MM-DD (e.g., '2024-01-01'). Category statistics are only available for the previous 13 months.\"),\n  aggregated_by: z.enum([\"day\", \"week\", \"month\"]).describe(\"Aggregation period for email statistics.\").optional(),\n}).describe(\"Request schema for `RetrieveEmailStatisticsForCategories`\\n\\nRetrieves email statistics for specified categories within a date range.\\nStatistics include metrics like delivered, opened, clicked, bounced, etc.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema = z.object({\n  opens: z.number().int().describe(\"The total number of times emails were opened.\").nullable().optional(),\n  blocks: z.number().int().describe(\"The number of emails that were not allowed to be delivered by ISPs.\").nullable().optional(),\n  clicks: z.number().int().describe(\"The number of links clicked in your emails.\").nullable().optional(),\n  bounces: z.number().int().describe(\"The number of emails that bounced instead of being delivered.\").nullable().optional(),\n  deferred: z.number().int().describe(\"The number of emails temporarily unable to be delivered.\").nullable().optional(),\n  requests: z.number().int().describe(\"The number of emails requested to be delivered.\").nullable().optional(),\n  delivered: z.number().int().describe(\"The number of emails confirmed as delivered to recipients.\").nullable().optional(),\n  processed: z.number().int().describe(\"The number of emails received and processed by SendGrid.\").nullable().optional(),\n  bounce_drops: z.number().int().describe(\"The number of emails dropped because of previous bounces.\").nullable().optional(),\n  spam_reports: z.number().int().describe(\"The number of recipients who marked emails as spam.\").nullable().optional(),\n  unique_opens: z.number().int().describe(\"The number of unique recipients who opened emails.\").nullable().optional(),\n  unsubscribes: z.number().int().describe(\"The number of recipients who unsubscribed.\").nullable().optional(),\n  unique_clicks: z.number().int().describe(\"The number of unique recipients who clicked links.\").nullable().optional(),\n  invalid_emails: z.number().int().describe(\"The number of recipients with malformed or invalid email addresses.\").nullable().optional(),\n  spam_report_drops: z.number().int().describe(\"The number of emails dropped due to prior spam reports.\").nullable().optional(),\n  unsubscribe_drops: z.number().int().describe(\"The number of emails dropped due to unsubscription.\").nullable().optional(),\n}).describe(\"Email statistics metrics for a category.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema = z.object({\n  name: z.string().describe(\"The name of the category.\").nullable().optional(),\n  type: z.string().describe(\"The type of stats - usually 'category'.\").nullable().optional(),\n  metrics: SendgridRetrieveEmailStatisticsForCategories_CategoryStatMetricsSchema.nullable().optional(),\n}).describe(\"Statistics for a single category on a specific date.\");\nconst SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema = z.object({\n  date: z.string().describe(\"The date for these statistics in YYYY-MM-DD format.\").nullable().optional(),\n  stats: z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatItemSchema).describe(\"List of category statistics for this date.\").nullable().optional(),\n}).describe(\"A single entry containing date and category stats.\");\nexport const SendgridRetrieveEmailStatisticsForCategoriesOutput = z.object({\n  data: z.union([z.array(SendgridRetrieveEmailStatisticsForCategories_CategoryStatEntrySchema), z.record(z.string(), z.unknown())]).nullable().optional(),\n}).describe(\"Response schema for `RetrieveEmailStatisticsForCategories`\\n\\nReturns email statistics organized by date and category. Each entry\\ncontains metrics like delivered, opened, clicked, bounced, etc.\");\n\nexport const sendgridRetrieveEmailStatisticsForCategories = action(\"SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_CATEGORIES\", {\n  slug: \"sendgrid-retrieve-email-statistics-for-categories\",\n  name: \"Retrieve email statistics for categories\",\n  description: \"Retrieve email statistics for specific categories within a date range. This endpoint returns detailed email metrics (delivered, opens, clicks, bounces, spam reports, etc.) for the specified categories, grouped by date. **Use Cases:** - Monitor email performance for specific campaign categories - Compare statistics across different email categories - Track trends over time with day/week/month aggregation **Limitations:** - Category statistics are available for the previous 13 months only - Free plans: limited to 100 categories daily - Paid plans: limited to 1,000 categories daily - Maximum 10 categories per request **Required Scope:** `categories.stats.read`\",\n  input: SendgridRetrieveEmailStatisticsForCategoriesInput,\n  output: SendgridRetrieveEmailStatisticsForCategoriesOutput,\n});\n"],"mappings":"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"}

package/dist/actions/retrieve-email-statistics-for-your-subusers.cjs

@@ -0,0 +1,54 @@
+const require_action = require("../action.cjs");
+let zod = require("zod");
+//#region src/actions/retrieve-email-statistics-for-your-subusers.ts
+const SendgridRetrieveEmailStatisticsForYourSubusersInput = zod.z.object({
+	limit: zod.z.number().int().describe("Maximum number of results to return per page. Use with 'offset' for pagination through large result sets.").optional(),
+	offset: zod.z.number().int().describe("The starting index for pagination. Use with 'limit' to page through results. Example: offset=10, limit=10 returns results 11-20.").optional(),
+	end_date: zod.z.string().describe("The end date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-31'. Defaults to today if not specified.").optional(),
+	subusers: zod.z.string().describe("The username of the subuser to retrieve statistics for. Example: 'my_subuser'. Note: To retrieve statistics for multiple subusers (up to 10), make separate API calls for each subuser."),
+	start_date: zod.z.string().describe("The starting date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-01'. Statistics are available for the last 3 years."),
+	aggregated_by: zod.z.enum([
+		"day",
+		"week",
+		"month"
+	]).describe("Aggregation period for statistics grouping.").optional()
+}).describe("Request schema for `RetrieveEmailStatisticsForYourSubusers`");
+const SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema = zod.z.object({
+	opens: zod.z.number().int().describe("Total number of email opens (including repeat opens).").nullable().optional(),
+	blocks: zod.z.number().int().describe("Number of emails blocked by receiving servers.").nullable().optional(),
+	clicks: zod.z.number().int().describe("Total number of link clicks in emails.").nullable().optional(),
+	bounces: zod.z.number().int().describe("Number of emails that bounced (hard and soft bounces).").nullable().optional(),
+	deferred: zod.z.number().int().describe("Number of emails temporarily deferred by receiving servers.").nullable().optional(),
+	requests: zod.z.number().int().describe("Number of email send requests received by SendGrid.").nullable().optional(),
+	delivered: zod.z.number().int().describe("Number of emails successfully delivered to recipients.").nullable().optional(),
+	processed: zod.z.number().int().describe("Number of emails processed by SendGrid.").nullable().optional(),
+	bounce_drops: zod.z.number().int().describe("Number of emails dropped due to previous bounces.").nullable().optional(),
+	spam_reports: zod.z.number().int().describe("Number of emails reported as spam by recipients.").nullable().optional(),
+	unique_opens: zod.z.number().int().describe("Number of unique recipients who opened the email.").nullable().optional(),
+	unsubscribes: zod.z.number().int().describe("Number of recipients who unsubscribed.").nullable().optional(),
+	unique_clicks: zod.z.number().int().describe("Number of unique recipients who clicked a link.").nullable().optional(),
+	invalid_emails: zod.z.number().int().describe("Number of emails sent to invalid addresses.").nullable().optional(),
+	spam_report_drops: zod.z.number().int().describe("Number of emails dropped due to previous spam reports.").nullable().optional(),
+	unsubscribe_drops: zod.z.number().int().describe("Number of emails dropped due to previous unsubscribes.").nullable().optional()
+}).describe("Email statistics metrics for a specific time period.");
+const SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema = zod.z.object({
+	name: zod.z.string().describe("The username of the subuser.").nullable().optional(),
+	type: zod.z.string().describe("The type of entity (usually 'subuser').").nullable().optional(),
+	metrics: SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema.nullable().optional()
+}).describe("Statistics entry for a specific subuser.");
+const SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema = zod.z.object({
+	date: zod.z.string().describe("The date of the statistics in YYYY-MM-DD format.").nullable().optional(),
+	stats: zod.z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema).describe("List of statistics entries for each subuser on this date.").nullable().optional()
+}).describe("Statistics for a specific date.");
+const SendgridRetrieveEmailStatisticsForYourSubusersOutput = zod.z.object({ data: zod.z.union([zod.z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema), zod.z.record(zod.z.string(), zod.z.unknown())]).nullable().optional() }).describe("Response schema for `RetrieveEmailStatisticsForYourSubusers`");
+const sendgridRetrieveEmailStatisticsForYourSubusers = require_action.action("SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_YOUR_SUBUSERS", {
+	slug: "sendgrid-retrieve-email-statistics-for-your-subusers",
+	name: "Retrieve email statistics for your subusers",
+	description: "Retrieves email statistics for specified subusers over a date range. Returns metrics including: blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, unsubscribes, and more. **Requirements:** - SendGrid Pro plan or higher with subusers configured - API key with `subusers.stats.read` scope **Usage Notes:** - Statistics are available for the last 3 years - Use `aggregated_by` to group results by day, week, or month - Results can be paginated using `limit` and `offset` parameters",
+	input: SendgridRetrieveEmailStatisticsForYourSubusersInput,
+	output: SendgridRetrieveEmailStatisticsForYourSubusersOutput
+});
+//#endregion
+exports.sendgridRetrieveEmailStatisticsForYourSubusers = sendgridRetrieveEmailStatisticsForYourSubusers;
+
+//# sourceMappingURL=retrieve-email-statistics-for-your-subusers.cjs.map

package/dist/actions/retrieve-email-statistics-for-your-subusers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-your-subusers.cjs","names":["z","action"],"sources":["../../src/actions/retrieve-email-statistics-for-your-subusers.ts"],"sourcesContent":["import { z } from \"zod\";\n\nimport { action } from \"../action\";\n\nexport const SendgridRetrieveEmailStatisticsForYourSubusersInput = z.object({\n  limit: z.number().int().describe(\"Maximum number of results to return per page. Use with 'offset' for pagination through large result sets.\").optional(),\n  offset: z.number().int().describe(\"The starting index for pagination. Use with 'limit' to page through results. Example: offset=10, limit=10 returns results 11-20.\").optional(),\n  end_date: z.string().describe(\"The end date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-31'. Defaults to today if not specified.\").optional(),\n  subusers: z.string().describe(\"The username of the subuser to retrieve statistics for. Example: 'my_subuser'. Note: To retrieve statistics for multiple subusers (up to 10), make separate API calls for each subuser.\"),\n  start_date: z.string().describe(\"The starting date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-01'. Statistics are available for the last 3 years.\"),\n  aggregated_by: z.enum([\"day\", \"week\", \"month\"]).describe(\"Aggregation period for statistics grouping.\").optional(),\n}).describe(\"Request schema for `RetrieveEmailStatisticsForYourSubusers`\");\nconst SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema = z.object({\n  opens: z.number().int().describe(\"Total number of email opens (including repeat opens).\").nullable().optional(),\n  blocks: z.number().int().describe(\"Number of emails blocked by receiving servers.\").nullable().optional(),\n  clicks: z.number().int().describe(\"Total number of link clicks in emails.\").nullable().optional(),\n  bounces: z.number().int().describe(\"Number of emails that bounced (hard and soft bounces).\").nullable().optional(),\n  deferred: z.number().int().describe(\"Number of emails temporarily deferred by receiving servers.\").nullable().optional(),\n  requests: z.number().int().describe(\"Number of email send requests received by SendGrid.\").nullable().optional(),\n  delivered: z.number().int().describe(\"Number of emails successfully delivered to recipients.\").nullable().optional(),\n  processed: z.number().int().describe(\"Number of emails processed by SendGrid.\").nullable().optional(),\n  bounce_drops: z.number().int().describe(\"Number of emails dropped due to previous bounces.\").nullable().optional(),\n  spam_reports: z.number().int().describe(\"Number of emails reported as spam by recipients.\").nullable().optional(),\n  unique_opens: z.number().int().describe(\"Number of unique recipients who opened the email.\").nullable().optional(),\n  unsubscribes: z.number().int().describe(\"Number of recipients who unsubscribed.\").nullable().optional(),\n  unique_clicks: z.number().int().describe(\"Number of unique recipients who clicked a link.\").nullable().optional(),\n  invalid_emails: z.number().int().describe(\"Number of emails sent to invalid addresses.\").nullable().optional(),\n  spam_report_drops: z.number().int().describe(\"Number of emails dropped due to previous spam reports.\").nullable().optional(),\n  unsubscribe_drops: z.number().int().describe(\"Number of emails dropped due to previous unsubscribes.\").nullable().optional(),\n}).describe(\"Email statistics metrics for a specific time period.\");\nconst SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema = z.object({\n  name: z.string().describe(\"The username of the subuser.\").nullable().optional(),\n  type: z.string().describe(\"The type of entity (usually 'subuser').\").nullable().optional(),\n  metrics: SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema.nullable().optional(),\n}).describe(\"Statistics entry for a specific subuser.\");\nconst SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema = z.object({\n  date: z.string().describe(\"The date of the statistics in YYYY-MM-DD format.\").nullable().optional(),\n  stats: z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema).describe(\"List of statistics entries for each subuser on this date.\").nullable().optional(),\n}).describe(\"Statistics for a specific date.\");\nexport const SendgridRetrieveEmailStatisticsForYourSubusersOutput = z.object({\n  data: z.union([z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema), z.record(z.string(), z.unknown())]).nullable().optional(),\n}).describe(\"Response schema for `RetrieveEmailStatisticsForYourSubusers`\");\n\nexport const sendgridRetrieveEmailStatisticsForYourSubusers = action(\"SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_YOUR_SUBUSERS\", {\n  slug: \"sendgrid-retrieve-email-statistics-for-your-subusers\",\n  name: \"Retrieve email statistics for your subusers\",\n  description: \"Retrieves email statistics for specified subusers over a date range. Returns metrics including: blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, unsubscribes, and more. **Requirements:** - SendGrid Pro plan or higher with subusers configured - API key with `subusers.stats.read` scope **Usage Notes:** - Statistics are available for the last 3 years - Use `aggregated_by` to group results by day, week, or month - Results can be paginated using `limit` and `offset` parameters\",\n  input: SendgridRetrieveEmailStatisticsForYourSubusersInput,\n  output: SendgridRetrieveEmailStatisticsForYourSubusersOutput,\n});\n"],"mappings":";;;AAIA,MAAa,sDAAsDA,IAAAA,EAAE,OAAO;CAC1E,OAAOA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,2GAA2G,CAAC,CAAC,SAAS;CACvJ,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,kIAAkI,CAAC,CAAC,SAAS;CAC/K,UAAUA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,sIAAsI,CAAC,CAAC,SAAS;CAC/K,UAAUA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,yLAAyL;CACvN,YAAYA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,sJAAsJ;CACtL,eAAeA,IAAAA,EAAE,KAAK;EAAC;EAAO;EAAQ;CAAO,CAAC,CAAC,CAAC,SAAS,6CAA6C,CAAC,CAAC,SAAS;AACnH,CAAC,CAAC,CAAC,SAAS,6DAA6D;AACzE,MAAM,oEAAoEA,IAAAA,EAAE,OAAO;CACjF,OAAOA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,uDAAuD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC9G,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,gDAAgD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACxG,QAAQA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wCAAwC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAChG,SAASA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wDAAwD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjH,UAAUA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,6DAA6D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACvH,UAAUA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,qDAAqD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC/G,WAAWA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wDAAwD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACnH,WAAWA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,yCAAyC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACpG,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,mDAAmD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjH,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,kDAAkD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAChH,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,mDAAmD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACjH,cAAcA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wCAAwC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACtG,eAAeA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,iDAAiD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAChH,gBAAgBA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,6CAA6C,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC7G,mBAAmBA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wDAAwD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC3H,mBAAmBA,IAAAA,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,wDAAwD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AAC7H,CAAC,CAAC,CAAC,SAAS,sDAAsD;AAClE,MAAM,yEAAyEA,IAAAA,EAAE,OAAO;CACtF,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,8BAA8B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAC9E,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,yCAAyC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CACzF,SAAS,kEAAkE,SAAS,CAAC,CAAC,SAAS;AACjG,CAAC,CAAC,CAAC,SAAS,0CAA0C;AACtD,MAAM,0EAA0EA,IAAAA,EAAE,OAAO;CACvF,MAAMA,IAAAA,EAAE,OAAO,CAAC,CAAC,SAAS,kDAAkD,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;CAClG,OAAOA,IAAAA,EAAE,MAAM,sEAAsE,CAAC,CAAC,SAAS,2DAA2D,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;AACnL,CAAC,CAAC,CAAC,SAAS,iCAAiC;AAC7C,MAAa,uDAAuDA,IAAAA,EAAE,OAAO,EAC3E,MAAMA,IAAAA,EAAE,MAAM,CAACA,IAAAA,EAAE,MAAM,uEAAuE,GAAGA,IAAAA,EAAE,OAAOA,IAAAA,EAAE,OAAO,GAAGA,IAAAA,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAC3J,CAAC,CAAC,CAAC,SAAS,8DAA8D;AAE1E,MAAa,iDAAiDC,eAAAA,OAAO,wDAAwD;CAC3H,MAAM;CACN,MAAM;CACN,aAAa;CACb,OAAO;CACP,QAAQ;AACV,CAAC"}

package/dist/actions/retrieve-email-statistics-for-your-subusers.d.cts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+//#region src/actions/retrieve-email-statistics-for-your-subusers.d.ts
+declare const SendgridRetrieveEmailStatisticsForYourSubusersInput: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  end_date: z.ZodOptional<z.ZodString>;
+  subusers: z.ZodString;
+  start_date: z.ZodString;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridRetrieveEmailStatisticsForYourSubusersOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      metrics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        blocks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        deferred: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        processed: 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>>;
+        unsubscribe_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+}, z.core.$strip>;
+declare const sendgridRetrieveEmailStatisticsForYourSubusers: import("@keystrokehq/action").WorkflowActionDefinition<{
+  subusers: string;
+  start_date: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  end_date?: string | undefined;
+  aggregated_by?: "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridRetrieveEmailStatisticsForYourSubusers };
+//# sourceMappingURL=retrieve-email-statistics-for-your-subusers.d.cts.map

package/dist/actions/retrieve-email-statistics-for-your-subusers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-your-subusers.d.cts","names":[],"sources":["../../src/actions/retrieve-email-statistics-for-your-subusers.ts"],"mappings":";;;cAIa,mDAAA,EAAmD,CAAA,CAAA,SAAA;;;;;;;;;;;;cAmCnD,oDAAA,EAAoD,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAIpD,8CAAA,gCAA8C,wBAAA"}

package/dist/actions/retrieve-email-statistics-for-your-subusers.d.mts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+
+//#region src/actions/retrieve-email-statistics-for-your-subusers.d.ts
+declare const SendgridRetrieveEmailStatisticsForYourSubusersInput: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  offset: z.ZodOptional<z.ZodNumber>;
+  end_date: z.ZodOptional<z.ZodString>;
+  subusers: z.ZodString;
+  start_date: z.ZodString;
+  aggregated_by: z.ZodOptional<z.ZodEnum<{
+    day: "day";
+    week: "week";
+    month: "month";
+  }>>;
+}, z.core.$strip>;
+declare const SendgridRetrieveEmailStatisticsForYourSubusersOutput: z.ZodObject<{
+  data: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    stats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      metrics: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        opens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        blocks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        clicks: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        bounces: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        deferred: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        requests: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        delivered: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        processed: 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>>;
+        unsubscribe_drops: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
+  }, z.core.$strip>>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>>;
+}, z.core.$strip>;
+declare const sendgridRetrieveEmailStatisticsForYourSubusers: import("@keystrokehq/action").WorkflowActionDefinition<{
+  subusers: string;
+  start_date: string;
+  limit?: number | undefined;
+  offset?: number | undefined;
+  end_date?: string | undefined;
+  aggregated_by?: "day" | "week" | "month" | undefined;
+}, unknown, import("@keystrokehq/shared").ResolvedCredentials<readonly [import("@keystrokehq/shared").Credential]>, readonly [import("@keystrokehq/shared").Credential]>;
+//#endregion
+export { sendgridRetrieveEmailStatisticsForYourSubusers };
+//# sourceMappingURL=retrieve-email-statistics-for-your-subusers.d.mts.map

package/dist/actions/retrieve-email-statistics-for-your-subusers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve-email-statistics-for-your-subusers.d.mts","names":[],"sources":["../../src/actions/retrieve-email-statistics-for-your-subusers.ts"],"mappings":";;;cAIa,mDAAA,EAAmD,CAAA,CAAA,SAAA;;;;;;;;;;;;cAmCnD,oDAAA,EAAoD,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAIpD,8CAAA,gCAA8C,wBAAA"}

package/dist/actions/retrieve-email-statistics-for-your-subusers.mjs

@@ -0,0 +1,53 @@
+import { action } from "../action.mjs";
+import { z } from "zod";
+//#region src/actions/retrieve-email-statistics-for-your-subusers.ts
+const SendgridRetrieveEmailStatisticsForYourSubusersInput = z.object({
+	limit: z.number().int().describe("Maximum number of results to return per page. Use with 'offset' for pagination through large result sets.").optional(),
+	offset: z.number().int().describe("The starting index for pagination. Use with 'limit' to page through results. Example: offset=10, limit=10 returns results 11-20.").optional(),
+	end_date: z.string().describe("The end date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-31'. Defaults to today if not specified.").optional(),
+	subusers: z.string().describe("The username of the subuser to retrieve statistics for. Example: 'my_subuser'. Note: To retrieve statistics for multiple subusers (up to 10), make separate API calls for each subuser."),
+	start_date: z.string().describe("The starting date of the statistics to retrieve. Must be in YYYY-MM-DD format. Example: '2024-01-01'. Statistics are available for the last 3 years."),
+	aggregated_by: z.enum([
+		"day",
+		"week",
+		"month"
+	]).describe("Aggregation period for statistics grouping.").optional()
+}).describe("Request schema for `RetrieveEmailStatisticsForYourSubusers`");
+const SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema = z.object({
+	opens: z.number().int().describe("Total number of email opens (including repeat opens).").nullable().optional(),
+	blocks: z.number().int().describe("Number of emails blocked by receiving servers.").nullable().optional(),
+	clicks: z.number().int().describe("Total number of link clicks in emails.").nullable().optional(),
+	bounces: z.number().int().describe("Number of emails that bounced (hard and soft bounces).").nullable().optional(),
+	deferred: z.number().int().describe("Number of emails temporarily deferred by receiving servers.").nullable().optional(),
+	requests: z.number().int().describe("Number of email send requests received by SendGrid.").nullable().optional(),
+	delivered: z.number().int().describe("Number of emails successfully delivered to recipients.").nullable().optional(),
+	processed: z.number().int().describe("Number of emails processed by SendGrid.").nullable().optional(),
+	bounce_drops: z.number().int().describe("Number of emails dropped due to previous bounces.").nullable().optional(),
+	spam_reports: z.number().int().describe("Number of emails reported as spam by recipients.").nullable().optional(),
+	unique_opens: z.number().int().describe("Number of unique recipients who opened the email.").nullable().optional(),
+	unsubscribes: z.number().int().describe("Number of recipients who unsubscribed.").nullable().optional(),
+	unique_clicks: z.number().int().describe("Number of unique recipients who clicked a link.").nullable().optional(),
+	invalid_emails: z.number().int().describe("Number of emails sent to invalid addresses.").nullable().optional(),
+	spam_report_drops: z.number().int().describe("Number of emails dropped due to previous spam reports.").nullable().optional(),
+	unsubscribe_drops: z.number().int().describe("Number of emails dropped due to previous unsubscribes.").nullable().optional()
+}).describe("Email statistics metrics for a specific time period.");
+const SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema = z.object({
+	name: z.string().describe("The username of the subuser.").nullable().optional(),
+	type: z.string().describe("The type of entity (usually 'subuser').").nullable().optional(),
+	metrics: SendgridRetrieveEmailStatisticsForYourSubusers_StatsMetricsSchema.nullable().optional()
+}).describe("Statistics entry for a specific subuser.");
+const SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema = z.object({
+	date: z.string().describe("The date of the statistics in YYYY-MM-DD format.").nullable().optional(),
+	stats: z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsEntrySchema).describe("List of statistics entries for each subuser on this date.").nullable().optional()
+}).describe("Statistics for a specific date.");
+const sendgridRetrieveEmailStatisticsForYourSubusers = action("SENDGRID_RETRIEVE_EMAIL_STATISTICS_FOR_YOUR_SUBUSERS", {
+	slug: "sendgrid-retrieve-email-statistics-for-your-subusers",
+	name: "Retrieve email statistics for your subusers",
+	description: "Retrieves email statistics for specified subusers over a date range. Returns metrics including: blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, unsubscribes, and more. **Requirements:** - SendGrid Pro plan or higher with subusers configured - API key with `subusers.stats.read` scope **Usage Notes:** - Statistics are available for the last 3 years - Use `aggregated_by` to group results by day, week, or month - Results can be paginated using `limit` and `offset` parameters",
+	input: SendgridRetrieveEmailStatisticsForYourSubusersInput,
+	output: z.object({ data: z.union([z.array(SendgridRetrieveEmailStatisticsForYourSubusers_SubuserStatsByDateSchema), z.record(z.string(), z.unknown())]).nullable().optional() }).describe("Response schema for `RetrieveEmailStatisticsForYourSubusers`")
+});
+//#endregion
+export { sendgridRetrieveEmailStatisticsForYourSubusers };
+
+//# sourceMappingURL=retrieve-email-statistics-for-your-subusers.mjs.map