id

var (
	// UnknownScheme is returned when no Generator is registered under the
	// requested Scheme — typically a missing blank-import of the scheme.
	UnknownScheme = errs.Static(CodeUnknownScheme, "UNKNOWN_SCHEME",
		"No identifier generator is registered under that scheme",
		"core/app/id.New: scheme absent from registry; blank-import the scheme's package to register it",
		0,
		0)

	// DuplicateRegistration is the boot-time panic sentinel for the Generator
	// registry: a nil generator or a distinct generator claiming a taken Scheme.
	DuplicateRegistration = errs.Static(CodeDuplicateRegistration, "DUPLICATE_REGISTRATION",
		"A generator is already registered under that scheme",
		"core/app/id.Register: a distinct generator already claims this scheme, or a nil generator was supplied",
		0,
		0)

	// EntropyFailed was the wrap of a crypto/rand.Read failure while drawing id
	// bytes. Nothing returns it since Go 1.24, whose crypto/rand.Read never
	// fails (a failing source crashes the program); it stays published with its
	// value, so a consumer matching it keeps compiling.
	EntropyFailed = errs.Static(CodeIDEntropyFailed, "ID_ENTROPY_FAILED",
		"Identifier generation failed to read secure random bytes",
		"service/app/id: crypto/rand.Read returned an error",
		0,
		0)

	// ClockBackwards is returned when the snowflake clock regressed past the
	// recoverable sequence window.
	ClockBackwards = errs.Static(CodeIDClockBackwards, "ID_CLOCK_BACKWARDS",
		"Identifier generation observed the clock moving backwards",
		"service/app/id: snowflake clock regressed beyond the same-millisecond sequence space",
		0,
		0)

	// ClockStalled is returned when the snowflake same-millisecond overflow wait
	// gave up because the clock stopped advancing.
	ClockStalled = errs.Static(CodeIDClockStalled, "ID_CLOCK_STALLED",
		"Identifier generation gave up waiting for the clock to advance",
		"service/app/id: snowflake overflow wait exceeded its spin budget without the clock ticking",
		0,
		0)

	// InvalidSize is returned by NewNanoID when the requested identifier length
	// is not positive. Carries a "size" field.
	InvalidSize = errs.Static(CodeIDInvalidSize, "ID_INVALID_SIZE",
		"Identifier generation requires a positive identifier length",
		"service/app/id: NewNanoID received a size <= 0; a zero-length identifier identifies nothing",
		0,
		0)

	// InvalidPrefix is returned by NewTypeID/FormatTypeID/ParseTypeID when the
	// type prefix is empty or breaks the lowercase-ASCII shape. Carries a "rule"
	// field naming the clause that failed, and never echoes the prefix.
	InvalidPrefix = errs.Static(CodeIDInvalidPrefix, "ID_INVALID_PREFIX",
		"Identifier generation requires a valid lowercase type prefix",
		"service/app/id: a TypeID prefix is 1..63 chars of [a-z], with '_' allowed only between two letters",
		0,
		0)

	// Malformed is returned by ParseKSUID/ParseTypeID/FormatTypeID when the
	// input is not a well-formed rendering. Carries a "rule" field naming which
	// check fired (length / alphabet / overflow), never the input itself.
	Malformed = errs.Static(CodeIDMalformed, "ID_MALFORMED",
		"The identifier is not well formed for its scheme",
		"service/app/id: a parse rejected the input's length, alphabet, or magnitude",
		0,
		0)

	// TimestampRange is returned when the clock sits outside the window a
	// scheme's timestamp field can represent (KSUID: 2014-05-13 .. 2150-06-19).
	TimestampRange = errs.Static(CodeIDTimestampRange, "ID_TIMESTAMP_RANGE",
		"Identifier generation observed a clock outside the scheme's timestamp range",
		"service/app/id: the KSUID 32-bit second counter cannot represent this clock reading",
		0,
		0)
)