@usehercules/sdk 1.14.3 → 1.14.5

package/resources/index.d.mts

@@ -1,7 +1,7 @@
 export { Commerce, type Currency, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.mjs";
 export { Content } from "./content/content.mjs";
 export { Domains, type Domain, type DomainListParams, type DomainsCursorIDPage } from "./domains.mjs";
-export { EmailResource, type Attachment, type Email, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email/email.mjs";
+export { EmailResource, type Attachment, type Email, type EmailGetResponse, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email/email.mjs";
 export { Files, type File, type Upload, type FileListParams, type FilesCursorIDPage } from "./files.mjs";
 export { PushNotifications, type PushNotificationEnableResponse, type PushNotificationIdentifyResponse, type PushNotificationSendResponse, type PushNotificationSubscribeResponse, type PushNotificationUnsubscribeResponse, type PushNotificationIdentifyParams, type PushNotificationSendParams, type PushNotificationSubscribeParams, type PushNotificationUnsubscribeParams, } from "./push-notifications/push-notifications.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE;OACzE,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE;OACzE,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}

package/resources/index.d.ts

@@ -1,7 +1,7 @@
 export { Commerce, type Currency, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/commerce.js";
 export { Content } from "./content/content.js";
 export { Domains, type Domain, type DomainListParams, type DomainsCursorIDPage } from "./domains.js";
-export { EmailResource, type Attachment, type Email, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email/email.js";
+export { EmailResource, type Attachment, type Email, type EmailGetResponse, type EmailSendResponse, type EmailListParams, type EmailSendParams, type EmailsCursorIDPage, } from "./email/email.js";
 export { Files, type File, type Upload, type FileListParams, type FilesCursorIDPage } from "./files.js";
 export { PushNotifications, type PushNotificationEnableResponse, type PushNotificationIdentifyResponse, type PushNotificationSendResponse, type PushNotificationSubscribeResponse, type PushNotificationUnsubscribeResponse, type PushNotificationIdentifyParams, type PushNotificationSendParams, type PushNotificationSubscribeParams, type PushNotificationUnsubscribeParams, } from "./push-notifications/push-notifications.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE;OACzE,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE;OACzE,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB;OACM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE;OAC9E,EACL,iBAAiB,EACjB,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,+BAA+B,EACpC,KAAK,iCAAiC,GACvC"}

package/resources/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mDAS6B;AAR3B,oGAAA,QAAQ,OAAA;AASV,gDAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,wCAAkG;AAAzF,kGAAA,OAAO,OAAA;AAChB,0CAQuB;AAPrB,sGAAA,aAAa,OAAA;AAQf,oCAAqG;AAA5F,8FAAA,KAAK,OAAA;AACd,iFAWiD;AAV/C,uHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mDAS6B;AAR3B,oGAAA,QAAQ,OAAA;AASV,gDAA4C;AAAnC,kGAAA,OAAO,OAAA;AAChB,wCAAkG;AAAzF,kGAAA,OAAO,OAAA;AAChB,0CASuB;AARrB,sGAAA,aAAa,OAAA;AASf,oCAAqG;AAA5F,8FAAA,KAAK,OAAA;AACd,iFAWiD;AAV/C,uHAAA,iBAAiB,OAAA"}

package/resources/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAQT;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAgE;OACzE,EACL,aAAa,GAOd;OACM,EAAE,KAAK,EAAuE;OAC9E,EACL,iBAAiB,GAUlB"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/resources/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,QAAQ,GAQT;OACM,EAAE,OAAO,EAAE;OACX,EAAE,OAAO,EAAgE;OACzE,EACL,aAAa,GAQd;OACM,EAAE,KAAK,EAAuE;OAC9E,EACL,iBAAiB,GAUlB"}

package/src/client.ts

@@ -11,7 +11,7 @@ import type { APIResponseProps } from './internal/parse';
 import { getPlatformHeaders } from './internal/detect-platform';
 import * as Shims from './internal/shims';
 import * as Opts from './internal/request-options';
-import * as qs from './internal/qs';
+import { stringifyQuery } from './internal/utils/query';
 import { VERSION } from './version';
 import * as Errors from './core/error';
 import * as Pagination from './core/pagination';
@@ -35,6 +35,7 @@ import { Content } from './resources/content/content';
 import {
   Attachment,
   Email,
+  EmailGetResponse,
   EmailListParams,
   EmailResource,
   EmailSendParams,
@@ -263,8 +264,8 @@ export class Hercules {
     return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
   }
 
-  protected stringifyQuery(query: Record<string, unknown>): string {
-    return qs.stringify(query, { arrayFormat: 'comma' });
+  protected stringifyQuery(query: object | Record<string, unknown>): string {
+    return stringifyQuery(query);
   }
 
   private getUserAgent(): string {
@@ -296,12 +297,13 @@ export class Hercules {
       : new URL(baseURL + (baseURL.endsWith('/') && path.startsWith('/') ? path.slice(1) : path));
 
     const defaultQuery = this.defaultQuery();
-    if (!isEmptyObj(defaultQuery)) {
-      query = { ...defaultQuery, ...query };
+    const pathQuery = Object.fromEntries(url.searchParams);
+    if (!isEmptyObj(defaultQuery) || !isEmptyObj(pathQuery)) {
+      query = { ...pathQuery, ...defaultQuery, ...query };
     }
 
     if (typeof query === 'object' && query && !Array.isArray(query)) {
-      url.search = this.stringifyQuery(query as Record<string, unknown>);
+      url.search = this.stringifyQuery(query);
     }
 
     return url.toString();
@@ -630,9 +632,9 @@ export class Hercules {
       }
     }
 
-    // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-    // just do what it says, but otherwise calculate a default
-    if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+    // If the API asks us to wait a certain amount of time, just do what it
+    // says, but otherwise calculate a default
+    if (timeoutMillis === undefined) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -759,6 +761,14 @@ export class Hercules {
         (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))
     ) {
       return { bodyHeaders: undefined, body: Shims.ReadableStreamFrom(body as AsyncIterable<Uint8Array>) };
+    } else if (
+      typeof body === 'object' &&
+      headers.values.get('content-type') === 'application/x-www-form-urlencoded'
+    ) {
+      return {
+        bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
+        body: this.stringifyQuery(body),
+      };
     } else {
       return this.#encoder({ body, headers });
     }
@@ -848,6 +858,7 @@ export declare namespace Hercules {
     EmailResource as EmailResource,
     type Attachment as Attachment,
     type Email as Email,
+    type EmailGetResponse as EmailGetResponse,
     type EmailSendResponse as EmailSendResponse,
     type EmailsCursorIDPage as EmailsCursorIDPage,
     type EmailListParams as EmailListParams,

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/internal/utils/query.ts

@@ -0,0 +1,7 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import * as qs from '../qs/stringify';
+
+export function stringifyQuery(query: object | Record<string, unknown>) {
+  return qs.stringify(query, { arrayFormat: 'comma' });
+}

package/src/internal/utils.ts

@@ -6,3 +6,4 @@ export * from './utils/env';
 export * from './utils/log';
 export * from './utils/uuid';
 export * from './utils/sleep';
+export * from './utils/query';

package/src/resources/commerce/coupons.ts

@@ -35,11 +35,7 @@ export class Coupons extends APIResource {
    * );
    * ```
    */
-  update(
-    couponID: string,
-    body: CouponUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Coupon> {
+  update(couponID: string, body: CouponUpdateParams, options?: RequestOptions): APIPromise<Coupon> {
     return this._client.patch(path`/v1/commerce/coupons/${couponID}`, { body, ...options });
   }
 

package/src/resources/commerce/customers.ts

@@ -18,7 +18,7 @@ export class Customers extends APIResource {
    * const customer = await client.commerce.customers.create();
    * ```
    */
-  create(body: CustomerCreateParams | null | undefined = {}, options?: RequestOptions): APIPromise<Customer> {
+  create(body: CustomerCreateParams, options?: RequestOptions): APIPromise<Customer> {
     return this._client.post('/v1/commerce/customers', { body, ...options });
   }
 
@@ -33,11 +33,7 @@ export class Customers extends APIResource {
    * );
    * ```
    */
-  update(
-    customerID: string,
-    body: CustomerUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Customer> {
+  update(customerID: string, body: CustomerUpdateParams, options?: RequestOptions): APIPromise<Customer> {
     return this._client.patch(path`/v1/commerce/customers/${customerID}`, { body, ...options });
   }
 
@@ -75,7 +71,7 @@ export class Customers extends APIResource {
    */
   billingPortal(
     customerID: string,
-    body: CustomerBillingPortalParams | null | undefined = {},
+    body: CustomerBillingPortalParams,
     options?: RequestOptions,
   ): APIPromise<CustomerBillingPortalResponse> {
     return this._client.post(path`/v1/commerce/customers/${customerID}/billing_portal`, { body, ...options });

package/src/resources/commerce/features.ts

@@ -33,11 +33,7 @@ export class Features extends APIResource {
    * );
    * ```
    */
-  update(
-    featureID: string,
-    body: FeatureUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Feature> {
+  update(featureID: string, body: FeatureUpdateParams, options?: RequestOptions): APIPromise<Feature> {
     return this._client.patch(path`/v1/commerce/features/${featureID}`, { body, ...options });
   }
 

package/src/resources/commerce/products/products.ts

@@ -61,11 +61,7 @@ export class Products extends APIResource {
    * );
    * ```
    */
-  update(
-    productID: string,
-    body: ProductUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Product> {
+  update(productID: string, body: ProductUpdateParams, options?: RequestOptions): APIPromise<Product> {
     return this._client.patch(path`/v1/commerce/products/${productID}`, { body, ...options });
   }
 

package/src/resources/content/assets.ts

@@ -21,11 +21,7 @@ export class Assets extends APIResource {
    * Updates asset metadata including URL, folder, title, description, and custom
    * metadata.
    */
-  update(
-    assetID: string,
-    body: AssetUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Asset> {
+  update(assetID: string, body: AssetUpdateParams, options?: RequestOptions): APIPromise<Asset> {
     return this._client.patch(path`/v1/content/assets/${assetID}`, { body, ...options });
   }
 

package/src/resources/content/collections/collections.ts

@@ -26,7 +26,7 @@ export class Collections extends APIResource {
    */
   update(
     collectionID: string,
-    body: CollectionUpdateParams | null | undefined = {},
+    body: CollectionUpdateParams,
     options?: RequestOptions,
   ): APIPromise<Collection> {
     return this._client.patch(path`/v1/content/collections/${collectionID}`, { body, ...options });

package/src/resources/content/entries.ts

@@ -20,11 +20,7 @@ export class Entries extends APIResource {
    * fields are modified. Use the version parameter for optimistic locking to prevent
    * concurrent update conflicts.
    */
-  update(
-    entryID: string,
-    body: EntryUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Entry> {
+  update(entryID: string, body: EntryUpdateParams, options?: RequestOptions): APIPromise<Entry> {
     return this._client.patch(path`/v1/content/entries/${entryID}`, { body, ...options });
   }
 
@@ -61,11 +57,7 @@ export class Entries extends APIResource {
    * publishing for a future time. Publishing validates that all required fields have
    * values.
    */
-  publish(
-    entryID: string,
-    body: EntryPublishParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Entry> {
+  publish(entryID: string, body: EntryPublishParams, options?: RequestOptions): APIPromise<Entry> {
     return this._client.post(path`/v1/content/entries/${entryID}/publish`, { body, ...options });
   }
 
@@ -101,16 +93,11 @@ export interface Entry {
   created: string;
 
   /**
-   * Field values. For localized fields: { fieldApiId: { locale: value } }. For
-   * non-localized: { fieldApiId: value }
+   * Field values. Localization is field-level: localized fields use { fieldApiId: {
+   * locale: value } }, non-localized use { fieldApiId: value }.
    */
   fields: { [key: string]: unknown };
 
-  /**
-   * Primary locale for this entry
-   */
-  locale: string;
-
   /**
    * Publishing status: draft, published, or archived
    */
@@ -165,16 +152,11 @@ export interface EntryCreateParams {
   id?: string;
 
   /**
-   * Field values. For localized fields: { fieldApiId: { locale: value } }. For
-   * non-localized: { fieldApiId: value }
+   * Field values. Localization is field-level: localized fields use { fieldApiId: {
+   * locale: value } }, non-localized use { fieldApiId: value }.
    */
   fields?: { [key: string]: unknown };
 
-  /**
-   * Primary locale for this entry
-   */
-  locale?: string;
-
   /**
    * Initial status (default: draft)
    */
@@ -188,11 +170,6 @@ export interface EntryUpdateParams {
    */
   fields?: { [key: string]: unknown };
 
-  /**
-   * Primary locale
-   */
-  locale?: string;
-
   /**
    * Expected version for optimistic locking. Update fails if version mismatch.
    */
@@ -215,11 +192,6 @@ export interface EntryListParams extends CursorIDPageParams {
    */
   include_depth?: number;
 
-  /**
-   * Filter by primary locale
-   */
-  locale?: string;
-
   /**
    * JSON-encoded sort order. Example: {"field":"publishedAt","direction":"desc"}
    */

package/src/resources/content/locales.ts

@@ -20,11 +20,7 @@ export class Locales extends APIResource {
    * Updates a locale's configuration including name, fallback, default status, and
    * active status.
    */
-  update(
-    localeCode: string,
-    body: LocaleUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Locale> {
+  update(localeCode: string, body: LocaleUpdateParams, options?: RequestOptions): APIPromise<Locale> {
     return this._client.patch(path`/v1/content/locales/${localeCode}`, { body, ...options });
   }
 

package/src/resources/content/releases/releases.ts

@@ -23,11 +23,7 @@ export class Releases extends APIResource {
   /**
    * Updates a release name and description. Only draft releases can be updated.
    */
-  update(
-    releaseID: string,
-    body: ReleaseUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Release> {
+  update(releaseID: string, body: ReleaseUpdateParams, options?: RequestOptions): APIPromise<Release> {
     return this._client.patch(path`/v1/content/releases/${releaseID}`, { body, ...options });
   }
 

package/src/resources/email/email.ts

@@ -8,6 +8,7 @@ import {
   Identity,
   IdentityCreateParams,
   IdentityListParams,
+  IdentityVerifyParams,
 } from './identities';
 import { APIPromise } from '../../core/api-promise';
 import { CursorIDPage, type CursorIDPageParams, PagePromise } from '../../core/pagination';
@@ -35,7 +36,7 @@ export class EmailResource extends APIResource {
   /**
    * Retrieves a single email by its unique identifier.
    */
-  get(emailID: string, options?: RequestOptions): APIPromise<Email> {
+  get(emailID: string, options?: RequestOptions): APIPromise<EmailGetResponse> {
     return this._client.get(path`/v1/email/${emailID}`, options);
   }
 
@@ -120,6 +121,66 @@ export interface Email {
   reply_to?: Array<string> | null;
 }
 
+/**
+ * A sent email object with full body content
+ */
+export interface EmailGetResponse {
+  /**
+   * Unique identifier for the email
+   */
+  id: string;
+
+  /**
+   * Timestamp when the email was sent
+   */
+  created_at: string;
+
+  /**
+   * Sender email address
+   */
+  from: string;
+
+  /**
+   * Email subject line
+   */
+  subject: string;
+
+  /**
+   * Recipient email addresses
+   */
+  to: Array<string>;
+
+  /**
+   * Blind carbon copy recipients
+   */
+  bcc?: Array<string> | null;
+
+  /**
+   * Carbon copy recipients
+   */
+  cc?: Array<string> | null;
+
+  /**
+   * The HTML version of the message body
+   */
+  html?: string | null;
+
+  /**
+   * The most recent event for this email
+   */
+  last_event?: 'sent' | 'delivered' | 'opened' | 'clicked' | 'bounced' | 'complained' | null;
+
+  /**
+   * Reply-to addresses
+   */
+  reply_to?: Array<string> | null;
+
+  /**
+   * The plain text version of the message body
+   */
+  text?: string | null;
+}
+
 /**
  * Response after sending an email
  */
@@ -213,6 +274,7 @@ export declare namespace EmailResource {
   export {
     type Attachment as Attachment,
     type Email as Email,
+    type EmailGetResponse as EmailGetResponse,
     type EmailSendResponse as EmailSendResponse,
     type EmailsCursorIDPage as EmailsCursorIDPage,
     type EmailListParams as EmailListParams,
@@ -225,5 +287,6 @@ export declare namespace EmailResource {
     type IdentitiesCursorIDPage as IdentitiesCursorIDPage,
     type IdentityCreateParams as IdentityCreateParams,
     type IdentityListParams as IdentityListParams,
+    type IdentityVerifyParams as IdentityVerifyParams,
   };
 }

package/src/resources/email/identities.ts

@@ -51,8 +51,8 @@ export class Identities extends APIResource {
    * Triggers a manual recheck of the identity's verification status against AWS SES.
    * Returns the identity with its updated status.
    */
-  verify(identityID: string, options?: RequestOptions): APIPromise<Identity> {
-    return this._client.post(path`/v1/email/identities/${identityID}/verify`, options);
+  verify(identityID: string, body: IdentityVerifyParams, options?: RequestOptions): APIPromise<Identity> {
+    return this._client.post(path`/v1/email/identities/${identityID}/verify`, { body, ...options });
   }
 }
 
@@ -72,6 +72,11 @@ export interface Identity {
    */
   created_at: string;
 
+  /**
+   * Whether a custom MAIL FROM domain is enabled for SPF alignment
+   */
+  mail_from_enabled: boolean;
+
   /**
    * The verification status of the identity
    */
@@ -88,6 +93,12 @@ export interface Identity {
    */
   value: string;
 
+  /**
+   * The subdomain prefix used for the custom MAIL FROM domain (e.g. 'mail' for
+   * mail.yourdomain.com)
+   */
+  mail_from_subdomain?: string | null;
+
   /**
    * DNS records required for verification (only present for domain identities)
    */
@@ -126,26 +137,62 @@ export namespace Identity {
   }
 }
 
-export interface IdentityCreateParams {
-  /**
-   * The type of identity to create. Use 'email' for a single address or 'domain' for
-   * an entire domain.
-   */
-  type: 'email' | 'domain';
+export type IdentityCreateParams = IdentityCreateParams.Variant0 | IdentityCreateParams.Variant1;
 
-  /**
-   * The email address or domain name to verify
-   */
-  value: string;
+export declare namespace IdentityCreateParams {
+  export interface Variant0 {
+    /**
+     * Create an email address identity
+     */
+    type: 'email';
+
+    /**
+     * The email address to verify
+     */
+    value: string;
+  }
+
+  export interface Variant1 {
+    /**
+     * Create a domain identity
+     */
+    type: 'domain';
+
+    /**
+     * The domain name to verify
+     */
+    value: string;
+
+    /**
+     * Enable a custom MAIL FROM domain for SPF alignment. When enabled, additional DNS
+     * records are required.
+     */
+    mail_from_enabled?: boolean;
+
+    /**
+     * The subdomain prefix for the custom MAIL FROM domain (e.g. 'mail' for
+     * mail.yourdomain.com). Defaults to 'mail'.
+     */
+    mail_from_subdomain?: string;
+  }
 }
 
 export interface IdentityListParams extends CursorIDPageParams {}
 
+export interface IdentityVerifyParams {
+  /**
+   * If true and the identity is an unverified email address, resend the verification
+   * email.
+   */
+  resend?: boolean;
+}
+
 export declare namespace Identities {
   export {
     type Identity as Identity,
     type IdentitiesCursorIDPage as IdentitiesCursorIDPage,
     type IdentityCreateParams as IdentityCreateParams,
     type IdentityListParams as IdentityListParams,
+    type IdentityVerifyParams as IdentityVerifyParams,
   };
 }

package/src/resources/email/index.ts

@@ -4,6 +4,7 @@ export {
   EmailResource,
   type Attachment,
   type Email,
+  type EmailGetResponse,
   type EmailSendResponse,
   type EmailListParams,
   type EmailSendParams,
@@ -14,5 +15,6 @@ export {
   type Identity,
   type IdentityCreateParams,
   type IdentityListParams,
+  type IdentityVerifyParams,
   type IdentitiesCursorIDPage,
 } from './identities';

package/src/resources/index.ts

@@ -16,6 +16,7 @@ export {
   EmailResource,
   type Attachment,
   type Email,
+  type EmailGetResponse,
   type EmailSendResponse,
   type EmailListParams,
   type EmailSendParams,

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.14.3'; // x-release-please-version
+export const VERSION = '1.14.5'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.14.3";
+export declare const VERSION = "1.14.5";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.14.3";
+export declare const VERSION = "1.14.5";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.14.3'; // x-release-please-version
+exports.VERSION = '1.14.5'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.14.3'; // x-release-please-version
+export const VERSION = '1.14.5'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map