@undefineds.co/xpod 0.3.67 → 0.3.68

package/dist/notifications/DeviceNotificationHub.js

@@ -0,0 +1,313 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceNotificationHub = void 0;
+const node_crypto_1 = require("node:crypto");
+const DEFAULT_MAX_TOPICS_PER_CONNECTION = 100;
+const DEFAULT_MAX_QUEUE_MESSAGES = 256;
+const DEFAULT_MAX_REPLAY_EVENTS = 512;
+class DeviceNotificationHub {
+    constructor(options) {
+        this.connections = new Map();
+        this.connectionsByDevice = new Map();
+        this.topicMembers = new Map();
+        this.replay = [];
+        this.sequence = 0;
+        this.origin = new URL(options.origin);
+        this.maxTopicsPerConnection = options.maxTopicsPerConnection ?? DEFAULT_MAX_TOPICS_PER_CONNECTION;
+        this.maxQueueMessages = options.maxQueueMessages ?? DEFAULT_MAX_QUEUE_MESSAGES;
+        this.maxReplayEvents = options.maxReplayEvents ?? DEFAULT_MAX_REPLAY_EVENTS;
+        this.authorizeTopic = options.authorizeTopic ?? (() => true);
+    }
+    openConnection(input) {
+        const deviceKey = this.deviceConnectionKey(input.identity, input.deviceSessionId);
+        const existingConnectionId = this.connectionsByDevice.get(deviceKey);
+        if (existingConnectionId) {
+            this.closeConnection(existingConnectionId, 4000, 'Replaced by newer device connection');
+        }
+        const connectionId = (0, node_crypto_1.randomUUID)();
+        this.connections.set(connectionId, {
+            connectionId,
+            identity: input.identity,
+            deviceSessionId: input.deviceSessionId,
+            topics: new Set(),
+            queue: [],
+            resyncTopics: new Set(),
+            resyncQueued: new Set(),
+            seenRequestIds: new Set(),
+            lastAck: 0,
+            pendingResumeFrom: undefined,
+            send: input.send,
+            close: input.close,
+        });
+        this.connectionsByDevice.set(deviceKey, connectionId);
+        return { connectionId };
+    }
+    hello(connectionId, resumeFrom) {
+        const connection = this.requireConnection(connectionId);
+        const ready = {
+            type: 'ready',
+            connectionId,
+            sequence: this.sequence,
+        };
+        this.deliver(connection, ready);
+        if (resumeFrom !== undefined) {
+            connection.pendingResumeFrom = resumeFrom;
+        }
+        return ready;
+    }
+    async registerTopics(connectionId, requestId, topics) {
+        const connection = this.requireConnection(connectionId);
+        this.assertNewRequestId(connection, requestId);
+        const normalizedTopics = topics.map((topic) => this.normalizeTopic(topic));
+        if ((new Set([...connection.topics, ...normalizedTopics])).size > this.maxTopicsPerConnection) {
+            throw new Error('Too many topics for connection');
+        }
+        for (const topic of normalizedTopics) {
+            if (!await this.authorizeTopic({ identity: connection.identity, topic })) {
+                throw new Error(`Topic not authorized: ${topic}`);
+            }
+            connection.topics.add(topic);
+            if (!this.topicMembers.has(topic)) {
+                this.topicMembers.set(topic, new Set());
+            }
+            this.topicMembers.get(topic).add(connectionId);
+        }
+        const frame = {
+            type: 'registered',
+            requestId,
+            topics: normalizedTopics,
+        };
+        this.deliver(connection, frame);
+        this.deliverPendingResume(connection);
+        return frame;
+    }
+    async unregisterTopics(connectionId, requestId, topics) {
+        const connection = this.requireConnection(connectionId);
+        this.assertNewRequestId(connection, requestId);
+        const normalizedTopics = topics.map((topic) => this.normalizeTopic(topic));
+        for (const topic of normalizedTopics) {
+            connection.topics.delete(topic);
+            const members = this.topicMembers.get(topic);
+            members?.delete(connectionId);
+            if (members?.size === 0) {
+                this.topicMembers.delete(topic);
+            }
+        }
+        const frame = {
+            type: 'unregistered',
+            requestId,
+            topics: normalizedTopics,
+        };
+        this.deliver(connection, frame);
+        return frame;
+    }
+    ack(connectionId, sequence) {
+        const connection = this.requireConnection(connectionId);
+        connection.lastAck = Math.max(connection.lastAck, sequence);
+        connection.queue = connection.queue.filter((frame) => frame.type !== 'event' || frame.sequence > sequence);
+    }
+    publish(input) {
+        const topic = this.normalizeTopic(input.topic);
+        const event = {
+            type: 'event',
+            sequence: ++this.sequence,
+            eventId: `urn:uuid:${(0, node_crypto_1.randomUUID)()}`,
+            topic,
+            ...(input.object ? { object: this.normalizeResource(input.object) } : {}),
+            operation: input.operation,
+            emittedAt: new Date().toISOString(),
+        };
+        this.pushReplay(event);
+        const memberIds = this.matchingMemberIds(topic, event.object);
+        for (const connectionId of memberIds) {
+            const connection = this.connections.get(connectionId);
+            if (!connection) {
+                continue;
+            }
+            this.deliver(connection, event);
+        }
+        return event;
+    }
+    resume(connectionId, resumeFrom) {
+        const connection = this.requireConnection(connectionId);
+        if (this.replay.length === 0) {
+            return [];
+        }
+        const oldest = this.replay[0].sequence;
+        if (resumeFrom < oldest) {
+            return {
+                type: 'resync-required',
+                topics: [...connection.topics].sort(),
+                reason: 'expired',
+            };
+        }
+        return this.replay
+            .filter((event) => event.sequence > resumeFrom)
+            .filter((event) => this.connectionMatches(connection, event.topic, event.object));
+    }
+    closeConnection(connectionId, code, reason) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return;
+        }
+        if (code !== undefined && reason !== undefined) {
+            connection.close?.(code, reason);
+        }
+        for (const topic of connection.topics) {
+            const members = this.topicMembers.get(topic);
+            members?.delete(connectionId);
+            if (members?.size === 0) {
+                this.topicMembers.delete(topic);
+            }
+        }
+        this.connections.delete(connectionId);
+        this.connectionsByDevice.delete(this.deviceConnectionKey(connection.identity, connection.deviceSessionId));
+    }
+    getSeenRequestIds(connectionId) {
+        return this.requireConnection(connectionId).seenRequestIds;
+    }
+    getTopicMemberCount(topic) {
+        return this.topicMembers.get(this.normalizeTopic(topic))?.size ?? 0;
+    }
+    getConnectionSnapshot(connectionId) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            return undefined;
+        }
+        return {
+            topicCount: connection.topics.size,
+            topics: [...connection.topics].sort(),
+            queueLength: connection.queue.length,
+            resyncTopics: [...connection.resyncTopics].sort(),
+            lastAck: connection.lastAck,
+        };
+    }
+    deliver(connection, frame) {
+        if (connection.send(frame)) {
+            return;
+        }
+        this.enqueue(connection, frame);
+    }
+    deliverPendingResume(connection) {
+        if (connection.pendingResumeFrom === undefined) {
+            return;
+        }
+        const resumeFrom = connection.pendingResumeFrom;
+        connection.pendingResumeFrom = undefined;
+        const replay = this.resume(connection.connectionId, resumeFrom);
+        if (Array.isArray(replay)) {
+            for (const frame of replay) {
+                this.deliver(connection, frame);
+            }
+        }
+        else {
+            this.deliver(connection, replay);
+        }
+    }
+    enqueue(connection, frame) {
+        if (frame.type === 'event') {
+            this.coalesceEvent(connection, frame);
+        }
+        else {
+            connection.queue.push(frame);
+        }
+        if (connection.queue.length > this.maxQueueMessages) {
+            this.markOverflow(connection, frame);
+        }
+    }
+    coalesceEvent(connection, frame) {
+        const index = connection.queue.findIndex((queued) => queued.type === 'event' && queued.topic === frame.topic && queued.object === frame.object);
+        if (index === -1) {
+            connection.queue.push(frame);
+            return;
+        }
+        const previous = connection.queue[index];
+        connection.queue[index] = {
+            ...frame,
+            operation: previous.operation === 'delete' ? 'delete' : frame.operation,
+        };
+    }
+    markOverflow(connection, frame) {
+        const topics = frame.type === 'event' ? [frame.topic] : [...connection.topics];
+        for (const topic of topics) {
+            connection.resyncTopics.add(topic);
+            if (!connection.resyncQueued.has(topic)) {
+                connection.queue.push({
+                    type: 'resync-required',
+                    topics: [topic],
+                    reason: 'overflow',
+                });
+                connection.resyncQueued.add(topic);
+            }
+        }
+        while (connection.queue.length > this.maxQueueMessages) {
+            const dropped = connection.queue.findIndex((queued) => queued.type === 'event');
+            connection.queue.splice(dropped === -1 ? 0 : dropped, 1);
+        }
+    }
+    pushReplay(event) {
+        this.replay.push(event);
+        while (this.replay.length > this.maxReplayEvents) {
+            this.replay.shift();
+        }
+    }
+    matchingMemberIds(topic, object) {
+        const ids = new Set();
+        for (const [registeredTopic, members] of this.topicMembers) {
+            if (this.topicMatches(registeredTopic, topic, object)) {
+                for (const member of members) {
+                    ids.add(member);
+                }
+            }
+        }
+        return ids;
+    }
+    connectionMatches(connection, topic, object) {
+        for (const registeredTopic of connection.topics) {
+            if (this.topicMatches(registeredTopic, topic, object)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    topicMatches(registeredTopic, eventTopic, object) {
+        return eventTopic === registeredTopic ||
+            object === registeredTopic ||
+            Boolean(object && registeredTopic.endsWith('/') && object.startsWith(registeredTopic));
+    }
+    assertNewRequestId(connection, requestId) {
+        if (connection.seenRequestIds.has(requestId)) {
+            throw new Error(`Duplicate requestId: ${requestId}`);
+        }
+        connection.seenRequestIds.add(requestId);
+    }
+    normalizeTopic(topic) {
+        const url = new URL(topic, this.origin);
+        if (url.origin !== this.origin.origin) {
+            throw new Error('topic must be same-origin');
+        }
+        url.hash = '';
+        url.search = '';
+        return url.toString();
+    }
+    normalizeResource(resource) {
+        const url = new URL(resource, this.origin);
+        if (url.origin !== this.origin.origin) {
+            throw new Error('resource must be same-origin');
+        }
+        url.hash = '';
+        return url.toString();
+    }
+    requireConnection(connectionId) {
+        const connection = this.connections.get(connectionId);
+        if (!connection) {
+            throw new Error(`Unknown notification connection: ${connectionId}`);
+        }
+        return connection;
+    }
+    deviceConnectionKey(identity, deviceSessionId) {
+        return `${identity.webId}\u0000${deviceSessionId}`;
+    }
+}
+exports.DeviceNotificationHub = DeviceNotificationHub;
+//# sourceMappingURL=DeviceNotificationHub.js.map

package/dist/notifications/DeviceNotificationHub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceNotificationHub.js","sourceRoot":"","sources":["../../src/notifications/DeviceNotificationHub.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type {\n  DeviceNotificationOperation,\n  DeviceNotificationServerFrame,\n} from './device-notification-protocol';\nimport type { DeviceNotificationIdentity } from '../api/handlers/DeviceNotificationTicketHandler';\n\nexport interface DeviceNotificationHubOptions {\n  origin: string;\n  maxTopicsPerConnection?: number;\n  maxQueueMessages?: number;\n  maxReplayEvents?: number;\n  authorizeTopic?: (input: { identity: DeviceNotificationIdentity; topic: string }) => boolean | Promise<boolean>;\n}\n\nexport interface OpenDeviceNotificationConnectionInput {\n  identity: DeviceNotificationIdentity;\n  deviceSessionId: string;\n  send: (frame: DeviceNotificationServerFrame) => boolean;\n  close?: (code: number, reason: string) => void;\n}\n\nexport interface DeviceNotificationConnectionHandle {\n  connectionId: string;\n}\n\nexport interface DeviceNotificationPublishInput {\n  topic: string;\n  object?: string;\n  operation: DeviceNotificationOperation;\n}\n\ninterface ConnectionState {\n  connectionId: string;\n  identity: DeviceNotificationIdentity;\n  deviceSessionId: string;\n  topics: Set<string>;\n  queue: DeviceNotificationServerFrame[];\n  resyncTopics: Set<string>;\n  resyncQueued: Set<string>;\n  seenRequestIds: Set<string>;\n  lastAck: number;\n  pendingResumeFrom?: number;\n  send: (frame: DeviceNotificationServerFrame) => boolean;\n  close?: (code: number, reason: string) => void;\n}\n\ntype EventFrame = Extract<DeviceNotificationServerFrame, { type: 'event' }>;\n\nconst DEFAULT_MAX_TOPICS_PER_CONNECTION = 100;\nconst DEFAULT_MAX_QUEUE_MESSAGES = 256;\nconst DEFAULT_MAX_REPLAY_EVENTS = 512;\n\nexport class DeviceNotificationHub {\n  private readonly origin: URL;\n  private readonly maxTopicsPerConnection: number;\n  private readonly maxQueueMessages: number;\n  private readonly maxReplayEvents: number;\n  private readonly authorizeTopic: (input: { identity: DeviceNotificationIdentity; topic: string }) => boolean | Promise<boolean>;\n  private readonly connections = new Map<string, ConnectionState>();\n  private readonly connectionsByDevice = new Map<string, string>();\n  private readonly topicMembers = new Map<string, Set<string>>();\n  private readonly replay: EventFrame[] = [];\n  private sequence = 0;\n\n  public constructor(options: DeviceNotificationHubOptions) {\n    this.origin = new URL(options.origin);\n    this.maxTopicsPerConnection = options.maxTopicsPerConnection ?? DEFAULT_MAX_TOPICS_PER_CONNECTION;\n    this.maxQueueMessages = options.maxQueueMessages ?? DEFAULT_MAX_QUEUE_MESSAGES;\n    this.maxReplayEvents = options.maxReplayEvents ?? DEFAULT_MAX_REPLAY_EVENTS;\n    this.authorizeTopic = options.authorizeTopic ?? (() => true);\n  }\n\n  public openConnection(input: OpenDeviceNotificationConnectionInput): DeviceNotificationConnectionHandle {\n    const deviceKey = this.deviceConnectionKey(input.identity, input.deviceSessionId);\n    const existingConnectionId = this.connectionsByDevice.get(deviceKey);\n    if (existingConnectionId) {\n      this.closeConnection(existingConnectionId, 4000, 'Replaced by newer device connection');\n    }\n    const connectionId = randomUUID();\n    this.connections.set(connectionId, {\n      connectionId,\n      identity: input.identity,\n      deviceSessionId: input.deviceSessionId,\n      topics: new Set(),\n      queue: [],\n      resyncTopics: new Set(),\n      resyncQueued: new Set(),\n      seenRequestIds: new Set(),\n      lastAck: 0,\n      pendingResumeFrom: undefined,\n      send: input.send,\n      close: input.close,\n    });\n    this.connectionsByDevice.set(deviceKey, connectionId);\n    return { connectionId };\n  }\n\n  public hello(connectionId: string, resumeFrom?: number): DeviceNotificationServerFrame {\n    const connection = this.requireConnection(connectionId);\n    const ready: DeviceNotificationServerFrame = {\n      type: 'ready',\n      connectionId,\n      sequence: this.sequence,\n    };\n    this.deliver(connection, ready);\n    if (resumeFrom !== undefined) {\n      connection.pendingResumeFrom = resumeFrom;\n    }\n    return ready;\n  }\n\n  public async registerTopics(connectionId: string, requestId: string, topics: string[]): Promise<DeviceNotificationServerFrame> {\n    const connection = this.requireConnection(connectionId);\n    this.assertNewRequestId(connection, requestId);\n    const normalizedTopics = topics.map((topic) => this.normalizeTopic(topic));\n    if ((new Set([...connection.topics, ...normalizedTopics])).size > this.maxTopicsPerConnection) {\n      throw new Error('Too many topics for connection');\n    }\n    for (const topic of normalizedTopics) {\n      if (!await this.authorizeTopic({ identity: connection.identity, topic })) {\n        throw new Error(`Topic not authorized: ${topic}`);\n      }\n      connection.topics.add(topic);\n      if (!this.topicMembers.has(topic)) {\n        this.topicMembers.set(topic, new Set());\n      }\n      this.topicMembers.get(topic)!.add(connectionId);\n    }\n    const frame: DeviceNotificationServerFrame = {\n      type: 'registered',\n      requestId,\n      topics: normalizedTopics,\n    };\n    this.deliver(connection, frame);\n    this.deliverPendingResume(connection);\n    return frame;\n  }\n\n  public async unregisterTopics(connectionId: string, requestId: string, topics: string[]): Promise<DeviceNotificationServerFrame> {\n    const connection = this.requireConnection(connectionId);\n    this.assertNewRequestId(connection, requestId);\n    const normalizedTopics = topics.map((topic) => this.normalizeTopic(topic));\n    for (const topic of normalizedTopics) {\n      connection.topics.delete(topic);\n      const members = this.topicMembers.get(topic);\n      members?.delete(connectionId);\n      if (members?.size === 0) {\n        this.topicMembers.delete(topic);\n      }\n    }\n    const frame: DeviceNotificationServerFrame = {\n      type: 'unregistered',\n      requestId,\n      topics: normalizedTopics,\n    };\n    this.deliver(connection, frame);\n    return frame;\n  }\n\n  public ack(connectionId: string, sequence: number): void {\n    const connection = this.requireConnection(connectionId);\n    connection.lastAck = Math.max(connection.lastAck, sequence);\n    connection.queue = connection.queue.filter((frame) => frame.type !== 'event' || frame.sequence > sequence);\n  }\n\n  public publish(input: DeviceNotificationPublishInput): EventFrame {\n    const topic = this.normalizeTopic(input.topic);\n    const event: EventFrame = {\n      type: 'event',\n      sequence: ++this.sequence,\n      eventId: `urn:uuid:${randomUUID()}`,\n      topic,\n      ...(input.object ? { object: this.normalizeResource(input.object) } : {}),\n      operation: input.operation,\n      emittedAt: new Date().toISOString(),\n    };\n    this.pushReplay(event);\n    const memberIds = this.matchingMemberIds(topic, event.object);\n    for (const connectionId of memberIds) {\n      const connection = this.connections.get(connectionId);\n      if (!connection) {\n        continue;\n      }\n      this.deliver(connection, event);\n    }\n    return event;\n  }\n\n  public resume(connectionId: string, resumeFrom: number): EventFrame[] | DeviceNotificationServerFrame {\n    const connection = this.requireConnection(connectionId);\n    if (this.replay.length === 0) {\n      return [];\n    }\n    const oldest = this.replay[0].sequence;\n    if (resumeFrom < oldest) {\n      return {\n        type: 'resync-required',\n        topics: [...connection.topics].sort(),\n        reason: 'expired',\n      };\n    }\n    return this.replay\n      .filter((event) => event.sequence > resumeFrom)\n      .filter((event) => this.connectionMatches(connection, event.topic, event.object));\n  }\n\n  public closeConnection(connectionId: string, code?: number, reason?: string): void {\n    const connection = this.connections.get(connectionId);\n    if (!connection) {\n      return;\n    }\n    if (code !== undefined && reason !== undefined) {\n      connection.close?.(code, reason);\n    }\n    for (const topic of connection.topics) {\n      const members = this.topicMembers.get(topic);\n      members?.delete(connectionId);\n      if (members?.size === 0) {\n        this.topicMembers.delete(topic);\n      }\n    }\n    this.connections.delete(connectionId);\n    this.connectionsByDevice.delete(this.deviceConnectionKey(connection.identity, connection.deviceSessionId));\n  }\n\n  public getSeenRequestIds(connectionId: string): Set<string> {\n    return this.requireConnection(connectionId).seenRequestIds;\n  }\n\n  public getTopicMemberCount(topic: string): number {\n    return this.topicMembers.get(this.normalizeTopic(topic))?.size ?? 0;\n  }\n\n  public getConnectionSnapshot(connectionId: string): {\n    topicCount: number;\n    topics: string[];\n    queueLength: number;\n    resyncTopics: string[];\n    lastAck: number;\n  } | undefined {\n    const connection = this.connections.get(connectionId);\n    if (!connection) {\n      return undefined;\n    }\n    return {\n      topicCount: connection.topics.size,\n      topics: [...connection.topics].sort(),\n      queueLength: connection.queue.length,\n      resyncTopics: [...connection.resyncTopics].sort(),\n      lastAck: connection.lastAck,\n    };\n  }\n\n  private deliver(connection: ConnectionState, frame: DeviceNotificationServerFrame): void {\n    if (connection.send(frame)) {\n      return;\n    }\n    this.enqueue(connection, frame);\n  }\n\n  private deliverPendingResume(connection: ConnectionState): void {\n    if (connection.pendingResumeFrom === undefined) {\n      return;\n    }\n    const resumeFrom = connection.pendingResumeFrom;\n    connection.pendingResumeFrom = undefined;\n    const replay = this.resume(connection.connectionId, resumeFrom);\n    if (Array.isArray(replay)) {\n      for (const frame of replay) {\n        this.deliver(connection, frame);\n      }\n    } else {\n      this.deliver(connection, replay);\n    }\n  }\n\n  private enqueue(connection: ConnectionState, frame: DeviceNotificationServerFrame): void {\n    if (frame.type === 'event') {\n      this.coalesceEvent(connection, frame);\n    } else {\n      connection.queue.push(frame);\n    }\n    if (connection.queue.length > this.maxQueueMessages) {\n      this.markOverflow(connection, frame);\n    }\n  }\n\n  private coalesceEvent(connection: ConnectionState, frame: EventFrame): void {\n    const index = connection.queue.findIndex((queued) =>\n      queued.type === 'event' && queued.topic === frame.topic && queued.object === frame.object);\n    if (index === -1) {\n      connection.queue.push(frame);\n      return;\n    }\n    const previous = connection.queue[index] as EventFrame;\n    connection.queue[index] = {\n      ...frame,\n      operation: previous.operation === 'delete' ? 'delete' : frame.operation,\n    };\n  }\n\n  private markOverflow(connection: ConnectionState, frame: DeviceNotificationServerFrame): void {\n    const topics = frame.type === 'event' ? [frame.topic] : [...connection.topics];\n    for (const topic of topics) {\n      connection.resyncTopics.add(topic);\n      if (!connection.resyncQueued.has(topic)) {\n        connection.queue.push({\n          type: 'resync-required',\n          topics: [topic],\n          reason: 'overflow',\n        });\n        connection.resyncQueued.add(topic);\n      }\n    }\n    while (connection.queue.length > this.maxQueueMessages) {\n      const dropped = connection.queue.findIndex((queued) => queued.type === 'event');\n      connection.queue.splice(dropped === -1 ? 0 : dropped, 1);\n    }\n  }\n\n  private pushReplay(event: EventFrame): void {\n    this.replay.push(event);\n    while (this.replay.length > this.maxReplayEvents) {\n      this.replay.shift();\n    }\n  }\n\n  private matchingMemberIds(topic: string, object?: string): Set<string> {\n    const ids = new Set<string>();\n    for (const [registeredTopic, members] of this.topicMembers) {\n      if (this.topicMatches(registeredTopic, topic, object)) {\n        for (const member of members) {\n          ids.add(member);\n        }\n      }\n    }\n    return ids;\n  }\n\n  private connectionMatches(connection: ConnectionState, topic: string, object?: string): boolean {\n    for (const registeredTopic of connection.topics) {\n      if (this.topicMatches(registeredTopic, topic, object)) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  private topicMatches(registeredTopic: string, eventTopic: string, object?: string): boolean {\n    return eventTopic === registeredTopic ||\n      object === registeredTopic ||\n      Boolean(object && registeredTopic.endsWith('/') && object.startsWith(registeredTopic));\n  }\n\n  private assertNewRequestId(connection: ConnectionState, requestId: string): void {\n    if (connection.seenRequestIds.has(requestId)) {\n      throw new Error(`Duplicate requestId: ${requestId}`);\n    }\n    connection.seenRequestIds.add(requestId);\n  }\n\n  private normalizeTopic(topic: string): string {\n    const url = new URL(topic, this.origin);\n    if (url.origin !== this.origin.origin) {\n      throw new Error('topic must be same-origin');\n    }\n    url.hash = '';\n    url.search = '';\n    return url.toString();\n  }\n\n  private normalizeResource(resource: string): string {\n    const url = new URL(resource, this.origin);\n    if (url.origin !== this.origin.origin) {\n      throw new Error('resource must be same-origin');\n    }\n    url.hash = '';\n    return url.toString();\n  }\n\n  private requireConnection(connectionId: string): ConnectionState {\n    const connection = this.connections.get(connectionId);\n    if (!connection) {\n      throw new Error(`Unknown notification connection: ${connectionId}`);\n    }\n    return connection;\n  }\n\n  private deviceConnectionKey(identity: DeviceNotificationIdentity, deviceSessionId: string): string {\n    return `${identity.webId}\\u0000${deviceSessionId}`;\n  }\n}\n"]}

package/dist/notifications/DeviceNotificationHub.jsonld

@@ -0,0 +1,258 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub",
+      "@type": "Class",
+      "requireElement": "DeviceNotificationHub",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub_options",
+          "range": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_origin",
+          "memberFieldName": "origin"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_maxTopicsPerConnection",
+          "memberFieldName": "maxTopicsPerConnection"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_maxQueueMessages",
+          "memberFieldName": "maxQueueMessages"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_maxReplayEvents",
+          "memberFieldName": "maxReplayEvents"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_authorizeTopic",
+          "memberFieldName": "authorizeTopic"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_connections",
+          "memberFieldName": "connections"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_connectionsByDevice",
+          "memberFieldName": "connectionsByDevice"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_topicMembers",
+          "memberFieldName": "topicMembers"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_replay",
+          "memberFieldName": "replay"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_sequence",
+          "memberFieldName": "sequence"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_openConnection",
+          "memberFieldName": "openConnection"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_hello",
+          "memberFieldName": "hello"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_registerTopics",
+          "memberFieldName": "registerTopics"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_unregisterTopics",
+          "memberFieldName": "unregisterTopics"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_ack",
+          "memberFieldName": "ack"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_publish",
+          "memberFieldName": "publish"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_resume",
+          "memberFieldName": "resume"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_closeConnection",
+          "memberFieldName": "closeConnection"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_getSeenRequestIds",
+          "memberFieldName": "getSeenRequestIds"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_getTopicMemberCount",
+          "memberFieldName": "getTopicMemberCount"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_getConnectionSnapshot",
+          "memberFieldName": "getConnectionSnapshot"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_deliver",
+          "memberFieldName": "deliver"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_deliverPendingResume",
+          "memberFieldName": "deliverPendingResume"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_enqueue",
+          "memberFieldName": "enqueue"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_coalesceEvent",
+          "memberFieldName": "coalesceEvent"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_markOverflow",
+          "memberFieldName": "markOverflow"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_pushReplay",
+          "memberFieldName": "pushReplay"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_matchingMemberIds",
+          "memberFieldName": "matchingMemberIds"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_connectionMatches",
+          "memberFieldName": "connectionMatches"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_topicMatches",
+          "memberFieldName": "topicMatches"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_assertNewRequestId",
+          "memberFieldName": "assertNewRequestId"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_normalizeTopic",
+          "memberFieldName": "normalizeTopic"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_normalizeResource",
+          "memberFieldName": "normalizeResource"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_requireConnection",
+          "memberFieldName": "requireConnection"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub__member_deviceConnectionKey",
+          "memberFieldName": "deviceConnectionKey"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHub_options"
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions",
+      "@type": "AbstractClass",
+      "requireElement": "DeviceNotificationHubOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions__member_origin",
+          "memberFieldName": "origin"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions__member_maxTopicsPerConnection",
+          "memberFieldName": "maxTopicsPerConnection"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions__member_maxQueueMessages",
+          "memberFieldName": "maxQueueMessages"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions__member_maxReplayEvents",
+          "memberFieldName": "maxReplayEvents"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationHubOptions__member_authorizeTopic",
+          "memberFieldName": "authorizeTopic"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#OpenDeviceNotificationConnectionInput",
+      "@type": "AbstractClass",
+      "requireElement": "OpenDeviceNotificationConnectionInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#OpenDeviceNotificationConnectionInput__member_identity",
+          "memberFieldName": "identity"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#OpenDeviceNotificationConnectionInput__member_deviceSessionId",
+          "memberFieldName": "deviceSessionId"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#OpenDeviceNotificationConnectionInput__member_send",
+          "memberFieldName": "send"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#OpenDeviceNotificationConnectionInput__member_close",
+          "memberFieldName": "close"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationConnectionHandle",
+      "@type": "AbstractClass",
+      "requireElement": "DeviceNotificationConnectionHandle",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationConnectionHandle__member_connectionId",
+          "memberFieldName": "connectionId"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationPublishInput",
+      "@type": "AbstractClass",
+      "requireElement": "DeviceNotificationPublishInput",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationPublishInput__member_topic",
+          "memberFieldName": "topic"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationPublishInput__member_object",
+          "memberFieldName": "object"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationHub.jsonld#DeviceNotificationPublishInput__member_operation",
+          "memberFieldName": "operation"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/notifications/DeviceNotificationResourceListener.d.ts

@@ -0,0 +1,21 @@
+import type { ResourceChangeEvent } from '../storage/ObservableResourceStore';
+import type { DeviceNotificationOperation } from './device-notification-protocol';
+export interface DeviceNotificationResourcePublisher {
+    publish(event: {
+        topic: string;
+        object?: string;
+        operation: DeviceNotificationOperation;
+    }): void;
+}
+export interface DeviceNotificationResourceListenerOptions {
+    origin: string;
+    hub: DeviceNotificationResourcePublisher;
+}
+export declare class DeviceNotificationResourceListener {
+    private readonly origin;
+    private readonly hub;
+    constructor(options: DeviceNotificationResourceListenerOptions);
+    onResourceChanged(event: ResourceChangeEvent): Promise<void>;
+    private toResourceUrl;
+    private toParentTopic;
+}