@keystrokehq/resend 0.0.1

package/dist/broadcasts.mjs

@@ -0,0 +1,178 @@
+import { createResendClient } from "./client.mjs";
+import { paginationQuerySchema, resendListEnvelope } from "./schemas.mjs";
+import { t as resendOperation } from "./factory-B3VyPRsL.mjs";
+import { z } from "zod";
+
+//#region src/broadcasts.ts
+/**
+* resend/broadcasts.ts
+*
+* Operations backing the Resend `/broadcasts` endpoints.
+* PLAN.md § 6.5: 6 operations (create, list, get, update, send, delete).
+*
+* Broadcasts send against a Segment (or legacy Audience) and support an
+* optional `scheduled_at`. The public API exposes the draft → send
+* lifecycle; preview and test-send live in the dashboard, not the API.
+*/
+const broadcastStatusSchema = z.enum([
+	"draft",
+	"scheduled",
+	"queued",
+	"sending",
+	"sent",
+	"cancelled",
+	"failed"
+]).or(z.string());
+const broadcastSummarySchema = z.object({
+	id: z.string(),
+	name: z.string().optional(),
+	status: broadcastStatusSchema.optional(),
+	audience_id: z.string().optional().nullable(),
+	segment_id: z.string().optional().nullable(),
+	created_at: z.string().optional(),
+	updated_at: z.string().optional(),
+	scheduled_at: z.string().optional().nullable(),
+	sent_at: z.string().optional().nullable()
+}).passthrough();
+const broadcastDetailSchema = broadcastSummarySchema.extend({
+	from: z.string().optional(),
+	subject: z.string().optional(),
+	reply_to: z.union([z.string(), z.array(z.string())]).optional(),
+	preview_text: z.string().optional().nullable(),
+	html: z.string().optional().nullable(),
+	text: z.string().optional().nullable()
+}).passthrough();
+const listBroadcastsResponseSchema = resendListEnvelope(broadcastSummarySchema);
+const broadcastCreateInputSchema = z.object({
+	name: z.string().optional(),
+	from: z.string().optional(),
+	subject: z.string().optional(),
+	reply_to: z.union([z.string(), z.array(z.string())]).optional(),
+	preview_text: z.string().optional(),
+	html: z.string().optional(),
+	text: z.string().optional(),
+	template: z.object({
+		id: z.string().min(1),
+		variables: z.record(z.string(), z.union([z.string(), z.number()])).optional()
+	}).optional(),
+	audience_id: z.string().optional(),
+	segment_id: z.string().optional(),
+	scheduled_at: z.string().optional()
+}).refine((b) => b.audience_id !== void 0 || b.segment_id !== void 0, { message: "Broadcast requires either `segment_id` or `audience_id`." });
+const createBroadcast = resendOperation({
+	id: "create_resend_broadcast",
+	name: "Create Resend Broadcast",
+	description: "Create a draft broadcast targeting a segment (or legacy audience).",
+	input: broadcastCreateInputSchema,
+	output: broadcastDetailSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "POST",
+			path: "/broadcasts",
+			body: input
+		});
+	}
+});
+const listBroadcasts = resendOperation({
+	id: "list_resend_broadcasts",
+	name: "List Resend Broadcasts",
+	description: "List broadcasts, optionally cursor-paginated.",
+	input: paginationQuerySchema,
+	output: listBroadcastsResponseSchema,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "GET",
+			path: "/broadcasts",
+			query: input
+		});
+	}
+});
+const retrieveBroadcast = resendOperation({
+	id: "retrieve_resend_broadcast",
+	name: "Retrieve Resend Broadcast",
+	description: "Retrieve a single broadcast by id.",
+	input: z.object({ id: z.string().min(1) }),
+	output: broadcastDetailSchema,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "GET",
+			path: `/broadcasts/${encodeURIComponent(input.id)}`
+		});
+	}
+});
+const updateBroadcast = resendOperation({
+	id: "update_resend_broadcast",
+	name: "Update Resend Broadcast",
+	description: "Update a draft broadcast. Ignored once the broadcast has started sending.",
+	input: z.object({
+		id: z.string().min(1),
+		name: z.string().optional(),
+		from: z.string().optional(),
+		subject: z.string().optional(),
+		reply_to: z.union([z.string(), z.array(z.string())]).optional(),
+		preview_text: z.string().optional(),
+		html: z.string().optional(),
+		text: z.string().optional(),
+		template: z.object({
+			id: z.string().min(1),
+			variables: z.record(z.string(), z.union([z.string(), z.number()])).optional()
+		}).optional(),
+		segment_id: z.string().optional(),
+		audience_id: z.string().optional(),
+		scheduled_at: z.string().optional()
+	}),
+	output: broadcastDetailSchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const { id, ...body } = input;
+		return createResendClient(credentials).request({
+			method: "PATCH",
+			path: `/broadcasts/${encodeURIComponent(id)}`,
+			body
+		});
+	}
+});
+const sendBroadcast = resendOperation({
+	id: "send_resend_broadcast",
+	name: "Send Resend Broadcast",
+	description: "Start sending a draft broadcast. Optionally schedule it for later.",
+	input: z.object({
+		id: z.string().min(1),
+		scheduled_at: z.string().min(1).optional()
+	}),
+	output: z.object({
+		id: z.string(),
+		object: z.literal("broadcast").optional()
+	}).passthrough(),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const { id, scheduled_at } = input;
+		return createResendClient(credentials).request({
+			method: "POST",
+			path: `/broadcasts/${encodeURIComponent(id)}/send`,
+			...scheduled_at ? { body: { scheduled_at } } : {}
+		});
+	}
+});
+const deleteBroadcast = resendOperation({
+	id: "delete_resend_broadcast",
+	name: "Delete Resend Broadcast",
+	description: "Delete a broadcast.",
+	input: z.object({ id: z.string().min(1) }),
+	output: z.object({
+		object: z.literal("broadcast").optional(),
+		id: z.string(),
+		deleted: z.boolean().optional()
+	}).passthrough(),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "DELETE",
+			path: `/broadcasts/${encodeURIComponent(input.id)}`
+		});
+	}
+});
+
+//#endregion
+export { createBroadcast, deleteBroadcast, listBroadcasts, retrieveBroadcast, sendBroadcast, updateBroadcast };

package/dist/client.d.mts

@@ -0,0 +1,27 @@
+import { t as ResendCredentials } from "./integration-ClH0F7x-.mjs";
+import { JsonRestClient, JsonRestRequestOptions } from "@keystrokehq/integration-authoring/http";
+
+//#region src/client.d.ts
+declare const RESEND_BASE_URL = "https://api.resend.com";
+/** User-Agent Resend sees on every request. Stable across minor releases. */
+declare const RESEND_USER_AGENT = "keystroke-integration-resend/0.0.0";
+type ResendClient = JsonRestClient;
+type ResendRequestOptions = JsonRestRequestOptions;
+interface CreateResendClientOptions {
+  /** Override the global `fetch`. Primarily for tests. */
+  readonly fetchImpl?: typeof fetch;
+  /** Override the base URL. Primarily for tests. */
+  readonly baseUrl?: string;
+  /** Override the default User-Agent. Primarily for tests. */
+  readonly userAgent?: string;
+}
+/**
+ * Create a Resend API client from resolved credentials.
+ *
+ * @param credentials - Resolved credentials containing `RESEND_API_KEY`.
+ * @param options - Optional overrides (primarily for testing).
+ * @returns A client with a typed `request` method.
+ */
+declare function createResendClient(credentials: ResendCredentials, options?: CreateResendClientOptions): ResendClient;
+//#endregion
+export { CreateResendClientOptions, RESEND_BASE_URL, RESEND_USER_AGENT, ResendClient, ResendRequestOptions, createResendClient };

package/dist/client.mjs

@@ -0,0 +1,40 @@
+import { createJsonRestClient } from "@keystrokehq/integration-authoring/http";
+
+//#region src/client.ts
+/**
+* resend/client.ts
+*
+* Thin wrapper over the shared `createJsonRestClient` helper configured
+* for the Resend API.
+*
+* Resend-specific notes:
+* - Base URL is `https://api.resend.com` (no version prefix).
+* - Auth is `Authorization: Bearer re_…`.
+* - A `User-Agent` header is *mandatory*: missing UA = HTTP 403 with
+*   error code 1010. Always attach one.
+* - `POST /emails` and `POST /emails/batch` honour an optional
+*   `Idempotency-Key` header (24h TTL, ≤256 chars). Pass it via
+*   `request({ headers: { 'Idempotency-Key': key } })`.
+*/
+const RESEND_BASE_URL = "https://api.resend.com";
+/** User-Agent Resend sees on every request. Stable across minor releases. */
+const RESEND_USER_AGENT = "keystroke-integration-resend/0.0.0";
+/**
+* Create a Resend API client from resolved credentials.
+*
+* @param credentials - Resolved credentials containing `RESEND_API_KEY`.
+* @param options - Optional overrides (primarily for testing).
+* @returns A client with a typed `request` method.
+*/
+function createResendClient(credentials, options = {}) {
+	return createJsonRestClient({
+		baseUrl: options.baseUrl ?? RESEND_BASE_URL,
+		errorPrefix: "Resend API error",
+		authHeaders: () => ({ Authorization: `Bearer ${credentials.RESEND_API_KEY}` }),
+		defaultHeaders: { "User-Agent": options.userAgent ?? RESEND_USER_AGENT },
+		...options.fetchImpl ? { fetchImpl: options.fetchImpl } : {}
+	});
+}
+
+//#endregion
+export { RESEND_BASE_URL, RESEND_USER_AGENT, createResendClient };

package/dist/connection.d.mts

@@ -0,0 +1,2 @@
+import { a as resendOfficialIntegration, n as resend, r as resendAuthSchema, t as ResendCredentials } from "./integration-ClH0F7x-.mjs";
+export { type ResendCredentials, resend, resendAuthSchema, resendOfficialIntegration };

package/dist/connection.mjs

@@ -0,0 +1,3 @@
+import { i as resendOfficialIntegration, n as resendAuthSchema, t as resend } from "./integration-BR1nTAnU.mjs";
+
+export { resend, resendAuthSchema, resendOfficialIntegration };

package/dist/contact-properties.d.mts

@@ -0,0 +1,139 @@
+import { z } from "zod";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+
+//#region src/contact-properties.d.ts
+declare const contactPropertyTypeSchema: z.ZodEnum<{
+  string: "string";
+  number: "number";
+  boolean: "boolean";
+  date: "date";
+}>;
+declare const contactPropertySchema: z.ZodObject<{
+  id: z.ZodString;
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  created_at: z.ZodOptional<z.ZodString>;
+  updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+declare const createContactProperty: _keystrokehq_core0.Operation<z.ZodObject<{
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodString;
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  created_at: z.ZodOptional<z.ZodString>;
+  updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, readonly [_keystrokehq_core0.CredentialSet<"resend", z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const listContactProperties: _keystrokehq_core0.Operation<z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+  after: z.ZodOptional<z.ZodString>;
+  before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  object: z.ZodLiteral<"list">;
+  has_more: z.ZodBoolean;
+  data: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    key: z.ZodString;
+    type: z.ZodEnum<{
+      string: "string";
+      number: "number";
+      boolean: "boolean";
+      date: "date";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"resend", z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const retrieveContactProperty: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodString;
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  created_at: z.ZodOptional<z.ZodString>;
+  updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, readonly [_keystrokehq_core0.CredentialSet<"resend", z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const updateContactProperty: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodString;
+  label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  id: z.ZodString;
+  key: z.ZodString;
+  type: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    date: "date";
+  }>;
+  label: z.ZodOptional<z.ZodString>;
+  created_at: z.ZodOptional<z.ZodString>;
+  updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>, readonly [_keystrokehq_core0.CredentialSet<"resend", z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const deleteContactProperty: _keystrokehq_core0.Operation<z.ZodObject<{
+  id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  object: z.ZodOptional<z.ZodLiteral<"contact_property">>;
+  id: z.ZodString;
+  deleted: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$loose>, readonly [_keystrokehq_core0.CredentialSet<"resend", z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  RESEND_API_KEY: z.ZodString;
+  RESEND_WEBHOOK_SIGNING_SECRETS: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>>[] | undefined>], undefined>;
+type ResendContactProperty = z.infer<typeof contactPropertySchema>;
+type ResendContactPropertyType = z.infer<typeof contactPropertyTypeSchema>;
+//#endregion
+export { ResendContactProperty, ResendContactPropertyType, createContactProperty, deleteContactProperty, listContactProperties, retrieveContactProperty, updateContactProperty };

package/dist/contact-properties.mjs

@@ -0,0 +1,115 @@
+import { createResendClient } from "./client.mjs";
+import { paginationQuerySchema, resendListEnvelope } from "./schemas.mjs";
+import { t as resendOperation } from "./factory-B3VyPRsL.mjs";
+import { z } from "zod";
+
+//#region src/contact-properties.ts
+/**
+* resend/contact-properties.ts
+*
+* Operations backing the Resend `/contact-properties` endpoints.
+* PLAN.md § 6.7: 5 operations.
+*
+* Contact properties are typed custom fields on contacts.
+*/
+const contactPropertyTypeSchema = z.enum([
+	"string",
+	"number",
+	"boolean",
+	"date"
+]);
+const contactPropertySchema = z.object({
+	id: z.string(),
+	key: z.string(),
+	type: contactPropertyTypeSchema,
+	label: z.string().optional(),
+	created_at: z.string().optional(),
+	updated_at: z.string().optional()
+}).passthrough();
+const listContactPropertiesResponseSchema = resendListEnvelope(contactPropertySchema);
+const createContactProperty = resendOperation({
+	id: "create_resend_contact_property",
+	name: "Create Resend Contact Property",
+	description: "Create a custom contact property.",
+	input: z.object({
+		key: z.string().min(1).regex(/^[a-z0-9_]+$/, "Keys use a-z, 0-9, underscore."),
+		type: contactPropertyTypeSchema,
+		label: z.string().optional()
+	}),
+	output: contactPropertySchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "POST",
+			path: "/contact-properties",
+			body: input
+		});
+	}
+});
+const listContactProperties = resendOperation({
+	id: "list_resend_contact_properties",
+	name: "List Resend Contact Properties",
+	description: "List all custom contact properties.",
+	input: paginationQuerySchema,
+	output: listContactPropertiesResponseSchema,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "GET",
+			path: "/contact-properties",
+			query: input
+		});
+	}
+});
+const retrieveContactProperty = resendOperation({
+	id: "retrieve_resend_contact_property",
+	name: "Retrieve Resend Contact Property",
+	description: "Retrieve a single contact property by id.",
+	input: z.object({ id: z.string().min(1) }),
+	output: contactPropertySchema,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "GET",
+			path: `/contact-properties/${encodeURIComponent(input.id)}`
+		});
+	}
+});
+const updateContactProperty = resendOperation({
+	id: "update_resend_contact_property",
+	name: "Update Resend Contact Property",
+	description: "Update a contact property (label only; key and type are immutable).",
+	input: z.object({
+		id: z.string().min(1),
+		label: z.string().optional()
+	}),
+	output: contactPropertySchema,
+	needsApproval: true,
+	run: async (input, credentials) => {
+		const { id, ...body } = input;
+		return createResendClient(credentials).request({
+			method: "PATCH",
+			path: `/contact-properties/${encodeURIComponent(id)}`,
+			body
+		});
+	}
+});
+const deleteContactProperty = resendOperation({
+	id: "delete_resend_contact_property",
+	name: "Delete Resend Contact Property",
+	description: "Delete a contact property.",
+	input: z.object({ id: z.string().min(1) }),
+	output: z.object({
+		object: z.literal("contact_property").optional(),
+		id: z.string(),
+		deleted: z.boolean().optional()
+	}).passthrough(),
+	needsApproval: true,
+	run: async (input, credentials) => {
+		return createResendClient(credentials).request({
+			method: "DELETE",
+			path: `/contact-properties/${encodeURIComponent(input.id)}`
+		});
+	}
+});
+
+//#endregion
+export { createContactProperty, deleteContactProperty, listContactProperties, retrieveContactProperty, updateContactProperty };