๐งฉ Modul 21 โ Dynamic WASM Plugin Registry & Zero-Downtime Hot-Reloading โ
"Look like Laravel, Run at Rust Speed. Menghadirkan ekosistem ekstensi WebAssembly terisolasi dengan kemampuan hot-reloading tanpa downtime dan proteksi kegagalan berstandar militer."
Selamat datang di Modul 21 Dokumentasi Resmi Pakem Framework! Pada modul ini, kita akan mempelajari arsitektur Dynamic WebAssembly (WASM) Plugin Registry, fitur enterprise Pakem yang memungkinkan penambahan logika kustom, filter template, dan lifecycle hooks pihak ketiga tanpa pernah mengorbankan kestabilan server inti (zero-crash guarantee).
๐ 1. Mengapa WebAssembly (WASM) di Backend? โ
Pada arsitektur monolitik konvensional, menambahkan kode pihak ketiga (misalnya kalkulator pajak daerah, parser dokumen khusus, atau modul anti-fraud) memiliki risiko fatal: jika kode tersebut mengalami panic (out-of-bounds array, null dereference), seluruh server akan jatuh (crash).
Pakem mengadopsi engine WebAssembly runtime (wasmi 2.0) dengan keunggulan mutlak:
- Linear Memory Isolation: Setiap plugin berjalan dalam ruang memori 32-bit terpisah.
- Fault & Trap Isolation: Jika plugin mengalami panic, hanya modul WASM tersebut yang ter-trap; server host tetap melayani jutaan pengguna dengan normal.
- Zero-Downtime Hot-Reloading: Anda dapat memperbarui biner
.wasmsaat server sedang berjalan di lingkungan produksi tanpa perlu me-restart proses server.
๐ 2. Manajemen Plugin via CLI โ
Pakem CLI menyediakan toolchain lengkap untuk siklus hidup plugin:
A. Membuat Plugin WASM Baru โ
canting plugin:new sensor_kataPerintah ini akan membuat sub-proyek Rust mandiri di folder plugins/sensor_kata/ yang dikonfigurasi khusus untuk target wasm32-unknown-unknown.
B. Mengompilasi Plugin ke Biner .wasm โ
# Kompilasi seluruh plugin di folder plugins/
canting plugin:build
# Kompilasi plugin tertentu
canting plugin:build sensor_kataBiner output otomatis dioptimasi dan disimpan ke plugins/sensor_kata.wasm.
C. Menampilkan Daftar Plugin โ
canting plugin:listD. Memeriksa Dashboard Metrik & Kesehatan Plugin โ
canting plugin:metricsOutput:
๐ Pakem WASM Sandbox & Plugin Metrics Dashboard
Total WASM Modules Loaded : 2
Script Modules Cached : 0
โโโโโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
โ PLUGIN NAME โ CALLS COUNT โ ERRORS COUNT โ AVG DURATION โ STATUS โ
โโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโค
โ sensor_kata โ 1540 โ 0 โ 4.25ยตs โ Healthy โ
โ
โ pajak_ppn โ 320 โ 0 โ 2.80ยตs โ Healthy โ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโE. Memicu Reload Manual Tanpa Downtime โ
canting plugin:reload๐ Reloading Pakem WASM Plugins (Zero-Downtime Hot-Reload)...
โ
[Reload Success] Berhasil memuat ulang 2 plugin dalam 3.42ms tanpa downtime! โก๐ 3. Zero-Downtime Hot-Reloading Otomatis โ
Di aplikasi Pakem, Anda dapat mengaktifkan pemantauan otomatis (background file watcher) yang mendeteksi pembaruan file .wasm secara asinkron:
use pakem::prelude::*;
use std::time::Duration;
#[tokio::main]
async fn main() {
let app = Application::new();
let plugin_manager = PakemPluginManager::new();
// Memuat seluruh plugin awal dari folder plugins/
plugin_manager.load_directory("plugins").unwrap();
// Aktifkan auto-watcher hot-reloading setiap 2 detik
plugin_manager.start_hot_reload_watcher("plugins", Duration::from_secs(2));
app.run().await;
}Ketika Anda mengunggah berkas .wasm versi baru ke folder plugins/, pointer instance di memori diperbarui secara atomik (Arc<RwLock<...>>). Request yang sedang berjalan menyelesaikan prosesnya dengan instance lama, sedangkan request baru langsung menggunakan versi terbaru.
๐ช 4. Lifecycle Hooks Pipeline โ
Plugin WASM dapat merespons berbagai event siklus hidup aplikasi dengan mengekspor fungsi standar:
| Hook Type | Nama Fungsi Export WASM | Waktu Eksekusi |
|---|---|---|
PluginHook::OnRequest | pakem_on_request | Dijalankan saat HTTP Request masuk. |
PluginHook::BeforeSave | pakem_before_save | Dijalankan sebelum model disimpan. |
PluginHook::AfterResponse | pakem_after_response | Dijalankan sebelum HTTP Response dikirim. |
Memanggil Hook dari Kode Host: โ
let results = plugin_manager.call_hook(PluginHook::OnRequest, &request_json);
for (plugin_name, result) in results {
match result {
Ok(transformed) => println!("Plugin {} memproses hook: {}", plugin_name, transformed),
Err(e) => eprintln!("Plugin {} error: {}", plugin_name, e),
}
}๐จ 5. Integrasi Filter Blade Template โ
Plugin WASM juga dapat digunakan langsung sebagai pipeline filter di template Blade .blade.rs:
<!-- Menggunakan filter WASM sensor_kata -->
<p>{{ $comment | sensor_kata }}</p>
<!-- Menggunakan direktif @wasm -->
<div>@wasm('pajak_ppn', 'hitung', $subtotal)</div>๐ฏ Kesimpulan โ
Dengan kehadiran Pakem Tinker dan Dynamic WASM Plugin Registry, Pakem Framework v1.0.0 resmi menetapkan standar baru bagi arsitektur framework backend modern: produktif, seindah Laravel, dan secepat serta seaman Rust!