@things-factory/attachment-base 10.0.0-beta.7 → 10.0.0-beta.71

package/dist-server/service/attachment/mimetype.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * 업로드 파일의 mimetype 정규화.
+ *
+ * Apollo `graphql-upload` 의 FileUpload.mimetype 은 클라이언트가 보낸
+ * multipart/form-data 의 Content-Type 을 그대로 받는다. 이 값은 OS / 브라우저의
+ * MIME 데이터베이스가 확장자를 인식하느냐에 따라 같은 파일이라도 다르게 들어온다.
+ * 대표적으로 GLB:
+ *   - .glb 가 MIME DB 에 등록된 환경  → 'model/gltf-binary'
+ *   - 미등록 환경 (Windows 일부 등)    → 'application/octet-stream'
+ *   - zip 해제 / 메일 첨부 거치면서 손실 → 'application/octet-stream'
+ *
+ * 이 불일치 때문에 썸네일 생성, 검색, category 분류 등 후속 로직이 같은 파일에
+ * 대해 다르게 동작했다. 본 모듈은 모호한 mime ('' / 'application/octet-stream')
+ * 일 때만 magic byte → 확장자 순으로 재판정하고, 의미 있는 mime 은 그대로 둔다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeMimetype = normalizeMimetype;
+exports.detectMimetypeFromContent = detectMimetypeFromContent;
+exports.categoryFromMimetype = categoryFromMimetype;
+const GENERIC_BINARY_MIMETYPES = new Set(['', 'application/octet-stream', 'binary/octet-stream']);
+/**
+ * 파일 컨텐츠의 처음 몇 바이트(magic byte)로 알려진 포맷을 식별한다.
+ * 알 수 없으면 undefined 반환. 의도적으로 좁은 집합만 식별 — 잘못된 추론을
+ * 피하기 위해 의심스러운 케이스는 호출자가 다음 단서(확장자)로 넘긴다.
+ */
+function detectByMagic(contents) {
+    if (!contents || contents.length < 4)
+        return;
+    // GLB: ASCII 'glTF'
+    if (contents[0] === 0x67 && contents[1] === 0x6c && contents[2] === 0x54 && contents[3] === 0x46) {
+        return 'model/gltf-binary';
+    }
+    return;
+}
+/**
+ * 파일명 확장자로 알려진 포맷을 추론.
+ */
+function detectByExtension(filename) {
+    const lower = filename.toLowerCase();
+    if (lower.endsWith('.glb'))
+        return 'model/gltf-binary';
+    if (lower.endsWith('.gltf'))
+        return 'model/gltf+json';
+    return;
+}
+/**
+ * 모호한 원본 mimetype 을 컨텐츠/파일명 기반으로 재판정한다.
+ *
+ * 정규화 규칙:
+ *  1. 원본 mime 이 의미 있으면 (예: 'image/png', 'model/gltf-binary') 그대로 보존.
+ *  2. 원본 mime 이 모호한 경우 (`''`, `application/octet-stream`,
+ *     `binary/octet-stream`) magic byte → 확장자 순으로 추론.
+ *  3. 추론도 실패하면 원본 그대로 반환 (정보 손실 없음).
+ *
+ * 이 함수는 동일 파일이 환경 차이로 다른 mime 으로 들어와도 일관된 mime 으로
+ * 저장/처리되도록 보장한다 — 썸네일 생성, 카테고리 분류, backfill 쿼리 등
+ * mime 을 키로 하는 후속 로직 모두에 영향.
+ */
+function normalizeMimetype(originalMime, filename, contents) {
+    const mime = originalMime || '';
+    if (!GENERIC_BINARY_MIMETYPES.has(mime))
+        return mime;
+    if (contents) {
+        const detected = detectByMagic(contents);
+        if (detected)
+            return detected;
+    }
+    if (filename) {
+        const detected = detectByExtension(filename);
+        if (detected)
+            return detected;
+    }
+    return mime;
+}
+/**
+ * 외부에서 (예: 백필 쿼리) 모호한 mime 으로 저장된 첨부파일의 실제 포맷을 추정.
+ * normalizeMimetype 와 동일한 매직바이트/확장자 결과를 반환하지만, 의미 있는
+ * 원본 mime 보존 정책을 거치지 않는다 — 이미 저장된 데이터의 실제 포맷이
+ * 무엇인지를 알아내야 하는 backfill 시나리오 전용.
+ */
+function detectMimetypeFromContent(filename, contents) {
+    if (contents) {
+        const detected = detectByMagic(contents);
+        if (detected)
+            return detected;
+    }
+    if (filename) {
+        const detected = detectByExtension(filename);
+        if (detected)
+            return detected;
+    }
+    return;
+}
+/**
+ * mimetype 으로부터 attachment.category 결정.
+ *
+ * 기본 규칙은 mimetype 의 main type ('image/png' → 'image'). 단, 3D 모델
+ * (model/*) 은 시각 자산이라 사용자 인지 측면에서 'image' 카테고리로 묶는다.
+ * 별도의 'model' 카테고리를 두지 않은 이유는 기존 attachment picker UI 들이
+ * 'image' 카테고리를 기준으로 시각 자산을 필터링하기 때문 — picker 마다 옵션
+ * 추가 작업 부담을 피하기 위한 실용적 선택. 향후 3D 모델 전용 picker 가
+ * 필요해지면 'model' 분리를 재검토.
+ */
+function categoryFromMimetype(mimetype) {
+    const main = (mimetype || '').split('/').shift() || '';
+    if (main === 'model')
+        return 'image';
+    return main;
+}
+//# sourceMappingURL=mimetype.js.map

package/dist-server/service/attachment/mimetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimetype.js","sourceRoot":"","sources":["../../../server/service/attachment/mimetype.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AA6CH,8CAoBC;AAQD,8DAeC;AAYD,oDAIC;AAtGD,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,0BAA0B,EAAE,qBAAqB,CAAC,CAAC,CAAA;AAEjG;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAM;IAE5C,oBAAoB;IACpB,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjG,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAED,OAAM;AACR,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IAEpC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,mBAAmB,CAAA;IACtD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,iBAAiB,CAAA;IAErD,OAAM;AACR,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAC/B,YAAgC,EAChC,QAA4B,EAC5B,QAAmC;IAEnC,MAAM,IAAI,GAAG,YAAY,IAAI,EAAE,CAAA;IAE/B,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAEpD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QAC5C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,QAA4B,EAC5B,QAAmC;IAEnC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;QAC5C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;IAC/B,CAAC;IAED,OAAM;AACR,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAAC,QAA4B;IAC/D,MAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAA;IACtD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACpC,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["/**\n * 업로드 파일의 mimetype 정규화.\n *\n * Apollo `graphql-upload` 의 FileUpload.mimetype 은 클라이언트가 보낸\n * multipart/form-data 의 Content-Type 을 그대로 받는다. 이 값은 OS / 브라우저의\n * MIME 데이터베이스가 확장자를 인식하느냐에 따라 같은 파일이라도 다르게 들어온다.\n * 대표적으로 GLB:\n *   - .glb 가 MIME DB 에 등록된 환경  → 'model/gltf-binary'\n *   - 미등록 환경 (Windows 일부 등)    → 'application/octet-stream'\n *   - zip 해제 / 메일 첨부 거치면서 손실 → 'application/octet-stream'\n *\n * 이 불일치 때문에 썸네일 생성, 검색, category 분류 등 후속 로직이 같은 파일에\n * 대해 다르게 동작했다. 본 모듈은 모호한 mime ('' / 'application/octet-stream')\n * 일 때만 magic byte → 확장자 순으로 재판정하고, 의미 있는 mime 은 그대로 둔다.\n */\n\nconst GENERIC_BINARY_MIMETYPES = new Set(['', 'application/octet-stream', 'binary/octet-stream'])\n\n/**\n * 파일 컨텐츠의 처음 몇 바이트(magic byte)로 알려진 포맷을 식별한다.\n * 알 수 없으면 undefined 반환. 의도적으로 좁은 집합만 식별 — 잘못된 추론을\n * 피하기 위해 의심스러운 케이스는 호출자가 다음 단서(확장자)로 넘긴다.\n */\nfunction detectByMagic(contents: Buffer): string | undefined {\n  if (!contents || contents.length < 4) return\n\n  // GLB: ASCII 'glTF'\n  if (contents[0] === 0x67 && contents[1] === 0x6c && contents[2] === 0x54 && contents[3] === 0x46) {\n    return 'model/gltf-binary'\n  }\n\n  return\n}\n\n/**\n * 파일명 확장자로 알려진 포맷을 추론.\n */\nfunction detectByExtension(filename: string): string | undefined {\n  const lower = filename.toLowerCase()\n\n  if (lower.endsWith('.glb')) return 'model/gltf-binary'\n  if (lower.endsWith('.gltf')) return 'model/gltf+json'\n\n  return\n}\n\n/**\n * 모호한 원본 mimetype 을 컨텐츠/파일명 기반으로 재판정한다.\n *\n * 정규화 규칙:\n *  1. 원본 mime 이 의미 있으면 (예: 'image/png', 'model/gltf-binary') 그대로 보존.\n *  2. 원본 mime 이 모호한 경우 (`''`, `application/octet-stream`,\n *     `binary/octet-stream`) magic byte → 확장자 순으로 추론.\n *  3. 추론도 실패하면 원본 그대로 반환 (정보 손실 없음).\n *\n * 이 함수는 동일 파일이 환경 차이로 다른 mime 으로 들어와도 일관된 mime 으로\n * 저장/처리되도록 보장한다 — 썸네일 생성, 카테고리 분류, backfill 쿼리 등\n * mime 을 키로 하는 후속 로직 모두에 영향.\n */\nexport function normalizeMimetype(\n  originalMime: string | undefined,\n  filename: string | undefined,\n  contents: Buffer | undefined | null\n): string {\n  const mime = originalMime || ''\n\n  if (!GENERIC_BINARY_MIMETYPES.has(mime)) return mime\n\n  if (contents) {\n    const detected = detectByMagic(contents)\n    if (detected) return detected\n  }\n\n  if (filename) {\n    const detected = detectByExtension(filename)\n    if (detected) return detected\n  }\n\n  return mime\n}\n\n/**\n * 외부에서 (예: 백필 쿼리) 모호한 mime 으로 저장된 첨부파일의 실제 포맷을 추정.\n * normalizeMimetype 와 동일한 매직바이트/확장자 결과를 반환하지만, 의미 있는\n * 원본 mime 보존 정책을 거치지 않는다 — 이미 저장된 데이터의 실제 포맷이\n * 무엇인지를 알아내야 하는 backfill 시나리오 전용.\n */\nexport function detectMimetypeFromContent(\n  filename: string | undefined,\n  contents: Buffer | undefined | null\n): string | undefined {\n  if (contents) {\n    const detected = detectByMagic(contents)\n    if (detected) return detected\n  }\n\n  if (filename) {\n    const detected = detectByExtension(filename)\n    if (detected) return detected\n  }\n\n  return\n}\n\n/**\n * mimetype 으로부터 attachment.category 결정.\n *\n * 기본 규칙은 mimetype 의 main type ('image/png' → 'image'). 단, 3D 모델\n * (model/*) 은 시각 자산이라 사용자 인지 측면에서 'image' 카테고리로 묶는다.\n * 별도의 'model' 카테고리를 두지 않은 이유는 기존 attachment picker UI 들이\n * 'image' 카테고리를 기준으로 시각 자산을 필터링하기 때문 — picker 마다 옵션\n * 추가 작업 부담을 피하기 위한 실용적 선택. 향후 3D 모델 전용 picker 가\n * 필요해지면 'model' 분리를 재검토.\n */\nexport function categoryFromMimetype(mimetype: string | undefined): string {\n  const main = (mimetype || '').split('/').shift() || ''\n  if (main === 'model') return 'image'\n  return main\n}\n"]}

package/dist-server/service/attachment/thumbnail-backfill.d.ts

@@ -0,0 +1,17 @@
+export declare class ThumbnailBackfillResult {
+    attempted: number;
+    succeeded: number;
+    failed: number;
+    remaining: number;
+}
+/**
+ * 썸네일이 없는 첨부파일을 조회해서 서버에서 썸네일을 생성·저장한다.
+ * 하나의 호출당 최대 `limit` 개까지만 처리 — 장시간 점유 방지.
+ * 결과의 `remaining > 0` 이면 동일 호출을 반복해 배치 완료시킴.
+ *
+ * 대상 mimetype 만 시도 (현재 image/*, model/gltf-*).
+ * contents 컬럼이 비어 있고 STORAGE.readFile 로도 못 읽으면 skip.
+ */
+export declare function backfillAttachmentThumbnails({ limit }: {
+    limit?: number;
+}, context: ResolverContext): Promise<ThumbnailBackfillResult>;

package/dist-server/service/attachment/thumbnail-backfill.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThumbnailBackfillResult = void 0;
+exports.backfillAttachmentThumbnails = backfillAttachmentThumbnails;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const env_1 = require("@things-factory/env");
+const shell_1 = require("@things-factory/shell");
+const attachment_const_1 = require("../../attachment-const");
+const attachment_1 = require("./attachment");
+const thumbnail_1 = require("./thumbnail");
+let ThumbnailBackfillResult = class ThumbnailBackfillResult {
+};
+exports.ThumbnailBackfillResult = ThumbnailBackfillResult;
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, { description: '이번 호출에서 처리 시도한 첨부 개수' }),
+    tslib_1.__metadata("design:type", Number)
+], ThumbnailBackfillResult.prototype, "attempted", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, { description: '썸네일 생성·저장 성공 개수' }),
+    tslib_1.__metadata("design:type", Number)
+], ThumbnailBackfillResult.prototype, "succeeded", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, { description: '실패(생성 실패/콘텐츠 없음 등) 개수' }),
+    tslib_1.__metadata("design:type", Number)
+], ThumbnailBackfillResult.prototype, "failed", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => type_graphql_1.Int, {
+        description: '이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료'
+    }),
+    tslib_1.__metadata("design:type", Number)
+], ThumbnailBackfillResult.prototype, "remaining", void 0);
+exports.ThumbnailBackfillResult = ThumbnailBackfillResult = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: '썸네일 백필 결과' })
+], ThumbnailBackfillResult);
+/**
+ * 썸네일이 없는 첨부파일을 조회해서 서버에서 썸네일을 생성·저장한다.
+ * 하나의 호출당 최대 `limit` 개까지만 처리 — 장시간 점유 방지.
+ * 결과의 `remaining > 0` 이면 동일 호출을 반복해 배치 완료시킴.
+ *
+ * 대상 mimetype 만 시도 (현재 image/*, model/gltf-*).
+ * contents 컬럼이 비어 있고 STORAGE.readFile 로도 못 읽으면 skip.
+ */
+async function backfillAttachmentThumbnails({ limit = 20 }, context) {
+    // ResolverContext 은 things-factory 런타임 전역 타입
+    const { domain, tx } = context.state;
+    const repository = tx ? tx.getRepository(attachment_1.Attachment) : (0, shell_1.getRepository)(attachment_1.Attachment);
+    // 지원 mimetype 중 썸네일 미생성 대상만 조회
+    const qb = repository.createQueryBuilder('att')
+        .where('att.domain_id = :domainId', { domainId: domain.id })
+        .andWhere('att.thumbnail IS NULL')
+        .andWhere('(att.mimetype LIKE :imagePrefix OR att.mimetype IN (:...gltfTypes))', {
+        imagePrefix: 'image/%',
+        gltfTypes: ['model/gltf-binary', 'model/gltf+json']
+    });
+    const candidates = await qb.take(limit).getMany();
+    let succeeded = 0;
+    let failed = 0;
+    for (const att of candidates) {
+        try {
+            const contents = await resolveContents(att);
+            if (!contents) {
+                failed++;
+                continue;
+            }
+            const thumbnail = await (0, thumbnail_1.generateThumbnail)(contents, att.mimetype);
+            if (!thumbnail) {
+                failed++;
+                continue;
+            }
+            await repository.update({ id: att.id }, { thumbnail });
+            succeeded++;
+        }
+        catch (e) {
+            failed++;
+            env_1.logger.warn(`[thumbnail-backfill] ${att.id} failed: ${e.message}`);
+        }
+    }
+    // 남은 후보 개수 — 다음 호출 필요 여부 판단용
+    const remaining = await qb.getCount();
+    return {
+        attempted: candidates.length,
+        succeeded,
+        failed,
+        remaining
+    };
+}
+/**
+ * contents 획득: DB 저장 모드는 att.contents Buffer 직접, 파일/S3/Azure 모드는
+ * STORAGE.readFile 로 경로에서 읽는다. 읽기 실패 시 undefined.
+ */
+async function resolveContents(att) {
+    // @ts-ignore — TypeORM 이 contents 를 Buffer 로 반환 (타입 시그니처는 any)
+    const fromDb = att.contents;
+    if (fromDb && fromDb.length > 0)
+        return fromDb;
+    if (!att.path)
+        return;
+    try {
+        const readFile = attachment_const_1.STORAGE.readFile;
+        if (typeof readFile !== 'function')
+            return;
+        const result = await readFile(att.path);
+        if (typeof result === 'string')
+            return Buffer.from(result);
+        if (Buffer.isBuffer(result))
+            return result;
+        return;
+    }
+    catch (e) {
+        env_1.logger.warn(`[thumbnail-backfill] readFile failed for ${att.path}: ${e.message}`);
+        return;
+    }
+}
+//# sourceMappingURL=thumbnail-backfill.js.map

package/dist-server/service/attachment/thumbnail-backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-backfill.js","sourceRoot":"","sources":["../../../server/service/attachment/thumbnail-backfill.ts"],"names":[],"mappings":"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","sourcesContent":["import { Field, Int, ObjectType } from 'type-graphql'\nimport { IsNull } from 'typeorm'\n\nimport { logger } from '@things-factory/env'\nimport { getRepository } from '@things-factory/shell'\n\nimport { STORAGE } from '../../attachment-const'\nimport { Attachment } from './attachment'\nimport { generateThumbnail } from './thumbnail'\n\n@ObjectType({ description: '썸네일 백필 결과' })\nexport class ThumbnailBackfillResult {\n  @Field(() => Int, { description: '이번 호출에서 처리 시도한 첨부 개수' })\n  attempted!: number\n\n  @Field(() => Int, { description: '썸네일 생성·저장 성공 개수' })\n  succeeded!: number\n\n  @Field(() => Int, { description: '실패(생성 실패/콘텐츠 없음 등) 개수' })\n  failed!: number\n\n  @Field(() => Int, {\n    description: '이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료'\n  })\n  remaining!: number\n}\n\n/**\n * 썸네일이 없는 첨부파일을 조회해서 서버에서 썸네일을 생성·저장한다.\n * 하나의 호출당 최대 `limit` 개까지만 처리 — 장시간 점유 방지.\n * 결과의 `remaining > 0` 이면 동일 호출을 반복해 배치 완료시킴.\n *\n * 대상 mimetype 만 시도 (현재 image/*, model/gltf-*).\n * contents 컬럼이 비어 있고 STORAGE.readFile 로도 못 읽으면 skip.\n */\nexport async function backfillAttachmentThumbnails(\n  { limit = 20 }: { limit?: number },\n  context: ResolverContext\n): Promise<ThumbnailBackfillResult> {\n  // ResolverContext 은 things-factory 런타임 전역 타입\n  const { domain, tx } = context.state\n  const repository = tx ? tx.getRepository(Attachment) : getRepository(Attachment)\n\n  // 지원 mimetype 중 썸네일 미생성 대상만 조회\n  const qb = repository.createQueryBuilder('att')\n    .where('att.domain_id = :domainId', { domainId: domain.id })\n    .andWhere('att.thumbnail IS NULL')\n    .andWhere('(att.mimetype LIKE :imagePrefix OR att.mimetype IN (:...gltfTypes))', {\n      imagePrefix: 'image/%',\n      gltfTypes: ['model/gltf-binary', 'model/gltf+json']\n    })\n\n  const candidates = await qb.take(limit).getMany()\n\n  let succeeded = 0\n  let failed = 0\n\n  for (const att of candidates) {\n    try {\n      const contents = await resolveContents(att)\n      if (!contents) {\n        failed++\n        continue\n      }\n\n      const thumbnail = await generateThumbnail(contents, att.mimetype)\n      if (!thumbnail) {\n        failed++\n        continue\n      }\n\n      await repository.update({ id: att.id }, { thumbnail })\n      succeeded++\n    } catch (e) {\n      failed++\n      logger.warn(`[thumbnail-backfill] ${att.id} failed: ${(e as Error).message}`)\n    }\n  }\n\n  // 남은 후보 개수 — 다음 호출 필요 여부 판단용\n  const remaining = await qb.getCount()\n\n  return {\n    attempted: candidates.length,\n    succeeded,\n    failed,\n    remaining\n  }\n}\n\n/**\n * contents 획득: DB 저장 모드는 att.contents Buffer 직접, 파일/S3/Azure 모드는\n * STORAGE.readFile 로 경로에서 읽는다. 읽기 실패 시 undefined.\n */\nasync function resolveContents(att: Attachment): Promise<Buffer | undefined> {\n  // @ts-ignore — TypeORM 이 contents 를 Buffer 로 반환 (타입 시그니처는 any)\n  const fromDb: Buffer | null | undefined = (att as any).contents\n  if (fromDb && fromDb.length > 0) return fromDb\n\n  if (!att.path) return\n\n  try {\n    const readFile = (STORAGE as any).readFile as\n      | ((path: string, encoding?: string) => Buffer | string)\n      | undefined\n    if (typeof readFile !== 'function') return\n    const result = await readFile(att.path)\n    if (typeof result === 'string') return Buffer.from(result)\n    if (Buffer.isBuffer(result)) return result\n    return\n  } catch (e) {\n    logger.warn(`[thumbnail-backfill] readFile failed for ${att.path}: ${(e as Error).message}`)\n    return\n  }\n}\n"]}

package/dist-server/service/attachment/thumbnail.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 바이너리 컨텐츠로부터 썸네일 data URI 생성.
+ *
+ * mimetype 기반 dispatcher:
+ *  - image/*             → sharp 로 200x200 JPEG 썸네일
+ *  - model/gltf-binary   → headless Three.js 렌더로 적절한 뷰포인트 JPEG
+ *  - model/gltf+json     → 동일
+ *  - 그 외                → undefined (클라이언트는 generic 아이콘 표시)
+ *
+ * 반환: `data:image/...;base64,...` 형태 — Attachment.thumbnail 컬럼에 저장 가능.
+ *        외부 URL 로 대체 저장하는 것도 스키마상 유효함.
+ */
+export declare function generateThumbnail(contents: Buffer | undefined | null, mimetype: string | undefined): Promise<string | undefined>;

package/dist-server/service/attachment/thumbnail.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateThumbnail = generateThumbnail;
+const tslib_1 = require("tslib");
+const sharp_1 = tslib_1.__importDefault(require("sharp"));
+const env_1 = require("@things-factory/env");
+const gltf_thumbnail_1 = require("./gltf-thumbnail");
+const IMAGE_THUMB_MAX = 200;
+const IMAGE_THUMB_QUALITY = 70;
+/**
+ * 바이너리 컨텐츠로부터 썸네일 data URI 생성.
+ *
+ * mimetype 기반 dispatcher:
+ *  - image/*             → sharp 로 200x200 JPEG 썸네일
+ *  - model/gltf-binary   → headless Three.js 렌더로 적절한 뷰포인트 JPEG
+ *  - model/gltf+json     → 동일
+ *  - 그 외                → undefined (클라이언트는 generic 아이콘 표시)
+ *
+ * 반환: `data:image/...;base64,...` 형태 — Attachment.thumbnail 컬럼에 저장 가능.
+ *        외부 URL 로 대체 저장하는 것도 스키마상 유효함.
+ */
+async function generateThumbnail(contents, mimetype) {
+    if (!contents || !mimetype)
+        return;
+    if (mimetype.startsWith('image/')) {
+        return generateImageThumbnail(contents);
+    }
+    if (mimetype === 'model/gltf-binary' || mimetype === 'model/gltf+json') {
+        return (0, gltf_thumbnail_1.generateGltfThumbnail)(contents, mimetype);
+    }
+    return;
+}
+async function generateImageThumbnail(contents) {
+    try {
+        const buffer = await (0, sharp_1.default)(contents)
+            .rotate() // EXIF 방향 자동 보정
+            .resize(IMAGE_THUMB_MAX, IMAGE_THUMB_MAX, { fit: 'inside', withoutEnlargement: true })
+            .jpeg({ quality: IMAGE_THUMB_QUALITY })
+            .toBuffer();
+        return `data:image/jpeg;base64,${buffer.toString('base64')}`;
+    }
+    catch (e) {
+        env_1.logger.warn(`[attachment] image thumbnail generation failed: ${e.message}`);
+        return;
+    }
+}
+//# sourceMappingURL=thumbnail.js.map

package/dist-server/service/attachment/thumbnail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.js","sourceRoot":"","sources":["../../../server/service/attachment/thumbnail.ts"],"names":[],"mappings":";;AAqBA,8CAeC;;AApCD,0DAAyB;AAEzB,6CAA4C;AAE5C,qDAAwD;AAExD,MAAM,eAAe,GAAG,GAAG,CAAA;AAC3B,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAE9B;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAAmC,EACnC,QAA4B;IAE5B,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ;QAAE,OAAM;IAElC,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,QAAQ,KAAK,mBAAmB,IAAI,QAAQ,KAAK,iBAAiB,EAAE,CAAC;QACvE,OAAO,IAAA,sCAAqB,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAClD,CAAC;IAED,OAAM;AACR,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,eAAK,EAAC,QAAQ,CAAC;aACjC,MAAM,EAAE,CAAC,gBAAgB;aACzB,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;aACrF,IAAI,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;aACtC,QAAQ,EAAE,CAAA;QAEb,OAAO,0BAA0B,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAA;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,YAAM,CAAC,IAAI,CAAC,mDAAoD,CAAW,CAAC,OAAO,EAAE,CAAC,CAAA;QACtF,OAAM;IACR,CAAC;AACH,CAAC","sourcesContent":["import sharp from 'sharp'\n\nimport { logger } from '@things-factory/env'\n\nimport { generateGltfThumbnail } from './gltf-thumbnail'\n\nconst IMAGE_THUMB_MAX = 200\nconst IMAGE_THUMB_QUALITY = 70\n\n/**\n * 바이너리 컨텐츠로부터 썸네일 data URI 생성.\n *\n * mimetype 기반 dispatcher:\n *  - image/*             → sharp 로 200x200 JPEG 썸네일\n *  - model/gltf-binary   → headless Three.js 렌더로 적절한 뷰포인트 JPEG\n *  - model/gltf+json     → 동일\n *  - 그 외                → undefined (클라이언트는 generic 아이콘 표시)\n *\n * 반환: `data:image/...;base64,...` 형태 — Attachment.thumbnail 컬럼에 저장 가능.\n *        외부 URL 로 대체 저장하는 것도 스키마상 유효함.\n */\nexport async function generateThumbnail(\n  contents: Buffer | undefined | null,\n  mimetype: string | undefined\n): Promise<string | undefined> {\n  if (!contents || !mimetype) return\n\n  if (mimetype.startsWith('image/')) {\n    return generateImageThumbnail(contents)\n  }\n\n  if (mimetype === 'model/gltf-binary' || mimetype === 'model/gltf+json') {\n    return generateGltfThumbnail(contents, mimetype)\n  }\n\n  return\n}\n\nasync function generateImageThumbnail(contents: Buffer): Promise<string | undefined> {\n  try {\n    const buffer = await sharp(contents)\n      .rotate() // EXIF 방향 자동 보정\n      .resize(IMAGE_THUMB_MAX, IMAGE_THUMB_MAX, { fit: 'inside', withoutEnlargement: true })\n      .jpeg({ quality: IMAGE_THUMB_QUALITY })\n      .toBuffer()\n\n    return `data:image/jpeg;base64,${buffer.toString('base64')}`\n  } catch (e) {\n    logger.warn(`[attachment] image thumbnail generation failed: ${(e as Error).message}`)\n    return\n  }\n}\n"]}