Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/integrations/src/admin-email-tracking.test.ts
T

158 lines
4.5 KiB
TypeScript

import { describe, expect, it } from "vitest";
import {
adminEmailTrackingBaseUrl,
createAdminEmailTrackingToken,
hashAdminEmailTrackingToken,
prepareAdminEmailTracking,
verifyAdminEmailTrackingToken,
} from "./admin-email-tracking.js";
const secret = "a".repeat(32);
const expiresAt = new Date("2027-01-01T00:00:00.000Z");
describe("admin email tracking", () => {
it("rewrites only safe absolute links and appends a signed open pixel", () => {
const result = prepareAdminEmailTracking({
html: '<p><a href="https://example.com/a?x=1&amp;y=2">A</a><a href=\'mailto:a@example.com\'>M</a><a href="/local">L</a></p>',
scheduledEmailId: "scheduled-1",
adminUserId: "admin-1",
baseUrl: "https://admin.hivegrid.de",
secret,
expiresAt,
});
expect(result.links).toHaveLength(1);
expect(result.links[0]?.destinationUrl).toBe(
"https://example.com/a?x=1&y=2"
);
expect(result.links[0]?.trackingTokenHash).toMatch(/^[a-f0-9]{64}$/u);
expect(result.bodyHtml).toContain(
"https://admin.hivegrid.de/e/admin/c/scheduled-1?t="
);
expect(result.bodyHtml).toContain("mailto:a@example.com");
expect(result.bodyHtml).toContain('href="/local"');
expect(result.bodyHtml).toContain(
"https://admin.hivegrid.de/e/admin/o/scheduled-1.gif?t="
);
});
it("binds token kind, scheduled email, expiry, owner and click target", () => {
const token = createAdminEmailTrackingToken({
adminUserId: "admin-1",
scheduledEmailId: "scheduled-1",
kind: "click",
destinationUrl: "https://example.com/path",
expiresAtMs: expiresAt.getTime(),
secret,
});
expect(
verifyAdminEmailTrackingToken({
token,
scheduledEmailId: "scheduled-1",
kind: "click",
secret,
now: new Date("2026-12-31T00:00:00.000Z"),
})
).toEqual({
adminUserId: "admin-1",
scheduledEmailId: "scheduled-1",
kind: "click",
destinationUrl: "https://example.com/path",
expiresAtMs: expiresAt.getTime(),
});
expect(
verifyAdminEmailTrackingToken({
token,
scheduledEmailId: "scheduled-2",
kind: "click",
secret,
})
).toBeNull();
expect(
verifyAdminEmailTrackingToken({
token,
scheduledEmailId: "scheduled-1",
kind: "open",
secret,
})
).toBeNull();
expect(
verifyAdminEmailTrackingToken({
token,
scheduledEmailId: "scheduled-1",
kind: "click",
secret,
now: expiresAt,
})
).not.toBeNull();
expect(
verifyAdminEmailTrackingToken({
token,
scheduledEmailId: "scheduled-1",
kind: "click",
secret,
now: new Date(expiresAt.getTime() + 1),
})
).toBeNull();
expect(hashAdminEmailTrackingToken(token)).toMatch(/^[a-f0-9]{64}$/u);
});
it("rejects tampering, unsafe targets, short secrets and invalid origins", () => {
const token = createAdminEmailTrackingToken({
adminUserId: "admin-1",
scheduledEmailId: "scheduled-1",
kind: "open",
expiresAtMs: expiresAt.getTime(),
secret,
});
expect(
verifyAdminEmailTrackingToken({
token: `${token}x`,
scheduledEmailId: "scheduled-1",
kind: "open",
secret,
})
).toBeNull();
expect(() =>
createAdminEmailTrackingToken({
adminUserId: "admin-1",
scheduledEmailId: "scheduled-1",
kind: "click",
destinationUrl: "javascript:alert(1)",
expiresAtMs: expiresAt.getTime(),
secret,
})
).toThrow("invalid_admin_email_tracking_claims");
expect(() =>
createAdminEmailTrackingToken({
adminUserId: "admin-1",
scheduledEmailId: "scheduled-1",
kind: "open",
expiresAtMs: expiresAt.getTime(),
secret: "short",
})
).toThrow("admin_email_tracking_secret_too_short");
expect(() =>
prepareAdminEmailTracking({
html: "<p>Text</p>",
scheduledEmailId: "scheduled-1",
adminUserId: "admin-1",
baseUrl: "https://user:pass@example.com",
secret,
expiresAt,
})
).toThrow("invalid_admin_email_tracking_base_url");
});
it("uses HTTP only for local admin hosts", () => {
expect(adminEmailTrackingBaseUrl("admin.localhost:3000")).toBe(
"http://admin.localhost:3000"
);
expect(adminEmailTrackingBaseUrl("admin.hivegrid.de")).toBe(
"https://admin.hivegrid.de"
);
});
});