@wix/auto_sdk_email-subscriptions_email-subscriptions 1.0.0 → 1.0.2

package/build/internal/es/src/emailsubscriptions-v1-emailsubscription-email-subscriptions.types.d.ts

@@ -1,22 +1,40 @@
 export interface EmailSubscription {
     /**
      * Email subscription ID.
+     * @format GUID
      * @readonly
      */
     id?: string | null;
-    /** Email address. */
+    /**
+     * Email address.
+     * @format EMAIL
+     */
     email?: string;
     /**
      * Indicates the recipient's opt-in or opt-out status
      * for marketing emails.
      *
-     * Default: `NOT_SET`.
+     * - `NOT_SET`: No status specified. This is the default, initial value before any info about the email address is known.
+     * - `PENDING`: Subscription confirmation was requested,
+     * but recipient hasn't confirmed yet.
+     * - `SUBSCRIBED`: Recipient has opted in to marketing emails.
+     * - `UNSUBSCRIBED`: Recipient has opted out of marketing emails.
+     *
+     * Defaults to `NOT_SET`.
      */
     subscriptionStatus?: SubscriptionEnumStatus;
     /**
      * Indicates last reported status of sent emails.
      *
-     * Default: `NOT_SET`.
+     * - `NOT_SET`: No status specified. This is the default, initial value before any info about the email address is known.
+     * - `VALID`: Emails to this email address are being delivered successfully.
+     * - `BOUNCED`: The last email to the recipient bounced or was rejected.
+     * - `SPAM_COMPLAINT`: The recipient registered a spam complaint
+     * with their email provider.
+     * - `INACTIVE`: Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.)
+     * This status might impact subsequent emails sent to this address.
+     *
+     * Defaults to `NOT_SET`.
      */
     deliverabilityStatus?: Status;
     /**
@@ -31,55 +49,34 @@ export interface EmailSubscription {
     updatedDate?: Date | null;
 }
 export declare enum SubscriptionEnumStatus {
-    /** Undefined status. */
     UNKNOWN = "UNKNOWN",
-    /** No status specified. This is the default, initial value before any info about the email address is known. */
+    /** No Subscription exists */
     NOT_SET = "NOT_SET",
-    /** Subscription confirmation was requested, but recipient hasn't confirmed yet. */
+    /** Pending Subscription */
     PENDING = "PENDING",
-    /** Recipient has opted in to marketing emails. */
+    /** Subscribed */
     SUBSCRIBED = "SUBSCRIBED",
-    /** Recipient has opted out of marketing emails. */
+    /** UnSubscribed */
     UNSUBSCRIBED = "UNSUBSCRIBED"
 }
 export declare enum Status {
-    /** No status specified. This is the initial default value before any info about the email address is known. */
     NOT_SET = "NOT_SET",
-    /** Emails to this email address are being delivered successfully. */
+    /** valid/deferral */
     VALID = "VALID",
-    /** The last email to the recipient bounced or was rejected. */
+    /** bounced/rejected/invalid */
     BOUNCED = "BOUNCED",
-    /** The recipient registered a spam complaint with their email provider. */
+    /** spam/complaint */
     SPAM_COMPLAINT = "SPAM_COMPLAINT",
-    /** Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.) This status might impact subsequent emails sent to this address. */
+    /** valid, but no activity reported */
     INACTIVE = "INACTIVE"
 }
-export interface V1RenderUnsubscribePageRequest {
-    /** Payload */
-    payload?: string;
-    /** Language */
-    language?: string | null;
-}
-export interface RawHttpResponse {
-    body?: Uint8Array;
-    statusCode?: number | null;
-    headers?: HeadersEntry[];
-}
-export interface HeadersEntry {
-    key?: string;
-    value?: string;
-}
-export interface V1ConfirmUnsubscribeActionRequest {
-    /** Payload */
-    payload?: string;
-}
-export interface Empty {
-}
+/** Triggered when an email subscription's status is changed. */
 export interface EmailSubscriptionChanged {
-    /** subscription */
+    /** Email subscription that changed. */
     subscription?: EmailSubscription;
 }
 export interface GetEmailSubscriptionRequest {
+    /** @format GUID */
     id: string;
 }
 export interface GetEmailSubscriptionResponse {
@@ -138,7 +135,11 @@ export interface UpsertEmailSubscriptionResponse {
     subscription?: EmailSubscription;
 }
 export interface BulkUpsertEmailSubscriptionRequest {
-    /** List of email subscriptions to update or create. */
+    /**
+     * List of email subscriptions to update or create.
+     * @minSize 1
+     * @maxSize 100
+     */
     subscriptions: EmailSubscription[];
 }
 export interface BulkUpsertEmailSubscriptionResponse {
@@ -171,11 +172,21 @@ export interface Metadata {
     totalFailure?: number;
 }
 export interface GenerateUnsubscribeLinkRequest {
-    /** Email address the unsubscribe link is for. */
+    /**
+     * Email address the unsubscribe link is for.
+     * @format EMAIL
+     */
     emailAddress: string;
     /** Arbitrary parameters for closing-the-loop. */
     metadata?: Record<string, string>;
-    /** Language for displaying unsubscribe confirmation page (optional - default EN). */
+    /**
+     * Language for displaying unsubscribe confirmation page.
+     *
+     * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+     *
+     * Default: `EN`
+     * @format LANGUAGE
+     */
     language?: string | null;
 }
 export interface GenerateUnsubscribeLinkResponse {
@@ -188,10 +199,21 @@ export interface RenderUnsubscribePageRequest {
     /** Language */
     language?: string | null;
 }
+export interface RawHttpResponse {
+    body?: Uint8Array;
+    statusCode?: number | null;
+    headers?: HeadersEntry[];
+}
+export interface HeadersEntry {
+    key?: string;
+    value?: string;
+}
 export interface ConfirmUnsubscribeActionRequest {
     /** Payload */
     payload?: string;
 }
+export interface Empty {
+}
 export interface DomainEvent extends DomainEventBodyOneOf {
     createdEvent?: EntityCreatedEvent;
     updatedEvent?: EntityUpdatedEvent;
@@ -265,9 +287,15 @@ export interface ActionEvent {
     bodyAsJson?: string;
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -275,26 +303,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -304,6 +356,16 @@ export declare enum WebhookIdentityType {
     WIX_USER = "WIX_USER",
     APP = "APP"
 }
+export interface V1RenderUnsubscribePageRequest {
+    /** Payload */
+    payload?: string;
+    /** Language */
+    language?: string | null;
+}
+export interface V1ConfirmUnsubscribeActionRequest {
+    /** Payload */
+    payload?: string;
+}
 interface EmailSubscriptionNonNullableFields {
     email: string;
     subscriptionStatus: SubscriptionEnumStatus;

package/build/internal/es/src/emailsubscriptions-v1-emailsubscription-email-subscriptions.types.js

@@ -1,27 +1,25 @@
 export var SubscriptionEnumStatus;
 (function (SubscriptionEnumStatus) {
-    /** Undefined status. */
     SubscriptionEnumStatus["UNKNOWN"] = "UNKNOWN";
-    /** No status specified. This is the default, initial value before any info about the email address is known. */
+    /** No Subscription exists */
     SubscriptionEnumStatus["NOT_SET"] = "NOT_SET";
-    /** Subscription confirmation was requested, but recipient hasn't confirmed yet. */
+    /** Pending Subscription */
     SubscriptionEnumStatus["PENDING"] = "PENDING";
-    /** Recipient has opted in to marketing emails. */
+    /** Subscribed */
     SubscriptionEnumStatus["SUBSCRIBED"] = "SUBSCRIBED";
-    /** Recipient has opted out of marketing emails. */
+    /** UnSubscribed */
     SubscriptionEnumStatus["UNSUBSCRIBED"] = "UNSUBSCRIBED";
 })(SubscriptionEnumStatus || (SubscriptionEnumStatus = {}));
 export var Status;
 (function (Status) {
-    /** No status specified. This is the initial default value before any info about the email address is known. */
     Status["NOT_SET"] = "NOT_SET";
-    /** Emails to this email address are being delivered successfully. */
+    /** valid/deferral */
     Status["VALID"] = "VALID";
-    /** The last email to the recipient bounced or was rejected. */
+    /** bounced/rejected/invalid */
     Status["BOUNCED"] = "BOUNCED";
-    /** The recipient registered a spam complaint with their email provider. */
+    /** spam/complaint */
     Status["SPAM_COMPLAINT"] = "SPAM_COMPLAINT";
-    /** Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.) This status might impact subsequent emails sent to this address. */
+    /** valid, but no activity reported */
     Status["INACTIVE"] = "INACTIVE";
 })(Status || (Status = {}));
 export var WebhookIdentityType;

package/build/internal/es/src/emailsubscriptions-v1-emailsubscription-email-subscriptions.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"emailsubscriptions-v1-emailsubscription-email-subscriptions.types.js","sourceRoot":"","sources":["../../../../src/emailsubscriptions-v1-emailsubscription-email-subscriptions.types.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAN,IAAY,sBAWX;AAXD,WAAY,sBAAsB;IAChC,wBAAwB;IACxB,6CAAmB,CAAA;IACnB,gHAAgH;IAChH,6CAAmB,CAAA;IACnB,mFAAmF;IACnF,6CAAmB,CAAA;IACnB,kDAAkD;IAClD,mDAAyB,CAAA;IACzB,mDAAmD;IACnD,uDAA6B,CAAA;AAC/B,CAAC,EAXW,sBAAsB,KAAtB,sBAAsB,QAWjC;AAED,MAAM,CAAN,IAAY,MAWX;AAXD,WAAY,MAAM;IAChB,+GAA+G;IAC/G,6BAAmB,CAAA;IACnB,qEAAqE;IACrE,yBAAe,CAAA;IACf,+DAA+D;IAC/D,6BAAmB,CAAA;IACnB,2EAA2E;IAC3E,2CAAiC,CAAA;IACjC,6NAA6N;IAC7N,+BAAqB,CAAA;AACvB,CAAC,EAXW,MAAM,KAAN,MAAM,QAWjB;AAuRD,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B"}
+{"version":3,"file":"emailsubscriptions-v1-emailsubscription-email-subscriptions.types.js","sourceRoot":"","sources":["../../../../src/emailsubscriptions-v1-emailsubscription-email-subscriptions.types.ts"],"names":[],"mappings":"AAmDA,MAAM,CAAN,IAAY,sBAUX;AAVD,WAAY,sBAAsB;IAChC,6CAAmB,CAAA;IACnB,6BAA6B;IAC7B,6CAAmB,CAAA;IACnB,2BAA2B;IAC3B,6CAAmB,CAAA;IACnB,iBAAiB;IACjB,mDAAyB,CAAA;IACzB,mBAAmB;IACnB,uDAA6B,CAAA;AAC/B,CAAC,EAVW,sBAAsB,KAAtB,sBAAsB,QAUjC;AAED,MAAM,CAAN,IAAY,MAUX;AAVD,WAAY,MAAM;IAChB,6BAAmB,CAAA;IACnB,qBAAqB;IACrB,yBAAe,CAAA;IACf,+BAA+B;IAC/B,6BAAmB,CAAA;IACnB,qBAAqB;IACrB,2CAAiC,CAAA;IACjC,sCAAsC;IACtC,+BAAqB,CAAA;AACvB,CAAC,EAVW,MAAM,KAAN,MAAM,QAUjB;AAyTD,MAAM,CAAN,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,wCAAiB,CAAA;IACjB,4CAAqB,CAAA;IACrB,kCAAW,CAAA;AACb,CAAC,EANW,mBAAmB,KAAnB,mBAAmB,QAM9B"}

package/build/internal/es/src/emailsubscriptions-v1-emailsubscription-email-subscriptions.universal.d.ts

@@ -1,22 +1,40 @@
 export interface EmailSubscription {
     /**
      * Email subscription ID.
+     * @format GUID
      * @readonly
      */
     _id?: string | null;
-    /** Email address. */
+    /**
+     * Email address.
+     * @format EMAIL
+     */
     email?: string;
     /**
      * Indicates the recipient's opt-in or opt-out status
      * for marketing emails.
      *
-     * Default: `NOT_SET`.
+     * - `NOT_SET`: No status specified. This is the default, initial value before any info about the email address is known.
+     * - `PENDING`: Subscription confirmation was requested,
+     * but recipient hasn't confirmed yet.
+     * - `SUBSCRIBED`: Recipient has opted in to marketing emails.
+     * - `UNSUBSCRIBED`: Recipient has opted out of marketing emails.
+     *
+     * Defaults to `NOT_SET`.
      */
     subscriptionStatus?: SubscriptionEnumStatus;
     /**
      * Indicates last reported status of sent emails.
      *
-     * Default: `NOT_SET`.
+     * - `NOT_SET`: No status specified. This is the default, initial value before any info about the email address is known.
+     * - `VALID`: Emails to this email address are being delivered successfully.
+     * - `BOUNCED`: The last email to the recipient bounced or was rejected.
+     * - `SPAM_COMPLAINT`: The recipient registered a spam complaint
+     * with their email provider.
+     * - `INACTIVE`: Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.)
+     * This status might impact subsequent emails sent to this address.
+     *
+     * Defaults to `NOT_SET`.
      */
     deliverabilityStatus?: Status;
     /**
@@ -31,55 +49,34 @@ export interface EmailSubscription {
     _updatedDate?: Date | null;
 }
 export declare enum SubscriptionEnumStatus {
-    /** Undefined status. */
     UNKNOWN = "UNKNOWN",
-    /** No status specified. This is the default, initial value before any info about the email address is known. */
+    /** No Subscription exists */
     NOT_SET = "NOT_SET",
-    /** Subscription confirmation was requested, but recipient hasn't confirmed yet. */
+    /** Pending Subscription */
     PENDING = "PENDING",
-    /** Recipient has opted in to marketing emails. */
+    /** Subscribed */
     SUBSCRIBED = "SUBSCRIBED",
-    /** Recipient has opted out of marketing emails. */
+    /** UnSubscribed */
     UNSUBSCRIBED = "UNSUBSCRIBED"
 }
 export declare enum Status {
-    /** No status specified. This is the initial default value before any info about the email address is known. */
     NOT_SET = "NOT_SET",
-    /** Emails to this email address are being delivered successfully. */
+    /** valid/deferral */
     VALID = "VALID",
-    /** The last email to the recipient bounced or was rejected. */
+    /** bounced/rejected/invalid */
     BOUNCED = "BOUNCED",
-    /** The recipient registered a spam complaint with their email provider. */
+    /** spam/complaint */
     SPAM_COMPLAINT = "SPAM_COMPLAINT",
-    /** Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.) This status might impact subsequent emails sent to this address. */
+    /** valid, but no activity reported */
     INACTIVE = "INACTIVE"
 }
-export interface V1RenderUnsubscribePageRequest {
-    /** Payload */
-    payload?: string;
-    /** Language */
-    language?: string | null;
-}
-export interface RawHttpResponse {
-    body?: Uint8Array;
-    statusCode?: number | null;
-    headers?: HeadersEntry[];
-}
-export interface HeadersEntry {
-    key?: string;
-    value?: string;
-}
-export interface V1ConfirmUnsubscribeActionRequest {
-    /** Payload */
-    payload?: string;
-}
-export interface Empty {
-}
+/** Triggered when an email subscription's status is changed. */
 export interface EmailSubscriptionChanged {
-    /** subscription */
+    /** Email subscription that changed. */
     subscription?: EmailSubscription;
 }
 export interface GetEmailSubscriptionRequest {
+    /** @format GUID */
     _id: string;
 }
 export interface GetEmailSubscriptionResponse {
@@ -138,7 +135,11 @@ export interface UpsertEmailSubscriptionResponse {
     subscription?: EmailSubscription;
 }
 export interface BulkUpsertEmailSubscriptionRequest {
-    /** List of email subscriptions to update or create. */
+    /**
+     * List of email subscriptions to update or create.
+     * @minSize 1
+     * @maxSize 100
+     */
     subscriptions: EmailSubscription[];
 }
 export interface BulkUpsertEmailSubscriptionResponse {
@@ -171,11 +172,21 @@ export interface Metadata {
     totalFailure?: number;
 }
 export interface GenerateUnsubscribeLinkRequest {
-    /** Email address the unsubscribe link is for. */
+    /**
+     * Email address the unsubscribe link is for.
+     * @format EMAIL
+     */
     emailAddress: string;
     /** Arbitrary parameters for closing-the-loop. */
     metadata?: Record<string, string>;
-    /** Language for displaying unsubscribe confirmation page (optional - default EN). */
+    /**
+     * Language for displaying unsubscribe confirmation page.
+     *
+     * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+     *
+     * Default: `EN`
+     * @format LANGUAGE
+     */
     language?: string | null;
 }
 export interface GenerateUnsubscribeLinkResponse {
@@ -188,10 +199,21 @@ export interface RenderUnsubscribePageRequest {
     /** Language */
     language?: string | null;
 }
+export interface RawHttpResponse {
+    body?: Uint8Array;
+    statusCode?: number | null;
+    headers?: HeadersEntry[];
+}
+export interface HeadersEntry {
+    key?: string;
+    value?: string;
+}
 export interface ConfirmUnsubscribeActionRequest {
     /** Payload */
     payload?: string;
 }
+export interface Empty {
+}
 export interface DomainEvent extends DomainEventBodyOneOf {
     createdEvent?: EntityCreatedEvent;
     updatedEvent?: EntityUpdatedEvent;
@@ -263,9 +285,15 @@ export interface ActionEvent {
     body?: string;
 }
 export interface MessageEnvelope {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -273,26 +301,50 @@ export interface MessageEnvelope {
     data?: string;
 }
 export interface IdentificationData extends IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
     /** @readonly */
     identityType?: WebhookIdentityType;
 }
 /** @oneof */
 export interface IdentificationDataIdOneOf {
-    /** ID of a site visitor that has not logged in to the site. */
+    /**
+     * ID of a site visitor that has not logged in to the site.
+     * @format GUID
+     */
     anonymousVisitorId?: string;
-    /** ID of a site visitor that has logged in to the site. */
+    /**
+     * ID of a site visitor that has logged in to the site.
+     * @format GUID
+     */
     memberId?: string;
-    /** ID of a Wix user (site owner, contributor, etc.). */
+    /**
+     * ID of a Wix user (site owner, contributor, etc.).
+     * @format GUID
+     */
     wixUserId?: string;
-    /** ID of an app. */
+    /**
+     * ID of an app.
+     * @format GUID
+     */
     appId?: string;
 }
 export declare enum WebhookIdentityType {
@@ -302,6 +354,16 @@ export declare enum WebhookIdentityType {
     WIX_USER = "WIX_USER",
     APP = "APP"
 }
+export interface V1RenderUnsubscribePageRequest {
+    /** Payload */
+    payload?: string;
+    /** Language */
+    language?: string | null;
+}
+export interface V1ConfirmUnsubscribeActionRequest {
+    /** Payload */
+    payload?: string;
+}
 export interface EmailSubscriptionNonNullableFields {
     email: string;
     subscriptionStatus: SubscriptionEnumStatus;
@@ -337,9 +399,15 @@ export interface GenerateUnsubscribeLinkResponseNonNullableFields {
     link: string;
 }
 export interface BaseEventMetadata {
-    /** App instance ID. */
+    /**
+     * App instance ID.
+     * @format GUID
+     */
     instanceId?: string | null;
-    /** Event type. */
+    /**
+     * Event type.
+     * @maxLength 150
+     */
     eventType?: string;
     /** The identification type and identity data. */
     identity?: IdentificationData;
@@ -377,7 +445,7 @@ export declare function getEmailSubscription(_id: string): Promise<EmailSubscrip
  *
  * Currently, querying is supported on the `email` field
  * with the `$in` array filter.
- * For example, to query for emails "me@my.com" and "you@your.org",
+ * For example, to query for emails `"me@my.com"`` and `"you@your.org"``,
  * the filter should be formed like this:
  *
  * ```json
@@ -414,8 +482,8 @@ export interface QueryEmailSubscriptionsOptions {
 /**
  * Updates or creates an email subscription for the requested email.
  *
- * An email subscription is always returned in the response,
- * regardless of whether it was updated or created.
+ * An email subscription is returned in the response
+ * whether it was updated or created.
  * @public
  * @documentationMaturity preview
  * @requiredField options.subscription.email
@@ -462,7 +530,14 @@ export declare function generateUnsubscribeLink(emailAddress: string, options?:
 export interface GenerateUnsubscribeLinkOptions {
     /** Arbitrary parameters for closing-the-loop. */
     metadata?: Record<string, string>;
-    /** Language for displaying unsubscribe confirmation page (optional - default EN). */
+    /**
+     * Language for displaying unsubscribe confirmation page.
+     *
+     * 2-letter language code in [ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format.
+     *
+     * Default: `EN`
+     * @format LANGUAGE
+     */
     language?: string | null;
 }
 export {};

package/build/internal/es/src/emailsubscriptions-v1-emailsubscription-email-subscriptions.universal.js

@@ -3,28 +3,26 @@ import { renameKeysFromSDKRequestToRESTRequest, renameKeysFromRESTResponseToSDKR
 import * as ambassadorWixEmailsubscriptionsV1Emailsubscription from './emailsubscriptions-v1-emailsubscription-email-subscriptions.http.js';
 export var SubscriptionEnumStatus;
 (function (SubscriptionEnumStatus) {
-    /** Undefined status. */
     SubscriptionEnumStatus["UNKNOWN"] = "UNKNOWN";
-    /** No status specified. This is the default, initial value before any info about the email address is known. */
+    /** No Subscription exists */
     SubscriptionEnumStatus["NOT_SET"] = "NOT_SET";
-    /** Subscription confirmation was requested, but recipient hasn't confirmed yet. */
+    /** Pending Subscription */
     SubscriptionEnumStatus["PENDING"] = "PENDING";
-    /** Recipient has opted in to marketing emails. */
+    /** Subscribed */
     SubscriptionEnumStatus["SUBSCRIBED"] = "SUBSCRIBED";
-    /** Recipient has opted out of marketing emails. */
+    /** UnSubscribed */
     SubscriptionEnumStatus["UNSUBSCRIBED"] = "UNSUBSCRIBED";
 })(SubscriptionEnumStatus || (SubscriptionEnumStatus = {}));
 export var Status;
 (function (Status) {
-    /** No status specified. This is the initial default value before any info about the email address is known. */
     Status["NOT_SET"] = "NOT_SET";
-    /** Emails to this email address are being delivered successfully. */
+    /** valid/deferral */
     Status["VALID"] = "VALID";
-    /** The last email to the recipient bounced or was rejected. */
+    /** bounced/rejected/invalid */
     Status["BOUNCED"] = "BOUNCED";
-    /** The recipient registered a spam complaint with their email provider. */
+    /** spam/complaint */
     Status["SPAM_COMPLAINT"] = "SPAM_COMPLAINT";
-    /** Multiple campaigns have been delivered to this address without any engagement from the recipient. (No emails were opened and no content was clicked.) This status might impact subsequent emails sent to this address. */
+    /** valid, but no activity reported */
     Status["INACTIVE"] = "INACTIVE";
 })(Status || (Status = {}));
 export var WebhookIdentityType;
@@ -75,7 +73,7 @@ export async function getEmailSubscription(_id) {
  *
  * Currently, querying is supported on the `email` field
  * with the `$in` array filter.
- * For example, to query for emails "me@my.com" and "you@your.org",
+ * For example, to query for emails `"me@my.com"`` and `"you@your.org"``,
  * the filter should be formed like this:
  *
  * ```json
@@ -128,8 +126,8 @@ export async function queryEmailSubscriptions(filter, options) {
 /**
  * Updates or creates an email subscription for the requested email.
  *
- * An email subscription is always returned in the response,
- * regardless of whether it was updated or created.
+ * An email subscription is returned in the response
+ * whether it was updated or created.
  * @public
  * @documentationMaturity preview
  * @requiredField options.subscription.email