(new): expand runtime APIs

(fix): harden concurrent lifecycle
(tests): add regression coverage
(doc): update v1.2 guidance

drafts.go

@@ -45,10 +45,8 @@ type DraftProvider struct {
 	generator draftIDGenerator
 }
 
-// NewRandomDraftProvider creates a new DraftProvider using random draft IDs.
-//
-// The provider will use random numbers for draft IDs.
-// All drafts created via this provider will have unpredictable, unique IDs.
+// NewRandomDraftProvider creates a DraftProvider using non-cryptographic random IDs.
+// Zero values and collisions with active drafts are retried.
 func NewRandomDraftProvider(api *tgapi.API) *DraftProvider {
 	return &DraftProvider{
 		api: api, generator: &RandomDraftIDGenerator{},