@things-factory/board-ai 10.0.0-beta.108

package/dist-server/service/chat-message/chat-message-publish.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishChatMessage = publishChatMessage;
+/*
+ * chat-message 방송 publisher — pubsub 의존, 데코레이터 없음.
+ *
+ * 데코레이터 resolver(chat-message-subscription.ts)와 분리한 이유: babel-jest 가 파라미터
+ * 데코레이터(@Root/@Arg)를 파싱 못 해 그 파일을 테스트에서 import 할 수 없다. 이 모듈은
+ * 데코레이터가 없어 통합 테스트가 실제 publish→방송 경로를 직접 구동할 수 있다.
+ */
+const shell_1 = require("@things-factory/shell");
+const chat_message_broadcast_js_1 = require("./chat-message-broadcast.js");
+/**
+ * ChatMessage 영속 직후 호출 — 같은 세션 구독자에게 방송.
+ * sessionId 없으면 skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.
+ */
+function publishChatMessage(payload) {
+    if (!payload.sessionId)
+        return;
+    try {
+        shell_1.pubsub.publish(chat_message_broadcast_js_1.CHAT_MESSAGE_TOPIC, payload);
+    }
+    catch {
+        /* 방송 생략 — 영속은 이미 끝남 */
+    }
+}
+//# sourceMappingURL=chat-message-publish.js.map

package/dist-server/service/chat-message/chat-message-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-publish.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-publish.ts"],"names":[],"mappings":";;AAcA,gDAOC;AArBD;;;;;;GAMG;AACH,iDAA8C;AAC9C,2EAAyF;AAEzF;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,OAA2B;IAC5D,IAAI,CAAC,OAAO,CAAC,SAAS;QAAE,OAAM;IAC9B,IAAI,CAAC;QACH,cAAM,CAAC,OAAO,CAAC,8CAAkB,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;AACH,CAAC","sourcesContent":["/*\n * chat-message 방송 publisher — pubsub 의존, 데코레이터 없음.\n *\n * 데코레이터 resolver(chat-message-subscription.ts)와 분리한 이유: babel-jest 가 파라미터\n * 데코레이터(@Root/@Arg)를 파싱 못 해 그 파일을 테스트에서 import 할 수 없다. 이 모듈은\n * 데코레이터가 없어 통합 테스트가 실제 publish→방송 경로를 직접 구동할 수 있다.\n */\nimport { pubsub } from '@things-factory/shell'\nimport { CHAT_MESSAGE_TOPIC, type ChatMessagePayload } from './chat-message-broadcast.js'\n\n/**\n * ChatMessage 영속 직후 호출 — 같은 세션 구독자에게 방송.\n * sessionId 없으면 skip. pubsub 미가용/실패해도 본 흐름(영속 완료)을 막지 않는다.\n */\nexport function publishChatMessage(payload: ChatMessagePayload): void {\n  if (!payload.sessionId) return\n  try {\n    pubsub.publish(CHAT_MESSAGE_TOPIC, payload)\n  } catch {\n    /* 방송 생략 — 영속은 이미 끝남 */\n  }\n}\n"]}

package/dist-server/service/chat-message/chat-message-subscription.d.ts

@@ -0,0 +1,8 @@
+import { ChatMessage } from './chat-message.js';
+import { type ChatMessagePayload } from './chat-message-broadcast.js';
+export { publishChatMessage } from './chat-message-publish.js';
+export { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js';
+export type { ChatMessagePayload } from './chat-message-broadcast.js';
+export declare class BoardChatMessageSubscription {
+    chatMessageActivity(payload: ChatMessagePayload, sessionId: string): ChatMessage;
+}

package/dist-server/service/chat-message/chat-message-subscription.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoardChatMessageSubscription = exports.chatMessageFilter = exports.CHAT_MESSAGE_TOPIC = exports.publishChatMessage = void 0;
+const tslib_1 = require("tslib");
+/*
+ * BoardChatMessageSubscription (Phase Board-AI C4 — 그룹챗 메시지 실시간 방송).
+ *
+ * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →
+ * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.
+ * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).
+ *
+ * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.
+ * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).
+ * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_yoga_1 = require("graphql-yoga");
+const shell_1 = require("@things-factory/shell");
+const chat_message_js_1 = require("./chat-message.js");
+const chat_message_broadcast_js_1 = require("./chat-message-broadcast.js");
+const subscribe_auth_js_1 = require("../subscribe-auth.js");
+// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).
+var chat_message_publish_js_1 = require("./chat-message-publish.js");
+Object.defineProperty(exports, "publishChatMessage", { enumerable: true, get: function () { return chat_message_publish_js_1.publishChatMessage; } });
+var chat_message_broadcast_js_2 = require("./chat-message-broadcast.js");
+Object.defineProperty(exports, "CHAT_MESSAGE_TOPIC", { enumerable: true, get: function () { return chat_message_broadcast_js_2.CHAT_MESSAGE_TOPIC; } });
+Object.defineProperty(exports, "chatMessageFilter", { enumerable: true, get: function () { return chat_message_broadcast_js_2.chatMessageFilter; } });
+let BoardChatMessageSubscription = class BoardChatMessageSubscription {
+    chatMessageActivity(payload, sessionId) {
+        return payload.message;
+    }
+};
+exports.BoardChatMessageSubscription = BoardChatMessageSubscription;
+tslib_1.__decorate([
+    (0, type_graphql_1.Subscription)({
+        description: 'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',
+        subscribe: async ({ args, context }) => {
+            const { domain, user } = context.state;
+            const { sessionId } = args;
+            await (0, subscribe_auth_js_1.assertDomainSubscribeAllowed)(domain, user, (d, u) => process.superUserGranted(d, u));
+            return (0, graphql_yoga_1.pipe)(shell_1.pubsub.subscribe(chat_message_broadcast_js_1.CHAT_MESSAGE_TOPIC), (0, graphql_yoga_1.filter)((0, chat_message_broadcast_js_1.chatMessageFilter)(domain.id, sessionId)));
+        }
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Root)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String]),
+    tslib_1.__metadata("design:returntype", chat_message_js_1.ChatMessage)
+], BoardChatMessageSubscription.prototype, "chatMessageActivity", null);
+exports.BoardChatMessageSubscription = BoardChatMessageSubscription = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)(chat_message_js_1.ChatMessage)
+], BoardChatMessageSubscription);
+//# sourceMappingURL=chat-message-subscription.js.map

package/dist-server/service/chat-message/chat-message-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message-subscription.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-subscription.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;GAUG;AACH,+CAAgE;AAChE,+CAA2C;AAC3C,iDAA8C;AAC9C,uDAA+C;AAC/C,2EAA4G;AAC5G,4DAAmE;AAEnE,8EAA8E;AAC9E,qEAA8D;AAArD,6HAAA,kBAAkB,OAAA;AAC3B,yEAAmF;AAA1E,+HAAA,kBAAkB,OAAA;AAAE,8HAAA,iBAAiB,OAAA;AAIvC,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;IAavC,mBAAmB,CAAS,OAA2B,EAAoB,SAAiB;QAC1F,OAAO,OAAO,CAAC,OAAO,CAAA;IACxB,CAAC;CACF,CAAA;AAhBY,oEAA4B;AAavC;IAZC,IAAA,2BAAY,EAAC;QACZ,WAAW,EACT,gGAAgG;QAClG,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;YAE1B,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,8CAAkB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,6CAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACpG,CAAC;KACF,CAAC;IACmB,mBAAA,IAAA,mBAAI,GAAE,CAAA;IAA+B,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;;;4CAAqB,6BAAW;uEAEzG;uCAfU,4BAA4B;IADxC,IAAA,uBAAQ,EAAC,6BAAW,CAAC;GACT,4BAA4B,CAgBxC","sourcesContent":["/*\n * BoardChatMessageSubscription (Phase Board-AI C4 — 그룹챗 메시지 실시간 방송).\n *\n * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →\n * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.\n * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).\n *\n * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.\n * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).\n * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.\n */\nimport { Resolver, Subscription, Root, Arg } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\nimport { ChatMessage } from './chat-message.js'\nimport { CHAT_MESSAGE_TOPIC, chatMessageFilter, type ChatMessagePayload } from './chat-message-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\n\n// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).\nexport { publishChatMessage } from './chat-message-publish.js'\nexport { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js'\nexport type { ChatMessagePayload } from './chat-message-broadcast.js'\n\n@Resolver(ChatMessage)\nexport class BoardChatMessageSubscription {\n  @Subscription({\n    description:\n      'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',\n    subscribe: async ({ args, context }) => {\n      const { domain, user } = context.state\n      const { sessionId } = args\n\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n\n      return pipe(pubsub.subscribe(CHAT_MESSAGE_TOPIC), filter(chatMessageFilter(domain.id, sessionId)))\n    }\n  })\n  chatMessageActivity(@Root() payload: ChatMessagePayload, @Arg('sessionId') sessionId: string): ChatMessage {\n    return payload.message\n  }\n}\n"]}

package/dist-server/service/chat-message/chat-message.d.ts

@@ -0,0 +1,56 @@
+import { User } from '@things-factory/auth-base';
+import { ChatSession } from '../chat-session/chat-session.js';
+export declare class ChatMessage {
+    readonly id?: string;
+    session?: ChatSession;
+    sessionId?: string;
+    role: string;
+    content: string;
+    relatedPatchId?: string;
+    relatedImportSessionId?: string;
+    /**
+     * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.
+     *
+     * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter
+     * 로 parse 된 객체. UI 의 fold-able 박스 ("AI 가 이런 도구를 사용했습니다") 가
+     * 페이지 reload / loadHistory 후에도 살아있도록 영속.
+     *
+     * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).
+     * null 이면 도구 호출 없었던 메시지 (text-only 응답).
+     */
+    toolUsages?: string;
+    /** GraphQL 노출용 — JSON 배열로 parse. */
+    get toolUsagesJson(): any;
+    /**
+     * 메시지를 일으킨 사용자.
+     *   - role='user' → 보낸 사용자
+     *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)
+     *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)
+     *
+     * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템
+     * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.
+     */
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    /**
+     * 부모 메시지 — 이 메시지가 "응답하는 대상" / "이어가는 메시지" 의 id.
+     *
+     * 의미 (role 별):
+     *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.
+     *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로
+     *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)
+     *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).
+     *
+     * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /
+     * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.
+     *
+     * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.
+     */
+    parentMessage?: ChatMessage;
+    parentMessageId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}

package/dist-server/service/chat-message/chat-message.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatMessage = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ChatMessage — ChatSession 의 한 메시지.
+ *
+ * role: 'user' | 'assistant' | 'system'
+ * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.
+ *
+ * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const chat_session_js_1 = require("../chat-session/chat-session.js");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let ChatMessage = class ChatMessage {
+    /** GraphQL 노출용 — JSON 배열로 parse. */
+    get toolUsagesJson() {
+        if (!this.toolUsages)
+            return null;
+        try {
+            return JSON.parse(this.toolUsages);
+        }
+        catch {
+            return null;
+        }
+    }
+};
+exports.ChatMessage = ChatMessage;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => chat_session_js_1.ChatSession, session => session.messages, { onDelete: 'CASCADE' }),
+    tslib_1.__metadata("design:type", chat_session_js_1.ChatSession)
+], ChatMessage.prototype, "session", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((message) => message.session),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16 }),
+    (0, type_graphql_1.Field)({ description: "'user' | 'assistant' | 'system'" }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "role", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
+    }),
+    (0, type_graphql_1.Field)({ description: 'Message content' }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "content", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "relatedPatchId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'ImportSession.id this message triggered (if any).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "relatedImportSessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined,
+        nullable: true
+    }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "toolUsages", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'
+    }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], ChatMessage.prototype, "toolUsagesJson", null);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who triggered this message.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatMessage.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((message) => message.creator),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Last user to update this message (for future edit support).' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatMessage.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((message) => message.updater),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "updaterId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' }),
+    tslib_1.__metadata("design:type", ChatMessage)
+], ChatMessage.prototype, "parentMessage", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((message) => message.parentMessage),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "parentMessageId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Creation timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatMessage.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatMessage.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Soft delete timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatMessage.prototype, "deletedAt", void 0);
+exports.ChatMessage = ChatMessage = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_chat_message_1', (message) => [message.session, message.createdAt]),
+    (0, type_graphql_1.ObjectType)({ description: 'A single chat message in a ChatSession.' })
+], ChatMessage);
+//# sourceMappingURL=chat-message.js.map

package/dist-server/service/chat-message/chat-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-message.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatMessage — ChatSession 의 한 메시지.\n *\n * role: 'user' | 'assistant' | 'system'\n * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.\n *\n * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_chat_message_1', (message: ChatMessage) => [message.session, message.createdAt])\n@ObjectType({ description: 'A single chat message in a ChatSession.' })\nexport class ChatMessage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.messages, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((message: ChatMessage) => message.session)\n  sessionId?: string\n\n  @Column({ type: 'varchar', length: 16 })\n  @Field({ description: \"'user' | 'assistant' | 'system'\" })\n  role!: string\n\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  @Field({ description: 'Message content' })\n  content!: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' })\n  relatedPatchId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ImportSession.id this message triggered (if any).' })\n  relatedImportSessionId?: string\n\n  /**\n   * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.\n   *\n   * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter\n   * 로 parse 된 객체. UI 의 fold-able 박스 (\"AI 가 이런 도구를 사용했습니다\") 가\n   * 페이지 reload / loadHistory 후에도 살아있도록 영속.\n   *\n   * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).\n   * null 이면 도구 호출 없었던 메시지 (text-only 응답).\n   */\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined,\n    nullable: true\n  })\n  toolUsages?: string\n\n  /** GraphQL 노출용 — JSON 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'\n  })\n  get toolUsagesJson(): any {\n    if (!this.toolUsages) return null\n    try {\n      return JSON.parse(this.toolUsages)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 메시지를 일으킨 사용자.\n   *   - role='user' → 보낸 사용자\n   *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)\n   *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)\n   *\n   * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템\n   * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who triggered this message.' })\n  creator?: User\n\n  @RelationId((message: ChatMessage) => message.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Last user to update this message (for future edit support).' })\n  updater?: User\n\n  @RelationId((message: ChatMessage) => message.updater)\n  updaterId?: string\n\n  /**\n   * 부모 메시지 — 이 메시지가 \"응답하는 대상\" / \"이어가는 메시지\" 의 id.\n   *\n   * 의미 (role 별):\n   *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.\n   *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로\n   *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)\n   *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).\n   *\n   * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /\n   * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.\n   *\n   * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.\n   */\n  @ManyToOne(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' })\n  parentMessage?: ChatMessage\n\n  @RelationId((message: ChatMessage) => message.parentMessage)\n  @Field({\n    nullable: true,\n    description:\n      'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'\n  })\n  parentMessageId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n}\n"]}

package/dist-server/service/chat-message/index.d.ts

@@ -0,0 +1,5 @@
+import { ChatMessage } from './chat-message.js';
+export { ChatMessage };
+export { BoardChatMessageSubscription, publishChatMessage, CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-subscription.js';
+export type { ChatMessagePayload } from './chat-message-subscription.js';
+export declare const entities: (typeof ChatMessage)[];

package/dist-server/service/chat-message/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.chatMessageFilter = exports.CHAT_MESSAGE_TOPIC = exports.publishChatMessage = exports.BoardChatMessageSubscription = exports.ChatMessage = void 0;
+const chat_message_js_1 = require("./chat-message.js");
+Object.defineProperty(exports, "ChatMessage", { enumerable: true, get: function () { return chat_message_js_1.ChatMessage; } });
+var chat_message_subscription_js_1 = require("./chat-message-subscription.js");
+Object.defineProperty(exports, "BoardChatMessageSubscription", { enumerable: true, get: function () { return chat_message_subscription_js_1.BoardChatMessageSubscription; } });
+Object.defineProperty(exports, "publishChatMessage", { enumerable: true, get: function () { return chat_message_subscription_js_1.publishChatMessage; } });
+Object.defineProperty(exports, "CHAT_MESSAGE_TOPIC", { enumerable: true, get: function () { return chat_message_subscription_js_1.CHAT_MESSAGE_TOPIC; } });
+Object.defineProperty(exports, "chatMessageFilter", { enumerable: true, get: function () { return chat_message_subscription_js_1.chatMessageFilter; } });
+exports.entities = [chat_message_js_1.ChatMessage];
+//# sourceMappingURL=index.js.map

package/dist-server/service/chat-message/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/chat-message/index.ts"],"names":[],"mappings":";;;AAAA,uDAA+C;AAEtC,4FAFA,6BAAW,OAEA;AACpB,+EAKuC;AAJrC,4IAAA,4BAA4B,OAAA;AAC5B,kIAAA,kBAAkB,OAAA;AAClB,kIAAA,kBAAkB,OAAA;AAClB,iIAAA,iBAAiB,OAAA;AAIN,QAAA,QAAQ,GAAG,CAAC,6BAAW,CAAC,CAAA","sourcesContent":["import { ChatMessage } from './chat-message.js'\n\nexport { ChatMessage }\nexport {\n  BoardChatMessageSubscription,\n  publishChatMessage,\n  CHAT_MESSAGE_TOPIC,\n  chatMessageFilter\n} from './chat-message-subscription.js'\nexport type { ChatMessagePayload } from './chat-message-subscription.js'\n\nexport const entities = [ChatMessage]\n"]}

package/dist-server/service/chat-session/chat-session.d.ts

@@ -0,0 +1,31 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+import { ChatMessage } from '../chat-message/chat-message.js';
+import { PatchEntry } from '../patch-entry/patch-entry.js';
+export declare class ChatSession {
+    readonly id?: string;
+    domain?: Domain;
+    domainId?: string;
+    /** Board.id 와 연결. Board 가 owning side 가 될 예정. 1:N — 한 보드에 여러 세션 가능. */
+    boardId?: string;
+    /**
+     * 세션의 사용자 정의 이름 (탭 레이블 / 세션 식별 표시용).
+     *
+     * nullable — 미설정 시 UI 가 fallback 라벨 ("세션 N" 또는 createdAt 기반) 사용. 사용자가
+     * 다중 세션 운영 시 의미 부여 (예: "초기 설계", "운영 시뮬레이션", "사용자A 의 사적 세션").
+     */
+    name?: string;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    /** 토큰 절감용 — 오래된 메시지를 LLM 으로 압축한 요약. Phase 2 에서 작성. */
+    lastSummary?: string;
+    /** 사용 모델 식별 — 'anthropic:claude-sonnet-4-6' 등 */
+    aiClientId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+    messages?: ChatMessage[];
+    patches?: PatchEntry[];
+}

package/dist-server/service/chat-session/chat-session.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatSession = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ChatSession — Board 와 결합되는 AI 협력 세션.
+ *
+ * 한 보드에 여러 세션 가능 — DB 레벨 unique 제약 없음.
+ *
+ * 향후 폭증할 세션 분화 차원 (예: thread / 사용자별 / 컨텍스트별 design vs ops /
+ * archived / forked from clone / agent별) 을 미리 차단하지 않기 위해 구조 자체는 1:N
+ * 으로 열어둠. 단일 세션 정책 (현재 UX) 은 app 레벨 idempotent 로직 — `startBoardAISession`
+ * 이 boardId 매칭 시 기존 세션 반환, `chatSessionByBoard` 가 첫 매칭 반환.
+ *
+ * 미래에 다중 세션 활성화 시 discriminator 컬럼 (kind / name / threadId / creatorId 등)
+ * 을 그때 추가. 마이그레이션 부담 최소화 — 현재는 unique 만 풀어 자리 마련.
+ *
+ * board-service 의 Board 가 owning side 가 될 예정 (ChatSession FK).
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const chat_message_js_1 = require("../chat-message/chat-message.js");
+const patch_entry_js_1 = require("../patch-entry/patch-entry.js");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let ChatSession = class ChatSession {
+};
+exports.ChatSession = ChatSession;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], ChatSession.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.domain),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).'
+    }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "boardId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, length: 200 }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'User-given name of this session (tab label / identification).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who created this session.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSession.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.creator),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who last updated this session.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSession.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.updater),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "updaterId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        nullable: true,
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
+    }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Compressed summary of older messages (for token saving).' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "lastSummary", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ChatSession.prototype, "aiClientId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSession.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSession.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    tslib_1.__metadata("design:type", Date
+    // ── 관계 (TypeORM 만, GraphQL 노출은 별도 query 통해 페이징) ──
+    )
+], ChatSession.prototype, "deletedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.OneToMany)(type => chat_message_js_1.ChatMessage, message => message.session),
+    tslib_1.__metadata("design:type", Array)
+], ChatSession.prototype, "messages", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.OneToMany)(type => patch_entry_js_1.PatchEntry, patch => patch.session),
+    tslib_1.__metadata("design:type", Array)
+], ChatSession.prototype, "patches", void 0);
+exports.ChatSession = ChatSession = tslib_1.__decorate([
+    (0, typeorm_1.Entity)()
+    // 인덱스는 조회 성능용으로 유지 (chatSessionByBoard 가 [domain, boardId] 로 자주 쿼리).
+    // unique 제약은 의도적으로 제거 — 한 보드에 여러 세션을 미래에 허용하기 위함.
+    ,
+    (0, typeorm_1.Index)('ix_chat_session_1', (session) => [session.domain, session.boardId]),
+    (0, type_graphql_1.ObjectType)({
+        description: 'AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장).'
+    })
+], ChatSession);
+//# sourceMappingURL=chat-session.js.map

package/dist-server/service/chat-session/chat-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session.js","sourceRoot":"","sources":["../../../server/service/chat-session/chat-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatSession — Board 와 결합되는 AI 협력 세션.\n *\n * 한 보드에 여러 세션 가능 — DB 레벨 unique 제약 없음.\n *\n * 향후 폭증할 세션 분화 차원 (예: thread / 사용자별 / 컨텍스트별 design vs ops /\n * archived / forked from clone / agent별) 을 미리 차단하지 않기 위해 구조 자체는 1:N\n * 으로 열어둠. 단일 세션 정책 (현재 UX) 은 app 레벨 idempotent 로직 — `startBoardAISession`\n * 이 boardId 매칭 시 기존 세션 반환, `chatSessionByBoard` 가 첫 매칭 반환.\n *\n * 미래에 다중 세션 활성화 시 discriminator 컬럼 (kind / name / threadId / creatorId 등)\n * 을 그때 추가. 마이그레이션 부담 최소화 — 현재는 unique 만 풀어 자리 마련.\n *\n * board-service 의 Board 가 owning side 가 될 예정 (ChatSession FK).\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  OneToMany,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatMessage } from '../chat-message/chat-message.js'\nimport { PatchEntry } from '../patch-entry/patch-entry.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n// 인덱스는 조회 성능용으로 유지 (chatSessionByBoard 가 [domain, boardId] 로 자주 쿼리).\n// unique 제약은 의도적으로 제거 — 한 보드에 여러 세션을 미래에 허용하기 위함.\n@Index('ix_chat_session_1', (session: ChatSession) => [session.domain, session.boardId])\n@ObjectType({\n  description: 'AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장).'\n})\nexport class ChatSession {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true })\n  domain?: Domain\n\n  @RelationId((session: ChatSession) => session.domain)\n  domainId?: string\n\n  /** Board.id 와 연결. Board 가 owning side 가 될 예정. 1:N — 한 보드에 여러 세션 가능. */\n  @Column({ nullable: true })\n  @Field({\n    nullable: true,\n    description:\n      'Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).'\n  })\n  boardId?: string\n\n  /**\n   * 세션의 사용자 정의 이름 (탭 레이블 / 세션 식별 표시용).\n   *\n   * nullable — 미설정 시 UI 가 fallback 라벨 (\"세션 N\" 또는 createdAt 기반) 사용. 사용자가\n   * 다중 세션 운영 시 의미 부여 (예: \"초기 설계\", \"운영 시뮬레이션\", \"사용자A 의 사적 세션\").\n   */\n  @Column({ nullable: true, length: 200 })\n  @Field({ nullable: true, description: 'User-given name of this session (tab label / identification).' })\n  name?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'User who created this session.' })\n  creator?: User\n\n  @RelationId((session: ChatSession) => session.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'User who last updated this session.' })\n  updater?: User\n\n  @RelationId((session: ChatSession) => session.updater)\n  updaterId?: string\n\n  /** 토큰 절감용 — 오래된 메시지를 LLM 으로 압축한 요약. Phase 2 에서 작성. */\n  @Column({\n    nullable: true,\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  @Field({ nullable: true, description: 'Compressed summary of older messages (for token saving).' })\n  lastSummary?: string\n\n  /** 사용 모델 식별 — 'anthropic:claude-sonnet-4-6' 등 */\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  aiClientId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  deletedAt?: Date\n\n  // ── 관계 (TypeORM 만, GraphQL 노출은 별도 query 통해 페이징) ──\n  @OneToMany(type => ChatMessage, message => message.session)\n  messages?: ChatMessage[]\n\n  @OneToMany(type => PatchEntry, patch => patch.session)\n  patches?: PatchEntry[]\n}\n"]}

package/dist-server/service/chat-session/index.d.ts

@@ -0,0 +1,3 @@
+import { ChatSession } from './chat-session.js';
+export { ChatSession };
+export declare const entities: (typeof ChatSession)[];

package/dist-server/service/chat-session/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.ChatSession = void 0;
+const chat_session_js_1 = require("./chat-session.js");
+Object.defineProperty(exports, "ChatSession", { enumerable: true, get: function () { return chat_session_js_1.ChatSession; } });
+exports.entities = [chat_session_js_1.ChatSession];
+//# sourceMappingURL=index.js.map

package/dist-server/service/chat-session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/chat-session/index.ts"],"names":[],"mappings":";;;AAAA,uDAA+C;AAEtC,4FAFA,6BAAW,OAEA;AAEP,QAAA,QAAQ,GAAG,CAAC,6BAAW,CAAC,CAAA","sourcesContent":["import { ChatSession } from './chat-session.js'\n\nexport { ChatSession }\n\nexport const entities = [ChatSession]\n"]}

package/dist-server/service/chat-session-participant/chat-session-participant.d.ts

@@ -0,0 +1,30 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+import { ChatSession } from '../chat-session/chat-session.js';
+export declare class ChatSessionParticipant {
+    readonly id?: string;
+    domain?: Domain;
+    domainId?: string;
+    session?: ChatSession;
+    sessionId?: string;
+    user?: User;
+    userId?: string;
+    /**
+     * 참여자의 역할.
+     *   - 'owner': 세션 만든 사람. rename / delete 권한.
+     *   - 'member': 일반 참여자. 메시지 송수신.
+     *   - 'viewer': 읽기 전용 (미래 권한 정책 활성화 시).
+     *
+     * 시작은 'owner' / 'member' 둘로 충분. 더 세분화 필요해지면 enum 확장.
+     */
+    role: string;
+    /** 마지막 활동 시각 — presence indicator. nullable. */
+    lastSeenAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}