@closerclick/closer-click-notifications 0.2.0 → 0.3.0

package/README.md

@@ -153,6 +153,10 @@ receipts.start()
 await receipts.report({ toPubkey: parsed.publickey, url: sharedUrl, name: parsed.name })
 ```
 
+- **Acumular (referidos)**: pasá `onReceipt(env)` para que tu app sume por acuse
+  fresco (además de la notificación). Para enlaces de invitación con tu pubkey
+  embebida usá `packPubkey(pubkey)` → token base64url para `#i=<token>`, y
+  `unpackPubkey(token)` del lado que abre (matchea byte a byte el ruteo del proxy).
 - **Identidad del que abre**: el sobre incluye **siempre** `from { pubkey, nick }`.
 - **Anti-spam**: `report` aplica throttle por `(toPubkey|url)` (default 24h).
 - **Propio**: `report` es no-op si el contenido es tuyo (`toPubkey === tu pubkey`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@closerclick/closer-click-notifications",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Notificaciones compartidas del ecosistema Closer Click: controlador data-agnostic (permiso del navegador + preferencias por categoría con scope por app + disparo), el Web Component <closer-click-notifications> (panel de ajustes), helper de Web Push ligado al vault + proxy y acuses de apertura de contenido compartido (createShareReceipts). Autohosteado, Shadow DOM, sin JS de terceros ni cookies.",
   "type": "module",
   "main": "src/index.js",

package/src/index.d.ts

@@ -123,6 +123,8 @@ export interface ShareReceiptsConfig {
   throttleMs?: number
   /** Override del click (default: navegar a url). */
   onOpen?: (url: string, env: ShareReceiptEnvelope) => void
+  /** Hook por acuse fresco entrante (además de notificar): para acumular (referidos, etc.). */
+  onReceipt?: (env: ShareReceiptEnvelope) => void
 }
 
 export interface ShareReceipts {
@@ -140,6 +142,11 @@ export interface ShareReceipts {
 /** Motor común de acuses de apertura de contenido compartido. */
 export function createShareReceipts(cfg: ShareReceiptsConfig): ShareReceipts
 
+/** Empaqueta una pubkey (JWK string del vault) para un enlace de invitación/acuse (base64url exacto). */
+export function packPubkey(pubkey: string): string
+/** Desempaqueta la pubkey de un token de enlace. Devuelve null si es inválido. */
+export function unpackPubkey(token: string): string | null
+
 export class CloserClickNotifications extends HTMLElement {
   controller: NotificationsController | null
 }

package/src/index.js

@@ -314,6 +314,7 @@ export function createShareReceipts (cfg = {}) {
   const render = typeof cfg.render === 'function' ? cfg.render : null
   const lang = cfg.lang || 'auto'
   const throttleMs = cfg.throttleMs != null ? cfg.throttleMs : 24 * 60 * 60 * 1000
+  const onReceipt = typeof cfg.onReceipt === 'function' ? cfg.onReceipt : null
   const onOpen = typeof cfg.onOpen === 'function'
     ? cfg.onOpen
     : (url) => { try { if (isBrowser && url) location.assign(url) } catch (_) {} }
@@ -392,6 +393,9 @@ export function createShareReceipts (cfg = {}) {
     const key = `${(env.from && env.from.pubkey) || ''}|${env.url}|${env.ts || ''}`
     if (_seen.has(key)) return
     _seen.add(key)
+    // Hook para que la app ACUMULE (p. ej. referidos) además de notificar. Se
+    // llama una vez por acuse fresco; la app hace su propio dedup durable.
+    if (onReceipt) { try { onReceipt(env) } catch (_) {} }
     const rendered = render ? render(env) : _defaultRender(env)
     if (!rendered) return
     const { title, body, ...rest } = rendered
@@ -427,6 +431,34 @@ export function createShareReceipts (cfg = {}) {
   return { report, start, stop, category, RECEIPT_TAG, RECEIPT_VERSION }
 }
 
+/* ----------------------------------------------------------------------------
+ * Pubkey ↔ token compacto para enlaces de invitación/acuse.
+ *
+ * El acuse se enruta por la MISMA pubkey (JWK string) que el destinatario usó en
+ * `identify`. Para meterla en un enlace compartible (`#i=<token>`) la empaquetamos
+ * como base64url del string EXACTO (no comprimimos el punto P-256: así el ruteo
+ * por `sendByPubkey` matchea byte a byte sin reconstruir el JWK). Quien abre el
+ * enlace desempaqueta la pubkey del autor y le manda el acuse.
+ * --------------------------------------------------------------------------*/
+
+function _b64urlEncode (str) {
+  const bytes = new TextEncoder().encode(str);
+  let bin = ''; for (const b of bytes) bin += String.fromCharCode(b);
+  return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+function _b64urlDecode (s) {
+  const b64 = s.replace(/-/g, '+').replace(/_/g, '/');
+  const bin = atob(b64);
+  const bytes = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
+  return new TextDecoder().decode(bytes);
+}
+
+/** Empaqueta una pubkey (JWK string del vault) para un enlace: base64url exacto. */
+export function packPubkey (pubkey) { return _b64urlEncode(String(pubkey)); }
+/** Desempaqueta la pubkey de un token de enlace. Devuelve null si es inválido. */
+export function unpackPubkey (token) { try { return _b64urlDecode(String(token)); } catch (_) { return null; } }
+
 /* ============================================================================
  * 4) Web Component  ──  <closer-click-notifications>  (panel de ajustes)
  * ==========================================================================*/