@kehto/services 0.15.0 → 0.16.1

package/dist/index.d.ts

@@ -1653,21 +1653,12 @@ declare function createResourceService(options: ResourceServiceOptions): Resourc
  * @packageDocumentation
  */
 
-/**
- * Relay-selection strategy:
- * - `outbox` — query/publish via author write relays (the outbox model)
- * - `inbox`  — query/publish via recipient read relays (the inbox model)
- * - `auto`   — let the shell choose per its policy and relay intelligence
- */
-type OutboxStrategy = 'outbox' | 'inbox' | 'auto';
 /** Options for a single-event outbox lookup. */
 interface OutboxEventOptions {
     /** Author hint for routing through the author's outbox relays. */
     author?: string;
     /** Relay hints; treated as a hint subject to shell validation, not a bypass. */
     relays?: string[];
-    /** Relay-selection strategy. */
-    strategy?: OutboxStrategy;
     /** Wall-clock budget for the lookup, in milliseconds. */
     timeoutMs?: number;
 }
@@ -1677,8 +1668,6 @@ interface OutboxQueryOptions {
     authors?: string[];
     /** Relay hints; treated as a hint subject to shell validation, not a bypass. */
     relays?: string[];
-    /** Relay-selection strategy. */
-    strategy?: OutboxStrategy;
     /** Maximum events to collect. */
     limit?: number;
     /** Wall-clock budget for the query, in milliseconds. */
@@ -1686,8 +1675,6 @@ interface OutboxQueryOptions {
 }
 /** Options for a live outbox subscription. */
 interface OutboxSubscribeOptions extends OutboxQueryOptions {
-    /** Keep the subscription open for real-time events after EOSE. */
-    live?: boolean;
 }
 /** Options for an outbox publish. */
 interface OutboxPublishOptions {
@@ -1695,8 +1682,6 @@ interface OutboxPublishOptions {
     relays?: string[];
     /** Recipient authors whose inbox relays should be included for directed events. */
     targetAuthors?: string[];
-    /** Relay-selection strategy. */
-    strategy?: OutboxStrategy;
 }
 /** A read/write target for relay-plan resolution. */
 interface OutboxTarget {
@@ -1706,8 +1691,6 @@ interface OutboxTarget {
     pubkey?: string;
     /** Whether the plan is for reading (their write relays) or writing (their read relays). */
     direction?: 'read' | 'write';
-    /** Relay-selection strategy. */
-    strategy?: OutboxStrategy;
 }
 /** The relay plan the shell would use for a target. */
 interface OutboxRelayPlan {
@@ -1812,9 +1795,6 @@ declare function createOutboxService(options: OutboxServiceOptions): ServiceHand
  * - reading an author's events  → their **write** relays (where they publish)
  * - writing to reach an author   → their **read**  relays (their inbox)
  *
- * `strategy` overrides the direction default: `outbox` forces write relays,
- * `inbox` forces read relays, `auto` (default) follows the read/write direction.
- *
  * @example
  * ```ts
  * import { createOutboxService, createRelayPoolOutboxRouter } from '@kehto/services';
@@ -3021,4 +3001,4 @@ declare function createCordnRelayCoordinatorClient(options: CordnRelayCoordinato
 /** Create a Cordn/ContextVM-backed NAP-DM adapter. */
 declare function createCordnDmAdapter(options: CordnDmAdapterOptions): DmAdapter;
 
-export { type AudioServiceOptions, type AudioSource, type BleServiceContext, type BleServiceOptions, type CacheServiceOptions, type CatalogIntentResolver, type CatalogIntentResolverOptions, type CommonServiceContext, type CommonServiceOptions, type ConfigSchemaValidation, type ConfigService, type ConfigServiceOptions, type CoordinatedRelayOptions, type CordnCodecResult, type CordnCoordinatorClient, type CordnCoordinatorSubscription, type CordnDmAdapterOptions, type CordnDmClient, type CordnGroupMessage, type CordnRelayCoordinatorOptions, type CountRequest, type CountResult, type CountServiceOptions, type DmAdapter, type DmConversation, type DmConversationPage, type DmConversationQuery, type DmHexPubkey, DmMemoryStore, type DmMessage, type DmMessagePage, type DmMessageQuery, type DmMessageStatus, type DmOk, type DmPeer, type DmRelayPool, type DmSendRequest, type DmSendResult, type DmService, type DmServiceOptions, type DmStatus, type DmSubscribeRequest, type DmSubscription, type DmTimestamp, type HostCacheBridge, type HostKeyEvent, type HostKeysBridge, type HostMediaBridge, type HttpUploaderOptions, type HttpUploaderRails, type IdentityServiceOptions, type IntentArchetypeSupport, type IntentAvailability, type IntentBehavior, type IntentCandidate, type IntentCatalogEntry, type IntentHandlerPreference, type IntentOpenParams, type IntentRequest, type IntentResolver, type IntentResolverContext, type IntentResult, type IntentServiceOptions, type IntentWindowController, type KeysServiceOptions, type LinkOpenContext, type LinkServiceOptions, type ListsServiceContext, type ListsServiceOptions, type ManifestArchetypeInput, type MaybePromise, type MediaMetadataLike, type MediaPlaybackOwner, type MediaServiceOptions, type MediaSessionCreateOptions, type MediaSessionTarget, type MediaSourceRef, type NdrDmAdapterOptions, type NdrRelayTransport, type NdrRelayTransportOptions, type NdrRumorLike, type NdrRuntimeLike, type Nip17DmAdapterOptions, type NostrTag, type Notification, type NotificationServiceOptions, type NotifyServiceOptions, type OutboxEventOptions, type OutboxEventResult, type OutboxPublishOptions, type OutboxPublishResult, type OutboxQueryOptions, type OutboxRelayPlan, type OutboxRelayPool, type OutboxResult, type OutboxRouter, type OutboxRouterSubscription, type OutboxServiceOptions, type OutboxStrategy, type OutboxSubscribeOptions, type OutboxSubscriptionSink, type OutboxTarget, type RailServerConfig, type RelayListEntry, type RelayPoolOutboxRouterOptions, type RelayPoolServiceOptions, type ResourceInfo, type ResourceInfoContext, type ResourceInfoProvider, type ResourceSchemeInfo, type ResourceService, type ResourceServiceOptions, type SerialServiceContext, type SerialServiceOptions, type SignEvent, type ThemeService, type ThemeServiceOptions, type UploadDimensions, type UploadInfo, type UploadInfoContext, type UploadInfoProvider, type UploadRail, type UploadRailInfo, type UploadRequest, type UploadResult, type UploadServiceOptions, type UploadState, type UploadStatus, type Uploader, type UploaderContext, type WebrtcServiceContext, type WebrtcServiceOptions, createAudioService, createBleService, createBrowserMediaBridge, createCacheService, createCatalogIntentResolver, createCommonService, createConfigService, createCoordinatedRelay, createCordnDmAdapter, createCordnRelayCoordinatorClient, createCountService, createDmService, createHttpUploader, createIdentityService, createIntentService, createKeysService, createLinkService, createListsService, createMediaService, createNdrDmAdapter, createNdrRelayTransport, createNip17DmAdapter, createNotificationService, createNotifyService, createOutboxService, createRelayPoolOutboxRouter, createRelayPoolService, createResourceService, createSerialService, createThemeService, createUploadService, createWebrtcService, manifestToIntentCatalogEntry };
+export { type AudioServiceOptions, type AudioSource, type BleServiceContext, type BleServiceOptions, type CacheServiceOptions, type CatalogIntentResolver, type CatalogIntentResolverOptions, type CommonServiceContext, type CommonServiceOptions, type ConfigSchemaValidation, type ConfigService, type ConfigServiceOptions, type CoordinatedRelayOptions, type CordnCodecResult, type CordnCoordinatorClient, type CordnCoordinatorSubscription, type CordnDmAdapterOptions, type CordnDmClient, type CordnGroupMessage, type CordnRelayCoordinatorOptions, type CountRequest, type CountResult, type CountServiceOptions, type DmAdapter, type DmConversation, type DmConversationPage, type DmConversationQuery, type DmHexPubkey, DmMemoryStore, type DmMessage, type DmMessagePage, type DmMessageQuery, type DmMessageStatus, type DmOk, type DmPeer, type DmRelayPool, type DmSendRequest, type DmSendResult, type DmService, type DmServiceOptions, type DmStatus, type DmSubscribeRequest, type DmSubscription, type DmTimestamp, type HostCacheBridge, type HostKeyEvent, type HostKeysBridge, type HostMediaBridge, type HttpUploaderOptions, type HttpUploaderRails, type IdentityServiceOptions, type IntentArchetypeSupport, type IntentAvailability, type IntentBehavior, type IntentCandidate, type IntentCatalogEntry, type IntentHandlerPreference, type IntentOpenParams, type IntentRequest, type IntentResolver, type IntentResolverContext, type IntentResult, type IntentServiceOptions, type IntentWindowController, type KeysServiceOptions, type LinkOpenContext, type LinkServiceOptions, type ListsServiceContext, type ListsServiceOptions, type ManifestArchetypeInput, type MaybePromise, type MediaMetadataLike, type MediaPlaybackOwner, type MediaServiceOptions, type MediaSessionCreateOptions, type MediaSessionTarget, type MediaSourceRef, type NdrDmAdapterOptions, type NdrRelayTransport, type NdrRelayTransportOptions, type NdrRumorLike, type NdrRuntimeLike, type Nip17DmAdapterOptions, type NostrTag, type Notification, type NotificationServiceOptions, type NotifyServiceOptions, type OutboxEventOptions, type OutboxEventResult, type OutboxPublishOptions, type OutboxPublishResult, type OutboxQueryOptions, type OutboxRelayPlan, type OutboxRelayPool, type OutboxResult, type OutboxRouter, type OutboxRouterSubscription, type OutboxServiceOptions, type OutboxSubscribeOptions, type OutboxSubscriptionSink, type OutboxTarget, type RailServerConfig, type RelayListEntry, type RelayPoolOutboxRouterOptions, type RelayPoolServiceOptions, type ResourceInfo, type ResourceInfoContext, type ResourceInfoProvider, type ResourceSchemeInfo, type ResourceService, type ResourceServiceOptions, type SerialServiceContext, type SerialServiceOptions, type SignEvent, type ThemeService, type ThemeServiceOptions, type UploadDimensions, type UploadInfo, type UploadInfoContext, type UploadInfoProvider, type UploadRail, type UploadRailInfo, type UploadRequest, type UploadResult, type UploadServiceOptions, type UploadState, type UploadStatus, type Uploader, type UploaderContext, type WebrtcServiceContext, type WebrtcServiceOptions, createAudioService, createBleService, createBrowserMediaBridge, createCacheService, createCatalogIntentResolver, createCommonService, createConfigService, createCoordinatedRelay, createCordnDmAdapter, createCordnRelayCoordinatorClient, createCountService, createDmService, createHttpUploader, createIdentityService, createIntentService, createKeysService, createLinkService, createListsService, createMediaService, createNdrDmAdapter, createNdrRelayTransport, createNip17DmAdapter, createNotificationService, createNotifyService, createOutboxService, createRelayPoolOutboxRouter, createRelayPoolService, createResourceService, createSerialService, createThemeService, createUploadService, createWebrtcService, manifestToIntentCatalogEntry };

package/dist/index.js

@@ -2030,6 +2030,59 @@ var OUTBOX_DESCRIPTOR = {
   version: OUTBOX_SERVICE_VERSION,
   description: "NAP-OUTBOX outbox-aware relay routing \u2014 getEvent/query/subscribe/publish/resolveRelays"
 };
+function isRecord(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 (!isRecord(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 (!isRecord(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 (!isRecord(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 (!isRecord(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);
@@ -2046,7 +2099,6 @@ 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 };
 }
@@ -2084,7 +2136,7 @@ function handleGetEvent(router, msg, send) {
     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(
+  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) })
   );
 }
@@ -2102,7 +2154,7 @@ function createOutboxService(options) {
       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,
@@ -2133,7 +2185,7 @@ function createOutboxService(options) {
         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;
@@ -2151,7 +2203,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,
@@ -2168,11 +2220,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) })
     );
   }
@@ -2233,11 +2286,6 @@ function deriveAuthors(filters, optionAuthors) {
   for (const author of optionAuthors ?? []) authors.add(author);
   return [...authors];
 }
-function wantsWriteRelays(direction, strategy) {
-  if (strategy === "outbox") return true;
-  if (strategy === "inbox") return false;
-  return direction === "read";
-}
 function allowed(ctx, urls) {
   const out = /* @__PURE__ */ new Set();
   for (const url of urls) {
@@ -2245,8 +2293,8 @@ function allowed(ctx, urls) {
   }
   return [...out];
 }
-async function resolvePlan(ctx, pubkeys, direction, strategy, relayHints) {
-  const useWrite = wantsWriteRelays(direction, strategy);
+async function resolvePlan(ctx, pubkeys, direction, relayHints) {
+  const useWrite = direction === "read";
   const collected = /* @__PURE__ */ new Set();
   const missingAuthors = [];
   let sawNip65 = false;
@@ -2344,9 +2392,8 @@ async function queryImpl(ctx, filters, options) {
   if (!ctx.relayPool.isAvailable()) {
     return { events: [], incomplete: true, error: "relay list unavailable" };
   }
-  const strategy = options?.strategy ?? "auto";
   const authors = deriveAuthors(filters, options?.authors);
-  const plan = await resolvePlan(ctx, authors, "read", strategy, options?.relays);
+  const plan = await resolvePlan(ctx, authors, "read", options?.relays);
   if (plan.relays.length === 0) {
     return { events: [], incomplete: true, error: "relay list unavailable" };
   }
@@ -2372,7 +2419,6 @@ async function getEventImpl(ctx, eventId, options) {
     queryOptions.authors = [options.author];
   }
   if (Array.isArray(options?.relays)) queryOptions.relays = options.relays;
-  if (options?.strategy !== void 0) queryOptions.strategy = options.strategy;
   if (options?.timeoutMs !== void 0) queryOptions.timeoutMs = options.timeoutMs;
   const queryResult = await queryImpl(ctx, [filter], queryOptions);
   const eventResult = queryResult.events.find((candidate) => candidate.event.id === eventId);
@@ -2392,21 +2438,10 @@ function closeLiveSub(sub) {
   }
   sub.handles.length = 0;
 }
-function attachLiveRelay(ctx, sub, filters, relayUrl, live, sink) {
+function attachLiveRelay(ctx, sub, filters, relayUrl, sink) {
   sub.handles.push(relayPoolSubscribe(ctx, filters, relayUrl, (item) => {
     if (sub.closed) return;
-    if (item === "EOSE") {
-      sub.eoseCount += 1;
-      if (!sub.eoseSent && sub.eoseCount >= sub.relayCount) {
-        sub.eoseSent = true;
-        if (!live) {
-          sub.closed = true;
-          closeLiveSub(sub);
-          sink.closed();
-        }
-      }
-      return;
-    }
+    if (item === "EOSE") return;
     if (sub.seen.has(item.id)) return;
     void ctx.verify(item).then((ok) => {
       if (!ok || sub.closed || sub.seen.has(item.id)) return;
@@ -2416,18 +2451,15 @@ function attachLiveRelay(ctx, sub, filters, relayUrl, live, sink) {
   }));
 }
 function startSubscription(ctx, filters, options, sink) {
-  const live = options?.live ?? true;
-  const strategy = options?.strategy ?? "auto";
   const authors = deriveAuthors(filters, options?.authors);
-  const sub = { handles: [], seen: /* @__PURE__ */ new Set(), closed: false, eoseCount: 0, relayCount: 0, eoseSent: false };
-  void resolvePlan(ctx, authors, "read", strategy, options?.relays).then((plan) => {
+  const sub = { handles: [], seen: /* @__PURE__ */ new Set(), closed: false };
+  void resolvePlan(ctx, authors, "read", options?.relays).then((plan) => {
     if (sub.closed) return;
     if (plan.relays.length === 0) {
       sink.closed("relay list unavailable");
       return;
     }
-    sub.relayCount = plan.relays.length;
-    for (const relayUrl of plan.relays) attachLiveRelay(ctx, sub, filters, relayUrl, live, sink);
+    for (const relayUrl of plan.relays) attachLiveRelay(ctx, sub, filters, relayUrl, sink);
   }).catch((err2) => {
     if (!sub.closed) sink.closed(err2 instanceof Error ? err2.message : "subscribe failed");
   });
@@ -2440,12 +2472,11 @@ function startSubscription(ctx, filters, options, sink) {
   };
 }
 async function resolvePublishTargets(ctx, signed, options) {
-  const strategy = options?.strategy ?? "auto";
   const targets = /* @__PURE__ */ new Set();
-  const authorPlan = await resolvePlan(ctx, [signed.pubkey], "read", strategy === "inbox" ? "auto" : "outbox");
+  const authorPlan = await resolvePlan(ctx, [signed.pubkey], "read");
   for (const url of authorPlan.relays) targets.add(url);
   if (options?.targetAuthors && options.targetAuthors.length > 0) {
-    const inboxPlan = await resolvePlan(ctx, options.targetAuthors, "write", "inbox");
+    const inboxPlan = await resolvePlan(ctx, options.targetAuthors, "write");
     for (const url of inboxPlan.relays) targets.add(url);
   }
   for (const url of options?.relays ?? []) targets.add(url);
@@ -2507,7 +2538,7 @@ function createRelayPoolOutboxRouter(options) {
     publish: (template, publishOptions) => publishImpl(ctx, template, publishOptions),
     resolveRelays: (target) => {
       const pubkeys = target.authors ?? (target.pubkey ? [target.pubkey] : []);
-      return resolvePlan(ctx, pubkeys, target.direction ?? "read", target.strategy ?? "auto");
+      return resolvePlan(ctx, pubkeys, target.direction ?? "read");
     }
   };
 }