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: LicenseRef-Carbon-Commercial
// Carbon Enterprise file, licensed only under the Carbon Commercial License
// (packages/ee/LICENSE). Not AGPL. Running, modifying, or copying it beyond those terms requires a commercial license.
import { describe, expect, it, vi } from "vitest";
import type {
CatalogIntegration,
WorkflowCatalog
} from "../definition/catalog";
import type { IntegrationNode } from "../definition/schema";
import { t } from "../definition/types";
import { createRuntimeContext } from "./fixtures";
import { integrationExecutor } from "./integration";
import type { WorkflowServices } from "./types";
const STEP: CatalogIntegration = {
id: "integration.google-calendar.create_google_calendar_event",
inputs: {
connectionId: { type: t.string, required: true },
title: { type: t.string, required: true }
},
outputs: { result: t.string },
batchable: false,
permission: { module: "workflows", action: "update" },
piece: { name: "google-calendar", action: "create_google_calendar_event" }
};
const node = (
data: Partial<IntegrationNode["data"]> = {}
): IntegrationNode => ({
id: "step",
name: "integration_0",
type: "integration",
position: { x: 0, y: 0 },
data: {
piece: "google-calendar",
action: "create_google_calendar_event",
inputs: {
connectionId: { kind: "literal", type: t.string, value: "icn_1" },
title: { kind: "literal", type: t.string, value: "Kickoff" }
},
...data
}
});
/** A catalog that answers for the one step above and nothing else. */
function catalogWith(step: CatalogIntegration | undefined): WorkflowCatalog {
const base = createRuntimeContext().catalog;
return {
...base,
getIntegration: (id) => (id === STEP.id ? step : undefined)
};
}
describe("integrationExecutor", () => {
it("runs the piece its catalog entry names and reports the result", async () => {
const runIntegration = vi.fn(async () => ({
ok: true as const,
outputs: {
result: {
kind: "primitive" as const,
of: "string" as const,
value: "{}"
}
}
}));
const ctx = createRuntimeContext({ services: { runIntegration } });
const outcome = await integrationExecutor.execute(node(), {
...ctx,
catalog: catalogWith(STEP)
});
// The piece comes off the catalog entry, never off the node's id.
expect(runIntegration).toHaveBeenCalledWith(STEP.piece, {
connectionId: { kind: "primitive", of: "string", value: "icn_1" },
title: { kind: "primitive", of: "string", value: "Kickoff" }
});
expect(outcome.status).toBe("Succeeded");
});
it("skips rather than fails when the step is no longer offered", async () => {
const ctx = createRuntimeContext();
const outcome = await integrationExecutor.execute(node(), {
...ctx,
catalog: catalogWith(undefined)
});
expect(outcome).toEqual({
status: "Skipped",
reason: "This integration step is no longer available."
});
});
it("gates on the permission its catalog entry carries", () => {
expect(integrationExecutor.permission(node(), catalogWith(STEP))).toEqual({
module: "workflows",
action: "update"
});
expect(
integrationExecutor.permission(node(), catalogWith(undefined))
).toBeUndefined();
});
describe("record links", () => {
const LINKED: CatalogIntegration = {
...STEP,
inputs: {
connectionId: { type: t.string, required: true },
text: {
type: t.string,
required: false,
links: { format: "slack" }
},
body: {
type: t.string,
required: false,
links: {
format: "html",
when: { input: "body_type", equals: ["html"] }
}
}
},
advancedInputs: {
body_type: {
type: t.string,
required: false,
defaultValue: "plain_text"
}
}
};
const orderTemplate = {
kind: "template" as const,
parts: [
{ kind: "text" as const, text: "See " },
{ kind: "ref" as const, nodeId: "trigger", output: "record", path: [] }
]
};
const linkedCtx = (runIntegration: WorkflowServices["runIntegration"]) => {
const base = createRuntimeContext({
outputs: {
trigger: {
record: {
kind: "entity" as const,
of: "purchaseOrder",
id: "po_1",
row: { purchaseOrderId: "PO000123" }
}
}
},
services: { runIntegration },
linkFor: (of: string, id: string) => `https://erp.test/${of}/${id}`
});
return { ...base, catalog: catalogWith(LINKED) };
};
const run = () => vi.fn(async () => ({ ok: true as const, outputs: {} }));
it("always links slack-format text", async () => {
const runIntegration = run();
await integrationExecutor.execute(
node({
inputs: {
connectionId: { kind: "literal", type: t.string, value: "icn_1" },
text: orderTemplate
}
}),
linkedCtx(runIntegration)
);
expect(runIntegration).toHaveBeenCalledWith(LINKED.piece, {
connectionId: { kind: "primitive", of: "string", value: "icn_1" },
text: {
kind: "primitive",
of: "string",
value: "See <https://erp.test/purchaseOrder/po_1|PO000123>"
}
});
});
it("renders plain text while the gate sibling holds its default", async () => {
const runIntegration = run();
await integrationExecutor.execute(
node({
inputs: {
connectionId: { kind: "literal", type: t.string, value: "icn_1" },
body: orderTemplate
}
}),
linkedCtx(runIntegration)
);
expect(runIntegration).toHaveBeenCalledWith(LINKED.piece, {
connectionId: { kind: "primitive", of: "string", value: "icn_1" },
body: { kind: "primitive", of: "string", value: "See PO000123" }
});
});
it("renders an html anchor once the author sets the gate sibling", async () => {
const runIntegration = run();
await integrationExecutor.execute(
node({
inputs: {
connectionId: { kind: "literal", type: t.string, value: "icn_1" },
body: orderTemplate,
body_type: { kind: "literal", type: t.string, value: "html" }
}
}),
linkedCtx(runIntegration)
);
expect(runIntegration).toHaveBeenCalledWith(LINKED.piece, {
connectionId: { kind: "primitive", of: "string", value: "icn_1" },
body: {
kind: "primitive",
of: "string",
value:
'See <a href="https://erp.test/purchaseOrder/po_1">PO000123</a>'
},
body_type: { kind: "primitive", of: "string", value: "html" }
});
});
});
});