addConnection([ 'driver' => 'sqlite', 'database' => ':memory:', ], 'default'); $capsule->setAsGlobal(); $capsule->bootEloquent(); $schema = $capsule->schema('default'); $schema->create('user', static function (Blueprint $table): void { $table->increments('id'); $table->string('email'); }); $schema->create('cloud_maintenance_notices', static function (Blueprint $table): void { $table->increments('id'); $table->string('notice_key'); $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'); }); $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'); }); $now = 1793900000; Capsule::table('user')->insert([ ['id' => 1, 'email' => 'ok@example.com'], ['id' => 2, 'email' => 'unknown@example.com'], ['id' => 3, 'email' => 'blocked@example.com'], ['id' => 4, 'email' => 'new@example.com'], ]); $insertNotice = static function (int $id, string $status = 'scheduled') use ($now): void { Capsule::table('cloud_maintenance_notices')->insert([ 'id' => $id, 'notice_key' => str_pad(dechex($id), 32, '0', STR_PAD_LEFT), 'requested_by_user_id' => 9, 'request_idempotency_key' => 'delivery-test-' . str_pad((string) $id, 4, '0', STR_PAD_LEFT), 'request_fingerprint' => str_repeat('a', 64), 'scope_type' => 'host', 'scope_id' => 1, 'scope_snapshot_json' => '{"label":"HKG-A"}', 'subject' => 'Maintenance ', 'message_text' => 'Please save.', 'impact' => 'network_interruption', 'maintenance_starts_at' => $now + 3600, 'maintenance_ends_at' => $now + 7200, 'scheduled_at' => $now, 'audience_digest' => str_repeat('b', 64), 'instance_count' => 1, 'recipient_count' => 1, 'skipped_count' => 0, 'status' => $status, 'last_error_code' => '', 'terminal_at' => null, 'created_at' => $now, 'updated_at' => $now, ]); }; $insertRecipient = static function (int $id, int $noticeId, int $userId, string $email, string $status, int $availableAt, ?string $token = null, int $leaseUntil = 0) use ($now): void { Capsule::table('cloud_maintenance_notice_recipients')->insert([ 'id' => $id, 'notice_id' => $noticeId, 'user_id' => $userId, 'email_snapshot' => $email, 'status' => $status, 'attempts' => $status === 'sending' ? 1 : 0, 'available_at' => $availableAt, 'lease_token' => $token, 'lease_until' => $leaseUntil, 'sent_at' => null, 'last_error_code' => '', 'last_error' => '', 'created_at' => $now, 'updated_at' => $now, ]); Capsule::table('cloud_maintenance_notice_instances')->insert([ 'notice_id' => $noticeId, 'instance_id' => 100 + $noticeId, 'user_id' => $userId, 'host_id' => 1, 'public_ip_pool_id' => null, 'instance_name' => 'vm-' . $noticeId, 'ipv4' => '203.0.113.' . $noticeId, 'ipv6' => '2001:db8::' . $noticeId, 'evidence_json' => '{}', 'created_at' => $now, ]); }; $insertNotice(1); $insertRecipient(1, 1, 1, 'ok@example.com', 'pending', $now); $insertRecipient(2, 1, 2, 'unknown@example.com', 'pending', $now + 60); $sent = []; $delivery = new CloudMaintenanceNoticeDeliveryService( static function (string $to, string $subject, array $variables) use (&$sent): bool { $sent[] = compact('to', 'subject', 'variables'); return $to === 'ok@example.com'; }, static fn (string $email): bool => $email === 'blocked@example.com', static fn (): int => $now, new CloudMaintenanceNoticeService( new CloudMaintenanceNoticeAudience(), static fn (): int => $now ) ); $assert($delivery->tick() === true && count($sent) === 1, 'One due recipient must be delivered per tick.'); $row = Capsule::table('cloud_maintenance_notice_recipients')->find(1); $assert($row->status === 'sent' && (int) $row->attempts === 1 && (int) $row->sent_at === $now, 'Accepted mail was not finalized exactly once.'); $assert($sent[0]['variables']['maintenance_starts_utc'] === gmdate('Y-m-d H:i:s \\U\\T\\C', $now + 3600) && $sent[0]['variables']['instances'][0]['ipv6'] === '2001:db8::1', 'Delivery lost the frozen UTC window or recipient instance list.'); $assert($delivery->tick() === false && count($sent) === 1, 'A future recipient was delivered early.'); Capsule::table('cloud_maintenance_notice_recipients')->where('id', 2) ->update(['available_at' => $now]); $assert($delivery->tick() === true && count($sent) === 2, 'The second due recipient was not attempted.'); $row = Capsule::table('cloud_maintenance_notice_recipients')->find(2); $notice = Capsule::table('cloud_maintenance_notices')->find(1); $assert($row->status === 'unknown' && $row->last_error_code === 'delivery_effect_unknown' && $notice->status === 'attention', 'A transport false result was not preserved as unknown attention.'); $assert($delivery->tick() === false && count($sent) === 2, 'An unknown delivery was replayed automatically.'); $insertNotice(2, 'sending'); $insertRecipient(3, 2, 1, 'expired@example.com', 'sending', $now - 400, str_repeat('c', 32), $now - 1); $assert($delivery->tick() === true && count($sent) === 2, 'An expired sending lease was not converged without transport.'); $row = Capsule::table('cloud_maintenance_notice_recipients')->find(3); $assert($row->status === 'unknown' && $row->last_error_code === 'delivery_lease_expired', 'Expired lease was retried or lost its unknown-effect evidence.'); $insertNotice(3); $insertRecipient(4, 3, 3, 'blocked@example.com', 'pending', $now); $assert($delivery->tick() === true && count($sent) === 2, 'A blacklisted recipient did not settle without transport.'); $row = Capsule::table('cloud_maintenance_notice_recipients')->find(4); $notice = Capsule::table('cloud_maintenance_notices')->find(3); $assert($row->status === 'skipped' && $row->last_error_code === 'recipient_blacklisted' && $notice->status === 'completed', 'Blacklisted delivery was sent or aggregated as a failure.'); $insertNotice(6); $insertRecipient(7, 6, 4, 'old@example.com', 'pending', $now); $assert($delivery->tick() === true && count($sent) === 2, 'An email-changed recipient did not settle without transport.'); $row = Capsule::table('cloud_maintenance_notice_recipients')->find(7); $assert($row->status === 'skipped' && $row->last_error_code === 'recipient_email_changed', 'Frozen recipient PII was sent after the account email changed.'); $insertNotice(4); $insertRecipient(5, 4, 99, 'deleted@example.com', 'pending', $now); $assert($delivery->tick() === true && count($sent) === 2 && Capsule::table('cloud_maintenance_notice_recipients')->find(5) ->status === 'skipped', 'A deleted user still reached the transport.'); $insertNotice(5); $insertRecipient(6, 5, 1, 'ok@example.com', 'pending', $now); $fenced = new CloudMaintenanceNoticeDeliveryService( static function (): bool { Capsule::table('cloud_maintenance_notice_recipients') ->where('id', 6)->update([ 'status' => 'unknown', 'lease_token' => null, 'lease_until' => 0, 'last_error_code' => 'external_reconciliation', ]); return true; }, static fn (): bool => false, static fn (): int => $now, new CloudMaintenanceNoticeService( new CloudMaintenanceNoticeAudience(), static fn (): int => $now ) ); $assert($fenced->tick() === true && Capsule::table('cloud_maintenance_notice_recipients')->find(6) ->status === 'unknown', 'A stale lease token overwrote a reconciled terminal outcome.'); echo "Maintenance notice delivery tests passed.\n";