@lichens-innovation/ts-common 1.15.5 → 1.17.0

package/dist/mime.cjs

@@ -7,6 +7,63 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var mime__default = /*#__PURE__*/_interopDefault(mime);
 
 // src/mime/index.ts
+
+// src/utils/types.utils.ts
+var isNullish = (value) => value === null || value === void 0;
+
+// src/utils/string.utils.ts
+var isBlank = (str) => {
+  return isNullish(str) || str?.trim() === "";
+};
+var DATA_URI_PATTERN = /^data:([\w.+-]+\/[\w.+-]+);base64,(.+)$/;
+var isValidDataUri = (uri) => {
+  if (isBlank(uri)) {
+    return false;
+  }
+  return DATA_URI_PATTERN.test(uri);
+};
+
+// src/mime/mime.utils.ts
+var VALID_IMAGE_TYPES = [
+  "image/png",
+  "image/jpeg",
+  "image/jpg",
+  "image/gif",
+  "image/webp",
+  "image/bmp",
+  "image/svg+xml",
+  "image/avif",
+  "image/tiff",
+  "image/x-icon",
+  "image/vnd.microsoft.icon",
+  "image/heic",
+  "image/heif"
+];
+
+// src/mime/index.ts
+var parseDataUri = (input) => {
+  if (!isValidDataUri(input)) return null;
+  const match = DATA_URI_PATTERN.exec(input);
+  if (!match) return null;
+  const [, mimeType, base64] = match;
+  if (!mimeType || !base64) return null;
+  return { mimeType, base64, ext: mimeToExt(mimeType) };
+};
+var isImageMimeType = (mimeType) => {
+  return VALID_IMAGE_TYPES.includes(mimeType);
+};
+var getImagePreviewSrc = (input) => {
+  const parsed = parseDataUri(input);
+  if (!parsed) return null;
+  if (!isImageMimeType(parsed.mimeType)) return null;
+  return input;
+};
+var mimeToExt = (mimeType) => {
+  const ext = mime__default.default.getExtension(mimeType);
+  if (ext) return ext;
+  const subtype = mimeType.split("/")[1] ?? mimeType;
+  return subtype.split("+")[0] ?? subtype;
+};
 var getMimeType = (extension) => {
   const mimeType = mime__default.default.getType(extension);
   if (!mimeType) {
@@ -15,6 +72,10 @@ var getMimeType = (extension) => {
   return mimeType;
 };
 
+exports.getImagePreviewSrc = getImagePreviewSrc;
 exports.getMimeType = getMimeType;
+exports.isImageMimeType = isImageMimeType;
+exports.mimeToExt = mimeToExt;
+exports.parseDataUri = parseDataUri;
 //# sourceMappingURL=mime.cjs.map
 //# sourceMappingURL=mime.cjs.map

package/dist/mime.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mime/index.ts"],"names":["mime"],"mappings":";;;;;;;;;AAEO,IAAM,WAAA,GAAc,CAAC,SAAA,KAA8B;AACxD,EAAA,MAAM,QAAA,GAAWA,qBAAA,CAAK,OAAA,CAAQ,SAAS,CAAA;AACvC,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kDAAA,EAAqD,SAAS,CAAA,CAAA,CAAG,CAAA;AAAA,EACnF;AAEA,EAAA,OAAO,QAAA;AACT","file":"mime.cjs","sourcesContent":["import mime from \"mime\";\n\nexport const getMimeType = (extension: string): string => {\n  const mimeType = mime.getType(extension);\n  if (!mimeType) {\n    throw new Error(`[getMimeType] Mime type not found for extension: \"${extension}\"`);\n  }\n\n  return mimeType;\n};\n"]}
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/string.utils.ts","../src/utils/uri.utils.ts","../src/mime/mime.utils.ts","../src/mime/index.ts"],"names":["mime"],"mappings":";;;;;;;;;;;AAEO,IAAM,SAAA,GAAY,CAAC,KAAA,KAA8C,KAAA,KAAU,QAAQ,KAAA,KAAU,MAAA;;;ACC7F,IAAM,OAAA,GAAU,CAAC,GAAA,KAAsD;AAC5E,EAAA,OAAO,SAAA,CAAU,GAAG,CAAA,IAAK,GAAA,EAAK,MAAK,KAAM,EAAA;AAC3C,CAAA;ACUO,IAAM,gBAAA,GAAmB,yCAAA;AAEzB,IAAM,cAAA,GAAiB,CAAC,GAAA,KAAiC;AAC9D,EAAA,IAAI,OAAA,CAAQ,GAAG,CAAA,EAAG;AAChB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OAAO,gBAAA,CAAiB,KAAK,GAAG,CAAA;AAClC,CAAA;;;ACvBO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,WAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,0BAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAA;;;ACHO,IAAM,YAAA,GAAe,CAAC,KAAA,KAA6C;AACxE,EAAA,IAAI,CAAC,cAAA,CAAe,KAAK,CAAA,EAAG,OAAO,IAAA;AAEnC,EAAA,MAAM,KAAA,GAAQ,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA;AACzC,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAEnB,EAAA,MAAM,GAAG,QAAA,EAAU,MAAM,CAAA,GAAI,KAAA;AAC7B,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ,OAAO,IAAA;AAEjC,EAAA,OAAO,EAAE,QAAA,EAAU,MAAA,EAAQ,GAAA,EAAK,SAAA,CAAU,QAAQ,CAAA,EAAE;AACtD;AAEO,IAAM,eAAA,GAAkB,CAAC,QAAA,KAA8B;AAC5D,EAAA,OAAO,iBAAA,CAAkB,SAAS,QAAQ,CAAA;AAC5C;AAEO,IAAM,kBAAA,GAAqB,CAAC,KAAA,KAAiC;AAClE,EAAA,MAAM,MAAA,GAAS,aAAa,KAAK,CAAA;AACjC,EAAA,IAAI,CAAC,QAAQ,OAAO,IAAA;AACpB,EAAA,IAAI,CAAC,eAAA,CAAgB,MAAA,CAAO,QAAQ,GAAG,OAAO,IAAA;AAE9C,EAAA,OAAO,KAAA;AACT;AAEO,IAAM,SAAA,GAAY,CAAC,QAAA,KAA6B;AACrD,EAAA,MAAM,GAAA,GAAMA,qBAAA,CAAK,YAAA,CAAa,QAAQ,CAAA;AACtC,EAAA,IAAI,KAAK,OAAO,GAAA;AAEhB,EAAA,MAAM,UAAU,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,QAAA;AAC1C,EAAA,OAAO,OAAA,CAAQ,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,OAAA;AAClC;AAEO,IAAM,WAAA,GAAc,CAAC,SAAA,KAA8B;AACxD,EAAA,MAAM,QAAA,GAAWA,qBAAA,CAAK,OAAA,CAAQ,SAAS,CAAA;AACvC,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kDAAA,EAAqD,SAAS,CAAA,CAAA,CAAG,CAAA;AAAA,EACnF;AAEA,EAAA,OAAO,QAAA;AACT","file":"mime.cjs","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n\n/**\n * Parses an optional comma-separated string into a trimmed, non-blank string array.\n */\nexport const parseCommaSeparatedList = (raw?: string | null): string[] => {\n  if (isBlank(raw)) {\n    return [];\n  }\n\n  return raw\n    .split(\",\")\n    .map((s: string) => s.trim())\n    .filter(isNotBlank);\n};\n","import { isBlank } from \".\";\n\nexport const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const DATA_URI_PATTERN = /^data:([\\w.+-]+\\/[\\w.+-]+);base64,(.+)$/;\n\nexport const isValidDataUri = (uri?: string | null): boolean => {\n  if (isBlank(uri)) {\n    return false;\n  }\n\n  return DATA_URI_PATTERN.test(uri);\n};\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","export const VALID_IMAGE_TYPES = [\n  \"image/png\",\n  \"image/jpeg\",\n  \"image/jpg\",\n  \"image/gif\",\n  \"image/webp\",\n  \"image/bmp\",\n  \"image/svg+xml\",\n  \"image/avif\",\n  \"image/tiff\",\n  \"image/x-icon\",\n  \"image/vnd.microsoft.icon\",\n  \"image/heic\",\n  \"image/heif\",\n];\n","import mime from \"mime\";\n\nimport { DATA_URI_PATTERN, isValidDataUri } from \"~/utils/uri.utils\";\nimport { VALID_IMAGE_TYPES } from \"./mime.utils\";\n\nexport interface ParseDataUriResult {\n  mimeType: string;\n  base64: string;\n  ext: string;\n}\n\nexport const parseDataUri = (input: string): ParseDataUriResult | null => {\n  if (!isValidDataUri(input)) return null;\n\n  const match = DATA_URI_PATTERN.exec(input);\n  if (!match) return null;\n\n  const [, mimeType, base64] = match;\n  if (!mimeType || !base64) return null;\n\n  return { mimeType, base64, ext: mimeToExt(mimeType) };\n};\n\nexport const isImageMimeType = (mimeType: string): boolean => {\n  return VALID_IMAGE_TYPES.includes(mimeType);\n};\n\nexport const getImagePreviewSrc = (input: string): string | null => {\n  const parsed = parseDataUri(input);\n  if (!parsed) return null;\n  if (!isImageMimeType(parsed.mimeType)) return null;\n\n  return input;\n};\n\nexport const mimeToExt = (mimeType: string): string => {\n  const ext = mime.getExtension(mimeType);\n  if (ext) return ext;\n\n  const subtype = mimeType.split(\"/\")[1] ?? mimeType;\n  return subtype.split(\"+\")[0] ?? subtype;\n};\n\nexport const getMimeType = (extension: string): string => {\n  const mimeType = mime.getType(extension);\n  if (!mimeType) {\n    throw new Error(`[getMimeType] Mime type not found for extension: \"${extension}\"`);\n  }\n\n  return mimeType;\n};\n\n"]}

package/dist/mime.d.cts

@@ -1,3 +1,12 @@
+interface ParseDataUriResult {
+    mimeType: string;
+    base64: string;
+    ext: string;
+}
+declare const parseDataUri: (input: string) => ParseDataUriResult | null;
+declare const isImageMimeType: (mimeType: string) => boolean;
+declare const getImagePreviewSrc: (input: string) => string | null;
+declare const mimeToExt: (mimeType: string) => string;
 declare const getMimeType: (extension: string) => string;
 
-export { getMimeType };
+export { type ParseDataUriResult, getImagePreviewSrc, getMimeType, isImageMimeType, mimeToExt, parseDataUri };

package/dist/mime.d.ts

@@ -1,3 +1,12 @@
+interface ParseDataUriResult {
+    mimeType: string;
+    base64: string;
+    ext: string;
+}
+declare const parseDataUri: (input: string) => ParseDataUriResult | null;
+declare const isImageMimeType: (mimeType: string) => boolean;
+declare const getImagePreviewSrc: (input: string) => string | null;
+declare const mimeToExt: (mimeType: string) => string;
 declare const getMimeType: (extension: string) => string;
 
-export { getMimeType };
+export { type ParseDataUriResult, getImagePreviewSrc, getMimeType, isImageMimeType, mimeToExt, parseDataUri };

package/dist/mime.js

@@ -1,6 +1,63 @@
 import mime from 'mime';
 
 // src/mime/index.ts
+
+// src/utils/types.utils.ts
+var isNullish = (value) => value === null || value === void 0;
+
+// src/utils/string.utils.ts
+var isBlank = (str) => {
+  return isNullish(str) || str?.trim() === "";
+};
+var DATA_URI_PATTERN = /^data:([\w.+-]+\/[\w.+-]+);base64,(.+)$/;
+var isValidDataUri = (uri) => {
+  if (isBlank(uri)) {
+    return false;
+  }
+  return DATA_URI_PATTERN.test(uri);
+};
+
+// src/mime/mime.utils.ts
+var VALID_IMAGE_TYPES = [
+  "image/png",
+  "image/jpeg",
+  "image/jpg",
+  "image/gif",
+  "image/webp",
+  "image/bmp",
+  "image/svg+xml",
+  "image/avif",
+  "image/tiff",
+  "image/x-icon",
+  "image/vnd.microsoft.icon",
+  "image/heic",
+  "image/heif"
+];
+
+// src/mime/index.ts
+var parseDataUri = (input) => {
+  if (!isValidDataUri(input)) return null;
+  const match = DATA_URI_PATTERN.exec(input);
+  if (!match) return null;
+  const [, mimeType, base64] = match;
+  if (!mimeType || !base64) return null;
+  return { mimeType, base64, ext: mimeToExt(mimeType) };
+};
+var isImageMimeType = (mimeType) => {
+  return VALID_IMAGE_TYPES.includes(mimeType);
+};
+var getImagePreviewSrc = (input) => {
+  const parsed = parseDataUri(input);
+  if (!parsed) return null;
+  if (!isImageMimeType(parsed.mimeType)) return null;
+  return input;
+};
+var mimeToExt = (mimeType) => {
+  const ext = mime.getExtension(mimeType);
+  if (ext) return ext;
+  const subtype = mimeType.split("/")[1] ?? mimeType;
+  return subtype.split("+")[0] ?? subtype;
+};
 var getMimeType = (extension) => {
   const mimeType = mime.getType(extension);
   if (!mimeType) {
@@ -9,6 +66,6 @@ var getMimeType = (extension) => {
   return mimeType;
 };
 
-export { getMimeType };
+export { getImagePreviewSrc, getMimeType, isImageMimeType, mimeToExt, parseDataUri };
 //# sourceMappingURL=mime.js.map
 //# sourceMappingURL=mime.js.map

package/dist/mime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mime/index.ts"],"names":[],"mappings":";;;AAEO,IAAM,WAAA,GAAc,CAAC,SAAA,KAA8B;AACxD,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,SAAS,CAAA;AACvC,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kDAAA,EAAqD,SAAS,CAAA,CAAA,CAAG,CAAA;AAAA,EACnF;AAEA,EAAA,OAAO,QAAA;AACT","file":"mime.js","sourcesContent":["import mime from \"mime\";\n\nexport const getMimeType = (extension: string): string => {\n  const mimeType = mime.getType(extension);\n  if (!mimeType) {\n    throw new Error(`[getMimeType] Mime type not found for extension: \"${extension}\"`);\n  }\n\n  return mimeType;\n};\n"]}
+{"version":3,"sources":["../src/utils/types.utils.ts","../src/utils/string.utils.ts","../src/utils/uri.utils.ts","../src/mime/mime.utils.ts","../src/mime/index.ts"],"names":[],"mappings":";;;;;AAEO,IAAM,SAAA,GAAY,CAAC,KAAA,KAA8C,KAAA,KAAU,QAAQ,KAAA,KAAU,MAAA;;;ACC7F,IAAM,OAAA,GAAU,CAAC,GAAA,KAAsD;AAC5E,EAAA,OAAO,SAAA,CAAU,GAAG,CAAA,IAAK,GAAA,EAAK,MAAK,KAAM,EAAA;AAC3C,CAAA;ACUO,IAAM,gBAAA,GAAmB,yCAAA;AAEzB,IAAM,cAAA,GAAiB,CAAC,GAAA,KAAiC;AAC9D,EAAA,IAAI,OAAA,CAAQ,GAAG,CAAA,EAAG;AAChB,IAAA,OAAO,KAAA;AAAA,EACT;AAEA,EAAA,OAAO,gBAAA,CAAiB,KAAK,GAAG,CAAA;AAClC,CAAA;;;ACvBO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,WAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,WAAA;AAAA,EACA,YAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,cAAA;AAAA,EACA,0BAAA;AAAA,EACA,YAAA;AAAA,EACA;AACF,CAAA;;;ACHO,IAAM,YAAA,GAAe,CAAC,KAAA,KAA6C;AACxE,EAAA,IAAI,CAAC,cAAA,CAAe,KAAK,CAAA,EAAG,OAAO,IAAA;AAEnC,EAAA,MAAM,KAAA,GAAQ,gBAAA,CAAiB,IAAA,CAAK,KAAK,CAAA;AACzC,EAAA,IAAI,CAAC,OAAO,OAAO,IAAA;AAEnB,EAAA,MAAM,GAAG,QAAA,EAAU,MAAM,CAAA,GAAI,KAAA;AAC7B,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,MAAA,EAAQ,OAAO,IAAA;AAEjC,EAAA,OAAO,EAAE,QAAA,EAAU,MAAA,EAAQ,GAAA,EAAK,SAAA,CAAU,QAAQ,CAAA,EAAE;AACtD;AAEO,IAAM,eAAA,GAAkB,CAAC,QAAA,KAA8B;AAC5D,EAAA,OAAO,iBAAA,CAAkB,SAAS,QAAQ,CAAA;AAC5C;AAEO,IAAM,kBAAA,GAAqB,CAAC,KAAA,KAAiC;AAClE,EAAA,MAAM,MAAA,GAAS,aAAa,KAAK,CAAA;AACjC,EAAA,IAAI,CAAC,QAAQ,OAAO,IAAA;AACpB,EAAA,IAAI,CAAC,eAAA,CAAgB,MAAA,CAAO,QAAQ,GAAG,OAAO,IAAA;AAE9C,EAAA,OAAO,KAAA;AACT;AAEO,IAAM,SAAA,GAAY,CAAC,QAAA,KAA6B;AACrD,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,YAAA,CAAa,QAAQ,CAAA;AACtC,EAAA,IAAI,KAAK,OAAO,GAAA;AAEhB,EAAA,MAAM,UAAU,QAAA,CAAS,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,QAAA;AAC1C,EAAA,OAAO,OAAA,CAAQ,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,OAAA;AAClC;AAEO,IAAM,WAAA,GAAc,CAAC,SAAA,KAA8B;AACxD,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,SAAS,CAAA;AACvC,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,kDAAA,EAAqD,SAAS,CAAA,CAAA,CAAG,CAAA;AAAA,EACnF;AAEA,EAAA,OAAO,QAAA;AACT","file":"mime.js","sourcesContent":["export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n\n/**\n * Parses an optional comma-separated string into a trimmed, non-blank string array.\n */\nexport const parseCommaSeparatedList = (raw?: string | null): string[] => {\n  if (isBlank(raw)) {\n    return [];\n  }\n\n  return raw\n    .split(\",\")\n    .map((s: string) => s.trim())\n    .filter(isNotBlank);\n};\n","import { isBlank } from \".\";\n\nexport const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const DATA_URI_PATTERN = /^data:([\\w.+-]+\\/[\\w.+-]+);base64,(.+)$/;\n\nexport const isValidDataUri = (uri?: string | null): boolean => {\n  if (isBlank(uri)) {\n    return false;\n  }\n\n  return DATA_URI_PATTERN.test(uri);\n};\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n\n/**\n * Extracts the base64 data from a data URI string.\n * Data URIs have the format: data:[<mediatype>][;base64],<data>\n * This function extracts everything after the first comma.\n *\n * @param dataUri - The data URI string (e.g., \"data:image/png;base64,iVBORw0KG...\")\n * @returns The base64 data without the data URI prefix, or the original string if no comma is found\n */\nexport const extractBase64FromDataUri = (dataUri: string): string => {\n  return dataUri.split(',')[1] ?? dataUri;\n};\n","export const VALID_IMAGE_TYPES = [\n  \"image/png\",\n  \"image/jpeg\",\n  \"image/jpg\",\n  \"image/gif\",\n  \"image/webp\",\n  \"image/bmp\",\n  \"image/svg+xml\",\n  \"image/avif\",\n  \"image/tiff\",\n  \"image/x-icon\",\n  \"image/vnd.microsoft.icon\",\n  \"image/heic\",\n  \"image/heif\",\n];\n","import mime from \"mime\";\n\nimport { DATA_URI_PATTERN, isValidDataUri } from \"~/utils/uri.utils\";\nimport { VALID_IMAGE_TYPES } from \"./mime.utils\";\n\nexport interface ParseDataUriResult {\n  mimeType: string;\n  base64: string;\n  ext: string;\n}\n\nexport const parseDataUri = (input: string): ParseDataUriResult | null => {\n  if (!isValidDataUri(input)) return null;\n\n  const match = DATA_URI_PATTERN.exec(input);\n  if (!match) return null;\n\n  const [, mimeType, base64] = match;\n  if (!mimeType || !base64) return null;\n\n  return { mimeType, base64, ext: mimeToExt(mimeType) };\n};\n\nexport const isImageMimeType = (mimeType: string): boolean => {\n  return VALID_IMAGE_TYPES.includes(mimeType);\n};\n\nexport const getImagePreviewSrc = (input: string): string | null => {\n  const parsed = parseDataUri(input);\n  if (!parsed) return null;\n  if (!isImageMimeType(parsed.mimeType)) return null;\n\n  return input;\n};\n\nexport const mimeToExt = (mimeType: string): string => {\n  const ext = mime.getExtension(mimeType);\n  if (ext) return ext;\n\n  const subtype = mimeType.split(\"/\")[1] ?? mimeType;\n  return subtype.split(\"+\")[0] ?? subtype;\n};\n\nexport const getMimeType = (extension: string): string => {\n  const mimeType = mime.getType(extension);\n  if (!mimeType) {\n    throw new Error(`[getMimeType] Mime type not found for extension: \"${extension}\"`);\n  }\n\n  return mimeType;\n};\n\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lichens-innovation/ts-common",
-  "version": "1.15.5",
+  "version": "1.17.0",
   "description": "Reusable generic typescript utilities, types, constants, helpers",
   "keywords": [
     "typescript",