@whooshbang/sdk 7.0.0 → 7.2.0

package/dist/client.js

@@ -1,6 +1,6 @@
 import { validateWhoAmI, validateOperatorCollection, validateOperatorResolution, validateCreateOperatorMessageRequest, validateOperatorMessageResult, validateOperatorBroadcast, validateOperatorPreferences, validateOperatorConnectRequest, } from "@whooshbang/contracts";
 import { validateAssertEmailConsentRequest, validateBindingSummary, } from "@whooshbang/contracts";
-import { contractValidationErrors, validateOrganizationCredential, validateOrganizationCredentialCollection, validateOrganizationCredentialRotation, validateOrganizationCredentialSecretReveal, validateBillingProjectSlots, validateBillingPromotions, validateBillingPromotion, validateRedeemBillingPromotionRequest, validateAssignBillingProjectSlotsRequest, validateSubscriptionChange, validateConfirmSubscriptionChangeRequest, validateBillingEntitlements, validateSubscriptionSelection, validateProjectAttribution, validateUpdateProjectAttributionRequest, validateAutoTopUpSettings, validateUpdateAutoTopUpSettingsRequest, validateBillingAccount, validateCardSetup, validateCreateCreditPurchaseRequest, validateCreditPurchase, validateBillingInvoiceCollection, validateUpdateBillingReceiptEmailRequest, validateOrganizationProjection, validateApiCredential, validateApiCredentialCollection, validateApiCredentialRotation, validateApiCredentialSecretReveal, validateAttachNotifierConnectionRequest, validateChannelConnection, validateChannelConnectionCollection, validateConnectionProviderCollection, validateUsageReport, validateMessageListPage, validateMessageDeliveryHistory, validateMessageNotificationImage, validateInteractionTimeline, validateUpdateEmailSenderRequest, validateCustomerEventDeliveryHistory, validateCustomerEventDeliveryAttempt, validateDeliveryHolds, validateMachineClientOperationsList, validateRecipientCopyCatalogue, validateNotifierConnectionCollection, validateProjectRecipientExperience, validateRecipientBrandLogoUpload, validateNotificationImageAsset, validateUpdateProjectRecipientExperienceRequest, validateEnvironmentRecipientExperience, validateUpdateEnvironmentRecipientExperienceRequest, validateSubscriberChannelSettings, validateAcknowledgeEmailRemediationRequest, validateCreateRecipientSessionRequest, validateCreateRecipientSessionResponse, validateRecipientSession, validateCreateProviderHandoffRequest, validateProviderHandoff, validateSetPreferredBindingRequest, validatePreferredBinding, validateCreateSubscriberRequest, validateSubscriber, validateSubscriberDataExport, validateUpdateSubscriberRequest, validateSubscriberCollection, validateCloseOrganizationRequest, validateInviteTeammateRequest, validateTeammate, validateTeammateAccessRequest, validateTeammateCollection, validateOrganizationClosureResult, validateCreateSubscriberGroupRequest, validateUpdateSubscriberGroupRequest, validateSubscriberGroup, validateSubscriberGroupCollection, validateSubscriberGroupMembership, validateSubscriberGroupMembershipCollection, validateCreateGroupBroadcastRequest, validateGroupBroadcast, validateCreateOrganizationCredentialRequest, validateCreateApiCredentialRequest, validateCreateChannelConnectionRequest, validateCreateCustomerEndpointRequest, validateCreateMachineClientRequest, validateCreateMessageRequest, validateCancelEscalationByKeyRequest, validateEscalationPathPreview, validateEscalationOrder, validateEscalationOrderCollection, validateSaveEscalationOrderRequest, validateQuietHours, validateSaveQuietHoursRequest, validateSetDigestPreferenceRequest, validateSetSubscriberDigestSettingRequest, validateSubscriberDigestSettings, validateEscalationPolicy, validateEscalationPolicyCollection, validateEscalationLimits, validateUpdateEscalationLimitsRequest, validateEscalationPagingLimitReport, validateUpdateEscalationPolicyRequest, validateCancelEscalationRequest, validateEscalation, validateMessageCategory, validateMessageCategoryCollection, validateCreateMessageCategoryRequest, validateUpdateMessageCategoryRequest, validateSubscriberCategoryPreference, validateSubscriberCategoryPreferenceCollection, validateSetSubscriberCategoryPreferenceRequest, validateCreateProjectRequest, validateUpdateProjectRequest, validateCreateSubscriptionLinkRequest, validateCustomerEndpoint, validateCustomerEndpointAttemptCollection, validateCustomerEndpointCollection, validateCustomerEndpointMutationResult, validateInteractionSummary, validateMachineClient, validateMachineCredential, validateMachineEventAckRequest, validateMachineEventAckResponse, validateMachineEventPollResponse, validateMessage, validateProblem, validateProject, validateProjectCollection, validateRecipientCopyOverride, validateRecipientCopyOverrideCollection, validateProviderCapabilitiesCollection, validateProviderInstallationCollection, validateEmailDomainCollection, validateCreateEmailDomainRequest, validateRegisterMachineCredentialRequest, validateRotateOrganizationCredentialRequest, validateRotateApiCredentialRequest, validateConnectionTest, validateConnectionTestCollection, validateCreateConnectionTestRequest, validateCustomerApplicationManifest, validateRotateChannelConnectionCredentialRequest, validateRotateCustomerEndpointRequest, validateSubscriptionLink, validateUpdateChannelConnectionRequest, validateUpdateRecipientCopyOverrideRequest, } from "@whooshbang/contracts";
+import { contractValidationErrors, validateOrganizationCredential, validateOrganizationCredentialCollection, validateOrganizationCredentialRotation, validateOrganizationCredentialSecretReveal, validateBillingProjectSlots, validateBillingPromotions, validateBillingPromotion, validateRedeemBillingPromotionRequest, validateAssignBillingProjectSlotsRequest, validateSubscriptionChange, validateConfirmSubscriptionChangeRequest, validateBillingEntitlements, validateSubscriptionSelection, validateProjectAttribution, validateUpdateProjectAttributionRequest, validateAutoTopUpSettings, validateUpdateAutoTopUpSettingsRequest, validateBillingAccount, validateCardSetup, validateCreateCreditPurchaseRequest, validateCreditPurchase, validateBillingInvoiceCollection, validateUpdateBillingReceiptEmailRequest, validateOrganizationProjection, validateApiCredential, validateApiCredentialCollection, validateApiCredentialRotation, validateApiCredentialSecretReveal, validateAttachNotifierConnectionRequest, validateChannelConnection, validateChannelConnectionCollection, validateConnectionProviderCollection, validateUsageReport, validateMessageListPage, validateMessageDeliveryHistory, validateMessageNotificationImage, validateInteractionTimeline, validateUpdateEmailSenderRequest, validateCustomerEventDeliveryHistory, validateCustomerEventDeliveryAttempt, validateDeliveryHolds, validateMachineClientOperationsList, validateRecipientCopyCatalogue, validateNotifierConnectionCollection, validateProjectRecipientExperience, validateRecipientBrandLogoUpload, validateNotificationImageAsset, validateUpdateProjectRecipientExperienceRequest, validateEnvironmentRecipientExperience, validateUpdateEnvironmentRecipientExperienceRequest, validateSubscriberChannelSettings, validateAcknowledgeEmailRemediationRequest, validateCreateRecipientSessionRequest, validateCreateRecipientSessionResponse, validateRecipientSession, validateCreateProviderHandoffRequest, validateProviderHandoff, validateSetPreferredBindingRequest, validatePreferredBinding, validateCreateSubscriberRequest, validateIdentifySubscriberRequest, validateBatchIdentifySubscriberRequest, validateSubscriberLifecycleRequest, validateSubscriberSyncResult, validateBatchIdentifySubscriberResult, validateSubscriber, validateSubscriberDataExport, validateUpdateSubscriberRequest, validateSubscriberCollection, validateCloseOrganizationRequest, validateInviteTeammateRequest, validateTeammate, validateTeammateAccessRequest, validateTeammateCollection, validateOrganizationClosureResult, validateCreateSubscriberGroupRequest, validateUpdateSubscriberGroupRequest, validateSubscriberGroup, validateSubscriberGroupCollection, validateSubscriberGroupMembership, validateSubscriberGroupMembershipCollection, validateCreateGroupBroadcastRequest, validateGroupBroadcast, validateCreateOrganizationCredentialRequest, validateCreateApiCredentialRequest, validateCreateChannelConnectionRequest, validateCreateCustomerEndpointRequest, validateCreateMachineClientRequest, validateCreateMessageRequest, validateCancelEscalationByKeyRequest, validateEscalationPathPreview, validateEscalationOrder, validateEscalationOrderCollection, validateSaveEscalationOrderRequest, validateQuietHours, validateSaveQuietHoursRequest, validateSetDigestPreferenceRequest, validateSetSubscriberDigestSettingRequest, validateSubscriberDigestSettings, validateEscalationPolicy, validateEscalationPolicyCollection, validateEscalationLimits, validateUpdateEscalationLimitsRequest, validateEscalationPagingLimitReport, validateUpdateEscalationPolicyRequest, validateCancelEscalationRequest, validateEscalation, validateMessageCategory, validateMessageCategoryCollection, validateCreateMessageCategoryRequest, validateUpdateMessageCategoryRequest, validateSubscriberCategoryPreference, validateSubscriberCategoryPreferenceCollection, validateSetSubscriberCategoryPreferenceRequest, validateCreateProjectRequest, validateUpdateProjectRequest, validateCreateSubscriptionLinkRequest, validateCustomerEndpoint, validateCustomerEndpointAttemptCollection, validateCustomerEndpointCollection, validateCustomerEndpointMutationResult, validateInteractionSummary, validateMachineClient, validateMachineCredential, validateMachineEventAckRequest, validateMachineEventAckResponse, validateMachineEventPollResponse, validateMessage, validateProblem, validateProject, validateProjectCollection, validateRecipientCopyOverride, validateRecipientCopyOverrideCollection, validateProviderCapabilitiesCollection, validateProviderInstallationCollection, validateEmailDomainCollection, validateCreateEmailDomainRequest, validateRegisterMachineCredentialRequest, validateRotateOrganizationCredentialRequest, validateRotateApiCredentialRequest, validateConnectionTest, validateConnectionTestCollection, validateCreateConnectionTestRequest, validateCustomerApplicationManifest, validateRotateChannelConnectionCredentialRequest, validateRotateCustomerEndpointRequest, validateSubscriptionLink, validateUpdateChannelConnectionRequest, validateUpdateRecipientCopyOverrideRequest, } from "@whooshbang/contracts";
 import { validateAdditiveCompatible } from "./additive-compatibility.js";
 import { WhooshBangContractError, WhooshBangOutcomeUnknownError, WhooshBangProblemError, WhooshBangProtocolError, WhooshBangTransportError, WhooshBangValidationError, validationError, } from "./errors.js";
 import { interactionAnswer } from "./interactions.js";
@@ -80,6 +80,45 @@ function usageQuery(operation, options) {
     return search.size === 0 ? "" : `?${search.toString()}`;
 }
 const templateRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function validateAuthoredTemplate(value) {
+    return (validateTemplateCatalogEntry(value) &&
+        Number.isSafeInteger(value.draftVersion));
+}
+function validatePublishedRevision(value) {
+    return (templateRecord(value) &&
+        Number.isSafeInteger(value.revision) &&
+        templateRecord(value.definition) &&
+        typeof value.publishedAt === "string");
+}
+function validateRevisionCollection(value) {
+    return (templateRecord(value) &&
+        Array.isArray(value.items) &&
+        value.items.every((item) => validatePublishedRevision(item)));
+}
+function validateTemplatePreview(value) {
+    return (templateRecord(value) &&
+        typeof value.channel === "string" &&
+        templateRecord(value.normalizedInput) &&
+        typeof value.templateLocale === "string");
+}
+function validateEmailLayout(value) {
+    return (templateRecord(value) &&
+        typeof value.id === "string" &&
+        typeof value.name === "string" &&
+        typeof value.isDefault === "boolean" &&
+        typeof value.disabled === "boolean" &&
+        templateRecord(value.draft) &&
+        Number.isSafeInteger(value.draftVersion) &&
+        Number.isSafeInteger(value.latestPublishedRevision));
+}
+function validateEmailLayoutCollection(value) {
+    return (templateRecord(value) &&
+        Array.isArray(value.items) &&
+        value.items.every((item) => validateEmailLayout(item)));
+}
+function validateDefaultLayout(value) {
+    return templateRecord(value) && typeof value.default_layout_id === "string";
+}
 function validateTemplateCatalog(value) {
     return (templateRecord(value) &&
         Array.isArray(value.items) &&
@@ -1477,6 +1516,202 @@ export class WhooshBangClient {
             strictResponse: true,
         });
     }
+    /** The template as its author sees it, including the editable draft. */
+    async getMessageTemplateForAuthoring(projectId, reference, options = {}) {
+        const operation = "getMessageTemplate";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            sideEffect: false,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, reference, "reference")}`,
+            validator: validateAuthoredTemplate,
+        });
+    }
+    /** Every template, drafts and disabled ones included, for authoring. */
+    async listMessageTemplatesForAuthoring(projectId, query = {}, options = {}) {
+        const operation = "listMessageTemplates";
+        const params = new URLSearchParams();
+        if (query.search !== undefined)
+            params.set("search", query.search);
+        if (query.category !== undefined)
+            params.set("category", query.category);
+        if (query.after !== undefined)
+            params.set("after", query.after);
+        if (query.limit !== undefined)
+            params.set("limit", String(query.limit));
+        if (query.page !== undefined)
+            params.set("page", String(query.page));
+        const suffix = params.size === 0 ? "" : `?${params}`;
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            sideEffect: false,
+            path: `${templateRoot(operation, projectId)}${suffix}`,
+            validator: (value) => validateTemplateCatalog(value) &&
+                value.items.every((item) => validateAuthoredTemplate(item)),
+        });
+    }
+    async createMessageTemplate(projectId, request, options = {}) {
+        const operation = "createMessageTemplate";
+        return this.#request({
+            body: request,
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: templateRoot(operation, projectId),
+            validator: validateAuthoredTemplate,
+        });
+    }
+    /** Renames, recategorises, disables or re-enables a template. */
+    async updateMessageTemplate(projectId, templateId, request, options = {}) {
+        const operation = "updateMessageTemplateMetadata";
+        return this.#request({
+            body: request,
+            method: "PATCH",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, templateId, "templateId")}`,
+            validator: validateAuthoredTemplate,
+        });
+    }
+    /** Replaces the draft. `draftVersion` is the version last read; a newer save refuses this one. */
+    async saveMessageTemplateDraft(projectId, templateId, draftVersion, definition, options = {}) {
+        const operation = "saveMessageTemplateDraft";
+        return this.#request({
+            body: { draft_version: draftVersion, definition },
+            method: "PUT",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, templateId, "templateId")}/draft`,
+            validator: validateAuthoredTemplate,
+        });
+    }
+    /** Validates the draft completely and publishes it as the next revision. */
+    async publishMessageTemplate(projectId, templateId, draftVersion, options = {}) {
+        const operation = "publishMessageTemplate";
+        return this.#request({
+            body: { draft_version: draftVersion },
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, templateId, "templateId")}/publish`,
+            validator: validatePublishedRevision,
+        });
+    }
+    async listMessageTemplateRevisions(projectId, templateId, options = {}) {
+        const operation = "listMessageTemplateRevisions";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            sideEffect: false,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, templateId, "templateId")}/revisions`,
+            validator: validateRevisionCollection,
+        });
+    }
+    /** Renders the draft, a revision or an unsaved definition. Nothing is sent. */
+    async previewMessageTemplate(projectId, templateId, request, options = {}) {
+        const operation = "previewMessageTemplate";
+        return this.#request({
+            body: request,
+            method: "POST",
+            operation,
+            options,
+            sideEffect: false,
+            path: `${templateRoot(operation, projectId)}/${pathSegment(operation, templateId, "templateId")}/preview`,
+            validator: validateTemplatePreview,
+        });
+    }
+    /** Sends the exact draft to one subscriber as a test. It never publishes. */
+    async testSendMessageTemplateDraft(projectId, environmentId, templateId, request, options = {}) {
+        const operation = "testSendMessageTemplateDraft";
+        return this.#request({
+            body: request,
+            method: "POST",
+            operation,
+            options,
+            idempotencyKey: options.idempotencyKey,
+            sideEffect: true,
+            path: `${environmentRoot(operation, projectId, environmentId)}/message-templates/${pathSegment(operation, templateId, "templateId")}/test-send`,
+            validator: validateTemplateMessageSendResult,
+        });
+    }
+    async listEmailLayouts(projectId, options = {}) {
+        const operation = "listEmailLayouts";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            sideEffect: false,
+            path: layoutRoot(operation, projectId),
+            validator: validateEmailLayoutCollection,
+        });
+    }
+    async getEmailLayout(projectId, layoutId, options = {}) {
+        const operation = "getEmailLayout";
+        return this.#request({
+            method: "GET",
+            operation,
+            options,
+            sideEffect: false,
+            path: `${layoutRoot(operation, projectId)}/${pathSegment(operation, layoutId, "layoutId")}`,
+            validator: validateEmailLayout,
+        });
+    }
+    async createEmailLayout(projectId, request, options = {}) {
+        const operation = "createEmailLayout";
+        return this.#request({
+            body: request,
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: layoutRoot(operation, projectId),
+            validator: validateEmailLayout,
+        });
+    }
+    async saveEmailLayoutDraft(projectId, layoutId, draftVersion, definition, options = {}) {
+        const operation = "saveEmailLayoutDraft";
+        return this.#request({
+            body: { draft_version: draftVersion, definition },
+            method: "PUT",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${layoutRoot(operation, projectId)}/${pathSegment(operation, layoutId, "layoutId")}/draft`,
+            validator: validateEmailLayout,
+        });
+    }
+    async publishEmailLayout(projectId, layoutId, draftVersion, options = {}) {
+        const operation = "publishEmailLayout";
+        return this.#request({
+            body: { draft_version: draftVersion },
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${layoutRoot(operation, projectId)}/${pathSegment(operation, layoutId, "layoutId")}/publish`,
+            validator: validatePublishedRevision,
+        });
+    }
+    /** Makes a published layout the project's default for email templates. */
+    async setDefaultEmailLayout(projectId, layoutId, options = {}) {
+        const operation = "setDefaultEmailLayout";
+        return this.#request({
+            method: "POST",
+            operation,
+            options,
+            sideEffect: true,
+            path: `${layoutRoot(operation, projectId)}/${pathSegment(operation, layoutId, "layoutId")}/default`,
+            validator: validateDefaultLayout,
+        });
+    }
     async createMessageCategory(projectId, request, options = {}) {
         const operation = "createMessageCategory";
         assertInput(operation, request, validateCreateMessageCategoryRequest);
@@ -1830,6 +2065,73 @@ export class WhooshBangClient {
             validator: validateBindingSummary,
         });
     }
+    async identifySubscriber(externalId, request, options = {}) {
+        return this.#identifySubscriber("identifySubscriber", "v1", externalId, request, options);
+    }
+    async identifySubscriberInEnvironment(projectId, environmentId, externalId, request, options = {}) {
+        const operation = "identifySubscriberInEnvironment";
+        return this.#identifySubscriber(operation, environmentRoot(operation, projectId, environmentId), externalId, request, options);
+    }
+    async #identifySubscriber(operation, root, externalId, request, options) {
+        assertInput(operation, request, validateIdentifySubscriberRequest);
+        return this.#request({
+            body: request,
+            idempotencyKey: options.idempotencyKey,
+            method: "PUT",
+            operation,
+            options,
+            path: `${root}/subscribers/${pathSegment(operation, externalId, "externalId")}`,
+            sideEffect: true,
+            validator: validateSubscriberSyncResult,
+        });
+    }
+    async identifySubscribers(request, options = {}) {
+        return this.#identifySubscribers("identifySubscribers", "v1", request, options);
+    }
+    async identifySubscribersInEnvironment(projectId, environmentId, request, options = {}) {
+        const operation = "identifySubscribersInEnvironment";
+        return this.#identifySubscribers(operation, environmentRoot(operation, projectId, environmentId), request, options);
+    }
+    async #identifySubscribers(operation, root, request, options) {
+        assertInput(operation, request, validateBatchIdentifySubscriberRequest);
+        return this.#request({
+            body: request,
+            idempotencyKey: options.idempotencyKey,
+            method: "PUT",
+            operation,
+            options,
+            path: `${root}/subscribers/batch-identify`,
+            sideEffect: true,
+            validator: validateBatchIdentifySubscriberResult,
+        });
+    }
+    async deactivateSubscriber(externalId, request, options = {}) {
+        return this.#subscriberLifecycle("deactivateSubscriber", "v1", externalId, request, "POST", "/deactivate", options);
+    }
+    async deactivateSubscriberInEnvironment(projectId, environmentId, externalId, request, options = {}) {
+        const operation = "deactivateSubscriberInEnvironment";
+        return this.#subscriberLifecycle(operation, environmentRoot(operation, projectId, environmentId), externalId, request, "POST", "/deactivate", options);
+    }
+    async deleteSubscriber(externalId, request, options = {}) {
+        return this.#subscriberLifecycle("deleteSubscriber", "v1", externalId, request, "DELETE", "", options);
+    }
+    async deleteSubscriberInEnvironment(projectId, environmentId, externalId, request, options = {}) {
+        const operation = "deleteSubscriberInEnvironment";
+        return this.#subscriberLifecycle(operation, environmentRoot(operation, projectId, environmentId), externalId, request, "DELETE", "", options);
+    }
+    async #subscriberLifecycle(operation, root, externalId, request, method, suffix, options) {
+        assertInput(operation, request, validateSubscriberLifecycleRequest);
+        return this.#request({
+            body: request,
+            idempotencyKey: options.idempotencyKey,
+            method,
+            operation,
+            options,
+            path: `${root}/subscribers/${pathSegment(operation, externalId, "externalId")}${suffix}`,
+            sideEffect: true,
+            validator: validateSubscriberSyncResult,
+        });
+    }
     async createSubscriber(request, options = {}) {
         return this.#createSubscriber("createSubscriber", "v1", request, options);
     }
@@ -4257,6 +4559,12 @@ function environmentRoot(operation, projectId, environmentId) {
     const environment = pathSegment(operation, environmentId, "environmentId");
     return `v1/projects/${project}/environments/${environment}`;
 }
+function templateRoot(operation, projectId) {
+    return `v1/projects/${pathSegment(operation, projectId, "projectId")}/message-templates`;
+}
+function layoutRoot(operation, projectId) {
+    return `v1/projects/${pathSegment(operation, projectId, "projectId")}/email-layouts`;
+}
 function subscriberGroupPath(operation, root, groupKey) {
     return `${root}/subscriber-groups/${pathSegment(operation, groupKey, "groupKey")}`;
 }