fakedev

fakedev

Generator PLP (Profile Logo Picture) berbasis Canvas untuk Node.js.

Hasil berupa PNG Buffer yang berisi:

• Foto profil bulat
• Nama melengkung (⌣) di atas, dengan opsi role/jabatan kecil di bawahnya
• Badge centang
• Background yang dapat dipilih (termasuk mode acak)

Package ini 100% platform-agnostic. Tidak memiliki kode khusus Telegram, WhatsApp, Discord, maupun framework bot lainnya. Output hanya berupa Buffer, sehingga bisa digunakan di project Node.js apa pun.

---

Install

npm install fakedev

---

Assets

Struktur default:

assets/
├── background1.jpg
├── background2.jpg
├── background3.jpg
├── centang.png
└── font.ttf

File	Required	Keterangan
background{N}.jpg		Background PLP
centang.png		Badge centang
font.ttf		Font custom

---

Basic Usage

const { generatePLP } = require("fakedev");
const fs = require("fs");

(async () => {
  const image = await generatePLP({
    photo: "./photo.jpg",
    name: "Kyuuu",
    bgIndex: 1,
    textColor: "#FFFFFF",
    shadowColor: "#00ffff",
    checkSize: 220
  });

  fs.writeFileSync("result.png", image);
})();

---

Nama + Role ("Nama|Role")

Nama besar selalu di atas (melengkung). Mulai versi ini, kamu bisa menambahkan baris role/jabatan kecil tepat di bawah nama, cukup pisahkan dengan karakter |:

const image = await generatePLP({
  photo: "./photo.jpg",
  name: "Kyuu|Not Dev", // "Kyuu" jadi nama besar, "Not Dev" jadi role di bawahnya
  bgIndex: 1
});

Format ini fleksibel, contoh lain: "text|text2", "Sanaka|Owner", "Alya|Bot Developer".

Kalau tidak butuh format "Nama|Role", role juga bisa diisi terpisah lewat opsi role:

const image = await generatePLP({
  photo: "./photo.jpg",
  name: "Kyuu",
  role: "Not Dev",
  bgIndex: 1
});

Tidak menulis role sama sekali (baik lewat "|" maupun opsi role) tetap didukung — hasilnya sama seperti versi sebelumnya, hanya nama tanpa role.

---

Pilih Background

bgIndex mendukung tiga cara:

// 1) Pilih background tertentu lewat nomor file (assets/background5.jpg)
await generatePLP({ photo, name, bgIndex: 5 });

// 2) Pilih acak dari semua background yang ada di assetsDir
await generatePLP({ photo, name, bgIndex: "random" }); // atau "acak"

// 3) Default kalau tidak diisi -> bgIndex: 1
await generatePLP({ photo, name });

Kalau index yang diminta tidak ada filenya, generatePLP akan melempar error yang menyebutkan daftar index background yang valid, supaya gampang di-debug.

Untuk bikin menu pilih background sendiri (misalnya tombol interaktif di bot), ambil daftar index yang tersedia lewat:

const { listAvailableBackgrounds } = require("fakedev");
const indexes = listAvailableBackgrounds("./assets"); // contoh: [1, 2, 3, ..., 30]

---

Options

Option	Type	Default	Description
photo	string | Buffer	required	Path lokal, URL, atau Buffer foto.
name	string	required	Nama yang ditampilkan. Bisa berupa "Nama|Role" untuk sekaligus mengisi role.
role	string	""	Role/jabatan kecil di bawah nama. Diabaikan kalau name sudah mengandung "|".
bgIndex	number | "random"	1	Background yang digunakan, atau "random"/"acak" untuk acak.
textColor	string	#FFFFFF	Warna teks nama.
shadowColor	string	#00ffff	Warna glow/shadow (dipakai untuk nama & role).
roleColor	string	sama dengan textColor	Warna teks role.
assetsDir	string	./assets	Folder assets custom.
checkSize	number	220	Ukuran badge centang.

---

Color Presets

const {
  textColors,
  shadowColors
} = require("fakedev");

console.log(textColors.white);
console.log(shadowColors.cyan);

Tersedia lebih dari 90 preset warna untuk teks dan glow.

---

WhatsApp (Baileys)

const { generatePLP } = require("fakedev");

const buffer = await generatePLP({
  photo: photoBuffer,
  name: "Kyuuu|Not Dev",
  bgIndex: "random"
});

await sock.sendMessage(chatId, {
  image: buffer
});

---

Telegram (Telegraf)

const { generatePLP } = require("fakedev");

const buffer = await generatePLP({
  photo: photoUrl,
  name: "Kyuuu|Owner"
});

await ctx.replyWithPhoto({
  source: buffer
});

---

node-telegram-bot-api

const { generatePLP } = require("fakedev");

const buffer = await generatePLP({
  photo: photoUrl,
  name: "Kyuuu"
});

await bot.sendPhoto(chatId, buffer);

---

API

const { generatePLP, listAvailableBackgrounds } = require("fakedev");

generatePLP(options)

Mengembalikan:

Promise<Buffer>

Output berupa PNG Buffer yang siap digunakan untuk:

• WhatsApp Bot
• Telegram Bot
• Discord Bot
• Express API
• Fastify API
• Next.js API Routes
• Vercel Functions
• Node.js Project

listAvailableBackgrounds(assetsDir)

Mengembalikan array nomor index background yang tersedia di assetsDir, contoh: [1, 2, 3, ..., 30]. Berguna untuk membuat menu pilih background sendiri (tombol interaktif, dsb).

---

License

MIT