@voyant-travel/notifications 0.111.7

package/dist/liquid.d.ts

@@ -0,0 +1,5 @@
+import { Liquid } from "liquidjs";
+declare const engine: Liquid;
+export declare function renderLiquidTemplate(template: string | null | undefined, data: Record<string, unknown>): string | null;
+export { engine as notificationLiquidEngine };
+//# sourceMappingURL=liquid.d.ts.map

package/dist/liquid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid.d.ts","sourceRoot":"","sources":["../src/liquid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,QAAA,MAAM,MAAM,QAOV,CAAA;AAqIF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,IAAI,CAiBf;AAED,OAAO,EAAE,MAAM,IAAI,wBAAwB,EAAE,CAAA"}

package/dist/liquid.js

@@ -0,0 +1,156 @@
+import { Liquid } from "liquidjs";
+const engine = new Liquid({
+    strictFilters: false,
+    strictVariables: false,
+    trimTagLeft: false,
+    trimTagRight: false,
+    greedy: false,
+    jsTruthy: true,
+});
+engine.registerFilter("json", (value) => JSON.stringify(value ?? null));
+engine.registerFilter("currency", (value, currency = "EUR", locale = "en-US") => {
+    const num = typeof value === "number" ? value : Number.parseFloat(String(value));
+    if (Number.isNaN(num))
+        return String(value ?? "");
+    return new Intl.NumberFormat(String(locale), {
+        style: "currency",
+        currency: String(currency || "EUR"),
+    }).format(num);
+});
+engine.registerFilter("date_format", (value, _format, locale = "en-US") => {
+    if (!value)
+        return "";
+    const date = value instanceof Date ? value : new Date(String(value));
+    if (Number.isNaN(date.getTime()))
+        return String(value);
+    return date.toLocaleDateString(String(locale), {
+        year: "numeric",
+        month: "long",
+        day: "numeric",
+    });
+});
+engine.registerFilter("phone", (value) => {
+    if (!value)
+        return "";
+    const phone = String(value).replace(/\D/g, "");
+    if (phone.length === 10) {
+        return `(${phone.slice(0, 3)}) ${phone.slice(3, 6)}-${phone.slice(6)}`;
+    }
+    if (phone.length === 11 && phone.startsWith("1")) {
+        return `+1 (${phone.slice(1, 4)}) ${phone.slice(4, 7)}-${phone.slice(7)}`;
+    }
+    if (phone.length > 10) {
+        return `+${phone.slice(0, -9)} ${phone.slice(-9, -6)} ${phone.slice(-6, -3)} ${phone.slice(-3)}`;
+    }
+    return String(value);
+});
+engine.registerFilter("default", (value, defaultValue) => {
+    if (value === null || value === undefined || value === "")
+        return defaultValue;
+    return value;
+});
+engine.registerFilter("pluralize", (count, singular, plural) => {
+    const num = typeof count === "number" ? count : Number.parseInt(String(count), 10);
+    return num === 1 ? singular : plural;
+});
+function toSnakeCase(str) {
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function normalizeKeys(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        result[key] =
+            value && typeof value === "object" && !Array.isArray(value)
+                ? normalizeKeys(value)
+                : value;
+        const snakeKey = toSnakeCase(key);
+        if (snakeKey !== key) {
+            result[snakeKey] = result[key];
+        }
+    }
+    return result;
+}
+function decodeHtmlEntities(str) {
+    return str
+        .replace(/"/g, '"')
+        .replace(/'/g, "'")
+        .replace(/&/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">");
+}
+function healBrokenTags(html) {
+    html = html.replace(/\{\{([\s\S]{1,300}?)\}\}/g, (match) => {
+        let healed = match;
+        if (/</.test(healed))
+            healed = healed.replace(/<[^>]+>/g, "").replace(/\s+/g, " ");
+        if (/&\w+;/.test(healed))
+            healed = decodeHtmlEntities(healed);
+        return healed;
+    });
+    html = html.replace(/\{%([\s\S]{1,300}?)%\}/g, (match) => {
+        let healed = match;
+        if (/</.test(healed))
+            healed = healed.replace(/<[^>]+>/g, "").replace(/\s+/g, " ");
+        if (/&\w+;/.test(healed))
+            healed = decodeHtmlEntities(healed);
+        return healed;
+    });
+    return html;
+}
+function healSyntax(template) {
+    let result = healBrokenTags(template);
+    result = result.replace(/\{%[-\s]*for\s+(\w+)\s*[-]?%\}/gi, (match, collection) => {
+        if (/\bfor\s+\w+\s+in\s+/i.test(match))
+            return match;
+        const singular = collection.endsWith("ies")
+            ? `${collection.slice(0, -3)}y`
+            : collection.endsWith("s")
+                ? collection.slice(0, -1)
+                : `${collection}_item`;
+        return `{% for ${singular} in ${collection} %}`;
+    });
+    result = result.replace(/\{%[-\s]*(endfor|endif|else|endunless|endcase|endcapture|endraw)\s*[-]?%\}/gi, (_match, tag) => `{% ${tag.toLowerCase()} %}`);
+    return result;
+}
+function regexFallback(template, data) {
+    function resolve(obj, path) {
+        const parts = path.split(".");
+        let cur = obj;
+        for (const p of parts) {
+            if (cur == null || typeof cur !== "object")
+                return undefined;
+            cur = cur[p];
+        }
+        return cur;
+    }
+    let result = template;
+    result = result.replace(/\{\{\s*([^}|]+?)(?:\s*\|[^}]*)?\s*\}\}/g, (_match, rawPath) => {
+        const path = rawPath.trim();
+        const value = resolve(data, path);
+        if (value !== undefined && value !== null)
+            return String(value);
+        return _match;
+    });
+    result = result.replace(/\{%[\s\S]*?%\}/g, "");
+    return result;
+}
+export function renderLiquidTemplate(template, data) {
+    if (!template)
+        return null;
+    const normalized = normalizeKeys(data);
+    const healed = healSyntax(template);
+    try {
+        return engine.parseAndRenderSync(healed, normalized);
+    }
+    catch (error) {
+        console.error("[notifications:liquid] template parsing failed, falling back to regex", error);
+    }
+    try {
+        return regexFallback(healed, normalized);
+    }
+    catch (fallbackError) {
+        console.error("[notifications:liquid] regex fallback failed", fallbackError);
+        return template;
+    }
+}
+export { engine as notificationLiquidEngine };

package/dist/providers/local.d.ts

@@ -0,0 +1,22 @@
+import type { NotificationChannel, NotificationPayload, NotificationProvider } from "../types.js";
+/**
+ * Options for {@link createLocalProvider}.
+ */
+export interface LocalProviderOptions {
+    /** Channels this provider advertises. Defaults to `["email", "sms"]`. */
+    channels?: ReadonlyArray<NotificationChannel>;
+    /**
+     * Optional sink for captured payloads. Defaults to `console.log`.
+     * Tests can pass a vi.fn() to capture notifications without console noise.
+     */
+    sink?: (payload: NotificationPayload) => void;
+    /** Provider name (defaults to `"local"`). Useful for stacking multiple locals. */
+    name?: string;
+}
+/**
+ * Create a development/test notification provider that captures sends to a
+ * sink (console by default) and returns synthetic message ids. Never makes
+ * network calls.
+ */
+export declare function createLocalProvider(options?: LocalProviderOptions): NotificationProvider;
+//# sourceMappingURL=local.d.ts.map

package/dist/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EAErB,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAC7C;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAA;IAC7C,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,oBAAoB,CAmB5F"}

package/dist/providers/local.js

@@ -0,0 +1,23 @@
+/**
+ * Create a development/test notification provider that captures sends to a
+ * sink (console by default) and returns synthetic message ids. Never makes
+ * network calls.
+ */
+export function createLocalProvider(options = {}) {
+    const name = options.name ?? "local";
+    const channels = options.channels ?? ["email", "sms"];
+    const sink = options.sink ??
+        ((payload) => {
+            console.log(`[notifications:${name}]`, payload);
+        });
+    let counter = 0;
+    return {
+        name,
+        channels,
+        async send(payload) {
+            counter += 1;
+            sink(payload);
+            return { id: `${name}_${counter}`, provider: name };
+        },
+    };
+}

package/dist/providers/voyant-cloud-email.d.ts

@@ -0,0 +1,27 @@
+import type { VoyantCloudClient } from "@voyant-travel/cloud-sdk";
+import type { NotificationProvider } from "../types.js";
+export interface VoyantCloudEmailRendered {
+    subject: string;
+    html?: string;
+    text?: string;
+}
+export interface VoyantCloudEmailProviderOptions {
+    /** Cloud SDK client. Construct via `getVoyantCloudClient(env)`. */
+    client: VoyantCloudClient;
+    /** Default sender address. Payload `from` overrides. */
+    from: string;
+    /** Optional default reply-to addresses. Payload may override per-send. */
+    replyTo?: ReadonlyArray<string>;
+    /**
+     * Render a template id + data tuple into an email body. When omitted,
+     * the payload's `template` is used as the subject and `data` is
+     * JSON-stringified into the text body.
+     */
+    renderTemplate?: (template: string, data: unknown) => Promise<VoyantCloudEmailRendered> | VoyantCloudEmailRendered;
+}
+/**
+ * Notification provider that delivers email through the Voyant Cloud
+ * `/email/v1/messages` endpoint.
+ */
+export declare function createVoyantCloudEmailProvider(options: VoyantCloudEmailProviderOptions): NotificationProvider;
+//# sourceMappingURL=voyant-cloud-email.d.ts.map

package/dist/providers/voyant-cloud-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyant-cloud-email.d.ts","sourceRoot":"","sources":["../../src/providers/voyant-cloud-email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,KAAK,EAA0B,oBAAoB,EAAsB,MAAM,aAAa,CAAA;AAEnG,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,+BAA+B;IAC9C,mEAAmE;IACnE,MAAM,EAAE,iBAAiB,CAAA;IACzB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,0EAA0E;IAC1E,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,KACV,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAA;CAClE;AAsBD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,oBAAoB,CAqDtB"}

package/dist/providers/voyant-cloud-email.js

@@ -0,0 +1,73 @@
+function mapAttachments(attachments) {
+    if (!attachments || attachments.length === 0)
+        return undefined;
+    return attachments.map((attachment) => ({
+        filename: attachment.filename,
+        ...(attachment.contentBase64 ? { content: attachment.contentBase64 } : {}),
+        ...(attachment.path ? { path: attachment.path } : {}),
+        ...(attachment.contentType ? { contentType: attachment.contentType } : {}),
+        ...(attachment.contentId ? { contentId: attachment.contentId } : {}),
+    }));
+}
+function attachEmailRequestContext(error, request) {
+    if (!error || typeof error !== "object")
+        return;
+    Object.defineProperty(error, "notificationRequest", {
+        configurable: true,
+        enumerable: true,
+        value: request,
+    });
+}
+/**
+ * Notification provider that delivers email through the Voyant Cloud
+ * `/email/v1/messages` endpoint.
+ */
+export function createVoyantCloudEmailProvider(options) {
+    return {
+        name: "voyant-cloud-email",
+        channels: ["email"],
+        async send(payload) {
+            if (payload.channel !== "email") {
+                throw new Error(`Voyant Cloud email provider only supports the "email" channel, got "${payload.channel}"`);
+            }
+            const rendered = options.renderTemplate
+                ? await options.renderTemplate(payload.template, payload.data)
+                : {
+                    subject: payload.subject ?? payload.template,
+                    text: JSON.stringify(payload.data ?? {}),
+                };
+            const attachments = mapAttachments(payload.attachments);
+            const request = {
+                from: payload.from ?? options.from,
+                to: [payload.to],
+                subject: payload.subject ?? rendered.subject,
+                html: payload.html ?? rendered.html ?? null,
+                text: payload.text ?? rendered.text ?? null,
+                ...(attachments ? { attachments } : {}),
+                ...(options.replyTo ? { replyTo: [...options.replyTo] } : {}),
+            };
+            let message;
+            try {
+                message = await options.client.email.sendMessage(request);
+            }
+            catch (error) {
+                attachEmailRequestContext(error, {
+                    from: request.from,
+                    to: request.to,
+                    replyTo: "replyTo" in request ? request.replyTo : null,
+                    subject: request.subject,
+                    attachmentCount: attachments?.length ?? 0,
+                    attachments: attachments?.map((attachment) => ({
+                        filename: attachment.filename,
+                        path: attachment.path ?? null,
+                        contentType: attachment.contentType ?? null,
+                        contentId: attachment.contentId ?? null,
+                        hasContent: Boolean(attachment.content),
+                    })) ?? [],
+                });
+                throw error;
+            }
+            return { id: message.id, provider: "voyant-cloud-email" };
+        },
+    };
+}

package/dist/providers/voyant-cloud-sms.d.ts

@@ -0,0 +1,26 @@
+import type { VoyantCloudClient } from "@voyant-travel/cloud-sdk";
+import type { NotificationProvider } from "../types.js";
+export interface VoyantCloudSmsRendered {
+    text: string;
+}
+export interface VoyantCloudSmsProviderOptions {
+    /** Cloud SDK client. Construct via `getVoyantCloudClient(env)`. */
+    client: VoyantCloudClient;
+    /**
+     * Default sender phone number. When omitted, the cloud account's default
+     * shared number is used (server-side selection).
+     */
+    from?: string;
+    /**
+     * Render a template id + data tuple into an SMS body. When omitted, the
+     * payload's `text` field is used directly, falling back to a JSON dump of
+     * `data`.
+     */
+    renderTemplate?: (template: string, data: unknown) => Promise<VoyantCloudSmsRendered> | VoyantCloudSmsRendered;
+}
+/**
+ * Notification provider that delivers SMS through the Voyant Cloud
+ * `/sms/v1/messages` endpoint.
+ */
+export declare function createVoyantCloudSmsProvider(options: VoyantCloudSmsProviderOptions): NotificationProvider;
+//# sourceMappingURL=voyant-cloud-sms.d.ts.map

package/dist/providers/voyant-cloud-sms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voyant-cloud-sms.d.ts","sourceRoot":"","sources":["../../src/providers/voyant-cloud-sms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAA;AAE3E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,6BAA6B;IAC5C,mEAAmE;IACnE,MAAM,EAAE,iBAAiB,CAAA;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,cAAc,CAAC,EAAE,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,KACV,OAAO,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAAA;CAC9D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,6BAA6B,GACrC,oBAAoB,CAwBtB"}

package/dist/providers/voyant-cloud-sms.js

@@ -0,0 +1,24 @@
+/**
+ * Notification provider that delivers SMS through the Voyant Cloud
+ * `/sms/v1/messages` endpoint.
+ */
+export function createVoyantCloudSmsProvider(options) {
+    return {
+        name: "voyant-cloud-sms",
+        channels: ["sms"],
+        async send(payload) {
+            if (payload.channel !== "sms") {
+                throw new Error(`Voyant Cloud SMS provider only supports the "sms" channel, got "${payload.channel}"`);
+            }
+            const rendered = options.renderTemplate
+                ? await options.renderTemplate(payload.template, payload.data)
+                : { text: payload.text ?? JSON.stringify(payload.data ?? {}) };
+            const message = await options.client.sms.sendMessage({
+                to: payload.to,
+                from: payload.from ?? options.from ?? null,
+                body: payload.text ?? rendered.text,
+            });
+            return { id: message.id, provider: "voyant-cloud-sms" };
+        },
+    };
+}