mirror of
https://github.com/block/buzz.git
synced 2026-08-18 06:50:31 +02:00
## Summary - add database-backed v2 invite links with optional maximum-use limits and atomic final-slot redemption - preserve v1 invite compatibility while adding exhausted/expired/invalid client handling across desktop, web, and mobile - emit structured claim-outcome logs with community, invite ID, outcome, maximum uses, and post-claim count ## Verification - `cargo fmt --all -- --check` - `cargo test -p buzz-db` (85 passed, 134 Postgres-dependent ignored) - `cargo clippy -p buzz-db --all-targets -- -D warnings` - desktop `npm run typecheck` - push hook: desktop checks/tests, desktop Tauri tests, Rust tests, and branch-skew passed - Postgres integration tests were previously reviewed green at the pre-rebase tree; local rerun on this session was unavailable because Postgres/Docker were not running - mobile push-hook check could not start because Flutter is unavailable locally --------- Signed-off-by: Kalvin Chau <kalvin@block.xyz> Signed-off-by: npub1dccv64krpcpse5cmkzfeh998cftungyatw3djt8jwdw6g43f7fyqzzmrf7 <6e30cd56c30e030cd31bb0939b94a7c257c9a09d5ba2d92cf2735da45629f248@buzz.block.builderlab.xyz> Co-authored-by: npub1c4alndp82zyt9veaklm5d965quss79vlhk9awv7qu5erwhmf42qqlvc25c <c57bf9b4275088b2b33db7f746975407210f159fbd8bd733c0e532375f69aa80@buzz.block.builderlab.xyz> Co-authored-by: npub122y0pqkertljmedu303rl0aqrj3w8pvu43t6jxm6875lzg6f2pwqegc3xc <5288f082d91aff2de5bc8be23fbfa01ca2e3859cac57a91b7a3fa9f12349505c@buzz.block.builderlab.xyz> Co-authored-by: npub1dccv64krpcpse5cmkzfeh998cftungyatw3djt8jwdw6g43f7fyqzzmrf7 <6e30cd56c30e030cd31bb0939b94a7c257c9a09d5ba2d92cf2735da45629f248@buzz.block.builderlab.xyz>
287 lines
8.4 KiB
Dart
287 lines
8.4 KiB
Dart
import 'dart:convert';
|
|
|
|
import 'package:http/http.dart' as http;
|
|
import 'package:hooks_riverpod/hooks_riverpod.dart';
|
|
import 'package:nostr/nostr.dart' as nostr;
|
|
|
|
import '../../shared/auth/auth.dart';
|
|
import '../../shared/deeplink/deep_link.dart';
|
|
import '../../shared/relay/relay_session.dart';
|
|
import '../../shared/relay/relay_validation.dart';
|
|
|
|
final inviteJoinHttpClientProvider = Provider<http.Client>((ref) {
|
|
final client = http.Client();
|
|
ref.onDispose(client.close);
|
|
return client;
|
|
});
|
|
|
|
final inviteKeyGeneratorProvider = Provider<InviteKeyGenerator>((ref) {
|
|
return () => nostr.Keys.generate();
|
|
});
|
|
|
|
typedef InviteKeyGenerator = nostr.Keys Function();
|
|
|
|
enum InviteJoinStatus {
|
|
idle,
|
|
confirming,
|
|
claiming,
|
|
success,
|
|
switchedExisting,
|
|
error,
|
|
}
|
|
|
|
class InviteJoinState {
|
|
final InviteJoinStatus status;
|
|
final InviteDeepLink? invite;
|
|
final String? host;
|
|
final String? communityName;
|
|
final String? errorMessage;
|
|
final bool requiresFreshInvite;
|
|
|
|
const InviteJoinState({
|
|
this.status = InviteJoinStatus.idle,
|
|
this.invite,
|
|
this.host,
|
|
this.communityName,
|
|
this.errorMessage,
|
|
this.requiresFreshInvite = false,
|
|
});
|
|
|
|
InviteJoinState copyWith({
|
|
InviteJoinStatus? status,
|
|
InviteDeepLink? invite,
|
|
String? host,
|
|
String? communityName,
|
|
String? errorMessage,
|
|
bool? requiresFreshInvite,
|
|
}) => InviteJoinState(
|
|
status: status ?? this.status,
|
|
invite: invite ?? this.invite,
|
|
host: host ?? this.host,
|
|
communityName: communityName ?? this.communityName,
|
|
errorMessage: errorMessage ?? this.errorMessage,
|
|
requiresFreshInvite: requiresFreshInvite ?? this.requiresFreshInvite,
|
|
);
|
|
}
|
|
|
|
class InviteJoinNotifier extends Notifier<InviteJoinState> {
|
|
@override
|
|
InviteJoinState build() => const InviteJoinState();
|
|
|
|
Future<void> prepare(InviteDeepLink invite) async {
|
|
validateInviteRelayUri(Uri.parse(invite.relayUrl));
|
|
final communities = await ref.read(communityListProvider.future);
|
|
final existing = _existingCommunity(communities, invite.relayUrl);
|
|
if (existing != null) {
|
|
await ref
|
|
.read(communityListProvider.notifier)
|
|
.switchCommunity(existing.id);
|
|
state = InviteJoinState(
|
|
status: InviteJoinStatus.switchedExisting,
|
|
invite: invite,
|
|
host: _hostFromRelay(invite.relayUrl),
|
|
communityName: existing.name,
|
|
);
|
|
return;
|
|
}
|
|
|
|
state = InviteJoinState(
|
|
status: InviteJoinStatus.confirming,
|
|
invite: invite,
|
|
host: _hostFromRelay(invite.relayUrl),
|
|
communityName: Community.nameFromUrl(invite.relayUrl),
|
|
);
|
|
}
|
|
|
|
Future<void> confirmJoin() async {
|
|
final invite = state.invite;
|
|
if (invite == null ||
|
|
state.requiresFreshInvite ||
|
|
(state.status != InviteJoinStatus.confirming &&
|
|
state.status != InviteJoinStatus.error)) {
|
|
return;
|
|
}
|
|
|
|
state = state.copyWith(status: InviteJoinStatus.claiming);
|
|
try {
|
|
final communities = await ref.read(communityListProvider.future);
|
|
final existing = _existingCommunity(communities, invite.relayUrl);
|
|
if (existing != null) {
|
|
await ref
|
|
.read(communityListProvider.notifier)
|
|
.switchCommunity(existing.id);
|
|
state = state.copyWith(
|
|
status: InviteJoinStatus.switchedExisting,
|
|
communityName: existing.name,
|
|
);
|
|
return;
|
|
}
|
|
|
|
final keys = ref.read(inviteKeyGeneratorProvider)();
|
|
final body = jsonEncode({
|
|
'code': invite.code,
|
|
if (invite.policyReceipt != null)
|
|
'policy_receipt': invite.policyReceipt,
|
|
});
|
|
final relayUri = Uri.parse(invite.relayUrl);
|
|
validateInviteRelayUri(relayUri);
|
|
final url = _claimUrlFromRelay(invite.relayUrl);
|
|
final request = http.Request('POST', Uri.parse(url))
|
|
..followRedirects = false
|
|
..headers.addAll({
|
|
'Authorization': buildNip98AuthHeader(
|
|
method: 'POST',
|
|
url: url,
|
|
bodyBytes: utf8.encode(body),
|
|
nsec: keys.nsec,
|
|
),
|
|
'Content-Type': 'application/json',
|
|
})
|
|
..body = body;
|
|
final streamedResponse = await ref
|
|
.read(inviteJoinHttpClientProvider)
|
|
.send(request);
|
|
final response = await http.Response.fromStream(streamedResponse);
|
|
final decoded = jsonDecode(response.body.isEmpty ? '{}' : response.body);
|
|
if (response.statusCode < 200 || response.statusCode >= 300) {
|
|
final message = decoded is Map && decoded['error'] is String
|
|
? decoded['error'] as String
|
|
: 'HTTP ${response.statusCode}';
|
|
throw InviteClaimException(message);
|
|
}
|
|
if (decoded is! Map) {
|
|
throw const FormatException('Invite claim returned malformed JSON');
|
|
}
|
|
final claim = Map<String, dynamic>.from(decoded);
|
|
|
|
final community = Community.create(
|
|
name: _communityNameFromClaim(claim, invite.relayUrl),
|
|
relayUrl: invite.relayUrl,
|
|
pubkey: keys.public,
|
|
nsec: keys.nsec,
|
|
);
|
|
await ref
|
|
.read(authProvider.notifier)
|
|
.authenticateWithCommunity(community);
|
|
state = state.copyWith(
|
|
status: InviteJoinStatus.success,
|
|
communityName: community.name,
|
|
);
|
|
} catch (error) {
|
|
final requiresFreshInvite = _requiresFreshInvite(error);
|
|
state = state.copyWith(
|
|
status: InviteJoinStatus.error,
|
|
errorMessage: _friendlyInviteError(error),
|
|
requiresFreshInvite: requiresFreshInvite,
|
|
);
|
|
}
|
|
}
|
|
|
|
void reset() {
|
|
state = const InviteJoinState();
|
|
}
|
|
}
|
|
|
|
final inviteJoinProvider =
|
|
NotifierProvider<InviteJoinNotifier, InviteJoinState>(
|
|
InviteJoinNotifier.new,
|
|
);
|
|
|
|
class InviteClaimException implements Exception {
|
|
final String message;
|
|
|
|
const InviteClaimException(this.message);
|
|
|
|
@override
|
|
String toString() => message;
|
|
}
|
|
|
|
Community? _existingCommunity(List<Community> communities, String relayUrl) {
|
|
final invite = _relayOriginForComparison(relayUrl);
|
|
for (final community in communities) {
|
|
final current = _relayOriginForComparison(community.relayUrl);
|
|
if (current == null) continue;
|
|
if (current == invite) {
|
|
return community;
|
|
}
|
|
}
|
|
return null;
|
|
}
|
|
|
|
({bool secure, String host, int? port})? _relayOriginForComparison(String url) {
|
|
final uri = Uri.tryParse(url);
|
|
if (uri == null || uri.host.isEmpty) return null;
|
|
final secure = switch (uri.scheme) {
|
|
'https' || 'wss' => true,
|
|
'http' || 'ws' => false,
|
|
_ => null,
|
|
};
|
|
if (secure == null) return null;
|
|
return (
|
|
secure: secure,
|
|
host: uri.host.toLowerCase(),
|
|
port: _effectivePort(uri),
|
|
);
|
|
}
|
|
|
|
int? _effectivePort(Uri uri) {
|
|
if (uri.hasPort) return uri.port;
|
|
return switch (uri.scheme) {
|
|
'https' || 'wss' => 443,
|
|
'http' || 'ws' => 80,
|
|
_ => null,
|
|
};
|
|
}
|
|
|
|
String _hostFromRelay(String relayUrl) {
|
|
final uri = Uri.parse(relayUrl);
|
|
if (uri.hasPort) return '${uri.host}:${uri.port}';
|
|
return uri.host;
|
|
}
|
|
|
|
String _claimUrlFromRelay(String relayUrl) {
|
|
final uri = Uri.parse(relayUrl);
|
|
final scheme = switch (uri.scheme) {
|
|
'wss' => 'https',
|
|
'ws' => 'http',
|
|
_ => throw FormatException('Invalid relay URL scheme: ${uri.scheme}'),
|
|
};
|
|
return Uri(
|
|
scheme: scheme,
|
|
host: uri.host,
|
|
port: uri.hasPort ? uri.port : null,
|
|
path: '/api/invites/claim',
|
|
).toString();
|
|
}
|
|
|
|
String _communityNameFromClaim(Map<String, dynamic> claim, String relayUrl) {
|
|
final host = claim['host'];
|
|
if (host is String && host.trim().isNotEmpty) return host.trim();
|
|
return Community.nameFromUrl(relayUrl);
|
|
}
|
|
|
|
bool _requiresFreshInvite(Object error) {
|
|
final message = error.toString();
|
|
return message.contains('join_policy_required') ||
|
|
message.contains('invite_exhausted');
|
|
}
|
|
|
|
String _friendlyInviteError(Object error) {
|
|
final message = error.toString();
|
|
if (message.contains('invite_expired')) return 'This invite has expired.';
|
|
if (message.contains('invite_exhausted')) {
|
|
return 'This invite has reached its use limit. Ask for a new invite.';
|
|
}
|
|
if (message.contains('invite_invalid')) return 'This invite is not valid.';
|
|
if (message.contains('join_policy_required')) {
|
|
return 'This invite approval has expired. Re-open the invite link to try again.';
|
|
}
|
|
if (message.contains('SocketException') ||
|
|
message.contains('Connection refused') ||
|
|
message.contains('Network is unreachable') ||
|
|
message.contains('No route to host')) {
|
|
return 'Could not reach the relay. Check your connection and try again.';
|
|
}
|
|
return 'Could not join this community: $message';
|
|
}
|