groundmail 0.23.0 → 0.25.0

package/README.md

@@ -25,6 +25,20 @@ const email = await tx.emails.send({
 console.log(email.id, email.status)
 ```
 
+## Azure managed identity (no API key)
+
+On Azure, authenticate with the workload's managed identity instead of a key. Pass a token provider; the client caches the token until shortly before it expires and asks for a new one after a 401:
+
+```ts
+import { DefaultAzureCredential } from '@azure/identity'
+import { Groundmail } from 'groundmail'
+
+const credential = new DefaultAzureCredential()
+const client = new Groundmail({ getToken: () => credential.getToken('api://<your-app-id>/.default') })
+```
+
+`getToken` may return a string or `{ token, expiresOnTimestamp }`. Register the identity in the dashboard first: https://docs.groundmail.dev/authentication/azure-managed-identity
+
 ## Testing
 
 Use a test key (`gm_test_…`, create one with `tx.apiKeys.create({ test: true })` or in the

package/dist/authjs.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail } from './client-CTG4zTKw.js';
+import { G as Groundmail } from './client-NSj8n5sB.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-QBGTN2WD.js";
+} from "./chunk-NQWM7F3N.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-CTG4zTKw.js';
+import { S as SendEmailResult, G as Groundmail } from './client-NSj8n5sB.js';
 
 type BetterAuthEmailUser = {
     email: string;

package/dist/better-auth.js

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

package/dist/{chunk-QBGTN2WD.js → chunk-NQWM7F3N.js}

@@ -1334,6 +1334,37 @@ var SuppressionsResource = class {
       method: "DELETE"
     });
   }
+  /**
+   * List category opt-outs: addresses that unsubscribed from product or
+   * newsletter email. Pass `tenant` for one tenant's opt-outs.
+   */
+  async listCategoryOptOuts(params = {}) {
+    const search = new URLSearchParams({ type: "category_opt_out" });
+    if (params.limit != null) search.set("limit", String(params.limit));
+    if (params.cursor) search.set("cursor", params.cursor);
+    if (params.email) search.set("email", params.email);
+    if (params.category) search.set("category", params.category);
+    if (params.tenant) search.set("tenant", params.tenant);
+    if (params.includeTenants) search.set("include_tenants", "true");
+    return this.client.request(`/suppressions?${search.toString()}`, { method: "GET" });
+  }
+  /**
+   * Remove a category opt-out by opt-out id or email address, so the address
+   * can receive that category again (for example after the reader re-subscribes).
+   * Throws a 404 error when nothing matches.
+   */
+  async removeCategoryOptOut(idOrEmail, options = {}) {
+    const search = new URLSearchParams({ type: "category_opt_out" });
+    if (options.category) search.set("category", options.category);
+    if (options.tenant) search.set("tenant", options.tenant);
+    if (idOrEmail.includes("@")) {
+      search.set("email", idOrEmail);
+      return this.client.request(`/suppressions?${search.toString()}`, { method: "DELETE" });
+    }
+    return this.client.request(`/suppressions/${encodeURIComponent(idOrEmail)}?${search.toString()}`, {
+      method: "DELETE"
+    });
+  }
 };
 
 // src/templates.ts
@@ -1528,12 +1559,24 @@ var WebhooksResource = class {
 
 // src/client.ts
 var DEFAULT_API_BASE_URL = "https://api.groundmail.dev";
-var Groundmail = class {
-  constructor(apiKey, options = {}) {
-    this.apiKey = apiKey;
-    this.options = options;
-    if (!apiKey?.startsWith("gm_")) {
-      throw new Error("Groundmail API key must start with gm_");
+var _Groundmail = class _Groundmail {
+  constructor(apiKeyOrOptions, options = {}) {
+    this.cachedToken = null;
+    if (apiKeyOrOptions && typeof apiKeyOrOptions === "object") {
+      if (typeof apiKeyOrOptions.getToken !== "function") {
+        throw new Error("Groundmail: pass an API key (gm_\u2026) or { getToken } to authenticate");
+      }
+      const { getToken, ...rest } = apiKeyOrOptions;
+      this.apiKey = null;
+      this.getToken = getToken;
+      this.options = rest;
+    } else {
+      if (!apiKeyOrOptions?.startsWith("gm_")) {
+        throw new Error("Groundmail API key must start with gm_");
+      }
+      this.apiKey = apiKeyOrOptions;
+      this.getToken = null;
+      this.options = options;
     }
     this.domains = new DomainsResource(this);
     this.emails = new EmailsResource(this);
@@ -1567,12 +1610,35 @@ var Groundmail = class {
   get fetchImpl() {
     return this.options.fetch || fetch;
   }
+  async bearer(forceRefresh = false) {
+    if (this.apiKey) return this.apiKey;
+    if (!forceRefresh && this.cachedToken && Date.now() < this.cachedToken.refreshAt) {
+      return this.cachedToken.token;
+    }
+    const value = await this.getToken();
+    const { token, expiresAt } = normalizeAccessToken(value);
+    if (!token) throw new Error("Groundmail: getToken() returned no token");
+    const fallback = Date.now() + _Groundmail.TOKEN_DEFAULT_TTL_MS;
+    const refreshAt = expiresAt ? expiresAt - _Groundmail.TOKEN_REFRESH_SKEW_MS : fallback;
+    this.cachedToken = { token, refreshAt };
+    return token;
+  }
+  /** Send with the current credential; with a token provider, retry once with a fresh token after a 401. */
+  async authorizedFetch(url, init, extraHeaders) {
+    const send = async (forceRefresh) => this.fetchImpl(url, {
+      ...init,
+      headers: { Authorization: `Bearer ${await this.bearer(forceRefresh)}`, ...extraHeaders, ...init.headers || {} }
+    });
+    const response = await send(false);
+    if (response.status === 401 && this.getToken) {
+      this.cachedToken = null;
+      return send(true);
+    }
+    return response;
+  }
   /** GET a text body (CSV downloads). Errors are JSON, like every other route. */
   async requestText(path) {
-    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
-      method: "GET",
-      headers: { Authorization: `Bearer ${this.apiKey}` }
-    });
+    const response = await this.authorizedFetch(`${this.baseUrl}${path}`, { method: "GET" }, {});
     if (!response.ok) {
       const body = await response.json().catch(() => ({}));
       throw GroundmailError.fromResponse(response.status, body);
@@ -1580,14 +1646,7 @@ var Groundmail = class {
     return response.text();
   }
   async request(path, init) {
-    const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
-      ...init,
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        "Content-Type": "application/json",
-        ...init.headers || {}
-      }
-    });
+    const response = await this.authorizedFetch(`${this.baseUrl}${path}`, init, { "Content-Type": "application/json" });
     const body = await response.json().catch(() => ({}));
     if (!response.ok) {
       throw GroundmailError.fromResponse(response.status, body);
@@ -1595,6 +1654,33 @@ var Groundmail = class {
     return body;
   }
 };
+/** Two minutes of slack so a token never expires in flight. */
+_Groundmail.TOKEN_REFRESH_SKEW_MS = 2 * 60 * 1e3;
+/** Tokens with no known expiry are reused this long at most. */
+_Groundmail.TOKEN_DEFAULT_TTL_MS = 5 * 60 * 1e3;
+var Groundmail = _Groundmail;
+function normalizeAccessToken(value) {
+  if (!value) return { token: "", expiresAt: null };
+  if (typeof value === "string") return { token: value, expiresAt: jwtExpiry(value) };
+  const token = typeof value.token === "string" ? value.token : "";
+  let expiresAt = null;
+  if (typeof value.expiresOnTimestamp === "number") expiresAt = value.expiresOnTimestamp;
+  else if (value.expiresOn instanceof Date) expiresAt = value.expiresOn.getTime();
+  else if (typeof value.expiresOn === "number") expiresAt = value.expiresOn < 1e12 ? value.expiresOn * 1e3 : value.expiresOn;
+  return { token, expiresAt: expiresAt ?? jwtExpiry(token) };
+}
+function jwtExpiry(token) {
+  const part = token.split(".")[1];
+  if (!part) return null;
+  try {
+    const base64 = part.replace(/-/g, "+").replace(/_/g, "/");
+    const json = typeof atob === "function" ? atob(base64.padEnd(base64.length + (4 - base64.length % 4) % 4, "=")) : "";
+    const exp = JSON.parse(json).exp;
+    return typeof exp === "number" ? exp * 1e3 : null;
+  } catch {
+    return null;
+  }
+}
 
 export {
   GroundmailError,
@@ -1605,5 +1691,6 @@ export {
   buildSignatureHeader,
   verifyWebhookSignature,
   DEFAULT_API_BASE_URL,
-  Groundmail
+  Groundmail,
+  normalizeAccessToken
 };

package/dist/clerk.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail, S as SendEmailResult } from './client-CTG4zTKw.js';
+import { G as Groundmail, S as SendEmailResult } from './client-NSj8n5sB.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-QBGTN2WD.js";
+} from "./chunk-NQWM7F3N.js";
 
 // src/clerk.ts
 function resolveApiKey(options) {

package/dist/{client-CTG4zTKw.d.ts → client-NSj8n5sB.d.ts}

@@ -697,6 +697,43 @@ type CreateSuppressionParams = {
     /** Add to this tenant's own list (external id or Groundmail id) instead of the account's. */
     tenant?: string;
 };
+/** A category a reader can opt out of with a one-click unsubscribe. */
+type CategoryOptOutCategory = 'product' | 'newsletter';
+/**
+ * A category opt-out: the address unsubscribed from one category (product or
+ * newsletter email). Sends in that category to the address are refused with a 422.
+ */
+type CategoryOptOut = {
+    id: string;
+    type: 'category_opt_out';
+    email: string;
+    category: CategoryOptOutCategory | string;
+    /** The tenant's external id for a tenant's opt-out; `null` when account-wide. */
+    tenant: string | null;
+    created_at: string;
+    updated_at: string;
+};
+type ListCategoryOptOutsParams = {
+    limit?: number;
+    cursor?: string;
+    email?: string;
+    category?: CategoryOptOutCategory;
+    /** List this tenant's opt-outs instead of the account-wide ones. */
+    tenant?: string;
+    /** Without `tenant`: also list every tenant's opt-outs (each row carries its tenant). */
+    includeTenants?: boolean;
+};
+type ListCategoryOptOutsResult = {
+    data: CategoryOptOut[];
+    has_more: boolean;
+    next_cursor: string | null;
+};
+type RemoveCategoryOptOutOptions = {
+    /** Only this category; omit to remove every category for the address. */
+    category?: CategoryOptOutCategory;
+    /** Remove from this tenant's opt-outs instead of the account-wide ones. */
+    tenant?: string;
+};
 type TemplateStatus = 'draft' | 'published';
 type TemplateFormat = 'html' | 'blocks';
 type TemplateLintWarning = {
@@ -803,10 +840,31 @@ type UpdateTemplateParams = {
     /** Move it to this folder (created when missing); `null` or `''` takes it out of any folder. */
     folder?: string | null;
 };
+/**
+ * What a token provider may return: the token itself, or an object with the
+ * token and when it expires (the `AccessToken` shape `@azure/identity`'s
+ * `credential.getToken()` returns, so it can be passed straight through).
+ */
+type GroundmailAccessToken = string | {
+    token: string;
+    expiresOnTimestamp?: number;
+    expiresOn?: Date | number;
+};
+/**
+ * Returns a Bearer token for each request, instead of a fixed API key. Use it
+ * for keyless auth from Azure (a managed identity's Microsoft Entra token):
+ * `getToken: () => credential.getToken('api://…/.default')`. The SDK caches the
+ * token until two minutes before it expires and asks again after a 401.
+ */
+type GroundmailTokenProvider = () => GroundmailAccessToken | null | undefined | Promise<GroundmailAccessToken | null | undefined>;
 type GroundmailOptions = {
     baseUrl?: string;
     fetch?: typeof fetch;
 };
+/** `new Groundmail({ getToken })`: authenticate with a token provider instead of an API key. */
+type GroundmailTokenOptions = GroundmailOptions & {
+    getToken: GroundmailTokenProvider;
+};
 type DomainStatus = 'pending' | 'verified' | 'failed';
 type DomainTlsMode = 'opportunistic' | 'enforced';
 type DomainDmarcAnalysis = {
@@ -1539,6 +1597,20 @@ declare class SuppressionsResource {
     }): Promise<{
         ok: boolean;
     }>;
+    /**
+     * List category opt-outs: addresses that unsubscribed from product or
+     * newsletter email. Pass `tenant` for one tenant's opt-outs.
+     */
+    listCategoryOptOuts(params?: ListCategoryOptOutsParams): Promise<ListCategoryOptOutsResult>;
+    /**
+     * Remove a category opt-out by opt-out id or email address, so the address
+     * can receive that category again (for example after the reader re-subscribes).
+     * Throws a 404 error when nothing matches.
+     */
+    removeCategoryOptOut(idOrEmail: string, options?: RemoveCategoryOptOutOptions): Promise<{
+        ok: boolean;
+        deleted: number;
+    }>;
 }
 
 declare class TemplatesResource {
@@ -1667,8 +1739,6 @@ declare class WebhooksResource {
 
 declare const DEFAULT_API_BASE_URL = "https://api.groundmail.dev";
 declare class Groundmail {
-    private readonly apiKey;
-    private readonly options;
     readonly domains: DomainsResource;
     readonly emails: EmailsResource;
     readonly receivedEmails: ReceivedEmailsResource;
@@ -1686,7 +1756,16 @@ declare class Groundmail {
     readonly migrations: MigrationsResource;
     /** DMARC monitoring per domain: report address, sources, pass rates and readiness. */
     readonly dmarc: DmarcResource;
+    private readonly apiKey;
+    private readonly options;
+    private readonly getToken;
+    private cachedToken;
+    /**
+     * `new Groundmail('gm_…')` with an API key, or `new Groundmail({ getToken })`
+     * with a token provider (for example an Azure managed identity; no key).
+     */
     constructor(apiKey: string, options?: GroundmailOptions);
+    constructor(options: GroundmailTokenOptions);
     /**
      * Check one address with Groundmail validation before you accept it (for
      * example on a signup form): syntax, mail server, disposable and role
@@ -1695,9 +1774,21 @@ declare class Groundmail {
     validate(email: string): Promise<ValidateEmailResult>;
     get baseUrl(): string;
     get fetchImpl(): typeof fetch;
+    /** 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. */
+    private static readonly TOKEN_DEFAULT_TTL_MS;
+    private bearer;
+    /** Send with the current credential; with a token provider, retry once with a fresh token after a 401. */
+    private authorizedFetch;
     /** GET a text body (CSV downloads). Errors are JSON, like every other route. */
     requestText(path: string): Promise<string>;
     request<T>(path: string, init: RequestInit): Promise<T>;
 }
+/** A token provider's result → the token and its expiry (ms since epoch), if known. */
+declare function normalizeAccessToken(value: GroundmailAccessToken | null | undefined): {
+    token: string;
+    expiresAt: number | null;
+};
 
-export { type Domain as $, type ApiErrorBody as A, type BatchSendEmailResult as B, type CategoryUnsubscribedErrorDetails as C, type DnsRecord as D, type CreateSuppressionParams as E, type CreateTemplateParams as F, Groundmail as G, type CreateTenantParams as H, type CreateWebhookParams as I, DEFAULT_API_BASE_URL as J, type DailyRampLimitErrorDetails as K, type DeleteTenantResult as L, type DeliverabilityBucket as M, type DeliverabilityDomainInsight as N, type DeliverabilityInsightsResult as O, type DeliverabilityMailServerRelay as P, type DeliverabilityWindow as Q, type DmarcDailyPoint as R, type SendEmailResult as S, type DmarcMonitoring as T, type DmarcMonitoringDisabled as U, type DmarcReadiness as V, type DmarcReadinessVerdict as W, type DmarcSource as X, type DmarcSourceStatus as Y, type DmarcStatus as Z, type DnsProviderName as _, type ApiErrorCode as a, type TemplateStatus as a$, type DomainBimiAnalysis as a0, type DomainDetailResult as a1, type DomainDmarcAnalysis as a2, type DomainDnsAnalysis as a3, type DomainStatus as a4, type DomainTlsMode as a5, type DomainTrackingDns as a6, type DomainTrackingStatus as a7, type EmailListItem as a8, type EmailWebhookEventPayload as a9, type ListTenantsResult as aA, type MailServerSigningStatus as aB, type MailStream as aC, type Migration as aD, type MigrationDnsChange as aE, type MigrationDnsPlan as aF, type MigrationDomainItem as aG, type MigrationItemStatus as aH, type MigrationProvider as aI, type MigrationResource as aJ, type MigrationSummary as aK, type MigrationTemplateItem as aL, type MigrationTotals as aM, type MigrationWebhookItem as aN, type ReceivedEmail as aO, type ReceivedEmailAttachment as aP, type ReceivedEmailAttachmentMeta as aQ, type RemoteApplyDnsCredentials as aR, type RunMigrationOptions as aS, type SendEmailParams as aT, type StreamDeliverability as aU, type SuppressedErrorDetails as aV, type Suppression as aW, type Template as aX, type TemplateFormat as aY, type TemplateLintWarning as aZ, type TemplateStarter as a_, type EmailWebhookEventType as aa, type EnableDmarcParams as ab, type EnableDmarcResult as ac, type EnrollmentSkip as ad, type EventRecord as ae, type GroundmailOptions as af, type HeldBackErrorDetails as ag, type HeldBackReason as ah, type HeldBackRecipient as ai, type ListApiKeysParams as aj, type ListApiKeysResult as ak, type ListAutomationRunsParams as al, type ListAutomationRunsResult as am, type ListAutomationsResult as an, type ListDomainsParams as ao, type ListDomainsResult as ap, type ListEmailsParams as aq, type ListEmailsResult as ar, type ListReceivedEmailsParams as as, type ListReceivedEmailsResult as at, type ListSuppressionsParams as au, type ListSuppressionsResult as av, type ListTemplatesParams as aw, type ListTemplatesResult as ax, type ListTenantDomainsResult as ay, type ListTenantsParams as az, type ApiKey as b, type TemplateVersion as b0, type Tenant as b1, type TenantPauseSource as b2, type TenantRamp as b3, type TenantStats as b4, type TenantStatsResult as b5, type TenantStatus as b6, type TenantStreamPolicy as b7, type TestEmailWebhookParams as b8, type TestEmailWebhookResult as b9, type TriggerEventParams as ba, type TriggerEventResult as bb, type TwilioIntegrationResponse as bc, type TwilioIntegrationStatus as bd, type UpdateAutomationParams as be, type UpdateDomainParams as bf, type UpdateEmailParams as bg, type UpdateTemplateParams as bh, type UpdateTenantParams as bi, type UpdateWebhookParams as bj, type ValidateEmailResult as bk, type ValidationReason as bl, type ValidationVerdict as bm, type VerifyDomainResult as bn, type WebhookEmailTag as bo, type WebhookEndpoint as bp, type WebhookEndpointWithSecret as bq, type WebhookEventType as br, mergeMigrations as bs, type ApiKeyScope as c, type ApplyDnsParams as d, type ApplyDnsRecordResult as e, type ApplyDnsResult as f, type Asset as g, type Automation as h, type AutomationResult as i, type AutomationRun as j, type AutomationRunResponse as k, type AutomationRunStatus as l, type AutomationRunStep as m, type AutomationRunStepStatus as n, type AutomationStatus as o, type AutomationStep as p, type AutomationTrigger as q, type BounceType as r, type ConnectTwilioParams as s, type ContactWebhookEventPayload as t, type CreateApiKeyParams as u, type CreateApiKeyResult as v, type CreateAutomationParams as w, type CreateDomainParams as x, type CreateDomainResult as y, type CreateMigrationParams as z };
+export { type DmarcStatus as $, type ApiErrorBody as A, type BatchSendEmailResult as B, type CategoryOptOut as C, type DnsRecord as D, type CreateDomainResult as E, type CreateMigrationParams as F, Groundmail as G, type CreateSuppressionParams as H, type CreateTemplateParams as I, type CreateTenantParams as J, type CreateWebhookParams as K, DEFAULT_API_BASE_URL as L, type DailyRampLimitErrorDetails as M, type DeleteTenantResult as N, type DeliverabilityBucket as O, type DeliverabilityDomainInsight as P, type DeliverabilityInsightsResult as Q, type DeliverabilityMailServerRelay as R, type SendEmailResult as S, type DeliverabilityWindow as T, type DmarcDailyPoint as U, type DmarcMonitoring as V, type DmarcMonitoringDisabled as W, type DmarcReadiness as X, type DmarcReadinessVerdict as Y, type DmarcSource as Z, type DmarcSourceStatus as _, type ApiErrorCode as a, type SendEmailParams as a$, type DnsProviderName as a0, type Domain as a1, type DomainBimiAnalysis as a2, type DomainDetailResult as a3, type DomainDmarcAnalysis as a4, type DomainDnsAnalysis as a5, type DomainStatus as a6, type DomainTlsMode as a7, type DomainTrackingDns as a8, type DomainTrackingStatus as a9, type ListReceivedEmailsResult as aA, type ListSuppressionsParams as aB, type ListSuppressionsResult as aC, type ListTemplatesParams as aD, type ListTemplatesResult as aE, type ListTenantDomainsResult as aF, type ListTenantsParams as aG, type ListTenantsResult as aH, type MailServerSigningStatus as aI, type MailStream as aJ, type Migration as aK, type MigrationDnsChange as aL, type MigrationDnsPlan as aM, type MigrationDomainItem as aN, type MigrationItemStatus as aO, type MigrationProvider as aP, type MigrationResource as aQ, type MigrationSummary as aR, type MigrationTemplateItem as aS, type MigrationTotals as aT, type MigrationWebhookItem as aU, type ReceivedEmail as aV, type ReceivedEmailAttachment as aW, type ReceivedEmailAttachmentMeta as aX, type RemoteApplyDnsCredentials as aY, type RemoveCategoryOptOutOptions as aZ, type RunMigrationOptions as a_, type EmailListItem as aa, type EmailWebhookEventPayload as ab, type EmailWebhookEventType as ac, type EnableDmarcParams as ad, type EnableDmarcResult as ae, type EnrollmentSkip as af, type EventRecord as ag, type GroundmailAccessToken as ah, type GroundmailOptions as ai, type GroundmailTokenOptions as aj, type GroundmailTokenProvider as ak, type HeldBackErrorDetails as al, type HeldBackReason as am, type HeldBackRecipient as an, type ListApiKeysParams as ao, type ListApiKeysResult as ap, type ListAutomationRunsParams as aq, type ListAutomationRunsResult as ar, type ListAutomationsResult as as, type ListCategoryOptOutsParams as at, type ListCategoryOptOutsResult as au, type ListDomainsParams as av, type ListDomainsResult as aw, type ListEmailsParams as ax, type ListEmailsResult as ay, type ListReceivedEmailsParams as az, type ApiKey as b, type StreamDeliverability as b0, type SuppressedErrorDetails as b1, type Suppression as b2, type Template as b3, type TemplateFormat as b4, type TemplateLintWarning as b5, type TemplateStarter as b6, type TemplateStatus as b7, type TemplateVersion as b8, type Tenant as b9, mergeMigrations as bA, normalizeAccessToken as bB, type TenantPauseSource as ba, type TenantRamp as bb, type TenantStats as bc, type TenantStatsResult as bd, type TenantStatus as be, type TenantStreamPolicy as bf, type TestEmailWebhookParams as bg, type TestEmailWebhookResult as bh, type TriggerEventParams as bi, type TriggerEventResult as bj, type TwilioIntegrationResponse as bk, type TwilioIntegrationStatus as bl, type UpdateAutomationParams as bm, type UpdateDomainParams as bn, type UpdateEmailParams as bo, type UpdateTemplateParams as bp, type UpdateTenantParams as bq, type UpdateWebhookParams as br, type ValidateEmailResult as bs, type ValidationReason as bt, type ValidationVerdict as bu, type VerifyDomainResult as bv, type WebhookEmailTag as bw, type WebhookEndpoint as bx, type WebhookEndpointWithSecret as by, type WebhookEventType as bz, type ApiKeyScope as c, type ApplyDnsParams as d, type ApplyDnsRecordResult as e, type ApplyDnsResult as f, type Asset as g, type Automation as h, type AutomationResult as i, type AutomationRun as j, type AutomationRunResponse as k, type AutomationRunStatus as l, type AutomationRunStep as m, type AutomationRunStepStatus as n, type AutomationStatus as o, type AutomationStep as p, type AutomationTrigger as q, type BounceType as r, type CategoryOptOutCategory as s, type CategoryUnsubscribedErrorDetails as t, type ConnectTwilioParams as u, type ContactWebhookEventPayload as v, type CreateApiKeyParams as w, type CreateApiKeyResult as x, type CreateAutomationParams as y, type CreateDomainParams as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ApiErrorBody, D as DnsRecord } from './client-CTG4zTKw.js';
-export { a as ApiErrorCode, b as ApiKey, c as ApiKeyScope, d as ApplyDnsParams, e as ApplyDnsRecordResult, f as ApplyDnsResult, g as Asset, h as Automation, i as AutomationResult, j as AutomationRun, k as AutomationRunResponse, l as AutomationRunStatus, m as AutomationRunStep, n as AutomationRunStepStatus, o as AutomationStatus, p as AutomationStep, q as AutomationTrigger, B as BatchSendEmailResult, r as BounceType, C as CategoryUnsubscribedErrorDetails, s as ConnectTwilioParams, t as ContactWebhookEventPayload, u as CreateApiKeyParams, v as CreateApiKeyResult, w as CreateAutomationParams, x as CreateDomainParams, y as CreateDomainResult, z as CreateMigrationParams, E as CreateSuppressionParams, F as CreateTemplateParams, H as CreateTenantParams, I as CreateWebhookParams, J as DEFAULT_API_BASE_URL, K as DailyRampLimitErrorDetails, L as DeleteTenantResult, M as DeliverabilityBucket, N as DeliverabilityDomainInsight, O as DeliverabilityInsightsResult, P as DeliverabilityMailServerRelay, Q as DeliverabilityWindow, R as DmarcDailyPoint, T as DmarcMonitoring, U as DmarcMonitoringDisabled, V as DmarcReadiness, W as DmarcReadinessVerdict, X as DmarcSource, Y as DmarcSourceStatus, Z as DmarcStatus, _ as DnsProviderName, $ as Domain, a0 as DomainBimiAnalysis, a1 as DomainDetailResult, a2 as DomainDmarcAnalysis, a3 as DomainDnsAnalysis, a4 as DomainStatus, a5 as DomainTlsMode, a6 as DomainTrackingDns, a7 as DomainTrackingStatus, a8 as EmailListItem, a9 as EmailWebhookEventPayload, aa as EmailWebhookEventType, ab as EnableDmarcParams, ac as EnableDmarcResult, ad as EnrollmentSkip, ae as EventRecord, G as Groundmail, af as GroundmailOptions, ag as HeldBackErrorDetails, ah as HeldBackReason, ai as HeldBackRecipient, aj as ListApiKeysParams, ak as ListApiKeysResult, al as ListAutomationRunsParams, am as ListAutomationRunsResult, an as ListAutomationsResult, ao as ListDomainsParams, ap as ListDomainsResult, aq as ListEmailsParams, ar as ListEmailsResult, as as ListReceivedEmailsParams, at as ListReceivedEmailsResult, au as ListSuppressionsParams, av as ListSuppressionsResult, aw as ListTemplatesParams, ax as ListTemplatesResult, ay as ListTenantDomainsResult, az as ListTenantsParams, aA as ListTenantsResult, aB as MailServerSigningStatus, aC as MailStream, aD as Migration, aE as MigrationDnsChange, aF as MigrationDnsPlan, aG as MigrationDomainItem, aH as MigrationItemStatus, aI as MigrationProvider, aJ as MigrationResource, aK as MigrationSummary, aL as MigrationTemplateItem, aM as MigrationTotals, aN as MigrationWebhookItem, aO as ReceivedEmail, aP as ReceivedEmailAttachment, aQ as ReceivedEmailAttachmentMeta, aR as RemoteApplyDnsCredentials, aS as RunMigrationOptions, aT as SendEmailParams, S as SendEmailResult, aU as StreamDeliverability, aV as SuppressedErrorDetails, aW as Suppression, aX as Template, aY as TemplateFormat, aZ as TemplateLintWarning, a_ as TemplateStarter, a$ as TemplateStatus, b0 as TemplateVersion, b1 as Tenant, b2 as TenantPauseSource, b3 as TenantRamp, b4 as TenantStats, b5 as TenantStatsResult, b6 as TenantStatus, b7 as TenantStreamPolicy, b8 as TestEmailWebhookParams, b9 as TestEmailWebhookResult, ba as TriggerEventParams, bb as TriggerEventResult, bc as TwilioIntegrationResponse, bd as TwilioIntegrationStatus, be as UpdateAutomationParams, bf as UpdateDomainParams, bg as UpdateEmailParams, bh as UpdateTemplateParams, bi as UpdateTenantParams, bj as UpdateWebhookParams, bk as ValidateEmailResult, bl as ValidationReason, bm as ValidationVerdict, bn as VerifyDomainResult, bo as WebhookEmailTag, bp as WebhookEndpoint, bq as WebhookEndpointWithSecret, br as WebhookEventType, bs as mergeMigrations } from './client-CTG4zTKw.js';
+import { A as ApiErrorBody, D as DnsRecord } from './client-NSj8n5sB.js';
+export { a as ApiErrorCode, b as ApiKey, c as ApiKeyScope, d as ApplyDnsParams, e as ApplyDnsRecordResult, f as ApplyDnsResult, g as Asset, h as Automation, i as AutomationResult, j as AutomationRun, k as AutomationRunResponse, l as AutomationRunStatus, m as AutomationRunStep, n as AutomationRunStepStatus, o as AutomationStatus, p as AutomationStep, q as AutomationTrigger, B as BatchSendEmailResult, r as BounceType, C as CategoryOptOut, s as CategoryOptOutCategory, t as CategoryUnsubscribedErrorDetails, u as ConnectTwilioParams, v as ContactWebhookEventPayload, w as CreateApiKeyParams, x as CreateApiKeyResult, y as CreateAutomationParams, z as CreateDomainParams, E as CreateDomainResult, F as CreateMigrationParams, H as CreateSuppressionParams, I as CreateTemplateParams, J as CreateTenantParams, K as CreateWebhookParams, L as DEFAULT_API_BASE_URL, M as DailyRampLimitErrorDetails, N as DeleteTenantResult, O as DeliverabilityBucket, P as DeliverabilityDomainInsight, Q as DeliverabilityInsightsResult, R as DeliverabilityMailServerRelay, T as DeliverabilityWindow, U as DmarcDailyPoint, V as DmarcMonitoring, W as DmarcMonitoringDisabled, X as DmarcReadiness, Y as DmarcReadinessVerdict, Z as DmarcSource, _ as DmarcSourceStatus, $ as DmarcStatus, a0 as DnsProviderName, a1 as Domain, a2 as DomainBimiAnalysis, a3 as DomainDetailResult, a4 as DomainDmarcAnalysis, a5 as DomainDnsAnalysis, a6 as DomainStatus, a7 as DomainTlsMode, a8 as DomainTrackingDns, a9 as DomainTrackingStatus, aa as EmailListItem, ab as EmailWebhookEventPayload, ac as EmailWebhookEventType, ad as EnableDmarcParams, ae as EnableDmarcResult, af as EnrollmentSkip, ag as EventRecord, G as Groundmail, ah as GroundmailAccessToken, ai as GroundmailOptions, aj as GroundmailTokenOptions, ak as GroundmailTokenProvider, al as HeldBackErrorDetails, am as HeldBackReason, an as HeldBackRecipient, ao as ListApiKeysParams, ap as ListApiKeysResult, aq as ListAutomationRunsParams, ar as ListAutomationRunsResult, as as ListAutomationsResult, at as ListCategoryOptOutsParams, au as ListCategoryOptOutsResult, av as ListDomainsParams, aw as ListDomainsResult, ax as ListEmailsParams, ay as ListEmailsResult, az as ListReceivedEmailsParams, aA as ListReceivedEmailsResult, aB as ListSuppressionsParams, aC as ListSuppressionsResult, aD as ListTemplatesParams, aE as ListTemplatesResult, aF as ListTenantDomainsResult, aG as ListTenantsParams, aH as ListTenantsResult, aI as MailServerSigningStatus, aJ as MailStream, aK as Migration, aL as MigrationDnsChange, aM as MigrationDnsPlan, aN as MigrationDomainItem, aO as MigrationItemStatus, aP as MigrationProvider, aQ as MigrationResource, aR as MigrationSummary, aS as MigrationTemplateItem, aT as MigrationTotals, aU as MigrationWebhookItem, aV as ReceivedEmail, aW as ReceivedEmailAttachment, aX as ReceivedEmailAttachmentMeta, aY as RemoteApplyDnsCredentials, aZ as RemoveCategoryOptOutOptions, a_ as RunMigrationOptions, a$ as SendEmailParams, S as SendEmailResult, b0 as StreamDeliverability, b1 as SuppressedErrorDetails, b2 as Suppression, b3 as Template, b4 as TemplateFormat, b5 as TemplateLintWarning, b6 as TemplateStarter, b7 as TemplateStatus, b8 as TemplateVersion, b9 as Tenant, ba as TenantPauseSource, bb as TenantRamp, bc as TenantStats, bd as TenantStatsResult, be as TenantStatus, bf as TenantStreamPolicy, bg as TestEmailWebhookParams, bh as TestEmailWebhookResult, bi as TriggerEventParams, bj as TriggerEventResult, bk as TwilioIntegrationResponse, bl as TwilioIntegrationStatus, bm as UpdateAutomationParams, bn as UpdateDomainParams, bo as UpdateEmailParams, bp as UpdateTemplateParams, bq as UpdateTenantParams, br as UpdateWebhookParams, bs as ValidateEmailResult, bt as ValidationReason, bu as ValidationVerdict, bv as VerifyDomainResult, bw as WebhookEmailTag, bx as WebhookEndpoint, by as WebhookEndpointWithSecret, bz as WebhookEventType, bA as mergeMigrations, bB as normalizeAccessToken } from './client-NSj8n5sB.js';
 
 type GroundmailErrorOptions = {
     code?: string;

package/dist/index.js

@@ -6,9 +6,10 @@ import {
   buildSignatureHeader,
   mergeMigrations,
   mergeSpfInclude,
+  normalizeAccessToken,
   signWebhookPayload,
   verifyWebhookSignature
-} from "./chunk-QBGTN2WD.js";
+} from "./chunk-NQWM7F3N.js";
 
 // src/simulator.ts
 var SIMULATOR_DOMAIN = "simulator.groundmail.dev";
@@ -42,6 +43,7 @@ export {
   isTestApiKey,
   mergeMigrations,
   mergeSpfInclude,
+  normalizeAccessToken,
   signWebhookPayload,
   simulatorAddress,
   verifyWebhookSignature

package/dist/payload.d.ts

@@ -1,4 +1,4 @@
-import { G as Groundmail } from './client-CTG4zTKw.js';
+import { G as Groundmail } from './client-NSj8n5sB.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-QBGTN2WD.js";
+} from "./chunk-NQWM7F3N.js";
 
 // src/payload.ts
 function resolveApiKey(args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Groundmail transactional email API client",
   "license": "MIT",
   "type": "module",
@@ -89,7 +89,7 @@
     "prepublishOnly": "npm run build && npm run build:nodemailer-bridge"
   },
   "dependencies": {
-    "groundmail-nodemailer": "0.15.9"
+    "groundmail-nodemailer": "0.15.11"
   },
   "devDependencies": {
     "@types/nodemailer": "^8.0.1",