public/assets/js/module-remote-support.js - develop - mikopbx/ModuleRemoteSupport

public/assets/js/module-remote-support.js
305 строк42 KB
Nikolai Beketov
feat: add engineer web admin access via Warpgate (lobby v2)
25 июл 2026, 09:25
25 июл 2026, 09:2516c0fc0
"use strict";

/* global $, globalTranslate, navigator, document */

/**
 * Remote support session page.
 * @module moduleRemoteSupport
 */
var moduleRemoteSupport = {
  API_URL: '/pbxcore/api/v3/module-remote-support/session',
  POLL_INTERVAL_MS: 1000,
  KNOWN_STATES: ['off', 'starting', 'active', 'stopping', 'error'],
  SUMMARY_CLASSES: ['remote-support-summary-grey', 'remote-support-summary-green', 'remote-support-summary-yellow', 'remote-support-summary-red'],
  SUMMARY_CLASS_BY_STATE: {
    off: 'remote-support-summary-grey',
    starting: 'remote-support-summary-yellow',
    active: 'remote-support-summary-green',
    stopping: 'remote-support-summary-yellow',
    error: 'remote-support-summary-red'
  },
  pollTimer: null,
  current: null,
  $views: null,
  $summary: null,
  $live: null,
  $code: null,
  $countdown: null,
  $error: null,
  $webAccess: null,
  $webLogin: null,
  $webPassword: null,

  /**
   * Initialize cached elements, handlers, and initial state loading.
   * @returns {void}
   */
  initialize: function initialize() {
    moduleRemoteSupport.$views = $('[data-state-view]');
    moduleRemoteSupport.$summary = $('#remote-support-summary');
    moduleRemoteSupport.$live = $('#remote-support-live');
    moduleRemoteSupport.$code = $('#remote-support-code');
    moduleRemoteSupport.$countdown = $('#remote-support-countdown');
    moduleRemoteSupport.$error = $('#remote-support-error');
    moduleRemoteSupport.$webAccess = $('#remote-support-web-access');
    moduleRemoteSupport.$webLogin = $('#remote-support-web-login');
    moduleRemoteSupport.$webPassword = $('#remote-support-web-password');
    $('#remote-support-start, #remote-support-retry').on('click', function () {
      moduleRemoteSupport.mutate('start');
    });
    $('#remote-support-stop').on('click', function () {
      moduleRemoteSupport.mutate('stop');
    });
    $('#remote-support-copy').on('click', function () {
      moduleRemoteSupport.copyValue(moduleRemoteSupport.current ? moduleRemoteSupport.current.code : '');
    });
    $('#remote-support-web-copy-login').on('click', function () {
      moduleRemoteSupport.copyValue(moduleRemoteSupport.current ? moduleRemoteSupport.current.webLogin : '');
    });
    $('#remote-support-web-copy-password').on('click', function () {
      moduleRemoteSupport.copyValue(moduleRemoteSupport.current ? moduleRemoteSupport.current.webPassword : '');
    });
    moduleRemoteSupport.loadStatus();
  },

  /**
   * Load the authenticated server state.
   * @returns {void}
   */
  loadStatus: function loadStatus() {
    moduleRemoteSupport.request('GET', moduleRemoteSupport.API_URL);
  },

  /**
   * Request a state mutation.
   * @param {string} action - Allowlisted API action.
   * @returns {void}
   */
  mutate: function mutate(action) {
    if (!['start', 'stop'].includes(action)) {
      return;
    }

    moduleRemoteSupport.disableActions(true);
    moduleRemoteSupport.request('POST', "".concat(moduleRemoteSupport.API_URL, ":").concat(action));
  },

  /**
   * Perform a same-origin JSON request.
   * @param {string} method - HTTP method.
   * @param {string} url - Fixed module API URL.
   * @returns {void}
   */
  request: function request(method, url) {
    $.ajax({
      url: url,
      method: method,
      dataType: 'json',
      contentType: 'application/json'
    }).done(function (response) {
      if (response && response.result === true && response.data) {
        moduleRemoteSupport.render(response.data);
        return;
      }

      moduleRemoteSupport.renderSafeError('rest_error_internal');
    }).fail(function () {
      moduleRemoteSupport.renderSafeError('rest_error_network');
    }).always(function () {
      moduleRemoteSupport.disableActions(false);
    });
  },

  /**
   * Render a normalized server state.
   * @param {Object} data - Normalized session response.
   * @returns {void}
   */
  render: function render(data) {
    var state = moduleRemoteSupport.KNOWN_STATES.includes(data.state) ? data.state : 'error';
    moduleRemoteSupport.current = {
      state: state,
      code: typeof data.code === 'string' ? data.code : '',
      expiresAt: Number.isInteger(data.expiresAt) ? data.expiresAt : 0,
      errorCode: typeof data.errorCode === 'string' ? data.errorCode : '',
      webLogin: typeof data.webLogin === 'string' ? data.webLogin : '',
      webPassword: typeof data.webPassword === 'string' ? data.webPassword : ''
    };
    moduleRemoteSupport.$views.prop('hidden', true);
    $("[data-state-view=\"".concat(state, "\"]")).prop('hidden', false);
    moduleRemoteSupport.renderSummary(state);
    moduleRemoteSupport.$code.text(moduleRemoteSupport.current.code);
    moduleRemoteSupport.$error.text(moduleRemoteSupport.errorLabel(moduleRemoteSupport.current.errorCode));
    moduleRemoteSupport.renderWebAccess();
    moduleRemoteSupport.updateCountdown();
    moduleRemoteSupport.schedulePolling(state);
  },

  /**
   * Show the ephemeral web credential only while it exists on an active session.
   * @returns {void}
   */
  renderWebAccess: function renderWebAccess() {
    var hasWebAccess = moduleRemoteSupport.current && moduleRemoteSupport.current.state === 'active' && moduleRemoteSupport.current.webLogin !== '';
    moduleRemoteSupport.$webAccess.prop('hidden', !hasWebAccess);

    if (!hasWebAccess) {
      moduleRemoteSupport.$webLogin.text('');
      moduleRemoteSupport.$webPassword.text('');
      return;
    }

    moduleRemoteSupport.$webLogin.text(moduleRemoteSupport.current.webLogin);
    moduleRemoteSupport.$webPassword.text(moduleRemoteSupport.current.webPassword);
  },

  /**
   * Render the localized status and its calm color indicator.
   * @param {string} state - Current allowlisted state.
   * @returns {void}
   */
  renderSummary: function renderSummary(state) {
    moduleRemoteSupport.$summary.removeClass(moduleRemoteSupport.SUMMARY_CLASSES.join(' ')).addClass(moduleRemoteSupport.SUMMARY_CLASS_BY_STATE[state]);
    moduleRemoteSupport.$live.text(moduleRemoteSupport.stateLabel(state));
  },

  /**
   * Poll only while the server owns an in-flight or active session.
   * @param {string} state - Current allowlisted state.
   * @returns {void}
   */
  schedulePolling: function schedulePolling(state) {
    if (moduleRemoteSupport.pollTimer !== null) {
      window.clearTimeout(moduleRemoteSupport.pollTimer);
      moduleRemoteSupport.pollTimer = null;
    }

    if (['starting', 'active', 'stopping'].includes(state)) {
      moduleRemoteSupport.pollTimer = window.setTimeout(function () {
        return moduleRemoteSupport.loadStatus();
      }, moduleRemoteSupport.POLL_INTERVAL_MS);
    }
  },

  /**
   * Render the remaining fixed session duration.
   * @returns {void}
   */
  updateCountdown: function updateCountdown() {
    if (!moduleRemoteSupport.current || moduleRemoteSupport.current.state !== 'active') {
      moduleRemoteSupport.$countdown.text('');
      return;
    }

    var remaining = Math.max(0, moduleRemoteSupport.current.expiresAt - Math.floor(Date.now() / 1000));
    var hours = Math.floor(remaining / 3600);
    var minutes = Math.floor(remaining % 3600 / 60);
    var seconds = remaining % 60;
    var time = [hours, minutes, seconds].map(function (part) {
      return String(part).padStart(2, '0');
    }).join(':');
    moduleRemoteSupport.$countdown.text(globalTranslate.module_remote_support_Countdown.replace('%time%', time));
  },

  /**
   * Copy a value without placing it in a URL or log.
   * @param {string} value - Sensitive value to copy.
   * @returns {void}
   */
  copyValue: function copyValue(value) {
    if (typeof value !== 'string' || value === '') {
      return;
    }

    if (navigator.clipboard && navigator.clipboard.writeText) {
      navigator.clipboard.writeText(value).then(function () {
        moduleRemoteSupport.$live.text(globalTranslate.module_remote_support_Copied);
      })["catch"](function () {
        moduleRemoteSupport.copyWithFallback(value);
      });
      return;
    }

    moduleRemoteSupport.copyWithFallback(value);
  },

  /**
   * Copy through a temporary, non-visible textarea.
   * @param {string} value - Sensitive value to copy.
   * @returns {void}
   */
  copyWithFallback: function copyWithFallback(value) {
    var $temporary = $('<textarea>').val(value).attr('readonly', true).css({
      position: 'fixed',
      left: '-9999px'
    });
    $('body').append($temporary);
    $temporary.trigger('select');
    document.execCommand('copy');
    $temporary.remove();
    moduleRemoteSupport.$live.text(globalTranslate.module_remote_support_Copied);
  },

  /**
   * Render a safe client-side error state.
   * @param {string} safeCode - Translation key returned by local logic.
   * @returns {void}
   */
  renderSafeError: function renderSafeError(safeCode) {
    moduleRemoteSupport.render({
      state: 'error',
      errorCode: safeCode
    });
  },

  /**
   * Resolve a localized state label.
   * @param {string} state - Allowlisted state.
   * @returns {string} Localized state label.
   */
  stateLabel: function stateLabel(state) {
    var labels = {
      off: globalTranslate.module_remote_support_StateOff,
      starting: globalTranslate.module_remote_support_StateStarting,
      active: globalTranslate.module_remote_support_StateActive,
      stopping: globalTranslate.module_remote_support_StateStopping,
      error: globalTranslate.module_remote_support_StateError
    };
    return labels[state];
  },

  /**
   * Resolve only allowlisted safe error codes.
   * @param {string} safeCode - Server-safe error code.
   * @returns {string} Localized message.
   */
  errorLabel: function errorLabel(safeCode) {
    var errors = {
      preflight_failed: globalTranslate.module_remote_support_ErrorPreflight,
      runtime_failed: globalTranslate.module_remote_support_ErrorRuntime,
      allocation_failed: globalTranslate.module_remote_support_ErrorAllocation,
      key_install_failed: globalTranslate.module_remote_support_ErrorKeyInstall,
      web_credential_failed: globalTranslate.module_remote_support_ErrorWebCredential,
      tunnel_start_failed: globalTranslate.module_remote_support_ErrorTunnelStart,
      tunnel_not_established: globalTranslate.module_remote_support_ErrorTunnelStart,
      tunnel_disconnected: globalTranslate.module_remote_support_ErrorDisconnected,
      cleanup_failed: globalTranslate.module_remote_support_ErrorCleanup,
      rest_error_network: globalTranslate.module_remote_support_ErrorNetwork,
      rest_error_internal: globalTranslate.module_remote_support_ErrorInternal
    };
    return errors[safeCode] || globalTranslate.module_remote_support_ErrorInternal;
  },

  /**
   * Toggle mutation controls during a request.
   * @param {boolean} disabled - Whether actions are disabled.
   * @returns {void}
   */
  disableActions: function disableActions(disabled) {
    $('#remote-support-start, #remote-support-stop, #remote-support-retry').toggleClass('loading disabled', disabled).prop('disabled', disabled);
  }
};
$(document).ready(function () {
  moduleRemoteSupport.initialize();
});
//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbInNyYy9tb2R1bGUtcmVtb3RlLXN1cHBvcnQuanMiXSwibmFtZXMiOlsibW9kdWxlUmVtb3RlU3VwcG9ydCIsIkFQSV9VUkwiLCJQT0xM … [Строка слишком длинная. Вы можете скачать файл]