Skip to content

๐Ÿงฉ 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:

  1. Linear Memory Isolation: Setiap plugin berjalan dalam ruang memori 32-bit terpisah.
  2. Fault & Trap Isolation: Jika plugin mengalami panic, hanya modul WASM tersebut yang ter-trap; server host tetap melayani jutaan pengguna dengan normal.
  3. Zero-Downtime Hot-Reloading: Anda dapat memperbarui biner .wasm saat 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 โ€‹

bash
canting plugin:new sensor_kata

Perintah 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 โ€‹

bash
# Kompilasi seluruh plugin di folder plugins/
canting plugin:build

# Kompilasi plugin tertentu
canting plugin:build sensor_kata

Biner output otomatis dioptimasi dan disimpan ke plugins/sensor_kata.wasm.

C. Menampilkan Daftar Plugin โ€‹

bash
canting plugin:list

D. Memeriksa Dashboard Metrik & Kesehatan Plugin โ€‹

bash
canting plugin:metrics

Output:

text
๐Ÿ“Š 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 โ€‹

bash
canting plugin:reload
text
๐Ÿ”„ 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:

rust
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 TypeNama Fungsi Export WASMWaktu Eksekusi
PluginHook::OnRequestpakem_on_requestDijalankan saat HTTP Request masuk.
PluginHook::BeforeSavepakem_before_saveDijalankan sebelum model disimpan.
PluginHook::AfterResponsepakem_after_responseDijalankan sebelum HTTP Response dikirim.

Memanggil Hook dari Kode Host: โ€‹

rust
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:

html
<!-- 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!

Dirilis di bawah Lisensi MIT. Look like Laravel, Run at Rust Speed.