kafka-client-engine 0.0.1

Execution and driver-integration layer for the native Kafka client
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
//! Shared admin completion capacity and typed publication scenarios.

use std::{
    future::Future,
    pin::Pin,
    sync::{Arc, Condvar, Mutex},
    task::{Context, Poll, Wake, Waker},
    thread::ThreadId,
};

use kafka_client_core::{
    AbortPartitionTransactionTerminal, AddRaftVoterSuccess, AddRaftVoterTerminal,
    AdminDescribeConsumerGroupsBatch, AdminDescribeConsumerGroupsTerminal,
    AdminDescribeProducersBatch, AdminDescribeProducersTerminal, AdminDescribeTransactionsBatch,
    AdminDescribeTransactionsTerminal, AdminFenceProducersBatch, AdminFenceProducersTerminal,
    AdminListConsumerGroupsBatch, AdminListConsumerGroupsTerminal, AdminListOffsetsBatch,
    AdminListOffsetsTerminal, AlterConsumerGroupOffsetsBatch, AlterConsumerGroupOffsetsTerminal,
    AlterPartitionReassignmentsBatch, AlterPartitionReassignmentsTerminal,
    AlterUserScramCredentialsBatch, AlterUserScramCredentialsTerminal, ClusterDescription,
    CreateDelegationTokenBrokerError, CreateDelegationTokenTerminal, CreatePartitionsTerminal,
    CreateTopicsTerminal, DeleteConsumerGroupOffsetsBatch, DeleteConsumerGroupOffsetsTerminal,
    DeleteConsumerGroupsBatch, DeleteConsumerGroupsTerminal, DeleteRecordsBatch,
    DeleteRecordsTerminal, DeleteShareGroupOffsetsBatch, DeleteShareGroupOffsetsTerminal,
    DeleteTopicsTerminal, DescribeClusterTerminal, DescribeConfigsBatch, DescribeConfigsTerminal,
    DescribeFeaturesBrokerError, DescribeFeaturesTerminal, DescribeMetadataQuorumBrokerError,
    DescribeMetadataQuorumTerminal, DescribeStreamsGroupBrokerError, DescribeStreamsGroupTerminal,
    DescribeTopicsTerminal, ElectLeadersBatch, ElectLeadersTerminal,
    ExpireDelegationTokenBrokerError, ExpireDelegationTokenTerminal, IncrementalAlterConfigsBatch,
    IncrementalAlterConfigsTerminal, LegacyAlterConfigsBatch, LegacyAlterConfigsTerminal,
    ListConsumerGroupOffsetsBatch, ListConsumerGroupOffsetsTerminal,
    ListPartitionReassignmentsBatch, ListPartitionReassignmentsTerminal,
    RemoveConsumerGroupMembersBatch, RemoveConsumerGroupMembersTerminal, RemoveRaftVoterSuccess,
    RemoveRaftVoterTerminal, RenewDelegationTokenBrokerError, RenewDelegationTokenTerminal,
};

use crate::completion::{CompletionRegistry, ReclaimStatus};

use super::{
    ABORT_PARTITION_TRANSACTION_CAPACITY, ADD_RAFT_VOTER_CAPACITY,
    ADMIN_DESCRIBE_PRODUCERS_CAPACITY, ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY,
    ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY, ADMIN_FENCE_PRODUCERS_CAPACITY,
    ADMIN_LIST_OFFSETS_CAPACITY, ADMIN_LIST_TRANSACTIONS_CAPACITY, ALTER_CLIENT_QUOTAS_CAPACITY,
    ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY, ALTER_PARTITION_REASSIGNMENTS_CAPACITY,
    ALTER_REPLICA_LOG_DIRS_CAPACITY, ALTER_USER_SCRAM_CREDENTIALS_CAPACITY, CREATE_ACLS_CAPACITY,
    CREATE_DELEGATION_TOKEN_CAPACITY, CREATE_PARTITIONS_CAPACITY, CREATE_TOPICS_CAPACITY,
    DELETE_ACLS_CAPACITY, DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY, DELETE_CONSUMER_GROUPS_CAPACITY,
    DELETE_RECORDS_CAPACITY, DELETE_TOPICS_CAPACITY, DESCRIBE_ACLS_CAPACITY,
    DESCRIBE_CLIENT_QUOTAS_CAPACITY, DESCRIBE_CLUSTER_CAPACITY, DESCRIBE_CONFIGS_CAPACITY,
    DESCRIBE_CONSUMER_GROUPS_CAPACITY, DESCRIBE_DELEGATION_TOKENS_CAPACITY,
    DESCRIBE_FEATURES_CAPACITY, DESCRIBE_LOG_DIRS_CAPACITY, DESCRIBE_METADATA_QUORUM_CAPACITY,
    DESCRIBE_REPLICA_LOG_DIRS_CAPACITY, DESCRIBE_TOPICS_CAPACITY,
    DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY, ELECT_LEADERS_CAPACITY,
    EXPIRE_DELEGATION_TOKEN_CAPACITY, INCREMENTAL_ALTER_CONFIGS_CAPACITY,
    LIST_CONSUMER_GROUP_OFFSETS_CAPACITY, LIST_CONSUMER_GROUPS_CAPACITY,
    LIST_PARTITION_REASSIGNMENTS_CAPACITY, REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY,
    REMOVE_RAFT_VOTER_CAPACITY, RENEW_DELEGATION_TOKEN_CAPACITY,
    alter_share_group_offsets::ALTER_SHARE_GROUP_OFFSETS_CAPACITY,
    completion::AdminCompletionNotifier,
    delete_share_group_offsets::DELETE_SHARE_GROUP_OFFSETS_CAPACITY,
    describe_share_group::DESCRIBE_SHARE_GROUP_CAPACITY,
    describe_streams_group::DESCRIBE_STREAMS_GROUP_CAPACITY,
    legacy_alter_configs::LEGACY_ALTER_CONFIGS_CAPACITY,
    list_client_metrics_resources::internal_api::LIST_CLIENT_METRICS_RESOURCES_CAPACITY,
    list_config_resources::LIST_CONFIG_RESOURCES_CAPACITY,
    list_share_group_offsets::LIST_SHARE_GROUP_OFFSETS_CAPACITY, test_support::completion_owner,
    unregister_broker::UNREGISTER_BROKER_CAPACITY, update_features::UPDATE_FEATURES_CAPACITY,
};

macro_rules! exercise_terminals {
    ($worker:expr; $($publisher:expr => $terminal:expr),+ $(,)?) => {
        $(exercise_terminal($publisher, $terminal, $worker);)+
    };
}

#[test]
#[expect(
    clippy::too_many_lines,
    reason = "one exhaustive fixture proves every concrete admin terminal uses the shared off-reactor worker"
)]
fn one_worker_publishes_every_concrete_admin_terminal_off_reactor() {
    let reactor = std::thread::current().id();
    let (mut notifier, ports) = completion_owner();
    let worker = notifier
        .thread_id()
        .unwrap_or_else(|| panic!("shared admin notifier must own one worker"));
    assert_ne!(worker, reactor);

    exercise_terminals! {
        worker;
        ports.abort_partition_transaction => AbortPartitionTransactionTerminal::Aborted,
        ports.add_raft_voter => AddRaftVoterTerminal::Added(AddRaftVoterSuccess::new(0)),
        ports.remove_raft_voter => RemoveRaftVoterTerminal::Removed(RemoveRaftVoterSuccess::new(0)),
        ports.create_topics => CreateTopicsTerminal::Topics(Vec::new()),
        ports.create_delegation_token => CreateDelegationTokenTerminal::BrokerRejected(
            CreateDelegationTokenBrokerError::new(0, core::num::NonZeroI16::MIN)
        ),
        ports.renew_delegation_token => RenewDelegationTokenTerminal::BrokerRejected(
            RenewDelegationTokenBrokerError::new(0, core::num::NonZeroI16::MIN)
        ),
        ports.expire_delegation_token => ExpireDelegationTokenTerminal::BrokerRejected(
            ExpireDelegationTokenBrokerError::new(0, core::num::NonZeroI16::MIN)
        ),
        ports.delete_topics => DeleteTopicsTerminal::Topics(Vec::new()),
        ports.describe_cluster => DescribeClusterTerminal::Cluster(ClusterDescription::new(
            String::from("cluster"),
            None,
            Vec::new(),
        )),
        ports.create_partitions => CreatePartitionsTerminal::Topics(Vec::new()),
        ports.describe_topics => DescribeTopicsTerminal::Topics(Vec::new()),
        ports.describe_configs => DescribeConfigsTerminal::Configs(
            DescribeConfigsBatch::new(0, Vec::new())
        ),
        ports.incremental_alter_configs => IncrementalAlterConfigsTerminal::Configs(
            IncrementalAlterConfigsBatch::new(0, Vec::new())
        ),
        ports.legacy_alter_configs => LegacyAlterConfigsTerminal::Configs(
            LegacyAlterConfigsBatch::new(0, Vec::new())
        ),
        ports.list_consumer_group_offsets => ListConsumerGroupOffsetsTerminal::Offsets(
            ListConsumerGroupOffsetsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.delete_consumer_group_offsets => DeleteConsumerGroupOffsetsTerminal::Deleted(
            DeleteConsumerGroupOffsetsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.delete_consumer_groups => DeleteConsumerGroupsTerminal::Deleted(
            DeleteConsumerGroupsBatch::new(0, Vec::new())
        ),
        ports.alter_consumer_group_offsets => AlterConsumerGroupOffsetsTerminal::Altered(
            AlterConsumerGroupOffsetsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.admin_list_offsets => AdminListOffsetsTerminal::Listed(
            AdminListOffsetsBatch::new(0, Vec::new())
        ),
        ports.list_partition_reassignments => ListPartitionReassignmentsTerminal::Reassignments(
            ListPartitionReassignmentsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.alter_partition_reassignments => AlterPartitionReassignmentsTerminal::Altered(
            AlterPartitionReassignmentsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.elect_leaders => ElectLeadersTerminal::Elected(
            ElectLeadersBatch::new(0, Vec::new())
        ),
        ports.delete_records => DeleteRecordsTerminal::Deleted(
            DeleteRecordsBatch::new(0, Vec::new())
        ),
        ports.delete_share_group_offsets => DeleteShareGroupOffsetsTerminal::Deleted(
            DeleteShareGroupOffsetsBatch::new(0, Vec::new())
        ),
        ports.describe_streams_group => DescribeStreamsGroupTerminal::BrokerRejected(
            DescribeStreamsGroupBrokerError::new(
                0,
                core::num::NonZeroI16::MIN,
                None,
                false,
            )
        ),
        ports.describe_consumer_groups => AdminDescribeConsumerGroupsTerminal::Described(
            AdminDescribeConsumerGroupsBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.describe_features => DescribeFeaturesTerminal::BrokerRejected(
            DescribeFeaturesBrokerError::new(0, core::num::NonZeroI16::MIN)
        ),
        ports.list_consumer_groups => AdminListConsumerGroupsTerminal::Listed(
            AdminListConsumerGroupsBatch::new(
                0,
                Vec::new(),
                Vec::new(),
            )
        ),
        ports.remove_consumer_group_members => RemoveConsumerGroupMembersTerminal::Removed(
            RemoveConsumerGroupMembersBatch::new(
                0,
                Vec::new(),
            )
        ),
        ports.alter_user_scram_credentials => AlterUserScramCredentialsTerminal::Altered(
            AlterUserScramCredentialsBatch::new(0, Vec::new())
        ),
        ports.describe_metadata_quorum => DescribeMetadataQuorumTerminal::BrokerRejected(
            DescribeMetadataQuorumBrokerError::new(
                core::num::NonZeroI16::MIN,
                None,
                false,
            )
        ),
        ports.describe_producers => AdminDescribeProducersTerminal::Described(
            AdminDescribeProducersBatch::new(0, Vec::new())
        ),
        ports.describe_transactions => AdminDescribeTransactionsTerminal::Described(
            AdminDescribeTransactionsBatch::new(0, Vec::new())
        ),
        ports.fence_producers => AdminFenceProducersTerminal::Fenced(
            AdminFenceProducersBatch::new(0, Vec::new())
        ),
    }

    let join = notifier
        .stop()
        .unwrap_or_else(|error| panic!("stop shared notifier: {error}"));
    assert_eq!(join.join_off_notifier(), Ok(()));
}

pub(super) fn exercise_terminal<T, P>(publisher: P, terminal: T, worker: ThreadId)
where
    T: Send + 'static,
    P: crate::completion::CompletionPublisher<T>,
{
    let mut pending = PendingTerminal::new(publisher);
    pending.publish(terminal);
    pending.observe_and_reclaim(worker);
}

#[test]
fn shared_capacity_is_the_sum_of_the_closed_admin_ticket_set() {
    super::completion_describe_topic_partitions_test::
        assert_shared_capacity_includes_describe_topic_partitions();
}

#[test]
fn describe_topics_is_included_in_the_closed_shared_capacity_equation() {
    assert_eq!(
        AdminCompletionNotifier::capacity_for_test().checked_sub(
            CREATE_TOPICS_CAPACITY
                + ABORT_PARTITION_TRANSACTION_CAPACITY
                + ADD_RAFT_VOTER_CAPACITY
                + DELETE_TOPICS_CAPACITY
                + DESCRIBE_CLUSTER_CAPACITY
                + CREATE_PARTITIONS_CAPACITY
                + DESCRIBE_CONFIGS_CAPACITY
                + INCREMENTAL_ALTER_CONFIGS_CAPACITY
                + LEGACY_ALTER_CONFIGS_CAPACITY
                + LIST_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUPS_CAPACITY
                + ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY
                + ADMIN_LIST_OFFSETS_CAPACITY
                + LIST_PARTITION_REASSIGNMENTS_CAPACITY
                + ALTER_PARTITION_REASSIGNMENTS_CAPACITY
                + ELECT_LEADERS_CAPACITY
                + DELETE_RECORDS_CAPACITY
                + DELETE_SHARE_GROUP_OFFSETS_CAPACITY
                + LIST_SHARE_GROUP_OFFSETS_CAPACITY
                + ALTER_SHARE_GROUP_OFFSETS_CAPACITY
                + DESCRIBE_SHARE_GROUP_CAPACITY
                + DESCRIBE_STREAMS_GROUP_CAPACITY
                + DESCRIBE_CONSUMER_GROUPS_CAPACITY
                + DESCRIBE_FEATURES_CAPACITY
                + LIST_CONSUMER_GROUPS_CAPACITY
                + REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY
                + REMOVE_RAFT_VOTER_CAPACITY
                + DESCRIBE_LOG_DIRS_CAPACITY
                + DESCRIBE_REPLICA_LOG_DIRS_CAPACITY
                + ALTER_REPLICA_LOG_DIRS_CAPACITY
                + DESCRIBE_ACLS_CAPACITY
                + DESCRIBE_CLIENT_QUOTAS_CAPACITY
                + ALTER_CLIENT_QUOTAS_CAPACITY
                + ALTER_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_METADATA_QUORUM_CAPACITY
                + ADMIN_DESCRIBE_PRODUCERS_CAPACITY
                + ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY
                + ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY
                + ADMIN_FENCE_PRODUCERS_CAPACITY
                + ADMIN_LIST_TRANSACTIONS_CAPACITY
                + LIST_CLIENT_METRICS_RESOURCES_CAPACITY
                + UPDATE_FEATURES_CAPACITY
                + UNREGISTER_BROKER_CAPACITY
                + LIST_CONFIG_RESOURCES_CAPACITY
                + CREATE_ACLS_CAPACITY
                + CREATE_DELEGATION_TOKEN_CAPACITY
                + DESCRIBE_DELEGATION_TOKENS_CAPACITY
                + RENEW_DELEGATION_TOKEN_CAPACITY
                + EXPIRE_DELEGATION_TOKEN_CAPACITY
                + DELETE_ACLS_CAPACITY
        ),
        Some(DESCRIBE_TOPICS_CAPACITY)
    );
}

#[test]
fn create_partitions_is_included_in_the_closed_shared_capacity_equation() {
    assert_eq!(
        AdminCompletionNotifier::capacity_for_test().checked_sub(
            CREATE_TOPICS_CAPACITY
                + ABORT_PARTITION_TRANSACTION_CAPACITY
                + ADD_RAFT_VOTER_CAPACITY
                + DELETE_TOPICS_CAPACITY
                + DESCRIBE_CLUSTER_CAPACITY
                + DESCRIBE_TOPICS_CAPACITY
                + DESCRIBE_CONFIGS_CAPACITY
                + INCREMENTAL_ALTER_CONFIGS_CAPACITY
                + LEGACY_ALTER_CONFIGS_CAPACITY
                + LIST_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUPS_CAPACITY
                + ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY
                + ADMIN_LIST_OFFSETS_CAPACITY
                + LIST_PARTITION_REASSIGNMENTS_CAPACITY
                + ALTER_PARTITION_REASSIGNMENTS_CAPACITY
                + ELECT_LEADERS_CAPACITY
                + DELETE_RECORDS_CAPACITY
                + DELETE_SHARE_GROUP_OFFSETS_CAPACITY
                + LIST_SHARE_GROUP_OFFSETS_CAPACITY
                + ALTER_SHARE_GROUP_OFFSETS_CAPACITY
                + DESCRIBE_SHARE_GROUP_CAPACITY
                + DESCRIBE_STREAMS_GROUP_CAPACITY
                + DESCRIBE_CONSUMER_GROUPS_CAPACITY
                + DESCRIBE_FEATURES_CAPACITY
                + LIST_CONSUMER_GROUPS_CAPACITY
                + REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY
                + REMOVE_RAFT_VOTER_CAPACITY
                + DESCRIBE_LOG_DIRS_CAPACITY
                + DESCRIBE_REPLICA_LOG_DIRS_CAPACITY
                + ALTER_REPLICA_LOG_DIRS_CAPACITY
                + DESCRIBE_ACLS_CAPACITY
                + DESCRIBE_CLIENT_QUOTAS_CAPACITY
                + ALTER_CLIENT_QUOTAS_CAPACITY
                + ALTER_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_METADATA_QUORUM_CAPACITY
                + ADMIN_DESCRIBE_PRODUCERS_CAPACITY
                + ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY
                + ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY
                + ADMIN_FENCE_PRODUCERS_CAPACITY
                + ADMIN_LIST_TRANSACTIONS_CAPACITY
                + LIST_CLIENT_METRICS_RESOURCES_CAPACITY
                + UPDATE_FEATURES_CAPACITY
                + UNREGISTER_BROKER_CAPACITY
                + LIST_CONFIG_RESOURCES_CAPACITY
                + CREATE_ACLS_CAPACITY
                + CREATE_DELEGATION_TOKEN_CAPACITY
                + DESCRIBE_DELEGATION_TOKENS_CAPACITY
                + RENEW_DELEGATION_TOKEN_CAPACITY
                + EXPIRE_DELEGATION_TOKEN_CAPACITY
                + DELETE_ACLS_CAPACITY
        ),
        Some(CREATE_PARTITIONS_CAPACITY)
    );
}

#[test]
fn describe_configs_is_included_in_the_closed_shared_capacity_equation() {
    assert_eq!(
        AdminCompletionNotifier::capacity_for_test().checked_sub(
            CREATE_TOPICS_CAPACITY
                + ABORT_PARTITION_TRANSACTION_CAPACITY
                + ADD_RAFT_VOTER_CAPACITY
                + DELETE_TOPICS_CAPACITY
                + DESCRIBE_CLUSTER_CAPACITY
                + CREATE_PARTITIONS_CAPACITY
                + DESCRIBE_TOPICS_CAPACITY
                + INCREMENTAL_ALTER_CONFIGS_CAPACITY
                + LEGACY_ALTER_CONFIGS_CAPACITY
                + LIST_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUPS_CAPACITY
                + ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY
                + ADMIN_LIST_OFFSETS_CAPACITY
                + LIST_PARTITION_REASSIGNMENTS_CAPACITY
                + ALTER_PARTITION_REASSIGNMENTS_CAPACITY
                + ELECT_LEADERS_CAPACITY
                + DELETE_RECORDS_CAPACITY
                + DELETE_SHARE_GROUP_OFFSETS_CAPACITY
                + LIST_SHARE_GROUP_OFFSETS_CAPACITY
                + ALTER_SHARE_GROUP_OFFSETS_CAPACITY
                + DESCRIBE_SHARE_GROUP_CAPACITY
                + DESCRIBE_STREAMS_GROUP_CAPACITY
                + DESCRIBE_CONSUMER_GROUPS_CAPACITY
                + DESCRIBE_FEATURES_CAPACITY
                + LIST_CONSUMER_GROUPS_CAPACITY
                + REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY
                + REMOVE_RAFT_VOTER_CAPACITY
                + DESCRIBE_LOG_DIRS_CAPACITY
                + DESCRIBE_REPLICA_LOG_DIRS_CAPACITY
                + ALTER_REPLICA_LOG_DIRS_CAPACITY
                + DESCRIBE_ACLS_CAPACITY
                + DESCRIBE_CLIENT_QUOTAS_CAPACITY
                + ALTER_CLIENT_QUOTAS_CAPACITY
                + ALTER_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_METADATA_QUORUM_CAPACITY
                + ADMIN_DESCRIBE_PRODUCERS_CAPACITY
                + ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY
                + ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY
                + ADMIN_FENCE_PRODUCERS_CAPACITY
                + ADMIN_LIST_TRANSACTIONS_CAPACITY
                + LIST_CLIENT_METRICS_RESOURCES_CAPACITY
                + UPDATE_FEATURES_CAPACITY
                + UNREGISTER_BROKER_CAPACITY
                + LIST_CONFIG_RESOURCES_CAPACITY
                + CREATE_ACLS_CAPACITY
                + CREATE_DELEGATION_TOKEN_CAPACITY
                + DESCRIBE_DELEGATION_TOKENS_CAPACITY
                + RENEW_DELEGATION_TOKEN_CAPACITY
                + EXPIRE_DELEGATION_TOKEN_CAPACITY
                + DELETE_ACLS_CAPACITY
        ),
        Some(DESCRIBE_CONFIGS_CAPACITY)
    );
}

#[test]
fn incremental_alter_configs_is_included_in_the_closed_shared_capacity_equation() {
    assert_eq!(
        AdminCompletionNotifier::capacity_for_test().checked_sub(
            CREATE_TOPICS_CAPACITY
                + ABORT_PARTITION_TRANSACTION_CAPACITY
                + ADD_RAFT_VOTER_CAPACITY
                + DELETE_TOPICS_CAPACITY
                + DESCRIBE_CLUSTER_CAPACITY
                + CREATE_PARTITIONS_CAPACITY
                + DESCRIBE_TOPICS_CAPACITY
                + DESCRIBE_CONFIGS_CAPACITY
                + LEGACY_ALTER_CONFIGS_CAPACITY
                + LIST_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUPS_CAPACITY
                + ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY
                + ADMIN_LIST_OFFSETS_CAPACITY
                + LIST_PARTITION_REASSIGNMENTS_CAPACITY
                + ALTER_PARTITION_REASSIGNMENTS_CAPACITY
                + ELECT_LEADERS_CAPACITY
                + DELETE_RECORDS_CAPACITY
                + DELETE_SHARE_GROUP_OFFSETS_CAPACITY
                + LIST_SHARE_GROUP_OFFSETS_CAPACITY
                + ALTER_SHARE_GROUP_OFFSETS_CAPACITY
                + DESCRIBE_SHARE_GROUP_CAPACITY
                + DESCRIBE_STREAMS_GROUP_CAPACITY
                + DESCRIBE_CONSUMER_GROUPS_CAPACITY
                + DESCRIBE_FEATURES_CAPACITY
                + LIST_CONSUMER_GROUPS_CAPACITY
                + REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY
                + REMOVE_RAFT_VOTER_CAPACITY
                + DESCRIBE_LOG_DIRS_CAPACITY
                + DESCRIBE_REPLICA_LOG_DIRS_CAPACITY
                + ALTER_REPLICA_LOG_DIRS_CAPACITY
                + DESCRIBE_ACLS_CAPACITY
                + DESCRIBE_CLIENT_QUOTAS_CAPACITY
                + ALTER_CLIENT_QUOTAS_CAPACITY
                + ALTER_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_METADATA_QUORUM_CAPACITY
                + ADMIN_DESCRIBE_PRODUCERS_CAPACITY
                + ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY
                + ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY
                + ADMIN_FENCE_PRODUCERS_CAPACITY
                + ADMIN_LIST_TRANSACTIONS_CAPACITY
                + LIST_CLIENT_METRICS_RESOURCES_CAPACITY
                + UPDATE_FEATURES_CAPACITY
                + UNREGISTER_BROKER_CAPACITY
                + LIST_CONFIG_RESOURCES_CAPACITY
                + CREATE_ACLS_CAPACITY
                + CREATE_DELEGATION_TOKEN_CAPACITY
                + DESCRIBE_DELEGATION_TOKENS_CAPACITY
                + RENEW_DELEGATION_TOKEN_CAPACITY
                + EXPIRE_DELEGATION_TOKEN_CAPACITY
                + DELETE_ACLS_CAPACITY
        ),
        Some(INCREMENTAL_ALTER_CONFIGS_CAPACITY)
    );
}

#[test]
fn group_offsets_is_included_in_the_closed_shared_capacity_equation() {
    assert_eq!(
        AdminCompletionNotifier::capacity_for_test().checked_sub(
            CREATE_TOPICS_CAPACITY
                + ABORT_PARTITION_TRANSACTION_CAPACITY
                + ADD_RAFT_VOTER_CAPACITY
                + DELETE_TOPICS_CAPACITY
                + DESCRIBE_CLUSTER_CAPACITY
                + CREATE_PARTITIONS_CAPACITY
                + DESCRIBE_TOPICS_CAPACITY
                + DESCRIBE_CONFIGS_CAPACITY
                + INCREMENTAL_ALTER_CONFIGS_CAPACITY
                + LEGACY_ALTER_CONFIGS_CAPACITY
                + DELETE_CONSUMER_GROUP_OFFSETS_CAPACITY
                + DELETE_CONSUMER_GROUPS_CAPACITY
                + ALTER_CONSUMER_GROUP_OFFSETS_CAPACITY
                + ADMIN_LIST_OFFSETS_CAPACITY
                + LIST_PARTITION_REASSIGNMENTS_CAPACITY
                + ALTER_PARTITION_REASSIGNMENTS_CAPACITY
                + ELECT_LEADERS_CAPACITY
                + DELETE_RECORDS_CAPACITY
                + DELETE_SHARE_GROUP_OFFSETS_CAPACITY
                + LIST_SHARE_GROUP_OFFSETS_CAPACITY
                + ALTER_SHARE_GROUP_OFFSETS_CAPACITY
                + DESCRIBE_SHARE_GROUP_CAPACITY
                + DESCRIBE_STREAMS_GROUP_CAPACITY
                + DESCRIBE_CONSUMER_GROUPS_CAPACITY
                + DESCRIBE_FEATURES_CAPACITY
                + LIST_CONSUMER_GROUPS_CAPACITY
                + REMOVE_CONSUMER_GROUP_MEMBERS_CAPACITY
                + REMOVE_RAFT_VOTER_CAPACITY
                + DESCRIBE_LOG_DIRS_CAPACITY
                + DESCRIBE_REPLICA_LOG_DIRS_CAPACITY
                + ALTER_REPLICA_LOG_DIRS_CAPACITY
                + DESCRIBE_ACLS_CAPACITY
                + DESCRIBE_CLIENT_QUOTAS_CAPACITY
                + ALTER_CLIENT_QUOTAS_CAPACITY
                + ALTER_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_USER_SCRAM_CREDENTIALS_CAPACITY
                + DESCRIBE_METADATA_QUORUM_CAPACITY
                + ADMIN_DESCRIBE_PRODUCERS_CAPACITY
                + ADMIN_DESCRIBE_TOPIC_PARTITIONS_CAPACITY
                + ADMIN_DESCRIBE_TRANSACTIONS_CAPACITY
                + ADMIN_FENCE_PRODUCERS_CAPACITY
                + ADMIN_LIST_TRANSACTIONS_CAPACITY
                + LIST_CLIENT_METRICS_RESOURCES_CAPACITY
                + UPDATE_FEATURES_CAPACITY
                + UNREGISTER_BROKER_CAPACITY
                + LIST_CONFIG_RESOURCES_CAPACITY
                + CREATE_ACLS_CAPACITY
                + CREATE_DELEGATION_TOKEN_CAPACITY
                + DESCRIBE_DELEGATION_TOKENS_CAPACITY
                + RENEW_DELEGATION_TOKEN_CAPACITY
                + EXPIRE_DELEGATION_TOKEN_CAPACITY
                + DELETE_ACLS_CAPACITY
        ),
        Some(LIST_CONSUMER_GROUP_OFFSETS_CAPACITY)
    );
}
struct PendingTerminal<T, P>
where
    T: Send + 'static,
    P: crate::completion::CompletionPublisher<T>,
{
    registry: CompletionRegistry<T, P>,
    id: crate::completion::CompletionId,
    observer: crate::completion::CompletionObserver<T>,
    wake: Arc<WakeProbe>,
}

impl<T, P> PendingTerminal<T, P>
where
    T: Send + 'static,
    P: crate::completion::CompletionPublisher<T>,
{
    fn new(publisher: P) -> Self {
        let mut registry = CompletionRegistry::with_publisher(1, publisher);
        let (id, mut observer) = registry
            .reserve()
            .unwrap_or_else(|error| panic!("reserve typed admin terminal: {error}"));
        let wake = WakeProbe::new();
        let waker = Waker::from(Arc::clone(&wake));
        assert!(matches!(
            Pin::new(&mut observer).poll(&mut Context::from_waker(&waker)),
            Poll::Pending
        ));
        Self {
            registry,
            id,
            observer,
            wake,
        }
    }

    fn publish(&mut self, terminal: T) {
        assert!(matches!(self.registry.publish(self.id, terminal), Ok(())));
    }

    fn observe_and_reclaim(mut self, worker: ThreadId) {
        assert_eq!(self.wake.wait(), worker);
        let terminal = self
            .observer
            .wait()
            .unwrap_or_else(|error| panic!("observe typed admin terminal: {error}"));
        drop(terminal);
        assert_eq!(self.registry.next_reclaim(), Ok(Some(self.id)));
        assert_eq!(
            self.registry.finish_reclaim(self.id),
            Ok(ReclaimStatus::Reclaimed)
        );
    }
}

struct WakeProbe {
    thread: Mutex<Option<ThreadId>>,
    changed: Condvar,
}

impl WakeProbe {
    fn new() -> Arc<Self> {
        Arc::new(Self {
            thread: Mutex::new(None),
            changed: Condvar::new(),
        })
    }

    fn wait(&self) -> ThreadId {
        let guard = self
            .thread
            .lock()
            .unwrap_or_else(std::sync::PoisonError::into_inner);
        let guard = self
            .changed
            .wait_while(guard, |thread| thread.is_none())
            .unwrap_or_else(std::sync::PoisonError::into_inner);
        guard.unwrap_or_else(|| panic!("notifier wake must record its worker"))
    }
}

impl Wake for WakeProbe {
    fn wake(self: Arc<Self>) {
        *self
            .thread
            .lock()
            .unwrap_or_else(std::sync::PoisonError::into_inner) = Some(std::thread::current().id());
        self.changed.notify_all();
    }
}