Raw GUID Converter

1.0.204 verified Sat Apr 25 auth: no javascript maintenance

Utility library and CLI tool for converting between Oracle RAW(16) format and standard formatted GUID strings. Version 1.0.204 is current, last updated in 2020 with low release cadence. Accepts 32-character hex strings (no dashes) and converts them to standard 36-character GUID format, and vice versa. Supports bulk conversion via CLI. Lightweight, zero dependencies, and available as both a Node.js library and global CLI command. Key differentiator: handles Oracle RAW-format GUIDs specifically, including endianness handling per Oracle conventions.

Common errors

error TypeError: convert is not a function ↓

cause Using default import when package has no default export.

fix

Use named imports: const { convertRaw } = require('raw-guid-converter');

error Error: GUID must be 32 hex characters ↓

cause Passing a standard formatted GUID to convertRaw instead of convertString.

fix

Use convertString for formatted GUIDs; convertRaw expects raw 32-char hex.

error bash: convert-guid: command not found ↓

cause CLI not installed globally or npx not used.

fix

Run 'npm install -g raw-guid-converter' or prefix with 'npx raw-guid-converter'.

Warnings

gotcha Input to convertRaw must be exactly 32 hex characters; 36-char GUIDs produce wrong output silently. ↓

fix Strip dashes and braces before passing; e.g., raw.replace(/[\-{}]/g, '').

gotcha Output from convertString is uppercase; Oracle stores uppercase but this may not match case expectations. ↓

fix Use .toLowerCase() on result if lowercase GUID required.

deprecated CLI subcommands 'fromRaw' and 'fromString' are case-sensitive; lower-case 'fromraw' fails. ↓

fix Use exact camelCase: fromRaw, fromString.

Install

npm install raw-guid-converter

yarn add raw-guid-converter

pnpm add raw-guid-converter

Imports

convertRaw

wrong

const convertRaw = require('raw-guid-converter').convertRaw

correct

import { convertRaw } from 'raw-guid-converter'

Package provides CommonJS and ES modules via dual packaging; import syntax works for ESM.

convertString
wrong
```
const convert = require('raw-guid-converter')
```
correct
```
import { convertString } from 'raw-guid-converter'
```
Require works but must destructure .convertString; default export not available.

default

wrong

const rgc = require('raw-guid-converter'); rgc()

correct

import rgc from 'raw-guid-converter'; rgc.convertRaw(...)

No default export; use named imports or namespace import.

convert-guid CLI
wrong
```
raw-guid-converter fromRaw ...
```
correct
```
npx raw-guid-converter fromRaw 4630880E6D0B3640AB446C6FB3C44FE3
```
Global install required for bare command; npx works without install.

Quickstart

Converts a 32-character Oracle RAW GUID to standard format and back using named functions.

const { convertRaw, convertString } = require('raw-guid-converter');
const raw = '4630880E6D0B3640AB446C6FB3C44FE3';
const formatted = convertRaw(raw);
console.log(formatted); // 0e883046-0b6d-4036-ab44-6c6fb3c44fe3
const back = convertString(formatted);
console.log(back); // 4630880E6D0B3640AB446C6FB3C44FE3