@kehto/services 0.12.0 → 0.12.3

package/README.md

@@ -87,7 +87,9 @@ runtime.registerService(
     services: () => [],
     read: () => [87],
     write: (_sessionId, _target, _data) => {},
-    subscribe: (_sessionId, _target) => {},
+    subscribe: (sessionId, target, ctx) => {
+      ctx.emit({ type: 'notification', sessionId, target, data: [87] });
+    },
     unsubscribe: (_sessionId, _target) => {},
     close: (_sessionId) => {},
   }),
@@ -439,6 +441,9 @@ Each factory returns a `ServiceHandler` registrable via `runtime.registerService
 ### Media NAP
 - `createMediaService` — owner-aware `media.session.create` / `update` / `destroy` / `media.state` / `media.capabilities` + `media.command` push envelopes (`media:control`). Napplet-owned sessions mirror to `navigator.mediaSession` by default; shell-owned creates are rejected until a host playback/fetch bridge is supplied. Implement the `HostMediaBridge` interface to swap in native backends. See [Media Service](#media-service) for the full contract.
 
+### BLE NAP
+- `createBleService` — `ble.open`, `ble.services`, `ble.read`, `ble.write`, `ble.subscribe`, `ble.unsubscribe`, `ble.close` + host-pushed `ble.event` envelopes. Hook contexts include `ctx.emit(event)`, so host Bluetooth notification listeners can forward `notification`, `state`, and `closed` events to the requesting napplet without replacing the reference handler.
+
 ### WebRTC NAP
 - `createWebrtcService` — `webrtc.open`, `webrtc.send`, `webrtc.close` + host-pushed `webrtc.event` envelopes. The reference handler owns only the NAP request/result bookkeeping; host bridges own signaling, SDP, ICE, peer connection lifecycle, and policy.
 
@@ -449,7 +454,7 @@ Each factory returns a `ServiceHandler` registrable via `runtime.registerService
 - `createAudioService` — `audio:*` inc-emit topic handler. Browser-agnostic registry of per-window audio sources; host wires `onChange` to update transport UI.
 
 ### Types
-`AudioSource`, `AudioServiceOptions`, `Notification`, `NotificationServiceOptions`, `IdentityServiceOptions`, `RelayPoolServiceOptions`, `CacheServiceOptions`, `CoordinatedRelayOptions`, `KeysServiceOptions`, `MediaServiceOptions`, `NotifyServiceOptions`, `ThemeServiceOptions`, `ThemeService`, `WebrtcServiceOptions`, `WebrtcServiceContext`.
+`AudioSource`, `AudioServiceOptions`, `Notification`, `NotificationServiceOptions`, `IdentityServiceOptions`, `RelayPoolServiceOptions`, `CacheServiceOptions`, `CoordinatedRelayOptions`, `KeysServiceOptions`, `MediaServiceOptions`, `NotifyServiceOptions`, `ThemeServiceOptions`, `ThemeService`, `BleServiceOptions`, `BleServiceContext`, `WebrtcServiceOptions`, `WebrtcServiceContext`.
 
 ## API Reference
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ServiceHandler, Signer } from '@kehto/runtime';
 import { IdentityGetProfileMessage, IdentityGetProfileResultMessage, IdentityGetFollowsMessage, IdentityGetFollowsResultMessage, IdentityGetListMessage, IdentityGetListResultMessage, IdentityGetZapsMessage, IdentityGetZapsResultMessage, IdentityGetMutesMessage, IdentityGetMutesResultMessage, IdentityGetBlockedMessage, IdentityGetBlockedResultMessage, IdentityGetBadgesMessage, IdentityGetBadgesResultMessage } from '@napplet/nap/identity/types';
-import { NostrFilter, NostrEvent, EventTemplate, LinkOpenOptions, LinkOpenResult, ListSupport, ListRef, ListItem, ListOptions, ListMutationResult, SerialOpenRequest, SerialOpenResult, BleOpenRequest, BleOpenResult, BleService, BleAttribute, BleWriteOptions, WebrtcEvent, WebrtcOpenRequest, WebrtcOpenResult, CommonProfileTarget, CommonProfileResult, CommonFollowsResult, CommonActionResult, CommonReaction, CommonReportTarget, CommonReportReason } from '@napplet/core';
+import { NostrFilter, NostrEvent, EventTemplate, LinkOpenOptions, LinkOpenResult, ListSupport, ListRef, ListItem, ListOptions, ListMutationResult, SerialOpenRequest, SerialOpenResult, BleEvent, BleOpenRequest, BleOpenResult, BleService, BleAttribute, BleWriteOptions, WebrtcEvent, WebrtcOpenRequest, WebrtcOpenResult, CommonProfileTarget, CommonProfileResult, CommonFollowsResult, CommonActionResult, CommonReaction, CommonReportTarget, CommonReportReason } from '@napplet/core';
 import { MediaMetadata, MediaAction } from '@napplet/nap/media/types';
 export { MediaAction } from '@napplet/nap/media/types';
 import { NotifySendMessage } from '@napplet/nap/notify/types';
@@ -2521,6 +2521,8 @@ declare function createSerialService(options?: SerialServiceOptions): ServiceHan
 interface BleServiceContext {
     /** Window id of the requesting napplet. */
     windowId: string;
+    /** Emit a runtime-owned BLE event back to the requesting napplet. */
+    emit(event: BleEvent): void;
 }
 /** Options for {@link createBleService}. */
 interface BleServiceOptions {

package/dist/index.js

@@ -3199,12 +3199,20 @@ function unsupported2(resultType, id) {
     error: `${resultType.replace(".result", "")} unavailable`
   };
 }
+function createContext(windowId, send) {
+  return {
+    windowId,
+    emit(event) {
+      send({ type: "ble.event", event });
+    }
+  };
+}
 function createBleService(options = {}) {
   return {
     descriptor: BLE_DESCRIPTOR,
     handleMessage(windowId, message, send) {
       const id = message.id ?? "";
-      const context = { windowId };
+      const context = createContext(windowId, send);
       if (message.type === "ble.open") {
         if (!options.open) {
           send(unsupported2("ble.open.result", id));
@@ -3344,7 +3352,7 @@ function unsupported3(resultType, id) {
     error: `${resultType.replace(".result", "")} unavailable`
   };
 }
-function createContext(windowId, send) {
+function createContext2(windowId, send) {
   return {
     windowId,
     emit(event) {
@@ -3357,7 +3365,7 @@ function createWebrtcService(options = {}) {
     descriptor: WEBRTC_DESCRIPTOR,
     handleMessage(windowId, message, send) {
       const id = message.id ?? "";
-      const context = createContext(windowId, send);
+      const context = createContext2(windowId, send);
       if (message.type === "webrtc.open") {
         if (!options.open) {
           send(unsupported3("webrtc.open.result", id));