@gravito/radiance 1.0.3 → 1.0.5

package/dist/core/src/transpiler-utils.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @fileoverview Transpiler 工具庫 - AST 層級代碼分析
+ *
+ * 使用 Bun.Transpiler API 進行精確的 handler 函式分析，
+ * 相比傳統字串匹配，精確度從 ~85% 提升至 ~99%。
+ *
+ * 核心策略：
+ * 1. 使用 transformSync() 標準化代碼格式（統一縮排、引號等）
+ * 2. 對轉換後的代碼使用精確的正規表達式匹配 member expression
+ * 3. 區分 API 呼叫（.req.header()）與變數名稱（const header = ...）
+ * 4. 支援解構賦值模式（const { header } = ctx.req）
+ * 5. 快取 Transpiler 實例（性能提升 5.9x）+ LRU 快取結果（額外 128x）
+ *
+ * @module @gravito/core/transpiler-utils
+ * @since 3.1.0
+ */
+/**
+ * TranspilerCache - 管理 Bun.Transpiler 實例與結果快取
+ *
+ * 避免重複建立 Transpiler（每次建立約需 40µs），
+ * 並快取 transformSync 結果（重用快取比每次 transform 快 128x）。
+ *
+ * @example
+ * ```typescript
+ * const cache = TranspilerCache.getInstance()
+ * const transformed = cache.transform(handlerSource)
+ * ```
+ */
+export declare class TranspilerCache {
+    private static instance;
+    /** 共享的 Bun.Transpiler 實例（避免重複建立） */
+    private readonly transpiler;
+    /** LRU 快取：原始代碼 → 轉換結果 */
+    private readonly cache;
+    /** 快取大小上限 */
+    private readonly maxSize;
+    /** 快取 TTL（毫秒），預設 5 分鐘 */
+    private readonly ttlMs;
+    private constructor();
+    /**
+     * 取得單例實例
+     * 確保全程只建立一個 Transpiler 實例
+     */
+    static getInstance(): TranspilerCache;
+    /**
+     * 重置單例（主要用於測試）
+     */
+    static resetInstance(): void;
+    /**
+     * 轉換代碼並快取結果
+     *
+     * 先嘗試從快取取得，若未命中則呼叫 transformSync 並儲存結果。
+     * 快取已滿時淘汰最舊的條目（近似 LRU）。
+     *
+     * 處理兩個 Bun.Transpiler 邊緣案例：
+     * 1. 箭頭函式表達式：`async (ctx) => ...` → transformSync 返回空字串
+     *    解法：包裝成 `const __fn = <source>` 後再轉換
+     * 2. 匿名函式表達式：`function(ctx) {...}` → transformSync 拋出 Parse error
+     *    解法：同樣包裝後轉換
+     *
+     * @param source - 原始 handler 函式字串
+     * @returns 轉換後的標準化代碼，若完全失敗則回傳 null
+     */
+    transform(source: string): string | null;
+    /**
+     * 實際執行 transformSync，處理箭頭函式和匿名函式的邊緣案例
+     *
+     * @param source - 原始代碼字串
+     * @returns 轉換後的代碼，或失敗時回傳 null
+     */
+    private doTransform;
+    /**
+     * 將代碼包裝成賦值語句後再 transform
+     *
+     * 用於處理無法直接 transform 的函式表達式。
+     * 包裝格式：`const __fn = <source>`
+     *
+     * @param source - 原始函式字串
+     * @returns 包裝後的轉換結果，或失敗時回傳 null
+     */
+    private transformWrapped;
+    /**
+     * 取得目前快取大小
+     */
+    get size(): number;
+    /**
+     * 清除所有快取條目
+     */
+    clear(): void;
+}
+/**
+ * Transpiler 分析的返回結果
+ * 與 HandlerAnalysis 介面對應
+ */
+export interface TranspilerAnalysisResult {
+    usesHeaders: boolean;
+    usesQuery: boolean;
+    usesBody: boolean;
+    usesParams: boolean;
+    isAsync: boolean;
+}
+/**
+ * 使用 Bun.Transpiler 進行精確的 handler 靜態分析
+ *
+ * 相比字串匹配，此函式能正確區分：
+ * - API 呼叫（`ctx.req.header(name)`）vs 變數名稱（`const header = '...'`）
+ * - 解構賦值（`const { header } = ctx.req`）
+ * - Minified 代碼（transformSync 先標準化）
+ * - 箭頭函式與匿名函式（包裝策略處理 Bun.Transpiler 邊緣案例）
+ *
+ * 若 Transpiler 轉換失敗，會自動 fallback 到字串匹配模式。
+ *
+ * ## isAsync 特殊處理
+ *
+ * `isAsync` 直接從原始碼偵測 `async` 關鍵字，而不是從 transformSync 結果：
+ * - 箭頭函式 `async (ctx) => ...` 的 transformSync 返回空字串
+ * - `async` 關鍵字本身不存在假陽性問題
+ *
+ * @param source - handler 函式的字串表示（通常來自 handler.toString()）
+ * @returns 分析結果，或在 fallback 模式下的近似結果
+ *
+ * @example
+ * ```typescript
+ * const handler = async (ctx) => {
+ *   const name = ctx.req.query('name')
+ *   return ctx.json({ name })
+ * }
+ * const result = analyzeHandlerWithTranspiler(handler.toString())
+ * // result.usesQuery === true
+ * // result.usesHeaders === false（即使有 'header' 字串，也不會誤判）
+ * // result.isAsync === true（即使是箭頭函式也能正確偵測）
+ * ```
+ */
+export declare function analyzeHandlerWithTranspiler(source: string): TranspilerAnalysisResult;
+/**
+ * 測試 handler 源代碼是否存取特定的 req 成員屬性
+ *
+ * 工具函式，方便在 Gravito.ts 等地方進行特定屬性的快速檢測。
+ *
+ * @param source - handler 函式的字串表示
+ * @param property - 要測試的屬性名稱（如 'header', 'query', 'body'）
+ * @returns 若該屬性被存取則回傳 true
+ *
+ * @example
+ * ```typescript
+ * const src = handler.toString()
+ * if (hasReqMemberAccess(src, 'header')) {
+ *   // handler 存取了 header
+ * }
+ * ```
+ */
+export declare function hasReqMemberAccess(source: string, property: string): boolean;
+/**
+ * 判斷 handler 是否為非同步函式
+ *
+ * 直接從原始碼偵測 `async` 關鍵字，不依賴 transformSync 結果，
+ * 因為箭頭函式的 transformSync 返回空字串。
+ * `async` 關鍵字本身不存在假陽性問題。
+ *
+ * @param source - handler 函式的字串表示
+ * @returns 若為 async 函式則回傳 true
+ */
+export declare function isAsyncHandler(source: string): boolean;
+/**
+ * 預熱 Transpiler 快取
+ *
+ * 在應用啟動時呼叫，觸發 Transpiler 實例建立，
+ * 避免第一個請求時的冷啟動延遲。
+ */
+export declare function warmupTranspilerCache(): void;

package/dist/core/src/types/events.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Event system type definitions.
+ */
+/**
+ * Listener interface.
+ *
+ * All event listeners must implement this interface.
+ */
+export interface Listener<TEvent extends Event = Event> {
+    /**
+     * Handle an event.
+     * @param event - Event instance
+     */
+    handle(event: TEvent): Promise<void> | void;
+}
+/**
+ * Marker interface for listeners that should be queued.
+ *
+ * Listeners implementing this interface can be dispatched asynchronously via a queue.
+ */
+export interface ShouldQueue {
+    /**
+     * Queue name (optional).
+     */
+    queue?: string;
+    /**
+     * Connection name (optional).
+     */
+    connection?: string;
+    /**
+     * Delay before execution (seconds).
+     */
+    delay?: number;
+}
+/**
+ * Marker interface for events that should be broadcast.
+ *
+ * Events implementing this interface can be automatically broadcast to clients.
+ */
+export interface ShouldBroadcast {
+    /**
+     * Define the broadcast channel.
+     * @returns Channel name or channel object
+     */
+    broadcastOn(): string | Channel;
+    /**
+     * Define broadcast payload (optional).
+     * If omitted, public event properties will be used.
+     * @returns Broadcast payload
+     */
+    broadcastWith?(): Record<string, unknown>;
+    /**
+     * Define the broadcast event name (optional).
+     * If omitted, the event class name will be used.
+     * @returns Event name
+     */
+    broadcastAs?(): string;
+}
+/**
+ * Channel interface.
+ */
+export interface Channel {
+    /**
+     * Channel name.
+     */
+    name: string;
+    /**
+     * Channel type.
+     */
+    type: 'public' | 'private' | 'presence';
+}
+/**
+ * Base event class.
+ *
+ * All events should extend this class.
+ */
+export declare abstract class Event {
+    /**
+     * Whether this event should be broadcast.
+     */
+    shouldBroadcast(): boolean;
+    /**
+     * Get broadcast channel.
+     */
+    getBroadcastChannel(): string | Channel | null;
+    /**
+     * Get broadcast payload.
+     */
+    getBroadcastData(): Record<string, unknown>;
+    /**
+     * Get broadcast event name.
+     */
+    getBroadcastEventName(): string;
+}

package/dist/index.js

@@ -1,276 +1,3 @@
-// src/BroadcastManager.ts
-class BroadcastManager {
-  core;
-  driver = null;
-  authCallback;
-  constructor(core) {
-    this.core = core;
-  }
-  setDriver(driver) {
-    this.driver = driver;
-  }
-  setAuthCallback(callback) {
-    this.authCallback = callback;
-  }
-  async broadcast(_event, channel, data, eventName) {
-    if (!this.driver) {
-      this.core.logger.warn("[BroadcastManager] No broadcast driver set, skipping broadcast");
-      return;
-    }
-    try {
-      await this.driver.broadcast(channel, eventName, data);
-    } catch (error) {
-      this.core.logger.error(`[BroadcastManager] Failed to broadcast event ${eventName}:`, error);
-      throw error;
-    }
-  }
-  async authorizeChannel(channel, socketId, userId) {
-    if (this.authCallback) {
-      const authorized = await this.authCallback(channel, socketId, userId);
-      if (!authorized) {
-        return null;
-      }
-    }
-    if (this.driver?.authorizeChannel) {
-      return await this.driver.authorizeChannel(channel, socketId, userId);
-    }
-    if (channel.startsWith("private-") || channel.startsWith("presence-")) {
-      return null;
-    }
-    return { auth: "" };
-  }
-}
-// src/channels/Channel.ts
-class PublicChannel {
-  name;
-  type = "public";
-  constructor(name) {
-    this.name = name;
-  }
-}
-
-class PrivateChannel {
-  name;
-  type = "private";
-  constructor(name) {
-    this.name = name;
-  }
-}
-
-class PresenceChannel {
-  name;
-  type = "presence";
-  constructor(name) {
-    this.name = name;
-  }
-}
-// src/drivers/AblyDriver.ts
-class AblyDriver {
-  config;
-  baseUrl = "https://rest.ably.io";
-  constructor(config) {
-    this.config = config;
-  }
-  async broadcast(channel, event, data) {
-    const path = `/channels/${channel.name}/messages`;
-    const auth = btoa(this.config.apiKey);
-    const response = await fetch(`${this.baseUrl}${path}`, {
-      method: "POST",
-      headers: {
-        Authorization: `Basic ${auth}`,
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        name: event,
-        data
-      })
-    });
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Failed to broadcast via Ably: ${error}`);
-    }
-  }
-  async authorizeChannel(channel, _socketId, userId) {
-    return {
-      auth: this.config.apiKey,
-      ...channel.startsWith("presence-") && userId ? {
-        channel_data: JSON.stringify({
-          clientId: userId.toString()
-        })
-      } : {}
-    };
-  }
-}
-// src/drivers/PusherDriver.ts
-class PusherDriver {
-  config;
-  baseUrl;
-  constructor(config) {
-    this.config = config;
-    const cluster = this.config.cluster || "mt1";
-    this.baseUrl = `https://api-${cluster}.pusher.com`;
-  }
-  async broadcast(channel, event, data) {
-    const path = `/apps/${this.config.appId}/events`;
-    const body = {
-      name: event,
-      channel: channel.name,
-      data: JSON.stringify(data)
-    };
-    const timestamp = Math.floor(Date.now() / 1000);
-    const queryString = new URLSearchParams({
-      auth_key: this.config.key,
-      auth_timestamp: timestamp.toString(),
-      auth_version: "1.0",
-      body_md5: this.md5(JSON.stringify(body))
-    });
-    const authString = `POST
-${path}
-${queryString.toString()}`;
-    const authSignature = await this.hmacSHA256(authString, this.config.secret);
-    queryString.append("auth_signature", authSignature);
-    const response = await fetch(`${this.baseUrl}${path}?${queryString.toString()}`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify(body)
-    });
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Failed to broadcast via Pusher: ${error}`);
-    }
-  }
-  async authorizeChannel(channel, socketId, userId) {
-    const stringToSign = `${socketId}:${channel}`;
-    const signature = await this.hmacSHA256(stringToSign, this.config.secret);
-    if (channel.startsWith("presence-")) {
-      const channelData = JSON.stringify({
-        user_id: userId?.toString(),
-        user_info: {}
-      });
-      return {
-        auth: `${this.config.key}:${signature}`,
-        channel_data: channelData
-      };
-    }
-    return {
-      auth: `${this.config.key}:${signature}`
-    };
-  }
-  async hmacSHA256(message, secret) {
-    const encoder = new TextEncoder;
-    const keyData = encoder.encode(secret);
-    const messageData = encoder.encode(message);
-    const key = await crypto.subtle.importKey("raw", keyData, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
-    const signature = await crypto.subtle.sign("HMAC", key, messageData);
-    const hashArray = Array.from(new Uint8Array(signature));
-    return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
-  }
-  md5(text) {
-    return btoa(text).replace(/[+/=]/g, "").substring(0, 32);
-  }
-}
-// src/drivers/RedisDriver.ts
-class RedisDriver {
-  config;
-  redis = null;
-  constructor(config) {
-    this.config = config;
-  }
-  setRedisClient(client) {
-    this.redis = client;
-  }
-  async broadcast(channel, event, data) {
-    if (!this.redis) {
-      throw new Error("Redis client not set. Please install a Redis client and call setRedisClient()");
-    }
-    const prefix = this.config.keyPrefix || "gravito:broadcast:";
-    const channelName = `${prefix}${channel.name}`;
-    const message = JSON.stringify({
-      event,
-      data,
-      channel: channel.name,
-      type: channel.type
-    });
-    await this.redis.publish(channelName, message);
-  }
-}
-// src/drivers/WebSocketDriver.ts
-class WebSocketDriver {
-  config;
-  constructor(config) {
-    this.config = config;
-  }
-  async broadcast(channel, event, data) {
-    const message = JSON.stringify({
-      channel: channel.name,
-      event,
-      data
-    });
-    let connections = this.config.getConnections();
-    if (this.config.filterConnectionsByChannel) {
-      connections = this.config.filterConnectionsByChannel(channel.name);
-    }
-    for (const connection of connections) {
-      if (connection.readyState === 1) {
-        try {
-          connection.send(message);
-        } catch (error) {
-          console.error("Failed to send WebSocket message:", error);
-        }
-      }
-    }
-  }
-}
-// src/OrbitRadiance.ts
-class OrbitRadiance {
-  options;
-  constructor(options) {
-    this.options = options;
-  }
-  static configure(options) {
-    return new OrbitRadiance(options);
-  }
-  async install(core) {
-    const manager = new BroadcastManager(core);
-    let driver;
-    switch (this.options.driver) {
-      case "pusher":
-        driver = new PusherDriver(this.options.config);
-        break;
-      case "ably":
-        driver = new AblyDriver(this.options.config);
-        break;
-      case "redis": {
-        driver = new RedisDriver(this.options.config);
-        const redisClient = core.container.make("redis");
-        if (redisClient) {
-          driver.setRedisClient(redisClient);
-        }
-        break;
-      }
-      case "websocket":
-        driver = new WebSocketDriver(this.options.config);
-        break;
-      default:
-        throw new Error(`Unsupported broadcast driver: ${this.options.driver}`);
-    }
-    manager.setDriver(driver);
-    if (this.options.authorizeChannel) {
-      manager.setAuthCallback(this.options.authorizeChannel);
-    }
-    core.container.instance("broadcast", manager);
-    if (core.events) {
-      core.events.setBroadcastManager({
-        broadcast: async (event, channel, data, eventName) => {
-          await manager.broadcast(event, channel, data, eventName);
-        }
-      });
-    }
-    core.logger.info(`[OrbitRadiance] Installed with ${this.options.driver} driver`);
-  }
-}
 export {
   WebSocketDriver,
   RedisDriver,
@@ -283,4 +10,4 @@ export {
   AblyDriver
 };
 
-//# debugId=B3E6ADF62B34DDC264756E2164756E21
+//# debugId=00053E5676168F4764756E2164756E21

package/dist/index.js.map

@@ -1,16 +1,9 @@
 {
   "version": 3,
-  "sources": ["../src/BroadcastManager.ts", "../src/channels/Channel.ts", "../src/drivers/AblyDriver.ts", "../src/drivers/PusherDriver.ts", "../src/drivers/RedisDriver.ts", "../src/drivers/WebSocketDriver.ts", "../src/OrbitRadiance.ts"],
+  "sources": [],
   "sourcesContent": [
-    "import type { PlanetCore } from '@gravito/core'\nimport type { BroadcastDriver } from './drivers/BroadcastDriver'\n\n/**\n * Channel authorization callback.\n */\nexport type ChannelAuthorizationCallback = (\n  channel: string,\n  socketId: string,\n  userId?: string | number\n) => Promise<boolean>\n\n/**\n * Broadcast manager.\n *\n * Responsible for managing the broadcast driver and handling broadcast requests.\n */\nexport class BroadcastManager {\n  private driver: BroadcastDriver | null = null\n  private authCallback?: ChannelAuthorizationCallback\n\n  constructor(private core: PlanetCore) {}\n\n  /**\n   * Set the broadcast driver.\n   *\n   * @param driver - The broadcast driver to use.\n   */\n  setDriver(driver: BroadcastDriver): void {\n    this.driver = driver\n  }\n\n  /**\n   * Set the channel authorization callback.\n   *\n   * @param callback - The callback function for channel authorization.\n   */\n  setAuthCallback(callback: ChannelAuthorizationCallback): void {\n    this.authCallback = callback\n  }\n\n  /**\n   * Broadcast an event.\n   *\n   * @param _event - Event instance (unused in current implementation, but kept for signature compatibility).\n   * @param channel - Channel object containing name and type.\n   * @param data - Event payload.\n   * @param eventName - Event name.\n   * @returns A promise that resolves when the event is broadcast.\n   */\n  async broadcast(\n    _event: unknown,\n    channel: { name: string; type: string },\n    data: Record<string, unknown>,\n    eventName: string\n  ): Promise<void> {\n    if (!this.driver) {\n      this.core.logger.warn('[BroadcastManager] No broadcast driver set, skipping broadcast')\n      return\n    }\n\n    try {\n      await this.driver.broadcast(channel, eventName, data)\n    } catch (error) {\n      this.core.logger.error(`[BroadcastManager] Failed to broadcast event ${eventName}:`, error)\n      throw error\n    }\n  }\n\n  /**\n   * Authorize channel access.\n   *\n   * @param channel - Channel name.\n   * @param socketId - Socket ID.\n   * @param userId - User ID (optional).\n   * @returns A promise resolving to the authorization payload or null if unauthorized.\n   */\n  async authorizeChannel(\n    channel: string,\n    socketId: string,\n    userId?: string | number\n  ): Promise<{ auth: string; channel_data?: string } | null> {\n    // Check authorization callback first.\n    if (this.authCallback) {\n      const authorized = await this.authCallback(channel, socketId, userId)\n      if (!authorized) {\n        return null\n      }\n    }\n\n    // If the driver supports authorization, use it.\n    if (this.driver?.authorizeChannel) {\n      return await this.driver.authorizeChannel(channel, socketId, userId)\n    }\n\n    // Default deny for private/presence channels.\n    if (channel.startsWith('private-') || channel.startsWith('presence-')) {\n      return null\n    }\n\n    // Public channels do not require authorization.\n    return { auth: '' }\n  }\n}\n",
-    "/**\n * Base channel interface.\n */\nexport interface Channel {\n  /**\n   * Channel name.\n   */\n  name: string\n\n  /**\n   * Channel type.\n   */\n  type: 'public' | 'private' | 'presence'\n}\n\n/**\n * Public channel.\n */\nexport class PublicChannel implements Channel {\n  type = 'public' as const\n\n  constructor(public name: string) {}\n}\n\n/**\n * Private channel.\n */\nexport class PrivateChannel implements Channel {\n  type = 'private' as const\n\n  constructor(public name: string) {}\n}\n\n/**\n * Presence channel (can track online users).\n */\nexport class PresenceChannel implements Channel {\n  type = 'presence' as const\n\n  constructor(public name: string) {}\n}\n",
-    "import type { BroadcastDriver } from './BroadcastDriver'\n\n/**\n * Ably driver configuration.\n */\nexport interface AblyDriverConfig {\n  apiKey: string\n}\n\n/**\n * Ably driver.\n *\n * Broadcasts through the Ably service.\n */\nexport class AblyDriver implements BroadcastDriver {\n  private baseUrl = 'https://rest.ably.io'\n\n  constructor(private config: AblyDriverConfig) {}\n\n  async broadcast(\n    channel: { name: string; type: string },\n    event: string,\n    data: Record<string, unknown>\n  ): Promise<void> {\n    const path = `/channels/${channel.name}/messages`\n    const auth = btoa(this.config.apiKey)\n\n    const response = await fetch(`${this.baseUrl}${path}`, {\n      method: 'POST',\n      headers: {\n        Authorization: `Basic ${auth}`,\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify({\n        name: event,\n        data,\n      }),\n    })\n\n    if (!response.ok) {\n      const error = await response.text()\n      throw new Error(`Failed to broadcast via Ably: ${error}`)\n    }\n  }\n\n  async authorizeChannel(\n    channel: string,\n    _socketId: string,\n    userId?: string | number\n  ): Promise<{ auth: string; channel_data?: string }> {\n    // Ably uses a different authorization mechanism.\n    // This is only a basic implementation.\n    return {\n      auth: this.config.apiKey,\n      ...(channel.startsWith('presence-') && userId\n        ? {\n            channel_data: JSON.stringify({\n              clientId: userId.toString(),\n            }),\n          }\n        : {}),\n    }\n  }\n}\n",
-    "import type { BroadcastDriver } from './BroadcastDriver'\n\n/**\n * Pusher driver configuration.\n */\nexport interface PusherDriverConfig {\n  appId: string\n  key: string\n  secret: string\n  cluster?: string\n  useTLS?: boolean\n}\n\n/**\n * Pusher driver.\n *\n * Broadcasts through the Pusher service.\n */\nexport class PusherDriver implements BroadcastDriver {\n  private baseUrl: string\n\n  constructor(private config: PusherDriverConfig) {\n    const cluster = this.config.cluster || 'mt1'\n    this.baseUrl = `https://api-${cluster}.pusher.com`\n  }\n\n  async broadcast(\n    channel: { name: string; type: string },\n    event: string,\n    data: Record<string, unknown>\n  ): Promise<void> {\n    const path = `/apps/${this.config.appId}/events`\n    const body = {\n      name: event,\n      channel: channel.name,\n      data: JSON.stringify(data),\n    }\n\n    const timestamp = Math.floor(Date.now() / 1000)\n    const queryString = new URLSearchParams({\n      auth_key: this.config.key,\n      auth_timestamp: timestamp.toString(),\n      auth_version: '1.0',\n      body_md5: this.md5(JSON.stringify(body)),\n    })\n\n    const authString = `POST\\n${path}\\n${queryString.toString()}`\n    const authSignature = await this.hmacSHA256(authString, this.config.secret)\n\n    queryString.append('auth_signature', authSignature)\n\n    const response = await fetch(`${this.baseUrl}${path}?${queryString.toString()}`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(body),\n    })\n\n    if (!response.ok) {\n      const error = await response.text()\n      throw new Error(`Failed to broadcast via Pusher: ${error}`)\n    }\n  }\n\n  async authorizeChannel(\n    channel: string,\n    socketId: string,\n    userId?: string | number\n  ): Promise<{ auth: string; channel_data?: string }> {\n    const stringToSign = `${socketId}:${channel}`\n    const signature = await this.hmacSHA256(stringToSign, this.config.secret)\n\n    if (channel.startsWith('presence-')) {\n      const channelData = JSON.stringify({\n        user_id: userId?.toString(),\n        user_info: {},\n      })\n      return {\n        auth: `${this.config.key}:${signature}`,\n        channel_data: channelData,\n      }\n    }\n\n    return {\n      auth: `${this.config.key}:${signature}`,\n    }\n  }\n\n  private async hmacSHA256(message: string, secret: string): Promise<string> {\n    // Uses the Web Crypto API.\n    const encoder = new TextEncoder()\n    const keyData = encoder.encode(secret)\n    const messageData = encoder.encode(message)\n\n    const key = await crypto.subtle.importKey(\n      'raw',\n      keyData,\n      { name: 'HMAC', hash: 'SHA-256' },\n      false,\n      ['sign']\n    )\n\n    const signature = await crypto.subtle.sign('HMAC', key, messageData)\n    const hashArray = Array.from(new Uint8Array(signature))\n    return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('')\n  }\n\n  private md5(text: string): string {\n    // Simplified MD5 implementation (production should use a proper MD5 implementation).\n    return btoa(text).replace(/[+/=]/g, '').substring(0, 32)\n  }\n}\n",
-    "import type { BroadcastDriver } from './BroadcastDriver'\n\n/**\n * Redis driver configuration.\n */\nexport interface RedisDriverConfig {\n  url?: string\n  host?: string\n  port?: number\n  password?: string\n  db?: number\n  keyPrefix?: string\n}\n\n/**\n * Redis driver.\n *\n * Broadcasts via Redis Pub/Sub.\n * Requires an external Redis client.\n */\nexport class RedisDriver implements BroadcastDriver {\n  private redis: {\n    publish(channel: string, message: string): Promise<number>\n  } | null = null\n\n  constructor(private config: RedisDriverConfig) {\n    // The Redis client should be injected from the outside.\n    // This class only provides the adapter interface.\n  }\n\n  /**\n   * Set Redis client.\n   */\n  setRedisClient(client: { publish(channel: string, message: string): Promise<number> }): void {\n    this.redis = client\n  }\n\n  async broadcast(\n    channel: { name: string; type: string },\n    event: string,\n    data: Record<string, unknown>\n  ): Promise<void> {\n    if (!this.redis) {\n      throw new Error(\n        'Redis client not set. Please install a Redis client and call setRedisClient()'\n      )\n    }\n\n    const prefix = this.config.keyPrefix || 'gravito:broadcast:'\n    const channelName = `${prefix}${channel.name}`\n    const message = JSON.stringify({\n      event,\n      data,\n      channel: channel.name,\n      type: channel.type,\n    })\n\n    await this.redis.publish(channelName, message)\n  }\n}\n",
-    "import type { BroadcastDriver } from './BroadcastDriver'\n\n/**\n * WebSocket connection interface.\n */\nexport interface WebSocketConnection {\n  send(data: string): void\n  close(): void\n  readyState: number\n}\n\n/**\n * WebSocket driver configuration.\n */\nexport interface WebSocketDriverConfig {\n  /**\n   * Get all active connections.\n   */\n  getConnections(): WebSocketConnection[]\n\n  /**\n   * Filter connections by channel (optional).\n   */\n  filterConnectionsByChannel?(channel: string): WebSocketConnection[]\n}\n\n/**\n * WebSocket driver.\n *\n * Broadcasts via WebSocket.\n * Suitable for single-node deployments or when direct WebSocket connections are required.\n */\nexport class WebSocketDriver implements BroadcastDriver {\n  constructor(private config: WebSocketDriverConfig) {}\n\n  async broadcast(\n    channel: { name: string; type: string },\n    event: string,\n    data: Record<string, unknown>\n  ): Promise<void> {\n    const message = JSON.stringify({\n      channel: channel.name,\n      event,\n      data,\n    })\n\n    let connections = this.config.getConnections()\n\n    // If channel filtering is supported, use it.\n    if (this.config.filterConnectionsByChannel) {\n      connections = this.config.filterConnectionsByChannel(channel.name)\n    }\n\n    // Send to all connections.\n    for (const connection of connections) {\n      if (connection.readyState === 1) {\n        // WebSocket.OPEN\n        try {\n          connection.send(message)\n        } catch (error) {\n          // Ignore failed sends.\n          console.error('Failed to send WebSocket message:', error)\n        }\n      }\n    }\n  }\n}\n",
-    "import type { GravitoOrbit, PlanetCore } from '@gravito/core'\nimport { BroadcastManager } from './BroadcastManager'\nimport type { AblyDriverConfig } from './drivers/AblyDriver'\nimport { AblyDriver } from './drivers/AblyDriver'\nimport type { BroadcastDriver } from './drivers/BroadcastDriver'\nimport type { PusherDriverConfig } from './drivers/PusherDriver'\nimport { PusherDriver } from './drivers/PusherDriver'\nimport type { RedisDriverConfig } from './drivers/RedisDriver'\nimport { RedisDriver } from './drivers/RedisDriver'\nimport type { WebSocketDriverConfig } from './drivers/WebSocketDriver'\nimport { WebSocketDriver } from './drivers/WebSocketDriver'\n\n/**\n * Options for configuring OrbitRadiance broadcasting.\n * @public\n */\nexport interface OrbitRadianceOptions {\n  /**\n   * The broadcast driver to use.\n   * - pusher: Official Pusher API\n   * - ably: Ably Realtime API\n   * - redis: Redis Pub/Sub for custom backends\n   * - websocket: Native WebSocket (Experimental)\n   */\n  driver: 'pusher' | 'ably' | 'redis' | 'websocket'\n\n  /**\n   * Specific configuration for the selected driver.\n   */\n  config: PusherDriverConfig | AblyDriverConfig | RedisDriverConfig | WebSocketDriverConfig\n\n  /**\n   * Optional callback to handle private channel authorization.\n   *\n   * @param channel - The channel name being accessed.\n   * @param socketId - The unique socket ID from the client.\n   * @param userId - Optional authenticated user ID.\n   * @returns Promise resolving to true if authorized.\n   */\n  authorizeChannel?: (\n    channel: string,\n    socketId: string,\n    userId?: string | number\n  ) => Promise<boolean>\n}\n\n/**\n * OrbitRadiance provides real-time event broadcasting capabilities.\n * It abstracts various delivery providers (Pusher, Ably, etc.) and integrates\n * seamlessly with Gravito's Event system.\n *\n * @example\n * ```typescript\n * const radiance = new OrbitRadiance({\n *   driver: 'pusher',\n *   config: { appId: '...', key: '...', secret: '...' }\n * });\n * core.addOrbit(radiance);\n *\n * // Broadcasting an event\n * await ctx.get('broadcast').broadcast('my-channel', 'my-event', { data: 'hello' });\n * ```\n * @public\n */\nexport class OrbitRadiance implements GravitoOrbit {\n  private options: OrbitRadianceOptions\n\n  constructor(options: OrbitRadianceOptions) {\n    this.options = options\n  }\n\n  /**\n   * Configure OrbitRadiance.\n   */\n  static configure(options: OrbitRadianceOptions): OrbitRadiance {\n    return new OrbitRadiance(options)\n  }\n\n  async install(core: PlanetCore): Promise<void> {\n    const manager = new BroadcastManager(core)\n\n    // Create and set driver.\n    let driver: BroadcastDriver\n\n    switch (this.options.driver) {\n      case 'pusher':\n        driver = new PusherDriver(this.options.config as PusherDriverConfig)\n        break\n      case 'ably':\n        driver = new AblyDriver(this.options.config as AblyDriverConfig)\n        break\n      case 'redis': {\n        driver = new RedisDriver(this.options.config as RedisDriverConfig)\n        // If a Redis client is provided via core container, set it.\n        const redisClient = core.container.make('redis') as\n          | { publish(channel: string, message: string): Promise<number> }\n          | undefined\n        if (redisClient) {\n          ;(driver as RedisDriver).setRedisClient(redisClient)\n        }\n        break\n      }\n      case 'websocket':\n        driver = new WebSocketDriver(this.options.config as WebSocketDriverConfig)\n        break\n      default:\n        throw new Error(`Unsupported broadcast driver: ${this.options.driver}`)\n    }\n\n    manager.setDriver(driver)\n\n    // Set auth callback.\n    if (this.options.authorizeChannel) {\n      manager.setAuthCallback(this.options.authorizeChannel)\n    }\n\n    // Register into core container\n    core.container.instance('broadcast', manager)\n\n    // Integrate with EventManager.\n    if (core.events) {\n      core.events.setBroadcastManager({\n        broadcast: async (event: any, channel: any, data: any, eventName: any) => {\n          await manager.broadcast(event, channel, data, eventName)\n        },\n      })\n    }\n\n    core.logger.info(`[OrbitRadiance] Installed with ${this.options.driver} driver`)\n  }\n}\n\n// Module augmentation for GravitoVariables\ndeclare module '@gravito/core' {\n  interface GravitoVariables {\n    /** Broadcaster manager for real-time events */\n    broadcast?: BroadcastManager\n  }\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "B3E6ADF62B34DDC264756E2164756E21",
+  "mappings": "",
+  "debugId": "00053E5676168F4764756E2164756E21",
   "names": []
 }