groundmail 0.42.0 → 0.44.0

package/dist/authjs.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail } from './client-Dsi5VG_k.js';
+import { G as Groundmail } from './client-CD3tBIro.js';
 
 /** Subset of Auth.js theme used for the default magic-link email. */
 type AuthjsTheme = {

package/dist/authjs.js

@@ -1,7 +1,7 @@
 import {
   DEFAULT_API_BASE_URL,
   Groundmail
-} from "./chunk-65NWGUZM.js";
+} from "./chunk-WMMIGQLO.js";
 
 // src/authjs.ts
 function escapeHtml(value) {

package/dist/better-auth.d.ts

@@ -1,4 +1,4 @@
-import { S as SendEmailResult, G as Groundmail } from './client-Dsi5VG_k.js';
+import { S as SendEmailResult, G as Groundmail } from './client-CD3tBIro.js';
 
 type BetterAuthEmailUser = {
     email: string;

package/dist/better-auth.js

@@ -1,7 +1,7 @@
 import {
   DEFAULT_API_BASE_URL,
   Groundmail
-} from "./chunk-65NWGUZM.js";
+} from "./chunk-WMMIGQLO.js";
 
 // src/better-auth.ts
 function linkHtml(label, url) {

package/dist/{chunk-65NWGUZM.js → chunk-WMMIGQLO.js}

@@ -1407,6 +1407,9 @@ function verifyWebhookSignature(secret, payload, header, toleranceSec = 300) {
   }
 }
 
+// package.json
+var version = "0.44.0";
+
 // src/automations.ts
 var AutomationsResource = class {
   constructor(client) {
@@ -1450,6 +1453,7 @@ var AutomationsResource = class {
   async listRuns(params = {}) {
     const search = new URLSearchParams();
     if (params.automation_id) search.set("automation_id", params.automation_id);
+    if (params.test != null) search.set("test", String(params.test));
     const query = search.toString();
     return this.client.request(`/automations/runs${query ? `?${query}` : ""}`, { method: "GET" });
   }
@@ -1648,8 +1652,8 @@ var EmailsResource = class {
       method: "GET"
     });
   }
-  async insights(window = "30d") {
-    const search = new URLSearchParams({ window });
+  async insights(window2 = "30d") {
+    const search = new URLSearchParams({ window: window2 });
     return this.client.request(`/deliverability?${search.toString()}`, {
       method: "GET"
     });
@@ -1859,6 +1863,7 @@ var SmtpCredentialsResource = class {
     const search = new URLSearchParams();
     if (params.limit != null) search.set("limit", String(params.limit));
     if (params.cursor) search.set("cursor", params.cursor);
+    if (params.test != null) search.set("test", String(params.test));
     const query = search.toString();
     return this.client.request(
       `/smtp-credentials${query ? `?${query}` : ""}`,
@@ -1869,7 +1874,8 @@ var SmtpCredentialsResource = class {
     return this.client.request("/smtp-credentials", {
       method: "POST",
       body: JSON.stringify({
-        ...params.name ? { name: params.name } : {}
+        ...params.name ? { name: params.name } : {},
+        ...params.test ? { test: true } : {}
       })
     });
   }
@@ -2086,9 +2092,9 @@ var TemplatesResource = class {
       method: "GET"
     });
   }
-  async restoreVersion(idOrAlias, version) {
+  async restoreVersion(idOrAlias, version2) {
     return this.client.request(
-      `/templates/${encodeURIComponent(idOrAlias)}/versions/${version}`,
+      `/templates/${encodeURIComponent(idOrAlias)}/versions/${version2}`,
       {
         method: "POST",
         body: JSON.stringify({ action: "restore" })
@@ -2307,6 +2313,16 @@ var _Groundmail = class _Groundmail {
   get fetchImpl() {
     return this.options.fetch || fetch;
   }
+  /**
+   * `groundmail/<version> node/<version>`, so Groundmail can tell SDK traffic from a plain
+   * HTTP call. Left to a custom `fetch` (our CLI and MCP server send their own), and never
+   * set in a browser, which owns this header.
+   */
+  get userAgentHeader() {
+    if (this.options.fetch || typeof window !== "undefined") return {};
+    const node = typeof process !== "undefined" ? process.versions?.node : void 0;
+    return { "User-Agent": `groundmail/${version}${node ? ` node/${node}` : ""}` };
+  }
   async bearer(forceRefresh = false) {
     if (this.apiKey) return this.apiKey;
     if (!forceRefresh && this.cachedToken && Date.now() < this.cachedToken.refreshAt) {
@@ -2324,7 +2340,12 @@ var _Groundmail = class _Groundmail {
   async authorizedFetch(url, init, extraHeaders) {
     const send = async (forceRefresh) => this.fetchImpl(url, {
       ...init,
-      headers: { Authorization: `Bearer ${await this.bearer(forceRefresh)}`, ...extraHeaders, ...init.headers || {} }
+      headers: {
+        ...this.userAgentHeader,
+        Authorization: `Bearer ${await this.bearer(forceRefresh)}`,
+        ...extraHeaders,
+        ...init.headers || {}
+      }
     });
     const response = await send(false);
     if (response.status === 401 && this.getToken) {

package/dist/clerk.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail, S as SendEmailResult } from './client-Dsi5VG_k.js';
+import { G as Groundmail, S as SendEmailResult } from './client-CD3tBIro.js';
 
 /**
  * Subset of Clerk `email.created` webhook `data` used for delivery.

package/dist/clerk.js

@@ -1,7 +1,7 @@
 import {
   DEFAULT_API_BASE_URL,
   Groundmail
-} from "./chunk-65NWGUZM.js";
+} from "./chunk-WMMIGQLO.js";
 
 // src/clerk.ts
 function resolveApiKey(options) {

package/dist/{client-Dsi5VG_k.d.ts → client-CD3tBIro.d.ts}

@@ -473,6 +473,8 @@ type SmtpCredential = {
     id: string;
     name: string;
     password_prefix: string;
+    /** A test credential (`gmsmtp_test_…`): mail sent with it is simulated and never delivered. */
+    test: boolean;
     username: string;
     host: string;
     port: number;
@@ -483,6 +485,8 @@ type SmtpCredential = {
 type ListSmtpCredentialsParams = {
     limit?: number;
     cursor?: string;
+    /** `true` for test credentials only, `false` for live ones only. */
+    test?: boolean;
 };
 type ListSmtpCredentialsResult = {
     data: SmtpCredential[];
@@ -491,6 +495,8 @@ type ListSmtpCredentialsResult = {
 };
 type CreateSmtpCredentialParams = {
     name?: string;
+    /** Create a test credential: mail sent with it is simulated and never delivered. */
+    test?: boolean;
 };
 type CreateSmtpCredentialResult = SmtpCredential & {
     password: string;
@@ -808,6 +814,8 @@ type AutomationRunResponse = {
 };
 type ListAutomationRunsParams = {
     automation_id?: string;
+    /** `true` for runs started with a test key only, `false` for live runs only. */
+    test?: boolean;
 };
 type ListAutomationRunsResult = {
     runs: AutomationRun[];
@@ -2562,6 +2570,12 @@ declare class Groundmail {
     validate(email: string): Promise<ValidateEmailResult>;
     get baseUrl(): string;
     get fetchImpl(): typeof fetch;
+    /**
+     * `groundmail/<version> node/<version>`, so Groundmail can tell SDK traffic from a plain
+     * HTTP call. Left to a custom `fetch` (our CLI and MCP server send their own), and never
+     * set in a browser, which owns this header.
+     */
+    private get userAgentHeader();
     /** Two minutes of slack so a token never expires in flight. */
     private static readonly TOKEN_REFRESH_SKEW_MS;
     /** Tokens with no known expiry are reused this long at most. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ApiErrorBody, D as DnsRecord } from './client-Dsi5VG_k.js';
-export { a as ApiErrorCode, b as ApiKey, c as ApiKeyMigrationParams, d as ApiKeyScope, e as ApplyDnsParams, f as ApplyDnsRecordResult, g as ApplyDnsResult, h as Asset, i as Automation, j as AutomationBranchQuestion, k as AutomationBranchStep, l as AutomationInlineEmail, m as AutomationResult, n as AutomationRun, o as AutomationRunResponse, p as AutomationRunStatus, q as AutomationRunStep, r as AutomationRunStepStatus, s as AutomationSendEmailStep, t as AutomationStatus, u as AutomationStep, v as AutomationTemplateEmail, w as AutomationTrigger, B as Batch, x as BatchSendEmailResult, y as BounceType, z as Brand, C as BrandLogo, E as BrandSettings, F as BurrowGuardCheck, H as BurrowGuardReason, I as BurrowGuardResource, J as BurrowGuardSite, K as BurrowGuardSiteWithSecret, L as BurrowGuardVerifyParams, M as BurrowGuardVerifyResult, N as CancelBatchResult, O as CategoryOptOut, P as CategoryOptOutCategory, Q as CategoryUnsubscribedErrorDetails, R as ConnectTwilioParams, T as ContactWebhookEventPayload, U as CreateApiKeyParams, V as CreateApiKeyResult, W as CreateAutomationParams, X as CreateBurrowGuardSiteParams, Y as CreateDomainParams, Z as CreateDomainResult, _ as CreateMigrationParams, $ as CreateSenderParams, a0 as CreateSuppressionParams, a1 as CreateTemplateParams, a2 as CreateTenantParams, a3 as CreateWebhookParams, a4 as DEFAULT_API_BASE_URL, a5 as DailyRampLimitErrorDetails, a6 as DeleteTenantResult, a7 as DeliverabilityBucket, a8 as DeliverabilityDomainInsight, a9 as DeliverabilityInsightsResult, aa as DeliverabilityMailServerRelay, ab as DeliverabilityWindow, ac as DmarcDailyPoint, ad as DmarcMonitoring, ae as DmarcMonitoringDisabled, af as DmarcReadiness, ag as DmarcReadinessVerdict, ah as DmarcSource, ai as DmarcSourceStatus, aj as DmarcStatus, ak as DnsProviderName, al as Domain, am as DomainBimiAnalysis, an as DomainBlocklistListing, ao as DomainBlocklistStatus, ap as DomainBlocklists, aq as DomainDetailResult, ar as DomainDmarcAnalysis, as as DomainDnsAnalysis, at as DomainStatus, au as DomainTlsMode, av as DomainTrackingDns, aw as DomainTrackingStatus, ax as EmailDelivery, ay as EmailListItem, az as EmailWebhookEventPayload, aA as EmailWebhookEventType, aB as EnableDmarcParams, aC as EnableDmarcResult, aD as EnrollmentSkip, aE as EventRecord, G as Groundmail, aF as GroundmailAccessToken, aG as GroundmailOptions, aH as GroundmailTokenOptions, aI as GroundmailTokenProvider, aJ as HeldBackErrorDetails, aK as HeldBackReason, aL as HeldBackRecipient, aM as InReplyToEmail, aN as ListApiKeysParams, aO as ListApiKeysResult, aP as ListAutomationRunsParams, aQ as ListAutomationRunsResult, aR as ListAutomationsResult, aS as ListBurrowGuardChecksParams, aT as ListBurrowGuardChecksResult, aU as ListCategoryOptOutsParams, aV as ListCategoryOptOutsResult, aW as ListDomainsParams, aX as ListDomainsResult, aY as ListEmailsParams, aZ as ListEmailsResult, a_ as ListReceivedEmailsParams, a$ as ListReceivedEmailsResult, b0 as ListSendersResult, b1 as ListSuppressionsParams, b2 as ListSuppressionsResult, b3 as ListTemplatesParams, b4 as ListTemplatesResult, b5 as ListTenantDomainsResult, b6 as ListTenantsParams, b7 as ListTenantsResult, b8 as ListTestInboxEmailsParams, b9 as ListTestInboxEmailsResult, ba as ListWebhookDeliveriesParams, bb as ListWebhookDeliveriesResult, bc as MailServerSigningStatus, bd as MailStream, be as Migration, bf as MigrationDnsChange, bg as MigrationDnsPlan, bh as MigrationDomainItem, bi as MigrationItemStatus, bj as MigrationProvider, bk as MigrationResource, bl as MigrationSummary, bm as MigrationTemplateItem, bn as MigrationTotals, bo as MigrationWebhookItem, bp as ReceivedEmail, bq as ReceivedEmailAttachment, br as ReceivedEmailAttachmentMeta, bs as RemoteApplyDnsCredentials, bt as RemoveCategoryOptOutOptions, bu as RunMigrationOptions, bv as SendEmailParams, S as SendEmailResult, bw as Sender, bx as SesMigrationParams, by as StreamDeliverability, bz as SuppressedErrorDetails, bA as Suppression, bB as TEST_INBOX_WAIT_DEFAULT_MS, bC as TEST_INBOX_WAIT_MAX_SECONDS, bD as Template, bE as TemplateFormat, bF as TemplateLintWarning, bG as TemplateStarter, bH as TemplateStatus, bI as TemplateVersion, bJ as Tenant, bK as TenantPauseSource, bL as TenantRamp, bM as TenantStats, bN as TenantStatsResult, bO as TenantStatus, bP as TenantStreamPolicy, bQ as TestEmailWebhookParams, bR as TestEmailWebhookResult, bS as TestInbox, bT as TestInboxAddressOptions, bU as TestInboxEmail, bV as TestInboxEmailDetail, bW as TestInboxHeader, bX as TestInboxResource, bY as TestInboxUsage, bZ as TriggerEventParams, b_ as TriggerEventResult, b$ as TwilioIntegrationResponse, c0 as TwilioIntegrationStatus, c1 as UpdateAutomationParams, c2 as UpdateBrandParams, c3 as UpdateBurrowGuardSiteParams, c4 as UpdateDomainParams, c5 as UpdateEmailParams, c6 as UpdateSenderParams, c7 as UpdateTemplateParams, c8 as UpdateTenantParams, c9 as UpdateWebhookParams, ca as ValidateEmailResult, cb as ValidationReason, cc as ValidationVerdict, cd as VerifyDomainResult, ce as WaitForTestEmailParams, cf as WebhookDelivery, cg as WebhookDeliveryAttempt, ch as WebhookDeliveryDetail, ci as WebhookDeliveryStatus, cj as WebhookEmailTag, ck as WebhookEndpoint, cl as WebhookEndpointHealth, cm as WebhookEndpointWithSecret, cn as WebhookEventType, co as mergeMigrations, cp as normalizeAccessToken } from './client-Dsi5VG_k.js';
+import { A as ApiErrorBody, D as DnsRecord } from './client-CD3tBIro.js';
+export { a as ApiErrorCode, b as ApiKey, c as ApiKeyMigrationParams, d as ApiKeyScope, e as ApplyDnsParams, f as ApplyDnsRecordResult, g as ApplyDnsResult, h as Asset, i as Automation, j as AutomationBranchQuestion, k as AutomationBranchStep, l as AutomationInlineEmail, m as AutomationResult, n as AutomationRun, o as AutomationRunResponse, p as AutomationRunStatus, q as AutomationRunStep, r as AutomationRunStepStatus, s as AutomationSendEmailStep, t as AutomationStatus, u as AutomationStep, v as AutomationTemplateEmail, w as AutomationTrigger, B as Batch, x as BatchSendEmailResult, y as BounceType, z as Brand, C as BrandLogo, E as BrandSettings, F as BurrowGuardCheck, H as BurrowGuardReason, I as BurrowGuardResource, J as BurrowGuardSite, K as BurrowGuardSiteWithSecret, L as BurrowGuardVerifyParams, M as BurrowGuardVerifyResult, N as CancelBatchResult, O as CategoryOptOut, P as CategoryOptOutCategory, Q as CategoryUnsubscribedErrorDetails, R as ConnectTwilioParams, T as ContactWebhookEventPayload, U as CreateApiKeyParams, V as CreateApiKeyResult, W as CreateAutomationParams, X as CreateBurrowGuardSiteParams, Y as CreateDomainParams, Z as CreateDomainResult, _ as CreateMigrationParams, $ as CreateSenderParams, a0 as CreateSuppressionParams, a1 as CreateTemplateParams, a2 as CreateTenantParams, a3 as CreateWebhookParams, a4 as DEFAULT_API_BASE_URL, a5 as DailyRampLimitErrorDetails, a6 as DeleteTenantResult, a7 as DeliverabilityBucket, a8 as DeliverabilityDomainInsight, a9 as DeliverabilityInsightsResult, aa as DeliverabilityMailServerRelay, ab as DeliverabilityWindow, ac as DmarcDailyPoint, ad as DmarcMonitoring, ae as DmarcMonitoringDisabled, af as DmarcReadiness, ag as DmarcReadinessVerdict, ah as DmarcSource, ai as DmarcSourceStatus, aj as DmarcStatus, ak as DnsProviderName, al as Domain, am as DomainBimiAnalysis, an as DomainBlocklistListing, ao as DomainBlocklistStatus, ap as DomainBlocklists, aq as DomainDetailResult, ar as DomainDmarcAnalysis, as as DomainDnsAnalysis, at as DomainStatus, au as DomainTlsMode, av as DomainTrackingDns, aw as DomainTrackingStatus, ax as EmailDelivery, ay as EmailListItem, az as EmailWebhookEventPayload, aA as EmailWebhookEventType, aB as EnableDmarcParams, aC as EnableDmarcResult, aD as EnrollmentSkip, aE as EventRecord, G as Groundmail, aF as GroundmailAccessToken, aG as GroundmailOptions, aH as GroundmailTokenOptions, aI as GroundmailTokenProvider, aJ as HeldBackErrorDetails, aK as HeldBackReason, aL as HeldBackRecipient, aM as InReplyToEmail, aN as ListApiKeysParams, aO as ListApiKeysResult, aP as ListAutomationRunsParams, aQ as ListAutomationRunsResult, aR as ListAutomationsResult, aS as ListBurrowGuardChecksParams, aT as ListBurrowGuardChecksResult, aU as ListCategoryOptOutsParams, aV as ListCategoryOptOutsResult, aW as ListDomainsParams, aX as ListDomainsResult, aY as ListEmailsParams, aZ as ListEmailsResult, a_ as ListReceivedEmailsParams, a$ as ListReceivedEmailsResult, b0 as ListSendersResult, b1 as ListSuppressionsParams, b2 as ListSuppressionsResult, b3 as ListTemplatesParams, b4 as ListTemplatesResult, b5 as ListTenantDomainsResult, b6 as ListTenantsParams, b7 as ListTenantsResult, b8 as ListTestInboxEmailsParams, b9 as ListTestInboxEmailsResult, ba as ListWebhookDeliveriesParams, bb as ListWebhookDeliveriesResult, bc as MailServerSigningStatus, bd as MailStream, be as Migration, bf as MigrationDnsChange, bg as MigrationDnsPlan, bh as MigrationDomainItem, bi as MigrationItemStatus, bj as MigrationProvider, bk as MigrationResource, bl as MigrationSummary, bm as MigrationTemplateItem, bn as MigrationTotals, bo as MigrationWebhookItem, bp as ReceivedEmail, bq as ReceivedEmailAttachment, br as ReceivedEmailAttachmentMeta, bs as RemoteApplyDnsCredentials, bt as RemoveCategoryOptOutOptions, bu as RunMigrationOptions, bv as SendEmailParams, S as SendEmailResult, bw as Sender, bx as SesMigrationParams, by as StreamDeliverability, bz as SuppressedErrorDetails, bA as Suppression, bB as TEST_INBOX_WAIT_DEFAULT_MS, bC as TEST_INBOX_WAIT_MAX_SECONDS, bD as Template, bE as TemplateFormat, bF as TemplateLintWarning, bG as TemplateStarter, bH as TemplateStatus, bI as TemplateVersion, bJ as Tenant, bK as TenantPauseSource, bL as TenantRamp, bM as TenantStats, bN as TenantStatsResult, bO as TenantStatus, bP as TenantStreamPolicy, bQ as TestEmailWebhookParams, bR as TestEmailWebhookResult, bS as TestInbox, bT as TestInboxAddressOptions, bU as TestInboxEmail, bV as TestInboxEmailDetail, bW as TestInboxHeader, bX as TestInboxResource, bY as TestInboxUsage, bZ as TriggerEventParams, b_ as TriggerEventResult, b$ as TwilioIntegrationResponse, c0 as TwilioIntegrationStatus, c1 as UpdateAutomationParams, c2 as UpdateBrandParams, c3 as UpdateBurrowGuardSiteParams, c4 as UpdateDomainParams, c5 as UpdateEmailParams, c6 as UpdateSenderParams, c7 as UpdateTemplateParams, c8 as UpdateTenantParams, c9 as UpdateWebhookParams, ca as ValidateEmailResult, cb as ValidationReason, cc as ValidationVerdict, cd as VerifyDomainResult, ce as WaitForTestEmailParams, cf as WebhookDelivery, cg as WebhookDeliveryAttempt, ch as WebhookDeliveryDetail, ci as WebhookDeliveryStatus, cj as WebhookEmailTag, ck as WebhookEndpoint, cl as WebhookEndpointHealth, cm as WebhookEndpointWithSecret, cn as WebhookEventType, co as mergeMigrations, cp as normalizeAccessToken } from './client-CD3tBIro.js';
 
 type GroundmailErrorOptions = {
     code?: string;

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   normalizeAccessToken,
   signWebhookPayload,
   verifyWebhookSignature
-} from "./chunk-65NWGUZM.js";
+} from "./chunk-WMMIGQLO.js";
 
 // src/simulator.ts
 var SIMULATOR_DOMAIN = "simulator.groundmail.dev";

package/dist/payload.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail } from './client-Dsi5VG_k.js';
+import { G as Groundmail } from './client-CD3tBIro.js';
 
 /**
  * Minimal Payload `SendEmailOptions` / address shapes used by this adapter.

package/dist/payload.js

@@ -1,7 +1,7 @@
 import {
   DEFAULT_API_BASE_URL,
   Groundmail
-} from "./chunk-65NWGUZM.js";
+} from "./chunk-WMMIGQLO.js";
 
 // src/payload.ts
 function resolveApiKey(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail",
-  "version": "0.42.0",
+  "version": "0.44.0",
   "description": "Groundmail transactional email API client",
   "license": "MIT",
   "type": "module",