Registry / serialization / raw-guid-converter

raw-guid-converter

library1.0.204jsnpmunverified

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.

serialization database

npm install raw-guid-converter

github ↗package ↗

INSTALL

IMPORT

SIG · RAW-GUID-CONVERTER

raw-guid-converter

serializationjavascriptv1.0.204

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

convertRaw

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

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

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

convertString

✓ import { convertString } from 'raw-guid-converter'

✗ const convert = require('raw-guid-converter')

Require works but must destructure .convertString; default export not available.

default

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

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

No default export; use named imports or namespace import.

convert-guid CLI

✓ npx raw-guid-converter fromRaw 4630880E6D0B3640AB446C6FB3C44FE3

✗ raw-guid-converter fromRaw ...

Global install required for bare command; npx works without install.

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

raw-guid-converter --version

Debug

Known issues

gotchaInput 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, '').

affects: >=0.0.0

gotchaOutput from convertString is uppercase; Oracle stores uppercase but this may not match case expectations.

fix

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

affects: >=0.0.0

deprecatedCLI subcommands 'fromRaw' and 'fromString' are case-sensitive; lower-case 'fromraw' fails.

fix

Use exact camelCase: fromRaw, fromString.

affects: >=0.0.0

Errors

Common errors & fixes

TypeError: convert is not a function

Using default import when package has no default export.

fix

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

Error: GUID must be 32 hex characters

Passing a standard formatted GUID to convertRaw instead of convertString.

fix

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

bash: convert-guid: command not found

CLI not installed globally or npx not used.

fix

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

Upgrade

Version history

1.0.204latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

11 hits · last 30 days

node

Resources

githubhttps://github.com/kanekotic/raw-guid-converter ↗

packagehttps://www.npmjs.com/package/raw-guid-converter ↗