{"id":20487,"library":"raw-guid-converter","title":"Raw GUID Converter","description":"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.","status":"maintenance","version":"1.0.204","language":"javascript","source_language":"en","source_url":"ssh://git@github.com/kanekotic/raw-guid-converter","tags":["javascript","command line","tool","guid","oracle"],"install":[{"cmd":"npm install raw-guid-converter","lang":"bash","label":"npm"},{"cmd":"yarn add raw-guid-converter","lang":"bash","label":"yarn"},{"cmd":"pnpm add raw-guid-converter","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package provides CommonJS and ES modules via dual packaging; import syntax works for ESM.","wrong":"const convertRaw = require('raw-guid-converter').convertRaw","symbol":"convertRaw","correct":"import { convertRaw } from 'raw-guid-converter'"},{"note":"Require works but must destructure .convertString; default export not available.","wrong":"const convert = require('raw-guid-converter')","symbol":"convertString","correct":"import { convertString } from 'raw-guid-converter'"},{"note":"No default export; use named imports or namespace import.","wrong":"const rgc = require('raw-guid-converter'); rgc()","symbol":"default","correct":"import rgc from 'raw-guid-converter'; rgc.convertRaw(...)"},{"note":"Global install required for bare command; npx works without install.","wrong":"raw-guid-converter fromRaw ...","symbol":"convert-guid CLI","correct":"npx raw-guid-converter fromRaw 4630880E6D0B3640AB446C6FB3C44FE3"}],"quickstart":{"code":"const { convertRaw, convertString } = require('raw-guid-converter');\nconst raw = '4630880E6D0B3640AB446C6FB3C44FE3';\nconst formatted = convertRaw(raw);\nconsole.log(formatted); // 0e883046-0b6d-4036-ab44-6c6fb3c44fe3\nconst back = convertString(formatted);\nconsole.log(back); // 4630880E6D0B3640AB446C6FB3C44FE3","lang":"javascript","description":"Converts a 32-character Oracle RAW GUID to standard format and back using named functions."},"warnings":[{"fix":"Strip dashes and braces before passing; e.g., raw.replace(/[\\-{}]/g, '').","message":"Input to convertRaw must be exactly 32 hex characters; 36-char GUIDs produce wrong output silently.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use .toLowerCase() on result if lowercase GUID required.","message":"Output from convertString is uppercase; Oracle stores uppercase but this may not match case expectations.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Use exact camelCase: fromRaw, fromString.","message":"CLI subcommands 'fromRaw' and 'fromString' are case-sensitive; lower-case 'fromraw' fails.","severity":"deprecated","affected_versions":">=0.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Use named imports: const { convertRaw } = require('raw-guid-converter');","cause":"Using default import when package has no default export.","error":"TypeError: convert is not a function"},{"fix":"Use convertString for formatted GUIDs; convertRaw expects raw 32-char hex.","cause":"Passing a standard formatted GUID to convertRaw instead of convertString.","error":"Error: GUID must be 32 hex characters"},{"fix":"Run 'npm install -g raw-guid-converter' or prefix with 'npx raw-guid-converter'.","cause":"CLI not installed globally or npx not used.","error":"bash: convert-guid: command not found"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}