@things-factory/attachment-base 10.0.0-beta.6 → 10.0.0-beta.67

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"]}