@react-pakistan/util-functions 1.25.73 → 1.25.75

package/general/convert-url-to-base64.d.ts

@@ -0,0 +1,55 @@
+/**
+ * URL to Base64 Conversion Utility
+ *
+ * Functions to convert URLs to base64 encoded strings.
+ */
+/**
+ * Convert a URL to base64 encoded string
+ *
+ * @param url - The URL to fetch and convert
+ * @returns Promise<string> - Base64 encoded string
+ * @throws Error if the URL cannot be fetched or converted
+ */
+export declare function convertUrlToBase64(url: string): Promise<string>;
+/**
+ * Convert a URL to base64 data URI format
+ *
+ * @param url - The URL to fetch and convert
+ * @param mimeType - Optional MIME type (will try to detect from response if not provided)
+ * @returns Promise<string> - Base64 data URI string (e.g., "data:image/png;base64,iVBORw0KGgo...")
+ * @throws Error if the URL cannot be fetched or converted
+ */
+export declare function convertUrlToBase64DataUri(url: string, mimeType?: string): Promise<string>;
+/**
+ * Convert multiple URLs to base64 strings
+ *
+ * @param urls - Array of URLs to convert
+ * @returns Promise<string[]> - Array of base64 encoded strings
+ * @throws Error if any URL cannot be fetched or converted
+ */
+export declare function convertUrlsToBase64(urls: string[]): Promise<string[]>;
+/**
+ * Convert multiple URLs to base64 data URIs
+ *
+ * @param urls - Array of URLs to convert
+ * @param mimeTypes - Optional array of MIME types (will try to detect if not provided)
+ * @returns Promise<string[]> - Array of base64 data URI strings
+ * @throws Error if any URL cannot be fetched or converted
+ */
+export declare function convertUrlsToBase64DataUris(urls: string[], mimeTypes?: (string | undefined)[]): Promise<string[]>;
+/**
+ * Check if a string is a valid URL
+ *
+ * @param url - The string to check
+ * @returns boolean - True if the string is a valid URL
+ */
+export declare function isValidUrl(url: string): boolean;
+/**
+ * Convert a URL to base64 with timeout
+ *
+ * @param url - The URL to fetch and convert
+ * @param timeoutMs - Timeout in milliseconds (default: 10000)
+ * @returns Promise<string> - Base64 encoded string
+ * @throws Error if the URL cannot be fetched within timeout or converted
+ */
+export declare function convertUrlToBase64WithTimeout(url: string, timeoutMs?: number): Promise<string>;

package/general/convert-url-to-base64.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * URL to Base64 Conversion Utility
+ *
+ * Functions to convert URLs to base64 encoded strings.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertUrlToBase64 = convertUrlToBase64;
+exports.convertUrlToBase64DataUri = convertUrlToBase64DataUri;
+exports.convertUrlsToBase64 = convertUrlsToBase64;
+exports.convertUrlsToBase64DataUris = convertUrlsToBase64DataUris;
+exports.isValidUrl = isValidUrl;
+exports.convertUrlToBase64WithTimeout = convertUrlToBase64WithTimeout;
+/**
+ * Convert a URL to base64 encoded string
+ *
+ * @param url - The URL to fetch and convert
+ * @returns Promise<string> - Base64 encoded string
+ * @throws Error if the URL cannot be fetched or converted
+ */
+function convertUrlToBase64(url) {
+    return __awaiter(this, void 0, void 0, function () {
+        var response, arrayBuffer, uint8Array, binaryString, i, error_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 3, , 4]);
+                    return [4 /*yield*/, fetch(url)];
+                case 1:
+                    response = _a.sent();
+                    if (!response.ok) {
+                        throw new Error("Failed to fetch URL: ".concat(response.status, " ").concat(response.statusText));
+                    }
+                    return [4 /*yield*/, response.arrayBuffer()];
+                case 2:
+                    arrayBuffer = _a.sent();
+                    uint8Array = new Uint8Array(arrayBuffer);
+                    binaryString = '';
+                    for (i = 0; i < uint8Array.length; i++) {
+                        binaryString += String.fromCharCode(uint8Array[i]);
+                    }
+                    return [2 /*return*/, btoa(binaryString)];
+                case 3:
+                    error_1 = _a.sent();
+                    console.error('Error converting URL to base64:', error_1);
+                    throw new Error("Failed to convert URL to base64: ".concat(error_1 instanceof Error ? error_1.message : 'Unknown error'));
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Convert a URL to base64 data URI format
+ *
+ * @param url - The URL to fetch and convert
+ * @param mimeType - Optional MIME type (will try to detect from response if not provided)
+ * @returns Promise<string> - Base64 data URI string (e.g., "data:image/png;base64,iVBORw0KGgo...")
+ * @throws Error if the URL cannot be fetched or converted
+ */
+function convertUrlToBase64DataUri(url, mimeType) {
+    return __awaiter(this, void 0, void 0, function () {
+        var response, contentType, arrayBuffer, uint8Array, binaryString, i, base64, error_2;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 3, , 4]);
+                    return [4 /*yield*/, fetch(url)];
+                case 1:
+                    response = _a.sent();
+                    if (!response.ok) {
+                        throw new Error("Failed to fetch URL: ".concat(response.status, " ").concat(response.statusText));
+                    }
+                    contentType = mimeType ||
+                        response.headers.get('content-type') ||
+                        'application/octet-stream';
+                    return [4 /*yield*/, response.arrayBuffer()];
+                case 2:
+                    arrayBuffer = _a.sent();
+                    uint8Array = new Uint8Array(arrayBuffer);
+                    binaryString = '';
+                    for (i = 0; i < uint8Array.length; i++) {
+                        binaryString += String.fromCharCode(uint8Array[i]);
+                    }
+                    base64 = btoa(binaryString);
+                    return [2 /*return*/, "data:".concat(contentType, ";base64,").concat(base64)];
+                case 3:
+                    error_2 = _a.sent();
+                    console.error('Error converting URL to base64 data URI:', error_2);
+                    throw new Error("Failed to convert URL to base64 data URI: ".concat(error_2 instanceof Error ? error_2.message : 'Unknown error'));
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}
+/**
+ * Convert multiple URLs to base64 strings
+ *
+ * @param urls - Array of URLs to convert
+ * @returns Promise<string[]> - Array of base64 encoded strings
+ * @throws Error if any URL cannot be fetched or converted
+ */
+function convertUrlsToBase64(urls) {
+    return __awaiter(this, void 0, void 0, function () {
+        var promises;
+        return __generator(this, function (_a) {
+            promises = urls.map(function (url) { return convertUrlToBase64(url); });
+            return [2 /*return*/, Promise.all(promises)];
+        });
+    });
+}
+/**
+ * Convert multiple URLs to base64 data URIs
+ *
+ * @param urls - Array of URLs to convert
+ * @param mimeTypes - Optional array of MIME types (will try to detect if not provided)
+ * @returns Promise<string[]> - Array of base64 data URI strings
+ * @throws Error if any URL cannot be fetched or converted
+ */
+function convertUrlsToBase64DataUris(urls, mimeTypes) {
+    return __awaiter(this, void 0, void 0, function () {
+        var promises;
+        return __generator(this, function (_a) {
+            promises = urls.map(function (url, index) {
+                return convertUrlToBase64DataUri(url, mimeTypes === null || mimeTypes === void 0 ? void 0 : mimeTypes[index]);
+            });
+            return [2 /*return*/, Promise.all(promises)];
+        });
+    });
+}
+/**
+ * Check if a string is a valid URL
+ *
+ * @param url - The string to check
+ * @returns boolean - True if the string is a valid URL
+ */
+function isValidUrl(url) {
+    try {
+        new URL(url);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Convert a URL to base64 with timeout
+ *
+ * @param url - The URL to fetch and convert
+ * @param timeoutMs - Timeout in milliseconds (default: 10000)
+ * @returns Promise<string> - Base64 encoded string
+ * @throws Error if the URL cannot be fetched within timeout or converted
+ */
+function convertUrlToBase64WithTimeout(url_1) {
+    return __awaiter(this, arguments, void 0, function (url, timeoutMs) {
+        var controller, timeoutId, response, arrayBuffer, uint8Array, binaryString, i, error_3;
+        if (timeoutMs === void 0) { timeoutMs = 10000; }
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    controller = new AbortController();
+                    timeoutId = setTimeout(function () { return controller.abort(); }, timeoutMs);
+                    _a.label = 1;
+                case 1:
+                    _a.trys.push([1, 4, , 5]);
+                    return [4 /*yield*/, fetch(url, {
+                            signal: controller.signal,
+                        })];
+                case 2:
+                    response = _a.sent();
+                    clearTimeout(timeoutId);
+                    if (!response.ok) {
+                        throw new Error("Failed to fetch URL: ".concat(response.status, " ").concat(response.statusText));
+                    }
+                    return [4 /*yield*/, response.arrayBuffer()];
+                case 3:
+                    arrayBuffer = _a.sent();
+                    uint8Array = new Uint8Array(arrayBuffer);
+                    binaryString = '';
+                    for (i = 0; i < uint8Array.length; i++) {
+                        binaryString += String.fromCharCode(uint8Array[i]);
+                    }
+                    return [2 /*return*/, btoa(binaryString)];
+                case 4:
+                    error_3 = _a.sent();
+                    clearTimeout(timeoutId);
+                    if (error_3 instanceof Error && error_3.name === 'AbortError') {
+                        throw new Error("Request timed out after ".concat(timeoutMs, "ms"));
+                    }
+                    console.error('Error converting URL to base64:', error_3);
+                    throw new Error("Failed to convert URL to base64: ".concat(error_3 instanceof Error ? error_3.message : 'Unknown error'));
+                case 5: return [2 /*return*/];
+            }
+        });
+    });
+}

package/general/format-value.d.ts

@@ -0,0 +1 @@
+export declare const formatValue: (v?: string | number | null) => string;

package/general/format-value.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatValue = void 0;
+var formatValue = function (v) {
+    return v === undefined || v === null || v === '' ? '—' : String(v);
+};
+exports.formatValue = formatValue;

package/general/normalize-phone.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizePhone(value: unknown): string | null | undefined;
+export declare function formatPhoneDisplay(value: unknown, defaultCountry?: string): string | undefined;

package/general/normalize-phone.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePhone = normalizePhone;
+exports.formatPhoneDisplay = formatPhoneDisplay;
+var libphonenumber_js_1 = require("libphonenumber-js");
+function normalizePhone(value) {
+    if (value === null)
+        return null;
+    if (typeof value !== 'string')
+        return undefined;
+    var trimmed = value.trim();
+    try {
+        var pn = (0, libphonenumber_js_1.parsePhoneNumberFromString)(trimmed);
+        if (pn && pn.isValid()) {
+            // Return E.164 digits without the leading +
+            return pn.number.replace(/\+/g, '');
+        }
+        return undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+function formatPhoneDisplay(value, defaultCountry) {
+    if (value === null)
+        return undefined;
+    if (typeof value !== 'string')
+        return undefined;
+    var trimmed = value.trim();
+    try {
+        var pn = (0, libphonenumber_js_1.parsePhoneNumberFromString)(trimmed, defaultCountry);
+        if (pn && pn.isValid()) {
+            return pn.formatInternational();
+        }
+        return undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+}

package/index.d.ts

@@ -1,28 +0,0 @@
-export * from './api/stellar-solutions/app-user';
-export * from './api/stellar-solutions/bank';
-export * from './api/stellar-solutions/branch';
-export * from './api/stellar-solutions/company-report';
-export * from './api/stellar-solutions/company';
-export * from './api/stellar-solutions/constants';
-export * from './api/stellar-solutions/constants';
-export * from './api/stellar-solutions/contact';
-export * from './api/stellar-solutions/currency';
-export * from './api/stellar-solutions/customer';
-export * from './api/stellar-solutions/expense-category';
-export * from './api/stellar-solutions/expense';
-export * from './api/stellar-solutions/lead';
-export * from './api/stellar-solutions/menu-order';
-export * from './api/stellar-solutions/payment-mode';
-export * from './api/stellar-solutions/payment';
-export * from './api/stellar-solutions/preference';
-export * from './api/stellar-solutions/product-category';
-export * from './api/stellar-solutions/product';
-export * from './api/stellar-solutions/profile';
-export * from './api/stellar-solutions/quote-invoice-report';
-export * from './api/stellar-solutions/quote-invoice';
-export * from './api/stellar-solutions/tax';
-export * from './api/stellar-solutions/types';
-export * from './constants';
-export * from './general';
-export * from './local-storage';
-export * from './storybook';

package/index.js

@@ -1,44 +1,28 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./api/stellar-solutions/app-user"), exports);
-__exportStar(require("./api/stellar-solutions/bank"), exports);
-__exportStar(require("./api/stellar-solutions/branch"), exports);
-__exportStar(require("./api/stellar-solutions/company-report"), exports);
-__exportStar(require("./api/stellar-solutions/company"), exports);
-__exportStar(require("./api/stellar-solutions/constants"), exports);
-__exportStar(require("./api/stellar-solutions/constants"), exports);
-__exportStar(require("./api/stellar-solutions/contact"), exports);
-__exportStar(require("./api/stellar-solutions/currency"), exports);
-__exportStar(require("./api/stellar-solutions/customer"), exports);
-__exportStar(require("./api/stellar-solutions/expense-category"), exports);
-__exportStar(require("./api/stellar-solutions/expense"), exports);
-__exportStar(require("./api/stellar-solutions/lead"), exports);
-__exportStar(require("./api/stellar-solutions/menu-order"), exports);
-__exportStar(require("./api/stellar-solutions/payment-mode"), exports);
-__exportStar(require("./api/stellar-solutions/payment"), exports);
-__exportStar(require("./api/stellar-solutions/preference"), exports);
-__exportStar(require("./api/stellar-solutions/product-category"), exports);
-__exportStar(require("./api/stellar-solutions/product"), exports);
-__exportStar(require("./api/stellar-solutions/profile"), exports);
-__exportStar(require("./api/stellar-solutions/quote-invoice-report"), exports);
-__exportStar(require("./api/stellar-solutions/quote-invoice"), exports);
-__exportStar(require("./api/stellar-solutions/tax"), exports);
-__exportStar(require("./api/stellar-solutions/types"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./general"), exports);
-__exportStar(require("./local-storage"), exports);
-__exportStar(require("./storybook"), exports);
+// export * from './api/stellar-solutions/app-user';
+// export * from './api/stellar-solutions/bank';
+// export * from './api/stellar-solutions/branch';
+// export * from './api/stellar-solutions/company-report';
+// export * from './api/stellar-solutions/company';
+// export * from './api/stellar-solutions/constants';
+// export * from './api/stellar-solutions/constants';
+// export * from './api/stellar-solutions/contact';
+// export * from './api/stellar-solutions/currency';
+// export * from './api/stellar-solutions/customer';
+// export * from './api/stellar-solutions/expense-category';
+// export * from './api/stellar-solutions/expense';
+// export * from './api/stellar-solutions/lead';
+// export * from './api/stellar-solutions/menu-order';
+// export * from './api/stellar-solutions/payment-mode';
+// export * from './api/stellar-solutions/payment';
+// export * from './api/stellar-solutions/preference';
+// export * from './api/stellar-solutions/product-category';
+// export * from './api/stellar-solutions/product';
+// export * from './api/stellar-solutions/profile';
+// export * from './api/stellar-solutions/quote-invoice-report';
+// export * from './api/stellar-solutions/quote-invoice';
+// export * from './api/stellar-solutions/tax';
+// export * from './api/stellar-solutions/types';
+// export * from './constants';
+// export * from './general';
+// export * from './local-storage';
+// export * from './storybook';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-pakistan/util-functions",
-  "version": "1.25.73",
+  "version": "1.25.75",
   "description": "A library of all util functions",
   "main": "index.js",
   "scripts": {
@@ -23,7 +23,7 @@
     "publish:github": "yarn build && cd lib && npm publish && cd ..",
     "publish:npm": "yarn build && cd lib && npm publish --access public && cd ..",
     "test": "jest --coverage --config jest.config.js",
-    "test:badges": "yarn test && jest-coverage-badges && yarn clean:badges && mkdir badges && cp ./coverage/*badge*.svg ./badges/",
+    "test:badges": "yarn test && yarn clean:badges && mkdir -p badges && cp ./coverage/*badge*.svg ./badges/",
     "upgrade": "ncu -u"
   },
   "repository": {
@@ -69,7 +69,6 @@
     "globals": "^15.13.0",
     "husky": "^9.1.7",
     "jest": "^29.7.0",
-    "jest-coverage-badges": "^1.1.2",
     "jest-environment-jsdom": "^29.7.0",
     "libphonenumber-js": "^1.12.13",
     "lint-staged": "^15.2.2",