@gravito/satellite-support 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @gravito/satellite-support
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/atlas@1.0.1
+  - @gravito/core@1.0.0
+  - @gravito/enterprise@1.0.0
+  - @gravito/ripple@1.0.0

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { ServiceProvider, Container } from '@gravito/core';
+
+declare class SupportServiceProvider extends ServiceProvider {
+    register(_container: Container): void;
+    boot(): void;
+}
+
+export { SupportServiceProvider };

package/dist/index.js

@@ -0,0 +1,60 @@
+// src/index.ts
+import { ServiceProvider } from "@gravito/core";
+var SupportServiceProvider = class extends ServiceProvider {
+  register(_container) {
+  }
+  boot() {
+    const core = this.core;
+    if (!core) {
+      return;
+    }
+    core.logger.info("\u{1F3A7} Support Satellite is ready for real-time inquiries");
+    const ripple = core.container.make("ripple.server");
+    ripple.on(
+      "support:client_message",
+      async (_socket, payload) => {
+        core.logger.info(`[Support] New message in ${payload.conversationId}`);
+        ripple.to(`private-support.chat.${payload.conversationId}`).emit("support:new_message", {
+          sender: "CUSTOMER",
+          text: payload.text,
+          at: /* @__PURE__ */ new Date()
+        });
+        ripple.to("presence-support.admin.inbox").emit("support:inbox_update", {
+          conversationId: payload.conversationId,
+          snippet: payload.text
+        });
+      }
+    );
+    core.router.prefix("/api/admin/v1/support").group((router) => {
+      router.get(
+        "/inbox",
+        (ctx) => ctx.json([
+          {
+            id: "SESS-001",
+            participant: "Carl",
+            contextType: "ORDER",
+            contextId: "ORD-9921",
+            status: "PENDING"
+          },
+          {
+            id: "SESS-002",
+            participant: "Guest_12",
+            contextType: "FORM",
+            subject: "\u7DB2\u7AD9\u5831\u50F9\u8A62\u554F",
+            status: "ACTIVE"
+          },
+          { id: "SESS-003", participant: "Alice", contextType: "GENERAL", status: "ACTIVE" }
+        ])
+      );
+      router.get(
+        "/conversations/:id/messages",
+        (ctx) => ctx.json([
+          { id: "msg-1", sender: "CUSTOMER", content: "\u60A8\u597D\uFF0C\u6211\u5C0D\u9019\u5F35\u8A02\u55AE\u6709\u7591\u554F", at: /* @__PURE__ */ new Date() }
+        ])
+      );
+    });
+  }
+};
+export {
+  SupportServiceProvider
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@gravito/satellite-support",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck"
+  },
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "@gravito/enterprise": "workspace:*",
+    "@gravito/atlas": "workspace:*",
+    "@gravito/ripple": "workspace:*",
+    "@gravito/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "satellites/support"
+  }
+}

package/src/Domain/Contracts/ISupportRepository.ts

@@ -0,0 +1,10 @@
+import type { Conversation } from '../Entities/Conversation'
+import type { Message } from '../Entities/Message'
+
+export interface ISupportRepository {
+  saveConversation(conversation: Conversation): Promise<void>
+  saveMessage(message: Message): Promise<void>
+  findConversationById(id: string): Promise<Conversation | null>
+  findMessagesByConversationId(conversationId: string): Promise<Message[]>
+  findPendingConversations(): Promise<Conversation[]>
+}

package/src/Domain/Entities/Conversation.ts

@@ -0,0 +1,41 @@
+import { Entity } from '@gravito/enterprise'
+
+export type ConversationContextType = 'ORDER' | 'PRODUCT' | 'FORM' | 'GENERAL'
+
+export interface ConversationProps {
+  participantId: string // 顧客 ID
+  subject?: string // 主旨 (如：來自聯繫表單)
+  contextType: ConversationContextType
+  contextId?: string // 關聯 ID (如：OrderId)
+  status: 'PENDING' | 'ACTIVE' | 'CLOSED'
+  lastMessageAt: Date
+  createdAt: Date
+}
+
+export class Conversation extends Entity<string> {
+  private _props: ConversationProps
+
+  constructor(props: ConversationProps, id?: string) {
+    super(id || crypto.randomUUID())
+    this._props = props
+  }
+
+  static start(
+    participantId: string,
+    context: { type: ConversationContextType; id?: string; subject?: string }
+  ) {
+    return new Conversation({
+      participantId,
+      subject: context.subject,
+      contextType: context.type,
+      contextId: context.id,
+      status: 'PENDING',
+      lastMessageAt: new Date(),
+      createdAt: new Date(),
+    })
+  }
+
+  unpack() {
+    return { ...this._props }
+  }
+}

package/src/Domain/Entities/Message.ts

@@ -0,0 +1,30 @@
+import { Entity } from '@gravito/enterprise'
+
+export interface MessageProps {
+  conversationId: string
+  sender: 'CUSTOMER' | 'SUPPORT'
+  type: 'TEXT' | 'IMAGE' | 'CARD'
+  content: string
+  metadata?: any // 儲存結構化數據 (如：表單欄位、訂單卡片詳情)
+  createdAt: Date
+}
+
+export class Message extends Entity<string> {
+  private _props: MessageProps
+
+  constructor(props: MessageProps, id?: string) {
+    super(id || crypto.randomUUID())
+    this._props = props
+  }
+
+  static create(props: Omit<MessageProps, 'createdAt'>) {
+    return new Message({
+      ...props,
+      createdAt: new Date(),
+    })
+  }
+
+  unpack() {
+    return { ...this._props }
+  }
+}

package/src/index.ts

@@ -0,0 +1,72 @@
+import { type Container, ServiceProvider } from '@gravito/core'
+import type { RippleServer } from '@gravito/ripple'
+
+export class SupportServiceProvider extends ServiceProvider {
+  register(_container: Container): void {
+    // 注入 Repository 與 Use Cases (略，暫時使用 Mock)
+  }
+
+  override boot(): void {
+    const core = this.core
+    if (!core) {
+      return
+    }
+
+    core.logger.info('🎧 Support Satellite is ready for real-time inquiries')
+
+    // 獲取 Ripple 實體
+    const ripple = core.container.make<RippleServer>('ripple.server')
+
+    /**
+     * 監聽即時通訊事件
+     */
+    ripple.on(
+      'support:client_message',
+      async (_socket, payload: { conversationId: string; text: string }) => {
+        core.logger.info(`[Support] New message in ${payload.conversationId}`)
+
+        // 廣播至該對話專屬頻道 (讓客服端即時收到)
+        ripple.to(`private-support.chat.${payload.conversationId}`).emit('support:new_message', {
+          sender: 'CUSTOMER',
+          text: payload.text,
+          at: new Date(),
+        })
+
+        // 同時通知管理員總收件匣
+        ripple.to('presence-support.admin.inbox').emit('support:inbox_update', {
+          conversationId: payload.conversationId,
+          snippet: payload.text,
+        })
+      }
+    )
+
+    // 註冊管理路由
+    core.router.prefix('/api/admin/v1/support').group((router) => {
+      router.get('/inbox', (ctx) =>
+        ctx.json([
+          {
+            id: 'SESS-001',
+            participant: 'Carl',
+            contextType: 'ORDER',
+            contextId: 'ORD-9921',
+            status: 'PENDING',
+          },
+          {
+            id: 'SESS-002',
+            participant: 'Guest_12',
+            contextType: 'FORM',
+            subject: '網站報價詢問',
+            status: 'ACTIVE',
+          },
+          { id: 'SESS-003', participant: 'Alice', contextType: 'GENERAL', status: 'ACTIVE' },
+        ])
+      )
+
+      router.get('/conversations/:id/messages', (ctx) =>
+        ctx.json([
+          { id: 'msg-1', sender: 'CUSTOMER', content: '您好，我對這張訂單有疑問', at: new Date() },
+        ])
+      )
+    })
+  }
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "baseUrl": ".",
+        "skipLibCheck": true,
+        "types": ["bun-types"],
+        "paths": {
+            "@gravito/core": ["../../packages/core/src/index.ts"],
+            "@gravito/*": ["../../packages/*/src/index.ts"]
+        }
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/*.test.ts"
+    ]
+}