groundmail 0.48.2 → 0.50.0

package/dist/authjs.js

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

package/dist/better-auth.js

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

package/dist/{chunk-QL2SVEHL.js → chunk-V7U3TJZY.js}

@@ -1670,7 +1670,7 @@ function verifyWebhookSignature(secret, payload, header, toleranceSec = 300) {
 }
 
 // package.json
-var version = "0.48.2";
+var version = "0.50.0";
 
 // src/automations.ts
 var AutomationsResource = class {
@@ -2138,7 +2138,18 @@ var SmtpCredentialsResource = class {
       method: "POST",
       body: JSON.stringify({
         ...params.name ? { name: params.name } : {},
-        ...params.test ? { test: true } : {}
+        ...params.test ? { test: true } : {},
+        ...params.category !== void 0 ? { category: params.category } : {}
+      })
+    });
+  }
+  /** Rename a credential or change its category. The password stays the same. */
+  async update(id, params) {
+    return this.client.request(`/smtp-credentials/${encodeURIComponent(id)}`, {
+      method: "PATCH",
+      body: JSON.stringify({
+        ...params.name !== void 0 ? { name: params.name } : {},
+        ...params.category !== void 0 ? { category: params.category } : {}
       })
     });
   }

package/dist/clerk.js

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

package/dist/{client-CGfDMp6Y.d.ts → client-BqaE8VYB.d.ts}

@@ -295,6 +295,13 @@ type InReplyToEmail = {
     /** The tenant's external id when it was sent as a tenant, else null. */
     tenant: string | null;
 };
+type ReceivedEmailForward = {
+    /** `rejected`: your URL answered 4xx and it wasn't retried. `failed`: retries ran out. */
+    status: 'pending' | 'delivered' | 'rejected' | 'failed';
+    attempts: number;
+    forwarded_at: string | null;
+    error: string | null;
+};
 type ReceivedEmail = {
     id: string;
     domain_id: string;
@@ -322,6 +329,8 @@ type ReceivedEmail = {
     in_reply_to_email: InReplyToEmail | null;
     attachment_count: number;
     attachments: ReceivedEmailAttachment[];
+    /** Forwarding to the domain's URL; null when the domain had none when it arrived. */
+    forward?: ReceivedEmailForward | null;
     text_body: string | null;
     html_body: string | null;
     auto_submitted: string | null;
@@ -480,12 +489,19 @@ type CreateApiKeyResult = {
     token: string;
     created_at: string;
 };
+type SmtpCredentialCategory = 'transactional' | 'product' | 'newsletter';
 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;
+    /**
+     * The category every email sent with this credential gets, for apps that can't
+     * add headers. `null`: each email decides (an `X-Groundmail-Category` header, or
+     * transactional). A header on the email wins over this.
+     */
+    category: SmtpCredentialCategory | null;
     username: string;
     host: string;
     port: number;
@@ -508,6 +524,13 @@ type CreateSmtpCredentialParams = {
     name?: string;
     /** Create a test credential: mail sent with it is simulated and never delivered. */
     test?: boolean;
+    /** The category every email sent with it gets. `newsletter` needs an approved account. */
+    category?: SmtpCredentialCategory | null;
+};
+type UpdateSmtpCredentialParams = {
+    name?: string;
+    /** `null` clears it: each email decides again. */
+    category?: SmtpCredentialCategory | null;
 };
 type CreateSmtpCredentialResult = SmtpCredential & {
     password: string;
@@ -1262,6 +1285,10 @@ type Domain = {
     inbound_spam_threshold?: number | null;
     /** `flag` keeps spam with `spam_status: 'spam'`; `drop` discards it. */
     inbound_spam_action?: 'flag' | 'drop';
+    /** Received mail is also POSTed here as the raw message, with ?from= and ?to=. Null when not set. */
+    inbound_forward_url?: string | null;
+    /** Whether a forward secret is set (the secret is never returned). */
+    inbound_forward_secret_set?: boolean;
     /** Daily blocklist check of this domain and its main domain. */
     blocklists?: DomainBlocklists;
     /** The tenant that owns this domain (external id). Absent for an account-wide domain. */
@@ -1399,6 +1426,10 @@ type UpdateDomainParams = {
     inbound_spam_threshold?: number | null;
     /** What to do with received mail at or above the threshold. */
     inbound_spam_action?: 'flag' | 'drop';
+    /** An https:// URL to POST each received email to as the raw message; null stops forwarding. */
+    inbound_forward_url?: string | null;
+    /** Sent with each forward as `Authorization: Bearer`; null removes it. */
+    inbound_forward_secret?: string | null;
 };
 type DnsProviderName = 'cloudflare' | 'godaddy' | 'vercel' | 'netlify' | 'digitalocean' | 'dnsimple';
 type RemoteApplyDnsCredentials = {
@@ -2711,6 +2742,8 @@ declare class SmtpCredentialsResource {
     constructor(client: Groundmail);
     list(params?: ListSmtpCredentialsParams): Promise<ListSmtpCredentialsResult>;
     create(params?: CreateSmtpCredentialParams): Promise<CreateSmtpCredentialResult>;
+    /** Rename a credential or change its category. The password stays the same. */
+    update(id: string, params: UpdateSmtpCredentialParams): Promise<SmtpCredential>;
     remove(id: string): Promise<{
         ok: boolean;
     }>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ApiErrorBody, D as DnsRecord } from './client-CGfDMp6Y.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 CreateMailboxParams, $ as CreateMigrationParams, a0 as CreateSenderParams, a1 as CreateSuppressionParams, a2 as CreateTemplateParams, a3 as CreateTenantParams, a4 as CreateWebhookParams, a5 as DEFAULT_API_BASE_URL, a6 as DailyRampLimitErrorDetails, a7 as DeleteMailboxResult, a8 as DeleteTenantResult, a9 as DeliverabilityBucket, aa as DeliverabilityDomainInsight, ab as DeliverabilityInsightsResult, ac as DeliverabilityMailServerRelay, ad as DeliverabilityWindow, ae as DmarcDailyPoint, af as DmarcMonitoring, ag as DmarcMonitoringDisabled, ah as DmarcReadiness, ai as DmarcReadinessVerdict, aj as DmarcSource, ak as DmarcSourceStatus, al as DmarcStatus, am as DnsProviderName, an as Domain, ao as DomainBimiAnalysis, ap as DomainBlocklistListing, aq as DomainBlocklistStatus, ar as DomainBlocklists, as as DomainDetailResult, at as DomainDmarcAnalysis, au as DomainDnsAnalysis, av as DomainStatus, aw as DomainTlsMode, ax as DomainTrackingDns, ay as DomainTrackingStatus, az as EmailDelivery, aA as EmailListItem, aB as EmailWebhookEventPayload, aC as EmailWebhookEventType, aD as EnableDmarcParams, aE as EnableDmarcResult, aF as EnrollmentSkip, aG as EventRecord, aH as ForwardMailboxParams, aI as GetMailboxThreadParams, G as Groundmail, aJ as GroundmailAccessToken, aK as GroundmailOptions, aL as GroundmailTokenOptions, aM as GroundmailTokenProvider, aN as HeldBackErrorDetails, aO as HeldBackReason, aP as HeldBackRecipient, aQ as InReplyToEmail, aR as InstantMailbox, aS as InstantMailboxParams, aT as ListApiKeysParams, aU as ListApiKeysResult, aV as ListAutomationRunsParams, aW as ListAutomationRunsResult, aX as ListAutomationsResult, aY as ListBurrowGuardChecksParams, aZ as ListBurrowGuardChecksResult, a_ as ListCategoryOptOutsParams, a$ as ListCategoryOptOutsResult, b0 as ListDomainsParams, b1 as ListDomainsResult, b2 as ListEmailsParams, b3 as ListEmailsResult, b4 as ListMailboxMessagesParams, b5 as ListMailboxMessagesResult, b6 as ListMailboxThreadsParams, b7 as ListMailboxThreadsResult, b8 as ListMailboxesParams, b9 as ListMailboxesResult, ba as ListReceivedEmailsParams, bb as ListReceivedEmailsResult, bc as ListSendersResult, bd as ListSuppressionsParams, be as ListSuppressionsResult, bf as ListTemplatesParams, bg as ListTemplatesResult, bh as ListTenantDomainsResult, bi as ListTenantsParams, bj as ListTenantsResult, bk as ListTestInboxEmailsParams, bl as ListTestInboxEmailsResult, bm as ListWebhookDeliveriesParams, bn as ListWebhookDeliveriesResult, bo as MAILBOX_WAIT_DEFAULT_MS, bp as MAILBOX_WAIT_MAX_SECONDS, bq as MailServerSigningStatus, br as MailStream, bs as Mailbox, bt as MailboxAttachment, bu as MailboxAttachmentDownload, bv as MailboxForwarding, bw as MailboxMessage, bx as MailboxMessageDetail, by as MailboxMessagesResource, bz as MailboxOutgoingAttachment, bA as MailboxSendResult, bB as MailboxStatus, bC as MailboxThread, bD as MailboxThreadDetail, bE as MailboxThreadsResource, bF as MailboxWebhookEventPayload, bG as MailboxesResource, bH as Migration, bI as MigrationDnsChange, bJ as MigrationDnsPlan, bK as MigrationDomainItem, bL as MigrationItemStatus, bM as MigrationProvider, bN as MigrationResource, bO as MigrationSummary, bP as MigrationTemplateItem, bQ as MigrationTotals, bR as MigrationWebhookItem, bS as ReceivedEmail, bT as ReceivedEmailAttachment, bU as ReceivedEmailAttachmentMeta, bV as RemoteApplyDnsCredentials, bW as RemoveCategoryOptOutOptions, bX as ReplyToMailboxMessageParams, bY as RunMigrationOptions, bZ as SendEmailParams, S as SendEmailResult, b_ as SendMailboxMessageParams, b$ as Sender, c0 as SesMigrationParams, c1 as StreamDeliverability, c2 as SuppressedErrorDetails, c3 as Suppression, c4 as TEST_INBOX_WAIT_DEFAULT_MS, c5 as TEST_INBOX_WAIT_MAX_SECONDS, c6 as Template, c7 as TemplateFormat, c8 as TemplateLintWarning, c9 as TemplateStarter, ca as TemplateStatus, cb as TemplateVersion, cc as Tenant, cd as TenantPauseSource, ce as TenantRamp, cf as TenantStats, cg as TenantStatsResult, ch as TenantStatus, ci as TenantStreamPolicy, cj as TestEmailWebhookParams, ck as TestEmailWebhookResult, cl as TestInbox, cm as TestInboxAddressOptions, cn as TestInboxEmail, co as TestInboxEmailDetail, cp as TestInboxHeader, cq as TestInboxResource, cr as TestInboxUsage, cs as TriggerEventParams, ct as TriggerEventResult, cu as TwilioIntegrationResponse, cv as TwilioIntegrationStatus, cw as UpdateAutomationParams, cx as UpdateBrandParams, cy as UpdateBurrowGuardSiteParams, cz as UpdateDomainParams, cA as UpdateEmailParams, cB as UpdateMailboxMessageParams, cC as UpdateMailboxParams, cD as UpdateMailboxThreadParams, cE as UpdateSenderParams, cF as UpdateTemplateParams, cG as UpdateTenantParams, cH as UpdateWebhookParams, cI as ValidateEmailResult, cJ as ValidationReason, cK as ValidationVerdict, cL as VerifyDomainResult, cM as WaitForMailboxMessageParams, cN as WaitForTestEmailParams, cO as WebhookDelivery, cP as WebhookDeliveryAttempt, cQ as WebhookDeliveryDetail, cR as WebhookDeliveryStatus, cS as WebhookEmailTag, cT as WebhookEndpoint, cU as WebhookEndpointHealth, cV as WebhookEndpointWithSecret, cW as WebhookEventType, cX as createInstantMailbox, cY as mergeMigrations, cZ as normalizeAccessToken } from './client-CGfDMp6Y.js';
+import { A as ApiErrorBody, D as DnsRecord } from './client-BqaE8VYB.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 CreateMailboxParams, $ as CreateMigrationParams, a0 as CreateSenderParams, a1 as CreateSuppressionParams, a2 as CreateTemplateParams, a3 as CreateTenantParams, a4 as CreateWebhookParams, a5 as DEFAULT_API_BASE_URL, a6 as DailyRampLimitErrorDetails, a7 as DeleteMailboxResult, a8 as DeleteTenantResult, a9 as DeliverabilityBucket, aa as DeliverabilityDomainInsight, ab as DeliverabilityInsightsResult, ac as DeliverabilityMailServerRelay, ad as DeliverabilityWindow, ae as DmarcDailyPoint, af as DmarcMonitoring, ag as DmarcMonitoringDisabled, ah as DmarcReadiness, ai as DmarcReadinessVerdict, aj as DmarcSource, ak as DmarcSourceStatus, al as DmarcStatus, am as DnsProviderName, an as Domain, ao as DomainBimiAnalysis, ap as DomainBlocklistListing, aq as DomainBlocklistStatus, ar as DomainBlocklists, as as DomainDetailResult, at as DomainDmarcAnalysis, au as DomainDnsAnalysis, av as DomainStatus, aw as DomainTlsMode, ax as DomainTrackingDns, ay as DomainTrackingStatus, az as EmailDelivery, aA as EmailListItem, aB as EmailWebhookEventPayload, aC as EmailWebhookEventType, aD as EnableDmarcParams, aE as EnableDmarcResult, aF as EnrollmentSkip, aG as EventRecord, aH as ForwardMailboxParams, aI as GetMailboxThreadParams, G as Groundmail, aJ as GroundmailAccessToken, aK as GroundmailOptions, aL as GroundmailTokenOptions, aM as GroundmailTokenProvider, aN as HeldBackErrorDetails, aO as HeldBackReason, aP as HeldBackRecipient, aQ as InReplyToEmail, aR as InstantMailbox, aS as InstantMailboxParams, aT as ListApiKeysParams, aU as ListApiKeysResult, aV as ListAutomationRunsParams, aW as ListAutomationRunsResult, aX as ListAutomationsResult, aY as ListBurrowGuardChecksParams, aZ as ListBurrowGuardChecksResult, a_ as ListCategoryOptOutsParams, a$ as ListCategoryOptOutsResult, b0 as ListDomainsParams, b1 as ListDomainsResult, b2 as ListEmailsParams, b3 as ListEmailsResult, b4 as ListMailboxMessagesParams, b5 as ListMailboxMessagesResult, b6 as ListMailboxThreadsParams, b7 as ListMailboxThreadsResult, b8 as ListMailboxesParams, b9 as ListMailboxesResult, ba as ListReceivedEmailsParams, bb as ListReceivedEmailsResult, bc as ListSendersResult, bd as ListSuppressionsParams, be as ListSuppressionsResult, bf as ListTemplatesParams, bg as ListTemplatesResult, bh as ListTenantDomainsResult, bi as ListTenantsParams, bj as ListTenantsResult, bk as ListTestInboxEmailsParams, bl as ListTestInboxEmailsResult, bm as ListWebhookDeliveriesParams, bn as ListWebhookDeliveriesResult, bo as MAILBOX_WAIT_DEFAULT_MS, bp as MAILBOX_WAIT_MAX_SECONDS, bq as MailServerSigningStatus, br as MailStream, bs as Mailbox, bt as MailboxAttachment, bu as MailboxAttachmentDownload, bv as MailboxForwarding, bw as MailboxMessage, bx as MailboxMessageDetail, by as MailboxMessagesResource, bz as MailboxOutgoingAttachment, bA as MailboxSendResult, bB as MailboxStatus, bC as MailboxThread, bD as MailboxThreadDetail, bE as MailboxThreadsResource, bF as MailboxWebhookEventPayload, bG as MailboxesResource, bH as Migration, bI as MigrationDnsChange, bJ as MigrationDnsPlan, bK as MigrationDomainItem, bL as MigrationItemStatus, bM as MigrationProvider, bN as MigrationResource, bO as MigrationSummary, bP as MigrationTemplateItem, bQ as MigrationTotals, bR as MigrationWebhookItem, bS as ReceivedEmail, bT as ReceivedEmailAttachment, bU as ReceivedEmailAttachmentMeta, bV as RemoteApplyDnsCredentials, bW as RemoveCategoryOptOutOptions, bX as ReplyToMailboxMessageParams, bY as RunMigrationOptions, bZ as SendEmailParams, S as SendEmailResult, b_ as SendMailboxMessageParams, b$ as Sender, c0 as SesMigrationParams, c1 as StreamDeliverability, c2 as SuppressedErrorDetails, c3 as Suppression, c4 as TEST_INBOX_WAIT_DEFAULT_MS, c5 as TEST_INBOX_WAIT_MAX_SECONDS, c6 as Template, c7 as TemplateFormat, c8 as TemplateLintWarning, c9 as TemplateStarter, ca as TemplateStatus, cb as TemplateVersion, cc as Tenant, cd as TenantPauseSource, ce as TenantRamp, cf as TenantStats, cg as TenantStatsResult, ch as TenantStatus, ci as TenantStreamPolicy, cj as TestEmailWebhookParams, ck as TestEmailWebhookResult, cl as TestInbox, cm as TestInboxAddressOptions, cn as TestInboxEmail, co as TestInboxEmailDetail, cp as TestInboxHeader, cq as TestInboxResource, cr as TestInboxUsage, cs as TriggerEventParams, ct as TriggerEventResult, cu as TwilioIntegrationResponse, cv as TwilioIntegrationStatus, cw as UpdateAutomationParams, cx as UpdateBrandParams, cy as UpdateBurrowGuardSiteParams, cz as UpdateDomainParams, cA as UpdateEmailParams, cB as UpdateMailboxMessageParams, cC as UpdateMailboxParams, cD as UpdateMailboxThreadParams, cE as UpdateSenderParams, cF as UpdateTemplateParams, cG as UpdateTenantParams, cH as UpdateWebhookParams, cI as ValidateEmailResult, cJ as ValidationReason, cK as ValidationVerdict, cL as VerifyDomainResult, cM as WaitForMailboxMessageParams, cN as WaitForTestEmailParams, cO as WebhookDelivery, cP as WebhookDeliveryAttempt, cQ as WebhookDeliveryDetail, cR as WebhookDeliveryStatus, cS as WebhookEmailTag, cT as WebhookEndpoint, cU as WebhookEndpointHealth, cV as WebhookEndpointWithSecret, cW as WebhookEventType, cX as createInstantMailbox, cY as mergeMigrations, cZ as normalizeAccessToken } from './client-BqaE8VYB.js';
 
 type GroundmailErrorOptions = {
     code?: string;

package/dist/index.js

@@ -19,7 +19,7 @@ import {
   normalizeAccessToken,
   signWebhookPayload,
   verifyWebhookSignature
-} from "./chunk-QL2SVEHL.js";
+} from "./chunk-V7U3TJZY.js";
 
 // src/simulator.ts
 var SIMULATOR_DOMAIN = "simulator.groundmail.dev";

package/dist/payload.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail",
-  "version": "0.48.2",
+  "version": "0.50.0",
   "description": "Groundmail client: email infrastructure for apps and AI agents",
   "license": "MIT",
   "type": "module",