@lumir-company/editor 0.4.3 → 0.4.5

package/dist/api/link-preview.d.mts

@@ -0,0 +1,40 @@
+/**
+ * @lumir-company/editor - Link Preview API Handler
+ *
+ * 서버 사이드 전용 모듈입니다. Next.js App Router, Remix, SvelteKit 등
+ * Web API 표준(Request/Response)을 지원하는 프레임워크에서 사용할 수 있습니다.
+ *
+ * Next.js App Router 사용 예시:
+ * ```ts
+ * // src/app/api/link-preview/route.ts
+ * export { GET } from "@lumir-company/editor/api/link-preview";
+ * ```
+ */
+interface LinkMetadata {
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    domain: string;
+}
+/**
+ * HTML 문자열에서 Open Graph / Twitter Card 메타데이터를 파싱합니다.
+ * 커스텀 서버 구현 시 직접 사용할 수 있습니다.
+ */
+declare function parseMetaTags(html: string, baseUrl: string): LinkMetadata;
+/**
+ * URL에서 메타데이터를 가져옵니다 (서버 사이드 전용).
+ * Express, Fastify 등 커스텀 서버에서 직접 사용할 수 있습니다.
+ */
+declare function fetchUrlMetadata(url: string): Promise<LinkMetadata>;
+/**
+ * 링크 프리뷰 메타데이터 조회 핸들러 (Web API 표준 Request/Response).
+ * Next.js App Router, Remix, SvelteKit 등에서 re-export하여 사용합니다.
+ *
+ * @example
+ * // Next.js: src/app/api/link-preview/route.ts
+ * export { linkPreviewHandler as GET } from "@lumir-company/editor/api/link-preview";
+ */
+declare function linkPreviewHandler(request: Request): Promise<Response>;
+
+export { type LinkMetadata, fetchUrlMetadata, linkPreviewHandler, parseMetaTags };

package/dist/api/link-preview.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @lumir-company/editor - Link Preview API Handler
+ *
+ * 서버 사이드 전용 모듈입니다. Next.js App Router, Remix, SvelteKit 등
+ * Web API 표준(Request/Response)을 지원하는 프레임워크에서 사용할 수 있습니다.
+ *
+ * Next.js App Router 사용 예시:
+ * ```ts
+ * // src/app/api/link-preview/route.ts
+ * export { GET } from "@lumir-company/editor/api/link-preview";
+ * ```
+ */
+interface LinkMetadata {
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    domain: string;
+}
+/**
+ * HTML 문자열에서 Open Graph / Twitter Card 메타데이터를 파싱합니다.
+ * 커스텀 서버 구현 시 직접 사용할 수 있습니다.
+ */
+declare function parseMetaTags(html: string, baseUrl: string): LinkMetadata;
+/**
+ * URL에서 메타데이터를 가져옵니다 (서버 사이드 전용).
+ * Express, Fastify 등 커스텀 서버에서 직접 사용할 수 있습니다.
+ */
+declare function fetchUrlMetadata(url: string): Promise<LinkMetadata>;
+/**
+ * 링크 프리뷰 메타데이터 조회 핸들러 (Web API 표준 Request/Response).
+ * Next.js App Router, Remix, SvelteKit 등에서 re-export하여 사용합니다.
+ *
+ * @example
+ * // Next.js: src/app/api/link-preview/route.ts
+ * export { linkPreviewHandler as GET } from "@lumir-company/editor/api/link-preview";
+ */
+declare function linkPreviewHandler(request: Request): Promise<Response>;
+
+export { type LinkMetadata, fetchUrlMetadata, linkPreviewHandler, parseMetaTags };

package/dist/api/link-preview.js

@@ -0,0 +1,190 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/link-preview.ts
+var link_preview_exports = {};
+__export(link_preview_exports, {
+  fetchUrlMetadata: () => fetchUrlMetadata,
+  linkPreviewHandler: () => linkPreviewHandler,
+  parseMetaTags: () => parseMetaTags
+});
+module.exports = __toCommonJS(link_preview_exports);
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname.replace(/^www\./, "");
+  } catch {
+    return url;
+  }
+}
+function decodeHtmlEntity(str) {
+  return str.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&nbsp;/g, " ").replace(/&#x27;/g, "'").replace(/&#x2F;/g, "/");
+}
+function getMetaContent(html, property, name) {
+  const patterns = [
+    new RegExp(
+      `<meta\\s+property=["']${property}["']\\s+content=["']([^"']+)["']`,
+      "i"
+    ),
+    new RegExp(
+      `<meta\\s+content=["']([^"']+)["']\\s+property=["']${property}["']`,
+      "i"
+    )
+  ];
+  if (name) {
+    patterns.push(
+      new RegExp(
+        `<meta\\s+name=["']${name}["']\\s+content=["']([^"']+)["']`,
+        "i"
+      ),
+      new RegExp(
+        `<meta\\s+content=["']([^"']+)["']\\s+name=["']${name}["']`,
+        "i"
+      )
+    );
+  }
+  for (const pattern of patterns) {
+    const match = html.match(pattern);
+    if (match?.[1]) return match[1].trim();
+  }
+  return null;
+}
+function parseMetaTags(html, baseUrl) {
+  const domain = extractDomain(baseUrl);
+  const metadata = { url: baseUrl, title: domain, domain };
+  const ogTitle = getMetaContent(html, "og:title");
+  const ogDescription = getMetaContent(html, "og:description");
+  const ogImage = getMetaContent(html, "og:image");
+  const ogUrl = getMetaContent(html, "og:url");
+  const twitterTitle = getMetaContent(html, "", "twitter:title");
+  const twitterDescription = getMetaContent(html, "", "twitter:description");
+  const twitterImage = getMetaContent(html, "", "twitter:image");
+  const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const descriptionMatch = html.match(
+    /<meta\s+name=["']description["']\s+content=["']([^"']+)["']/i
+  );
+  if (ogTitle) {
+    metadata.title = decodeHtmlEntity(ogTitle);
+  } else if (twitterTitle) {
+    metadata.title = decodeHtmlEntity(twitterTitle);
+  } else if (titleMatch?.[1]) {
+    metadata.title = decodeHtmlEntity(titleMatch[1].trim());
+  }
+  if (ogDescription) {
+    metadata.description = decodeHtmlEntity(ogDescription);
+  } else if (twitterDescription) {
+    metadata.description = decodeHtmlEntity(twitterDescription);
+  } else if (descriptionMatch?.[1]) {
+    metadata.description = decodeHtmlEntity(descriptionMatch[1].trim());
+  }
+  let imageUrl;
+  if (ogImage) {
+    imageUrl = ogImage;
+  } else if (twitterImage) {
+    imageUrl = twitterImage;
+  }
+  if (imageUrl) {
+    imageUrl = decodeHtmlEntity(imageUrl);
+    if (imageUrl.trim()) {
+      try {
+        metadata.image = new URL(imageUrl, baseUrl).toString();
+      } catch {
+        metadata.image = void 0;
+      }
+    }
+  }
+  if (ogUrl) {
+    try {
+      metadata.url = new URL(ogUrl, baseUrl).toString();
+    } catch {
+    }
+  }
+  return metadata;
+}
+async function fetchUrlMetadata(url) {
+  const targetUrl = new URL(url);
+  if (!["http:", "https:"].includes(targetUrl.protocol)) {
+    throw new Error("Only http and https URLs are allowed");
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 8e3);
+  try {
+    const response = await fetch(targetUrl.toString(), {
+      signal: controller.signal,
+      headers: {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "Accept-Language": "ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7"
+      },
+      redirect: "follow"
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch URL: ${response.status} ${response.statusText}`
+      );
+    }
+    const html = await response.text();
+    return parseMetaTags(html, targetUrl.toString());
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw error;
+  }
+}
+function jsonResponse(data, status = 200) {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+async function linkPreviewHandler(request) {
+  const { searchParams } = new URL(request.url);
+  const url = searchParams.get("url");
+  if (!url) {
+    return jsonResponse({ error: "url parameter is required" }, 400);
+  }
+  let targetUrl;
+  try {
+    targetUrl = new URL(url);
+    if (!["http:", "https:"].includes(targetUrl.protocol)) {
+      return jsonResponse(
+        { error: "Only http and https URLs are allowed" },
+        400
+      );
+    }
+  } catch {
+    return jsonResponse({ error: "Invalid URL format" }, 400);
+  }
+  try {
+    const metadata = await fetchUrlMetadata(targetUrl.toString());
+    return jsonResponse(metadata);
+  } catch (error) {
+    if (error.name === "AbortError") {
+      return jsonResponse({ error: "Request timeout" }, 408);
+    }
+    console.error("Error fetching link metadata:", error);
+    return jsonResponse({ error: "Failed to fetch link metadata" }, 500);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchUrlMetadata,
+  linkPreviewHandler,
+  parseMetaTags
+});
+//# sourceMappingURL=link-preview.js.map

package/dist/api/link-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/link-preview.ts"],"sourcesContent":["/**\r\n * @lumir-company/editor - Link Preview API Handler\r\n *\r\n * 서버 사이드 전용 모듈입니다. Next.js App Router, Remix, SvelteKit 등\r\n * Web API 표준(Request/Response)을 지원하는 프레임워크에서 사용할 수 있습니다.\r\n *\r\n * Next.js App Router 사용 예시:\r\n * ```ts\r\n * // src/app/api/link-preview/route.ts\r\n * export { GET } from \"@lumir-company/editor/api/link-preview\";\r\n * ```\r\n */\r\n\r\nexport interface LinkMetadata {\r\n  url: string;\r\n  title: string;\r\n  description?: string;\r\n  image?: string;\r\n  domain: string;\r\n}\r\n\r\nfunction extractDomain(url: string): string {\r\n  try {\r\n    return new URL(url).hostname.replace(/^www\\./, \"\");\r\n  } catch {\r\n    return url;\r\n  }\r\n}\r\n\r\nfunction decodeHtmlEntity(str: string): string {\r\n  return str\r\n    .replace(/&amp;/g, \"&\")\r\n    .replace(/&lt;/g, \"<\")\r\n    .replace(/&gt;/g, \">\")\r\n    .replace(/&quot;/g, '\"')\r\n    .replace(/&#39;/g, \"'\")\r\n    .replace(/&nbsp;/g, \" \")\r\n    .replace(/&#x27;/g, \"'\")\r\n    .replace(/&#x2F;/g, \"/\");\r\n}\r\n\r\nfunction getMetaContent(\r\n  html: string,\r\n  property: string,\r\n  name?: string\r\n): string | null {\r\n  const patterns = [\r\n    new RegExp(\r\n      `<meta\\\\s+property=[\"']${property}[\"']\\\\s+content=[\"']([^\"']+)[\"']`,\r\n      \"i\"\r\n    ),\r\n    new RegExp(\r\n      `<meta\\\\s+content=[\"']([^\"']+)[\"']\\\\s+property=[\"']${property}[\"']`,\r\n      \"i\"\r\n    ),\r\n  ];\r\n\r\n  if (name) {\r\n    patterns.push(\r\n      new RegExp(\r\n        `<meta\\\\s+name=[\"']${name}[\"']\\\\s+content=[\"']([^\"']+)[\"']`,\r\n        \"i\"\r\n      ),\r\n      new RegExp(\r\n        `<meta\\\\s+content=[\"']([^\"']+)[\"']\\\\s+name=[\"']${name}[\"']`,\r\n        \"i\"\r\n      )\r\n    );\r\n  }\r\n\r\n  for (const pattern of patterns) {\r\n    const match = html.match(pattern);\r\n    if (match?.[1]) return match[1].trim();\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * HTML 문자열에서 Open Graph / Twitter Card 메타데이터를 파싱합니다.\r\n * 커스텀 서버 구현 시 직접 사용할 수 있습니다.\r\n */\r\nexport function parseMetaTags(html: string, baseUrl: string): LinkMetadata {\r\n  const domain = extractDomain(baseUrl);\r\n  const metadata: LinkMetadata = { url: baseUrl, title: domain, domain };\r\n\r\n  const ogTitle = getMetaContent(html, \"og:title\");\r\n  const ogDescription = getMetaContent(html, \"og:description\");\r\n  const ogImage = getMetaContent(html, \"og:image\");\r\n  const ogUrl = getMetaContent(html, \"og:url\");\r\n\r\n  const twitterTitle = getMetaContent(html, \"\", \"twitter:title\");\r\n  const twitterDescription = getMetaContent(html, \"\", \"twitter:description\");\r\n  const twitterImage = getMetaContent(html, \"\", \"twitter:image\");\r\n\r\n  const titleMatch = html.match(/<title[^>]*>([^<]+)<\\/title>/i);\r\n  const descriptionMatch = html.match(\r\n    /<meta\\s+name=[\"']description[\"']\\s+content=[\"']([^\"']+)[\"']/i\r\n  );\r\n\r\n  if (ogTitle) {\r\n    metadata.title = decodeHtmlEntity(ogTitle);\r\n  } else if (twitterTitle) {\r\n    metadata.title = decodeHtmlEntity(twitterTitle);\r\n  } else if (titleMatch?.[1]) {\r\n    metadata.title = decodeHtmlEntity(titleMatch[1].trim());\r\n  }\r\n\r\n  if (ogDescription) {\r\n    metadata.description = decodeHtmlEntity(ogDescription);\r\n  } else if (twitterDescription) {\r\n    metadata.description = decodeHtmlEntity(twitterDescription);\r\n  } else if (descriptionMatch?.[1]) {\r\n    metadata.description = decodeHtmlEntity(descriptionMatch[1].trim());\r\n  }\r\n\r\n  let imageUrl: string | undefined;\r\n  if (ogImage) {\r\n    imageUrl = ogImage;\r\n  } else if (twitterImage) {\r\n    imageUrl = twitterImage;\r\n  }\r\n\r\n  if (imageUrl) {\r\n    imageUrl = decodeHtmlEntity(imageUrl);\r\n    if (imageUrl.trim()) {\r\n      try {\r\n        metadata.image = new URL(imageUrl, baseUrl).toString();\r\n      } catch {\r\n        metadata.image = undefined;\r\n      }\r\n    }\r\n  }\r\n\r\n  if (ogUrl) {\r\n    try {\r\n      metadata.url = new URL(ogUrl, baseUrl).toString();\r\n    } catch {\r\n      // keep original URL\r\n    }\r\n  }\r\n\r\n  return metadata;\r\n}\r\n\r\n/**\r\n * URL에서 메타데이터를 가져옵니다 (서버 사이드 전용).\r\n * Express, Fastify 등 커스텀 서버에서 직접 사용할 수 있습니다.\r\n */\r\nexport async function fetchUrlMetadata(url: string): Promise<LinkMetadata> {\r\n  const targetUrl = new URL(url);\r\n  if (![\"http:\", \"https:\"].includes(targetUrl.protocol)) {\r\n    throw new Error(\"Only http and https URLs are allowed\");\r\n  }\r\n\r\n  const controller = new AbortController();\r\n  const timeoutId = setTimeout(() => controller.abort(), 8000);\r\n\r\n  try {\r\n    const response = await fetch(targetUrl.toString(), {\r\n      signal: controller.signal,\r\n      headers: {\r\n        \"User-Agent\":\r\n          \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\r\n        Accept:\r\n          \"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\r\n        \"Accept-Language\": \"ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7\",\r\n      },\r\n      redirect: \"follow\",\r\n    });\r\n\r\n    clearTimeout(timeoutId);\r\n\r\n    if (!response.ok) {\r\n      throw new Error(\r\n        `Failed to fetch URL: ${response.status} ${response.statusText}`\r\n      );\r\n    }\r\n\r\n    const html = await response.text();\r\n    return parseMetaTags(html, targetUrl.toString());\r\n  } catch (error) {\r\n    clearTimeout(timeoutId);\r\n    throw error;\r\n  }\r\n}\r\n\r\nfunction jsonResponse(data: unknown, status = 200): Response {\r\n  return new Response(JSON.stringify(data), {\r\n    status,\r\n    headers: { \"Content-Type\": \"application/json\" },\r\n  });\r\n}\r\n\r\n/**\r\n * 링크 프리뷰 메타데이터 조회 핸들러 (Web API 표준 Request/Response).\r\n * Next.js App Router, Remix, SvelteKit 등에서 re-export하여 사용합니다.\r\n *\r\n * @example\r\n * // Next.js: src/app/api/link-preview/route.ts\r\n * export { linkPreviewHandler as GET } from \"@lumir-company/editor/api/link-preview\";\r\n */\r\nexport async function linkPreviewHandler(request: Request): Promise<Response> {\r\n  const { searchParams } = new URL(request.url);\r\n  const url = searchParams.get(\"url\");\r\n\r\n  if (!url) {\r\n    return jsonResponse({ error: \"url parameter is required\" }, 400);\r\n  }\r\n\r\n  let targetUrl: URL;\r\n  try {\r\n    targetUrl = new URL(url);\r\n    if (![\"http:\", \"https:\"].includes(targetUrl.protocol)) {\r\n      return jsonResponse(\r\n        { error: \"Only http and https URLs are allowed\" },\r\n        400\r\n      );\r\n    }\r\n  } catch {\r\n    return jsonResponse({ error: \"Invalid URL format\" }, 400);\r\n  }\r\n\r\n  try {\r\n    const metadata = await fetchUrlMetadata(targetUrl.toString());\r\n    return jsonResponse(metadata);\r\n  } catch (error: any) {\r\n    if (error.name === \"AbortError\") {\r\n      return jsonResponse({ error: \"Request timeout\" }, 408);\r\n    }\r\n\r\n    console.error(\"Error fetching link metadata:\", error);\r\n    return jsonResponse({ error: \"Failed to fetch link metadata\" }, 500);\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/api/link-preview.mjs

@@ -0,0 +1,163 @@
+// src/api/link-preview.ts
+function extractDomain(url) {
+  try {
+    return new URL(url).hostname.replace(/^www\./, "");
+  } catch {
+    return url;
+  }
+}
+function decodeHtmlEntity(str) {
+  return str.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&nbsp;/g, " ").replace(/&#x27;/g, "'").replace(/&#x2F;/g, "/");
+}
+function getMetaContent(html, property, name) {
+  const patterns = [
+    new RegExp(
+      `<meta\\s+property=["']${property}["']\\s+content=["']([^"']+)["']`,
+      "i"
+    ),
+    new RegExp(
+      `<meta\\s+content=["']([^"']+)["']\\s+property=["']${property}["']`,
+      "i"
+    )
+  ];
+  if (name) {
+    patterns.push(
+      new RegExp(
+        `<meta\\s+name=["']${name}["']\\s+content=["']([^"']+)["']`,
+        "i"
+      ),
+      new RegExp(
+        `<meta\\s+content=["']([^"']+)["']\\s+name=["']${name}["']`,
+        "i"
+      )
+    );
+  }
+  for (const pattern of patterns) {
+    const match = html.match(pattern);
+    if (match?.[1]) return match[1].trim();
+  }
+  return null;
+}
+function parseMetaTags(html, baseUrl) {
+  const domain = extractDomain(baseUrl);
+  const metadata = { url: baseUrl, title: domain, domain };
+  const ogTitle = getMetaContent(html, "og:title");
+  const ogDescription = getMetaContent(html, "og:description");
+  const ogImage = getMetaContent(html, "og:image");
+  const ogUrl = getMetaContent(html, "og:url");
+  const twitterTitle = getMetaContent(html, "", "twitter:title");
+  const twitterDescription = getMetaContent(html, "", "twitter:description");
+  const twitterImage = getMetaContent(html, "", "twitter:image");
+  const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
+  const descriptionMatch = html.match(
+    /<meta\s+name=["']description["']\s+content=["']([^"']+)["']/i
+  );
+  if (ogTitle) {
+    metadata.title = decodeHtmlEntity(ogTitle);
+  } else if (twitterTitle) {
+    metadata.title = decodeHtmlEntity(twitterTitle);
+  } else if (titleMatch?.[1]) {
+    metadata.title = decodeHtmlEntity(titleMatch[1].trim());
+  }
+  if (ogDescription) {
+    metadata.description = decodeHtmlEntity(ogDescription);
+  } else if (twitterDescription) {
+    metadata.description = decodeHtmlEntity(twitterDescription);
+  } else if (descriptionMatch?.[1]) {
+    metadata.description = decodeHtmlEntity(descriptionMatch[1].trim());
+  }
+  let imageUrl;
+  if (ogImage) {
+    imageUrl = ogImage;
+  } else if (twitterImage) {
+    imageUrl = twitterImage;
+  }
+  if (imageUrl) {
+    imageUrl = decodeHtmlEntity(imageUrl);
+    if (imageUrl.trim()) {
+      try {
+        metadata.image = new URL(imageUrl, baseUrl).toString();
+      } catch {
+        metadata.image = void 0;
+      }
+    }
+  }
+  if (ogUrl) {
+    try {
+      metadata.url = new URL(ogUrl, baseUrl).toString();
+    } catch {
+    }
+  }
+  return metadata;
+}
+async function fetchUrlMetadata(url) {
+  const targetUrl = new URL(url);
+  if (!["http:", "https:"].includes(targetUrl.protocol)) {
+    throw new Error("Only http and https URLs are allowed");
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 8e3);
+  try {
+    const response = await fetch(targetUrl.toString(), {
+      signal: controller.signal,
+      headers: {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        "Accept-Language": "ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7"
+      },
+      redirect: "follow"
+    });
+    clearTimeout(timeoutId);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch URL: ${response.status} ${response.statusText}`
+      );
+    }
+    const html = await response.text();
+    return parseMetaTags(html, targetUrl.toString());
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw error;
+  }
+}
+function jsonResponse(data, status = 200) {
+  return new Response(JSON.stringify(data), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+async function linkPreviewHandler(request) {
+  const { searchParams } = new URL(request.url);
+  const url = searchParams.get("url");
+  if (!url) {
+    return jsonResponse({ error: "url parameter is required" }, 400);
+  }
+  let targetUrl;
+  try {
+    targetUrl = new URL(url);
+    if (!["http:", "https:"].includes(targetUrl.protocol)) {
+      return jsonResponse(
+        { error: "Only http and https URLs are allowed" },
+        400
+      );
+    }
+  } catch {
+    return jsonResponse({ error: "Invalid URL format" }, 400);
+  }
+  try {
+    const metadata = await fetchUrlMetadata(targetUrl.toString());
+    return jsonResponse(metadata);
+  } catch (error) {
+    if (error.name === "AbortError") {
+      return jsonResponse({ error: "Request timeout" }, 408);
+    }
+    console.error("Error fetching link metadata:", error);
+    return jsonResponse({ error: "Failed to fetch link metadata" }, 500);
+  }
+}
+export {
+  fetchUrlMetadata,
+  linkPreviewHandler,
+  parseMetaTags
+};
+//# sourceMappingURL=link-preview.mjs.map

package/dist/api/link-preview.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/link-preview.ts"],"sourcesContent":["/**\r\n * @lumir-company/editor - Link Preview API Handler\r\n *\r\n * 서버 사이드 전용 모듈입니다. Next.js App Router, Remix, SvelteKit 등\r\n * Web API 표준(Request/Response)을 지원하는 프레임워크에서 사용할 수 있습니다.\r\n *\r\n * Next.js App Router 사용 예시:\r\n * ```ts\r\n * // src/app/api/link-preview/route.ts\r\n * export { GET } from \"@lumir-company/editor/api/link-preview\";\r\n * ```\r\n */\r\n\r\nexport interface LinkMetadata {\r\n  url: string;\r\n  title: string;\r\n  description?: string;\r\n  image?: string;\r\n  domain: string;\r\n}\r\n\r\nfunction extractDomain(url: string): string {\r\n  try {\r\n    return new URL(url).hostname.replace(/^www\\./, \"\");\r\n  } catch {\r\n    return url;\r\n  }\r\n}\r\n\r\nfunction decodeHtmlEntity(str: string): string {\r\n  return str\r\n    .replace(/&amp;/g, \"&\")\r\n    .replace(/&lt;/g, \"<\")\r\n    .replace(/&gt;/g, \">\")\r\n    .replace(/&quot;/g, '\"')\r\n    .replace(/&#39;/g, \"'\")\r\n    .replace(/&nbsp;/g, \" \")\r\n    .replace(/&#x27;/g, \"'\")\r\n    .replace(/&#x2F;/g, \"/\");\r\n}\r\n\r\nfunction getMetaContent(\r\n  html: string,\r\n  property: string,\r\n  name?: string\r\n): string | null {\r\n  const patterns = [\r\n    new RegExp(\r\n      `<meta\\\\s+property=[\"']${property}[\"']\\\\s+content=[\"']([^\"']+)[\"']`,\r\n      \"i\"\r\n    ),\r\n    new RegExp(\r\n      `<meta\\\\s+content=[\"']([^\"']+)[\"']\\\\s+property=[\"']${property}[\"']`,\r\n      \"i\"\r\n    ),\r\n  ];\r\n\r\n  if (name) {\r\n    patterns.push(\r\n      new RegExp(\r\n        `<meta\\\\s+name=[\"']${name}[\"']\\\\s+content=[\"']([^\"']+)[\"']`,\r\n        \"i\"\r\n      ),\r\n      new RegExp(\r\n        `<meta\\\\s+content=[\"']([^\"']+)[\"']\\\\s+name=[\"']${name}[\"']`,\r\n        \"i\"\r\n      )\r\n    );\r\n  }\r\n\r\n  for (const pattern of patterns) {\r\n    const match = html.match(pattern);\r\n    if (match?.[1]) return match[1].trim();\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * HTML 문자열에서 Open Graph / Twitter Card 메타데이터를 파싱합니다.\r\n * 커스텀 서버 구현 시 직접 사용할 수 있습니다.\r\n */\r\nexport function parseMetaTags(html: string, baseUrl: string): LinkMetadata {\r\n  const domain = extractDomain(baseUrl);\r\n  const metadata: LinkMetadata = { url: baseUrl, title: domain, domain };\r\n\r\n  const ogTitle = getMetaContent(html, \"og:title\");\r\n  const ogDescription = getMetaContent(html, \"og:description\");\r\n  const ogImage = getMetaContent(html, \"og:image\");\r\n  const ogUrl = getMetaContent(html, \"og:url\");\r\n\r\n  const twitterTitle = getMetaContent(html, \"\", \"twitter:title\");\r\n  const twitterDescription = getMetaContent(html, \"\", \"twitter:description\");\r\n  const twitterImage = getMetaContent(html, \"\", \"twitter:image\");\r\n\r\n  const titleMatch = html.match(/<title[^>]*>([^<]+)<\\/title>/i);\r\n  const descriptionMatch = html.match(\r\n    /<meta\\s+name=[\"']description[\"']\\s+content=[\"']([^\"']+)[\"']/i\r\n  );\r\n\r\n  if (ogTitle) {\r\n    metadata.title = decodeHtmlEntity(ogTitle);\r\n  } else if (twitterTitle) {\r\n    metadata.title = decodeHtmlEntity(twitterTitle);\r\n  } else if (titleMatch?.[1]) {\r\n    metadata.title = decodeHtmlEntity(titleMatch[1].trim());\r\n  }\r\n\r\n  if (ogDescription) {\r\n    metadata.description = decodeHtmlEntity(ogDescription);\r\n  } else if (twitterDescription) {\r\n    metadata.description = decodeHtmlEntity(twitterDescription);\r\n  } else if (descriptionMatch?.[1]) {\r\n    metadata.description = decodeHtmlEntity(descriptionMatch[1].trim());\r\n  }\r\n\r\n  let imageUrl: string | undefined;\r\n  if (ogImage) {\r\n    imageUrl = ogImage;\r\n  } else if (twitterImage) {\r\n    imageUrl = twitterImage;\r\n  }\r\n\r\n  if (imageUrl) {\r\n    imageUrl = decodeHtmlEntity(imageUrl);\r\n    if (imageUrl.trim()) {\r\n      try {\r\n        metadata.image = new URL(imageUrl, baseUrl).toString();\r\n      } catch {\r\n        metadata.image = undefined;\r\n      }\r\n    }\r\n  }\r\n\r\n  if (ogUrl) {\r\n    try {\r\n      metadata.url = new URL(ogUrl, baseUrl).toString();\r\n    } catch {\r\n      // keep original URL\r\n    }\r\n  }\r\n\r\n  return metadata;\r\n}\r\n\r\n/**\r\n * URL에서 메타데이터를 가져옵니다 (서버 사이드 전용).\r\n * Express, Fastify 등 커스텀 서버에서 직접 사용할 수 있습니다.\r\n */\r\nexport async function fetchUrlMetadata(url: string): Promise<LinkMetadata> {\r\n  const targetUrl = new URL(url);\r\n  if (![\"http:\", \"https:\"].includes(targetUrl.protocol)) {\r\n    throw new Error(\"Only http and https URLs are allowed\");\r\n  }\r\n\r\n  const controller = new AbortController();\r\n  const timeoutId = setTimeout(() => controller.abort(), 8000);\r\n\r\n  try {\r\n    const response = await fetch(targetUrl.toString(), {\r\n      signal: controller.signal,\r\n      headers: {\r\n        \"User-Agent\":\r\n          \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\r\n        Accept:\r\n          \"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\r\n        \"Accept-Language\": \"ko-KR,ko;q=0.9,en-US;q=0.8,en;q=0.7\",\r\n      },\r\n      redirect: \"follow\",\r\n    });\r\n\r\n    clearTimeout(timeoutId);\r\n\r\n    if (!response.ok) {\r\n      throw new Error(\r\n        `Failed to fetch URL: ${response.status} ${response.statusText}`\r\n      );\r\n    }\r\n\r\n    const html = await response.text();\r\n    return parseMetaTags(html, targetUrl.toString());\r\n  } catch (error) {\r\n    clearTimeout(timeoutId);\r\n    throw error;\r\n  }\r\n}\r\n\r\nfunction jsonResponse(data: unknown, status = 200): Response {\r\n  return new Response(JSON.stringify(data), {\r\n    status,\r\n    headers: { \"Content-Type\": \"application/json\" },\r\n  });\r\n}\r\n\r\n/**\r\n * 링크 프리뷰 메타데이터 조회 핸들러 (Web API 표준 Request/Response).\r\n * Next.js App Router, Remix, SvelteKit 등에서 re-export하여 사용합니다.\r\n *\r\n * @example\r\n * // Next.js: src/app/api/link-preview/route.ts\r\n * export { linkPreviewHandler as GET } from \"@lumir-company/editor/api/link-preview\";\r\n */\r\nexport async function linkPreviewHandler(request: Request): Promise<Response> {\r\n  const { searchParams } = new URL(request.url);\r\n  const url = searchParams.get(\"url\");\r\n\r\n  if (!url) {\r\n    return jsonResponse({ error: \"url parameter is required\" }, 400);\r\n  }\r\n\r\n  let targetUrl: URL;\r\n  try {\r\n    targetUrl = new URL(url);\r\n    if (![\"http:\", \"https:\"].includes(targetUrl.protocol)) {\r\n      return jsonResponse(\r\n        { error: \"Only http and https URLs are allowed\" },\r\n        400\r\n      );\r\n    }\r\n  } catch {\r\n    return jsonResponse({ error: \"Invalid URL format\" }, 400);\r\n  }\r\n\r\n  try {\r\n    const metadata = await fetchUrlMetadata(targetUrl.toString());\r\n    return jsonResponse(metadata);\r\n  } catch (error: any) {\r\n    if (error.name === \"AbortError\") {\r\n      return jsonResponse({ error: \"Request timeout\" }, 408);\r\n    }\r\n\r\n    console.error(\"Error fetching link metadata:\", error);\r\n    return jsonResponse({ error: \"Failed to fetch link metadata\" }, 500);\r\n  }\r\n}\r\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -39,8 +39,9 @@ declare class LumirEditorError extends Error {
     static uploadFailed(message: string, originalError?: Error): LumirEditorError;
     /**
      * 잘못된 파일 형식 에러 생성
+     * @param allowVideoUpload true이면 "image and video" 메시지 사용
      */
-    static invalidFileType(fileName: string): LumirEditorError;
+    static invalidFileType(fileName: string, allowVideoUpload?: boolean): LumirEditorError;
     /**
      * S3 설정 에러 생성
      */
@@ -77,6 +78,12 @@ interface LumirEditorProps {
         appendUUID?: boolean;
         /** false로 설정하면 확장자를 자동으로 붙이지 않음 (기본: true) */
         preserveExtension?: boolean;
+        /** 업로드 진행률(0–100) 콜백. S3 PUT 시에만 호출됨 */
+        onProgress?: (percent: number) => void;
+        /** PUT 요청 타임아웃(ms). 미설정 시 120000(120초). 대용량 비디오에 유리 */
+        uploadTimeoutMs?: number;
+        /** PUT 실패 시 재시도 횟수. 기본 2(최대 3회 시도) */
+        maxRetries?: number;
     };
     allowVideoUpload?: boolean;
     allowAudioUpload?: boolean;
@@ -118,10 +125,11 @@ interface LumirEditorProps {
     /** 에러 발생 시 호출되는 콜백 */
     onError?: (error: LumirEditorError) => void;
     /**
-     * 이미지가 에디터에서 삭제될 때 호출되는 콜백
-     * - S3 등 외부 스토리지에서 이미지를 삭제하는 용도로 사용
+     * 이미지·비디오(미디어)가 에디터에서 삭제될 때 호출되는 콜백
+     * - S3 등 외부 스토리지에서 해당 미디어를 삭제하는 용도로 사용
+     * - 이미지 블록과 비디오 블록 삭제 시 모두 호출됨
      * - Undo/Redo를 고려하여 지연 삭제를 권장
-     * @param imageUrl 삭제된 이미지의 URL
+     * @param imageUrl 삭제된 이미지 또는 비디오의 URL
      */
     onImageDelete?: (imageUrl: string) => void;
 }
@@ -210,6 +218,12 @@ interface S3UploaderConfig {
     appendUUID?: boolean;
     /** false로 설정하면 확장자를 자동으로 붙이지 않음 (기본: true) */
     preserveExtension?: boolean;
+    /** 업로드 진행률(0–100) 콜백. S3 PUT 시에만 호출됨 */
+    onProgress?: (percent: number) => void;
+    /** PUT 요청 타임아웃(ms). 미설정 시 120000(120초). 대용량 비디오에 유리 */
+    uploadTimeoutMs?: number;
+    /** PUT 실패 시 재시도 횟수. 기본 2(최대 3회 시도) */
+    maxRetries?: number;
 }
 declare const createS3Uploader: (config: S3UploaderConfig) => (file: File) => Promise<string>;
 

package/dist/index.d.ts

@@ -39,8 +39,9 @@ declare class LumirEditorError extends Error {
     static uploadFailed(message: string, originalError?: Error): LumirEditorError;
     /**
      * 잘못된 파일 형식 에러 생성
+     * @param allowVideoUpload true이면 "image and video" 메시지 사용
      */
-    static invalidFileType(fileName: string): LumirEditorError;
+    static invalidFileType(fileName: string, allowVideoUpload?: boolean): LumirEditorError;
     /**
      * S3 설정 에러 생성
      */
@@ -77,6 +78,12 @@ interface LumirEditorProps {
         appendUUID?: boolean;
         /** false로 설정하면 확장자를 자동으로 붙이지 않음 (기본: true) */
         preserveExtension?: boolean;
+        /** 업로드 진행률(0–100) 콜백. S3 PUT 시에만 호출됨 */
+        onProgress?: (percent: number) => void;
+        /** PUT 요청 타임아웃(ms). 미설정 시 120000(120초). 대용량 비디오에 유리 */
+        uploadTimeoutMs?: number;
+        /** PUT 실패 시 재시도 횟수. 기본 2(최대 3회 시도) */
+        maxRetries?: number;
     };
     allowVideoUpload?: boolean;
     allowAudioUpload?: boolean;
@@ -118,10 +125,11 @@ interface LumirEditorProps {
     /** 에러 발생 시 호출되는 콜백 */
     onError?: (error: LumirEditorError) => void;
     /**
-     * 이미지가 에디터에서 삭제될 때 호출되는 콜백
-     * - S3 등 외부 스토리지에서 이미지를 삭제하는 용도로 사용
+     * 이미지·비디오(미디어)가 에디터에서 삭제될 때 호출되는 콜백
+     * - S3 등 외부 스토리지에서 해당 미디어를 삭제하는 용도로 사용
+     * - 이미지 블록과 비디오 블록 삭제 시 모두 호출됨
      * - Undo/Redo를 고려하여 지연 삭제를 권장
-     * @param imageUrl 삭제된 이미지의 URL
+     * @param imageUrl 삭제된 이미지 또는 비디오의 URL
      */
     onImageDelete?: (imageUrl: string) => void;
 }
@@ -210,6 +218,12 @@ interface S3UploaderConfig {
     appendUUID?: boolean;
     /** false로 설정하면 확장자를 자동으로 붙이지 않음 (기본: true) */
     preserveExtension?: boolean;
+    /** 업로드 진행률(0–100) 콜백. S3 PUT 시에만 호출됨 */
+    onProgress?: (percent: number) => void;
+    /** PUT 요청 타임아웃(ms). 미설정 시 120000(120초). 대용량 비디오에 유리 */
+    uploadTimeoutMs?: number;
+    /** PUT 실패 시 재시도 횟수. 기본 2(최대 3회 시도) */
+    maxRetries?: number;
 }
 declare const createS3Uploader: (config: S3UploaderConfig) => (file: File) => Promise<string>;