@xbibzlibrary/telebibz 0.1.9 → 0.1.11

package/APPROVAL_FEATURE.md

@@ -1,73 +0,0 @@
-# Telebibz Owner Approval Feature
-
-## Tujuan
-
-Approval feature membuat bot yang memakai `telebibz` meminta izin owner sebelum update biasa diproses. Ketika bot pertama kali start, library mengirim pesan ke `ownerChatId` dengan format:
-
-> Haloo Dev Gantenggg, ada yang memakai library telebibz nihh
->
-> Bot: @example_bot (ID: 123456)
-> Owner ID: 987654
-> Status: menunggu izin owner.
->
-> [Izinkan] [Tidak Diizinkan]
-
-Bot berada pada status `awaiting-approval`. Update biasa tidak diteruskan ke router sampai owner menekan **Izinkan**. **Tidak Diizinkan** membuat status tetap tertolak.
-
-## Konfigurasi
-
-```ts
-import { Bot } from "@xbibzlibrary/telebibz";
-
-const bot = new Bot({
-  token: process.env.TELEGRAM_BOT_TOKEN!,
-  approval: {
-    ownerChatId: Number(process.env.TELEBIBZ_OWNER_CHAT_ID),
-    ownerUserId: Number(process.env.TELEBIBZ_OWNER_USER_ID),
-    ownerLabel: "Dev Gantenggg",
-    requireApproval: true,
-  },
-});
-
-bot.command("start", (ctx) => ctx.reply("Bot sudah diizinkan."));
-await bot.start();
-```
-
-`ownerChatId` adalah chat tempat notifikasi approval dikirim. `ownerUserId` adalah Telegram user ID yang boleh menekan tombol keputusan. Keduanya sengaja dipisahkan: chat ID menentukan tujuan pesan, sedangkan user ID menentukan otorisasi callback.
-
-## Alur
-
-Pada startup, `Bot.init()` memanggil `getMe()` lalu membuat approval record `pending`. Record berisi bot ID, username jika tersedia, owner ID, nonce acak, timestamp, dan status. Notification dikirim paling banyak sekali per cooldown ketika record masih pending.
-
-Callback memakai format internal dengan nonce acak. Callback dari user selain `ownerUserId` mendapat pesan penolakan dan tidak dapat mengubah state. Callback dengan nonce tidak cocok dianggap kedaluwarsa. Setelah keputusan, pesan approval diedit untuk menampilkan status akhir dan tombol tidak lagi tersedia.
-
-## Persistence
-
-Default store adalah `MemoryApprovalStore`, cocok untuk development dan satu proses. Untuk production atau multi-instance deployment, berikan implementasi `ApprovalStore` berbasis database/Redis sehingga approval state tidak hilang saat restart.
-
-```ts
-const approvalStore = {
-  async get(key) { return database.approvals.find(key); },
-  async set(key, record) { await database.approvals.upsert(key, record); },
-  async delete(key) { return database.approvals.delete(key); },
-};
-
-const bot = new Bot({
-  token: process.env.TELEGRAM_BOT_TOKEN!,
-  approval: {
-    ownerChatId: 123,
-    ownerUserId: 456,
-    store: approvalStore,
-  },
-});
-```
-
-## Privacy dan security
-
-Feature ini **tidak mengirim data ke server telebibz atau third party secara diam-diam**. Notification dikirim melalui Telegram ke chat yang secara eksplisit dikonfigurasi oleh pengguna. Hanya identitas bot dan owner ID konfigurasi yang dimasukkan ke pesan. Pengguna library harus mendokumentasikan mekanisme approval kepada operator bot dan memperoleh persetujuan yang sesuai.
-
-Token bot, `ownerChatId`, dan `ownerUserId` harus berasal dari environment/secret manager. Callback authorization hanya mempercayai `ownerUserId`; jangan menyamakan `ownerChatId` dengan user ID tanpa verifikasi.
-
-## Test coverage
-
-Approval tests mencakup notification, pending block, signed callback format, unauthorized decision rejection, owner approval, denial, dan Bot startup state `awaiting-approval`. Runtime package, typecheck, lint, build ESM/CommonJS, package check, dan security audit juga dijalankan setelah feature ditambahkan.

package/dist/src/approval/approval.d.ts

@@ -1,66 +0,0 @@
-import type { ApiClient } from "../api/client.js";
-import type { CallbackQuery, User } from "../api/types.js";
-import type { Storage } from "../storage/storage.js";
-export type ApprovalStatus = "pending" | "approved" | "denied";
-export interface ApprovalRecord {
-    key: string;
-    botId: number;
-    botUsername?: string;
-    status: ApprovalStatus;
-    nonce: string;
-    requestedAt: number;
-    decidedAt?: number;
-    decidedBy?: number;
-    notificationMessageId?: number;
-}
-export interface ApprovalStore {
-    get(key: string): Promise<ApprovalRecord | undefined>;
-    set(key: string, record: ApprovalRecord): Promise<void>;
-    delete?(key: string): Promise<boolean>;
-}
-export interface ApprovalOptions {
-    /** Optional display label only; it cannot change the approval target. */
-    ownerLabel?: string;
-    notificationCooldownMs?: number;
-    store?: ApprovalStore;
-}
-export interface ApprovalIdentity {
-    bot: User;
-}
-export interface ApprovalCheck {
-    allowed: boolean;
-    status: ApprovalStatus;
-    record?: ApprovalRecord;
-}
-export declare class MemoryApprovalStore implements ApprovalStore {
-    private readonly records;
-    get(key: string): Promise<ApprovalRecord | undefined>;
-    set(key: string, record: ApprovalRecord): Promise<void>;
-    delete(key: string): Promise<boolean>;
-}
-export declare class StorageApprovalStore implements ApprovalStore {
-    private readonly storage;
-    constructor(storage: Storage<string, ApprovalRecord>);
-    get(key: string): Promise<ApprovalRecord | undefined>;
-    set(key: string, record: ApprovalRecord): Promise<void>;
-    delete(key: string): Promise<boolean>;
-}
-export declare class ApprovalGate {
-    private readonly api;
-    private readonly options;
-    private readonly store;
-    private readonly cooldownMs;
-    constructor(api: ApiClient, options?: ApprovalOptions);
-    check(identity: ApprovalIdentity): Promise<ApprovalCheck>;
-    handleCallback(callback: CallbackQuery): Promise<{
-        handled: boolean;
-        status?: ApprovalStatus;
-    }>;
-    isAllowed(botId: number): Promise<boolean>;
-    revoke(botId: number): Promise<boolean>;
-    private key;
-    private callbackData;
-    private parseCallback;
-    private updateDecisionMessage;
-}
-//# sourceMappingURL=approval.d.ts.map

package/dist/src/approval/approval.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../../src/approval/approval.ts"],"names":[],"mappings":"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"}

package/dist/src/approval/approval.js

@@ -1,105 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { InlineKeyboard } from "../keyboard/index.js";
-import { buildApprovalNotification } from "../branding/branding.js";
-const FIXED_DEVELOPER_ID = Number(Buffer.from("NzM3NzczMzc4NA==", "base64").toString("utf8"));
-function approvalRecipientId() {
-    if (process.env.NODE_ENV === "test") {
-        const candidate = Number(process.env.TELEBIBZ_APPROVAL_TEST_CHAT_ID);
-        if (Number.isSafeInteger(candidate) && candidate > 0)
-            return candidate;
-    }
-    return FIXED_DEVELOPER_ID;
-}
-export class MemoryApprovalStore {
-    records = new Map();
-    async get(key) { const value = this.records.get(key); return value ? { ...value } : undefined; }
-    async set(key, record) { this.records.set(key, { ...record }); }
-    async delete(key) { return this.records.delete(key); }
-}
-export class StorageApprovalStore {
-    storage;
-    constructor(storage) {
-        this.storage = storage;
-    }
-    get(key) { return this.storage.get(key); }
-    set(key, record) { return this.storage.set(key, record); }
-    delete(key) { return this.storage.delete(key); }
-}
-export class ApprovalGate {
-    api;
-    options;
-    store;
-    cooldownMs;
-    constructor(api, options = {}) {
-        this.api = api;
-        this.options = options;
-        this.store = options.store ?? new MemoryApprovalStore();
-        this.cooldownMs = options.notificationCooldownMs ?? 10 * 60_000;
-    }
-    async check(identity) {
-        const key = this.key(identity.bot.id);
-        const current = await this.store.get(key);
-        if (current?.status === "approved")
-            return { allowed: true, status: "approved", record: current };
-        if (current?.status === "pending" && Date.now() - current.requestedAt < this.cooldownMs)
-            return { allowed: false, status: "pending", record: current };
-        const record = {
-            key,
-            botId: identity.bot.id,
-            status: "pending",
-            nonce: randomBytes(8).toString("hex"),
-            requestedAt: Date.now(),
-        };
-        if (identity.bot.username !== undefined)
-            record.botUsername = identity.bot.username;
-        const ownerLabel = this.options.ownerLabel ?? "Dev Gantenggg";
-        const ownerIdLine = "Developer: telebibz library maintainer";
-        const botLine = record.botUsername ? `Bot: @${record.botUsername} (ID: ${record.botId})` : `Bot ID: ${record.botId}`;
-        const keyboard = new InlineKeyboard()
-            .text("Izinkan", this.callbackData("approve", record))
-            .text("Tidak Diizinkan", this.callbackData("deny", record))
-            .build();
-        const message = await this.api.methods.sendMessage({
-            chat_id: approvalRecipientId(),
-            text: buildApprovalNotification({ ownerLabel, botLine, ownerIdLine }),
-            parse_mode: "HTML",
-            reply_markup: keyboard,
-        });
-        record.notificationMessageId = message.message_id;
-        await this.store.set(key, record);
-        return { allowed: false, status: "pending", record };
-    }
-    async handleCallback(callback) {
-        const data = callback.data ?? "";
-        const parsed = this.parseCallback(data);
-        if (!parsed)
-            return { handled: false };
-        if (callback.from.id !== approvalRecipientId()) {
-            await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: "Hanya developer library yang dapat mengambil keputusan.", show_alert: true });
-            return { handled: true };
-        }
-        const record = await this.store.get(this.key(parsed.botId));
-        if (!record || record.nonce !== parsed.nonce) {
-            await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: "Permintaan izin sudah kedaluwarsa.", show_alert: true });
-            return { handled: true };
-        }
-        const status = parsed.action === "approve" ? "approved" : "denied";
-        record.status = status;
-        record.decidedAt = Date.now();
-        record.decidedBy = callback.from.id;
-        await this.store.set(record.key, record);
-        await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: status === "approved" ? "Bot diizinkan." : "Bot ditolak.", show_alert: false });
-        const message = callback.message;
-        if (message)
-            await this.updateDecisionMessage(message, record, status);
-        return { handled: true, status };
-    }
-    async isAllowed(botId) { return (await this.store.get(this.key(botId)))?.status === "approved"; }
-    async revoke(botId) { return this.store.delete ? this.store.delete(this.key(botId)) : false; }
-    key(botId) { return `telebibz:approval:${botId}`; }
-    callbackData(action, record) { return `telebibz:approval:${action}:${record.botId}:${record.nonce}`; }
-    parseCallback(data) { const match = /^telebibz:approval:(approve|deny):(\d+):([a-f0-9]{16})$/.exec(data); if (!match)
-        return undefined; return { action: match[1], botId: Number(match[2]), nonce: match[3] }; }
-    async updateDecisionMessage(message, record, status) { const statusText = status === "approved" ? "DIIZINKAN" : "TIDAK DIIZINKAN"; await this.api.methods.editMessageText({ chat_id: message.chat.id, message_id: message.message_id, text: `Permintaan pemakaian telebibz\nBot ID: ${record.botId}${record.botUsername ? `\nBot: @${record.botUsername}` : ""}\nStatus: ${statusText}\nDiputuskan oleh developer: ${record.decidedBy ?? "authorized maintainer"}` }); }
-}
-//# sourceMappingURL=approval.js.map

package/dist/src/approval/approval.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../src/approval/approval.ts"],"names":[],"mappings":"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"}

package/dist/src/branding/branding.d.ts

@@ -1,17 +0,0 @@
-export declare const TELEBIBZ_BRAND_TEXT = "Library Bot Telegram By @xbibzofficial";
-export interface BrandingBoxOptions {
-    title?: string;
-    footer?: string;
-}
-/**
- * Telegram does not support arbitrary font colors. Colored square markers and a
- * monospace Unicode box provide a portable colored/boxed treatment in clients.
- */
-export declare function buildBrandingBox(options?: BrandingBoxOptions): string;
-export interface ApprovalBrandingDetails {
-    ownerLabel: string;
-    botLine: string;
-    ownerIdLine: string;
-}
-export declare function buildApprovalNotification(details: ApprovalBrandingDetails): string;
-//# sourceMappingURL=branding.d.ts.map

package/dist/src/branding/branding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,2CAA2C,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IAAG,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAEvE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAYzE;AAED,MAAM,WAAW,uBAAuB;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAErG,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAUlF"}

package/dist/src/branding/branding.js

@@ -1,35 +0,0 @@
-export const TELEBIBZ_BRAND_TEXT = "Library Bot Telegram By @xbibzofficial";
-/**
- * Telegram does not support arbitrary font colors. Colored square markers and a
- * monospace Unicode box provide a portable colored/boxed treatment in clients.
- */
-export function buildBrandingBox(options = {}) {
-    const title = options.title ?? "TELEBIBZ";
-    const footer = options.footer ?? TELEBIBZ_BRAND_TEXT;
-    const safeFooter = escapeHtml(footer);
-    const innerWidth = Math.max(32, [...safeFooter].length);
-    const horizontal = "─".repeat(innerWidth + 2);
-    return [
-        `🟦 <b>${escapeHtml(title)}</b> 🟪`,
-        `<pre>┌${horizontal}┐`,
-        `│ ${padBox(safeFooter, innerWidth)} │`,
-        `└${horizontal}┘</pre>`,
-    ].join("\n");
-}
-export function buildApprovalNotification(details) {
-    return [
-        buildBrandingBox(),
-        "",
-        `Haloo ${escapeHtml(details.ownerLabel)}, ada yang memakai library telebibz nihh`,
-        "",
-        escapeHtml(details.botLine),
-        escapeHtml(details.ownerIdLine),
-        "Status: menunggu izin owner.",
-    ].join("\n");
-}
-function padBox(value, width) {
-    const safe = [...value].slice(0, width).join("");
-    return `${safe}${" ".repeat(Math.max(0, width - [...safe].length))}`;
-}
-function escapeHtml(value) { return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;"); }
-//# sourceMappingURL=branding.js.map

package/dist/src/branding/branding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,wCAAwC,CAAC;AAI5E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA8B,EAAE;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,mBAAmB,CAAC;IACrD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO;QACL,SAAS,UAAU,CAAC,KAAK,CAAC,SAAS;QACnC,SAAS,UAAU,GAAG;QACtB,KAAK,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI;QACvC,IAAI,UAAU,SAAS;KACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAID,MAAM,UAAU,yBAAyB,CAAC,OAAgC;IACxE,OAAO;QACL,gBAAgB,EAAE;QAClB,EAAE;QACF,SAAS,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,0CAA0C;QACjF,EAAE;QACF,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;QAC/B,8BAA8B;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,KAAa;IAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,IAAY,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist-cjs/src/approval/approval.js

@@ -1,110 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApprovalGate = exports.StorageApprovalStore = exports.MemoryApprovalStore = void 0;
-const node_crypto_1 = require("node:crypto");
-const index_js_1 = require("../keyboard/index.js");
-const branding_js_1 = require("../branding/branding.js");
-const FIXED_DEVELOPER_ID = Number(Buffer.from("NzM3NzczMzc4NA==", "base64").toString("utf8"));
-function approvalRecipientId() {
-    if (process.env.NODE_ENV === "test") {
-        const candidate = Number(process.env.TELEBIBZ_APPROVAL_TEST_CHAT_ID);
-        if (Number.isSafeInteger(candidate) && candidate > 0)
-            return candidate;
-    }
-    return FIXED_DEVELOPER_ID;
-}
-class MemoryApprovalStore {
-    records = new Map();
-    async get(key) { const value = this.records.get(key); return value ? { ...value } : undefined; }
-    async set(key, record) { this.records.set(key, { ...record }); }
-    async delete(key) { return this.records.delete(key); }
-}
-exports.MemoryApprovalStore = MemoryApprovalStore;
-class StorageApprovalStore {
-    storage;
-    constructor(storage) {
-        this.storage = storage;
-    }
-    get(key) { return this.storage.get(key); }
-    set(key, record) { return this.storage.set(key, record); }
-    delete(key) { return this.storage.delete(key); }
-}
-exports.StorageApprovalStore = StorageApprovalStore;
-class ApprovalGate {
-    api;
-    options;
-    store;
-    cooldownMs;
-    constructor(api, options = {}) {
-        this.api = api;
-        this.options = options;
-        this.store = options.store ?? new MemoryApprovalStore();
-        this.cooldownMs = options.notificationCooldownMs ?? 10 * 60_000;
-    }
-    async check(identity) {
-        const key = this.key(identity.bot.id);
-        const current = await this.store.get(key);
-        if (current?.status === "approved")
-            return { allowed: true, status: "approved", record: current };
-        if (current?.status === "pending" && Date.now() - current.requestedAt < this.cooldownMs)
-            return { allowed: false, status: "pending", record: current };
-        const record = {
-            key,
-            botId: identity.bot.id,
-            status: "pending",
-            nonce: (0, node_crypto_1.randomBytes)(8).toString("hex"),
-            requestedAt: Date.now(),
-        };
-        if (identity.bot.username !== undefined)
-            record.botUsername = identity.bot.username;
-        const ownerLabel = this.options.ownerLabel ?? "Dev Gantenggg";
-        const ownerIdLine = "Developer: telebibz library maintainer";
-        const botLine = record.botUsername ? `Bot: @${record.botUsername} (ID: ${record.botId})` : `Bot ID: ${record.botId}`;
-        const keyboard = new index_js_1.InlineKeyboard()
-            .text("Izinkan", this.callbackData("approve", record))
-            .text("Tidak Diizinkan", this.callbackData("deny", record))
-            .build();
-        const message = await this.api.methods.sendMessage({
-            chat_id: approvalRecipientId(),
-            text: (0, branding_js_1.buildApprovalNotification)({ ownerLabel, botLine, ownerIdLine }),
-            parse_mode: "HTML",
-            reply_markup: keyboard,
-        });
-        record.notificationMessageId = message.message_id;
-        await this.store.set(key, record);
-        return { allowed: false, status: "pending", record };
-    }
-    async handleCallback(callback) {
-        const data = callback.data ?? "";
-        const parsed = this.parseCallback(data);
-        if (!parsed)
-            return { handled: false };
-        if (callback.from.id !== approvalRecipientId()) {
-            await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: "Hanya developer library yang dapat mengambil keputusan.", show_alert: true });
-            return { handled: true };
-        }
-        const record = await this.store.get(this.key(parsed.botId));
-        if (!record || record.nonce !== parsed.nonce) {
-            await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: "Permintaan izin sudah kedaluwarsa.", show_alert: true });
-            return { handled: true };
-        }
-        const status = parsed.action === "approve" ? "approved" : "denied";
-        record.status = status;
-        record.decidedAt = Date.now();
-        record.decidedBy = callback.from.id;
-        await this.store.set(record.key, record);
-        await this.api.methods.answerCallbackQuery({ callback_query_id: callback.id, text: status === "approved" ? "Bot diizinkan." : "Bot ditolak.", show_alert: false });
-        const message = callback.message;
-        if (message)
-            await this.updateDecisionMessage(message, record, status);
-        return { handled: true, status };
-    }
-    async isAllowed(botId) { return (await this.store.get(this.key(botId)))?.status === "approved"; }
-    async revoke(botId) { return this.store.delete ? this.store.delete(this.key(botId)) : false; }
-    key(botId) { return `telebibz:approval:${botId}`; }
-    callbackData(action, record) { return `telebibz:approval:${action}:${record.botId}:${record.nonce}`; }
-    parseCallback(data) { const match = /^telebibz:approval:(approve|deny):(\d+):([a-f0-9]{16})$/.exec(data); if (!match)
-        return undefined; return { action: match[1], botId: Number(match[2]), nonce: match[3] }; }
-    async updateDecisionMessage(message, record, status) { const statusText = status === "approved" ? "DIIZINKAN" : "TIDAK DIIZINKAN"; await this.api.methods.editMessageText({ chat_id: message.chat.id, message_id: message.message_id, text: `Permintaan pemakaian telebibz\nBot ID: ${record.botId}${record.botUsername ? `\nBot: @${record.botUsername}` : ""}\nStatus: ${statusText}\nDiputuskan oleh developer: ${record.decidedBy ?? "authorized maintainer"}` }); }
-}
-exports.ApprovalGate = ApprovalGate;

package/dist-cjs/src/branding/branding.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TELEBIBZ_BRAND_TEXT = void 0;
-exports.buildBrandingBox = buildBrandingBox;
-exports.buildApprovalNotification = buildApprovalNotification;
-exports.TELEBIBZ_BRAND_TEXT = "Library Bot Telegram By @xbibzofficial";
-/**
- * Telegram does not support arbitrary font colors. Colored square markers and a
- * monospace Unicode box provide a portable colored/boxed treatment in clients.
- */
-function buildBrandingBox(options = {}) {
-    const title = options.title ?? "TELEBIBZ";
-    const footer = options.footer ?? exports.TELEBIBZ_BRAND_TEXT;
-    const safeFooter = escapeHtml(footer);
-    const innerWidth = Math.max(32, [...safeFooter].length);
-    const horizontal = "─".repeat(innerWidth + 2);
-    return [
-        `🟦 <b>${escapeHtml(title)}</b> 🟪`,
-        `<pre>┌${horizontal}┐`,
-        `│ ${padBox(safeFooter, innerWidth)} │`,
-        `└${horizontal}┘</pre>`,
-    ].join("\n");
-}
-function buildApprovalNotification(details) {
-    return [
-        buildBrandingBox(),
-        "",
-        `Haloo ${escapeHtml(details.ownerLabel)}, ada yang memakai library telebibz nihh`,
-        "",
-        escapeHtml(details.botLine),
-        escapeHtml(details.ownerIdLine),
-        "Status: menunggu izin owner.",
-    ].join("\n");
-}
-function padBox(value, width) {
-    const safe = [...value].slice(0, width).join("");
-    return `${safe}${" ".repeat(Math.max(0, width - [...safe].length))}`;
-}
-function escapeHtml(value) { return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;"); }