@undefineds.co/xpod 0.3.67 → 0.3.69

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.67",
+  "version": "0.3.69",
   "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",