npm - @byuckchon-frontend/utils - Versions diffs - 1.0.0 - Mend

@byuckchon-frontend/utils 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.d.ts +2 -0
package/dist/index.mjs +155 -0
package/dist/index.umd.js +1 -0
package/dist/src/formatData/index.d.ts +45 -0
package/dist/src/index.d.ts +2 -0
package/dist/src/validate/index.d.ts +114 -0
package/dist/vite.config.d.ts +2 -0
package/package.json +53 -0

package/dist/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './src/index'
2	+ export {}

package/dist/index.mjs ADDED Viewed

@@ -0,0 +1,155 @@
+const C = () => ({
+  formatPhoneNumber: (n) => {
+    const t = (n ?? "").replace(/\D/g, "");
+    if (/^1[568]\d{7}$/.test(t))
+      return t.replace(/^(\d{4})(\d{4})$/, "$1-$2");
+    if (t.startsWith("02")) {
+      if (t.length === 9)
+        return t.replace(/^(\d{2})(\d{3})(\d{4})$/, "$1-$2-$3");
+      if (t.length === 10)
+        return t.replace(/^(\d{2})(\d{4})(\d{4})$/, "$1-$2-$3");
+    }
+    if (/^0\d+/.test(t)) {
+      if (t.length === 10)
+        return t.replace(/^(\d{3})(\d{3})(\d{4})$/, "$1-$2-$3");
+      if (t.length === 11)
+        return t.replace(/^(\d{3})(\d{4})(\d{4})$/, "$1-$2-$3");
+    }
+    return n;
+  },
+  formatBizNumber: (n) => {
+    const t = (n ?? "").replace(/\D/g, "");
+    return t.length === 10 ? t.replace(/^(\d{3})(\d{2})(\d{5})$/, "$1-$2-$3") : t.length === 13 ? t.replace(/^(\d{6})(\d{7})$/, "$1-$2") : String(n ?? "");
+  },
+  formatDate: (n) => {
+    if (!(n instanceof Date) || isNaN(n.getTime())) return "";
+    const t = n.getHours(), r = n.getMinutes(), a = t < 12 ? "오전" : "오후", l = t % 12 === 0 ? 12 : t % 12;
+    return `${a} ${l}시 ${r}분`;
+  },
+  Masker: {
+    /**
+     * 이름/문자열 마스킹
+     * - 1글자: "*"
+     * - 2글자: 첫 글자 + "*"
+     * - 3글자 이상: 첫 글자 + (중간 전부 "*") + 마지막 글자
+     *
+     * @param {string} raw 원본 문자열
+     * @returns {string} 마스킹된 문자열 (공백/빈문자열 입력 시 빈 문자열)
+     * @example
+     * Masker.maskName("홍");      // "*"
+     * Masker.maskName("홍길");    // "홍*"
+     * Masker.maskName("홍길동");  // "홍*동"
+     */
+    maskName: (n) => {
+      const t = (n ?? "").trim(), r = [...t].length;
+      if (r <= 0) return "";
+      if (r === 1) return "*";
+      if (r === 2) {
+        const [d] = [...t];
+        return `${d}*`;
+      }
+      const a = [...t], l = a[0], i = a[r - 1], s = "*".repeat(r - 2);
+      return `${l}${s}${i}`;
+    },
+    /**
+     * 전화번호 마스킹
+     * - 하이픈 포함 입력을 우선 처리(중간 블록을 *로), 하이픈 미포함 시 3-*-4 규칙으로 생성
+     * - 최소 8자리 미만은 원본 반환
+     *
+     * @param {string} input 전화번호(하이픈 포함/미포함 모두 가능)
+     * @returns {string} 마스킹된 전화번호
+     * @example
+     * Masker.maskPhoneNumber("010-1234-5678"); // "010-****-5678"
+     * Masker.maskPhoneNumber("0212345678");    // "021****678" (하이픈 미포함 입력)
+     */
+    maskPhoneNumber: (n) => {
+      if (n.includes("-")) {
+        const i = n.split("-");
+        if (i.length === 3) {
+          const [s, d, $] = i;
+          return `${s}-${"*".repeat(
+            d.replace(/\D/g, "").length || 4
+          )}-${$}`;
+        }
+        if (i.length === 2) {
+          const [s, d] = i, $ = d.replace(/\D/g, ""), g = $.slice(-4), h = Math.max(1, $.length - g.length);
+          return `${s}-${"*".repeat(h)}${g}`;
+        }
+        return n;
+      }
+      const t = n.replace(/\D/g, "");
+      if (t.length < 8) return n;
+      const r = t.slice(0, 3), a = t.slice(-4), l = Math.max(1, t.length - (r.length + a.length));
+      return `${r}${"*".repeat(l)}${a}`;
+    }
+  },
+  commanizeData: (n) => {
+    const t = String(n ?? "").trim();
+    if (!t) return "";
+    const r = t.replace(/,/g, ""), a = r.startsWith("-") ? "-" : "", l = r.replace(/^-/, ""), [i, s] = l.split("."), d = i.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+    return a + d + (s !== void 0 ? `.${s}` : "");
+  },
+  decommanizeData: (n) => n.replace(/,/g, "")
+}), p = /^[A-Za-z0-9]([A-Za-z0-9_.+-]*[A-Za-z0-9])?@[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?\.[A-Za-z]{2,}$/, x = /^010(\d{4})(\d{4})$/, z = /^(070|02|031|032|033|034|035|036|037|038|039|041|042|043|051|052|053|054|055|061|062|063|064|070|071|072)[0-9]{3,4}[0-9]{4}$/, D = /([0-9]{2}(0[1-9]|1[0-2])(0[1-9]|[1,2][0-9]|3[0,1]))/, b = /^(19[0-9][0-9]|20\d{2})(0[0-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])$/, A = /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[!@#$%^&*()_+~`\-={}[\]:;"'<>,.?/\\]).{10,}$/, R = /^d{2}([0]\d|[1][0-2])([0][1-9]|[1-2]\d|[3][0-1])[-]*[1-4]\d{6}$/, B = /^(?:[0-9]{2}(?:0[1-9]|1[0-2])(?:0[1-9]|[1,2][0-9]|3[0,1]))-[1-8][0-9]{6}$/, N = /^https?:\/\/(?:[-\w.])+(?:\.[a-zA-Z]{2,})+(?::\d+)?(?:\/[^\s]*)?$/i, v = /\.(jpg|jpeg|png|gif|pdf|doc|docx|xls|xlsx|ppt|pptx|txt|zip|rar)$/i;
+function P(e) {
+  return p.test(e);
+}
+function Z(e) {
+  return x.test(e);
+}
+function k(e) {
+  return z.test(e);
+}
+function M(e) {
+  return D.test(e);
+}
+function j(e) {
+  return b.test(e);
+}
+function w(e) {
+  return A.test(e);
+}
+function S(e) {
+  return R.test(e);
+}
+function y(e) {
+  return B.test(e);
+}
+function F(e) {
+  const o = e.replace(/-/gi, "").split("").map((u) => parseInt(u, 10));
+  if (o.length === 10) {
+    if (o.every((c) => c === 0))
+      return !1;
+    const u = [1, 3, 7, 1, 3, 7, 1, 3, 5];
+    let f = 0;
+    for (let c = 0; c < 9; c++)
+      f += u[c] * o[c];
+    const m = (10 - f % 10) % 10;
+    return o[9] === m;
+  }
+  return !1;
+}
+function I(e) {
+  return N.test(e);
+}
+function W(e, o = 10) {
+  const u = typeof e == "string" ? e : e.name;
+  return !(!v.test(u) || e instanceof File && e.size / 1048576 > o);
+}
+const E = {
+  email: P,
+  phone: Z,
+  homePhone: k,
+  birth6: M,
+  birth8: j,
+  password: w,
+  juminAfter2020: y,
+  juminBefore2020: S,
+  corporateRegiNumber: F,
+  url: I,
+  file: W
+};
+export {
+  C as FormatData,
+  E as validate
+};

package/dist/index.umd.js ADDED Viewed

@@ -0,0 +1 @@

package/dist/src/formatData/index.d.ts ADDED Viewed

@@ -0,0 +1,45 @@
+/**
+ * 유틸 팩토리: 전화번호/사업자번호/날짜 포매팅, 마스킹, 숫자 콤마 처리 등 제공
+ *
+ * @returns 객체 형태의 포매터/마스커 유틸들
+ * @example
+ * const { formatPhoneNumber, Masker, commanizeData } = FormatData();
+ * formatPhoneNumber("01012345678");      // "010-1234-5678"
+ * Masker.maskName("홍길동");               // "홍*동"
+ * commanizeData(1234567.89);             // "1,234,567.89"
+ */
+export declare const FormatData: () => {
+    formatPhoneNumber: (value: string) => string;
+    formatBizNumber: (value: string) => string;
+    formatDate: (value: Date) => string;
+    Masker: {
+        /**
+         * 이름/문자열 마스킹
+         * - 1글자: "*"
+         * - 2글자: 첫 글자 + "*"
+         * - 3글자 이상: 첫 글자 + (중간 전부 "*") + 마지막 글자
+         *
+         * @param {string} raw 원본 문자열
+         * @returns {string} 마스킹된 문자열 (공백/빈문자열 입력 시 빈 문자열)
+         * @example
+         * Masker.maskName("홍");      // "*"
+         * Masker.maskName("홍길");    // "홍*"
+         * Masker.maskName("홍길동");  // "홍*동"
+         */
+        maskName: (raw: string) => string;
+        /**
+         * 전화번호 마스킹
+         * - 하이픈 포함 입력을 우선 처리(중간 블록을 *로), 하이픈 미포함 시 3-*-4 규칙으로 생성
+         * - 최소 8자리 미만은 원본 반환
+         *
+         * @param {string} input 전화번호(하이픈 포함/미포함 모두 가능)
+         * @returns {string} 마스킹된 전화번호
+         * @example
+         * Masker.maskPhoneNumber("010-1234-5678"); // "010-****-5678"
+         * Masker.maskPhoneNumber("0212345678");    // "021****678" (하이픈 미포함 입력)
+         */
+        maskPhoneNumber: (input: string) => string;
+    };
+    commanizeData: (value: string | number) => string;
+    decommanizeData: (value: string) => string;
+};

package/dist/src/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from './formatData';
2	+ export * from './validate';

package/dist/src/validate/index.d.ts ADDED Viewed

@@ -0,0 +1,114 @@
+/**
+ * 이메일 형식을 검증합니다.
+ * @param email - 검증할 이메일 문자열
+ * @returns 유효한 이메일 형식이면 true, 아니면 false
+ * @example
+ * validateEmail('test@example.com') // true
+ * validateEmail('invalid-email') // false
+ */
+declare function validateEmail(email: string): boolean;
+/**
+ * 휴대폰 번호 형식을 검증합니다. (010으로 시작하는 11자리 숫자, 하이픈 없음)
+ * @param phone - 검증할 휴대폰 번호 문자열
+ * @returns 유효한 휴대폰 번호 형식이면 true, 아니면 false
+ * @example
+ * validatePhone('01012345678') // true
+ * validatePhone('010-1234-5678') // false
+ */
+declare function validatePhone(phone: string): boolean;
+/**
+ * 집 전화번호 형식을 검증합니다. (한국의 모든 지역번호)
+ * @param homePhone - 검증할 집 전화번호 문자열
+ * @returns 유효한 집 전화번호 형식이면 true, 아니면 false
+ * @example
+ * validateHomePhone('0212345678') // true
+ * validateHomePhone('03112345678') // true
+ */
+declare function validateHomePhone(homePhone: string): boolean;
+/**
+ * 생년월일 6자리 형식을 검증합니다. (YYMMDD)
+ * @param birth - 검증할 생년월일 문자열
+ * @returns 유효한 생년월일 형식이면 true, 아니면 false
+ * @example
+ * validateBirth6('990101') // true
+ * validateBirth6('001231') // true
+ */
+declare function validateBirth6(birth: string): boolean;
+/**
+ * 생년월일 8자리 형식을 검증합니다. (YYYYMMDD)
+ * @param birth - 검증할 생년월일 문자열
+ * @returns 유효한 생년월일 형식이면 true, 아니면 false
+ * @example
+ * validateBirth8('19990101') // true
+ * validateBirth8('20001231') // true
+ */
+declare function validateBirth8(birth: string): boolean;
+/**
+ * 비밀번호 형식을 검증합니다. (영문 대소문자 + 숫자 + 특수문자 각 1회 이상, 10자리 이상)
+ * @param password - 검증할 비밀번호 문자열
+ * @returns 유효한 비밀번호 형식이면 true, 아니면 false
+ * @example
+ * validatePassword('MyPassword123!') // true
+ * validatePassword('weak') // false
+ */
+declare function validatePassword(password: string): boolean;
+/**
+ * 주민등록번호 형식을 검증합니다. (2020년 이전 출생자)
+ * @param jumin - 검증할 주민등록번호 문자열
+ * @returns 유효한 주민등록번호 형식이면 true, 아니면 false
+ * @example
+ * validateJuminBefore2020('990101-1234567') // true
+ */
+declare function validateJuminBefore2020(jumin: string): boolean;
+/**
+ * 주민등록번호 형식을 검증합니다. (2020년 이후 출생자 포함)
+ * @param jumin - 검증할 주민등록번호 문자열
+ * @returns 유효한 주민등록번호 형식이면 true, 아니면 false
+ * @example
+ * validateJuminAfter2020('200101-5234567') // true
+ */
+declare function validateJuminAfter2020(jumin: string): boolean;
+/**
+ * 사업자등록번호를 검증합니다.
+ * @param number - 검증할 사업자등록번호 문자열 (하이픈 포함 가능)
+ * @returns 유효한 사업자등록번호이면 true, 아니면 false
+ * @example
+ * validateCorporateRegiNumber('123-45-67890') // 유효성 검사 후 결과 반환
+ * validateCorporateRegiNumber('1234567890') // 유효성 검사 후 결과 반환
+ */
+declare function validateCorporateRegiNumber(number: string): boolean;
+/**
+ * URL 형식을 검증합니다.
+ * @param url - 검증할 URL 문자열
+ * @returns 유효한 URL 형식이면 true, 아니면 false
+ * @example
+ * validateUrl('https://example.com') // true
+ * validateUrl('http://example.com/path') // true
+ * validateUrl('not-a-url') // false
+ */
+declare function validateUrl(url: string): boolean;
+/**
+ * 파일의 확장자와 크기를 검증합니다.
+ * 지원 확장자: jpg, jpeg, png, gif, pdf, doc, docx, xls, xlsx, ppt, pptx, txt, zip, rar
+ * @param file - 검증할 File 객체 또는 파일명 문자열
+ * @param maxSizeInMB - 최대 파일 크기 (MB 단위, 기본값: 10MB)
+ * @returns 유효한 파일이면 true, 아니면 false
+ * @example
+ * validateFile(new File(['content'], 'document.pdf'), 5) // true (5MB 이하)
+ * validateFile('image.jpg', 10) // true (확장자 검증만)
+ */
+declare function validateFile(file: File | string, maxSizeInMB?: number): boolean;
+export declare const validate: {
+    email: typeof validateEmail;
+    phone: typeof validatePhone;
+    homePhone: typeof validateHomePhone;
+    birth6: typeof validateBirth6;
+    birth8: typeof validateBirth8;
+    password: typeof validatePassword;
+    juminAfter2020: typeof validateJuminAfter2020;
+    juminBefore2020: typeof validateJuminBefore2020;
+    corporateRegiNumber: typeof validateCorporateRegiNumber;
+    url: typeof validateUrl;
+    file: typeof validateFile;
+};
+export {};

package/dist/vite.config.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ declare const _default: import('vite').UserConfig;
2	+ export default _default;

package/package.json ADDED Viewed

@@ -0,0 +1,53 @@
+{
+  "name": "@byuckchon-frontend/utils",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.umd.js",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "devDependencies": {
+    "vite": "^7.1.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vite-plugin-libcss": "^1.1.2",
+    "vite-css-modules": "^1.10.0",
+    "typescript": "~5.8.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RevolutionaryWarrior/byuckchon-frontend-packages.git"
+  },
+  "keywords": [
+    "javascript",
+    "typescript",
+    "utils",
+    "common",
+    "frontend"
+  ],
+  "author": "Byuckchon Frontend Team",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/RevolutionaryWarrior/byuckchon-frontend-packages/issues"
+  },
+  "homepage": "https://github.com/RevolutionaryWarrior/byuckchon-frontend-packages#readme",
+  "description": "",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "lint": "eslint src --ext ts,tsx",
+    "build:watch": "vite build --watch"
+  }
+}