feat(sdk): Integrate verified Python and PHP S2S payment verifiers with unified test orchestrator

[PinoyQ8]

GitHub Issue: Integration of Verified Python & PHP S2S Payment Verifiers

📌 Issue Metadata

• Title: feat(sdk): Integrate verified Python and PHP S2S payment verifiers with unified test orchestrator
• Assignee: @PinoyQ8
• Labels: feature, enhancement, community-port, ci-cd, documentation
• Milestone: Alpha Build v4.0.0

---

🚀 Overview

We are officially integrating our newly completed and verified Python 3.12+ and PHP 8.x Server-to-Server (S2S) SDK community ports into the active bazaar-republic-alpha repository under the isolated /sdk-ports/ directory.

This structural separation ensures that our main Web2 Next.js hot-reloading buffers and TypeScript compiler diagnostic layers remain completely decoupled and protected from foreign-environment dependencies, preserving development velocity.

---

🛠️ Scope of Work

1. 🐍 Python SDK Port Integration (/sdk-ports/python/)

• Core Client Class: Ingest pi_payment_verifier.py mapping the official S2S REST API methods:
  • User profile verification (GET /v2/me)
  • User-to-App payment inspection (GET /v2/payments/<id>)
  • Payment approval triggers (POST /v2/payments/<id>/approve)
  • Payment completion closures (POST /v2/payments/<id>/complete)
• Test Suite: Integrate test_verifier.py using static unit-test mocks to validate session profiles and payment sequences offline in ~4 milliseconds.
• Environment Configuration: Add requirements.txt listing lightweight runtime dependencies (requests, urllib3).

2. 🐘 PHP SDK Port Integration (/sdk-ports/php/)

• Core Client Class: Ingest namespaced PiPaymentVerifier.php using robust cURL configurations and defensive HTML-error catch blocks.
• Test Suite: Integrate test_verifier.php featuring local Namespace Overriding to intercept global cURL handles and evaluate:
  • Authorization Bearer header overrides during session handshakes.
  • Correct POST request verb dispatching.
  • Exception-handling mechanics under a simulated 502 Bad Gateway HTML response state.
  • Correct Float-to-Integer type alignments to protect strict value assertions.

3. 🧪 Unified Multi-Engine Test Orchestrator (/sdk-ports/)

• Automated Runner: Deploy test-all-ports.ps1 at the parent folder root.
• Platform Security Alignment: Enforce ASCII-only status block markers ([RUN], [OK], [STATUS], [PASS], [FAIL]) to prevent PowerShell parser crashes under standard Windows-1252 / ANSI decoding profiles.
• CI/CD Compatibility: Design the orchestrator script to return clean exit codes (0 for success, 1 for failures) for frictionless execution inside automated Git hooks and GitHub Actions pipelines.

4. 📂 VS Code Workspace Refinement

• Configure the root bazaar-republic-alpha.code-workspace file to segment the workspace into three isolated root directories:
  1. ⚡ Bazaar Republic (Next.js)
  2. 🐍 Pi Python SDK Port
  3. 🐘 Pi PHP SDK Port

---

🧪 Testing & Execution Run

Execute the unified test suite from your PowerShell terminal to verify compliance across both environments:

# Navigate into your isolated ports directory
cd J:\Project-Bazaar\bazaar-republic\bazaar-republic-alpha\sdk-ports\

# Run the ASCII-safe test orchestrator
powershell -ExecutionPolicy Bypass -File .\test-all-ports.ps1

Expected Output Structure:

==========================================================
 [RUN] PROJECT BAZAAR: MULTI-PORT SDK TEST AGGREGATOR 
==========================================================
Target Directory Root: J:\Project-Bazaar\bazaar-republic\bazaar-republic-alpha\sdk-ports

--- [1/2] Executing Python SDK Verifier Tests ---
  [OK] Python Test Suite executed cleanly!

--- [2/2] Executing PHP SDK Verifier Tests ---
  [OK] PHP Test Suite executed cleanly!

==========================================================
 [STATUS] UNIFIED PORT VALIDATION DASHBOARD
==========================================================
  [PASS] Python SDK Verifier (6/6 Mock Assertions Handled)
  [PASS] PHP SDK Verifier    (15/15 Namespace-Mock Assertions Handled)
==========================================================
  [SUCCESS] All community ports are 100% healthy!

---

© BAZAAR REPUBLIC — In code we trust