Service Detail Hooks

Hook::add('filter:service.detail_data', 10, function (&$data, $service) {
    // Add your own data without disturbing the keys already there.
    $data['acme_health'] = Acme::health((int) ($service['id'] ?? 0));
});

Hook::add('filter:service.dashboard.cards', 10, function (&$cards, $module) {
    // Put your card where it belongs rather than at the end.
    array_splice($cards, 1, 0, [Acme::usageCard()]);
});

Hook::add('filter:service.dashboard.tools', 10, function (&$tools, $module) {
    // The list IS GROUPED: reach the tools inside a group.
    foreach ($tools as &$group)
        $group['tools'] = array_filter($group['tools'] ?? [],
            fn ($t) => ($t['key'] ?? '') !== 'rebuild');
});

Hook::add('filter:service.detail_tabs_capabilities', 10,
    function (&$capabilities, $service, $module) {
        if ($module === null) return;                 // a domain with no module

        // Switching a mark off hides that tab on the screen.
        $capabilities['has_email_forwarding'] = Acme::mailAllowed($service);
    });

Hook::add('action:service.addon.created', 10,
    function ($addonRecordId, $serviceId, $addonId, $invoiceId, $totalAmount) {
        // An addonId of 0 marks a DOMAIN add-on, not a product.
        if ($addonId === 0) return;

        Crm::addonSold($serviceId, $addonId, (float) $totalAmount);
    });

Hook::add('action:service.addon.status_changed', 10, function ($payload) {
    // ONE array arrives; the old and new status sit inside it.
    if (($payload['new_status'] ?? '') === 'suspended')
        Acme::addonOff((int) ($payload['addon_id'] ?? 0));
});

Hook::add('gate:service.metric_toggle', 10,
    function ($service, $metricKey, $enable, $label) {
        // The label arrives ready: write the message with the name they see.
        if (!$enable && Acme::metricRequired($metricKey))
            return $label . ' cannot be switched off.';

        return null;
    });

Hook::add('action:service.metric_toggled', 10, function ($service, $metricKey, $enable) {
    // A metric switched off can still be billed: set your own counter.
    Acme::metricState((int) ($service['id'] ?? 0), $metricKey, (bool) $enable);
});

Hook::add('action:service.detail.viewed', 10, function ($service, $serviceId) {
    // Keep it light: the customer is waiting for the page.
    Acme::touchLastSeen($serviceId);
});

Hook::add('action:service.viewed', 10, function ($service, $service_id) {
    // Pull the live status from the remote panel ahead of time.
    Acme::prefetchStatus($service_id);
});

Hook::add('gate:service.file_download', 10, function ($kind, $ctx) {
    if ($kind !== 'package') return null;

    // Block when the quota is used up; no reason reaches the screen, so log it.
    if (Acme::quotaExceeded((int) ($ctx['user_id'] ?? 0))) {
        Acme::log('download quota used up', $ctx);
        return true;
    }

    return null;
});

Hook::add('filter:service.file_download.source', 10, function (&$source, &$ctx) {
    if (($ctx['kind'] ?? '') !== 'package') return;

    // Build a package with the install key inside, then have it removed.
    $source['path']    = Acme::buildPackage((int) ($ctx['service_id'] ?? 0));
    $source['name']    = 'acme-setup.zip';
    $source['cleanup'] = true;
});

Hook::add('gate:service.billing_profile_assign', 10,
    function ($service, $profileId, $uid) {
        // Do not allow profile changes while an account is frozen.
        if (Acme::frozen($uid)) return 'Your account is under review, so this cannot change.';

        return null;
    });

Hook::add('action:service.billing_profile_assigned', 10,
    function ($service, $profileId, $profileName, $uid) {
        Acme::syncAccounting((int) ($service['id'] ?? 0), $profileId);
    });