Open-source manufacturing ERP, MES and QMS. Quoting, MRP, inventory, shop floor, quality and lot/serial traceability on one Postgres schema, with a REST API and MCP server. Self-host or use Carbon Cloud.
TypeScript ai-agentsbill-of-materialserpinventory-managementleanmanufacturingmanufacturing-execution-systemmcp-servermesmrpopen-source-erppostgresqlproduction-planningqmsquality-management-systemreact-routerself-hostedsupabasetraceabilitytypescript
// SPDX-License-Identifier: AGPL-3.0-only
// Carbon (github.com/crbnos/carbon). Modified or adapted versions of this file,
// including ports, remain AGPLv3; serving them over a network requires releasing their source.
import { describe, expect, it } from "vitest";
import {
getNotificationTopicChannels,
getNotificationTopicScope,
isNotificationTopic,
isNotificationTopicEnabledByDefault,
NotificationTopic,
notificationPreferenceCompanyId,
renderInlineLinks,
renderSlackMrkdwn,
USER_FACING_NOTIFICATION_TOPICS
} from "./index";
const ORIGIN = "https://app.carbon.ms";
const HREF = `${ORIGIN}/api/link?event=workflow&documentId=so_1`;
describe("renderInlineLinks", () => {
it("returns nothing for an empty string", () => {
expect(renderInlineLinks("", ORIGIN)).toEqual([]);
});
it("returns plain text as a single segment", () => {
expect(renderInlineLinks("Nothing to see", ORIGIN)).toEqual([
{ text: "Nothing to see" }
]);
});
it("splits a link out of the surrounding text", () => {
expect(
renderInlineLinks(`Check [SO000123](${HREF}) today`, ORIGIN)
).toEqual([
{ text: "Check " },
{ text: "SO000123", href: HREF },
{ text: " today" }
]);
});
it("handles two links in one body", () => {
const body = `[A](${HREF}) and [B](${HREF})`;
expect(renderInlineLinks(body, ORIGIN)).toEqual([
{ text: "A", href: HREF },
{ text: " and " },
{ text: "B", href: HREF }
]);
});
// The reason this function exists: the body is customer-authored.
it("leaves a javascript: url as literal text", () => {
const body = "[click](javascript:alert(1))";
expect(renderInlineLinks(body, ORIGIN)).toEqual([{ text: body }]);
});
it("leaves another host as literal text", () => {
const body = "[click](https://evil.example/steal)";
expect(renderInlineLinks(body, ORIGIN)).toEqual([{ text: body }]);
});
it("leaves a plain http url as literal text", () => {
const body = "[click](http://app.carbon.ms/x)";
expect(renderInlineLinks(body, ORIGIN)).toEqual([{ text: body }]);
});
it("leaves a relative path as literal text", () => {
const body = "[click](/x/sales/orders)";
expect(renderInlineLinks(body, ORIGIN)).toEqual([{ text: body }]);
});
it("treats an unparseable origin as no origin at all", () => {
const body = `Check [SO000123](${HREF})`;
expect(renderInlineLinks(body, "")).toEqual([{ text: body }]);
});
});
describe("renderSlackMrkdwn", () => {
it("rewrites a Carbon link as Slack mrkdwn", () => {
expect(renderSlackMrkdwn(`Check [SO000123](${HREF})`, ORIGIN)).toBe(
`Check <${HREF}|SO000123>`
);
});
it("leaves a link on another host as literal text", () => {
const body = "[click](https://evil.example/steal)";
expect(renderSlackMrkdwn(body, ORIGIN)).toBe(
"[click](https://evil.example/steal)"
);
});
// `|` would terminate the label, and Slack reads bare `&`/`<`/`>` as markup.
it("escapes Slack's control characters in both a label and plain text", () => {
expect(renderSlackMrkdwn(`A & B <c> [x|y](${HREF})`, ORIGIN)).toBe(
`A & B <c> <${HREF}|x¦y>`
);
});
it("returns an empty string for an empty message", () => {
expect(renderSlackMrkdwn("", ORIGIN)).toBe("");
});
});
describe("notification topic settings", () => {
it("lists the changelog newsletter on the settings page", () => {
expect(USER_FACING_NOTIFICATION_TOPICS).toContain(
NotificationTopic.Changelog
);
});
it("offers only email for the changelog newsletter", () => {
expect(getNotificationTopicChannels(NotificationTopic.Changelog)).toEqual([
"email"
]);
expect(getNotificationTopicChannels(NotificationTopic.Job)).toEqual([
"email",
"slack"
]);
});
it("scopes only the newsletter to the account", () => {
expect(getNotificationTopicScope(NotificationTopic.Changelog)).toBe(
"account"
);
expect(getNotificationTopicScope(NotificationTopic.Job)).toBe("company");
});
it("treats a missing preference as off only for the opt-in newsletter", () => {
expect(
isNotificationTopicEnabledByDefault(NotificationTopic.Changelog)
).toBe(false);
for (const topic of USER_FACING_NOTIFICATION_TOPICS) {
if (topic === NotificationTopic.Changelog) continue;
expect(isNotificationTopicEnabledByDefault(topic)).toBe(true);
}
});
});
describe("notificationPreferenceCompanyId", () => {
it("stores the newsletter once per person", () => {
expect(
notificationPreferenceCompanyId(NotificationTopic.Changelog, "c1")
).toBeNull();
});
it("stores every other topic per company", () => {
for (const topic of USER_FACING_NOTIFICATION_TOPICS) {
if (topic === NotificationTopic.Changelog) continue;
expect(notificationPreferenceCompanyId(topic, "c1")).toBe("c1");
}
});
});
describe("isNotificationTopic", () => {
it("accepts every topic and nothing else", () => {
for (const topic of Object.values(NotificationTopic)) {
expect(isNotificationTopic(topic)).toBe(true);
}
expect(isNotificationTopic("not-a-topic")).toBe(false);
});
});