README

Teleframe ⚡

Telegram power with almost zero friction — for PHP & Laravel.

One package for the whole Telegram surface: native MTProto 2.0 for users and bots, the Bot HTTP API, Mini App auth, Passport KYC, and — merged in as modules — the consumer layer (tenant-scoped Ingest, Redis stream Bus + daemon + backfill, encrypted backup vault) plus a one-class handler facade.

composer require merezarezaei/teleframe

One class composes everything

use MeRezaRezaei\Teleframe\Teleframe;

$teleframe = app(Teleframe::class);

$teleframe->onMessage(function ($update) use ($teleframe) {
    // every stored update reaches you through one pipeline
    $teleframe->send($update->accountId, ['random_id' => random_int(1, PHP_INT_MAX), 'text' => 'got it']);
});

• Teleframe — compose-not-own facade: ingest, ingestResponse, onMessage / on (route by constructor, zero-regex), run (fixtures through the REAL pipeline), user/chat/channel, route, backup, schemaLayer, send (writes the Q2d echo-elimination registry).
• Teleclient — the ingest-only public face, retained byte-stable.

What's inside

Docs: quickstart.md · index.md · php artisan teleframe:doctor.

Influence & credit

Teleframe draws heavily on the Nutgram-style handler ergonomics and follows the owner's unification design (see docs/superpowers/specs/). The original teleclient package that held the consumer layer is archived.

MIT licensed.