httpStatus === $status, $message); return; } throw new RuntimeException($message); }; $capsule = new Capsule(); $capsule->addConnection([ 'driver' => 'sqlite', 'database' => ':memory:', ], 'default'); $capsule->setAsGlobal(); $capsule->bootEloquent(); $schema = $capsule->schema('default'); $schema->create('cloud_hosts', static function (Blueprint $table): void { $table->increments('id'); $table->string('name'); $table->string('region')->default(''); $table->boolean('enabled')->default(false); }); $schema->create('cloud_public_ip_pools', static function (Blueprint $table): void { $table->increments('id'); $table->string('pool_key'); $table->integer('host_id'); $table->integer('address_family'); $table->string('name'); $table->string('cidr'); $table->string('state')->default('active'); }); $schema->create('user', static function (Blueprint $table): void { $table->increments('id'); $table->string('email'); }); $schema->create('cloud_instances', static function (Blueprint $table): void { $table->increments('id'); $table->integer('user_id'); $table->integer('host_id'); $table->integer('reservation_id')->nullable(); $table->string('name'); $table->string('status'); $table->text('spec_json'); }); $schema->create('cloud_resource_reservations', static function (Blueprint $table): void { $table->increments('id'); $table->integer('instance_id')->nullable(); $table->integer('host_id'); $table->integer('user_id'); $table->string('state'); }); $schema->create('cloud_resource_reservation_ips', static function (Blueprint $table): void { $table->increments('id'); $table->integer('reservation_id'); $table->integer('address_family'); $table->integer('claim_generation'); $table->integer('active_claim')->nullable(); $table->integer('public_ip_pool_id'); $table->integer('public_ip_id'); $table->string('operation_id'); $table->string('state'); }); $schema->create('cloud_public_ips', static function (Blueprint $table): void { $table->increments('id'); $table->integer('host_id'); $table->integer('reservation_id')->nullable(); $table->integer('reservation_ip_claim_id')->nullable(); $table->integer('instance_id')->nullable(); $table->integer('public_ip_pool_id')->nullable(); $table->integer('address_family'); $table->string('operation_id')->nullable(); $table->string('state'); $table->string('address'); $table->integer('prefix_length'); }); $schema->create('cloud_maintenance_notices', static function (Blueprint $table): void { $table->increments('id'); $table->string('notice_key')->unique(); $table->integer('requested_by_user_id'); $table->string('request_idempotency_key'); $table->string('request_fingerprint'); $table->string('scope_type'); $table->integer('scope_id'); $table->text('scope_snapshot_json'); $table->string('subject'); $table->text('message_text'); $table->string('impact'); $table->integer('maintenance_starts_at'); $table->integer('maintenance_ends_at'); $table->integer('scheduled_at'); $table->string('audience_digest'); $table->integer('instance_count'); $table->integer('recipient_count'); $table->integer('skipped_count'); $table->string('status'); $table->string('last_error_code'); $table->integer('terminal_at')->nullable(); $table->integer('created_at'); $table->integer('updated_at'); $table->unique(['requested_by_user_id', 'request_idempotency_key']); }); $schema->create('cloud_maintenance_notice_instances', static function (Blueprint $table): void { $table->increments('id'); $table->integer('notice_id'); $table->integer('instance_id'); $table->integer('user_id'); $table->integer('host_id'); $table->integer('public_ip_pool_id')->nullable(); $table->string('instance_name'); $table->string('ipv4'); $table->string('ipv6'); $table->text('evidence_json'); $table->integer('created_at'); }); $schema->create('cloud_maintenance_notice_recipients', static function (Blueprint $table): void { $table->increments('id'); $table->integer('notice_id'); $table->integer('user_id'); $table->string('email_snapshot'); $table->string('status'); $table->integer('attempts'); $table->integer('available_at'); $table->string('lease_token')->nullable(); $table->integer('lease_until'); $table->integer('sent_at')->nullable(); $table->string('last_error_code'); $table->string('last_error'); $table->integer('created_at'); $table->integer('updated_at'); }); Capsule::table('cloud_hosts')->insert([ 'id' => 1, 'name' => 'HKG-A', 'region' => 'HongKong', 'enabled' => 1, ]); Capsule::table('cloud_public_ip_pools')->insert([ 'id' => 7, 'pool_key' => str_repeat('a', 32), 'host_id' => 1, 'address_family' => 4, 'name' => 'HKG public v4', 'cidr' => '192.0.2.0/29', 'state' => 'draining', ]); Capsule::table('user')->insert([ ['id' => 1, 'email' => 'owner@example.com'], ['id' => 2, 'email' => 'invalid'], ]); Capsule::table('cloud_instances')->insert([ ['id' => 11, 'user_id' => 1, 'host_id' => 1, 'reservation_id' => null, 'name' => 'vm-a', 'status' => 'active', 'spec_json' => '{}'], ['id' => 12, 'user_id' => 2, 'host_id' => 1, 'reservation_id' => null, 'name' => 'vm-b', 'status' => 'active', 'spec_json' => '{}'], ]); $now = 1793900000; $audience = new CloudMaintenanceNoticeAudience(); $service = new CloudMaintenanceNoticeService( $audience, static fn (): int => $now ); $catalog = $service->catalog(); $assert($catalog['hosts'][0]['enabled'] === true && $catalog['pools'][0]['state'] === 'draining', 'The page catalog must retain disabled or draining audience scopes.'); $assert($service->prefill([ 'scope_type' => 'public_ip_pool', 'host_id' => 1, 'pool_key' => str_repeat('a', 32), ], $catalog) === ['scope_type' => 'public_ip_pool', 'scope_id' => 7], 'A trusted pool shortcut must resolve through the server catalog.'); $assert($service->prefill([ 'scope_type' => 'public_ip_pool', 'host_id' => 2, 'pool_key' => str_repeat('a', 32), ], $catalog) === [], 'A shortcut cannot resolve a pool under a different host.'); $preview = $service->preview('host', 1); $request = [ 'scope_type' => 'host', 'scope_id' => 1, 'subject' => 'HKG-A maintenance', 'message_text' => "Network maintenance\nPlease save your work.", 'impact' => 'network_interruption', 'maintenance_starts_at' => $now + 3600, 'maintenance_ends_at' => $now + 7200, 'scheduled_at' => $now + 60, 'audience_digest' => $preview['audience_digest'], ]; $created = $service->schedule( 9, 'maintenance-test-0001', $request ); $assert($created['status'] === 'scheduled' && $created['instance_count'] === 2 && $created['recipient_count'] === 1 && $created['skipped_count'] === 1, 'Schedule must freeze reviewed counts.'); $assert(count($created['recipients']) === 2 && $created['recipients'][0]['status'] === 'pending' && $created['recipients'][1]['status'] === 'skipped', 'Schedule must persist pending and skipped recipients.'); $assert($service->schedule(9, 'maintenance-test-0001', $request) ['notice_key'] === $created['notice_key'], 'An identical idempotent request must return its original notice.'); $different = $request; $different['subject'] = 'Changed subject'; $expect( static fn () => $service->schedule( 9, 'maintenance-test-0001', $different ), 409, 'An idempotency key must not accept a different request.' ); $invalidType = $request; $invalidType['subject'] = ['unexpected']; $expect( static fn () => $service->schedule( 9, 'maintenance-test-typed-input', $invalidType ), 422, 'Array input must not be coerced into an email subject.' ); $invalidHeader = $request; $invalidHeader['subject'] = "Maintenance\r\nBcc: attacker@example.com"; $expect( static fn () => $service->schedule( 9, 'maintenance-test-header-input', $invalidHeader ), 422, 'Email subjects must reject control characters.' ); $cancelled = $service->cancel($created['notice_key']); $assert($cancelled['status'] === 'cancelled' && $cancelled['terminal_at'] === $now, 'Cancelling an unsent notice must make it terminal.'); $assert($cancelled['recipients'][0]['status'] === 'cancelled' && $cancelled['recipients'][1]['status'] === 'skipped', 'Cancellation must only change pending recipients.'); $oldPreview = $service->preview('host', 1); Capsule::table('cloud_instances')->insert([ 'id' => 13, 'user_id' => 1, 'host_id' => 1, 'reservation_id' => null, 'name' => 'vm-c', 'status' => 'active', 'spec_json' => '{}', ]); $drifted = $request; $drifted['audience_digest'] = $oldPreview['audience_digest']; $expect( static fn () => $service->schedule( 9, 'maintenance-test-0002', $drifted ), 409, 'Audience drift must reject scheduling.' ); $assert(Capsule::table('cloud_maintenance_notices')->count() === 1, 'A rejected drifted request must not create a notice.'); echo "Maintenance notice service tests passed.\n";