Loop definitions

Loop definitions

@loop-engine/definitions is the canonical source for Commerce Chain loop IDs, event names, and the LoopParticipantManifest shape domain modules implement.

LoopIds

import { LoopIds } from "@loop-engine/definitions";

LoopIds.SCM_PROCUREMENT; // "scm.procurement"
LoopIds.SCM_FULFILLMENT; // "scm.fulfillment"
LoopIds.SCM_QUALITY; // "scm.quality"
LoopIds.SCM_REPLENISHMENT; // "scm.replenishment"
LoopIds.SCM_INVENTORY; // "scm.inventory"
LoopIds.SCM_EXECUTION; // "scm.execution"

LoopIds.DCM_DEMAND_SIGNAL; // "dcm.demand-signal"
LoopIds.DCM_DEMAND; // "dcm.demand"
LoopIds.DCM_ORDER; // "dcm.order"
LoopIds.DCM_RETURNS; // "dcm.returns"
LoopIds.DCM_CHANNELS; // "dcm.channels"

EventNames

Convention: {family}.{module}.{snake_case_past_tense}.v{N}

import { EventNames } from "@loop-engine/definitions";

EventNames.INVENTORY_STOCK_RESERVED; // "scm.inventory.stock_reserved.v1"
EventNames.INVENTORY_STOCK_RESERVATION_FAILED;
EventNames.INVENTORY_STOCK_RETURNED;

EventNames.PROCUREMENT_PO_CONFIRMED; // "scm.procurement.po_confirmed.v1"
EventNames.EXECUTION_GOODS_RECEIVED; // "scm.execution.goods_received.v1"

EventNames.DEMAND_REPLENISHMENT_TRIGGERED;
EventNames.DEMAND_THRESHOLD_BREACH_DETECTED;

EventNames.ORDERS_ORDER_CONFIRMED;
EventNames.ORDERS_ORDER_LINE_SHIPPED;

EventNames.RETURNS_RMA_APPROVED;
EventNames.RETURNS_RETURN_RECEIVED;
EventNames.RETURNS_RETURN_CREDITED;

LoopParticipantManifest

import type { LoopParticipantManifest } from "@loop-engine/definitions";

// Every module exports a manifest:
// { moduleId, description?, handles: [{ event, loops, description? }] }

Participant validation

@loop-engine/actors ships tests that fail CI when a participant references an unknown loop or event constant — keeping the graph consistent as you add modules.

Serializable definitions

The package also publishes data-first loop definitions (states, transitions) for dashboards, compliance maps, and tooling. Browse:

• registry.betterdata.co/loop-definitions

Install

npm install @loop-engine/definitions

→ Loops
→ SCM packages · DCM packages