@things-factory/ai-assistant 10.1.6

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

@@ -0,0 +1,100 @@
+"use strict";
+/*
+ * 세션 앵커 순수 로직 — 리졸버와 분리.
+ *
+ * chat-session-resolver 는 type-graphql 의 **매개변수 데코레이터**(@Arg)를 쓰므로 jest 의 babel
+ * 파서가 읽지 못한다. 순수 함수를 여기 두면 단위 테스트가 가능하다(chat-echo-dedup ·
+ * chat-input-builder 와 같은 관례).
+ *
+ * **앵커란**: 대화가 무엇에 매달려 있는지. 저작 대화는 보드에, 운영 대화는 공간(사이트와 그 공간에서
+ * 도는 트윈들)에 매달린다. 앵커가 대화의 성격과 **이력 경계**를 정한다 — 보드 편집 이력에 운영
+ * 문답이 끼지 않아야 하고, 그 반대도 마찬가지다.
+ *
+ * **하위호환**: 기존 행은 앵커 컬럼이 비어 있고 boardId 만 있다. 백필하지 않고 **읽을 때** board
+ * 앵커로 간주한다(컬럼 추가만으로 끝내기 위함). 보드 앵커 세션은 anchorId 와 boardId 를 함께
+ * 쓴다(dual-write) — 기존 조회·인덱스·소비자(operato-board 등)가 그대로 동작한다.
+ *
+ * ── Why this file validates instead of casting (2026-09-09) ──────────────────────
+ * `anchorColumns` used to do `(anchorType || 'none') as SessionAnchorType`. That is a cast, not a
+ * check: the type existed and nothing enforced it, so any string reached a nullable varchar and
+ * was stored. The plant lane was about to add a product and stopped to ask which value to write,
+ * which is the only reason this was noticed — the column would have accepted whatever it sent.
+ *
+ * A wrong value here is not a wrong value in one row. The anchor decides which conversations are
+ * listed together and which history a reply may see, so a typo silently creates a second,
+ * invisible bucket: the session is written, the inbox query for the real anchor does not match
+ * it, and the conversation is simply gone from the list with no error anywhere.
+ *
+ * Two rules follow, and both are refusals rather than defaults:
+ *
+ *   · An unknown anchor type throws. A default of 'none' would be worse than a typo, because it
+ *     turns "you named something that does not exist" into "this conversation is about nothing".
+ *   · Every anchor except 'none' requires an id. An anchor is a pointer; `('space', '')` points
+ *     nowhere, and `anchorWhere` would then look for an empty string while `anchorColumns` stored
+ *     NULL — the lookup misses its own row and every call creates another session.
+ *
+ * 'none' therefore means exactly one thing: **not addressable by anchor.** It is the UI state for
+ * "nothing picked yet" (twin's dock refuses to create a session while it holds 'none'), not a
+ * value a product writes because it has nothing narrower to point at. A product whose subject is
+ * the whole tenant anchors to 'domain' and holds the domain id — that conversation is listable and
+ * has a history boundary, and "unanchored" has neither.
+ *
+ * Adding a value to this set is an architect's call, not a lane's. A new anchor type means a new
+ * kind of subject a conversation can be about, and it is stored — once rows carry it, renaming it
+ * orphans them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_ANCHOR_TYPES = void 0;
+exports.isSessionAnchorType = isSessionAnchorType;
+exports.anchorColumns = anchorColumns;
+exports.anchorWhere = anchorWhere;
+/**
+ * 대화가 매달릴 수 있는 것. **저장되는 값이므로 늘리는 것은 아키텍트 판단이다.**
+ *
+ *   board     보드 저작 대화 — 그 보드의 편집 이력
+ *   space     공간 운영 대화 — 사이트와 그 공간에서 도는 트윈들
+ *   instance  트윈 하나에 대한 대화
+ *   domain    테넌트 전체가 주제인 대화 — 공장 전체 문답처럼 더 좁게 가리킬 것이 없을 때
+ *   none      앵커로 찾을 수 없는 대화. 「아직 아무것도 고르지 않았다」는 화면 상태다
+ */
+exports.SESSION_ANCHOR_TYPES = ['board', 'space', 'instance', 'domain', 'none'];
+function isSessionAnchorType(value) {
+    return typeof value === 'string' && exports.SESSION_ANCHOR_TYPES.includes(value);
+}
+function assertAnchorType(anchorType, where) {
+    const type = anchorType || 'none';
+    if (!isSessionAnchorType(type)) {
+        throw new Error(`[board-ai/session-anchor] ${where}: '${type}' is not an anchor type. ` +
+            `Allowed: ${exports.SESSION_ANCHOR_TYPES.join(' · ')}. ` +
+            'The anchor decides which conversations are listed together and which history a reply may see, ' +
+            'so an unrecognised value would write a session the inbox can never find. ' +
+            'If a new kind of subject is needed, raise it — this set is stored in rows.');
+    }
+    return type;
+}
+/** 앵커 → 저장할 컬럼 값. 보드 앵커는 boardId 에도 같은 값을 넣어 기존 조회가 그대로 동작하게 한다. */
+function anchorColumns(anchorType, anchorId) {
+    const type = assertAnchorType(anchorType, 'anchorColumns');
+    const id = anchorId || undefined;
+    if (type !== 'none' && !id) {
+        throw new Error(`[board-ai/session-anchor] anchorColumns: anchor '${type}' was given no id. ` +
+            'An anchor is a pointer, so this would store NULL while the lookup searches for the id it was ' +
+            'given — the session would not be found by its own anchor and every call would create another. ' +
+            "Use 'none' for a conversation that is deliberately not addressable by anchor.");
+    }
+    return { anchorType: type, anchorId: id, boardId: type === 'board' ? id : undefined };
+}
+/**
+ * 앵커 조회 조건. 보드 앵커는 **앵커 컬럼이 빈 옛 행도 잡아야** 하므로 boardId 로 찾는다
+ * (dual-write 덕분에 신규 행도 같은 조건에 걸린다). 그 밖 앵커는 앵커 컬럼으로 찾는다.
+ *
+ * 여기서도 앵커 이름을 검사한다 — 읽기 경로에서 틀린 이름은 오류가 아니라 **0 행**으로 나오고,
+ * 화면은 「대화가 없다」로 그린다. 그 증상으로는 원인을 못 찾는다.
+ */
+function anchorWhere(domainId, anchorType, anchorId) {
+    const type = assertAnchorType(anchorType, 'anchorWhere');
+    if (type === 'board')
+        return { boardId: anchorId, domain: { id: domainId } };
+    return { anchorType: type, anchorId, domain: { id: domainId } };
+}
+//# sourceMappingURL=session-anchor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-anchor.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-anchor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;;;AAeH,kDAEC;AAiBD,sCAeC;AASD,kCAIC;AA5DD;;;;;;;;GAQG;AACU,QAAA,oBAAoB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAA;AAI7F,SAAgB,mBAAmB,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,4BAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AACjG,CAAC;AAED,SAAS,gBAAgB,CAAC,UAA8B,EAAE,KAAa;IACrE,MAAM,IAAI,GAAG,UAAU,IAAI,MAAM,CAAA;IACjC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,6BAA6B,KAAK,MAAM,IAAI,2BAA2B;YACrE,YAAY,4BAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;YAChD,gGAAgG;YAChG,2EAA2E;YAC3E,4EAA4E,CAC/E,CAAA;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oEAAoE;AACpE,SAAgB,aAAa,CAC3B,UAA8B,EAC9B,QAA4B;IAE5B,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;IAC1D,MAAM,EAAE,GAAG,QAAQ,IAAI,SAAS,CAAA;IAChC,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,oDAAoD,IAAI,qBAAqB;YAC3E,+FAA+F;YAC/F,gGAAgG;YAChG,+EAA+E,CAClF,CAAA;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAA;AACvF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,QAAgB,EAAE,UAAkB,EAAE,QAAgB;IAChF,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IACxD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAA;IAC5E,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAA;AACjE,CAAC","sourcesContent":["/*\n * 세션 앵커 순수 로직 — 리졸버와 분리.\n *\n * chat-session-resolver 는 type-graphql 의 **매개변수 데코레이터**(@Arg)를 쓰므로 jest 의 babel\n * 파서가 읽지 못한다. 순수 함수를 여기 두면 단위 테스트가 가능하다(chat-echo-dedup ·\n * chat-input-builder 와 같은 관례).\n *\n * **앵커란**: 대화가 무엇에 매달려 있는지. 저작 대화는 보드에, 운영 대화는 공간(사이트와 그 공간에서\n * 도는 트윈들)에 매달린다. 앵커가 대화의 성격과 **이력 경계**를 정한다 — 보드 편집 이력에 운영\n * 문답이 끼지 않아야 하고, 그 반대도 마찬가지다.\n *\n * **하위호환**: 기존 행은 앵커 컬럼이 비어 있고 boardId 만 있다. 백필하지 않고 **읽을 때** board\n * 앵커로 간주한다(컬럼 추가만으로 끝내기 위함). 보드 앵커 세션은 anchorId 와 boardId 를 함께\n * 쓴다(dual-write) — 기존 조회·인덱스·소비자(operato-board 등)가 그대로 동작한다.\n *\n * ── Why this file validates instead of casting (2026-09-09) ──────────────────────\n * `anchorColumns` used to do `(anchorType || 'none') as SessionAnchorType`. That is a cast, not a\n * check: the type existed and nothing enforced it, so any string reached a nullable varchar and\n * was stored. The plant lane was about to add a product and stopped to ask which value to write,\n * which is the only reason this was noticed — the column would have accepted whatever it sent.\n *\n * A wrong value here is not a wrong value in one row. The anchor decides which conversations are\n * listed together and which history a reply may see, so a typo silently creates a second,\n * invisible bucket: the session is written, the inbox query for the real anchor does not match\n * it, and the conversation is simply gone from the list with no error anywhere.\n *\n * Two rules follow, and both are refusals rather than defaults:\n *\n *   · An unknown anchor type throws. A default of 'none' would be worse than a typo, because it\n *     turns \"you named something that does not exist\" into \"this conversation is about nothing\".\n *   · Every anchor except 'none' requires an id. An anchor is a pointer; `('space', '')` points\n *     nowhere, and `anchorWhere` would then look for an empty string while `anchorColumns` stored\n *     NULL — the lookup misses its own row and every call creates another session.\n *\n * 'none' therefore means exactly one thing: **not addressable by anchor.** It is the UI state for\n * \"nothing picked yet\" (twin's dock refuses to create a session while it holds 'none'), not a\n * value a product writes because it has nothing narrower to point at. A product whose subject is\n * the whole tenant anchors to 'domain' and holds the domain id — that conversation is listable and\n * has a history boundary, and \"unanchored\" has neither.\n *\n * Adding a value to this set is an architect's call, not a lane's. A new anchor type means a new\n * kind of subject a conversation can be about, and it is stored — once rows carry it, renaming it\n * orphans them.\n */\n\n/**\n * 대화가 매달릴 수 있는 것. **저장되는 값이므로 늘리는 것은 아키텍트 판단이다.**\n *\n *   board     보드 저작 대화 — 그 보드의 편집 이력\n *   space     공간 운영 대화 — 사이트와 그 공간에서 도는 트윈들\n *   instance  트윈 하나에 대한 대화\n *   domain    테넌트 전체가 주제인 대화 — 공장 전체 문답처럼 더 좁게 가리킬 것이 없을 때\n *   none      앵커로 찾을 수 없는 대화. 「아직 아무것도 고르지 않았다」는 화면 상태다\n */\nexport const SESSION_ANCHOR_TYPES = ['board', 'space', 'instance', 'domain', 'none'] as const\n\nexport type SessionAnchorType = (typeof SESSION_ANCHOR_TYPES)[number]\n\nexport function isSessionAnchorType(value: unknown): value is SessionAnchorType {\n  return typeof value === 'string' && (SESSION_ANCHOR_TYPES as readonly string[]).includes(value)\n}\n\nfunction assertAnchorType(anchorType: string | undefined, where: string): SessionAnchorType {\n  const type = anchorType || 'none'\n  if (!isSessionAnchorType(type)) {\n    throw new Error(\n      `[board-ai/session-anchor] ${where}: '${type}' is not an anchor type. ` +\n        `Allowed: ${SESSION_ANCHOR_TYPES.join(' · ')}. ` +\n        'The anchor decides which conversations are listed together and which history a reply may see, ' +\n        'so an unrecognised value would write a session the inbox can never find. ' +\n        'If a new kind of subject is needed, raise it — this set is stored in rows.'\n    )\n  }\n  return type\n}\n\n/** 앵커 → 저장할 컬럼 값. 보드 앵커는 boardId 에도 같은 값을 넣어 기존 조회가 그대로 동작하게 한다. */\nexport function anchorColumns(\n  anchorType: string | undefined,\n  anchorId: string | undefined\n): { anchorType: SessionAnchorType; anchorId?: string; boardId?: string } {\n  const type = assertAnchorType(anchorType, 'anchorColumns')\n  const id = anchorId || undefined\n  if (type !== 'none' && !id) {\n    throw new Error(\n      `[board-ai/session-anchor] anchorColumns: anchor '${type}' was given no id. ` +\n        'An anchor is a pointer, so this would store NULL while the lookup searches for the id it was ' +\n        'given — the session would not be found by its own anchor and every call would create another. ' +\n        \"Use 'none' for a conversation that is deliberately not addressable by anchor.\"\n    )\n  }\n  return { anchorType: type, anchorId: id, boardId: type === 'board' ? id : undefined }\n}\n\n/**\n * 앵커 조회 조건. 보드 앵커는 **앵커 컬럼이 빈 옛 행도 잡아야** 하므로 boardId 로 찾는다\n * (dual-write 덕분에 신규 행도 같은 조건에 걸린다). 그 밖 앵커는 앵커 컬럼으로 찾는다.\n *\n * 여기서도 앵커 이름을 검사한다 — 읽기 경로에서 틀린 이름은 오류가 아니라 **0 행**으로 나오고,\n * 화면은 「대화가 없다」로 그린다. 그 증상으로는 원인을 못 찾는다.\n */\nexport function anchorWhere(domainId: string, anchorType: string, anchorId: string): any {\n  const type = assertAnchorType(anchorType, 'anchorWhere')\n  if (type === 'board') return { boardId: anchorId, domain: { id: domainId } }\n  return { anchorType: type, anchorId, domain: { id: domainId } }\n}\n"]}

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

@@ -0,0 +1,80 @@
+/** 목록에 필요한 세션 필드(엔티티·typeorm 비의존). */
+export interface InboxSessionRow {
+    id?: string;
+    name?: string;
+    anchorType?: string;
+    anchorId?: string;
+    boardId?: string;
+    lastMessageAt?: Date | string | null;
+    lastMessagePreview?: string | null;
+    createdAt?: Date | string | null;
+}
+/** 내 참여 기록(읽은 지점). */
+export interface MyParticipation {
+    sessionId?: string;
+    lastReadAt?: Date | string | null;
+    /** 내 목록에서 숨긴 시각 — 이후 새 활동이 생기면 다시 보인다. */
+    hiddenAt?: Date | string | null;
+}
+export interface InboxEntry extends InboxSessionRow {
+    /** 안 읽은 활동이 있는가 — 목록의 점 표시. */
+    unread: boolean;
+    /** 내가 참여자인가 — 아니면 열어볼 수는 있어도 읽음 상태를 갖지 않는다. */
+    participant: boolean;
+    /** 내가 숨긴 대화인가 — 목록에서 빠지지만 필터로 볼 수 있다(되돌리기 가능). */
+    hidden?: boolean;
+}
+/**
+ * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.
+ *
+ * 안 읽음 판정: 세션의 마지막 활동이 내가 읽은 지점보다 **뒤**면 안 읽음.
+ *   · 참여자가 아니면 안 읽음으로 표시하지 않는다(내 것이 아닌 대화에 배지를 띄우지 않는다).
+ *   · 참여자인데 한 번도 읽지 않았고(lastReadAt 없음) 활동이 있으면 안 읽음이다.
+ *   · 활동이 없는 세션(빈 대화)은 안 읽음이 아니다.
+ *
+ * 같은 시각 비교는 **엄격 초과**만 안 읽음으로 본다 — 읽은 직후 같은 밀리초에 저장된 활동을 안 읽음으로
+ * 잡으면 방금 읽은 화면에 배지가 남는다.
+ */
+export declare function buildInbox(sessions: InboxSessionRow[], mine: MyParticipation[]): InboxEntry[];
+/**
+ * 숨김 표시·필터.
+ *
+ * 숨김은 **나에게만** 적용되고 되돌릴 수 있다. 숨긴 **뒤에 새 활동이 생기면 다시 보인다** —
+ * 아직 참여 중인 대화에서 조용히 잘려 나가는 것이 목록 한 줄보다 나쁘다.
+ *
+ * `showHidden` 이면 숨긴 것도 함께 돌려주되 표시(hidden)를 남긴다 — 필터를 켠 사용자가 무엇이
+ * 숨겨진 것인지 알아야 되돌릴 수 있다.
+ */
+export declare function applyHidden(entries: InboxEntry[], hiddenAt: Map<string, Date | string | null | undefined>, showHidden?: boolean): InboxEntry[];
+/**
+ * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.
+ *
+ * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은
+ * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),
+ * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로
+ * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.
+ * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).
+ */
+export declare function searchInbox(entries: InboxEntry[], search?: string): InboxEntry[];
+/** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */
+export declare const INBOX_SCAN_CAP = 500;
+/** 안 읽은 세션 수 — 도크 버튼 배지(개수가 아니라 **세션 수**). */
+export declare function countUnreadSessions(entries: InboxEntry[]): number;
+/**
+ * 메시지 저장 시 세션에 반영할 활동 값. 미리보기는 짧게 자르고 개행을 없앤다
+ * (목록 한 줄에 들어가야 하고, 컬럼 길이 제한이 있다).
+ */
+export declare function activityPatch(content: string, at?: Date): {
+    lastMessageAt: Date;
+    lastMessagePreview: string;
+};
+/**
+ * 첫 발화로 세션 이름을 만든다.
+ *
+ * `세션 2` 같은 순번은 목록에서 아무것도 알려주지 않는다 — "A-DC 포화 원인" 이어야 돌아갈 대화를 찾는다.
+ * 사용자가 직접 지은 이름은 이 함수로 덮지 않는다(호출부가 이름 없을 때만 부른다).
+ *
+ * 규칙: 한 줄로 눌러 첫 문장 경계(., ?, !, 개행)까지, 최대 40자. 문장 부호로 끝나면 떼어 낸다
+ * (목록 제목에 물음표가 붙으면 길이만 먹는다).
+ */
+export declare function autoSessionName(content: string, max?: number): string;

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

@@ -0,0 +1,133 @@
+"use strict";
+/*
+ * 세션 목록(받은편지함) 순수 로직 — 리졸버와 분리해 단위 테스트 가능.
+ *
+ * ── 왜 필요한가 ─────────────────────────────────────────────────────────────
+ * 대화가 늘면(가벼운 질문을 승격할 때마다 새 세션) "어디로 갈지"를 목록에서 골라야 하고, 다른 참여자가
+ * 남긴 새 메시지를 알아야 한다. 세션 목록은 **최근 활동순**이어야 하고 **안 읽음**이 보여야 한다.
+ *
+ * ── 집계 쿼리를 쓰지 않는다 ─────────────────────────────────────────────────
+ * 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계가 붙고, 이 프레임워크는 5개 DB
+ * 드라이버를 지원해야 한다. 대신 `ChatSession.lastMessageAt` 을 비정규화해 두고(메시지 저장 시 갱신),
+ * 참여자의 `lastReadAt` 과 **값 비교**로 안 읽음을 판정한다 — 조회 두 번(세션·내 참여자)으로 끝난다.
+ *
+ * ── v1 은 개수가 아니라 "안 읽음 여부" ──────────────────────────────────────
+ * 정확한 미읽음 **개수**는 세션별 count 가 필요하다(목록 N개면 N번). 목록에서는 점 하나로 충분하고,
+ * 숫자가 필요해지면 화면에 보이는 세션에 한해 따로 세면 된다. 처음부터 N번 세지 않는다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INBOX_SCAN_CAP = void 0;
+exports.buildInbox = buildInbox;
+exports.applyHidden = applyHidden;
+exports.searchInbox = searchInbox;
+exports.countUnreadSessions = countUnreadSessions;
+exports.activityPatch = activityPatch;
+exports.autoSessionName = autoSessionName;
+function time(v) {
+    if (!v)
+        return 0;
+    const t = v instanceof Date ? v.getTime() : Date.parse(v);
+    return Number.isFinite(t) ? t : 0;
+}
+/**
+ * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.
+ *
+ * 안 읽음 판정: 세션의 마지막 활동이 내가 읽은 지점보다 **뒤**면 안 읽음.
+ *   · 참여자가 아니면 안 읽음으로 표시하지 않는다(내 것이 아닌 대화에 배지를 띄우지 않는다).
+ *   · 참여자인데 한 번도 읽지 않았고(lastReadAt 없음) 활동이 있으면 안 읽음이다.
+ *   · 활동이 없는 세션(빈 대화)은 안 읽음이 아니다.
+ *
+ * 같은 시각 비교는 **엄격 초과**만 안 읽음으로 본다 — 읽은 직후 같은 밀리초에 저장된 활동을 안 읽음으로
+ * 잡으면 방금 읽은 화면에 배지가 남는다.
+ */
+function buildInbox(sessions, mine) {
+    const readBy = new Map();
+    const isParticipant = new Set();
+    for (const p of mine) {
+        if (!p.sessionId)
+            continue;
+        isParticipant.add(p.sessionId);
+        readBy.set(p.sessionId, time(p.lastReadAt));
+    }
+    const entries = sessions.map(session => {
+        const id = session.id ?? '';
+        const activity = time(session.lastMessageAt);
+        const participant = isParticipant.has(id);
+        const read = readBy.get(id) ?? 0;
+        return {
+            ...session,
+            participant,
+            unread: participant && activity > 0 && activity > read
+        };
+    });
+    return entries.sort((a, b) => (time(b.lastMessageAt) || time(b.createdAt)) - (time(a.lastMessageAt) || time(a.createdAt)));
+}
+/**
+ * 숨김 표시·필터.
+ *
+ * 숨김은 **나에게만** 적용되고 되돌릴 수 있다. 숨긴 **뒤에 새 활동이 생기면 다시 보인다** —
+ * 아직 참여 중인 대화에서 조용히 잘려 나가는 것이 목록 한 줄보다 나쁘다.
+ *
+ * `showHidden` 이면 숨긴 것도 함께 돌려주되 표시(hidden)를 남긴다 — 필터를 켠 사용자가 무엇이
+ * 숨겨진 것인지 알아야 되돌릴 수 있다.
+ */
+function applyHidden(entries, hiddenAt, showHidden = false) {
+    const out = [];
+    for (const entry of entries) {
+        const at = hiddenAt.get(entry.id ?? '');
+        /* 숨긴 시각보다 **뒤에** 활동이 있으면 숨김은 풀린 것으로 본다. */
+        const hidden = !!at && time(entry.lastMessageAt) <= time(at);
+        if (hidden && !showHidden)
+            continue;
+        out.push(hidden ? { ...entry, hidden: true } : entry);
+    }
+    return out;
+}
+/**
+ * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.
+ *
+ * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은
+ * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),
+ * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로
+ * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.
+ * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).
+ */
+function searchInbox(entries, search) {
+    const q = (search ?? '').trim().toLowerCase();
+    if (!q)
+        return entries;
+    return entries.filter(e => `${e.name ?? ''}\n${e.lastMessagePreview ?? ''}`.toLowerCase().includes(q));
+}
+/** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */
+exports.INBOX_SCAN_CAP = 500;
+/** 안 읽은 세션 수 — 도크 버튼 배지(개수가 아니라 **세션 수**). */
+function countUnreadSessions(entries) {
+    return entries.filter(e => e.unread).length;
+}
+/**
+ * 메시지 저장 시 세션에 반영할 활동 값. 미리보기는 짧게 자르고 개행을 없앤다
+ * (목록 한 줄에 들어가야 하고, 컬럼 길이 제한이 있다).
+ */
+function activityPatch(content, at = new Date()) {
+    const flat = (content ?? '').replace(/\s+/g, ' ').trim();
+    return { lastMessageAt: at, lastMessagePreview: flat.slice(0, 200) };
+}
+/**
+ * 첫 발화로 세션 이름을 만든다.
+ *
+ * `세션 2` 같은 순번은 목록에서 아무것도 알려주지 않는다 — "A-DC 포화 원인" 이어야 돌아갈 대화를 찾는다.
+ * 사용자가 직접 지은 이름은 이 함수로 덮지 않는다(호출부가 이름 없을 때만 부른다).
+ *
+ * 규칙: 한 줄로 눌러 첫 문장 경계(., ?, !, 개행)까지, 최대 40자. 문장 부호로 끝나면 떼어 낸다
+ * (목록 제목에 물음표가 붙으면 길이만 먹는다).
+ */
+function autoSessionName(content, max = 40) {
+    const flat = (content ?? '').replace(/\s+/g, ' ').trim();
+    if (!flat)
+        return '';
+    const cut = flat.search(/[.?!\n]/);
+    const head = (cut > 0 ? flat.slice(0, cut) : flat).trim();
+    const name = head.length > max ? head.slice(0, max).trim() + '…' : head;
+    return name;
+}
+//# sourceMappingURL=session-inbox.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-inbox.js","sourceRoot":"","sources":["../../../server/service/chat-session/session-inbox.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAgDH,gCAwBC;AAWD,kCAUC;AAWD,kCAMC;AAMD,kDAEC;AAMD,sCAGC;AAWD,0CAOC;AAlHD,SAAS,IAAI,CAAC,CAAmC;IAC/C,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAA;IAChB,MAAM,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,UAAU,CAAC,QAA2B,EAAE,IAAuB;IAC7E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAA;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,SAAQ;QAC1B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;QACrC,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QAC5C,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO;YACL,GAAG,OAAO;YACV,WAAW;YACX,MAAM,EAAE,WAAW,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,GAAG,IAAI;SACvD,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,OAAO,CAAC,IAAI,CACjB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACtG,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,OAAqB,EAAE,QAAuD,EAAE,UAAU,GAAG,KAAK;IAC5H,MAAM,GAAG,GAAiB,EAAE,CAAA;IAC5B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;QACvC,2CAA2C;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;QAC5D,IAAI,MAAM,IAAI,CAAC,UAAU;YAAE,SAAQ;QACnC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,WAAW,CAAC,OAAqB,EAAE,MAAe;IAChE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7C,IAAI,CAAC,CAAC;QAAE,OAAO,OAAO,CAAA;IACtB,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACxB,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,KAAK,CAAC,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC3E,CAAA;AACH,CAAC;AAED,4CAA4C;AAC/B,QAAA,cAAc,GAAG,GAAG,CAAA;AAEjC,8CAA8C;AAC9C,SAAgB,mBAAmB,CAAC,OAAqB;IACvD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAA;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,KAAW,IAAI,IAAI,EAAE;IAClE,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxD,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;AACtE,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,GAAG,GAAG,EAAE;IACvD,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;IACvE,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/*\n * 세션 목록(받은편지함) 순수 로직 — 리졸버와 분리해 단위 테스트 가능.\n *\n * ── 왜 필요한가 ─────────────────────────────────────────────────────────────\n * 대화가 늘면(가벼운 질문을 승격할 때마다 새 세션) \"어디로 갈지\"를 목록에서 골라야 하고, 다른 참여자가\n * 남긴 새 메시지를 알아야 한다. 세션 목록은 **최근 활동순**이어야 하고 **안 읽음**이 보여야 한다.\n *\n * ── 집계 쿼리를 쓰지 않는다 ─────────────────────────────────────────────────\n * 세션마다 메시지를 집계하면(MAX/COUNT + group by) 목록 한 번에 집계가 붙고, 이 프레임워크는 5개 DB\n * 드라이버를 지원해야 한다. 대신 `ChatSession.lastMessageAt` 을 비정규화해 두고(메시지 저장 시 갱신),\n * 참여자의 `lastReadAt` 과 **값 비교**로 안 읽음을 판정한다 — 조회 두 번(세션·내 참여자)으로 끝난다.\n *\n * ── v1 은 개수가 아니라 \"안 읽음 여부\" ──────────────────────────────────────\n * 정확한 미읽음 **개수**는 세션별 count 가 필요하다(목록 N개면 N번). 목록에서는 점 하나로 충분하고,\n * 숫자가 필요해지면 화면에 보이는 세션에 한해 따로 세면 된다. 처음부터 N번 세지 않는다.\n */\n\n/** 목록에 필요한 세션 필드(엔티티·typeorm 비의존). */\nexport interface InboxSessionRow {\n  id?: string\n  name?: string\n  anchorType?: string\n  anchorId?: string\n  boardId?: string\n  lastMessageAt?: Date | string | null\n  lastMessagePreview?: string | null\n  createdAt?: Date | string | null\n}\n\n/** 내 참여 기록(읽은 지점). */\nexport interface MyParticipation {\n  sessionId?: string\n  lastReadAt?: Date | string | null\n  /** 내 목록에서 숨긴 시각 — 이후 새 활동이 생기면 다시 보인다. */\n  hiddenAt?: Date | string | null\n}\n\nexport interface InboxEntry extends InboxSessionRow {\n  /** 안 읽은 활동이 있는가 — 목록의 점 표시. */\n  unread: boolean\n  /** 내가 참여자인가 — 아니면 열어볼 수는 있어도 읽음 상태를 갖지 않는다. */\n  participant: boolean\n  /** 내가 숨긴 대화인가 — 목록에서 빠지지만 필터로 볼 수 있다(되돌리기 가능). */\n  hidden?: boolean\n}\n\nfunction time(v: Date | string | null | undefined): number {\n  if (!v) return 0\n  const t = v instanceof Date ? v.getTime() : Date.parse(v)\n  return Number.isFinite(t) ? t : 0\n}\n\n/**\n * 세션 + 내 참여 기록 → 목록 항목. **최근 활동순**(활동 없으면 생성순) 내림차순.\n *\n * 안 읽음 판정: 세션의 마지막 활동이 내가 읽은 지점보다 **뒤**면 안 읽음.\n *   · 참여자가 아니면 안 읽음으로 표시하지 않는다(내 것이 아닌 대화에 배지를 띄우지 않는다).\n *   · 참여자인데 한 번도 읽지 않았고(lastReadAt 없음) 활동이 있으면 안 읽음이다.\n *   · 활동이 없는 세션(빈 대화)은 안 읽음이 아니다.\n *\n * 같은 시각 비교는 **엄격 초과**만 안 읽음으로 본다 — 읽은 직후 같은 밀리초에 저장된 활동을 안 읽음으로\n * 잡으면 방금 읽은 화면에 배지가 남는다.\n */\nexport function buildInbox(sessions: InboxSessionRow[], mine: MyParticipation[]): InboxEntry[] {\n  const readBy = new Map<string, number>()\n  const isParticipant = new Set<string>()\n  for (const p of mine) {\n    if (!p.sessionId) continue\n    isParticipant.add(p.sessionId)\n    readBy.set(p.sessionId, time(p.lastReadAt))\n  }\n\n  const entries = sessions.map(session => {\n    const id = session.id ?? ''\n    const activity = time(session.lastMessageAt)\n    const participant = isParticipant.has(id)\n    const read = readBy.get(id) ?? 0\n    return {\n      ...session,\n      participant,\n      unread: participant && activity > 0 && activity > read\n    }\n  })\n\n  return entries.sort(\n    (a, b) => (time(b.lastMessageAt) || time(b.createdAt)) - (time(a.lastMessageAt) || time(a.createdAt))\n  )\n}\n\n/**\n * 숨김 표시·필터.\n *\n * 숨김은 **나에게만** 적용되고 되돌릴 수 있다. 숨긴 **뒤에 새 활동이 생기면 다시 보인다** —\n * 아직 참여 중인 대화에서 조용히 잘려 나가는 것이 목록 한 줄보다 나쁘다.\n *\n * `showHidden` 이면 숨긴 것도 함께 돌려주되 표시(hidden)를 남긴다 — 필터를 켠 사용자가 무엇이\n * 숨겨진 것인지 알아야 되돌릴 수 있다.\n */\nexport function applyHidden(entries: InboxEntry[], hiddenAt: Map<string, Date | string | null | undefined>, showHidden = false): InboxEntry[] {\n  const out: InboxEntry[] = []\n  for (const entry of entries) {\n    const at = hiddenAt.get(entry.id ?? '')\n    /* 숨긴 시각보다 **뒤에** 활동이 있으면 숨김은 풀린 것으로 본다. */\n    const hidden = !!at && time(entry.lastMessageAt) <= time(at)\n    if (hidden && !showHidden) continue\n    out.push(hidden ? { ...entry, hidden: true } : entry)\n  }\n  return out\n}\n\n/**\n * 검색 — 이름과 마지막 미리보기에 대한 대소문자 무시 부분일치.\n *\n * **왜 메모리에서 하는가**: 이 프레임워크는 5개 DB 드라이버를 지원한다. 대소문자 무시 검색은\n * 드라이버마다 표기가 갈리고(ILIKE=pg 전용, LOWER()+LIKE 는 되지만 정렬·NULL 취급이 또 갈린다),\n * 목록 경로에 드라이버별 SQL 을 두는 것은 이 프로젝트의 규율에 반한다. 그래서 조회는 앵커로\n * **상한을 두고** 가져오고(아래 INBOX_SCAN_CAP) 걸러내기·정렬·페이지는 여기서 한다.\n * 상한을 넘으면 잘렸다는 사실을 그대로 알린다(조용히 일부만 보여주지 않는다).\n */\nexport function searchInbox(entries: InboxEntry[], search?: string): InboxEntry[] {\n  const q = (search ?? '').trim().toLowerCase()\n  if (!q) return entries\n  return entries.filter(e =>\n    `${e.name ?? ''}\\n${e.lastMessagePreview ?? ''}`.toLowerCase().includes(q)\n  )\n}\n\n/** 한 번에 훑는 세션 상한 — 이보다 많으면 잘렸다고 알린다(정직). */\nexport const INBOX_SCAN_CAP = 500\n\n/** 안 읽은 세션 수 — 도크 버튼 배지(개수가 아니라 **세션 수**). */\nexport function countUnreadSessions(entries: InboxEntry[]): number {\n  return entries.filter(e => e.unread).length\n}\n\n/**\n * 메시지 저장 시 세션에 반영할 활동 값. 미리보기는 짧게 자르고 개행을 없앤다\n * (목록 한 줄에 들어가야 하고, 컬럼 길이 제한이 있다).\n */\nexport function activityPatch(content: string, at: Date = new Date()): { lastMessageAt: Date; lastMessagePreview: string } {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  return { lastMessageAt: at, lastMessagePreview: flat.slice(0, 200) }\n}\n\n/**\n * 첫 발화로 세션 이름을 만든다.\n *\n * `세션 2` 같은 순번은 목록에서 아무것도 알려주지 않는다 — \"A-DC 포화 원인\" 이어야 돌아갈 대화를 찾는다.\n * 사용자가 직접 지은 이름은 이 함수로 덮지 않는다(호출부가 이름 없을 때만 부른다).\n *\n * 규칙: 한 줄로 눌러 첫 문장 경계(., ?, !, 개행)까지, 최대 40자. 문장 부호로 끝나면 떼어 낸다\n * (목록 제목에 물음표가 붙으면 길이만 먹는다).\n */\nexport function autoSessionName(content: string, max = 40): string {\n  const flat = (content ?? '').replace(/\\s+/g, ' ').trim()\n  if (!flat) return ''\n  const cut = flat.search(/[.?!\\n]/)\n  const head = (cut > 0 ? flat.slice(0, cut) : flat).trim()\n  const name = head.length > max ? head.slice(0, max).trim() + '…' : head\n  return name\n}\n"]}

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

@@ -0,0 +1,49 @@
+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;
+    /**
+     * 이 참여자가 **읽은 지점**. 세션의 마지막 활동 시각과 비교해 안 읽음을 판정한다.
+     *
+     * `lastSeenAt`(접속 표시)과 다른 개념이다 — 창을 열어 두고 화면을 안 볼 수 있고, 접속이 끊긴 뒤에도
+     * 읽은 지점은 남는다. 두 값을 섞어 쓰면 "봤는데 안 읽음" 또는 그 반대가 된다.
+     * nullable — 한 번도 읽지 않은 참여자(초대 직후)는 세션의 모든 활동이 안 읽음이다.
+     */
+    lastReadAt?: Date;
+    /**
+     * 이 사용자가 **자기 목록에서 숨긴 시각**. 숨김은 **나에게만** 적용된다 — 남의 목록·대화 내용은 그대로다.
+     *
+     * 왜 삭제와 나누는가: 협의는 여럿의 기록이므로 지우는 것은 **만든 사람**만 할 수 있다(되돌릴 수 없다).
+     * 그 권한이 없는 사람에게도 "내 목록을 정리할" 방법은 있어야 하고, 그것이 숨김이다.
+     *
+     * 숨긴 **뒤에 새 활동이 생기면 다시 나타난다** — 아직 참여자인 대화에서 조용히 잘려 나가는 것이
+     * 목록이 한 줄 늘어나는 것보다 나쁘다. 완전히 빠지려면 대화에서 나가야 한다(별개 기능).
+     * nullable — 값이 없으면 숨기지 않은 상태.
+     */
+    hiddenAt?: Date;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+    deletedAt?: Date;
+}

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

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatSessionParticipant = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ChatSessionParticipant — 채팅 세션의 참여 사용자.
+ *
+ * 한 ChatSession 에 여러 사용자가 참여할 수 있고, 각자 role (owner / member / viewer 등)
+ * 을 가짐. 다자간 채팅 / 권한 분화 / "내 세션 목록" / 멤버 표시 등의 기반.
+ *
+ * 현재 visibility 정책 (도메인 내 모두 공개) 은 그대로 유지 — 본 엔티티는 영속/추적
+ * 데이터 만들고, "참여자만 접근" 같은 enforcement 는 정책 굳을 때 별도 phase 에서 도입.
+ *
+ * 자동 참여 vs 명시적 초대 정책도 미정 — 일단 세션 creator 만 자동 'owner' 로 등록.
+ */
+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 chat_session_js_1 = require("../chat-session/chat-session.js");
+let ChatSessionParticipant = class ChatSessionParticipant {
+};
+exports.ChatSessionParticipant = ChatSessionParticipant;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique participant id.' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.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, description: 'Domain to which this participant belongs.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], ChatSessionParticipant.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((p) => p.domain),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => chat_session_js_1.ChatSession, { onDelete: 'CASCADE' }),
+    (0, type_graphql_1.Field)(type => chat_session_js_1.ChatSession, { nullable: true, description: 'The ChatSession this participation belongs to.' }),
+    tslib_1.__metadata("design:type", chat_session_js_1.ChatSession)
+], ChatSessionParticipant.prototype, "session", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((p) => p.session),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.prototype, "sessionId", 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: 'The user participating in the session.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSessionParticipant.prototype, "user", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((p) => p.user),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.prototype, "userId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16, default: 'member' }),
+    (0, type_graphql_1.Field)({ description: 'Role of this participant: owner | member | viewer.' }),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.prototype, "role", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last seen / activity timestamp (presence indicator).' }),
+    tslib_1.__metadata("design:type", Date
+    /**
+     * 이 참여자가 **읽은 지점**. 세션의 마지막 활동 시각과 비교해 안 읽음을 판정한다.
+     *
+     * `lastSeenAt`(접속 표시)과 다른 개념이다 — 창을 열어 두고 화면을 안 볼 수 있고, 접속이 끊긴 뒤에도
+     * 읽은 지점은 남는다. 두 값을 섞어 쓰면 "봤는데 안 읽음" 또는 그 반대가 된다.
+     * nullable — 한 번도 읽지 않은 참여자(초대 직후)는 세션의 모든 활동이 안 읽음이다.
+     */
+    )
+], ChatSessionParticipant.prototype, "lastSeenAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Point up to which this participant has read the session. Distinct from lastSeenAt (presence): a window can be open without being read, and the read point survives disconnection. Null means nothing read yet.' }),
+    tslib_1.__metadata("design:type", Date
+    /**
+     * 이 사용자가 **자기 목록에서 숨긴 시각**. 숨김은 **나에게만** 적용된다 — 남의 목록·대화 내용은 그대로다.
+     *
+     * 왜 삭제와 나누는가: 협의는 여럿의 기록이므로 지우는 것은 **만든 사람**만 할 수 있다(되돌릴 수 없다).
+     * 그 권한이 없는 사람에게도 "내 목록을 정리할" 방법은 있어야 하고, 그것이 숨김이다.
+     *
+     * 숨긴 **뒤에 새 활동이 생기면 다시 나타난다** — 아직 참여자인 대화에서 조용히 잘려 나가는 것이
+     * 목록이 한 줄 늘어나는 것보다 나쁘다. 완전히 빠지려면 대화에서 나가야 한다(별개 기능).
+     * nullable — 값이 없으면 숨기지 않은 상태.
+     */
+    )
+], ChatSessionParticipant.prototype, "lastReadAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When this user hid the session from their own list. Per-user only; the session and other participants are unaffected. Activity newer than this timestamp makes it reappear.' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSessionParticipant.prototype, "hiddenAt", 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 participant record (typically session owner who invited).' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSessionParticipant.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((p) => p.creator),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.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: 'Last user to update this participant record (e.g., role change).' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ChatSessionParticipant.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((p) => p.updater),
+    tslib_1.__metadata("design:type", String)
+], ChatSessionParticipant.prototype, "updaterId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Joined-at timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSessionParticipant.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Last update timestamp (role change / lastSeenAt bump).' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSessionParticipant.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.DeleteDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Soft delete (= left session) timestamp.' }),
+    tslib_1.__metadata("design:type", Date)
+], ChatSessionParticipant.prototype, "deletedAt", void 0);
+exports.ChatSessionParticipant = ChatSessionParticipant = tslib_1.__decorate([
+    (0, typeorm_1.Entity)('chat_session_participants'),
+    (0, typeorm_1.Index)('ix_chat_session_participant_0', ['domain', 'session', 'user'], {
+        unique: true,
+        where: '"deleted_at" IS NULL'
+    }),
+    (0, typeorm_1.Index)('ix_chat_session_participant_1', ['domain', 'user'], {
+        where: '"deleted_at" IS NULL'
+    }),
+    (0, type_graphql_1.ObjectType)({
+        description: 'Participant of a ChatSession — links a User to a session with a role. Foundation for multi-user chat / per-user filtering / member display.'
+    })
+], ChatSessionParticipant);
+//# sourceMappingURL=chat-session-participant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-session-participant.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/chat-session-participant.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;GAUG;AACH,qCAUgB;AAChB,+CAAoD;AAEpD,iDAA8C;AAC9C,yDAAgD;AAEhD,qEAA6D;AActD,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;CA6FlC,CAAA;AA7FY,wDAAsB;AAGxB;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;;kDACzC;AAIpB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;sCAC3F,cAAM;sDAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;;wDACnC;AAIjB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACvD,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;sCACpG,6BAAW;uDAAA;AAGrB;IADC,IAAA,oBAAU,EAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;yDACnC;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;sCACxF,gBAAI;oDAAA;AAGX;IADC,IAAA,oBAAU,EAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;;sDACnC;AAYf;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC1D,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC;;oDAChE;AAKb;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC;sCAClF,IAAI;IAEjB;;;;;;OAMG;;0DARc;AAWjB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gNAAgN,EAAE,CAAC;sCAC5O,IAAI;IAEjB;;;;;;;;;OASG;;0DAXc;AAcjB;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6KAA6K,EAAE,CAAC;sCAC3M,IAAI;wDAAA;AAIf;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;sCAC9H,gBAAI;uDAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;yDACnC;AAIlB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kEAAkE,EAAE,CAAC;sCAC/G,gBAAI;uDAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,CAAyB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;yDACnC;AAIlB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,CAAC;sCACnD,IAAI;yDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;sCACrF,IAAI;yDAAA;AAIhB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;sCACtE,IAAI;yDAAA;iCA5FL,sBAAsB;IAZlC,IAAA,gBAAM,EAAC,2BAA2B,CAAC;IACnC,IAAA,eAAK,EAAC,+BAA+B,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;QACrE,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,sBAAsB;KAC9B,CAAC;IACD,IAAA,eAAK,EAAC,+BAA+B,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE;QAC1D,KAAK,EAAE,sBAAsB;KAC9B,CAAC;IACD,IAAA,yBAAU,EAAC;QACV,WAAW,EACT,6IAA6I;KAChJ,CAAC;GACW,sBAAsB,CA6FlC","sourcesContent":["/**\n * ChatSessionParticipant — 채팅 세션의 참여 사용자.\n *\n * 한 ChatSession 에 여러 사용자가 참여할 수 있고, 각자 role (owner / member / viewer 등)\n * 을 가짐. 다자간 채팅 / 권한 분화 / \"내 세션 목록\" / 멤버 표시 등의 기반.\n *\n * 현재 visibility 정책 (도메인 내 모두 공개) 은 그대로 유지 — 본 엔티티는 영속/추적\n * 데이터 만들고, \"참여자만 접근\" 같은 enforcement 는 정책 굳을 때 별도 phase 에서 도입.\n *\n * 자동 참여 vs 명시적 초대 정책도 미정 — 일단 세션 creator 만 자동 'owner' 로 등록.\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'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\n@Entity('chat_session_participants')\n@Index('ix_chat_session_participant_0', ['domain', 'session', 'user'], {\n  unique: true,\n  where: '\"deleted_at\" IS NULL'\n})\n@Index('ix_chat_session_participant_1', ['domain', 'user'], {\n  where: '\"deleted_at\" IS NULL'\n})\n@ObjectType({\n  description:\n    'Participant of a ChatSession — links a User to a session with a role. Foundation for multi-user chat / per-user filtering / member display.'\n})\nexport class ChatSessionParticipant {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique participant id.' })\n  readonly id?: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Domain to which this participant belongs.' })\n  domain?: Domain\n\n  @RelationId((p: ChatSessionParticipant) => p.domain)\n  domainId?: string\n\n  @ManyToOne(type => ChatSession, { onDelete: 'CASCADE' })\n  @Field(type => ChatSession, { nullable: true, description: 'The ChatSession this participation belongs to.' })\n  session?: ChatSession\n\n  @RelationId((p: ChatSessionParticipant) => p.session)\n  sessionId?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'The user participating in the session.' })\n  user?: User\n\n  @RelationId((p: ChatSessionParticipant) => p.user)\n  userId?: string\n\n  /**\n   * 참여자의 역할.\n   *   - 'owner': 세션 만든 사람. rename / delete 권한.\n   *   - 'member': 일반 참여자. 메시지 송수신.\n   *   - 'viewer': 읽기 전용 (미래 권한 정책 활성화 시).\n   *\n   * 시작은 'owner' / 'member' 둘로 충분. 더 세분화 필요해지면 enum 확장.\n   */\n  @Column({ type: 'varchar', length: 16, default: 'member' })\n  @Field({ description: 'Role of this participant: owner | member | viewer.' })\n  role!: string\n\n  /** 마지막 활동 시각 — presence indicator. nullable. */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Last seen / activity timestamp (presence indicator).' })\n  lastSeenAt?: Date\n\n  /**\n   * 이 참여자가 **읽은 지점**. 세션의 마지막 활동 시각과 비교해 안 읽음을 판정한다.\n   *\n   * `lastSeenAt`(접속 표시)과 다른 개념이다 — 창을 열어 두고 화면을 안 볼 수 있고, 접속이 끊긴 뒤에도\n   * 읽은 지점은 남는다. 두 값을 섞어 쓰면 \"봤는데 안 읽음\" 또는 그 반대가 된다.\n   * nullable — 한 번도 읽지 않은 참여자(초대 직후)는 세션의 모든 활동이 안 읽음이다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Point up to which this participant has read the session. Distinct from lastSeenAt (presence): a window can be open without being read, and the read point survives disconnection. Null means nothing read yet.' })\n  lastReadAt?: Date\n\n  /**\n   * 이 사용자가 **자기 목록에서 숨긴 시각**. 숨김은 **나에게만** 적용된다 — 남의 목록·대화 내용은 그대로다.\n   *\n   * 왜 삭제와 나누는가: 협의는 여럿의 기록이므로 지우는 것은 **만든 사람**만 할 수 있다(되돌릴 수 없다).\n   * 그 권한이 없는 사람에게도 \"내 목록을 정리할\" 방법은 있어야 하고, 그것이 숨김이다.\n   *\n   * 숨긴 **뒤에 새 활동이 생기면 다시 나타난다** — 아직 참여자인 대화에서 조용히 잘려 나가는 것이\n   * 목록이 한 줄 늘어나는 것보다 나쁘다. 완전히 빠지려면 대화에서 나가야 한다(별개 기능).\n   * nullable — 값이 없으면 숨기지 않은 상태.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'When this user hid the session from their own list. Per-user only; the session and other participants are unaffected. Activity newer than this timestamp makes it reappear.' })\n  hiddenAt?: Date\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'User who created this participant record (typically session owner who invited).' })\n  creator?: User\n\n  @RelationId((p: ChatSessionParticipant) => p.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true, description: 'Last user to update this participant record (e.g., role change).' })\n  updater?: User\n\n  @RelationId((p: ChatSessionParticipant) => p.updater)\n  updaterId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Joined-at timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (role change / lastSeenAt bump).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete (= left session) timestamp.' })\n  deletedAt?: Date\n}\n"]}

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

@@ -0,0 +1,4 @@
+import { ChatSessionParticipant } from './chat-session-participant.js';
+export { ChatSessionParticipant };
+export { isOnline, PRESENCE_TTL_MS } from './presence.js';
+export declare const entities: (typeof ChatSessionParticipant)[];

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entities = exports.PRESENCE_TTL_MS = exports.isOnline = exports.ChatSessionParticipant = void 0;
+const chat_session_participant_js_1 = require("./chat-session-participant.js");
+Object.defineProperty(exports, "ChatSessionParticipant", { enumerable: true, get: function () { return chat_session_participant_js_1.ChatSessionParticipant; } });
+var presence_js_1 = require("./presence.js");
+Object.defineProperty(exports, "isOnline", { enumerable: true, get: function () { return presence_js_1.isOnline; } });
+Object.defineProperty(exports, "PRESENCE_TTL_MS", { enumerable: true, get: function () { return presence_js_1.PRESENCE_TTL_MS; } });
+exports.entities = [chat_session_participant_js_1.ChatSessionParticipant];
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/index.ts"],"names":[],"mappings":";;;AAAA,+EAAsE;AAE7D,uGAFA,oDAAsB,OAEA;AAC/B,6CAAyD;AAAhD,uGAAA,QAAQ,OAAA;AAAE,8GAAA,eAAe,OAAA;AAErB,QAAA,QAAQ,GAAG,CAAC,oDAAsB,CAAC,CAAA","sourcesContent":["import { ChatSessionParticipant } from './chat-session-participant.js'\n\nexport { ChatSessionParticipant }\nexport { isOnline, PRESENCE_TTL_MS } from './presence.js'\n\nexport const entities = [ChatSessionParticipant]\n"]}

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

@@ -0,0 +1,27 @@
+/**
+ * 협업 초대 알림 — 순수 payload 빌더.
+ *
+ * 부수효과(실제 발송)는 resolver 의 thin caller 가 `context.state.notify` 로 수행.
+ * 여기엔 "무엇을 보낼지"(payload) 결정 로직만 둔다 — DB·pubsub·notify 의존 없이 테스트 가능.
+ * (patch spine 의 board-patch-broadcast.ts 와 동일한 순수/부수효과 분리 컨벤션.)
+ */
+/** notification-middleware 의 notifier 가 받는 인자 형태 (필요한 키만). */
+export interface InviteNotification {
+    receivers: string[];
+    type: string;
+    subject: string;
+    title: string;
+    body: string;
+    url?: string;
+    mode: 'background' | 'foreground';
+}
+/** 초대자 식별용 — User 엔티티에서 쓰는 필드만 (duck-typed). */
+export interface Inviter {
+    name?: string | null;
+    email?: string | null;
+}
+/**
+ * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.
+ * 받는 사람이 없으면 null (= 보낼 것 없음).
+ */
+export declare function buildInviteNotification(userIds: string[], boardId: string | undefined, inviter: Inviter | undefined | null): InviteNotification | null;