@gravito/radiance 1.0.0-alpha.2

package/README.md

@@ -0,0 +1,247 @@
+# @gravito/radiance
+
+輕量、高效的廣播系統，支援多種驅動（Pusher、Ably、Redis、WebSocket）。借鑑 Laravel 架構但保持 Gravito 的核心價值（高效能、低耗、輕量、AI 友善）。
+
+> **狀態**：v0.1.0 - 核心功能已完成，支援多種廣播驅動
+
+## 特性
+
+- **零運行時開銷**：純類型包裝，直接委派給驅動
+- **多驅動支援**：Pusher、Ably、Redis、WebSocket
+- **完全模組化**：按需安裝驅動，核心包極小
+- **與 Events 整合**：事件可實作 `ShouldBroadcast` 自動廣播
+- **頻道授權**：支援私有頻道和存在頻道授權
+- **AI 友善**：完整的型別推導、清晰的 JSDoc、直觀的 API
+
+## 安裝
+
+```bash
+bun add @gravito/radiance
+```
+
+## 快速開始
+
+### 1. 配置 OrbitRadiance
+
+```typescript
+import { PlanetCore } from 'gravito-core'
+import { OrbitRadiance } from '@gravito/radiance'
+
+const core = await PlanetCore.boot({
+  orbits: [
+    OrbitRadiance.configure({
+      driver: 'pusher',
+      config: {
+        appId: 'your-app-id',
+        key: 'your-key',
+        secret: 'your-secret',
+        cluster: 'mt1',
+      },
+      authorizeChannel: async (channel, socketId, userId) => {
+        // 實作頻道授權邏輯
+        return true
+      },
+    }),
+  ],
+})
+```
+
+### 2. 創建可廣播事件
+
+```typescript
+import { Event, ShouldBroadcast } from 'gravito-core'
+import { PrivateChannel } from '@gravito/radiance'
+
+class OrderShipped extends Event implements ShouldBroadcast {
+  constructor(public order: Order) {
+    super()
+  }
+
+  broadcastOn(): PrivateChannel {
+    return new PrivateChannel(`user.${this.order.userId}`)
+  }
+
+  broadcastWith(): Record<string, unknown> {
+    return {
+      order_id: this.order.id,
+      status: 'shipped',
+      tracking_number: this.order.trackingNumber,
+    }
+  }
+
+  broadcastAs(): string {
+    return 'OrderShipped'
+  }
+}
+```
+
+### 3. 分發事件（自動廣播）
+
+```typescript
+// 分發事件時會自動廣播
+await core.events.dispatch(new OrderShipped(order))
+```
+
+### 4. 手動廣播
+
+```typescript
+const broadcast = c.get('broadcast') as BroadcastManager
+
+await broadcast.broadcast(
+  event,
+  { name: 'user.123', type: 'private' },
+  { message: 'Hello' },
+  'CustomEvent'
+)
+```
+
+## 驅動
+
+### Pusher
+
+```typescript
+OrbitRadiance.configure({
+  driver: 'pusher',
+  config: {
+    appId: 'your-app-id',
+    key: 'your-key',
+    secret: 'your-secret',
+    cluster: 'mt1', // 可選
+    useTLS: true, // 可選
+  },
+})
+```
+
+### Ably
+
+```typescript
+OrbitRadiance.configure({
+  driver: 'ably',
+  config: {
+    apiKey: 'your-api-key',
+  },
+})
+```
+
+### Redis
+
+```typescript
+import { RedisDriver } from '@gravito/radiance'
+
+// 需要先設置 Redis 客戶端
+const redisDriver = new RedisDriver({
+  url: 'redis://localhost:6379',
+})
+
+// 設置 Redis 客戶端
+redisDriver.setRedisClient(redisClient)
+
+OrbitRadiance.configure({
+  driver: 'redis',
+  config: {
+    url: 'redis://localhost:6379',
+    keyPrefix: 'gravito:broadcast:', // 可選
+  },
+})
+```
+
+### WebSocket
+
+```typescript
+OrbitRadiance.configure({
+  driver: 'websocket',
+  config: {
+    getConnections: () => {
+      // 返回所有 WebSocket 連接
+      return Array.from(websocketConnections.values())
+    },
+    filterConnectionsByChannel: (channel) => {
+      // 根據頻道過濾連接（可選）
+      return Array.from(websocketConnections.values()).filter(
+        (conn) => conn.subscribedChannels.includes(channel)
+      )
+    },
+  },
+})
+```
+
+## 頻道類型
+
+### 公開頻道
+
+```typescript
+import { PublicChannel } from '@gravito/radiance'
+
+class PublicEvent extends Event implements ShouldBroadcast {
+  broadcastOn(): PublicChannel {
+    return new PublicChannel('public-channel')
+  }
+}
+```
+
+### 私有頻道
+
+```typescript
+import { PrivateChannel } from '@gravito/radiance'
+
+class PrivateEvent extends Event implements ShouldBroadcast {
+  broadcastOn(): PrivateChannel {
+    return new PrivateChannel(`user.${this.userId}`)
+  }
+}
+```
+
+### 存在頻道
+
+```typescript
+import { PresenceChannel } from '@gravito/radiance'
+
+class PresenceEvent extends Event implements ShouldBroadcast {
+  broadcastOn(): PresenceChannel {
+    return new PresenceChannel('presence-room')
+  }
+}
+```
+
+## 頻道授權
+
+私有頻道和存在頻道需要授權。在配置中提供 `authorizeChannel` 回調：
+
+```typescript
+OrbitRadiance.configure({
+  driver: 'pusher',
+  config: { /* ... */ },
+  authorizeChannel: async (channel, socketId, userId) => {
+    // 檢查使用者是否有權限存取此頻道
+    if (channel.startsWith('private-user.')) {
+      const channelUserId = channel.replace('private-user.', '')
+      return userId?.toString() === channelUserId
+    }
+    return false
+  },
+})
+```
+
+## API 參考
+
+### BroadcastManager
+
+#### 方法
+
+- `broadcast(event, channel, data, eventName): Promise<void>` - 廣播事件
+- `authorizeChannel(channel, socketId, userId): Promise<{ auth, channel_data? } | null>` - 授權頻道存取
+- `setDriver(driver: BroadcastDriver): void` - 設置廣播驅動
+- `setAuthCallback(callback: ChannelAuthorizationCallback): void` - 設置授權回調
+
+### ShouldBroadcast
+
+事件實作此介面可自動廣播：
+
+- `broadcastOn(): string | Channel` - 指定廣播頻道（必須實作）
+- `broadcastWith?(): Record<string, unknown>` - 指定廣播資料（可選）
+- `broadcastAs?(): string` - 指定廣播事件名稱（可選）
+
+## 授權
+
+MIT © Carl Lee
+

package/dist/index.js

@@ -0,0 +1,286 @@
+// 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.services.get("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.services.set("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,
+  PusherDriver,
+  PublicChannel,
+  PrivateChannel,
+  PresenceChannel,
+  OrbitRadiance,
+  BroadcastManager,
+  AblyDriver
+};
+
+//# debugId=01B589AE84540A2064756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,16 @@
+{
+  "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"],
+  "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  setDriver(driver: BroadcastDriver): void {\n    this.driver = driver\n  }\n\n  /**\n   * Set the channel authorization callback.\n   */\n  setAuthCallback(callback: ChannelAuthorizationCallback): void {\n    this.authCallback = callback\n  }\n\n  /**\n   * Broadcast an event.\n   *\n   * @param event - Event instance\n   * @param channel - Channel object\n   * @param data - Event payload\n   * @param eventName - Event name\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 Authorization payload\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 * OrbitRadiance options.\n */\nexport interface OrbitRadianceOptions {\n  /**\n   * Driver type.\n   */\n  driver: 'pusher' | 'ably' | 'redis' | 'websocket'\n\n  /**\n   * Driver configuration.\n   */\n  config: PusherDriverConfig | AblyDriverConfig | RedisDriverConfig | WebSocketDriverConfig\n\n  /**\n   * Channel authorization callback (optional).\n   */\n  authorizeChannel?: (\n    channel: string,\n    socketId: string,\n    userId?: string | number\n  ) => Promise<boolean>\n}\n\n/**\n * Broadcasting Orbit\n *\n * Provides broadcasting capabilities with multiple drivers (Pusher, Ably, Redis, WebSocket).\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 services, set it.\n        const redisClient = core.services.get('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 services.\n    core.services.set('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"
+  ],
+  "mappings": "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",
+  "debugId": "01B589AE84540A2064756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@gravito/radiance",
+  "version": "1.0.0-alpha.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Lightweight, high-performance broadcasting system for Gravito framework. Supports multiple drivers (Pusher, Ably, Redis, WebSocket) with zero runtime overhead.",
+  "module": "./dist/index.mjs",
+  "main": "./dist/index.cjs",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "gravito",
+    "orbit",
+    "broadcasting",
+    "websocket",
+    "pusher",
+    "ably",
+    "redis",
+    "realtime"
+  ],
+  "author": "Carl Lee <carllee0520@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "gravito-core": "1.0.0-beta.2"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "^5.9.3"
+  },
+  "homepage": "https://github.com/gravito-framework/gravito#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "packages/radiance"
+  }
+}