@crmforall/connector 0.1.8 → 0.1.10

package/dist/contracts.d.ts

@@ -18,6 +18,7 @@ export declare const MCP_TOOL: {
     readonly TRACK_ENGAGEMENT: "track_engagement";
     readonly ONBOARDING_STATUS: "onboarding_status";
     readonly SYNC_ALL: "sync_all";
+    readonly AUDIENCE_SUMMARY: "audience_summary";
 };
 export type McpToolName = (typeof MCP_TOOL)[keyof typeof MCP_TOOL];
 export declare const APPROVAL_SCOPE: {

package/dist/contracts.js

@@ -21,6 +21,7 @@ exports.MCP_TOOL = {
     TRACK_ENGAGEMENT: "track_engagement",
     ONBOARDING_STATUS: "onboarding_status",
     SYNC_ALL: "sync_all",
+    AUDIENCE_SUMMARY: "audience_summary",
 };
 exports.APPROVAL_SCOPE = {
     TARGET_SNAPSHOT_CREATE: "target_snapshot:create",
@@ -45,6 +46,7 @@ exports.TOOL_APPROVAL_REQUIREMENT = {
     [exports.MCP_TOOL.TRACK_ENGAGEMENT]: null,
     [exports.MCP_TOOL.ONBOARDING_STATUS]: null,
     [exports.MCP_TOOL.SYNC_ALL]: null,
+    [exports.MCP_TOOL.AUDIENCE_SUMMARY]: null,
 };
 /** 승인 토큰이 필요한 도구 — 토큰 없이 호출되면 즉시 거부한다. */
 exports.APPROVAL_REQUIRED_TOOLS = new Set(Object.entries(exports.TOOL_APPROVAL_REQUIREMENT)

package/dist/server.js

@@ -15,8 +15,23 @@ const tools_1 = require("./tools");
 async function main() {
     const config = (0, config_1.loadConfig)();
     if (!config) {
-        console.error("[crmforall-connector] 설정이 없습니다. 먼저 `npx @crmforall/connect init`을 실행하세요.");
-        process.exit(1);
+        // 설정 전(플러그인 설치 직후 등) — 죽지 않고 '설치 안내 모드'로 떠서 다음 단계를 알려준다.
+        const setup = new mcp_js_1.McpServer({ name: "crmforall-connector", version: "0.1.9" }, { instructions: "아직 DB 설정이 없습니다. 터미널에서 `npx @crmforall/connect init`을 먼저 실행해 연결하세요." });
+        setup.tool("onboarding_status", "온보딩 상태 — 아직 설정(연결) 전입니다.", {}, async () => ({
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ready: false,
+                        nextStep: "터미널에서 `npx @crmforall/connect init --token=<설치토큰> --platform-url=https://crmforall-console.vercel.app` 을 실행해 DB를 연결한 뒤, 이 세션을 재시작하세요.",
+                        docs: "https://crmforall-console.vercel.app/docs/dev/connector",
+                    }),
+                },
+            ],
+        }));
+        await setup.connect(new stdio_js_1.StdioServerTransport());
+        console.error("[crmforall-connector] 설정 없음 — 설치 안내 모드로 시작 (connect init 필요)");
+        return;
     }
     let db = null;
     const getDb = async () => {
@@ -29,7 +44,7 @@ async function main() {
     };
     const server = new mcp_js_1.McpServer({
         name: "crmforall-connector",
-        version: "0.1.0",
+        version: "0.1.9",
     }, {
         instructions: [
             "크렘포올 DB 커넥터입니다. 고객사 DB를 진단·연결·매핑해 크렘포올 플랫폼과 잇습니다.",

package/dist/targets.d.ts

@@ -21,6 +21,20 @@ export interface TargetComputation {
     }>;
     previewHash: string;
 }
+export interface AudienceSummary {
+    totalCustomers: number;
+    withPhone: number | null;
+    optInTrue: number | null;
+    optInFalse: number | null;
+    optInUnknown: number | null;
+    /** 발송 가능 후보(전화 보유 + 동의 거부 아님) — 첫 체감용 대략치 */
+    reachable: number | null;
+}
+/**
+ * 청중 요약 — 매핑만으로 즉시 가능한 "고객 N명 · 발송 동의 분포" (프로젝트 불필요).
+ * 온보딩 직후 첫 체감("보낼 수 있는 고객 N명")을 주기 위한 읽기 전용 집계.
+ */
+export declare function audienceSummary(db: SqlExecutor, mapping: MappingConfig): Promise<AudienceSummary>;
 /**
  * 스냅샷/미리보기 해시 — 같은 대상 집합이면 항상 같은 값.
  * 승인 토큰의 snapshotHash 바인딩과 비교되므로 결정적이어야 한다.

package/dist/targets.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.audienceSummary = audienceSummary;
 exports.computePreviewHash = computePreviewHash;
 exports.computeTargets = computeTargets;
 const node_crypto_1 = require("node:crypto");
@@ -13,6 +14,38 @@ function ident(name) {
 function tableRef(t) {
     return `${ident(t.schema)}.${ident(t.table)}`;
 }
+/**
+ * 청중 요약 — 매핑만으로 즉시 가능한 "고객 N명 · 발송 동의 분포" (프로젝트 불필요).
+ * 온보딩 직후 첫 체감("보낼 수 있는 고객 N명")을 주기 위한 읽기 전용 집계.
+ */
+async function audienceSummary(db, mapping) {
+    const c = mapping.customer;
+    const hasPhone = Boolean(c.fields.phoneNumberHash);
+    const hasOptIn = Boolean(c.fields.marketingOptIn);
+    const selects = ["COUNT(*)::int AS total"];
+    if (hasPhone)
+        selects.push(`COUNT(${ident(c.fields.phoneNumberHash)})::int AS with_phone`);
+    if (hasOptIn) {
+        const o = ident(c.fields.marketingOptIn);
+        selects.push(`COUNT(*) FILTER (WHERE ${o} IS TRUE)::int AS optin_true`);
+        selects.push(`COUNT(*) FILTER (WHERE ${o} IS FALSE)::int AS optin_false`);
+        selects.push(`COUNT(*) FILTER (WHERE ${o} IS NULL)::int AS optin_null`);
+        if (hasPhone) {
+            selects.push(`COUNT(*) FILTER (WHERE ${o} IS DISTINCT FROM FALSE AND ${ident(c.fields.phoneNumberHash)} IS NOT NULL)::int AS reachable`);
+        }
+    }
+    const rows = (await db.selectRows(`SELECT ${selects.join(", ")} FROM ${tableRef(c.table)}`));
+    const row = rows[0] ?? {};
+    const num = (k) => (typeof row[k] === "number" ? row[k] : null);
+    return {
+        totalCustomers: num("total") ?? 0,
+        withPhone: hasPhone ? num("with_phone") : null,
+        optInTrue: hasOptIn ? num("optin_true") : null,
+        optInFalse: hasOptIn ? num("optin_false") : null,
+        optInUnknown: hasOptIn ? num("optin_null") : null,
+        reachable: hasOptIn && hasPhone ? num("reachable") : null,
+    };
+}
 /**
  * 스냅샷/미리보기 해시 — 같은 대상 집합이면 항상 같은 값.
  * 승인 토큰의 snapshotHash 바인딩과 비교되므로 결정적이어야 한다.

package/dist/tools.js

@@ -357,6 +357,22 @@ function registerTools(server, rt) {
             return unexpected(err);
         }
     });
+    server.tool(contracts_1.MCP_TOOL.AUDIENCE_SUMMARY, "확정된 매핑으로 고객 수·발송 동의 분포·발송 가능 후보 수를 즉시 집계한다 (프로젝트 불필요, 읽기 전용, 승인 불필요). 온보딩 직후 첫 체감용.", {}, async () => {
+        try {
+            if (!rt.config.mapping) {
+                return ok({
+                    ready: false,
+                    message: "먼저 propose_field_mapping → validate_mapping(persist=true)으로 매핑을 확정하세요.",
+                });
+            }
+            const db = await rt.getDb();
+            const summary = await (0, targets_1.audienceSummary)(db, rt.config.mapping);
+            return ok(summary);
+        }
+        catch (err) {
+            return unexpected(err);
+        }
+    });
     server.tool(contracts_1.MCP_TOOL.SYNC_SEND_RESULT, "발송 작업 결과를 플랫폼에서 가져와 CRM 스키마에 동기화한다 (승인 불필요)", { sendJobId: zod_1.z.string() }, async ({ sendJobId }) => {
         try {
             const db = await rt.getDb();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crmforall/connector",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "crmforall MCP 커넥터 — 운영 DB 읽기, CRM 스키마 쓰기(승인 토큰 필수), 대상 산출",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",