cofeid

Generate CofeIDs: real UUIDv4 values whose first segment is fixed to C0FFEE1D.

What it is

A CofeID is a standards-compliant UUIDv4 string with one deliberate constraint:

• the first 8 hex characters are always C0FFEE1D
• the version nibble is still 4
• the variant nibble is still 8, 9, a, or b

Example:

C0FFEE1D-1234-4abc-8def-1234567890ab

Why this is useful

• Memorable, branded identifier format for logs, demos, test fixtures, and internal tooling.
• Preserves the familiar UUID shape while making the output instantly recognizable.
• Tiny, dependency-free, and safe to ship as a CLI or library.
• Easy to spot in logs, tickets, dashboards, and payloads.
• Still a real UUIDv4, so it fits systems that expect standard UUID format.

Install

npm i -g cofeid

Use

Generate a fresh CofeID:

cofeid

Validate or echo a provided CofeID:

cofeid C0FFEE1D-0000-4000-8000-000000000000

Help:

cofeid --help

Env presets

You can generate predefined CofeIDs using environment-style flags:

cofeid --e1 cofeid --e3

Examples:

C0FFEE1D-E100-4000-8000-000000000000 C0FFEE1D-E300-4000-8000-000000000000

Supports --e1 through --e6.

Library API

const { COFEID_PREFIX, UUID_V4_REGEX, COFEID_UUID_REGEX, generateUuidV4, generateUuidV4WithCofeidPrefix, normalizeUuid, isCofeid, } = require('cofeid');

File layout

• bin/cofeid — executable CLI
• src/cofeid.js — core logic
• index.js — package entrypoint
• test/cofeid.test.js — unit tests

Notes

This is a real UUIDv4 with a fixed first segment. It is not a random UUIDv4 in the strict sense because the first 32 bits are intentionally constant.