@tellescope/sdk 1.256.16 → 2.0.0-beta.0

package/lib/cjs/tests/api_tests/templated_message_date_fields.test.js

@@ -0,0 +1,202 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templated_message_date_field_tests = void 0;
+require('source-map-support').install();
+var setup_isolated_1 = require("../setup_isolated");
+var host = process.env.API_URL || 'http://localhost:8080';
+/**
+ * Coverage for how `get_templated_message` renders enduser field values that LOOK like dates.
+ *
+ * The rule: a value stored as text renders as the author stored it. `message_templating.ts` only
+ * reformats an actual `Date` object, and a custom field is always a string.
+ *
+ * This exists because that rule was silently broken IN PRODUCTION, and had been for a long time.
+ * The templating code read `if (fieldValue instanceof Date || isDate(fieldValue))`. Validator
+ * 13.11.0's `isDate` was timezone-dependent — it compared a UTC-parsed date against a local-time
+ * `.getDate()` — so it returned false on a US developer's machine but TRUE in UTC, which is what
+ * the servers run. A date of birth stored as "1985-03-12" therefore took the Date branch in
+ * production, was parsed as UTC midnight and localized to the enduser's timezone, and rendered in a
+ * patient-facing SMS or email as "3/11/1985, 7:00:00 PM" — the PREVIOUS day, with a time nobody
+ * entered. A January date lost a year: "2024-01-01" rendered "12/31/2023".
+ *
+ * The validator bump did not cause this; it made it reproducible locally, which is how it surfaced.
+ * Removing the `isDate` half of the condition fixes it in every timezone.
+ *
+ * This is the ONE intentional production behavior change in an otherwise behavior-neutral
+ * dependency PR, made deliberately rather than shipping wrong dates to patients for another
+ * cycle. Every other validator touched here was pinned to production's existing behavior.
+ *
+ * So the assertions below are about the day not moving and no clock time appearing, which is what a
+ * patient would actually notice. A pure-function test could not have caught this: the function that
+ * does the work is module-private and the endpoint is the real surface.
+ *
+ * Runs standalone or as part of the main suite:
+ *   npm run test:modular -- api_tests/templated_message_date_fields
+ */
+/** Values a customer realistically stores in a date-ish custom field, and what must come back. */
+var DATE_SHAPED_VALUES = [
+    { label: 'ISO date (the shape that regressed)', value: '1985-03-12' },
+    { label: 'ISO date, recent', value: '2024-01-01' },
+    { label: 'slash-separated date', value: '1999/12/31' },
+    { label: 'MM-DD-YYYY (the dateOfBirth format)', value: '03-12-1985' },
+    { label: 'ISO datetime string', value: '2024-06-15T14:30:00.000Z' },
+    { label: 'leap day', value: '2000-02-29' },
+];
+/** A rendered date-only value must not have grown a clock time or a timezone abbreviation. */
+var LOOKS_REFORMATTED = /\d{1,2}:\d{2}|\bAM\b|\bPM\b|\bE[SD]T\b|\bUTC\b|\bGMT\b/;
+var templated_message_date_field_checks = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var checks, tenant, sdk, userId, fields, enduser, i, _a, label, value, plaintext, dob, control;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                checks = [];
+                return [4 /*yield*/, (0, setup_isolated_1.setup_isolated_tenant)({ users: [{ isAdmin: true }] })];
+            case 1:
+                tenant = _b.sent();
+                _b.label = 2;
+            case 2:
+                _b.trys.push([2, , 10, 12]);
+                sdk = tenant.sdk;
+                userId = tenant.users[0].id;
+                fields = Object.fromEntries(DATE_SHAPED_VALUES.map(function (c, i) { return ["DateField".concat(i), c.value]; }));
+                return [4 /*yield*/, sdk.api.endusers.createOne({
+                        fname: 'Date',
+                        lname: 'Fields',
+                        timezone: 'America/New_York',
+                        fields: fields,
+                    })];
+            case 3:
+                enduser = _b.sent();
+                i = 0;
+                _b.label = 4;
+            case 4:
+                if (!(i < DATE_SHAPED_VALUES.length)) return [3 /*break*/, 7];
+                _a = DATE_SHAPED_VALUES[i], label = _a.label, value = _a.value;
+                return [4 /*yield*/, sdk.api.templates.get_templated_message({
+                        enduserId: enduser.id,
+                        userId: userId,
+                        channel: 'Chat',
+                        message: "[{{enduser.DateField".concat(i, "}}]"),
+                    })];
+            case 5:
+                plaintext = (_b.sent()).plaintext;
+                checks.push({
+                    label: "".concat(label, " renders exactly as stored"),
+                    pass: plaintext === "[".concat(value, "]"),
+                    detail: "stored ".concat(JSON.stringify(value), ", rendered ").concat(JSON.stringify(plaintext)),
+                });
+                // A second, independent signal for the specific symptom, so this still catches a shifted
+                // rendering even if the equality check above is ever loosened. Only meaningful for values
+                // that carry no time of their own — an ISO datetime legitimately contains one.
+                if (!LOOKS_REFORMATTED.test(value)) {
+                    checks.push({
+                        label: "".concat(label, " does not gain a clock time"),
+                        pass: !LOOKS_REFORMATTED.test(plaintext),
+                        detail: "rendered ".concat(JSON.stringify(plaintext)),
+                    });
+                }
+                _b.label = 6;
+            case 6:
+                i++;
+                return [3 /*break*/, 4];
+            case 7: return [4 /*yield*/, sdk.api.templates.get_templated_message({
+                    enduserId: enduser.id,
+                    userId: userId,
+                    channel: 'Chat',
+                    message: "DOB: {{enduser.DateField0}}",
+                })];
+            case 8:
+                dob = (_b.sent()).plaintext;
+                checks.push({
+                    label: 'a date of birth does not render as the previous day',
+                    pass: dob.includes('1985-03-12') && !dob.includes('3/11/1985'),
+                    detail: "rendered ".concat(JSON.stringify(dob)),
+                });
+                return [4 /*yield*/, sdk.api.templates.get_templated_message({
+                        enduserId: enduser.id,
+                        userId: userId,
+                        channel: 'Chat',
+                        message: "{{enduser.fname}} {{enduser.lname}}",
+                    })];
+            case 9:
+                control = (_b.sent()).plaintext;
+                checks.push({
+                    label: 'control: non-date fields are still templated at all',
+                    pass: control === 'Date Fields',
+                    detail: "rendered ".concat(JSON.stringify(control)),
+                });
+                return [2 /*return*/, checks];
+            case 10: return [4 /*yield*/, tenant.teardown()];
+            case 11:
+                _b.sent();
+                return [7 /*endfinally*/];
+            case 12: return [2 /*return*/];
+        }
+    });
+}); };
+/** Asserting wrapper, for standalone runs and for sequential use in the suite. */
+var templated_message_date_field_tests = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                _a = setup_isolated_1.assert_checks;
+                _b = ['Templated message date-shaped fields'];
+                return [4 /*yield*/, templated_message_date_field_checks()];
+            case 1:
+                _a.apply(void 0, _b.concat([_c.sent()]));
+                return [2 /*return*/];
+        }
+    });
+}); };
+exports.templated_message_date_field_tests = templated_message_date_field_tests;
+// Allow running this test file independently
+if (require.main === module) {
+    console.log("\uD83C\uDF10 Using API URL: ".concat(host));
+    (0, exports.templated_message_date_field_tests)()
+        .then(function () {
+        console.log("✅ Templated message date field test suite completed successfully");
+        process.exit(0);
+    })
+        .catch(function (error) {
+        console.error("❌ Templated message date field test suite failed:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=templated_message_date_fields.test.js.map

package/lib/cjs/tests/api_tests/templated_message_date_fields.test.js.map

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

package/lib/cjs/tests/api_tests/templated_message_link_in_href.test.d.ts

@@ -0,0 +1,3 @@
+/** Asserting wrapper, for standalone runs and for sequential use in the suite. */
+export declare const templated_message_link_in_href_tests: () => Promise<void>;
+//# sourceMappingURL=templated_message_link_in_href.test.d.ts.map

package/lib/cjs/tests/api_tests/templated_message_link_in_href.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templated_message_link_in_href.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/api_tests/templated_message_link_in_href.test.ts"],"names":[],"mappings":"AAyKA,kFAAkF;AAClF,eAAO,MAAM,oCAAoC,qBAEhD,CAAA"}

package/lib/cjs/tests/api_tests/templated_message_link_in_href.test.js

@@ -0,0 +1,233 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.templated_message_link_in_href_tests = void 0;
+require('source-map-support').install();
+var setup_isolated_1 = require("../setup_isolated");
+var host = process.env.API_URL || 'http://localhost:8080';
+/**
+ * Coverage for what `get_templated_message` does with a `{url}[text]` link template that sits in
+ * ATTRIBUTE position rather than in body text.
+ *
+ * `replaceLinks` scans the html as a flat string and, for every link template it finds, substitutes a
+ * complete `<a href="<tracking url>">text</a>` element. In body text that is the whole point. Inside an
+ * attribute it corrupts the document:
+ *
+ *   <a href="{https://x.com}[Click]" target="_blank" style="...">Button</a>
+ *     became
+ *   <a href="<a href="https://api.../r/TOKEN">Click</a>" target="_blank" style="...">Button</a>
+ *
+ * An html parser ends that start tag at the inner `">`, so the href value and every attribute after it
+ * render as visible text in the recipient's mail client — a styled CTA button turns into a paragraph of
+ * markup. That is what was reported from staging: a button reading
+ * `https://google.com/m" target="_blank" style="display:inline-block; ...;"> View Details`.
+ *
+ * A link template reaches an href either because the author put one there, or because they used a merge
+ * field there: every link resolver in `message_templating.ts` (`{{forms.<id>.link}}`,
+ * `{{portal.link.<page>}}`, `{{files.<id>.link}}`, ...) returns the `{url}[text]` form, not a URL, so
+ * `href="{{forms.<id>.link}}"` lands in the same place. `[$LINK_ONLY]` was the only way to avoid it, and
+ * nothing told an author it existed.
+ *
+ * Now a template in attribute position resolves to the bare tracking URL — tracked exactly as before,
+ * with the author's own anchor, styling and target left intact.
+ *
+ * End-to-end through the endpoint on purpose: `replaceLinks` is module-private, and this is the same
+ * endpoint the worker calls through `api_bridge.get_templated_message` on every outbound email.
+ *
+ * Runs standalone or as part of the main suite:
+ *   npm run test:modular -- api_tests/templated_message_link_in_href
+ */
+var LINK = 'https://example.com/landing-page';
+/** The reported shape: a table-based email CTA whose href holds a link template. */
+var BUTTON_HTML = function (linkTemplate) { return ("<td align=\"center\" style=\"border-radius: 30px;\">"
+    + "<a href=\"".concat(linkTemplate, "\" target=\"_blank\" style=\"display:inline-block; padding: 14px 36px; color:#ffffff;\">View Details</a>")
+    + "</td>"); };
+/** A tracked link is `<portal or api url>/r/<token>`; the token itself is not predictable. */
+var TRACKING_URL_EXP = /https?:\/\/[^\s"'<>]+\/r\/[A-Za-z0-9_-]+/;
+var templated_message_link_in_href_checks = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var checks, tenant, sdk_1, userId_1, enduser_1, templated, attributeHTML, cases, _i, cases_1, _a, label, message, html, bodyTemplate, _b, bodyHTML, bodyText, afterStrayBracket, strayHTML, linkOnlyHTML, mixed, mixedHTML, control;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                checks = [];
+                return [4 /*yield*/, (0, setup_isolated_1.setup_isolated_tenant)({ users: [{ isAdmin: true }] })];
+            case 1:
+                tenant = _c.sent();
+                _c.label = 2;
+            case 2:
+                _c.trys.push([2, , 13, 15]);
+                sdk_1 = tenant.sdk;
+                userId_1 = tenant.users[0].id;
+                return [4 /*yield*/, sdk_1.api.endusers.createOne({ fname: 'Link', lname: 'Href' })];
+            case 3:
+                enduser_1 = _c.sent();
+                templated = function (message, html) { return sdk_1.api.templates.get_templated_message({
+                    enduserId: enduser_1.id,
+                    userId: userId_1,
+                    channel: 'Email',
+                    message: message,
+                    html: html,
+                }); };
+                attributeHTML = BUTTON_HTML("{".concat(LINK, "}[").concat(LINK, "]"));
+                cases = [
+                    { label: 'plaintext carries the template too (composer HTML mode)', message: attributeHTML },
+                    { label: 'plaintext differs from html', message: 'View details at our site' },
+                ];
+                _i = 0, cases_1 = cases;
+                _c.label = 4;
+            case 4:
+                if (!(_i < cases_1.length)) return [3 /*break*/, 7];
+                _a = cases_1[_i], label = _a.label, message = _a.message;
+                return [4 /*yield*/, templated(message, attributeHTML)];
+            case 5:
+                html = (_c.sent()).html;
+                checks.push({
+                    label: "no <a> is spliced inside the href \u2014 ".concat(label),
+                    pass: !html.includes('href="<a') && !html.includes('</a>"'),
+                    detail: "rendered ".concat(JSON.stringify(html)),
+                });
+                checks.push({
+                    label: "the author's anchor stays a single well-formed tag \u2014 ".concat(label),
+                    pass: (html.match(/<a\s/g) || []).length === 1 && (html.match(/<\/a>/g) || []).length === 1,
+                    detail: "rendered ".concat(JSON.stringify(html)),
+                });
+                checks.push({
+                    label: "the href is the tracking URL, and the anchor keeps target and style \u2014 ".concat(label),
+                    pass: (new RegExp("<a href=\"".concat(TRACKING_URL_EXP.source, "\" target=\"_blank\" style=\"[^\"]+\">View Details</a>")).test(html)),
+                    detail: "rendered ".concat(JSON.stringify(html)),
+                });
+                checks.push({
+                    label: "click tracking still happens \u2014 ".concat(label),
+                    pass: TRACKING_URL_EXP.test(html) && !html.includes(LINK),
+                    detail: "rendered ".concat(JSON.stringify(html)),
+                });
+                _c.label = 6;
+            case 6:
+                _i++;
+                return [3 /*break*/, 4];
+            case 7:
+                bodyTemplate = "Read more here: {".concat(LINK, "}[Read more]");
+                return [4 /*yield*/, templated(bodyTemplate, "<p>".concat(bodyTemplate, "</p>"))];
+            case 8:
+                _b = _c.sent(), bodyHTML = _b.html, bodyText = _b.plaintext;
+                checks.push({
+                    label: 'a link template in body text still becomes an anchor',
+                    pass: new RegExp("<p>Read more here: <a href=\"".concat(TRACKING_URL_EXP.source, "\">Read more</a></p>")).test(bodyHTML),
+                    detail: "rendered ".concat(JSON.stringify(bodyHTML)),
+                });
+                checks.push({
+                    label: 'the plaintext version is unaffected by the html handling',
+                    pass: /^Read more here: Read more \(https?:\/\/.+\/r\/[A-Za-z0-9_-]+\)$/.test(bodyText),
+                    detail: "rendered ".concat(JSON.stringify(bodyText)),
+                });
+                afterStrayBracket = "<p>Tom & Jerry <3 \"quotes\" \u2014 {".concat(LINK, "}[Read more]</p>");
+                return [4 /*yield*/, templated('Tom & Jerry', afterStrayBracket)];
+            case 9:
+                strayHTML = (_c.sent()).html;
+                checks.push({
+                    label: 'a stray < in body text does not downgrade the link after it',
+                    pass: new RegExp("<a href=\"".concat(TRACKING_URL_EXP.source, "\">Read more</a>")).test(strayHTML),
+                    detail: "rendered ".concat(JSON.stringify(strayHTML)),
+                });
+                return [4 /*yield*/, templated('Button', BUTTON_HTML("{".concat(LINK, "}[$LINK_ONLY]")))];
+            case 10:
+                linkOnlyHTML = (_c.sent()).html;
+                checks.push({
+                    label: '[$LINK_ONLY] in an href behaves as it always has',
+                    pass: (new RegExp("<a href=\"".concat(TRACKING_URL_EXP.source, "\" target=\"_blank\" style=\"[^\"]+\">View Details</a>")).test(linkOnlyHTML)
+                        && !linkOnlyHTML.includes('$LINK_ONLY')),
+                    detail: "rendered ".concat(JSON.stringify(linkOnlyHTML)),
+                });
+                mixed = "<p>Or visit {".concat(LINK, "}[our site]</p>") + BUTTON_HTML("{".concat(LINK, "}[").concat(LINK, "]"));
+                return [4 /*yield*/, templated('Or visit our site', mixed)];
+            case 11:
+                mixedHTML = (_c.sent()).html;
+                checks.push({
+                    label: 'body and attribute templates in one message each resolve correctly',
+                    pass: ((mixedHTML.match(/<a\s/g) || []).length === 2
+                        && !mixedHTML.includes('href="<a')
+                        && new RegExp("<a href=\"".concat(TRACKING_URL_EXP.source, "\">our site</a>")).test(mixedHTML)),
+                    detail: "rendered ".concat(JSON.stringify(mixedHTML)),
+                });
+                return [4 /*yield*/, templated('{{enduser.fname}} {{enduser.lname}}', '')];
+            case 12:
+                control = (_c.sent()).plaintext;
+                checks.push({
+                    label: 'control: templating runs at all',
+                    pass: control === 'Link Href',
+                    detail: "rendered ".concat(JSON.stringify(control)),
+                });
+                return [2 /*return*/, checks];
+            case 13: return [4 /*yield*/, tenant.teardown()];
+            case 14:
+                _c.sent();
+                return [7 /*endfinally*/];
+            case 15: return [2 /*return*/];
+        }
+    });
+}); };
+/** Asserting wrapper, for standalone runs and for sequential use in the suite. */
+var templated_message_link_in_href_tests = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var _a, _b;
+    return __generator(this, function (_c) {
+        switch (_c.label) {
+            case 0:
+                _a = setup_isolated_1.assert_checks;
+                _b = ['Templated message link in href'];
+                return [4 /*yield*/, templated_message_link_in_href_checks()];
+            case 1:
+                _a.apply(void 0, _b.concat([_c.sent()]));
+                return [2 /*return*/];
+        }
+    });
+}); };
+exports.templated_message_link_in_href_tests = templated_message_link_in_href_tests;
+// Allow running this test file independently
+if (require.main === module) {
+    console.log("\uD83C\uDF10 Using API URL: ".concat(host));
+    (0, exports.templated_message_link_in_href_tests)()
+        .then(function () {
+        console.log("✅ Templated message link in href test suite completed successfully");
+        process.exit(0);
+    })
+        .catch(function (error) {
+        console.error("❌ Templated message link in href test suite failed:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=templated_message_link_in_href.test.js.map

package/lib/cjs/tests/api_tests/templated_message_link_in_href.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templated_message_link_in_href.test.js","sourceRoot":"","sources":["../../../../src/tests/api_tests/templated_message_link_in_href.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,EAAE,CAAC;AAExC,oDAI0B;AAE1B,IAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,uBAAgC,CAAA;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,IAAM,IAAI,GAAG,kCAAkC,CAAA;AAE/C,oFAAoF;AACpF,IAAM,WAAW,GAAG,UAAC,YAAoB,IAAK,OAAA,CAC5C,sDAAkD;MAChD,oBAAY,YAAY,6GAAqG;MAC7H,OAAO,CACV,EAJ6C,CAI7C,CAAA;AAED,8FAA8F;AAC9F,IAAM,gBAAgB,GAAG,0CAA0C,CAAA;AAEnE,IAAM,qCAAqC,GAAG;;;;;gBACtC,MAAM,GAAY,EAAE,CAAA;gBACX,qBAAM,IAAA,sCAAqB,EAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAA;;gBAApE,MAAM,GAAG,SAA2D;;;;gBAGhE,QAAQ,MAAM,IAAX,CAAW;gBAChB,WAAS,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;gBACjB,qBAAM,KAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAA;;gBAA5E,YAAU,SAAkE;gBAE5E,SAAS,GAAG,UAAC,OAAe,EAAE,IAAY,IAAK,OAAA,KAAG,CAAC,GAAG,CAAC,SAAS,CAAC,qBAAqB,CAAC;oBAC3F,SAAS,EAAE,SAAO,CAAC,EAAE;oBAAE,MAAM,UAAA;oBAAE,OAAO,EAAE,OAAO;oBAAE,OAAO,SAAA;oBAAE,IAAI,MAAA;iBAC/D,CAAC,EAFmD,CAEnD,CAAA;gBAMI,aAAa,GAAG,WAAW,CAAC,WAAI,IAAI,eAAK,IAAI,MAAG,CAAC,CAAA;gBACjD,KAAK,GAAG;oBACZ,EAAE,KAAK,EAAE,yDAAyD,EAAE,OAAO,EAAE,aAAa,EAAE;oBAC5F,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,0BAA0B,EAAE;iBAC9E,CAAA;sBAEqC,EAAL,eAAK;;;qBAAL,CAAA,mBAAK,CAAA;gBAA3B,gBAAkB,EAAhB,KAAK,WAAA,EAAE,OAAO,aAAA;gBACR,qBAAM,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,EAAA;;gBAAhD,IAAI,GAAK,CAAA,SAAuC,CAAA,KAA5C;gBAEZ,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,mDAAuC,KAAK,CAAE;oBACrD,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC3D,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE;iBAC3C,CAAC,CAAA;gBACF,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,oEAAwD,KAAK,CAAE;oBACtE,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;oBAC3F,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE;iBAC3C,CAAC,CAAA;gBACF,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,qFAAyE,KAAK,CAAE;oBACvF,IAAI,EAAE,CACJ,IAAI,MAAM,CAAC,oBAAY,gBAAgB,CAAC,MAAM,2DAAkD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7G;oBACD,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE;iBAC3C,CAAC,CAAA;gBACF,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,8CAAkC,KAAK,CAAE;oBAChD,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACzD,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAE;iBAC3C,CAAC,CAAA;;;gBAxB6B,IAAK,CAAA;;;gBA4BhC,YAAY,GAAG,2BAAoB,IAAI,iBAAc,CAAA;gBACX,qBAAM,SAAS,CAAC,YAAY,EAAE,aAAM,YAAY,SAAM,CAAC,EAAA;;gBAAjG,KAA0C,SAAuD,EAAzF,QAAQ,UAAA,EAAa,QAAQ,eAAA;gBAC3C,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,sDAAsD;oBAC7D,IAAI,EAAE,IAAI,MAAM,CAAC,uCAA+B,gBAAgB,CAAC,MAAM,yBAAqB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAC5G,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAE;iBAC/C,CAAC,CAAA;gBACF,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,0DAA0D;oBACjE,IAAI,EAAE,kEAAkE,CAAC,IAAI,CAAC,QAAQ,CAAC;oBACvF,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAE;iBAC/C,CAAC,CAAA;gBAKI,iBAAiB,GAAG,+CAAiC,IAAI,qBAAkB,CAAA;gBACrD,qBAAM,SAAS,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAA;;gBAA/D,SAAS,GAAK,CAAA,SAAiD,CAAA,KAAtD;gBACvB,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,6DAA6D;oBACpE,IAAI,EAAE,IAAI,MAAM,CAAC,oBAAY,gBAAgB,CAAC,MAAM,qBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;oBACtF,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAE;iBAChD,CAAC,CAAA;gBAI6B,qBAAM,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,WAAI,IAAI,kBAAe,CAAC,CAAC,EAAA;;gBAAhF,YAAY,GAAK,CAAA,SAA+D,CAAA,KAApE;gBAC1B,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,kDAAkD;oBACzD,IAAI,EAAE,CACJ,IAAI,MAAM,CAAC,oBAAY,gBAAgB,CAAC,MAAM,2DAAkD,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;2BACjH,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CACxC;oBACD,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAE;iBACnD,CAAC,CAAA;gBAGI,KAAK,GAAG,uBAAgB,IAAI,oBAAiB,GAAG,WAAW,CAAC,WAAI,IAAI,eAAK,IAAI,MAAG,CAAC,CAAA;gBAC3D,qBAAM,SAAS,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAA;;gBAAzD,SAAS,GAAK,CAAA,SAA2C,CAAA,KAAhD;gBACvB,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,oEAAoE;oBAC3E,IAAI,EAAE,CACJ,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;2BAC1C,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;2BAC/B,IAAI,MAAM,CAAC,oBAAY,gBAAgB,CAAC,MAAM,oBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CACnF;oBACD,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAE;iBAChD,CAAC,CAAA;gBAG6B,qBAAM,SAAS,CAAC,qCAAqC,EAAE,EAAE,CAAC,EAAA;;gBAAtE,OAAO,GAAK,CAAA,SAA0D,CAAA,UAA/D;gBAC1B,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,iCAAiC;oBACxC,IAAI,EAAE,OAAO,KAAK,WAAW;oBAC7B,MAAM,EAAE,mBAAY,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAE;iBAC9C,CAAC,CAAA;gBAEF,sBAAO,MAAM,EAAA;qBAEb,qBAAM,MAAM,CAAC,QAAQ,EAAE,EAAA;;gBAAvB,SAAuB,CAAA;;;;;KAE1B,CAAA;AAED,kFAAkF;AAC3E,IAAM,oCAAoC,GAAG;;;;;gBAClD,KAAA,8BAAa,CAAA;sBAAC,gCAAgC;gBAAE,qBAAM,qCAAqC,EAAE,EAAA;;gBAA7F,4BAAgD,SAA6C,GAAC,CAAA;;;;KAC/F,CAAA;AAFY,QAAA,oCAAoC,wCAEhD;AAED,6CAA6C;AAC7C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE;IAC3B,OAAO,CAAC,GAAG,CAAC,sCAAqB,IAAI,CAAE,CAAC,CAAA;IACxC,IAAA,4CAAoC,GAAE;SACnC,IAAI,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAA;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC;SACD,KAAK,CAAC,UAAC,KAAK;QACX,OAAO,CAAC,KAAK,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAA;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC,CAAC,CAAA;CACL"}

package/lib/cjs/tests/api_tests/templated_message_links.test.d.ts

@@ -0,0 +1,3 @@
+/** Asserting wrapper, for standalone runs and for sequential use in the suite. */
+export declare const templated_message_link_tests: () => Promise<void>;
+//# sourceMappingURL=templated_message_links.test.d.ts.map

package/lib/cjs/tests/api_tests/templated_message_links.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templated_message_links.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/api_tests/templated_message_links.test.ts"],"names":[],"mappings":"AA8KA,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,qBAExC,CAAA"}