Support configurable Crypto UUID output formats

[tim-smart]

Summary

Convert randomUUIDv4 and randomUUIDv7 to functions with optional { format?: "hex" | "bytes" } options. The default and "hex" return lowercase, hyphenated UUID strings; "bytes" returns 16 UUID bytes. Literal formats infer precise result types, while union formats return string | Uint8Array. The PlatformError channel and ULID API are unchanged.

Reuse the existing UUID byte helpers, migrate existing call sites and the JSDoc example, and add a changeset. This includes the contract tests from the earlier tests-only commit; this implementation run adds no new tests.

Validation

All commands ran under nix develop -c.

• Targeted Crypto, TestCrypto, NodeCrypto and BrowserCrypto suites: 32 tests passed.
• DenoCrypto suite under Deno: 4 tests passed.
• Crypto type tests: passed on TypeScript 5.9.3 and 6.0.3.
• pnpm check, pnpm lint-fix, pnpm lint, and pnpm jsdocs --check: passed.
• Crypto JSDoc examples: 3 tests passed.
• git diff --check: passed.

Closes EFF-1871

[changeset-bot]

🦋 Changeset detected

Latest commit: c952138

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 32 packages

Name	Type
effect	Patch
@effect/opentelemetry	Patch
@effect/vitest	Patch
@effect/ai-anthropic	Patch
@effect/ai-cloudflare	Patch
@effect/ai-openai-compat	Patch
@effect/ai-openai	Patch
@effect/ai-openrouter	Patch
@effect/ai-typesafe	Patch
@effect/atom-react	Patch
@effect/atom-solid	Patch
@effect/atom-vue	Patch
@effect/platform-browser	Patch
@effect/platform-bun	Patch
@effect/platform-deno	Patch
@effect/platform-node-shared	Patch
@effect/platform-node	Patch
@effect/sql-clickhouse	Patch
@effect/sql-d1	Patch
@effect/sql-libsql	Patch
@effect/sql-mssql	Patch
@effect/sql-mysql2	Patch
@effect/sql-pg	Patch
@effect/sql-pglite	Patch
@effect/sql-sqlite-bun	Patch
@effect/sql-sqlite-do	Patch
@effect/sql-sqlite-node	Patch
@effect/sql-sqlite-react-native	Patch
@effect/sql-sqlite-wasm	Patch
@effect/docgen	Patch
@effect/doctest	Patch
@effect/openapi-generator	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Bundle Size Analysis

Generated from PR build output; treat the content below as untrusted.

File Name	Current Size	Previous Size	Difference
arbitrary-combinators.ts	38.79 KB	38.79 KB	0.00 KB (0.00%)
basic.ts	7.06 KB	7.06 KB	0.00 KB (0.00%)
batching.ts	10.14 KB	10.14 KB	0.00 KB (0.00%)
brand.ts	6.73 KB	6.73 KB	0.00 KB (0.00%)
cache.ts	10.90 KB	10.90 KB	0.00 KB (0.00%)
config.ts	22.27 KB	22.27 KB	0.00 KB (0.00%)
differ.ts	21.34 KB	21.34 KB	0.00 KB (0.00%)
http-client.ts	22.68 KB	22.68 KB	0.00 KB (0.00%)
http-router.ts	34.11 KB	34.11 KB	0.00 KB (0.00%)
logger.ts	11.23 KB	11.23 KB	0.00 KB (0.00%)
metric.ts	9.03 KB	9.03 KB	0.00 KB (0.00%)
optic.ts	6.96 KB	6.96 KB	0.00 KB (0.00%)
pubsub.ts	15.19 KB	15.19 KB	0.00 KB (0.00%)
queue.ts	12.14 KB	12.14 KB	0.00 KB (0.00%)
schedule.ts	11.23 KB	11.23 KB	0.00 KB (0.00%)
schema-bigdecimal.ts	13.76 KB	13.76 KB	0.00 KB (0.00%)
schema-binary.ts	40.00 KB	40.00 KB	0.00 KB (0.00%)
schema-class.ts	21.09 KB	21.09 KB	0.00 KB (0.00%)
schema-fromJsonSchemaDocument.ts	32.10 KB	32.10 KB	0.00 KB (0.00%)
schema-representation-roundtrip.ts	27.31 KB	27.31 KB	0.00 KB (0.00%)
schema-string-transformation.ts	14.51 KB	14.51 KB	0.00 KB (0.00%)
schema-string.ts	12.02 KB	12.02 KB	0.00 KB (0.00%)
schema-template-literal.ts	16.09 KB	16.09 KB	0.00 KB (0.00%)
schema-toArbitrary.ts	38.32 KB	38.32 KB	0.00 KB (0.00%)
schema-toCodeDocument.ts	25.30 KB	25.30 KB	0.00 KB (0.00%)
schema-toCodecJson.ts	20.26 KB	20.26 KB	0.00 KB (0.00%)
schema-toEquivalence.ts	20.45 KB	20.45 KB	0.00 KB (0.00%)
schema-toFormatter.ts	20.57 KB	20.57 KB	0.00 KB (0.00%)
schema-toJsonSchemaDocument.ts	25.03 KB	25.03 KB	0.00 KB (0.00%)
schema-toRepresentation.ts	20.55 KB	20.55 KB	0.00 KB (0.00%)
schema.ts	20.31 KB	20.31 KB	0.00 KB (0.00%)
stm.ts	13.26 KB	13.26 KB	0.00 KB (0.00%)
stream.ts	9.99 KB	9.99 KB	0.00 KB (0.00%)