@antelopejs/dms-mailing 0.3.4 → 0.4.0

package/dist/services/templates.d.ts

@@ -1,17 +1,44 @@
-import { type MailingTemplate } from "../db";
-import type { LocaleContent, TemplateContent, VariableDefinition } from "../types";
+import { type MailingTemplate, type MailingTemplateVersion, TemplateModel } from "../db";
+import { type TemplateChange } from "../engine";
+import type { Block, LocaleContent, TemplateContent, VariableDefinition } from "../types";
 export interface TemplateAuthor {
     name?: string;
     email: string;
 }
 export declare function localesOf(content: TemplateContent): string;
+export declare function requireTemplate(model: TemplateModel, id: string): Promise<MailingTemplate>;
 export declare function parseContent(template: MailingTemplate): TemplateContent;
+export declare function hasDraft(template: MailingTemplate): boolean;
+export declare function workingContent(template: MailingTemplate): TemplateContent;
+export declare function publishedVersionOf(template: MailingTemplate): number;
+export declare function isPublished(template: MailingTemplate): boolean;
 export declare function parseVariables(template: MailingTemplate): VariableDefinition[];
+export declare function workingVariables(template: MailingTemplate): VariableDefinition[];
+export interface TemplateDraft {
+    content: TemplateContent;
+    variables: VariableDefinition[];
+}
+export declare function pendingChanges(template: MailingTemplate): TemplateChange[];
 export declare function parseTestData(template: MailingTemplate): Record<string, unknown>;
+export declare function footerBlock(locale: string, text?: string): Block;
 export declare function blankContent(locale: string): TemplateContent;
-export declare function saveContent(tenantId: string, templateId: string, content: TemplateContent, author: string): Promise<void>;
+export declare function isStaleRevision(template: MailingTemplate, revision: number | undefined): boolean;
+export declare function saveDraft(tenantId: string, template: MailingTemplate, draft: TemplateDraft, author: string): Promise<number>;
+export declare function discardDraft(tenantId: string, template: MailingTemplate, author: string): Promise<void>;
+export declare function parseVersionChanges(row: MailingTemplateVersion): TemplateChange[];
+export declare function parseVersionVariables(row: MailingTemplateVersion): VariableDefinition[];
+export declare function restoreVersionAsDraft(tenantId: string, template: MailingTemplate, row: MailingTemplateVersion, author: string): Promise<number>;
+export declare function localesWithoutSubject(content: TemplateContent): string[];
+export interface PublishOutcome {
+    version: number;
+    changes: TemplateChange[];
+}
+export declare function publishTemplate(tenantId: string, template: MailingTemplate, author: string): Promise<PublishOutcome>;
+export declare function contentOfVersion(tenantId: string, template: MailingTemplate, version: number): Promise<TemplateContent>;
+export declare function parseVersionContent(row: MailingTemplateVersion): TemplateContent;
 export declare function contentFieldsOf(source: MailingTemplate): Partial<MailingTemplate>;
-export declare function initializeTemplate(tenantId: string, templateId: string, locale: string, author: string, source?: MailingTemplate): Promise<void>;
+export declare function initializeTemplate(tenantId: string, templateId: string, author: string, fields: Partial<MailingTemplate>): Promise<void>;
+export declare function blankFields(content: TemplateContent): Partial<MailingTemplate>;
 export declare function localeContentOf(content: TemplateContent, locale: string): LocaleContent | undefined;
 export declare function pickLocale(content: TemplateContent, wanted: string | undefined, fallback: string): string;
 export declare function displayName(user: TemplateAuthor): string;

package/dist/services/templates.js

@@ -1,90 +1,309 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.localesOf = localesOf;
+exports.requireTemplate = requireTemplate;
 exports.parseContent = parseContent;
+exports.hasDraft = hasDraft;
+exports.workingContent = workingContent;
+exports.publishedVersionOf = publishedVersionOf;
+exports.isPublished = isPublished;
 exports.parseVariables = parseVariables;
+exports.workingVariables = workingVariables;
+exports.pendingChanges = pendingChanges;
 exports.parseTestData = parseTestData;
+exports.footerBlock = footerBlock;
 exports.blankContent = blankContent;
-exports.saveContent = saveContent;
+exports.isStaleRevision = isStaleRevision;
+exports.saveDraft = saveDraft;
+exports.discardDraft = discardDraft;
+exports.parseVersionChanges = parseVersionChanges;
+exports.parseVersionVariables = parseVersionVariables;
+exports.restoreVersionAsDraft = restoreVersionAsDraft;
+exports.localesWithoutSubject = localesWithoutSubject;
+exports.publishTemplate = publishTemplate;
+exports.contentOfVersion = contentOfVersion;
+exports.parseVersionContent = parseVersionContent;
 exports.contentFieldsOf = contentFieldsOf;
 exports.initializeTemplate = initializeTemplate;
+exports.blankFields = blankFields;
 exports.localeContentOf = localeContentOf;
 exports.pickLocale = pickLocale;
 exports.displayName = displayName;
+const interface_api_1 = require("@antelopejs/interface-api");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const constants_1 = require("../constants");
 const db_1 = require("../db");
+const engine_1 = require("../engine");
+const template_attention_1 = require("./template-attention");
 function localesOf(content) {
     return Object.keys(content.locales).join(constants_1.LOCALE_LIST_SEPARATOR);
 }
+const EMPTY_CONTENT = '{"locales":{}}';
+const NEVER_PUBLISHED = 0;
+const STALE_DRAFT = "stale_draft";
+const VERSION_NOT_FOUND = "$dms_mailing.errors.version_not_found";
+const TEMPLATE_NOT_FOUND = "$dms_mailing.errors.template_not_found";
+async function requireTemplate(model, id) {
+    const template = await model.get(id);
+    if (!template)
+        throw new interface_api_1.HTTPResult(constants_1.HTTP_NOT_FOUND, TEMPLATE_NOT_FOUND);
+    return template;
+}
 function parseContent(template) {
-    return JSON.parse(template.json_content || '{"locales":{}}');
+    return JSON.parse(template.json_content || EMPTY_CONTENT);
+}
+function hasDraft(template) {
+    return Boolean(template.json_draft);
+}
+function workingContent(template) {
+    if (!template.json_draft)
+        return parseContent(template);
+    return JSON.parse(template.json_draft);
+}
+function publishedVersionOf(template) {
+    return template.publishedVersion;
+}
+function isPublished(template) {
+    return publishedVersionOf(template) > NEVER_PUBLISHED;
 }
 function parseVariables(template) {
-    return JSON.parse(template.json_variables || "[]");
+    return JSON.parse(template.json_variables);
+}
+function workingVariables(template) {
+    if (!hasDraft(template) || !template.json_variables_draft)
+        return parseVariables(template);
+    return JSON.parse(template.json_variables_draft);
+}
+function changesOf(template, draft) {
+    const wasPublished = isPublished(template);
+    const published = wasPublished ? parseContent(template) : { locales: {} };
+    const declared = wasPublished ? parseVariables(template) : [];
+    return [
+        ...(0, engine_1.diffContents)(published, draft.content),
+        ...(0, engine_1.diffVariables)(declared, draft.variables),
+    ];
+}
+function pendingChanges(template) {
+    if (!hasDraft(template))
+        return [];
+    return changesOf(template, {
+        content: workingContent(template),
+        variables: workingVariables(template),
+    });
 }
 function parseTestData(template) {
-    return JSON.parse(template.json_test_data || "{}");
+    return JSON.parse(template.json_test_data);
 }
 const FOOTER_LABELS = {
     en: { unsubscribe: "Unsubscribe", preferences: "Preferences" },
     fr: { unsubscribe: "Se désinscrire", preferences: "Préférences" },
 };
 const FOOTER_BLOCK_ID = "footer";
-function blankContent(locale) {
+function footerBlock(locale, text = "") {
     const labels = FOOTER_LABELS[locale] ?? FOOTER_LABELS.en;
-    const footer = {
+    return {
         id: FOOTER_BLOCK_ID,
         type: "footer",
-        text: "",
+        text,
         unsubscribeLabel: labels.unsubscribe,
         preferencesLabel: labels.preferences,
         visibleIf: null,
     };
+}
+function blankContent(locale) {
     return {
-        locales: { [locale]: { subject: "", preheader: "", blocks: [footer] } },
+        locales: {
+            [locale]: { subject: "", preheader: "", blocks: [footerBlock(locale)] },
+        },
     };
 }
-async function saveContent(tenantId, templateId, content, author) {
-    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(templateId, {
+const FIRST_DRAFT_REVISION = 0;
+const NO_ATTENTION = { attention: "", needsAttention: false };
+function isStaleRevision(template, revision) {
+    return revision !== undefined && revision !== template.draftRevision;
+}
+function draftWriteFields(template, author) {
+    return {
+        draftRevision: template.draftRevision + 1,
+        draftUpdatedAt: new Date(),
+        draftUpdatedBy: author,
+        updatedBy: author,
+    };
+}
+function isPublishedDraft(template, draft) {
+    return isPublished(template) && changesOf(template, draft).length === 0;
+}
+async function saveDraft(tenantId, template, draft, author) {
+    const { content, variables } = draft;
+    const locales = isPublished(template) ? {} : { locales: localesOf(content) };
+    const isClean = isPublishedDraft(template, draft);
+    const fields = draftWriteFields(template, author);
+    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(template._id, {
+        json_draft: isClean ? "" : JSON.stringify(content),
+        json_variables_draft: isClean ? "" : JSON.stringify(variables),
+        isDraftPending: !isClean,
+        ...fields,
+        ...locales,
+    });
+    await (0, template_attention_1.refreshAttentionIfFlagged)(tenantId, template, STALE_DRAFT);
+    return fields.draftRevision;
+}
+async function discardDraft(tenantId, template, author) {
+    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(template._id, {
+        json_draft: "",
+        json_variables_draft: "",
+        isDraftPending: false,
+        ...draftWriteFields(template, author),
+    });
+}
+function parseVersionChanges(row) {
+    return JSON.parse(row.json_changes);
+}
+function parseVersionVariables(row) {
+    return JSON.parse(row.json_variables);
+}
+function restoreVersionAsDraft(tenantId, template, row, author) {
+    const draft = {
+        content: parseVersionContent(row),
+        variables: parseVersionVariables(row),
+    };
+    return saveDraft(tenantId, template, draft, author);
+}
+function localesWithoutSubject(content) {
+    return Object.entries(content.locales)
+        .filter(([, locale]) => !locale.subject.trim())
+        .map(([code]) => code);
+}
+async function ship(tenantId, template, shipment, author) {
+    const { content, variables, version, changes } = shipment;
+    const shipped = {
         json_content: JSON.stringify(content),
+        json_variables: variables,
         locales: localesOf(content),
+        publishedAt: new Date(),
+        publishedBy: author,
+    };
+    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateVersionModel, tenantId).insert({
+        ...shipped,
+        templateId: template._id,
+        version,
+        json_changes: JSON.stringify(changes),
+    });
+    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(template._id, {
+        ...shipped,
+        json_draft: "",
+        json_variables_draft: "",
+        isDraftPending: false,
+        draftRevision: template.draftRevision + 1,
+        status: "live",
+        publishedVersion: version,
+        updatedBy: author,
+    });
+}
+async function publishTemplate(tenantId, template, author) {
+    const previous = publishedVersionOf(template);
+    const changes = pendingChanges(template);
+    const isUnchanged = previous > NEVER_PUBLISHED && changes.length === 0;
+    const version = isUnchanged ? previous : previous + 1;
+    if (isUnchanged)
+        await markLive(tenantId, template, previous, author);
+    else
+        await ship(tenantId, template, {
+            content: workingContent(template),
+            variables: JSON.stringify(workingVariables(template)),
+            version,
+            changes,
+        }, author);
+    await (0, template_attention_1.refreshTemplateAttention)(tenantId);
+    return { version, changes };
+}
+async function markLive(tenantId, template, version, author) {
+    const draft = hasDraft(template)
+        ? {
+            json_draft: "",
+            json_variables_draft: "",
+            isDraftPending: false,
+            draftRevision: template.draftRevision + 1,
+        }
+        : {};
+    await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(template._id, {
+        status: "live",
+        publishedVersion: version,
+        publishedAt: template.publishedAt ?? new Date(),
         updatedBy: author,
+        ...draft,
     });
 }
+async function contentOfVersion(tenantId, template, version) {
+    if (!version)
+        return workingContent(template);
+    const row = await (0, interface_database_decorators_1.GetModel)(db_1.TemplateVersionModel, tenantId).getVersion(template._id, version);
+    if (!row)
+        throw new interface_api_1.HTTPResult(constants_1.HTTP_NOT_FOUND, VERSION_NOT_FOUND);
+    return parseVersionContent(row);
+}
+function parseVersionContent(row) {
+    return JSON.parse(row.json_content);
+}
 function contentFieldsOf(source) {
+    const content = workingContent(source);
     return {
-        json_content: source.json_content,
-        json_variables: source.json_variables,
+        json_content: "",
+        json_draft: JSON.stringify(content),
+        isDraftPending: true,
+        json_variables: JSON.stringify(workingVariables(source)),
+        json_variables_draft: "",
         json_test_data: source.json_test_data,
-        locales: source.locales,
+        locales: localesOf(content),
+        publishedVersion: NEVER_PUBLISHED,
+        draftRevision: FIRST_DRAFT_REVISION,
+        ...NO_ATTENTION,
     };
 }
-async function initializeTemplate(tenantId, templateId, locale, author, source) {
-    const content = source
-        ? contentFieldsOf(source)
-        : blankFields(blankContent(locale));
+async function initializeTemplate(tenantId, templateId, author, fields) {
     await (0, interface_database_decorators_1.GetModel)(db_1.TemplateModel, tenantId).update(templateId, {
         status: "draft",
         json_variables: "[]",
         json_test_data: "{}",
-        ...content,
+        ...fields,
         updatedBy: author,
     });
+    await (0, template_attention_1.refreshTemplateAttention)(tenantId);
 }
 function blankFields(content) {
     return {
-        json_content: JSON.stringify(content),
+        json_content: "",
+        json_draft: JSON.stringify(content),
+        isDraftPending: true,
         locales: localesOf(content),
+        publishedVersion: NEVER_PUBLISHED,
+        draftRevision: FIRST_DRAFT_REVISION,
+        ...NO_ATTENTION,
     };
 }
 function localeContentOf(content, locale) {
     return content.locales[locale];
 }
+const LOCALE_PART_SEPARATOR = /[-_]/;
+function requestedCandidates(wanted) {
+    if (!wanted)
+        return [];
+    const [language = wanted] = wanted.split(LOCALE_PART_SEPARATOR);
+    return [wanted, language];
+}
 function pickLocale(content, wanted, fallback) {
     const available = Object.keys(content.locales);
-    const candidates = [wanted, fallback, constants_1.DEFAULT_FALLBACK_LOCALE, available[0]];
-    return (candidates.find((locale) => Boolean(locale && content.locales[locale])) ?? constants_1.DEFAULT_FALLBACK_LOCALE);
+    const byCode = new Map(available.map((code) => [code.toLowerCase(), code]));
+    const candidates = [
+        ...requestedCandidates(wanted),
+        fallback,
+        constants_1.DEFAULT_FALLBACK_LOCALE,
+        available[0],
+    ];
+    const match = candidates
+        .map((locale) => (locale ? byCode.get(locale.toLowerCase()) : undefined))
+        .find((code) => Boolean(code));
+    return match ?? constants_1.DEFAULT_FALLBACK_LOCALE;
 }
 function displayName(user) {
     return user.name || user.email;

package/dist/services/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/services/templates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/services/templates.ts"],"names":[],"mappings":"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"}

package/dist/services/webhook-status.d.ts

@@ -0,0 +1,27 @@
+import { type MailingWebhookStatus } from "../db";
+import type { WebhookReceipt, WebhookRefusal, WebhookStatus } from "../types";
+export declare const WEBHOOK_TEST_MESSAGE_ID = "dms-mailing-webhook-test";
+export declare const WEBHOOK_SECRET_HEADER = "x-mailing-webhook-secret";
+export declare const WEBHOOK_REFUSAL_MESSAGES: Record<WebhookRefusal, string>;
+export interface WebhookRefusalBody {
+    error: "webhook_refused";
+    reason: WebhookRefusal;
+    message: string;
+}
+export interface WebhookTestOutcome {
+    isReceived: boolean;
+    url: string;
+    durationMs: number;
+    httpStatus?: number;
+    refusal?: WebhookRefusal;
+    networkError?: string;
+}
+export type WebhookFetch = (url: string, init: RequestInit) => Promise<Response>;
+export declare function refusalBody(reason: WebhookRefusal): WebhookRefusalBody;
+export declare function secretRefusal(provided: string | undefined, stored: string | undefined): WebhookRefusal | null;
+export declare function isWebhookTestEvent(messageId: string): boolean;
+export declare function noteWebhookReceived(tenantId: string, receipt: Omit<WebhookReceipt, "at">): Promise<void>;
+export declare function noteWebhookRefused(tenantId: string, provider: string, reason: WebhookRefusal): Promise<void>;
+export declare function toWebhookStatus(row: MailingWebhookStatus | undefined): WebhookStatus;
+export declare function readWebhookStatus(tenantId: string): Promise<WebhookStatus>;
+export declare function sendWebhookTest(url: string, secret: string, fetcher?: WebhookFetch): Promise<WebhookTestOutcome>;

package/dist/services/webhook-status.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WEBHOOK_REFUSAL_MESSAGES = exports.WEBHOOK_SECRET_HEADER = exports.WEBHOOK_TEST_MESSAGE_ID = void 0;
+exports.refusalBody = refusalBody;
+exports.secretRefusal = secretRefusal;
+exports.isWebhookTestEvent = isWebhookTestEvent;
+exports.noteWebhookReceived = noteWebhookReceived;
+exports.noteWebhookRefused = noteWebhookRefused;
+exports.toWebhookStatus = toWebhookStatus;
+exports.readWebhookStatus = readWebhookStatus;
+exports.sendWebhookTest = sendWebhookTest;
+const logging_1 = require("@antelopejs/interface-core/logging");
+const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
+const db_1 = require("../db");
+const events_1 = require("./events");
+exports.WEBHOOK_TEST_MESSAGE_ID = "dms-mailing-webhook-test";
+exports.WEBHOOK_SECRET_HEADER = "x-mailing-webhook-secret";
+const WEBHOOK_TEST_EVENT_TYPE = "delivered";
+const WEBHOOK_TEST_TIMEOUT_MS = 10_000;
+const JSON_CONTENT_TYPE = "application/json";
+exports.WEBHOOK_REFUSAL_MESSAGES = {
+    missing_secret: `The ${exports.WEBHOOK_SECRET_HEADER} header is missing. Send the webhook secret shown in Mailing > Settings > Provider & webhook.`,
+    bad_secret: `The ${exports.WEBHOOK_SECRET_HEADER} header does not match the webhook secret of this workspace (Mailing > Settings > Provider & webhook). It changes when the secret is rotated.`,
+    invalid_event: 'The body is not a mailing event: send JSON with "messageId" and "type".',
+};
+function refusalBody(reason) {
+    return {
+        error: "webhook_refused",
+        reason,
+        message: exports.WEBHOOK_REFUSAL_MESSAGES[reason],
+    };
+}
+function secretRefusal(provided, stored) {
+    if (!provided)
+        return "missing_secret";
+    return (0, events_1.webhookSecretMatches)(provided, stored) ? null : "bad_secret";
+}
+function isWebhookTestEvent(messageId) {
+    return messageId === exports.WEBHOOK_TEST_MESSAGE_ID;
+}
+async function writeStatus(tenantId, patch) {
+    try {
+        await (0, interface_database_decorators_1.GetModel)(db_1.WebhookStatusModel, tenantId).record(tenantId, patch);
+    }
+    catch (error) {
+        logging_1.Logging.Error("[dms-mailing] Could not record the webhook status:", error);
+    }
+}
+function noteWebhookReceived(tenantId, receipt) {
+    return writeStatus(tenantId, {
+        receivedAt: new Date(),
+        receivedProvider: receipt.provider,
+        receivedType: receipt.type,
+        isReceivedMatched: receipt.isMatched,
+        isReceivedTest: receipt.isTest,
+    });
+}
+function noteWebhookRefused(tenantId, provider, reason) {
+    return writeStatus(tenantId, {
+        refusedAt: new Date(),
+        refusedProvider: provider,
+        refusedReason: reason,
+    });
+}
+function toWebhookStatus(row) {
+    return {
+        lastReceived: row?.receivedAt
+            ? {
+                at: row.receivedAt,
+                provider: row.receivedProvider ?? "",
+                type: row.receivedType ?? "",
+                isMatched: !!row.isReceivedMatched,
+                isTest: !!row.isReceivedTest,
+            }
+            : null,
+        lastRefused: row?.refusedAt && row.refusedReason
+            ? {
+                at: row.refusedAt,
+                provider: row.refusedProvider ?? "",
+                reason: row.refusedReason,
+            }
+            : null,
+    };
+}
+async function readWebhookStatus(tenantId) {
+    return toWebhookStatus(await (0, interface_database_decorators_1.GetModel)(db_1.WebhookStatusModel, tenantId).get(tenantId));
+}
+const describeError = (error) => error instanceof Error
+    ? String(error.cause?.message ?? error.message)
+    : String(error);
+async function refusalOf(response) {
+    try {
+        const body = (await response.json());
+        return body.reason;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function sendWebhookTest(url, secret, fetcher = fetch) {
+    const startedAt = Date.now();
+    const elapsed = () => Date.now() - startedAt;
+    try {
+        const response = await fetcher(url, {
+            method: "POST",
+            headers: {
+                "content-type": JSON_CONTENT_TYPE,
+                [exports.WEBHOOK_SECRET_HEADER]: secret,
+            },
+            body: JSON.stringify({
+                messageId: exports.WEBHOOK_TEST_MESSAGE_ID,
+                type: WEBHOOK_TEST_EVENT_TYPE,
+                details: { test: true },
+            }),
+            signal: AbortSignal.timeout(WEBHOOK_TEST_TIMEOUT_MS),
+        });
+        return {
+            isReceived: response.ok,
+            url,
+            durationMs: elapsed(),
+            httpStatus: response.status,
+            refusal: response.ok ? undefined : await refusalOf(response),
+        };
+    }
+    catch (error) {
+        return {
+            isReceived: false,
+            url,
+            durationMs: elapsed(),
+            networkError: describeError(error),
+        };
+    }
+}
+//# sourceMappingURL=webhook-status.js.map

package/dist/services/webhook-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-status.js","sourceRoot":"","sources":["../../src/services/webhook-status.ts"],"names":[],"mappings":"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"}

package/dist/types/blocks.d.ts

@@ -1,2 +1,3 @@
 export type { Block, BlockBase, BlockType, ButtonBlock, CodeBlock, Condition, ConditionOperator, DividerBlock, FooterBlock, HeadingBlock, HeroBlock, IfBlock, ListBlock, LocaleContent, ParagraphBlock, TemplateContent, TextAlign, TotalBlock, VariableDefinition, VariableType, } from "@antelopejs/interface-dms-mailing";
 export type TemplateStatus = "draft" | "live" | "archived";
+export type TemplateAttentionReason = "stale_draft" | "never_sent" | "missing_locale";

package/dist/types/index.d.ts

@@ -2,3 +2,5 @@ export * from "./blocks";
 export * from "./resolved";
 export * from "./sends";
 export * from "./settings";
+export * from "./suppressions";
+export * from "./webhook";

package/dist/types/index.js

@@ -18,4 +18,6 @@ __exportStar(require("./blocks"), exports);
 __exportStar(require("./resolved"), exports);
 __exportStar(require("./sends"), exports);
 __exportStar(require("./settings"), exports);
+__exportStar(require("./suppressions"), exports);
+__exportStar(require("./webhook"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB;AACxB,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB;AACxB,6CAA2B;AAC3B,iDAA+B;AAC/B,4CAA0B"}

package/dist/types/sends.d.ts

@@ -1,7 +1,14 @@
-import type { SendStatus } from "@antelopejs/interface-dms-mailing";
+import type { SendEventType, SendStatus } from "@antelopejs/interface-dms-mailing";
 export type { SendEventType, SendStatus, } from "@antelopejs/interface-dms-mailing";
+export declare const SEND_EVENT_TYPES: SendEventType[];
 export declare const SEND_STATUSES: SendStatus[];
 export declare const PROBLEM_STATUSES: SendStatus[];
+export type SendStage = "problem" | "in_progress" | "delivered" | "engaged" | "unsubscribed" | "suppressed" | "resolved";
+export declare const SEND_STAGES: SendStage[];
+export declare const STAGE_BY_STATUS: Record<SendStatus, SendStage>;
+export declare const RESOLVED_STAGE: SendStage;
+export declare function stageOf(status: SendStatus, isResolved?: boolean): SendStage;
+export declare function isResolvedStage(stage: SendStage | undefined): boolean;
 export type SendAudience = "business" | "operational";
 export declare const SEND_AUDIENCE_QUERY_KEY = "audience";
 export declare const BUSINESS_AUDIENCE = "business";
@@ -11,4 +18,6 @@ export interface SendEventDetails {
     userAgent?: string;
     reason?: string;
     code?: string;
+    eventId?: string;
+    bounceType?: string;
 }