Validates, asserts, and generates UUIDs behind a branded UUID type in TypeScript.
npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-uuid-sergiodxa
Please help me install this Agent Skill. Skill: sdxc-uuid Source: https://github.com/sergiodxa/monorepo/tree/main/.agents/skills/sdxc-uuid Command: npx skills add https://github.com/sergiodxa/monorepo --skill sdxc-uuid-sergiodxa
isUUID narrows a string to UUID for branching, while assertUUID throws on invalid input for boundary checks. - Typed generation: generateUUID wraps crypto.randomUUID() and returns a typed UUID without a cast. - Distinct error classes: InvalidUUIDTypeError, InvalidUUIDLengthError, and InvalidUUIDFormatError distinguish wrong types, truncated values, and malformed shapes. - Use Case: A Remix route receives an account ID as a path segment; call assertUUID at the boundary, then type every function below as accepting UUID so no layer re-validates. ## Quick Start Add @sdxc/uuid as a workspace dependency and use isUUID or assertUUID to validate an incoming string identifier at the request boundary.High-intent search queries and answers about installing and using this skill.
Use isUUID from @sdxc/uuid to check a string and narrow its type to UUID in the true branch. For boundaries where invalid input should stop the request, call assertUUID, which throws a typed error instead of returning a boolean.
Call generateUUID from @sdxc/uuid, which wraps crypto.randomUUID() and returns the branded UUID type directly. This avoids writing an unsafe cast from string to your identifier type.
Yes, the package has no dependencies and runs on any runtime that provides crypto.randomUUID(), which includes Cloudflare Workers, Bun, and modern Node.js. No platform-specific setup is required.
Only lowercase 8-4-4-4-12 hexadecimal passes the format check, so uppercase and brace-wrapped forms fail. This ensures stored and compared identifiers have exactly one spelling, preventing mismatches from equivalent representations.
isUUID returns a boolean and narrows the type, suiting values a person can get wrong like form fields. assertUUID throws InvalidUUIDTypeError, InvalidUUIDLengthError, or InvalidUUIDFormatError, suiting boundaries where invalid input should halt processing.
EmmanuelkwaaAdd a custom route constraint to .NET Web API for validating string path parameters.
langware-labsNavigate Flowpad UI to specific entities by TypeId.
Luqman-Ud-DinDetects web form validation defects including boundary values, cross-field rules, and error accessibility issues.
jeremybrasherApplies TypeScript typing rules and code review practices when reading or editing .ts and .tsx files.