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

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

@@ -0,0 +1,39 @@
+import '@things-factory/auth-base';
+import { Board } from '@things-factory/board-service';
+import { ImportSession } from './import-session';
+import { type SuggestBoardMetaResult } from './suggest-board-name';
+declare class MaterializeImportSessionInput {
+    sessionId: string;
+    name: string;
+    description?: string;
+    groupId?: string;
+    type?: 'main' | 'sub' | 'popup';
+    thumbnail?: string;
+    variantId?: string;
+}
+declare class SuggestBoardNameInput {
+    sessionId?: string;
+    hint?: string;
+}
+declare class ImportBoardAsyncInput {
+    attachmentId: string;
+    chatSessionId?: string;
+    scopes?: string[];
+    normalizeOrigin?: boolean;
+    flipY?: boolean;
+    scale?: number;
+    applyBinding?: boolean;
+    parseOptions?: any;
+    userPrompt?: string;
+}
+export declare class ImportSessionResolver {
+    importSession(id: string, context: ResolverContext): Promise<ImportSession | null>;
+    importSessionsByChatSession(chatSessionId: string, context: ResolverContext): Promise<ImportSession[]>;
+    importBoardAsync(input: ImportBoardAsyncInput, context: ResolverContext): Promise<ImportSession>;
+    suggestBoardName(input: SuggestBoardNameInput, context: ResolverContext): Promise<string>;
+    suggestBoardMeta(input: SuggestBoardNameInput, context: ResolverContext): Promise<SuggestBoardMetaResult>;
+    /** 두 query 가 공유하는 deps wiring — typeorm find idiomatic 패턴 (distinctAlias 회귀 회피). */
+    private _buildSuggestDeps;
+    materializeImportSession(input: MaterializeImportSessionInput, context: ResolverContext): Promise<Board>;
+}
+export {};

package/dist-server/service/import-session/import-session-resolver.js

@@ -0,0 +1,263 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportSessionResolver = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ImportSession resolver + 비동기 worker.
+ *
+ * Mutation:
+ *   - importBoardAsync(attachmentId, options): ImportSession (즉시 반환, 백그라운드에서 처리)
+ *
+ * Query:
+ *   - importSession(id): ImportSession (진행 상황 polling)
+ *
+ * 비동기 worker 는 단일 프로세스 내 setImmediate 기반. 추후 큐(Redis/BullMQ) 로 이전 가능.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const typeorm_1 = require("typeorm");
+require("@things-factory/auth-base");
+const shell_1 = require("@things-factory/shell");
+const board_service_1 = require("@things-factory/board-service");
+const attachment_base_1 = require("@things-factory/attachment-base");
+const import_session_1 = require("./import-session");
+const materialize_from_session_1 = require("./materialize-from-session");
+const suggest_board_name_1 = require("./suggest-board-name");
+const import_actions_1 = require("./import-actions");
+let MaterializeImportSessionInput = class MaterializeImportSessionInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.ID, { description: 'ImportSession id (must be in completed state).' }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'New Board name.' }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Optional Board description.' }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.ID, { nullable: true, description: 'Optional Group id to attach the Board to.' }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "groupId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: "Board type — 'main' | 'sub' | 'popup'. Default 'main'." }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Base64 thumbnail. If omitted, board-service default empty thumbnail is used.' }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "thumbnail", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: "ImportSession 의 결과 시안 중 하나의 id. 'as-is' / 'scene' / 'auto-fit'. " +
+            '미지정 시 default variant (보통 \'scene\') 사용.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], MaterializeImportSessionInput.prototype, "variantId", void 0);
+MaterializeImportSessionInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], MaterializeImportSessionInput);
+let BoardMetaSuggestion = class BoardMetaSuggestion {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Suggested short board name (collision-free with current domain).' }),
+    tslib_1.__metadata("design:type", String)
+], BoardMetaSuggestion.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        description: 'Suggested detailed description — combines user prompt, AI importStrategy narrative, and category distribution stats.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], BoardMetaSuggestion.prototype, "description", void 0);
+BoardMetaSuggestion = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)()
+], BoardMetaSuggestion);
+let SuggestBoardNameInput = class SuggestBoardNameInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.ID, {
+        nullable: true,
+        description: 'ImportSession id — 있으면 거기서 userPrompt / VLM reasoning / attachment.name 추출.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], SuggestBoardNameInput.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: '명시 hint. session 정보보다 우선. 사용자가 직접 적은 메모를 기반으로 추천받고 싶을 때.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], SuggestBoardNameInput.prototype, "hint", void 0);
+SuggestBoardNameInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], SuggestBoardNameInput);
+let ImportBoardAsyncInput = class ImportBoardAsyncInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Attachment id of the source drawing file (uploaded via attachment-base).' }),
+    tslib_1.__metadata("design:type", String)
+], ImportBoardAsyncInput.prototype, "attachmentId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'ChatSession id when triggered from board-ai chat.' }),
+    tslib_1.__metadata("design:type", String)
+], ImportBoardAsyncInput.prototype, "chatSessionId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String], { nullable: true, description: 'Registry scopes to use (board-import).' }),
+    tslib_1.__metadata("design:type", Array)
+], ImportBoardAsyncInput.prototype, "scopes", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Normalize coordinates so minX,minY=0' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ImportBoardAsyncInput.prototype, "normalizeOrigin", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Flip Y axis (CAD Y-up → scene Y-down).' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ImportBoardAsyncInput.prototype, "flipY", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Scale factor (e.g. 1 for mm:1unit).' }),
+    tslib_1.__metadata("design:type", Number)
+], ImportBoardAsyncInput.prototype, "scale", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Apply Stage 4 (data binding).' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ImportBoardAsyncInput.prototype, "applyBinding", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Adapter parse options (excludeLayers, maxEntities, ...).' }),
+    tslib_1.__metadata("design:type", Object)
+], ImportBoardAsyncInput.prototype, "parseOptions", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'User-provided context / hints about the drawing — passed to VLM as additional guidance. ' +
+            'e.g. "fab lithography zone, central rectangles are stockers, thin lines are OHT rails."'
+    }),
+    tslib_1.__metadata("design:type", String)
+], ImportBoardAsyncInput.prototype, "userPrompt", void 0);
+ImportBoardAsyncInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)()
+], ImportBoardAsyncInput);
+let ImportSessionResolver = class ImportSessionResolver {
+    async importSession(id, context) {
+        const { domain } = context.state;
+        return await (0, import_actions_1.fetchImportSession)(id, { domain, user: context.state.user }, (0, shell_1.getRepository)(import_session_1.ImportSession));
+    }
+    async importSessionsByChatSession(chatSessionId, context) {
+        const { domain, user } = context.state;
+        return await (0, import_actions_1.listImportSessionsByChatSession)(chatSessionId, { domain, user }, (0, shell_1.getRepository)(import_session_1.ImportSession));
+    }
+    async importBoardAsync(input, context) {
+        const { domain, user } = context.state;
+        return await (0, import_actions_1.startImportJobAsync)(input, { domain, user }, (0, shell_1.getRepository)(import_session_1.ImportSession));
+    }
+    async suggestBoardName(input, context) {
+        const { domain } = context.state;
+        const deps = this._buildSuggestDeps();
+        return await (0, suggest_board_name_1.suggestBoardName)(input, { domain }, deps);
+    }
+    async suggestBoardMeta(input, context) {
+        const { domain } = context.state;
+        const deps = this._buildSuggestDeps();
+        return await (0, suggest_board_name_1.suggestBoardMeta)(input, { domain }, deps);
+    }
+    /** 두 query 가 공유하는 deps wiring — typeorm find idiomatic 패턴 (distinctAlias 회귀 회피). */
+    _buildSuggestDeps() {
+        const sessionRepo = (0, shell_1.getRepository)(import_session_1.ImportSession);
+        const attachmentRepo = (0, shell_1.getRepository)(attachment_base_1.Attachment);
+        const boardRepo = {
+            findExistingNames: async ({ domainId, basePrefix }) => {
+                // 도메인 격리 + 'basePrefix' 로 시작하는 name 후보 한 번에 조회.
+                // 단순 find({ where, select }) — take 없음 → DISTINCT 서브쿼리 미발생.
+                const escaped = basePrefix.replace(/[%_\\]/g, ch => '\\' + ch);
+                const items = await (0, shell_1.getRepository)(board_service_1.Board).find({
+                    select: ['name'],
+                    where: { domain: { id: domainId }, name: (0, typeorm_1.Like)(`${escaped}%`) }
+                });
+                return items.map(b => b.name);
+            }
+        };
+        return { sessionRepo, attachmentRepo, boardRepo };
+    }
+    async materializeImportSession(input, context) {
+        const { domain, user } = context.state;
+        const sessionRepo = (0, shell_1.getRepository)(import_session_1.ImportSession);
+        const boardRepo = (0, shell_1.getRepository)(board_service_1.Board);
+        const groupRepo = (0, shell_1.getRepository)(board_service_1.Group);
+        const session = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } });
+        return (await (0, materialize_from_session_1.materializeFromSession)(session, input, { domain, user }, { boardRepo: boardRepo, groupRepo: groupRepo }));
+    }
+};
+exports.ImportSessionResolver = ImportSessionResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => import_session_1.ImportSession, { nullable: true, description: 'Get import session progress.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('id')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "importSession", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => [import_session_1.ImportSession], { description: 'List recent import sessions for a chat session.' }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('chatSessionId')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "importSessionsByChatSession", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Mutation)(() => import_session_1.ImportSession, {
+        description: '도면 → 보드 변환을 비동기로 시작. 즉시 ImportSession 반환, 백그라운드에서 처리.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('input')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [ImportBoardAsyncInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "importBoardAsync", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => String, {
+        description: '@deprecated suggestBoardMeta 사용 권장. 단순 string name 만 반환하는 구버전 query.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('input')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [SuggestBoardNameInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "suggestBoardName", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => BoardMetaSuggestion, {
+        description: '도메인 안에서 충돌하지 않는 Board name + 상세 description 제안. ' +
+            'name 은 짧고 심플 (30자 이내, 충돌 회피 (n) suffix), description 은 자세히 ' +
+            '(사용자 prompt + AI importStrategy + 카테고리 분포 통계 합성).'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('input')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [SuggestBoardNameInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "suggestBoardMeta", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Mutation)(() => board_service_1.Board, {
+        description: '완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화한다. ' +
+            '검수 단계 (사용자/AI 가 import 결과를 확인 후 명시적으로 호출) 에서 사용. ' +
+            'Board.state="draft" 로 생성되므로 release mutation 으로 별도 발행 필요.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "board-import", privilege: "mutation")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('input')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [MaterializeImportSessionInput, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], ImportSessionResolver.prototype, "materializeImportSession", null);
+exports.ImportSessionResolver = ImportSessionResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], ImportSessionResolver);
+//# sourceMappingURL=import-session-resolver.js.map

package/dist-server/service/import-session/import-session-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-session-resolver.js","sourceRoot":"","sources":["../../../server/service/import-session/import-session-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ImportSession resolver + 비동기 worker.\n *\n * Mutation:\n *   - importBoardAsync(attachmentId, options): ImportSession (즉시 반환, 백그라운드에서 처리)\n *\n * Query:\n *   - importSession(id): ImportSession (진행 상황 polling)\n *\n * 비동기 worker 는 단일 프로세스 내 setImmediate 기반. 추후 큐(Redis/BullMQ) 로 이전 가능.\n */\nimport {\n  Resolver,\n  Query,\n  Mutation,\n  Arg,\n  Ctx,\n  Directive,\n  Field,\n  ID,\n  InputType,\n  ObjectType\n} from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport { Like } from 'typeorm'\nimport '@things-factory/auth-base'\n\nimport { getRepository } from '@things-factory/shell'\nimport { Board, Group } from '@things-factory/board-service'\nimport { Attachment } from '@things-factory/attachment-base'\n\nimport { ImportSession } from './import-session'\nimport { materializeFromSession } from './materialize-from-session'\nimport {\n  suggestBoardName,\n  suggestBoardMeta,\n  type SuggestBoardMetaResult,\n  type SuggestBoardRepoLike\n} from './suggest-board-name'\nimport {\n  startImportJobAsync,\n  fetchImportSession,\n  listImportSessionsByChatSession\n} from './import-actions'\n\n@InputType()\nclass MaterializeImportSessionInput {\n  @Field(() => ID, { description: 'ImportSession id (must be in completed state).' })\n  sessionId!: string\n\n  @Field({ description: 'New Board name.' })\n  name!: string\n\n  @Field({ nullable: true, description: 'Optional Board description.' })\n  description?: string\n\n  @Field(() => ID, { nullable: true, description: 'Optional Group id to attach the Board to.' })\n  groupId?: string\n\n  @Field({ nullable: true, description: \"Board type — 'main' | 'sub' | 'popup'. Default 'main'.\" })\n  type?: 'main' | 'sub' | 'popup'\n\n  @Field({ nullable: true, description: 'Base64 thumbnail. If omitted, board-service default empty thumbnail is used.' })\n  thumbnail?: string\n\n  @Field({\n    nullable: true,\n    description:\n      \"ImportSession 의 결과 시안 중 하나의 id. 'as-is' / 'scene' / 'auto-fit'. \" +\n      '미지정 시 default variant (보통 \\'scene\\') 사용.'\n  })\n  variantId?: string\n}\n\n@ObjectType()\nclass BoardMetaSuggestion {\n  @Field({ description: 'Suggested short board name (collision-free with current domain).' })\n  name!: string\n\n  @Field({\n    description:\n      'Suggested detailed description — combines user prompt, AI importStrategy narrative, and category distribution stats.'\n  })\n  description!: string\n}\n\n@InputType()\nclass SuggestBoardNameInput {\n  @Field(() => ID, {\n    nullable: true,\n    description: 'ImportSession id — 있으면 거기서 userPrompt / VLM reasoning / attachment.name 추출.'\n  })\n  sessionId?: string\n\n  @Field({\n    nullable: true,\n    description: '명시 hint. session 정보보다 우선. 사용자가 직접 적은 메모를 기반으로 추천받고 싶을 때.'\n  })\n  hint?: string\n}\n\n@InputType()\nclass ImportBoardAsyncInput {\n  @Field({ description: 'Attachment id of the source drawing file (uploaded via attachment-base).' })\n  attachmentId!: string\n\n  @Field({ nullable: true, description: 'ChatSession id when triggered from board-ai chat.' })\n  chatSessionId?: string\n\n  @Field(() => [String], { nullable: true, description: 'Registry scopes to use (board-import).' })\n  scopes?: string[]\n\n  @Field({ nullable: true, description: 'Normalize coordinates so minX,minY=0' })\n  normalizeOrigin?: boolean\n\n  @Field({ nullable: true, description: 'Flip Y axis (CAD Y-up → scene Y-down).' })\n  flipY?: boolean\n\n  @Field({ nullable: true, description: 'Scale factor (e.g. 1 for mm:1unit).' })\n  scale?: number\n\n  @Field({ nullable: true, description: 'Apply Stage 4 (data binding).' })\n  applyBinding?: boolean\n\n  @Field(() => GraphQLJSON, { nullable: true, description: 'Adapter parse options (excludeLayers, maxEntities, ...).' })\n  parseOptions?: any\n\n  @Field({\n    nullable: true,\n    description:\n      'User-provided context / hints about the drawing — passed to VLM as additional guidance. ' +\n      'e.g. \"fab lithography zone, central rectangles are stockers, thin lines are OHT rails.\"'\n  })\n  userPrompt?: string\n}\n\n@Resolver()\nexport class ImportSessionResolver {\n  @Query(() => ImportSession, { nullable: true, description: 'Get import session progress.' })\n  @Directive('@privilege(category: \"board-import\", privilege: \"query\")')\n  async importSession(\n    @Arg('id') id: string,\n    @Ctx() context: ResolverContext\n  ): Promise<ImportSession | null> {\n    const { domain } = context.state\n    return await fetchImportSession(id, { domain, user: context.state.user }, getRepository(ImportSession) as any)\n  }\n\n  @Query(() => [ImportSession], { description: 'List recent import sessions for a chat session.' })\n  @Directive('@privilege(category: \"board-import\", privilege: \"query\")')\n  async importSessionsByChatSession(\n    @Arg('chatSessionId') chatSessionId: string,\n    @Ctx() context: ResolverContext\n  ): Promise<ImportSession[]> {\n    const { domain, user } = context.state\n    return await listImportSessionsByChatSession(chatSessionId, { domain, user }, getRepository(ImportSession) as any)\n  }\n\n  @Mutation(() => ImportSession, {\n    description: '도면 → 보드 변환을 비동기로 시작. 즉시 ImportSession 반환, 백그라운드에서 처리.'\n  })\n  @Directive('@privilege(category: \"board-import\", privilege: \"mutation\")')\n  async importBoardAsync(\n    @Arg('input') input: ImportBoardAsyncInput,\n    @Ctx() context: ResolverContext\n  ): Promise<ImportSession> {\n    const { domain, user } = context.state\n    return await startImportJobAsync(input, { domain, user }, getRepository(ImportSession) as any)\n  }\n\n  @Query(() => String, {\n    description:\n      '@deprecated suggestBoardMeta 사용 권장. 단순 string name 만 반환하는 구버전 query.'\n  })\n  @Directive('@privilege(category: \"board-import\", privilege: \"query\")')\n  async suggestBoardName(\n    @Arg('input') input: SuggestBoardNameInput,\n    @Ctx() context: ResolverContext\n  ): Promise<string> {\n    const { domain } = context.state\n    const deps = this._buildSuggestDeps()\n    return await suggestBoardName(input, { domain }, deps)\n  }\n\n  @Query(() => BoardMetaSuggestion, {\n    description:\n      '도메인 안에서 충돌하지 않는 Board name + 상세 description 제안. ' +\n      'name 은 짧고 심플 (30자 이내, 충돌 회피 (n) suffix), description 은 자세히 ' +\n      '(사용자 prompt + AI importStrategy + 카테고리 분포 통계 합성).'\n  })\n  @Directive('@privilege(category: \"board-import\", privilege: \"query\")')\n  async suggestBoardMeta(\n    @Arg('input') input: SuggestBoardNameInput,\n    @Ctx() context: ResolverContext\n  ): Promise<SuggestBoardMetaResult> {\n    const { domain } = context.state\n    const deps = this._buildSuggestDeps()\n    return await suggestBoardMeta(input, { domain }, deps)\n  }\n\n  /** 두 query 가 공유하는 deps wiring — typeorm find idiomatic 패턴 (distinctAlias 회귀 회피). */\n  private _buildSuggestDeps() {\n    const sessionRepo = getRepository(ImportSession) as any\n    const attachmentRepo = getRepository(Attachment) as any\n    const boardRepo: SuggestBoardRepoLike = {\n      findExistingNames: async ({ domainId, basePrefix }) => {\n        // 도메인 격리 + 'basePrefix' 로 시작하는 name 후보 한 번에 조회.\n        // 단순 find({ where, select }) — take 없음 → DISTINCT 서브쿼리 미발생.\n        const escaped = basePrefix.replace(/[%_\\\\]/g, ch => '\\\\' + ch)\n        const items = await getRepository(Board).find({\n          select: ['name'],\n          where: { domain: { id: domainId }, name: Like(`${escaped}%`) }\n        })\n        return items.map(b => b.name as string)\n      }\n    }\n    return { sessionRepo, attachmentRepo, boardRepo }\n  }\n\n  @Mutation(() => Board, {\n    description:\n      '완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화한다. ' +\n      '검수 단계 (사용자/AI 가 import 결과를 확인 후 명시적으로 호출) 에서 사용. ' +\n      'Board.state=\"draft\" 로 생성되므로 release mutation 으로 별도 발행 필요.'\n  })\n  @Directive('@privilege(category: \"board-import\", privilege: \"mutation\")')\n  async materializeImportSession(\n    @Arg('input') input: MaterializeImportSessionInput,\n    @Ctx() context: ResolverContext\n  ): Promise<Board> {\n    const { domain, user } = context.state\n    const sessionRepo = getRepository(ImportSession)\n    const boardRepo = getRepository(Board)\n    const groupRepo = getRepository(Group)\n\n    const session = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } })\n\n    return (await materializeFromSession(\n      session as any,\n      input,\n      { domain, user },\n      { boardRepo: boardRepo as any, groupRepo: groupRepo as any }\n    )) as Board\n  }\n}\n"]}

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

@@ -0,0 +1,28 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+export declare class ImportSession {
+    readonly id?: string;
+    domain?: Domain;
+    domainId?: string;
+    /** Attachment.id (도면 파일). attachment-base 의존이지만 직접 ManyToOne 대신 ID 만 보유. */
+    attachmentId: string;
+    /** 어느 ChatSession 에서 발동됐는지 (board-ai 와 연동). 없으면 직접 호출. */
+    chatSessionId?: string;
+    /** 'queued' | 'parsing' | 'mapping' | 'assembling' | 'binding' | 'completed' | 'failed' */
+    status: string;
+    /** 0..100 */
+    progress: number;
+    /** 현재 단계 설명 또는 에러 메시지 */
+    message?: string;
+    /** import 옵션 (scopes, parseOptions, normalizeOrigin 등) */
+    optionsJson?: string;
+    get options(): any;
+    /** 결과: { boardModel, mapping: { stats, warnings } } */
+    resultJson?: string;
+    get result(): any;
+    totalEntities?: number;
+    creator?: User;
+    createdAt?: Date;
+    updatedAt?: Date;
+    completedAt?: Date;
+}

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

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportSession = void 0;
+const tslib_1 = require("tslib");
+/**
+ * ImportSession — 도면(Attachment) → BoardModel 변환 작업 단위.
+ *
+ * 비동기 워크플로우:
+ *   1) 클라이언트가 importBoardAsync(attachmentId) 호출 → ImportSession 즉시 반환 (status:'queued')
+ *   2) 백그라운드 worker 가 attachment 본문 → importBoard() 실행 → status 갱신
+ *   3) 클라이언트는 polling 또는 subscription 으로 진행 상황 추적
+ *   4) status='completed' 시 result 에 BoardModel + stats + warnings 포함
+ *
+ * board-ai 의 ChatSession 과 연결 가능 (chatSessionId) — chat 안에서 자동 발동되면 진행 메시지가
+ * 자동으로 ChatMessage(role:'system') 으로 기록되어 AI 컨텍스트에 흐름.
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+const env_1 = require("@things-factory/env");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let ImportSession = class ImportSession {
+    get options() {
+        try {
+            return this.optionsJson ? JSON.parse(this.optionsJson) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    get result() {
+        try {
+            return this.resultJson ? JSON.parse(this.resultJson) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+};
+exports.ImportSession = ImportSession;
+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)
+], ImportSession.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)
+], ImportSession.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((session) => session.domain),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Attachment id (the source drawing file)' }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "attachmentId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'ChatSession id when triggered from chat (board-ai).' }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "chatSessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 32, default: 'queued' }),
+    (0, type_graphql_1.Field)({ description: 'queued | parsing | mapping | assembling | binding | completed | failed' }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float', default: 0 }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { description: 'Progress percentage 0..100' }),
+    tslib_1.__metadata("design:type", Number)
+], ImportSession.prototype, "progress", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true, type: 'text' }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "message", 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
+    }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "optionsJson", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Options used (parsed JSON).' }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], ImportSession.prototype, "options", null);
+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
+    }),
+    tslib_1.__metadata("design:type", String)
+], ImportSession.prototype, "resultJson", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { nullable: true, description: 'Result (parsed JSON): { boardModel, stats, warnings }.' }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], ImportSession.prototype, "result", null);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'Total entities counted (when known).' }),
+    tslib_1.__metadata("design:type", Number)
+], ImportSession.prototype, "totalEntities", 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 }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], ImportSession.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ImportSession.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ImportSession.prototype, "updatedAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], ImportSession.prototype, "completedAt", void 0);
+exports.ImportSession = ImportSession = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_import_session_1', (session) => [session.domain, session.createdAt]),
+    (0, typeorm_1.Index)('ix_import_session_2', (session) => [session.chatSessionId]),
+    (0, type_graphql_1.ObjectType)({ description: '도면 → 보드 변환 작업의 영속 단위 (비동기 진행상태 추적).' })
+], ImportSession);
+//# sourceMappingURL=import-session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import-session.js","sourceRoot":"","sources":["../../../server/service/import-session/import-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ImportSession — 도면(Attachment) → BoardModel 변환 작업 단위.\n *\n * 비동기 워크플로우:\n *   1) 클라이언트가 importBoardAsync(attachmentId) 호출 → ImportSession 즉시 반환 (status:'queued')\n *   2) 백그라운드 worker 가 attachment 본문 → importBoard() 실행 → status 갱신\n *   3) 클라이언트는 polling 또는 subscription 으로 진행 상황 추적\n *   4) status='completed' 시 result 에 BoardModel + stats + warnings 포함\n *\n * board-ai 의 ChatSession 과 연결 가능 (chatSessionId) — chat 안에서 자동 발동되면 진행 메시지가\n * 자동으로 ChatMessage(role:'system') 으로 기록되어 AI 컨텍스트에 흐름.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, Float, ID, Int, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_import_session_1', (session: ImportSession) => [session.domain, session.createdAt])\n@Index('ix_import_session_2', (session: ImportSession) => [session.chatSessionId])\n@ObjectType({ description: '도면 → 보드 변환 작업의 영속 단위 (비동기 진행상태 추적).' })\nexport class ImportSession {\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: ImportSession) => session.domain)\n  domainId?: string\n\n  /** Attachment.id (도면 파일). attachment-base 의존이지만 직접 ManyToOne 대신 ID 만 보유. */\n  @Column()\n  @Field({ description: 'Attachment id (the source drawing file)' })\n  attachmentId!: string\n\n  /** 어느 ChatSession 에서 발동됐는지 (board-ai 와 연동). 없으면 직접 호출. */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ChatSession id when triggered from chat (board-ai).' })\n  chatSessionId?: string\n\n  /** 'queued' | 'parsing' | 'mapping' | 'assembling' | 'binding' | 'completed' | 'failed' */\n  @Column({ type: 'varchar', length: 32, default: 'queued' })\n  @Field({ description: 'queued | parsing | mapping | assembling | binding | completed | failed' })\n  status!: string\n\n  /** 0..100 */\n  @Column({ type: 'float', default: 0 })\n  @Field(type => Float, { description: 'Progress percentage 0..100' })\n  progress!: number\n\n  /** 현재 단계 설명 또는 에러 메시지 */\n  @Column({ nullable: true, type: 'text' })\n  @Field({ nullable: true })\n  message?: string\n\n  /** import 옵션 (scopes, parseOptions, normalizeOrigin 등) */\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  optionsJson?: string\n\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Options used (parsed JSON).' })\n  get options(): any {\n    try {\n      return this.optionsJson ? JSON.parse(this.optionsJson) : null\n    } catch {\n      return null\n    }\n  }\n\n  /** 결과: { boardModel, mapping: { stats, warnings } } */\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  resultJson?: string\n\n  @Field(type => GraphQLJSON, { nullable: true, description: 'Result (parsed JSON): { boardModel, stats, warnings }.' })\n  get result(): any {\n    try {\n      return this.resultJson ? JSON.parse(this.resultJson) : null\n    } catch {\n      return null\n    }\n  }\n\n  @Column({ nullable: true })\n  @Field(type => Int, { nullable: true, description: 'Total entities counted (when known).' })\n  totalEntities?: number\n\n  @ManyToOne(type => User)\n  @Field(type => User, { nullable: true })\n  creator?: User\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true })\n  updatedAt?: Date\n\n  @Column({ nullable: true })\n  @Field({ nullable: true })\n  completedAt?: Date\n}\n"]}

package/dist-server/service/import-session/import-worker.d.ts

@@ -0,0 +1 @@
+export declare function runImportJob(sessionId: string): Promise<void>;