@usehercules/sdk 1.14.3 → 1.14.4

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 });
   }
 

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.4'; // 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.4";
 //# 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.4";
 //# 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.4'; // 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.4'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map