Rip X12 - @rip-lang/x12

X12 EDI parser, editor, and query engine

Parse, query, and edit X12 EDI transactions (270/271, 835, 837, etc.) with a path-based addressing system. Auto-detects field, repetition, component, and segment separators from the ISA header.

Quick Start

# Install
bun add -g @rip-lang/x12

# Show fields
rip-x12 -f message.x12

# Query specific values
rip-x12 -q "ISA-6,GS-2" message.x12

# Show message body
rip-x12 -m message.x12

# Recursive directory scan
rip-x12 -d -f /path/to/edi/

Library Usage

import { X12 } from '@rip-lang/x12'

# Parse an X12 message
x12 = new X12 rawString

# Get values using path addressing
sender   = x12.get "ISA-6"        # ISA segment, field 6
receiver = x12.get "ISA-8"        # ISA segment, field 8
code     = x12.get "EB-1"         # First EB segment, field 1
third    = x12.get "EB(3)-4"      # 3rd EB segment, field 4
comp     = x12.get "EB(3)-4(2).1" # 3rd EB, field 4, repeat 2, component 1
count    = x12.get "EB(?)"        # Count of EB segments

# Set values
x12.set "ISA-6", "NEWSENDER"
x12.set "GS-2", "NEWID"

# Query multiple values at once
[sender, receiver] = x12.find "ISA-6", "ISA-8"

# Display formatted output
x12.show 'down', 'full'   # lowercase segments, show body

# Iterate segments
x12.each (row) -> console.log row[0]
x12.each 'EB', (row) -> console.log row

# Get raw X12 string
output = x12.raw()

Path Addressing

seg(num)-fld(rep).com

seg      — Segment name (2-3 chars): ISA, GS, EB, CLP, etc.
(num)    — Segment occurrence: (1)=first, (3)=third, (?)=count, (*)=all, (+)=new
-fld     — Field number (1-based)
(rep)    — Repetition within field: (1)=first, (?)=count, (*)=all, (+)=new
.com     — Component within repeat (1-based)

Examples

Separators

X12 uses four delimiter levels, auto-detected from the ISA header:

CLI Options

Links

• Rip Language
• X12 Standard