@kehto/paja 0.5.1 → 0.6.3

package/dist/browser-host.js

@@ -243,7 +243,7 @@ function cvmMap(action) {
   return { senderCap: "cvm:call", recipientCap: null };
 }
 function outboxMap(action) {
-  if (action === "event" || action === "eose" || action === "closed" || action.endsWith(".result") || action.endsWith(".error")) {
+  if (action === "event" || action === "closed" || action.endsWith(".result") || action.endsWith(".error")) {
     return { senderCap: null, recipientCap: "outbox:read" };
   }
   if (action === "publish") return { senderCap: "outbox:write", recipientCap: null };
@@ -612,7 +612,7 @@ function deserialize2(json) {
   return defaultConfig();
 }
 
-// ../../node_modules/.pnpm/@napplet+core@0.25.0/node_modules/@napplet/core/dist/index.js
+// ../../node_modules/.pnpm/@napplet+core@0.27.0/node_modules/@napplet/core/dist/index.js
 function createDispatch() {
   const handlers = /* @__PURE__ */ new Map();
   function registerNap2(domain, handler) {
@@ -1079,6 +1079,41 @@ function createEventBuffer(sendToNapplet, sessionRegistry2, enforce, subscriptio
     }
   };
 }
+function stringList(value) {
+  if (!Array.isArray(value)) return void 0;
+  const out = [...new Set(value.filter((item) => typeof item === "string" && item.length > 0))];
+  return out.length > 0 ? out : void 0;
+}
+function sidecarFromUnknown(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const input = value;
+  const sidecar = {};
+  if (Array.isArray(input.resources) && input.resources.length > 0) sidecar.resources = input.resources;
+  const relayHints = stringList(input.relayHints);
+  if (relayHints) sidecar.relayHints = relayHints;
+  return sidecar.resources || sidecar.relayHints ? sidecar : void 0;
+}
+function createRelayEventResult(event, sidecar) {
+  const normalized = sidecarFromUnknown(sidecar);
+  return normalized ? { event, sidecar: normalized } : { event };
+}
+function createRelayEventResultWithHints(event, relayHints) {
+  return createRelayEventResult(event, relayHints && relayHints.length > 0 ? { relayHints } : void 0);
+}
+function relayEventResultFromCarrier(carrier) {
+  if (carrier.result && typeof carrier.result === "object") {
+    const result2 = carrier.result;
+    if (result2.event && typeof result2.event === "object") return createRelayEventResult(result2.event, result2.sidecar);
+  }
+  if (carrier.event && typeof carrier.event === "object") {
+    const sidecar = sidecarFromUnknown(carrier.sidecar) ?? sidecarFromUnknown({ resources: carrier.resources });
+    const relayHints = typeof carrier.relay === "string" && carrier.relay.length > 0 ? [carrier.relay] : void 0;
+    const merged = sidecar ? { ...sidecar } : {};
+    if (relayHints) merged.relayHints = relayHints;
+    return createRelayEventResult(carrier.event, merged);
+  }
+  return null;
+}
 function notifyServiceWindowDestroyed(windowId, services) {
   for (const handler of Object.values(services)) {
     try {
@@ -1119,6 +1154,15 @@ function relayServiceFrom(context) {
 function isShellKindQuery(filters) {
   return filters.length > 0 && filters.every((filter) => filter.kinds?.every((kind) => kind >= 29e3 && kind < 3e4));
 }
+function sendRelayEvent(hooks, windowId, subId, result2) {
+  hooks.sendToNapplet(windowId, { type: "relay.event", subId, result: result2 });
+}
+function normalizeRelayServiceResponse(resp) {
+  const m = resp;
+  if (m.type !== "relay.event") return resp;
+  const result2 = relayEventResultFromCarrier(m);
+  return result2 ? { type: "relay.event", subId: m.subId, result: result2 } : resp;
+}
 function handleRelaySubscribe(context, windowId, msg, m) {
   const { eventBuffer, hooks, serviceRegistry, subscriptions } = context;
   const subId = m.subId ?? "";
@@ -1127,11 +1171,11 @@ function handleRelaySubscribe(context, windowId, msg, m) {
   const subKey = `${windowId}:${subId}`;
   subscriptions.set(subKey, { windowId, filters });
   const seenIds = /* @__PURE__ */ new Set();
-  function deliver(event) {
+  function deliver(event, relayHints) {
     if (seenIds.has(event.id)) return;
     seenIds.add(event.id);
     if (subscriptions.has(subKey)) {
-      hooks.sendToNapplet(windowId, { type: "relay.event", subId, event });
+      sendRelayEvent(hooks, windowId, subId, createRelayEventResultWithHints(event, relayHints));
     }
   }
   for (const bufferedEvent of eventBuffer.getBufferedEvents()) {
@@ -1143,12 +1187,12 @@ function handleRelaySubscribe(context, windowId, msg, m) {
   if (!isShellKind && relayService) {
     relayService.handleMessage(windowId, msg, (resp) => {
       if (!subscriptions.has(subKey)) return;
-      hooks.sendToNapplet(windowId, resp);
+      hooks.sendToNapplet(windowId, normalizeRelayServiceResponse(resp));
     });
     if (cacheService) {
       cacheService.handleMessage(windowId, msg, (resp) => {
         if (!subscriptions.has(subKey)) return;
-        hooks.sendToNapplet(windowId, resp);
+        hooks.sendToNapplet(windowId, normalizeRelayServiceResponse(resp));
       });
     }
     return;
@@ -1188,10 +1232,11 @@ function deliverFromRuntimeBackends(context, windowId, subId, subKey, filters, i
       }
       return;
     }
-    deliver(item);
+    const event = item;
+    deliver(event, relayUrls);
     if (cache2?.isAvailable() && !isShellKind) {
       try {
-        cache2.store(item);
+        cache2.store(event);
       } catch {
         return;
       }
@@ -1330,7 +1375,7 @@ function handleRelayQuery(context, windowId, m) {
   for (const event of eventBuffer.getBufferedEvents()) {
     if (matchesAnyFilter(event, filters) && !seenIds.has(event.id)) {
       seenIds.add(event.id);
-      events.push(event);
+      events.push(createRelayEventResult(event));
     }
   }
   let settled = false;
@@ -1363,9 +1408,10 @@ function handleRelayQuery(context, windowId, m) {
     }, makeCollector2 = function() {
       return function collector(resp) {
         const r = resp;
-        if (r.type === "relay.event" && r.event && !seenIds.has(r.event.id)) {
-          seenIds.add(r.event.id);
-          events.push(r.event);
+        const result2 = r.type === "relay.event" ? relayEventResultFromCarrier(r) : null;
+        if (result2 && !seenIds.has(result2.event.id)) {
+          seenIds.add(result2.event.id);
+          events.push(result2);
         } else if (r.type === "relay.eose") {
           onBackendEose2();
         }
@@ -1407,7 +1453,7 @@ function handleRelayQuery(context, windowId, m) {
       for (const event of cachedEvents) {
         if (!seenIds.has(event.id)) {
           seenIds.add(event.id);
-          events.push(event);
+          events.push(createRelayEventResult(event));
         }
       }
     }).catch(() => {
@@ -1434,7 +1480,7 @@ function handleRelayQuery(context, windowId, m) {
     const event = item;
     if (!seenIds.has(event.id)) {
       seenIds.add(event.id);
-      events.push(event);
+      events.push(createRelayEventResultWithHints(event, relayUrls));
     }
     if (cache2?.isAvailable()) {
       try {
@@ -7499,7 +7545,7 @@ function createRelayPoolService(options) {
             }
             return;
           }
-          send({ type: "relay.event", subId, event: item });
+          send({ type: "relay.event", subId, result: createRelayEventResultWithHints(item, relayUrls2) });
         }, relayUrls2);
         tracked.set(subKey, { handle, eoseTimer });
         return;
@@ -8857,6 +8903,59 @@ var OUTBOX_DESCRIPTOR = {
   version: OUTBOX_SERVICE_VERSION,
   description: "NAP-OUTBOX outbox-aware relay routing \u2014 getEvent/query/subscribe/publish/resolveRelays"
 };
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function stringArray(value) {
+  if (!Array.isArray(value)) return void 0;
+  const strings = value.filter((item) => typeof item === "string");
+  return strings.length > 0 ? strings : void 0;
+}
+function uint(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0 ? value : void 0;
+}
+function sanitizeEventOptions(raw) {
+  if (!isRecord2(raw)) return void 0;
+  const out = {};
+  if (typeof raw.author === "string") out.author = raw.author;
+  const relays = stringArray(raw.relays);
+  if (relays) out.relays = relays;
+  const timeoutMs = uint(raw.timeoutMs);
+  if (timeoutMs !== void 0) out.timeoutMs = timeoutMs;
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function sanitizeQueryOptions(raw) {
+  if (!isRecord2(raw)) return void 0;
+  const out = {};
+  const authors = stringArray(raw.authors);
+  if (authors) out.authors = authors;
+  const relays = stringArray(raw.relays);
+  if (relays) out.relays = relays;
+  const limit = uint(raw.limit);
+  if (limit !== void 0) out.limit = limit;
+  const timeoutMs = uint(raw.timeoutMs);
+  if (timeoutMs !== void 0) out.timeoutMs = timeoutMs;
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+var sanitizeSubscribeOptions = sanitizeQueryOptions;
+function sanitizePublishOptions(raw) {
+  if (!isRecord2(raw)) return void 0;
+  const out = {};
+  const relays = stringArray(raw.relays);
+  if (relays) out.relays = relays;
+  const targetAuthors = stringArray(raw.targetAuthors);
+  if (targetAuthors) out.targetAuthors = targetAuthors;
+  return Object.keys(out).length > 0 ? out : void 0;
+}
+function sanitizeTarget(raw) {
+  if (!isRecord2(raw)) return void 0;
+  const out = {};
+  const authors = stringArray(raw.authors);
+  if (authors) out.authors = authors;
+  if (typeof raw.pubkey === "string") out.pubkey = raw.pubkey;
+  if (raw.direction === "read" || raw.direction === "write") out.direction = raw.direction;
+  return out;
+}
 function normalizeFilters(raw) {
   if (Array.isArray(raw)) {
     const filters = raw.filter((f) => typeof f === "object" && f !== null);
@@ -8873,17 +8972,14 @@ function buildEventQuery(eventId, eventOptions) {
     queryOptions.authors = [eventOptions.author];
   }
   if (Array.isArray(eventOptions?.relays)) queryOptions.relays = eventOptions.relays;
-  if (eventOptions?.strategy !== void 0) queryOptions.strategy = eventOptions.strategy;
   if (eventOptions?.timeoutMs !== void 0) queryOptions.timeoutMs = eventOptions.timeoutMs;
   return { filter, queryOptions };
 }
 function eventResultFromQuery(eventId, result2) {
-  const event = result2.events.find((candidate) => candidate.id === eventId);
-  const eventResult = {
-    relays: event ? result2.relays[eventId] ?? [] : []
-  };
-  if (event) eventResult.event = event;
-  if (!event) eventResult.error = result2.error ?? "not found";
+  const relayResult = result2.events.find((candidate) => candidate.event.id === eventId);
+  const eventResult = {};
+  if (relayResult) eventResult.result = relayResult;
+  if (!relayResult) eventResult.error = result2.error ?? "not found";
   else if (result2.error !== void 0) eventResult.error = result2.error;
   if (result2.incomplete !== void 0) eventResult.incomplete = result2.incomplete;
   return eventResult;
@@ -8893,15 +8989,14 @@ function fallbackGetEvent(router, eventId, eventOptions) {
   return router.query([filter], queryOptions).then((result2) => eventResultFromQuery(eventId, result2));
 }
 function sendEventResult(id, eventId, result2, send) {
-  if (result2.event && result2.event.id !== eventId) {
-    send({ type: "outbox.getEvent.result", id, relays: [], error: "not found" });
+  if (result2.result && result2.result.event.id !== eventId) {
+    send({ type: "outbox.getEvent.result", id, error: "not found" });
     return;
   }
   send({
     type: "outbox.getEvent.result",
     id,
-    ...result2.event === void 0 ? {} : { event: result2.event },
-    relays: result2.relays,
+    ...result2.result === void 0 ? {} : { result: result2.result },
     ...result2.incomplete === void 0 ? {} : { incomplete: result2.incomplete },
     ...result2.error === void 0 ? {} : { error: result2.error }
   });
@@ -8910,12 +9005,12 @@ function handleGetEvent(router, msg, send) {
   const m = msg;
   const id = m.id ?? "";
   if (typeof m.eventId !== "string" || m.eventId.length === 0) {
-    send({ type: "outbox.getEvent.result", id, relays: [], error: "invalid filter" });
+    send({ type: "outbox.getEvent.result", id, error: "invalid filter" });
     return;
   }
   const getEvent = router.getEvent ?? ((eventId, eventOptions) => fallbackGetEvent(router, eventId, eventOptions));
-  void getEvent(m.eventId, m.options).then((result2) => sendEventResult(id, m.eventId, result2, send)).catch(
-    (err2) => send({ type: "outbox.getEvent.result", id, relays: [], error: toErrorMessage(err2) })
+  void getEvent(m.eventId, sanitizeEventOptions(m.options)).then((result2) => sendEventResult(id, m.eventId, result2, send)).catch(
+    (err2) => send({ type: "outbox.getEvent.result", id, error: toErrorMessage(err2) })
   );
 }
 function createOutboxService(options) {
@@ -8929,20 +9024,19 @@ function createOutboxService(options) {
     const id = m.id ?? "";
     const filters = normalizeFilters(m.filters);
     if (!filters) {
-      send({ type: "outbox.query.result", id, events: [], relays: {}, error: "invalid filter" });
+      send({ type: "outbox.query.result", id, events: [], error: "invalid filter" });
       return;
     }
-    void router.query(filters, m.options).then(
+    void router.query(filters, sanitizeQueryOptions(m.options)).then(
       (result2) => send({
         type: "outbox.query.result",
         id,
         events: result2.events,
-        relays: result2.relays,
         ...result2.incomplete === void 0 ? {} : { incomplete: result2.incomplete },
         ...result2.error === void 0 ? {} : { error: result2.error }
       })
     ).catch(
-      (err2) => send({ type: "outbox.query.result", id, events: [], relays: {}, error: toErrorMessage(err2) })
+      (err2) => send({ type: "outbox.query.result", id, events: [], error: toErrorMessage(err2) })
     );
   }
   function handleSubscribe2(windowId, msg, send) {
@@ -8958,14 +9052,13 @@ function createOutboxService(options) {
       return;
     }
     const sink = {
-      event: (event, relay) => send({ type: "outbox.event", subId, event, ...relay === void 0 ? {} : { relay } }),
-      eose: () => send({ type: "outbox.eose", subId }),
+      event: (result2) => send({ type: "outbox.event", subId, result: result2 }),
       closed: (reason) => {
         subscriptions.delete(subKey);
         send({ type: "outbox.closed", subId, ...reason === void 0 ? {} : { reason } });
       }
     };
-    subscriptions.set(subKey, router.subscribe(filters, m.options, sink));
+    subscriptions.set(subKey, router.subscribe(filters, sanitizeSubscribeOptions(m.options), sink));
   }
   function handleClose(windowId, msg, send) {
     const m = msg;
@@ -8983,7 +9076,7 @@ function createOutboxService(options) {
       send({ type: "outbox.publish.result", id, ok: false, error: "invalid filter" });
       return;
     }
-    void router.publish(m.event, m.options).then(
+    void router.publish(m.event, sanitizePublishOptions(m.options)).then(
       (result2) => send({
         type: "outbox.publish.result",
         id,
@@ -9000,11 +9093,12 @@ function createOutboxService(options) {
   function handleResolveRelays(msg, send) {
     const m = msg;
     const id = m.id ?? "";
-    if (!m.target || typeof m.target !== "object") {
+    const target = sanitizeTarget(m.target);
+    if (!target) {
       send({ type: "outbox.resolveRelays.result", id, error: "invalid filter" });
       return;
     }
-    void router.resolveRelays(m.target).then((plan) => send({ type: "outbox.resolveRelays.result", id, plan })).catch(
+    void router.resolveRelays(target).then((plan) => send({ type: "outbox.resolveRelays.result", id, plan })).catch(
       (err2) => send({ type: "outbox.resolveRelays.result", id, error: toErrorMessage(err2) })
     );
   }
@@ -10478,13 +10572,13 @@ function createOutboxRouter(pool, getSimulation, confirmRequest, signerProvider)
           error: () => resolve(out)
         });
       });
-      return { events, relays: Object.fromEntries(events.map((event) => [event.id, relayUrls])) };
+      return { events: events.map((event) => createRelayEventResultWithHints(event, relayUrls)) };
     },
     subscribe(filters, _options, sink) {
       const relayUrls = getRelayUrls(getSimulation());
       const sub = pool.subscription(relayUrls, filters).subscribe((item) => {
-        if (item === "EOSE") sink.eose();
-        else sink.event(item, relayUrls[0]);
+        if (item === "EOSE") return;
+        sink.event(createRelayEventResultWithHints(item, relayUrls[0] ? [relayUrls[0]] : relayUrls));
       });
       return { close: () => sub.unsubscribe() };
     },
@@ -11092,9 +11186,9 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 var verifiedSymbol2 = /* @__PURE__ */ Symbol("verified");
-var isRecord2 = (obj) => obj instanceof Object;
+var isRecord3 = (obj) => obj instanceof Object;
 function validateEvent2(event) {
-  if (!isRecord2(event))
+  if (!isRecord3(event))
     return false;
   if (typeof event.kind !== "number")
     return false;
@@ -14032,9 +14126,9 @@ function renderSignerStatus(state, signerPubkey) {
 
 // ../../node_modules/.pnpm/nostr-tools@2.23.3_typescript@5.9.3/node_modules/nostr-tools/lib/esm/pool.js
 var verifiedSymbol3 = /* @__PURE__ */ Symbol("verified");
-var isRecord3 = (obj) => obj instanceof Object;
+var isRecord4 = (obj) => obj instanceof Object;
 function validateEvent3(event) {
-  if (!isRecord3(event))
+  if (!isRecord4(event))
     return false;
   if (typeof event.kind !== "number")
     return false;
@@ -15523,7 +15617,7 @@ async function resolveNapplet(options) {
 }
 
 // src/runtime-resolver.ts
-var PAJA_NAPPLET_MANIFEST_KIND = 35129;
+var PAJA_NAPPLET_MANIFEST_KINDS = NAPPLET_KINDS;
 function decodePajaPointer(value) {
   const trimmed = value.trim();
   const decoded = decode(trimmed);
@@ -15607,17 +15701,17 @@ async function resolvePointerEvent(pointer, pool, relays, maxWaitMs) {
   if (!event) {
     throw new Error(`No napplet manifest event found for ${pointer.type} pointer.`);
   }
-  if (event.kind !== PAJA_NAPPLET_MANIFEST_KIND) {
-    throw new Error(`Pointer resolved kind ${event.kind}; expected ${PAJA_NAPPLET_MANIFEST_KIND}.`);
+  if (!isNappletManifestKind(event.kind)) {
+    throw new Error(`Pointer resolved kind ${event.kind}; expected ${formatNappletManifestKinds()}.`);
   }
   return event;
 }
 function addressableFilter(pointer) {
-  if (pointer.kind !== PAJA_NAPPLET_MANIFEST_KIND) {
-    throw new Error(`naddr kind ${pointer.kind} is not a napplet manifest kind.`);
+  if (pointer.kind !== NAPPLET_KIND_NAMED) {
+    throw new Error(`naddr kind ${pointer.kind} is not a named NIP-5D napplet manifest kind.`);
   }
   return {
-    kinds: [PAJA_NAPPLET_MANIFEST_KIND],
+    kinds: [NAPPLET_KIND_NAMED],
     authors: [pointer.pubkey],
     "#d": [pointer.identifier],
     limit: 1
@@ -15667,6 +15761,9 @@ function normalizeRelayUrl(value) {
 function escapeAttribute(value) {
   return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
+function formatNappletManifestKinds() {
+  return PAJA_NAPPLET_MANIFEST_KINDS.join(" / ");
+}
 
 // src/browser-host.ts
 var bridgeRef = null;