@agentisend/sdk-node 0.4.0 → 0.5.1

package/dist/types.d.ts

@@ -16,7 +16,11 @@ export interface Attachment {
     content_id?: string;
 }
 export interface SendEmailPayload {
-    from: string;
+    /**
+     * Required unless `template_id` or `template` names a published template
+     * with a default sender. A `from` here overrides the template's.
+     */
+    from?: string;
     to: AddressList;
     /** Required unless `template_id` or `template` names a published template with a subject. */
     subject?: string;
@@ -44,10 +48,10 @@ export interface SendEmailPayload {
     topic_id?: string;
     /** Resend Node SDK name for `topic_id`. */
     topicId?: string;
-    /** Published template to render, instead of html or text. */
+    /** Id or alias of a published template to render, instead of html or text. */
     template_id?: string;
     template_values?: Record<string, unknown>;
-    /** Resend's send shape: `{id, variables}` instead of sibling `template_id`/`template_values`. */
+    /** Resend's send shape: `{id, variables}`; `id` is the template's id or its alias. */
     template?: {
         id: string;
         variables?: Record<string, string | number>;
@@ -55,6 +59,34 @@ export interface SendEmailPayload {
     /** When a held send stops waiting for a person. At most 7 days ahead. */
     expires_at?: string;
 }
+/** A template variable as Resend writes it: a key, a type, and an optional fallback. */
+export interface TemplateVariableInput {
+    key: string;
+    type: 'string' | 'number' | 'boolean';
+    /** With no fallback the variable is required when sending. */
+    fallback_value?: string | number | boolean;
+}
+/**
+ * POST /templates. Send `html` the way Resend does, or `content` for markdown
+ * and blocks. `variables` take Resend's `{key, type, fallback_value}` or the
+ * native `{name, type, required, default}`.
+ */
+export interface TemplateCreatePayload {
+    name: string;
+    /** Unique on the account. Use it wherever a template id is taken. */
+    alias?: string;
+    /** Default sender, such as `Acme <hello@acme.com>`. A send's own `from` overrides it. */
+    from?: string;
+    subject?: string;
+    /** Default Reply-To. A send's own `reply_to` overrides it. */
+    reply_to?: string | string[];
+    html?: string;
+    /** Native body: `{mode: 'markdown' | 'html', source}` or `{mode: 'block', blocks}`. */
+    content?: unknown;
+    /** Plain-text part. Left out, one is made from the HTML; `''` sends no text part. */
+    text?: string;
+    variables?: Array<TemplateVariableInput | Record<string, unknown>>;
+}
 export type MessageStatus = 'queued' | 'scheduled' | 'sent' | 'delivered' | 'delivery_delayed' | 'bounced' | 'complained' | 'opened' | 'clicked' | 'failed' | 'canceled' | 'suppressed';
 export interface AttachmentView {
     filename: string;
@@ -109,14 +141,59 @@ export interface ListQuery {
     /** Resend's previous-page cursor. Mutually exclusive with cursor/after. */
     before?: string;
 }
-/** GET /metrics and GET /emails/metrics (W4.10). */
+/**
+ * GET /metrics and GET /emails/metrics (W4.10).
+ *
+ * `since` and `until` (and `group_by`, `event`, `domain`, `api_key_id` on the
+ * route) select this API's own shape. `start_date`, `end_date` and the rest
+ * select Resend's: totals, or rows broken down by `dimensions`.
+ */
 export interface MetricsQuery {
     since?: string;
     until?: string;
-    /** Resend's name for `since`. A YYYY-MM-DD date is 00:00 UTC. */
+    /** The start of the range: an ISO 8601 date or datetime. Defaults to 6 days before `end_date`. */
     start_date?: string;
-    /** Resend's name for `until`. A YYYY-MM-DD date is 23:59:59.999 UTC. */
+    /** The end of the range. A date covers that whole day. A future value is clamped to now. */
     end_date?: string;
+    /** IANA timezone that buckets periods when `period` is a dimension. Default UTC. */
+    timezone?: string;
+    /** Bucket size when `period` is a dimension. Default daily. At most 10,000 periods. */
+    granularity?: 'hourly' | 'daily' | 'weekly' | 'monthly';
+    /** Metrics to return (a list, or a comma-separated string). Omit for all. */
+    metrics?: string | string[];
+    /** Any of period, domain, email, broadcast. `email` cannot be combined with `broadcast`. */
+    dimensions?: string | string[];
+    /** Up to 100 sending domain ids. */
+    domain_id?: string | string[];
+    /** Up to 100 email ids. Not with the broadcast dimension or `broadcast_id`. */
+    email_id?: string | string[];
+    /** Up to 100 broadcast ids. Not with the email dimension or `email_id`. */
+    broadcast_id?: string | string[];
+}
+/** GET /broadcasts/{id}/recipients (Resend: list-broadcast-recipients). */
+export interface BroadcastRecipientsQuery {
+    type: 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | 'unsubscribed' | 'suppressed';
+    /** Keep recipients whose email contains this value. */
+    email?: string;
+    /** Only with `type: 'bounced'`. */
+    bounce_type?: 'permanent' | 'transient' | 'undetermined';
+    /** 1 to 100. Default 20. */
+    limit?: number;
+    after?: string;
+    before?: string;
+}
+/** GET /broadcasts/{id}/clicked-links (Resend: list-broadcast-clicked-links). */
+export interface BroadcastClickedLinksQuery {
+    /** 1 to 100. Default 20. */
+    limit?: number;
+    after?: string;
+    before?: string;
+}
+/** Resend's list envelope for the broadcast engagement routes. */
+export interface EngagementList<T> {
+    object: 'list';
+    has_more: boolean;
+    data: T[];
 }
 /** One component on the public status page, and what it reports about itself. */
 export interface ServiceComponent {
@@ -207,31 +284,62 @@ export interface EventDefinition {
     updated_at: string;
 }
 /** One step of one automation run, and what it did (M5.6). */
+/** A graph step (Resend's shape): `config` depends on `type`. */
+export interface AutomationGraphStep {
+    key: string;
+    type: 'trigger' | 'delay' | 'send_email' | 'wait_for_event' | 'condition' | 'contact_update' | 'contact_delete' | 'add_to_segment';
+    config: Record<string, unknown>;
+}
+/** A link between two graph steps, by key. `type` defaults to `default`. */
+export interface AutomationConnection {
+    from: string;
+    to: string;
+    type?: 'default' | 'condition_met' | 'condition_not_met' | 'timeout' | 'event_received';
+}
 export interface AutomationRunStep {
     index: number;
     kind: string;
+    /** A graph step's key; null on a linear run. */
+    key: string | null;
+    type: string;
     /**
-     * `skipped` is a real outcome: a step that did nothing on purpose.
-     * `waiting`: sending is paused for every account; the step runs again after
-     * `output.retry_at`, and the run stays `running` until it does.
+     * Linear: succeeded, skipped, failed, or waiting (sending is paused for
+     * every account; the step runs again after `output.retry_at`). Graph:
+     * completed, skipped, failed, or waiting (a delay or a wait for an event).
      */
-    status: 'succeeded' | 'skipped' | 'failed' | 'waiting';
+    status: 'succeeded' | 'completed' | 'skipped' | 'failed' | 'waiting' | 'pending' | 'running';
     output: Record<string, unknown> | null;
-    error: string | null;
+    /** A linear run's sentence, or a graph run's `{ message }`. */
+    error: string | {
+        message: string;
+    } | null;
     started_at: string;
     finished_at: string | null;
+    completed_at: string | null;
+    created_at: string;
 }
 /** One execution of one automation. `steps` is present on the single read. */
 export interface AutomationRun {
+    object: 'automation_run';
     id: string;
     automation_id: string;
     version_number: number | null;
     trigger_type: string;
     event_name: string | null;
     contact_id: string | null;
-    status: 'running' | 'succeeded' | 'failed';
+    /** Linear: running, succeeded or failed. Graph: running, completed, failed or cancelled. */
+    status: 'running' | 'succeeded' | 'completed' | 'failed' | 'cancelled';
     started_at: string;
     finished_at: string | null;
+    completed_at: string | null;
+    created_at: string;
+    /** Graph runs: the step the run is on. */
+    current_step: string | null;
+    /** Graph runs: the event a wait holds for, and when a delay or timeout ends. */
+    waiting_for: {
+        event: string | null;
+        until: string | null;
+    } | null;
     steps?: AutomationRunStep[];
 }
 /** One item's outcome in a suppression batch (M5.5). */
@@ -459,7 +567,35 @@ export interface DomainRecord {
     /** What to do about this record, the alternative accepted forms included. */
     fix: string;
 }
+/** What a domain does. Sending defaults to enabled, receiving to disabled. */
+export interface DomainCapabilities {
+    sending?: 'enabled' | 'disabled';
+    receiving?: 'enabled' | 'disabled';
+}
+/** `POST /domains/claim`, `GET /domains/:id/claim` and `POST /domains/:id/claim/verify`. */
+export interface DomainClaim {
+    object: 'domain_claim';
+    id: string;
+    name: string;
+    status: 'pending' | 'verified' | 'completed' | 'blocked' | 'expired' | 'superseded' | 'canceled' | 'failed';
+    /** The placeholder domain the claim created on your account. */
+    domain_id: string | null;
+    region: DomainRegion | null;
+    /** The TXT record to publish at your DNS to prove you control the domain. */
+    record: {
+        type: 'TXT';
+        name: string;
+        value: string;
+        ttl: string;
+    };
+    blocked_reason: 'grace_period' | 'recent_owner_activity' | 'pending_scheduled_emails' | null;
+    failure_reason: string | null;
+    created_at: string;
+    expires_at: string;
+}
 export interface Domain {
+    /** `domain` on a retrieved domain; absent on list items. */
+    object?: 'domain';
     id: string;
     name: string;
     zone?: string;
@@ -471,6 +607,11 @@ export interface Domain {
     open_tracking: boolean;
     tracking_subdomain: string;
     return_path_subdomain?: string;
+    /** Whether the domain sends and whether it receives. */
+    capabilities?: {
+        sending: 'enabled' | 'disabled';
+        receiving: 'enabled' | 'disabled';
+    };
     /**
      * DNS sheet. Present on create, get, verify, and update. `list()` omits it
      * (research/01-resend-api-baseline.md:182); call `get(id)` for the records.

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * JSON import and no bundler has to resolve one. It cannot drift silently:
  * `sdk_node_is_publishable_standalone` compares it to the manifest.
  */
-export declare const SDK_VERSION = "0.4.0";
+export declare const SDK_VERSION = "0.5.1";

package/dist/version.js

@@ -5,5 +5,5 @@
  * JSON import and no bundler has to resolve one. It cannot drift silently:
  * `sdk_node_is_publishable_standalone` compares it to the manifest.
  */
-export const SDK_VERSION = '0.4.0';
+export const SDK_VERSION = '0.5.1';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentisend/sdk-node",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "AgentiSend is a transactional email API for AI agents. This is its typed Node client.",
   "author": "AgentiSend <hello@agentisend.com>",
   "type": "module",
@@ -57,7 +57,6 @@
     "README.md"
   ],
   "devDependencies": {
-    "resend": "6.30.0",
     "typescript": "^5.6.0",
     "vitest": "^3.0.0"
   },