spotlibs-components 0.1.10 → 0.1.12

package/src/utils/formatters/date.js

@@ -0,0 +1,219 @@
+/**
+ * Date Formatting Utilities
+ *
+ * Konsolidasi dari:
+ * - stringUtils.js (semua date formatter functions)
+ *
+ * Konvensi penamaan:
+ * - "Dash" = separator "-" (e.g., 2024-07-19)
+ * - "Slash" = separator "/" (e.g., 19/07/2024)
+ * - "YearFirst" = format YYYY-MM-DD
+ * - "DateFirst" = format DD-MM-YYYY atau DD/MM/YYYY
+ */
+
+/**
+ * Konversi Date object ke format YYYY-MM-DD.
+ * @param {Date|string} value - Date object atau date string
+ * @returns {string} Format "YYYY-MM-DD"
+ *
+ * @example
+ * toYearFirstDash(new Date(2024, 6, 19)) // "2024-07-19"
+ * toYearFirstDash("2024-07-19T00:00:00") // "2024-07-19"
+ */
+export const toYearFirstDash = (value) => {
+  const date = new Date(value);
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${year}-${month}-${day}`;
+};
+
+/**
+ * Konversi Date object ke format DD/MM/YYYY.
+ * @param {Date|string} value - Date object atau date string
+ * @returns {string} Format "DD/MM/YYYY"
+ *
+ * @example
+ * toDateFirstSlash(new Date(2024, 1, 1)) // "01/02/2024"
+ * toDateFirstSlash("2024-02-01") // "01/02/2024"
+ */
+export const toDateFirstSlash = (value) => {
+  const date = new Date(value);
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const day = String(date.getDate()).padStart(2, "0");
+  return `${day}/${month}/${year}`;
+};
+
+/**
+ * Konversi Date object ke format DD/MM/YYYY (alias).
+ * @param {Date} date - Date object
+ * @returns {string} Format "DD/MM/YYYY"
+ *
+ * @example
+ * formatDateToDDSlashMMSlashYYYY(new Date(2025, 2, 31)) // "31/03/2025"
+ */
+export const formatDateToDDSlashMMSlashYYYY = (date) => {
+  const day = String(date.getDate()).padStart(2, "0");
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const year = date.getFullYear();
+  return `${day}/${month}/${year}`;
+};
+
+/**
+ * Konversi Date object ke format DDMMYYYY (tanpa separator).
+ * @param {Date} date - Date object
+ * @returns {string} Format "DDMMYYYY"
+ *
+ * @example
+ * formatDateToDDMMYYYY(new Date(2025, 2, 31)) // "31032025"
+ */
+export const formatDateToDDMMYYYY = (date) => {
+  const day = String(date.getDate()).padStart(2, "0");
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const year = date.getFullYear();
+  return `${day}${month}${year}`;
+};
+
+/**
+ * Konversi format YYYY-MM-DD ke DD-MM-YYYY.
+ * @param {string} value - Date string format "YYYY-MM-DD"
+ * @returns {string} Format "DD-MM-YYYY"
+ *
+ * @example
+ * yearFirstDashToDateFirstDash("2024-07-26") // "26-07-2024"
+ */
+export const yearFirstDashToDateFirstDash = (value) => {
+  if (!value) return "";
+  const [year, month, day] = value.split("-");
+  return `${day}-${month}-${year}`;
+};
+
+/**
+ * Konversi format YYYY-MM-DD ke DD/MM/YYYY.
+ * @param {string} value - Date string format "YYYY-MM-DD"
+ * @returns {string} Format "DD/MM/YYYY"
+ *
+ * @example
+ * yearFirstDashToDateFirstSlash("2024-07-19") // "19/07/2024"
+ */
+export const yearFirstDashToDateFirstSlash = (value) => {
+  if (!value) return "";
+  const parts = value.split("-");
+  if (parts.length === 3) {
+    const [year, month, day] = parts;
+    return `${day}/${month}/${year}`;
+  }
+  return value;
+};
+
+/**
+ * Konversi format DD/MM/YYYY ke YYYY-MM-DD.
+ * @param {string} value - Date string format "DD/MM/YYYY"
+ * @returns {string} Format "YYYY-MM-DD"
+ *
+ * @example
+ * dateFirstSlashToYearFirstDash("19/07/2024") // "2024-07-19"
+ */
+export const dateFirstSlashToYearFirstDash = (value) => {
+  if (!value) return "";
+  const [day, month, year] = value.split("/");
+  return `${year}-${month.padStart(2, "0")}-${day.padStart(2, "0")}`;
+};
+
+/**
+ * Konversi format 7 digit (e.g., "0041125") ke DD/MM/YYYY.
+ * Format: [prefix 1 digit][DD][MM][YY atau YYYY]
+ * @param {string} value - 7-digit date string
+ * @returns {string} Format "DD/MM/YYYY"
+ *
+ * @example
+ * sevenDigitToDateFirstSlash("0190724") // "19/07/2024"
+ * sevenDigitToDateFirstSlash("0041125") // "04/11/2025"
+ */
+export const sevenDigitToDateFirstSlash = (value) => {
+  if (!value) return "";
+  const actualDate = value.substring(1);
+  const day = actualDate.substring(0, 2);
+  const month = actualDate.substring(2, 4);
+  const yearLastTwoDigits = actualDate.substring(4, 8);
+  const yearPrefix = parseInt(yearLastTwoDigits, 10) >= 70 ? "19" : "20";
+  const year = yearPrefix + yearLastTwoDigits;
+  return `${day}/${month}/${year}`;
+};
+
+/**
+ * Konversi format 7 digit ke YYYY-MM-DD.
+ * @param {string} value - 7-digit date string
+ * @returns {string} Format "YYYY-MM-DD"
+ *
+ * @example
+ * sevenDigitToYearFirstDash("0190724") // "2024-07-19"
+ */
+export const sevenDigitToYearFirstDash = (value) => {
+  if (!value) return "";
+  const actualDate = value.substring(1);
+  const day = actualDate.slice(0, 2);
+  const month = actualDate.slice(2, 4);
+  const yearLastTwoDigits = actualDate.slice(4, 8);
+  const yearPrefix = parseInt(yearLastTwoDigits, 10) >= 70 ? "19" : "20";
+  const year = yearPrefix + yearLastTwoDigits;
+  return `${year}-${month}-${day}`;
+};
+
+/**
+ * Konversi format 7 digit ke DD-MM-YYYY.
+ * @param {string} value - 7-digit date string
+ * @returns {string} Format "DD-MM-YYYY"
+ *
+ * @example
+ * sevenDigitToDateFirstDash("0041125") // "04-11-2025"
+ */
+export const sevenDigitToDateFirstDash = (value) => {
+  if (!value) return "";
+  const actualDate = value.substring(1);
+  const day = actualDate.slice(0, 2);
+  const month = actualDate.slice(2, 4);
+  const yearLastTwoDigits = actualDate.slice(4, 8);
+  const yearPrefix = parseInt(yearLastTwoDigits, 10) >= 70 ? "19" : "20";
+  const year = yearPrefix + yearLastTwoDigits;
+  return `${day}-${month}-${year}`;
+};
+
+/**
+ * Konversi datetime string ke format DD-MM-YYYY HH:mm.
+ * @param {string} value - DateTime string (e.g., "2025-01-13 16:39:39")
+ * @returns {string} Format "DD-MM-YYYY HH:mm"
+ *
+ * @example
+ * toDateTimeHourMinute("2025-01-13 16:39:39") // "13-01-2025 16:39"
+ */
+export const toDateTimeHourMinute = (value) => {
+  if (!value) return "";
+  const date = new Date(value);
+  const day = String(date.getDate()).padStart(2, "0");
+  const month = String(date.getMonth() + 1).padStart(2, "0");
+  const year = date.getFullYear();
+  const hours = String(date.getHours()).padStart(2, "0");
+  const minutes = String(date.getMinutes()).padStart(2, "0");
+  return `${day}-${month}-${year} ${hours}:${minutes}`;
+};
+
+/**
+ * Konversi format DDMMYY (6 digit) ke DD/MM/YYYY.
+ * @param {string} value - 6-digit date string (DDMMYY)
+ * @returns {string} Format "DD/MM/YYYY"
+ *
+ * @example
+ * ddmmyyToSlashDate("190724") // "19/07/2024"
+ * ddmmyyToSlashDate("010170") // "01/01/1970"
+ */
+export const ddmmyyToSlashDate = (value) => {
+  if (!value || value.length !== 6) return "";
+  const day = value.substring(0, 2);
+  const month = value.substring(2, 4);
+  const yearSuffix = value.substring(4, 6);
+  const year =
+    parseInt(yearSuffix, 10) >= 70 ? "19" + yearSuffix : "20" + yearSuffix;
+  return `${day}/${month}/${year}`;
+};

package/src/utils/formatters/index.d.ts

@@ -0,0 +1,47 @@
+// Account
+export declare function formatAccountNumber(value: string | null | undefined): string;
+export declare function formatNPWP(value: string | null | undefined): string;
+
+// Currency
+export declare function formatCurrency(
+  value: number | string | null | undefined,
+  options?: {
+    locale?: string;
+    currency?: string;
+    minFractionDigits?: number;
+    maxFractionDigits?: number;
+  }
+): string;
+export declare function formatRupiah(value: number | string | null | undefined): string;
+export declare function formatNominal(
+  value: number | string | null | undefined,
+  options?: {
+    locale?: string;
+    minFractionDigits?: number;
+    maxFractionDigits?: number;
+    decimalSeparator?: string;
+  }
+): string;
+export declare function formatDigit(value: number | string): string;
+
+// Date
+export declare function toYearFirstDash(value: Date | string): string;
+export declare function toDateFirstSlash(value: Date | string): string;
+export declare function formatDateToDDSlashMMSlashYYYY(date: Date): string;
+export declare function formatDateToDDMMYYYY(date: Date): string;
+export declare function yearFirstDashToDateFirstDash(value: string): string;
+export declare function yearFirstDashToDateFirstSlash(value: string): string;
+export declare function dateFirstSlashToYearFirstDash(value: string): string;
+export declare function sevenDigitToDateFirstSlash(value: string): string;
+export declare function sevenDigitToYearFirstDash(value: string): string;
+export declare function sevenDigitToDateFirstDash(value: string): string;
+export declare function toDateTimeHourMinute(value: string): string;
+export declare function ddmmyyToSlashDate(value: string): string;
+
+// String
+export declare function formatResponseDesc(desc: string): string;
+export declare function titleCase(str: string): string;
+export declare function snakeToCamelWithSpace(snakeStr: string): string;
+export declare function stringToBoolean(str: string): boolean | undefined;
+export declare function matchWiths(targetStr: string, values?: string[]): boolean;
+export declare function maskString(value: string, type?: string): string;

package/src/utils/formatters/index.js

@@ -0,0 +1,47 @@
+/**
+ * Consolidated Formatters
+ *
+ * Barrel export untuk semua formatting utilities.
+ * Menggantikan fungsi-fungsi yang tersebar di:
+ * - formatString.js
+ * - formatCurrency.js
+ * - formatters.js
+ * - stringUtils.js
+ * - convertSnakeToCamelWithSpace.js
+ */
+
+export {
+  formatAccountNumber,
+  formatNPWP,
+} from "./account";
+
+export {
+  formatCurrency,
+  formatRupiah,
+  formatNominal,
+  formatDigit,
+} from "./currency";
+
+export {
+  toYearFirstDash,
+  toDateFirstSlash,
+  formatDateToDDSlashMMSlashYYYY,
+  formatDateToDDMMYYYY,
+  yearFirstDashToDateFirstDash,
+  yearFirstDashToDateFirstSlash,
+  dateFirstSlashToYearFirstDash,
+  sevenDigitToDateFirstSlash,
+  sevenDigitToYearFirstDash,
+  sevenDigitToDateFirstDash,
+  toDateTimeHourMinute,
+  ddmmyyToSlashDate,
+} from "./date";
+
+export {
+  formatResponseDesc,
+  titleCase,
+  snakeToCamelWithSpace,
+  stringToBoolean,
+  matchWiths,
+  maskString,
+} from "./string";

package/src/utils/formatters/string.d.ts

@@ -0,0 +1,6 @@
+export declare function formatResponseDesc(desc: string): string;
+export declare function titleCase(str: string): string;
+export declare function snakeToCamelWithSpace(snakeStr: string): string;
+export declare function stringToBoolean(str: string): boolean | undefined;
+export declare function matchWiths(targetStr: string, values?: string[]): boolean;
+export declare function maskString(value: string, type?: string): string;

package/src/utils/formatters/string.js

@@ -0,0 +1,114 @@
+/**
+ * String Formatting & Transformation Utilities
+ *
+ * Konsolidasi dari:
+ * - formatString.js (formatResponseDesc, titleCase, stringToBoolean)
+ * - convertSnakeToCamelWithSpace.js (snakeToCamelWithSpace)
+ * - stringUtils.js (matchWiths, needToHide)
+ */
+
+/**
+ * Format response description: replace underscores with spaces dan capitalize.
+ * @param {string} desc - Description string dari API response
+ * @returns {string} Formatted description
+ *
+ * @example
+ * formatResponseDesc("invalid_request_data") // "Invalid Request Data"
+ * formatResponseDesc("brispot_error") // "BRISPOT Error"
+ */
+export const formatResponseDesc = (desc) => {
+  if (!desc) return "";
+  return desc
+    .replace(/_(\w)/g, (_match, p1) => " " + p1.toUpperCase())
+    .replace(/brispot/gi, "BRISPOT");
+};
+
+/**
+ * Konversi string ke Title Case.
+ * @param {string} str - Input string
+ * @returns {string} Title cased string
+ *
+ * @example
+ * titleCase("hello world") // "Hello World"
+ * titleCase("JOHN DOE") // "John Doe"
+ */
+export const titleCase = (str) => {
+  if (!str) return "";
+  return str
+    .toLowerCase()
+    .split(" ")
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(" ");
+};
+
+/**
+ * Konversi snake_case ke Title Case With Spaces.
+ * @param {string} snakeStr - Snake case string
+ * @returns {string} Title case with spaces
+ *
+ * @example
+ * snakeToCamelWithSpace("hello_world") // "Hello World"
+ * snakeToCamelWithSpace("user_full_name") // "User Full Name"
+ */
+export function snakeToCamelWithSpace(snakeStr) {
+  if (!snakeStr) return "";
+  return snakeStr
+    .toLowerCase()
+    .replace(/_([a-z])/g, (_match, letter) => ` ${letter.toUpperCase()}`)
+    .replace(/^([a-z])/, (_, letter) => letter.toUpperCase());
+}
+
+/**
+ * Konversi string "true"/"false" ke boolean.
+ * @param {string} str - String "true" atau "false"
+ * @returns {boolean|undefined} Boolean value atau undefined jika bukan "true"/"false"
+ *
+ * @example
+ * stringToBoolean("true") // true
+ * stringToBoolean("false") // false
+ * stringToBoolean("other") // undefined
+ */
+export const stringToBoolean = (str) => {
+  if (str === "true" || str === "false") {
+    return str === "true";
+  }
+  return undefined;
+};
+
+/**
+ * Cek apakah target string mengandung salah satu dari values.
+ * @param {string} targetStr - String yang akan dicek
+ * @param {string[]} values - Array of substrings to match
+ * @returns {boolean} True jika salah satu value ditemukan
+ *
+ * @example
+ * matchWiths("hello world", ["hello", "foo"]) // true
+ * matchWiths("hello world", ["foo", "bar"]) // false
+ */
+export function matchWiths(targetStr, values = []) {
+  if (!targetStr) return false;
+  return values.some((v) => targetStr.includes(v));
+}
+
+/**
+ * Mask/hide sebagian karakter dari string (untuk privasi).
+ * @param {string} value - String yang akan di-mask
+ * @param {string} type - Tipe masking: "email" atau default
+ * @returns {string} Masked string
+ *
+ * @example
+ * maskString("johndoe@email.com", "email") // "joh****@email.com"
+ * maskString("081234567890") // "081*****890"
+ */
+export const maskString = (value, type) => {
+  if (!value) return "";
+  const tempArr = value.split("");
+  let len = tempArr.length - 3;
+
+  if (type === "email") {
+    len = tempArr.indexOf("@");
+  }
+
+  tempArr.splice(3 - tempArr.length, len - 3, ..."*".repeat(len - 3).split(""));
+  return tempArr.join("");
+};

package/src/utils/generateImportExcel.d.ts

@@ -0,0 +1,35 @@
+export interface GenerateAnnualTemplateExcelConfig {
+  year?: number;
+  data?: Array<Record<string, unknown>>;
+  headers1?: string[];
+  headers2?: string[];
+  title?: string;
+  disabledMonths?: number[];
+  startDataRow?: number;
+  isLocked?: boolean;
+  password?: string;
+  freezeColumns?: number;
+  freezeHeader?: boolean;
+  filename?: string;
+  isTotalCell?: boolean;
+  mappings?: Record<string, number>;
+}
+
+export interface ImportAnnualTemplateExcelConfig {
+  maxValue?: number;
+  file: File;
+  sheetName?: string;
+  headerRow?: number;
+  requiredHeaders?: string[];
+  mappings?: Record<string, string>;
+  hasMonthlyData?: boolean;
+  validateRow?: (row: Record<string, unknown>) => boolean;
+}
+
+export declare function generateAnnualTemplateExcel(
+  config: GenerateAnnualTemplateExcelConfig
+): Promise<void>;
+
+export declare function importAnnualTemplateExcel(
+  config: ImportAnnualTemplateExcelConfig
+): Promise<Array<Record<string, unknown>>>;