@prefixcheck/edi 0.1.0

package/dist/samples.js

@@ -0,0 +1,100 @@
+// ============================================================
+// @prefixcheck/edi · sample messages for demos, tests, and docs
+//
+// Real-shape SMDG D.00B CODECO + COPRAR messages with valid
+// ISO 6346 container check digits. The container number
+// MSCU1234566 appears in both so that `reconcile()` against
+// them produces a clean cross-match in tests and examples.
+// ============================================================
+/**
+ * A complete SMDG-shape CODECO message: gate-in report from
+ * terminal ECT Rotterdam to carrier MSC, one full 40-foot
+ * high-cube container (MSCU1234566) bound for New York.
+ */
+export const SAMPLE_CODECO = `UNA:+.? '
+UNB+UNOA:2+TERMINAL01:ZZZ+MSCU:ZZZ+260524:1430+CDC00012345'
+UNH+CDC0001+CODECO:D:00B:UN:SMDG21'
+BGM+34:::TRANSPORT EQUIPMENT GATE IN REPORT+CDC0001+9'
+DTM+137:202605241430:203'
+TDT+20+251NB+3+31+MSCU:172:20'
+LOC+9+NLRTM:139:6+ECT:TER:ZZZ'
+DTM+178:202605241425:203'
+NAD+CF+MSC:160:20'
+NAD+TR+ECT:160:20'
+NAD+CA+MSCU:172:20'
+EQD+CN+MSCU1234566+45G1:102:5++2+4'
+RFF+BN:BKG778899'
+RFF+BM:MSCUNLRTM0042'
+RFF+EQ:MSCU1234566'
+DTM+178:202605241425:203'
+LOC+9+NLRTM:139:6+ECT:TER:ZZZ'
+LOC+11+USNYC:139:6'
+LOC+165+USNYC:139:6'
+MEA+AAE+AET+KGM:28450'
+MEA+AAL++KGM:3920'
+MEA+VGM++KGM:28450'
+SEL+CN789456+CA'
+SEL+TR556677+TR'
+FTX+AAA+++FULL CONTAINER GATE IN'
+EQA+CH+CHSU0099887'
+STS+1+2'
+DTM+178:202605241430:203'
+CNT+16:1'
+UNT+28+CDC0001'
+UNZ+1+CDC00012345'`;
+/**
+ * A complete SMDG-shape COPRAR Load order: carrier MSC instructs
+ * terminal ECT Rotterdam to load three containers on vessel
+ * MSC MAYA (voyage 251NB) bound for New York. The first container
+ * (MSCU1234566) matches the CODECO sample above so the pair
+ * cross-reconciles cleanly. Container 3 is a frozen reefer.
+ */
+export const SAMPLE_COPRAR = `UNA:+.? '
+UNB+UNOA:2+MSCU:ZZZ+TERMINAL01:ZZZ+260524:1200+CPR00098765'
+UNH+CPR0001+COPRAR:D:00B:UN:SMDG21'
+BGM+45+CPR0001+9'
+DTM+137:202605241200:203'
+RFF+XXX:VOY-251NB-LOAD'
+TDT+20+251NB+1+13+MSCU:172:20+++9876543:146:11::MSC MAYA'
+LOC+9+NLRTM:139:6+ECT:TER:ZZZ'
+DTM+133:202605260800:203'
+LOC+11+USNYC:139:6'
+DTM+132:202606051400:203'
+NAD+CA+MSCU:172:20'
+NAD+CF+MSC:160:20'
+NAD+TR+ECT:160:20'
+EQD+CN+MSCU1234566+45G1:102:5++4+4'
+RFF+BN:BKG778899'
+RFF+BM:MSCUNLRTM0042'
+LOC+9+NLRTM:139:6'
+LOC+11+USNYC:139:6'
+MEA+AAE++KGM:28450'
+MEA+AAL++KGM:3920'
+MEA+VGM++KGM:28450'
+TPL+++147:021082'
+EQD+CN+MSCU2345672+22G1:102:5++4+4'
+RFF+BN:BKG778900'
+RFF+BM:MSCUNLRTM0043'
+LOC+9+NLRTM:139:6'
+LOC+11+USNYC:139:6'
+MEA+AAE++KGM:18200'
+MEA+AAL++KGM:2230'
+MEA+VGM++KGM:18200'
+TPL+++147:019084'
+EQD+CN+MSCU3456789+45R1:102:5++4+4'
+RFF+BN:BKG778901'
+RFF+BM:MSCUNLRTM0044'
+LOC+9+NLRTM:139:6'
+LOC+11+USNYC:139:6'
+TMP+2+-018:CEL'
+RNG+5+CEL:-020:-015'
+MEA+AAE++KGM:27800'
+MEA+AAL++KGM:4500'
+MEA+VGM++KGM:27800'
+EQA+RG+MSCG0001122'
+TPL+++147:023086'
+CNT+16:3'
+CNT+7:5'
+UNT+46+CPR0001'
+UNZ+1+CPR00098765'`;
+//# sourceMappingURL=samples.js.map

package/dist/samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.js","sourceRoot":"","sources":["../src/samples.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gEAAgE;AAChE,EAAE;AACF,4DAA4D;AAC5D,wDAAwD;AACxD,4DAA4D;AAC5D,2DAA2D;AAC3D,+DAA+D;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA8BV,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBA+CV,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,79 @@
+import type { Diagnostic, MessageSchema, MessageType, ParsedMessage, ReconcileReport } from "./types.js";
+/**
+ * Validate an ISO 6346 container number's check digit (11th character).
+ * Letter values skip every multiple of 11.
+ */
+export declare function validateCheckDigit(code: string): boolean;
+export interface SegmentInfo {
+    name: string;
+    brief: string;
+}
+export declare const SEGMENTS: Record<string, SegmentInfo>;
+type CodeList = Record<string, string>;
+export declare const CODE_LISTS: Record<string, CodeList>;
+/**
+ * Decode a 4-character ISO 6346 size-type code into operator-readable
+ * parts: size, type group, height/variant, variant digit.
+ *
+ * Returns `null` if the input doesn't look like a valid size-type code.
+ *
+ * @example
+ * ```ts
+ * decodeISOSizeType("45R1"); // "40ft · Integral reefer · 9ft 6in (high cube) · variant 1"
+ * decodeISOSizeType("22G1"); // "20ft · General purpose · 8ft 6in (standard) · variant 1"
+ * ```
+ */
+export declare function decodeISOSizeType(code: string): string | null;
+export declare const CODECO: MessageSchema;
+export declare const COPRAR: MessageSchema;
+/**
+ * Detect whether the parsed message is CODECO, COPRAR, or unknown.
+ * Inspects UNH.type first, then falls back to BGM document code.
+ */
+export declare function detectMessageType(parsed: ParsedMessage): MessageType;
+/** Look up a code in a named list. Returns null if the list or code is unknown. */
+export declare function lookup(listName: string, code: string): string | null;
+/** Get the segment dictionary entry for a 3-letter tag. */
+export declare function segmentInfo(tag: string): SegmentInfo;
+/**
+ * Run all single-message diagnostic rules against a parsed CODECO
+ * or COPRAR. Returns an array of diagnostics (empty = clean message).
+ *
+ * Rules implemented:
+ *   - BAD_CHECK_DIGIT      · ISO 6346 mod-11 fails on any EQD container number
+ *   - BAD_BIC_FORMAT       · EQD container ID not in 4-letter + 7-digit shape
+ *   - BAD_LOCODE_FORMAT    · LOC place doesn't match 5-char UN/LOCODE pattern
+ *   - DTM_FORMAT           · DTM format not 203 (SMDG mandates 203)
+ *   - MISSING_NAD_CF       · Required container operator party absent
+ *   - EMPTY_BUT_HEAVY      · EQD declared empty but gross weight exceeds tare
+ *   - UNKNOWN_SIZETYPE     · ISO 4-character size-type not in catalogue
+ *   - UNT_COUNT_WRONG      · UNT segment count doesn't match actual UNH→UNT count
+ *   - CNT_EQD_MISMATCH     · CNT+16 declared count != actual EQD count
+ *   - REEFER_WITHOUT_TMP   · R-type ISO size but no TMP segment
+ *   - LOAD_BUT_EMPTY       · COPRAR Load (BGM 45) but EQD declares empty
+ *   - MISSING_VGM          · Full container on Load order missing SOLAS VGM
+ *   - CHARSET_LOWERCASE    · UNB declares UNOA but body contains lowercase
+ */
+export declare function diagnoseSingle(parsed: ParsedMessage): Diagnostic[];
+/**
+ * Cross-message reconciliation between a COPRAR and its matching CODECO.
+ * Returns container-by-container matches with field-level diffs and
+ * unmatched-container lists.
+ *
+ * Tolerances:
+ *   - Gross weight: ±2%
+ *   - VGM: ±5%
+ *   - Reefer temperature: ±1°C
+ *
+ * @example
+ * ```ts
+ * import { parse, reconcile } from "@prefixcheck/edi";
+ * const coprar = parse(coprarText);
+ * const codeco = parse(codecoText);
+ * const report = reconcile(coprar, codeco);
+ * console.log(`${report.matched.length} matched, ${report.inCoprarOnly.length} expected but not gated`);
+ * ```
+ */
+export declare function reconcile(coprar: ParsedMessage, codeco: ParsedMessage): ReconcileReport;
+export {};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,UAAU,EAEV,aAAa,EACb,WAAW,EACX,aAAa,EAEb,eAAe,EAEhB,MAAM,YAAY,CAAC;AAgCpB;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASxD;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAmHhD,CAAC;AAGF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAoP/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuC7D;AAGD,eAAO,MAAM,MAAM,EAAE,aASpB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,aASpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAapE;AAED,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAIpD;AAGD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,EAAE,CAqPlE;AAqED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,eAAe,CAwFvF"}