@hce/decode

HCE (Hierarchical Columnar Encoding) decoder for converting HCE back to JSON.

Installation

npm install @hce/decode
# or
pnpm add @hce/decode

Usage

import { HCEDecoder } from '@hce/decode';

const hceContent = `users(user)[2]:
  user(id,name,role)[2]:
    1,Alice,admin|2,Bob,user`;

const decoder = new HCEDecoder({
  fieldDelimiter: ',',
  recordDelimiter: '|',
  typeField: 'type'
});

const data = decoder.decode(hceContent);
console.log(JSON.stringify(data, null, 2));

Options

• fieldDelimiter - Delimiter between fields (default: ',')
• recordDelimiter - Delimiter between records (default: '|')
• nestedDelimiter - Delimiter for nested arrays (default: ';')
• missingValue - Placeholder for missing/null values (default: ' ')
• typeField - Name of the type field (default: 'type')
• indent - Expected indentation size in spaces (default: 2)

Features

• Fast and accurate HCE to JSON conversion
• Support for nested objects and arrays
• Handles missing/null values
• Type-safe TypeScript implementation
• Automatic type detection

License

MIT