@owp/core 2.5.5 → 2.5.6

package/dist/types/utils/zipUtil.d.ts

@@ -8,6 +8,7 @@ export interface SaveAsZipFileOptions {
     fileTitle?: string;
     archiveExtension?: string;
     appendDatetime?: boolean;
+    preserveFileNames?: boolean;
 }
 /**
  * ZIP 엔트리 텍스트 로드

package/dist/utils/zipUtil.js

@@ -1,69 +1,71 @@
-var E = Object.defineProperty;
-var i = (e, t) => E(e, "name", { value: t, configurable: !0 });
-import d from "dayjs";
-import { t as m } from "i18next";
-import { enqueueSnackbar as x } from "notistack";
-import { loadJSZip as u } from "./jszipBrowser.js";
+var y = Object.defineProperty;
+var i = (e, t) => y(e, "name", { value: t, configurable: !0 });
+import v from "dayjs";
+import { t as E } from "i18next";
+import { enqueueSnackbar as d } from "notistack";
+import { loadJSZip as m } from "./jszipBrowser.js";
 const l = {
   type: "pdf",
   fileExtension: "application/pdf",
   fileTitle: "archive",
   archiveExtension: "zip",
-  appendDatetime: !1
-}, y = /* @__PURE__ */ i((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "_"), "sanitizeFileName"), s = /* @__PURE__ */ i((e) => {
-  x(
-    m(`Message.${e}`, {
+  appendDatetime: !1,
+  preserveFileNames: !1
+}, u = /* @__PURE__ */ i((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "_"), "sanitizeFileName"), f = /* @__PURE__ */ i((e) => {
+  d(
+    E(`Message.${e}`, {
       defaultValue: e
     }),
     { variant: "warning" }
   );
-}, "showZipWarning"), o = /* @__PURE__ */ i((e) => ({
+}, "showZipWarning"), x = /* @__PURE__ */ i((e) => ({
   type: (e == null ? void 0 : e.type) ?? l.type,
   fileExtension: (e == null ? void 0 : e.fileExtension) ?? l.fileExtension,
   fileTitle: (e == null ? void 0 : e.fileTitle) ?? l.fileTitle,
   archiveExtension: (e == null ? void 0 : e.archiveExtension) ?? l.archiveExtension,
-  appendDatetime: (e == null ? void 0 : e.appendDatetime) ?? l.appendDatetime
-}), "normalizeZipOptions"), v = /* @__PURE__ */ i((e, t, n) => `${y(`${e + 1}_${t}`)}.${n}`, "createZipEntryFileName"), Z = /* @__PURE__ */ i((e) => e.replace(/^\.+/, "") || l.archiveExtension, "normalizeArchiveExtension"), w = /* @__PURE__ */ i((e, t, n) => `${y(e)}${t ? `-${d().format("YYYY_MM_DD_HH_mm_ss")}` : ""}.${Z(n)}`, "createArchiveFileName"), h = /* @__PURE__ */ i((e, t) => typeof t == "string" ? e === t : t instanceof RegExp ? t.test(e) : t(e), "isMatchedZipEntry"), $ = /* @__PURE__ */ i(async (e) => e instanceof Blob ? e.arrayBuffer() : e, "toZipArrayBuffer"), _ = /* @__PURE__ */ i(async (e, t) => {
-  const a = await (await u()).loadAsync(await $(e)), r = Object.values(a.files).find(
+  appendDatetime: (e == null ? void 0 : e.appendDatetime) ?? l.appendDatetime,
+  preserveFileNames: (e == null ? void 0 : e.preserveFileNames) ?? l.preserveFileNames
+}), "normalizeZipOptions"), F = /* @__PURE__ */ i((e, t, r) => `${u(`${e + 1}_${t}`)}.${r}`, "createZipEntryFileName"), Z = /* @__PURE__ */ i((e) => e.replace(/^\.+/, "") || l.archiveExtension, "normalizeArchiveExtension"), w = /* @__PURE__ */ i((e, t, r) => `${u(e)}${t ? `-${v().format("YYYY_MM_DD_HH_mm_ss")}` : ""}.${Z(r)}`, "createArchiveFileName"), h = /* @__PURE__ */ i((e, t) => typeof t == "string" ? e === t : t instanceof RegExp ? t.test(e) : t(e), "isMatchedZipEntry"), N = /* @__PURE__ */ i(async (e) => e instanceof Blob ? e.arrayBuffer() : e, "toZipArrayBuffer"), $ = /* @__PURE__ */ i(async (e, t) => {
+  const a = await (await m()).loadAsync(await N(e)), n = Object.values(a.files).find(
     (c) => !c.dir && h(c.name, t)
   );
-  return r ? r.async("string") : null;
+  return n ? n.async("string") : null;
 }, "readZipEntryText"), A = /* @__PURE__ */ i(async (e, t) => {
-  const n = await _(e, t);
-  return n ? JSON.parse(n) : null;
-}, "readZipEntryJson"), z = /* @__PURE__ */ i((e, t, n) => {
-  t.forEach(({ blob: a, fileName: r }, c) => {
+  const r = await $(e, t);
+  return r ? JSON.parse(r) : null;
+}, "readZipEntryJson"), _ = /* @__PURE__ */ i((e, t, r) => {
+  t.forEach(({ blob: a, fileName: n }, c) => {
     a && e.file(
-      v(c, r, n.fileExtension),
-      new Blob([a], { type: n.type })
+      r.preserveFileNames ? n : F(c, n, r.fileExtension),
+      r.preserveFileNames ? a : new Blob([a], { type: r.type })
     );
   });
 }, "appendZipFiles"), S = /* @__PURE__ */ i(async (e, t) => {
-  const n = o(t);
-  if (!n.type) {
-    s("type 이 선언되지 않았습니다");
+  const r = x(t);
+  if (!r.preserveFileNames && !r.type) {
+    f("type 이 선언되지 않았습니다");
     return;
   }
-  if (!n.fileExtension) {
-    s("파일 확장자가 선언되지 않았습니다");
+  if (!r.preserveFileNames && !r.fileExtension) {
+    f("파일 확장자가 선언되지 않았습니다");
     return;
   }
   if (!e) {
-    s("다운로드할 데이터가 없습니다");
+    f("다운로드할 데이터가 없습니다");
     return;
   }
-  const a = await u(), r = new a();
-  z(r, e, n);
-  const c = await r.generateAsync({ type: "blob" }), p = URL.createObjectURL(c), f = document.createElement("a");
-  f.href = p, f.download = w(
-    n.fileTitle,
-    n.appendDatetime,
-    n.archiveExtension
-  ), f.click(), URL.revokeObjectURL(p);
+  const a = await m(), n = new a();
+  _(n, e, r);
+  const c = await n.generateAsync({ type: "blob" }), p = URL.createObjectURL(c), s = document.createElement("a");
+  s.href = p, s.download = w(
+    r.fileTitle,
+    r.appendDatetime,
+    r.archiveExtension
+  ), s.click(), URL.revokeObjectURL(p);
 }, "saveAsZipFile");
 export {
   A as readZipEntryJson,
-  _ as readZipEntryText,
+  $ as readZipEntryText,
   S as saveAsZipFile
 };
 //# sourceMappingURL=zipUtil.js.map

package/dist/utils/zipUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"zipUtil.js","sources":["../../src/utils/zipUtil.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport { t } from 'i18next';\nimport type JSZip from 'jszip';\nimport { enqueueSnackbar } from 'notistack';\nimport { loadJSZip } from './jszipBrowser';\n\ntype BlobInfoData = {\n  blob: Blob;\n  fileName: string;\n};\n\nexport interface SaveAsZipFileOptions {\n  type?: string;\n  fileExtension?: string;\n  fileTitle?: string;\n  archiveExtension?: string;\n  appendDatetime?: boolean;\n}\n\nconst DEFAULT_ZIP_OPTIONS: Required<SaveAsZipFileOptions> = {\n  type: 'pdf',\n  fileExtension: 'application/pdf',\n  fileTitle: 'archive',\n  archiveExtension: 'zip',\n  appendDatetime: false,\n};\n\n/**\n * 파일명 안전 문자 변환\n * @param fileName 원본 파일명\n */\nconst sanitizeFileName = (fileName: string) => fileName.replace(/[.*+?^${}()|[\\]\\\\]/g, '_');\n\n/**\n * ZIP 경고 메시지 출력\n * @param message 경고 메시지\n */\nconst showZipWarning = (message: string) => {\n  enqueueSnackbar(\n    t(`Message.${message}`, {\n      defaultValue: message,\n    }),\n    { variant: 'warning' },\n  );\n};\n\n/**\n * ZIP 저장 옵션 정규화\n * @param options 저장 옵션\n */\nconst normalizeZipOptions = (options?: SaveAsZipFileOptions) => {\n  return {\n    type: options?.type ?? DEFAULT_ZIP_OPTIONS.type,\n    fileExtension: options?.fileExtension ?? DEFAULT_ZIP_OPTIONS.fileExtension,\n    fileTitle: options?.fileTitle ?? DEFAULT_ZIP_OPTIONS.fileTitle,\n    archiveExtension: options?.archiveExtension ?? DEFAULT_ZIP_OPTIONS.archiveExtension,\n    appendDatetime: options?.appendDatetime ?? DEFAULT_ZIP_OPTIONS.appendDatetime,\n  };\n};\n\n/**\n * ZIP 내부 파일명 생성\n * @param index 파일 순서\n * @param fileName 파일명\n * @param fileExtension 파일 확장자\n */\nconst createZipEntryFileName = (index: number, fileName: string, fileExtension: string) => {\n  return `${sanitizeFileName(`${index + 1}_${fileName}`)}.${fileExtension}`;\n};\n\n/**\n * ZIP 다운로드 파일명 생성\n * @param fileTitle 파일 제목\n * @param appendDatetime 일시 추가 여부\n */\nconst normalizeArchiveExtension = (archiveExtension: string) => {\n  return archiveExtension.replace(/^\\.+/, '') || DEFAULT_ZIP_OPTIONS.archiveExtension;\n};\n\n/**\n * ZIP 다운로드 파일명 생성\n * @param fileTitle 파일 제목\n * @param appendDatetime 일시 추가 여부\n * @param archiveExtension 아카이브 확장자\n */\nconst createArchiveFileName = (\n  fileTitle: string,\n  appendDatetime: boolean,\n  archiveExtension: string,\n) => {\n  return `${sanitizeFileName(fileTitle)}${appendDatetime ? `-${dayjs().format('YYYY_MM_DD_HH_mm_ss')}` : ''}.${normalizeArchiveExtension(archiveExtension)}`;\n};\n\n/**\n * ZIP 엔트리 일치 여부 확인\n * @param fileName ZIP 엔트리 파일명\n * @param matcher 엔트리 식별자\n */\nconst isMatchedZipEntry = (\n  fileName: string,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n) => {\n  if (typeof matcher === 'string') {\n    return fileName === matcher;\n  }\n\n  if (matcher instanceof RegExp) {\n    return matcher.test(fileName);\n  }\n\n  return matcher(fileName);\n};\n\n/**\n * ZIP 소스 ArrayBuffer 변환\n * @param source ZIP 소스\n */\nconst toZipArrayBuffer = async (source: Blob | ArrayBuffer) => {\n  return source instanceof Blob ? source.arrayBuffer() : source;\n};\n\n/**\n * ZIP 엔트리 텍스트 로드\n * @param source ZIP 소스\n * @param matcher 엔트리 식별자\n */\nexport const readZipEntryText = async (\n  source: Blob | ArrayBuffer,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n): Promise<string | null> => {\n  const JSZip = await loadJSZip();\n  const zip = await JSZip.loadAsync(await toZipArrayBuffer(source));\n  const zipFile = Object.values(zip.files).find(\n    (entry) => !entry.dir && isMatchedZipEntry(entry.name, matcher),\n  );\n\n  if (!zipFile) {\n    return null;\n  }\n\n  return zipFile.async('string');\n};\n\n/**\n * ZIP 엔트리 JSON 로드\n * @param source ZIP 소스\n * @param matcher 엔트리 식별자\n */\nexport const readZipEntryJson = async <T>(\n  source: Blob | ArrayBuffer,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n): Promise<T | null> => {\n  const text = await readZipEntryText(source, matcher);\n\n  if (!text) {\n    return null;\n  }\n\n  return JSON.parse(text) as T;\n};\n\n/**\n * ZIP 파일 데이터 추가\n * @param zip ZIP 인스턴스\n * @param data 파일 데이터 목록\n * @param options ZIP 저장 옵션\n */\nconst appendZipFiles = (\n  zip: JSZip,\n  data: BlobInfoData[],\n  options: Required<SaveAsZipFileOptions>,\n) => {\n  data.forEach(({ blob, fileName }, index) => {\n    if (!blob) {\n      return;\n    }\n\n    zip.file(\n      createZipEntryFileName(index, fileName, options.fileExtension),\n      new Blob([blob], { type: options.type }),\n    );\n  });\n};\n\n/**\n * ZIP 파일 저장\n * @param data 저장할 파일 데이터\n * @param options 저장 옵션\n */\nexport const saveAsZipFile = async (\n  data: BlobInfoData[],\n  options?: SaveAsZipFileOptions,\n) => {\n  const normalizedOptions = normalizeZipOptions(options);\n\n  if (!normalizedOptions.type) {\n    showZipWarning('type 이 선언되지 않았습니다');\n    return;\n  }\n\n  if (!normalizedOptions.fileExtension) {\n    showZipWarning('파일 확장자가 선언되지 않았습니다');\n    return;\n  }\n\n  if (!data) {\n    showZipWarning('다운로드할 데이터가 없습니다');\n    return;\n  }\n\n  const JSZip = await loadJSZip();\n  const zip = new JSZip();\n  appendZipFiles(zip, data, normalizedOptions);\n\n  const archiveFiles = await zip.generateAsync({ type: 'blob' });\n  const url = URL.createObjectURL(archiveFiles);\n  const link = document.createElement('a');\n  link.href = url;\n  link.download = createArchiveFileName(\n    normalizedOptions.fileTitle,\n    normalizedOptions.appendDatetime,\n    normalizedOptions.archiveExtension,\n  );\n  link.click();\n  URL.revokeObjectURL(url);\n};\n"],"names":["DEFAULT_ZIP_OPTIONS","sanitizeFileName","__name","fileName","showZipWarning","message","enqueueSnackbar","t","normalizeZipOptions","options","createZipEntryFileName","index","fileExtension","normalizeArchiveExtension","archiveExtension","createArchiveFileName","fileTitle","appendDatetime","dayjs","isMatchedZipEntry","matcher","toZipArrayBuffer","source","readZipEntryText","zip","loadJSZip","zipFile","entry","readZipEntryJson","text","appendZipFiles","data","blob","saveAsZipFile","normalizedOptions","JSZip","archiveFiles","url","link"],"mappings":"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"}
+{"version":3,"file":"zipUtil.js","sources":["../../src/utils/zipUtil.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport { t } from 'i18next';\nimport type JSZip from 'jszip';\nimport { enqueueSnackbar } from 'notistack';\nimport { loadJSZip } from './jszipBrowser';\n\ntype BlobInfoData = {\n  blob: Blob;\n  fileName: string;\n};\n\nexport interface SaveAsZipFileOptions {\n  type?: string;\n  fileExtension?: string;\n  fileTitle?: string;\n  archiveExtension?: string;\n  appendDatetime?: boolean;\n  preserveFileNames?: boolean;\n}\n\nconst DEFAULT_ZIP_OPTIONS: Required<SaveAsZipFileOptions> = {\n  type: 'pdf',\n  fileExtension: 'application/pdf',\n  fileTitle: 'archive',\n  archiveExtension: 'zip',\n  appendDatetime: false,\n  preserveFileNames: false,\n};\n\n/**\n * 파일명 안전 문자 변환\n * @param fileName 원본 파일명\n */\nconst sanitizeFileName = (fileName: string) => fileName.replace(/[.*+?^${}()|[\\]\\\\]/g, '_');\n\n/**\n * ZIP 경고 메시지 출력\n * @param message 경고 메시지\n */\nconst showZipWarning = (message: string) => {\n  enqueueSnackbar(\n    t(`Message.${message}`, {\n      defaultValue: message,\n    }),\n    { variant: 'warning' },\n  );\n};\n\n/**\n * ZIP 저장 옵션 정규화\n * @param options 저장 옵션\n */\nconst normalizeZipOptions = (options?: SaveAsZipFileOptions) => {\n  return {\n    type: options?.type ?? DEFAULT_ZIP_OPTIONS.type,\n    fileExtension: options?.fileExtension ?? DEFAULT_ZIP_OPTIONS.fileExtension,\n    fileTitle: options?.fileTitle ?? DEFAULT_ZIP_OPTIONS.fileTitle,\n    archiveExtension: options?.archiveExtension ?? DEFAULT_ZIP_OPTIONS.archiveExtension,\n    appendDatetime: options?.appendDatetime ?? DEFAULT_ZIP_OPTIONS.appendDatetime,\n    preserveFileNames: options?.preserveFileNames ?? DEFAULT_ZIP_OPTIONS.preserveFileNames,\n  };\n};\n\n/**\n * ZIP 내부 파일명 생성\n * @param index 파일 순서\n * @param fileName 파일명\n * @param fileExtension 파일 확장자\n */\nconst createZipEntryFileName = (index: number, fileName: string, fileExtension: string) => {\n  return `${sanitizeFileName(`${index + 1}_${fileName}`)}.${fileExtension}`;\n};\n\n/**\n * ZIP 다운로드 파일명 생성\n * @param fileTitle 파일 제목\n * @param appendDatetime 일시 추가 여부\n */\nconst normalizeArchiveExtension = (archiveExtension: string) => {\n  return archiveExtension.replace(/^\\.+/, '') || DEFAULT_ZIP_OPTIONS.archiveExtension;\n};\n\n/**\n * ZIP 다운로드 파일명 생성\n * @param fileTitle 파일 제목\n * @param appendDatetime 일시 추가 여부\n * @param archiveExtension 아카이브 확장자\n */\nconst createArchiveFileName = (\n  fileTitle: string,\n  appendDatetime: boolean,\n  archiveExtension: string,\n) => {\n  return `${sanitizeFileName(fileTitle)}${appendDatetime ? `-${dayjs().format('YYYY_MM_DD_HH_mm_ss')}` : ''}.${normalizeArchiveExtension(archiveExtension)}`;\n};\n\n/**\n * ZIP 엔트리 일치 여부 확인\n * @param fileName ZIP 엔트리 파일명\n * @param matcher 엔트리 식별자\n */\nconst isMatchedZipEntry = (\n  fileName: string,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n) => {\n  if (typeof matcher === 'string') {\n    return fileName === matcher;\n  }\n\n  if (matcher instanceof RegExp) {\n    return matcher.test(fileName);\n  }\n\n  return matcher(fileName);\n};\n\n/**\n * ZIP 소스 ArrayBuffer 변환\n * @param source ZIP 소스\n */\nconst toZipArrayBuffer = async (source: Blob | ArrayBuffer) => {\n  return source instanceof Blob ? source.arrayBuffer() : source;\n};\n\n/**\n * ZIP 엔트리 텍스트 로드\n * @param source ZIP 소스\n * @param matcher 엔트리 식별자\n */\nexport const readZipEntryText = async (\n  source: Blob | ArrayBuffer,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n): Promise<string | null> => {\n  const JSZip = await loadJSZip();\n  const zip = await JSZip.loadAsync(await toZipArrayBuffer(source));\n  const zipFile = Object.values(zip.files).find(\n    (entry) => !entry.dir && isMatchedZipEntry(entry.name, matcher),\n  );\n\n  if (!zipFile) {\n    return null;\n  }\n\n  return zipFile.async('string');\n};\n\n/**\n * ZIP 엔트리 JSON 로드\n * @param source ZIP 소스\n * @param matcher 엔트리 식별자\n */\nexport const readZipEntryJson = async <T>(\n  source: Blob | ArrayBuffer,\n  matcher: string | RegExp | ((fileName: string) => boolean),\n): Promise<T | null> => {\n  const text = await readZipEntryText(source, matcher);\n\n  if (!text) {\n    return null;\n  }\n\n  return JSON.parse(text) as T;\n};\n\n/**\n * ZIP 파일 데이터 추가\n * @param zip ZIP 인스턴스\n * @param data 파일 데이터 목록\n * @param options ZIP 저장 옵션\n */\nconst appendZipFiles = (\n  zip: JSZip,\n  data: BlobInfoData[],\n  options: Required<SaveAsZipFileOptions>,\n) => {\n  data.forEach(({ blob, fileName }, index) => {\n    if (!blob) {\n      return;\n    }\n\n    zip.file(\n      options.preserveFileNames\n        ? fileName\n        : createZipEntryFileName(index, fileName, options.fileExtension),\n      options.preserveFileNames ? blob : new Blob([blob], { type: options.type }),\n    );\n  });\n};\n\n/**\n * ZIP 파일 저장\n * @param data 저장할 파일 데이터\n * @param options 저장 옵션\n */\nexport const saveAsZipFile = async (\n  data: BlobInfoData[],\n  options?: SaveAsZipFileOptions,\n) => {\n  const normalizedOptions = normalizeZipOptions(options);\n\n  if (!normalizedOptions.preserveFileNames && !normalizedOptions.type) {\n    showZipWarning('type 이 선언되지 않았습니다');\n    return;\n  }\n\n  if (!normalizedOptions.preserveFileNames && !normalizedOptions.fileExtension) {\n    showZipWarning('파일 확장자가 선언되지 않았습니다');\n    return;\n  }\n\n  if (!data) {\n    showZipWarning('다운로드할 데이터가 없습니다');\n    return;\n  }\n\n  const JSZip = await loadJSZip();\n  const zip = new JSZip();\n  appendZipFiles(zip, data, normalizedOptions);\n\n  const archiveFiles = await zip.generateAsync({ type: 'blob' });\n  const url = URL.createObjectURL(archiveFiles);\n  const link = document.createElement('a');\n  link.href = url;\n  link.download = createArchiveFileName(\n    normalizedOptions.fileTitle,\n    normalizedOptions.appendDatetime,\n    normalizedOptions.archiveExtension,\n  );\n  link.click();\n  URL.revokeObjectURL(url);\n};\n"],"names":["DEFAULT_ZIP_OPTIONS","sanitizeFileName","__name","fileName","showZipWarning","message","enqueueSnackbar","t","normalizeZipOptions","options","createZipEntryFileName","index","fileExtension","normalizeArchiveExtension","archiveExtension","createArchiveFileName","fileTitle","appendDatetime","dayjs","isMatchedZipEntry","matcher","toZipArrayBuffer","source","readZipEntryText","zip","loadJSZip","zipFile","entry","readZipEntryJson","text","appendZipFiles","data","blob","saveAsZipFile","normalizedOptions","JSZip","archiveFiles","url","link"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@owp/core",
   "private": false,
-  "version": "2.5.5",
+  "version": "2.5.6",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -92,6 +92,7 @@
     "colors/",
     "colors.d.ts",
     "colors.js",
+    "configs/",
     "constants.d.ts",
     "constants.js",
     "contexts.d.ts",