@undefineds.co/xpod 0.3.66 → 0.3.68

package/dist/notifications/DeviceNotificationResourceListener.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeviceNotificationResourceListener = void 0;
+class DeviceNotificationResourceListener {
+    constructor(options) {
+        this.origin = new URL(options.origin);
+        this.hub = options.hub;
+    }
+    async onResourceChanged(event) {
+        const object = this.toResourceUrl(event.path);
+        this.hub.publish({
+            topic: this.toParentTopic(object),
+            object,
+            operation: event.action,
+        });
+    }
+    toResourceUrl(path) {
+        try {
+            return new URL(path).toString();
+        }
+        catch {
+            return new URL(path, this.origin).toString();
+        }
+    }
+    toParentTopic(object) {
+        const url = new URL(object);
+        if (url.pathname.endsWith('/')) {
+            return url.toString();
+        }
+        const index = url.pathname.lastIndexOf('/');
+        url.pathname = index >= 0 ? url.pathname.slice(0, index + 1) : '/';
+        url.search = '';
+        url.hash = '';
+        return url.toString();
+    }
+}
+exports.DeviceNotificationResourceListener = DeviceNotificationResourceListener;
+//# sourceMappingURL=DeviceNotificationResourceListener.js.map

package/dist/notifications/DeviceNotificationResourceListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceNotificationResourceListener.js","sourceRoot":"","sources":["../../src/notifications/DeviceNotificationResourceListener.ts"],"names":[],"mappings":";;;AAYA,MAAa,kCAAkC;IAI7C,YAAmB,OAAkD;QACnE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,KAA0B;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;YACf,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YACjC,MAAM;YACN,SAAS,EAAE,KAAK,CAAC,MAAM;SACxB,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,IAAY;QAChC,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,MAAc;QAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,GAAG,CAAC,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;CACF;AArCD,gFAqCC","sourcesContent":["import type { ResourceChangeEvent } from '../storage/ObservableResourceStore';\nimport type { DeviceNotificationOperation } from './device-notification-protocol';\n\nexport interface DeviceNotificationResourcePublisher {\n  publish(event: { topic: string; object?: string; operation: DeviceNotificationOperation }): void;\n}\n\nexport interface DeviceNotificationResourceListenerOptions {\n  origin: string;\n  hub: DeviceNotificationResourcePublisher;\n}\n\nexport class DeviceNotificationResourceListener {\n  private readonly origin: URL;\n  private readonly hub: DeviceNotificationResourcePublisher;\n\n  public constructor(options: DeviceNotificationResourceListenerOptions) {\n    this.origin = new URL(options.origin);\n    this.hub = options.hub;\n  }\n\n  public async onResourceChanged(event: ResourceChangeEvent): Promise<void> {\n    const object = this.toResourceUrl(event.path);\n    this.hub.publish({\n      topic: this.toParentTopic(object),\n      object,\n      operation: event.action,\n    });\n  }\n\n  private toResourceUrl(path: string): string {\n    try {\n      return new URL(path).toString();\n    } catch {\n      return new URL(path, this.origin).toString();\n    }\n  }\n\n  private toParentTopic(object: string): string {\n    const url = new URL(object);\n    if (url.pathname.endsWith('/')) {\n      return url.toString();\n    }\n    const index = url.pathname.lastIndexOf('/');\n    url.pathname = index >= 0 ? url.pathname.slice(0, index + 1) : '/';\n    url.search = '';\n    url.hash = '';\n    return url.toString();\n  }\n}\n"]}

package/dist/notifications/DeviceNotificationResourceListener.jsonld

@@ -0,0 +1,98 @@
+{
+  "@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/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener",
+      "@type": "Class",
+      "requireElement": "DeviceNotificationResourceListener",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener_options_origin",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener_options_hub",
+          "range": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourcePublisher"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_origin",
+          "memberFieldName": "origin"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_hub",
+          "memberFieldName": "hub"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_onResourceChanged",
+          "memberFieldName": "onResourceChanged"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_toResourceUrl",
+          "memberFieldName": "toResourceUrl"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener__member_toParentTopic",
+          "memberFieldName": "toParentTopic"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "origin",
+              "value": {
+                "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener_options_origin"
+              }
+            },
+            {
+              "keyRaw": "hub",
+              "value": {
+                "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListener_options_hub"
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourcePublisher",
+      "@type": "AbstractClass",
+      "requireElement": "DeviceNotificationResourcePublisher",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourcePublisher__member_publish",
+          "memberFieldName": "publish"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListenerOptions",
+      "@type": "AbstractClass",
+      "requireElement": "DeviceNotificationResourceListenerOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListenerOptions__member_origin",
+          "memberFieldName": "origin"
+        },
+        {
+          "@id": "undefineds:dist/notifications/DeviceNotificationResourceListener.jsonld#DeviceNotificationResourceListenerOptions__member_hub",
+          "memberFieldName": "hub"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/notifications/device-notification-protocol.d.ts

@@ -0,0 +1,56 @@
+export declare const XPOD_NOTIFICATIONS_PROTOCOL = "xpod.notifications.v1";
+export type DeviceNotificationOperation = 'create' | 'update' | 'delete' | 'invalidate';
+export type DeviceNotificationClientFrame = {
+    type: 'hello';
+    protocol: typeof XPOD_NOTIFICATIONS_PROTOCOL;
+    resumeFrom?: number;
+} | {
+    type: 'register';
+    requestId: string;
+    topics: string[];
+} | {
+    type: 'unregister';
+    requestId: string;
+    topics: string[];
+} | {
+    type: 'ack';
+    sequence: number;
+};
+export type DeviceNotificationServerFrame = {
+    type: 'ready';
+    connectionId: string;
+    sequence: number;
+} | {
+    type: 'registered' | 'unregistered';
+    requestId: string;
+    topics: string[];
+} | {
+    type: 'event';
+    sequence: number;
+    eventId: string;
+    topic: string;
+    object?: string;
+    operation: DeviceNotificationOperation;
+    emittedAt: string;
+} | {
+    type: 'resync-required';
+    topics: string[];
+    reason: 'gap' | 'overflow' | 'expired';
+} | {
+    type: 'error';
+    requestId?: string;
+    code: string;
+    message: string;
+};
+export interface ParseClientFrameOptions {
+    origin?: string;
+    seenRequestIds?: Set<string>;
+    maxTopicsPerBatch?: number;
+}
+export declare function parseClientFrame(input: unknown, options?: ParseClientFrameOptions): DeviceNotificationClientFrame;
+export declare function serializeServerFrame(frame: DeviceNotificationServerFrame): string;
+export declare function createProtocolErrorFrame(code: string, message: string, requestId?: string): DeviceNotificationServerFrame;
+export declare function parseDeviceNotificationSubprotocols(header: string | string[] | undefined): {
+    protocolAccepted: boolean;
+    ticket?: string;
+};

package/dist/notifications/device-notification-protocol.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XPOD_NOTIFICATIONS_PROTOCOL = void 0;
+exports.parseClientFrame = parseClientFrame;
+exports.serializeServerFrame = serializeServerFrame;
+exports.createProtocolErrorFrame = createProtocolErrorFrame;
+exports.parseDeviceNotificationSubprotocols = parseDeviceNotificationSubprotocols;
+exports.XPOD_NOTIFICATIONS_PROTOCOL = 'xpod.notifications.v1';
+const CLIENT_FIELDS = {
+    hello: new Set(['type', 'protocol', 'resumeFrom']),
+    register: new Set(['type', 'requestId', 'topics']),
+    unregister: new Set(['type', 'requestId', 'topics']),
+    ack: new Set(['type', 'sequence']),
+};
+function parseClientFrame(input, options = {}) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error('Invalid client frame');
+    }
+    const frame = input;
+    if (typeof frame.type !== 'string' || !(frame.type in CLIENT_FIELDS)) {
+        throw new Error(`Unknown frame type: ${String(frame.type)}`);
+    }
+    rejectUnknownFields(frame, CLIENT_FIELDS[frame.type]);
+    switch (frame.type) {
+        case 'hello':
+            return parseHello(frame);
+        case 'register':
+        case 'unregister':
+            return parseTopicFrame(frame, frame.type, options);
+        case 'ack':
+            return parseAck(frame);
+        default:
+            throw new Error(`Unknown frame type: ${String(frame.type)}`);
+    }
+}
+function serializeServerFrame(frame) {
+    return JSON.stringify(frame);
+}
+function createProtocolErrorFrame(code, message, requestId) {
+    return {
+        type: 'error',
+        ...(requestId ? { requestId } : {}),
+        code,
+        message: messageContainsSecret(message) ? '[redacted]' : message,
+    };
+}
+function parseDeviceNotificationSubprotocols(header) {
+    const raw = Array.isArray(header) ? header.join(',') : header ?? '';
+    const entries = raw.split(',').map((entry) => entry.trim()).filter(Boolean);
+    return {
+        protocolAccepted: entries.includes(exports.XPOD_NOTIFICATIONS_PROTOCOL),
+        ticket: entries.find((entry) => entry !== exports.XPOD_NOTIFICATIONS_PROTOCOL),
+    };
+}
+function parseHello(frame) {
+    if (frame.protocol !== exports.XPOD_NOTIFICATIONS_PROTOCOL) {
+        throw new Error('Unsupported notification protocol');
+    }
+    if (frame.resumeFrom !== undefined && !isNonNegativeInteger(frame.resumeFrom)) {
+        throw new Error('resumeFrom must be a non-negative integer');
+    }
+    return {
+        type: 'hello',
+        protocol: exports.XPOD_NOTIFICATIONS_PROTOCOL,
+        ...(frame.resumeFrom === undefined ? {} : { resumeFrom: frame.resumeFrom }),
+    };
+}
+function parseTopicFrame(frame, type, options) {
+    if (typeof frame.requestId !== 'string' || frame.requestId.length === 0) {
+        throw new Error('requestId is required');
+    }
+    if (options.seenRequestIds?.has(frame.requestId)) {
+        throw new Error(`Duplicate requestId: ${frame.requestId}`);
+    }
+    const topics = parseTopics(frame.topics, options);
+    options.seenRequestIds?.add(frame.requestId);
+    return { type, requestId: frame.requestId, topics };
+}
+function parseAck(frame) {
+    if (!isNonNegativeInteger(frame.sequence)) {
+        throw new Error('sequence must be a non-negative integer');
+    }
+    return { type: 'ack', sequence: frame.sequence };
+}
+function parseTopics(input, options) {
+    if (!Array.isArray(input) || input.length === 0) {
+        throw new Error('topics must be a non-empty array');
+    }
+    const maxTopics = options.maxTopicsPerBatch ?? 100;
+    if (input.length > maxTopics) {
+        throw new Error(`Too many topics: ${input.length}`);
+    }
+    return input.map((topic) => parseTopic(topic, options.origin));
+}
+function parseTopic(input, origin) {
+    if (typeof input !== 'string' || input.trim().length === 0) {
+        throw new Error('topic must be a URL string');
+    }
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw new Error('topic must be an absolute URL');
+    }
+    if (!['http:', 'https:'].includes(url.protocol)) {
+        throw new Error('topic must be an HTTP URL');
+    }
+    if (origin && url.origin !== new URL(origin).origin) {
+        throw new Error('topic must be a same-origin Pod resource URL');
+    }
+    return url.toString();
+}
+function rejectUnknownFields(frame, allowed) {
+    for (const key of Object.keys(frame)) {
+        if (!allowed.has(key)) {
+            throw new Error(`Unknown field: ${key}`);
+        }
+    }
+}
+function isNonNegativeInteger(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+}
+function messageContainsSecret(message) {
+    return /token|ticket|secret|bearer/i.test(message);
+}
+//# sourceMappingURL=device-notification-protocol.js.map

package/dist/notifications/device-notification-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-notification-protocol.js","sourceRoot":"","sources":["../../src/notifications/device-notification-protocol.ts"],"names":[],"mappings":"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","sourcesContent":["export const XPOD_NOTIFICATIONS_PROTOCOL = 'xpod.notifications.v1';\n\nexport type DeviceNotificationOperation = 'create' | 'update' | 'delete' | 'invalidate';\n\nexport type DeviceNotificationClientFrame =\n  | { type: 'hello'; protocol: typeof XPOD_NOTIFICATIONS_PROTOCOL; resumeFrom?: number }\n  | { type: 'register'; requestId: string; topics: string[] }\n  | { type: 'unregister'; requestId: string; topics: string[] }\n  | { type: 'ack'; sequence: number };\n\nexport type DeviceNotificationServerFrame =\n  | { type: 'ready'; connectionId: string; sequence: number }\n  | { type: 'registered' | 'unregistered'; requestId: string; topics: string[] }\n  | {\n      type: 'event';\n      sequence: number;\n      eventId: string;\n      topic: string;\n      object?: string;\n      operation: DeviceNotificationOperation;\n      emittedAt: string;\n    }\n  | { type: 'resync-required'; topics: string[]; reason: 'gap' | 'overflow' | 'expired' }\n  | { type: 'error'; requestId?: string; code: string; message: string };\n\nexport interface ParseClientFrameOptions {\n  origin?: string;\n  seenRequestIds?: Set<string>;\n  maxTopicsPerBatch?: number;\n}\n\nconst CLIENT_FIELDS: Record<string, Set<string>> = {\n  hello: new Set(['type', 'protocol', 'resumeFrom']),\n  register: new Set(['type', 'requestId', 'topics']),\n  unregister: new Set(['type', 'requestId', 'topics']),\n  ack: new Set(['type', 'sequence']),\n};\n\nexport function parseClientFrame(input: unknown, options: ParseClientFrameOptions = {}): DeviceNotificationClientFrame {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) {\n    throw new Error('Invalid client frame');\n  }\n  const frame = input as Record<string, unknown>;\n  if (typeof frame.type !== 'string' || !(frame.type in CLIENT_FIELDS)) {\n    throw new Error(`Unknown frame type: ${String(frame.type)}`);\n  }\n  rejectUnknownFields(frame, CLIENT_FIELDS[frame.type]);\n\n  switch (frame.type) {\n    case 'hello':\n      return parseHello(frame);\n    case 'register':\n    case 'unregister':\n      return parseTopicFrame(frame, frame.type, options);\n    case 'ack':\n      return parseAck(frame);\n    default:\n      throw new Error(`Unknown frame type: ${String(frame.type)}`);\n  }\n}\n\nexport function serializeServerFrame(frame: DeviceNotificationServerFrame): string {\n  return JSON.stringify(frame);\n}\n\nexport function createProtocolErrorFrame(\n  code: string,\n  message: string,\n  requestId?: string,\n): DeviceNotificationServerFrame {\n  return {\n    type: 'error',\n    ...(requestId ? { requestId } : {}),\n    code,\n    message: messageContainsSecret(message) ? '[redacted]' : message,\n  };\n}\n\nexport function parseDeviceNotificationSubprotocols(header: string | string[] | undefined): {\n  protocolAccepted: boolean;\n  ticket?: string;\n} {\n  const raw = Array.isArray(header) ? header.join(',') : header ?? '';\n  const entries = raw.split(',').map((entry) => entry.trim()).filter(Boolean);\n  return {\n    protocolAccepted: entries.includes(XPOD_NOTIFICATIONS_PROTOCOL),\n    ticket: entries.find((entry) => entry !== XPOD_NOTIFICATIONS_PROTOCOL),\n  };\n}\n\nfunction parseHello(frame: Record<string, unknown>): DeviceNotificationClientFrame {\n  if (frame.protocol !== XPOD_NOTIFICATIONS_PROTOCOL) {\n    throw new Error('Unsupported notification protocol');\n  }\n  if (frame.resumeFrom !== undefined && !isNonNegativeInteger(frame.resumeFrom)) {\n    throw new Error('resumeFrom must be a non-negative integer');\n  }\n  return {\n    type: 'hello',\n    protocol: XPOD_NOTIFICATIONS_PROTOCOL,\n    ...(frame.resumeFrom === undefined ? {} : { resumeFrom: frame.resumeFrom as number }),\n  };\n}\n\nfunction parseTopicFrame(\n  frame: Record<string, unknown>,\n  type: 'register' | 'unregister',\n  options: ParseClientFrameOptions,\n): DeviceNotificationClientFrame {\n  if (typeof frame.requestId !== 'string' || frame.requestId.length === 0) {\n    throw new Error('requestId is required');\n  }\n  if (options.seenRequestIds?.has(frame.requestId)) {\n    throw new Error(`Duplicate requestId: ${frame.requestId}`);\n  }\n  const topics = parseTopics(frame.topics, options);\n  options.seenRequestIds?.add(frame.requestId);\n  return { type, requestId: frame.requestId, topics };\n}\n\nfunction parseAck(frame: Record<string, unknown>): DeviceNotificationClientFrame {\n  if (!isNonNegativeInteger(frame.sequence)) {\n    throw new Error('sequence must be a non-negative integer');\n  }\n  return { type: 'ack', sequence: frame.sequence as number };\n}\n\nfunction parseTopics(input: unknown, options: ParseClientFrameOptions): string[] {\n  if (!Array.isArray(input) || input.length === 0) {\n    throw new Error('topics must be a non-empty array');\n  }\n  const maxTopics = options.maxTopicsPerBatch ?? 100;\n  if (input.length > maxTopics) {\n    throw new Error(`Too many topics: ${input.length}`);\n  }\n  return input.map((topic) => parseTopic(topic, options.origin));\n}\n\nfunction parseTopic(input: unknown, origin?: string): string {\n  if (typeof input !== 'string' || input.trim().length === 0) {\n    throw new Error('topic must be a URL string');\n  }\n  let url: URL;\n  try {\n    url = new URL(input);\n  } catch {\n    throw new Error('topic must be an absolute URL');\n  }\n  if (!['http:', 'https:'].includes(url.protocol)) {\n    throw new Error('topic must be an HTTP URL');\n  }\n  if (origin && url.origin !== new URL(origin).origin) {\n    throw new Error('topic must be a same-origin Pod resource URL');\n  }\n  return url.toString();\n}\n\nfunction rejectUnknownFields(frame: Record<string, unknown>, allowed: Set<string>): void {\n  for (const key of Object.keys(frame)) {\n    if (!allowed.has(key)) {\n      throw new Error(`Unknown field: ${key}`);\n    }\n  }\n}\n\nfunction isNonNegativeInteger(value: unknown): boolean {\n  return typeof value === 'number' && Number.isInteger(value) && value >= 0;\n}\n\nfunction messageContainsSecret(message: string): boolean {\n  return /token|ticket|secret|bearer/i.test(message);\n}\n"]}

package/dist/notifications/device-notification-protocol.jsonld

@@ -0,0 +1,29 @@
+{
+  "@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/device-notification-protocol.jsonld#ParseClientFrameOptions",
+      "@type": "AbstractClass",
+      "requireElement": "ParseClientFrameOptions",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/notifications/device-notification-protocol.jsonld#ParseClientFrameOptions__member_origin",
+          "memberFieldName": "origin"
+        },
+        {
+          "@id": "undefineds:dist/notifications/device-notification-protocol.jsonld#ParseClientFrameOptions__member_seenRequestIds",
+          "memberFieldName": "seenRequestIds"
+        },
+        {
+          "@id": "undefineds:dist/notifications/device-notification-protocol.jsonld#ParseClientFrameOptions__member_maxTopicsPerBatch",
+          "memberFieldName": "maxTopicsPerBatch"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export * from './device-notification-protocol';
+export * from './DeviceNotificationHub';
+export * from './DeviceNotificationResourceListener';

package/dist/notifications/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./device-notification-protocol"), exports);
+__exportStar(require("./DeviceNotificationHub"), exports);
+__exportStar(require("./DeviceNotificationResourceListener"), exports);
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,0DAAwC;AACxC,uEAAqD","sourcesContent":["export * from './device-notification-protocol';\nexport * from './DeviceNotificationHub';\nexport * from './DeviceNotificationResourceListener';\n"]}

package/dist/storage/ObservableResourceStore.d.ts

@@ -46,6 +46,7 @@ export interface ObservableResourceStoreOptions {
  * 3. 事件异步处理，不阻塞主流程
  */
 export declare class ObservableResourceStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {
+    private static readonly globalListeners;
     protected readonly logger: import("global-logger-factory").Logger<unknown>;
     private readonly emitter;
     private readonly listeners;
@@ -54,6 +55,8 @@ export declare class ObservableResourceStore<T extends ResourceStore = ResourceS
      * 添加监听器
      */
     addListener(listener: ResourceChangeListener): void;
+    static addGlobalListener(listener: ResourceChangeListener): void;
+    static removeGlobalListener(listener: ResourceChangeListener): void;
     /**
      * 移除监听器
      */

package/dist/storage/ObservableResourceStore.js

@@ -35,6 +35,17 @@ class ObservableResourceStore extends community_server_1.PassthroughStore {
     addListener(listener) {
         this.listeners.push(listener);
     }
+    static addGlobalListener(listener) {
+        if (!this.globalListeners.includes(listener)) {
+            this.globalListeners.push(listener);
+        }
+    }
+    static removeGlobalListener(listener) {
+        const index = this.globalListeners.indexOf(listener);
+        if (index !== -1) {
+            this.globalListeners.splice(index, 1);
+        }
+    }
     /**
      * 移除监听器
      */
@@ -102,7 +113,11 @@ class ObservableResourceStore extends community_server_1.PassthroughStore {
      * 通知所有监听器
      */
     notifyListeners(event) {
-        for (const listener of this.listeners) {
+        const listeners = new Set([
+            ...ObservableResourceStore.globalListeners,
+            ...this.listeners,
+        ]);
+        for (const listener of listeners) {
             listener.onResourceChanged(event).catch((error) => {
                 this.logger.error(`Listener error for ${event.path}: ${error}`);
             });
@@ -122,4 +137,5 @@ class ObservableResourceStore extends community_server_1.PassthroughStore {
     }
 }
 exports.ObservableResourceStore = ObservableResourceStore;
+ObservableResourceStore.globalListeners = [];
 //# sourceMappingURL=ObservableResourceStore.js.map

package/dist/storage/ObservableResourceStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableResourceStore.js","sourceRoot":"","sources":["../../src/storage/ObservableResourceStore.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ObservableResourceStore - 可观察的资源存储包装器\n *\n * 在资源变更时发出事件，供订阅者（如 UsageTracker、VectorIndexer）处理。\n * 采用事件驱动模式，解耦存储操作与副作用逻辑。\n */\n\nimport { EventEmitter } from 'node:events';\nimport { PassthroughStore } from '@solid/community-server';\nimport type {\n  ChangeMap,\n  Representation,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Conditions,\n  ResourceStore,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\n/**\n * 资源变更事件类型\n */\nexport type ResourceChangeAction = 'create' | 'update' | 'delete';\n\n/**\n * 资源变更事件\n */\nexport interface ResourceChangeEvent {\n  /** 资源路径 */\n  path: string;\n  /** 变更类型 */\n  action: ResourceChangeAction;\n  /** 是否为容器 */\n  isContainer: boolean;\n  /** 变更时间戳 */\n  timestamp: number;\n}\n\n/**\n * 资源变更监听器接口\n */\nexport interface ResourceChangeListener {\n  /**\n   * 处理资源变更事件\n   * @param event 变更事件\n   */\n  onResourceChanged(event: ResourceChangeEvent): Promise<void>;\n}\n\nexport interface ObservableResourceStoreOptions {\n  /** 资源变更监听器列表 */\n  listeners?: ResourceChangeListener[];\n}\n\n/**\n * ObservableResourceStore - 在资源变更时发出事件\n *\n * 使用方式：\n * 1. 作为 Store 链的包装层\n * 2. 注册 listeners 处理变更事件\n * 3. 事件异步处理，不阻塞主流程\n */\nexport class ObservableResourceStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  protected readonly logger = getLoggerFor(this);\n  private readonly emitter = new EventEmitter();\n  private readonly listeners: ResourceChangeListener[];\n\n  public constructor(source: T, options: ObservableResourceStoreOptions = {}) {\n    super(source);\n    this.listeners = options.listeners ?? [];\n\n    // 注册内部事件处理\n    this.emitter.on('resource:changed', (event: ResourceChangeEvent) => {\n      this.notifyListeners(event);\n    });\n  }\n\n  /**\n   * 添加监听器\n   */\n  public addListener(listener: ResourceChangeListener): void {\n    this.listeners.push(listener);\n  }\n\n  /**\n   * 移除监听器\n   */\n  public removeListener(listener: ResourceChangeListener): void {\n    const index = this.listeners.indexOf(listener);\n    if (index !== -1) {\n      this.listeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * 添加资源（创建新资源）\n   */\n  public override async addResource(\n    container: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.addResource(container, representation, conditions);\n\n    // 从 ChangeMap 中获取新创建的资源路径\n    for (const [identifier] of change) {\n      this.emitChange(identifier.path, 'create');\n    }\n\n    return change;\n  }\n\n  /**\n   * 设置资源（创建或更新）\n   */\n  public override async setRepresentation(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    // 检查资源是否已存在\n    const exists = await this.resourceExists(identifier);\n    const action: ResourceChangeAction = exists ? 'update' : 'create';\n\n    const change = await super.setRepresentation(identifier, representation, conditions);\n\n    this.emitChange(identifier.path, action);\n\n    return change;\n  }\n\n  /**\n   * 删除资源\n   */\n  public override async deleteResource(\n    identifier: ResourceIdentifier,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.deleteResource(identifier, conditions);\n\n    this.emitChange(identifier.path, 'delete');\n\n    return change;\n  }\n\n  /**\n   * 修改资源（PATCH）\n   */\n  public override async modifyResource(\n    identifier: ResourceIdentifier,\n    patch: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.modifyResource(identifier, patch, conditions);\n\n    this.emitChange(identifier.path, 'update');\n\n    return change;\n  }\n\n  /**\n   * 发出资源变更事件\n   */\n  private emitChange(path: string, action: ResourceChangeAction): void {\n    const event: ResourceChangeEvent = {\n      path,\n      action,\n      isContainer: path.endsWith('/'),\n      timestamp: Date.now(),\n    };\n\n    this.logger.debug(`Resource ${action}: ${path}`);\n\n    // 异步发出事件，不阻塞主流程\n    setImmediate(() => {\n      this.emitter.emit('resource:changed', event);\n    });\n  }\n\n  /**\n   * 通知所有监听器\n   */\n  private notifyListeners(event: ResourceChangeEvent): void {\n    for (const listener of this.listeners) {\n      listener.onResourceChanged(event).catch((error) => {\n        this.logger.error(`Listener error for ${event.path}: ${error}`);\n      });\n    }\n  }\n\n  /**\n   * 检查资源是否存在\n   */\n  private async resourceExists(identifier: ResourceIdentifier): Promise<boolean> {\n    try {\n      await this.source.getRepresentation(identifier, {} as RepresentationPreferences);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"]}
+{"version":3,"file":"ObservableResourceStore.js","sourceRoot":"","sources":["../../src/storage/ObservableResourceStore.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ObservableResourceStore - 可观察的资源存储包装器\n *\n * 在资源变更时发出事件，供订阅者（如 UsageTracker、VectorIndexer）处理。\n * 采用事件驱动模式，解耦存储操作与副作用逻辑。\n */\n\nimport { EventEmitter } from 'node:events';\nimport { PassthroughStore } from '@solid/community-server';\nimport type {\n  ChangeMap,\n  Representation,\n  RepresentationPreferences,\n  ResourceIdentifier,\n  Conditions,\n  ResourceStore,\n} from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\n\n/**\n * 资源变更事件类型\n */\nexport type ResourceChangeAction = 'create' | 'update' | 'delete';\n\n/**\n * 资源变更事件\n */\nexport interface ResourceChangeEvent {\n  /** 资源路径 */\n  path: string;\n  /** 变更类型 */\n  action: ResourceChangeAction;\n  /** 是否为容器 */\n  isContainer: boolean;\n  /** 变更时间戳 */\n  timestamp: number;\n}\n\n/**\n * 资源变更监听器接口\n */\nexport interface ResourceChangeListener {\n  /**\n   * 处理资源变更事件\n   * @param event 变更事件\n   */\n  onResourceChanged(event: ResourceChangeEvent): Promise<void>;\n}\n\nexport interface ObservableResourceStoreOptions {\n  /** 资源变更监听器列表 */\n  listeners?: ResourceChangeListener[];\n}\n\n/**\n * ObservableResourceStore - 在资源变更时发出事件\n *\n * 使用方式：\n * 1. 作为 Store 链的包装层\n * 2. 注册 listeners 处理变更事件\n * 3. 事件异步处理，不阻塞主流程\n */\nexport class ObservableResourceStore<T extends ResourceStore = ResourceStore> extends PassthroughStore<T> {\n  private static readonly globalListeners: ResourceChangeListener[] = [];\n\n  protected readonly logger = getLoggerFor(this);\n  private readonly emitter = new EventEmitter();\n  private readonly listeners: ResourceChangeListener[];\n\n  public constructor(source: T, options: ObservableResourceStoreOptions = {}) {\n    super(source);\n    this.listeners = options.listeners ?? [];\n\n    // 注册内部事件处理\n    this.emitter.on('resource:changed', (event: ResourceChangeEvent) => {\n      this.notifyListeners(event);\n    });\n  }\n\n  /**\n   * 添加监听器\n   */\n  public addListener(listener: ResourceChangeListener): void {\n    this.listeners.push(listener);\n  }\n\n  public static addGlobalListener(listener: ResourceChangeListener): void {\n    if (!this.globalListeners.includes(listener)) {\n      this.globalListeners.push(listener);\n    }\n  }\n\n  public static removeGlobalListener(listener: ResourceChangeListener): void {\n    const index = this.globalListeners.indexOf(listener);\n    if (index !== -1) {\n      this.globalListeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * 移除监听器\n   */\n  public removeListener(listener: ResourceChangeListener): void {\n    const index = this.listeners.indexOf(listener);\n    if (index !== -1) {\n      this.listeners.splice(index, 1);\n    }\n  }\n\n  /**\n   * 添加资源（创建新资源）\n   */\n  public override async addResource(\n    container: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.addResource(container, representation, conditions);\n\n    // 从 ChangeMap 中获取新创建的资源路径\n    for (const [identifier] of change) {\n      this.emitChange(identifier.path, 'create');\n    }\n\n    return change;\n  }\n\n  /**\n   * 设置资源（创建或更新）\n   */\n  public override async setRepresentation(\n    identifier: ResourceIdentifier,\n    representation: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    // 检查资源是否已存在\n    const exists = await this.resourceExists(identifier);\n    const action: ResourceChangeAction = exists ? 'update' : 'create';\n\n    const change = await super.setRepresentation(identifier, representation, conditions);\n\n    this.emitChange(identifier.path, action);\n\n    return change;\n  }\n\n  /**\n   * 删除资源\n   */\n  public override async deleteResource(\n    identifier: ResourceIdentifier,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.deleteResource(identifier, conditions);\n\n    this.emitChange(identifier.path, 'delete');\n\n    return change;\n  }\n\n  /**\n   * 修改资源（PATCH）\n   */\n  public override async modifyResource(\n    identifier: ResourceIdentifier,\n    patch: Representation,\n    conditions?: Conditions,\n  ): Promise<ChangeMap> {\n    const change = await super.modifyResource(identifier, patch, conditions);\n\n    this.emitChange(identifier.path, 'update');\n\n    return change;\n  }\n\n  /**\n   * 发出资源变更事件\n   */\n  private emitChange(path: string, action: ResourceChangeAction): void {\n    const event: ResourceChangeEvent = {\n      path,\n      action,\n      isContainer: path.endsWith('/'),\n      timestamp: Date.now(),\n    };\n\n    this.logger.debug(`Resource ${action}: ${path}`);\n\n    // 异步发出事件，不阻塞主流程\n    setImmediate(() => {\n      this.emitter.emit('resource:changed', event);\n    });\n  }\n\n  /**\n   * 通知所有监听器\n   */\n  private notifyListeners(event: ResourceChangeEvent): void {\n    const listeners = new Set([\n      ...ObservableResourceStore.globalListeners,\n      ...this.listeners,\n    ]);\n    for (const listener of listeners) {\n      listener.onResourceChanged(event).catch((error) => {\n        this.logger.error(`Listener error for ${event.path}: ${error}`);\n      });\n    }\n  }\n\n  /**\n   * 检查资源是否存在\n   */\n  private async resourceExists(identifier: ResourceIdentifier): Promise<boolean> {\n    try {\n      await this.source.getRepresentation(identifier, {} as RepresentationPreferences);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@undefineds.co/xpod",
-  "version": "0.3.66",
+  "version": "0.3.68",
   "description": "Xpod is an extended Community Solid Server, offering rich-feature, production-level Solid Pod and identity management.",
   "repository": "https://github.com/undefinedsco/xpod",
   "author": "developer@undefineds.co",