PHPackages                             morfeditorial/machinima-telegram-adapter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication & Authorization](/categories/authentication)
4. /
5. morfeditorial/machinima-telegram-adapter

ActiveSymfony-bundle[Authentication & Authorization](/categories/authentication)

morfeditorial/machinima-telegram-adapter
========================================

Telegram platform adapter for the Machinima core app.

014PHPCI passing

Since Jul 25Pushed 1mo agoCompare

[ Source](https://github.com/morfeditorial/machinima-telegram-adapter)[ Packagist](https://packagist.org/packages/morfeditorial/machinima-telegram-adapter)[ RSS](/packages/morfeditorial-machinima-telegram-adapter/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (1)Used By (0)

[![Morf Editorial](assets/images/morf-logo.svg)](assets/images/morf-logo.svg)machinima-telegram-adapter
==========================

[](#machinima-telegram-adapter)

*Telegram platform adapter for the Machinima platform.*

[![Latest Stable Version](https://camo.githubusercontent.com/f41114d4b53e64e810f4845b44b287d04a48c39108d21147cba0cd64872513b4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f7266656469746f7269616c2f6d616368696e696d612d74656c656772616d2d616461707465722e7376673f6c6162656c3d5061636b6167697374266c6f676f3d7061636b6167697374)](https://packagist.org/packages/morfeditorial/machinima-telegram-adapter)[![Total Downloads](https://camo.githubusercontent.com/0dd7dc829fcf5df663a2727f74000eb5d79ce09fdcd5fde2bf0d8b179c734abb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f7266656469746f7269616c2f6d616368696e696d612d74656c656772616d2d616461707465722e7376673f6c6162656c3d446f776e6c6f616473266c6f676f3d7061636b6167697374)](https://packagist.org/packages/morfeditorial/machinima-telegram-adapter)[![License](https://camo.githubusercontent.com/4eb2185501f9eb1d9e816c245094b840ee34e817ce27ea7d0594002554a8fa37/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6f7266656469746f7269616c2f6d616368696e696d612d74656c656772616d2d616461707465722e7376673f6c6162656c3d4c6963656e6365266c6f676f3d6f70656e2d736f757263652d696e6974696174697665)](https://packagist.org/packages/morfeditorial/machinima-telegram-adapter)

[Architecture](#architecture) · [Env vars](#env-vars) · [Contributing](#contributing)

---

**machinima-telegram-adapter** is a Symfony bundle that implements the platform-specific integration between the Machinima core and the Telegram WebApp surface. It enables seamless zero-click authentication, UI hints processing, and native Telegram notification delivery by satisfying the core platform contracts.

Architecture
------------

[](#architecture)

Provides the platform-specific implementations of the core `Morfeditorial\MachinimaCoreBundle\Contract\*` ports:

- `Morfeditorial\MachinimaCoreBundle\Contract\PlatformAdapterInterface` → `Morfeditorial\MachinimaTelegramAdapter\TelegramPlatformAdapter`
    - bootstrap module (`Resources/public/js/telegram-bootstrap.js`) — client-side zero-click detection, posted to core's `/api/auth/bootstrap`
    - UI-hints module (`Resources/public/js/telegram-ui-hints.js`) — theme/back-button, only loaded for an already-authenticated Telegram session
- `Morfeditorial\MachinimaCoreBundle\Contract\IdentityProviderPort` (two, deliberately under different registry names — see `MiniApp\TelegramMiniAppIdentityProvider` docblock):
    - `telegram` → `Oidc\TelegramOidcProvider` (OAuth-button login, validates an id\_token)
    - `telegram_mini_app` → `MiniApp\TelegramMiniAppIdentityProvider` (zero-click, validates raw Mini App `initData`; hidden from `/login` via `BootstrapOnlyIdentityProvider`)
- `Morfeditorial\MachinimaCoreBundle\Contract\UserNotificationAddressResolver` → `Morfeditorial\MachinimaTelegramAdapter\Notification\TelegramNotificationAddressResolver`
- `Morfeditorial\MachinimaCoreBundle\Contract\NotificationChannelPort` → `Morfeditorial\MachinimaTelegramAdapter\Notification\TelegramNotificationService`
- `Morfeditorial\MachinimaCoreBundle\Event\UserAuthenticatedEvent` bridge from `Morfeditorial\TelegramBotBundle\Event\TelegramUserAuthenticatedEvent` → `Morfeditorial\MachinimaTelegramAdapter\EventSubscriber\TelegramToIdentityBridge` (used by the Telegram *bot*, i.e. chat commands — unrelated to Mini App zero-click login)

The adapter is loaded by the host application only when the active `APP_PROFILE` requires Telegram capabilities (e.g. `telegram-webapp` or `telegram-bot`). Core profiles (`core-only`) must not import any class from this package.

Env vars
--------

[](#env-vars)

- `TELEGRAM_BOT_TOKEN` — used both by `telegram-bot-bundle` and by `TelegramMiniAppIdentityProvider` to verify Mini App `initData` signatures.
- `TELEGRAM_OIDC_CLIENT_ID` / `TELEGRAM_OIDC_CLIENT_SECRET` / `TELEGRAM_OIDC_REDIRECT_URI` — OAuth-button login only.

Contributing
------------

[](#contributing)

Contributions are welcome and appreciated! Here's how you can contribute:

1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

Please make sure to update tests as appropriate and adhere to the existing coding style.

License
-------

[](#license)

This bundle is licensed under the CSSM Unlimited License v2.0 (CSSM-ULv2). See the [LICENSE](LICENSE) file for details.

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance61

Regular maintenance activity

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 98.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/e2471bdadcf4a5ea969fe763a72d03fb46525b59a7e4cedc3ed4d855029e7785?d=identicon)[ChernegaSergiy](/maintainers/ChernegaSergiy)

---

Top Contributors

[![ChernegaSergiy](https://avatars.githubusercontent.com/u/60980650?v=4)](https://github.com/ChernegaSergiy "ChernegaSergiy (90 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

authenticationmachinimamorf-editorialphpphp8symfonysymfony-bundletelegram-apitelegram-bottelegram-web-app

### Embed Badge

![Health badge](/badges/morfeditorial-machinima-telegram-adapter/health.svg)

```
[![Health](https://phpackages.com/badges/morfeditorial-machinima-telegram-adapter/health.svg)](https://phpackages.com/packages/morfeditorial-machinima-telegram-adapter)
```

###  Alternatives

[tg/tgwebvalid

An easy way to validate Telegram Login Widget and Telegram Mini App users on your website using PHP

6828.9k1](/packages/tg-tgwebvalid)[vitalybaev/laravel5-dkim

Laravel 5/6 package for signing outgoing messages with DKIM.

3163.1k](/packages/vitalybaev-laravel5-dkim)[mehdibo/codeigniter-recaptcha

CodeIgniter library to use Google's reCAPTCHA V2

284.1k](/packages/mehdibo-codeigniter-recaptcha)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)