feat(api): defer registration phone verification to community joins (#1709)

packages/schema/src/domains/admin/AdminSchemas.ts

@@ -527,6 +527,11 @@ const InstancePolicyResponse = z.object({
 		youtube: z.boolean(),
 		bluesky: z.boolean(),
 	}),
+	deferred_phone_gate: z.object({
+		enabled: z.boolean(),
+		window_hours: z.number(),
+		member_threshold: z.number(),
+	}),
 });
 
 const CaptchaProviderSchema = z.enum(['hcaptcha', 'turnstile', 'none']);
@@ -735,6 +740,13 @@ export const InstanceConfigUpdateRequest = z.object({
 					bluesky_enabled: z.boolean().nullish(),
 				})
 				.nullish(),
+			deferred_phone_gate: z
+				.object({
+					enabled: z.boolean().optional(),
+					window_hours: z.number().positive().max(8760).optional(),
+					member_threshold: z.number().int().positive().max(1_000_000).optional(),
+				})
+				.nullish(),
 		})
 		.nullish(),
 });

packages/schema/src/domains/admin/AdminUserSchemas.ts

@@ -57,6 +57,9 @@ export const UserAdminResponseSchema = z.object({
 		'Suspicious activity indicators',
 		'SuspiciousActivityFlags',
 	),
+	phone_verification_deferred: z
+		.boolean()
+		.describe('Whether a stored phone requirement is deferred until the user joins a discoverable or large community'),
 	temp_banned_until: z.string().nullable(),
 	pending_deletion_at: z.string().nullable(),
 	pending_bulk_message_deletion_at: z.string().nullable(),