@rowger_go/chatu 0.1.3

package/dist/sdk/core/channel.js

@@ -0,0 +1,158 @@
+"use strict";
+/******************************************************************
+ * Channel SDK - Channel Class
+ *
+ * OpenClaw Channel SDK 的核心 Channel 类
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Channel = void 0;
+const channel_1 = require("../types/channel");
+const default_1 = require("../adapters/default");
+/**
+ * Channel 类 [Channel SDK 标准]
+ *
+ * Channel 的核心管理类，处理连接、消息收发等
+ *
+ * @example
+ * ```typescript
+ * const channel = new Channel({
+ *   config: {
+ *     channelId: 'wh_ch_xxx',
+ *     accessToken: 'token_xxx',
+ *   }
+ * });
+ *
+ * channel.connect();
+ * channel.onMessage((msg) => {
+ *   console.log('收到消息:', msg);
+ * });
+ * ```
+ */
+class Channel {
+    /** 是否已连接 [Channel SDK 标准] */
+    get isConnected() {
+        return this.connectionAdapter.status === 'connected';
+    }
+    /** 当前状态 [Channel SDK 标准] */
+    get status() {
+        return this.connectionAdapter.status;
+    }
+    /**
+     * 创建 Channel 实例 [Channel SDK 标准]
+     */
+    constructor(options) {
+        /** 统计信息 [Channel SDK 标准] */
+        this._stats = {
+            messagesSent: 0,
+            messagesReceived: 0,
+            connectedDuration: 0,
+            lastActiveAt: Date.now(),
+        };
+        this.config = {
+            heartbeatInterval: 30000,
+            heartbeatTimeout: 10000,
+            maxReconnectAttempts: 3,
+            ...options.config,
+        };
+        this.adapterFactory = options.adapterFactory || (0, default_1.createDefaultFactory)();
+        this.connectionAdapter = this.adapterFactory.createConnectionAdapter(this.config);
+        this.messageCallbacks = new Set();
+        this.statusCallbacks = new Set();
+        // 设置回调
+        this.connectionAdapter.onMessage((message) => {
+            this._stats.messagesReceived++;
+            this._stats.lastActiveAt = Date.now();
+            this.messageCallbacks.forEach((cb) => cb(message));
+        });
+        this.connectionAdapter.onStatusChange((status, error) => {
+            this.statusCallbacks.forEach((cb) => cb(status, error));
+        });
+    }
+    /**
+     * 连接到 Channel 服务 [Channel SDK 标准]
+     */
+    async connect() {
+        await this.connectionAdapter.connect();
+    }
+    /**
+     * 断开连接 [Channel SDK 标准]
+     */
+    async disconnect() {
+        await this.connectionAdapter.disconnect();
+    }
+    /**
+     * 发送消息 [Channel SDK 标准]
+     */
+    async send(message) {
+        const result = await this.connectionAdapter.send(message);
+        if (result.success) {
+            this._stats.messagesSent++;
+            this._stats.lastActiveAt = Date.now();
+        }
+        return result;
+    }
+    /**
+     * 发送文本消息 [Channel SDK 标准]
+     */
+    async sendText(targetId, text, options) {
+        return this.send({
+            target: {
+                type: options?.type || channel_1.TargetType.USER,
+                id: targetId,
+            },
+            content: {
+                text,
+                format: 'plain',
+            },
+            replyTo: options?.replyTo,
+        });
+    }
+    /**
+     * 订阅消息 [Channel SDK 标准]
+     */
+    onMessage(callback) {
+        this.messageCallbacks.add(callback);
+        // 返回取消订阅函数
+        return () => {
+            this.messageCallbacks.delete(callback);
+        };
+    }
+    /**
+     * 订阅状态变化 [Channel SDK 标准]
+     */
+    onStatusChange(callback) {
+        this.statusCallbacks.add(callback);
+        return () => {
+            this.statusCallbacks.delete(callback);
+        };
+    }
+    /**
+     * 获取统计信息 [Channel SDK 标准]
+     */
+    async getStats() {
+        const adapterStats = await this.connectionAdapter.getStats();
+        return {
+            ...this._stats,
+            ...adapterStats,
+        };
+    }
+    /**
+     * 获取能力 [Channel SDK 标准]
+     */
+    async getCapabilities() {
+        const adapter = this.adapterFactory.createCapabilitiesAdapter();
+        return adapter.getCapabilities();
+    }
+    /**
+     * 销毁 Channel [Channel SDK 标准]
+     */
+    async destroy() {
+        await this.disconnect();
+        this.messageCallbacks.clear();
+        this.statusCallbacks.clear();
+    }
+}
+exports.Channel = Channel;
+//# sourceMappingURL=channel.js.map

package/dist/sdk/core/channel.js.map

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

package/dist/sdk/index.d.ts

@@ -0,0 +1,27 @@
+/******************************************************************
+ * Channel SDK - Entry Point
+ *
+ * OpenClaw Channel SDK 入口文件
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+export * from './types/channel';
+export * from './types/adapters';
+export * from './core/channel';
+export * from './adapters/websocket';
+export * from './adapters/default';
+export * from './adapters/webhub';
+/******************************************************************
+ * Channel SDK - Message Class (Placeholder)
+ ******************************************************************/
+export interface Message {
+    id: string;
+    content: string;
+}
+/******************************************************************
+ * Channel SDK - Connection Class (Placeholder)
+ ******************************************************************/
+export interface Connection {
+    status: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;oEAMoE;AAGpE,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC;;oEAEoE;AAEpE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;oEAEoE;AAEpE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/sdk/index.js

@@ -0,0 +1,33 @@
+"use strict";
+/******************************************************************
+ * Channel SDK - Entry Point
+ *
+ * OpenClaw Channel SDK 入口文件
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+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("./types/channel"), exports);
+__exportStar(require("./types/adapters"), exports);
+// 导出核心类
+__exportStar(require("./core/channel"), exports);
+// 导出适配器
+__exportStar(require("./adapters/websocket"), exports);
+__exportStar(require("./adapters/default"), exports);
+__exportStar(require("./adapters/webhub"), exports);
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":";AAAA;;;;;;oEAMoE;;;;;;;;;;;;;;;;AAEpE,OAAO;AACP,kDAAgC;AAChC,mDAAiC;AAEjC,QAAQ;AACR,iDAA+B;AAE/B,QAAQ;AACR,uDAAqC;AACrC,qDAAmC;AACnC,oDAAkC"}

package/dist/sdk/types/adapters.d.ts

@@ -0,0 +1,128 @@
+/******************************************************************
+ * Channel SDK - Adapter Types
+ *
+ * OpenClaw Channel SDK 的适配器接口定义
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+import type { InboundMessage, OutboundMessage, SendResult, ConnectionConfig, ConnectionStatus, ChannelStats, ChannelCapabilities } from './channel';
+/**
+ * 消息回调 [Channel SDK 标准]
+ */
+export type MessageCallback = (message: InboundMessage) => void;
+/**
+ * 状态回调 [Channel SDK 标准]
+ */
+export type StatusCallback = (status: ConnectionStatus, error?: Error) => void;
+/**
+ * 连接适配器接口 [Channel SDK 标准]
+ *
+ * 负责管理与目标服务的连接
+ */
+export interface ConnectionAdapter {
+    /** 连接配置 [Channel SDK 标准] */
+    config: ConnectionConfig;
+    /** 当前状态 [Channel SDK 标准] */
+    status: ConnectionStatus;
+    /** 连接 [Channel SDK 标准] */
+    connect(): Promise<void>;
+    /** 断开连接 [Channel SDK 标准] */
+    disconnect(): Promise<void>;
+    /** 发送消息 [Channel SDK 标准] */
+    send(message: OutboundMessage): Promise<SendResult>;
+    /** 订阅消息 [Channel SDK 标准] */
+    onMessage(callback: MessageCallback): void;
+    /** 订阅状态变化 [Channel SDK 标准] */
+    onStatusChange(callback: StatusCallback): void;
+    /** 获取连接统计 [Channel SDK 标准] */
+    getStats(): Promise<ChannelStats>;
+}
+/**
+ * 消息处理适配器接口 [Channel SDK 标准]
+ *
+ * 负责消息的解析和格式化
+ */
+export interface MessageAdapter {
+    /** 解析入站消息 [Channel SDK 标准] */
+    parseInbound(raw: unknown): InboundMessage;
+    /** 格式化出站消息 [Channel SDK 标准] */
+    formatOutbound(message: OutboundMessage): unknown;
+    /** 验证消息 [Channel SDK 标准] */
+    validate(message: InboundMessage | OutboundMessage): boolean;
+    /** 清理消息 [Channel SDK 标准] */
+    sanitize(text: string): string;
+}
+/**
+ * 心跳适配器接口 [Channel SDK 标准]
+ *
+ * 负责心跳检测和管理
+ */
+export interface HeartbeatAdapter {
+    /** 发送心跳 [Channel SDK 标准] */
+    send(): Promise<boolean>;
+    /** 处理心跳响应 [Channel SDK 标准] */
+    handleResponse(): void;
+    /** 检查是否超时 [Channel SDK 标准] */
+    isTimeout(): boolean;
+    /** 获取下次心跳时间 [Channel SDK 标准] */
+    getNextHeartbeatTime(): number;
+}
+/**
+ * 认证适配器接口 [Channel SDK 标准]
+ *
+ * 负责身份验证和授权
+ */
+export interface AuthAdapter {
+    /** 获取认证头 [Channel SDK 标准] */
+    getAuthHeaders(): Record<string, string>;
+    /** 验证响应 [Channel SDK 标准] */
+    validateResponse(response: unknown): boolean;
+    /** 刷新令牌 [Channel SDK 标准] */
+    refreshToken(): Promise<boolean>;
+}
+/**
+ * 能力查询适配器接口 [Channel SDK 标准]
+ *
+ * 负责查询 Channel 能力
+ */
+export interface CapabilitiesAdapter {
+    /** 获取能力 [Channel SDK 标准] */
+    getCapabilities(): Promise<ChannelCapabilities>;
+    /** 检查能力 [Channel SDK 标准] */
+    hasCapability(capability: keyof ChannelCapabilities): boolean;
+}
+/**
+ * 日志适配器接口 [Channel SDK 标准]
+ *
+ * 负责日志记录
+ */
+export interface LoggerAdapter {
+    /** 调试日志 [Channel SDK 标准] */
+    debug(message: string, data?: unknown): void;
+    /** 信息日志 [Channel SDK 标准] */
+    info(message: string, data?: unknown): void;
+    /** 警告日志 [Channel SDK 标准] */
+    warn(message: string, data?: unknown): void;
+    /** 错误日志 [Channel SDK 标准] */
+    error(message: string, error?: Error): void;
+}
+/**
+ * 适配器工厂接口 [Channel SDK 标准]
+ *
+ * 负责创建和管理适配器
+ */
+export interface AdapterFactory {
+    /** 创建连接适配器 [Channel SDK 标准] */
+    createConnectionAdapter(config: ConnectionConfig): ConnectionAdapter;
+    /** 创建消息适配器 [Channel SDK 标准] */
+    createMessageAdapter(): MessageAdapter;
+    /** 创建心跳适配器 [Channel SDK 标准] */
+    createHeartbeatAdapter(): HeartbeatAdapter;
+    /** 创建认证适配器 [Channel SDK 标准] */
+    createAuthAdapter(): AuthAdapter;
+    /** 创建能力适配器 [Channel SDK 标准] */
+    createCapabilitiesAdapter(): CapabilitiesAdapter;
+    /** 创建日志适配器 [Channel SDK 标准] */
+    createLoggerAdapter(): LoggerAdapter;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/sdk/types/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/sdk/types/adapters.ts"],"names":[],"mappings":"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"}

package/dist/sdk/types/adapters.js

@@ -0,0 +1,10 @@
+"use strict";
+/******************************************************************
+ * Channel SDK - Adapter Types
+ *
+ * OpenClaw Channel SDK 的适配器接口定义
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=adapters.js.map

package/dist/sdk/types/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../../src/sdk/types/adapters.ts"],"names":[],"mappings":";AAAA;;;;;;oEAMoE"}

package/dist/sdk/types/channel.d.ts

@@ -0,0 +1,270 @@
+/******************************************************************
+ * Channel SDK - Channel Types
+ *
+ * OpenClaw Channel SDK 的核心类型定义
+ *
+ * @see https://github.com/chatu-ai/openclaw-web-hub-channel
+ ******************************************************************/
+/**
+ * 连接状态 [Channel SDK 标准]
+ */
+export type ConnectionStatus = 'connecting' | 'connected' | 'disconnected' | 'error';
+/**
+ * 消息类型 [Channel SDK 标准]
+ */
+export declare enum MessageType {
+    TEXT = "text",
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    FILE = "file",
+    LOCATION = "location",
+    /** Plugin-Channel Realtime: operation/command type */
+    ACTION = "action",
+    /** Plugin-Channel Realtime: unrecognised type, frontend renders placeholder */
+    UNKNOWN = "unknown"
+}
+/**
+ * 目标类型 [Channel SDK 标准]
+ */
+export declare enum TargetType {
+    USER = "user",
+    GROUP = "group",
+    CHANNEL = "channel"
+}
+/**
+ * 消息发送者 [Channel SDK 标准]
+ */
+export interface Sender {
+    /** 发送者 ID [Channel SDK 标准] */
+    id: string;
+    /** 发送者显示名 [Channel SDK 标准] */
+    displayName?: string;
+    /** 发送者头像 URL [Channel SDK 标准] */
+    avatarUrl?: string;
+    /** 是否为机器人 [Channel SDK 标准] */
+    isBot?: boolean;
+}
+/**
+ * 消息目标 [Channel SDK 标准]
+ */
+export interface Target {
+    /** 目标类型 [Channel SDK 标准] */
+    type: TargetType;
+    /** 目标 ID [Channel SDK 标准] */
+    id: string;
+    /** 目标名称 [Channel SDK 标准] */
+    name?: string;
+}
+/**
+ * 媒体附件 [Channel SDK 标准]
+ */
+export interface Media {
+    /** 媒体类型 [Channel SDK 标准] */
+    type: MessageType;
+    /** 媒体 URL [Channel SDK 标准] */
+    url: string;
+    /** MIME 类型 [Channel SDK 标准] */
+    mimeType?: string;
+    /** 文件大小（字节）[Channel SDK 标准] */
+    size?: number;
+    /** 图片/视频宽度 [Channel SDK 标准] */
+    width?: number;
+    /** 图片/视频高度 [Channel SDK 标准] */
+    height?: number;
+    /** 音视频时长（秒）[Channel SDK 标准] */
+    duration?: number;
+    /** 缩略图 URL [Channel SDK 标准] */
+    thumbnailUrl?: string;
+}
+/**
+ * 消息内容 [Channel SDK 标准]
+ */
+export interface MessageContent {
+    /** 文本内容 [Channel SDK 标准] */
+    text: string;
+    /** 文本格式 [Channel SDK 标准] */
+    format?: 'plain' | 'markdown' | 'html';
+}
+/**
+ * 消息回复 [Channel SDK 标准]
+ */
+export interface MessageReply {
+    /** 回复的消息 ID [Channel SDK 标准] */
+    messageId: string;
+    /** 引用的文本 [Channel SDK 标准] */
+    quotedText?: string;
+}
+/**
+ * 入站消息 [Channel SDK 标准]
+ */
+export interface InboundMessage {
+    /** 消息 ID [Channel SDK 标准] */
+    id: string;
+    /** 通道 ID [Channel SDK 标准] */
+    channelId: string;
+    /** 发送者 [Channel SDK 标准] */
+    sender: Sender;
+    /** 目标 [Channel SDK 标准] */
+    target: Target;
+    /** 消息内容 [Channel SDK 标准] */
+    content: MessageContent;
+    /** 媒体附件 [Channel SDK 标准] */
+    media?: Media[];
+    /** 回复 [Channel SDK 标准] */
+    replyTo?: MessageReply;
+    /** 时间戳 [Channel SDK 标准] */
+    timestamp: number;
+    /** 元数据 [Channel SDK 标准] */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 出站消息 [Channel SDK 标准]
+ */
+export interface OutboundMessage {
+    /** 消息 ID [Channel SDK 标准] */
+    messageId?: string;
+    /** 目标 [Channel SDK 标准] */
+    target: Target;
+    /** 消息内容 [Channel SDK 标准] */
+    content: MessageContent;
+    /** 媒体附件 [Channel SDK 标准] */
+    media?: Media[];
+    /** 回复 [Channel SDK 标准] */
+    replyTo?: string;
+    /** 消息标记 [Channel SDK 标准] */
+    flags?: {
+        /** 静默发送 [Channel SDK 标准] */
+        silent?: boolean;
+        /** 紧急消息 [Channel SDK 标准] */
+        urgent?: boolean;
+    };
+    /** 元数据 [Channel SDK 标准] */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 发送结果 [Channel SDK 标准]
+ */
+export interface SendResult {
+    /** 消息 ID [Channel SDK 标准] */
+    messageId: string;
+    /** 是否成功 [Channel SDK 标准] */
+    success: boolean;
+    /** 时间戳 [Channel SDK 标准] */
+    timestamp: number;
+    /** 错误信息 [Channel SDK 标准] */
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * 连接配置 [Channel SDK 标准]
+ */
+export interface ConnectionConfig {
+    /** Channel ID [Channel SDK 标准] */
+    channelId: string;
+    /** 访问令牌 [Channel SDK 标准] */
+    accessToken: string;
+    /** WebHub Backend URL (配置时设置) */
+    webhubUrl?: string;
+    /** Webhook URL [Channel SDK 标准] */
+    webhookUrl?: string;
+    /** WebSocket URL [Channel SDK 标准] */
+    wsUrl?: string;
+    /** 心跳间隔（毫秒）[Channel SDK 标准] */
+    heartbeatInterval?: number;
+    /** 心跳超时（毫秒）[Channel SDK 标准] */
+    heartbeatTimeout?: number;
+    /** 最大重连次数 [Channel SDK 标准] */
+    maxReconnectAttempts?: number;
+    /** Plugin-Channel Realtime: connection mode, 'user' | 'group' (future) */
+    mode?: 'user' | 'group';
+}
+/**
+ * Channel 统计信息 [Channel SDK 标准]
+ */
+export interface ChannelStats {
+    /** 发送消息数 [Channel SDK 标准] */
+    messagesSent: number;
+    /** 接收消息数 [Channel SDK 标准] */
+    messagesReceived: number;
+    /** 连接时长（秒）[Channel SDK 标准] */
+    connectedDuration: number;
+    /** 最后活跃时间 [Channel SDK 标准] */
+    lastActiveAt: number;
+    /** 连接模式 (WebHub 扩展) */
+    mode?: string;
+}
+/**
+ * Channel 能力 [Channel SDK 标准]
+ */
+export interface ChannelCapabilities {
+    /** 支持的消息类型 [Channel SDK 标准] */
+    messageTypes: MessageType[];
+    /** 支持的目标类型 [Channel SDK 标准] */
+    targetTypes: TargetType[];
+    /** 支持富文本格式 [Channel SDK 标准] */
+    richFormats?: ('markdown' | 'html')[];
+    /** 支持附件 [Channel SDK 标准] */
+    attachments?: boolean;
+    /** 支持回复 [Channel SDK 标准] */
+    reply?: boolean;
+    /** 支持消息编辑 [Channel SDK 标准] */
+    edit?: boolean;
+    /** 支持消息删除 [Channel SDK 标准] */
+    delete?: boolean;
+    /** 支持表情反应 [Channel SDK 标准] */
+    reactions?: boolean;
+    /** 支持投票 [Channel SDK 标准] */
+    polls?: boolean;
+    /** 支持按钮 [Channel SDK 标准] */
+    buttons?: boolean;
+}
+/**
+ * T005: Content type for multi-type message rendering (mirrors API MessageContentType).
+ */
+export type MessageContentType = 'text' | 'image' | 'file' | 'action' | 'unknown';
+/**
+ * T005: Payload for a single streaming chunk, sent to API via POST /api/channel/stream/chunk.
+ */
+export interface StreamChunkPayload {
+    /** Unique message ID (UUID v4) */
+    messageId: string;
+    /** Monotonically increasing sequence number (0-based) */
+    seq: number;
+    /** Incremental text delta from this chunk */
+    delta: string;
+}
+/**
+ * T005: Payload for the streaming completion frame, POST /api/channel/stream/done.
+ */
+export interface StreamDonePayload {
+    /** Same messageId as the preceding chunks */
+    messageId: string;
+    /** Total number of chunks sent (for frontend sequence validation) */
+    totalSeq: number;
+}
+/**
+ * T005: A single cached message entry on the plugin side.
+ */
+export interface PluginCacheEntry {
+    /** Message ID (UUID v4) — idempotency key */
+    messageId: string;
+    /** Serialised outbound message payload */
+    payload: string;
+    /** Unix ms timestamp when cached */
+    cachedAt: number;
+    /** Whether the message has been acknowledged by the API */
+    acked?: boolean;
+}
+/**
+ * T005: Root structure of the plugin-side message cache JSON file
+ * (default: ~/.openclaw/chatu/message_cache.json).
+ */
+export interface PluginMessageCacheFile {
+    version: 1;
+    entries: PluginCacheEntry[];
+    updatedAt: number;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/sdk/types/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/sdk/types/channel.ts"],"names":[],"mappings":"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"}