Personel Bildirimi (notify.staff) ⏳ Yakında

import { RestomenumClient } from '@restomenum/plugin-sdk';   // v1.10.0+

// TÜKETİCİ (scope: capability:notify.staff:consume) — jenerik capability yolu.
// Sonuç tipi (NotifyStaffResult) capability id'den OTOMATİK türer; elle <> tip argümanı GEREKMEZ.
const r = await client.capabilities.invoke('notify.staff', {
  to: { role: 'manager' },              // { role: 'manager'|'staff' } VEYA { userId } (en az biri)
  title: 'Stok uyarısı',
  body: 'Domates kritik seviyede (2 kg).',
  idempotencyKey: `stock-alert-${date}`,  // ZORUNLU — çift bildirim koruması
});
// r = { requestId, status: 'accepted'|'sent'|'failed', providerMessageId?, idempotentReplay? }
// Sağlayıcı bağlı değilse ApiError('plugin.notify.noProvider', 424) → özelliği gizle.

import { verifyAndParseCapability, capabilityResponse } from '@restomenum/plugin-sdk';
import type { NotifyStaffPayload } from '@restomenum/plugin-sdk';

// SAĞLAYICI (scope: capability:notify.staff:provide) — actionUrl'e gelen imzalı type:"capability" POST:
const req = await verifyAndParseCapability<NotifyStaffPayload>(rawBody, headers['x-restomenum-signature'], {
  getSecret: (tenantId) => installStore.find(tenantId)?.webhookSecret,   // webhook ile AYNI imza şeması
});
if (!req) return res.status(401).json({ error: 'invalid_signature' });
// ZORUNLU dedupe: aynı req.requestId tekrar gelirse YENİDEN GÖNDERME (önceki yanıtı dön).

// Hedefi ÇÖZ: { role|userId } — personel listesini KENDİ users:read'inle çek (rol→kullanıcı):
const { to, title, body } = req.payload;
// const users = await client.users.get();  // {role:'manager'} → authority filtrele; {userId} → doğrudan
// … push/Telegram/dahili ekran ile personele ilet …
res.json(capabilityResponse('accepted', { providerMessageId }));