<?php
/**
 * Broadcasting Support Class
 *
 * @version     1.0.0
 * @package     bplan-base/globals
 * @subpackage  Broadcasting
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 * @copyright   Copyright (C) 2025, 2026 bplan-solutions GmbH & Co. KG <https://www.bplan-solutions.de/>
 * /Δ\
 */

namespace BplanBase\Globals\Broadcasting;


/**
 * Zentrale Quelle für alle WebSocket-Channel-Namen.
 *
 * Präfixe werden von Laravel automatisch gesetzt:
 *   private-   = nur authentifizierte Clients
 *   presence-  = wie private, zeigt zusätzlich wer verbunden ist
 *
 * @version     1.0.0 / 2026-05-04
 * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
 */
class ChannelNames
{


/* +++ TRAITS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ CLASS CONSTANTS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT MEMBERS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ CLASS MEMBERS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ OBJECT METHODS +++ +++++++++++++++++++++++++++++++++++++++++++++++++++ */


/* +++ CLASS METHODS +++ ++++++++++++++++++++++++++++++++++++++++++++++++++++ */


    /**
     * Private channel for a specific terminal (Location with Kiosk sub-type).
     * Full channel name: private-terminal.{uuid}
     *
     * @param       string $locationUuid
     *
     * @return      string
     *
     * @version     1.0.0 / 2026-05-04
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public static function terminal(string $locationUuid): string
    {
        return 'terminal.'.$locationUuid;

    } // terminal()


    /**
     * Presence channel for all idle terminals.
     * Full channel name: presence-terminals.idle
     *
     * @return      string
     *
     * @version     1.0.0 / 2026-05-04
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public static function terminalsIdle(): string
    {
        return 'terminals.idle';

    } // terminalsIdle()


    /**
     * Private channel for the status of a specific print job.
     * Full channel name: private-print-job.{uuid}
     *
     * @param       string $printJobUuid
     *
     * @return      string
     *
     * @version     1.0.0 / 2026-05-04
     * @author      Wassilios Meletiadis <wassilios.meletiadis@bplan-solutions.de>
     */
    public static function printJob(string $printJobUuid): string
    {
        return 'print-job.'.$printJobUuid;

    } // printJob()


} // class ChannelNames {}
