@things-factory/ai-assistant 10.1.6

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

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * 협업 초대 알림 — 순수 payload 빌더.
+ *
+ * 부수효과(실제 발송)는 resolver 의 thin caller 가 `context.state.notify` 로 수행.
+ * 여기엔 "무엇을 보낼지"(payload) 결정 로직만 둔다 — DB·pubsub·notify 의존 없이 테스트 가능.
+ * (patch spine 의 board-patch-broadcast.ts 와 동일한 순수/부수효과 분리 컨벤션.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInviteNotification = buildInviteNotification;
+/**
+ * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.
+ * 받는 사람이 없으면 null (= 보낼 것 없음).
+ */
+function buildInviteNotification(userIds, boardId, inviter) {
+    if (!Array.isArray(userIds) || userIds.length === 0)
+        return null;
+    const who = inviter?.name || inviter?.email || 'someone';
+    return {
+        receivers: userIds,
+        type: 'board-collab-invite',
+        subject: 'info',
+        title: 'Board collaboration invite',
+        body: `${who} invited you to collaborate on a board.`,
+        // board 가 연결돼 있으면 모델러로 바로 가는 링크. 없으면 링크 생략.
+        url: boardId ? `board-modeller/${boardId}` : undefined,
+        mode: 'background'
+    };
+}
+//# sourceMappingURL=invite-notification.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invite-notification.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/invite-notification.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAuBH,0DAkBC;AAtBD;;;GAGG;AACH,SAAgB,uBAAuB,CACrC,OAAiB,EACjB,OAA2B,EAC3B,OAAmC;IAEnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAEhE,MAAM,GAAG,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,KAAK,IAAI,SAAS,CAAA;IACxD,OAAO;QACL,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,4BAA4B;QACnC,IAAI,EAAE,GAAG,GAAG,yCAAyC;QACrD,4CAA4C;QAC5C,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS;QACtD,IAAI,EAAE,YAAY;KACnB,CAAA;AACH,CAAC","sourcesContent":["/**\n * 협업 초대 알림 — 순수 payload 빌더.\n *\n * 부수효과(실제 발송)는 resolver 의 thin caller 가 `context.state.notify` 로 수행.\n * 여기엔 \"무엇을 보낼지\"(payload) 결정 로직만 둔다 — DB·pubsub·notify 의존 없이 테스트 가능.\n * (patch spine 의 board-patch-broadcast.ts 와 동일한 순수/부수효과 분리 컨벤션.)\n */\n\n/** notification-middleware 의 notifier 가 받는 인자 형태 (필요한 키만). */\nexport interface InviteNotification {\n  receivers: string[]\n  type: string\n  subject: string\n  title: string\n  body: string\n  url?: string\n  mode: 'background' | 'foreground'\n}\n\n/** 초대자 식별용 — User 엔티티에서 쓰는 필드만 (duck-typed). */\nexport interface Inviter {\n  name?: string | null\n  email?: string | null\n}\n\n/**\n * 초대된 사용자들에게 보낼 협업 초대 알림 payload 를 만든다.\n * 받는 사람이 없으면 null (= 보낼 것 없음).\n */\nexport function buildInviteNotification(\n  userIds: string[],\n  boardId: string | undefined,\n  inviter: Inviter | undefined | null\n): InviteNotification | null {\n  if (!Array.isArray(userIds) || userIds.length === 0) return null\n\n  const who = inviter?.name || inviter?.email || 'someone'\n  return {\n    receivers: userIds,\n    type: 'board-collab-invite',\n    subject: 'info',\n    title: 'Board collaboration invite',\n    body: `${who} invited you to collaborate on a board.`,\n    // board 가 연결돼 있으면 모델러로 바로 가는 링크. 없으면 링크 생략.\n    url: boardId ? `board-modeller/${boardId}` : undefined,\n    mode: 'background'\n  }\n}\n"]}

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

@@ -0,0 +1,4 @@
+/** online 으로 간주할 기본 유예(ms) — heartbeat 주기의 ~2.5배 권장(주기 30s → 75s). */
+export declare const PRESENCE_TTL_MS = 75000;
+/** lastSeenAt 이 now 기준 ttl 이내면 online. lastSeenAt 없으면 offline. */
+export declare function isOnline(lastSeenAt: Date | string | null | undefined, now: number, ttlMs?: number): boolean;

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

@@ -0,0 +1,22 @@
+"use strict";
+/*
+ * presence — lastSeenAt 기반 online 판정 (Phase Board-AI C4). 순수·결정적 → 테스트 가능.
+ * 클라이언트가 주기적 heartbeat(touchPresence)로 lastSeenAt 을 갱신하고, roster 는
+ * 이 판정으로 online/offline 표시. 시각(now)을 주입받아 시간 의존성을 제거.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PRESENCE_TTL_MS = void 0;
+exports.isOnline = isOnline;
+/** online 으로 간주할 기본 유예(ms) — heartbeat 주기의 ~2.5배 권장(주기 30s → 75s). */
+exports.PRESENCE_TTL_MS = 75_000;
+/** lastSeenAt 이 now 기준 ttl 이내면 online. lastSeenAt 없으면 offline. */
+function isOnline(lastSeenAt, now, ttlMs = exports.PRESENCE_TTL_MS) {
+    if (!lastSeenAt)
+        return false;
+    const t = lastSeenAt instanceof Date ? lastSeenAt.getTime() : new Date(lastSeenAt).getTime();
+    if (!Number.isFinite(t))
+        return false;
+    const age = now - t;
+    return age >= 0 ? age <= ttlMs : true; // 미래 시각(클럭 스큐)은 online 으로 관대 처리
+}
+//# sourceMappingURL=presence.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../../server/service/chat-session-participant/presence.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMH,4BAUC;AAdD,sEAAsE;AACzD,QAAA,eAAe,GAAG,MAAM,CAAA;AAErC,kEAAkE;AAClE,SAAgB,QAAQ,CACtB,UAA4C,EAC5C,GAAW,EACX,QAAgB,uBAAe;IAE/B,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAA;IAC7B,MAAM,CAAC,GAAG,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5F,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAA;IACnB,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAA,CAAC,gCAAgC;AACxE,CAAC","sourcesContent":["/*\n * presence — lastSeenAt 기반 online 판정 (Phase Board-AI C4). 순수·결정적 → 테스트 가능.\n * 클라이언트가 주기적 heartbeat(touchPresence)로 lastSeenAt 을 갱신하고, roster 는\n * 이 판정으로 online/offline 표시. 시각(now)을 주입받아 시간 의존성을 제거.\n */\n\n/** online 으로 간주할 기본 유예(ms) — heartbeat 주기의 ~2.5배 권장(주기 30s → 75s). */\nexport const PRESENCE_TTL_MS = 75_000\n\n/** lastSeenAt 이 now 기준 ttl 이내면 online. lastSeenAt 없으면 offline. */\nexport function isOnline(\n  lastSeenAt: Date | string | null | undefined,\n  now: number,\n  ttlMs: number = PRESENCE_TTL_MS\n): boolean {\n  if (!lastSeenAt) return false\n  const t = lastSeenAt instanceof Date ? lastSeenAt.getTime() : new Date(lastSeenAt).getTime()\n  if (!Number.isFinite(t)) return false\n  const age = now - t\n  return age >= 0 ? age <= ttlMs : true // 미래 시각(클럭 스큐)은 online 으로 관대 처리\n}\n"]}

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

@@ -0,0 +1,93 @@
+import { User } from '@things-factory/auth-base';
+import { ChatSession } from './chat-session/chat-session.js';
+import { ChatMessage } from './chat-message/chat-message.js';
+import { ChatSessionParticipant } from './chat-session-participant/chat-session-participant.js';
+declare class ChatSessionInboxEntry {
+    id?: string;
+    name?: string;
+    anchorType?: string;
+    anchorId?: string;
+    boardId?: string;
+    lastMessageAt?: Date;
+    lastMessagePreview?: string;
+    createdAt?: Date;
+    unread: boolean;
+    participant: boolean;
+    mine: boolean;
+    hidden?: boolean;
+}
+export declare class ChatSessionResolver {
+    chatSession(id: string, context: ResolverContext): Promise<ChatSession | null>;
+    chatSessionsByAnchor(anchorType: string, anchorId: string, context: ResolverContext): Promise<ChatSession[]>;
+    /**
+     * 받은편지함 — 앵커의 세션 목록 + 내 안 읽음 상태. 최근 활동순.
+     * 집계 쿼리를 쓰지 않는다: 세션의 비정규화된 lastMessageAt 과 내 참여자 lastReadAt 을 **값 비교**한다
+     * (5개 DB 드라이버 지원 때문에 group by/MAX 를 목록 경로에 두지 않는다).
+     */
+    chatSessionInbox(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean, limit?: number, offset?: number): Promise<ChatSessionInboxEntry[]>;
+    /**
+     * 필터를 통과한 **전체 개수** — "더 보기" 가 남았는지, 검색 결과가 몇 건인지.
+     *
+     * 목록과 같은 요청에 담아 가져가므로 왕복은 늘지 않는다. 개수를 모르면 사용자는 목록의 끝이
+     * 페이지의 끝인지 자료의 끝인지 구별할 수 없다.
+     */
+    chatSessionInboxTotal(anchorType: string, anchorId: string, context: ResolverContext, showHidden?: boolean, search?: string, mineOnly?: boolean): Promise<number>;
+    /** 필터 적용(페이지 전) — 목록·개수가 **같은 규칙**을 쓰도록 한 곳에 둔다(어긋나면 "더 보기" 가 거짓말이 된다). */
+    private _inboxFiltered;
+    /**
+     * 내가 숨긴 대화 수 — 필터에 "몇 개가 접혀 있는지" 를 보여주기 위한 값.
+     *
+     * 숨긴 것이 몇 개인지 모르면 필터를 눌러 볼 이유가 생기지 않는다(숨긴 사실 자체를 잊는다).
+     * 목록 조회와 **같은 요청**에 담아 가져갈 수 있으므로 왕복은 늘지 않는다.
+     */
+    hiddenSessionCount(anchorType: string, anchorId: string, context: ResolverContext): Promise<number>;
+    /** 목록 조립 — 숨김 표시까지 붙인 **전체**. 목록·개수 두 진입점이 같은 규칙을 쓰도록 한 곳에 둔다. */
+    private _inboxEntries;
+    /**
+     * 세션 삭제 — **만든 사람만.**
+     *
+     * 협의는 여럿의 기록이고 삭제는 화면에서 되돌릴 수 없다. 그래서 권한을 좁힌다(이름 변경은 되돌릴 수
+     * 있어서 누구나 할 수 있는 것과 대비). 권한이 없는 사람에게는 `hideAISession`(내 목록에서만 숨김)이
+     * 있다 — 남의 기록을 지우지 않고 자기 목록을 정리하는 길.
+     *
+     * 소프트 삭제(deletedAt)다 — 메시지·패치는 세션을 통해서만 도달하므로 함께 사라지고, 잘못 지운 경우
+     * 데이터로는 남아 있다. 다른 참여자 목록에서도 사라져야 하므로 meta 활동으로 방송한다.
+     */
+    deleteAISession(sessionId: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * 내 목록에서 숨기기·되돌리기 — **나에게만** 적용된다(대화·다른 참여자 목록은 그대로).
+     *
+     * 참여자가 아니어도 숨길 수 있어야 한다 — 목록에는 같은 공간의 남의 협의도 보이고, 그것을 정리하는
+     * 것은 남에게 아무 영향이 없다. 그 경우 'viewer' 역할로 기록만 남긴다(참여자 명부·배지에는 들지 않는다).
+     */
+    hideAISession(sessionId: string, context: ResolverContext, hidden?: boolean): Promise<boolean>;
+    /**
+     * 세션 이름 변경 — **참여자 누구나** 할 수 있다.
+     *
+     * 왜 소유자 전용이 아닌가: 이름은 대화의 주제표이고 협의는 여럿이 한다. 논의가 흘러 주제가 달라졌는데
+     * 만든 사람만 고칠 수 있으면 그 사람이 없을 때 목록이 계속 어긋난다. 되돌릴 수 있는 변경이고 대화
+     * 내용에 영향이 없으므로 권한을 좁힐 이유가 없다(되돌릴 수 없는 것만 좁힌다).
+     *
+     * 변경은 **meta 활동**으로 방송한다 — 모든 참여자 목록에 즉시 반영되지만 안 읽음 배지는 올리지 않는다
+     * (이름 변경을 "새 소식" 으로 알리면 소음이다).
+     */
+    renameAISession(sessionId: string, name: string, context: ResolverContext): Promise<boolean>;
+    /**
+     * 읽은 지점 갱신 — 이 세션을 여기까지 읽었다. 멱등(여러 번 호출해도 최신 시각으로만 이동).
+     * 접속 표시(lastSeenAt)와 분리한다 — 창을 열어 두고 화면을 안 볼 수 있다.
+     */
+    markSessionRead(sessionId: string, context: ResolverContext): Promise<boolean>;
+    domainUsersForMention(query: string | undefined, limit: number, context: ResolverContext): Promise<User[]>;
+    chatSessionParticipants(sessionId: string, context: ResolverContext): Promise<ChatSessionParticipant[]>;
+    touchPresence(sessionId: string, context: ResolverContext): Promise<boolean>;
+    chatMessages(sessionId: string, limit: number, offset: number, context: ResolverContext): Promise<ChatMessage[]>;
+    startAISession(anchorType: string, anchorId: string, context: ResolverContext): Promise<ChatSession>;
+    createAISession(anchorType: string, anchorId: string, name: string | undefined, context: ResolverContext): Promise<ChatSession>;
+    renameChatSession(sessionId: string, name: string, context: ResolverContext): Promise<boolean>;
+    appendSessionNote(sessionId: string, content: string, context: ResolverContext): Promise<boolean>;
+    appendSessionTurns(sessionId: string, turns: {
+        role?: string;
+        content?: string;
+    }[], context: ResolverContext): Promise<boolean>;
+}
+export {};