@undefineds.co/drizzle-solid 0.2.6

package/dist/esm/core/notifications/channels/base-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-channel.d.ts","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/base-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEtF;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAU3E;AAED;;GAEG;AACH,8BAAsB,WAAY,YAAW,mBAAmB;IAC9D,SAAS,CAAC,UAAU,UAAS;IAC7B,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;gBAE7B,MAAM,EAAE,aAAa;IAIjC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,IAAI,IAAI;IAE3B;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS3C;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAQzC;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,IAAI;CAM9B"}

package/dist/esm/core/notifications/channels/base-channel.js

@@ -0,0 +1,58 @@
+/**
+ * 解析 Activity Streams 2.0 消息为 NotificationEvent
+ */
+export function parseActivityStreamsMessage(data) {
+    const json = JSON.parse(data);
+    return {
+        id: json.id || json['@id'] || '',
+        type: json.type,
+        object: typeof json.object === 'string' ? json.object : json.object?.id || json.object?.['@id'] || '',
+        published: json.published || new Date().toISOString(),
+        state: json.state,
+    };
+}
+/**
+ * Channel 抽象基类
+ */
+export class BaseChannel {
+    constructor(config) {
+        this._connected = false;
+        this.config = config;
+    }
+    get connected() {
+        return this._connected;
+    }
+    /**
+     * 处理收到的消息
+     */
+    handleMessage(data) {
+        try {
+            const event = parseActivityStreamsMessage(data);
+            this.config.onNotification(event);
+        }
+        catch (error) {
+            this.handleError(new Error(`Failed to parse notification: ${error}`));
+        }
+    }
+    /**
+     * 处理错误
+     */
+    handleError(error) {
+        if (this.config.onError) {
+            this.config.onError(error);
+        }
+        else {
+            console.error('[NotificationChannel] Error:', error);
+        }
+    }
+    /**
+     * 处理连接关闭
+     */
+    handleClose() {
+        this._connected = false;
+        if (this.config.onClose) {
+            this.config.onClose();
+        }
+    }
+}
+//# sourceMappingURL=base-channel.js.map

package/dist/esm/core/notifications/channels/base-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-channel.js","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/base-channel.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;QACrG,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrD,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,OAAgB,WAAW;IAI/B,YAAY,MAAqB;QAHvB,eAAU,GAAG,KAAK,CAAC;QAI3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAKD;;OAEG;IACO,aAAa,CAAC,IAAY;QAClC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,KAAY;QAChC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACO,WAAW;QACnB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/esm/core/notifications/channels/index.d.ts

@@ -0,0 +1,4 @@
+export { BaseChannel, parseActivityStreamsMessage } from './base-channel';
+export { SSEChannel } from './sse-channel';
+export { WebSocketChannel } from './websocket-channel';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/core/notifications/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/core/notifications/channels/index.js

@@ -0,0 +1,4 @@
+export { BaseChannel, parseActivityStreamsMessage } from './base-channel';
+export { SSEChannel } from './sse-channel';
+export { WebSocketChannel } from './websocket-channel';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/notifications/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/esm/core/notifications/channels/sse-channel.d.ts

@@ -0,0 +1,50 @@
+import { BaseChannel } from './base-channel';
+import type { ChannelConfig } from '../types';
+/**
+ * SSE (Server-Sent Events) 通道实现
+ * 对应 Solid Notifications Protocol 的 StreamingHTTPChannel2023
+ *
+ * 支持两种模式：
+ * 1. 标准 SSE (text/event-stream): data: 前缀的 JSON-LD
+ * 2. CSS 直接模式 (text/turtle): 直接返回 Turtle 格式的通知
+ */
+export declare class SSEChannel extends BaseChannel {
+    private abortController;
+    private reader;
+    private contentType;
+    constructor(config: ChannelConfig);
+    connect(): Promise<void>;
+    disconnect(): void;
+    /**
+     * 读取流
+     */
+    private readStream;
+    /**
+     * 处理 Turtle 格式的缓冲区
+     * CSS 返回的 Turtle 通知以空行分隔
+     */
+    private processTurtleBuffer;
+    /**
+     * 处理标准 SSE 格式的缓冲区
+     */
+    private processSSEBuffer;
+    /**
+     * 解析 Turtle 格式的通知 (CSS 模式)
+     *
+     * 示例：
+     * <urn:xxx:topic> <https://www.w3.org/ns/activitystreams#object> <http://localhost:3000/test/>;
+     *     <http://www.w3.org/ns/solid/notifications#state> "\"etag\"";
+     *     <https://www.w3.org/ns/activitystreams#published> "2025-12-13T00:54:11.531Z"^^<xsd:dateTime>;
+     *     a <https://www.w3.org/ns/activitystreams#Update>.
+     */
+    private parseTurtleNotification;
+    /**
+     * 解析通知（自动检测格式）
+     */
+    private parseNotification;
+    /**
+     * 解析标准 SSE 消息
+     */
+    private parseSSEMessage;
+}
+//# sourceMappingURL=sse-channel.d.ts.map

package/dist/esm/core/notifications/channels/sse-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-channel.d.ts","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/sse-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE,aAAa;IAI3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B,UAAU,IAAI,IAAI;IAalB;;OAEG;YACW,UAAU;IAsCxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB"}

package/dist/esm/core/notifications/channels/sse-channel.js

@@ -0,0 +1,206 @@
+import { BaseChannel } from './base-channel';
+/**
+ * SSE (Server-Sent Events) 通道实现
+ * 对应 Solid Notifications Protocol 的 StreamingHTTPChannel2023
+ *
+ * 支持两种模式：
+ * 1. 标准 SSE (text/event-stream): data: 前缀的 JSON-LD
+ * 2. CSS 直接模式 (text/turtle): 直接返回 Turtle 格式的通知
+ */
+export class SSEChannel extends BaseChannel {
+    constructor(config) {
+        super(config);
+        this.abortController = null;
+        this.reader = null;
+        this.contentType = '';
+    }
+    async connect() {
+        if (this._connected) {
+            return;
+        }
+        this.abortController = new AbortController();
+        const fetchFn = this.config.fetch || fetch;
+        try {
+            // CSS 直接模式不需要 Accept: text/event-stream
+            // 使用 text/turtle 可以获得 Turtle 格式的通知流
+            const requestId = `notify-sse-${Date.now()}`;
+            const response = await fetchFn(this.config.receiveFrom, {
+                method: 'GET',
+                headers: {
+                    'Accept': 'text/turtle, text/event-stream',
+                    'X-Request-ID': requestId,
+                },
+                signal: this.abortController.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`SSE connection failed: ${response.status} ${response.statusText}`);
+            }
+            if (!response.body) {
+                throw new Error('SSE response has no body');
+            }
+            this.contentType = response.headers.get('content-type') || '';
+            this._connected = true;
+            this.reader = response.body.getReader();
+            this.readStream();
+        }
+        catch (error) {
+            if (error.name !== 'AbortError') {
+                this.handleError(error);
+            }
+            throw error;
+        }
+    }
+    disconnect() {
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        if (this.reader) {
+            this.reader.cancel().catch(() => { });
+            this.reader = null;
+        }
+        this._connected = false;
+        this.handleClose();
+    }
+    /**
+     * 读取流
+     */
+    async readStream() {
+        if (!this.reader)
+            return;
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (this._connected) {
+                const { done, value } = await this.reader.read();
+                if (done) {
+                    // 处理最后的缓冲区
+                    if (buffer.trim()) {
+                        this.parseNotification(buffer.trim());
+                    }
+                    this.handleClose();
+                    break;
+                }
+                const chunk = decoder.decode(value, { stream: true });
+                buffer += chunk;
+                // 根据内容类型选择解析方式
+                if (this.contentType.includes('text/turtle')) {
+                    // CSS Turtle 模式：以空行分隔通知
+                    buffer = this.processTurtleBuffer(buffer);
+                }
+                else {
+                    // 标准 SSE 模式：以 \n\n 分隔
+                    buffer = this.processSSEBuffer(buffer);
+                }
+            }
+        }
+        catch (error) {
+            if (error.name !== 'AbortError') {
+                this.handleError(error);
+            }
+        }
+    }
+    /**
+     * 处理 Turtle 格式的缓冲区
+     * CSS 返回的 Turtle 通知以空行分隔
+     */
+    processTurtleBuffer(buffer) {
+        // Turtle 通知以 "." 结尾，后跟换行
+        // 寻找完整的 Turtle 语句（以 . 结尾的行）
+        const lines = buffer.split('\n');
+        let currentNotification = '';
+        let remaining = '';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            currentNotification += line + '\n';
+            // 检查是否是完整的 Turtle 语句（以 . 结尾）
+            if (line.trim().endsWith('.')) {
+                // 完整的通知，解析它
+                this.parseTurtleNotification(currentNotification.trim());
+                currentNotification = '';
+            }
+        }
+        // 返回未完成的部分
+        return currentNotification;
+    }
+    /**
+     * 处理标准 SSE 格式的缓冲区
+     */
+    processSSEBuffer(buffer) {
+        const messages = buffer.split('\n\n');
+        const remaining = messages.pop() || '';
+        for (const message of messages) {
+            if (message.trim()) {
+                this.parseSSEMessage(message);
+            }
+        }
+        return remaining;
+    }
+    /**
+     * 解析 Turtle 格式的通知 (CSS 模式)
+     *
+     * 示例：
+     * <urn:xxx:topic> <https://www.w3.org/ns/activitystreams#object> <http://localhost:3000/test/>;
+     *     <http://www.w3.org/ns/solid/notifications#state> "\"etag\"";
+     *     <https://www.w3.org/ns/activitystreams#published> "2025-12-13T00:54:11.531Z"^^<xsd:dateTime>;
+     *     a <https://www.w3.org/ns/activitystreams#Update>.
+     */
+    parseTurtleNotification(turtle) {
+        try {
+            // 提取关键信息
+            const objectMatch = turtle.match(/<https:\/\/www\.w3\.org\/ns\/activitystreams#object>\s*<([^>]+)>/);
+            const typeMatch = turtle.match(/a\s*<https:\/\/www\.w3\.org\/ns\/activitystreams#(\w+)>/);
+            const publishedMatch = turtle.match(/<https:\/\/www\.w3\.org\/ns\/activitystreams#published>\s*"([^"]+)"/);
+            const stateMatch = turtle.match(/<http:\/\/www\.w3\.org\/ns\/solid\/notifications#state>\s*"([^"]+)"/);
+            const idMatch = turtle.match(/^<([^>]+)>/);
+            if (!objectMatch || !typeMatch) {
+                // 不是有效的通知，忽略
+                return;
+            }
+            const notification = {
+                id: idMatch?.[1] || `urn:notification:${Date.now()}`,
+                type: typeMatch[1],
+                object: objectMatch[1],
+                published: publishedMatch?.[1] || new Date().toISOString(),
+                state: stateMatch?.[1],
+            };
+            this.handleMessage(JSON.stringify(notification));
+        }
+        catch (error) {
+            console.warn('[SSE] Failed to parse Turtle notification:', error);
+        }
+    }
+    /**
+     * 解析通知（自动检测格式）
+     */
+    parseNotification(data) {
+        if (data.startsWith('{')) {
+            // JSON 格式
+            this.handleMessage(data);
+        }
+        else if (data.includes('activitystreams')) {
+            // Turtle 格式
+            this.parseTurtleNotification(data);
+        }
+    }
+    /**
+     * 解析标准 SSE 消息
+     */
+    parseSSEMessage(message) {
+        const lines = message.split('\n');
+        let data = '';
+        let eventType = 'message';
+        for (const line of lines) {
+            if (line.startsWith('data:')) {
+                data += line.slice(5).trim();
+            }
+            else if (line.startsWith('event:')) {
+                eventType = line.slice(6).trim();
+            }
+        }
+        if (data && eventType === 'message') {
+            this.handleMessage(data);
+        }
+    }
+}
+//# sourceMappingURL=sse-channel.js.map

package/dist/esm/core/notifications/channels/sse-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-channel.js","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/sse-channel.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/notifications/channels/websocket-channel.d.ts

@@ -0,0 +1,16 @@
+import { BaseChannel } from './base-channel';
+import type { ChannelConfig } from '../types';
+/**
+ * WebSocket 通道实现
+ * 对应 Solid Notifications Protocol 的 WebSocketChannel2023
+ */
+export declare class WebSocketChannel extends BaseChannel {
+    private ws;
+    private reconnectAttempts;
+    private readonly maxReconnectAttempts;
+    private readonly reconnectDelay;
+    constructor(config: ChannelConfig);
+    connect(): Promise<void>;
+    disconnect(): void;
+}
+//# sourceMappingURL=websocket-channel.d.ts.map

package/dist/esm/core/notifications/channels/websocket-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-channel.d.ts","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/websocket-channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAiB9C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,MAAM,EAAE,aAAa;IAI3B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD9B,UAAU,IAAI,IAAI;CAQnB"}

package/dist/esm/core/notifications/channels/websocket-channel.js

@@ -0,0 +1,83 @@
+import { BaseChannel } from './base-channel';
+// 兼容 Node.js 和浏览器环境
+const getWebSocket = () => {
+    if (typeof WebSocket !== 'undefined') {
+        return WebSocket;
+    }
+    // Node.js 环境，动态导入 ws
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ws = require('ws');
+        return ws;
+    }
+    catch {
+        throw new Error('WebSocket is not available. Install "ws" package for Node.js support.');
+    }
+};
+/**
+ * WebSocket 通道实现
+ * 对应 Solid Notifications Protocol 的 WebSocketChannel2023
+ */
+export class WebSocketChannel extends BaseChannel {
+    constructor(config) {
+        super(config);
+        this.ws = null;
+        this.reconnectAttempts = 0;
+        this.maxReconnectAttempts = 3;
+        this.reconnectDelay = 1000; // ms
+    }
+    async connect() {
+        if (this._connected) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            try {
+                const WebSocketImpl = getWebSocket();
+                this.ws = new WebSocketImpl(this.config.receiveFrom);
+                this.ws.onopen = () => {
+                    this._connected = true;
+                    this.reconnectAttempts = 0;
+                    resolve();
+                };
+                this.ws.onmessage = (event) => {
+                    const data = typeof event.data === 'string'
+                        ? event.data
+                        : event.data?.toString?.() || '';
+                    this.handleMessage(data);
+                };
+                this.ws.onerror = () => {
+                    const error = new Error('WebSocket error');
+                    this.handleError(error);
+                    if (!this._connected) {
+                        reject(error);
+                    }
+                };
+                this.ws.onclose = (event) => {
+                    this._connected = false;
+                    if (!event.wasClean && this.reconnectAttempts < this.maxReconnectAttempts) {
+                        // 尝试重连
+                        this.reconnectAttempts++;
+                        setTimeout(() => {
+                            this.connect().catch(() => { });
+                        }, this.reconnectDelay * this.reconnectAttempts);
+                    }
+                    else {
+                        this.handleClose();
+                    }
+                };
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    disconnect() {
+        this.reconnectAttempts = this.maxReconnectAttempts; // 防止重连
+        if (this.ws) {
+            this.ws.close(1000, 'Client disconnect');
+            this.ws = null;
+        }
+        this._connected = false;
+    }
+}
+//# sourceMappingURL=websocket-channel.js.map

package/dist/esm/core/notifications/channels/websocket-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-channel.js","sourceRoot":"","sources":["../../../../../src/core/notifications/channels/websocket-channel.ts"],"names":[],"mappings":"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"}

package/dist/esm/core/notifications/index.d.ts

@@ -0,0 +1,3 @@
+export { NotificationsClient, type NotificationsClientConfig } from './notifications-client';
+export type { Activity, ActivityObject, NotificationEvent, NotificationType, ChannelType, SubscribeOptions, TableSubscribeOptions, EntitySubscribeOptions, Subscription, SubscriptionFeature, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/core/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,YAAY,EACV,QAAQ,EACR,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/esm/core/notifications/index.js

@@ -0,0 +1,2 @@
+export { NotificationsClient } from './notifications-client';
+//# sourceMappingURL=index.js.map

package/dist/esm/core/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/notifications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAkC,MAAM,wBAAwB,CAAC"}

package/dist/esm/core/notifications/notifications-client.d.ts

@@ -0,0 +1,87 @@
+import type { ChannelType, SubscribeOptions, Subscription, NotificationChannel } from './types';
+interface DiscoveredService {
+    baseEndpoint: string;
+    supportedChannels: ChannelType[];
+}
+export interface NotificationsClientConfig {
+    /** 通道偏好顺序，默认 ['streaming-http', 'websocket'] */
+    preferredChannels?: ChannelType[];
+}
+/**
+ * Solid Notifications 客户端
+ *
+ * 支持两种通道：
+ * - streaming-http (SSE): CSS 直接连接模式，无需订阅
+ * - websocket: 标准订阅模式，POST 获取 receiveFrom
+ *
+ * 特性：
+ * - 自动重连：当连接断开时（如 xpod node_id 切换），自动重新订阅
+ * - 指数退避：重连延迟采用指数退避策略，避免服务器过载
+ */
+export declare class NotificationsClient {
+    private readonly fetch;
+    private readonly subscriptions;
+    private readonly preferredChannels;
+    constructor(authenticatedFetch: typeof globalThis.fetch, config?: NotificationsClientConfig);
+    /**
+     * 订阅资源变化
+     */
+    subscribe(topic: string, options: SubscribeOptions): Promise<Subscription>;
+    /**
+     * 重新订阅（内部方法，用于自动重连）
+     * @internal
+     */
+    resubscribe(topic: string, channelType: ChannelType, discovery: DiscoveredService, options: SubscribeOptions): Promise<NotificationChannel>;
+    /**
+     * 连接到指定通道
+     */
+    private connectChannel;
+    /**
+     * 构建 SSE 直接连接 URL (CSS 模式)
+     * 格式: /.notifications/StreamingHTTPChannel2023/{encodeURIComponent(topic)}
+     */
+    private buildSSEDirectUrl;
+    /**
+     * 取消所有订阅
+     */
+    unsubscribeAll(): void;
+    /**
+     * 发现资源的 notifications 服务
+     *
+     * 发现顺序:
+     * 1. 从 HEAD 请求的 Link header 直接获取通知端点
+     * 2. 从 storage description (.well-known/solid) 获取
+     * 3. 回退到默认的 /.notifications/ 路径
+     */
+    private discoverNotificationService;
+    /**
+     * 从 HEAD 请求的 Link header 发现通知端点
+     *
+     * CSS 在 Link header 中提供:
+     * - solid:updatesViaStreamingHttp2023 - SSE 端点
+     * - (WebSocket 通常也可用，但不在 Link header 中公开)
+     */
+    private discoverFromLinkHeader;
+    /**
+     * 查找资源的存储根 URL
+     */
+    private findStorageRoot;
+    /**
+     * 获取 storage description 并提取 notifications 端点
+     */
+    private fetchStorageDescription;
+    /**
+     * 创建 WebSocket 订阅（POST 请求）
+     */
+    private createSubscription;
+    /**
+     * 创建通道实例
+     */
+    private createChannel;
+    /**
+     * 创建带自动重连支持的通道实例
+     */
+    private createChannelWithReconnect;
+}
+export {};
+//# sourceMappingURL=notifications-client.d.ts.map

package/dist/esm/core/notifications/notifications-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-client.d.ts","sourceRoot":"","sources":["../../../../src/core/notifications/notifications-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EAEZ,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAoBjB,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,WAAW,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;gBAGhD,kBAAkB,EAAE,OAAO,UAAU,CAAC,KAAK,EAC3C,MAAM,CAAC,EAAE,yBAAyB;IAMpC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IA+BhF;;;OAGG;IACG,WAAW,CACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAiC/B;;OAEG;YACW,cAAc;IAqD5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;;;;;;OAOG;YACW,2BAA2B;IAuBzC;;;;;;OAMG;YACW,sBAAsB;IA0DpC;;OAEG;YACW,eAAe;IA0B7B;;OAEG;YACW,uBAAuB;IAyDrC;;OAEG;YACW,kBAAkB;IAkChC;;OAEG;IACH,OAAO,CAAC,aAAa;IAuBrB;;OAEG;IACH,OAAO,CAAC,0BAA0B;CA8BnC"}