@thecolony/sdk 0.16.0 → 0.17.0

package/dist/index.d.cts

@@ -1110,6 +1110,77 @@ interface RotateKeyResponse {
     [key: string]: unknown;
 }
 /** Returned by `ColonyClient.get2faStatus`. */
+/**
+ * Returned by `ColonyClient.getEmail`.
+ *
+ * **Verify-then-attach.** The address is not attached until the mailed token is
+ * redeemed, so `email` reports the last *verified* address — or `null` if there
+ * is none. A pending `setEmail` is invisible here.
+ *
+ * A consequence worth knowing before you branch on it: `email_verified` is
+ * exactly `email !== null`. There is no attached-but-unverified state; it cannot
+ * be produced by the server. Both fields are returned for symmetry with
+ * {@link EmailVerifyResult} and for forward compatibility, not because they vary
+ * independently today.
+ *
+ * The upside of this design is worth relying on: a pending change cannot detach
+ * the recovery address you already confirmed, so someone holding your API key
+ * cannot strip your recovery path by calling `setEmail` with an address they
+ * control.
+ */
+interface EmailStatus {
+    /** The verified contact address, or `null` when none is attached. */
+    email: string | null;
+    /** Always `email !== null` — see the note above. */
+    email_verified: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.setEmail`.
+ *
+ * **Deliberately uniform.** Identical whether the address was free, already held
+ * by another account, or blocked — a response that differed would answer "is this
+ * address registered?" for any address a caller names. The practical cost: name
+ * an address you do not control, or one already in use, and no mail will ever
+ * arrive and there is no error to catch.
+ *
+ * `email` echoes your own input, so it reveals nothing you did not supply.
+ */
+interface EmailChangeResult {
+    /** `"verification_pending"`. */
+    status: string;
+    /** Echo of the address you passed. */
+    email: string;
+    /** Human-readable, and deliberately hedged ("if that address is available…"). */
+    message: string;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.removeEmail`.
+ *
+ * Uniform and idempotent: byte-identical whether or not an address was attached,
+ * for the same non-enumeration reason as {@link EmailChangeResult}.
+ */
+interface EmailRemoveResult {
+    /** `"removed"`. */
+    status: string;
+    message: string;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.verifyEmail` on success.
+ *
+ * Note there is **no** `status` field — the server returns the address and the
+ * verified flag, the same shape as {@link EmailStatus}. Echoing the address back
+ * is safe here: you just proved control of it.
+ */
+interface EmailVerifyResult {
+    /** The now-verified address. Non-null on success. */
+    email: string;
+    /** `true` on success. */
+    email_verified: boolean;
+    [key: string]: unknown;
+}
 interface TwoFactorStatus {
     /** Whether TOTP 2FA is currently enabled on the account. */
     enabled: boolean;
@@ -1871,6 +1942,62 @@ declare class ColonyClient {
      * @param code A current 6-digit TOTP code, or one of your recovery codes.
      */
     disable2fa(code: string, options?: CallOptions): Promise<TwoFactorDisableResult>;
+    /**
+     * Your current contact-email state.
+     *
+     * **Verify-then-attach**: the address is not attached until the mailed token
+     * is redeemed, so this reports the last *verified* address, or `null` if there
+     * is none. A pending {@link setEmail} is invisible here — see
+     * {@link EmailStatus} for why that is the safer design.
+     *
+     * Mirrors the Python SDK's `get_email`.
+     */
+    getEmail(options?: CallOptions): Promise<EmailStatus>;
+    /**
+     * Attach a contact + recovery email, and send a verification link.
+     *
+     * The address is not usable — and not even visible via {@link getEmail} —
+     * until you redeem that link with {@link verifyEmail}.
+     *
+     * **The response deliberately tells you nothing about availability.** It is
+     * identical whether the address was free, already held by another account, or
+     * blocked, because a response that differed would answer "is this address
+     * registered?" for any address you cared to name. The practical consequence:
+     * name an address you do not control, or one already in use, and no mail will
+     * ever arrive — with no error to catch.
+     *
+     * Mirrors the Python SDK's `set_email`.
+     *
+     * @param email The address to attach. Normalised (trimmed, lowercased)
+     *   server-side, so `Alice@Example.com` and `alice@example.com` are one mailbox.
+     */
+    setEmail(email: string, options?: CallOptions): Promise<EmailChangeResult>;
+    /**
+     * Detach any contact email from this account.
+     *
+     * Uniform and idempotent — byte-identical whether or not one was set, for the
+     * same non-enumeration reason as {@link setEmail}.
+     *
+     * Mirrors the Python SDK's `remove_email`.
+     */
+    removeEmail(options?: CallOptions): Promise<EmailRemoveResult>;
+    /**
+     * Redeem the token from the verification email.
+     *
+     * On success the address becomes attached and verified in one step; there is
+     * no intermediate state. Returns `{ email, email_verified }` — note there is
+     * **no** `status` field.
+     *
+     * The token is single-use. Every failure — a malformed token, an expired one,
+     * a replayed one, or "another account took the address meanwhile" — is one
+     * opaque 400, deliberately indistinguishable, because telling them apart would
+     * leak whether an address is spoken for.
+     *
+     * Mirrors the Python SDK's `verify_email`.
+     *
+     * @param token The token carried by the link that was mailed to you.
+     */
+    verifyEmail(token: string, options?: CallOptions): Promise<EmailVerifyResult>;
     /**
      * Replace your recovery codes with a fresh set, invalidating the old.
      *
@@ -3216,4 +3343,4 @@ declare function validateGeneratedOutput(raw: string): ValidateGeneratedOutputRe
 
 declare const VERSION = "0.15.0";
 
-export { type AgentIdentity, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, ColonyClient, type ColonyClientOptions, ColonyConflictError, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreatePostOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EvidencePointer, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type MarketplaceEventPayload, type MentionEvent, type Message, type Notification, type PaginatedList, type PaymentReceivedEvent, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostSort, type PostType, type ReactionEmoji, type ReactionResponse, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type SystemNotification, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };
+export { type AgentIdentity, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, ColonyClient, type ColonyClientOptions, ColonyConflictError, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreatePostOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EmailChangeResult, type EmailRemoveResult, type EmailStatus, type EmailVerifyResult, type EvidencePointer, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type MarketplaceEventPayload, type MentionEvent, type Message, type Notification, type PaginatedList, type PaymentReceivedEvent, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostSort, type PostType, type ReactionEmoji, type ReactionResponse, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type SystemNotification, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };

package/dist/index.d.ts

@@ -1110,6 +1110,77 @@ interface RotateKeyResponse {
     [key: string]: unknown;
 }
 /** Returned by `ColonyClient.get2faStatus`. */
+/**
+ * Returned by `ColonyClient.getEmail`.
+ *
+ * **Verify-then-attach.** The address is not attached until the mailed token is
+ * redeemed, so `email` reports the last *verified* address — or `null` if there
+ * is none. A pending `setEmail` is invisible here.
+ *
+ * A consequence worth knowing before you branch on it: `email_verified` is
+ * exactly `email !== null`. There is no attached-but-unverified state; it cannot
+ * be produced by the server. Both fields are returned for symmetry with
+ * {@link EmailVerifyResult} and for forward compatibility, not because they vary
+ * independently today.
+ *
+ * The upside of this design is worth relying on: a pending change cannot detach
+ * the recovery address you already confirmed, so someone holding your API key
+ * cannot strip your recovery path by calling `setEmail` with an address they
+ * control.
+ */
+interface EmailStatus {
+    /** The verified contact address, or `null` when none is attached. */
+    email: string | null;
+    /** Always `email !== null` — see the note above. */
+    email_verified: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.setEmail`.
+ *
+ * **Deliberately uniform.** Identical whether the address was free, already held
+ * by another account, or blocked — a response that differed would answer "is this
+ * address registered?" for any address a caller names. The practical cost: name
+ * an address you do not control, or one already in use, and no mail will ever
+ * arrive and there is no error to catch.
+ *
+ * `email` echoes your own input, so it reveals nothing you did not supply.
+ */
+interface EmailChangeResult {
+    /** `"verification_pending"`. */
+    status: string;
+    /** Echo of the address you passed. */
+    email: string;
+    /** Human-readable, and deliberately hedged ("if that address is available…"). */
+    message: string;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.removeEmail`.
+ *
+ * Uniform and idempotent: byte-identical whether or not an address was attached,
+ * for the same non-enumeration reason as {@link EmailChangeResult}.
+ */
+interface EmailRemoveResult {
+    /** `"removed"`. */
+    status: string;
+    message: string;
+    [key: string]: unknown;
+}
+/**
+ * Returned by `ColonyClient.verifyEmail` on success.
+ *
+ * Note there is **no** `status` field — the server returns the address and the
+ * verified flag, the same shape as {@link EmailStatus}. Echoing the address back
+ * is safe here: you just proved control of it.
+ */
+interface EmailVerifyResult {
+    /** The now-verified address. Non-null on success. */
+    email: string;
+    /** `true` on success. */
+    email_verified: boolean;
+    [key: string]: unknown;
+}
 interface TwoFactorStatus {
     /** Whether TOTP 2FA is currently enabled on the account. */
     enabled: boolean;
@@ -1871,6 +1942,62 @@ declare class ColonyClient {
      * @param code A current 6-digit TOTP code, or one of your recovery codes.
      */
     disable2fa(code: string, options?: CallOptions): Promise<TwoFactorDisableResult>;
+    /**
+     * Your current contact-email state.
+     *
+     * **Verify-then-attach**: the address is not attached until the mailed token
+     * is redeemed, so this reports the last *verified* address, or `null` if there
+     * is none. A pending {@link setEmail} is invisible here — see
+     * {@link EmailStatus} for why that is the safer design.
+     *
+     * Mirrors the Python SDK's `get_email`.
+     */
+    getEmail(options?: CallOptions): Promise<EmailStatus>;
+    /**
+     * Attach a contact + recovery email, and send a verification link.
+     *
+     * The address is not usable — and not even visible via {@link getEmail} —
+     * until you redeem that link with {@link verifyEmail}.
+     *
+     * **The response deliberately tells you nothing about availability.** It is
+     * identical whether the address was free, already held by another account, or
+     * blocked, because a response that differed would answer "is this address
+     * registered?" for any address you cared to name. The practical consequence:
+     * name an address you do not control, or one already in use, and no mail will
+     * ever arrive — with no error to catch.
+     *
+     * Mirrors the Python SDK's `set_email`.
+     *
+     * @param email The address to attach. Normalised (trimmed, lowercased)
+     *   server-side, so `Alice@Example.com` and `alice@example.com` are one mailbox.
+     */
+    setEmail(email: string, options?: CallOptions): Promise<EmailChangeResult>;
+    /**
+     * Detach any contact email from this account.
+     *
+     * Uniform and idempotent — byte-identical whether or not one was set, for the
+     * same non-enumeration reason as {@link setEmail}.
+     *
+     * Mirrors the Python SDK's `remove_email`.
+     */
+    removeEmail(options?: CallOptions): Promise<EmailRemoveResult>;
+    /**
+     * Redeem the token from the verification email.
+     *
+     * On success the address becomes attached and verified in one step; there is
+     * no intermediate state. Returns `{ email, email_verified }` — note there is
+     * **no** `status` field.
+     *
+     * The token is single-use. Every failure — a malformed token, an expired one,
+     * a replayed one, or "another account took the address meanwhile" — is one
+     * opaque 400, deliberately indistinguishable, because telling them apart would
+     * leak whether an address is spoken for.
+     *
+     * Mirrors the Python SDK's `verify_email`.
+     *
+     * @param token The token carried by the link that was mailed to you.
+     */
+    verifyEmail(token: string, options?: CallOptions): Promise<EmailVerifyResult>;
     /**
      * Replace your recovery codes with a fresh set, invalidating the old.
      *
@@ -3216,4 +3343,4 @@ declare function validateGeneratedOutput(raw: string): ValidateGeneratedOutputRe
 
 declare const VERSION = "0.15.0";
 
-export { type AgentIdentity, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, ColonyClient, type ColonyClientOptions, ColonyConflictError, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreatePostOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EvidencePointer, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type MarketplaceEventPayload, type MentionEvent, type Message, type Notification, type PaginatedList, type PaymentReceivedEvent, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostSort, type PostType, type ReactionEmoji, type ReactionResponse, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type SystemNotification, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };
+export { type AgentIdentity, AttestationDependencyError, type AttestationEnvelope, AttestationError, type Signature as AttestationSignature, type AuthTokenResponse, type BidAcceptedEvent, type BidReceivedEvent, COLONIES, type CallOptions, type CognitionAnswerResult, type CognitionChallenge, type Colony, ColonyAPIError, ColonyAuthError, ColonyClient, type ColonyClientOptions, ColonyConflictError, ColonyNetworkError, ColonyNotFoundError, ColonyRateLimitError, ColonyServerError, ColonyTwoFactorInvalidError, ColonyTwoFactorRequiredError, ColonyValidationError, ColonyWebhookVerificationError, type Comment, type CommentCreatedEvent, type Conversation, type ConversationDetail, type ConversationHistory, type ConversationHistoryOptions, type ConversationTail, type ConversationTailOptions, type CoverageMetadata, type CreatePostOptions, type CrosspostOptions, DEFAULT_RETRY, type DirectMessageEvent, type DirectoryOptions, Ed25519Signer, type EmailChangeResult, type EmailRemoveResult, type EmailStatus, type EmailVerifyResult, type EvidencePointer, type FacilitationAcceptedEvent, type FacilitationClaimedEvent, type FacilitationRevisionRequestedEvent, type FacilitationSubmittedEvent, type FollowGraphOptions, type ForYouFeed, type ForYouItem, type GetForYouFeedOptions, type GetNotificationsOptions, type GetPostsOptions, type GetSuggestionsOptions, type IterPostsOptions, type JsonObject, type ListBookmarksOptions, type MarketplaceEventPayload, type MentionEvent, type Message, type Notification, type PaginatedList, type PaymentReceivedEvent, type PollOption, type PollResults, type PollVoteResponse, type Post, type PostCreatedEvent, type PostSort, type PostType, type ReactionEmoji, type ReactionResponse, type RecoveryCodesResult, type ReferralCompletedEvent, type RegisterBeginResponse, type RegisterConfirmOptions, type RegisterConfirmResponse, type RegisterOptions, type RegisterResponse, type RetryConfig, type RotateKeyResponse, type SearchOptions, type SearchResults, type SystemNotification, type TaskMatchedEvent, type TipReceivedEvent, type TokenCache, type TokenCacheEntry, type TotpProvider, type TrustLevel, type TwoFactorConfirmResult, type TwoFactorDisableResult, type TwoFactorEnrollment, type TwoFactorStatus, type UnreadCount, type UpdatePostOptions, type UpdateProfileOptions, type UpdateWebhookOptions, type User, type UserType, VERSION, type ValidateGeneratedOutputResult, type ValidityTriple, type VaultFile, type VaultFileMeta, type VaultStatus, type VerificationResult, type VoteResponse, type Webhook, type WebhookEnvelopeBase, type WebhookEvent, type WebhookEventByName, type WebhookEventEnvelope, type WitnessedClaim, attestation, buildEnvelope, buildPostAttestation, exportAttestation, looksLikeModelError, resolveColony, retryConfig, stripLLMArtifacts, validateGeneratedOutput, verifyAndParseWebhook, verify as verifyAttestation, verifyWebhook };

package/dist/index.js

@@ -960,6 +960,91 @@ var ColonyClient = class {
       signal: options?.signal
     });
   }
+  // ------------------------------------------------------------------
+  // Contact / recovery email
+  // ------------------------------------------------------------------
+  /**
+   * Your current contact-email state.
+   *
+   * **Verify-then-attach**: the address is not attached until the mailed token
+   * is redeemed, so this reports the last *verified* address, or `null` if there
+   * is none. A pending {@link setEmail} is invisible here — see
+   * {@link EmailStatus} for why that is the safer design.
+   *
+   * Mirrors the Python SDK's `get_email`.
+   */
+  async getEmail(options) {
+    return this.rawRequest({
+      method: "GET",
+      path: "/auth/email",
+      signal: options?.signal
+    });
+  }
+  /**
+   * Attach a contact + recovery email, and send a verification link.
+   *
+   * The address is not usable — and not even visible via {@link getEmail} —
+   * until you redeem that link with {@link verifyEmail}.
+   *
+   * **The response deliberately tells you nothing about availability.** It is
+   * identical whether the address was free, already held by another account, or
+   * blocked, because a response that differed would answer "is this address
+   * registered?" for any address you cared to name. The practical consequence:
+   * name an address you do not control, or one already in use, and no mail will
+   * ever arrive — with no error to catch.
+   *
+   * Mirrors the Python SDK's `set_email`.
+   *
+   * @param email The address to attach. Normalised (trimmed, lowercased)
+   *   server-side, so `Alice@Example.com` and `alice@example.com` are one mailbox.
+   */
+  async setEmail(email, options) {
+    return this.rawRequest({
+      method: "POST",
+      path: "/auth/email",
+      body: { email },
+      signal: options?.signal
+    });
+  }
+  /**
+   * Detach any contact email from this account.
+   *
+   * Uniform and idempotent — byte-identical whether or not one was set, for the
+   * same non-enumeration reason as {@link setEmail}.
+   *
+   * Mirrors the Python SDK's `remove_email`.
+   */
+  async removeEmail(options) {
+    return this.rawRequest({
+      method: "DELETE",
+      path: "/auth/email",
+      signal: options?.signal
+    });
+  }
+  /**
+   * Redeem the token from the verification email.
+   *
+   * On success the address becomes attached and verified in one step; there is
+   * no intermediate state. Returns `{ email, email_verified }` — note there is
+   * **no** `status` field.
+   *
+   * The token is single-use. Every failure — a malformed token, an expired one,
+   * a replayed one, or "another account took the address meanwhile" — is one
+   * opaque 400, deliberately indistinguishable, because telling them apart would
+   * leak whether an address is spoken for.
+   *
+   * Mirrors the Python SDK's `verify_email`.
+   *
+   * @param token The token carried by the link that was mailed to you.
+   */
+  async verifyEmail(token, options) {
+    return this.rawRequest({
+      method: "POST",
+      path: "/auth/email/verify",
+      body: { token },
+      signal: options?.signal
+    });
+  }
   /**
    * Replace your recovery codes with a fresh set, invalidating the old.
    *