orderNumber.ts

mcp-server/src/lib/orderNumber.ts

1. /**
2. * Customer-facing display numbers (e.g. "MD2639582") are neither accepted nor
3. * returned by the API: resolution to the raw `order_ref` is client-side only.
4. *
5. * Rules (see docs/PLINTH-API.md, "Order numbers"):
6. * - current: ^MD(\d{2})(\d+)$ -> strip "MD" + the 2-digit year; the rest IS
7. * the order_ref.
8. * - a year later than this one: accept with a warning (likely a typo).
9. * - legacy: ^M-\d{6}$ (from before Plinth) -> refuse; route to a human.
10. */
12. export type ResolveAction = "accept" | "warn" | "refuse";
14. export interface DisplayNumberResolution {
15. action: ResolveAction;
16. /** Present when action is "accept" or "warn". */
17. orderId?: number;
18. /** Human-readable reason, for warn/refuse. */
19. note?: string;
20. }
22. const CURRENT = /^MD(\d{2})(\d+)$/;
23. const LEGACY = /^M-\d{6}$/;
25. export function resolveDisplayNumber(display: string, now: Date = new Date()): DisplayNumberResolution {
26. const value = display.trim().toUpperCase();
28. const current = CURRENT.exec(value);
29. if (current) {
30. const orderId = Number(current[2]);
31. if (Number(current[1]) > now.getUTCFullYear() % 100) {
32. return {
33. action: "warn",
34. orderId,
35. note: "The year in this number is later than the current year; check it was typed correctly.",
36. };
37. }
38. return { action: "accept", orderId };
39. }
41. if (LEGACY.test(value)) {
42. return {
43. action: "refuse",
44. note: "Legacy number from before Plinth; it is not resolvable by rule. Route to a human.",
45. };
46. }
48. return { action: "refuse", note: `Unrecognized display-number format: ${display}` };
49. }